diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 5eb9777e60953..2b983557e2094 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -7,6 +7,7 @@ * [Overview](architecture/overview.md) * [Components](architecture/components.md) +* [Fees and Channels](architecture/fees-and-channels.md) * [Verification](architecture/verification/README.md) * [Ethereum](architecture/verification/ethereum.md) * [Polkadot](architecture/verification/polkadot/README.md) diff --git a/docs/architecture/fees-and-channels.md b/docs/architecture/fees-and-channels.md new file mode 100644 index 0000000000000..840f0f64e4bed --- /dev/null +++ b/docs/architecture/fees-and-channels.md @@ -0,0 +1,15 @@ +# Fees and Channels + +Users pay bridge fees in the native token of the source chain. This means that on Ethereum, users pay in ETH to send messages across to Polkadot. In the opposite direction, users pay a fee in DOT to send messages to Ethereum. + +These collected fees are paid in out rewards to off-chain message relayers. This incentivizes them to keep the bridge operating. + +It is important to note that each parachain has its own logical messaging _channel_ to Ethereum. Fees and rewards are configured on a per-channel basis. + +This allows greater flexibility in allowing parachains to subsidise the messaging activity of their users. + +## Rebalancing + +Fees are collected on the source network (Ethereum or Polkadot), and rewards are paid out on the destination network (Ethereum or Polkadot). + +Depending on various factors, it may be necessary for channel owners to periodically _rebalance_ the accounts used for fees and rewards, so that the rewards account does not become empty.