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

package/lib/cjs/cli/commands/antCommands.js

@@ -6,76 +6,103 @@ exports.setAntUndernameCLICommand = setAntUndernameCLICommand;
 exports.transferRecordOwnershipCLICommand = transferRecordOwnershipCLICommand;
 exports.upgradeAntCLICommand = upgradeAntCLICommand;
 const utils_js_1 = require("../utils.js");
+function targetProtocolFromOptions(o) {
+    const raw = o.targetProtocol;
+    if (!raw || raw === 'arweave')
+        return 0;
+    if (raw === 'ipfs')
+        return 1;
+    throw new Error(`Invalid --target-protocol "${raw}". Must be "arweave" or "ipfs".`);
+}
 /** @deprecated -- use set-ant-base-name and set-ant-undername */
 async function setAntRecordCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
     const undername = (0, utils_js_1.requiredStringFromOptions)(o, 'undername');
     const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
-    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    const targetProtocol = targetProtocolFromOptions(o);
+    const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
     const recordParams = {
         undername,
         transactionId,
         ttlSeconds,
+        targetProtocol,
         ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
     };
     if (!o.skipConfirmation) {
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this record on the ANT process ${writeAnt.processId}?\n${JSON.stringify(recordParams, null, 2)}`, o);
     }
-    return (0, utils_js_1.writeANTFromOptions)(o).setRecord(recordParams, (0, utils_js_1.customTagsFromOptions)(o));
+    return (await (0, utils_js_1.writeANTFromOptions)(o)).setRecord(recordParams, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function setAntBaseNameCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
     const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
+    const targetProtocol = targetProtocolFromOptions(o);
     const params = {
         transactionId,
         ttlSeconds,
+        targetProtocol,
         ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
     };
-    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
     if (!o.skipConfirmation) {
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this base name on the ANT process ${writeAnt.processId}?\n${JSON.stringify(params, null, 2)}`, o);
     }
-    return (0, utils_js_1.writeANTFromOptions)(o).setBaseNameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
+    return (await (0, utils_js_1.writeANTFromOptions)(o)).setBaseNameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function setAntUndernameCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
     const undername = (0, utils_js_1.requiredStringFromOptions)(o, 'undername');
     const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
+    const targetProtocol = targetProtocolFromOptions(o);
     const params = {
         undername,
         transactionId,
         ttlSeconds,
+        targetProtocol,
         ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
     };
-    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
     if (!o.skipConfirmation) {
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this undername on the ANT process ${writeAnt.processId}?\n${JSON.stringify(params, null, 2)}`, o);
     }
-    return (0, utils_js_1.writeANTFromOptions)(o).setUndernameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
+    return (await (0, utils_js_1.writeANTFromOptions)(o)).setUndernameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function transferRecordOwnershipCLICommand(o) {
     const undername = (0, utils_js_1.requiredStringFromOptions)(o, 'undername');
     const recipient = (0, utils_js_1.requiredStringFromOptions)(o, 'recipient');
-    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
     if (!o.skipConfirmation) {
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to transfer ownership of "${undername}" to "${recipient}" on ANT process ${writeAnt.processId}?\n${JSON.stringify({ undername, recipient }, null, 2)}`, o);
     }
