@ar.io/sdk 3.24.0 → 4.0.0-solana.3

package/README.md

@@ -48,6 +48,22 @@ const ario = ARIO.mainnet(); // defaults to mainnet
 const gateways = await ario.getGateways();
 ```
 
+> **Solana backend (preview)** — `npm install @ar.io/sdk@solana`
+> ships the Solana port. Same `ARIO`/`ANT` API surface, kit-native:
+>
+> ```ts
+> import { ARIO } from '@ar.io/sdk/solana';
+> import { createSolanaRpc } from '@solana/kit';
+>
+> const ario = ARIO.init({
+>   backend: 'solana',
+>   rpc: createSolanaRpc('https://api.mainnet-beta.solana.com'),
+> });
+> ```
+>
+> See the **[Solana backend](#solana-backend)** section below for the
+> full kit-native usage (read + write paths, ANT spawn, escrow, etc.).
+
 <details>
   <summary>Output</summary>
 
@@ -3170,6 +3186,132 @@ In the example above, the query will return ArNS records where:
 - The type is "lease" AND
 - The processId is EITHER "ZkgLfyHALs5koxzojpcsEFAKA8fbpzP7l-tbM7wmQNM" OR "r61rbOjyXx3u644nGl9bkwLWlWmArMEzQgxBo2R-Vu0"
 
+## Solana backend
+
+The Solana backend ports the ARIO/ANT API surface to Solana. Same
+`ARIO.init`/`ANT.init` factory calls — pass `backend: 'solana'` plus a
+`@solana/kit` RPC client and you get the kit-native implementation.
+
+### Quick start
+
+```ts
+import { ARIO, ANT } from '@ar.io/sdk/solana';
+import {
+  createSolanaRpc,
+  createSolanaRpcSubscriptions,
+  createKeyPairSignerFromBytes,
+} from '@solana/kit';
+import { readFileSync } from 'node:fs';
+
+// Read-only client (RPC only)
+const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
+const ario = ARIO.init({ backend: 'solana', rpc });
+
+const record = await ario.getArNSRecord({ name: 'ardrive' });
+//   record.processId === '<the ANT mint pubkey>'
+
+// Write client — pair an RPC + a signer
+const signerBytes = new Uint8Array(
+  JSON.parse(readFileSync('/path/to/keypair.json', 'utf8')),
+);
+const signer = await createKeyPairSignerFromBytes(signerBytes);
+const rpcSubs = createSolanaRpcSubscriptions(
+  'wss://api.mainnet-beta.solana.com',
+);
+
+const arioWrite = ARIO.init({
+  backend: 'solana',
+  rpc,
+  rpcSubscriptions: rpcSubs,
+  signer,
+});
+
+await arioWrite.buyRecord({
+  name: 'foo',
+  type: 'lease',
+  years: 1,
+  processId: '<ANT mint pubkey>',
+});
+```
+
+### What's available
+
+The Solana backend implements the full `AoARIOWrite` and `AoANTWrite`
+interfaces — every method on the AO-backed clients has a Solana
+equivalent. Read paths (`getArNSRecord`, `getGateway`,
+`getEpochSettings`, etc.) and write paths (`buyRecord`, `extendLease`,
+`upgradeRecord`, `joinNetwork`, `delegateStake`, `decreaseDelegateStake`,
+`createVault`, `transferAnt`, `setRecord`, etc.) all work against the
+on-chain AR.IO programs deployed on Solana.
+
+Multi-source funding works the same way as Lua's `getFundingPlan`:
+pass `fundFrom: 'any'` and the SDK composes a plan across balance,
+matured withdrawal vaults, excess delegated stake, and minimum stake
+across multiple gateways. See the planner at
+`src/solana/funding-plan.ts` for the Lua-faithful drawdown order.
+
+### ANT lifecycle
+
+ANTs on Solana are Metaplex Core NFTs with an Attributes plugin
+carrying ArNS traits (`ArNS Name`, `Type`, `Undername Limit`,
+`ANT Program`). Spawn a fresh one:
+
+```ts
+import { ANT, spawnSolanaANT } from '@ar.io/sdk/solana';
+
+const { processId } = await spawnSolanaANT({
+  rpc, rpcSubscriptions: rpcSubs, signer,
+  state: {
+    name: 'My ANT',
+    ticker: 'MYANT',
+    description: 'whatever',
+    uri: 'ar://placeholder-metadata',
+  },
+});
+
+const ant = await ANT.init({
+  backend: 'solana',
+  processId,           // the Metaplex Core asset pubkey
+  rpc, rpcSubscriptions: rpcSubs, signer,
+});
+await ant.setBaseNameRecord({ transactionId: '...', ttlSeconds: 3600 });
+await ant.addController({ controller: '<some-pubkey>' });
+```
+
+The asset's Attributes plugin tracks which ANT program (the canonical
+`ARIO_ANT_PROGRAM_ID` or a third-party-conformant program — see
+ADR-016) holds the records. The SDK reads the plugin to derive the
+correct `AntRecord` PDA on every record lookup.
+
+### Conditional imports
+
+The `@ar.io/sdk/solana` subpath bundles Solana-only deps (`@solana/kit`,
+`@solana-program/compute-budget`, etc.). The default `@ar.io/sdk` /
+`@ar.io/sdk/node` / `@ar.io/sdk/web` entries stay AO-only — bundle size
+is unchanged for AO-only consumers.
+
+You can also import the codama-emitted typed clients directly for
+custom transaction building:
+
+```ts
+import {
+  getBuyNameInstructionAsync,
+  ARIO_ARNS_PROGRAM_ADDRESS,
+} from '@ar.io/sdk/solana/generated';
+```
+
+### Networks
+
+| Network | RPC | Programs |
+|---|---|---|
+| Mainnet | not yet deployed | TBD |
+| Devnet | `https://api.devnet.solana.com` | See `src/solana/constants.ts` for current devnet program IDs |
+| Localnet | Surfpool — `https://github.com/solana-foundation/surfpool` | Localnet harness in `solana-ar-io` monorepo |
+
+The migration tooling (snapshot exporter, batch importer, claim app)
+lives in the [`solana-ar-io`](https://github.com/ar-io/solana-ar-io)
+monorepo until cutover.
+
 ## Resources
 
 ### Bundling

package/lib/cjs/cli/cli.js

@@ -1,5 +1,38 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
@@ -23,6 +56,7 @@ const token_js_1 = require("../types/token.js");
 const version_js_1 = require("../version.js");
 const antCommands_js_1 = require("./commands/antCommands.js");
 const arnsPurchaseCommands_js_1 = require("./commands/arnsPurchaseCommands.js");
+const escrowCommands_js_1 = require("./commands/escrowCommands.js");
 const gatewayWriteCommands_js_1 = require("./commands/gatewayWriteCommands.js");
 const readCommands_js_1 = require("./commands/readCommands.js");
 const transfer_js_1 = require("./commands/transfer.js");
@@ -413,7 +447,12 @@ const utils_js_1 = require("./utils.js");
     options: options_js_1.buyRecordOptions,
     action: arnsPurchaseCommands_js_1.buyRecordCLICommand,
 });
