eth Namespace

Ethereum-compatible RPC methods for blockchain interaction

Overview

The eth namespace provides Ethereum-compatible methods for querying blockchain data, managing accounts, and submitting transactions.

Blockchain Queries

eth_blockNumber

Returns the number of the most recent block.

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  https://rpc.viction.xyz

result · string

The current block number as a hexadecimal string

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}

---

eth_getBlockByNumber

Returns information about a block by block number.

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x4b7",true],"id":1}' \
  https://rpc.viction.xyz

params[0] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

params[1] · boolean · required

If true, returns full transaction objects; if false, returns only transaction hashes

result · object

Block object or null if block not found

Show properties

number · string

Block number (hex)

hash · string

Block hash

parentHash · string

Hash of parent block

miner · string

Address of block creator

timestamp · string

Unix timestamp (hex)

gasLimit · string

Gas limit (hex)

gasUsed · string

Gas used (hex)

transactions · array

Array of transaction objects or hashes

---

eth_getBlockByHash

Returns information about a block by block hash.

params[0] · string · required

32-byte block hash

params[1] · boolean · required

If true, returns full transaction objects; if false, returns only transaction hashes

---

eth_getBalance

Returns the balance of an account at a given block.

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","latest"],"id":1}' \
  https://rpc.viction.xyz

params[0] · string · required

20-byte account address

params[1] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

result · string

Balance in wei (hex)

---

eth_getStorageAt

Returns the value from a storage position at a given address.

params[0] · string · required

20-byte account address

params[1] · string · required

Storage position (hex)

params[2] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

---

eth_getCode

Returns code at a given address.

params[0] · string · required

20-byte account address

params[1] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

result · string

Contract bytecode (hex) or “0x” if account has no code

---

Transactions

eth_getTransactionCount

Returns the number of transactions sent from an address (nonce).

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","latest"],"id":1}' \
  https://rpc.viction.xyz

params[0] · string · required

20-byte account address

params[1] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

result · string

Transaction count (hex)

---

eth_getTransactionByHash

Returns information about a transaction by transaction hash.

params[0] · string · required

32-byte transaction hash

result · object

Transaction object or null if not found

Show properties

hash · string

Transaction hash

from · string

Sender address

to · string

Recipient address (null for contract creation)

value · string

Value transferred in wei (hex)

gas · string

Gas provided (hex)

gasPrice · string

Gas price in wei (hex)

nonce · string

Transaction nonce (hex)

input · string

Transaction data (hex)

blockHash · string

Block hash (null if pending)

blockNumber · string

Block number (hex, null if pending)

transactionIndex · string

Transaction index in block (hex, null if pending)

---

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

params[0] · string · required

32-byte transaction hash

result · object

Receipt object or null if not found

Show properties

transactionHash · string

Transaction hash

blockHash · string

Block hash

blockNumber · string

Block number (hex)

from · string

Sender address

to · string

Recipient address

gasUsed · string

Gas used (hex)

cumulativeGasUsed · string

Cumulative gas used (hex)

contractAddress · string

Contract address created (null if not a contract creation)

logs · array

Array of log objects

status · string

1 (success) or 0 (failure) (hex)

---

eth_sendRawTransaction

Submits a signed transaction to the network.

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xf86c..."],"id":1}' \
  https://rpc.viction.xyz

params[0] · string · required

Signed transaction data (hex)

result · string

32-byte transaction hash

---

Call and Estimation

eth_call

Executes a new message call immediately without creating a transaction.

params[0] · object · required

Transaction call object

Show properties

from · string

Sender address (optional)

to · string · required

Recipient address

gas · string

Gas provided (optional)

gasPrice · string

Gas price (optional)

value · string

Value to transfer (optional)

data · string

Transaction data (optional)

params[1] · string · required

Block number (hex) or “latest”, “earliest”, “pending”

result · string

Return value of executed contract (hex)

---

eth_estimateGas

Generates and returns an estimate of gas needed to complete the transaction.

params[0] · object · required

Transaction call object (same as eth_call)

result · string

Estimated gas amount (hex)

---

Network and Protocol

eth_chainId

Returns the chain ID of the network.

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' \
  https://rpc.viction.xyz

result · string

Chain ID (hex): “0x58” for mainnet, “0x59” for testnet

---

eth_syncing

Returns an object with sync status data or false.

result · object|boolean

Sync status object or false if not syncing

Show properties (if syncing)

startingBlock · string

Block at which sync started (hex)

currentBlock · string

Current block number (hex)

highestBlock · string

Estimated highest block (hex)

---

eth_gasPrice

Returns the current gas price in wei.

result · string

Gas price in wei (hex)

---

eth_protocolVersion

Returns the current Ethereum protocol version.

result · string

Protocol version (hex)

---

Viction-Specific Methods

eth_getOwnerByCoinbase

Returns the masternode owner address for a given coinbase address.

params[0] · string · required

Coinbase address

params[1] · string · required

Block number (hex) or “latest”

result · string

Owner address

---

eth_getRewardByHash

Returns the reward information for a block by hash.

params[0] · string · required

Block hash

result · object

Reward details organized by type and recipient