> ## Documentation Index
> Fetch the complete documentation index at: https://docs.debridge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about deBridge

## General

<Accordion title="What is deBridge?">
  deBridge is cross-chain infrastructure enabling fast, secure asset transfers and messaging across [25+
  blockchains](/dln-details/overview/fees-supported-chains) including EVM chains and Solana.
</Accordion>

<Accordion title="How is deBridge different from other bridges?">
  * **0-TVL architecture**: No liquidity pools to hack
  * **Native tokens**: You receive real assets, not wrapped versions
  * **Fast settlement**: Most trades complete in seconds
</Accordion>

<Accordion title="Which chains are supported?">
  deBridge supports 25+ blockchains including:

  * **Major chains**: Solana, Ethereum, Polygon, Base, Arbitrum, Optimism, Avalanche, BNB Chain
  * **Emerging chains**: Story, Monad, Injective, Sei, Linea

  See [Fees and Supported Chains](/dln-details/overview/fees-supported-chains) for the full list with chain-specific fees.
</Accordion>

<Accordion title="How long do transactions take?">
  Transaction speed depends on the source/destination chains and trade size:

  * **Small amounts**: Solvers typically fulfill immediately after on-chain events are emitted (seconds)
  * **Large amounts**: Solvers may wait for more block confirmations to mitigate chain reorg risk (minutes)

  DLN uses a free market of solvers who assess and price chain reorg risks themselves. Most trades complete in under 2 minutes.
</Accordion>

## Products

<Accordion title="When should I use the Widget vs API?">
  * **Widget**: Fastest integration (30 minutes), pre-built UI
  * **API**: Custom UI, programmatic control, hooks support
</Accordion>

<Accordion title="What's the difference between deBridge Liquidity Network (DLN) and deBridge Messaging Protocol (DMP)?">
  **deBridge Liquidity Network (DLN)**:

  * Cross-chain value/asset transfer
  * API-based integration (Widget, REST API)
  * Lower complexity, optimized for swaps
  * Best for: cross-chain swaps, user onboarding

  **deBridge Messaging Protocol (DMP)**:

  * Arbitrary cross-chain messaging (any data)
  * Smart contract integration required
  * Higher complexity, maximum flexibility
  * Foundation layer—DLN is built on top of DMP
  * Best for: custom protocols, governance, state synchronization

  | Aspect      | DMP                 | DLN                 |
  | ----------- | ------------------- | ------------------- |
  | Purpose     | Arbitrary messaging | Value transfer      |
  | Integration | Smart contract      | API-based           |
  | Complexity  | Higher              | Lower               |
  | Flexibility | Maximum             | Optimized for swaps |

  Learn more: [DLN Overview](/home/products/dln-overview) | [DMP Overview](/home/products/dmp-overview)
</Accordion>

<Accordion title="What are Hooks?">
  Hooks let you execute arbitrary contract calls alongside trades:

  * **PostHooks**: Execute after trades complete (e.g., swap to USDC then deposit into Aave)
</Accordion>

## Integration

