For the complete documentation index, see llms.txt. This page is also available as Markdown.

System Contracts

System and bridge contract addresses on Gravity Mainnet (L1).

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.

Gravity L1 system runtime contracts live at fixed, well-known addresses in the 0x1625F00000x1625F5xxx 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.

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.

Token contracts

For the canonical ERC-20 token list on Gravity L1 (native G, wG, and bridged assets as their bridge routes go live), see Token Contracts on Gravity.

See also

Last updated

Was this helpful?