Skip to main content
Cross-Chain Infrastructure

deBridge Protocol V1

A decentralized cross-chain interoperability and liquidity transfer protocol enabling secure asset and data transfers between any blockchain networks.

Get StartedView Architecture
57+
GitHub Stars
Multi-Chain
Support
100%
Decentralized
DeBridgeGate.sol

Quick Start

Get up and running with deBridge Protocol in minutes

1

Understand the Architecture

Learn how deBridge Protocol works with its lock-and-mint mechanism, oracle network, and cross-chain messaging system.

Read Architecture Overview

Explore the core components and design principles
2

Deploy or Connect to Contracts

Deploy the smart contracts to your target networks or connect to existing deBridge deployments.
Setup Environment
# Clone the repository
git clone https://github.com/debridge-finance/debridge-contracts-v1.git
cd debridge-contracts-v1

# Install dependencies
yarn install

# Compile contracts
yarn compile
Make sure you have Node.js 16+ and Hardhat installed before proceeding.
3

Send Your First Cross-Chain Transfer

Use the DeBridgeGate contract to send assets or messages between chains.
Send Assets
// Send ETH to another chain
deBridgeGate.send{value: amount + protocolFee}(
  address(0), // native token
  amount,
  targetChainId,
  receiverAddressBytes,
  permitData,
  useAssetFee,
  referralCode,
  autoParams
);
After a successful send, you’ll receive a Sent event with a unique submissionId that can be used to track the transfer through the deBridge explorer.

Core Features

Everything you need for cross-chain interoperability

Asset Transfers

Lock-and-mint mechanism for secure cross-chain asset transfers with 1:1 collateral backing

Cross-Chain Messaging

Send arbitrary data and execute smart contract calls across different blockchain networks

Decentralized Oracles

Independent validator network with delegated staking and slashing mechanics for security

Flexible Fee Structure

Configurable fees with discount support and multiple payment options including native tokens

Explore Smart Contracts

Comprehensive reference for all deBridge contracts

DeBridgeGate

Main contract for asset transfers and cross-chain operations

CallProxy

Execute cross-chain smart contract calls with custom parameters

OraclesManager

Manage the decentralized oracle network and validator set

SignatureVerifier

Verify oracle signatures for cross-chain transaction validation

DeBridgeToken

ERC-20 wrapped tokens representing assets on secondary chains

Libraries

Utility libraries for flags, signatures, and helper functions

Integration Examples

Learn by example with real-world integration patterns

Incrementor Contract

Cross-chain state synchronization using BridgeAppBase pattern

View example

Sending Native Tokens

Transfer ETH and other native tokens across chains

View example

Sending ERC-20 Tokens

Bridge any ERC-20 token with permit support

View example

Cross-Chain Swaps

Swap tokens across chains with automatic execution

View example

Developer Resources

Tools and guides for building on deBridge

Development Setup

Configure your local environment for contract development and testing

Testing Guide

Run comprehensive test suites and write your own integration tests

Deployment

Deploy contracts to testnet and mainnet with Hardhat scripts

Contract Verification

Verify deployed contracts on block explorers for transparency

Join the deBridge Community

Connect with developers, ask questions, and stay updated on the latest protocol developments

Join DiscordFollow on Twitter