# Tavchain Docs

> Learn about Tavchain, connect to Tavchain Testnet, build smart contracts, contribute feedback and understand network operations.

- [Tavchain](https://docs.tavchain.safeney.com/index.md): Learn about the network, build with EVM tools, contribute and explore node operations.
- [About Tavchain](https://docs.tavchain.safeney.com/tavchain/about.md): Learn what Tavchain is, how its EVM-compatible Layer 1 works, and where to start with testnet applications and node operation.
- [Tavchain whitepaper](https://docs.tavchain.safeney.com/tavchain/whitepaper.md): Read Tavchain's purpose, EVM architecture, Tavcoin economics, validator security and development direction in the versioned testnet whitepaper.
- [Development and roadmap](https://docs.tavchain.safeney.com/tavchain/learn/history.md): Understand the current Tavchain development scope, available testnet workflows and features that are not yet enabled.
- [Glossary](https://docs.tavchain.safeney.com/tavchain/learn/glossary.md): Definitions of Tavchain account, transaction, token and node terminology, including chain IDs, gas, receipts and base units.
- [Network information](https://docs.tavchain.safeney.com/tavchain/network.md): Tavchain Testnet chain IDs, RPC URL, currency, explorer, faucet, address formats and genesis identity for wallets and node operators.
- [Release status](https://docs.tavchain.safeney.com/tavchain/status.md): Check Tavchain Testnet's available interfaces, published node release, compiler compatibility and current limits on participation and public services.
- [Network architecture](https://docs.tavchain.safeney.com/tavchain/learn/architecture.md): Understand how Tavchain consensus, EVM execution, full nodes and public services fit together, with links to the network security model.
- [Accounts and self-custody](https://docs.tavchain.safeney.com/tavchain/learn/accounts.md): Understand Tavchain EVM accounts, wallet custody, chain-specific balances and the distinction between native and EVM address formats.
- [Wallets, tools and services](https://docs.tavchain.safeney.com/tavchain/learn/wallets.md): Choose a wallet or development tool for Tavchain Testnet and understand the distinct roles of wallets, RPC, the faucet and explorer.
- [Tavcoin](https://docs.tavchain.safeney.com/tavchain/learn/tavcoin.md): Understand Tavcoin, its 18-decimal base units, testnet genesis allocation and the difference between Test TAV and application tokens.
- [Native TAV and application tokens](https://docs.tavchain.safeney.com/tavchain/learn/tokens.md): Distinguish native TAV from ERC-20 assets, identify tokens by chain and contract address, and handle token decimals and gas correctly.
- [Protocol overview](https://docs.tavchain.safeney.com/tavchain/learn/protocol.md): Learn how Tavchain combines consensus, EVM execution and native node interfaces, including validator admission and network identity.
- [Consensus, finality and security](https://docs.tavchain.safeney.com/tavchain/learn/security.md): Read Tavchain Testnet consensus and validator trust assumptions, availability risks, wallet safety and private vulnerability reporting guidance.
- [Transaction lifecycle](https://docs.tavchain.safeney.com/tavchain/learn/transactions.md): Follow a Tavchain transaction from local signing and submission to execution, receipt inspection and explorer indexing.
- [Fees and resource limits](https://docs.tavchain.safeney.com/tavchain/learn/fees.md): Learn how gas is paid in Test TAV, how to estimate transaction fees and why execution gas differs from public RPC usage limits.
- [Staking and delegation](https://docs.tavchain.safeney.com/tavchain/learn/staking.md): Understand TAV self-bonding, delegation, validator voting power and the testnet unbonding period before participating.
- [Network rewards](https://docs.tavchain.safeney.com/tavchain/learn/rewards.md): Understand how transaction fees, validator commission and delegator shares relate to the testnet, without a promised yield.
- [Governance and upgrades](https://docs.tavchain.safeney.com/tavchain/learn/governance.md): Learn the testnet governance thresholds, proposal deposits and relationship between voting power and validator participation.
- [Cross-chain connectivity](https://docs.tavchain.safeney.com/tavchain/learn/bridging.md): Check Tavchain cross-chain availability and understand why EVM-compatible addresses do not provide bridging or asset conversion.
- [Get started with Tavchain](https://docs.tavchain.safeney.com/tavchain/getting-started.md): Connect a wallet, get Test TAV and make your first transaction.
- [Connect to Tavchain](https://docs.tavchain.safeney.com/tavchain/connect.md): Add Tavchain Testnet to an EVM wallet using the chain ID, RPC and explorer settings, then select the network before signing transactions.
- [Get Test TAV](https://docs.tavchain.safeney.com/tavchain/faucet.md): Request Test TAV from the faucet, understand the address cooldown and claim process, and review availability and claim-data retention.
- [Send your first transfer](https://docs.tavchain.safeney.com/tavchain/first-transfer.md): Send Test TAV with your wallet, review the recipient and fee, and confirm execution using the transaction receipt and explorer.
- [EVM contract workflow](https://docs.tavchain.safeney.com/tavchain/contracts.md): Choose Remix or Hardhat to compile, test, deploy and verify Solidity contracts on Tavchain Testnet, with links to token and transaction guides.
- [Write and test a contract](https://docs.tavchain.safeney.com/tavchain/write-contract.md): Create and compile a Solidity Greeter in Remix with the Tavchain tutorial settings, ready for deployment through an EVM wallet.
- [Deploy a contract](https://docs.tavchain.safeney.com/tavchain/deploy-token.md): Deploy Greeter on Tavchain Testnet with Remix and MetaMask, read its state, send a contract update and inspect the resulting receipt.
- [Verify a contract](https://docs.tavchain.safeney.com/tavchain/verify-contract.md): Publish your Solidity source on Tavchain Testnet's explorer, match the original compiler settings, and read your verified contract without a wallet.
- [Create and transfer an ERC-20 token](https://docs.tavchain.safeney.com/tavchain/erc20-token.md): Deploy OpenZeppelin's example ERC-20 on Tavchain Testnet, read balances, transfer tokens, and verify the source with standard Ethereum tools.
- [Use Tavchain with AI](https://docs.tavchain.safeney.com/tavchain/ai-tools.md): Connect your coding assistant to Tavchain documentation, find current network settings and use Markdown pages as context for development.
- [Read live blockchain data with AI](https://docs.tavchain.safeney.com/tavchain/ai-chain.md): Connect a local read-only MCP server to Tavchain Testnet to inspect blocks, balances, transaction receipts and contract state from your AI editor.
- [Build and deploy with Hardhat](https://docs.tavchain.safeney.com/tavchain/hardhat.md): Build and test an OpenZeppelin ERC-20, deploy it to Tavchain Testnet with Hardhat Ignition, then verify its source without unlocking a signing key.
- [Developer documentation](https://docs.tavchain.safeney.com/tavchain/index.md): Choose a Tavchain development workflow for wallets, Solidity contracts and Ethereum JSON-RPC, with links to setup and troubleshooting.
- [Start testing Tavchain](https://docs.tavchain.safeney.com/tavchain/testnet.md): Start testing Tavchain with wallet setup, faucet funding, transfers and Solidity development, using the public testnet interfaces.
- [API overview](https://docs.tavchain.safeney.com/tavchain/api/openapi.md): Choose between Tavchain Ethereum JSON-RPC, explorer, faucet and local node interfaces, with links to the appropriate request and response guides.
- [Ethereum JSON-RPC](https://docs.tavchain.safeney.com/tavchain/http-api.md): Use Tavchain HTTP Ethereum JSON-RPC for state queries and signed transactions, with endpoint details, common methods, limits and errors.
- [Transactions](https://docs.tavchain.safeney.com/tavchain/transactions.md): Choose the correct Tavchain interface for native transfers, contract transactions, read-only calls and execution-result checks.
- [Read network identity](https://docs.tavchain.safeney.com/tavchain/api/network-selection.md): Identify Tavchain Testnet using eth_chainId, interpret the hexadecimal result and distinguish wallet identity from the native node chain ID.
- [Read a balance and nonce](https://docs.tavchain.safeney.com/tavchain/api/account.md): Read native TAV balances and account nonces, select a block or pending state, and interpret base-unit hexadecimal results safely.
- [Submit a signed transaction](https://docs.tavchain.safeney.com/tavchain/api/submit-transaction.md): Submit locally signed EVM transaction bytes to Tavchain, interpret the returned hash and handle uncertain broadcast outcomes safely.
- [Read a transaction receipt](https://docs.tavchain.safeney.com/tavchain/api/transaction.md): Read a Tavchain transaction receipt, distinguish pending or missing results from execution failure, and inspect block and gas information.
- [Read an ERC-20 token balance](https://docs.tavchain.safeney.com/tavchain/api/reference-token.md): Query ERC-20 balanceOf and decimals using a token contract, distinguish token balances from native TAV and format raw amounts safely.
- [JSON-RPC response formats](https://docs.tavchain.safeney.com/tavchain/api/schemas.md): Interpret Tavchain JSON-RPC results, errors, hexadecimal quantities, addresses, byte data and receipt execution status.
- [Wallet and RPC troubleshooting](https://docs.tavchain.safeney.com/tavchain/troubleshooting.md): Resolve common Tavchain wallet, faucet, RPC and transaction problems, including network selection, rate limits and uncertain submissions.
- [Contribute to Tavchain](https://docs.tavchain.safeney.com/tavchain/contribute.md): Improve the docs, share developer feedback and report problems.
- [Report an issue](https://docs.tavchain.safeney.com/tavchain/contribute/reporting.md): What to include in documentation, developer and security reports.
- [Operate Tavchain](https://docs.tavchain.safeney.com/tavchain/operate.md): Understand node roles, network access and the current operating model.
- [Node roles and access](https://docs.tavchain.safeney.com/tavchain/operate/node-roles.md): Choose the right interface and understand validator participation.
- [Run a native node](https://docs.tavchain.safeney.com/tavchain/operate/node-native.md): Install a Tavchain Testnet full node on Linux x86-64, Linux ARM64 or Windows x86-64, verify the release, and check sync before using local RPC.
- [Run a node with Docker](https://docs.tavchain.safeney.com/tavchain/operate/node-docker.md): Run a Tavchain Testnet full node with Docker Compose, verify synchronization, and preserve its data and identity across normal stops and restarts.
- [Run a full node](https://docs.tavchain.safeney.com/tavchain/operate/run-full-node.md): Follow Tavchain Testnet from genesis with the native node client.
- [Run a node as a service](https://docs.tavchain.safeney.com/tavchain/operate/node-service.md): Keep a Tavchain full node running with systemd, persistent state and standard Linux commands.
- [Monitor a node](https://docs.tavchain.safeney.com/tavchain/operate/monitoring.md): Check sync, peers, block agreement and host health with native RPC and systemd.
- [Upgrades and recovery](https://docs.tavchain.safeney.com/tavchain/operate/upgrades-recovery.md): Maintain an existing full node, prepare for client upgrades and recover from interruptions.
- [Troubleshoot a node](https://docs.tavchain.safeney.com/tavchain/operate/troubleshooting.md): Diagnose startup, peer, sync and RPC problems without resetting node state.
- [Network files and ports](https://docs.tavchain.safeney.com/tavchain/operate/network-assets.md): Verify the 771002 genesis, public peers and observer configuration alongside the unchanged Tavchain node release.

## Optional

- [Website](https://tavchain.safeney.com/)
- [Explorer](https://explorer.tavchain.safeney.com/)
- [Docs for AI](https://docs.tavchain.safeney.com/tavchain/ai-tools)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.