Documentation
Docs23. `eth_` Methods (30 Methods)

23. eth_ Methods (30 Methods)

Kortana natively implements 30 standard Ethereum JSON-RPC methods, guaranteeing seamless compatibility with MetaMask, ethers.js, viem, and Web3 tooling.

23.1 Chain & Blocks

Kortana provides complete implementation of all core Ethereum chain query methods, allowing Web3 clients to inspect the canonical blockchain state seamlessly.

  • eth_chainId: Returns the integer chain ID formatted as a hex string (e.g., 0x11B3F for Testnet 72511, 0x232A for Mainnet 9002).
  • eth_blockNumber: Returns the numeric height of the most recently finalized block carrying a valid Quorum Certificate.
  • eth_getBlockByHash, eth_getBlockByNumber: Returns full block header metadata, transactions, gas limits, and BLS Quorum Certificates for the requested block identifier or tag (latest, earliest, pending).
  • eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber: Returns the total number of transactions executed in the specified block.
  • eth_getUncleCountByBlockHash, eth_getUncleCountByBlockNumber: Always returns 0x0 because Kortana's BFT consensus guarantees deterministic single-chain progression without uncle or orphan blocks.
  • eth_syncing: Returns false when the node is fully synchronized, or an object containing startingBlock, currentBlock, highestBlock, and knownStates when synchronization is active.
  • eth_mining: Always returns false since Kortana utilizes BFT Proof-of-Stake rather than Proof-of-Work mining.

23.2 Transactions

Transaction submission and inspection methods adhere strictly to standard Ethereum JSON-RPC 2.0 specifications.

  • eth_sendRawTransaction: Ingests an RLP-encoded serialized transaction payload (supporting Legacy Type 0, EIP-2930 Type 1, EIP-1559 Type 2, and native Type 0x30-0x40 envelopes). The node validates the signature, admits the transaction to the mempool, and returns the 32-byte transaction hash.
  • eth_getTransactionByHash: Retrieves detailed transaction information, including nonce, gas price, tip cap, input calldata, sender address, and recipient.
  • eth_getTransactionByBlockHashAndIndex, eth_getTransactionByBlockNumberAndIndex: Returns transaction details based on its exact position within a canonical block.
  • eth_getTransactionReceipt: Fetches the authoritative execution receipt, recording execution status (0x1 for success, 0x0 for revert), cumulative gas consumed, effective gas price, contract address (if created), and all emitted event log objects.
  • eth_getTransactionCount: Returns the current execution nonce for an account, enabling client wallets to accurately assign sequential nonces to outbound transactions.

23.3 State

State inspection methods query the unified Merkle-Patricia State Trie directly at the latest committed block tip.

  • eth_getBalance: Returns the native Dinar ($DNR) balance of a given account address formatted as a hexadecimal wei value (10^18 wei = 1 DNR).
  • eth_getCode: Returns the executable bytecode stored at an address. If the address hosts a native Quorlin contract, this method returns the raw KVM binary module prefixed with 4B564D00; if it hosts a Solidity contract, it returns standard EVM runtime bytecode.
  • eth_getStorageAt: Returns the 32-byte hexadecimal value stored at a designated contract storage key slot.
  • eth_getProof: Generates an EIP-1186 Merkle-Patricia Trie proof containing account proofs and storage proofs, allowing light clients and bridge relayers to verify state cryptographically against the header state_root.
  • eth_accounts: Always returns an empty array [] as kortanad is an enterprise node that does not store unencrypted private keys in process memory.

23.4 Execution & Gas

Kortana provides gas estimation and state simulation methods powered by isolated sandbox execution frames.

  • eth_call: Executes a read-only message call directly against the current state trie without committing changes to disk or creating an on-chain transaction. This method is used by dApps to read view and pure functions in Solidity and reads functions in Quorlin.
  • eth_estimateGas: Simulates transaction execution through binary search to determine the precise gas limit required for the transaction to complete without running out of gas.
  • eth_gasPrice: Returns the current recommended base gas price in wei, calculated based on the latest EIP-1559 base fee plus median priority tip trends.
  • eth_maxPriorityFeePerGas: Computes the suggested priority fee per gas (validator tip) needed to secure timely inclusion in the next proposed block.
  • eth_feeHistory: Returns historical EIP-1559 fee market trends, including base fee progression, block gas target fullness ratios, and priority fee percentiles across recent blocks.

23.5 Logs & Subscriptions

Event log filtering and real-time pub/sub streams allow applications and indexers to monitor smart contract activity efficiently.

  • eth_getLogs: Searches historical transaction receipts across a specified block range, returning all event logs that match declared contract address filters and 32-byte indexed topic arrays.
  • eth_subscribe: Establishes a persistent WebSocket subscription stream for live events, supporting newHeads (pushing new block headers upon BFT finalization), logs (pushing matched smart contract events in real time), and newPendingTransactions (broadcasting transaction hashes admitted to the local mempool).
  • eth_unsubscribe: Unregisters an active WebSocket subscription using its unique subscription identifier string.
Previous 22. OverviewNext24. `ktn_` Methods (18 Methods)