@ar.io/sdk 3.24.0 → 4.0.0-alpha.1

package/lib/types/cli/commands/pruneCommands.d.ts

@@ -0,0 +1,31 @@
+import type { WriteActionCLIOptions } from '../types.js';
+type PruneOptions = WriteActionCLIOptions & {
+    name?: string;
+    max?: string;
+    gateway?: string;
+    delegator?: string;
+    observer?: string;
+    initiator?: string;
+    owner?: string;
+    withdrawalId?: string;
+    vaultId?: string;
+    epochIndex?: string;
+    arnsRecords?: string[];
+    returnedNames?: string[];
+};
+export declare function pruneExpiredNamesCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult | {
+    message: string;
+}>;
+export declare function pruneNameToReturnedCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function pruneReturnedNamesCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult | {
+    message: string;
+}>;
+export declare function pruneExpiredReservationCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function pruneGatewayCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function finalizeGoneCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function closeObservationCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function closeEmptyDelegationCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function closeDrainedWithdrawalCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function releaseVaultCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export declare function closeExpiredRequestCLICommand(o: PruneOptions): Promise<import("../../types/common.js").MessageResult>;
+export {};

package/lib/types/cli/commands/readCommands.d.ts

@@ -13,66 +13,71 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoArNSNameDataWithName, AoDelegation, AoGatewayDelegateWithAddress, AoGatewayVault, AoGetCostDetailsParams } from '../../types/io.js';
+import { ArNSNameDataWithName, Delegation, GatewayDelegateWithAddress, GatewayVault, GetCostDetailsParams, UserWithdrawal } from '../../types/io.js';
 import { AddressAndNameCLIOptions, AddressAndVaultIdCLIOptions, AddressCLIOptions, CLIOptionsFromAoParams, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, NameCLIOptions, PaginationAddressCLIOptions, PaginationCLIOptions } from '../types.js';
