Tetreum Testnet RPC API

Tetreum Testnet ETH RPC Methods Reference

Complete reference for Ethereum JSON-RPC methods available on Tetreum Testnet.

Quick Reference

Tetreum Testnet is a Geth-based PoA network and provides an EVM-compatible JSON-RPC endpoint.

RPC Endpoint

https://testrpc.tetreum.com

Explorer

https://testnet.tetscan.com/

Network Details

• Network Name: Tetreum Testnet

• Chain ID: 793788

• Currency Symbol: TET

• Consensus: PoA

• Client: Geth

Wallet Configuration

Network Name: Tetreum Testnet
RPC URL: https://testrpc.tetreum.com
Chain ID: 793788
Currency Symbol: TET
Block Explorer URL: https://testnet.tetscan.com/

Methods Overview

Read Operations

Method	Description	Parameters
eth_blockNumber	Get latest block number	None
eth_getBalance	Get account balance	address, block
eth_getTransactionCount	Get nonce	address, block
eth_getCode	Get contract bytecode	address, block
eth_getStorageAt	Get storage value	address, position, block
eth_gasPrice	Get current gas price	None
eth_chainId	Get chain ID	None

Transaction Operations

Method	Description	Parameters
eth_getTransactionByHash	Get transaction details	hash
eth_getTransactionReceipt	Get transaction receipt	hash
eth_sendRawTransaction	Submit signed transaction	signedData

Block Operations

Method	Description	Parameters
eth_getBlockByNumber	Get block by number	blockNumber, fullTx
eth_getBlockByHash	Get block by hash	blockHash, fullTx

Call Operations

Method	Description	Parameters
eth_call	Execute contract call	transaction, block
eth_estimateGas	Estimate gas cost	transaction, block

Log Operations

Method	Description	Parameters
eth_getLogs	Get event logs	filter

1

eth_blockNumber

Purpose: Get the latest block number.

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

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

2

eth_getBalance

Purpose: Get account balance.

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x0000000000000000000000000000000000000000",
    "latest"
  ],
  "id": 1
}

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

3

eth_getLogs

Purpose: Get matching event logs.

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "fromBlock": "0x1",
      "toBlock": "latest",
      "topics": []
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": [],
  "id": 1
}

4

eth_gasPrice

Purpose: Get current gas price.

{
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

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

5

eth_getTransactionByHash

Purpose: Get transaction details by hash.

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
    "from": "0x...",
    "to": "0x...",
    "value": "0x...",
    "gas": "0x...",
    "gasPrice": "0x...",
    "input": "0x...",
    "nonce": "0x...",
    "blockNumber": "0x...",
    "blockHash": "0x...",
    "transactionIndex": "0x..."
  },
  "id": 1
}

6

eth_getTransactionReceipt

Purpose: Get transaction receipt.

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "transactionHash": "0x88df...",
    "transactionIndex": "0x1",
    "blockHash": "0x...",
    "blockNumber": "0x...",
    "from": "0x...",
    "to": "0x...",
    "cumulativeGasUsed": "0x...",
    "gasUsed": "0x5208",
    "contractAddress": null,
    "logs": [],
    "logsBloom": "0x...",
    "status": "0x1"
  },
  "id": 1
}

7

eth_chainId

Purpose: Get chain ID.

{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

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

8

eth_getTransactionCount

Purpose: Get nonce for an address.

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x0000000000000000000000000000000000000000",
    "latest"
  ],
  "id": 1
}

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

9

eth_getCode

Purpose: Get bytecode at an address.

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x0000000000000000000000000000000000000000",
    "latest"
  ],
  "id": 1
}

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

10

eth_getStorageAt

Purpose: Get value from storage position.

{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x0000000000000000000000000000000000000000",
    "0x0",
    "latest"
  ],
  "id": 1
}

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

11

eth_estimateGas

Purpose: Estimate gas cost.

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x0000000000000000000000000000000000000000",
      "to": "0x0000000000000000000000000000000000000000",
      "value": "0x0"
    },
    "latest"
  ],
  "id": 1
}

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

12

eth_getBlockByNumber

Purpose: Get block information by number.

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": ["latest", false],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "number": "0x123456",
    "hash": "0x...",
    "parentHash": "0x...",
    "timestamp": "0x...",
    "transactions": ["0x..."],
    "gasLimit": "0x...",
    "gasUsed": "0x...",
    "miner": "0x..."
  },
  "id": 1
}

13

eth_getBlockByHash

Purpose: Get block information by hash.

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x9b83c12c69edb74f6c8dd5d052765c1adf940e320bd1291696e6fa07829eee71",
    false
  ],
  "id": 1
}

14

eth_sendRawTransaction

Purpose: Submit a signed transaction.

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0xf86c098504a817c800825208943535353535353535353535353535353535353535880de0b6b3a76400008025a028ef61340bd939bc2195fe537567866003e1a15d3c71ff63e1590620aa636276a067cbe9d8997f761aecb703304b3800ccf555c9f3dc64214b297fb1966a3b6d83"
  ],
  "id": 1
}

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

15

eth_call

Purpose: Execute a contract call without creating a transaction.

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "to": "0x0000000000000000000000000000000000000000",
      "data": "0x"
    },
    "latest"
  ],
  "id": 1
}

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

Usage Tips

Batch Requests

[
  {
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  },
  {
    "jsonrpc": "2.0",
    "method": "eth_gasPrice",
    "params": [],
    "id": 2
  }
]

Error Handling

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid params"
  },
  "id": 1
}

• -32700 = Parse error

• -32600 = Invalid request

• -32601 = Method not found

• -32602 = Invalid params

• -32603 = Internal error