Game7 Dev Hub
  • Built for Players
  • The G7 Network
  • Building on the G7 Network
    • G7 Network Information
    • Connecting to the Network
    • G7 Token and Faucet
    • Bridging G7
    • Using G7 Network Explorer
    • G7 Testnet Bridge
    • G7 Sepolia Faucet
    • G7 Sepolia Block Explorer
  • World Builder
  • G7 Network Technology Partners
  • Open-source Commitment
  • Game7 Brand Kit
  • Additional Contracts and Services
  • Terms of Service
  • Privacy Policy
Powered by GitBook

Copyright (c) 2024 Game7 DAO

On this page
  • What is the Game7 Bridge
  • The Game7 Relay Bridge: Easy Option
  • How to Bridge with Game7 Relay Bridge
  • Using the Game7 Relay Bridge
  • The Game7 Canonical Bridge (Secure Option)
  • How to Bridge with the Game7 Canonical Bridge
  • Regarding Deposit and Withdrawals
  • Roll-Up Challenge Periods
Export as PDF
  1. Building on the G7 Network

Bridging G7

The canonical fungible token bridge for the G7 Network and more

PreviousG7 Token and FaucetNextUsing G7 Network Explorer

Last updated 4 months ago

What is the Game7 Bridge

The enables fungible token transfers between blockchains (such as Ethereum and Arbitrum) and the G7 Network (a Layer 3 network). The Game7 Bridge provides two bridging solutions: the and the .

The Game7 Bridge provides two bridging solutions:

1. (Quick & Easy)

  • Best for: Everyday transfers when you need tokens right away

  • Speed: Instant transfers

  • Cost: 2.5% fee when bridging out of G7 Network. Fees accumulate to the Citizen Pool.

  • Available on: Mainnet only (not available on test networks)

  • Supported networks: G7 Network, Arbitrum, Ethereum, and other EVM chains

(Secure & Free)

  • Best for: Large transfers where security is the top priority

  • Speed: 7-day waiting period when withdrawing

  • Cost: Free

  • Available on: Both mainnet and test networks

  • Supported networks: G7 Network, Arbitrum, Ethereum

  • Extra feature: Includes a messaging system for developers

The Game7 Canonical Bridge is currently available on Ethereum Sepolia, Arbitrum Sepolia, G7 Sepolia testnets, and Ethereum, Arbitrum One, and the G7 Network mainnets. The Game7 Relay Bridge supports mainnet bridging of G7 between Ethereum, Arbitrum, and the G7 Network.

The Game7 Relay Bridge: Easy Option

  • The Relay Bridge allows for instant bridging out of the G7 Network.

  • A total of 2.5% fee applied when bridging out of G7 Network. 1.75% will be transferred to the Citizen Pool and the remaining is paid to RelayLink.

The Game7 Relay Bridge supports mainnet bridging of $G7 between G7 Network, Arbitrum, and Ethereum, and other EVM chains.

How to Bridge with Game7 Relay Bridge

IMPORTANT: Make sure you have some ETH for gas fees on the destination network. When bridging $G7 to other network, it is required to have application gas tokens (i.e. ETH on Arbitrum and Ethereum) to transfer the $G7 tokens to another address (i.e. CEXs) once they are on Ethereum or Arbitrum.

Using the Game7 Relay Bridge

The Game7 Relay Bridge allows for the immediate bridging of supported tokens into and out of the G7 Network. The Game7 Relay Bridge is only available on the G7 Network (mainnet), and not G7 Sepolia (testnet). So for developers or users who wish to bridge tokens between testnets, should use the Game7 Canonical Bridge.

  1. Click Connect Wallet your supported wallet, such as MetaMask

  1. Select the networks that you want to bridge From and To via the drop down under each category

Note: Relay not only allows for bridging the same token between networks, but also supports a swap. For example, it is possible to bridge USDC on Ethereum to G7 on the Network G7 via the Game7 Relay Bridge.

  1. Select the tokens that you want to bridge From, and the token you want to bridge To, and input the amount in either field (the other field will automatically update based on current market prices).

  1. Click Review to see the full Quote, this is essentially the fee for the transaction, and confirm by clicking Swap.

  1. Complete the transaction by confirming in your connected wallet.

The selected tokens will now be received on your selected network. You can now view the status of the completed transaction by clicking View Details.

Although the Game7 Relay Bridge does not require a withdrawal, and therefore, no fee to claim the tokens on the bridged-to network, applicable gas tokens are still required to transfer the bridged tokens to another address once they are on Ethereum or Arbitrum.

The Game7 Canonical Bridge (Secure Option)

  • The Canonical Bridge applies a 7-day withdrawal period (challenge period) for security reasons and it is the most security option for large transfers.

  • There are no fees associated with bridging in/out of the G7 Network.

  • Only the Canonical Bridge supports bridging tokens on G7 Sepolia and other testnets (Ethereum Sepolia, Arbitrum Sepolia).

The Game7 Canonical Bridge is currently available on Ethereum Sepolia, Arbitrum Sepolia, G7 Sepolia testnets, and Ethereum, Arbitrum One, and the G7 Network mainnets.

How to Bridge with the Game7 Canonical Bridge

The Game7 Canonical Bridge is available for both developers and general users to easily transfer and withdraw supported fungible tokens to and from the G7 Network.

Using the Canonical Bridge on either testnet or mainnet networks requires gas tokens for the networks being utilized. In the case of G7 Sepolia, TG7T is required, while on Ethereum Sepolia and Arbitrum Sepolia, testnet ETH will be required.

