@huggies/shit-1170-rex-engine-middleman 0.0.0-stage → 0.0.2

package/bin/shit-1170/api_shit_1170_api_keys_post.ts

@@ -0,0 +1,68 @@
+// ========================================
+// API_SHIT_1170_API_KEYS_POST
+// runnable bin for POST /api/shit-1170/api-keys via middleman. the
+// middleman logs the framed request + response, so this bin only adds
+// a one-line summary.
+//
+// the accounts come from a json file, so a real signed message can be
+// posted without a wallet in the loop:
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_api_keys_post.ts \
+//     --accounts <path-to-json>
+//
+// the file holds the accounts array, either as the array itself or as
+// the whole request body:
+//   { "accounts": [ { "accountId": "...", "publicKey": "...", ... } ] }
+//
+// --- WHY --- the bin is named after the API KEY and not after the
+// session: the credential in it is not a browser session. the user
+// signs in once and hands the key to an agent, and the agent holds it
+// as a bearer token for as long as it lives.
+// ========================================
+
+import { readFileSync } from "node:fs";
+import { api_shit_1170_api_keys_post } from "@huggies/shit-1170-rex-engine-middleman";
+import type {
+  SHIT_1170_API_KEYS_REQUEST,
+  SHIT_1170_SIGNED_ACCOUNT,
+} from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const accounts_flag = argv.indexOf("--accounts");
+const accounts_path =
+  accounts_flag === -1 ? undefined : argv[accounts_flag + 1];
+if (accounts_path === undefined || accounts_path.length === 0) {
+  console.error(
+    "usage: api_shit_1170_api_keys_post.ts [--base-url <url>] --accounts <file.json>",
+  );
+  process.exit(1);
+}
+
+const raw = readFileSync(accounts_path, "utf8");
+const parsed = JSON.parse(raw) as
+  SHIT_1170_API_KEYS_REQUEST | SHIT_1170_SIGNED_ACCOUNT[];
+// the file may hold the accounts array on its own or the whole body.
+const accounts = Array.isArray(parsed) ? parsed : parsed.accounts;
+
+const keys = await api_shit_1170_api_keys_post(base_url, { accounts });
+
+console.log(`API KEYS: ${keys.keys.length} account(s)`);
+for (const entry of keys.keys) {
+  console.log(
+    `  ${entry.accountId}  ${
+      entry.created ? "created" : "existing"
+    }  key: ${entry.apiKey.slice(0, 8)}…`,
+  );
+}
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_ping_get.ts

@@ -0,0 +1,28 @@
+// ========================================
+// API_SHIT_1170_PING_GET
+// runnable bin for GET /api/shit-1170/ping via middleman. the
+// middleman logs the framed request + response, so this bin only adds
+// a one-line summary.
+//
+// argv:
+//   bun middleman/bin/shit-1170/api_shit_1170_ping_get.ts [--base-url <url>]
+// ========================================
+
+import { api_shit_1170_ping_get } from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const ping = await api_shit_1170_ping_get(base_url);
+
+console.log("PING", ping.ok ? "ok" : "not ok", `app: ${ping.app}`);
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_accounts_delete.ts

@@ -0,0 +1,81 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_ACCOUNTS_DELETE
+// runnable bin for DELETE
+// /api/shit-1170/swap-queue/{swap_id}/accounts/{account_id} via
+// middleman. the middleman logs the framed request + response, so this
+// bin only adds a summary.
+//
+// the account removed is ALWAYS the one the api key belongs to — the
+// backend refuses anybody else. so the bin takes the account id and
+// checks it against the key's own answer, and says so when they differ.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_accounts_delete.ts \
+//     --api-key shit_1170_abc123... \
+//     --swap-id 8f14e45f-ceea-467a-9b0d-2b1c2e6c1a11 \
+//     --account-id alice.near
+// ========================================
+
+import {
+  api_shit_1170_swap_queue_accounts_delete,
+  api_shit_1170_api_key_me_get,
+} from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = [];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const swap_id = flags.get("--swap-id");
+const account_id = flags.get("--account-id");
+if (swap_id === undefined || account_id === undefined) {
+  console.error(
+    "usage: api_shit_1170_swap_queue_accounts_delete.ts [--base-url <url>] " +
+      "--api-key <key> --swap-id <id> --account-id <account_id>",
+  );
+  process.exit(1);
+}
+
+const api_key = flags.get("--api-key");
+
+// --- WHY --- the account is CHECKED against the key here: the backend
+// refuses to remove anybody but the key's own account, and a 403 says
+// less than saying which account the key really belongs to.
+const me = await api_shit_1170_api_key_me_get(base_url, { api_key });
+if (me.accountId !== account_id) {
+  console.error(
+    `api_shit_1170_swap_queue_accounts_delete: the api key belongs to ${me.accountId}, ` +
+      `not to ${account_id} — you may only remove yourself`,
+  );
+  process.exit(1);
+}
+
+const swap = await api_shit_1170_swap_queue_accounts_delete(
+  base_url,
+  swap_id,
+  account_id,
+  { api_key },
+);
+
+console.log(`SWAP QUEUE ${swap.swapId}: ${swap.accounts.length} account(s)`);
+for (const account of swap.accounts) {
+  console.log(`    ${account.accountId}  ${account.status}`);
+}
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_accounts_post.ts

