@ardrive/turbo-sdk 1.42.0-alpha.1 → 1.42.0-alpha.3

package/lib/esm/common/turbo.js

@@ -51,6 +51,18 @@ export class TurboUnauthenticatedClient {
     getBalance(address) {
         return this.paymentService.getBalance(address);
     }
+    /**
+     * Returns the price in 'winc' (and mARIO) to buy/extend/upgrade an ArNS name.
+     */
+    getArNSPriceForName(params) {
+        return this.paymentService.getArNSPriceForName(params);
+    }
+    /**
+     * Returns the status of an ArNS purchase by its nonce.
+     */
+    getArNSPurchaseStatus(p) {
+        return this.paymentService.getArNSPurchaseStatus(p);
+    }
     /**
      * Returns a list of all supported fiat currencies.
      */
@@ -155,6 +167,38 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     getBalance(userAddress) {
         return this.paymentService.getBalance(userAddress);
     }
+    /**
+     * Buys, extends, or upgrades an ArNS name, paying with the signer's Turbo
+     * credit balance. Poll {@link getArNSPurchaseStatus} with the returned nonce.
+     */
+    purchaseArNSName(params) {
+        return this.paymentService.purchaseArNSName(params);
+    }
+    /** Buys a new ArNS name (lease or permabuy). */
+    buyArNSName(params) {
+        return this.paymentService.buyArNSName(params);
+    }
+    /** Extends the lease on an existing ArNS name. */
+    extendArNSLease(params) {
+        return this.paymentService.extendArNSLease(params);
+    }
+    /** Increases the undername limit on an existing ArNS name. */
+    increaseArNSUndernameLimit(params) {
+        return this.paymentService.increaseArNSUndernameLimit(params);
+    }
+    /** Upgrades an ArNS lease to a permabuy. */
+    upgradeArNSName(params) {
+        return this.paymentService.upgradeArNSName(params);
+    }
+    transferArNSAnt(params) {
+        return this.paymentService.transferArNSAnt(params);
+    }
+    setArNSRecord(params) {
+        return this.paymentService.setArNSRecord(params);
+    }
+    removeArNSRecord(params) {
+        return this.paymentService.removeArNSRecord(params);
+    }
     /**
      * Returns a list of all credit share approvals for the user.
      */

package/lib/esm/types.js

@@ -94,3 +94,10 @@ export function isEthereumWalletAdapter(walletAdapter) {
     return 'getSigner' in walletAdapter;
 }
 export const validChunkingModes = ['force', 'disabled', 'auto'];
+// ===== ArNS purchases paid with Turbo credits (via the bundler REST API) =====
+export const arNSPurchaseIntents = [
+    'Buy-Name',
+    'Extend-Lease',
+    'Increase-Undername-Limit',
+    'Upgrade-Name',
+];

package/lib/esm/utils/errors.js

@@ -35,6 +35,23 @@ export class ProvidedInputError extends BaseError {
         super(message ?? `User has provided an invalid input`);
     }
 }
