Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.near.org/llms.txt

Use this file to discover all available pages before exploring further.

The RPC API exposes several methods for broadcasting signed transactions and tracking their execution. All transaction methods accept a base64-encoded signed_tx_base64 payload. Status methods accept either the same payload or a tx_hash + sender_account_id pair.

​
Quick Reference

MethodPurpose
send_txBroadcast a signed transaction and wait for the result
txGet the status of a previously broadcast transaction
EXPERIMENTAL_tx_statusLike tx, but also returns receipt details
EXPERIMENTAL_receiptFetch a single receipt by id
broadcast_tx_asyncBroadcast and return immediately with the transaction hash
broadcast_tx_commitBroadcast and wait until the transaction is included in a block
Prefer send_tx and tx for new integrations. The broadcast_tx_async and broadcast_tx_commit methods are kept for backward compatibility but offer less control over when the call returns.

​
The wait_until Field

send_tx and tx accept an optional wait_until field that controls how long the RPC waits before returning a response. Each value waits for a stricter execution milestone than the previous one — pick the lowest level that satisfies your use case so you don’t pay extra latency.
ValueReturns when…Typical use
NONEThe transaction is queued but not yet included in a block.Fire-and-forget broadcasts where you only need the hash.
INCLUDEDThe transaction is included in a block (the block may not be finalized).UI optimism: you want to confirm the tx hit the chain.
EXECUTED_OPTIMISTIC (default)Included + all non-refund receipts have executed (blocks may still not be finalized).Default for most apps — you can read the result.
INCLUDED_FINALIncluded in a finalized block.You need finality but don’t care about receipts.
EXECUTEDFinalized + all non-refund receipts executed.Strong correctness without waiting for refund receipts.
FINALFinalized + all receipts (including refunds) finalized.Accounting and cross-chain settlement, where refund-tracking matters.
If the field is omitted, the RPC behaves as if EXECUTED_OPTIMISTIC was passed. 
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "send_tx",
  "params": {
    "signed_tx_base64": "DwAAAHNlbmRlci50ZXN0bmV0...",
    "wait_until": "FINAL"
  }
}
Higher wait_until levels can take several seconds. If your client has a short timeout, prefer INCLUDED or EXECUTED_OPTIMISTIC and poll tx for the stricter level.

​
Send Transaction

Broadcasts a signed transaction and waits for the requested execution milestone before returning.
  • method: send_tx
  • params: signed_tx_base64, optional wait_until
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "send_tx",
  "params": {
    "signed_tx_base64": "DwAAAHNlbmRlci50ZXN0bmV0...",
    "wait_until": "EXECUTED_OPTIMISTIC"
  }
}

​
Transaction Status

Returns the status of a previously submitted transaction.
  • method: tx
  • params: either signed_tx_base64, or tx_hash + sender_account_id. Optional wait_until.
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "tx",
  "params": {
    "tx_hash": "6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugbhqsK7wQHnZS",
    "sender_account_id": "sender.testnet",
    "wait_until": "FINAL"
  }
}

​
Transaction Status with Receipts

EXPERIMENTAL_tx_status returns the same payload as tx plus the full set of receipts produced by the transaction. Useful when debugging cross-contract calls.
  • method: EXPERIMENTAL_tx_status
  • params: same as tx

​
Receipt by Id

Fetches a single receipt by its id.
  • method: EXPERIMENTAL_receipt
  • params: receipt_id

​
Broadcast Async

Broadcasts a signed transaction and returns immediately with the transaction hash. Equivalent to send_tx with wait_until: "NONE".
  • method: broadcast_tx_async
  • params: a single positional string — the base64-encoded signed transaction.

​
Broadcast Commit

Broadcasts a signed transaction and waits for it to be included in a block. Equivalent to send_tx with wait_until: "EXECUTED_OPTIMISTIC".
  • method: broadcast_tx_commit
  • params: a single positional string — the base64-encoded signed transaction.

​
Error Handling

Error CodeDescriptionSolution
INVALID_TRANSACTIONThe signed transaction failed validation.Re-sign with the correct nonce, block hash, and signer key.
EXPIRED_TRANSACTIONThe reference block hash is too old.Refresh block_hash and re-sign.
TIMEOUT_ERRORThe chosen wait_until level was not reached before the RPC’s deadline.Lower wait_until and poll tx, or use an archival/dedicated provider.
UNKNOWN_TRANSACTIONNo record of the requested transaction hash.Verify the hash and sender_account_id.
INVALID_SIGNATUREThe signature does not match the signer’s key.Sign again with the matching access key.