@@ -0,0 +1,80 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_ACCOUNTS_POST
+// runnable bin for POST /api/shit-1170/swap-queue/{swap_id}/accounts via
+// middleman. the middleman logs the framed request + response, so this
+// bin only adds a summary.
+//
+// the account added is ALWAYS the one the api key belongs to — the
+// backend refuses anybody else. so the bin takes the account id and
+// checks it against the key's own answer, and says so when they differ.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_accounts_post.ts \
+//     --api-key shit_1170_abc123... \
+//     --swap-id 8f14e45f-ceea-467a-9b0d-2b1c2e6c1a11 \
+//     --account-id alice.near
+// ========================================
+
+import {
+  api_shit_1170_swap_queue_accounts_post,
+  api_shit_1170_api_key_me_get,
+} from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = [];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const swap_id = flags.get("--swap-id");
+const account_id = flags.get("--account-id");
+if (swap_id === undefined || account_id === undefined) {
+  console.error(
+    "usage: api_shit_1170_swap_queue_accounts_post.ts [--base-url <url>] " +
+      "--api-key <key> --swap-id <id> --account-id <account_id>",
+  );
+  process.exit(1);
+}
+
+const api_key = flags.get("--api-key");
+
+// --- WHY --- the account is CHECKED against the key here: the backend
+// refuses to add anybody but the key's own account, and a 403 says less
+// than saying which account the key really belongs to.
+const me = await api_shit_1170_api_key_me_get(base_url, { api_key });
+if (me.accountId !== account_id) {
+  console.error(
+    `api_shit_1170_swap_queue_accounts_post: the api key belongs to ${me.accountId}, ` +
+      `not to ${account_id} — you may only add yourself`,
+  );
+  process.exit(1);
+}
+
+const swap = await api_shit_1170_swap_queue_accounts_post(
+  base_url,
+  swap_id,
+  { accountId: account_id },
+  { api_key },
+);
+
+console.log(`SWAP QUEUE ${swap.swapId}: ${swap.accounts.length} account(s)`);
+for (const account of swap.accounts) {
+  console.log(`    ${account.accountId}  ${account.status}`);
+}
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_get.ts

@@ -0,0 +1,91 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_GET
+// runnable bin for GET /api/shit-1170/swap-queue via middleman. the
+// middleman logs the framed request + response, so this bin only adds
+// a summary.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_get.ts \
+//     --api-key shit_1170_abc123... \
+//     --limit 50
+//
+// the filters:
+//   --account-id    only the swaps these accounts are on, comma separated
+//   --hide-sent     with the account, drop the ones it has already sent
+//   --token-in      only the swaps that sell this token
+//   --token-out     only the swaps that buy this token
+//   --limit         how many to return
+//   --cursor        where the page starts, default the first page
+//
+// --- WHY --- `--hide-sent` NEEDS `--account-id`: "has this account sent
+// it" is a question about ONE account, and the backend answers a 400
+// for the filter without one.
+//
+// --- WHY --- --cursor and not --offset: the page is walked by a cursor
+// the backend hands out, and the cursor is opaque. there is no offset
+// to ask for, and the bin prints the next cursor so the next page can
+// be fetched with it.
+// ========================================
+
+import { api_shit_1170_swap_queue_get } from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = ["--hide-sent"];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags, seen } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const limit_raw = flags.get("--limit");
+let limit: number | undefined;
+if (limit_raw !== undefined) {
+  const parsed = Number(limit_raw);
+  if (!Number.isFinite(parsed)) {
+    console.error(
+      `api_shit_1170_swap_queue_get: --limit must be a number: ${limit_raw}`,
+    );
+    process.exit(1);
+  }
+  limit = parsed;
+}
+
+const cursor = flags.get("--cursor");
+
+const list = await api_shit_1170_swap_queue_get(
+  base_url,
+  {
+    account_id: flags.get("--account-id"),
+    hide_sent: seen.has("--hide-sent"),
+    token_in: flags.get("--token-in"),
+    token_out: flags.get("--token-out"),
+    limit,
+    cursor,
+  },
+  { api_key: flags.get("--api-key") },
+);
+
+console.log(`SWAP QUEUE: ${list.items.length} of ${list.total}`);
+for (const swap of list.items) {
+  console.log(
+    `  ${swap.swapId}  ${swap.tokenIn} -> ${swap.tokenOut}  ` +
+      `in ${swap.amountIn}  out ${swap.amountOut ?? "(no quote)"}  ` +
+      `${swap.accounts.length} account(s)`,
+  );
+}
+console.log(`NEXT CURSOR: ${list.nextCursor ?? "(last page)"}`);
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_one_get.ts

