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.

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

Updates on tools/data indexing, aa provider and unified bridges (#655) #656

Closed
wants to merge 3 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/about/networks/_category_.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"position": 1,
"label": "Networks Overview",
"collapsible": true,
"collapsed": false,
"collapsed": true,
"link": {
"type": "generated-index"
}
Expand Down
2 changes: 1 addition & 1 deletion docs/about/specs/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 2,
"position": 3,
"label": "Chain Specifications",
"collapsible": true,
"collapsed": true,
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 2
sidebar_position: 3
description: Gnosis uses a unique dual-token model, xdai for fees, gno for consensus
keywords: [gnosis tokens, gnosis gno, gno token, xdai token, fee token, gno validation]
---
Expand Down
9 changes: 9 additions & 0 deletions docs/about/tokens/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"position": 2,
"label": "Token",
"collapsible": true,
"collapsed": true,
"link": {
"type": "generated-index"
}
}
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ xDai tokens are native tokens on Gnosis and also used to pay for execution of sm

### Bridge

Convert DAI from Ethereum to xDai using the [xDai Bridge](/bridges/tokenbridge/xdai-bridge).
Convert DAI from Ethereum to xDai using the [Unified Gnosis Bridge App](/bridges/usebridges).

### Buy xDAI

Expand Down
29 changes: 16 additions & 13 deletions docs/bridges/Bridge Explorer.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,22 @@ keywords: [gnosis bridge, bridge architecture, omnibridge, xdai bridge]

# Bridge Explorer

Bridge explorer allows user to check bridge transactions of xDAI bridge and Omnibridge, bridges configurations, and validators status. Users may also claim their bridge transactions in bridge explorer.
Bridge explorer allows user to check bridge transactions of Gnosis Bridge, bridges configurations, and validators status. Users may also claim their bridge transactions in bridge explorer.

:::info
https://bridge-explorer.gnosischain.com/
https://bridge-explorer.gnosischain.com/bridge-explorer/latest-transactions
:::


## Transactions

### How to search for your transation?

1. Select **xDAI** for [xDAI bridge](./tokenbridge/xdai-bridge.md) transaction or **Omnibridge** for [Omnibridge](./tokenbridge/omnibridge.md) transaction.
2. Search the transaction by inserting the transaction hash or initiator/receiver address.
3. You can use different filter options to filter out the unrelevant transactions.
4. Click on the transaction item to check the details of the transaction.
1. Search the transaction by inserting the transaction hash or initiator/receiver address.
2. You can use different filter options to filter out the unrelevant transactions.
3. Click on the transaction item to check the details of the transaction.

![Search Transaction](../../static/img/bridges/bridge-explorer/search-tx.png)
![Search Transaction](../../static/img/bridges/bridge-explorer/search-new-tx.png)

### What does different filters mean?

Expand All @@ -37,7 +36,7 @@ https://bridge-explorer.gnosischain.com/
**Direction**

1. Gnosis > Mainnet: The transaction is initiated from Gnosis Chain, and bridged to Ethereum mainnet, user need to claim the transaction on Ethereum mainnet.
2. Mainnet > Gnosis: The transaction is initiated from Ethereum mainnet, and bridged to Gnossi Chain.
2. Mainnet > Gnosis: The transaction is initiated from Ethereum mainnet, and bridged to Gnosis Chain.

**Signed by**

Expand All @@ -53,8 +52,12 @@ https://bridge-explorer.gnosischain.com/
2. Search for your transaction
3. Click **Claim** button to claim your transaction.

![claim tx](../../static/img/bridges/bridge-explorer/claim-tx.png)

![Claim Transaction](../../static/img/bridges/bridge-explorer/claim-new.png)

You can also claim your transaction from Transaction page.

![Claim Transaction page](../../static/img/bridges/bridge-explorer/claim-tx-page.png)

### Daily bridge limits

