Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lidian.finance/llms.txt

Use this file to discover all available pages before exploring further.

Frequently asked questions about Lidian’s stablecoin swap protocol.

​
General Questions

Lidian is a universal, trust-minimized intent settlement protocol designed to make money move better. It connects money movers and liquidity providers from any chain to any chain, facilitating peer-to-peer exchange from any stablecoin to any stablecoin.
Lidian uses an intent-based system where users express what they want to accomplish (e.g., “swap 1000 USDC for USDT on Base”), liquidity providers compete to offer the best rates, and the protocol executes the swap securely. The protocol uses LayerZero for final settlement between chains.
Yes, Lidian is an onchain protocol. While we provide APIs and infrastructure, the core smart contracts are deployed onchain. Users maintain custody of their funds throughout the order process.
Yes, Lidian is an onchain protocol focused on compliant money movement. This differs from public and decentralized protocols like Relay, Across, and Stargate. We believe there is a place for those types of protocols, however, for businesses, enterprises, and institutions to come onchain and use money they need to follow rules that those protocols are not built for while Lidian is.

​
Technical Questions

Lidian is currently on testnet and supports a few chains. See the deployments page for more.
Lidian is focused on stablecoins. See the deployments page for more.
Cross-chain swaps use a trustless intent system with LayerZero for final settlement.
LayerZero Endpoint IDs (EIDs) are unique identifiers for each supported blockchain network. They’re used to route cross-chain messages securely. For example, Base has EID 30110 and Polygon has EID 30109. Final settlement transactions via LayerZero can be found on LayerZero Scan.
To get started, you’ll need to:
  1. Visit the Lidian Portal to create an account
  2. Complete the KYC/KYB verification
  3. Generate API keys for your environment
  4. Install the SDK or use our REST API
  5. Make your first quote request or offer

​
Security Questions

Yes, Lidian prioritizes security through multiple layers:
  • Smart contracts are professionally audited
  • Cross-chain operations are use LayerZero’s battle-tested infrastructure
  • Users maintain custody of their funds
  • EIP712 signatures provide cryptographic authorization
If a cross-chain swap fails, the entire operation reverts atomically. This means your input tokens are automatically returned to you on the source chain, and no partial state is possible. The protocol ensures either the complete swap succeeds or nothing happens.
Yes, your funds are safe throughout the swap process. For single-chain swaps, tokens are transferred atomically in a single transaction. For cross-chain swaps, your input tokens are locked on the source chain and only released when the output tokens are confirmed on the destination chain.
Cancellation is only possible in emergency cases on the destination chain due to race conditions.

​
Fees and Costs

Lidian charges two types of fees:
  • Protocol Fee: A small fee to the protocol (in basis points)
  • LP Fee: A fee to liquidity providers (in basis points)
All fees are transparent and disclosed upfront in quotes. Gas costs for blockchain transactions are separate and paid directly to the network.
Fees are calculated as a percentage of the input amount and are paid in the input token. The exact fee structure depends on the specific quote you receive from liquidity providers, who compete to offer the best rates.
No, Lidian is transparent about all costs. All fees are disclosed upfront in quotes, and you can see the exact amount you’ll receive before confirming any swap. The only additional cost is the gas fee for blockchain transactions, which is standard for all onchain operations.
Yes, you need to hold the native token (ETH on Base, MATIC on Polygon) to pay for gas fees. However, you may choose to execute via account abstraction solutions if you prefer which may offer an alternative option.

​
Troubleshooting

Common reasons for quote request failures include:
  • Invalid token addresses
  • Unsupported chain combinations
  • Invalid balance on an account
  • Invalid API key
  • Rate limit exceeded
Check the error response for specific details about what went wrong.
Swap failures can occur due to:
  • Order expiration
  • Insufficient balance
  • Invalid signature
  • Network congestion
Check the swap status and error details for more information.
Quotes typically remain valid for 30 seconds to 5 minutes, depending on market conditions. The exact validity period is included in the quote response. Always check the validUntil timestamp before using a quote.
If your transaction is stuck, it’s likely due to network congestion or low gas prices. You can:
  • Wait for the transaction to be processed
  • Check the transaction status on the blockchain explorer
  • Contact support if the transaction remains stuck for an extended period

​
Support

You can get help through several channels: