@ar.io/sdk 3.19.0-alpha.9 → 3.20.0-alpha.1

package/lib/cjs/cli/cli.js

@@ -536,6 +536,7 @@ const utils_js_1 = require("./utils.js");
             state,
             signer: (0, utils_js_1.requiredAoSignerFromOptions)(options),
             logger: (0, utils_js_1.getLoggerFromOptions)(options),
+            ...(options.module !== undefined ? { module: options.module } : {}),
         });
         return {
             processId: antProcessId,
@@ -632,7 +633,13 @@ const utils_js_1 = require("./utils.js");
     name: 'set-ant-undername',
     description: 'Set an undername of an ANT process',
     options: options_js_1.setAntUndernameOptions,
-    action: antCommands_js_1.setAntRecordCLICommand,
+    action: antCommands_js_1.setAntUndernameCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'transfer-record',
+    description: 'Transfer ownership of a specific record (undername) to another address',
+    options: options_js_1.transferRecordOwnershipOptions,
+    action: antCommands_js_1.transferRecordOwnershipCLICommand,
 });
 (0, utils_js_1.makeCommand)({
     name: 'upgrade-ant',

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setAntRecordCLICommand = setAntRecordCLICommand;
 exports.setAntBaseNameCLICommand = setAntBaseNameCLICommand;
 exports.setAntUndernameCLICommand = setAntUndernameCLICommand;
+exports.transferRecordOwnershipCLICommand = transferRecordOwnershipCLICommand;
 exports.upgradeAntCLICommand = upgradeAntCLICommand;
 const utils_js_1 = require("../utils.js");
 /** @deprecated -- use set-ant-base-name and set-ant-undername */
@@ -11,40 +12,55 @@ async function setAntRecordCLICommand(o) {
     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({
+    const recordParams = {
         undername,
         transactionId,
         ttlSeconds,
-    }, (0, utils_js_1.customTagsFromOptions)(o));
+        ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
+    };
+    if (!o.skipConfirmation) {
+        await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this record on the ANT process ${writeAnt.processId}?\n${JSON.stringify(recordParams, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).setRecord(recordParams, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function setAntBaseNameCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
     const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
+    const params = {
+        transactionId,
+        ttlSeconds,
+        ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
+    };
     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);
+        await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set this base name on the ANT process ${writeAnt.processId}?\n${JSON.stringify(params, null, 2)}`, o);
     }
-    return (0, utils_js_1.writeANTFromOptions)(o).setBaseNameRecord({
-        transactionId,
-        ttlSeconds,
-    }, (0, utils_js_1.customTagsFromOptions)(o));
+    return (0, utils_js_1.writeANTFromOptions)(o).setBaseNameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function setAntUndernameCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? utils_js_1.defaultTtlSecondsCLI);
     const undername = (0, utils_js_1.requiredStringFromOptions)(o, 'undername');
     const transactionId = (0, utils_js_1.requiredStringFromOptions)(o, 'transactionId');
-    const 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({
+    const params = {
         undername,
         transactionId,
         ttlSeconds,
-    }, (0, utils_js_1.customTagsFromOptions)(o));
+        ...(0, utils_js_1.antRecordMetadataFromOptions)(o),
+    };
+    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(params, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).setUndernameRecord(params, (0, utils_js_1.customTagsFromOptions)(o));
+}
+async function transferRecordOwnershipCLICommand(o) {
+    const undername = (0, utils_js_1.requiredStringFromOptions)(o, 'undername');
+    const recipient = (0, utils_js_1.requiredStringFromOptions)(o, 'recipient');
+    const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);
+    if (!o.skipConfirmation) {
+        await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to transfer ownership of "${undername}" to "${recipient}" on ANT process ${writeAnt.processId}?\n${JSON.stringify({ undername, recipient }, null, 2)}`, o);
+    }
+    return (0, utils_js_1.writeANTFromOptions)(o).transferRecord({ undername, recipient }, (0, utils_js_1.customTagsFromOptions)(o));
 }
 async function upgradeAntCLICommand(o) {
     const writeAnt = (0, utils_js_1.writeANTFromOptions)(o);

package/lib/cjs/cli/options.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.upgradeAntOptions = 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.transferRecordOwnershipOptions = exports.upgradeAntOptions = 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>',
@@ -254,6 +254,14 @@ exports.optionMap = {
         description: 'The keywords for the ANT',
         type: 'array',
     },
+    owner: {
+        alias: '--owner <owner>',
+        description: 'The owner address for the record',
+    },
+    displayName: {
+        alias: '--display-name <displayName>',
+        description: 'The display name for the record',
+    },
     names: {
         alias: '--names <names...>',
         description: 'The names to interact with',
@@ -289,6 +297,10 @@ exports.optionMap = {
         alias: '--logo <logo>',
         description: 'The ANT logo',
     },
+    module: {
+        alias: '--module <module>',
+        description: 'The module ID to use for spawning the ANT process',
+    },
     token: {
         alias: '-t, --token <type>',
         description: 'Crypto token type for wallet or action',
@@ -416,11 +428,17 @@ exports.antStateOptions = [
     exports.optionMap.controllers,
     exports.optionMap.ttlSeconds,
     exports.optionMap.logo,
+    exports.optionMap.module,
 ];
 exports.setAntBaseNameOptions = [
     exports.optionMap.processId,
     exports.optionMap.transactionId,
     exports.optionMap.ttlSeconds,
+    exports.optionMap.owner,
+    exports.optionMap.displayName,
+    exports.optionMap.logo,
+    exports.optionMap.description,
+    exports.optionMap.keywords,
     ...exports.writeActionOptions,
 ];
 exports.setAntUndernameOptions = [
@@ -433,3 +451,9 @@ exports.upgradeAntOptions = [
     exports.optionMap.reassignAffiliatedNames,
     ...exports.writeActionOptions,
 ];
+exports.transferRecordOwnershipOptions = [
+    exports.optionMap.processId,
+    exports.optionMap.undername,
+    exports.optionMap.recipient,
+    ...exports.writeActionOptions,
+];

package/lib/cjs/cli/utils.js

@@ -50,6 +50,7 @@ exports.getTokenCostParamsFromOptions = getTokenCostParamsFromOptions;
 exports.fundFromFromOptions = fundFromFromOptions;
 exports.referrerFromOptions = referrerFromOptions;
 exports.assertLockLengthInRange = assertLockLengthInRange;
+exports.antRecordMetadataFromOptions = antRecordMetadataFromOptions;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -559,3 +560,16 @@ function assertLockLengthInRange(lockLengthMs, assertMin = true) {
         throw new Error(`Lock length must be at least 14 days (1209600000 ms). Provided lock length: ${lockLengthMs} ms`);
     }
 }
+function antRecordMetadataFromOptions(options) {
+    return {
+        ...(options.owner != null &&
+            options.owner !== '' && { owner: options.owner }),
+        ...(options.displayName != null &&
+            options.displayName !== '' && { displayName: options.displayName }),
+        ...(options.logo != null && options.logo !== '' && { logo: options.logo }),
+        ...(options.description != null &&
+            options.description !== '' && { description: options.description }),
+        ...(options.keywords != null &&
+            options.keywords.length > 0 && { keywords: options.keywords }),
+    };
+}

package/lib/cjs/common/ant.js

@@ -396,7 +396,7 @@ class AoANTReadable {
         query {
           transactions(
             ids: ["${this.processId}"]
-            first: 1,
+            first: 1
           ) {
             edges {
               node {
@@ -763,17 +763,31 @@ class AoANTWriteable extends AoANTReadable {
      * @param undername @type {string} The record you want to set the transactionId and ttlSeconds of.
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      */
-    async setRecord({ undername, transactionId, ttlSeconds }, options) {
+    async setRecord({ undername, transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }, options) {
+        const tags = [
+            ...(options?.tags ?? []),
+            { name: 'Action', value: 'Set-Record' },
+            { name: 'Sub-Domain', value: undername },
+            { name: 'Transaction-Id', value: transactionId },
+            { name: 'TTL-Seconds', value: ttlSeconds.toString() },
+            { name: 'Record-Owner', value: owner },
+            { name: 'Display-Name', value: displayName },
+            { name: 'Logo', value: logo },
+            { name: 'Description', value: description },
+            {
+                name: 'Keywords',
+                value: keywords ? JSON.stringify(keywords) : undefined,
+            },
+        ].filter((tag) => tag.value !== undefined);
         return this.process.send({
-            tags: [
-                ...(options?.tags ?? []),
-                { name: 'Action', value: 'Set-Record' },
-                { name: 'Sub-Domain', value: undername },
-                { name: 'Transaction-Id', value: transactionId },
-                { name: 'TTL-Seconds', value: ttlSeconds.toString() },
-            ],
+            tags,
             signer: this.signer,
         });
     }
@@ -782,17 +796,27 @@ class AoANTWriteable extends AoANTReadable {
      *
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      * @example
      * ```ts
      * 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 }, options) {
+    async setBaseNameRecord({ transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }, options) {
         return this.setRecord({
             transactionId,
             ttlSeconds,
             undername: '@',
+            owner,
+            displayName,
+            logo,
+            description,
+            keywords,
         }, options);
     }
     /**
@@ -801,17 +825,27 @@ class AoANTWriteable extends AoANTReadable {
      * @param undername @type {string} The undername of the ANT.
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      * @example
      * ```ts
      * 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 }, options) {
+    async setUndernameRecord({ undername, transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }, options) {
         return this.setRecord({
             undername,
             transactionId,
             ttlSeconds,
+            owner,
+            displayName,
+            logo,
+            description,
+            keywords,
         }, options);
     }
     /**
@@ -1034,7 +1068,9 @@ class AoANTWriteable extends AoANTReadable {
      * ant.removePrimaryNames({ names: ["ardrive", "dapp_ardrive"], arioProcessId: ARIO_MAINNET_PROCESS_ID, notifyOwners: true }); // removes the primary names and associated wallet addresses assigned to "ardrive" and "dapp_ardrive"
      * ```
      */
-    async removePrimaryNames({ names, arioProcessId, notifyOwners = false, }, options) {
+    async removePrimaryNames({ names, arioProcessId, 
+    // TODO: remove this param, its not used on the ANT contract
+    notifyOwners = false, }, options) {
         return this.process.send({
             tags: [
                 ...(options?.tags ?? []),
@@ -1103,5 +1139,27 @@ class AoANTWriteable extends AoANTReadable {
             });
         }
     }
+    /**
+     * Transfers ownership of a specific record (undername) to another address. This allows delegation of control for individual records within an ANT while maintaining the ANT owner's ultimate authority.
+     *
+     * @param undername @type {string} The subdomain/record whose ownership you want to transfer.
+     * @param recipient @type {string} The address of the new owner for this record.
+     * @returns {Promise<AoMessageResult>} The result of the interaction.
+     * @example
+     * ```ts
+     * ant.transferRecord({ undername: "alice", recipient: "new-owner-address-123..." }); // transfers ownership of the "alice" record to the new owner
+     * ```
+     */
+    async transferRecord({ undername, recipient, }, options) {
+        return this.process.send({
+            tags: [
+                ...(options?.tags ?? []),
+                { name: 'Action', value: 'Transfer-Record' },
+                { name: 'Sub-Domain', value: undername },
+                { name: 'Recipient', value: recipient },
+            ],
+            signer: this.signer,
+        });
+    }
 }
 exports.AoANTWriteable = AoANTWriteable;

package/lib/cjs/common/io.js

@@ -684,12 +684,12 @@ class ARIOReadable {
      * @returns {Promise<AoArNSNameData[]>} The ARNS names associated with the address
      */
     async getArNSRecordsForAddress(params) {
-        const { antRegistryId = constants_js_1.ANT_REGISTRY_ID, address } = params;
+        const { antRegistryProcessId = constants_js_1.ANT_REGISTRY_ID, address } = params;
         const antRegistry = ant_registry_js_1.ANTRegistry.init({
             hyperbeamUrl: this.hyperbeamUrl,
             process: new ao_process_js_1.AOProcess({
                 ao: this.process.ao,
-                processId: antRegistryId,
+                processId: antRegistryProcessId,
             }),
         });
         // Note: there could be a race condition here if the ACL changes during pagination requests, resulting in different results from the `getArNSRecords`.

package/lib/cjs/types/ant.js

@@ -55,6 +55,23 @@ exports.AntRecordSchema = zod_1.z.object({
     transactionId: exports.ArweaveTxIdSchema.describe('The Target ID of the undername'),
     ttlSeconds: zod_1.z.number(),
     priority: zod_1.z.number().optional(),
+    owner: exports.AOAddressSchema.describe('The owner address of the record').optional(),
+    displayName: zod_1.z
+        .string()
+        .max(61)
+        .describe('Display name of the record (max 61 chars)')
+        .optional(),
+    logo: exports.ArweaveTxIdSchema.describe('Logo transaction ID for the record').optional(),
+    description: zod_1.z
+        .string()
+        .max(512)
+        .describe('Description of the record (max 512 chars)')
+        .optional(),
+    keywords: zod_1.z
+        .array(zod_1.z.string().max(32))
+        .max(16)
+        .describe('Keywords array (max 16, each max 32 chars)')
+        .optional(),
 });
 exports.AntRecordsSchema = zod_1.z.record(zod_1.z.string(), exports.AntRecordSchema);
 exports.AntControllersSchema = zod_1.z.array(exports.AOAddressSchema.describe('Controller address'));
@@ -120,6 +137,7 @@ exports.AntWriteHandlers = [
     'reassignName',
     'approvePrimaryName',
     'removePrimaryNames',
+    'transferRecordOwnership',
 ];
 exports.AntHandlerNames = [...exports.AntReadHandlers, ...exports.AntWriteHandlers];
 exports.AntHandlersSchema = zod_1.z

package/lib/cjs/utils/processes.js

@@ -26,7 +26,7 @@ const io_js_1 = require("../common/io.js");
 const logger_js_1 = require("../common/logger.js");
 const constants_js_1 = require("../constants.js");
 /**
- * @beta This API is in beta and may change in the future.
+ * @deprecated Use getArNSRecordsForAddress instead
  */
 const getANTProcessesOwnedByWallet = async ({ address, registry = ant_registry_js_1.ANTRegistry.init(), }) => {
     const res = await registry.accessControlList({ address });

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.19.0-alpha.9';
+exports.version = '3.20.0-alpha.1';

package/lib/esm/cli/cli.js

@@ -19,12 +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, upgradeAntCLICommand, } from './commands/antCommands.js';
+import { setAntBaseNameCLICommand, setAntRecordCLICommand, setAntUndernameCLICommand, transferRecordOwnershipCLICommand, upgradeAntCLICommand, } from './commands/antCommands.js';
 import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, setPrimaryNameCLICommand, 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, listAntsForAddress, listArNSRecords, listArNSRecordsForAddress, 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, upgradeAntOptions, 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, transferRecordOwnershipOptions, updateGatewaySettingsOptions, upgradeAntOptions, 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';
 applyOptions(program
     .name('ar.io')
@@ -534,6 +534,7 @@ makeCommand({
             state,
             signer: requiredAoSignerFromOptions(options),
             logger: getLoggerFromOptions(options),
+            ...(options.module !== undefined ? { module: options.module } : {}),
         });
         return {
             processId: antProcessId,
@@ -630,7 +631,13 @@ makeCommand({
     name: 'set-ant-undername',
     description: 'Set an undername of an ANT process',
     options: setAntUndernameOptions,
-    action: setAntRecordCLICommand,
+    action: setAntUndernameCLICommand,
+});
+makeCommand({
+    name: 'transfer-record',
+    description: 'Transfer ownership of a specific record (undername) to another address',
+    options: transferRecordOwnershipOptions,
+    action: transferRecordOwnershipCLICommand,
 });
 makeCommand({
     name: 'upgrade-ant',

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

@@ -1,44 +1,59 @@
-import { arioProcessIdFromOptions, assertConfirmationPrompt, booleanFromOptions, customTagsFromOptions, defaultTtlSecondsCLI, readARIOFromOptions, requiredStringFromOptions, stringArrayFromOptions, writeANTFromOptions, } from '../utils.js';
+import { antRecordMetadataFromOptions, arioProcessIdFromOptions, assertConfirmationPrompt, booleanFromOptions, customTagsFromOptions, defaultTtlSecondsCLI, readARIOFromOptions, requiredStringFromOptions, stringArrayFromOptions, writeANTFromOptions, } 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({
+    const recordParams = {
         undername,
         transactionId,
         ttlSeconds,
-    }, customTagsFromOptions(o));
+        ...antRecordMetadataFromOptions(o),
+    };
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to set this record on the ANT process ${writeAnt.processId}?\n${JSON.stringify(recordParams, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).setRecord(recordParams, customTagsFromOptions(o));
 }
 export async function setAntBaseNameCLICommand(o) {
     const ttlSeconds = +(o.ttlSeconds ?? defaultTtlSecondsCLI);
     const transactionId = requiredStringFromOptions(o, 'transactionId');
+    const params = {
+        transactionId,
+        ttlSeconds,
+        ...antRecordMetadataFromOptions(o),
+    };
     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);
+        await assertConfirmationPrompt(`Are you sure you want to set this base name on the ANT process ${writeAnt.processId}?\n${JSON.stringify(params, null, 2)}`, o);
     }
-    return writeANTFromOptions(o).setBaseNameRecord({
-        transactionId,
-        ttlSeconds,
-    }, customTagsFromOptions(o));
+    return writeANTFromOptions(o).setBaseNameRecord(params, customTagsFromOptions(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({
+    const params = {
         undername,
         transactionId,
         ttlSeconds,
-    }, customTagsFromOptions(o));
+        ...antRecordMetadataFromOptions(o),
+    };
+    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(params, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).setUndernameRecord(params, customTagsFromOptions(o));
+}
+export async function transferRecordOwnershipCLICommand(o) {
+    const undername = requiredStringFromOptions(o, 'undername');
+    const recipient = requiredStringFromOptions(o, 'recipient');
+    const writeAnt = writeANTFromOptions(o);
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to transfer ownership of "${undername}" to "${recipient}" on ANT process ${writeAnt.processId}?\n${JSON.stringify({ undername, recipient }, null, 2)}`, o);
+    }
+    return writeANTFromOptions(o).transferRecord({ undername, recipient }, customTagsFromOptions(o));
 }
 export async function upgradeAntCLICommand(o) {
     const writeAnt = writeANTFromOptions(o);

package/lib/esm/cli/options.js

@@ -251,6 +251,14 @@ export const optionMap = {
         description: 'The keywords for the ANT',
         type: 'array',
     },
+    owner: {
+        alias: '--owner <owner>',
+        description: 'The owner address for the record',
+    },
+    displayName: {
+        alias: '--display-name <displayName>',
+        description: 'The display name for the record',
+    },
     names: {
         alias: '--names <names...>',
         description: 'The names to interact with',
@@ -286,6 +294,10 @@ 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',
+    },
     token: {
         alias: '-t, --token <type>',
         description: 'Crypto token type for wallet or action',
@@ -413,11 +425,17 @@ export const antStateOptions = [
     optionMap.controllers,
     optionMap.ttlSeconds,
     optionMap.logo,
+    optionMap.module,
 ];
 export const setAntBaseNameOptions = [
     optionMap.processId,
     optionMap.transactionId,
     optionMap.ttlSeconds,
+    optionMap.owner,
+    optionMap.displayName,
+    optionMap.logo,
+    optionMap.description,
+    optionMap.keywords,
     ...writeActionOptions,
 ];
 export const setAntUndernameOptions = [
@@ -430,3 +448,9 @@ export const upgradeAntOptions = [
     optionMap.reassignAffiliatedNames,
     ...writeActionOptions,
 ];
+export const transferRecordOwnershipOptions = [
+    optionMap.processId,
+    optionMap.undername,
+    optionMap.recipient,
+    ...writeActionOptions,
+];

package/lib/esm/cli/utils.js

@@ -507,3 +507,16 @@ export function assertLockLengthInRange(lockLengthMs, assertMin = true) {
         throw new Error(`Lock length must be at least 14 days (1209600000 ms). Provided lock length: ${lockLengthMs} ms`);
     }
 }
+export function antRecordMetadataFromOptions(options) {
+    return {
+        ...(options.owner != null &&
+            options.owner !== '' && { owner: options.owner }),
+        ...(options.displayName != null &&
+            options.displayName !== '' && { displayName: options.displayName }),
+        ...(options.logo != null && options.logo !== '' && { logo: options.logo }),
+        ...(options.description != null &&
+            options.description !== '' && { description: options.description }),
+        ...(options.keywords != null &&
+            options.keywords.length > 0 && { keywords: options.keywords }),
+    };
+}