@ar.io/sdk 3.10.2 → 3.11.0-alpha.10

package/lib/cjs/utils/random.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomInt = void 0;
+/**
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const crypto_1 = require("crypto");
+/**
+ * Cryptographically secure helper for randomness, does not support seeding
+ * @param min - the minimum value
+ * @param max - the maximum value
+ * @returns a random integer between min and max
+ */
+const randomInt = (min, max) => {
+    const [rand] = crypto_1.webcrypto.getRandomValues(new Uint32Array(1));
+    return min + (rand % (max - min));
+};
+exports.randomInt = randomInt;

package/lib/cjs/utils/url.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlWithSearchParams = void 0;
+/**
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const urlWithSearchParams = ({ baseUrl, params, }) => {
+    const urlObj = new URL(baseUrl);
+    Object.entries(params).forEach(([key, value]) => {
+        if (value === undefined || value === null)
+            return;
+        urlObj.searchParams.set(key, value.toString());
+    });
+    return urlObj.toString();
+};
+exports.urlWithSearchParams = urlWithSearchParams;

package/lib/cjs/utils/url.test.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_test_1 = require("node:test");
+const url_js_1 = require("./url.js");
+(0, node_test_1.test)('urlWithSearchParams prunes undefined values but keeps other falsey values', () => {
+    const result = (0, url_js_1.urlWithSearchParams)({
+        baseUrl: 'https://example.com',
+        params: {
+            number: 1,
+            string: 'string',
+            boolean: true,
+            empty: '',
+            zero: 0,
+            false: false,
+            null: null,
+            undef: undefined,
+        },
+    });
+    node_assert_1.default.strictEqual(result, 'https://example.com/?number=1&string=string&boolean=true&empty=&zero=0&false=false');
+});

package/lib/cjs/utils/utils.test.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = require("node:assert");
 const node_test_1 = require("node:test");
+const ao_js_1 = require("./ao.js");
 const arweave_js_1 = require("./arweave.js");
-const index_js_1 = require("./index.js");
 (0, node_test_1.describe)('pruneTags', () => {
     (0, node_test_1.it)('should remove tags with undefined values', () => {
         const tags = [
@@ -45,7 +45,7 @@ const index_js_1 = require("./index.js");
         const output = {
             Error: 'Error message',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return error message from Error tag', () => {
@@ -56,7 +56,7 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return error message from Error tag if Error field is undefined', () => {
@@ -67,7 +67,7 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return undefined if no error message is present', () => {
@@ -78,21 +78,21 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, undefined);
     });
     (0, node_test_1.it)('should return error message with line number', () => {
         const output = {
             Error: '[string "aos"]:123: Error message',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message (line 123)');
     });
     (0, node_test_1.it)('should return error message with line number and remove unicode', () => {
         const output = {
             Error: '[string "aos"]:123: Error message\u001b[0m',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message (line 123)');
     });
     const knownErrorMessages = '\u001b[31mError\u001b[90m handling message with Action = Register\u001b[0m\n\u001b[32m[string ".handlers"]:723: [string "aos"]:128: Already registered\u001b[0m\n\n\u001b[90mstack traceback:\n\t[string ".process"]:871: in function \'.process.handle\'\u001b[0m\n\n\u001b[31merror:\n\u001b[0m[string ".handlers"]:723: [string "aos"]:128: Already registered';
@@ -100,7 +100,7 @@ const index_js_1 = require("./index.js");
         const output = {
             Error: knownErrorMessages,
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Already registered (line 128)');
     });
 });

package/lib/cjs/version.js

@@ -17,4 +17,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-exports.version = '3.10.2';
+exports.version = '3.11.0-alpha.10';

package/lib/cjs/web/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArconnectSigner = exports.ArweaveSigner = void 0;
+exports.EthereumSigner = exports.InjectedEthereumSigner = exports.ArconnectSigner = exports.ArweaveSigner = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -33,6 +33,8 @@ exports.ArconnectSigner = exports.ArweaveSigner = void 0;
 var arbundles_1 = require("@dha-team/arbundles");
 Object.defineProperty(exports, "ArweaveSigner", { enumerable: true, get: function () { return arbundles_1.ArweaveSigner; } });
 Object.defineProperty(exports, "ArconnectSigner", { enumerable: true, get: function () { return arbundles_1.ArconnectSigner; } });
+Object.defineProperty(exports, "InjectedEthereumSigner", { enumerable: true, get: function () { return arbundles_1.InjectedEthereumSigner; } });
+Object.defineProperty(exports, "EthereumSigner", { enumerable: true, get: function () { return arbundles_1.EthereumSigner; } });
 __exportStar(require("../types/index.js"), exports);
 __exportStar(require("../common/index.js"), exports);
 __exportStar(require("../constants.js"), exports);

package/lib/esm/cli/cli.js

@@ -22,7 +22,7 @@ import { version } from '../version.js';
 import { setAntBaseNameCLICommand, setAntRecordCLICommand, } from './commands/antCommands.js';
 import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, upgradeRecordCLICommand, } from './commands/arnsPurchaseCommands.js';
 import { cancelWithdrawal, decreaseDelegateStake, decreaseOperatorStake, delegateStake, increaseOperatorStake, instantWithdrawal, joinNetwork, leaveNetwork, redelegateStake, saveObservations, updateGatewaySettings, } from './commands/gatewayWriteCommands.js';
-import { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, } from './commands/readCommands.js';
+import { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, resolveArNSName, } from './commands/readCommands.js';
 import { createVaultCLICommand, extendVaultCLICommand, increaseVaultCLICommand, revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
 import { addressAndVaultIdOptions, antStateOptions, arnsPurchaseOptions, buyRecordOptions, decreaseDelegateStakeOptions, delegateStakeOptions, epochOptions, getVaultOptions, globalOptions, joinNetworkOptions, operatorStakeOptions, optionMap, paginationAddressOptions, paginationOptions, redelegateStakeOptions, setAntBaseNameOptions, setAntUndernameOptions, tokenCostOptions, transferOptions, updateGatewaySettingsOptions, vaultedTransferOptions, writeActionOptions, } from './options.js';
 import { applyOptions, arioProcessIdFromOptions, assertConfirmationPrompt, customTagsFromOptions, epochInputFromOptions, formatARIOWithCommas, getANTStateFromOptions, getLoggerFromOptions, makeCommand, paginationParamsFromOptions, readANTFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredAoSignerFromOptions, requiredProcessIdFromOptions, requiredStringArrayFromOptions, requiredStringFromOptions, writeANTFromOptions, } from './utils.js';
@@ -31,6 +31,7 @@ applyOptions(program
     .version(version)
     .description('AR.IO Network CLI')
     .helpCommand(true), globalOptions);
+// # Getters
 makeCommand({
     name: 'info',
     description: 'Get network info',
@@ -41,6 +42,18 @@ makeCommand({
     description: 'Get the total token supply',
     action: (options) => readARIOFromOptions(options).getTokenSupply(),
 });
+makeCommand({
+    name: 'balance',
+    description: 'Get the balance of an address',
+    options: [optionMap.address],
+    action: (options) => readARIOFromOptions(options)
+        .getBalance({ address: requiredAddressFromOptions(options) })
+        .then((result) => ({
+        address: requiredAddressFromOptions(options),
+        mARIOBalance: result,
+        message: `Provided address current has a balance of ${formatARIOWithCommas(new mARIOToken(result).toARIO())} ARIO`,
+    })),
+});
 makeCommand({
     name: 'get-registration-fees',
     description: 'Get registration fees',
@@ -67,24 +80,18 @@ makeCommand({
     options: [optionMap.address],
     action: getGateway,
 });
-makeCommand({
-    name: 'list-gateways',
-    description: 'List the gateways of the network',
-    options: paginationOptions,
-    action: listGateways,
-});
-makeCommand({
-    name: 'list-all-delegates',
-    description: 'List all paginated delegates from all gateways',
-    options: paginationOptions,
-    action: listAllDelegatesCLICommand,
-});
 makeCommand({
     name: 'get-gateway-delegates',
     description: 'Get the delegates of a gateway',
     options: paginationAddressOptions,
     action: getGatewayDelegates,
 });
+makeCommand({
+    name: 'get-gateway-vaults',
+    description: 'Get the vaults of a gateway',
+    options: paginationAddressOptions,
+    action: getGatewayVaults,
+});
 makeCommand({
     name: 'get-delegations',
     description: 'Get all stake delegated to gateways from this address',
@@ -103,36 +110,18 @@ makeCommand({
     options: [optionMap.name],
     action: getArNSRecord,
 });
-makeCommand({
-    name: 'list-arns-records',
-    description: 'List all ArNS records',
-    options: paginationOptions,
-    action: listArNSRecords,
-});
 makeCommand({
     name: 'get-arns-reserved-name',
     description: 'Get a reserved ArNS name',
     options: [optionMap.name],
     action: getArNSReservedName,
 });
-makeCommand({
-    name: 'list-arns-reserved-names',
-    description: 'Get all reserved ArNS names',
-    options: paginationOptions,
-    action: listArNSReservedNames,
-});
 makeCommand({
     name: 'get-arns-returned-name',
     description: 'Get an ArNS returned name by name',
     options: [optionMap.name],
     action: getArNSReturnedName,
 });
-makeCommand({
-    name: 'list-arns-returned-names',
-    description: 'Get all ArNS recently returned names',
-    options: paginationOptions,
-    action: listArNSReturnedNames,
-});
 makeCommand({
     name: 'get-epoch',
     description: 'Get epoch data',
@@ -193,14 +182,11 @@ makeCommand({
     action: getCostDetails,
 });
 makeCommand({
-    name: 'list-vaults',
-    description: 'Get all wallet vaults',
-    options: paginationOptions,
-    action: (o) => readARIOFromOptions(o)
-        .getVaults(paginationParamsFromOptions(o))
-        .then((result) => result.items.length ? result : { message: 'No vaults found' }),
+    name: 'get-primary-name',
+    description: 'Get primary name',
+    options: [optionMap.address, optionMap.name],
+    action: getPrimaryName,
 });
-// TODO: Could assert valid arweave (or ETH) addresses at CLI level when coming from options (no need from wallet)
 makeCommand({
     name: 'get-primary-name-request',
     description: 'Get primary name request',
@@ -213,6 +199,66 @@ makeCommand({
         message: `No primary name request found`,
     }),
 });
+makeCommand({
+    name: 'get-redelegation-fee',
+    description: 'Get redelegation fee',
+    options: [optionMap.address],
+    action: (options) => readARIOFromOptions(options).getRedelegationFee({
+        address: requiredAddressFromOptions(options),
+    }),
+});
+makeCommand({
+    name: 'get-vault',
+    description: 'Get the vault of provided address and vault ID',
+    options: getVaultOptions,
+    action: getVault,
+});
+// # ArNS Resolution
+makeCommand({
+    name: 'resolve-arns-name',
+    description: 'Resolve an ArNS name',
+    options: [optionMap.name],
+    action: resolveArNSName,
+});
+// # Paginated handlers
+makeCommand({
+    name: 'list-gateways',
+    description: 'List the gateways of the network',
+    options: paginationOptions,
+    action: listGateways,
+});
+makeCommand({
+    name: 'list-all-delegates',
+    description: 'List all paginated delegates from all gateways',
+    options: paginationOptions,
+    action: listAllDelegatesCLICommand,
+});
+makeCommand({
+    name: 'list-arns-records',
+    description: 'List all ArNS records',
+    options: paginationOptions,
+    action: listArNSRecords,
+});
+makeCommand({
+    name: 'list-arns-reserved-names',
+    description: 'Get all reserved ArNS names',
+    options: paginationOptions,
+    action: listArNSReservedNames,
+});
+makeCommand({
+    name: 'list-arns-returned-names',
+    description: 'Get all ArNS recently returned names',
+    options: paginationOptions,
+    action: listArNSReturnedNames,
+});
+makeCommand({
+    name: 'list-vaults',
+    description: 'Get all wallet vaults',
+    options: paginationOptions,
+    action: (o) => readARIOFromOptions(o)
+        .getVaults(paginationParamsFromOptions(o))
+        .then((result) => result.items.length ? result : { message: 'No vaults found' }),
+});
 makeCommand({
     name: 'list-primary-name-requests',
     description: 'Get primary name requests',
@@ -221,12 +267,6 @@ makeCommand({
         .getPrimaryNameRequests(paginationParamsFromOptions(o))
         .then((result) => result.items.length ? result : { message: 'No requests found' }),
 });
-makeCommand({
-    name: 'get-primary-name',
-    description: 'Get primary name',
-    options: [optionMap.address, optionMap.name],
-    action: getPrimaryName,
-});
 makeCommand({
     name: 'list-primary-names',
     description: 'Get primary names',
@@ -235,18 +275,6 @@ makeCommand({
         .getPrimaryNames(paginationParamsFromOptions(o))
         .then((result) => result.items.length ? result : { message: 'No names found' }),
 });
-makeCommand({
-    name: 'balance',
-    description: 'Get the balance of an address',
-    options: [optionMap.address],
-    action: (options) => readARIOFromOptions(options)
-        .getBalance({ address: requiredAddressFromOptions(options) })
-        .then((result) => ({
-        address: requiredAddressFromOptions(options),
-        mARIOBalance: result,
-        message: `Provided address current has a balance of ${formatARIOWithCommas(new mARIOToken(result).toARIO())} ARIO`,
-    })),
-});
 makeCommand({
     name: 'list-balances',
     description: 'List all balances',
@@ -255,32 +283,13 @@ makeCommand({
         .getBalances(paginationParamsFromOptions(o))
         .then((result) => result.items.length ? result : { message: 'No balances found' }),
 });
-makeCommand({
-    name: 'get-redelegation-fee',
-    description: 'Get redelegation fee',
-    options: [optionMap.address],
-    action: (options) => readARIOFromOptions(options).getRedelegationFee({
-        address: requiredAddressFromOptions(options),
-    }),
-});
-makeCommand({
-    name: 'get-vault',
-    description: 'Get the vault of provided address and vault ID',
-    options: getVaultOptions,
-    action: getVault,
-});
-makeCommand({
-    name: 'get-gateway-vaults',
-    description: 'Get the vaults of a gateway',
-    options: paginationAddressOptions,
-    action: getGatewayVaults,
-});
 makeCommand({
     name: 'list-all-gateway-vaults',
     description: 'List vaults from all gateways',
     options: paginationAddressOptions,
     action: getAllGatewayVaults,
 });
+// # Actions
 makeCommand({
     name: 'transfer',
     description: 'Transfer ARIO to another address',
@@ -416,24 +425,8 @@ makeCommand({
     options: arnsPurchaseOptions,
     action: requestPrimaryNameCLICommand,
 });
-makeCommand({
-    name: 'spawn-ant',
-    description: 'Spawn an ANT process',
-    options: antStateOptions,
-    action: async (options) => {
-        const state = getANTStateFromOptions(options);
-        const antProcessId = await spawnANT({
-            state,
-            signer: requiredAoSignerFromOptions(options),
-            logger: getLoggerFromOptions(options),
-        });
-        return {
-            processId: antProcessId,
-            state,
-            message: `Spawned ANT process with process ID ${antProcessId}`,
-        };
-    },
-});
+// # ANTS
+// # Getters
 makeCommand({
     name: 'get-ant-state',
     description: 'Get the state of an ANT process',
@@ -460,14 +453,6 @@ makeCommand({
         })) ?? { message: 'No record found' });
     },
 });
-makeCommand({
-    name: 'list-ant-records',
-    description: 'Get the records of an ANT process',
-    options: [optionMap.processId],
-    action: async (options) => {
-        return readANTFromOptions(options).getRecords();
-    },
-});
 makeCommand({
     name: 'get-ant-owner',
     description: 'Get the owner of an ANT process',
@@ -476,14 +461,6 @@ makeCommand({
         return readANTFromOptions(options).getOwner();
     },
 });
-makeCommand({
-    name: 'list-ant-controllers',
-    description: 'List the controllers of an ANT process',
-    options: [optionMap.processId],
-    action: async (options) => {
-        return readANTFromOptions(options).getControllers();
-    },
-});
 makeCommand({
     name: 'get-ant-name',
     description: 'Get the name of an ANT process',
@@ -510,6 +487,42 @@ makeCommand({
         });
     },
 });
+// # Spawn
+makeCommand({
+    name: 'spawn-ant',
+    description: 'Spawn an ANT process',
+    options: antStateOptions,
+    action: async (options) => {
+        const state = getANTStateFromOptions(options);
+        const antProcessId = await spawnANT({
+            state,
+            signer: requiredAoSignerFromOptions(options),
+            logger: getLoggerFromOptions(options),
+        });
+        return {
+            processId: antProcessId,
+            state,
+            message: `Spawned ANT process with process ID ${antProcessId}`,
+        };
+    },
+});
+// # ANT Paginated Handlers
+makeCommand({
+    name: 'list-ant-records',
+    description: 'Get the records of an ANT process',
+    options: [optionMap.processId],
+    action: async (options) => {
+        return readANTFromOptions(options).getRecords();
+    },
+});
+makeCommand({
+    name: 'list-ant-controllers',
+    description: 'List the controllers of an ANT process',
+    options: [optionMap.processId],
+    action: async (options) => {
+        return readANTFromOptions(options).getControllers();
+    },
+});
 makeCommand({
     name: 'list-ant-balances',
     description: 'Get the balances of an ANT process',
@@ -518,6 +531,7 @@ makeCommand({
         return readANTFromOptions(options).getBalances();
     },
 });
+// # Actions
 makeCommand({
     name: 'transfer-ant-ownership',
     description: 'Transfer ownership of an ANT process',
@@ -552,6 +566,18 @@ makeCommand({
         }, customTagsFromOptions(options));
     },
 });
+makeCommand({
+    name: 'remove-ant-record',
+    description: 'Remove a record from an ANT process',
+    options: [optionMap.processId, optionMap.undername, ...writeActionOptions],
+    action: async (options) => {
+        const undername = requiredStringFromOptions(options, 'undername');
+        await assertConfirmationPrompt(`Are you sure you want to remove the record with undername ${undername}?`, options);
+        return writeANTFromOptions(options).removeRecord({
+            undername,
+        }, customTagsFromOptions(options));
+    },
+});
 makeCommand({
     name: 'set-ant-record',
     description: 'Set a record of an ANT process. Deprecated: use set-ant-base-name and set-ant-undername',
@@ -570,18 +596,6 @@ makeCommand({
     options: setAntUndernameOptions,
     action: setAntRecordCLICommand,
 });
-makeCommand({
-    name: 'remove-ant-record',
-    description: 'Remove a record from an ANT process',
-    options: [optionMap.processId, optionMap.undername, ...writeActionOptions],
-    action: async (options) => {
-        const undername = requiredStringFromOptions(options, 'undername');
-        await assertConfirmationPrompt(`Are you sure you want to remove the record with undername ${undername}?`, options);
-        return writeANTFromOptions(options).removeRecord({
-            undername,
-        }, customTagsFromOptions(options));
-    },
-});
 makeCommand({
     name: 'set-ant-ticker',
     description: 'Set the ticker of an ANT process',
@@ -642,11 +656,11 @@ makeCommand({
         const txId = requiredStringFromOptions(options, 'transactionId');
         await assertConfirmationPrompt(`Are you sure you want to set the ANT logo to target Arweave TxID ${txId}?`, options);
         return writeANTFromOptions(options).setLogo({
-            // TODO: Could take a logo file, upload it to Arweave, get transaction ID
             txId,
         }, customTagsFromOptions(options));
     },
 });
+// # ARIO Actions
 makeCommand({
     name: 'release-name',
     description: 'Release the name of an ANT process',
@@ -713,6 +727,7 @@ makeCommand({
         }, customTagsFromOptions(options));
     },
 });
+// # Utilities
 makeCommand({
     name: 'write-action',
     description: 'Send a write action to an AO Process',

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

@@ -165,3 +165,8 @@ export async function getVault(o) {
         message: `No vault found for provided address and vault ID`,
     });
 }
+export async function resolveArNSName(o) {
+    const name = requiredStringFromOptions(o, 'name');
+    const result = await readARIOFromOptions(o).resolveArNSName({ name });
+    return result ?? { message: `No record found for name ${name}` };
+}

package/lib/esm/cli/options.js

@@ -49,6 +49,10 @@ export const optionMap = {
         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',
@@ -269,9 +273,15 @@ export const optionMap = {
         alias: '--logo <logo>',
         description: 'The ANT logo',
     },
+    token: {
+        alias: '-t, --token <type>',
+        description: 'Crypto token type for wallet or action',
+        default: 'arweave',
+    },
 };
 export const walletOptions = [
     optionMap.walletFile,
+    optionMap.token,
     // optionMap.mnemonic,
     optionMap.privateKey,
 ];
@@ -289,6 +299,7 @@ export const arnsPurchaseOptions = [
     ...writeActionOptions,
     optionMap.name,
     optionMap.fundFrom,
+    optionMap.paymentUrl,
 ];
 export const epochOptions = [optionMap.epochIndex, optionMap.timestamp];
 export const addressAndVaultIdOptions = [optionMap.address, optionMap.vaultId];
@@ -312,6 +323,7 @@ export const tokenCostOptions = [
     optionMap.quantity,
     optionMap.address,
     optionMap.fundFrom,
+    optionMap.paymentUrl,
 ];
 export const transferOptions = [
     ...writeActionOptions,