deBridge
  • Introduction
  • The deBridge Messaging Protocol
    • Protocol Overview
    • Fees and Supported Chains
    • 🟢Deployed Contracts
    • Development Guides
      • Building an EVM-based dApp
        • EVM smart contract interfaces
          • Interfaces
            • ICallProxy
            • IDeBridgeGate
            • IDeBridgeToken
            • IDeBridgeTokenDeployer
            • IOraclesManager
            • ISignatureVerifier
            • IWethGate
          • Libraries
            • Flags
          • Periphery
            • CallProxy
            • DeBridgeToken
            • DeBridgeTokenProxy
            • SimpleFeeProxy
          • Transfers
            • DeBridgeGate
            • DeBridgeTokenDeployer
            • OraclesManager
            • SignatureVerifier
            • WethGate
      • Sending cross-chain messages from Solana
        • On-Chain external call preparation for Solana
        • Off-chain external call preparation for Solana
      • Lifecycle of a cross-chain call
      • Gathering data for the claim
    • Development Tools
    • Security
    • Slashing and Delegated Staking
  • 🔁DLN: The deBridge Liquidity Network Protocol
    • Introduction
    • Protocol Overview
    • deBridge Hooks
    • Fees and Supported Chains
    • 🟢Deployed Contracts
    • Market and Limit Orders
    • Integration Guidelines
      • Interacting with the API
        • Authentication
        • Creating an Order
          • Quick Start
          • Reserve Assets
          • Bridging Reserve Assets
          • Bridging non-reserve assets
          • API Parameters
            • Estimation-Only
            • prependOperatingExpenses
          • API Response
            • JSON Example
          • Refreshing Estimates
          • Fees and operating expenses
          • Order Fulfillment
            • Detecting the Order
            • Fulfilling the Order
              • Pre-Fill-Swap
            • Claiming the Order
        • Tracking Order Status
          • Order States
        • Integrating deBridge hooks
          • Creating Hook data for Solana
        • Submitting an Order Creation Transaction
        • Cancelling the Order
        • Affiliate fees
      • deBridge Widget
      • Interacting with smart contracts
        • Placing orders
        • Filling orders
        • Withdrawing Affiliate Fees
    • Interacting with the deBridge App
      • Custom Linking
    • Protocol specs
      • Deterministic order ID
      • Hook data
        • Anatomy of a Hook for the EVM-based chains
        • Anatomy of a Hook for Solana
  • 💸dePort
    • Getting started
    • Transfers Flow
  • ⚡deBridge Points
    • Referrers Overview
    • Integrators Overview
  • 🌐deBridge IaaS
    • Getting started
  • 🌐Legal
    • SDK & API License Agreement
  • External Links
    • deBridge Use Cases
      • 💡Examples
    • Talks, Videos, and Articles
    • Website
    • Github
    • Twitter
    • Social channels
      • Discord
      • Facebook
      • LinkedIn
      • Medium
      • Telegram
      • YouTube
Powered by GitBook
On this page

Was this helpful?

  1. DLN: The deBridge Liquidity Network Protocol
  2. Integration Guidelines
  3. Interacting with the API
  4. Creating an Order

Bridging non-reserve assets

Bridging of non-reserve assets, and steps to take. Pre-Order-Swap explained.

PreviousBridging Reserve AssetsNextAPI Parameters

Last updated 4 days ago

Was this helpful?

The (DLN) protocol supports bridging any liquid token from the source chain to the destination chain, not just . While the actions taken by the system are similar to those used when , the internal flow differs and introduces considerations that must be communicated clearly for a seamless end-user experience.

Cross-chain settlements are executed in to simplify operations for solvers. As a result, whenever a non-reserve asset is bridged, it must first be swapped into a reserve asset before the order is created—a process referred to as the Pre-Order-Swap.

The create-tx API automatically handles this swap step. It queries DeFi aggregators in the background to simulate the swap and produce response.tx.calldata (see step 1a in the diagram). The API is optimized to select the best available rate.

Once a user signs and submits response.tx, the DLN smart contracts initiate the process by transferring the approved non-reserve assets to themselves (step 3a). The actual Pre-Order-Swap is executed via an Automated Market Maker (AMM) (step 3b). Given the potential for price slippage, the destination chain estimate is based on the minimum amount a user would receive from the swap.

This design—basing estimates on the minimum outcome of the Pre-Order-Swap—helps shield users from market volatility and reduces the likelihood of orders being ignored due to insufficient profitability from a solver's perspective.

If integrators prefer to manage the swap path manually, they can perform the conversion to themselves before calling the create-tx endpoint—ensuring complete control over the swap route.

Once the swap completes, the are locked within the protocol until the order is either or .

If the order is , the locked are returned to the user. It is important to note that the user will receive reserve assets back—not the original non-reserve assets used at the start of the process.

🔁
reserve assets
reserve assets
fulfilled
cancelled
cancelled
reserve assets
DeBridge Liquidity Network
reserve assets
bridging reserve assets
reserve assets
Bridging non-reserve assets