In the below guide, we will reference testnet in the supporting images, but the flow is the same for mainnet. The only difference is that the gas tokens needed will be G7 on the G7 Network, and mainnet ETH on Ethereum and Arbitrum One.

The network - Mainnet/G7 Network or Testnet/G7 Sepolia - can be toggled via the selector at the top left of the page. For this bridging example, it will be set to Testnet.

  1. With your wallet connected, choose the network you want to bridge tokens From and To, and also switch the network in your wallet to the From network (this will often be prompted automatically).

  1. Select the token you wish to bridge. Enter the amount of the token into Amount field.

Note: Before being able to confirm the bridging action, you will need to ensure you have enough of the appropriate tokens for the transaction fees.

4a. Once you click Submit, you will be prompted to "Approve Allowance". This approval grants the bridge permission to transfer that amount of tokens which have been specified. When clicking Approve, you will be prompted to approve in this in your connected wallet.

4b. Once you have approved the allowance in your connected wallet, you will next need to approve the bridging transaction itself, so that the tokens will be bridged.

  1. After approving the bridging transaction, you will be automatically taken to the Activity tab. Here you can see the status of your transaction. It will first display a Pending state.

  1. Once the transaction has completed, the Activity tab will update the status of the transaction and an notification will be served, and the tokens will have been delivered to your wallet.

Regarding Deposit and Withdrawals

  • When you choose to Deposit tokens to the G7 Network or G7 Sepolia with the Canonical Bridge, the tokens will be received to your connected wallet once the transaction has finalized, with no further steps required.

  • When you choose to Withdraw tokens from the G7 Network or G7 Sepolia, once the transaction is finalized, the tokens will not be available in your connected wallet until you have manually selected to Withdraw the tokens via a Claim Now button. Note, that you will require a native token balance on the respected chain to make the withdrawal to pay the transaction fee on regardless of whether on mainnet or testnet.

  • It is required to Claim the bridged out assets for all tokens (such as USDC), not only G7. For all transactions you will need to return after the challenge period to claim the tokens back to your wallet.

Roll-Up Challenge Periods

The challenge period is one hour for G7 Sepolia, and seven days for G7 Network withdrawals when utilizing the Game7 Bridge.

You will see your pending claims transactions in the Activity tab.


The messaging protocol sends transactions through a specific smart contract (InboxContract) to create retryable tickets. Retryable tickets are a component of how one Layer communicates with another. This allows developers to generate transactions in the destination Layer by sending one to the origin Layer. Messaging enables us to send multiple retryable tickets in the same transaction on a Layer 1, triggering another retryable ticket on Layer 2, creating a chained transaction that ultimately reaches Layer 3. You can read more information on this .

The Game7 Relay Bridge integrates , an omni-chain bridge and swap application. This not only allows for the the bridging of G7 across chains where the G7 token has been deployed (such as Ethereum and Arbitrum One), but also allows for the swapping of tokens during the bridging process. Such as bridging USDC on Arbitrum One, and swapping it to G7 on G7 Network.

The Game7 Relay Bridge integrates, an omni-chain bridge and swap application. This not only allows for the bridging of G7 across chains where the G7 token has been deployed (such as Ethereum and Arbitrum One), but also allows for the swapping of tokens during the bridging process. Such as bridging USDC on Arbitrum One, and swapping it to G7 on G7 Network.

In the , navigate to the and select Relay

The Canonical Bridge delivers another feature with the inclusion of a built into the UI of the Bridge application.

The messaging protocol sends transactions through a specific smart contract (InboxContract) to create retryable tickets. Retryable tickets are a component of how one Layer communicates with another. This allows developers to generate transactions in the destination Layer by sending one to the origin Layer. Messaging enables us to send multiple retryable tickets in the same transaction on a Layer 1, triggering another retryable ticket on Layer 2, creating a chained transaction that ultimately reaches Layer 3. You can read more information on this.

The testnet version of the can also be accessed in the Game7 DevHub.

Navigate to the Game7 Bridge in the and connect a supported wallet such as MetaMask.

As with other Layer 3 networks, there are challenge periods for withdrawing tokens from the G7 Network. This challenge period is standard for and exists for fraud proofs, ensuring that only legitimate transactions are finalized.

Game7 Bridge
Layer 1 and Layer 2
Game7 Canonical Bridge
Game7 Relay Bridge
Game7 Relay Bridge
2. Game7 Canonical Bridge
here
Relay
Relay
Game7 DevHub
Game7 Bridge
messaging protocol
here
Canonical Bridge
Game7 DevHub
Optimistic rollups
Game7 - World builder
Logo
You can switch to the Canonical Bridge by clicking "Bridge" in the menu or clicking "Bridge with Canonical"
The above would bridge USDC on Arbitrum and swap to G7 on the G7 Network
Once the tokens and amounts have been set, and Route and gas fee will be displayed
The Quote will update with a new fee if the transaction is not executed, to ensure true market values are being used
If you have not used the Game7 Relay Bridge before you will need to approve the bridge to transfer the token you will bridge from
As we will be referencing testnet, Arbitrum Sepolia and G7 Sepolia are shown as network options
Once an amount has been defined, the Transaction Summary will update and the Submit button will become active
Approve the bridge to access the tokens and the amount you want to bridge. You can set a custom amount.
You can click the Transaction status icon (e.g Pending, Completed) in the Activity tab, to view your transaction in the block explorer.
A notification will appear to alert you that the transaction has completed
You will need to click Claim Now to complete the transaction. This Claim Now action is a transaction, and therefore will require gas tokens for the network where the tokens are being claimed.
The connected wallet already holds a balance of TG7T on Arbitrum Sepolia. TG7T can be claimed from the
Game7 Faucet