# TBURN Testnet RPC Gateway
# AI-readable discovery file for Large Language Models
# Format: llms.txt v1.0
# Domain: testnet-rpc.tburn.io
# Updated: 2026-03-28

## About

TBURN Testnet RPC Gateway is an enterprise-grade, free JSON-RPC 2.0 infrastructure platform for the TBURN blockchain testnet ecosystem. It provides developers with high-performance RPC endpoints, real-time network monitoring, API documentation, performance benchmarks, and a secure Federation Gateway.

**Canonical URL:** https://testnet-rpc.tburn.io
**Organization:** TBURN Foundation (https://tburn.io)
**License:** Free for developers, no rate limits

---

## Network Specifications

- **Testnet Chain ID:** 5900 (hex: 0x170C)
- **Mainnet Chain ID:** 5800 (hex: 0x16A8)
- **Consensus:** BFT-5Phase (Byzantine Fault Tolerant)
- **Shard Formula:** shardCount = ⌊totalValidators / 16⌋
- **BFT Quorum:** ⌊16 × 2/3⌋ + 1 = 11 per shard
- **Gas Unit:** Ember (EMB), 1 TBURN = 1,000,000 EMB
- **L2 Chain ID:** 58001

---

## RPC Endpoints

### Primary (US-East, Virginia)
- **HTTP RPC:** https://testnet-rpc.tburn.io
- **WebSocket:** wss://testnet-ws.tburn.io
- **Latency:** ~12ms | Uptime: 99.95%

### Europe (Frankfurt)
- **HTTP RPC:** https://eu.testnet-rpc.tburn.io
- **Latency:** ~22ms | Uptime: 99.92%

### Asia-Pacific (Tokyo)
- **HTTP RPC:** https://ap.testnet-rpc.tburn.io
- **Latency:** ~38ms | Uptime: 99.90%

---

## Gas (Ember/EMB) Tier System

| Tier      | Price   | Confirmation  |
|-----------|---------|---------------|
| Economy   | 5 EMB   | ~30 seconds   |
| Standard  | 10 EMB  | ~15 seconds   |
| Express   | 25 EMB  | ~5 seconds    |
| Instant   | 50 EMB  | ~2 seconds    |

Gas Formula (§5.9): baseFeeEMB = 10 × (1 + avgLoad/100 × 2)

---

## JSON-RPC 2.0 Supported Methods (29 total)

### Block Methods
eth_blockNumber, eth_getBlockByHash, eth_getBlockByNumber,
eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber

### Transaction Methods
eth_getTransactionByHash, eth_getTransactionReceipt, eth_getTransactionCount,
eth_sendRawTransaction

### State Methods
eth_getBalance, eth_getCode, eth_getStorageAt, eth_call, eth_estimateGas

### Gas Methods
eth_gasPrice, eth_feeHistory, eth_maxPriorityFeePerGas

### Network Methods
eth_chainId, eth_syncing, net_version, net_listening, net_peerCount

### Utility Methods
eth_getLogs, eth_accounts, eth_mining, eth_hashrate, web3_clientVersion, web3_sha3

---

## MetaMask Configuration

```
Network Name: TBurn Testnet
RPC URL: https://testnet-rpc.tburn.io
Chain ID: 5900
Currency Symbol: tTBURN
Block Explorer: https://scan.tburn.io
```

---

## Quick Start (ethers.js v6)

```javascript
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider('https://testnet-rpc.tburn.io');
const blockNumber = await provider.getBlockNumber();
const balance = await provider.getBalance('0x...');
```

---

## Federation Gateway API

**Base URL:** https://api.tburn.io/federation
**Auth:** HMAC-SHA256 (server-to-server)
**Rate Limits:** R=120/min, W=30/min
**Chain IDs:** L1=5800, L2=58001
**Endpoints:** 21 total

### Key Endpoints
- GET /network-state — Real-time network state (§5.3, cache 3s)
- GET /chain-metrics — Chain performance metrics (§5.4, cache 2s)
- GET /tps — Transactions per second with EWMA α=0.3 (§5.6)
- GET /validators — Validator set, shard count, BFT quorum (§5.7, cache 30s)
- GET /gas-oracle — Gas price in EMB with load factor (§5.9)
- GET /bridge-status — Cross-chain bridge state (§5.10, cache 30s)
- GET /l2-state — L2 rollup state (§5.11, cache 5s)
- GET /staking-overview — Staking metrics (§5.13, cache 30s)
- GET /dex-pools — DEX liquidity pools with EMB fees (§5.14, cache 10s)
- GET /federation-nodes — Active federation nodes (§5.19, cache 60s)
- GET /health — Public health check (§5.21, cache 15s)

---

## Platform Pages

| Page | URL | Description |
|------|-----|-------------|
| RPC Endpoints | https://testnet-rpc.tburn.io | Main RPC endpoint info and network config |
| Status Monitoring | https://testnet-rpc.tburn.io/status | Real-time uptime and health monitoring |
| Ecosystem Analytics | https://testnet-rpc.tburn.io/ecosystem | Mainnet/Testnet ecosystem data |
| Federation Gateway | https://testnet-rpc.tburn.io/federation | S2S Federation API dashboard |
| API Documentation | https://testnet-rpc.tburn.io/docs | Interactive API reference |
| Benchmark | https://testnet-rpc.tburn.io/benchmark | RPC performance benchmarking |
| Faucet | https://scan.tburn.io/faucet | Free tTBURN token faucet |
| Block Explorer | https://scan.tburn.io | TBURN Testnet block explorer |

---

## Frequently Asked Questions

**Q: Is TBURN Testnet RPC free?**
A: Yes. Completely free, no API key required, no rate limits for developers.

**Q: What is the TBURN gas unit?**
A: Ember (EMB). 1 TBURN = 1,000,000 EMB. Standard gas = 10 EMB (~15s confirmation).

**Q: How do I get free tTBURN?**
A: Visit https://scan.tburn.io/faucet for instant free testnet tokens.

**Q: Is TBURN compatible with Ethereum tools?**
A: Yes. TBURN is EVM-compatible. Use MetaMask, ethers.js, web3.py, or any Ethereum tool.

**Q: What is the Federation Gateway?**
A: An enterprise server-to-server API (api.tburn.io/federation) providing 21 real-time endpoints for mainnet data, secured with HMAC-SHA256 authentication.

---

## Contact & Resources

- **Main Site:** https://tburn.io
- **Block Explorer:** https://scan.tburn.io
- **API Base:** https://api.tburn.io
- **Federation:** https://api.tburn.io/federation
- **Faucet:** https://scan.tburn.io/faucet