Agglayer Native Bridge

Overview

Agglayer Native Bridge is the SDK's Native module that provides direct interaction with Agglayer bridge contracts and blockchain networks. Unlike Multi-Bridge Routes which uses ARC API for route aggregation, Native Bridge gives you complete control over bridge operations, ERC20 token management, and chain configurations across local, testnet, and mainnet environments.

Core Features

Complete Guides

When to Use Native Bridge

Choose Native Bridge when you need direct control over bridge operations, local testing capabilities with AggSandbox, or custom bridge logic beyond standard route aggregation. It's ideal for advanced integrations with custom business logic and testnet development workflows.

Consider Multi-Bridge Routes for route optimization across multiple providers and cross-chain bridging from non-Agglayer chains.

Quick Example

Here's how simple it is to perform direct bridge operations with Native Bridge:

import { AggLayerSDK, SDK_MODES } from '@agglayer/sdk';

// Initialize for local testing
const sdk = new AggLayerSDK({
  mode: [SDK_MODES.NATIVE],
  native: {
    defaultNetwork: 1,
    customRpcUrls: {
      1: 'http://localhost:8545',     // AggSandbox L1
      1101: 'http://localhost:8546',  // AggSandbox L2
    },
  },
});

const native = sdk.getNative();

// Create token instance and bridge directly
const token = native.erc20('0xTokenAddress', 1);
const bridgeTx = await token.bridgeTo(
  1101, // Destination network
  '0xRecipientAddress',
  '1000000000000000000', // 1 token
  '0xFromAddress'
);

// Transaction ready for signing and execution
console.log('Bridge transaction built:', bridgeTx.to);