API REFERENCE
REST · JSON-RPC · WebSocket
Endpoints
REST + JSON-RPChttps://rpc.sentrixchain.com
WebSocketwss://rpc.sentrixchain.com/ws
Sourcify (verifier)https://verify.sentrixchain.com
Faucet (testnet)https://faucet.sentrixchain.com
All EVM JSON-RPC methods POST to https://rpc.sentrixchain.com/rpc; native REST endpoints below are GET / POST against https://rpc.sentrixchain.com.
REST API — 25 endpoints
| Method | Path | Description | curl |
|---|---|---|---|
| GET | /chain/info | Chain headline (height, supply, validator count, mempool size). | |
| GET | /chain/blocks?page=N&limit=M | Paginated block list (limit ≤100; in-memory window = last 1000 blocks). | |
| GET | /chain/blocks/{height} | Block detail by height — includes transactions + justification. | |
| GET | /sentrix_status | Node status: chain ID, consensus mode, version, sync info. | |
| GET | /health | Health probe — returns 200 OK while node is responsive. | |
| GET | /metrics | Prometheus scrape — chain + system metrics. | |
| GET | /accounts/{address} | Account balance + nonce + tx count. | |
| GET | /accounts/top?limit=N | Top accounts by balance (richlist). | |
| GET | /address/{address}/history?page=N | Per-address tx history (paginated). | |
| GET | /transactions/{txid} | Transaction detail — wraps tx + block context. | |
| POST | /transactions | Submit a signed native tx. Body: TxRequest (txid + signature + payload). | |
| GET | /mempool | Live pending transactions snapshot. | |
| GET | /tokens | List of deployed SRC-20 tokens. | |
| GET | /tokens/{address} | Token detail (name, symbol, total supply, holder count). | |
| GET | /tokens/{address}/holders?limit=N | Top holders for a given token. | |
| POST | /tokens/deploy | Deploy a new SRC-20 token (signed). | |
| POST | /tokens/transfer | Native SRC-20 transfer (signed). | |
| POST | /tokens/burn | Native SRC-20 burn (signed). | |
| GET | /staking/validators | Active + jailed validator set with stake breakdown. | |
| GET | /staking/validators/{address} | Per-validator detail (commission, blocks produced, jail flags). | |
| GET | /staking/delegations/{address} | All delegations FROM an account. | |
| GET | /staking/rewards/{address} | Pending + claimed rewards for an address. | |
| GET | /epoch/current | Current epoch number, block range, accrued rewards. | |
| GET | /stats/daily | Daily aggregates (txs, active addresses, supply delta). | |
| GET | /chain/performance?range=24h | Block-time + TPS series across a window. |
JSON-RPC — 24 methods
| Namespace | Method | Description | curl |
|---|---|---|---|
| eth_ | eth_chainId | Returns the chain ID (7119 mainnet, 7120 testnet). | |
| eth_ | eth_blockNumber | Latest block height. | |
| eth_ | eth_getBlockByNumber | Block detail (full EVM-shape with mixHash / stateRoot / receiptsRoot). | |
| eth_ | eth_getBalance | Account balance (18-decimal wei view). | |
| eth_ | eth_getTransactionByHash | Transaction detail. | |
| eth_ | eth_getTransactionReceipt | Receipt with logs + status (1=success, 0=revert). | |
| eth_ | eth_call | Execute a read-only call against the EVM state. | |
| eth_ | eth_estimateGas | Gas estimate for a candidate tx. | |
| eth_ | eth_sendRawTransaction | Submit a signed RLP-encoded EVM tx. | |
| eth_ | eth_getLogs | Event log filter (by address + topics + block range). | |
| eth_ | eth_gasPrice | Current base fee (EIP-1559). | |
| eth_ | eth_feeHistory | Recent base-fee history for fee oracles. | |
| eth_ | eth_getCode | Contract bytecode at a given address. | |
| eth_ | eth_getStorageAt | Storage slot read. | |
| eth_ | eth_getTransactionCount | Account nonce. | |
| eth_ | eth_subscribe | WebSocket-only — see WS section below. | |
| sentrix_ | sentrix_getFinalizedHeight | BFT-finalized height — safe-to-rely-on tip. | |
| sentrix_ | sentrix_getValidatorSet | Active validator set with stakes. | |
| sentrix_ | sentrix_getEpochInfo | Current epoch metadata. | |
| sentrix_ | sentrix_getJailEvents | Recent jail / unjail events. | |
| sentrix_ | sentrix_getDelegations | Per-address delegations. | |
| sentrix_ | sentrix_estimateRewards | Pending claimable rewards. | |
| net_ | net_version | Network ID as decimal string. | |
| web3_ | web3_clientVersion | Node software version. |
WebSocket subscriptions — 9 channels
All channels — including the Sentrix-native ones — are subscribed via eth_subscribe. There is no separate sentrix_subscribe method on the chain (common confusion source).
| Channel | Description | JSON-RPC body |
|---|---|---|
| newHeads | New block headers as they finalize. | |
| logs | Filtered log stream — second param is the filter object. | |
| newPendingTransactions | Mempool admission events. | |
| syncing | Sync-status changes. | |
| sentrix_finalized | Sentrix-native: BFT-finalized block notification. | |
| sentrix_validatorSet | Sentrix-native: validator-set rotation events. | |
| sentrix_tokenOps | Sentrix-native: SRC-20 Mint/Burn/Transfer/Approve/Deploy. | |
| sentrix_stakingOps | Sentrix-native: Delegate/Undelegate/ClaimRewards/AddSelfStake/Unjail. | |
| sentrix_jail | Sentrix-native: per-validator jail/unjail events. |
Official SDKs
TypeScript: @sentrix/chain — viem-based EVM client + native REST client + WebSocket subscription manager + native-tx wallet (sign + submit Delegate / Undelegate / ClaimRewards / SRC-20 ops).
pnpm add @sentrix/chain viem
import { native, evm, bft, SentrixWallet } from "@sentrix/chain";
const sentrix = native.nativeClient("mainnet");
const info = await sentrix.chainInfo();
console.log(`Height ${info.height}`);Repo: sentriscloud/sdk-ts