Skip to content

Commit

Permalink
add bridge asset transfer warning (#5789)
Browse files Browse the repository at this point in the history
* add bridge asset transfer warning

* Update learn-guides-DOT-KSM-bridge.md

* Update docs/learn/learn-guides-DOT-KSM-bridge.md

Co-authored-by: Adrian Catangiu <[email protected]>

---------

Co-authored-by: Radha <[email protected]>
  • Loading branch information
acatangiu and DrW3RK authored Apr 16, 2024
1 parent b71d57b commit 963d70c
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions docs/learn/learn-guides-DOT-KSM-bridge.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,3 +126,23 @@ balances of any account on Kusama Asset Hub can be queried on-chain through the
`foreignAssets`pallet as shown below.

![Wrapped KSM Balance](../assets/bridge-hub/PAH-KSM-Balance.png)

## Transfer of arbitrary assets between Polkadot Asset Hub and Kusama Asset Hub

Transfer functionality of assets other than DOT and KSM between Asset Hubs is yet to be enabled. Once this
functionality is enabled, assets which are sufficient or non-sufficient on the Asset Hubs can be bridged.

:::caution Avoid Asset Traps

To avoid issues on the receiving side for non-sufficient assets, make sure to call
[pallet_assets::touch()](https://github.com/paritytech/polkadot-sdk/blob/0ef37c75401b78b61ed35ce27af8b964da27bb3c/substrate/frame/assets/src/lib.rs#L1531) or [pallet_assets::touch_other()](https://github.com/paritytech/polkadot-sdk/blob/0ef37c75401b78b61ed35ce27af8b964da27bb3c/substrate/frame/assets/src/lib.rs#L1616)
effectively guaranteeing the ability to successfully receive and accept the bridged assets in your
account on the destination chain.
This eliminates issues like your account on destination not existing or not having enough ED or having
reached the maximum limit of different assets it can hold.
Without this sanity step, you risk that the bridged assets will make their way to the destination chain
but will not be accepted by your account, and instead get trapped in the Asset Trap on the destination chain.

:::

Once arbitrary asset transfers are enabled by the Asset Hubs, a guide will be posted to this Wiki page.

0 comments on commit 963d70c

Please sign in to comment.