+/**
+ * Raised when a credit-paid operation (e.g. an ArNS purchase) is rejected by the
+ * service because the paying wallet does not hold enough Turbo credits. Maps the
+ * bundler's HTTP `402 Payment Required` response to a typed, catchable error so
+ * callers can prompt a top-up without string-matching on messages.
+ *
+ * Recovery: top up the balance, then retry the SAME operation reusing the
+ * captured `nonce` (the nonce is the idempotency key), or mint a fresh request.
+ */
+export class InsufficientCreditsError extends BaseError {
+    constructor(message) {
+        super(message ??
+            'Insufficient Turbo credits to complete this purchase. Top up your balance and retry.');
+        /** Always the HTTP status that produced this error. */
+        this.status = 402;
+    }
+}
 export class AbortError extends BaseError {
     constructor(message = 'Request was aborted') {
         super(message);

package/lib/esm/utils/uuid.js

@@ -0,0 +1,28 @@
+/**
+ * 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 { randomBytes } from 'crypto';
+/**
+ * RFC 4122 version 4 UUID, derived from `randomBytes` (already used across the
+ * SDK in both the node and web builds). Avoids depending on
+ * `crypto.randomUUID`, whose availability varies by runtime/polyfill.
+ */
+export function uuidV4() {
+    const bytes = randomBytes(16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // RFC 4122 variant
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}

package/lib/esm/web/signer.js

@@ -59,9 +59,11 @@ export class TurboWebArweaveSigner extends TurboDataItemAbstractSigner {
             dataItemSizeFactory: () => signedDataItemSize,
         };
     }
-    async generateSignedRequestHeaders() {
+    async generateSignedRequestHeaders(nonce, additionalData) {
         await this.setPublicKey();
-        return super.generateSignedRequestHeaders();
+        // Pass through the caller's nonce + action-binding data (previously dropped,
+        // which would override a route-required UUID nonce and the H-2 binding).
+        return super.generateSignedRequestHeaders(nonce, additionalData);
     }
     async signData(dataToSign) {
         await this.setPublicKey();

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

@@ -0,0 +1,88 @@
+import { ArNSNameType, ArNSPriceParams, ArNSPriceResponse, ArNSPurchaseResponse, ArNSPurchaseStatusResponse } from '../../types.js';
+import { ArNSPriceOptions, ArNSPurchaseOptions, ArNSPurchaseStatusOptions, RemoveArNSRecordOptions, SetArNSRecordOptions, TransferArNSAntOptions } from '../types.js';
+export type ArNSPriceClient = {
+    getArNSPriceForName(params: ArNSPriceParams): Promise<ArNSPriceResponse>;
+};
+export type ArNSStatusClient = {
+    getArNSPurchaseStatus(p: {
+        nonce: string;
+    }): Promise<ArNSPurchaseStatusResponse>;
+};
+export type ArNSPurchaseClient = {
+    buyArNSName(params: {
+        name: string;
+        type: ArNSNameType;
+        years?: number;
+        processId?: string;
+        paidBy?: string[];
+    }): Promise<ArNSPurchaseResponse>;
+    extendArNSLease(params: {
+        name: string;
+        years: number;
+        paidBy?: string[];
+    }): Promise<ArNSPurchaseResponse>;
+    increaseArNSUndernameLimit(params: {
+        name: string;
+        increaseQty: number;
+        paidBy?: string[];
+    }): Promise<ArNSPurchaseResponse>;
+    upgradeArNSName(params: {
+        name: string;
+        paidBy?: string[];
+    }): Promise<ArNSPurchaseResponse>;
+};
+export type ArNSCustodyClient = {
+    transferArNSAnt(params: {
+        antId: string;
+        target: string;
+    }): Promise<{
+        antId: string;
+        target: string;
+        name?: string;
+        messageId: string;
+    }>;
+    setArNSRecord(params: {
+        antId: string;
+        undername?: string;
+        transactionId: string;
+        ttlSeconds: number;
+    }): Promise<{
+        antId: string;
+        undername: string;
+        transactionId: string;
+        ttlSeconds: number;
+        messageId: string;
+    }>;
+    removeArNSRecord(params: {
+        antId: string;
+        undername: string;
+    }): Promise<{
+        antId: string;
+        undername: string;
+        messageId: string;
+    }>;
+};
+export declare function requiredNameFromOptions(options: {
+    name?: string;
+}): string;
+export declare function positiveIntFromOption(value: string | undefined, flag: string): number;
+export declare function typeFromOptions(value: string | undefined): ArNSNameType;
+export declare function paidByFromArNSOptions(paidBy: string[] | undefined): string[] | undefined;
+/**
+ * Infer the ArNS pricing intent from the provided flags:
+ * - `--type` present            -> Buy-Name (lease needs --years; --process-id optional for pricing)
+ * - `--increase-qty` present    -> Increase-Undername-Limit
+ * - `--years` present (no type) -> Extend-Lease
+ * - otherwise                   -> Upgrade-Name
+ */
+export declare function arnsPriceParamsFromOptions(options: ArNSPriceOptions): ArNSPriceParams;
+export declare function arnsPrice(options: ArNSPriceOptions, turbo?: ArNSPriceClient): Promise<void>;
+export declare function buyArNSName(options: ArNSPurchaseOptions, turbo?: ArNSPurchaseClient): Promise<void>;
+export declare function extendArNSLease(options: ArNSPurchaseOptions, turbo?: ArNSPurchaseClient): Promise<void>;
+export declare function increaseArNSUndernames(options: ArNSPurchaseOptions, turbo?: ArNSPurchaseClient): Promise<void>;
+export declare function upgradeArNSName(options: ArNSPurchaseOptions, turbo?: ArNSPurchaseClient): Promise<void>;
+export declare function arnsPurchaseStatus(options: ArNSPurchaseStatusOptions, turbo?: ArNSStatusClient): Promise<void>;
+export declare function transferArNSAnt(options: TransferArNSAntOptions, turbo?: ArNSCustodyClient): Promise<void>;
+export declare function setArNSRecord(options: SetArNSRecordOptions, turbo?: ArNSCustodyClient): Promise<void>;
+export declare function removeArNSRecord(options: RemoveArNSRecordOptions, turbo?: ArNSCustodyClient): Promise<void>;
+//# sourceMappingURL=arns.d.ts.map

package/lib/types/cli/commands/arns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arns.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/arns.ts"],"names":[],"mappings":"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"}

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

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export * from './arns.js';
 export * from './balance.js';
 export * from './cryptoFund.js';
 export * from './price.js';

package/lib/types/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

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

@@ -186,6 +186,50 @@ export declare const optionMap: {
         readonly alias: "--max-crypto-top-up-value <maxCryptoTopUpValue>";
         readonly description: "Maximum crypto top-up value to use for the upload. Defaults to no limit.";
     };
+    readonly arnsName: {
+        readonly alias: "--name <name>";
+        readonly description: "ArNS name to price, buy, or manage";
+    };
+    readonly arnsType: {
+        readonly alias: "--type <type>";
+        readonly description: "ArNS purchase type for Buy-Name: 'lease' or 'permabuy'";
+    };
+    readonly arnsYears: {
+        readonly alias: "--years <years>";
+        readonly description: "Lease duration in years (Buy-Name lease / Extend-Lease)";
+    };
+    readonly arnsIncreaseQty: {
+        readonly alias: "--increase-qty <qty>";
+        readonly description: "Number of additional undernames (Increase-Undername-Limit)";
+    };
+    readonly arnsProcessId: {
+        readonly alias: "--process-id <processId>";
+        readonly description: "ANT process ID the ArNS name resolves to (Buy-Name). Optional: omit for Turbo custodial provisioning (Turbo owns the ANT); supply for a user-owned ANT";
+    };
+    readonly arnsNonce: {
+        readonly alias: "--nonce <nonce>";
+        readonly description: "ArNS purchase nonce to look up the status for";
+    };
+    readonly arnsAntId: {
+        readonly alias: "--ant-id <antId>";
+        readonly description: "ANT (Metaplex Core asset) ID to transfer or manage";
+    };
+    readonly arnsTarget: {
+        readonly alias: "--target <address>";
+        readonly description: "Target Solana pubkey to transfer the ANT to";
+    };
+    readonly arnsUndername: {
+        readonly alias: "--undername <undername>";
+        readonly description: "ArNS undername record to set or remove (defaults to '@')";
+    };
+    readonly arnsTransactionId: {
+        readonly alias: "--transaction-id <transactionId>";
+        readonly description: "Arweave transaction ID the ArNS record resolves to";
+    };
+    readonly arnsTtlSeconds: {
+        readonly alias: "--ttl-seconds <ttlSeconds>";
+        readonly description: "TTL in seconds for the ArNS record";
+    };
 };
 export declare const walletOptions: ({
     readonly alias: "-w, --wallet-file <filePath>";
@@ -469,4 +513,161 @@ export declare const listSharesOptions: ({
     readonly alias: "-p, --private-key <key>";
     readonly description: "Private key to use with the action";
 })[];
+export declare const arnsPriceOptions: ({
+    readonly alias: "--name <name>";
+    readonly description: "ArNS name to price, buy, or manage";
+} | {
+    readonly alias: "--type <type>";
+    readonly description: "ArNS purchase type for Buy-Name: 'lease' or 'permabuy'";
+} | {
+    readonly alias: "--years <years>";
+    readonly description: "Lease duration in years (Buy-Name lease / Extend-Lease)";
+} | {
+    readonly alias: "--increase-qty <qty>";
+    readonly description: "Number of additional undernames (Increase-Undername-Limit)";
+} | {
+    readonly alias: "--process-id <processId>";
+    readonly description: "ANT process ID the ArNS name resolves to (Buy-Name). Optional: omit for Turbo custodial provisioning (Turbo owns the ANT); supply for a user-owned ANT";
+})[];
+export declare const buyArNSNameOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--paid-by <paidBy...>";
+    readonly description: "Address to pay for the upload";
+    readonly type: "array";
+} | {
+    readonly alias: "--name <name>";
+    readonly description: "ArNS name to price, buy, or manage";
+} | {
+    readonly alias: "--type <type>";
+    readonly description: "ArNS purchase type for Buy-Name: 'lease' or 'permabuy'";
+} | {
+    readonly alias: "--years <years>";
+    readonly description: "Lease duration in years (Buy-Name lease / Extend-Lease)";
+} | {
+    readonly alias: "--process-id <processId>";
+    readonly description: "ANT process ID the ArNS name resolves to (Buy-Name). Optional: omit for Turbo custodial provisioning (Turbo owns the ANT); supply for a user-owned ANT";
+})[];
+export declare const extendArNSLeaseOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--paid-by <paidBy...>";
+    readonly description: "Address to pay for the upload";
+    readonly type: "array";
+} | {
+    readonly alias: "--name <name>";
+    readonly description: "ArNS name to price, buy, or manage";
+} | {
+    readonly alias: "--years <years>";
+    readonly description: "Lease duration in years (Buy-Name lease / Extend-Lease)";
+})[];
+export declare const increaseArNSUndernamesOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--paid-by <paidBy...>";
+    readonly description: "Address to pay for the upload";
+    readonly type: "array";
+} | {
+    readonly alias: "--name <name>";
+    readonly description: "ArNS name to price, buy, or manage";
+} | {
+    readonly alias: "--increase-qty <qty>";
+    readonly description: "Number of additional undernames (Increase-Undername-Limit)";
+})[];
+export declare const upgradeArNSNameOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--paid-by <paidBy...>";
+    readonly description: "Address to pay for the upload";
+    readonly type: "array";
+} | {
+    readonly alias: "--name <name>";
+    readonly description: "ArNS name to price, buy, or manage";
+})[];
+export declare const arnsPurchaseStatusOptions: {
+    readonly alias: "--nonce <nonce>";
+    readonly description: "ArNS purchase nonce to look up the status for";
+}[];
+export declare const transferArNSAntOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--ant-id <antId>";
+    readonly description: "ANT (Metaplex Core asset) ID to transfer or manage";
+} | {
+    readonly alias: "--target <address>";
+    readonly description: "Target Solana pubkey to transfer the ANT to";
+})[];
+export declare const setArNSRecordOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--ant-id <antId>";
+    readonly description: "ANT (Metaplex Core asset) ID to transfer or manage";
+} | {
+    readonly alias: "--undername <undername>";
+    readonly description: "ArNS undername record to set or remove (defaults to '@')";
+} | {
+    readonly alias: "--transaction-id <transactionId>";
+    readonly description: "Arweave transaction ID the ArNS record resolves to";
+} | {
+    readonly alias: "--ttl-seconds <ttlSeconds>";
+    readonly description: "TTL in seconds for the ArNS record";
+})[];
+export declare const removeArNSRecordOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "--ant-id <antId>";
+    readonly description: "ANT (Metaplex Core asset) ID to transfer or manage";
+} | {
+    readonly alias: "--undername <undername>";
+    readonly description: "ArNS undername record to set or remove (defaults to '@')";
+})[];
 //# sourceMappingURL=options.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0LZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUzB,CAAC;AASF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYzB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;IAK/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;IAAwC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;IAAuB,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwOZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUzB,CAAC;AASF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYzB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;IAK/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;IAAwC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;IAAuB,CAAC;AAItD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;IAM5B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;IAO9B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;IAKlC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;IAKzC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;IAIlC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;GAAwB,CAAC;AAE/D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;IAIlC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;IAMhC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;IAInC,CAAC"}

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

