Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/1inch/cross-chain-sdk/llms.txt

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

​
What is the 1inch Cross-Chain SDK?

The 1inch Cross-Chain SDK enables developers to create atomic cross-chain swaps through the 1inch Fusion+ protocol. It provides a TypeScript/JavaScript interface for executing trustless token swaps between different blockchain networks without relying on bridges or wrapped tokens.

​
How It Works

The SDK implements atomic swaps using:
  • Hash Time-Locked Contracts (HTLCs): Cryptographic hash locks ensure that swaps either complete fully or fail safely
  • Trustless Escrows: Smart contracts on both source and destination chains hold funds securely
  • Secret Management: Users generate and share secrets to unlock funds after escrows are deployed
  • 1inch Fusion+ Protocol: Orders are matched and executed through 1inch’s decentralized resolver network

​
Supported Chains

The SDK supports cross-chain swaps between:

​
EVM Chains

  • Ethereum
  • Polygon
  • Arbitrum
  • Optimism
  • Avalanche
  • BNB Chain (Binance Smart Chain)
  • Base
  • Gnosis
  • zkSync Era

​
Non-EVM Chains

  • Solana
You can swap between any supported EVM chain, from EVM to Solana, or from Solana to EVM.

​
Key Features

Atomic Swaps

Cryptographically guaranteed all-or-nothing execution using hash locks

No Bridges

Direct chain-to-chain swaps without intermediary wrapped tokens

TypeScript Support

Fully typed SDK with comprehensive TypeScript definitions

Integrator Fees

Built-in support for charging fees as an integrator (in basis points)

Multiple Presets

Choose between fast, medium, and slow execution speeds

Native Assets

Support for both ERC-20 tokens and native assets (ETH, BNB, AVAX, etc.)

​
Use Cases

  • DeFi Applications: Enable users to access liquidity across multiple chains
  • Cross-Chain DEX Aggregators: Build interfaces for multi-chain token swaps
  • Portfolio Management: Rebalance assets across different networks
  • Payment Solutions: Accept payments on one chain and receive on another

​
Getting Started

Ready to integrate cross-chain swaps into your application?

Installation

Install the SDK and configure your development environment

Quickstart

Execute your first cross-chain swap in minutes

​
Additional Resources

The SDK requires an API key from the 1inch Developer Portal. You can get started for free.