From c0a9ded683751049f0cfb57e81eb8e7519e678ae Mon Sep 17 00:00:00 2001 From: bader y Date: Wed, 28 Aug 2024 13:04:19 -0400 Subject: [PATCH] Expand on Snowfork content on Bridge Hub page (#6167) * start refactor * change to dot-ksm bridge * initial stub for snowbridge * Change location of page * add bulk of content * tweaks * Update docs/learn/learn-bridge-hub.md Co-authored-by: Filippo <110459737+filippoweb3@users.noreply.github.com> * Update docs/learn/learn-bridge-hub.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-bridge-hub.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-bridge-hub.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-bridge-hub.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-snowbridge.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-snowbridge.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> * Update docs/learn/learn-snowbridge.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> --------- Co-authored-by: Filippo <110459737+filippoweb3@users.noreply.github.com> Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> --- docs/learn/learn-bridge-hub.md | 29 +++++++++++++++--------- docs/learn/learn-bridges.md | 1 + docs/learn/learn-snowbridge.md | 41 ++++++++++++++++++++++++++++++++++ polkadot-wiki/sidebars.js | 1 + 4 files changed, 62 insertions(+), 10 deletions(-) create mode 100644 docs/learn/learn-snowbridge.md diff --git a/docs/learn/learn-bridge-hub.md b/docs/learn/learn-bridge-hub.md index 330bfce8ae69..2e63b1249042 100644 --- a/docs/learn/learn-bridge-hub.md +++ b/docs/learn/learn-bridge-hub.md @@ -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](./learn-system-chains.md). System parachains are +responsible for delegating functionality away from the relay chain for peformance reasons, taking +advantage of the inherent parallelization the architecture of Polkadot provides. + +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 the required bridge +[pallets](../general/glossary.md#pallet) in its runtime, which enable trustless bridging with other +blockchain networks like {{ polkadot: Kusama :polkadot }}{{ kusama: Polkadot :kusama }} and Ethereum +. The Bridge Hub uses the native token of the relay chain, {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}. ## Trustless Bridges on Bridge Hub @@ -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 bridges on Bridge Hub include: + +- Snowfork, a decentralized bridge between Polkadot and Ethereum +- [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 diff --git a/docs/learn/learn-bridges.md b/docs/learn/learn-bridges.md index 87d7f66c8fe6..0f654eeefd33 100644 --- a/docs/learn/learn-bridges.md +++ b/docs/learn/learn-bridges.md @@ -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 diff --git a/docs/learn/learn-snowbridge.md b/docs/learn/learn-snowbridge.md new file mode 100644 index 000000000000..340a945d0b89 --- /dev/null +++ b/docs/learn/learn-snowbridge.md @@ -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](https://snowfork.com/) is a general-purpose, trustless bridge between Polkadot and Ethereum. It +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 +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 +track [processing times of transactions,](https://app.snowbridge.network/status), +[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/) diff --git a/polkadot-wiki/sidebars.js b/polkadot-wiki/sidebars.js index ab2cde52ca33..816aa6579192 100644 --- a/polkadot-wiki/sidebars.js +++ b/polkadot-wiki/sidebars.js @@ -537,6 +537,7 @@ module.exports = { items: [ "learn/learn-bridge-hub", "learn/learn-dot-ksm-bridge", + "learn/learn-snowbridge", "learn/learn-hyperbridge", ], },