VEA
Vea
Vea is a cross-chain message bridge which enables fast and secure interoperability specifically designed with optimistic rollups in mind.
About Vea
What type of bridge is this?
A trust-minimized optimistically-verified bridge, open to any participant to fulfill the roles of Oracle, Challenger or Relayer. The trust model requires only 1 live honest verifier, similar to optimistic rollups.
How is this secure?
As an optimistic bridge, it is cheap and fast to use in the happy case, where an Oracle makes an unchallenged claim. While in the unhappy case, it is no different than using the canonical bridges operated by a particular rollup or side-chain. There is no need for any additional trust assumption on say a 3rd-party oracle or some slow governance mechanism or trusted DAO multisig to ensure that the message is relayed correctly. As long as there is one honest participant running a working implementation of the light client specifications at any time, and anybody can take on this role.
Learn more...
🌐 Website
📖 Documentation
🕵️ Security disclosures
Deployments
⛓️ Contracts addresses
⚖️ VeaScan explorer
🗃️ Subgraph endpoints
Content
| Package | Description |
|---|---|
| contracts | Smart contracts of the Vea bridge protocol. |
| relayer-cli | Convenience utility capable of automating the relaying of messages for verified state roots. |
| relayer-subgraph-inbox | Indexing of the bridge inbox for relaying purposes, in particular for the computation of the proof of inclusion of a message in a state root. |
| services | Supporting services such as a graph-node container. |
| validator-cli | Validator implementation in TypeScript capable of fulfilling the roles of Oracle and Challenger. |
| veascan-subgraph-inbox | Indexing of the bridge inbox for retrieval by the Veascan frontend. |
| veascan-subgraph-outbox | Indexing of the bridge outbox for retrieval by the Veascan frontend. |
| veascan-web | Explorer of snapshot and messages crossing the bridge. |
Toolchain:
- Solidity v0.8
- Hardhat
- Ethers v5
- Chai + Mocha
- Node v16
- Typescript
- Yarn v3 without PlugnPlay
Contributing
Prerequisites
- Install NodeJS 16:
- on Red Hat Linux:
sudo dnf module install nodejs:16 - on Ubuntu Linux:
sudo snap install node --classic - on MacOS via brew:
brew install node
- on Red Hat Linux:
- Install Yarn v1 (Classic):
npm install -g yarn- Then upgrade Yarn to v3:
yarn set version berry
- Then upgrade Yarn to v3:
- Install Volta.sh:
curl https://get.volta.sh | sh - Install Docker Desktop to run the local graph node.
- Shell utilities: jq, yq
- on Red Hat Linux:
sudo dnf install jq yq - on Ubuntu Linux:
sudo snap install jq yq - on MacOS via brew:
brew install jq yq
- on Red Hat Linux:
Install the dependencies
$ yarn installHardhat CLI auto-completion (optional)
$ npm i -g hardhat-shorthand
$ hardhat-completion install
✔ Which Shell do you use ? · bash
✔ We will install completion to ~/.bashrc, is it ok ? (y/N) · true
$ exec bash