Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Hashi contracts and integration #717

Merged
merged 30 commits into from
Sep 17, 2024
Merged

Hashi contracts and integration #717

Show file tree
Hide file tree
Changes from 29 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
9fc18de
Add files via upload
0xarmagan Jul 29, 2024
8af54f1
Update 07-24-core-devs-call.md
0xarmagan Jul 29, 2024
1bb846e
fix broken RPC url
vanshika-srivastava Jul 29, 2024
683d1c8
fix all the broken anchors and hyperlinks
vanshika-srivastava Jul 31, 2024
edc86c6
chore: fix some comments (#702)
zhoufanjin Jul 31, 2024
0244f05
shutterized -> to change to shutter enabled
vanshika-srivastava Aug 1, 2024
4a5ca3c
Merge branch 'main' into dev
vanshika-srivastava Aug 1, 2024
8db8770
fix core dev call layout
vanshika-srivastava Aug 2, 2024
4550427
Core Devs Call Notes July 31, 2024
0xarmagan Aug 6, 2024
86d3056
remove custom signer from interact page
vanshika-srivastava Aug 6, 2024
76868df
fix: 07-31-core-devs-call format
zengzengzenghuy Aug 6, 2024
6461c4f
Core Devs Call Notes Aug 7, 2024
0xarmagan Aug 9, 2024
03e5df4
"Liquid Staking" Page Update (#709)
iamjackgale Aug 12, 2024
aa150fb
Update _generate_validator_keys_wagyu.md (#710)
theChim9 Aug 12, 2024
ef62199
Update voluntary-exit.md (#711)
theChim9 Aug 12, 2024
d222223
Add files via upload
0xarmagan Aug 23, 2024
c0deaae
Update 08-21-core-devs-call.md
0xarmagan Aug 23, 2024
5a2569c
Update 08-07-core-devs-call.md
0xarmagan Aug 23, 2024
b35f1e8
Merge branch 'main' into dev
vanshika-srivastava Aug 26, 2024
aec2c12
Updates 08-21-core-devs-call.md for a small typo
vanshika-srivastava Aug 26, 2024
8f6fca4
Core Devs call notes Aug 28
0xarmagan Aug 31, 2024
9b89786
feat: Cookbook Onboard integration (#715)
ClockRide Sep 2, 2024
97b2046
Update 08-28-core-devs-call.md - fix format
vanshika-srivastava Sep 2, 2024
9090c86
Added dRPC to community Faucets (#698)
maradeeym Sep 2, 2024
46c76b9
chore(bridges): update deprecated url to https://github.com/tokenbridge/
zengzengzenghuy Sep 8, 2024
a79b5c3
add section for running node with eth swarm setup
vanshika-srivastava Sep 11, 2024
fed4767
feat(bridges): add Hashi integration overview
zengzengzenghuy Sep 16, 2024
01d820f
chore(bridges): add testnet contracts for Hashi integration
zengzengzenghuy Sep 17, 2024
9e9710c
fix: error
zengzengzenghuy Sep 17, 2024
be2b4fc
Merge branch 'main' into dev
vanshika-srivastava Sep 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 20 additions & 28 deletions docs/bridges/About Token Bridges/amb-bridge.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ keywords:

The native Arbitrary Message Bridge (AMB) allows user to send arbitrary data between Gnosis Chain and Ethereum. This allows Gnosis contracts to send data and trigger contract functions on Ethereum and other chains, and vice versa.

The AMB is a key bridge primitive that is used inside higher-order bridges like the [Omnibridge native token bridge](../About%20Token%20Bridges/omnibridge.md), and is part of the [Tokenbridge Architecture](https://tokenbridge.net/).
The AMB is a key bridge primitive that is used inside higher-order bridges like the [Omnibridge native token bridge](../About%20Token%20Bridges/omnibridge.md), and is part of the [Tokenbridge Architecture](https://github.com/tokenbridge/docs).

With [Telepathy added as the 8th validator](../managementdecisions.md#add-telepathy-validator-in-the-amb), AMB bridge is now more secure with trustless zero-knowledge light client technology. Due to the light client finality requirements (at least 23mins on Ethereum), the transactions will take approx. 30mins to be signed by the bridge. However, users can still use 3rd party bridges (Jumper.exchange, Connext, Hop) without any impact. For more details, check out [how AMB & Omnibridge works with Telepathy validator](#how-it-works-with-telepathy-validator).

Expand All @@ -34,11 +34,11 @@ With [Telepathy added as the 8th validator](../managementdecisions.md#add-telepa

### Ethereum

| Contract | Address |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Omnibridge Multi-Token Mediator | [0x88ad09518695c6c3712AC10a214bE5109a655671](https://etherscan.io/address/0x88ad09518695c6c3712AC10a214bE5109a655671#writeProxyContract) |
| AMB (Foreign) | [0x4C36d2919e407f0Cc2Ee3c993ccF8ac26d9CE64e](https://etherscan.io/address/0x4C36d2919e407f0Cc2Ee3c993ccF8ac26d9CE64e#writeProxyContract) |
| AMB/OmniBridge wETH Router Helper | [0xa6439Ca0FCbA1d0F80df0bE6A17220feD9c9038a](https://etherscan.io/address/0xa6439ca0fcba1d0f80df0be6a17220fed9c9038a) |
| Contract | Address |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Omnibridge Multi-Token Mediator | [0x88ad09518695c6c3712AC10a214bE5109a655671](https://etherscan.io/address/0x88ad09518695c6c3712AC10a214bE5109a655671#writeProxyContract) |
| AMB (Foreign) | [0x4C36d2919e407f0Cc2Ee3c993ccF8ac26d9CE64e](https://etherscan.io/address/0x4C36d2919e407f0Cc2Ee3c993ccF8ac26d9CE64e#writeProxyContract) |
| AMB/OmniBridge wETH Router Helper | [0xa6439Ca0FCbA1d0F80df0bE6A17220feD9c9038a](https://etherscan.io/address/0xa6439ca0fcba1d0f80df0be6a17220fed9c9038a) |

</TabItem>

Expand All @@ -49,7 +49,7 @@ With [Telepathy added as the 8th validator](../managementdecisions.md#add-telepa
| Contract | Address |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| AMB/Omnibridge Multi-Token Mediator | [0xf6A78083ca3e2a662D6dd1703c939c8aCE2e268d](https://gnosisscan.io/address/0xf6A78083ca3e2a662D6dd1703c939c8aCE2e268d#writeProxyContract) |
| AMB (Home) | [0x75Df5AF045d91108662D8080fD1FEFAd6aA0bb59](https://gnosisscan.io/address/0x75Df5AF045d91108662D8080fD1FEFAd6aA0bb59#writeProxyContract) |
| AMB (Home) | [0x75Df5AF045d91108662D8080fD1FEFAd6aA0bb59](https://gnosisscan.io/address/0x75Df5AF045d91108662D8080fD1FEFAd6aA0bb59#writeProxyContract) |
| AMB Helper Contract | [0x7d94ece17e81355326e3359115D4B02411825EdD](https://gnosisscan.io/address/0x7d94ece17e81355326e3359115D4B02411825EdD#readContract) |

</TabItem>
Expand All @@ -58,19 +58,16 @@ With [Telepathy added as the 8th validator](../managementdecisions.md#add-telepa

### Sepolia - Chiaado

| Contract | Address |
|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| AMB (Sepolia) | [0xf2546D6648BD2af6a008A7e7C1542BB240329E11](https://sepolia.etherscan.io/address/0xf2546D6648BD2af6a008A7e7C1542BB240329E11) |
| Validator Contract (Sepolia) | [0xa0bd95dd2570632c8640ab5bc213f3a0ea33e26a](https://sepolia.etherscan.io/address/0xa0bd95dd2570632c8640ab5bc213f3a0ea33e26a) |
| AMB (Chiado) | [0x8448E15d0e706C0298dECA99F0b4744030e59d7d](https://gnosis-chiado.blockscout.com/address/0x8448E15d0e706C0298dECA99F0b4744030e59d7d) |
| Validator Contract (Chiado) | [0x9e8a89ebcb83065eaaf4b7ff720caa5e6b25c976](https://gnosis-chiado.blockscout.com/address/0x9e8a89ebcb83065eaaf4b7ff720caa5e6b25c976) |
| AMB Helper Contract (Chiado) | [0x3cc500B3c01D04C265c9293cB35BA2Fd8eA6dc1b](https://gnosis-chiado.blockscout.com/address/0x3cc500B3c01D04C265c9293cB35BA2Fd8eA6dc1b?tab=read_contract) |


| Contract | Address |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AMB (Sepolia) | [0xf2546D6648BD2af6a008A7e7C1542BB240329E11](https://sepolia.etherscan.io/address/0xf2546D6648BD2af6a008A7e7C1542BB240329E11) |
| Validator Contract (Sepolia) | [0xa0bd95dd2570632c8640ab5bc213f3a0ea33e26a](https://sepolia.etherscan.io/address/0xa0bd95dd2570632c8640ab5bc213f3a0ea33e26a) |
| AMB (Chiado) | [0x8448E15d0e706C0298dECA99F0b4744030e59d7d](https://gnosis-chiado.blockscout.com/address/0x8448E15d0e706C0298dECA99F0b4744030e59d7d) |
| Validator Contract (Chiado) | [0x9e8a89ebcb83065eaaf4b7ff720caa5e6b25c976](https://gnosis-chiado.blockscout.com/address/0x9e8a89ebcb83065eaaf4b7ff720caa5e6b25c976) |
| AMB Helper Contract (Chiado) | [0x3cc500B3c01D04C265c9293cB35BA2Fd8eA6dc1b](https://gnosis-chiado.blockscout.com/address/0x3cc500B3c01D04C265c9293cB35BA2Fd8eA6dc1b?tab=read_contract) |

</TabItem>


<TabItem value="goerli" label="Goerli-Chiado">

### Goerli - Chiado
Expand All @@ -85,27 +82,24 @@ The bridge betwee Goerli and Chiado is deprecating soon.
| AMB Contract Proxy (Foreign) | [0x87A19d769D875964E9Cd41dDBfc397B2543764E6](https://goerli.etherscan.io/address/0x87A19d769D875964E9Cd41dDBfc397B2543764E6) |
| GNO on Goerli | [0x7f477c3f03213970d939104cc436dc995cf615b5](https://goerli.etherscan.io/address/0x7f477c3f03213970d939104cc436dc995cf615b5) |


| Contract | Address |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| OmniBridge Mediator (Home) | [0x09D549a48AC52F3f9945E7de6402c609c92aa2E1](https://gnosis-chiado.blockscout.com/address/0x09D549a48AC52F3f9945E7de6402c609c92aa2E1) |
| AMB Contract Proxy (Home) | [0x99Ca51a3534785ED619f46A79C7Ad65Fa8d85e7a](https://gnosis-chiado.blockscout.com/address/0x99Ca51a3534785ED619f46A79C7Ad65Fa8d85e7a) |
| GnosisBridge(GNO) on Chiado | [0x19C653Da7c37c66208fbfbE8908A5051B57b4C70](https://gnosis-chiado.blockscout.com/address/0x19C653Da7c37c66208fbfbE8908A5051B57b4C70) |


</TabItem>


</Tabs>


### Fees & Daily Limits

As the Arbitrary Message Bridge is a message passing bridge, there are no fees or daily limits associated with it.

### Bridge Validators

- See [Bridge Validator](../management/validators#amb--omnibridge)

### Bridge Governance

- See [Bridge Governance](../management/README.md)
Expand Down Expand Up @@ -171,10 +165,10 @@ There are 5 key components for Telepathy validator in AMB & Omnibridge:

Once the user initiate cross-chain method via AMB on Ethereum, it will take ~12 mins for the transaction to get finalized in block and for Telepathy light client to obtain the block header information. Thus, user has to wait for approx. 30 mins for the message to get bridged to Gnosis Chain.

| Role | Address |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Telepathy PubSub | [0x30Ec3049F571cf61099535bd73EcbC8968e6311a](https://gnosisscan.io/address/0x30Ec3049F571cf61099535bd73EcbC8968e6311a) |
| Telepathy Validator | [0x456c255a8bc1f33778603a2a48eb6b0c69f4d48](https://gnosisscan.io/address/0x456c255A8BC1F33778603A2a48Eb6B0C69F4d48E) |
| Role | Address |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Telepathy PubSub | [0x30Ec3049F571cf61099535bd73EcbC8968e6311a](https://gnosisscan.io/address/0x30Ec3049F571cf61099535bd73EcbC8968e6311a) |
| Telepathy Validator | [0x456c255a8bc1f33778603a2a48eb6b0c69f4d48](https://gnosisscan.io/address/0x456c255A8BC1F33778603A2a48Eb6B0C69F4d48E) |
| Telepathy Light Client | [0x251cee0641afed44f625fafa1cd2b410f7868591](https://gnosisscan.io/address/0x251cee0641afed44f625fafa1cd2b410f7868591) |

For more details, check out [Telepathy Validator for Omnibridge](https://hackmd.io/@wdyZgTm3RrOsm-rhXDXEHA/BJ_7ExKgn) and https://docs.telepathy.xyz/.
Expand Down Expand Up @@ -217,8 +211,6 @@ A mediator contract is needed if there is an approval flow, such as when transfe
- ERC-to-Native Bridges: `ERC-TO-NATIVE` mode enables the user to send ERC20 tokens to the Foreign Bridge and receive native coins from the Home Bridge Complimentarily, then can send native coins to the Home Bridge to unlock ERC20 tokens from the Foreign Bridge. The home network nodes must support a consensus engine that allows using a smart contract for block reward calculation. This mode is used by the [xDai Bridge](xdai-bridge)
- Message Passing: `ARBITRARY-MESSAGE` mode enables the capability to invoke a Home/Foreign Bridge contract to send a message that will be executed on the other Network. This can be an arbitrary contract method invocation.


## Resources

- [Arbitrary Message Bridge Documentation](https://docs.tokenbridge.net/amb-bridge/about-amb-bridge)
- [Diagrams illustrating how AMB Bridge works](https://docs.tokenbridge.net/eth-xdai-amb-bridge/multi-token-extension/extension-internals)
- [Token bridge Documentation](https://github.com/tokenbridge/docs)
Loading
Loading