This guide walks through the steps required to integrate Hyperbridge for cross-chain asset transfers

Rust version used for this integration is 1.89.0
Polkadot SDK version used for this integration is tag: polkadot-stable2503-7

The first step is to integrate the pallets in your runtime.
Click here to follow the pallets integration guide

Once this is done, verify that the pallets are successfully integrated.
Click here to use the polkadot explorer

Next is to run the consensus relayer that validates state proofs.
Click here to run the consensus relayer

Next is to run the messaging relayer that is responsible for cross chain transfers of messages and tokens.
Click here to run the messaging relayer

• Follow: Setting up consensus relayer
• Share the consensus state with the Hyperbridge team
• It must be whitelisted before starting the relayer

⚠️ Note: Kusama / Polkadot consensus states must also be whitelisted on your chain

• Follow: Setting up messaging relayer

• Pallet: tokenGateway
• Extrinsic: createErc6160Asset

• Use Hyper Fungible Token Contract
• Choose any:
  • Token name
  • Token symbol
• Share the contract address with the Hyperbridge team

• Pallet: tokenGateway
• Extrinsic: setTokenGatewayAddresses

Sepolia Token Gateway: 0xFcDa26cA021d5535C3059547390E6cCd8De7acA6

Grant the following roles to the Token Gateway:

• MINTER_ROLE
• BURNER_ROLE

Approve:

• Token Gateway contract
• Fee Token contract

You need USD.h tokens for transaction fees.

Get from: Testnet Fee Token Faucet

• Pallet: tokenGateway
• Extrinsic: teleport

• Use teleport function from Token Gateway (EVM)
• Create a script with correct parameters

• Check explorer logs for successful asset import

• ERC6160 token created on Substrate
• Token deployed on Sepolia (same name & symbol)
• MINTER_ROLE granted
• BURNER_ROLE granted
• Token Gateway approved
• Fee token approved

• Asset 0 is treated as the native token by Hyperbridge
• Transfers from Sepolia updated native token balance

• pallet-assets must:
  • Create the asset
  • Mint tokens

Required for Token Gateway to recognize assets for teleport

• Ensure relayers are running
• Ensure sufficient fees
• Ensure roles are properly assigned

Request Flow