API Reference
Complete technical reference for InterLayer's JSON-RPC API, runtime pallets, and error codes.
JSON-RPC Methods
Chain Methods
chain_getBlock
Get block details by hash or number
// Request
POST /rpc
{"jsonrpc": "2.0", "method": "chain_getBlock", "params": ["0xABC..."], "id": 1}
// Response
{"jsonrpc": "2.0", "result": {"block": {...}, "justifications": null}, "id": 1}
chain_getHeader
Get block header by hash
{"jsonrpc": "2.0", "method": "chain_getHeader", "params": [], "id": 1}
// Returns latest header if params empty
chain_getFinalizedHead
Get hash of the last finalized block
{"jsonrpc": "2.0", "method": "chain_getFinalizedHead", "params": [], "id": 1}
MEL Custom Methods
mel_submitCrossVmTx
Submit an atomic MEL-enveloped cross-VM transaction payload directly to the Unified Matrix.
// Request Example
{
"jsonrpc": "2.0",
"method": "mel_submitCrossVmTx",
"params": {
"from": [4, 112, 235, ...],
"to": [21, 95, 12, ...],
"vm": { "EVM": null },
"payload": [248, 110, 130, ...],
"gas_budget": 21000,
"nonce": 1717234399000,
"chain_id": 2021,
"auth_scheme": { "Native": null }
}
}
Authentication Schemes: Matches Ecdsa, Ed25519, Sr25519, or Native (delegating verification directly to the internal VM signature decoder).
mel_getVmState
Query VM-specific state
{"method": "mel_getVmState", "params": {"vm": "EVM", "address": "0x..."}}
mel_estimateGas
Estimate unified gas for cross-VM call
{"method": "mel_estimateGas", "params": [...]}
// Returns gas in unified units
State Methods
state_getStorage
Query chain state by storage key
{"method": "state_getStorage", "params": ["0x26aa394eea5630e07c48ae0c9558cef7"]}
state_getMetadata
Get runtime metadata
{"method": "state_getMetadata", "params": []}
Runtime Pallets
InterLayer ships with 35+ runtime pallets across governance, execution, bridging, DeFi, liquidity, and security. Fees are routed 80% to validators/delegators, 10% to LiteVerse reward pools, and the remainder to treasury.
| Pallet | Category | Purpose |
|---|---|---|
| mel-core / mel-bus | MEL | Multi-VM scheduler, atomic bundles, routing |
| mel-evm / mel-svm / mel-move / mel-cosmwasm / mel-polkavm | MEL | Per-VM adapter API for execution |
| fee-distribution | Economics | On-chain fee splitter (80% validators / 10% LiteVerse / 10% treasury) |
| delegated-staking | Staking | Validators, self-bond, delegations, unbonding, eras, commission |
| hotstuff-consensus / hotstuff-session / block-timing | Consensus | HotStuff BFT, authority sets, 100ms slots |
| pallet-handles | Identity | Human-readable usernames + cross-chain mapping |
| pallet-smart-accounts | Identity | External wallet binding and execution nonces |
| pallet-unified-balance | Core | Shared balance ledger for atomic cross-VM execution |
| pallet-interlayer-token | Economics | Native IL asset issuance and transfers |
| pallet-interlayer-native-assets | Bridging | MPC-backed deposit addresses, withdrawal batching |
| bridge-pallet / settlement / dex / registry | DeFi | Shadow bridge, swaps, token registry |
| multi-vm-governance | Governance | Per-VM council tracks and proposal lifecycle |
| governance / treasury-liquidity / agent | Governance | Council votes, treasury ops, agent hooks |
| mev-protection / mev-controls | Security | MEV guards and ordering controls |
| quantum-signatures / pq-signatures | Security | Post-quantum / quantum-resistant signature pallets |
| zk-verification | Security | On-chain ZK proof verification primitives |
| atomic-execution | Execution | Atomic transaction execution guarantees |
| liteverse-pallet | Lite Clients | Watch tasks, rewards for BTC/SOL/ETH watchers |
| faucet | Infra | Rate-limited testnet tokens, store-eviction-safe history |
| gas-sponsorship / payment-channels | Infra | Sponsored gas and payment channel support |
| monitoring / slashing / session-management | Infra | Validator monitoring, slashing, session handover |
| rate-limit / dynamic-blocks / data-availability-hooks | Consensus | Rate limits, dynamic block sizing, bridge DA hooks |
| interoperability | Bridging | Cross-chain interoperability primitives |
| fees | Economics | Fee calculation and routing primitives |
| validator-set / staking-reward-payout | Staking | Validator set management and reward payout |
Runtime APIs Included in the Node
The InterLayer node exposes more than a generic Substrate runtime API set. These custom APIs are accessed via the node RPC layer and power the portal, explorer, SDKs, and wallet integrations.
| API | Layer | Key Capabilities |
|---|---|---|
| MelEvmApi / MelSvmApi / MelMoveApi / MelCosmApi / MelPolkaVmApi / MelUnifiedApi | MEL | Per-VM dry-run, execution, estimate gas, balance/nonce/code/storage queries, unified account lookup |
| LiteverseApi | Lite Clients | Watch address management, available bridge tasks, watcher rewards |
| HandlesApi | Identity | Resolve handles, reverse lookup handles, availability checks |
| UnifiedAddressApi | Identity | Resolve per-VM addresses from a handle, reverse resolve VM address to handle |
| FaucetApi | Infra | Address resolution, balance lookup, last request timestamps, request counts, total distributed |
| SmartAccountsApi | Security | VM account mapping, bound wallet enumeration, execution/binding nonces |
| PortalApi | Portal | Account overview, supported wallet types, validator list, network/staking/portfolio/governance overviews, governance proposals |
| StakingApi | Staking | Staking config, current era, overview, validator views, account views |
| GasSponsorshipApi | Infra | Sponsor deposit balance, gas budget, gas used, active status, user allowlists |
| HotStuffApi | Consensus | Current validator authorities, current slot, current view/epoch |
Error Codes
NonceTooLow
Code: 2001
Transaction nonce incorrect
Solution:
Use correct account nonce
InsufficientBalance
Code: 2002
Account balance too low to cover fees
Solution:
Fund account or reduce transfer amount
VmTypeNotSupported
Code: 2003
Requested VM type is not active
Solution:
Use EVM, SVM, PolkaVM, Move, or CosmWasm
SvmAccountNotFound
Code: 2004
SVM account not yet initialized
Solution:
Initialize the account by transferring lamports via svm_airdrop
GasSponsorshipInvalid
Code: 2005
Sponsor is inactive or user not allowlisted
Solution:
Check sponsor status and user allowlist
AtomicExecutionFailed
Code: 2006
One or more calls in an atomic bundle reverted
Solution:
Check individual VM receipts in receipt.vm_error
HandleUnavailable
Code: 3000
Requested handle/username is taken
Solution:
Choose an alternative handle
StakingCandidateNotActive
Code: 4000
Validator candidate is not in Active status
Solution:
Wait for candidate activation or pick another candidate
WebSocket Subscriptions
chain_subscribeNewHeads
Subscribe to new block headers
const
unsubscribe = await api.rpc.chain.subscribeNewHeads((header) => {console.log(`New block #${header.number}`);
});state_subscribeStorage
Subscribe to storage changes
api.rpc.state.subscribeStorage([key], (changes) => { ... })