Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Expand on Snowfork content on Bridge Hub page #6167

Merged
merged 14 commits into from
Aug 28, 2024
Merged
29 changes: 19 additions & 10 deletions docs/learn/learn-bridge-hub.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,24 @@
id: learn-bridge-hub
title: Bridge Hub
sidebar_label: Bridge Hub
description: Overview of Bridge Hub System Parachain.
description: Overview of the Bridge Hub System Parachain.
keywords: [Bridge, XCM, Bridge Hub]
slug: ../learn-bridge-hub
---

The primary functionality of {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} relay
chain is to secure the parachains and facilitate secure communication between them. All other
functionalities like asset transfers, governance, identities and especially bridging, which can be
resource intensive can benefit from operating seaparately on system parachains. That's why, the
Bridge Hub system parachain is operating on
{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} since 2023. The Bridge Hub has all
the required bridge pallets in its runtime, which enable trustless bridging with other blockchain
networks like {{ polkadot: Kusama :polkadot }}{{ kusama: Polkadot :kusama }}, Ethereum etc. The
Bridge Hub uses the native token of the relay chain,
The primary functionality of the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}
relay chain is to secure the parachains and facilitate secure communication between them. All other
functionalities like asset transfers, governance, identities and bridging (a potentially resource
intensive task) can benefit from operating separately on system parachains. System parachains are
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
responsible for delegating functionality away from the relay chain for peformance reasons, taking
advantage of the inherent parallelization the relay chain provides.
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved

The Bridge Hub system parachain operates on
{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}, and is responsible for faciliating
bridges to the wider Web3 space. It contains all required bridge
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
[pallets](../general/glossary.md#pallet) in its runtime, which enable trustless bridging with other
blockchain networks like {{ polkadot: Kusama :polkadot }}{{ kusama: Polkadot :kusama }}, Ethereum
etc. The Bridge Hub uses the native token of the relay chain,
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}.

## Trustless Bridges on Bridge Hub
Expand All @@ -25,6 +29,11 @@ A two-way trustless bridge between chains A and B can be viewed as two one-way b
source and a target chain. Any bridge operating on the Bridge Hub will have on-chain (pallets) and
offchain (relayers) components.

Examples of trustless on Bridge Hub include:
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved

- Snowfork, a decentralized bridge between Polkadot and Ethereum
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we specify that this is an Ethereum light client on Polkadot that syncs to Ethereum and keeps the Ethereum state up-to-date on Polkadot?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe this is good for the next PR, we can add those details in the followup 👍

- [The Polkadot-to-Kusama Bridge](./learn-DOT-KSM-bridge.md)

### On-chain Bridge Components

On-chain bridge components are modules (pallets or smart contracts) that are deployed on the chain's
Expand Down
1 change: 1 addition & 0 deletions docs/learn/learn-bridges.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,7 @@ There is now a

## Additional Resources and Examples

- [Snowbridge - a trustless, decentralized bridge between Polkadot and Ethereum](https://docs.snowbridge.network/)
- [Parity Bridges Common Resources](https://github.com/paritytech/parity-bridges-common)
- [Substrate/Ethereum Bridge](https://github.com/ChainSafe/ChainBridge) - ChainSafe and Centrifuge
were awarded a grant in W3F Grants
Expand Down
41 changes: 41 additions & 0 deletions docs/learn/learn-snowbridge.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
id: learn-snowbridge
title: Snowbridge
sidebar_label: Snowbridge
description: Overview of Snowbridge by Snowfork
keywords: [Bridge, XCM, Bridge Hub, Snowbridge, Snowfork]
slug: ../learn-snowbridge
---

Snowbridge by Snowfork is a general-purpose, trustless bridge between Polkadot and Ethereum. It
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
utilizes the [Bridge Hub system parachain](./learn-bridge-hub.md) to establish a connection to its
relayers, allowing for permissionless messaging between Ethereum and Polkadot.

## Trustlessness in Snowbridge

Trustlessness here is defined in the sense that the users do not need to trust any particular
individuals or organizations, but rather only the mathematics, code, cryptography, and protocol. An
example of a system which implies a high level of trust **trust** would be that of a bridge which is
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
example of a system which implies a high level of trust **trust** would be that of a bridge which is
example of a system which implies a high level of **trust** would be that of a bridge, which is

controlled via a multi-signature scheme, wherein you must trust the cosignatories.

Basic assumptions are always needed in principle when defining a trustless system, as a completely
trustless setup cannot always be guaranteed.

With Snowbridge, a sender can always run a
[relayer](https://docs.snowbridge.network/architecture/relayers) to ensure that their cross-chain
transaction is successful.

## Applications

Snowbridge currently supports
[two-way token transfers](https://docs.snowbridge.network/applications/token-transfers) between
Ethereum and Polkadot parachain.

## Accessing & Using Snowbridge

Snowbridge can be accessed through [the web app.](https://app.snowbridge.network/), where you may
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
track [how long transfers are taking,](https://app.snowbridge.network/status),
CrackTheCode016 marked this conversation as resolved.
Show resolved Hide resolved
[recent transfers](https://app.snowbridge.network/history), and other information about the bridge's
overall status.

To create transfers, you may visit the [transfer page.](https://app.snowbridge.network/)
1 change: 1 addition & 0 deletions polkadot-wiki/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -537,6 +537,7 @@ module.exports = {
items: [
"learn/learn-bridge-hub",
"learn/learn-dot-ksm-bridge",
"learn/learn-snowbridge",
"learn/learn-hyperbridge",
],
},
Expand Down
Loading