@ardrive/turbo-sdk 1.42.0-alpha.12 → 1.42.0-alpha.13

package/lib/cjs/cli/cli.js

@@ -147,6 +147,37 @@ const utils_js_1 = require("./utils.js");
     .description('Remove a resolution record (undername) from a Turbo-custodied ANT'), options_js_1.removeArNSRecordOptions).action(async (_commandOptions, command) => {
     await (0, utils_js_1.runCommand)(command, arns_js_1.removeArNSRecord);
 });
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('add-arns-controller')
+    .description('Grant controller rights on a Turbo-custodied ANT'), options_js_1.addArNSControllerOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.addArNSController);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('remove-arns-controller')
+    .description('Revoke controller rights on a Turbo-custodied ANT'), options_js_1.removeArNSControllerOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.removeArNSController);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('transfer-arns-record')
+    .description('Transfer one record (undername) on a Turbo-custodied ANT to another address'), options_js_1.transferArNSRecordOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.transferArNSRecord);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('set-arns-record-metadata')
+    .description("Set a record's display name, logo, description, or keywords on a Turbo-custodied ANT"), options_js_1.setArNSRecordMetadataOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.setArNSRecordMetadata);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('remove-arns-record-metadata')
+    .description("Clear a record's metadata on a Turbo-custodied ANT"), options_js_1.removeArNSRecordMetadataOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.removeArNSRecordMetadata);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('arns-action-price')
+    .description('Preview the Turbo Credit price of a non-purchase ArNS action (set-record, remove-record, ' +
+    'set-record-metadata, remove-record-metadata, transfer-record, add-controller, remove-controller, transfer)'), options_js_1.arnsActionPriceOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.arnsActionPrice);
+});
 (0, utils_js_1.applyOptions)(commander_1.program
     .command('inspect-data-items')
     .description('Lists all given or received Turbo credit share approvals for specified address or connected wallet'), [options_js_1.optionMap.folderPath]).action(async (_commandOptions, command) => {

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.requiredNameFromOptions = requiredNameFromOptions;
 exports.positiveIntFromOption = positiveIntFromOption;
 exports.typeFromOptions = typeFromOptions;
+exports.actionFromOptions = actionFromOptions;
 exports.paidByFromArNSOptions = paidByFromArNSOptions;
 exports.arnsPriceParamsFromOptions = arnsPriceParamsFromOptions;
 exports.arnsPrice = arnsPrice;
@@ -15,6 +16,12 @@ exports.arnsPurchaseStatus = arnsPurchaseStatus;
 exports.transferArNSAnt = transferArNSAnt;
 exports.setArNSRecord = setArNSRecord;
 exports.removeArNSRecord = removeArNSRecord;
+exports.addArNSController = addArNSController;
+exports.removeArNSController = removeArNSController;
+exports.transferArNSRecord = transferArNSRecord;
+exports.setArNSRecordMetadata = setArNSRecordMetadata;
+exports.removeArNSRecordMetadata = removeArNSRecordMetadata;
+exports.arnsActionPrice = arnsActionPrice;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -33,6 +40,7 @@ exports.removeArNSRecord = removeArNSRecord;
 const bignumber_js_1 = require("bignumber.js");
 const arnsActions_js_1 = require("../../common/arnsActions.js");
 const factory_js_1 = require("../../node/factory.js");
+const types_js_1 = require("../../types.js");
 const errors_js_1 = require("../../utils/errors.js");
 const constants_js_1 = require("../constants.js");
 const utils_js_1 = require("../utils.js");
@@ -51,6 +59,13 @@ function ownerFromOptions(options) {
     }
     return (0, arnsActions_js_1.solanaOwnerSigner)(options.ownerKey);
 }
+/** The four ARIO-purchase actions are priced via `arnsPrice`, not this route. */
+const ARNS_PURCHASE_ACTIONS = new Set([
+    'buy-name',
+    'extend-lease',
+    'upgrade-name',
+    'increase-undername-limit',
+]);
 function requiredNameFromOptions(options) {
     if (options.name === undefined || options.name.length === 0) {
         throw new Error('Must provide an ArNS --name');
@@ -73,6 +88,25 @@ function typeFromOptions(value) {
     }
     return value;
 }
+/** Parses `--action` for `arns-action-price`, rejecting the four purchase actions. */
+function actionFromOptions(options) {
+    const { action } = options;
+    if (action === undefined || action.length === 0) {
+        throw new Error(`Must provide --action. One of: ${types_js_1.arNSActions.join(', ')}`);
+    }
+    if (!types_js_1.arNSActions.includes(action)) {
+        throw new Error(`Invalid --action '${action}'. One of: ${types_js_1.arNSActions.join(', ')}`);
+    }
+    if (ARNS_PURCHASE_ACTIONS.has(action)) {
+        throw new Error(`'${action}' is priced via \`turbo arns-price\`, not \`arns-action-price\` — ` +
+            'it spends ARIO, not just the flat credits margin this route quotes.');
+    }
+    return action;
+}
+/** `null` clears the field (Set-Record-Metadata's tri-state), `undefined` leaves it unchanged. */
+function metadataFieldFromOptions(value, clear) {
+    return clear ? null : value;
+}
 function paidByFromArNSOptions(paidBy) {
     return paidBy !== undefined && paidBy.length > 0 ? paidBy : undefined;
 }
@@ -315,3 +349,87 @@ async function removeArNSRecord(options, turbo) {
     });
     console.log(JSON.stringify({ message: 'ArNS record removed!', ...result }, null, 2));
 }
