For the complete documentation index, see llms.txt. This page is also available as Markdown.

zks_getTransactionDetails - Lens

Example code for the zks_getTransactionDetails JSON-RPC method. Complete guide on how to use zks_getTransactionDetails JSON-RPC in GetBlock Web3 documentation.

Returns Lens-specific details for a transaction: whether it originated on L1, its status, the fee paid, the initiator, and the gas-per-pubdata limit used by the ZK fee model.

Parameters

Parameter
Type
Required
Description

txHash

string

Yes

Transaction hash

Request

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "zks_getTransactionDetails",
    "params": ["0x6c0f1d0d6b9f6a2e3c4b8a7f5e9d0c1a3b5f7e9d2c4a6b8f0e1d3c5a7b9f1e2d"],
    "id": "getblock.io"
}'
example.js
const axios = require('axios');
const response = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', { jsonrpc: '2.0', method: 'zks_getTransactionDetails', params: ["0x6c0f1d0d6b9f6a2e3c4b8a7f5e9d0c1a3b5f7e9d2c4a6b8f0e1d3c5a7b9f1e2d"], id: 'getblock.io' }, { headers: { 'Content-Type': 'application/json' } });
console.log(response.data.result);
example.py
import requests
response = requests.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', headers={'Content-Type': 'application/json'}, json={'jsonrpc': '2.0', 'method': 'zks_getTransactionDetails', 'params': ["0x6c0f1d0d6b9f6a2e3c4b8a7f5e9d0c1a3b5f7e9d2c4a6b8f0e1d3c5a7b9f1e2d"], 'id': 'getblock.io'})
print(response.json())
example.rs
use reqwest::Client;
use serde_json::{json, Value};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client.post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/").json(&json!({"jsonrpc":"2.0","method":"zks_getTransactionDetails","params":["0x6c0f1d0d6b9f6a2e3c4b8a7f5e9d0c1a3b5f7e9d2c4a6b8f0e1d3c5a7b9f1e2d"],"id":"getblock.io"})).send().await?.json::<Value>().await?;
    println!("{}", res["result"]);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "isL1Originated": false,
        "status": "verified",
        "fee": "0x1a2b3c",
        "initiatorAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "receivedAt": "2025-11-01T12:00:00Z",
        "gasPerPubdata": "0x320"
    }
}

Response Fields

Field
Type
Description

isL1Originated

boolean

Whether the tx came from an L1 deposit

status

string

Settlement status

fee

string

Fee paid in wei

gasPerPubdata

string

Gas per pubdata byte used

Use Cases

  • Status Polling: Track a tx to L1 finality

  • Fee Accounting: Read the exact fee and pubdata cost

Error Handling

Error
Message
Description

-32602 / Invalid params

Invalid params

A parameter was malformed

403 / RBAC: access denied

Access denied

The GetBlock access token is missing or incorrect

Was this helpful?