Trade with your AI agent

curl -s https://protect.temporal.exchange/api/venue/health

{"ok":true,"ready":true,"phase":"testnet","seq":2155967,"wallets":210, ...}

curl -s https://protect.temporal.exchange/api/venue/chain/health

{"ok":true,"chainId":99801,"ledger":"0x5dc52db2…51cc","intentRelay":true,
 "pricedAssets":["BTC","HYPE"],"assetIds":{"BTC":0,"HYPE":1,"SPX":2},
 "fees":{...},"front":{...},"venueVersion":"elysium-testnet-21", ...}

curl -s "https://protect.temporal.exchange/api/venue/chain/state?wallet=0xYOUR_WALLET"

{"ok":true,"wallet":"0x…","connected":false,"cashUSD":0,"accounts":{},
 "perpMark":{"BTC":79892.5,"HYPE":76.2105}, ...}

curl -s "https://protect.temporal.exchange/api/venue/chain/nonce?wallet=0xYOUR_WALLET"

{"ok":true,"source":"elysium-testnet-1","nonce":2}

// temporal.mjs: the whole toolkit an agent needs to act on the Temporal TESTNET venue.
// Needs Node 22+ and `npm i ethers`. The key stays in YOUR environment (WALLET_KEY); the venue never sees it.
import { Wallet, Interface, keccak256 } from "ethers";

export const BASE = process.env.TEMPORAL_BASE ?? "https://protect.temporal.exchange/api/venue";
export const wallet = new Wallet(process.env.WALLET_KEY);

const json = (r) => r.json();
export const get = (path, headers = {}) => fetch(BASE + path, { headers }).then(json);
export const post = (path, body, headers = {}) =>
  fetch(BASE + path, { method: "POST", headers: { "content-type": "application/json", ...headers }, body: JSON.stringify(body) }).then(json);

// The ledger calls, exactly as the website builds them.
export const ledger = new Interface([
  "function connect()",
  "function mintAccount(uint8 kind)",
  "function deposit(uint256 account, uint256 usd)",
  "function withdraw(uint256 account, uint256 usd)",
  "function openLegAtFront(uint256 account, (uint8 asset, uint8 side, uint8 wing, uint256 strikeK, uint256 decay) spec, uint256 qty, uint256 consent)",
  "function closeLegAtFront(uint256 account, uint256 legIndex, uint256 qty)",
  "function closeAccountAtFront(uint256 account)",
  "function openPerpWithLegs(uint256 account, uint8 asset, uint8 side, uint256 qty, uint8 leverage, uint256 margin, (uint8 wing, uint8 side, uint256 strikeK, uint256 qty, uint256 decay, uint256 bound, uint256 consent)[] legs)",
  "function requestClosePerp(uint256 account, uint256 perpId)",
]);
export const call = (name, ...args) => ledger.encodeFunctionData(name, args);

// Units: dollars have 6 decimals, coins and strikes 18. `up` rounds a dollar amount UP (a consent never authorises less than asked).
export const KIND = { trade: 0, protect: 1, earn: 3 };
export const ASSET = { BTC: 0, HYPE: 1 };
export const usd = (x, up = false) => BigInt(up ? Math.ceil(x * 1e6 - 1e-6) : Math.round(x * 1e6));
export const coin = (x) => BigInt(Math.round(x * 1e6)) * 10n ** 12n;
export const strike = (dollars) => BigInt(Math.round(dollars * 100)) * 10n ** 16n;
// A decay is signed as its rate per year (12 / months) in 18 decimals. A whole month is exact.
export const decay = (months) =>
  Number.isInteger(months) ? (12n * 10n ** 18n) / BigInt(months) : BigInt(Math.round((12 / months) * 1e6)) * 10n ** 12n;

// Ask the venue what the act would do. Nothing is signed or sent.
export const check = (data) => post("/chain/dryrun", { user: wallet.address, call: data, extraCashUSD: 0 });

// Sign ONE intent for a ledger call and hand it to the venue, which submits it and pays the gas.
export async function act(data) {
  const health = await get("/chain/health");
  const { nonce } = await get(`/chain/nonce?wallet=${wallet.address}`);
  const deadline = Math.floor(Date.now() / 1000) + 600;
  const domain = { name: "VenueLedger", version: "1", chainId: health.chainId, verifyingContract: health.ledger };
  const types = {
    VenueIntent: [
      { name: "user", type: "address" },
      { name: "callHash", type: "bytes32" },
      { name: "nonce", type: "uint256" },
      { name: "deadline", type: "uint256" },
    ],
  };
  const message = { user: wallet.address, callHash: keccak256(data), nonce: String(nonce), deadline };
  const sig = await wallet.signTypedData(domain, types, message);
  // Acts that read a price carry a fresh signed price snapshot (it lives 5 seconds, so fetch it right before sending).
  const snap = await post("/chain/snapshot", { call: data, wallet: wallet.address });
  return post("/chain/intent", { user: wallet.address, call: data, nonce: String(nonce), deadline, sig, ...(snap.ok ? { snaps: snap.snaps } : {}) });
}

// Poll a read until it says what you expect (the index trails the chain by a few seconds).
export async function until(read, ok, seconds = 90) {
  for (let t = 0; t < seconds; t += 3) {
    const v = await read();
    if (ok(v)) return v;
    await new Promise((r) => setTimeout(r, 3000));
  }
  throw new Error("timed out waiting for the venue to show the change");
}

{"ok":false,"code":"intent_reverted","errorName":"NoSuchAccount","reason":"No such account on this wallet.","dry":true}