EmpoorioChain

Appearance

API reference ​

EmpoorioChain nodes expose a Substrate-compatible JSON-RPC API over HTTP and WebSocket.

Public testnet ​

HTTP RPC:   https://testnet.empooriochain.org
WebSocket:  wss://testnet.empooriochain.org

Use these URLs in SDKs and tools. Do not embed private validator or internal IPs in applications.

Common JSON-RPC methods ​

Chain metadata ​

bash
curl -s -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"system_chain","params":[]}' \
  https://testnet.empooriochain.org
bash
curl -s -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"system_properties","params":[]}' \
  https://testnet.empooriochain.org

system_properties returns token symbol and decimals (DMS, 18 decimals on local nodes per operator docs).

Latest block height ​

bash
curl -s -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain_getHeader","params":[]}' \
  https://testnet.empooriochain.org

SDK-first integration ​

Most applications should use:

  • TypeScript: @empoorio/sdk (Polkadot.js-based)
  • Rust: empoorio-sdk + subxt
  • CLI: emp for operator and protocol commands

The SDKs wrap RPC calls, signing, and subscriptions — prefer them over raw RPC when possible.

EVM (Frontier) ​

Solidity tooling can target the Frontier EVM layer. Testnet EVM chain ID: 27777 (from chain configuration in the repository).

Local EVM JSON-RPC in dev setups may use port 8545 on your machine — that is not a public Empoorio endpoint.

REST / EmpProtocols ​

The repository describes additional REST-style protocol surfaces in docs/03_DEVELOPMENT/API_AND_SDK_REFERENCE.md. Only use base URLs that are officially announced for your environment. This marketing site documents the public testnet RPC/WebSocket above.