Order Lifecycle¶

const timeRes = await fetch("https://api.sera.cx/api/v1/system/time");
const { timestamp } = await timeRes.json();
console.log("Server time:", timestamp);

const tokensRes = await fetch("https://api.sera.cx/api/v1/tokens");
const { tokens } = await tokensRes.json();

// Find USDC and EURC addresses
const usdc = tokens.find((t: any) => t.symbol === "USDC");
const eurc = tokens.find((t: any) => t.symbol === "EURC");

import { v4 as uuidv4 } from "uuid";

// Generate a unique order ID
const orderId  = uuidv4();
const { executor_id: executorId } = await fetch("https://api.sera.cx/api/v1/health")
  .then(r => r.json());
const raw      = BigInt("0x" + orderId.replace(/-/g, ""));
const groupId  = raw >> 16n;
const uuidInt  = ((BigInt(executorId) << 252n) | (raw << 124n) | (groupId << 12n)).toString();

// Construct the order. from_address is the market base token and
// to_address is the market quote token. Side decides which one is spent.
const order = {
  owner_address: walletAddress,
  side:          "bid",                  // buy EURC with USDC
  amount:        "1000.0",               // 1000 EURC
  price:         "1.085",                // at 1.085 USDC per EURC
  order_type:    "limit",
  from_address:  EURC_ADDRESS,           // base token you want to buy
  to_address:    USDC_ADDRESS,           // quote token you spend on a bid
  order_id:      orderId,
  uuid_int:      uuidInt,
  expiration:    Math.floor(Date.now() / 1000) + 86_400,
};

// Sign with EIP-712 (see Authentication for full signing details)
const signature = await signOrder(signer, order);

const response = await fetch("https://api.sera.cx/api/v1/orders", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ ...order, signature }),
});
const result = await response.json();
console.log("Order placed:", result.order_id);

const statusRes = await fetch(
  `https://api.sera.cx/api/v1/orders/${orderId}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY:YOUR_API_SECRET" } },
);
const status = await statusRes.json();
console.log("Status:", status.status);
// External statuses: "pending", "matched", "settled", "cancelled", "failed"
console.log("Filled:", status.filled_amount);
console.log("Signed uuid_int:", status.uuid_int);

const balanceRes = await fetch(
  `https://api.sera.cx/api/v1/balances?owner_address=${walletAddress}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY:YOUR_API_SECRET" } },
);

const { balances } = await balanceRes.json();
for (const bal of balances) {
  console.log(`${bal.symbol}: vault_raw=${bal.vault_available}, ` +
              `frozen_raw=${bal.vault_frozen}, decimals=${bal.decimals}`);
}

// Sign a CancelOrder message
const cancelSignature = await signCancelOrder(signer, walletAddress, BigInt(status.uuid_int));

const cancelRes = await fetch("https://api.sera.cx/api/v1/orders/cancel", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    owner_address: walletAddress,
    order_id:      orderId,
    uuid_int:      status.uuid_int,
    signature:     cancelSignature,
  }),
});
console.log("Cancelled:", await cancelRes.json());