> For the complete documentation index, see [llms.txt](https://docs.gravity.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gravity.xyz/developer-resources/mainnet.md).

# System Contracts

{% hint style="info" %}
The addresses on this page are for **Gravity Mainnet (L1, chain ID `127001`)**. For the legacy **Gravity Alpha Mainnet (L2, Arbitrum Nitro, chain ID `1625`)** rollup contracts (rollup, inbox, outbox, sequencer, gateways), see [Gravity Alpha Mainnet (L2) Contracts](/legacy-alpha-mainnet-l2/mainnet.md).
{% endhint %}

Gravity L1 system runtime contracts live at fixed, well-known addresses in the `0x1625F0000`–`0x1625F5xxx` range. They cannot be re-deployed; adding a new system contract requires a hardfork.

## System runtime contracts

### Consensus engine (`0x1625F0xxx`)

| Address       | Contract     | Purpose                                            |
| ------------- | ------------ | -------------------------------------------------- |
| `0x1625F0000` | SystemCaller | Block prologue, NIL blocks, system-initiated calls |
| `0x1625F0001` | Genesis      | Chain initialization (active only at genesis)      |

### Runtime configurations (`0x1625F1xxx`)

| Address       | Contract                 | Purpose                                               |
| ------------- | ------------------------ | ----------------------------------------------------- |
| `0x1625F1000` | Timestamp                | On-chain microsecond-precision time                   |
| `0x1625F1001` | StakeConfig              | Staking parameters (lockup, minimum stake, …)         |
| `0x1625F1002` | ValidatorConfig          | Validator parameters (bond range, unbonding delay, …) |
| `0x1625F1003` | RandomnessConfig         | DKG threshold parameters                              |
| `0x1625F1004` | GovernanceConfig         | Voting threshold, proposal stake                      |
| `0x1625F1005` | EpochConfig              | Epoch interval duration                               |
| `0x1625F1006` | VersionConfig            | Protocol major version                                |
| `0x1625F1007` | ConsensusConfig          | Consensus parameters (BCS-serialized)                 |
| `0x1625F1008` | ExecutionConfig          | VM execution parameters (BCS-serialized)              |
| `0x1625F1009` | OracleTaskConfig         | Continuous oracle task configuration                  |
| `0x1625F100A` | OnDemandOracleTaskConfig | On-demand oracle request type registry                |

### Staking & validator (`0x1625F2xxx`)

| Address       | Contract           | Purpose                                          |
| ------------- | ------------------ | ------------------------------------------------ |
| `0x1625F2000` | Staking            | Governance staking (open to all G holders)       |
| `0x1625F2001` | ValidatorManager   | Validator registration, bonding, set transitions |
| `0x1625F2002` | DKG                | Distributed Key Generation session lifecycle     |
| `0x1625F2003` | Reconfiguration    | Epoch transitions and reconfiguration            |
| `0x1625F2004` | Block              | Block prologue/epilogue handler                  |
| `0x1625F2005` | PerformanceTracker | Per-validator success/failure proposal tracking  |

### Governance (`0x1625F3xxx`)

| Address       | Contract   | Purpose                                           |
| ------------- | ---------- | ------------------------------------------------- |
| `0x1625F3000` | Governance | Proposal lifecycle: submission, voting, execution |

### Oracle (`0x1625F4xxx`)

| Address       | Contract           | Purpose                                                  |
| ------------- | ------------------ | -------------------------------------------------------- |
| `0x1625F4000` | NativeOracle       | Verified external data (blockchains, JWK providers, DNS) |
| `0x1625F4001` | JWKManager         | JWKs for keyless account authentication                  |
| `0x1625F4002` | OracleRequestQueue | User-initiated on-demand oracle requests                 |

### Precompiles (`0x1625F5xxx`)

| Address       | Contract               | Purpose                                    |
| ------------- | ---------------------- | ------------------------------------------ |
| `0x1625F5000` | NativeMintPrecompile   | Authorized native G mint                   |
| `0x1625F5001` | BlsPopVerifyPrecompile | BLS12-381 proof-of-possession verification |

The full Solidity source for these contracts is published at [Galxe/gravity\_chain\_core\_contracts](https://github.com/Galxe/gravity_chain_core_contracts).

## Cross-chain bridge

The canonical bridge consists of two contracts on **Ethereum mainnet**, paired with the `GBridgeReceiver` contract on Gravity L1 (deployed at genesis) that mints native G via the native-mint precompile once the consensus engine relays a verified message through the native oracle:

| Contract         | Address                                      | Purpose                                                                 |
| ---------------- | -------------------------------------------- | ----------------------------------------------------------------------- |
| `GravityPortal`  | `0x76cf8526Fa9461e50B2c6702a7246ce6915f6E53` | Charges ETH fees, emits `MessageSent` events for consensus              |
| `GBridgeSender`  | `0xE82c61Ac9Ec2041b493118051afa4F18a55dC876` | Locks G ERC-20 from the user, forwards the bridge message to the Portal |
| Owner (multisig) | `0xbD6e434dB90FD8AD4E28d85C133AD34cA6fbfB6D` | Gnosis Safe 3-of-6, owner of both Portal and Sender                     |

Both Ethereum contracts are owned by a 3-of-6 Gnosis Safe multisig. For the end-user bridging flow, see [How to Get G](/the-g-token/how-to-get-g.md).

## Token contracts

For the canonical ERC-20 token list on Gravity L1 (G, wG, USDT, USDC, …), see [Token Contracts on Gravity](/the-g-token/token-contracts.md).

## See also

* [Verify a Smart Contract](/legacy-alpha-mainnet-l2/verify-a-smart-contract.md) — explorer verification (Foundry / Hardhat).
* [Token Contracts on Gravity](/the-g-token/token-contracts.md) — ERC-20s on L1.
* [Gravity Mainnet (L1)](/gravity-networks/l1-mainnet.md) — network connection parameters.
* [Legacy: Alpha Mainnet (L2) contracts](/legacy-alpha-mainnet-l2/mainnet.md) — rollup, inbox, outbox, gateways.


---

# 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
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gravity.xyz/developer-resources/mainnet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.