WSS

Connect to wss://blast.nownodes.io/wss/{{api-key}} with your NOWNodes API key in the path. JSON-RPC 2.0 requests are sent as text messages over this connection; responses and subscription notifications arrive on the same connection.

eth_subscribe

Starts a subscription to one of the event types: newHeads (new block headers), logs (with an optional filter object {address, topics}), newPendingTransactions (pending transaction hashes) or minedTransactions (transaction objects as they are mined). The server answers with a subscription id and then pushes eth_subscription notifications carrying that id. Only available on WebSocket connections.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_subscribe", "id": 2, "params": ["newHeads"]}

Example response: 200

subscription created (subscription id returned)

{
    "jsonrpc": "2.0",
    "id": 2,
    "result": "0x120ac69196e4f4b0aa9fbb251a4addd1"
}

subsequent push message on the same connection (newHeads)

{
    "jsonrpc": "2.0",
    "method": "eth_subscription",
    "params": {
        "subscription": "0x120ac69196e4f4b0aa9fbb251a4addd1",
        "result": {
            "parentHash": "0x36e47e59cd78c9b5d79748e77c79706a0c3fade869d90d2d07a6b1f48f3d0ecf",
            "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
            "miner": "0x0000000000000000000000000000000000000000",
            "stateRoot": "0x173d731a33d73bed28b5e46f1f025677706d8805a1f1bd1ea06246106d7b0fe4",
            "transactionsRoot": "0xfd5cbd4b68a0f979bbfa75482c7b99b2ce40bd08025cf569b85338764de6743a",
            "receiptsRoot": "0x6131cb6d400ccbed44e9be6751ad29020b0309c6aa97ace45d4725075eff0d19",
            "logsBloom": "0x413204bc001391c1c922708917002401a300850c00f62404080205021842c02400d200a412a042a6a00048001401401519004335d220d81004bc0a20000690c0882c5182130102106000b1585105844944308dc9ae260230143501080000440186e4c0085248408201101053068488865654078207e94640200010128000300a11010026048048201108000c81088510b2c0dc41bef4a6082600611041849243a411104304a4050000a20003c188016114080209250010258d668801047100489999caa71188010009810136410524441194090d0ce22042250441160a14e1008ae4614a201080244423304020250708060989000410110090305c384410650a",
            "difficulty": "0x0",
            "number": "0x45b3e02",
            "gasLimit": "0x1c9c380",
            "gasUsed": "0x132818f",
            "timestamp": "0x69317b04",
            "extraData": "0x",
            "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "nonce": "0x0000000000000000",
            "baseFeePerGas": "0x630e876",
            "blobGasUsed": "0x0",
            "excessBlobGas": "0x0",
            "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "hash": "0xfb30b8b59f5781e82a23f6031a00533f09c40d569727c868d0725cf90a627369"
        }
    }
}

eth_unsubscribe

Cancels a subscription created with eth_subscribe, passing the subscription id as the first parameter. Returns true when the subscription was active and is now cancelled.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_unsubscribe", "id": 1, "params": ["0x120ac69196e4f4b0aa9fbb251a4addd1"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": true
}

eth_chainId

Returns the currently configured chain id used in replay-protected (EIP-155) transaction signing. Blast mainnet chain id is 0x13e31 (81457).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_chainId", "id": 1}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x13e31"
}

eth_blockNumber

Returns the number of the most recent block as a hex string.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_blockNumber", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x29d657e"
}

eth_syncing

Returns false when the node is fully synced, or a progress object with startingBlock / currentBlock / highestBlock while syncing.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_syncing", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": false
}

eth_gasPrice

Returns an estimate of the current gas price in wei (on L2 chains this reflects the L2 component).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_gasPrice", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x5d21dba00"
}

eth_estimateGas

Generates and returns an estimate of how much gas is necessary for the transaction to complete. The transaction is not added to the chain; the estimate can exceed the actually used gas.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_estimateGas", "id": 1, "params": [{"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567"}, "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x5208"
}

eth_maxPriorityFeePerGas