@@ -89,4 +89,31 @@ export type RevokeCreditsOptions = WalletOptions & {
     address: string | undefined;
 };
 export type ListSharesOptions = RevokeCreditsOptions;
+export type ArNSPriceOptions = GlobalOptions & {
+    name: string | undefined;
+    type: string | undefined;
+    years: string | undefined;
+    increaseQty: string | undefined;
+    processId: string | undefined;
+};
+export type ArNSPurchaseOptions = WalletOptions & ArNSPriceOptions & {
+    paidBy: string[] | undefined;
+};
+export type ArNSPurchaseStatusOptions = GlobalOptions & {
+    nonce: string | undefined;
+};
+export type TransferArNSAntOptions = WalletOptions & {
+    antId: string | undefined;
+    target: string | undefined;
+};
+export type SetArNSRecordOptions = WalletOptions & {
+    antId: string | undefined;
+    undername: string | undefined;
+    transactionId: string | undefined;
+    ttlSeconds: string | undefined;
+};
+export type RemoveArNSRecordOptions = WalletOptions & {
+    antId: string | undefined;
+    undername: string | undefined;
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"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"}

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

@@ -36,13 +36,14 @@ export declare class TurboHTTPService implements TurboHTTPServiceInterface {
         allowedStatuses?: number[];
         headers?: Partial<TurboSignedRequestHeaders> & Record<string, string>;
     }): Promise<T>;
