> For the complete documentation index, see [llms.txt](https://docs.tetreum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tetreum.com/api-archive/tetreum-testnet-rpc-api.md).

# 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     |

{% stepper %}
{% step %}

### eth\_blockNumber

**Purpose:** Get the latest block number.

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

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

{% endstep %}

{% step %}

### eth\_getBalance

**Purpose:** Get account balance.

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

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

{% endstep %}

{% step %}

### eth\_getLogs

**Purpose:** Get matching event logs.

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

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

{% endstep %}

{% step %}

### eth\_gasPrice

**Purpose:** Get current gas price.

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

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

{% endstep %}

{% step %}

### eth\_getTransactionByHash

**Purpose:** Get transaction details by hash.

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

```json
{
  "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
}
```

{% endstep %}

{% step %}

### eth\_getTransactionReceipt

**Purpose:** Get transaction receipt.

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

```json
{
  "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
}
```

{% endstep %}

{% step %}

### eth\_chainId

**Purpose:** Get chain ID.

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

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

{% endstep %}

{% step %}

### eth\_getTransactionCount

**Purpose:** Get nonce for an address.

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

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

{% endstep %}

{% step %}

### eth\_getCode

**Purpose:** Get bytecode at an address.

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

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

{% endstep %}

{% step %}

### eth\_getStorageAt

**Purpose:** Get value from storage position.

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

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

{% endstep %}

{% step %}

### eth\_estimateGas

**Purpose:** Estimate gas cost.

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

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

{% endstep %}

{% step %}

### eth\_getBlockByNumber

**Purpose:** Get block information by number.

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

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

{% endstep %}

{% step %}

### eth\_getBlockByHash

**Purpose:** Get block information by hash.

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

{% endstep %}

{% step %}

### eth\_sendRawTransaction

**Purpose:** Submit a signed transaction.

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

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

{% endstep %}

{% step %}

### eth\_call

**Purpose:** Execute a contract call without creating a transaction.

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

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

{% endstep %}
{% endstepper %}

## Usage Tips

### Batch Requests

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

### Error Handling

```json
{
  "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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tetreum.com/api-archive/tetreum-testnet-rpc-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.