Skip to content
Integral Help Center home
Integral Help Center home

Bridging and Cross-Chain Transactions

Overview

Integral automatically detects and captures bridging transactions across multiple blockchain networks, providing seamless tracking of your cross-chain asset movements. Our system recognizes when you move assets between different blockchains and automatically categorizes these transactions as bridge transfers, eliminating the need for manual classification.

How It Works

When a bridging transaction occurs, Integral will:

1. Automatically Detect Bridge Activity: Recognizes transactions involving known bridge protocols and contracts

2. Link Related Transactions: Connect the Bridge Out transaction on the source chain with the Bridge In transaction on the destination chain

image.png

3. Categorizes Transactions: Labels transactions as "Bridge Out" (sending) and "Bridge In" (receiving)

4. Enriches Transaction Data: Adds bridging metadata including source/destination chains, addresses, and amounts

Supported Blockchain Networks

Integral supports bridging detection across 30+ blockchain networks, including:

Arbitrum One

Ethereum

Optimism

Base

Polygon

Avalanche

Fantom

Blast

Zora

Linea

zkSync Era

Binance Smart Chain (BSC)

Starknet

Solana

Cosmos

Osmosis

dYdX

Supported Bridge Protocols

Integral automatically recognizes transactions from major bridging protocols and their contract addresses:

Orbiter Finance - Cross-Rollup Bridge Aggregator

Supported Contract Addresses:

- 0x80c67432656d59144ceff962e8faf8926599bcf8 - Primary Bridge Contract

- 0xe4edb277e41dc89ab076a1f049f4a3efa700bce8 - Secondary Bridge Contract

- 0x3bDB03ad7363152DFBc185Ee23eBC93F0CF93fd1 - Bridge Contract #3

- 0xacc517ea627ceb71cf25e002adaa9761623837b9 - Bridge Contract #4

- 0x9c6750d463ad17deec97a630af766f0a78f95127 - Bridge Contract #5

OP Stack Bridges - Ethereum Layer 1 Portals

Official bridges for Optimism ecosystem chains, connecting Layer 2 networks to Ethereum mainnet.

Supported Contract Addresses:

- 0x49048044d57e1c92a77f79988d21fa8faf74e97e - Base Portal (Coinbase Layer 2)

- 0x3a05E5d33d7Ab3864D53aaEc93c8301C1Fa49115 - Blast Portal (Blast Layer 2)

- 0xbeb5fc579115071764c7423a4f12edde41f106ed - Optimism Portal (Optimism Layer 2)

- 0x0bd48f6b86a26d3a217d0fa6ffe2b491b956a7a2 - Unichain Portal (Uniswap Layer 2)

- 0x1a0ad011913a150f69f6a19df447a0cfd9551054 - Zora Portal (Zora Layer 2)

Arbitrum Ecosystem Bridges

Official bridges for Arbitrum Layer 2 networks, providing secure asset transfers to and from Ethereum.

Supported Contract Addresses:

- 0x8315177ab297ba92a06054ce80a67ed4dbd7ed3a - Arbitrum One Bridge (Primary)

- 0x2f06e43d850ac75926fa2866e40139475b58cb16 - Arbitrum One Bridge (Secondary)

- 0x9a28e783c47bbeb813f32b861a431d0776681e95 - Arbitrum One Bridge (Third)

- 0xc1ebd02f738644983b6c4b2d440b8e77dde276bd - Arbitrum Nova Bridge

Gnosis Chain Bridges

Bridges connecting Ethereum mainnet with Gnosis Chain (formerly xDai Chain).

Supported Contract Addresses:

- 0x88ad09518695c6c3712ac10a214be5109a655671 - Ethereum OmniBridge (Multi-token bridge)

- 0x4aa42145aa6ebf72e164c9bbc74fbd3788045016 - Ethereum xDai Bridge (Native token bridge)

- 0xf6a78083ca3e2a662d6dd1703c939c8ace2e268d - Gnosis OmniBridge (Gnosis side)

Starknet Bridge

Official bridge for transferring assets between Ethereum and Starknet Layer 2.

Supported Contract Addresses:

- 0xc662c410C0ECf747543f5bA90660f6ABeBD9C8c4 - Starknet L1 Core Contract

Additional Supported Protocols

Integral also supports detection for these major bridging protocols (contract addresses vary by network):

- Wormhole - Multi-chain bridge supporting 20+ networks

- Multichain (formerly Anyswap) - Cross-chain router protocol

- Celer Network - Layer 2 scaling and cross-chain solutions

- Stargate - Omnichain liquidity transport protocol

- Allbridge - Modular token bridge

- Hop Protocol - Rollup-to-rollup token bridge

- Polygon Bridge - Official Ethereum-Polygon bridge

- zkSync Bridge - Native bridge for zkSync Era

- Wrapped Bitcoin (WBTC) - Bitcoin representation on Ethereum

- Across Protocol - Optimistic bridge for Layer 2s

- Synapse Protocol - Cross-chain AMM and bridge

Transaction Types Automatically Detected

Bridge Out Transactions

- Asset transfers leaving your wallet to a bridge contract

- Automatically tagged with source chain information

- Includes bridge fees and gas costs

- Links to corresponding Bridge In transaction

Bridge In Transactions

- Asset receipts from bridge contracts to your wallet

- Tagged with destination chain information

- Shows any slippage or conversion differences

- Maintains connection to originating Bridge Out transaction

Bridge Fees

- Separate categorization of bridge protocol fees

- Gas fees on both source and destination chains

- Any additional service fees charged by bridge operators

Frequently Asked Questions

Q: Do I need to manually mark bridge transactions?

A: No, Integral automatically detects and categorizes bridge transactions from supported protocols and networks

Q: What if I use a bridge protocol not listed here?

A: Integral continuously adds support for new protocols. Contact help@integral.xyz if you need a specific bridge added.

Q: How quickly are bridge transactions detected?

A: Bridge transactions are typically detected within minutes upon being synced to Integral.

Q: Can I see the connection between my Bridge Out and Bridge In transactions?

A: Yes, Integral automatically links related transactions and displays them together in your transaction history in BKV2.

Q: Are bridge fees properly categorized?

A: Yes, all bridge-related fees including protocol fees and gas costs are automatically identified and categorized.

Support

For questions about bridging support or to request additional protocol integrations, please contact our support team at help@integral.xyz. We continuously expand our bridge protocol coverage based on user needs and market developments.