본문으로 건너뛰기

Xphere-Specific JSON-RPC (xp_*)

In addition to the standard Ethereum-compatible methods, Xphere exposes a custom xp_* namespace for dual-chain state and PBFT consensus introspection. These methods are unique to Xphere and have no Ethereum equivalent.

노트

All methods follow the same JSON-RPC 2.0 envelope as the eth_* namespace. Enable them with --rpcapi xp,eth,net when launching xen.

Block & Chain​

xp_blockNumber​

Returns the latest sealed Main Chain block number. Equivalent to eth_blockNumber, provided for symmetry with the xp console.

xp_getBlockWithConsensusInfo​

Returns a block plus the PBFT consensus messages (prepare, commit) that finalized it.

Parameters

  1. QUANTITY|TAG — block number or tag
  2. BOOL — if true, include full transaction objects

Returns — block object extended with consensus field:

{
  "number": "0x32d6",
  "hash": "0x...",
  "consensus": {
    "round": 0,
    "prepareMsgNum": 3,
    "commitMsgNum": 3,
    "validators": ["0xB54...", "0xA12...", "0x4F8...", "0x9D2..."]
  },
  "transactions": [...]
}

xp_getBlockWithConsensusInfoRange​

Same as above but for a range of blocks.

Parameters

  1. QUANTITY — from block
  2. QUANTITY — to block (max range: 100)

xp_getChainConfig​

Returns the active chain configuration, including fork heights.

{
  "chainId": 20250217,
  "xpHashForkBlock": 1740000,
  "blockTime": 1,
  "consensus": "PBFT",
  "proofChain": { "algorithm": "xpHash" }
}

Consensus Participants​

xp_getCommittee​

Returns the current committee — the active validator set for the current PBFT round.

Parameters — none Returns — array of validator addresses

curl -X POST https://en-hkg.x-phere.com \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"xp_getCommittee","params":[],"id":1}'
{ "jsonrpc": "2.0", "id": 1, "result": ["0x4...","0x5...","0x9...","0xf..."] }

xp_getCommitteeSize​

Returns the size of the current committee.

xp_getCouncil​

Returns the full council — all eligible validators registered on the Main Chain, regardless of whether they are in the active committee.

xp_getCouncilSize​

Returns the size of the council.

Block Receipts (Batch)​

xp_getBlockReceipts​

Returns all transaction receipts in a single block. Faster than calling eth_getTransactionReceipt per-tx.

Parameters

  1. QUANTITY|TAG — block number or tag

Compatibility Helpers​

xp_getBlock / xp_getBlockNumber / xp_getBlockTransactionCount / xp_getCode​

Mirror their eth_* counterparts under the xp namespace for compatibility with the xen JavaScript console.

Discovering Available Modules​

To check which namespaces an endpoint exposes:

curl -X POST https://en-hkg.x-phere.com \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"rpc_modules","params":[],"id":1}'
{ "result": { "eth": "1.0", "net": "1.0", "rpc": "1.0", "xp": "1.0" } }

If xp is missing, the operator has disabled it — use a different endpoint or run your own XEN with --rpcapi xp,eth,net.

See Also​