Taker Integration Guide#

1import { TetraFi } from "@tetrafi/sdk";
2
3const tetrafi = new TetraFi({
4  apiKey: process.env.TETRAFI_API_KEY!,
5  environment: "sandbox",
6});
7
8const rfq = await tetrafi.rfq.create({
9  pair: "USDC/USDT",
10  side: "buy",
11  amount: "1000000.00",        // 1M USDC
12  corridor: "ethereum-optimism",
13  maxSlippage: 0.001,           // 0.1% max slippage
14});
15
16console.log(`RFQ created: {rfq.id}`);
17console.log(`Status: {rfq.status}`);  // "quoting"
18console.log(`Auction ends: {rfq.expiresAt}`);

1// Option 1: Poll for quotes
2const quotes = await tetrafi.rfq.getQuotes(rfq.id);
3console.log(`Received {quotes.length} quotes:`);
4
5quotes.forEach((q) => {
6  console.log(`  {q.solverId}: {q.price} ({q.confidence * 100}% confidence)`);
7});
8
9// Option 2: Real-time via WebSocket
10tetrafi.events.on("quote.received", (event) => {
11  console.log(`New quote: {event.quote.price} from {event.quote.solverId}`);
12  console.log(`  TTL: {event.quote.ttl}s | Confidence: {event.quote.confidence * 100}%`);
13});

1// Automatic best-price selection
2const settlement = await tetrafi.rfq.acceptBest(rfq.id);
3console.log("Settlement initiated:", settlement.id);
4
5// OR manual selection for custom logic
6const sorted = quotes.sort((a, b) => parseFloat(b.price) - parseFloat(a.price));
7const settlement = await tetrafi.quotes.accept(sorted[0].id);
8console.log("Accepted quote:", sorted[0].id, "at price:", sorted[0].price);

1// Subscribe to settlement events
2tetrafi.events.on("settlement.pending", (event) => {
3  console.log("Escrow locked:", event.settlement.escrowTxHash);
4  console.log("Settlement in progress...");
5});
6
7tetrafi.events.on("settlement.complete", (event) => {
8  const { settlement } = event;
9  console.log("Settlement complete!");
10  console.log("  Origin TX:", settlement.originTxHash);
11  console.log("  Destination TX:", settlement.destinationTxHash);
12});
13
14tetrafi.events.on("settlement.failed", (event) => {
15  console.error("Settlement failed:", event.settlement.error);
16  console.log("Refund TX:", event.settlement.refundTxHash);
17});
18
19// OR poll status
20const status = await tetrafi.settlements.get(settlement.id);
21// status.status: "pending" | "escrow_locked" | "filling" | "complete" | "failed"

1// Fetch WORM audit trail
2const audit = await tetrafi.audit.getTrail(settlement.id);
3console.log("Audit entries:", audit.length);
4
5for (const entry of audit) {
6  console.log(`[{entry.type}] {entry.timestamp}: {entry.hash}`);
7}
8
9// Settlement receipt for accounting
10const receipt = {
11  settlementId: settlement.id,
12  pair: rfq.pair,
13  side: rfq.side,
14  amount: rfq.amount,
15  executedPrice: accepted.price,
16  originTx: settlement.originTxHash,
17  destTx: settlement.destinationTxHash,
18  settledAt: new Date().toISOString(),
19};
20
21await recordToAccountingSystem(receipt);