ValueChain JSON-RPC
ValueChain EVM provides Ethereum-compatible JSON-RPC over HTTP and WebSocket. Network endpoints, chain IDs, and explorer URLs are listed on ValueChain EVM.
Parameter names, encodings, and response shapes follow the Ethereum JSON-RPC and Execution API specifications unless noted on the method page.
When submitting transactions, verify the chain ID, estimate gas against the selected network, retain the transaction hash, and wait for transaction finality before starting dependent work.
Call a method
curl -sS https://mainnet.valuechain.xyz \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'Use https://testnet.valuechain.xyz or wss://testnet-ws.valuechain.xyz on testnet. Hex quantities use a 0x prefix.
Methods
Chain and node
[eth_chainId](json-rpc/eth-chainId.md)
[eth_blockNumber](json-rpc/eth-blockNumber.md)
Blocks and headers
[eth_getBlockByHash](json-rpc/eth-getBlockByHash.md)
[eth_getBlockByNumber](json-rpc/eth-getBlockByNumber.md)
[eth_getBlockReceipts](json-rpc/eth-getBlockReceipts.md)
[eth_getHeaderByHash](json-rpc/eth-getHeaderByHash.md)
[eth_getHeaderByNumber](json-rpc/eth-getHeaderByNumber.md)
[eth_getBlockTransactionCountByHash](json-rpc/eth-getBlockTransactionCountByHash.md)
[eth_getBlockTransactionCountByNumber](json-rpc/eth-getBlockTransactionCountByNumber.md)
ValueChain uses single slot finality with a 2-second slot. safe and finalized return the same block and typically lag latest by one slot. Additional confirmation depth is not required.
Accounts and state
[eth_getBalance](json-rpc/eth-getBalance.md)
[eth_getCode](json-rpc/eth-getCode.md)
[eth_getStorageAt](json-rpc/eth-getStorageAt.md)
[eth_getProof](json-rpc/eth-getProof.md)
[eth_getTransactionCount](json-rpc/eth-getTransactionCount.md)
[eth_call](json-rpc/eth-call.md)
[eth_createAccessList](json-rpc/eth-createAccessList.md)
[eth_simulateV1](json-rpc/eth-simulateV1.md)
Balances are native SOSO in wei (18 decimals), not ETH.
Transactions
[eth_getTransactionByHash](json-rpc/eth-getTransactionByHash.md)
[eth_getTransactionReceipt](json-rpc/eth-getTransactionReceipt.md)
[eth_getRawTransactionByHash](json-rpc/eth-getRawTransactionByHash.md)
[eth_getTransactionByBlockHashAndIndex](json-rpc/eth-getTransactionByBlockHashAndIndex.md)
[eth_getTransactionByBlockNumberAndIndex](json-rpc/eth-getTransactionByBlockNumberAndIndex.md)
[eth_sendRawTransaction](json-rpc/eth-sendRawTransaction.md)
Submit signed transactions with eth_sendRawTransaction.
Logs
[eth_getLogs](json-rpc/eth-getLogs.md)
Gas
[eth_gasPrice](json-rpc/eth-gasPrice.md)
[eth_maxPriorityFeePerGas](json-rpc/eth-maxPriorityFeePerGas.md)
[eth_feeHistory](json-rpc/eth-feeHistory.md)
[eth_estimateGas](json-rpc/eth-estimateGas.md)
See Gas & Fees for EIP-1559 pricing and fee calculation.
WebSocket
[eth_subscribe](json-rpc/eth-subscribe.md)
[eth_unsubscribe](json-rpc/eth-unsubscribe.md)
Use wss://mainnet-ws.valuechain.xyz or wss://testnet-ws.valuechain.xyz. HTTP requests reject eth_subscribe with notifications not supported. newHeads follows latest; safe and finalized typically lag that head by one slot.
Related documentation
ValueChain EVM — network endpoints and chain IDs
Relayer — sponsored submission when the caller does not send the raw transaction
Last updated