Bridging G7

The canonical fungible token bridge for the G7 Network and more

What is the Game7 Bridge

The Game7 Bridge enables fungible token transfers between Layer 1 and Layer 2 blockchains (such as Ethereum and Arbitrum) and the G7 Network (a Layer 3 network).

Game7 Canonical Bridge (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 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 here.

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 integrates Relay, 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 Canonical Bridge

  • 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 Canonical Bridge delivers another feature with the inclusion of a messaging protocol 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 here.

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.

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

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.

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

As we will be referencing testnet, Arbitrum Sepolia and G7 Sepolia are shown as network options

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).

The connected wallet already holds a balance of TG7T on Arbitrum Sepolia. TG7T can be claimed from the Game7 Faucet

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

Once an amount has been defined, the Transaction Summary will update and the Submit button will become active

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.

Approve the bridge to access the tokens and the amount you want to bridge. You can set a custom amount.

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.

You can click the Transaction status icon (e.g Pending, Completed) in the Activity tab, to view your transaction in the block explorer.

  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.

A notification will appear to alert you that the transaction has completed

  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.

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.

Roll-Up Challenge Periods

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

The challenge period is one hour for G7 Network withdrawals when utilizing the Game7 Bridge.

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

LogoGame7 - World builder
PreviousG7 Token and FaucetNextUsing G7 Network Explorer

Last updated