Overview The AllBridgeFacet enables cross-chain token transfers using Allbridge, a cross-chain bridge supporting multiple blockchains including EVM and non-EVM chains.
Contract Interface Functions startBridgeTokensViaAllBridge Bridges tokens to another chain using Allbridge.
function startBridgeTokensViaAllBridge ( BridgeData _bridgeData , AllBridgeData _allBridgeData ) external payable
Standard bridge data containing transaction details
Allbridge-specific bridging parameters Show AllBridgeData fields
Recipient address (supports non-EVM chains)
Token to receive on destination
Unique nonce for the transfer
Messenger protocol to use
Whether to pay fees with sending asset
swapAndStartBridgeTokensViaAllBridge Performs a token swap on the source chain before bridging via Allbridge.
function swapAndStartBridgeTokensViaAllBridge ( BridgeData _bridgeData , SwapData [] _swapData , AllBridgeData _allBridgeData ) external payable
Array of swap operations to execute before bridging
Allbridge-specific parameters
Data Structures AllBridgeData struct AllBridgeData { bytes32 recipient ; // Recipient address (supports non-EVM) uint256 fees ; // Bridge fees bytes32 receiveToken ; // Token to receive uint256 nonce ; // Unique nonce uint8 messenger ; // Messenger protocol bool payFeeWithSendingAsset ; // Pay fees with sending token }
Usage Example import { AllBridgeFacet } from '@lifi/contract-types' ; const allBridgeFacet = AllBridgeFacet__factory . connect ( facetAddress , signer ); const bridgeData = { transactionId: '0x...' , bridge: 'allbridge' , integrator: 'my-dapp' , referrer: '0x0000000000000000000000000000000000000000' , sendingAssetId: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' , // USDC receiver: '0x...' , minAmount: ethers . utils . parseUnits ( '100' , 6 ), destinationChainId: 43114 , // Avalanche hasSourceSwaps: false , hasDestinationCall: false }; const allBridgeData = { recipient: ethers . utils . hexZeroPad ( bridgeData . receiver , 32 ), fees: ethers . utils . parseEther ( '0.01' ), receiveToken: ethers . utils . hexZeroPad ( '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E' , // USDC on Avalanche 32 ), nonce: Date . now (), messenger: 1 , // Primary messenger payFeeWithSendingAsset: false }; const tx = await allBridgeFacet . startBridgeTokensViaAllBridge ( bridgeData , allBridgeData , { value: allBridgeData . fees } ); await tx . wait ();
Bridging to Non-EVM Chains Allbridge supports bridging to non-EVM chains like Solana:
const allBridgeData = { // Solana address as bytes32 recipient: ethers . utils . arrayify ( bs58 . decode ( '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU' ) ), fees: ethers . utils . parseEther ( '0.01' ), receiveToken: ethers . utils . hexZeroPad ( '0xTokenAddressOnSolana' , 32 ), nonce: Date . now (), messenger: 1 , payFeeWithSendingAsset: false };
Events
LiFiTransferStarted(BridgeData bridgeData)BridgeToNonEVMChain(bytes32 transactionId, uint256 destinationChainId, bytes receiver) - For non-EVM transfersAssetSwapped (when using swapAndStart variant)
Notes
Allbridge supports both EVM and non-EVM chains
The recipient field uses bytes32 to support various address formats
Fees can be paid either in native tokens or the sending asset
Different messenger protocols may have different costs and speeds
See Also