@ardrive/turbo-sdk 1.42.0-alpha.7 → 1.42.0-alpha.9

package/lib/esm/common/payment.js

@@ -18,6 +18,7 @@ import { arNSPurchaseIntents, fiatCurrencyTypes, isCurrency, } from '../types.js
 import { isAnyValidUserAddress } from '../utils/common.js';
 import { FailedRequestError, FiatPaymentsDisabledError, InsufficientCreditsError, ProvidedInputError, } from '../utils/errors.js';
 import { uuidV4 } from '../utils/uuid.js';
+import { arNSOwnerProofHeaders, buildArNSCustodyMessage, } from './arnsActions.js';
 import { defaultRetryConfig } from './http.js';
 import { TurboHTTPService } from './http.js';
 import { Logger } from './logger.js';
@@ -59,6 +60,22 @@ export class TurboUnauthenticatedPaymentService {
         // and coerce a missing field (e.g. a 404 body) to `null`.
         return { bytesRemaining: status?.bytesRemaining ?? null };
     }
+    /**
+     * Returns the ArNS names a wallet owns or controls -- both custodial names
+     * bought via Turbo's ArNS-with-credits feature (Turbo may spawn and hold
+     * the ANT on the caller's behalf, depending on the buy) and self-custody
+     * names, in one list. See `TurboArNSName` for field semantics, including
+     * the `custodial` flag distinguishing the two.
+     *
+     * To read a name's current records or lease/expiration state, use
+     * `@ar.io/sdk` directly against the returned `antId` -- it talks to the
+     * chain directly and needs no round-trip through this SDK/backend.
+     */
+    getArNSNames(address) {
+        return this.httpService.get({
+            endpoint: `/arns/my-names/${encodeURIComponent(address)}`,
+        });
+    }
     getFiatRates() {
         return this.httpService.get({
             endpoint: '/rates',
@@ -107,9 +124,18 @@ export class TurboUnauthenticatedPaymentService {
         // `async` so a validation failure surfaces as a rejected promise (consistent
         // with `purchaseArNSName`) rather than a synchronous throw.
         this.validateArNSPurchaseParams(params);
-        return this.httpService.get({
+        const price = await this.httpService.get({
             endpoint: `/arns/price/${params.intent.toLowerCase()}/${params.name}${this.buildArNSPurchaseQuery(params)}`,
         });
+        // Normalize the figure to charge into ONE field. `winc` is the name only
+        // and excludes the ANT spawn surcharge — for a Buy-Name that surcharge can
+        // exceed the name's own price, so a caller reading `winc` silently
+        // under-quotes every purchase. Surfacing `wincTotal` makes the correct
+        // field the obvious one.
+        return {
+            ...price,
+            wincTotal: price.wincTotalWithAntSpawn ?? price.winc,
+        };
     }
     /**
      * Fail fast (client-side) on malformed ArNS requests so JS callers that bypass
@@ -490,112 +516,221 @@ export class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymen
      * balance. The bundler performs the on-chain ARIO purchase and debits credits;
      * a `402` (FailedRequestError.status === 402) indicates insufficient credits.
      */
-    async purchaseArNSName(params) {
-        this.validateArNSPurchaseParams(params);
-        // The bundler requires the signed nonce to be a UUID; it also doubles as
-        // the idempotency + status-lookup key (`getArNSPurchaseStatus`).
+    // ===== ArNS actions — the sponsored surface =====
+    //
+    // Every ArNS operation is an ACTION, and an action has exactly one of two
+    // shapes, chosen by the SERVER rather than the caller: either Turbo already
+    // holds the authority (`completed`), or the ANT owner must sign a transaction
+    // Turbo has already fee-payer-signed (`awaiting-signature`).
+    //
+    // The shape is not stable per action, which is why callers must branch on
+    // `status` and never on which action they asked for: `set-record` completes
+    // alone while Turbo is a controller, and degrades to `awaiting-signature`
+    // the moment the customer revokes Turbo.
+    //
+    // This replaced `/arns/purchase/{intent}/{name}`, `/arns/transfer/{antId}`
+    // and `/arns/manage/*`, which were deleted along with Turbo-custodial ANTs.
+    // Turbo now takes custody of nothing: every ANT is minted straight to the
+    // customer.
+    /**
+     * Create an action. Returns `completed` or `awaiting-signature`.
+     *
+     * Credits are debited HERE, not at `/sign`. Capture the returned `nonce`
+     * before prompting for a signature: it is the idempotency key, and polling
+     * it is how you resume. Never re-create an action to "retry" — that debits
+     * a second time. An abandoned action is refunded automatically.
+     */
+    async createArNSAction(action, params = {}, ownerProof) {
         const nonce = uuidV4();
-        const headers = await this.signer.generateSignedRequestHeaders(nonce);
-        let response;
+        const headers = {
+            ...(await this.signer.generateSignedRequestHeaders(nonce)),
+            'content-type': 'application/json',
+        };
+        // Record actions carry a SECOND signature, from the ANT owner's Solana key
+        // over a different message. It travels in its own `x-owner-*` headers
+        // because two signatures cannot share one header set.
+        if (ownerProof !== undefined) {
+            Object.assign(headers, await arNSOwnerProofHeaders(ownerProof.owner, ownerProof.message, uuidV4()));
+        }
         try {
-            response = await this.httpService.post({
-                endpoint: `/arns/purchase/${params.intent.toLowerCase()}/${params.name}${this.buildArNSPurchaseQuery(params)}`,
+            return await this.httpService.post({
+                endpoint: `/arns/actions/${action}`,
                 headers,
-                // Params travel in the query string + signed headers; the service reads
-                // no body, but the HTTP layer requires a `data` field.
-                data: Buffer.from([]),
-                // Non-idempotent signed write: the nonce is single-use, so a retried
-                // (but already-landed) purchase would 4xx as "already exists". Poll
-                // status by nonce instead of retrying.
+                data: Buffer.from(JSON.stringify(params)),
+                // Non-idempotent signed write that has already debited. A blind retry
+                // risks paying twice for one name; poll the nonce instead.
                 retry: false,
             });
         }
         catch (error) {
-            // Surface a credit shortfall as a typed, catchable error so callers can
-            // prompt a top-up. The `nonce` is the idempotency key: after topping up,
-            // retry the same purchase (a fresh nonce is fine — the service dedupes by
-            // the on-chain effect, and a captured nonce lets you poll status).
             if (error instanceof FailedRequestError && error.status === 402) {
                 throw new InsufficientCreditsError(error.message);
             }
             throw error;
         }
-        // Normalize both nonce fields to the one we signed so callers can poll with
-        // either `response.nonce` or `response.purchaseReceipt.nonce`.
-        return {
-            ...response,
-            nonce,
-            purchaseReceipt: { ...response.purchaseReceipt, nonce },
-        };
     }
-    buyArNSName(params) {
-        return this.purchaseArNSName({
-            ...params,
-            intent: 'Buy-Name',
+    /**
+     * Submit the owner-signed transaction for an `awaiting-signature` action.
+     *
+     * `signedTransaction` is the FULL serialized transaction, base64 — not just
+     * the signature. Replaying a completed action returns `alreadyCompleted:
+     * true` rather than buying twice, so this is safe to call again if a
+     * response is lost.
+     */
+    async signArNSAction(nonce, signedTransaction) {
+        return this.httpService.post({
+            endpoint: `/arns/actions/${nonce}/sign`,
+            headers: {
+                ...(await this.signer.generateSignedRequestHeaders(uuidV4())),
+                'content-type': 'application/json',
+            },
+            data: Buffer.from(JSON.stringify({ transaction: signedTransaction })),
+            retry: false,
         });
     }
-    extendArNSLease(params) {
-        return this.purchaseArNSName({ ...params, intent: 'Extend-Lease' });
-    }
-    increaseArNSUndernameLimit(params) {
-        return this.purchaseArNSName({
-            ...params,
-            intent: 'Increase-Undername-Limit',
+    /**
+     * Status of an action by nonce. Open — no signature required — so it works
+     * from a status page or callback handler that never holds the payer's key.
+     *
+     * Terminal success carries `messageId`; terminal failure carries
+     * `failedDate`.
+     */
+    async getArNSActionStatus(nonce) {
+        return this.httpService.get({
+            endpoint: `/arns/actions/${nonce}`,
         });
     }
-    upgradeArNSName(params) {
-        return this.purchaseArNSName({ ...params, intent: 'Upgrade-Name' });
-    }
-    // ---- ArNS ANT custody: self-custody exit + manage records ----
-    // Canonical ACTION-BOUND message. MUST match the bundler's
-    // buildArNSCustodyMessage byte-for-byte (newline-delimited) or every signature
-    // is rejected. The bundler reconstructs this from the request and verifies the
-    // signature over `message + nonce`, so a captured signature can't be replayed
-    // against a different operation/params.
-    buildArNSCustodyMessage(action, fields) {
-        return ['arns', action, ...fields].join('\n');
+    /**
+     * Run an action to a terminal state, signing if the server asks for it.
+     *
+     * This is the two-shape branch, once, in one place — so callers cannot
+     * hardcode which actions need a signature and break when a customer
+     * exercises ownership.
+     */
+    async completeArNSAction(action, params, owner, opts = {}, ownerProofMessage) {
+        const created = await this.createArNSAction(action, params, owner !== undefined && ownerProofMessage !== undefined
+            ? { owner, message: ownerProofMessage }
+            : undefined);
+        // Fires before any wallet prompt: the action is already debited, so the
+        // caller needs the nonce persisted even if the user walks away here.
+        await opts.onNonce?.(created.nonce);
+        if (created.status === 'completed')
+            return created;
+        if (owner === undefined) {
+            throw new Error(`ArNS action "${action}" requires the ANT owner's signature, but no owner signer was provided. ` +
+                `Pass \`owner\`, or drive createArNSAction/signArNSAction yourself. ` +
+                `Nonce ${created.nonce} is already debited — poll it rather than re-creating.`);
+        }
+        const signed = await owner.signTransaction(created.transaction);
+        return this.signArNSAction(created.nonce, signed);
     }
     /**
-     * Self-custody exit: move a Turbo-custodied ANT to a Solana pubkey you control.
-     * Authenticated with an action-bound, single-use signature.
+     * Buy a name. The ANT is minted straight to `owner` — Turbo never holds it.
+     *
+     * This is the ONLY action that always needs the owner's signature:
+     * `ario_ant::initialize` is the one instruction in the whole lifecycle that
+     * requires the ANT owner's key. The customer signs once, here, and never
+     * again unless they change controllers or transfer the name.
+     *
+     * The owner needs a Solana key to sign with, NOT a funded one — Turbo pays
+     * every lamport of fee and rent.
      */
-    async transferArNSAnt({ antId, target, }) {
-        const nonce = uuidV4();
-        const headers = await this.signer.generateSignedRequestHeaders(nonce, this.buildArNSCustodyMessage('transfer', [antId, target]));
-        return this.httpService.post({
-            endpoint: `/arns/transfer/${antId}?target=${encodeURIComponent(target)}`,
-            headers,
-            data: Buffer.from([]),
-            retry: false, // single-use action-bound nonce; don't re-POST on 5xx
-        });
+    async buyArNSName({ name, owner, type = 'lease', years, paidBy, onNonce, }) {
+        return this.completeArNSAction('buy-name', {
+            name,
+            ownerAddress: await owner.getAddress(),
+            type,
+            ...(years !== undefined ? { years } : {}),
+            ...(paidBy !== undefined ? { paidBy } : {}),
+        }, owner, { onNonce });
+    }
+    /** Extend a lease. Permissionless on chain — no owner signature needed. */
+    async extendArNSLease({ name, years, paidBy, onNonce, }) {
+        return this.completeArNSAction('extend-lease', { name, years, ...(paidBy !== undefined ? { paidBy } : {}) }, undefined, { onNonce });
+    }
+    /** Upgrade a lease to a permanent name. No owner signature needed. */
+    async upgradeArNSName({ name, paidBy, onNonce, }) {
+        return this.completeArNSAction('upgrade-name', { name, ...(paidBy !== undefined ? { paidBy } : {}) }, undefined, { onNonce });
+    }
+    /** Raise the undername limit. No owner signature needed. */
+    async increaseArNSUndernameLimit({ name, increaseQty, paidBy, onNonce, }) {
+        return this.completeArNSAction('increase-undername-limit', { name, increaseQty, ...(paidBy !== undefined ? { paidBy } : {}) }, undefined, { onNonce });
     }
-    /** Set a resolution record on a custodied ANT (undername defaults to '@'). */
-    async setArNSRecord({ antId, undername = '@', transactionId, ttlSeconds, }) {
-        const nonce = uuidV4();
-        const headers = await this.signer.generateSignedRequestHeaders(nonce, this.buildArNSCustodyMessage('set-record', [
+    /**
+     * Point a name (or undername) at an Arweave transaction.
+     *
+     * Free — Turbo sponsors the Solana fee. Completes in one call while Turbo is
+     * a controller of the ANT, and returns `awaiting-signature` once the customer
+     * has revoked Turbo, at which point `owner` signs it themselves. Both paths
+     * are handled here.
+     *
+     * The owner proof is required EITHER WAY: Turbo is directing its own
+     * controller authority over an asset someone else owns, so nothing on chain
+     * records the owner's consent and we demand it. It is a MESSAGE signature,
+     * not a transaction — cheap and offline, but still a wallet prompt.
+     */
+    async setArNSRecord({ antId, owner, transactionId, undername = '@', ttlSeconds = 3600, onNonce, }) {
+        return this.completeArNSAction('set-record', {
+            antId,
+            ownerAddress: await owner.getAddress(),
+            transactionId,
+            undername,
+            ttlSeconds,
+        }, owner, { onNonce }, buildArNSCustodyMessage('set-record', [
             antId,
             undername,
             transactionId,
             String(ttlSeconds),
         ]));
-        const query = `?undername=${encodeURIComponent(undername)}&transactionId=${transactionId}&ttlSeconds=${ttlSeconds}`;
-        return this.httpService.post({
-            endpoint: `/arns/manage/${antId}/set-record${query}`,
-            headers,
-            data: Buffer.from([]),
-            retry: false, // single-use action-bound nonce; don't re-POST on 5xx
-        });
     }
-    /** Remove a resolution record (an undername) from a custodied ANT. */
-    async removeArNSRecord({ antId, undername, }) {
-        const nonce = uuidV4();
-        const headers = await this.signer.generateSignedRequestHeaders(nonce, this.buildArNSCustodyMessage('remove-record', [antId, undername]));
-        return this.httpService.post({
-            endpoint: `/arns/manage/${antId}/remove-record?undername=${encodeURIComponent(undername)}`,
-            headers,
-            data: Buffer.from([]),
-            retry: false, // single-use action-bound nonce; don't re-POST on 5xx
-        });
+    /** Remove a record (an undername). Free; same two-shape rules as setArNSRecord. */
+    async removeArNSRecord({ antId, owner, undername, onNonce, }) {
+        return this.completeArNSAction('remove-record', { antId, ownerAddress: await owner.getAddress(), undername }, owner, { onNonce }, buildArNSCustodyMessage('remove-record', [antId, undername]));
+    }
+    /**
+     * Grant controller rights on the ANT. Omit `target` for Turbo itself, which
+     * is what makes `setArNSRecord` a single call.
+     *
+     * Owner-signed: changing an ANT's access control is an owner-only
+     * instruction. Free to the customer — Turbo funds the ACL page growth.
+     */
+    async addArNSController({ antId, owner, target, onNonce, }) {
+        return this.completeArNSAction('add-controller', {
+            antId,
+            ownerAddress: await owner.getAddress(),
+            ...(target !== undefined ? { target } : {}),
+        }, owner, { onNonce });
+    }
+    /**
+     * Revoke controller rights — the escape hatch that keeps "Turbo is not a
+     * custodian" honest.
+     *
+     * Always available, always free, and needs nothing from Turbo but the fee.
+     * After revoking, `setArNSRecord` keeps working: it simply starts returning
+     * `awaiting-signature` so the owner signs their own record writes.
+     */
+    async removeArNSController({ antId, owner, target, onNonce, }) {
+        return this.completeArNSAction('remove-controller', {
+            antId,
+            ownerAddress: await owner.getAddress(),
+            ...(target !== undefined ? { target } : {}),
+        }, owner, { onNonce });
+    }
+    /**
+     * Hand the ANT to a new owner. Irreversible: after this lands, `owner` no
+     * longer controls the name. Owner-signed, and sponsored like the rest.
+     */
+    async transferArNSAnt({ antId, owner, target, onNonce, }) {
+        return this.completeArNSAction('transfer', { antId, ownerAddress: await owner.getAddress(), target }, owner, { onNonce });
+    }
+    /**
+     * Defaults to the signer's own address when `userAddress` is omitted
+     * (`null`/`undefined`). Passing `''` does NOT trigger this default --
+     * mirrors `getBalance`'s existing behavior above.
+     */
+    async getArNSNames(userAddress) {
+        userAddress ??= await this.signer.getNativeAddress();
+        return super.getArNSNames(userAddress);
     }
     async getCreditShareApprovals({ userAddress, }) {
         userAddress ??= await this.signer.getNativeAddress();

package/lib/esm/common/turbo.js

@@ -66,6 +66,19 @@ export class TurboUnauthenticatedClient {
     getArNSPurchaseStatus(p) {
         return this.paymentService.getArNSPurchaseStatus(p);
     }
+    /**
+     * Returns the ArNS names a wallet owns or controls via Turbo's custodial
+     * ArNS-with-credits feature. `custodial: true` on a returned name means
+     * Turbo still holds/manages its ANT (transfer/manage routes apply);
+     * `custodial: false` means self-custody (or an already-completed exit) and
+     * is informational only.
+     *
+     * To read a name's current records or lease/expiration state, use
+     * `@ar.io/sdk` directly against the returned `antId`.
+     */
+    getArNSNames(address) {
+        return this.paymentService.getArNSNames(address);
+    }
     /**
      * Quote a fiat (Stripe) ArNS purchase — buy a name with a credit card in one
      * step, no Turbo Credits top-up in between. Complete the returned
@@ -197,16 +210,22 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     getPaymentHistory(params) {
         return this.paymentService.getPaymentHistory(params);
     }
-    /**
-     * 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);
+    // ===== ArNS actions (sponsored) =====
+    //
+    // Thin delegations. The two-shape branch and the owner-proof construction
+    // live in the payment service; see its comments for why callers must branch
+    // on `status` rather than on which action they asked for.
+    /** Create an action. Debits credits HERE — capture the nonce before signing. */
+    createArNSAction(action, params, ownerProof) {
+        return this.paymentService.createArNSAction(action, params, ownerProof);
     }
-    /** Buys a new ArNS name (lease or permabuy). */
-    buyArNSName(params) {
-        return this.paymentService.buyArNSName(params);
+    /** Submit the owner-signed transaction (FULL serialized tx, base64). */
+    signArNSAction(nonce, signedTransaction) {
+        return this.paymentService.signArNSAction(nonce, signedTransaction);
+    }
+    /** Status by nonce — open, needs no signature. Use it to resume. */
+    getArNSActionStatus(nonce) {
+        return this.paymentService.getArNSActionStatus(nonce);
     }
     /**
      * Quote a fiat (Stripe) ArNS purchase for this signer's wallet — a credit-card
@@ -220,27 +239,53 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     getArNSFiatPurchaseQuote(params) {
         return this.paymentService.getArNSFiatPurchaseQuote(params);
     }
-    /** Extends the lease on an existing ArNS name. */
+    /**
+     * Buy a name. The ANT is minted straight to `owner`; Turbo never holds it.
+     * The only action that always needs the owner's signature — once, ever.
+     */
+    buyArNSName(params) {
+        return this.paymentService.buyArNSName(params);
+    }
+    /** Extend a lease. No owner signature needed. */
     extendArNSLease(params) {
         return this.paymentService.extendArNSLease(params);
     }
-    /** Increases the undername limit on an existing ArNS name. */
+    /** Raise the undername limit. No owner signature needed. */
     increaseArNSUndernameLimit(params) {
         return this.paymentService.increaseArNSUndernameLimit(params);
     }
-    /** Upgrades an ArNS lease to a permabuy. */
+    /** Upgrade a lease to a permanent name. No owner signature needed. */
     upgradeArNSName(params) {
         return this.paymentService.upgradeArNSName(params);
     }
-    transferArNSAnt(params) {
-        return this.paymentService.transferArNSAnt(params);
-    }
+    /** Point a name (or undername) at data. Free; handles both shapes. */
     setArNSRecord(params) {
         return this.paymentService.setArNSRecord(params);
     }
+    /** Remove a record. Free; handles both shapes. */
     removeArNSRecord(params) {
         return this.paymentService.removeArNSRecord(params);
     }
+    /** Grant controller rights — omit `target` for Turbo itself. Free. */
+    addArNSController(params) {
+        return this.paymentService.addArNSController(params);
+    }
+    /** Revoke controller rights. Always available, always free. */
+    removeArNSController(params) {
+        return this.paymentService.removeArNSController(params);
+    }
+    /** Hand the ANT to a new owner. Irreversible. Free. */
+    transferArNSAnt(params) {
+        return this.paymentService.transferArNSAnt(params);
+    }
+    /**
+     * Returns the ArNS names owned or controlled by the connected signer's
+     * wallet (or the given `userAddress`) via Turbo's custodial
+     * ArNS-with-credits feature.
+     */
+    getArNSNames(userAddress) {
+        return this.paymentService.getArNSNames(userAddress);
+    }
     /**
      * Returns a list of all credit share approvals for the user.
      */

package/lib/esm/types.js

@@ -99,6 +99,25 @@ export const arNSPurchaseIntents = [
     'Increase-Undername-Limit',
     'Upgrade-Name',
 ];
+// ===== ArNS actions (sponsored — the current bundler surface) =====
+/**
+ * The nine sponsored ArNS actions.
+ *
+ * NOT included, because the bundler does not sponsor them: `primary-name`,
+ * `release-name`, `reassign`, and ANT metadata (name/description/keywords/logo).
+ * Those stay on the direct-signer path and cost the user SOL.
+ */
+export const arNSActions = [
+    'buy-name',
+    'extend-lease',
+    'upgrade-name',
+    'increase-undername-limit',
+    'set-record',
+    'remove-record',
+    'add-controller',
+    'remove-controller',
+    'transfer',
+];
 // ===== ArNS purchases paid with fiat (Stripe) — no Turbo Credits in between ====
 /**
  * Stripe integration mode for a fiat ArNS purchase quote.

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

@@ -1,4 +1,5 @@
-import { ArNSFiatPurchaseQuoteParams, ArNSFiatPurchaseQuoteResponse, ArNSNameType, ArNSPriceParams, ArNSPriceResponse, ArNSPurchaseResponse, ArNSPurchaseStatusResponse } from '../../types.js';
+import { ArNSFiatPurchaseQuoteParams, ArNSFiatPurchaseQuoteResponse, ArNSNameType, ArNSPriceParams, ArNSPriceResponse, ArNSPurchaseStatusResponse } from '../../types.js';
+import { ArNSActionCompleted, ArNSOwnerSigner } from '../../types.js';
 import { ArNSFiatQuoteOptions, ArNSPriceOptions, ArNSPurchaseOptions, ArNSPurchaseStatusOptions, RemoveArNSRecordOptions, SetArNSRecordOptions, TransferArNSAntOptions } from '../types.js';
 export type ArNSPriceClient = {
     getArNSPriceForName(params: ArNSPriceParams): Promise<ArNSPriceResponse>;
@@ -11,56 +12,44 @@ export type ArNSStatusClient = {
 export type ArNSPurchaseClient = {
     buyArNSName(params: {
         name: string;
-        type: ArNSNameType;
+        owner: ArNSOwnerSigner;
+        type?: ArNSNameType;
         years?: number;
-        processId?: string;
         paidBy?: string[];
-    }): Promise<ArNSPurchaseResponse>;
+    }): Promise<ArNSActionCompleted>;
     extendArNSLease(params: {
         name: string;
         years: number;
         paidBy?: string[];
-    }): Promise<ArNSPurchaseResponse>;
+    }): Promise<ArNSActionCompleted>;
     increaseArNSUndernameLimit(params: {
         name: string;
         increaseQty: number;
         paidBy?: string[];
-    }): Promise<ArNSPurchaseResponse>;
+    }): Promise<ArNSActionCompleted>;
     upgradeArNSName(params: {
         name: string;
         paidBy?: string[];
-    }): Promise<ArNSPurchaseResponse>;
+    }): Promise<ArNSActionCompleted>;
 };
 export type ArNSCustodyClient = {
     transferArNSAnt(params: {
         antId: string;
+        owner: ArNSOwnerSigner;
         target: string;
-    }): Promise<{
-        antId: string;
-        target: string;
-        name?: string;
-        messageId: string;
-    }>;
+    }): Promise<ArNSActionCompleted>;
     setArNSRecord(params: {
         antId: string;
-        undername?: string;
+        owner: ArNSOwnerSigner;
         transactionId: string;
-        ttlSeconds: number;
-    }): Promise<{
-        antId: string;
-        undername: string;
-        transactionId: string;
-        ttlSeconds: number;
-        messageId: string;
-    }>;
+        undername?: string;
+        ttlSeconds?: number;
+    }): Promise<ArNSActionCompleted>;
     removeArNSRecord(params: {
         antId: string;
+        owner: ArNSOwnerSigner;
         undername: string;
-    }): Promise<{
-        antId: string;
-        undername: string;
-        messageId: string;
-    }>;
+    }): Promise<ArNSActionCompleted>;
 };
 export declare function requiredNameFromOptions(options: {
     name?: string;

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

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