@ar.io/sdk 4.0.0-solana.8 → 4.0.0

package/lib/esm/cli/commands/pruneCommands.js

@@ -1,16 +1,17 @@
 import { assertConfirmationPrompt, requiredStringFromOptions, writeARIOFromOptions, } from '../utils.js';
-function rejectAoBackend(o, command) {
-    if (o.ao) {
-        throw new Error(`${command} is Solana-only — Lua's tick() handles the equivalent on AO. Drop --ao.`);
-    }
-}
 async function getSolanaWriter(o) {
     const { ario } = await writeARIOFromOptions(o);
     return ario;
 }
-function parseMaxNames(o) {
+function parseMaxNames(o, fallbackCount) {
     const raw = o.max;
     if (raw === undefined) {
+        // When an explicit name list is supplied, derive the u8 batch size from
+        // it (capped at the on-chain max of 255) so callers don't have to also
+        // pass --max. Discovery paths (no explicit list) still require --max.
+        if (fallbackCount !== undefined && fallbackCount > 0) {
+            return Math.min(fallbackCount, 255);
+        }
         throw new Error('--max <count> is required (u8 batch size, 1-255)');
     }
     const n = Number(raw);
@@ -23,8 +24,7 @@ function parseMaxNames(o) {
 // ArNS prune
 // =========================================
 export async function pruneExpiredNamesCLICommand(o) {
-    rejectAoBackend(o, 'prune-expired-names');
-    const max = parseMaxNames(o);
+    const max = parseMaxNames(o, o.arnsRecords?.length);
     const ario = await getSolanaWriter(o);
     // If `--arns-records` wasn't provided, discover them via the readable's
     // helper. Cap at `max` so we never overshoot the ix's u8 batch parameter.
@@ -44,15 +44,13 @@ export async function pruneExpiredNamesCLICommand(o) {
     return ario.pruneExpiredNames({ maxNames: max, arnsRecords: records });
 }
 export async function pruneNameToReturnedCLICommand(o) {
-    rejectAoBackend(o, 'prune-name-to-returned');
     const name = requiredStringFromOptions(o, 'name');
     const ario = await getSolanaWriter(o);
     await assertConfirmationPrompt(`Convert expired lease for "${name}" to a ReturnedName (Dutch auction)?`, o);
     return ario.pruneNameToReturned({ name });
 }
 export async function pruneReturnedNamesCLICommand(o) {
-    rejectAoBackend(o, 'prune-returned-names');
-    const max = parseMaxNames(o);
+    const max = parseMaxNames(o, o.returnedNames?.length);
     const ario = await getSolanaWriter(o);
     let returned = o.returnedNames ?? [];
     if (returned.length === 0) {
@@ -73,7 +71,6 @@ export async function pruneReturnedNamesCLICommand(o) {
     });
 }
 export async function pruneExpiredReservationCLICommand(o) {
-    rejectAoBackend(o, 'prune-expired-reservation');
     const name = requiredStringFromOptions(o, 'name');
     const ario = await getSolanaWriter(o);
     await assertConfirmationPrompt(`Close expired reservation for "${name}"?`, o);
@@ -83,14 +80,12 @@ export async function pruneExpiredReservationCLICommand(o) {
 // Gateway prune
 // =========================================
 export async function pruneGatewayCLICommand(o) {
-    rejectAoBackend(o, 'prune-gateway');
     const gateway = requiredStringFromOptions(o, 'gateway');
     const ario = await getSolanaWriter(o);
     await assertConfirmationPrompt(`Slash + remove deficient gateway ${gateway}?`, o);
     return ario.pruneGateway({ gateway });
 }
 export async function finalizeGoneCLICommand(o) {
-    rejectAoBackend(o, 'finalize-gone');
     const gateway = requiredStringFromOptions(o, 'gateway');
     const ario = await getSolanaWriter(o);
     await assertConfirmationPrompt(`Finalize-GC departed gateway ${gateway} (reclaim PDA rent)?`, o);
@@ -100,7 +95,6 @@ export async function finalizeGoneCLICommand(o) {
 // Rent reclaim
 // =========================================
 export async function closeObservationCLICommand(o) {
-    rejectAoBackend(o, 'close-observation');
     const epochIndexStr = requiredStringFromOptions(o, 'epochIndex');
     const observer = requiredStringFromOptions(o, 'observer');
     const epochIndex = Number(epochIndexStr);
@@ -112,7 +106,6 @@ export async function closeObservationCLICommand(o) {
     return ario.closeObservation({ epochIndex, observer });
 }
 export async function closeEmptyDelegationCLICommand(o) {
-    rejectAoBackend(o, 'close-empty-delegation');
     const gateway = requiredStringFromOptions(o, 'gateway');
     const delegator = requiredStringFromOptions(o, 'delegator');
     const ario = await getSolanaWriter(o);
@@ -120,7 +113,6 @@ export async function closeEmptyDelegationCLICommand(o) {
     return ario.closeEmptyDelegation({ gateway, delegator });
 }
 export async function closeDrainedWithdrawalCLICommand(o) {
-    rejectAoBackend(o, 'close-drained-withdrawal');
     const owner = requiredStringFromOptions(o, 'owner');
     const withdrawalIdStr = requiredStringFromOptions(o, 'withdrawalId');
     // Validate before BigInt() — `BigInt('0xff')` and `BigInt('  1  ')` succeed
@@ -139,18 +131,15 @@ export async function closeDrainedWithdrawalCLICommand(o) {
 // Vault + primary-name request
 // =========================================
 export async function releaseVaultCLICommand(o) {
-    rejectAoBackend(o, 'release-vault');
     // The on-chain handler requires `owner: Signer` — the SDK uses the
     // configured signer as the owner. The `--owner` flag is accepted as
     // documentation but ignored unless it matches the signer; fail loud if
     // it doesn't, so users don't think they can release someone else's vault.
-    const ario = await getSolanaWriter(o);
-    if (o.owner) {
-        const signerAddr = (await writeARIOFromOptions(o)).signerAddress;
-        if (o.owner !== signerAddr) {
-            throw new Error(`release-vault: --owner ${o.owner} does not match signer ${signerAddr}. ` +
-                `release_vault is owner-signed; use the owner's wallet to call it.`);
-        }
+    const { ario: arioWrite, signerAddress } = await writeARIOFromOptions(o);
+    const ario = arioWrite;
+    if (o.owner && o.owner !== signerAddress) {
+        throw new Error(`release-vault: --owner ${o.owner} does not match signer ${signerAddress}. ` +
+            `release_vault is owner-signed; use the owner's wallet to call it.`);
     }
     const vaultIdStr = requiredStringFromOptions(o, 'vaultId');
     const vaultId = vaultIdStr;
@@ -158,7 +147,6 @@ export async function releaseVaultCLICommand(o) {
     return ario.releaseVault({ vaultId });
 }
 export async function closeExpiredRequestCLICommand(o) {
-    rejectAoBackend(o, 'close-expired-request');
     const initiator = requiredStringFromOptions(o, 'initiator');
     const ario = await getSolanaWriter(o);
     await assertConfirmationPrompt(`Close expired primary-name request from ${initiator}?`, o);

package/lib/esm/cli/commands/readCommands.js

@@ -67,7 +67,6 @@ export async function listArNSRecordsForAddress(o) {
     const names = await readARIOFromOptions(o).getArNSRecordsForAddress({
         ...paginationParams,
         address,
-        antRegistryProcessId: o.antRegistryProcessId,
     });
     return names.items.length ? names : { message: 'No names found' };
 }
@@ -165,6 +164,18 @@ export async function getAllGatewayVaults(o) {
             message: `No vaults found`,
         };
 }
+export async function getWithdrawals(o) {
+    const address = requiredAddressFromOptions(o);
+    const result = await readARIOFromOptions(o).getWithdrawals({
+        address,
+        ...paginationParamsFromOptions(o),
+    });
+    return result.items?.length
+        ? result
+        : {
+            message: `No pending withdrawals found for address ${address}`,
+        };
+}
 export async function getVault(o) {
     return readARIOFromOptions(o)
         .getVault({

package/lib/esm/cli/options.js

@@ -28,34 +28,7 @@ export const optionMap = {
     },
     mainnet: {
         alias: '--mainnet',
-        description: 'Run against the AR.IO mainnet process',
-        type: 'boolean',
-    },
-    testnet: {
-        alias: '--testnet',
-        description: 'Run against the AR.IO testnet process',
-        type: 'boolean',
-    },
-    devnet: {
-        alias: '--dev, --devnet',
-        description: 'Run against the AR.IO devnet process',
-        type: 'boolean',
-    },
-    arioProcessId: {
-        alias: '--ario-process-id <arioProcessId>',
-        description: 'Run against a custom AR.IO process id',
-    },
-    antRegistryProcessId: {
-        alias: '--ant-registry-process-id <antRegistryProcessId>',
-        description: 'Run against a custom ANT registry process id',
-    },
-    hyperbeamUrl: {
-        alias: '--hyperbeam-url <hyperbeamUrl>',
-        description: 'The URL for a custom hyperbeam node',
-    },
-    ao: {
-        alias: '--ao',
-        description: 'Use the legacy AO backend instead of Solana',
+        description: 'Run against AR.IO mainnet (Solana)',
         type: 'boolean',
     },
     rpcUrl: {
@@ -116,14 +89,6 @@ export const optionMap = {
         alias: '--claimant <pubkey>',
         description: 'Solana pubkey that will receive the ANT on claim.',
     },
-    cuUrl: {
-        alias: '--cu-url <cuUrl>',
-        description: 'The URL for a custom compute unit',
-    },
-    paymentUrl: {
-        alias: '--payment-url <paymentUrl>',
-        description: 'The URL for a custom turbo payment service',
-    },
     processId: {
         alias: '--process-id <processId>',
         description: 'The process ID to interact with',
@@ -200,10 +165,6 @@ export const optionMap = {
         description: 'The allowed delegates for the gateway. By default this is empty, meaning all are allowed delegate stake unless delegating is explicitly disallowed by the gateway',
         type: 'array',
     },
-    services: {
-        alias: '--services <services>',
-        description: 'JSON string of gateway services configuration (e.g., \'{"bundlers":[{"fqdn":"bundler.example.com","port":443,"protocol":"https","path":"/bundler"}]}\')',
-    },
     skipConfirmation: {
         alias: '--skip-confirmation',
         description: 'Skip confirmation prompts',
@@ -373,11 +334,6 @@ export const optionMap = {
         description: 'Whether the vaulted transfer is revokable by the sender. Defaults to false',
         type: 'boolean',
     },
-    removeControllers: {
-        alias: '--remove-controllers',
-        description: 'Whether to remove controllers when transferring ANT ownership. Defaults to true',
-        type: 'boolean',
-    },
     lockLengthMs: {
         alias: '--lock-length-ms <lockLengthMs>',
         description: 'The length of time in milliseconds to lock the vault for',
@@ -394,13 +350,9 @@ export const optionMap = {
         alias: '--logo <logo>',
         description: 'The ANT logo',
     },
-    module: {
-        alias: '--module <module>',
-        description: 'The module ID to use for spawning the ANT process',
-    },
     metadataUri: {
         alias: '--metadata-uri <metadataUri>',
-        description: 'Solana spawn-ant only: URI baked into the Metaplex Core asset (e.g. "ar://<txid>" or "https://<gateway>/raw/<txid>"). Build the JSON with `buildAntMetadata` from `@ar.io/sdk/solana` and upload via Turbo. See sdk/scripts/devnet-validation/populate-ant.ts.',
+        description: 'spawn-ant only: URI baked into the Metaplex Core asset (e.g. "ar://<txid>" or "https://<gateway>/raw/<txid>"). Build the JSON with `buildAntMetadata` from `@ar.io/sdk` and upload via Turbo. See sdk/scripts/devnet-validation/populate-ant.ts.',
     },
     token: {
         alias: '-t, --token <type>',
@@ -416,11 +368,6 @@ export const optionMap = {
         alias: '--referrer <referrer>',
         description: 'The referrer for ArNS purchase tracking',
     },
-    reassignAffiliatedNames: {
-        alias: '--reassign-affiliated-names',
-        description: 'Reassign all affiliated names to the new process',
-        type: 'boolean',
-    },
     // -----------------------------------------------------------------
     // Prune / cleanup flags (Solana-only — see pruneCommands.ts)
     // -----------------------------------------------------------------
@@ -459,14 +406,8 @@ export const walletOptions = [
 ];
 export const globalOptions = [
     ...walletOptions,
-    optionMap.devnet,
-    optionMap.testnet,
     optionMap.mainnet,
     optionMap.debug,
-    optionMap.arioProcessId,
-    optionMap.cuUrl,
-    optionMap.hyperbeamUrl,
-    optionMap.ao,
     optionMap.rpcUrl,
     optionMap.antProgramId,
     optionMap.coreProgramId,
@@ -483,7 +424,6 @@ export const arnsPurchaseOptions = [
     optionMap.withdrawalId,
     optionMap.fundingPlanJson,
     optionMap.paidBy,
-    optionMap.paymentUrl,
     optionMap.referrer,
 ];
 export const epochOptions = [optionMap.epochIndex, optionMap.timestamp];
@@ -509,7 +449,6 @@ export const tokenCostOptions = [
     optionMap.quantity,
     optionMap.address,
     optionMap.fundFrom,
-    optionMap.paymentUrl,
 ];
 export const transferOptions = [
     ...writeActionOptions,
@@ -547,7 +486,6 @@ export const updateGatewaySettingsOptions = [
     optionMap.fqdn,
     optionMap.port,
     optionMap.protocol,
-    optionMap.services,
 ];
 export const joinNetworkOptions = [
     ...updateGatewaySettingsOptions,
@@ -567,13 +505,8 @@ export const antStateOptions = [
     optionMap.ticker,
     optionMap.name,
     optionMap.description,
-    optionMap.controllers,
     optionMap.ttlSeconds,
     optionMap.logo,
-    optionMap.module,
-    // Required for Solana spawn-ant; ignored by AO. Without this entry,
-    // Commander rejects --metadata-uri as an unknown option even though
-    // spawnSolanaANTFromOptions in utils.ts reads it as `(options as any).metadataUri`.
     optionMap.metadataUri,
 ];
 export const setAntBaseNameOptions = [
@@ -592,12 +525,6 @@ export const setAntUndernameOptions = [
     ...setAntBaseNameOptions,
     optionMap.undername,
 ];
-export const upgradeAntOptions = [
-    optionMap.processId,
-    optionMap.names,
-    optionMap.reassignAffiliatedNames,
-    ...writeActionOptions,
-];
 export const transferRecordOwnershipOptions = [
     optionMap.processId,
     optionMap.undername,