update bridges content

gnosischain · Jul 28, 2023 · f37cfca · f37cfca
1 parent 6e87940
commit f37cfca
Show file tree

Hide file tree

Showing 35 changed files with 1,449 additions and 1,208 deletions.
diff --git a/docs/about/faq/FAQ.md b/docs/about/faq/FAQ.md
diff --git a/docs/about/networks/optimism.md b/docs/about/networks/optimism.md
@@ -15,23 +15,22 @@ An Optimism implementation is deployed on Gnosis. Gnosis functions as the L1 (ak
 
 Deployment processes are similar to using [Optimism with Ethereum](https://community.optimism.io/) with updated configs to match the Gnosis chain setup.
 
-
-| Parameter                        | Value                                                                         |
-| -------------------------------- | ---------------------- |
-| Network Name                     | Optimism on Gnosis     |
-| Chain ID                         | 300                    |
+| Parameter    | Value              |
+| ------------ | ------------------ |
+| Network Name | Optimism on Gnosis |
+| Chain ID     | 300                |
 
 ## Make a Deposit
 
 :::danger DEPRECATED NETWORK!
 Do NOT deposit funds, they will not be withdrawable.
 :::
 
-Deposits are initiated through the [Proxy\_\_OVM\_L1StandardBridge contract](https://blockscout.com/xdai/mainnet/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/transactions) on the Gnosis Chain with the **`depositETH`** method and the following inputs:
+Deposits are initiated through the [Proxy\_\_OVM_L1StandardBridge contract](https://gnosis.blockscout.com/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/transactions) on the Gnosis Chain with the **`depositETH`** method and the following inputs:
 
-* \_l2Gas: **`200000`**
-* data: **`0x`**
-* value: **`Deposit value in xDai (ie. 0.1 = 0.1 xDai)`**
+- \_l2Gas: **`200000`**
+- data: **`0x`**
+- value: **`Deposit value in xDai (ie. 0.1 = 0.1 xDai)`**
 
 :::info
 Some smart contract wallets are blocked from calling the `depositETH (and depositERC20) methods`. If you want to deposit using a smart contract wallet you can use the `depositETHTo function instead.`
@@ -40,18 +39,18 @@ Some smart contract wallets are blocked from calling the `depositETH (and deposi
 <details>
     <summary>Example using BlockScout</summary>
 
-1. Go to [https://blockscout.com/xdai/mainnet/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/write-proxy](https://blockscout.com/xdai/mainnet/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/write-proxy)
+1. Go to [https://gnosis.blockscout.com/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/write-proxy](https://gnosis.blockscout.com/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/write-proxy)
 
 2. Connect a web3 wallet like MetaMask that contains some xDai for funding and gas fees.
 
 ![](/img/about/optimism/connect-wallet.png)
 
 3. Scroll down to the **`depositETH`** method and enter the following:
 
-* _l2Gas: **`200000`**
-* _data: **`0x`**
-* value: **`Deposit value in xDai`**
-* Click **Write** and complete the transaction with your wallet.
+- \_l2Gas: **`200000`**
+- \_data: **`0x`**
+- value: **`Deposit value in xDai`**
+- Click **Write** and complete the transaction with your wallet.
 
 ![](/img/about/optimism/method.png)
 
@@ -65,48 +64,47 @@ It may take several minutes for the deposit to be processed and the balance to u
 
 Additional Info related to specific contracts is [available here](https://github.com/ethereum-optimism/optimism/tree/56961f9208af8a43a25a138cce21ef488c418141/packages/contracts/docs).
 
-| Contract                             | Address                                                                                                                                           |
-| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| BondManager                          | [0x730fE4431a00286Ff8dc7E9B03c661E63Ef05121](https://blockscout.com/xdai/mainnet/address/0x730fE4431a00286Ff8dc7E9B03c661E63Ef05121/transactions) |
-| CanonicalTransactionChain            | [0x636434F59e52D50423bD8272FEB3B2bff5dF586b](https://blockscout.com/xdai/mainnet/address/0x636434F59e52D50423bD8272FEB3B2bff5dF586b/transactions) |
-| ChainStorageContainer-CTC-batches    | [0xEc64fee4f95E48A3BAd799A5912F183d222086A8](https://blockscout.com/xdai/mainnet/address/0xEc64fee4f95E48A3BAd799A5912F183d222086A8/transactions) |
-| ChainStorageContainer-SCC-batches    | [0x26EbaD990cC56ef36166d1C4114CEF25F024b75D](https://blockscout.com/xdai/mainnet/address/0x26EbaD990cC56ef36166d1C4114CEF25F024b75D/transactions) |
-| ChugSplashDictator                   | [0x77fAf5Aa4EB7874a676F773fc308e0FD8e9400f7](https://blockscout.com/xdai/mainnet/address/0x77fAf5Aa4EB7874a676F773fc308e0FD8e9400f7/transactions) |
-| ERC1820Registry                      | [x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24](https://blockscout.com/xdai/mainnet/address/0x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24/transactions)  |
-| L1StandardBridge                     | [0x3804bA4ecC886AAe91A6D57dE880616E17C8269C](https://blockscout.com/xdai/mainnet/address/0x3804bA4ecC886AAe91A6D57dE880616E17C8269C/transactions) |
-| OVM\_L1CrossDomainMessenger          | [0x6A52b1dbE0293F1ba1bc136b0f8C8f0395F940b9](https://blockscout.com/xdai/mainnet/address/0x6A52b1dbE0293F1ba1bc136b0f8C8f0395F940b9/transactions) |
-| OVM\_Proposer                        | [0xE57cfefE4B7EddE88af28d4ffB3BD63b272f578A](https://blockscout.com/xdai/mainnet/address/0xE57cfefE4B7EddE88af28d4ffB3BD63b272f578A/transactions) |
-| OVM\_Sequencer                       | [0xFDCa025dB7368A84deeCc0d82598eB90638D52DF](https://blockscout.com/xdai/mainnet/address/0xFDCa025dB7368A84deeCc0d82598eB90638D52DF/transactions) |
-| Proxy\_\_OVM\_L1CrossDomainMessenger | [0x4324fdD26161457f4BCc1ABDA87709d3Be8Fd10E](https://blockscout.com/xdai/mainnet/address/0x4324fdD26161457f4BCc1ABDA87709d3Be8Fd10E/transactions) |
-| Proxy\_\_OVM\_L1StandardBridge       | [0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80](https://blockscout.com/xdai/mainnet/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/transactions) |
-| StateCommitmentChain                 | [0xbAE5EA90F4A1dFBC1b0D145453f371E06287a6D8](https://blockscout.com/xdai/mainnet/address/0xbAE5EA90F4A1dFBC1b0D145453f371E06287a6D8/transactions) |
-
+| Contract                            | Address                                                                                                                                     |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| BondManager                         | [0x730fE4431a00286Ff8dc7E9B03c661E63Ef05121](https://gnosis.blockscout.com/address/0x730fE4431a00286Ff8dc7E9B03c661E63Ef05121/transactions) |
+| CanonicalTransactionChain           | [0x636434F59e52D50423bD8272FEB3B2bff5dF586b](https://gnosis.blockscout.com/address/0x636434F59e52D50423bD8272FEB3B2bff5dF586b/transactions) |
+| ChainStorageContainer-CTC-batches   | [0xEc64fee4f95E48A3BAd799A5912F183d222086A8](https://gnosis.blockscout.com/address/0xEc64fee4f95E48A3BAd799A5912F183d222086A8/transactions) |
+| ChainStorageContainer-SCC-batches   | [0x26EbaD990cC56ef36166d1C4114CEF25F024b75D](https://gnosis.blockscout.com/address/0x26EbaD990cC56ef36166d1C4114CEF25F024b75D/transactions) |
+| ChugSplashDictator                  | [0x77fAf5Aa4EB7874a676F773fc308e0FD8e9400f7](https://gnosis.blockscout.com/address/0x77fAf5Aa4EB7874a676F773fc308e0FD8e9400f7/transactions) |
+| ERC1820Registry                     | [x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24](https://gnosis.blockscout.com/address/0x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24/transactions)  |
+| L1StandardBridge                    | [0x3804bA4ecC886AAe91A6D57dE880616E17C8269C](https://gnosis.blockscout.com/address/0x3804bA4ecC886AAe91A6D57dE880616E17C8269C/transactions) |
+| OVM_L1CrossDomainMessenger          | [0x6A52b1dbE0293F1ba1bc136b0f8C8f0395F940b9](https://gnosis.blockscout.com/address/0x6A52b1dbE0293F1ba1bc136b0f8C8f0395F940b9/transactions) |
+| OVM_Proposer                        | [0xE57cfefE4B7EddE88af28d4ffB3BD63b272f578A](https://gnosis.blockscout.com/address/0xE57cfefE4B7EddE88af28d4ffB3BD63b272f578A/transactions) |
+| OVM_Sequencer                       | [0xFDCa025dB7368A84deeCc0d82598eB90638D52DF](https://gnosis.blockscout.com/address/0xFDCa025dB7368A84deeCc0d82598eB90638D52DF/transactions) |
+| Proxy\_\_OVM_L1CrossDomainMessenger | [0x4324fdD26161457f4BCc1ABDA87709d3Be8Fd10E](https://gnosis.blockscout.com/address/0x4324fdD26161457f4BCc1ABDA87709d3Be8Fd10E/transactions) |
+| Proxy\_\_OVM_L1StandardBridge       | [0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80](https://gnosis.blockscout.com/address/0x184a119d4C1D08A459FCfBFe7ECc051c163B4c80/transactions) |
+| StateCommitmentChain                | [0xbAE5EA90F4A1dFBC1b0D145453f371E06287a6D8](https://gnosis.blockscout.com/address/0xbAE5EA90F4A1dFBC1b0D145453f371E06287a6D8/transactions) |
 
 ## L2 Contract Addresses
 
-* Optimism L2 contracts can be explored at [https://blockscout.com/xdai/optimism](https://blockscout.com/xdai/optimism)
-* Additional Info related to specific contracts is [available here](https://github.com/ethereum-optimism/optimism/tree/56961f9208af8a43a25a138cce21ef488c418141/packages/contracts/docs).
-* Summaries for [relevant predeploys here](https://github.com/ethereum-optimism/optimism/blob/8d67991aba584c1703692ea46273ea8a1ef45f56/specs/protocol/components/predeploys.md).
-
-| Contract                     | Address                                    |
-| ---------------------------- | ------------------------------------------ |
-| OVM\_L2ToL1MessagePasser     | 0x4200000000000000000000000000000000000000 |
-| OVM\_L1MessageSender         | 0x4200000000000000000000000000000000000001 |
-| OVM\_DeployerWhitelist       | 0x4200000000000000000000000000000000000002 |
-| OVM\_ECDSAContractAccount    | 0x4200000000000000000000000000000000000003 |
-| OVM\_SequencerEntrypoint     | 0x4200000000000000000000000000000000000005 |
-| OVM\_ETH                     | 0x4200000000000000000000000000000000000006 |
-| OVM\_L2CrossDomainMessenger  | 0x4200000000000000000000000000000000000007 |
-| Lib\_AddressManager          | 0x4200000000000000000000000000000000000008 |
-| OVM\_ProxyEOA                | 0x4200000000000000000000000000000000000009 |
-| OVM\_L2StandardBridge        | 0x4200000000000000000000000000000000000010 |
-| OVM\_SequencerFeeVault       | 0x4200000000000000000000000000000000000011 |
-| OVM\_ExecutionManagerWrapper | 0x420000000000000000000000000000000000000B |
-| OVM\_GasPriceOracle          | 0x420000000000000000000000000000000000000F |
+- Optimism L2 contracts can be explored at [https://blockscout.com/xdai/optimism](https://blockscout.com/xdai/optimism)
+- Additional Info related to specific contracts is [available here](https://github.com/ethereum-optimism/optimism/tree/56961f9208af8a43a25a138cce21ef488c418141/packages/contracts/docs).
+- Summaries for [relevant predeploys here](https://github.com/ethereum-optimism/optimism/blob/8d67991aba584c1703692ea46273ea8a1ef45f56/specs/protocol/components/predeploys.md).
+
+| Contract                    | Address                                    |
+| --------------------------- | ------------------------------------------ |
+| OVM_L2ToL1MessagePasser     | 0x4200000000000000000000000000000000000000 |
+| OVM_L1MessageSender         | 0x4200000000000000000000000000000000000001 |
+| OVM_DeployerWhitelist       | 0x4200000000000000000000000000000000000002 |
+| OVM_ECDSAContractAccount    | 0x4200000000000000000000000000000000000003 |
+| OVM_SequencerEntrypoint     | 0x4200000000000000000000000000000000000005 |
+| OVM_ETH                     | 0x4200000000000000000000000000000000000006 |
+| OVM_L2CrossDomainMessenger  | 0x4200000000000000000000000000000000000007 |
+| Lib_AddressManager          | 0x4200000000000000000000000000000000000008 |
+| OVM_ProxyEOA                | 0x4200000000000000000000000000000000000009 |
+| OVM_L2StandardBridge        | 0x4200000000000000000000000000000000000010 |
+| OVM_SequencerFeeVault       | 0x4200000000000000000000000000000000000011 |
+| OVM_ExecutionManagerWrapper | 0x420000000000000000000000000000000000000B |
+| OVM_GasPriceOracle          | 0x420000000000000000000000000000000000000F |
 
 ## Graph Protocol
 
 When starting the graph-node the network key is: **`optimism`**
 
-* Graph [https://graph-optimism.gnosischain.com/](https://graph-optimism.gnosischain.com/)
-* Admin [https://admin-graph-optimism.gnosischain.com/](https://admin-graph-optimism.gnosischain.com/)
+- Graph [https://graph-optimism.gnosischain.com/](https://graph-optimism.gnosischain.com/)
+- Admin [https://admin-graph-optimism.gnosischain.com/](https://admin-graph-optimism.gnosischain.com/)
diff --git a/docs/bridges/README.md b/docs/bridges/README.md
@@ -8,38 +8,42 @@ keywords: [gnosis bridge, bridge architecture, omnibridge, xdai bridge]
 
 Gnosis' native bridges allow for sending tokens and data, and are run by a group of [trusted bridge validators](/bridges/tokenbridge/amb-bridge#bridge-validators). There is a [roadmap](/bridges/roadmap) to move towards [trustless bridges](/bridges/roadmap#trustless-bridges).
 
-There is a growing ecosystem of [3rd-party Bridges](/user-guide/bridges) that build on top of native bridges, that provide users with fast liquidity and user experience.
+There is a growing ecosystem of [3rd-party Bridges](third-party.md) that build on top of native bridges, that provide users with fast liquidity and user experience.
+
+Gnosis' native bridges are first-class citizens in the chain's architecture due to the [native xDai bridge's](/bridges/tokenbridge/xdai-bridge) integral role in minting and burning the native [xDai token](/about/tokens/xdai) used for gas.
 
-Gnosis' native bridges are first-class citizens in the chain's architecture due to the [native xDai bridge's](/bridges/tokenbridge/xdai-bridge) integral role in minting and burning the native [xDai token](/about/tokens/xdai) used for gas. 
 ## Conceptual Architecture
 
-Gnosis has three main types of bridges: 
+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")
+- **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
 
-- **Native Bridges**: built into the chain itself, and mint the [canonical token](#canonical-tokens) representation of the original asset on Gnosis (e.g. "Canonical Dai", "Canonical ETH")
-- **3rd-party Bridges**: these are maintained by 3rd parties and allow users to swap for [canonical tokens](#canonical-tokens) created by native bridges
-- **Application-Specific Bridges**: some applications may provide custom bridges that maintain their own [canonical token](#canonical-tokens) on Gnosis
+![Diagrams overview of Bridges](../../static/img/bridges/diagrams/bridge-overview.svg)
 
-![Diagrams overview of Bridges](/img/bridges/diagrams/bridge-overview.svg)
 ## Native Bridges
 
 Gnosis has two native bridges:
 
 - **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 
+- **Omnibridge** and underlying **Arbitrary Message Bridge** that are used for bridging tokens and data
 
 ### Bridging Dai
 
-See the [xDai Bridge](/bridges/tokenbridge/xdai-bridge). 
+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. 
+Tokens that are bridged using [Omnibridge](/bridges/tokenbridge/omnibridge) are regarded as canonical representations of the origin token on Gnosis Chain.
 
 - [Canonical Bridged Tokens from Ethereum](https://blockscout.com/xdai/mainnet/bridged-tokens/eth)
 - [Canonical Bridged Tokens from Binance Smart Chain](https://blockscout.com/xdai/mainnet/bridged-tokens/bsc)

diff --git a/docs/bridges/governance/README.md b/docs/bridges/governance/README.md
@@ -52,15 +52,15 @@ There are currently 16 Bridge Governors, of which 8-of-16 are required to pass a
 
 ### Phase 1: Ideation
 
-Post created on the Gnosis Forum in the [GnosisDAO category 108](https://forum.gnosis.io/c/dao/20). There is no set duration on how long a proposal stays in this stage. There is no formal requirement for a proposal to pass this stage. However, if a proposal discussion fails to garner momentum from the community, it is unlikely to become a successful proposal.
+Post created on the Gnosis Forum in the [GnosisDAO](https://forum.gnosis.io/). There is no set duration on how long a proposal stays in this stage. There is no formal requirement for a proposal to pass this stage. However, if a proposal discussion fails to garner momentum from the community, it is unlikely to become a successful proposal.
 
 ### Phase 2: Specification
 
-[Gnosis Improvement Proposal 73](https://forum.gnosis.io/t/gip-0-template/734) (GIP) post is created. This stage lasts 5 days. For the proposal to pass this stage, one outcome with a relative majority of votes on the forum poll must be achieved. If the relative majority of votes indicates `Make no changes`, the proposal does not pass to Phase 3.
+[Gnosis Improvement Proposal](https://forum.gnosis.io/t/gip-0-template/734) (GIP) post is created. This stage lasts 5 days. For the proposal to pass this stage, one outcome with a relative majority of votes on the forum poll must be achieved. If the relative majority of votes indicates `Make no changes`, the proposal does not pass to Phase 3.
 
 ### Phase 3: Multisig Voting & Execution
 
-[Gnosis Improvement Proposal 73](https://forum.gnosis.io/t/gip-0-template/734) (GIP) post is refined, and there is a [GnosisDAO Snapshot 60](https://snapshot.org/#/gnosis.eth) poll. This stage lasts for 7 days. For proposals to be accepted there must be one outcome with a relative majority of GNO used for signaling on the GnosisDAO Snapshot poll accompanied by a yes-voting quorum of a minimum of 4% of the circulating supply of GNO. If the relative majority of GNO used in signaling on the Snapshot poll indicates the result Make no changes, the proposal will not be accepted and considered closed.
+[Gnosis Improvement Proposal](https://forum.gnosis.io/t/gip-0-template/734) (GIP) post is refined, and there is a [GnosisDAO Snapshot](https://snapshot.org/#/gnosis.eth) poll. This stage lasts for 7 days. For proposals to be accepted there must be one outcome with a relative majority of GNO used for signaling on the GnosisDAO Snapshot poll accompanied by a yes-voting quorum of a minimum of 4% of the circulating supply of GNO. If the relative majority of GNO used in signaling on the Snapshot poll indicates the result Make no changes, the proposal will not be accepted and considered closed.
 
 ## Governance Parameters