@@ -0,0 +1,62 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_ONE_GET
+// runnable bin for GET /api/shit-1170/swap-queue/{swap_id} via
+// middleman. the middleman logs the framed request + response, so this
+// bin only adds a summary.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_one_get.ts \
+//     --api-key shit_1170_abc123... \
+//     --swap-id 8f14e45f-ceea-467a-9b0d-2b1c2e6c1a11
+// ========================================
+
+import { api_shit_1170_swap_queue_one_get } from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = [];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const swap_id = flags.get("--swap-id");
+if (swap_id === undefined) {
+  console.error(
+    "usage: api_shit_1170_swap_queue_one_get.ts [--base-url <url>] --api-key <key> --swap-id <id>",
+  );
+  process.exit(1);
+}
+
+const swap = await api_shit_1170_swap_queue_one_get(base_url, swap_id, {
+  api_key: flags.get("--api-key"),
+});
+
+console.log(`SWAP QUEUE ${swap.swapId}: ${swap.tokenIn} -> ${swap.tokenOut}`);
+console.log(`  what: ${swap.what ?? "(none)"}`);
+console.log(`  when: ${swap.when ?? "(none)"}`);
+console.log(`  why:  ${swap.why ?? "(none)"}`);
+console.log(`  amount in:  ${swap.amountIn}`);
+console.log(`  amount out: ${swap.amountOut ?? "(no quote)"}`);
+console.log(`  dex:        ${swap.dexId ?? "(none)"}`);
+for (const account of swap.accounts) {
+  console.log(
+    `    ${account.accountId}  ${account.status}  ${account.txHash ?? "(no hash)"}  ` +
+      `out ${account.amountOut ?? "(unknown)"}`,
+  );
+}
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_post.ts

@@ -0,0 +1,118 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_POST
+// runnable bin for POST /api/shit-1170/swap-queue via middleman. the
+// middleman logs the framed request + response, so this bin only adds
+// a summary.
+//
+// a queued swap is NOT a queued batch of transactions: the agent does
+// not know the route. it names the token in, the amount in and the token
+// out, and the route is worked out when the swap is executed.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_post.ts \
+//     --api-key shit_1170_abc123... \
+//     --token-in usdt.tether-token.near \
+//     --amount-in 100000000 \
+//     --token-out near \
+//     --what "swap 100 USDC for NEAR" \
+//     --why "you asked for it" \
+//     --account alice.near
+//
+// --- WHY --- the amount in is the RAW unit amount and not a human
+// amount: the chain and the router trade the token's smallest unit, and
+// a human amount only means something next to the token it belongs to.
+// ========================================
+
+import { api_shit_1170_swap_queue_post } from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = [];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const token_in = flags.get("--token-in");
+const amount_in = flags.get("--amount-in");
+const token_out = flags.get("--token-out");
+if (
+  token_in === undefined ||
+  amount_in === undefined ||
+  token_out === undefined
+) {
+  console.error(
+    "usage: api_shit_1170_swap_queue_post.ts [--base-url <url>] --api-key <key> " +
+      "--token-in <id> --amount-in <raw> --token-out <id> " +
+      "[--amount-out <raw>] [--dex-id <dex>] [--what <text>] [--when <text>] " +
+      "[--why <text>] [--when-at <ms>] [--account <account_id> ...]",
+  );
+  process.exit(1);
+}
+
+// the WHO — the accounts this swap is for. each one must be an account
+// the api key belongs to.
+const accounts: string[] = [];
+for (let i = 0; i < argv.length; i++) {
+  const token = argv[i];
+  if (token === undefined) continue;
+  const value = argv[i + 1];
+  if (value === undefined || value.startsWith("--")) continue;
+  if (token === "--account") {
+    accounts.push(value);
+    i++;
+  }
+}
+
+const when_at_raw = flags.get("--when-at");
+let when_at: number | undefined;
+if (when_at_raw !== undefined) {
+  const parsed = Number(when_at_raw);
+  if (!Number.isFinite(parsed)) {
+    console.error(
+      `api_shit_1170_swap_queue_post: --when-at must be a number of milliseconds: ${when_at_raw}`,
+    );
+    process.exit(1);
+  }
+  when_at = parsed;
+}
+
+const swap = await api_shit_1170_swap_queue_post(
+  base_url,
+  {
+    what: flags.get("--what"),
+    when: flags.get("--when"),
+    why: flags.get("--why"),
+    whenAt: when_at,
+    tokenIn: token_in,
+    amountIn: amount_in,
+    tokenOut: token_out,
+    amountOut: flags.get("--amount-out"),
+    dexId: flags.get("--dex-id"),
+    accounts: accounts.length > 0 ? accounts : undefined,
+  },
+  { api_key: flags.get("--api-key") },
+);
+
+console.log(
+  `SWAP QUEUE: ${swap.swapId}  ${swap.tokenIn} -> ${swap.tokenOut}  ` +
+    `amount in ${swap.amountIn}, amount out ${swap.amountOut ?? "(no quote)"}`,
+);
+console.log(
+  `  accounts: ${swap.accounts.map((one) => one.accountId).join(", ") || "(none)"}`,
+);
+// ========================================
+// copyright 2026 by sleet.near

