This repository provides an end-to-end solution for proving data from rollup chains and verifying it against state posted on the parent chain.
npm i @unruggable/gateways ✓
- We have extensive documentation, with a slightly less quick Quickstart.
- The examples page may be of particular interest.
- We also have an examples repo that utilises our npm package to demonstrate both simple and complex use cases in a few clicks.
- Request — a program that fetches data from one or more contracts
- constructable in Solidity and TypeScript using (almost) the same syntax
- Commit — a commitment (eg.
StateRoot) of one chain on another - VM — a machine that executes a Request for a Commit
- TypeScript — records sequence of necessary proofs
- Solidity — verifies sequence of supplied proofs (in the same order)
- Rollup (TypeScript) — traverses Commit history, generates a Commit proof and supplies a Prover
- Prover (TypeScript) — generates rollup-specific Account and Storage proofs
- Gateway (TypeScript) — receives a Request, finds the appropriate Commit, executes the VM, and responds with a sequence of proofs via CCIP-Read
- Verifier (Solidity) — verifies a Commit proof and executes the VM with Hooks
- Verifier Hooks (Solidity) — verifies rollup-specific Account and Storage proofs
- Rollups & Verifers
- OP — Base, Blast, Celo, Cyber, Fraxtal, Mantle, Mode, opBNB, Redstone, Shape, Zora
- OP w/Fault Proofs — Optimism
- Nitro — Arbitrum One
- Linea
- Polygon PoS
- Polygon ZK — WIP
- Scroll
- Taiko
- ZKSync
- Reverse OP — L2 → L1 for any Superchain
- Self — any Chain to itself
- Provers
- Verifier Hooks
- Eth — Patricia Merkle Tree
- Linea — Sparse Merkle Tree + Mimc
- Scroll — Binary Merkle Tree + Poseidon
- ZKSync — Sparse Merkle Tree + Blake2S
If you are interested in building a solution for another chain, please take a look at our our Contribution Guidelines and/or get in touch.
bun run serve <chain> [port]- Chains:
arb1base-testnetbaseblastcelo-alfajorescyberfraxtallineaV1lineamantlemodeopopbnbpolygonredstonereverse-opscrollself-ethself-holeskyself-sepoliashapetaikozksynczora - Default port:
8000
- Chains:
There is an extensive test suite available for testing individual components of the solution in an isolated manner.
Using Foundry and blocksmith.js, we fork the chain in question (such that can interact with contracts deployed on a real network) and then deploy and test against an isolated unit (for example the chain specific verifier).
Commands available include:
bun run testbun run test-componentsbun run test-gateways- Contract → Reader → Tests
⚠️ Scroll failsreadZero()test⚠️ Polygon has pooreth_getProofsupport
A number of examples are provided as part of this repository. For more extensive step-wise example code, please see our documentation.
- linea-ens
- Replacement backend demo for https://names.linea.build/
bun serve lineaV1
# installed by forge in step (2)
# provided for reference
forge install foundry-rs/forge-std
forge install OpenZeppelin/[email protected]
# installed by script instead of the following command
# placed at standard remapping location
# see: https://github.com/ethereum-optimism/optimism/issues/10202
#forge install ethereum-optimism/optimism
bun build/import-op.tsWe welcome contributions to this codebase.
The premise behind the development of this software is to minimise duplication of effort and provide tooling that allows developers to interface with a simple, standardised API to read data from other chains.
Please take a look at our CONTRIBUTING.md file for a more in depth overview of our contribution process.
- main is our stable release branch that reflects the latest release.
- develop is our ongoing development branch. Feature branches are to merged down into this.
- Feature Branches: Separate branches will be utilised for new feature development or bug fixes.
All files within this repository are licensed under the MIT License unless stated otherwise.