@ar.io/sdk 3.4.0-alpha.2 → 3.4.0-alpha.3

package/lib/cjs/cli/cli.js

@@ -21,6 +21,7 @@ const commander_1 = require("commander");
 const index_js_1 = require("../node/index.js");
 const token_js_1 = require("../types/token.js");
 const version_js_1 = require("../version.js");
+const antCommands_js_1 = require("./commands/antCommands.js");
 const arnsPurchaseCommands_js_1 = require("./commands/arnsPurchaseCommands.js");
 const gatewayWriteCommands_js_1 = require("./commands/gatewayWriteCommands.js");
 const readCommands_js_1 = require("./commands/readCommands.js");
@@ -519,25 +520,21 @@ const utils_js_1 = require("./utils.js");
 });
 (0, utils_js_1.makeCommand)({
     name: 'set-ant-record',
-    description: 'Set a record of an ANT process',
-    options: [
-        options_js_1.optionMap.processId,
-        options_js_1.optionMap.undername,
-        options_js_1.optionMap.transactionId,
-        options_js_1.optionMap.ttlSeconds,
-        ...options_js_1.writeActionOptions,
-    ],
-    action: async (options) => {
-        const ttlSeconds = options.ttlSeconds ?? 3600;
-        const undername = (0, utils_js_1.requiredStringFromOptions)(options, 'undername');
-        const transactionId = (0, utils_js_1.requiredStringFromOptions)(options, 'transactionId');
-        await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this record?\n${JSON.stringify({ undername, transactionId, ttlSeconds }, null, 2)}`, options);
-        return (0, utils_js_1.writeANTFromOptions)(options).setRecord({
-            undername,
-            transactionId,
-            ttlSeconds,
-        }, (0, utils_js_1.writeActionTagsFromOptions)(options));
-    },
+    description: 'Set a record of an ANT process. Deprecated: use set-ant-base-name and set-ant-undername',
+    options: options_js_1.setAntUndernameOptions,
+    action: antCommands_js_1.setAntRecordCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'set-ant-base-name',
+    description: 'Set the base name of an ANT process',
+    options: options_js_1.setAntBaseNameOptions,
+    action: antCommands_js_1.setAntBaseNameCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'set-ant-undername',
+    description: 'Set an undername of an ANT process',
+    options: options_js_1.setAntUndernameOptions,
+    action: antCommands_js_1.setAntRecordCLICommand,
 });
 (0, utils_js_1.makeCommand)({
     name: 'remove-ant-record',

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setAntUndernameCLICommand = exports.setAntBaseNameCLICommand = exports.setAntRecordCLICommand = void 0;
+const utils_js_1 = require("../utils.js");
+/** @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);
+    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({ undername, transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).setRecord({
+        undername,
+        transactionId,
+        ttlSeconds,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+}
+exports.setAntRecordCLICommand = setAntRecordCLICommand;
+async function setAntBaseNameCLICommand(o) {
+    const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
+    const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
+    const writeAnt = (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({ transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).setBaseNameRecord({
+        transactionId,
+        ttlSeconds,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+}
+exports.setAntBaseNameCLICommand = setAntBaseNameCLICommand;
+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 writeAnt = (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({ undername, transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).setUndernameRecord({
+        undername,
+        transactionId,
+        ttlSeconds,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+}
+exports.setAntUndernameCLICommand = setAntUndernameCLICommand;

package/lib/cjs/cli/options.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.antStateOptions = exports.buyRecordOptions = exports.joinNetworkOptions = exports.updateGatewaySettingsOptions = exports.decreaseDelegateStakeOptions = exports.delegateStakeOptions = exports.redelegateStakeOptions = exports.operatorStakeOptions = exports.vaultedTransferOptions = exports.transferOptions = exports.tokenCostOptions = exports.getVaultOptions = exports.paginationAddressOptions = exports.paginationOptions = exports.nameWriteOptions = exports.addressAndVaultIdOptions = exports.epochOptions = exports.arnsPurchaseOptions = exports.writeActionOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+exports.setAntUndernameOptions = exports.setAntBaseNameOptions = exports.antStateOptions = exports.buyRecordOptions = exports.joinNetworkOptions = exports.updateGatewaySettingsOptions = exports.decreaseDelegateStakeOptions = exports.delegateStakeOptions = exports.redelegateStakeOptions = exports.operatorStakeOptions = exports.vaultedTransferOptions = exports.transferOptions = exports.tokenCostOptions = exports.getVaultOptions = exports.paginationAddressOptions = exports.paginationOptions = exports.nameWriteOptions = exports.addressAndVaultIdOptions = exports.epochOptions = exports.arnsPurchaseOptions = exports.writeActionOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
 exports.optionMap = {
     walletFile: {
         alias: '-w, --wallet-file <walletFilePath>',
@@ -354,3 +354,13 @@ exports.antStateOptions = [
     exports.optionMap.controllers,
     exports.optionMap.ttlSeconds,
 ];
+exports.setAntBaseNameOptions = [
+    exports.optionMap.processId,
+    exports.optionMap.transactionId,
+    exports.optionMap.ttlSeconds,
+    ...exports.writeActionOptions,
+];
+exports.setAntUndernameOptions = [
+    ...exports.setAntBaseNameOptions,
+    exports.optionMap.undername,
+];

package/lib/cjs/cli/utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fundFromFromOptions = exports.getTokenCostParamsFromOptions = exports.getANTStateFromOptions = exports.requiredPositiveIntegerFromOptions = exports.positiveIntegerFromOptions = exports.requiredStringArrayFromOptions = exports.requiredStringFromOptions = exports.booleanFromOptions = exports.writeANTFromOptions = exports.readANTFromOptions = exports.requiredProcessIdFromOptions = exports.assertConfirmationPrompt = exports.confirmationPrompt = exports.assertEnoughMARIOBalance = exports.assertEnoughBalanceForArNSPurchase = exports.requiredMARIOFromOptions = exports.recordTypeFromOptions = exports.redelegateParamsFromOptions = exports.requiredTargetAndQuantityFromOptions = exports.gatewaySettingsFromOptions = exports.writeActionTagsFromOptions = exports.requiredInitiatorFromOptions = exports.epochInputFromOptions = exports.paginationParamsFromOptions = exports.requiredAddressFromOptions = exports.addressFromOptions = exports.formatMARIOToARIOWithCommas = exports.formatARIOWithCommas = exports.writeARIOFromOptions = exports.requiredAoSignerFromOptions = exports.requiredContractSignerFromOptions = exports.readARIOFromOptions = exports.getLoggerFromOptions = exports.jwkToAddress = exports.requiredJwkFromOptions = exports.arioProcessIdFromOptions = exports.makeCommand = exports.applyOptions = exports.runCommand = exports.stringifyJsonForCLIDisplay = void 0;
+exports.fundFromFromOptions = exports.getTokenCostParamsFromOptions = exports.getANTStateFromOptions = exports.requiredPositiveIntegerFromOptions = exports.positiveIntegerFromOptions = exports.requiredStringArrayFromOptions = exports.requiredStringFromOptions = exports.booleanFromOptions = exports.writeANTFromOptions = exports.readANTFromOptions = exports.requiredProcessIdFromOptions = exports.assertConfirmationPrompt = exports.confirmationPrompt = exports.assertEnoughMARIOBalance = exports.assertEnoughBalanceForArNSPurchase = exports.requiredMARIOFromOptions = exports.recordTypeFromOptions = exports.redelegateParamsFromOptions = exports.requiredTargetAndQuantityFromOptions = exports.gatewaySettingsFromOptions = exports.writeActionTagsFromOptions = exports.requiredInitiatorFromOptions = exports.epochInputFromOptions = exports.paginationParamsFromOptions = exports.requiredAddressFromOptions = exports.addressFromOptions = exports.formatMARIOToARIOWithCommas = exports.formatARIOWithCommas = exports.writeARIOFromOptions = exports.requiredAoSignerFromOptions = exports.requiredContractSignerFromOptions = exports.readARIOFromOptions = exports.getLoggerFromOptions = exports.jwkToAddress = exports.requiredJwkFromOptions = exports.arioProcessIdFromOptions = exports.makeCommand = exports.applyOptions = exports.runCommand = exports.stringifyJsonForCLIDisplay = exports.defaultTtlSecondsCLI = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -25,6 +25,7 @@ const fs_1 = require("fs");
 const prompts_1 = __importDefault(require("prompts"));
 const index_js_1 = require("../node/index.js");
 const options_js_1 = require("./options.js");
+exports.defaultTtlSecondsCLI = 3600;
 function stringifyJsonForCLIDisplay(json) {
     return JSON.stringify(json, null, 2);
 }
@@ -428,7 +429,9 @@ function getANTStateFromOptions(options) {
         ticker: options.ticker,
         name: options.name,
         keywords: options.keywords,
-        ttlSeconds: options.ttlSeconds !== undefined ? +options.ttlSeconds : 3600,
+        ttlSeconds: options.ttlSeconds !== undefined
+            ? +options.ttlSeconds
+            : exports.defaultTtlSecondsCLI,
     });
 }
 exports.getANTStateFromOptions = getANTStateFromOptions;

package/lib/cjs/common/ant.js

@@ -34,6 +34,7 @@ class ANT {
 exports.ANT = ANT;
 class AoANTReadable {
     process;
+    processId;
     strict;
     constructor(config) {
         this.strict = config.strict || false;
@@ -48,6 +49,7 @@ class AoANTReadable {
         else {
             throw new index_js_2.InvalidContractConfigurationError();
         }
+        this.processId = this.process.processId;
     }
     async getState({ strict } = { strict: this.strict }) {
         const tags = [{ name: 'Action', value: 'State' }];
@@ -292,12 +294,8 @@ class AoANTWriteable extends AoANTReadable {
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
-     * @example
-     * ```ts
-     * ant.setController({ controller: "fGht8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5-5dV7nk" });
-     * ```
      */
-    async setRecord({ undername, transactionId, ttlSeconds, }, options) {
+    async setRecord({ undername, transactionId, ttlSeconds }, options) {
         return this.process.send({
             tags: [
                 ...(options?.tags ?? []),
@@ -320,16 +318,12 @@ class AoANTWriteable extends AoANTReadable {
      * ant.setBaseNameRecord({ transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    async setBaseNameRecord({ transactionId, ttlSeconds, }) {
-        return this.process.send({
-            tags: [
-                { name: 'Action', value: 'Set-Record' },
-                { name: 'Sub-Domain', value: '@' },
-                { name: 'Transaction-Id', value: transactionId },
-                { name: 'TTL-Seconds', value: ttlSeconds.toString() },
-            ],
-            signer: this.signer,
-        });
+    async setBaseNameRecord({ transactionId, ttlSeconds }, options) {
+        return this.setRecord({
+            transactionId,
+            ttlSeconds,
+            undername: '@',
+        }, options);
     }
     /**
      * Adds or updates an undername of the ANT. An undername is appended to the base name of the ANT (e.g. ardrive.ar.io) to form a fully qualified name (e.g. dapp_ardrive.ar.io)
@@ -343,12 +337,12 @@ class AoANTWriteable extends AoANTReadable {
      * ant.setUndernameRecord({ undername: "dapp", transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // dapp_ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    async setUndernameRecord({ undername, transactionId, ttlSeconds, }) {
+    async setUndernameRecord({ undername, transactionId, ttlSeconds }, options) {
         return this.setRecord({
             undername,
             transactionId,
             ttlSeconds,
-        });
+        }, options);
     }
     /**
      * Removes an undername from the ANT. This will remove the undername from the ANT.

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.4.0-alpha.2';
+exports.version = '3.4.0-alpha.3';

package/lib/esm/cli/cli.js

@@ -19,11 +19,12 @@ import { program } from 'commander';
 import { AOProcess, spawnANT } from '../node/index.js';
 import { mARIOToken } from '../types/token.js';
 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 { revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
-import { addressAndVaultIdOptions, antStateOptions, arnsPurchaseOptions, buyRecordOptions, decreaseDelegateStakeOptions, delegateStakeOptions, epochOptions, getVaultOptions, globalOptions, joinNetworkOptions, operatorStakeOptions, optionMap, paginationAddressOptions, paginationOptions, redelegateStakeOptions, tokenCostOptions, transferOptions, updateGatewaySettingsOptions, vaultedTransferOptions, writeActionOptions, } from './options.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, epochInputFromOptions, formatARIOWithCommas, getANTStateFromOptions, getLoggerFromOptions, makeCommand, paginationParamsFromOptions, readANTFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredAoSignerFromOptions, requiredProcessIdFromOptions, requiredStringArrayFromOptions, requiredStringFromOptions, writeANTFromOptions, writeActionTagsFromOptions, } from './utils.js';
 applyOptions(program
     .name('ar.io')
@@ -517,25 +518,21 @@ makeCommand({
 });
 makeCommand({
     name: 'set-ant-record',
-    description: 'Set a record of an ANT process',
-    options: [
-        optionMap.processId,
-        optionMap.undername,
-        optionMap.transactionId,
-        optionMap.ttlSeconds,
-        ...writeActionOptions,
-    ],
-    action: async (options) => {
-        const ttlSeconds = options.ttlSeconds ?? 3600;
-        const undername = requiredStringFromOptions(options, 'undername');
-        const transactionId = requiredStringFromOptions(options, 'transactionId');
-        await assertConfirmationPrompt(`Are you sure you want to set this record?\n${JSON.stringify({ undername, transactionId, ttlSeconds }, null, 2)}`, options);
-        return writeANTFromOptions(options).setRecord({
-            undername,
-            transactionId,
-            ttlSeconds,
-        }, writeActionTagsFromOptions(options));
-    },
+    description: 'Set a record of an ANT process. Deprecated: use set-ant-base-name and set-ant-undername',
+    options: setAntUndernameOptions,
+    action: setAntRecordCLICommand,
+});
+makeCommand({
+    name: 'set-ant-base-name',
+    description: 'Set the base name of an ANT process',
+    options: setAntBaseNameOptions,
+    action: setAntBaseNameCLICommand,
+});
+makeCommand({
+    name: 'set-ant-undername',
+    description: 'Set an undername of an ANT process',
+    options: setAntUndernameOptions,
+    action: setAntRecordCLICommand,
 });
 makeCommand({
     name: 'remove-ant-record',

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

@@ -0,0 +1,42 @@
+import { assertConfirmationPrompt, defaultTtlSecondsCLI, requiredStringFromOptions, writeANTFromOptions, writeActionTagsFromOptions, } from '../utils.js';
+/** @deprecated -- use set-ant-base-name and set-ant-undername */
+export async function setAntRecordCLICommand(o) {
+    const ttlSeconds = +(o.ttlSeconds ?? defaultTtlSecondsCLI);
+    const undername = requiredStringFromOptions(o, 'undername');
+    const transactionId = requiredStringFromOptions(o, 'transactionId');
+    const writeAnt = writeANTFromOptions(o);
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to set this record on the ANT process ${writeAnt.processId}?\n${JSON.stringify({ undername, transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).setRecord({
+        undername,
+        transactionId,
+        ttlSeconds,
+    }, writeActionTagsFromOptions(o));
+}
+export async function setAntBaseNameCLICommand(o) {
+    const ttlSeconds = +(o.ttlSeconds ?? defaultTtlSecondsCLI);
+    const transactionId = requiredStringFromOptions(o, 'transactionId');
+    const writeAnt = writeANTFromOptions(o);
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to set this base name on the ANT process ${writeAnt.processId}?\n${JSON.stringify({ transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).setBaseNameRecord({
+        transactionId,
+        ttlSeconds,
+    }, writeActionTagsFromOptions(o));
+}
+export async function setAntUndernameCLICommand(o) {
+    const ttlSeconds = +(o.ttlSeconds ?? defaultTtlSecondsCLI);
+    const undername = requiredStringFromOptions(o, 'undername');
+    const transactionId = requiredStringFromOptions(o, 'transactionId');
+    const writeAnt = writeANTFromOptions(o);
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to set this undername on the ANT process ${writeAnt.processId}?\n${JSON.stringify({ undername, transactionId, ttlSeconds }, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).setUndernameRecord({
+        undername,
+        transactionId,
+        ttlSeconds,
+    }, writeActionTagsFromOptions(o));
+}

package/lib/esm/cli/options.js

@@ -351,3 +351,13 @@ export const antStateOptions = [
     optionMap.controllers,
     optionMap.ttlSeconds,
 ];
+export const setAntBaseNameOptions = [
+    optionMap.processId,
+    optionMap.transactionId,
+    optionMap.ttlSeconds,
+    ...writeActionOptions,
+];
+export const setAntUndernameOptions = [
+    ...setAntBaseNameOptions,
+    optionMap.undername,
+];

package/lib/esm/cli/utils.js

@@ -19,6 +19,7 @@ import { readFileSync } from 'fs';
 import prompts from 'prompts';
 import { ANT, AOProcess, ARIO, ARIOToken, ARIO_DEVNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, ArweaveSigner, Logger, createAoSigner, fromB64Url, fundFromOptions, initANTStateForAddress, isValidFundFrom, isValidIntent, mARIOToken, sha256B64Url, validIntents, } from '../node/index.js';
 import { globalOptions } from './options.js';
+export const defaultTtlSecondsCLI = 3600;
 export function stringifyJsonForCLIDisplay(json) {
     return JSON.stringify(json, null, 2);
 }
@@ -385,7 +386,9 @@ export function getANTStateFromOptions(options) {
         ticker: options.ticker,
         name: options.name,
         keywords: options.keywords,
-        ttlSeconds: options.ttlSeconds !== undefined ? +options.ttlSeconds : 3600,
+        ttlSeconds: options.ttlSeconds !== undefined
+            ? +options.ttlSeconds
+            : defaultTtlSecondsCLI,
     });
 }
 export function getTokenCostParamsFromOptions(o) {

package/lib/esm/common/ant.js

@@ -30,6 +30,7 @@ export class ANT {
 }
 export class AoANTReadable {
     process;
+    processId;
     strict;
     constructor(config) {
         this.strict = config.strict || false;
@@ -44,6 +45,7 @@ export class AoANTReadable {
         else {
             throw new InvalidContractConfigurationError();
         }
+        this.processId = this.process.processId;
     }
     async getState({ strict } = { strict: this.strict }) {
         const tags = [{ name: 'Action', value: 'State' }];
@@ -287,12 +289,8 @@ export class AoANTWriteable extends AoANTReadable {
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
-     * @example
-     * ```ts
-     * ant.setController({ controller: "fGht8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5-5dV7nk" });
-     * ```
      */
-    async setRecord({ undername, transactionId, ttlSeconds, }, options) {
+    async setRecord({ undername, transactionId, ttlSeconds }, options) {
         return this.process.send({
             tags: [
                 ...(options?.tags ?? []),
@@ -315,16 +313,12 @@ export class AoANTWriteable extends AoANTReadable {
      * ant.setBaseNameRecord({ transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    async setBaseNameRecord({ transactionId, ttlSeconds, }) {
-        return this.process.send({
-            tags: [
-                { name: 'Action', value: 'Set-Record' },
-                { name: 'Sub-Domain', value: '@' },
-                { name: 'Transaction-Id', value: transactionId },
-                { name: 'TTL-Seconds', value: ttlSeconds.toString() },
-            ],
-            signer: this.signer,
-        });
+    async setBaseNameRecord({ transactionId, ttlSeconds }, options) {
+        return this.setRecord({
+            transactionId,
+            ttlSeconds,
+            undername: '@',
+        }, options);
     }
     /**
      * Adds or updates an undername of the ANT. An undername is appended to the base name of the ANT (e.g. ardrive.ar.io) to form a fully qualified name (e.g. dapp_ardrive.ar.io)
@@ -338,12 +332,12 @@ export class AoANTWriteable extends AoANTReadable {
      * ant.setUndernameRecord({ undername: "dapp", transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // dapp_ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    async setUndernameRecord({ undername, transactionId, ttlSeconds, }) {
+    async setUndernameRecord({ undername, transactionId, ttlSeconds }, options) {
         return this.setRecord({
             undername,
             transactionId,
             ttlSeconds,
-        });
+        }, options);
     }
     /**
      * Removes an undername from the ANT. This will remove the undername from the ANT.

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '3.4.0-alpha.2';
+export const version = '3.4.0-alpha.3';

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

@@ -0,0 +1,21 @@
+/**
+ * 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.
+ */
+import { AoANTSetBaseNameRecordParams, AoANTSetUndernameRecordParams } from '../../types/ant.js';
+import { CLIWriteOptionsFromAoAntParams } from '../types.js';
+/** @deprecated -- use set-ant-base-name and set-ant-undername */
+export declare function setAntRecordCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetUndernameRecordParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function setAntBaseNameCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetBaseNameRecordParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function setAntUndernameCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetUndernameRecordParams>): Promise<import("../../types/common.js").AoMessageResult>;

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

@@ -333,3 +333,11 @@ export declare const antStateOptions: {
     alias: string;
     description: string;
 }[];
+export declare const setAntBaseNameOptions: {
+    alias: string;
+    description: string;
+}[];
+export declare const setAntUndernameOptions: {
+    alias: string;
+    description: string;
+}[];

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

@@ -49,6 +49,9 @@ export type CLIOptionsFromAoParams<T> = {
 };
 export type CLIReadOptionsFromAoParams<T> = CLIOptionsFromAoParams<T> & GlobalCLIOptions;
 export type CLIWriteOptionsFromAoParams<T> = WriteActionCLIOptions & CLIOptionsFromAoParams<T>;
+export type CLIWriteOptionsFromAoAntParams<T> = CLIWriteOptionsFromAoParams<T & {
+    processId: string;
+}>;
 export type PaginationCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<PaginationParams>;
 export type AddressCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AoAddressParams>;
 export type ProcessIdCLIOptions = GlobalCLIOptions & {

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

@@ -2,6 +2,7 @@ import { JWKInterface } from 'arweave/node/lib/wallet.js';
 import { Command, OptionValues } from 'commander';
 import { ARIOToken, AoANTRead, 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';
+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>;
 export interface CommanderOption {

package/lib/types/common/ant.d.ts

@@ -1,4 +1,4 @@
-import { AntReadOptions, AoANTHandler, AoANTInfo, AoANTRead, AoANTRecord, AoANTState, AoANTWrite } from '../types/ant.js';
+import { AntReadOptions, AoANTHandler, AoANTInfo, AoANTRead, AoANTRecord, AoANTSetBaseNameRecordParams, AoANTSetUndernameRecordParams, AoANTState, AoANTWrite } from '../types/ant.js';
 import { AoMessageResult, ProcessConfiguration, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
 import { AOProcess } from './index.js';
 type ANTConfigOptionalStrict = Required<ProcessConfiguration> & {
@@ -12,6 +12,7 @@ export declare class ANT {
 }
 export declare class AoANTReadable implements AoANTRead {
     protected process: AOProcess;
+    readonly processId: string;
     private strict;
     constructor(config: ANTConfigOptionalStrict);
     getState({ strict }?: AntReadOptions): Promise<AoANTState>;
@@ -154,16 +155,8 @@ export declare class AoANTWriteable extends AoANTReadable implements AoANTWrite
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
-     * @example
-     * ```ts
-     * ant.setController({ controller: "fGht8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5-5dV7nk" });
-     * ```
      */
-    setRecord({ undername, transactionId, ttlSeconds, }: {
-        undername: string;
-        transactionId: string;
-        ttlSeconds: number;
-    }, options?: WriteOptions): Promise<AoMessageResult>;
+    setRecord({ undername, transactionId, ttlSeconds }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Sets the top level name of the ANT. This is the name that will be used to resolve the ANT (e.g. ardrive.ar.io)
      *
@@ -175,10 +168,7 @@ export declare class AoANTWriteable extends AoANTReadable implements AoANTWrite
      * ant.setBaseNameRecord({ transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    setBaseNameRecord({ transactionId, ttlSeconds, }: {
-        transactionId: string;
-        ttlSeconds: number;
-    }): Promise<AoMessageResult>;
+    setBaseNameRecord({ transactionId, ttlSeconds }: AoANTSetBaseNameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Adds or updates an undername of the ANT. An undername is appended to the base name of the ANT (e.g. ardrive.ar.io) to form a fully qualified name (e.g. dapp_ardrive.ar.io)
      *
@@ -191,11 +181,7 @@ export declare class AoANTWriteable extends AoANTReadable implements AoANTWrite
      * ant.setUndernameRecord({ undername: "dapp", transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // dapp_ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    setUndernameRecord({ undername, transactionId, ttlSeconds, }: {
-        undername: string;
-        transactionId: string;
-        ttlSeconds: number;
-    }): Promise<AoMessageResult>;
+    setUndernameRecord({ undername, transactionId, ttlSeconds }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Removes an undername from the ANT. This will remove the undername from the ANT.
      *