1. Transport & conventions
| Property | Value |
|---|
| Base URL | https://zenx.network/rpc (also http://194.31.55.222:8545) |
| Protocol | JSON-RPC 2.0 over HTTP POST; WebSocket at ws://194.31.55.222:8546 |
| Content-Type | application/json |
| Values | Quantities are hex (0x-prefixed); data are hex bytes; addresses are 20-byte hex |
| CORS | Enabled (*) — browser dApps can call directly |
| Batching | Supported — send an array of requests, receive an array of responses |
2. eth_* methods
| Method | Purpose |
|---|
eth_blockNumber | Latest block height |
eth_getBlockByNumber / eth_getBlockByHash | Block data (full tx objects or hashes) |
eth_getTransactionByHash | Transaction lookup |
eth_getTransactionReceipt | Receipt (status, gasUsed, logs) |
eth_getTransactionCount | Nonce of an account |
eth_getBalance | Native ZENX balance |
eth_getCode | Contract bytecode at an address |
eth_getStorageAt | Raw storage slot read |
eth_call | Execute a read against state without a tx (contract reads) |
eth_estimateGas | Estimate gas for a transaction |
eth_gasPrice | Current gas price suggestion |
eth_feeHistory | EIP-1559 base-fee history |
eth_getLogs | Event logs by address/topics over a block range (archive) |
eth_sendRawTransaction | Broadcast a signed transaction |
eth_chainId | Chain ID (88911) |
eth_syncing | Sync status (false when fully synced) |
eth_subscribe / eth_unsubscribe | WebSocket: newHeads, logs |
3. net_* methods
| Method | Purpose |
|---|
net_version | Network id (88911) |
net_listening | Whether the node accepts connections |
net_peerCount | Number of connected peers (hex) |
4. web3_* methods
| Method | Purpose |
|---|
web3_clientVersion | Node client identification string |
web3_sha3 | Keccak-256 of given data |
5. Worked examples
Latest block + native balance (curl)
curl -X POST https://zenx.network/rpc -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
# {"jsonrpc":"2.0","id":1,"result":"0xc039e"}
curl -X POST https://zenx.network/rpc -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xDb76978175bF9Fd68fe55694EefCe7b83ef71584","latest"],"id":2}'
Contract read — ZENX totalSupply (web3.js)
const Web3 = require('web3');
const w = new Web3('https://zenx.network/rpc');
const abi = [{ "constant": true, "inputs": [], "name": "totalSupply", "outputs": [{ "name": "", "type": "uint256" }], "type": "function" }];
const zenx = new w.eth.Contract(abi, '0xC7F0800731cF1591Cb3328E450C7aF3f40895c74');
zenx.methods.totalSupply().call().then(console.log);
Logs (python)
import requests, json
r = requests.post('https://zenx.network/rpc', json={
"jsonrpc": "2.0", "id": 1, "method": "eth_getLogs",
"params": [{"address": "0x9248C5bEDd12264A7aADA38E4a4150a8e0E75552",
"fromBlock": "0x0", "toBlock": "latest"}],
}).json()
print(len(r.get("result", []))) # total DEX events ever
6. Errors & limits
- Standard JSON-RPC errors:
-32601 method not found, -32602 invalid params, -32000 execution/gas errors, -32005 limit exceeded.
- Read reverts surface as
execution reverted; pair with eth_call on the exact method for the revert reason.
- Public endpoint limits and fair-use policy: see API & RPC — rate-limiting plan.
- Live reachability and latency: Network Status.