TypeScript 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,           // request timeout (ms), default 30000
7  retries: 3,               // auto-retry on 5xx, default 3
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 entries = await tetrafi.audit.getTrail("stl_abc123");

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  console.log("RFQ created:", rfq.id);
16
17  // 2. Wait for quotes (poll)
18  await new Promise((r) => setTimeout(r, 3000));
19  const quotes = await tetrafi.rfq.getQuotes(rfq.id);
20  console.log("Received quotes:", quotes.length);
21
22  if (quotes.length === 0) {
23    throw new Error("No quotes received");
24  }
25
26  // 3. Accept best price
27  const settlement = await tetrafi.rfq.acceptBest(rfq.id);
28  console.log("Settlement initiated:", settlement.id);
29
30  // 4. Monitor to completion
31  let status = settlement;
32  while (!["complete", "failed", "refunded"].includes(status.status)) {
33    await new Promise((r) => setTimeout(r, 5000));
34    status = await tetrafi.settlements.get(settlement.id);
35    console.log("Status:", status.status);
36  }
37
38  if (status.status === "complete") {
39    console.log("Success!");
40    console.log("Origin TX:", status.originTxHash);
41    console.log("Destination TX:", status.destinationTxHash);
42  } else {
43    throw new Error(`Settlement failed: {status.status}`);
44  }
45}
46
47executeSwap().catch(console.error);

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

1import { TetraFi } from "@tetrafi/sdk";
2
3const tetrafi = new TetraFi({
4  apiKey: process.env.TETRAFI_API_KEY!,
5  environment: "sandbox",
6});
7
8// Connect (lazy - happens on first .on() call)
9const unsubQuotes = tetrafi.events.on("quote.received", (event) => {
10  console.log(`[Quote] {event.quote.solverId}: {event.quote.price}`);
11});
12
13const unsubSettlement = tetrafi.events.on("settlement.*", (event) => {
14  switch (event.type) {
15    case "settlement.pending":
16      console.log("Escrow locked:", event.settlement.id);
17      break;
18    case "settlement.complete":
19      console.log("Complete!", event.settlement.originTxHash);
20      break;
21    case "settlement.failed":
22      console.error("Failed:", event.settlement.error);
23      break;
24  }
25});
26
27// Connection lifecycle hooks
28tetrafi.events.on("connection.opened", () => console.log("WS connected"));
29tetrafi.events.on("connection.closed", () => console.log("WS disconnected - auto-reconnecting"));
30tetrafi.events.on("connection.error", (e) => console.error("WS error:", e));
31
32// Cleanup on shutdown
33process.on("SIGTERM", () => {
34  unsubQuotes();
35  unsubSettlement();
36  tetrafi.events.disconnect();
37});

1[TetraFi] Warning: tetrafi.rfq.create({ slippage }) is deprecated. Use { maxSlippage } instead. This will be removed in 2.0.0.