API Reference
Cross-language API reference for all chain types
All Lux chains expose JSON-RPC APIs. The SDK wraps these APIs with typed clients in each language.
| API | Endpoint | Description |
|---|
| P-Chain | /ext/bc/P | Validators, chains, staking, delegations |
| X-Chain | /ext/bc/X | UTXO operations, asset creation and transfer |
| C-Chain | /ext/bc/C/rpc | EVM JSON-RPC (eth, net, web3 namespaces) |
| Sovereign L1 EVM | /ext/bc/{name}/rpc | Same as C-Chain, per-chain endpoint |
| Info | /ext/info | Node info, network ID, node ID |
| Health | /ext/health | Node and chain health status |
| Admin | /ext/admin | Node administration (whitelisted) |
| Method | Description |
|---|
platform.getCurrentValidators | List active validators with stake and uptime |
platform.getPendingValidators | Validators waiting to join |
platform.getBlockchains | All blockchains registered on the network |
platform.getSubnets | All chains with validator membership |
platform.getBalance | P-Chain address balance |
platform.getTx | Transaction by ID |
platform.getHeight | Current P-Chain height |
| Method | Description |
|---|
xvm.getBalance | Address balance for a specific asset |
xvm.getUTXOs | Unspent transaction outputs |
xvm.send | Send assets (requires unlocked keystore) |
xvm.getAssetDescription | Asset metadata (name, symbol, denomination) |
xvm.getTx | Transaction by ID |
Standard Ethereum JSON-RPC methods are supported:
| Method | Description |
|---|
eth_blockNumber | Latest block number |
eth_getBalance | Account balance in wei |
eth_sendRawTransaction | Broadcast signed transaction |
eth_call | Read-only contract call |
eth_getTransactionReceipt | Transaction receipt with logs |
eth_getLogs | Filter event logs |
eth_subscribe | WebSocket subscriptions (newHeads, logs) |
curl -X POST http://127.0.0.1:9630/ext/info \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"info.getNodeID","params":{},"id":1}'
| Method | Description |
|---|
info.getNodeID | Node's ID and BLS public key |
info.getNetworkID | Network ID (1=mainnet, 2=testnet) |
info.getNetworkName | Human-readable network name |
info.getBlockchainID | Blockchain ID for a given alias |
info.peers | Connected peers |