Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.layerswap.io/llms.txt

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

​
Overview

Native wallet packages provide complete, out-of-the-box wallet management for multiple blockchain ecosystems. This is the recommended approach for most integrations, offering the fastest path to production with minimal configuration.

​
Basic Usage

​
Quick Start with getDefaultProviders()

The fastest way to get started with all wallet providers: 
import { LayerswapProvider, Swap } from "@layerswap/widget"
import { getDefaultProviders } from "@layerswap/wallets"
import "@layerswap/widget/index.css"
import { walletConnectConfigs, tonConfigs } from "./configs"

export const App = () => {
  const walletProviders = getDefaultProviders({
    walletConnect: walletConnectConfigs,
    ton: tonConfigs
  })

  return (
    <LayerswapProvider
      walletProviders={walletProviders}
    >
      <Swap />
    </LayerswapProvider>
  )
}
getDefaultProviders() returns all available providers: EVM (with zkSync + Loopring), Starknet, Solana, Bitcoin, TON, Tron, Fuel, Paradex, and Immutable X.

​
Single Ecosystem

If you only need to support one blockchain ecosystem: 
import { LayerswapProvider, Swap } from "@layerswap/widget"
import { createEVMProvider } from "@layerswap/wallets"
import "@layerswap/widget/index.css"

export const App = () => {
  const evmProvider = createEVMProvider({
    walletConnectConfigs: {
      projectId: "YOUR_WALLETCONNECT_PROJECT_ID",
      name: "Your App Name",
      description: "Your app description",
      url: "https://yourapp.com",
      icons: ["https://yourapp.com/logo.png"]
    }
  })

  return (
    <LayerswapProvider
      walletProviders={[evmProvider]}
    >
      <Swap />
    </LayerswapProvider>
  )
}

​
Multi-Ecosystem Support

To support multiple blockchain ecosystems, create providers individually: 
import { LayerswapProvider, Swap } from "@layerswap/widget"
import {
  createEVMProvider,
  createStarknetProvider,
  createSVMProvider,
  createBitcoinProvider,
  createTONProvider
} from "@layerswap/wallets"
import "@layerswap/widget/index.css"

export const App = () => {
  const walletConnectConfigs = {
    projectId: "YOUR_WALLETCONNECT_PROJECT_ID",
    name: "Your App Name",
    description: "Your app description",
    url: "https://yourapp.com",
    icons: ["https://yourapp.com/logo.png"]
  }

  const walletProviders = [
    createEVMProvider({ walletConnectConfigs }),
    createStarknetProvider({ walletConnectConfigs }),
    createSVMProvider({ walletConnectConfigs }),
    createBitcoinProvider(),
    createTONProvider({
      tonConfigs: {
        tonApiKey: "YOUR_TON_API_KEY",
        manifestUrl: "https://yourapp.com/tonconnect-manifest.json"
      }
    })
  ]

  return (
    <LayerswapProvider
      config={{
        apiKey: "YOUR_API_KEY",
        version: "mainnet"
      }}
      walletProviders={walletProviders}
    >
      <Swap />
    </LayerswapProvider>
  )
}

​
Installation

The easiest way to get all wallet providers: 
npm install @layerswap/widget @layerswap/wallets wagmi viem @tanstack/react-query @bigmi/client @bigmi/core @bigmi/react
The @layerswap/wallets package includes:
  • All provider creator functions (createEVMProvider, createStarknetProvider, etc.)
  • The getDefaultProviders() helper function
  • All necessary dependencies

​
Alternative: Install Individual Providers

If you only need specific ecosystems, you can install individual packages: 
npm install @layerswap/wallet-evm wagmi viem @tanstack/react-query
Available individual packages:
  • @layerswap/wallet-evm - Ethereum and EVM-compatible chains
  • @layerswap/wallet-starknet - Starknet
  • @layerswap/wallet-svm - Solana
  • @layerswap/wallet-bitcoin - Bitcoin
  • @layerswap/wallet-ton - TON
  • @layerswap/wallet-tron - Tron
  • @layerswap/wallet-fuel - Fuel
  • @layerswap/wallet-paradex - Paradex
  • @layerswap/wallet-imtbl-passport - Immutable Passport
  • @layerswap/wallet-imtbl-x - Immutable X

​
Configuration

Each provider creator function accepts its own configuration options. Some providers require specific setup (like WalletConnect for EVM, API keys for TON), while others work without any configuration.

​
Provider-Specific Configuration

Configuration is passed directly to each provider: 
import { createEVMProvider, createTONProvider } from "@layerswap/wallets"

// Provider with configuration
const evmProvider = createEVMProvider({
  walletConnectConfigs: {
    projectId: "YOUR_PROJECT_ID",
    name: "Your App",
    description: "Your app description",
    url: "https://yourapp.com",
    icons: ["https://yourapp.com/icon.png"]
  }
})

// Provider without configuration
const bitcoinProvider = createBitcoinProvider()
For detailed configuration options for each provider, see their respective documentation pages:

​
When to Use Native Packages

Native wallet packages are ideal when:
  • You want the fastest integration path with minimal setup
  • Standard wallet support meets your requirements
  • You don’t have existing wallet management infrastructure

​
Supported Ecosystems

The following native providers are available and ready to use:

​
EVM (Ethereum Virtual Machine)

Package: @layerswap/wallet-evm Supports MetaMask, WalletConnect, and all EVM-compatible wallets across Ethereum, Polygon, Arbitrum, Optimism, Base, and more. View EVM Provider Documentation →

​
Starknet

Package: @layerswap/wallet-starknet Supports ArgentX, Braavos, and all Starknet-compatible wallets on Starknet Mainnet and Sepolia. View Starknet Provider Documentation →

​
Solana (SVM)

Package: @layerswap/wallet-svm Supports Phantom, Solflare, Backpack, and all Solana wallet adapter compatible wallets. View Solana Provider Documentation →

​
Bitcoin

Package: @layerswap/wallet-bitcoin Supports Unisat, Leather, Xverse, and other Bitcoin wallets using the Bigmi library. View Bitcoin Provider Documentation →

​
Fuel

Package: @layerswap/wallet-fuel Supports Fuel Network wallets and ecosystem. View Fuel Provider Documentation →

​
TON

Package: @layerswap/wallet-ton Supports TON Connect compatible wallets including Tonkeeper, MyTonWallet, and more. View TON Provider Documentation →

​
Tron

Package: @layerswap/wallet-tron Supports TronLink and other Tron ecosystem wallets. View Tron Provider Documentation →

​
Specialized Providers

​
Paradex

Package: @layerswap/wallet-paradex Integration for Paradex decentralized exchange. Requires Starknet wallet as dependency. View Paradex Provider Documentation →

​
Immutable Passport

Package: @layerswap/wallet-immutable-passport Immutable’s gaming-focused wallet solution with seamless onboarding. View Immutable Passport Documentation →

​
ImmutableX

Package: @layerswap/wallet-immutablex Layer 2 scaling solution for NFTs and gaming on Ethereum. View ImmutableX Provider Documentation →