https://github.com/Snowfork/snowbridge
A trustless bridge between Polkadot and Ethereum
https://github.com/Snowfork/snowbridge
ethereum polkadot
Last synced: 23 days ago
JSON representation
A trustless bridge between Polkadot and Ethereum
- Host: GitHub
- URL: https://github.com/Snowfork/snowbridge
- Owner: Snowfork
- License: apache-2.0
- Created: 2020-06-29T15:46:44.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-05-07T09:31:56.000Z (25 days ago)
- Last Synced: 2025-05-07T10:38:41.922Z (25 days ago)
- Topics: ethereum, polkadot
- Language: Go
- Homepage: https://docs.snowbridge.network
- Size: 47.5 MB
- Stars: 300
- Watchers: 27
- Forks: 112
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- best-of-crypto - GitHub - 6% open · ⏱️ 04.06.2024): (Others)
README
# Snowbridge
[](https://codecov.io/gh/Snowfork/snowbridge)
Snowbridge is a trustless bridge between Polkadot and Ethereum. For documentation, visit https://docs.snowbridge.network.
## Components
The Snowbridge project lives in two repositories:
- [Snowfork/polkadot-sdk](https://github.com/Snowfork/polkadot-sdk): The Snowbridge parachain and pallets live in
a fork of the polkadot-sdk. Changes are eventually contributed back to
[paritytech/polkadot-sdk](https://github.com/paritytech/polkadot-sdk)
- [Snowfork/snowbridge](https://github.com/Snowfork/snowbridge): The rest of the Snowbridge components, like contracts,
off-chain relayer, end-to-end tests and test-net setup code.
### Parachain
Polkadot parachain and our pallets. See [https://github.com/Snowfork/polkadot-sdk](https://github.com/Snowfork/polkadot-sdk/blob/snowbridge/bridges/snowbridge/README.md).
### Contracts
Ethereum contracts and unit tests. See [contracts/README.md](https://github.com/Snowfork/snowbridge/blob/main/contracts/README.md)
### Relayer
Off-chain relayer services for relaying messages between Polkadot and Ethereum. See
[relayer/README.md](https://github.com/Snowfork/snowbridge/blob/main/relayer/README.md)
### Local Testnet
Scripts to provision a local testnet, running the above services to bridge between local deployments of Polkadot and
Ethereum. See [web/packages/test/README.md](https://github.com/Snowfork/snowbridge/blob/main/web/packages/test/README.md).
### Smoke Tests
Integration tests for our local testnet. See [smoketest/README.md](https://github.com/Snowfork/snowbridge/blob/main/smoketest/README.md).
## Development
We use the Nix package manager to provide a reproducible and maintainable developer environment.
After [installing Nix](https://nixos.org/download.html), enable [flakes](https://wiki.nixos.org/wiki/Flakes):
```sh
mkdir -p ~/.config/nix
echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
```
Then activate a developer shell in the root of our repo, where
[`flake.nix`](https://github.com/Snowfork/snowbridge/blob/main/flake.nix) is located:
```sh
nix develop
```
Also make sure to run this initialization script once:
```sh
scripts/init.sh
```
### Support for code editors
To ensure your code editor (such as VS Code) can execute tools in the nix shell, startup your editor within the
interactive shell.
Example for VS Code:
```sh
nix develop
code .
```
### Custom shells
The developer shell is bash by default. To preserve your existing shell:
```sh
nix develop --command $SHELL
```
### Automatic developer shells
To automatically enter the developer shell whenever you open the project, install
[`direnv`](https://direnv.net/docs/installation.html) and use the template `.envrc`:
```sh
cp .envrc.example .envrc
direnv allow
```
### Upgrading the Rust toolchain
Sometimes we would like to upgrade rust toolchain. First update `polkadot-sdk/rust-toolchain.toml` as required and then
update `flake.lock` running
```sh
nix flake lock --update-input rust-overlay
```
## Troubleshooting
Check the contents of all `.envrc` files.
Remove untracked files:
```sh
git clean -idx
```
Ensure that the current Rust toolchain is the one selected in `scripts/init.sh`.
Ensure submodules are up-to-date:
```sh
git submodule update
```
Check untracked files & directories:
```sh
git clean -ndx | awk '{print $3}'
```
After removing `node_modules` directories (eg. with `git clean above`), clear the pnpm cache:
```sh
pnpm store prune
```
Check Nix config in `~/.config/nix/nix.conf`.
Run a pure developer shell (note that this removes access to your local tools):
```sh
nix develop -i --pure-eval
```
## Security
The security policy and procedures can be found in SECURITY.md.