Skip to content

Snowbridge V2 docs#5902

Merged
acatangiu merged 13 commits intoparitytech:masterfrom
vgeddes:v2-docs
Oct 9, 2024
Merged

Snowbridge V2 docs#5902
acatangiu merged 13 commits intoparitytech:masterfrom
vgeddes:v2-docs

Conversation

@vgeddes
Copy link
Copy Markdown
Contributor

@vgeddes vgeddes commented Oct 2, 2024

Here are MD docs for V2 @acatangiu @franciscoaguirre . Let me know what you think.

@vgeddes vgeddes marked this pull request as ready for review October 2, 2024 10:14
@paritytech-review-bot paritytech-review-bot bot requested a review from a team October 2, 2024 10:15
@acatangiu acatangiu added R0-no-crate-publish-required The change does not require any crates to be re-published. T11-documentation This PR/Issue is related to documentation. labels Oct 2, 2024
Copy link
Copy Markdown
Contributor

@acatangiu acatangiu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the great write-up capturing everything we discussed!

Comment on lines +36 to +38
2. Dry-run $x_1$ on AH to receive xcm $x_2$ and cost $b$ in DOT
3. Dry-run $x_2$ on BH to receive command $m$ and cost $c$ in DOT
4. Dry-run $m$ on Ethereum to receive cost $d$ in ETH
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given that you previously stated $P^{'}$ and $E^{'}$ were the native currency of Polkadot and Ethereum respectively, should those be used here? Or should we just use DOT and ETH throughout?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The mathematical notation was useful for distilling the essence of the algorithm. However I've made it more clear in 495ab69 that DOT and ETH are alternative names.

- Given source parachain $S$, with native token $S^{'}$ and the initial xcm $x_0$ to be executed on $S$.
- The native currency $P^{'}$ of the Polkadot relay chain, and $E^{'}$ of Ethereum.
- Suppose that the user agent chooses relayer reward $r$ in $E^{'}$.
- Suppose that the exchange rates $K_{P^{'}/S^{'}}$ and $K_{E^{'}/S^{'}}$. The user agent chooses a multiplier to $\beta$ to cover volatility in these rates.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These rates are obtained off-chain and the total fee might be too low if the rates were wrong and beta not enough to cover the difference, right?

I might add a little note here to highlight the importance of getting the correct exchange rates and the consequence of not having them.

Copy link
Copy Markdown
Contributor

@franciscoaguirre franciscoaguirre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great writeup 😄

vgeddes and others added 4 commits October 9, 2024 15:01
Co-authored-by: Francisco Aguirre <[email protected]>
Co-authored-by: Adrian Catangiu <[email protected]>
Co-authored-by: Alistair Singh <[email protected]>
Co-authored-by: Francisco Aguirre <[email protected]>
@Polkadot-Forum
Copy link
Copy Markdown

This pull request has been mentioned on Polkadot Forum. There might be relevant details there:

https://forum.polkadot.network/t/snowbridge-september-update/10389/1

@acatangiu acatangiu added this pull request to the merge queue Oct 9, 2024
Merged via the queue into paritytech:master with commit 90ff47d Oct 9, 2024
ordian added a commit that referenced this pull request Oct 11, 2024
* master: (28 commits)
  `substrate-node`: removed excessive polkadot-sdk features (#5925)
  Rename QueueEvent::StartWork (#6015)
  [ci] Remove quick-benchmarks-omni from GitLab (#6014)
  Set larger timeout for cmd.yml (#6006)
  Fix `0003-beefy-and-mmr` test (#6003)
  Remove redundant XCMs from dry run's forwarded xcms (#5913)
  Add RadiumBlock bootnodes to Coretime Polkadot Chain spec (#5967)
  Bump strum from 0.26.2 to 0.26.3 (#5943)
  Add PVF execution priority (#4837)
  Snowbridge V2 docs (#5902)
  Fix u256 conversion in BABE (#5994)
  [ci] Move test-linux-stable-no-try-runtime to GHA (#5979)
  Bump PoV request timeout (#5924)
  [Release/CI] Github flow to build `polkadot`/`polkadot-parachain` rc binaries and deb package (#5963)
  [ci] Remove short-benchmarks from Gitlab (#5988)
  Disable flaky tests reported in 5972/5973/5974 (#5976)
  Bump some dependencies (#5886)
  bump zombienet version and set request for k8s (#5968)
  [omni-bencher] Make all runtimes work (#5872)
  Omni-Node renamings (#5915)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

R0-no-crate-publish-required The change does not require any crates to be re-published. T11-documentation This PR/Issue is related to documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants