Quickstart

npm install viem wagmi
# or
yarn add viem wagmi

const ONETX_ROUTER = "0xbFdd5bEdC0cB9B8795A93C2a1fB634012C8F99bC";
const USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";

import { parseUnits } from 'viem';

// Instrument ID for Aave USDC on Base
const AAVE_USDC_ID = "0x00002105c053a3e1290845e12a3eea14926472ce7f15da324cdf0700056fc04b";
const amount = parseUnits("1000", 6); // 1000 USDC

// 1. Approve 1tx Router to spend your USDC
await usdc.write.approve([ONETX_ROUTER, amount]);

// 2. Execute buy via 1tx Router
// buy(instrumentId, amount, minDepositedAmount, fastTransfer, maxFee, referralFeeBps, referralWallet)
await d1txRouter.write.buy([
  AAVE_USDC_ID,
  amount,
  0n,
  false,
  0n,
  0,                                              // referralFeeBps (0-500, e.g. 25 = 0.25%)
  '0x0000000000000000000000000000000000000000',   // referralWallet (zero address = no referral)
]);

curl -H "X-API-Key: your-api-key" \
  https://api.1tx.fi/api/v1/instruments

curl -H "X-API-Key: your-api-key" \
  https://api.1tx.fi/api/v1/instruments/0x00002105c053a3e1290845e12a3eea14926472ce7f15da324cdf0700056fc04b

curl -X POST "https://api.1tx.fi/api/v1/transactions/buy" \
  -H "Authorization: Bearer <your_jwt>" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "userAddress": "0x59F84Af036712AFe2fD0Ec77f4D9a6F0a612f1fE",
    "instrumentId": "0x0000a4b194d4938ed6aab5bdbac7ca4b622f3639b1bca1b8b9c3271403d3b1b5",
    "amountUsdc": "2.20"
  }'

curl "https://api.1tx.fi/api/v1/cctp/relay/tx/0xSourceTxHash"

npm install @privy-io/react-auth wagmi viem

import { PrivyProvider } from '@privy-io/react-auth';

<PrivyProvider
  appId="your-privy-app-id"
  config={{
    embeddedWallets: {
      createOnLogin: 'all-users',
    },
  }}
>
  <YourApp />
</PrivyProvider>

import { usePrivy } from '@privy-io/react-auth';

const { createSessionKey } = usePrivy();

// Create session key with limits
await createSessionKey({
  maxAmount: parseEther("10000"), // Max 10k USDC
  expiry: Date.now() + 86400000, // 24 hours
});