> 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

Public Nodes / Public API Endpoints

### Mainnet

#### RPC

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

#### WS

```
wss://rpc.vinuchain.org
```

### Testnet

#### RPC

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

#### WS

```
wss://testnet-rpc.vinuchain.org:4100
```

***

### ELEMONT RPC Surface

Both mainnet and testnet now expose the complete ELEMONT RPC surface. Mainnet moved to the `v2.0.49-elemont` binary in the 2026-08-29 upgrade window and finished its activation seals on 2026-08-30, so `rpc_modules`, `vc_getPaybackBalance`, `eth_config` and `vc_config` now answer identically on both networks. Gating these calls on network is no longer necessary.

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

{% hint style="warning" %}
**Status checked 3 September 2026:** `vc_getRules`, `vc_getPaybackBalance`, and `eth_config` / `vc_config` all work on **both** networks. Mainnet's ELEMONT activation began 2026-08-29 and completed at the final seal on 2026-08-30 (block `14,707,397`); the earlier `-32601` responses on `https://rpc.vinuchain.org` no longer occur.

Check before depending on one:

```bash
curl -s -X POST https://rpc.vinuchain.org -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"rpc_modules","params":[],"id":1}'
```

See the [Mainnet Upgrade Guide](/vinuchain/technical-docs/vinuchain-mainnet/chain-upgrade-guide.md).
{% endhint %}

#### `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).