> For the complete documentation index, see [llms.txt](https://vinu.gitbook.io/vinuchain/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vinu.gitbook.io/vinuchain/technical-docs/api/public-api-endpoints.md).

# Public API Endpoints

### Mainnet

#### RPC

```
https://vinuchain-rpc.com
ChainID: 207
Symbol: VC
Explorer: https://vinuexplorer.org
```

Alternate RPC:

```
https://rpc.vinuchain.org
```

#### WS

```
wss://vinuchain-rpc.com:4100
```

### Testnet

#### RPC

```
https://vinufoundation-rpc.com
ChainID: 206
Symbol: VC
Explorer: https://testnet.vinuexplorer.org
```

#### WS

```
wss://vinufoundation-rpc.com:4100
```

***

### ELEMONT RPC Surface

Both mainnet and testnet expose the ELEMONT RPC extensions introduced with the ELEMONT hard-fork.

#### `vc_*` namespace

The `vc_*` namespace mirrors the standard `eth_*` namespace and accepts the same arguments and returns the same types. Examples:

| Method           | Description                                                                                                           |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| `vc_blockNumber` | Returns the current block number.                                                                                     |
| `vc_call`        | Executes a call without creating a transaction.                                                                       |
| `vc_getRules`    | Returns the active consensus rules for the current epoch, including the staged fork flags and quota contract address. |

Most common read/transaction `eth_*` methods have a `vc_*` equivalent (e.g. `vc_chainId`, `vc_getBalance`, `vc_getTransactionReceipt`, `vc_sendRawTransaction`). The mirror is **not** complete: filter and subscription methods (`eth_getLogs`, `eth_newFilter`, `eth_subscribe`) are registered only under `eth_*`, so their `vc_*` forms return method-not-found (`-32601`). Use the standard `eth_*` methods for normal tooling; reach for `vc_*` specifically for `vc_getRules` and `vc_getPaybackBalance`.

#### `vc_getPaybackBalance`

```
vc_getPaybackBalance(address, blockNrOrHash) → quantity
```

Returns the accrued fee-refund (payback) balance for `address` at the given block. This call is rate-limited by the node; if the request queue is exhausted the node returns JSON-RPC error **-32005**.

#### `eth_config` / `vc_config`

```
eth_config() → ForkConfig
vc_config() → ForkConfig
```

Returns an object describing the current, next, and last applied fork configuration. Each fork entry includes `activationBlock`, `chainId`, `forkId`, and `precompiles`.

For the full ELEMONT RPC reference and operator upgrade guide, see [VinuChain ELEMONT Upgrade](/vinuchain/technical-docs/vinuchain-mainnet/elemont-upgrade.md).


---

# 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, and the optional `goal` query parameter:

```
GET https://vinu.gitbook.io/vinuchain/technical-docs/api/public-api-endpoints.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.