> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teqoin.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Run node

> Use the public RPC today and prepare for self-hosted node operations as TeQoin infra expands

# Run a node

TeQoin currently exposes a public RPC endpoint at `https://rpc.teqoin.io`. If you need read and write access immediately, that endpoint is the fastest option.

This page focuses on two practical workflows:

* Using the public RPC in development and automation
* Preparing your stack for a dedicated or self-hosted node later

## Quick connectivity check

Use a JSON-RPC request to confirm the network is reachable:

```bash theme={null}
curl https://rpc.teqoin.io ^
  -H "Content-Type: application/json" ^
  -d "{\"jsonrpc\":\"2.0\",\"method\":\"eth_chainId\",\"params\":[],\"id\":1}"
```

You should get back the TeQoin chain ID in hex.

## Use the public RPC in your tools

### Hardhat

```javascript theme={null}
networks: {
  teqoin: {
    url: 'https://rpc.teqoin.io',
    chainId: 420377,
    accounts: [process.env.PRIVATE_KEY],
  },
}
```

### Foundry

```toml theme={null}
[rpc_endpoints]
teqoin = "https://rpc.teqoin.io"
```

### Ethers

```javascript theme={null}
import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://rpc.teqoin.io');
const blockNumber = await provider.getBlockNumber();
console.log(blockNumber);
```

## When you need your own node

A dedicated node becomes useful when you need:

* Higher request volume
* Internal monitoring
* Stable latency for production services
* Control over archival, tracing, or custom indexing

## Suggested operational checklist

Prepare these pieces now, even if you still rely on the public RPC:

* A secrets manager for RPC credentials and wallet keys
* Request retries and circuit breakers in your backend
* Health checks for `eth_chainId`, `eth_blockNumber`, and `net_version`
* Metrics for latency, error rate, and stale block detection

## Health checks to automate

Run these checks on an interval:

```bash theme={null}
cast chain-id --rpc-url https://rpc.teqoin.io
cast block-number --rpc-url https://rpc.teqoin.io
```

Alert when:

* The chain ID changes unexpectedly
* Block height stops advancing
* Latency spikes above your service threshold

## Current limitation

As of April 22, 2026, the public TeQoin GitHub account only exposes the docs repository. A public node repository or install guide was not available in that account when this page was prepared, so this guide documents the live RPC workflow instead of unpublished infrastructure.

## Next steps

* Build against the public RPC first
* Add monitoring before you scale traffic
* Revisit this page when TeQoin publishes dedicated node software or operator docs