Returns a fee per gas that is an estimate of how much can be paid as a priority fee (tip) to get a transaction included in the current block.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_maxPriorityFeePerGas", "id": 1}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_feeHistory

Returns the base fee per gas and gas used ratio for a range of blocks, plus priority fee percentiles when requested. Parameters: blockCount (hex), newestBlock (tag or hex), reward percentiles (array of numbers 0-100, optional).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_feeHistory", "id": 1, "params": ["0x4", "latest", [10, 50]]}

Example response: 200

fee history for the last 4 blocks with 10th/50th priority percentiles

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "oldestBlock": "0x13e2c",
        "baseFeePerGas": [
            "0xa",
            "0xa",
            "0xa",
            "0xa",
            "0xa"
        ],
        "gasUsedRatio": [
            0.1,
            0.1,
            0.1,
            0.4
        ],
        "reward": [
            [
                "0x1",
                "0x2"
            ],
            [
                "0x1",
                "0x2"
            ],
            [
                "0x1",
                "0x2"
            ],
            [
                "0x1",
                "0x2"
            ]
        ]
    }
}

invalid parameters

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32602,
        "message": "invalid argument 1: hex string without 0x prefix"
    }
}

eth_getBlockByHash

Returns information about a block by hash. The second parameter controls whether transactions are returned as full objects (true) or hashes (false). Returns null for an unknown hash.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getBlockByHash", "id": 1, "params": ["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getBlockByNumber

Returns information about a block by block number (hex) or tag (latest, earliest, pending, safe, finalized). The second parameter controls full transactions versus hashes.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getBlockByNumber", "id": 1, "params": ["0x1b4", true]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "difficulty": "0x0",
        "extraData": "0x",
        "gasLimit": "0x3e4985c",
        "gasUsed": "0xcbec",
        "hash": "0x8ba0b60cee01c4a42e687596808b0332e34c7c2371b768641efe58f89e6c41c2",
        "logsBloom": "0x00000000000000000000000000000000400000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000010000000000000000000000000000000000008400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080002000000000000000000000000000000",
        "miner": "0x0000000000000000000000000000000000000000",
        "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "nonce": "0x0000000000000000",
        "number": "0x1b4",
        "parentHash": "0x04d1ccba421361c2ac227fef90be045be530b71fe486612a0250d82e40a6d102",
        "receiptsRoot": "0x3982c4136a5bda4bab50002cc86af568e308e48edae4c4705263d511cd78dc0c",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "size": "0x510",
        "stateRoot": "0x48a171ad566e60dfce51d37f29a10e22222057accd9bd7ba372461773af09b52",
        "timestamp": "0x5f9b2727",
        "totalDifficulty": "0x0",
        "transactions": [
            "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
        ],
        "transactionsRoot": "0x13be6179c3e234a1da1d93748cd8b035d5e638f43a8ee5ea593dce425f1eb9f4",
        "uncles": [],
        "baseFeePerGas": "0x630e876"
    }
}

eth_getBlockTransactionCountByHash

Returns the number of transactions in the block matching the given hash (null for an unknown hash).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByHash", "id": 1, "params": ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getBlockTransactionCountByNumber

Returns the number of transactions in the block matching the given block number.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByNumber", "id": 1, "params": ["0xe8"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1"
}

eth_getUncleByBlockHashAndIndex

Returns information about an uncle of a block by hash and uncle index position. Proof-of-stake / L2 chains have no uncles; the result is null for any index.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getUncleByBlockHashAndIndex", "id": 1, "params": ["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b", "0x0"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getUncleByBlockNumberAndIndex

Returns information about an uncle of a block by number and uncle index position; null on Blast.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getUncleByBlockNumberAndIndex", "id": 1, "params": ["0x29c", "0x0"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getUncleCountByBlockHash

Returns the number of uncles in the block matching the given hash (null for an unknown hash; Blast blocks have no uncles).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getUncleCountByBlockHash", "id": 1, "params": ["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getUncleCountByBlockNumber

Returns the number of uncles in the block matching the given number; 0x0 on Blast (no uncles).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getUncleCountByBlockNumber", "id": 1, "params": ["0xe8"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_getTransactionByHash