Expand All @@ -67,23 +70,23 @@ This section shows insight of bridge limit and is reset every `Daily limit reset
- Ethereum -> Gnosis Chain: Maximum amount of DAI/token that bridge validators can execute and bridge from Gnosis to Ethereum in a day.
- Gnosis Chain -> Ethereum: Maximum amount of XDAI/token that bridge validators can execute and bridge from Ethereum to Gnosis in a day.
3. **Min. per transaction**: Minimum amount of token that users can bridge in a single transaction.
4. **Max. per transaction**: Maximum amount of DAI that users can bridge in a single transaction.
4. **Max. per transaction**: Maximum amount of token that users can bridge in a single transaction.
5. **Execution max. per transaction**: Maximum amount of token that validators can execute in a single transaction.
6. **Daily limit reset**: In how many hours will the daily limit get reset to zero.
7. **Token address**: Token address of corresponding token, native token(xDAI) don't have an address.

![](../../static/img/bridges/bridge-explorer/bridge-info.png)
![](../../static/img/bridges/bridge-explorer/bridge-info-new.png)

### Configuration

This section shows the address of key contracts.
![](../../static/img/bridges/bridge-explorer/bridge-configuration.png)
![](../../static/img/bridges/bridge-explorer/bridge-configuration-new.png)

## Validators

This section shows the insight of current bridges validators, including last seen ago, total signed and executed transactions in 24 hours, balance of validators and their addresses.

![](../../static/img//bridges/bridge-explorer/validator-status.png)
![](../../static/img//bridges/bridge-explorer/validator-status-new.png)


If you are not coming from Ethereum, you can use one of the following bridges:
Expand Down
24 changes: 5 additions & 19 deletions docs/bridges/Bridges Architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,37 +7,23 @@ sidebar_position: 4

Gnosis has three main types of bridges:

- **Native Bridges**: built into the chain itself, and mint the [canonical token](./tokenbridge/omnibridge.md#canonical-token-registries) representation of the original asset on Gnosis (e.g. "Canonical Dai", "Canonical ETH")
- **Native Bridges**: built into the chain itself, and mint the xDAI and ERC20 token from Ethereum to Gnosis Chain
- **3rd-party Bridges**: these are maintained by 3rd parties and allow users to swap for canonical tokens created by native bridges
- **Application-Specific Bridges**: some applications may provide custom bridges that maintain their own canonical token on Gnosis

![Diagrams overview of Bridges](../../static/img/bridges/diagrams/bridge-overview.svg)

## Native Bridges
## Gnosis Chain Bridge

Gnosis has two native bridges:
Gnosis Chain bridge :
- allows to mint the native stablecoin xDAI on gnosis chain by bridging DAI from Ethereum
- allows to bridge ERC2O token from Ethereum to Gnosis Chain

- **xDai Bridge** that is used to mint the native stablecoin by bridging Dai from Ethereum
- **Omnibridge** and underlying **Arbitrary Message Bridge** that are used for bridging tokens and data

### Bridging Dai

See the [xDai Bridge](/bridges/tokenbridge/xdai-bridge).

### Bridging Data

See the [Arbitrary Message Passing Bridge](/bridges/tokenbridge/amb-bridge) or AMB Bridge for short.

### Bridging Tokens

See the [Omnibridge](/bridges/tokenbridge/omnibridge), which is built on top of the [Arbitrary Message Passing Bridge](/bridges/tokenbridge/amb-bridge).

## Canonical Bridged Tokens

Tokens that are bridged using [Omnibridge](/bridges/tokenbridge/omnibridge) are regarded as canonical representations of the origin token on Gnosis Chain.

- [Canonical Bridged Tokens](https://gnosis.blockscout.com/tokens?tab=bridged)
- Select the origin chain by using **Filter** option.

## Roadmap

Expand Down
12 changes: 6 additions & 6 deletions docs/bridges/Build with Bridges/using-omnibridge/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,28 +7,28 @@ keywords: [omnibridge, token bridge, gnosis, bsc, ethereum]
# OmniBridge

:::info
The OmniBridge and the OmniBridge UI are experimental software in Beta which you use at your own risk. The OmniBridge UI can be accessed here: https://omni.gnosischain.com/bridge
The Legacy OmniBridge and the legacy OmniBridge UI are now deprecated but still available, use it at your own risk. The OmniBridge UI can be accessed here: https://omni.legacy.gnosischain.com/bridge
:::
The Omnibridge can be used to bridge ERC-20 tokens between Ethereum and Gnosis. The first time a token is bridged, a new ERC677 token contract is deployed on GC with an additional suffix to differentiate the token. It will say "token name on xDai", as this was the original chain name prior to re-branding. If a token has been bridged previously, the previously deployed contract is used. The requested token amount is minted and sent to the account initiating the transfer (or an alternative receiver account specified by the sender).

- [Tokenbridge Docs: Using the Omnibridge UI](https://docs.tokenbridge.net/eth-xdai-amb-bridge/multi-token-extension/ui-to-transfer-tokens)
- [Tokenbridge Docs](https://docs.tokenbridge.net/eth-xdai-amb-bridge/multi-token-extension/ui-to-transfer-tokens)

## Transfer any ERC-20 token from Ethereum to Gnosis

It is possible to use the OmniBridge UI to transfer any ERC20 from Ethereum to xDai. Any user can initiate this initial transfer. Once the token exists on Gnosis, it can be transferred back and forth using the same UI.
It is possible to use the [Gnosis Bridge](https://bridge.gnosischain.com) to transfer any ERC20 from Ethereum to xDai. Any user can initiate this initial transfer. Once the token exists on Gnosis, it can be transferred back and forth using the same UI.

### Token Transfer

In this example, we transfer the Basic Attention Token (BAT) from Ethereum to xDai. When this process was started, this token does not yet exist on Gnosis. It takes less than 5 minutes and some ETH for gas fees.

1. Go the the [OmniBridge UI](https://omni.gnosischain.com/bridge)
1. Go the the [Legacy OmniBridge UI](https://omni.legacy.gnosischain.com/bridge)

- Connect your wallet to the Ethereum Mainnet
- Select the token you want to transfer (here we select BAT) and enter the amount
- Click Unlock and approve the account interaction.

:::note
These screenshots were taken back when Basic Attention Token (BAT) was first bridged. The steps are the same, but note that the url is old and is now https://omni.gnosischain.com/bridge
These screenshots were taken back when Basic Attention Token (BAT) was first bridged. The steps are the same, but note that the url is old and is now https://omni.legacy.gnosischain.com/bridge
:::
![](/img/bridges/omni-tokentransfer1.jpg) 2. Confirm the transaction to approve
![](/img/bridges/omni-tokentransfer2.jpg) 3. Once transaction approval is complete, you can now Transfer BAT to BAT on xDai. Click Transfer.
Expand Down Expand Up @@ -67,7 +67,7 @@ When switching between networks within the same bridge, press the arrows icon in
## Transfer Tokens without the UI

The instructions below use the Etherscan UI and the Blockscout UI to demonstrate the token transfer process.
There is an [OMNIBRIDGE UI](https://omni.gnosischain.com/bridge) also available which calls the methods of the multi-token mediators contracts described below.
There is [Legacy OMNIBRIDGE UI](https://omni.legacy.gnosischain.com/bridge) also available which calls the methods of the multi-token mediators contracts described below.

### General Case: ERC-20 Token Transfer

Expand Down
5 changes: 3 additions & 2 deletions docs/bridges/Build with Bridges/using-xdai-bridge/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ keywords: [xdai bridge, token bridge, ethereum, gnosis, gnosis bridge]
You will need some Dai to transfer AND some ETH for gas (transaction fees). [Bridge minimum/maximum amounts](../../tokenbridge/xdai-bridge.md#fees--daily-limits) are set by the [bridge governors](../../tokenbridge/xdai-bridge.md#bridge-governance). Bridge may take some time to update chain stats, try refreshing or waiting a minute if you receive any errors. You can also select a [different RPC](#custom-rpc) in the Settings dropdown.
:::

1. Go to the [xDai Bridge UI](https://bridge.gnosischain.com/) and connect your wallet to the Ethereum Mainnet. Once connected, you will see your address populated in the header, and your DAI and xDai balance displayed on the page. If you change the dropdown on the page (ETH Mainnet) but not in MetaMask, the interface will update but your wallet will not auto-connect to the chain. _Switching chains in MetaMask_ however will automatically update the interface.

1. Go to the [Legacy xDai Bridge UI](https://bridge.legacy.gnosischain.com/) and connect your wallet to the Ethereum Mainnet. Once connected, you will see your address populated in the header, and your DAI and xDai balance displayed on the page. If you change the dropdown on the page (ETH Mainnet) but not in MetaMask, the interface will update but your wallet will not auto-connect to the chain. _Switching chains in MetaMask_ however will automatically update the interface.
2. Enter the amount of Dai you would like to transfer to Gnosis, and click the Transfer button.
3. The web3 wallet window will open with transaction details. The default gas price is fine, if you would like a faster transaction you can increase. Click Submit or Confirm (depending on wallet) to initiate the transaction.
4. Wait for the transaction confirmation (this can take some time if the network is super congested). The transaction is considered finalized after 8 blocks. To check on a pending transaction, click on the tx in the UI.
Expand All @@ -30,7 +31,7 @@ It is recommended to use Google Chrome and MetaMask without Ad Blockers to compl
You will need a **small additional amount of xDai** to process the first transaction, and an **additional amount of Eth** to process the claim transaction on Ethereum.
:::

1. Go to the [xDai Bridge UI](https://bridge.gnosischain.com/) and connect your wallet to Gnosis Chain. Once connected, you will see your address populated in the header, and your DAI and xDai balance displayed on the page. If you change the dropdown on the page but not in MetaMask, the interface will update but your wallet will not auto-connect to the chain. _Switching chains in MetaMask_ however will automatically update the interface.
1. Go to the [Legacy xDai Bridge UI](https://bridge.legacy.gnosischain.com/) and connect your wallet to Gnosis Chain. Once connected, you will see your address populated in the header, and your DAI and xDai balance displayed on the page. If you change the dropdown on the page but not in MetaMask, the interface will update but your wallet will not auto-connect to the chain. _Switching chains in MetaMask_ however will automatically update the interface.
2. Enter the amount of xDai you would like to transfer to Dai, and click the Request button. Note that there exists a [minimum amount](../../tokenbridge/xdai-bridge.md#fees--daily-limits).
3. Confirm that you will need to perform 2 transactions, and will need xDai and Eth to complete the transfer. Click **Confirm** to process the transaction on Gnosis Chain.
4. Your web3 wallet window will open with transaction details.
Expand Down
17 changes: 6 additions & 11 deletions docs/bridges/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,14 @@ title: Intro to Gnosis Bridges
keywords: [gnosis bridges, omnibridge, xdai bridge]
---

Welcome to Gnosis Bridges! 🎉
Currently, there are two types of bridges offered by Gnosis, [xDai Bridge](https://bridge.gnosischain.com/) and [OmniBridge](https://omni.gnosischain.com/bridge). Let's take a quick look at both of these.
Welcome to Gnosis Bridges! 🎉

<Card
title="What is Omni Bridge ?"
subtitle="Omnibridge is a native token bridge that mints the canonical representations of bridged assets on Gnosis and connects Gnosis to Ethereum. The first time a token is bridged, a new ERC677 token contract is deployed on GC with an additional suffix to differentiate the token. It will say 'token name on xDai', as this was the original chain name prior to re-branding.The requested token amount is minted and sent to the account initiating the transfer (or an alternative receiver account specified by the sender).
Read more here on architecture of Omni Bridge."
url="https://omni.gnosischain.com/"
/>
title="What is Gnosis Bridge App?"
subtitle="Gnosis Chain bridge is a single bridge which allows you to bridge ERC20 tokens and xDAI token from Ethereum to Gnosis Chain and vice-versa. The requested token amount is minted and sent to the account initiating the transfer (or an alternative receiver account specified by the sender)."
url="https://bridge.gnosischain.com"

<Card
title="What is xDai Bridge ?"
subtitle="The xDai bridge is a native Dai bridge from Ethereum that is used to mint and burn xDai, the native asset used for gas and transaction fees on Gnosis. This bridge allows users to transform DAI (an ERC20 stable token) on the mainnet into xDAI on a compatible chain. xDAI tokens can then be sent quickly and with minimal cost on the xDAI network. The xDAI chain has been a breakout success in the Ethereum community, providing an easy way for vendors to accept a stable cryptocurrency. Read more here on architecture of xDai Bridge."
url="https://bridge.gnosischain.com/"
/>



4 changes: 2 additions & 2 deletions docs/bridges/Token Bridge/omnibridge.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@ keywords: [omnibridge, token bridge, token claim]
# Omnibridge

:::info
Omnibridge can be accessed at [omni.gnosischain.com](https://omni.gnosischain.com/)
Legacy Omnibridge can be accessed at https://omni.legacy.gnosischain.com/bridge
:::

![](/img/bridges/diagrams/token-bridge-01.png)

## Key Information

[Omnibridge](https://omni.gnosischain.com/) is a native token bridge that mints the canonical representations of bridged assets on Gnosis. The Omnibridge is built on top of the [Arbitrary Message Bridge (AMB)](/bridges/tokenbridge/amb-bridge) and thus relies on the same group of [Trusted Bridge Validators](/bridges/tokenbridge/amb-bridge#bridge-validators) and trust model as the AMB. With [Telepathy added as the 8th validator](../governance/decisions.md#add-telepathy-validator-in-the-amb), Omnibridge bridge is now more secure with trustless zero-knowledge light client technology. Check out how Omnibridge works with Telepathy validator [here](amb-bridge.md#how-it-works-with-telepathy-validator).
[Omnibridge](https://omni.legacy.gnosischain.com/bridge) is a native token bridge that mints the canonical representations of bridged assets on Gnosis. The Omnibridge is built on top of the [Arbitrary Message Bridge (AMB)](/bridges/tokenbridge/amb-bridge) and thus relies on the same group of [Trusted Bridge Validators](/bridges/tokenbridge/amb-bridge#bridge-validators) and trust model as the AMB. With [Telepathy added as the 8th validator](../governance/decisions.md#add-telepathy-validator-in-the-amb), Omnibridge bridge is now more secure with trustless zero-knowledge light client technology. Check out how Omnibridge works with Telepathy validator [here](amb-bridge.md#how-it-works-with-telepathy-validator).

The Omnibridge currently connects Gnosis to Ethereum.

Expand Down
5 changes: 3 additions & 2 deletions docs/bridges/Token Bridge/xdai-bridge.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,12 @@ keywords: [xdai bridge, bridge, dai, ethereum, gnosis bridge]

:::info

The xDai bridge can be found at [bridge.gnosischain.com](https://bridge.gnosischain.com/)
The Legacy xDai bridge can be found at https://bridge.legacy.gnosischain.com/


:::

The [xDai bridge](https://bridge.gnosischain.com) is a native Dai bridge from Ethereum that is used to mint and burn [xDai](/concepts/tokens/xdai), the native asset used for gas and transaction fees on Gnosis.
The [Legacy xDai bridge](https://bridge.legacy.gnosischain.com/) is a native Dai bridge from Ethereum that is used to mint and burn [xDai](/concepts/tokens/xdai), the native asset used for gas and transaction fees on Gnosis.

![xDai Bridge Diagram](/img/bridges/diagrams/dai-bridge-01.png)

Expand Down
2 changes: 0 additions & 2 deletions docs/bridges/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,4 @@ Hashi is an EVM Hash Oracle Aggregator designed to enhance cross-chain bridge se
### Telepathy, zkSNARK-enabled Light Client bridge validator
Succinct Lab's zkSNARK-enabled Light Client, Telepathy, launched in July 2023, has emerged as a key component of the AMB bridge ecosystem. Utilizing zkSNARKs, Telepathy provides validity proofs, ensuring trustless verification of transaction events across chains. This solution has become one of the most active bridge validators in the AMB network, enhancing security and reliability for cross-chain transactions.

![Hashi Architecture](../../static/img/bridges/diagrams/Hashi-architecture.png)

After successful audits and release, we aim to gradually migrate our canonical bridges to Hashi’s distributed trust model.
Loading
Loading