Engine Error Codes Reference and Handling Strategies

interface TxResult {
  code: number;    // 0 = success; non-zero = ExecError code
  hash: string;    // transaction hash (hex)
  height?: number; // block height (populated after DeliverTx)
  log?: string;    // human-readable message (populated on error)
  events?: TxEvent[];
}

import { decodeExecError, execErrorName } from "@proof/trading-sdk";

// Returns ExecErrorInfo | null  (null for code 0 and unknown codes)
const info = decodeExecError(r.code);
// { name: "InsufficientMargin", description: "post-trade equity below initial margin requirement" }

// Returns just the stable variant name string
const name = execErrorName(r.code);
// "InsufficientMargin"  — or "Ok" for code 0, "UnknownError" for unrecognised codes

interface ExecErrorInfo {
  name: string;        // Rust variant name — stable, machine-readable
  description: string; // one-line human-readable message, suitable for toasts
}

import { decodeExecError } from "@proof/trading-sdk";

const r = await client.submitTx({
  type: "PlaceOrder",
  data: { /* ... */ },
});

if (r.code !== 0) {
  const err = decodeExecError(r.code);

  if (r.code === 21) {
    // TimestampNonceRejected — transient; the SDK advances the nonce automatically.
    // Simply retry the same action.
    const retried = await client.submitTx({ type: "PlaceOrder", data: { /* ... */ } });
    return retried;
  }

  throw new Error(
    `${err?.name ?? "UnknownError"} (code ${r.code}): ${err?.description ?? r.log}`
  );
}

try {
  const r = await client.submitTx(action);
  if (r.code !== 0) {
    const err = decodeExecError(r.code);
    console.error(`Engine error ${r.code} (${err?.name}): ${err?.description}`);
  }
} catch (e) {
  // HTTP-level error from the gateway (401, 429, network failure, etc.)
  console.error("Gateway error:", e);
}