+async function addArNSController(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to add a controller to');
+    }
+    const client = turbo ?? (await (0, utils_js_1.turboFromOptions)(options));
+    const result = await client.addArNSController({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS controller added!', ...result }, null, 2));
+}
+async function removeArNSController(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to remove a controller from');
+    }
+    const client = turbo ?? (await (0, utils_js_1.turboFromOptions)(options));
+    const result = await client.removeArNSController({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS controller removed!', ...result }, null, 2));
+}
+async function transferArNSRecord(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id whose record to transfer');
+    }
+    if (options.undername === undefined || options.undername.length === 0) {
+        throw new Error('Must provide an --undername to transfer');
+    }
+    if (options.target === undefined) {
+        throw new Error('Must provide a --target address to transfer the record to');
+    }
+    const client = turbo ?? (await (0, utils_js_1.turboFromOptions)(options));
+    const result = await client.transferArNSRecord({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername,
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS record transferred!', ...result }, null, 2));
+}
+async function setArNSRecordMetadata(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to set record metadata on');
+    }
+    const client = turbo ?? (await (0, utils_js_1.turboFromOptions)(options));
+    const result = await client.setArNSRecordMetadata({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername ?? '@',
+        displayName: metadataFieldFromOptions(options.displayName, options.clearDisplayName),
+        recordLogo: metadataFieldFromOptions(options.recordLogo, options.clearRecordLogo),
+        recordDescription: metadataFieldFromOptions(options.recordDescription, options.clearRecordDescription),
+        recordKeywords: metadataFieldFromOptions(options.recordKeywords, options.clearRecordKeywords),
+    });
+    console.log(JSON.stringify({ message: 'ArNS record metadata set!', ...result }, null, 2));
+}
+async function removeArNSRecordMetadata(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to remove record metadata from');
+    }
+    if (options.undername === undefined || options.undername.length === 0) {
+        throw new Error('Must provide an --undername');
+    }
+    const client = turbo ?? (await (0, utils_js_1.turboFromOptions)(options));
+    const result = await client.removeArNSRecordMetadata({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername,
+    });
+    console.log(JSON.stringify({ message: 'ArNS record metadata removed!', ...result }, null, 2));
+}
+/**
+ * Preview what one of the eight non-purchase actions will debit, without
+ * creating it.
+ */
+async function arnsActionPrice(options, turbo) {
+    const action = actionFromOptions(options);
+    const client = turbo ?? factory_js_1.TurboFactory.unauthenticated((0, utils_js_1.configFromOptions)(options));
+    const { wincQty } = await client.getArNSActionPrice(action);
+    console.log(JSON.stringify({ action, wincQty, credits: creditsFromWinc(wincQty) }, null, 2));
+}

package/lib/cjs/cli/options.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeArNSRecordOptions = exports.setArNSRecordOptions = exports.transferArNSAntOptions = exports.arnsPurchaseStatusOptions = exports.upgradeArNSNameOptions = exports.increaseArNSUndernamesOptions = exports.extendArNSLeaseOptions = exports.buyArNSNameOptions = exports.arnsFiatQuoteOptions = exports.arnsPriceOptions = exports.listSharesOptions = exports.revokeCreditsOptions = exports.shareCreditsOptions = exports.uploadFileOptions = exports.uploadFolderOptions = exports.uploadOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+exports.arnsActionPriceOptions = exports.removeArNSRecordMetadataOptions = exports.setArNSRecordMetadataOptions = exports.transferArNSRecordOptions = exports.removeArNSControllerOptions = exports.addArNSControllerOptions = exports.removeArNSRecordOptions = exports.setArNSRecordOptions = exports.transferArNSAntOptions = exports.arnsPurchaseStatusOptions = exports.upgradeArNSNameOptions = exports.increaseArNSUndernamesOptions = exports.extendArNSLeaseOptions = exports.buyArNSNameOptions = exports.arnsFiatQuoteOptions = exports.arnsPriceOptions = exports.listSharesOptions = exports.revokeCreditsOptions = exports.shareCreditsOptions = exports.uploadFileOptions = exports.uploadFolderOptions = exports.uploadOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
 exports.optionMap = {
     token: {
         alias: '-t, --token <type>',
@@ -234,6 +234,48 @@ exports.optionMap = {
         alias: '--ttl-seconds <ttlSeconds>',
         description: 'TTL in seconds for the ArNS record',
     },
+    arnsDisplayName: {
+        alias: '--display-name <displayName>',
+        description: 'Display name for the record (Set-Record-Metadata)',
+    },
+    arnsClearDisplayName: {
+        alias: '--clear-display-name',
+        description: 'Clear the record display name (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordLogo: {
+        alias: '--record-logo <transactionId>',
+        description: 'Arweave transaction ID for the record logo (Set-Record-Metadata)',
+    },
+    arnsClearRecordLogo: {
+        alias: '--clear-record-logo',
+        description: 'Clear the record logo (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordDescription: {
+        alias: '--record-description <description>',
+        description: 'Description for the record (Set-Record-Metadata)',
+    },
+    arnsClearRecordDescription: {
+        alias: '--clear-record-description',
+        description: 'Clear the record description (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordKeywords: {
+        alias: '--record-keywords <keywords...>',
+        description: 'Keywords for the record (Set-Record-Metadata)',
+        type: 'array',
+    },
+    arnsClearRecordKeywords: {
+        alias: '--clear-record-keywords',
+        description: 'Clear the record keywords (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsAction: {
+        alias: '--action <action>',
+        description: 'ArNS action to price: set-record, remove-record, set-record-metadata, ' +
+            'remove-record-metadata, transfer-record, add-controller, remove-controller, or transfer',
+    },
     // ---- Payment history ----
     limit: {
         alias: '--limit <limit>',
@@ -365,3 +407,38 @@ exports.removeArNSRecordOptions = [
     exports.optionMap.arnsAntId,
     exports.optionMap.arnsUndername,
 ];
+exports.addArNSControllerOptions = [
+    ...exports.walletOptions,
+    exports.optionMap.arnsOwnerKey,
+    exports.optionMap.arnsAntId,
+    exports.optionMap.arnsTarget,
+];
+exports.removeArNSControllerOptions = exports.addArNSControllerOptions;
+exports.transferArNSRecordOptions = [
+    ...exports.walletOptions,
+    exports.optionMap.arnsOwnerKey,
+    exports.optionMap.arnsAntId,
+    exports.optionMap.arnsUndername,
+    exports.optionMap.arnsTarget,
+];
+exports.setArNSRecordMetadataOptions = [
+    ...exports.walletOptions,
+    exports.optionMap.arnsOwnerKey,
+    exports.optionMap.arnsAntId,
+    exports.optionMap.arnsUndername,
+    exports.optionMap.arnsDisplayName,
+    exports.optionMap.arnsClearDisplayName,
+    exports.optionMap.arnsRecordLogo,
+    exports.optionMap.arnsClearRecordLogo,
+    exports.optionMap.arnsRecordDescription,
+    exports.optionMap.arnsClearRecordDescription,
+    exports.optionMap.arnsRecordKeywords,
+    exports.optionMap.arnsClearRecordKeywords,
+];
+exports.removeArNSRecordMetadataOptions = [
+    ...exports.walletOptions,
+    exports.optionMap.arnsOwnerKey,
+    exports.optionMap.arnsAntId,
+    exports.optionMap.arnsUndername,
+];
+exports.arnsActionPriceOptions = [exports.optionMap.arnsAction];

package/lib/cjs/common/payment.js

@@ -140,6 +140,24 @@ class TurboUnauthenticatedPaymentService {
             wincTotal: price.wincTotalWithAntSpawn ?? price.winc,
         };
     }
+    /**
+     * Preview the flat credits margin one of the eight non-purchase actions
+     * (everything except Buy-Name/Extend-Lease/Upgrade-Name/
+     * Increase-Undername-Limit) will debit, without creating it. Those four
+     * purchase actions are priced by `getArNSPriceForName` instead — their
+     * cost is dominated by the ARIO purchase, not this margin, so this route
+     * rejects them.
+     *
+     * No signature required: this mirrors `getArNSPriceForName`'s read-only,
+     * unauthenticated shape rather than `getArNSActionStatus`'s (which happens
+     * to live on the authenticated client today despite needing no signature
+     * either).
+     */
+    async getArNSActionPrice(action) {
+        return this.httpService.get({
+            endpoint: `/arns/actions/${action}/price`,
+        });
+    }
     /**
      * Fail fast (client-side) on malformed ArNS requests so JS callers that bypass
      * the compile-time intent unions get a clear `ProvidedInputError` instead of an

package/lib/cjs/common/turbo.js

@@ -63,6 +63,14 @@ class TurboUnauthenticatedClient {
     getArNSPriceForName(params) {
         return this.paymentService.getArNSPriceForName(params);
     }
+    /**
+     * Previews what one of the eight non-purchase ArNS actions will debit,
+     * without creating it. Use {@link getArNSPriceForName} for the four
+     * ARIO-purchase actions instead.
+     */
+    getArNSActionPrice(action) {
+        return this.paymentService.getArNSActionPrice(action);
+    }
     /**
      * Returns the status of an ArNS purchase by its nonce.
      */

package/lib/cjs/types.js

@@ -115,7 +115,7 @@ exports.arNSPurchaseIntents = [
 ];
 // ===== ArNS actions (sponsored — the current bundler surface) =====
 /**
- * The nine sponsored ArNS actions.
+ * The twelve sponsored ArNS actions.
  *
  * Sponsorship covers these twelve and NOTHING else. Everything else in the
  * ArNS, ANT and core programs stays on the direct-signer path and costs the

package/lib/esm/cli/cli.js

@@ -20,7 +20,7 @@ import { DataItem } from '@dha-team/arbundles';
 import { program } from 'commander';
 import { readFileSync, readdirSync } from 'fs';
 import { version } from '../version.js';
-import { arnsFiatQuote, arnsPrice, arnsPurchaseStatus, buyArNSName, extendArNSLease, increaseArNSUndernames, removeArNSRecord, setArNSRecord, transferArNSAnt, upgradeArNSName, } from './commands/arns.js';
+import { addArNSController, arnsActionPrice, arnsFiatQuote, arnsPrice, arnsPurchaseStatus, buyArNSName, extendArNSLease, increaseArNSUndernames, removeArNSController, removeArNSRecord, removeArNSRecordMetadata, setArNSRecord, setArNSRecordMetadata, transferArNSAnt, transferArNSRecord, upgradeArNSName, } from './commands/arns.js';
 import { fiatEstimate } from './commands/fiatEstimate.js';
 import { balance, cryptoFund, freeStatus, paymentHistory, price, topUp, uploadFile, uploadFolder, } from './commands/index.js';
 import { listShares } from './commands/listShares.js';
@@ -28,7 +28,7 @@ import { revokeCredits } from './commands/revokeCredits.js';
 import { shareCredits } from './commands/shareCredits.js';
 import { tokenPrice } from './commands/tokenPrice.js';
 import { x402UploadUnsignedFile } from './commands/x402UploadUnsignedData.js';
-import { arnsFiatQuoteOptions, arnsPriceOptions, arnsPurchaseStatusOptions, buyArNSNameOptions, extendArNSLeaseOptions, globalOptions, increaseArNSUndernamesOptions, listSharesOptions, optionMap, removeArNSRecordOptions, revokeCreditsOptions, setArNSRecordOptions, shareCreditsOptions, transferArNSAntOptions, upgradeArNSNameOptions, uploadFileOptions, uploadFolderOptions, walletOptions, } from './options.js';
+import { addArNSControllerOptions, arnsActionPriceOptions, arnsFiatQuoteOptions, arnsPriceOptions, arnsPurchaseStatusOptions, buyArNSNameOptions, extendArNSLeaseOptions, globalOptions, increaseArNSUndernamesOptions, listSharesOptions, optionMap, removeArNSControllerOptions, removeArNSRecordMetadataOptions, removeArNSRecordOptions, revokeCreditsOptions, setArNSRecordMetadataOptions, setArNSRecordOptions, shareCreditsOptions, transferArNSAntOptions, transferArNSRecordOptions, upgradeArNSNameOptions, uploadFileOptions, uploadFolderOptions, walletOptions, } from './options.js';
 import { applyOptions, runCommand } from './utils.js';
 applyOptions(program
     .name('turbo')
@@ -145,6 +145,37 @@ applyOptions(program
     .description('Remove a resolution record (undername) from a Turbo-custodied ANT'), removeArNSRecordOptions).action(async (_commandOptions, command) => {
     await runCommand(command, removeArNSRecord);
 });
+applyOptions(program
+    .command('add-arns-controller')
+    .description('Grant controller rights on a Turbo-custodied ANT'), addArNSControllerOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, addArNSController);
+});
+applyOptions(program
+    .command('remove-arns-controller')
+    .description('Revoke controller rights on a Turbo-custodied ANT'), removeArNSControllerOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, removeArNSController);
+});
+applyOptions(program
+    .command('transfer-arns-record')
+    .description('Transfer one record (undername) on a Turbo-custodied ANT to another address'), transferArNSRecordOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, transferArNSRecord);
+});
+applyOptions(program
+    .command('set-arns-record-metadata')
+    .description("Set a record's display name, logo, description, or keywords on a Turbo-custodied ANT"), setArNSRecordMetadataOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, setArNSRecordMetadata);
+});
+applyOptions(program
+    .command('remove-arns-record-metadata')
+    .description("Clear a record's metadata on a Turbo-custodied ANT"), removeArNSRecordMetadataOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, removeArNSRecordMetadata);
+});
+applyOptions(program
+    .command('arns-action-price')
+    .description('Preview the Turbo Credit price of a non-purchase ArNS action (set-record, remove-record, ' +
+    'set-record-metadata, remove-record-metadata, transfer-record, add-controller, remove-controller, transfer)'), arnsActionPriceOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, arnsActionPrice);
+});
 applyOptions(program
     .command('inspect-data-items')
     .description('Lists all given or received Turbo credit share approvals for specified address or connected wallet'), [optionMap.folderPath]).action(async (_commandOptions, command) => {

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

@@ -16,6 +16,7 @@
 import { BigNumber } from 'bignumber.js';
 import { solanaOwnerSigner } from '../../common/arnsActions.js';
 import { TurboFactory } from '../../node/factory.js';
+import { arNSActions, } from '../../types.js';
 import { FiatPaymentsDisabledError, InsufficientCreditsError, } from '../../utils/errors.js';
 import { wincPerCredit } from '../constants.js';
 import { configFromOptions, turboFromOptions } from '../utils.js';
@@ -34,6 +35,13 @@ function ownerFromOptions(options) {
     }
     return solanaOwnerSigner(options.ownerKey);
 }
+/** The four ARIO-purchase actions are priced via `arnsPrice`, not this route. */
+const ARNS_PURCHASE_ACTIONS = new Set([
+    'buy-name',
+    'extend-lease',
+    'upgrade-name',
+    'increase-undername-limit',
+]);
 export function requiredNameFromOptions(options) {
     if (options.name === undefined || options.name.length === 0) {
         throw new Error('Must provide an ArNS --name');
@@ -56,6 +64,25 @@ export function typeFromOptions(value) {
     }
     return value;
 }
+/** Parses `--action` for `arns-action-price`, rejecting the four purchase actions. */
+export function actionFromOptions(options) {
+    const { action } = options;
+    if (action === undefined || action.length === 0) {
+        throw new Error(`Must provide --action. One of: ${arNSActions.join(', ')}`);
+    }
+    if (!arNSActions.includes(action)) {
+        throw new Error(`Invalid --action '${action}'. One of: ${arNSActions.join(', ')}`);
+    }
+    if (ARNS_PURCHASE_ACTIONS.has(action)) {
+        throw new Error(`'${action}' is priced via \`turbo arns-price\`, not \`arns-action-price\` — ` +
+            'it spends ARIO, not just the flat credits margin this route quotes.');
+    }
+    return action;
+}
+/** `null` clears the field (Set-Record-Metadata's tri-state), `undefined` leaves it unchanged. */
+function metadataFieldFromOptions(value, clear) {
+    return clear ? null : value;
+}
 export function paidByFromArNSOptions(paidBy) {
     return paidBy !== undefined && paidBy.length > 0 ? paidBy : undefined;
 }
@@ -298,3 +325,87 @@ export async function removeArNSRecord(options, turbo) {
     });
     console.log(JSON.stringify({ message: 'ArNS record removed!', ...result }, null, 2));
 }
+export async function addArNSController(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to add a controller to');
+    }
+    const client = turbo ?? (await turboFromOptions(options));
+    const result = await client.addArNSController({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS controller added!', ...result }, null, 2));
+}
+export async function removeArNSController(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to remove a controller from');
+    }
+    const client = turbo ?? (await turboFromOptions(options));
+    const result = await client.removeArNSController({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS controller removed!', ...result }, null, 2));
+}
+export async function transferArNSRecord(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id whose record to transfer');
+    }
+    if (options.undername === undefined || options.undername.length === 0) {
+        throw new Error('Must provide an --undername to transfer');
+    }
+    if (options.target === undefined) {
+        throw new Error('Must provide a --target address to transfer the record to');
+    }
+    const client = turbo ?? (await turboFromOptions(options));
+    const result = await client.transferArNSRecord({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername,
+        target: options.target,
+    });
+    console.log(JSON.stringify({ message: 'ArNS record transferred!', ...result }, null, 2));
+}
+export async function setArNSRecordMetadata(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to set record metadata on');
+    }
+    const client = turbo ?? (await turboFromOptions(options));
+    const result = await client.setArNSRecordMetadata({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername ?? '@',
+        displayName: metadataFieldFromOptions(options.displayName, options.clearDisplayName),
+        recordLogo: metadataFieldFromOptions(options.recordLogo, options.clearRecordLogo),
+        recordDescription: metadataFieldFromOptions(options.recordDescription, options.clearRecordDescription),
+        recordKeywords: metadataFieldFromOptions(options.recordKeywords, options.clearRecordKeywords),
+    });
+    console.log(JSON.stringify({ message: 'ArNS record metadata set!', ...result }, null, 2));
+}
+export async function removeArNSRecordMetadata(options, turbo) {
+    if (options.antId === undefined) {
+        throw new Error('Must provide an --ant-id to remove record metadata from');
+    }
+    if (options.undername === undefined || options.undername.length === 0) {
+        throw new Error('Must provide an --undername');
+    }
+    const client = turbo ?? (await turboFromOptions(options));
+    const result = await client.removeArNSRecordMetadata({
+        antId: options.antId,
+        owner: ownerFromOptions(options),
+        undername: options.undername,
+    });
+    console.log(JSON.stringify({ message: 'ArNS record metadata removed!', ...result }, null, 2));
+}
+/**
+ * Preview what one of the eight non-purchase actions will debit, without
+ * creating it.
+ */
+export async function arnsActionPrice(options, turbo) {
+    const action = actionFromOptions(options);
+    const client = turbo ?? TurboFactory.unauthenticated(configFromOptions(options));
+    const { wincQty } = await client.getArNSActionPrice(action);
+    console.log(JSON.stringify({ action, wincQty, credits: creditsFromWinc(wincQty) }, null, 2));
+}

package/lib/esm/cli/options.js

@@ -231,6 +231,48 @@ export const optionMap = {
         alias: '--ttl-seconds <ttlSeconds>',
         description: 'TTL in seconds for the ArNS record',
     },
+    arnsDisplayName: {
+        alias: '--display-name <displayName>',
+        description: 'Display name for the record (Set-Record-Metadata)',
+    },
+    arnsClearDisplayName: {
+        alias: '--clear-display-name',
+        description: 'Clear the record display name (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordLogo: {
+        alias: '--record-logo <transactionId>',
+        description: 'Arweave transaction ID for the record logo (Set-Record-Metadata)',
+    },
+    arnsClearRecordLogo: {
+        alias: '--clear-record-logo',
+        description: 'Clear the record logo (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordDescription: {
+        alias: '--record-description <description>',
+        description: 'Description for the record (Set-Record-Metadata)',
+    },
+    arnsClearRecordDescription: {
+        alias: '--clear-record-description',
+        description: 'Clear the record description (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsRecordKeywords: {
+        alias: '--record-keywords <keywords...>',
+        description: 'Keywords for the record (Set-Record-Metadata)',
+        type: 'array',
+    },
+    arnsClearRecordKeywords: {
+        alias: '--clear-record-keywords',
+        description: 'Clear the record keywords (Set-Record-Metadata)',
+        default: false,
+    },
+    arnsAction: {
+        alias: '--action <action>',
+        description: 'ArNS action to price: set-record, remove-record, set-record-metadata, ' +
+            'remove-record-metadata, transfer-record, add-controller, remove-controller, or transfer',
+    },
     // ---- Payment history ----
     limit: {
         alias: '--limit <limit>',
@@ -362,3 +404,38 @@ export const removeArNSRecordOptions = [
     optionMap.arnsAntId,
     optionMap.arnsUndername,
 ];
+export const addArNSControllerOptions = [
+    ...walletOptions,
+    optionMap.arnsOwnerKey,
+    optionMap.arnsAntId,
+    optionMap.arnsTarget,
+];
+export const removeArNSControllerOptions = addArNSControllerOptions;
+export const transferArNSRecordOptions = [
+    ...walletOptions,
+    optionMap.arnsOwnerKey,
+    optionMap.arnsAntId,
+    optionMap.arnsUndername,
+    optionMap.arnsTarget,
+];
+export const setArNSRecordMetadataOptions = [
+    ...walletOptions,
+    optionMap.arnsOwnerKey,
+    optionMap.arnsAntId,
+    optionMap.arnsUndername,
+    optionMap.arnsDisplayName,
+    optionMap.arnsClearDisplayName,
+    optionMap.arnsRecordLogo,
+    optionMap.arnsClearRecordLogo,
+    optionMap.arnsRecordDescription,
+    optionMap.arnsClearRecordDescription,
+    optionMap.arnsRecordKeywords,
+    optionMap.arnsClearRecordKeywords,
+];
+export const removeArNSRecordMetadataOptions = [
+    ...walletOptions,
+    optionMap.arnsOwnerKey,
+    optionMap.arnsAntId,
+    optionMap.arnsUndername,
+];
+export const arnsActionPriceOptions = [optionMap.arnsAction];

package/lib/esm/common/payment.js

@@ -137,6 +137,24 @@ export class TurboUnauthenticatedPaymentService {
             wincTotal: price.wincTotalWithAntSpawn ?? price.winc,
         };
     }
+    /**
+     * Preview the flat credits margin one of the eight non-purchase actions
+     * (everything except Buy-Name/Extend-Lease/Upgrade-Name/
+     * Increase-Undername-Limit) will debit, without creating it. Those four
+     * purchase actions are priced by `getArNSPriceForName` instead — their
+     * cost is dominated by the ARIO purchase, not this margin, so this route
+     * rejects them.
+     *
+     * No signature required: this mirrors `getArNSPriceForName`'s read-only,
+     * unauthenticated shape rather than `getArNSActionStatus`'s (which happens
+     * to live on the authenticated client today despite needing no signature
+     * either).
+     */
+    async getArNSActionPrice(action) {
+        return this.httpService.get({
+            endpoint: `/arns/actions/${action}/price`,
+        });
+    }
     /**
      * Fail fast (client-side) on malformed ArNS requests so JS callers that bypass
      * the compile-time intent unions get a clear `ProvidedInputError` instead of an

package/lib/esm/common/turbo.js

@@ -60,6 +60,14 @@ export class TurboUnauthenticatedClient {
     getArNSPriceForName(params) {
         return this.paymentService.getArNSPriceForName(params);
     }
+    /**
+     * Previews what one of the eight non-purchase ArNS actions will debit,
+     * without creating it. Use {@link getArNSPriceForName} for the four
+     * ARIO-purchase actions instead.
+     */
+    getArNSActionPrice(action) {
+        return this.paymentService.getArNSActionPrice(action);
+    }
     /**
      * Returns the status of an ArNS purchase by its nonce.
      */