> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/near-protocol-near/near_tx.md). # tx - NEAR Protocol Example code for the tx json-rpc method. Сomplete guide on how to use tx json-rpc in GetBlock.io Web3 documentation. This method returns the **full details of a transaction** on the NEAR blockchain, including its status, outcome, receipts, and metadata. ## Supported Networks * Mainnet ## Parameters Description | **Parameter** | **Type** | **Required** | **Description** | | --------------------- | -------- | ------------ | ------------------------------------------------------------- | | **transaction\_hash** | string | Yes | The hash of the transaction to retrieve. | | **signer\_id** | string | Yes | The NEAR account ID of the sender who signed the transaction. | ## Request Example **Base URL** ```bash https://shared.eu-central-1.getblock.io/ ``` **Example(cURL)** ```bash curl -X POST https://shared.eu-central-1.getblock.io/ \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "method": "tx", "params": ["Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN","relay.aurora"], "id": "getblock.io"}' ``` ## Response Example ```json { "jsonrpc": "2.0", "id": "getblock.io", "result": { "status": { "SuccessValue": "" }, "transaction": { "signer_id": "sender.testnet", "public_key": "ed25519:Gowpa4kXNyTMRKgt5W7147pmcc2PxiFic8UHW9rsNvJ6", "nonce": 15, "receiver_id": "receiver.testnet", "actions": [ { "Transfer": { "deposit": "1000000000000000000000000" } } ], "signature": "ed25519:3168QMdTpcwHvM1dmMYBc8hg9J3Wn8n7MWBSE9WrEpns6P5CaY87RM6k4uzyBkQuML38CZhU18HzmQEevPG1zCvk", "hash": "6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugqzqt9wJZwNFm" }, "transaction_outcome": { "proof": [ { "hash": "F7mL76CMdfbdZ3xCehVGNh1fCyaR37gr3MeGX3EZkiVf", "direction": "Right" } ], "block_hash": "ADTMLVtkhsvzUxuf6m87Pt1dnF5vi1yY7ftxmNpFx7y", "id": "6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugqzqt9wJZwNFm", "outcome": { "logs": [], "receipt_ids": [ "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT" ], "gas_burnt": 223182562500, "tokens_burnt": "22318256250000000000", "executor_id": "sender.testnet", "status": { "SuccessReceiptId": "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT" } } }, "receipts_outcome": [ { "proof": [ { "hash": "6h95oEd7ih62KXfyPT4zsZYont4qy9sWEXc5VQVDhqtG", "direction": "Right" }, { "hash": "6DnibgZk1T669ZprcehUy1GpCSPw1kjzXRGu69nSaUNn", "direction": "Right" } ], "block_hash": "GgFTVr33r4MrpAiHc9mr8TZqLnpZAX1BaZTNvhBnciy2", "id": "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT", "outcome": { "logs": [], "receipt_ids": [ "46KYgN8ddxs4Qy8C7BDQH49XUfcYZsaQmAvdU1nfcL9V" ], "gas_burnt": 223182562500, "tokens_burnt": "22318256250000000000", "executor_id": "receiver.testnet", "status": { "SuccessValue": "" } } }, { "proof": [ { "hash": "CD9Y7Bw3MSFgaPZzpc1yP51ajhGDCAsR61qXcMNcRoHf", "direction": "Left" } ], "block_hash": "EGAgKuW6Bd6QKYSaxAkx2pPGmnjrjAcq4UpoUiqMXvPH", "id": "46KYgN8ddxs4Qy8C7BDQH49XUfcYZsaQmAvdU1nfcL9V", "outcome": { "logs": [], "receipt_ids": [], "gas_burnt": 0, "tokens_burnt": "0", "executor_id": "sender.testnet", "status": { "SuccessValue": "" } } } ] } } ``` ## Response Parameters Definition | **Field** | **Type** | **Description** | | --------------------------------------------------------- | -------- | -------------------------------------------------------------- | | **receipts\_outcome** | array | The receipts outcome for the transaction. | | **receipts\_outcome.block\_hash** | string | The hash of the block this transaction was associated with. | | **receipts\_outcome.id** | string | The transaction ID. | | **receipts\_outcome.outcome** | object | The outcome associated with the transaction. | | **receipts\_outcome.outcome.executor\_id** | string | The ID of the transaction originator. | | **receipts\_outcome.outcome.gas\_burnt** | integer | The gas burnt while executing the transaction. | | **receipts\_outcome.outcome.logs** | array | Logs for the application being executed by this transaction. | | **receipts\_outcome.outcome.metadata** | object | Describes transaction metadata and contextual information. | | **receipts\_outcome.outcome.gas\_profile** | array | Details about gas usage, cost, and category. | | **receipts\_outcome.outcome.gas\_profile.cost** | string | The cost of the gas used. | | **receipts\_outcome.outcome.gas\_profile.cost\_category** | string | The category of the gas cost (e.g., compute, storage). | | **receipts\_outcome.outcome.gas\_profile.gas\_used** | string | The total amount of gas used. | | **receipts\_outcome.outcome.version** | string | Version number of the transaction execution. | | **receipts\_outcome.outcome.receipt\_ids** | array | The IDs of receipts generated by the transaction. | | **receipts\_outcome.outcome.status** | string | The status of the transaction (e.g., Success, Failure). | | **receipts\_outcome.outcome.successReceiptId** | string | The transaction ID of the successful receipt. | | **receipts\_outcome.outcome.tokens\_burnt** | string | The amount of tokens burnt during execution. | | **receipts\_outcome.proof** | array | The cryptographic proof for the transaction. | | **receipts\_outcome.proof.hash** | string | The hash of the proof. | | **receipts\_outcome.proof.direction** | string | The proof direction. | | **receipts\_outcome.status** | string | Final transaction status. | | **receipts\_outcome.successValue** | string | Value successfully sent after execution. | | **transaction** | object | The transaction object containing metadata and action details. | | **transaction.actions** | array | Actions performed within the transaction. | | **transaction.actions.FunctionCall** | object | Represents a function call action on the `receiver_id`. | | **transaction.actions.FunctionCall.args** | string | Transaction-specific arguments (Base64-encoded). | | **transaction.actions.FunctionCall.deposit** | string | Amount of tokens deposited (in yoctoNEAR). | | **transaction.actions.FunctionCall.gas** | integer | Gas allocated for function execution. | | **transaction.actions.FunctionCall.method\_name** | string | The method being called on the contract. | | **transaction.hash** | string | Hash of the transaction. | | **transaction.nonce** | integer | Number of prior transactions from the signer (nonce). | | **transaction.public\_key** | string | The public key of the signer. | | **transaction.receiver\_id** | string | The account ID of the transaction receiver. | | **transaction.signature** | string | The standard `ed25519` signature type. | | **transaction.signer\_id** | string | The account ID of the transaction originator. | | **transaction\_outcome** | object | The main transaction outcome object. | | **transaction\_outcome.block\_hash** | string | The hash of the block this transaction was associated with. | | **transaction\_outcome.id** | string | The transaction ID. | | **transaction\_outcome.outcome** | object | The outcome associated with transaction execution. | | **transaction\_outcome.outcome.executor\_id** | string | The executor of the transaction. | | **transaction\_outcome.outcome.gas\_burnt** | integer | Gas consumed during execution. | | **transaction\_outcome.outcome.logs** | array | Logs generated by the transaction. | | **transaction\_outcome.outcome.metadata** | object | Describes transaction execution metadata. | | **transaction\_outcome.outcome.gas\_profile** | array | Details of gas consumption and categorization. | | **transaction\_outcome.outcome.version** | string | Version number of transaction outcome. | | **transaction\_outcome.outcome.receipt\_ids** | array | The IDs of the receipts generated. | | **transaction\_outcome.outcome.status** | string | Status of the transaction execution. | | **transaction\_outcome.outcome.successReceiptId** | string | ID of the successful receipt. | | **transaction\_outcome.outcome.tokens\_burnt** | string | Total tokens burnt. | | **transaction\_outcome.proof** | array | Cryptographic proof of the transaction. | | **transaction\_outcome.proof.hash** | string | Hash value of the proof. | | **transaction\_outcome.proof.direction** | string | Direction of the proof in Merkle path. | ## Use Cases * Retrieve **transaction status** and validate results. * Track **gas consumption and receipts**. * Display **user transaction history** in wallets or explorers. * Debug and **trace smart contract executions**. ## Code Example **Node(axios)** ```js import axios from 'axios'; let data = JSON.stringify({ "jsonrpc": "2.0", "method": "tx", "params": [ "Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN", "relay.aurora" ], "id": "getblock.io" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://shared.eu-central-1.getblock.io/', headers: { 'Content-Type': 'application/json' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` **Python(Requests)** ```python import requests import json url = "https://shared.eu-central-1.getblock.io/" payload = json.dumps({ "jsonrpc": "2.0", "method": "tx", "params": [ "Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN", "relay.aurora" ], "id": "getblock.io" }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) ``` ## Error Handling | **HTTP Code** | **Error Message** | **Description** | | ----------------------------- | --------------------------------------- | ------------------------------------------------ | | **400 Bad Request** | `Invalid transaction hash or signer_id` | Missing or malformed transaction parameters. | | **403 Forbidden** | `RBAC: access denied` | The getblock access token is missing or incrrect | | **500 Internal Server Error** | `Node processing error` | The NEAR node failed to process the request. | | **503 Service Unavailable** | `Node temporarily unavailable` | The node is syncing or temporarily offline. | ## Integration with Web3 By integrating `tx` into dApp, developers can: * Build **blockchain explorers** and **wallet transaction trackers**. * Verify transaction confirmations and receipts. * Automate **transaction monitoring** for smart contracts and bots. * Improve **user experience** by showing accurate success/failure messages.