-    post<T>({ endpoint, signal, allowedStatuses, headers, data, x402Options, }: {
+    post<T>({ endpoint, signal, allowedStatuses, headers, data, x402Options, retry, }: {
         endpoint: `/${string}`;
         signal?: AbortSignal;
         allowedStatuses?: number[];
         headers?: Partial<TurboSignedRequestHeaders> & Record<string, string>;
         data: Readable | Buffer | ReadableStream | Uint8Array;
         x402Options?: X402RequestCredentials;
+        retry?: boolean;
     }): Promise<T>;
     private tryRequest;
     private withRetry;

package/lib/types/common/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,WAQzD,CAAC;AAOH,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,EACV,GAAG,EACH,MAAM,EACN,WAAwC,GACzC,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,EAAE,WAAW,CAAC;KACrB;IAMK,GAAG,CAAC,CAAC,EAAE,EACX,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,GACR,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvE,GAAG,OAAO,CAAC,CAAC,CAAC;IAYR,IAAI,CAAC,CAAC,EAAE,EACZ,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,EACP,IAAI,EACJ,WAAW,GACZ,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;QACtD,WAAW,CAAC,EAAE,sBAAsB,CAAC;KACtC,GAAG,OAAO,CAAC,CAAC,CAAC;YAiCA,UAAU;YA6BV,SAAS;YAsCT,QAAQ;CA8CvB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,WAQzD,CAAC;AAOH,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,EACV,GAAG,EACH,MAAM,EACN,WAAwC,GACzC,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,EAAE,WAAW,CAAC;KACrB;IAMK,GAAG,CAAC,CAAC,EAAE,EACX,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,GACR,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvE,GAAG,OAAO,CAAC,CAAC,CAAC;IAYR,IAAI,CAAC,CAAC,EAAE,EACZ,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAY,GACb,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;QACtD,WAAW,CAAC,EAAE,sBAAsB,CAAC;QAIrC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,CAAC,CAAC;YAmCA,UAAU;YA6BV,SAAS;YAsCT,QAAQ;CA8CvB"}

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

@@ -18,4 +18,5 @@ export * from './payment.js';
 export * from './turbo.js';
 export * from './currency.js';
 export * from './token/index.js';
+export * from '../utils/errors.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC"}

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

@@ -1,4 +1,4 @@
-import { Currency, GetCreditShareApprovalsResponse, TokenTools, TokenType, TurboAuthenticatedPaymentServiceConfiguration, TurboAuthenticatedPaymentServiceInterface, TurboBalanceResponse, TurboCheckoutSessionParams, TurboCheckoutSessionResponse, TurboCountriesResponse, TurboCryptoFundResponse, TurboCurrenciesResponse, TurboDataItemSigner, TurboFiatEstimateForBytesResponse, TurboFiatToArResponse, TurboFundWithTokensParams, TurboLogger, TurboPaymentIntentParams, TurboPaymentIntentResponse, TurboPriceResponse, TurboRatesResponse, TurboSignedRequestHeaders, TurboSubmitFundTxResponse, TurboTokenPriceForBytesResponse, TurboUnauthenticatedPaymentServiceConfiguration, TurboUnauthenticatedPaymentServiceInterface, TurboWincForFiatParams, TurboWincForFiatResponse, TurboWincForTokenParams, TurboWincForTokenResponse, UserAddress } from '../types.js';
+import { ArNSBuyNameArgs, ArNSExtendLeaseParams, ArNSIncreaseUndernameLimitParams, ArNSPaidByParams, ArNSPriceParams, ArNSPriceResponse, ArNSPurchaseParams, ArNSPurchaseResponse, ArNSPurchaseStatusResponse, ArNSUpgradeNameParams, Currency, GetCreditShareApprovalsResponse, TokenTools, TokenType, TurboAuthenticatedPaymentServiceConfiguration, TurboAuthenticatedPaymentServiceInterface, TurboBalanceResponse, TurboCheckoutSessionParams, TurboCheckoutSessionResponse, TurboCountriesResponse, TurboCryptoFundResponse, TurboCurrenciesResponse, TurboDataItemSigner, TurboFiatEstimateForBytesResponse, TurboFiatToArResponse, TurboFundWithTokensParams, TurboLogger, TurboPaymentIntentParams, TurboPaymentIntentResponse, TurboPriceResponse, TurboRatesResponse, TurboSignedRequestHeaders, TurboSubmitFundTxResponse, TurboTokenPriceForBytesResponse, TurboUnauthenticatedPaymentServiceConfiguration, TurboUnauthenticatedPaymentServiceInterface, TurboWincForFiatParams, TurboWincForFiatResponse, TurboWincForTokenParams, TurboWincForTokenResponse, UserAddress } from '../types.js';
 import { TurboHTTPService } from './http.js';
 export declare const developmentPaymentServiceURL = "https://payment.ardrive.dev";
 export declare const defaultPaymentServiceURL = "https://payment.ardrive.io";
@@ -20,6 +20,23 @@ export declare class TurboUnauthenticatedPaymentService implements TurboUnauthen
     }): Promise<TurboPriceResponse[]>;
     getWincForFiat({ amount, promoCodes, nativeAddress, }: TurboWincForFiatParams): Promise<TurboWincForFiatResponse>;
     getWincForToken({ tokenAmount, }: TurboWincForTokenParams): Promise<TurboWincForTokenResponse>;
