Skip to content

Commit d2370d0

Browse files
authored
Merge pull request #68 from nomad-xyz/odyslam-patch-1
Document dust feature
2 parents 8e8ad5a + a9be646 commit d2370d0

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/dev/token-bridge.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,3 +144,13 @@ To support teams desiring specific token functionality, the registry supports en
144144
When a custom token is enrolled, that token no longer has a 1:1 correspondence between local representation and canonical identifier. Instead, there are >1 local representations. Incoming transfers mint the **latest** representation (the most recently enrolled custom token), while outgoing transfer may burn **any** previous representation. This ensures that users' tokens are never invalidated, but new users get the best version.
145145

146146
For convenience, we also expose a `migrate` function that allows users to immediately exchange any previous representation for the **latest** representation. This allows a user to upgrade outdated representations and receive the latest without dispatching a cross-chain message.
147+
148+
### Dust
149+
150+
We provide the users with `dust` in order to facilitate their onboarding to the chain (all chains apart from Ethereum).
151+
152+
We provide no guarantees to the end users that they will necessarily receive gas from the Dust feature. We provide it in **good faith** that it won't be abused and will be used by users who need it.
153+
154+
Dust is donated by people who are incentivized for users to have gas after they bridge. Large $$$ values of dust should not be donated at any given time and we are actively talking with teams to avoid doing so.
155+
156+
It is hoped that the gas is used for genuine users, but not a concern if the gas is used improperly, as it should be of negligible importance to the donor.

0 commit comments

Comments
 (0)