-export declare function getGateway(o: AddressCLIOptions): Promise<import("../../types/io.js").AoGateway>;
-export declare function listGateways(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoGatewayWithAddress> | {
+export declare function getGateway(o: AddressCLIOptions): Promise<import("../../types/io.js").Gateway>;
+export declare function listGateways(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").GatewayWithAddress> | {
     message: string;
 }>;
-export declare function listAllDelegatesCLICommand(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoAllDelegates> | {
+export declare function listAllDelegatesCLICommand(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AllDelegates> | {
     message: string;
 }>;
-export declare function getGatewayDelegates(o: AddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoGatewayDelegateWithAddress> | {
+export declare function getGatewayDelegates(o: AddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<GatewayDelegateWithAddress> | {
     message: string;
 }>;
-export declare function getDelegations(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoDelegation> | {
+export declare function getDelegations(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<Delegation> | {
     message: string;
 }>;
 export declare function getAllowedDelegates(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<string> | {
     message: string;
 }>;
-export declare function getArNSRecord(o: NameCLIOptions): Promise<import("../../types/io.js").AoArNSNameData>;
-export declare function listArNSRecords(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoArNSNameDataWithName> | {
+export declare function getArNSRecord(o: NameCLIOptions): Promise<import("../../types/io.js").ArNSNameData>;
+export declare function listArNSRecords(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<ArNSNameDataWithName> | {
     message: string;
 }>;
-export declare function listArNSRecordsForAddress(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoArNSNameDataWithName> | {
+export declare function listArNSRecordsForAddress(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<ArNSNameDataWithName> | {
     message: string;
 }>;
-export declare function getArNSReservedName(o: NameCLIOptions): Promise<import("../../types/io.js").AoArNSReservedNameData>;
-export declare function listArNSReservedNames(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoArNSReservedNameDataWithName> | {
+export declare function getArNSReservedName(o: NameCLIOptions): Promise<import("../../types/io.js").ArNSReservedNameData>;
+export declare function listArNSReservedNames(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").ArNSReservedNameDataWithName> | {
     message: string;
 }>;
-export declare function getArNSReturnedName(o: NameCLIOptions): Promise<import("../../types/io.js").AoReturnedName>;
-export declare function listArNSReturnedNames(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoReturnedName> | {
+export declare function getArNSReturnedName(o: NameCLIOptions): Promise<import("../../types/io.js").ReturnedName>;
+export declare function listArNSReturnedNames(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").ReturnedName> | {
     message: string;
 }>;
-export declare function getEpoch(o: EpochCLIOptions): Promise<import("../../types/io.js").AoEpochData<import("../../types/io.js").AoEpochDistributionData>>;
-export declare function getPrescribedObservers(o: EpochCLIOptions): Promise<import("../../types/io.js").AoWeightedObserver[]>;
+export declare function getEpoch(o: EpochCLIOptions): Promise<import("../../types/io.js").EpochData<import("../../types/io.js").EpochDistributionData>>;
+export declare function getPrescribedObservers(o: EpochCLIOptions): Promise<import("../../types/io.js").WeightedObserver[]>;
 export declare function getPrescribedNames(o: EpochCLIOptions): Promise<string[]>;
 export declare function getTokenCost(o: GetTokenCostCLIOptions): Promise<{
     mARIOTokenCost: number;
     message: string;
 }>;
-export declare function getCostDetails(o: GlobalCLIOptions & CLIOptionsFromAoParams<AoGetCostDetailsParams>): Promise<{
+export declare function getCostDetails(o: GlobalCLIOptions & CLIOptionsFromAoParams<GetCostDetailsParams>): Promise<{
     message: string;
     tokenCost: number;
     discounts: import("../../types/io.js").CostDiscount[];
-    returnedNameDetails?: import("../../types/io.js").AoReturnedName & {
+    returnedNameDetails?: import("../../types/io.js").ReturnedName & {
         basePrice: number;
     };
-    fundingPlan?: import("../../types/io.js").AoFundingPlan;
+    fundingPlan?: import("../../types/io.js").FundingPlan;
     wincQty?: string;
 }>;
-export declare function getPrimaryName(o: AddressAndNameCLIOptions): Promise<import("../../types/common.js").AoPrimaryName>;
-export declare function getGatewayVaults(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoGatewayVault> | {
+export declare function getPrimaryName(o: AddressAndNameCLIOptions): Promise<import("../../types/common.js").PrimaryName>;
+export declare function getGatewayVaults(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<GatewayVault> | {
     message: string;
 }>;
-export declare function getAllGatewayVaults(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoAllGatewayVaults> | {
+export declare function getAllGatewayVaults(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AllGatewayVaults> | {
     message: string;
 }>;
-export declare function getVault(o: AddressAndVaultIdCLIOptions): Promise<import("../../types/io.js").AoVaultData>;
+export declare function getWithdrawals(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<UserWithdrawal> | {
+    message: string;
+}>;
+export declare function getVault(o: AddressAndVaultIdCLIOptions): Promise<import("../../types/io.js").VaultData>;
 export declare function resolveArNSName(o: NameCLIOptions): Promise<import("../../types/io.js").ArNSNameResolutionData>;
 export declare function listAntsForAddress(o: AddressCLIOptions): Promise<{
     Owned: string[];
     Controlled: string[];
+} | {
+    message: string;
 }>;

package/lib/types/cli/commands/transfer.d.ts

@@ -13,28 +13,28 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoCreateVaultParams, AoExtendVaultParams, AoIncreaseVaultParams, AoRevokeVaultParams, AoVaultedTransferParams } from '../../types/io.js';
+import { CreateVaultParams, ExtendVaultParams, IncreaseVaultParams, RevokeVaultParams, VaultedTransferParams } from '../../types/io.js';
 import { CLIWriteOptionsFromAoParams, JsonSerializable, TransferCLIOptions } from '../types.js';
 export declare function transferCLICommand(options: TransferCLIOptions): Promise<{
     senderAddress: string;
-    transferResult: import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>;
+    transferResult: import("../../types/common.js").MessageResult<Record<string, string | number | boolean | null>>;
     message: string;
 } | {
     message: string;
 }>;
-export declare function vaultedTransferCLICommand(o: CLIWriteOptionsFromAoParams<AoVaultedTransferParams>): Promise<JsonSerializable>;
-export declare function revokeVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoRevokeVaultParams>): Promise<JsonSerializable>;
-export declare function createVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoCreateVaultParams>): Promise<JsonSerializable>;
-export declare function extendVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoExtendVaultParams>): Promise<{
+export declare function vaultedTransferCLICommand(o: CLIWriteOptionsFromAoParams<VaultedTransferParams>): Promise<JsonSerializable>;
+export declare function revokeVaultCLICommand(o: CLIWriteOptionsFromAoParams<RevokeVaultParams>): Promise<JsonSerializable>;
+export declare function createVaultCLICommand(o: CLIWriteOptionsFromAoParams<CreateVaultParams>): Promise<JsonSerializable>;
+export declare function extendVaultCLICommand(o: CLIWriteOptionsFromAoParams<ExtendVaultParams>): Promise<{
     senderAddress: string;
-    transferResult: import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>;
+    transferResult: import("../../types/common.js").MessageResult<Record<string, string | number | boolean | null>>;
     message: string;
 } | {
     message: string;
 }>;
-export declare function increaseVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoIncreaseVaultParams>): Promise<{
+export declare function increaseVaultCLICommand(o: CLIWriteOptionsFromAoParams<IncreaseVaultParams>): Promise<{
     senderAddress: string;
-    transferResult: import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>;
+    transferResult: import("../../types/common.js").MessageResult<Record<string, string | number | boolean | null>>;
     message: string;
 } | {
     message: string;

package/lib/types/cli/options.d.ts

@@ -27,33 +27,59 @@ export declare const optionMap: {
         description: string;
         type: string;
     };
-    testnet: {
+    rpcUrl: {
         alias: string;
         description: string;
-        type: string;
     };
-    devnet: {
+    antProgramId: {
+        alias: string;
+        description: string;
+    };
+    coreProgramId: {
+        alias: string;
+        description: string;
+    };
+    garProgramId: {
+        alias: string;
+        description: string;
+    };
+    arnsProgramId: {
+        alias: string;
+        description: string;
+    };
+    escrowProgramId: {
+        alias: string;
+        description: string;
+    };
+    ant: {
+        alias: string;
+        description: string;
+    };
+    recipientArweave: {
+        alias: string;
+        description: string;
+    };
+    recipientEthereum: {
         alias: string;
         description: string;
-        type: string;
     };
-    arioProcessId: {
+    newRecipientArweave: {
         alias: string;
         description: string;
     };
-    antRegistryProcessId: {
+    newRecipientEthereum: {
         alias: string;
         description: string;
     };
-    hyperbeamUrl: {
+    signatureFile: {
         alias: string;
         description: string;
     };
-    cuUrl: {
+    saltLen: {
         alias: string;
         description: string;
     };
-    paymentUrl: {
+    claimant: {
         alias: string;
         description: string;
     };
@@ -133,10 +159,6 @@ export declare const optionMap: {
         description: string;
         type: string;
     };
-    services: {
-        alias: string;
-        description: string;
-    };
     skipConfirmation: {
         alias: string;
         description: string;
@@ -234,6 +256,10 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
+    targetProtocol: {
+        alias: string;
+        description: string;
+    };
     ttlSeconds: {
         alias: string;
         description: string;
@@ -273,12 +299,24 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
-    revokable: {
+    gatewayAddress: {
+        alias: string;
+        description: string;
+    };
+    fundAsOperator: {
         alias: string;
         description: string;
         type: string;
     };
-    removeControllers: {
+    withdrawalId: {
+        alias: string;
+        description: string;
+    };
+    fundingPlanJson: {
+        alias: string;
+        description: string;
+    };
+    revokable: {
         alias: string;
         description: string;
         type: string;
@@ -299,7 +337,7 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
-    module: {
+    metadataUri: {
         alias: string;
         description: string;
     };
@@ -317,7 +355,28 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
-    reassignAffiliatedNames: {
+    gateway: {
+        alias: string;
+        description: string;
+    };
+    delegator: {
+        alias: string;
+        description: string;
+    };
+    observer: {
+        alias: string;
+        description: string;
+    };
+    max: {
+        alias: string;
+        description: string;
+    };
+    arnsRecords: {
+        alias: string;
+        description: string;
+        type: string;
+    };
+    returnedNames: {
         alias: string;
         description: string;
         type: string;
@@ -416,10 +475,6 @@ export declare const setAntUndernameOptions: {
     alias: string;
     description: string;
 }[];
-export declare const upgradeAntOptions: {
-    alias: string;
-    description: string;
-}[];
 export declare const transferRecordOwnershipOptions: {
     alias: string;
     description: string;

package/lib/types/cli/types.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoAddressParams, AoArNSNameParams, AoGetVaultParams, AoJoinNetworkParams, AoTokenCostParams, PaginationParams } from '../types/io.js';
+import { AddressParams, ArNSNameParams, GetVaultParams, JoinNetworkParams, PaginationParams, TokenCostParams } from '../types/io.js';
 export type SupportedCLITokenType = 'ethereum' | 'arweave';
 export type WalletCLIOptions = {
     walletFile?: string;
@@ -21,15 +21,13 @@ export type WalletCLIOptions = {
     privateKey?: string;
 };
 export type GlobalCLIOptions = WalletCLIOptions & {
-    devnet: boolean;
-    testnet: boolean;
     mainnet: boolean;
     debug: boolean;
-    arioProcessId?: string;
-    antRegistryProcessId?: string;
-    hyperbeamUrl?: string;
-    cuUrl?: string;
-    paymentUrl?: string;
+    rpcUrl?: string;
+    antProgramId?: string;
+    coreProgramId?: string;
+    garProgramId?: string;
+    arnsProgramId?: string;
 };
 export type WriteActionCLIOptions = GlobalCLIOptions & {
     tags?: string[];
@@ -60,7 +58,7 @@ export type CLIWriteOptionsFromAoAntParams<T> = CLIWriteOptionsFromAoParams<T &
     processId: string;
 }>;
 export type PaginationCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<PaginationParams>;
-export type AddressCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AoAddressParams>;
+export type AddressCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AddressParams>;
 export type ProcessIdCLIOptions = GlobalCLIOptions & {
     processId?: string;
 };
@@ -75,17 +73,17 @@ export type EpochCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<{
     epochIndex: number;
     timestamp: number;
 }>;
-export type GetTokenCostCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AoTokenCostParams>;
+export type GetTokenCostCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<TokenCostParams>;
 export type PaginationAddressCLIOptions = AddressCLIOptions & PaginationCLIOptions;
-export type NameCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AoArNSNameParams>;
+export type NameCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<ArNSNameParams>;
 export type NameWriteCLIOptions = WriteActionCLIOptions & NameCLIOptions;
-export type AddressAndVaultIdCLIOptions = CLIOptionsFromAoParams<AoGetVaultParams> & GlobalCLIOptions;
+export type AddressAndVaultIdCLIOptions = CLIOptionsFromAoParams<GetVaultParams> & GlobalCLIOptions;
 export type AddressAndVaultIdCLIWriteOptions = WriteActionCLIOptions & AddressAndVaultIdCLIOptions;
 export type TransferCLIOptions = WriteActionCLIOptions & {
     quantity?: string;
     target?: string;
 };
-export type JoinNetworkCLIOptions = WriteActionCLIOptions & CLIOptionsFromAoParams<AoJoinNetworkParams>;
+export type JoinNetworkCLIOptions = WriteActionCLIOptions & CLIOptionsFromAoParams<JoinNetworkParams>;
 export type UpdateGatewaySettingsCLIOptions = Omit<JoinNetworkCLIOptions, 'operatorStake'>;
 export type DelegateStakeCLIOptions = TransferCLIOptions;
 export type RedelegateStakeCLIOptions = TransferCLIOptions & {

package/lib/types/cli/utils.d.ts

@@ -1,7 +1,11 @@
-import { JWKInterface } from 'arweave/node/lib/wallet.js';
 import { Command, OptionValues } from 'commander';
-import { ARIOToken, AoANTRead, AoANTRegistryRead, AoANTWrite, AoARIORead, AoARIOWrite, AoGetCostDetailsParams, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, FundFrom, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
-import { ANTStateCLIOptions, AddressCLIOptions, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, InitiatorCLIOptions, JsonSerializable, PaginationCLIOptions, ProcessIdCLIOptions, RedelegateStakeCLIOptions, TransferCLIOptions, UpdateGatewaySettingsCLIOptions, WalletCLIOptions, WriteActionCLIOptions } from './types.js';
+import { Logger } from '../common/logger.js';
+import type { ANTRegistryRead } from '../types/ant-registry.js';
+import type { ANTRead, ANTWrite } from '../types/ant.js';
+import type { WriteOptions } from '../types/common.js';
+import type { ARIORead, ARIOWrite, EpochInput, FundFrom, GetCostDetailsParams, PaginationParams, RedelegateStakeParams, UpdateGatewaySettingsParams } from '../types/io.js';
+import { ARIOToken, mARIOToken } from '../types/token.js';
+import { ANTStateCLIOptions, AddressCLIOptions, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, InitiatorCLIOptions, JsonSerializable, PaginationCLIOptions, ProcessIdCLIOptions, RedelegateStakeCLIOptions, TransferCLIOptions, UpdateGatewaySettingsCLIOptions, WriteActionCLIOptions } from './types.js';
 export declare const defaultTtlSecondsCLI = 3600;
 export declare function stringifyJsonForCLIDisplay(json: JsonSerializable | unknown): string;
 export declare function runCommand<O extends OptionValues>(command: Command, action: (options: O) => Promise<JsonSerializable>): Promise<void>;
@@ -17,42 +21,42 @@ export declare function makeCommand<O extends OptionValues = GlobalCLIOptions>({
     action?: (options: O) => Promise<JsonSerializable>;
     options?: CommanderOption[];
 }): Command;
-export declare function arioProcessIdFromOptions({ arioProcessId, devnet, testnet, }: GlobalCLIOptions): string;
-export declare function antRegistryIdFromOptions({ antRegistryProcessId, testnet, }: GlobalCLIOptions): string;
-export declare function requiredJwkFromOptions(options: WalletCLIOptions): JWKInterface;
-export declare function jwkToAddress(jwk: JWKInterface): string;
 export declare function getLoggerFromOptions(options: GlobalCLIOptions): Logger;
-export declare function readARIOFromOptions(options: GlobalCLIOptions): AoARIORead;
-export declare function readANTRegistryFromOptions(options: ProcessIdCLIOptions): AoANTRegistryRead;
-export declare function contractSignerFromOptions(options: WalletCLIOptions): {
-    signer: ContractSigner;
+export declare function readARIOFromOptions(options: GlobalCLIOptions): ARIORead;
+export declare function readANTRegistryFromOptions(options: ProcessIdCLIOptions): Promise<ANTRegistryRead>;
+export declare function writeARIOFromOptions(options: GlobalCLIOptions): Promise<{
+    ario: ARIOWrite;
     signerAddress: string;
-} | undefined;
-export declare function requiredContractSignerFromOptions(options: WalletCLIOptions): {
-    signer: ContractSigner;
-    signerAddress: string;
-};
-export declare function requiredAoSignerFromOptions(options: WalletCLIOptions): AoSigner;
-export declare function writeARIOFromOptions(options: GlobalCLIOptions): {
-    ario: AoARIOWrite;
-    signerAddress: string;
-};
+}>;
 export declare function formatARIOWithCommas(value: ARIOToken): string;
 export declare function formatMARIOToARIOWithCommas(value: mARIOToken): string;
-/** helper to get address from --address option first, then check wallet options  */
+/**
+ * Resolve the wallet address from CLI options. Priority order:
+ *   1. `--address <addr>` — used verbatim.
+ *   2. `--wallet-file <path-to-keypair.json>` — derive the Solana pubkey
+ *      from the keypair file (last 32 bytes of the 64-byte secret-key
+ *      array are the public key; base58-encode them).
+ *   3. `--private-key <base58-secret>` — base58-decode the secret, take
+ *      the trailing 32 bytes as the pubkey. Matches the keypair-file
+ *      path; kept aligned with `loadSolanaSignerFromOptions` so cost
+ *      / funding lookups work even when the user authenticates with
+ *      only a private key.
+ *
+ * Returns `undefined` when none of those is set. Use
+ * `requiredAddressFromOptions` for callers that must have an address.
+ */
 export declare function addressFromOptions<O extends AddressCLIOptions>(options: O): string | undefined;
 export declare function requiredAddressFromOptions<O extends AddressCLIOptions>(options: O): string;
 export declare function paginationParamsFromOptions<O extends PaginationCLIOptions, R>(options: O): PaginationParams<R>;
 export declare function epochInputFromOptions(options: EpochCLIOptions): EpochInput;
 export declare function requiredInitiatorFromOptions(options: InitiatorCLIOptions): string;
 export declare function customTagsFromOptions<O extends WriteActionCLIOptions>(options: O): WriteOptions;
-export declare function servicesFromOptions(services?: string): any;
-export declare function gatewaySettingsFromOptions(options: UpdateGatewaySettingsCLIOptions): AoUpdateGatewaySettingsParams;
+export declare function gatewaySettingsFromOptions(options: UpdateGatewaySettingsCLIOptions): UpdateGatewaySettingsParams;
 export declare function requiredTargetAndQuantityFromOptions(options: TransferCLIOptions): {
     target: string;
     arioQuantity: ARIOToken;
 };
-export declare function redelegateParamsFromOptions(options: RedelegateStakeCLIOptions): AoRedelegateStakeParams & {
+export declare function redelegateParamsFromOptions(options: RedelegateStakeCLIOptions): RedelegateStakeParams & {
     stakeQty: mARIOToken;
 };
 export declare function recordTypeFromOptions<O extends {
@@ -60,12 +64,12 @@ export declare function recordTypeFromOptions<O extends {
 }>(options: O): 'lease' | 'permabuy';
 export declare function requiredMARIOFromOptions<O extends GlobalCLIOptions>(options: O, key: string): mARIOToken;
 export declare function assertEnoughBalanceForArNSPurchase({ ario, address, costDetailsParams, }: {
-    ario: AoARIORead;
+    ario: ARIORead;
     address: string;
-    costDetailsParams: AoGetCostDetailsParams;
+    costDetailsParams: GetCostDetailsParams;
 }): Promise<void>;
 export declare function assertEnoughMARIOBalance({ address, ario, mARIOQuantity, }: {
-    ario: AoARIORead;
+    ario: ARIORead;
     address: string;
     mARIOQuantity: mARIOToken | number;
 }): Promise<void>;
@@ -74,15 +78,27 @@ export declare function assertConfirmationPrompt<O extends {
     skipConfirmation?: boolean;
 }>(message: string, options: O): Promise<boolean>;
 export declare function requiredProcessIdFromOptions<O extends ProcessIdCLIOptions>(o: O): string;
-export declare function readANTFromOptions(options: ProcessIdCLIOptions): AoANTRead;
-export declare function writeANTFromOptions(options: ProcessIdCLIOptions, signer?: ContractSigner): AoANTWrite;
+export declare function readANTFromOptions(options: ProcessIdCLIOptions): Promise<ANTRead>;
+export declare function writeANTFromOptions(options: ProcessIdCLIOptions): Promise<ANTWrite>;
 export declare function booleanFromOptions<O extends GlobalCLIOptions>(options: O, key: string): boolean;
 export declare function requiredStringFromOptions<O extends GlobalCLIOptions>(options: O, key: string): string;
 export declare function stringArrayFromOptions<O extends GlobalCLIOptions>(options: O, key: string): string[] | undefined;
 export declare function requiredStringArrayFromOptions<O extends GlobalCLIOptions>(options: O, key: string): string[];
 export declare function positiveIntegerFromOptions<O extends GlobalCLIOptions>(options: O, key: string): number | undefined;
 export declare function requiredPositiveIntegerFromOptions<O extends GlobalCLIOptions>(options: O, key: string): number;
-export declare function getANTStateFromOptions(options: ANTStateCLIOptions): SpawnANTState;
+/**
+ * Spawn a fresh ANT on Solana from CLI options.
+ *
+ * Resolves the signer the same way `writeARIOFromOptions` does (KeyPairSigner
+ * from `--wallet-file` or `--private-key`), then bundles MPL Core `CreateV1` +
+ * `ario_ant::initialize` into a single transaction. The signer's address
+ * becomes the ANT owner on chain — no separate `--address` is required.
+ *
+ * Maps the user-facing options (`--name`, `--ticker`, `--description`,
+ * `--keywords`, `--logo`, `--target` for the @ record tx id) onto the Solana
+ * `InitializeAntParams` payload.
+ */
+export declare function spawnSolanaANTFromOptions(options: ANTStateCLIOptions): Promise<import('../solana/spawn-ant.js').SpawnSolanaANTResult>;
 export declare function getTokenCostParamsFromOptions(o: GetTokenCostCLIOptions): {
     type: "lease" | "permabuy";
     quantity: number | undefined;
@@ -97,6 +113,30 @@ export declare function fundFromFromOptions<O extends {
 export declare function referrerFromOptions<O extends {
     referrer?: string;
 }>(o: O): string | undefined;
+/** Parse `--withdrawal-id` from CLI options into a bigint. */
+export declare function withdrawalIdFromOptions<O extends {
+    withdrawalId?: string;
+}>(o: O): bigint | undefined;
+/**
+ * Parse `--funding-plan-json` into a `FundingSourceSpec[]`. Validates each
+ * entry's `kind` against the on-chain enum and parses `amount` as a bigint.
+ * Each Delegation/OperatorStake entry MAY carry a `gateway` field (base58
+ * Solana address) — required when the plan spans multiple gateways.
+ *
+ * Format examples:
+ *   '[{"kind":"balance","amount":"100"},{"kind":"withdrawal","amount":"500"}]'
+ *   '[{"kind":"delegation","amount":"100","gateway":"Gw1..."},{"kind":"delegation","amount":"50","gateway":"Gw2..."}]'
+ *
+ * Returns undefined when the flag isn't set; throws Error on malformed JSON
+ * or unknown kinds.
+ */
+export declare function fundingPlanFromOptions<O extends {
+    fundingPlanJson?: string;
+}>(o: O): {
+    kind: string;
+    amount: bigint;
+    gateway?: string;
+}[] | undefined;
 export declare function assertLockLengthInRange(lockLengthMs: number, assertMin?: boolean): void;
 export declare function antRecordMetadataFromOptions<O extends {
     owner?: string;