-// TODO alias buy-record with buy-name
+(0, utils_js_1.makeCommand)({
+    name: 'buy-name',
+    description: 'Buy a name (alias for buy-record)',
+    options: options_js_1.buyRecordOptions,
+    action: arnsPurchaseCommands_js_1.buyRecordCLICommand,
+});
 (0, utils_js_1.makeCommand)({
     name: 'upgrade-record',
     description: 'Upgrade the lease of a record to a permabuy',
@@ -432,6 +471,14 @@ const utils_js_1 = require("./utils.js");
     options: [...options_js_1.arnsPurchaseOptions, options_js_1.optionMap.increaseCount],
     action: arnsPurchaseCommands_js_1.increaseUndernameLimitCLICommand,
 });
+(0, utils_js_1.makeCommand)({
+    name: 'sync-attributes',
+    description: 'Sync the on-chain ANT Attributes plugin (ArNS Name / Type / Undername Limit) ' +
+        'with the current ArnsRecord. Solana-only; permissionless reconciliation. ' +
+        'Use after a buy/reassign where the buyer was not the ANT NFT holder.',
+    options: options_js_1.arnsPurchaseOptions,
+    action: arnsPurchaseCommands_js_1.syncAttributesCLICommand,
+});
 (0, utils_js_1.makeCommand)({
     name: 'request-primary-name',
     description: 'Request a primary name',
@@ -458,7 +505,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the state of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getState();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getState();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -466,7 +513,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the info of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getInfo();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getInfo();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -474,7 +521,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get a record of an ANT process',
     options: [options_js_1.optionMap.processId, options_js_1.optionMap.undername],
     action: async (options) => {
-        return ((await (0, utils_js_1.readANTFromOptions)(options).getRecord({
+        return ((await (await (0, utils_js_1.readANTFromOptions)(options)).getRecord({
             undername: (0, utils_js_1.requiredStringFromOptions)(options, 'undername'),
         })) ?? { message: 'No record found' });
     },
@@ -484,7 +531,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the owner of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getOwner();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getOwner();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -492,7 +539,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the name of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getName();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getName();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -500,7 +547,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the ticker of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getTicker();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getTicker();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -508,7 +555,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the logo of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getLogo();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getLogo();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -516,7 +563,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the balance of an ANT process',
     options: [options_js_1.optionMap.processId, options_js_1.optionMap.address],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getBalance({
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getBalance({
             address: (0, utils_js_1.requiredAddressFromOptions)(options),
         });
     },
@@ -527,17 +574,32 @@ const utils_js_1 = require("./utils.js");
     description: 'Spawn an ANT process',
     options: options_js_1.antStateOptions,
     action: async (options) => {
-        const state = (0, utils_js_1.getANTStateFromOptions)(options);
-        const antProcessId = await (0, index_js_1.spawnANT)({
-            state,
-            signer: (0, utils_js_1.requiredAoSignerFromOptions)(options),
-            logger: (0, utils_js_1.getLoggerFromOptions)(options),
-            ...(options.module !== undefined ? { module: options.module } : {}),
-        });
+        if (options.ao) {
+            const state = (0, utils_js_1.getANTStateFromOptions)(options);
+            const antProcessId = await (0, index_js_1.spawnANT)({
+                state,
+                signer: (0, utils_js_1.requiredAoSignerFromOptions)(options),
+                logger: (0, utils_js_1.getLoggerFromOptions)(options),
+                ...(options.module !== undefined ? { module: options.module } : {}),
+            });
+            return {
+                processId: antProcessId,
+                signature: null,
+                state,
+                message: `Spawned ANT process with process ID ${antProcessId}`,
+            };
+        }
+        // Solana branch: the signer's pubkey IS the owner — no separate
+        // `--address` is needed (or possible, since the address would be the
+        // signer's pubkey anyway). We pass the raw CLI options through and let
+        // `spawnSolanaANTFromOptions` build the InitializeAntParams payload.
+        const { spawnSolanaANTFromOptions } = await Promise.resolve().then(() => __importStar(require('./utils.js')));
+        const result = await spawnSolanaANTFromOptions(options);
         return {
-            processId: antProcessId,
-            state,
-            message: `Spawned ANT process with process ID ${antProcessId}`,
+            processId: result.processId,
+            signature: result.signature,
+            state: null,
+            message: `Spawned Solana ANT (mint=${result.processId})`,
         };
     },
 });
@@ -547,7 +609,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the records of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getRecords();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getRecords();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -555,7 +617,7 @@ const utils_js_1 = require("./utils.js");
     description: 'List the controllers of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getControllers();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getControllers();
     },
 });
 (0, utils_js_1.makeCommand)({
@@ -563,7 +625,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Get the balances of an ANT process',
     options: [options_js_1.optionMap.processId],
     action: async (options) => {
-        return (0, utils_js_1.readANTFromOptions)(options).getBalances();
+        return (await (0, utils_js_1.readANTFromOptions)(options)).getBalances();
     },
 });
 // # Actions
@@ -582,7 +644,7 @@ const utils_js_1 = require("./utils.js");
             ? options.removeControllers
             : true;
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to transfer ANT ownership to ${target}${removeControllers ? ' (controllers will be removed)' : ' (controllers will be retained)'}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).transfer({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).transfer({
             target,
             removeControllers,
         }, (0, utils_js_1.customTagsFromOptions)(options));
@@ -595,7 +657,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const controller = (0, utils_js_1.requiredStringFromOptions)(options, 'controller');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to add ${controller} as a controller?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).addController({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).addController({
             controller: (0, utils_js_1.requiredStringFromOptions)(options, 'controller'),
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -605,7 +667,7 @@ const utils_js_1 = require("./utils.js");
     description: 'Remove a controller from an ANT process',
     options: [options_js_1.optionMap.processId, options_js_1.optionMap.controller, ...options_js_1.writeActionOptions],
     action: async (options) => {
-        return (0, utils_js_1.writeANTFromOptions)(options).removeController({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).removeController({
             controller: (0, utils_js_1.requiredStringFromOptions)(options, 'controller'),
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -617,7 +679,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const undername = (0, utils_js_1.requiredStringFromOptions)(options, 'undername');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to remove the record with undername ${undername}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).removeRecord({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).removeRecord({
             undername,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -659,7 +721,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const ticker = (0, utils_js_1.requiredStringFromOptions)(options, 'ticker');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the ticker to ${ticker}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setTicker({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).setTicker({
             ticker,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -671,7 +733,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const name = (0, utils_js_1.requiredStringFromOptions)(options, 'name');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the name to ${(0, utils_js_1.requiredStringFromOptions)(options, 'name')}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setName({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).setName({
             name,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -683,7 +745,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const description = (0, utils_js_1.requiredStringFromOptions)(options, 'description');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the ANT description to ${description}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setDescription({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).setDescription({
             description,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -695,7 +757,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const keywords = (0, utils_js_1.requiredStringArrayFromOptions)(options, 'keywords');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the ANT keywords to ${keywords}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setKeywords({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).setKeywords({
             keywords,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -711,7 +773,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const txId = (0, utils_js_1.requiredStringFromOptions)(options, 'transactionId');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the ANT logo to target Arweave TxID ${txId}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setLogo({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).setLogo({
             txId,
         }, (0, utils_js_1.customTagsFromOptions)(options));
     },
@@ -724,7 +786,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const name = (0, utils_js_1.requiredStringFromOptions)(options, 'name');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to release the name ${name} back to the protocol?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).releaseName({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).releaseName({
             name,
             arioProcessId: (0, utils_js_1.arioProcessIdFromOptions)(options),
         }, (0, utils_js_1.customTagsFromOptions)(options));
@@ -743,7 +805,7 @@ const utils_js_1 = require("./utils.js");
         const targetProcess = (0, utils_js_1.requiredStringFromOptions)(options, 'target');
         const name = (0, utils_js_1.requiredStringFromOptions)(options, 'name');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to reassign the name ${name} to ANT process ${targetProcess}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).reassignName({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).reassignName({
             name,
             arioProcessId: (0, utils_js_1.arioProcessIdFromOptions)(options),
             antProcessId: targetProcess,
@@ -763,7 +825,7 @@ const utils_js_1 = require("./utils.js");
         const address = (0, utils_js_1.requiredAddressFromOptions)(options);
         const name = (0, utils_js_1.requiredStringFromOptions)(options, 'name');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to approve the primary name request ${name} to ${address}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).approvePrimaryNameRequest({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).approvePrimaryNameRequest({
             name,
             address,
             arioProcessId: (0, utils_js_1.arioProcessIdFromOptions)(options),
@@ -777,7 +839,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const names = (0, utils_js_1.requiredStringArrayFromOptions)(options, 'names');
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to remove the primary names ${names}?`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).removePrimaryNames({
+        return (await (0, utils_js_1.writeANTFromOptions)(options)).removePrimaryNames({
             names,
             arioProcessId: (0, utils_js_1.arioProcessIdFromOptions)(options),
         }, (0, utils_js_1.customTagsFromOptions)(options));
@@ -813,10 +875,69 @@ const utils_js_1 = require("./utils.js");
         });
     },
 });
-// Normalize separators so includes() works on Windows (argv uses backslashes).
-const argvScript = process.argv[1].replace(/\\/g, '/');
-if (argvScript.includes('bin/ar.io') || // Running from global .bin
-    argvScript.includes('cli/cli') // Running from source
+// =========================================
+// ANT Escrow commands (`ario-ant-escrow` program — Solana-only)
+// =========================================
+// `optionMap.rpcUrl`, `walletFile`, and `privateKey` are already in
+// `globalOptions` and are merged in by `makeCommand` for every command — re-listing
+// them here would re-register the flags and crash Commander with
+// "due to conflicting flag '--rpc-url'" at CLI startup.
+const escrowCommonOptions = [options_js_1.optionMap.escrowProgramId, options_js_1.optionMap.ant];
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-status',
+    description: 'Read the on-chain EscrowAnt PDA for an ANT mint (no signer needed).',
+    options: [options_js_1.optionMap.escrowProgramId, options_js_1.optionMap.ant],
+    action: escrowCommands_js_1.escrowStatusCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-deposit',
+    description: 'Lock an ANT into the trustless escrow program. Use --recipient-arweave <jwk> or --recipient-ethereum <0x...>.',
+    options: [
+        ...escrowCommonOptions,
+        options_js_1.optionMap.recipientArweave,
+        options_js_1.optionMap.recipientEthereum,
+    ],
+    action: escrowCommands_js_1.escrowDepositCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-cancel',
+    description: 'Pull an escrowed ANT back to the depositor. Closes the escrow PDA and refunds rent.',
+    options: escrowCommonOptions,
+    action: escrowCommands_js_1.escrowCancelCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-update-recipient',
+    description: 'Re-target an active escrow at a different Arweave/Ethereum identity. Rotates the on-chain nonce.',
+    options: [
+        ...escrowCommonOptions,
+        options_js_1.optionMap.newRecipientArweave,
+        options_js_1.optionMap.newRecipientEthereum,
+    ],
+    action: escrowCommands_js_1.escrowUpdateRecipientCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-claim-arweave',
+    description: 'Submit an Arweave RSA-PSS-4096 signature to release the ANT. Anyone can submit; only the named claimant receives.',
+    options: [
+        ...escrowCommonOptions,
+        options_js_1.optionMap.signatureFile,
+        options_js_1.optionMap.saltLen,
+        options_js_1.optionMap.claimant,
+    ],
+    action: escrowCommands_js_1.escrowClaimArweaveCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'escrow-claim-ethereum',
+    description: 'Submit an Ethereum ECDSA personal_sign signature (65 bytes r||s||v) to release the ANT.',
+    options: [
+        ...escrowCommonOptions,
+        options_js_1.optionMap.signatureFile,
+        options_js_1.optionMap.claimant,
+    ],
+    action: escrowCommands_js_1.escrowClaimEthereumCLICommand,
+});
+if (process.argv[1].includes('bin/ar.io') || // Running from global .bin
+    process.argv[1].includes('cli/cli') // Running from source
 ) {
     commander_1.program.parse(process.argv);
 }