# Gravity Docs

## EN

- [Introduction](https://docs.gravity.xyz/overview/readme.md): Gravity is a high-performance Layer 1 blockchain with a native protocol-level oracle — built to be the world computer and the foundational harness for humans and their AI agents.
- [Ecosystem VC Alliance](https://docs.gravity.xyz/overview/ecosystem-vc-alliance.md): Eligibility and Application Guide for the Gravity Ecosystem VC Alliance
- [Developer Grant Program](https://docs.gravity.xyz/overview/developer-grant-program.md): Explore Gravity's $5 million grant program funding developers building on Gravity with up to $200K plus ecosystem support for qualified projects.
- [Community Program: Galactic G](https://docs.gravity.xyz/overview/galactic-g.md): Discover Galactic G - the badge for Gravity's passionate supporters. Learn how to become a community leader through engagement, creativity, and advocacy to gain exclusive privileges.
- [G Token](https://docs.gravity.xyz/the-g-token/g-token.md): Powering the future of Web3. G is the native token on Gravity, and the utility token of both Gravity and the Galxe ecosystem.
- [How to Get G](https://docs.gravity.xyz/the-g-token/how-to-get-g.md): How to bridge G to Gravity L1, buy G on exchanges, or migrate from Alpha Mainnet (L2).
- [How to Get Test Tokens](https://docs.gravity.xyz/the-g-token/how-to-get-test-tokens.md)
- [Token Contracts on Gravity](https://docs.gravity.xyz/the-g-token/token-contracts.md): Canonical ERC-20 token contracts on Gravity L1.
- [Gravity Mainnet (L1)](https://docs.gravity.xyz/gravity-networks/l1-mainnet.md): Gravity Mainnet (L1) network reference — chain ID, RPC, explorer, bridge.
- [Gravity Mainnet Hardforks](https://docs.gravity.xyz/gravity-networks/mainnet-hardforks.md): Gravity Mainnet (L1) hardfork schedule, required node version, and what happens if a node misses an activation.
- [Run a Gravity Mainnet Public Full Node](https://docs.gravity.xyz/gravity-networks/run-a-mainnet-pfn.md): Run a Gravity Mainnet (L1) Public Full Node. Covers binaries, genesis artifacts, public/VFN seeds, deployment, database warm start, and sync verification for a PFN/RPC endpoint.
- [Run a Gravity Mainnet Public Full Node With Docker](https://docs.gravity.xyz/gravity-networks/run-a-mainnet-pfn-with-docker.md): Run a Gravity Mainnet (L1) Public Full Node with Docker. Covers image preparation, mainnet artifacts, PFN identity generation, pruning, startup, sync checks, and operational cleanup.
- [Run a Gravity Mainnet VFN](https://docs.gravity.xyz/gravity-networks/run-a-mainnet-vfn.md): Run a Gravity Mainnet (L1) Validator Full Node. Covers validator VFN-network seeds, deployment, optional public listener, database warm start, and sync verification.
- [Run a Gravity Mainnet Validator (Invite Only)](https://docs.gravity.xyz/gravity-networks/run-a-mainnet-validator.md): Run an invite-only Gravity Mainnet (L1) validator. Validator onboarding is currently invite-only. Covers validator node deployment, StakePool creation, governance whitelisting, validator join, status
- [Node Operation Anti-Patterns](https://docs.gravity.xyz/gravity-networks/node-operation-anti-patterns.md): Node operation mistakes that cause sync problems on Gravity L1, with the symptoms to look for, why they happen, how to confirm them, and how to fix them.
- [Gravity Longevity Testnet (L1)](https://docs.gravity.xyz/gravity-networks/l1-longevity-testnet.md)
- [Gravity Longevity Testnet Hardforks](https://docs.gravity.xyz/gravity-networks/testnet-hardforks.md): Gravity Longevity Testnet (L1) hardfork schedule, how activations are stored, and the node version needed to follow the live chain.
- [Run a Gravity Testnet Public Full Node](https://docs.gravity.xyz/gravity-networks/run-a-testnet-pfn.md): Run a Gravity Longevity Testnet (L1) Public Full Node. Covers binaries, testnet genesis artifacts, the public-network seed, deployment, database warm start, and sync verification for a PFN/RPC endpoin
- [Run a Gravity Testnet Public Full Node With Docker](https://docs.gravity.xyz/gravity-networks/run-a-testnet-pfn-with-docker.md): Run a Gravity Longevity Testnet (L1) Public Full Node with Docker. Covers image preparation, testnet artifacts, PFN identity generation, pruning, startup, sync checks, and operational cleanup.
- [Deployed Contracts](https://docs.gravity.xyz/developer-resources/deployed-contracts.md): Canonical EVM ecosystem preinstall contracts on Gravity Mainnet (L1).
- [Deployed Contracts (Testnet)](https://docs.gravity.xyz/developer-resources/deployed-contracts-testnet.md): Canonical EVM ecosystem preinstall contracts on the Gravity Longevity Testnet (L1).
- [Gravity Skill](https://docs.gravity.xyz/developer-resources/gravity-skill.md): Official Agent Skill that teaches AI coding tools how to build on Gravity.
- [System Contracts](https://docs.gravity.xyz/developer-resources/mainnet.md): System and bridge contract addresses on Gravity Mainnet (L1).
- [Gravity Litepaper](https://docs.gravity.xyz/research-and-development/litepaper.md): Building Gravity Chain: A High-Performance EVM Layer-1 Powered by Grevm and Gravity SDK
- [Gravity Reth](https://docs.gravity.xyz/research-and-development/greth.md): Gravity Reth is the fastest open-source EVM execution client, a performance-engineered fork of Reth.
- [Grevm 2.1 (Gravity EVM)](https://docs.gravity.xyz/research-and-development/grevm2.md): Gravity Parallel EVM (Grevm) is a high-performance, parallel EVM runtime.
- [Native Oracle](https://docs.gravity.xyz/research-and-development/native-oracle.md)
- [Build Your Own 100k+ TPS Chain Using Gravity SDK](https://docs.gravity.xyz/research-and-development/gravity-sdk-tutorial.md): A developer-focused guide explains how to build a fully functional, custom L1 blockchain application using the Gravity SDK framework.
- [Validator Cluster Deployment Guide](https://docs.gravity.xyz/research-and-development/cluster-deployment.md): Deploy a local multi-validator Gravity EVM cluster using Gravity SDK in minutes — the fastest way to run a high-performance, EVM-compatible chain from scratch.
- [Benchmark Reproduction Guide](https://docs.gravity.xyz/research-and-development/benchmark-guide.md): Step-by-step guide to reproducing the Gravity EVM benchmark and collecting throughput and latency data using gravity\_bench.
- [3-Validator Cluster Benchmark Results](https://docs.gravity.xyz/research-and-development/benchmark-results.md): 3-validator cluster benchmark results from 2026-02-28, covering TPS benchmarks and bottleneck analysis across CPU, memory, and I/O.
- [(Archived) Grevm 1.0](https://docs.gravity.xyz/research-and-development/grevm.md): Gravity Parallel EVM (Grevm) is a high-performance, parallel EVM runtime.
- [Wallets & Exchanges](https://docs.gravity.xyz/ecosystem-infrastructures/supported-wallets.md): Wallets and exchanges that support Gravity Mainnet (L1) and the legacy Gravity Alpha Mainnet (L2).
- [Node Providers](https://docs.gravity.xyz/ecosystem-infrastructures/node-providers.md): Explore node providers for Gravity, offering scalable and reliable RPC endpoints to streamline on-chain development.
- [Developer Utilities](https://docs.gravity.xyz/ecosystem-infrastructures/developer-utilities.md)
- [Explorers](https://docs.gravity.xyz/ecosystem-infrastructures/explorers.md)
- [Cross-chain Interoperability](https://docs.gravity.xyz/ecosystem-infrastructures/cross-chain-interoperability.md)
- [Onramps](https://docs.gravity.xyz/ecosystem-infrastructures/onramps.md): Explore reliable fiat-to-crypto onramps that connect users from traditional payment methods directly to Gravity, enabling smooth and secure blockchain access.
- [Smart Contract Wallets](https://docs.gravity.xyz/ecosystem-infrastructures/safe.md)
- [Data Analytics Platforms](https://docs.gravity.xyz/ecosystem-infrastructures/data-analytics-platforms.md)
- [Overview](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/legacy-l2.md): Reference material for Gravity Alpha Mainnet (L2) — the 2024 Arbitrum Nitro rollup that preceded Gravity L1.
- [Alpha Mainnet & Sepolia Testnet (L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/using-gravity-alpha-mainnet-l2.md): Gravity Alpha Mainnet & Sepolia Testnet Information
- [Alpha Mainnet (L2) Archive Node Setup](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/run-a-gravity-alpha-mainnet-l2-archive-node.md): Run a Gravity Alpha Mainnet (L2) archive node with full historical state for eth\_call, debug\_traceTransaction, and trace APIs against any block.
- [Alpha Mainnet (L2) Full Node from Snapshot](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/run-a-gravity-alpha-mainnet-l2-full-node-from-snapshot.md): Bootstrap a Gravity Alpha Mainnet (L2) full node by downloading a public GCS chaindata snapshot and starting nitro in non-archive mode.
- [Sepolia Testnet (L2) Node Setup](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/gravity-testnet-sepolia-l2-node-setup.md): Instructions about how to run a Gravity Alpha Testnet Sepolia node.
- [How to Get G (Gravity Alpha, L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/bridge-to-gravity.md): Learn the different methods to acquire G tokens through bridges, exchanges, and direct purchases on Gravity Alpha Mainnet (L2).
- [Bridge Assets back to Ethereum (Gravity Alpha, L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/bridge-back-to-ethereum.md): Move G and other assets from Gravity Alpha Mainnet (L2) back to Ethereum mainnet.
- [Token Contracts on Gravity Alpha (L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/token-contracts-on-gravity.md): Explore a list of available ERC20 tokens on Gravity Alpha Mainnet (L2) Bridge.
- [Alpha G Fast Bridge Contracts](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/alpha-g-fast-bridge.md): Verified contract addresses for the G-only fast bridge from Gravity Alpha Mainnet to Ethereum.
- [Gravity Alpha Mainnet (L2) Contracts](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/mainnet.md)
- [Gravity Alpha Sepolia Testnet (L2) Contracts](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/testnet.md)
- [Verify a Smart Contract (Gravity Alpha, L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/verify-a-smart-contract.md): Verify your smart contract on Gravity Alpha Mainnet (L2).
- [Oracles (legacy L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/pyth-price-feeds.md): Third-party oracle integrations from the legacy Gravity Alpha Mainnet (L2). Gravity Mainnet (L1) is integrating a range of oracle services; Native Oracle is supported by default for now.
- [Indexers (legacy L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/the-graph.md)
- [Gravity Name Service (legacy L2)](https://docs.gravity.xyz/legacy-alpha-mainnet-l2/gravity-name-service.md): SPACE ID Web3 Name SDK (legacy Gravity Alpha Mainnet, L2)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gravity.xyz/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.