Returns the information about a transaction requested by transaction hash (pending or mined); null for an unknown hash.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getTransactionByHash", "id": 1, "params": ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getTransactionByBlockHashAndIndex

Returns information about a transaction by block hash and transaction index position; null when the block or index is unknown.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getTransactionByBlockHashAndIndex", "id": 1, "params": ["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b", "0x0"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_getTransactionByBlockNumberAndIndex

Returns information about a transaction by block number (or tag) and transaction index position.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getTransactionByBlockNumberAndIndex", "id": 1, "params": ["0x29c", "0x0"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x9f4a279646f77ae46ca7df63b4f31d09ef0d0e9bf33cfba52b21ccf980aa8cfe",
        "blockNumber": "0x29c",
        "from": "0x4abef613822fb2031d897e792f89c896ddafc466",
        "gas": "0x4057e",
        "gasPrice": "0x6d6e2edc00",
        "hash": "0xc1ff83cfe18bda60bc8a867bfe6c1b3a20cf2c59e0cbecdb6360f7a087d56142",
        "input": "0x",
        "nonce": "0xef",
        "to": "0x95042281af6566fc6748f28263ceeecaefb4d2b4",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x13e31",
        "v": "0x27c86",
        "r": "0xfb4fa8ce6ff4a923856ccd5d66e682bd6383c813e0e6da49be3d260bf40d3245",
        "s": "0x2156e53641c59a1f603b758acc4994472bf15634d912b2153b3a64c849de4e6a"
    }
}

eth_getTransactionCount

Returns the number of transactions sent from an address, optionally filtered by block tag.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getTransactionCount", "id": 1, "params": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_getTransactionReceipt

Returns the receipt of a mined transaction by transaction hash (null while pending or unknown).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getTransactionReceipt", "id": 1, "params": ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

eth_pendingTransactions

Returns the transactions currently pending in the node transaction pool (empty array when the pool is empty).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_pendingTransactions", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": []
}

eth_getBalance

Returns the balance of the account of the given address in wei, optionally at a block tag.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getBalance", "id": 1, "params": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_getCode

Returns the code at a given address (0x for plain accounts), optionally at a block tag.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getCode", "id": 1, "params": ["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x"
}

eth_getStorageAt

Returns the value from a storage position at a given address (32-byte hex word).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getStorageAt", "id": 1, "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

eth_call

Executes a new message call immediately without creating a transaction on the chain. Parameters: call object {from?, to, gas?, gasPrice?, value?, data?} and a block tag.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_call", "id": 1, "params": [{"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567"}, "latest"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x"
}

eth_getProof

Returns the account and storage values of the specified account, including a Merkle proof. Parameters: address, array of storage keys, block tag.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getProof", "id": 1, "params": ["0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", ["0x0"], "latest"]}

Example response: 200

proof for an empty account and empty storage key

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "address": "0xe5cb067e90d5cd1f8052b83562ae670ba4a211a8",
        "accountProof": [],
        "balance": "0x0",
        "nonce": "0x0",
        "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
        "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "storageProof": [
            {
                "key": "0x0",
                "value": "0x0",
                "proof": []
            }
        ]
    }
}

missing required argument

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32602,
        "message": "missing value for required argument 1"
    }
}

eth_createAccessList

Returns the list of addresses and storage keys read and written by the transaction (except the sender and precompiles), plus the estimated gas consumed when the access list is added.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_createAccessList", "id": 1, "params": [{"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x0", "gasPrice": "0x9184e72a000", "value": "0x0", "data": "0x"}]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "failed to apply transaction: 0x295daf8de677ee7e46bc6776b7608cb9d9f7b1550145f6228dd636e6e203492c err: intrinsic gas too low: have 0, want 21000"
    }
}

eth_newFilter

