SDK Client#

1npm install @tetrafi/sdk

1import { TetraFi } from "@tetrafi/sdk";
2
3const tetrafi = new TetraFi({
4  apiKey: process.env.TETRAFI_API_KEY!,
5  environment: "sandbox",  // "sandbox" | "production"
6  timeout: 30000,           // ms, default 30000
7  retries: 3,               // auto-retry on 5xx
8});

1const rfq = await tetrafi.rfq.create({
2  pair: "USDC/USDT",
3  side: "buy",
4  amount: "1000000.00",
5  corridor: "ethereum-optimism",
6  maxSlippage: 0.001,
7});

1const quotes = await tetrafi.rfq.getQuotes("rfq_abc123");

1const settlement = await tetrafi.rfq.acceptBest("rfq_abc123");

1const settlement = await tetrafi.quotes.accept("qt_xyz789");

1const settlement = await tetrafi.settlements.get("stl_abc123");

1const status = await tetrafi.compliance.check("...");

1const unsubscribe = tetrafi.events.on("settlement.complete", (event) => {
2  console.log("Settled:", event.settlement.id);
3});
4
5// Later: stop receiving events
6unsubscribe();

1import { TetraFi } from "@tetrafi/sdk";
2
3const tetrafi = new TetraFi({
4  apiKey: process.env.TETRAFI_API_KEY!,
5  environment: "sandbox",
6});
7
8async function executeSwap() {
9  // 1. Create RFQ
10  const rfq = await tetrafi.rfq.create({
11    pair: "USDC/USDT",
12    side: "buy",
13    amount: "1000000.00",
14  });
15
16  // 2. Wait for auction window
17  await new Promise((r) => setTimeout(r, 3000));
18  const quotes = await tetrafi.rfq.getQuotes(rfq.id);
19  if (quotes.length === 0) throw new Error("No quotes");
20
21  // 3. Accept best price
22  const settlement = await tetrafi.rfq.acceptBest(rfq.id);
23
24  // 4. Monitor to completion
25  let status = settlement;
26  while (!["complete", "failed", "refunded"].includes(status.status)) {
27    await new Promise((r) => setTimeout(r, 5000));
28    status = await tetrafi.settlements.get(settlement.id);
29  }
30
31  console.log(status.status === "complete" ? "Success!" : `Failed: ${status.status}`);
32}
33
34executeSwap().catch(console.error);

1import { TetraFiError, RateLimitError, AuthError, ComplianceError } from "@tetrafi/sdk";
2
3try {
4  const rfq = await tetrafi.rfq.create({ pair: "USDC/USDT", side: "buy", amount: "1000000" });
5} catch (e) {
6  if (e instanceof RateLimitError) {
7    await sleep(e.retryAfter * 1000);
8  } else if (e instanceof AuthError) {
9    console.error("Invalid API key");
10  } else if (e instanceof ComplianceError) {
11    console.error("Compliance check failed");
12  } else if (e instanceof TetraFiError) {
13    console.error("API error:", e.code, e.message);
14  } else {
15    throw e;
16  }
17}

1interface RFQ {
2  id: string;
3  pair: string;
4  side: "buy" | "sell";
5  amount: string;
6  corridor: string;
7  status: "pending" | "quoting" | "accepted" | "expired";
8  createdAt: string;
9  expiresAt: string;
10}
11
12interface Quote {
13  id: string;
14  rfqId: string;
15  solverId: string;
16  price: string;
17  ttl: number;
18  confidence: number;
19  createdAt: string;
20}
21
22interface Settlement {
23  id: string;
24  rfqId: string;
25  quoteId: string;
26  status: "pending" | "escrow_locked" | "filling" | "complete" | "failed" | "refunded";
27  originTxHash?: string;
28  destinationTxHash?: string;
29  amount: string;
30  createdAt: string;
31  settledAt?: string;
32}
33
34interface ComplianceStatus {
35  address: string;
36  isCompliant: boolean;
37  attestationHash: string;
38  expiresAt: string;
39}