+    getArNSPriceForName(params: ArNSPriceParams): Promise<ArNSPriceResponse>;
+    /**
+     * 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
+     * opaque service 4xx. Enforces the required fields per intent:
+     *  - `Buy-Name`: `type` ('lease' | 'permabuy'); leases also need `years`.
+     *    `processId` is OPTIONAL — omit it to have the bundler custodially
+     *    provision the ANT (Turbo owns it), supply it for a user-owned ANT.
+     *  - `Extend-Lease`: positive `years`
+     *  - `Increase-Undername-Limit`: positive `increaseQty`
+     *  - `Upgrade-Name`: just `name`
+     */
+    protected validateArNSPurchaseParams(params: ArNSPriceParams): void;
+    getArNSPurchaseStatus({ nonce, }: {
+        nonce: string;
+    }): Promise<ArNSPurchaseStatusResponse>;
+    protected buildArNSPurchaseQuery(input: ArNSPurchaseParams): string;
     protected appendPromoCodesToQuery(promoCodes: string[]): string;
     getTurboCryptoWallets(): Promise<Record<TokenType, string>>;
     protected getCheckout({ amount, owner, promoCodes, uiMode, ...callbackUrls }: TurboCheckoutSessionParams, type?: 'checkout-session' | 'payment-intent', headers?: TurboSignedRequestHeaders): Promise<TurboCheckoutSessionResponse>;
