# Layerswap Developer Portal - [Layerswap Developer Docs](https://docs.layerswap.io/home.md): Build cross-chain bridging and swapping into your product with Layerswap. - [What is Layerswap?](https://docs.layerswap.io/get-started/what-is-layerswap.md): Layerswap is infrastructure for moving assets across supported blockchains and exchanges. - [Choose your integration](https://docs.layerswap.io/get-started/choose-your-integration.md): Choose the Widget, Hosted Page, or API based on how much of the experience your product needs to control. - [API keys & environments](https://docs.layerswap.io/get-started/api-keys.md): Create a Layerswap API key, select an environment, and authenticate API and Widget requests. - [Supported Networks & Tokens](https://docs.layerswap.io/get-started/networks-and-tokens.md): Browse live Layerswap route coverage and query supported networks and tokens programmatically. - [Swap lifecycle](https://docs.layerswap.io/concepts/swap-lifecycle.md): Understand the statuses a swap goes through from creation to completion or refund, and how to handle each one. - [Refunds](https://docs.layerswap.io/concepts/refunds.md): Learn when and how Layerswap refunds a swap, what the refund address is for, what amount is returned, and how to identify the refund transaction. - [Routes, quotes & limits](https://docs.layerswap.io/concepts/routes-quotes-limits.md): How routes, quotes, and limits determine what you can move and what you'll receive. - [Funding methods](https://docs.layerswap.io/concepts/funding-methods.md): Compare Layerswap funding methods and choose the right one for your integration. - [Fees](https://docs.layerswap.io/concepts/fees.md): Understand how Layerswap fees are structured, how they are calculated, and how to retrieve fee data from API quotes. - [Security](https://docs.layerswap.io/concepts/security.md): Review the verified security properties of the Layerswap Depository and Widget delivery model. - [Glossary](https://docs.layerswap.io/concepts/glossary.md): Canonical Layerswap integration terms and their corresponding API or Widget names. - [Swap Widget Quickstart](https://docs.layerswap.io/widget/quickstart.md): Add the Swap Widget to your React app with @layerswap/widget-react — one package, no CSS imports, no bundler config. - [Deposit Widget](https://docs.layerswap.io/widget/deposit-widget.md): A drop-in component that lets your users fund a fixed address — from a connected wallet or from any wallet or exchange via a deposit address. - [Configuration](https://docs.layerswap.io/widget/configuration.md): Configure the Swap Widget with its config object, callbacks, wallet options, and loader-level props. - [Initial values & flows](https://docs.layerswap.io/widget/initial-values.md): Prefill, lock, or hide Widget fields and select the Swap, CEX, or Deposit flow. - [Wallets](https://docs.layerswap.io/widget/wallets.md): How wallet support works in the widget — filtering chains and supplying credentials. - [Sharing your wagmi config](https://docs.layerswap.io/widget/wagmi-config.md): Let the Widget reuse your app's EVM wallet connection and chain configuration. - [Theming](https://docs.layerswap.io/widget/theming.md): Apply brand colors and layout settings to the Swap Widget and Deposit Widget. - [Theme reference](https://docs.layerswap.io/widget/theme-reference.md): Reference every Widget theme field, border-radius scale, and CSS custom property. - [Events overview](https://docs.layerswap.io/widget/events/overview.md): Subscribe to widget events and receive swap status updates via the callbacks prop - [onFormChange](https://docs.layerswap.io/widget/events/on-form-change.md): Triggered whenever the swap form values change. - [onSwapCreate](https://docs.layerswap.io/widget/events/on-swap-create.md): Triggered when a new swap is created. - [onSwapComplete](https://docs.layerswap.io/widget/events/on-swap-complete.md): Triggered when a swap completes. - [onSwapStatusChange](https://docs.layerswap.io/widget/events/on-swap-status-change.md): Triggered whenever a swap's status changes. - [onSwapModalStateChange](https://docs.layerswap.io/widget/events/on-swap-modal-state-change.md): Triggered when the swap modal opens or closes. - [onBackClick](https://docs.layerswap.io/widget/events/on-back-click.md): Triggered when the user clicks the back button. - [onMenuNavigationChange](https://docs.layerswap.io/widget/events/on-menu-navigation-change.md): Triggered when the user navigates inside the widget menu. - [onError](https://docs.layerswap.io/widget/events/on-error.md): Triggered when a runtime error occurs inside the widget. - [Compatibility](https://docs.layerswap.io/widget/compatibility.md): Framework requirements for @layerswap/widget-react — which are deliberately minimal. - [Widget delivery and security](https://docs.layerswap.io/widget/delivery-and-security.md): How the Widget loader fetches, verifies, and runs the CDN-delivered Widget. - [Troubleshooting](https://docs.layerswap.io/widget/troubleshooting.md): Diagnose a blank or stuck Swap Widget or Deposit Widget: read the error, check your CSP, recover. - [JavaScript package](https://docs.layerswap.io/widget/vanilla-js.md): Embed the widget from Vue, Angular, Svelte, or plain DOM with @layerswap/widget-js. - [Playground](https://docs.layerswap.io/widget/playground.md): Preview Swap Widget configuration and theming against the current React integration. - [Self-bundled Widget](https://docs.layerswap.io/widget/advanced/self-bundled.md): For teams that need complete control over the Widget bundle and its dependencies. - [Migrating to @layerswap/widget-react](https://docs.layerswap.io/widget/advanced/migrate-to-widget-react.md): Move from the self-bundled @layerswap/widget to the CDN-delivered @layerswap/widget-react. - [Wallet management](https://docs.layerswap.io/widget/advanced/wallet-management.md): Understand and configure wallet providers in the self-bundled Widget. - [Native wallet packages](https://docs.layerswap.io/widget/advanced/native-wallet-packages.md): Self-bundled Widget wallet packages by chain family. - [Custom wallet management](https://docs.layerswap.io/widget/advanced/custom-wallet-management.md): Connect a third-party wallet SDK to the self-bundled Widget through the current external-store contract. - [Wallet providers](https://docs.layerswap.io/widget/advanced/wallet-providers.md): Configure self-bundled Widget provider factories by chain family. - [Build troubleshooting](https://docs.layerswap.io/widget/advanced/build-troubleshooting.md): Fix Vite and Next.js build issues in the self-bundled Widget. - [Hosted Page setup](https://docs.layerswap.io/hosted-page/setup.md): Link, redirect, or embed the Layerswap application with a prefilled route and flow. - [Track completion](https://docs.layerswap.io/hosted-page/track-completion.md): Correlate a Hosted Page session with a Layerswap swap and confirm its final status. - [API overview](https://docs.layerswap.io/api/overview.md): What the Layerswap v2 API does and which endpoint to use for each integration task. - [API quickstart](https://docs.layerswap.io/api/quickstart.md): Move ETH from Ethereum to Arbitrum through the API in four calls: quote, create, deposit, track. - [Execute deposit actions](https://docs.layerswap.io/api/funding/transfer.md): Fund a swap by completing its deposit actions — submit the source-network transfer, or share the deposit address and amount with the sender. - [EVM chains](https://docs.layerswap.io/api/funding/networks/evm.md): Submit native-token and ERC-20 deposit actions on EVM-compatible source networks. - [Bitcoin](https://docs.layerswap.io/api/funding/networks/bitcoin.md): Build a Bitcoin deposit transaction with the exact payment amount and Layerswap OP_RETURN memo. - [Solana](https://docs.layerswap.io/api/funding/networks/solana.md): Decode, refresh, sign, and submit the serialized Solana transaction returned in call_data. - [Starknet](https://docs.layerswap.io/api/funding/networks/starknet.md): Execute the Starknet multicall returned in a deposit action. - [TON](https://docs.layerswap.io/api/funding/networks/ton.md): Build native TON and Jetton deposit messages from the returned action. - [Tron](https://docs.layerswap.io/api/funding/networks/tron.md): Build and submit memo-bearing TRC-20 deposit transactions on Tron. - [Fuel](https://docs.layerswap.io/api/funding/networks/fuel.md): Reconstruct, fund, and submit the Fuel script transaction returned in call_data. - [Fund via the Depository contract](https://docs.layerswap.io/api/funding/depository.md): Create and fund a swap through the Depository using the contract call returned by the API. - [Gasless deposits](https://docs.layerswap.io/api/funding/gasless.md): Fund a supported swap by signing EIP-712 typed data for a relayed deposit. - [Track swaps](https://docs.layerswap.io/api/track-swaps.md): Poll swap status, list by status filter, look up a funding transaction, or receive webhooks. - [Webhooks](https://docs.layerswap.io/api/webhooks.md): Configure a Partner Dashboard webhook and verify Svix-signed deliveries. - [Errors](https://docs.layerswap.io/api/errors.md): Handle Layerswap API JSON errors, empty-body validation responses, and per-step failures. - [Privy server wallets](https://docs.layerswap.io/api/recipes/privy-wallets.md): Fund a Layerswap swap from a Privy server wallet with a sponsored Depository call. - [Health Check](https://docs.layerswap.io/api-reference/health/health-check.md): Verifies that the API is running and operational. - [Get Networks](https://docs.layerswap.io/api-reference/swaps/get-networks.md): Retrieves a list of available networks with their tokens. - [Get Sources](https://docs.layerswap.io/api-reference/swaps/get-sources.md): Retrieves all available source routes. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token addresses (e.g. 0xa0b8...). For native tokens via address, use 0x00000000… - [Get Destinations](https://docs.layerswap.io/api-reference/swaps/get-destinations.md): Retrieves all available destination routes. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token addresses (e.g. 0xa0b8...). For native tokens via address, use 0x000… - [Get Connections](https://docs.layerswap.io/api-reference/swaps/get-connections.md): Retrieves active token connections for one source/destination network corridor. Each token contains its symbol and network-specific address; address is null when the token has neither a contract nor a canonical native-token identifier. Each connection is the Cartesian product of its source_tokens an… - [Get Swap Route Limits](https://docs.layerswap.io/api-reference/swaps/get-swap-route-limits.md): Retrieves the limits for swap route. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token addresses (e.g. 0xa0b8...). For native tokens via address, use 0x0000000000… - [Post Swap Route Limits](https://docs.layerswap.io/api-reference/swaps/post-swap-route-limits.md): Calculates limits from JSON, including optional integrator_fee_splits. Nonnegative integer shares must total at most 2000 bps; zero-bps entries are ignored. Active recipients must be nonzero Base EVM addresses. Optional fee_sponsorship_percentage (0–100) sponsors that percentage of fees; integrator… - [Get Quote](https://docs.layerswap.io/api-reference/swaps/get-quote.md): Retrieves a swap quote based on the provided route request. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token addresses (e.g. 0xa0b8...). For native tokens via ad… - [Post Quote](https://docs.layerswap.io/api-reference/swaps/post-quote.md): Quotes a swap from JSON. Optional integrator_fee_splits add an undiscounted fee on the accepted input, capped at 2000 bps in total. Recipients must be nonzero Base EVM addresses. Optional fee_sponsorship_percentage (0–100) sponsors that percentage of fees; integrator fees are not sponsored. - [Get Detailed Quote](https://docs.layerswap.io/api-reference/swaps/get-detailed-quote.md): Retrieves a swap quote based on the provided route request. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token addresses (e.g. 0xa0b8...). For native tokens via ad… - [Get Transaction Status](https://docs.layerswap.io/api-reference/swaps/get-transaction-status.md): Retrieves the status of a transaction by its ID. - [Get Swap By Transaction Hash](https://docs.layerswap.io/api-reference/swaps/get-swap-by-transaction-hash.md): Retrieves the details of a swap associated with the given on-chain transaction hash. - [Get Swap Details](https://docs.layerswap.io/api-reference/swaps/get-swap-details.md): Retrieves a specific swap and the same complete ordered deposit_actions workflow returned by /swaps/{swapId}/deposit_actions. Set exclude_deposit_actions=true to omit workflow construction. - [Get Deposit Actions](https://docs.layerswap.io/api-reference/swaps/get-deposit-actions.md): Returns the swap's complete ordered user-action workflow. Every item remains visible with step/status; sign steps include signing_standard (eip3009, eip2612, permit2, or permit2_witness), while only the action_required item includes transaction or typed-data fields. Existing transfer fields remain a… - [Get Gasless Authorization Status](https://docs.layerswap.io/api-reference/swaps/get-gasless-authorization-status.md): Returns the status of a gasless deposit authorization and, once published, the on-chain transaction. - [Authorize Gasless Deposit](https://docs.layerswap.io/api-reference/swaps/authorize-gasless-deposit.md): Submits a signed EIP-3009 authorization for a gasless deposit and starts the paymaster-sponsored deposit workflow. - [Speed up deposit](https://docs.layerswap.io/api-reference/swaps/speed-up-deposit.md): Speed up deposit detection with deposit transaction hash. - [Get All Swaps](https://docs.layerswap.io/api-reference/swaps/get-all-swaps.md): Retrieves a list of all swaps. - [Create Swap](https://docs.layerswap.io/api-reference/swaps/create-swap.md): Creates a new swap and returns the same complete ordered deposit_actions workflow exposed by GET /swaps/{swapId} and GET /swaps/{swapId}/deposit_actions. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept eit… - [DepositAddress](https://docs.layerswap.io/DepositAddress.md) - [Production checklist](https://docs.layerswap.io/resources/production-checklist.md): Validate keys, routes, error handling, tracking, security, and release dependencies before launch. - [Partner Dashboard](https://docs.layerswap.io/resources/partner-dashboard.md): Manage Layerswap apps, environment keys, webhooks, logos, and wallet-integration branding. - [Support](https://docs.layerswap.io/resources/support.md): Collect the right diagnostic information and contact Layerswap developer support. - [Brand Assets](https://docs.layerswap.io/resources/brand-assets.md): Download the Layerswap logo, symbol, and brand colors ## OpenAPI Specs - [swagger](https://api.layerswap.io/swagger/v2/swagger.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.