# Docs

- [Getting Started](/docs): Mandala Chain documentation. Pick your path based on what you want to do.
- Learn
  - [Introduction to Mandala Chain](/docs/learn/introduction-to-mandala-chain): What Mandala is, the stack it runs on, and where to read next.
  - [Why Mandala Chain?](/docs/learn/why-mandala-chain): The builder-side pitch: EVM-equivalent, cheap by construction, on-demand blocks, regional roots.
  - [L2 & Arbitrum Orbit](/docs/learn/l2-and-arbitrum-orbit): Just enough vocabulary to read the rest of Learn: what an L2 is, what an optimistic rollup is, what Orbit is, and what AnyTrust is.
  - [How Mandala is Built](/docs/learn/how-mandala-is-built): Mandala's stack on top of Arbitrum Orbit: sequencer, batch poster, validators, DAC, and the L1 contracts.
  - [Trust & Security Model](/docs/learn/trust-and-security-model): What you trust when you use Mandala, who runs which part, the failure modes, and how to get out if anything misbehaves.
  - [Accounts & Wallets](/docs/learn/accounts-and-wallets): EOAs, smart accounts, and wallet support on Mandala. Mostly the EVM you already know.
  - [Gas & Fees](/docs/learn/gas-and-fees): How gas works on Mandala, what users pay for, and where the cost actually goes.
  - [Block Production & Finality](/docs/learn/block-production-and-finality): How blocks are produced on Mandala (on demand), the three flavors of finality, and the 7-day withdrawal window.
  - [Glossary](/docs/learn/glossary): Definitions of common terms across Mandala Chain and the broader L2 ecosystem.
- Network
  - [Network Details](/docs/network/network-details): Chain ID, RPC and WebSocket endpoints, explorer URL, native token, and the L1 + L2 contract addresses you may need to reference.
  - Wallet Setup
    - [MetaMask](/docs/network/wallet-setup/metamask): Install MetaMask, create a wallet, and add Mandala Chain as a custom network.
    - [Rabby](/docs/network/wallet-setup/rabby): Install Rabby, create a wallet, and add Mandala Chain as a custom network.
  - Testnet
    - [Network Details](/docs/network/testnet/network-details): Connection values for the Mandala testnet: Chain ID, RPC and WebSocket endpoints, explorer URL, and native token.
    - [Faucet](/docs/network/testnet/faucet): Claim free KPGT testnet tokens from the Mandala Chain Faucet to deploy contracts, send transactions, and test dApps at no cost.
  - Bridge
    - [Overview](/docs/network/bridge/overview): How bridging works between Ethereum and Mandala, the two timing profiles, and where to actually do it.
    - [Deposit from Ethereum](/docs/network/bridge/deposit-from-ethereum): Move ETH, KPG, or ERC-20 tokens from Ethereum L1 to Mandala via the Arbitrum Portal.
    - [Withdraw to Ethereum](/docs/network/bridge/withdraw-to-ethereum): Move ETH, KPG, or ERC-20 tokens from Mandala back to Ethereum L1 via the Arbitrum Portal.
  - [Block Explorer](/docs/network/block-explorer): How to use Blockscout to inspect transactions, contracts, and accounts on Mandala.
- Build on Mandala
  - [Quickstart](/docs/build/quickstart): Deploy a Solidity contract to Mandala in five minutes. Foundry or Hardhat.
  - [Differences from Ethereum](/docs/build/differences-from-ethereum): What changes when you deploy to Mandala instead of Ethereum. Five gotchas in plain language.
  - [Hardhat](/docs/build/hardhat): Install Hardhat, configure for Mandala, deploy a contract, verify on Blockscout.
  - [Foundry](/docs/build/foundry): Install Foundry, configure for Mandala, deploy a contract, verify on Blockscout.
  - [Verify a contract](/docs/build/verify-contract): Three ways to verify on Blockscout: Hardhat plugin, Foundry CLI, and the explorer UI.
  - [Frontend integration](/docs/build/frontend-integration): Connect your frontend to Mandala: chain config, wallet, reading and writing contracts with viem and wagmi.
  - [Reference](/docs/build/reference): Network values, contract addresses, and upstream documentation index for Mandala builders.
- Support
  - [Getting Help](/docs/support/getting-help): Where to ask, how to ask, and how to disclose security findings.
  - [Frequently Asked Questions](/docs/support/faq): Short answers to what builders and users ask most about Mandala Chain.