1Click API for apps

import { OneClickService, OpenAPI, QuoteRequest } from '@defuse-protocol/one-click-sdk-typescript'

OpenAPI.BASE = 'https://1click.chaindefuser.com'
OpenAPI.TOKEN = process.env.ONECLICK_JWT // keep the key on your server

// Pin asset IDs from /v0/tokens; never build them by hand
const USDC_SOL = 'nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near'
const USDC_NEAR = 'nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1'

export async function createSwap(userSolanaAddress: string, nearRecipient: string) {
  const request: QuoteRequest = {
    dry: true,
    swapType: QuoteRequest.swapType.EXACT_INPUT,
    slippageTolerance: 100, // basis points: 1%
    originAsset: USDC_SOL,
    depositType: QuoteRequest.depositType.ORIGIN_CHAIN,
    destinationAsset: USDC_NEAR,
    amount: '25000000', // 25 USDC, smallest units, integer string
    refundTo: userSolanaAddress,
    refundType: QuoteRequest.refundType.ORIGIN_CHAIN,
    recipient: nearRecipient,
    recipientType: QuoteRequest.recipientType.DESTINATION_CHAIN,
    deadline: new Date(Date.now() + 30 * 60_000).toISOString(),
    appFees: [{ recipient: 'fees.myapp.near', fee: 30 }], // your 0.3%, paid inside Intents
  }

  // 1. Preview: price and time estimate, no deposit address
  const preview = await OneClickService.getQuote(request)
  console.log(preview.quote.amountOutFormatted, preview.quote.timeEstimate)

  // 2. Live quote once the user confirms
  const live = await OneClickService.getQuote({ ...request, dry: false })
  await saveQuote(live) // keep the WHOLE response, including `signature`, for disputes
  return live.quote // depositAddress, depositMemo?, amountIn, minAmountOut, deadline…
}

const TERMINAL = new Set(['SUCCESS', 'REFUNDED', 'FAILED'])

export async function track(depositAddress: string) {
  for (;;) {
    const s = await OneClickService.getExecutionStatus(depositAddress)
    if (TERMINAL.has(s.status)) return s // swapDetails: amountOut, refundedAmount, refundReason…
    if (s.status === 'INCOMPLETE_DEPOSIT') notifyUser('Deposit is below the quoted amount')
    await new Promise((r) => setTimeout(r, 5_000))
  }
}

declare function saveQuote(q: unknown): Promise<void>
declare function notifyUser(msg: string): void