Skip to content

Commit

Permalink
Expand on Snowfork content on Bridge Hub page (#6167)
Browse files Browse the repository at this point in the history
* 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>
  • Loading branch information
3 people authored Aug 28, 2024
1 parent 5d3f069 commit c0a9ded
Show file tree
Hide file tree
Showing 4 changed files with 62 additions and 10 deletions.
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](./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
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 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
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](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/)
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

0 comments on commit c0a9ded

Please sign in to comment.