package/bin/shit-1170/api_shit_1170_swap_queue_sent_post.ts

@@ -0,0 +1,87 @@
+// ========================================
+// API_SHIT_1170_SWAP_QUEUE_SENT_POST
+// runnable bin for POST /api/shit-1170/swap-queue/{swap_id}/sent via
+// middleman. the middleman logs the framed request + response, so this
+// bin only adds a summary.
+//
+// THIS is the route the swap page calls after it executes a queued swap,
+// so the swap's status moves from `pending` to `sent` to `succeeded` or
+// `failed`.
+//
+//   bun middleman/bin/shit-1170/api_shit_1170_swap_queue_sent_post.ts \
+//     --api-key shit_1170_abc123... \
+//     --swap-id 8f14e45f-ceea-467a-9b0d-2b1c2e6c1a11 \
+//     --tx-hash 9t6w... \
+//     --status succeeded \
+//     --amount-out 4999000000000000000000000
+//
+// --- WHY --- the status is OPTIONAL: without it the status is `sent`,
+// which means "it went out and nobody knows how it went yet".
+// ========================================
+
+import { api_shit_1170_swap_queue_sent_post } from "@huggies/shit-1170-rex-engine-middleman";
+import { resolve_base_url } from "../fun/resolve_base_url";
+import { split_argv } from "../fun/split_argv";
+
+// --- CONFIG --------------------------------------------------------
+// used when no argv is supplied. the default is the local backend,
+// which binds 0.0.0.0:54733 (see shit_1170_port_fun.rs).
+const DEFAULT_BASE_URL = "http://127.0.0.1:54733";
+
+// the flags of this bin that take no value.
+const BOOLEAN_FLAGS: string[] = [];
+
+// --- argv ----------------------------------------------------------
+// argv[0] is bun, argv[1] is this script, so real args start at 2.
+const argv = process.argv.slice(2);
+
+const { flags } = split_argv(argv, { boolean_flags: BOOLEAN_FLAGS });
+
+// --- WHY --- the base url is resolved from the raw argv rather than
+// the split result: split_argv would put --base-url in the flags map,
+// and reading the raw argv keeps one rule for the url: it is never a
+// positional.
+const base_url = resolve_base_url(argv, DEFAULT_BASE_URL);
+
+const swap_id = flags.get("--swap-id");
+const tx_hash = flags.get("--tx-hash");
+if (swap_id === undefined || tx_hash === undefined) {
+  console.error(
+    "usage: api_shit_1170_swap_queue_sent_post.ts [--base-url <url>] " +
+      "--api-key <key> --swap-id <id> --tx-hash <hash> " +
+      "[--status succeeded|failed] [--amount-out <raw>]",
+  );
+  process.exit(1);
+}
+
+// --- WHY --- the status is CHECKED here: the backend refuses anything
+// but `succeeded` and `failed`, and a 400 says less than naming the
+// word that is wrong.
+const status = flags.get("--status");
+if (status !== undefined && status !== "succeeded" && status !== "failed") {
+  console.error(
+    `api_shit_1170_swap_queue_sent_post: --status must be succeeded or failed, not ${status}`,
+  );
+  process.exit(1);
+}
+
+const swap = await api_shit_1170_swap_queue_sent_post(
+  base_url,
+  swap_id,
+  {
+    txHash: tx_hash,
+    status,
+    amountOut: flags.get("--amount-out"),
+  },
+  { api_key: flags.get("--api-key") },
+);
+
+console.log(`SWAP QUEUE ${swap.swapId}: ${swap.accounts.length} account(s)`);
+for (const account of swap.accounts) {
+  console.log(
+    `    ${account.accountId}  ${account.status}  ${account.txHash ?? "(no hash)"}  ` +
+      `out ${account.amountOut ?? "(unknown)"}`,
+  );
+}
+// ========================================
+// copyright 2026 by sleet.near