SDK Libraries

Client libraries for integrating with the 1Click Swap API

The 1Click SDK provides client libraries in multiple languages for seamless cross-chain token swaps using the 1Click Swap API.

TypeScript

npm package

Go

Go module

Rust

Cargo crate

---

Quickstart

There is no testnet version of NEAR Intents - use small amounts for test swaps.

1. Prerequisites

   • A small amount of tokens on ANY supported chain.
   • A JWT token to avoid the 0.2% fee.
2. Install SDK package

   TypeScript

   npm install @defuse-protocol/one-click-sdk-typescript
   
3. Configure client

   TypeScript

   import { OpenAPI } from '@defuse-protocol/one-click-sdk-typescript';
   
   // The base URL defaults to https://1click.chaindefuser.com
   OpenAPI.BASE = 'https://1click.chaindefuser.com';
   
   // Required for getQuote, submitDepositTx, and getExecutionStatus
   OpenAPI.TOKEN = 'YOUR_JWT_TOKEN';
   
4. Query supported tokens

   TypeScript

   import { OneClickService } from '@defuse-protocol/one-click-sdk-typescript';
   
   const tokens = await OneClickService.getTokens();
   console.log(tokens);
   
5. Request a quote

   TypeScript

   import { OneClickService, QuoteRequest } from '@defuse-protocol/one-click-sdk-typescript';
   
   // Example: swap USDC on Arbitrum for USDC on Solana
   const quoteRequest: QuoteRequest = {
     dry: false,                                    // true = simulate only, no depositAddress returned
     swapType: QuoteRequest.swapType.EXACT_INPUT,
     slippageTolerance: 100,                        // basis points (100 = 1%)
     originAsset: 'nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near',
     depositType: QuoteRequest.depositType.ORIGIN_CHAIN,
     destinationAsset: 'nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near',
     amount: '1000000',                             // 1 USDC in smallest units (6 decimals)
     refundTo: '0xYourArbitrumAddress',
     refundType: QuoteRequest.refundType.ORIGIN_CHAIN,
     recipient: 'YourSolanaAddress',
     recipientType: QuoteRequest.recipientType.DESTINATION_CHAIN,
     deadline: new Date(Date.now() + 3 * 60 * 1000).toISOString(),
   };
   
   const quote = await OneClickService.getQuote(quoteRequest);
   

   Save quote.quote.depositAddress (and quote.quote.depositMemo if present). You will use these for deposit and status checks.

6. Send tokens

   Transfer tokens to the depositAddress (on the origin chain) from the quote response. The swap begins automatically upon receipt.

   Save your transaction hash for optional submission and tracking.

7. Submit transaction hash (optional)

   Submitting the transaction hash lets the service detect your deposit faster and start processing sooner.

   TypeScript

   await OneClickService.submitDepositTx({
     depositAddress: quote.quote.depositAddress!,
     txHash: '0xYourTransactionHash',
   });
   
8. Monitor status

   Poll until status reaches a terminal state (SUCCESS, REFUNDED, or FAILED).

   TypeScript

   const status = await OneClickService.getExecutionStatus(quote.quote.depositAddress!);
   console.log(status.status);
   

   Status values

   Status	Description
   PENDING_DEPOSIT	Awaiting your token deposit
   KNOWN_DEPOSIT_TX	Deposit transaction detected
   PROCESSING	Swap being executed
   SUCCESS	Tokens delivered to destination address
   INCOMPLETE_DEPOSIT	Deposit below required amount
   REFUNDED	Swap failed, funds returned to refund address
   FAILED	Swap encountered an error