<Accordion title="How do I get started?">
  Choose the integration that fits your needs:

  * **[Widget](/dln-details/widget/deBridge-widget)**: Easiest option—pre-built UI, 30-minute setup
    * Use the [Widget Builder](https://app.debridge.com/widget) to customize
  * **[DLN API](/dln-details/integration-guidelines/order-creation/creating-order/quick-start)**: Full programmatic control, custom
    UI
    * No API key required for basic usage
</Accordion>

<Accordion title="What programming languages are supported?">
  deBridge integration is API-based, so any language that can make HTTP requests works:

  * **REST API**: JavaScript, Python, Go, Rust, Java, or any language
  * **Widget**: HTML/JavaScript/React embed
  * **Smart contract integration**: Solidity (EVM chains), Rust (Solana)

  Documentation examples primarily use JavaScript/TypeScript, along with the [example repository](https://github.com/debridge-finance/api-integrator-example).
</Accordion>

<Accordion title="Do I need an API key?">
  No API key required for basic usage of the DLN API. You can start creating orders and tracking them immediately.
</Accordion>

<Accordion title="How do I test my integration?">
  * Use small amounts of real assets for testing on mainnets
  * Track orders via the [tracking API](/dln-details/integration-guidelines/order-creation/order-tracking-api/tracking-orders) to verify behavior
</Accordion>

<Accordion title="Which testnets are supported?">
  deBridge does not support testnets. The protocol relies on extensive on-chain infrastructure across multiple chains, making testnet maintenance impractical.

  For testing, use small amounts of real assets on mainnets. This also provides a more accurate representation of production
  behavior.
</Accordion>

## Fees & Pricing

<Accordion title="How are fees calculated?">
  **DLN** fees include:

  1. **[Flat fee](/dln-details/overview/fees-supported-chains)**: Paid in native gas token (e.g., 0.001 ETH on Ethereum, 0.015 SOL on Solana)
  2. **Variable protocol fee**: 4 bps (0.04%) of input amount
  3. **Taker margin**: \~4 bps (0.04%) solver profit
  4. **Operating expenses**: Gas costs for [fulfillment, unlock, and claim transactions](/dln-details/dln-specifics/order-fulfillment/order-fulfillment)

  **Note**: All fees are fully refunded if an order is cancelled.

  Optional: Integrators can add an [affiliate fee](/dln-details/affiliates/integrators) to monetize their integration.

  See [Fee Structure](/dln-details/overview/fee-structure) for detailed breakdown.
</Accordion>

<Accordion title="Can I monetize my integration?">
  Yes! Integrators can set an affiliate fee and earn on every trade. See [Affiliate Program](/dln-details/affiliates/integrators).
</Accordion>

<Accordion title="Can my orders be cancelled automatically?">
  Yes. Orders can be cancelled automatically if they aren't fulfilled within 5-15 minutes, depending on the cancellation reason.
  See [Auto-Cancellations](/dln-details/affiliates/auto-cancellations) for details.
</Accordion>

## Security

<Accordion title="Is deBridge safe?">
  deBridge is designed with security-first principles:

  * **0-TVL**: No liquidity pools to hack—solvers provide liquidity on-demand
  * **Decentralized model**: deBridge is fully decentralized with no ability to hold or retain user funds. Unfulfilled orders can always be [cancelled](/dln-details/integration-guidelines/order-creation/cancelling-order).
  * **Multi-validator consensus**: For cross-chain messaging
  * **Audited smart contracts**: By leading security firms
  * **Bug bounty program**: Active responsible disclosure program

  See [Security Overview](/home/security/security-overview).
</Accordion>

<Accordion title="What happens if a trade fails?">
  If an order isn't filled, users can cancel and reclaim tokens after expiry.
</Accordion>

<Accordion title="Are my funds at risk while waiting?">
  With DLN, your tokens are deposited in a smart contract for the duration of the order (a few minutes at most), but you can cancel
  and reclaim them if the order isn't fulfilled.

  0-TVL means there are no shared liquidity pools sitting in contracts. Funds pass through per-order like water through pipes - funds are never pooled.
</Accordion>

<Accordion title="What security audits have been completed?">
  deBridge has undergone 25+ security audits by leading firms:

  * **Auditors**: Halborn, Neodyme, Zokyo, Ackee Blockchain
  * **Audit reports**: Available in the [deBridge GitHub repository](https://github.com/debridge-finance/debridge-security)
  * **Bug bounty**: \$200,000 program on [Immunefi](https://immunefi.com/bounty/debridge/)

  See [Security Overview](/home/security/security-overview) for more details.
</Accordion>

## Troubleshooting

<Accordion title="My order is stuck. What do I do?">
  1. Check order status via the [tracking API](/dln-details/integration-guidelines/order-creation/order-tracking-api/tracking-orders)
  2. Wait for solver fulfillment (usually \< 2 minutes)
  3. If unfilled after expiry, [cancel the order](/dln-details/integration-guidelines/order-creation/cancelling-order) to reclaim funds
  4. Contact support on [Discord](https://discord.com/invite/debridge)
</Accordion>

<Accordion title="Why was my transaction rejected? (DLN)">
  Common reasons:

  * Insufficient token balance

  * Approval not granted

  * Exceeded slippage tolerance (market conditions abruptly changed during execution, or the order was not submitted promptly -
    within 30 seconds of receiving the response from deBridge API)
</Accordion>

<Accordion title="Where can I get help?">
  * [Discord](https://discord.com/invite/debridge) - Community and team support

  * [GitHub](https://github.com/debridge-finance/) - Technical issues

  * [Integration guides](/home/guides/guides) - Docs and examples
</Accordion>

## Technical

<Accordion title="How does the 0-TVL model work?">
  Instead of liquidity pools, solvers provide liquidity on-demand:

  1. User creates order (deposits tokens in smart contract)
  2. Solver sends tokens directly to user on destination
  3. Solver claims locked tokens on source

  No shared pool = no honeypot to attack.
</Accordion>

<Accordion title="How are order IDs generated?">
  [Order IDs](/dln-details/protocol-specs/deterministic-order-id) are deterministically computed from order parameters (amounts, addresses, chains). This ensures:

  * Unique ID per order
  * Tamper-proof (changing params = different ID)
  * Reproducible (can verify ID from params)
</Accordion>