-    return (0, utils_js_1.writeANTFromOptions)(o).transferRecord({ undername, recipient }, (0, utils_js_1.customTagsFromOptions)(o));
+    return (await (0, utils_js_1.writeANTFromOptions)(o)).transferRecord({ undername, recipient }, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function upgradeAntCLICommand(o) {
-    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    // Solana: simple per-ANT schema migration (no forking, no name reassignment)
+    if (!o.ao) {
+        const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
+        if (!o.skipConfirmation) {
+            await (0, utils_js_1.assertConfirmationPrompt)(`Migrate ANT to latest schema version?\n` +
+                `ANT: ${writeAnt.processId}`, o);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const result = await writeAnt.upgrade();
+        if (!result.needsMigration) {
+            return { message: 'ANT is already at the latest version' };
+        }
+        return { message: 'ANT migrated successfully', txId: String(result.id) };
+    }
+    // AO: fork process and reassign names
+    const writeAnt = await (0, utils_js_1.writeANTFromOptions)(o);
     const arioProcessId = (0, utils_js_1.arioProcessIdFromOptions)(o);
     const ario = (0, utils_js_1.readARIOFromOptions)(o);
     const reassignAffiliatedNames = (0, utils_js_1.booleanFromOptions)(o, 'reassignAffiliatedNames');
     const names = (0, utils_js_1.stringArrayFromOptions)(o, 'names') || [];
     if (reassignAffiliatedNames) {
-        // Fetch all ArNS records that point to this ANT process
         const allRecords = await ario.getArNSRecords({
             filters: {
                 processId: writeAnt.processId,
             },
         });
-        // Filter records that belong to this ANT
         const affiliatedNames = allRecords.items.map((record) => record.name);
         names.push(...affiliatedNames);
     }
@@ -89,15 +116,14 @@ async function upgradeAntCLICommand(o) {
             `Names that will be reassigned (${names.length}): ${names.join(', ')}`, o);
     }
     const result = reassignAffiliatedNames
-        ? await (0, utils_js_1.writeANTFromOptions)(o).upgrade({
+        ? await (await (0, utils_js_1.writeANTFromOptions)(o)).upgrade({
             reassignAffiliatedNames,
             arioProcessId,
         })
-        : await (0, utils_js_1.writeANTFromOptions)(o).upgrade({
+        : await (await (0, utils_js_1.writeANTFromOptions)(o)).upgrade({
             names,
             arioProcessId,
         });
-    // Serialize error objects for JSON compatibility
     const serializedFailedReassignedNames = {};
     for (const [name, failure] of Object.entries(result.failedReassignedNames)) {
         serializedFailedReassignedNames[name] = {

package/lib/cjs/cli/commands/arnsPurchaseCommands.js

@@ -6,6 +6,7 @@ exports.extendLeaseCLICommand = extendLeaseCLICommand;
 exports.increaseUndernameLimitCLICommand = increaseUndernameLimitCLICommand;
 exports.requestPrimaryNameCLICommand = requestPrimaryNameCLICommand;
 exports.setPrimaryNameCLICommand = setPrimaryNameCLICommand;
+exports.syncAttributesCLICommand = syncAttributesCLICommand;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -23,8 +24,18 @@ exports.setPrimaryNameCLICommand = setPrimaryNameCLICommand;
  */
 const ant_js_1 = require("../../common/ant.js");
 const utils_js_1 = require("../utils.js");
+/** Coerce the JSON-parsed funding plan to the typed `FundingSourceSpec[]`. */
+function coerceFundingPlanSources(parsed) {
+    if (!parsed)
+        return undefined;
+    return parsed.map((s) => ({
+        kind: s.kind,
+        amount: s.amount,
+        ...(s.gateway ? { gateway: s.gateway } : {}),
+    }));
+}
 async function buyRecordCLICommand(o) {
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
     const type = (0, utils_js_1.recordTypeFromOptions)(o);
     const years = (0, utils_js_1.positiveIntegerFromOptions)(o, 'years');
@@ -64,13 +75,17 @@ async function buyRecordCLICommand(o) {
         type,
         years,
         fundFrom: (0, utils_js_1.fundFromFromOptions)(o),
+        gatewayAddress: o.gatewayAddress,
+        fundAsOperator: o.fundAsOperator,
+        withdrawalId: (0, utils_js_1.withdrawalIdFromOptions)(o),
+        sources: coerceFundingPlanSources((0, utils_js_1.fundingPlanFromOptions)(o)),
         paidBy: (0, utils_js_1.stringArrayFromOptions)(o, 'paidBy'),
         referrer,
     }, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function upgradeRecordCLICommand(o) {
     const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
     if (!o.skipConfirmation) {
@@ -98,6 +113,8 @@ async function upgradeRecordCLICommand(o) {
     return ario.upgradeRecord({
         name,
         fundFrom,
+        gatewayAddress: o.gatewayAddress,
+        fundAsOperator: o.fundAsOperator,
         paidBy: (0, utils_js_1.stringArrayFromOptions)(o, 'paidBy'),
         referrer,
     });
@@ -107,7 +124,7 @@ async function extendLeaseCLICommand(o) {
     const years = (0, utils_js_1.requiredPositiveIntegerFromOptions)(o, 'years');
     const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     if (!o.skipConfirmation) {
         const existingRecord = await ario.getArNSRecord({
             name,
@@ -134,6 +151,9 @@ async function extendLeaseCLICommand(o) {
     return ario.extendLease({
         name,
         years,
+        fundFrom,
+        gatewayAddress: o.gatewayAddress,
+        fundAsOperator: o.fundAsOperator,
         paidBy: (0, utils_js_1.stringArrayFromOptions)(o, 'paidBy'),
         referrer,
     }, (0, utils_js_1.customTagsFromOptions)(o));
@@ -143,7 +163,7 @@ async function increaseUndernameLimitCLICommand(o) {
     const increaseCount = (0, utils_js_1.requiredPositiveIntegerFromOptions)(o, 'increaseCount');
     const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     if (!o.skipConfirmation) {
         const existingRecord = await ario.getArNSRecord({
             name,
@@ -167,12 +187,15 @@ async function increaseUndernameLimitCLICommand(o) {
     return ario.increaseUndernameLimit({
         name,
         increaseCount,
+        fundFrom,
+        gatewayAddress: o.gatewayAddress,
+        fundAsOperator: o.fundAsOperator,
         paidBy: (0, utils_js_1.stringArrayFromOptions)(o, 'paidBy'),
         referrer,
     }, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function requestPrimaryNameCLICommand(o) {
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
     const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
@@ -201,7 +224,7 @@ async function requestPrimaryNameCLICommand(o) {
     return result.request;
 }
 async function setPrimaryNameCLICommand(o) {
-    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const { ario, signerAddress } = await (0, utils_js_1.writeARIOFromOptions)(o);
     const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
     const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
@@ -210,3 +233,20 @@ async function setPrimaryNameCLICommand(o) {
     }
     return ario.setPrimaryName({ name, fundFrom, referrer });
 }
+/**
+ * Reconcile the on-chain ANT Attributes plugin (`ArNS Name`, `Type`,
+ * `Undername Limit`) with the current `ArnsRecord` state. Permissionless,
+ * Solana-only; AO backend will throw with a clear error.
+ *
+ * Use after a `buy-record` / `reassign-name` where the buyer/recipient was
+ * not the ANT NFT holder (the ANT-side trait CPI gets skipped at runtime
+ * in that case so the plugin stays empty until the actual holder reconciles).
+ */
+async function syncAttributesCLICommand(o) {
+    const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
+    const { ario } = await (0, utils_js_1.writeARIOFromOptions)(o);
+    if (!o.skipConfirmation) {
+        await (0, utils_js_1.assertConfirmationPrompt)(`Sync on-chain ANT traits for "${name}" to match the current ArnsRecord?`, o);
+    }
+    return ario.syncAttributes({ name });
+}

package/lib/cjs/cli/commands/escrowCommands.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * CLI commands for `ario-ant-escrow` — trustless multi-protocol ANT custody.
+ *
+ * Each command instantiates an {@link ANTEscrow} with options-driven RPC +
+ * signer wiring (mirrors the rest of the Solana CLI surface — see
+ * `arnsPurchaseCommands.ts`). All read commands work without a signer; all
+ * write commands require `--wallet-file` or `--private-key`.
+ *
+ * Recipient pubkey loading:
+ * - Arweave: `--recipient-arweave <jwk-file>` reads the JWK JSON, decodes
+ *   the base64url `n` field to 512 raw bytes (RSA-4096 modulus).
+ * - Ethereum: `--recipient-ethereum 0x...` parses the 20-byte hex address.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escrowStatusCLICommand = escrowStatusCLICommand;
+exports.escrowDepositCLICommand = escrowDepositCLICommand;
+exports.escrowCancelCLICommand = escrowCancelCLICommand;
+exports.escrowUpdateRecipientCLICommand = escrowUpdateRecipientCLICommand;
+exports.escrowClaimArweaveCLICommand = escrowClaimArweaveCLICommand;
+exports.escrowClaimEthereumCLICommand = escrowClaimEthereumCLICommand;
+const node_fs_1 = require("node:fs");
+const kit_1 = require("@solana/kit");
+const bs58_1 = __importDefault(require("bs58"));
+const constants_js_1 = require("../../solana/constants.js");
+const escrow_js_1 = require("../../solana/escrow.js");
+// =========================================
+// Wiring helpers
+// =========================================
+function wsUrlFromRpcUrl(rpcUrl) {
+    return rpcUrl.replace(/^http/, 'ws');
+}
+function escrowProgramIdFrom(options) {
+    return options.escrowProgramId
+        ? (0, kit_1.address)(options.escrowProgramId)
+        : constants_js_1.ARIO_ANT_ESCROW_PROGRAM_ID;
+}
+async function readEscrowReader(options) {
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    return escrow_js_1.ANTEscrow.init({
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        programId: escrowProgramIdFrom(options),
+    });
+}
+async function writeEscrowFromOptions(options) {
+    let secretKey;
+    if (options.privateKey) {
+        secretKey = bs58_1.default.decode(options.privateKey);
+    }
+    else if (options.walletFile) {
+        const raw = (0, node_fs_1.readFileSync)(options.walletFile, 'utf-8');
+        secretKey = new Uint8Array(JSON.parse(raw));
+    }
+    else {
+        throw new Error('escrow write operations require a signer. Provide --wallet-file <path> or --private-key <base58>');
+    }
+    const signer = await (0, kit_1.createKeyPairSignerFromBytes)(secretKey);
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    return escrow_js_1.ANTEscrow.init({
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        rpcSubscriptions: (0, kit_1.createSolanaRpcSubscriptions)(wsUrlFromRpcUrl(rpcUrl)),
+        signer,
+        programId: escrowProgramIdFrom(options),
+    });
+}
+// =========================================
+// Recipient pubkey parsing
+// =========================================
+function base64UrlDecode(s) {
+    // Convert base64url → base64, then decode.
+    let b64 = s.replace(/-/g, '+').replace(/_/g, '/');
+    while (b64.length % 4 !== 0)
+        b64 += '=';
+    return new Uint8Array(Buffer.from(b64, 'base64'));
+}
+/** Load an Arweave RSA-4096 modulus from a JWK file (`.json` with `n` field). */
+function loadArweaveModulusFromJwk(filePath) {
+    const raw = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+    const jwk = JSON.parse(raw);
+    if (jwk.kty !== 'RSA' || !jwk.n) {
+        throw new Error(`Not a valid Arweave RSA JWK (missing kty=RSA or n field)`);
+    }
+    const modulus = base64UrlDecode(jwk.n);
+    if (modulus.length !== 512) {
+        throw new Error(`Arweave modulus must be 512 bytes (4096-bit RSA); got ${modulus.length}`);
+    }
+    return modulus;
+}
+/** Parse an Ethereum address (`0xabc...`) into 20 raw bytes. */
+function parseEthereumAddress(hex) {
+    const cleaned = hex.startsWith('0x') ? hex.slice(2) : hex;
+    if (cleaned.length !== 40 || !/^[0-9a-fA-F]+$/.test(cleaned)) {
+        throw new Error(`Ethereum address must be 0x-prefixed 40-char hex; got "${hex}"`);
+    }
+    return Uint8Array.from(Buffer.from(cleaned, 'hex'));
+}
+function recipientFromDepositOptions(o) {
+    if (o.recipientArweave && o.recipientEthereum) {
+        throw new Error('--recipient-arweave and --recipient-ethereum are mutually exclusive');
+    }
+    if (o.recipientArweave) {
+        return {
+            protocol: 'arweave',
+            publicKey: loadArweaveModulusFromJwk(o.recipientArweave),
+        };
+    }
+    if (o.recipientEthereum) {
+        return {
+            protocol: 'ethereum',
+            publicKey: parseEthereumAddress(o.recipientEthereum),
+        };
+    }
+    throw new Error('one of --recipient-arweave or --recipient-ethereum is required');
+}
+function recipientFromUpdateOptions(o) {
+    return recipientFromDepositOptions({
+        recipientArweave: o.newRecipientArweave,
+        recipientEthereum: o.newRecipientEthereum,
+    });
+}
+function antFromOptions(o) {
+    if (!o.ant)
+        throw new Error('--ant <mint> is required');
+    return (0, kit_1.address)(o.ant);
+}
+// =========================================
+// CLI handlers
+// =========================================
+/** `ar.io escrow status --ant <mint>` */
+async function escrowStatusCLICommand(o) {
+    const escrow = await readEscrowReader(o);
+    const ant = antFromOptions(o);
+    const state = await escrow.get(ant);
+    if (!state) {
+        return { active: false, antMint: ant };
+    }
+    return {
+        active: true,
+        antMint: state.antMint,
+        depositor: state.depositor,
+        recipientProtocol: state.recipientProtocol,
+        recipientPubkeyHex: Buffer.from(state.recipientPubkey).toString('hex'),
+        nonceHex: Buffer.from(state.nonce).toString('hex'),
+        depositSlot: state.depositSlot.toString(),
+        version: state.version,
+    };
+}
+/** `ar.io escrow deposit --ant <mint> --recipient-{arweave|ethereum} ...` */
+async function escrowDepositCLICommand(o) {
+    const recipient = recipientFromDepositOptions(o);
+    const escrow = await writeEscrowFromOptions(o);
+    const sig = await escrow.deposit({ antMint: antFromOptions(o), recipient });
+    return { signature: sig };
+}
+/** `ar.io escrow cancel --ant <mint>` */
+async function escrowCancelCLICommand(o) {
+    const escrow = await writeEscrowFromOptions(o);
+    const sig = await escrow.cancel({ antMint: antFromOptions(o) });
+    return { signature: sig };
+}
+/** `ar.io escrow update-recipient --ant <mint> --new-recipient-{arweave|ethereum} ...` */
+async function escrowUpdateRecipientCLICommand(o) {
+    const newRecipient = recipientFromUpdateOptions(o);
+    const escrow = await writeEscrowFromOptions(o);
+    const sig = await escrow.updateRecipient({
+        antMint: antFromOptions(o),
+        newRecipient,
+    });
+    return { signature: sig };
+}
+/** `ar.io escrow claim-arweave --ant <mint> --signature-file <bin> --claimant <pubkey> [--salt-len 32]` */
+async function escrowClaimArweaveCLICommand(o) {
+    if (!o.signatureFile)
+        throw new Error('--signature-file <path> is required');
+    if (!o.claimant)
+        throw new Error('--claimant <pubkey> is required');
+    const sigBytes = new Uint8Array((0, node_fs_1.readFileSync)(o.signatureFile));
+    if (sigBytes.length !== 512) {
+        throw new Error(`signature file must be 512 bytes; got ${sigBytes.length}`);
+    }
+    const escrow = await writeEscrowFromOptions(o);
+    const sig = await escrow.claimArweave({
+        antMint: antFromOptions(o),
+        claimant: (0, kit_1.address)(o.claimant),
+        signature: sigBytes,
+        saltLen: o.saltLen ? Number(o.saltLen) : 32,
+    });
+    return { signature: sig };
+}
+/** `ar.io escrow claim-ethereum --ant <mint> --signature-file <bin> --claimant <pubkey>` */
+async function escrowClaimEthereumCLICommand(o) {
+    if (!o.signatureFile)
+        throw new Error('--signature-file <path> is required');
+    if (!o.claimant)
+        throw new Error('--claimant <pubkey> is required');
+    const sigBytes = new Uint8Array((0, node_fs_1.readFileSync)(o.signatureFile));
+    if (sigBytes.length !== 65) {
+        throw new Error(`signature file must be 65 bytes (r||s||v); got ${sigBytes.length}`);
+    }
+    const escrow = await writeEscrowFromOptions(o);
+    const sig = await escrow.claimEthereum({
+        antMint: antFromOptions(o),
+        claimant: (0, kit_1.address)(o.claimant),
+        signature: sigBytes,
+    });
+    return { signature: sig };
+}