@@ -44,6 +61,52 @@ export declare class TurboAuthenticatedPaymentService extends TurboUnauthenticat
     protected readonly tokenTools: TokenTools | undefined;
     constructor({ url, retryConfig, signer, logger, token, tokenTools, }: TurboAuthenticatedPaymentServiceConfiguration);
     getBalance(userAddress?: string): Promise<TurboBalanceResponse>;
+    /**
+     * Buy / extend / upgrade an ArNS name, paying with the signer's Turbo credit
+     * balance. The bundler performs the on-chain ARIO purchase and debits credits;
+     * a `402` (FailedRequestError.status === 402) indicates insufficient credits.
+     */
+    purchaseArNSName(params: ArNSPurchaseParams): Promise<ArNSPurchaseResponse>;
+    buyArNSName(params: ArNSBuyNameArgs): Promise<ArNSPurchaseResponse>;
+    extendArNSLease(params: Omit<ArNSExtendLeaseParams, 'intent'> & ArNSPaidByParams): Promise<ArNSPurchaseResponse>;
+    increaseArNSUndernameLimit(params: Omit<ArNSIncreaseUndernameLimitParams, 'intent'> & ArNSPaidByParams): Promise<ArNSPurchaseResponse>;
+    upgradeArNSName(params: Omit<ArNSUpgradeNameParams, 'intent'> & ArNSPaidByParams): Promise<ArNSPurchaseResponse>;
+    private buildArNSCustodyMessage;
+    /**
+     * Self-custody exit: move a Turbo-custodied ANT to a Solana pubkey you control.
+     * Authenticated with an action-bound, single-use signature.
+     */
+    transferArNSAnt({ antId, target, }: {
+        antId: string;
+        target: string;
+    }): Promise<{
+        antId: string;
+        target: string;
+        name?: string;
+        messageId: string;
+    }>;
+    /** Set a resolution record on a custodied ANT (undername defaults to '@'). */
+    setArNSRecord({ antId, undername, transactionId, ttlSeconds, }: {
+        antId: string;
+        undername?: string;
+        transactionId: string;
+        ttlSeconds: number;
+    }): Promise<{
+        antId: string;
+        undername: string;
+        transactionId: string;
+        ttlSeconds: number;
+        messageId: string;
+    }>;
+    /** Remove a resolution record (an undername) from a custodied ANT. */
+    removeArNSRecord({ antId, undername, }: {
+        antId: string;
+        undername: string;
+    }): Promise<{
+        antId: string;
+        undername: string;
+        messageId: string;
+    }>;
     getCreditShareApprovals({ userAddress, }: {
         userAddress?: string;
     }): Promise<GetCreditShareApprovalsResponse>;