Creates a filter object based on filter options ({fromBlock, toBlock, address, topics}) to notify when the state changes (logs). Use eth_getFilterChanges to poll it.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_newFilter", "id": 73, "params": [{"fromBlock": "0x1", "toBlock": "0x2", "address": "0x8888f1f195afa192cfee860698584c030f4c9db1", "topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]}]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 73,
    "result": "0xcee1fa075b18c4fd1b8e58fe6bbc9594"
}

eth_newBlockFilter

Creates a filter in the node to notify when a new block arrives; poll it with eth_getFilterChanges.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_newBlockFilter", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xaf9a08536d6b7769455bda015537e9e9"
}

eth_newPendingTransactionFilter

Creates a filter in the node to notify when new pending transactions arrive; poll it with eth_getFilterChanges.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_newPendingTransactionFilter", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x3785d8c95d83c935d03bb57f8d7647f7"
}

eth_uninstallFilter

Uninstalls a filter with the given id; should always be called when the filter is no longer needed.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_uninstallFilter", "id": 73, "params": ["0xb"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 73,
    "result": false
}

eth_getFilterChanges

Polling method for a filter, returning an array of logs (log filters) or block/transaction hashes (block / pending-transaction filters) which occurred since the last poll.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getFilterChanges", "id": 73, "params": ["0x16"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 73,
    "error": {
        "code": -32000,
        "message": "filter not found"
    }
}

eth_getFilterLogs

Returns an array of all logs matching the filter with the given id (created with eth_newFilter).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getFilterLogs", "id": 74, "params": ["0x16"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 74,
    "error": {
        "code": -32000,
        "message": "filter not found"
    }
}

eth_getLogs

Returns an array of all logs matching the given filter object ({fromBlock, toBlock, address, topics, blockHash}).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_getLogs", "id": 74, "params": [{"topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 74,
    "result": []
}

eth_sendRawTransaction

Creates a new message call transaction or a contract creation for signed transactions. WRITE operation: the error example shows the standard RLP validation failure for a malformed payload.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_sendRawTransaction", "id": 1, "params": ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "rlp: element is larger than containing list"
    }
}

eth_sendTransaction

Creates a new message call transaction or a contract creation. Requires the sender account to be managed by the node; NOWNodes endpoints do not manage accounts, so the call answers with the unknown account error. WRITE operation.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_sendTransaction", "id": 1, "params": [{"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"}]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "unknown account"
    }
}

eth_sign

Calculates an Ethereum-specific signature: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)). Requires a node-managed account, so public endpoints answer with the unknown account error.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_sign", "id": 1, "params": ["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "unknown account"
    }
}

eth_signTransaction

Signs a transaction object with a node-managed account. Public endpoints do not manage accounts; the error example shows the validation error for an incomplete transaction object.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_signTransaction", "id": 1, "params": [{"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675", "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", "gas": "0x76c0", "gasPrice": "0x9184e72a000", "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "value": "0x9184e72a"}]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "nonce not specified"
    }
}

eth_coinbase

Returns the coinbase address (fee recipient; on L2 chains typically the sequencer address) of the node.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "eth_coinbase", "id": 64, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 64,
    "result": "0x0000000000000000000000000000000000000000"
}

net_version

Returns the current network id. Blast mainnet network id is 81457 (decimal string).

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "net_version", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "81457"
}

net_listening

Returns true if the client is actively listening for network connections.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "net_listening", "id": 1}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": true
}

net_peerCount

Returns the number of peers currently connected to the client, as a hex string.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "net_peerCount", "id": 74, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 74,
    "result": "0x0"
}

web3_clientVersion

Returns the web3 client version string of the node.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "web3_clientVersion", "id": 1, "params": []}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "v0.13.2"
}

web3_sha3

Returns Keccak-256 (not the standardized SHA3-256) of the given data.

Sent as a JSON text message over the WebSocket connection wss://blast.nownodes.io/wss/{{api-key}}.

Copied!

wss://blast.nownodes.io/wss/{{api-key}}

Example body (raw)

{"jsonrpc": "2.0", "method": "web3_sha3", "id": 1, "params": ["0x67656c6c6f20776f726c64"]}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1b84adea42d5b7d192fd8a61a85b25abe0757e9a65cab1da470258914053823f"
}