@ardrive/turbo-sdk 1.42.0-alpha.6 → 1.42.0-alpha.8

package/lib/cjs/cli/cli.js

@@ -102,6 +102,11 @@ const utils_js_1 = require("./utils.js");
     .description('Get the Turbo Credit (winc + mARIO) price to buy, extend, increase undernames, or upgrade an ArNS name'), options_js_1.arnsPriceOptions).action(async (_commandOptions, command) => {
     await (0, utils_js_1.runCommand)(command, arns_js_1.arnsPrice);
 });
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('arns-fiat-quote')
+    .description('Quote an ArNS purchase paid by credit card (Stripe) - no credits needed'), options_js_1.arnsFiatQuoteOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, arns_js_1.arnsFiatQuote);
+});
 (0, utils_js_1.applyOptions)(commander_1.program
     .command('buy-arns-name')
     .description('Buy an ArNS name (lease or permabuy) with Turbo Credits'), options_js_1.buyArNSNameOptions).action(async (_commandOptions, command) => {

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

@@ -6,6 +6,7 @@ exports.typeFromOptions = typeFromOptions;
 exports.paidByFromArNSOptions = paidByFromArNSOptions;
 exports.arnsPriceParamsFromOptions = arnsPriceParamsFromOptions;
 exports.arnsPrice = arnsPrice;
+exports.arnsFiatQuote = arnsFiatQuote;
 exports.buyArNSName = buyArNSName;
 exports.extendArNSLease = extendArNSLease;
 exports.increaseArNSUndernames = increaseArNSUndernames;
@@ -146,6 +147,53 @@ async function arnsPrice(options, turbo) {
         mARIO,
     }, null, 2));
 }
+async function arnsFiatQuote(options, turbo) {
+    const params = arnsPriceParamsFromOptions(options);
+    // `arnsPriceParamsFromOptions` substitutes PRICING_PLACEHOLDER_PROCESS_ID for
+    // an omitted Buy-Name `processId`, which is fine for a price lookup but NOT
+    // here: a quote records a real purchase, and that placeholder is not a valid
+    // ANT. Send `processId` only when the caller actually supplied one — omitting
+    // it is what tells Turbo to custodially provision the ANT.
+    if (options.processId === undefined) {
+        delete params.processId;
+    }
+    const address = options.address;
+    if (address === undefined) {
+        throw new Error('A destination --address is required for a fiat ArNS quote.');
+    }
+    const client = turbo ?? factory_js_1.TurboFactory.unauthenticated((0, utils_js_1.configFromOptions)(options));
+    try {
+        const { purchaseQuote, paymentSession, adjustments, fees } = await client.getArNSFiatPurchaseQuote({
+            ...params,
+            address,
+            currency: (options.currency ?? 'usd'),
+            method: options.method,
+            promoCodes: options.promoCode,
+        });
+        console.log(JSON.stringify({
+            name: purchaseQuote.name,
+            intent: purchaseQuote.intent,
+            nonce: purchaseQuote.nonce,
+            paymentAmount: purchaseQuote.paymentAmount,
+            currency: purchaseQuote.currencyType,
+            quoteExpirationDate: purchaseQuote.quoteExpirationDate,
+            paymentSessionId: paymentSession.id,
+            // Present for a payment intent / embedded checkout; a hosted
+            // checkout session returns `url` instead.
+            clientSecret: paymentSession.client_secret ?? undefined,
+            checkoutUrl: paymentSession.url ?? undefined,
+            adjustments,
+            fees,
+        }, null, 2));
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.FiatPaymentsDisabledError) {
+            console.error('Fiat (Stripe) payments are disabled on this payment service. Use the credit-paid commands (buy-arns-name, extend-arns-lease, ...) instead.');
+            throw error;
+        }
+        throw error;
+    }
+}
 async function buyArNSName(options, turbo) {
     const name = requiredNameFromOptions(options);
     const type = typeFromOptions(options.type);

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.arnsPriceOptions = exports.listSharesOptions = exports.revokeCreditsOptions = exports.shareCreditsOptions = exports.uploadFileOptions = exports.uploadFolderOptions = exports.uploadOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+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>',
@@ -304,6 +304,23 @@ exports.arnsPriceOptions = [
     exports.optionMap.arnsIncreaseQty,
     exports.optionMap.arnsProcessId,
 ];
+exports.arnsFiatQuoteOptions = [
+    exports.optionMap.arnsName,
+    exports.optionMap.arnsType,
+    exports.optionMap.arnsYears,
+    exports.optionMap.arnsIncreaseQty,
+    exports.optionMap.arnsProcessId,
+    exports.optionMap.address,
+    exports.optionMap.currency,
+    {
+        alias: '--method <method>',
+        description: 'Stripe integration mode: payment-intent (default) or checkout-session',
+    },
+    {
+        alias: '--promo-code <promoCode...>',
+        description: 'Promo code(s) to apply to the fiat price',
+    },
+];
 exports.buyArNSNameOptions = [
     ...exports.walletOptions,
     exports.optionMap.arnsName,

package/lib/cjs/common/payment.js

@@ -62,6 +62,22 @@ 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',
@@ -190,6 +206,95 @@ class TurboUnauthenticatedPaymentService {
         const query = params.toString();
         return query.length > 0 ? `?${query}` : '';
     }
+    /**
+     * Quote a fiat (Stripe) ArNS purchase — buy a name with a credit card in one
+     * step, with no Turbo Credits top-up in between.
+     *
+     * Returns the recorded `purchaseQuote` (its `nonce` is what
+     * `getArNSPurchaseStatus` polls) plus the Stripe `paymentSession` to complete
+     * payment with. For `payment-intent`, confirm client-side with
+     * `stripe.confirmCardPayment(paymentSession.client_secret, ...)`, then poll
+     * the nonce until the purchase reports success or failure.
+     *
+     * Throws {@link FiatPaymentsDisabledError} when the service has Stripe turned
+     * off (normal in the testnet sandbox) so callers can fall back to the
+     * credit-paid path without string-matching a generic 503.
+     */
+    async getArNSFiatPurchaseQuote(params) {
+        this.validateArNSPurchaseParams(params);
+        const { address, currency, method = 'payment-intent', promoCodes = [], } = params;
+        if (typeof address !== 'string' || address.length === 0) {
+            throw new errors_js_1.ProvidedInputError('A destination `address` is required for a fiat ArNS purchase quote.');
+        }
+        if (!(0, types_js_1.isCurrency)(currency)) {
+            throw new errors_js_1.ProvidedInputError(`Invalid currency '${currency}'. Supported: ${types_js_1.fiatCurrencyTypes.join(', ')}`);
+        }
+        // Every interpolated segment is encoded. Five user-controlled values land in
+        // the path here, and an unencoded one (e.g. a name or address containing
+        // `../`) would silently retarget the request at another route.
+        const segments = [
+            method,
+            address,
+            currency,
+            params.intent,
+            params.name,
+        ].map((segment) => encodeURIComponent(segment));
+        const query = this.buildArNSFiatQuoteQuery(params, promoCodes);
+        try {
+            return await this.httpService.get({
+                endpoint: `/arns/quote/${segments.join('/')}${query}`,
+            });
+        }
+        catch (error) {
+            // The service returns 503 both for "Stripe is disabled" and for internal
+            // errors, so the body is what disambiguates them.
+            if (error instanceof errors_js_1.FailedRequestError &&
+                error.status === 503 &&
+                /Fiat \(Stripe\).*disabled/i.test(error.message)) {
+                throw new errors_js_1.FiatPaymentsDisabledError(error.message);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Query string for a fiat quote. Distinct from `buildArNSPurchaseQuery`
+     * because this route takes `uiMode` + its paired URLs and has no `paidBy`
+     * (fiat has no delegated payer), and because promo codes must be REPEATED
+     * params here: the service reads them with `parseQueryParams`, which treats a
+     * comma-joined string as one code rather than several.
+     */
+    buildArNSFiatQuoteQuery(params, promoCodes) {
+        const { type, years, increaseQty, processId } = params;
+        const search = new URLSearchParams();
+        if (type !== undefined)
+            search.set('type', type);
+        if (years !== undefined)
+            search.set('years', `${years}`);
+        if (increaseQty !== undefined)
+            search.set('increaseQty', `${increaseQty}`);
+        if (processId !== undefined)
+            search.set('processId', processId);
+        const uiMode = params.uiMode;
+        if (uiMode !== undefined)
+            search.set('uiMode', uiMode);
+        if (uiMode === 'embedded') {
+            const { returnUrl } = params;
+            if (returnUrl !== undefined)
+                search.set('returnUrl', returnUrl);
+        }
+        else {
+            const { successUrl, cancelUrl } = params;
+            if (successUrl !== undefined)
+                search.set('successUrl', successUrl);
+            if (cancelUrl !== undefined)
+                search.set('cancelUrl', cancelUrl);
+        }
+        for (const code of promoCodes) {
+            search.append('promoCode', code);
+        }
+        const query = search.toString();
+        return query.length > 0 ? `?${query}` : '';
+    }
     appendPromoCodesToQuery(promoCodes) {
         const promoCodesQuery = promoCodes.join(',');
         return promoCodesQuery ? `promoCode=${promoCodesQuery}` : '';
@@ -355,6 +460,20 @@ class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentServic
         userAddress ??= await this.signer.getNativeAddress();
         return super.getBalance(userAddress);
     }
+    /**
+     * Quote a fiat (Stripe) ArNS purchase. `address` defaults to this signer's
+     * native address — the wallet that will own the name — so the common case
+     * needs no address at all. Pass one explicitly to buy on another wallet's
+     * behalf; the route takes the destination as a path param and requires no
+     * signature, which is why it is available unauthenticated too.
+     */
+    async getArNSFiatPurchaseQuote(params) {
+        const address = params.address ?? (await this.signer.getNativeAddress());
+        return super.getArNSFiatPurchaseQuote({
+            ...params,
+            address,
+        });
+    }
     async getFreeStatus(userAddress) {
         userAddress ??= await this.signer.getNativeAddress();
         return super.getFreeStatus(userAddress);
@@ -498,6 +617,15 @@ class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentServic
             retry: false, // single-use action-bound nonce; don't re-POST on 5xx
         });
     }
+    /**
+     * 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();
         return super.getCreditShareApprovals({ userAddress });

package/lib/cjs/common/turbo.js

@@ -69,6 +69,30 @@ 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
+     * `paymentSession` with Stripe, then poll {@link getArNSPurchaseStatus} using
+     * `purchaseQuote.nonce`.
+     *
+     * Throws `FiatPaymentsDisabledError` when the service has Stripe switched off.
+     */
+    getArNSFiatPurchaseQuote(params) {
+        return this.paymentService.getArNSFiatPurchaseQuote(params);
+    }
     /**
      * Returns a list of all supported fiat currencies.
      */
@@ -201,6 +225,18 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     buyArNSName(params) {
         return this.paymentService.buyArNSName(params);
     }
+    /**
+     * Quote a fiat (Stripe) ArNS purchase for this signer's wallet — a credit-card
+     * buy in one step, with no Turbo Credits top-up in between. `address` defaults
+     * to the signer's native address; pass one to buy on another wallet's behalf.
+     *
+     * Complete the returned `paymentSession` with Stripe, then poll
+     * {@link getArNSPurchaseStatus} using `purchaseQuote.nonce`. Throws
+     * `FiatPaymentsDisabledError` when the service has Stripe switched off.
+     */
+    getArNSFiatPurchaseQuote(params) {
+        return this.paymentService.getArNSFiatPurchaseQuote(params);
+    }
     /** Extends the lease on an existing ArNS name. */
     extendArNSLease(params) {
         return this.paymentService.extendArNSLease(params);
@@ -222,6 +258,14 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     removeArNSRecord(params) {
         return this.paymentService.removeArNSRecord(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/cjs/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.arNSPurchaseIntents = exports.validChunkingModes = exports.isJWK = exports.isWebUploadFolderParams = exports.isNodeUploadFolderParams = exports.multipartFinalizedStatus = exports.multipartFailedStatus = exports.multipartPendingStatus = exports.X402Funding = exports.OnDemandFunding = exports.ExistingBalanceFunding = exports.supportedEvmSignerTokens = exports.tokenTypes = exports.fiatCurrencyTypes = void 0;
+exports.arNSFiatPurchaseMethods = exports.arNSPurchaseIntents = exports.validChunkingModes = exports.isJWK = exports.isWebUploadFolderParams = exports.isNodeUploadFolderParams = exports.multipartFinalizedStatus = exports.multipartFailedStatus = exports.multipartPendingStatus = exports.X402Funding = exports.OnDemandFunding = exports.ExistingBalanceFunding = exports.supportedEvmSignerTokens = exports.tokenTypes = exports.fiatCurrencyTypes = void 0;
 exports.isCurrency = isCurrency;
 exports.isKyvePrivateKey = isKyvePrivateKey;
 exports.isEthPrivateKey = isEthPrivateKey;
@@ -113,3 +113,20 @@ exports.arNSPurchaseIntents = [
     'Increase-Undername-Limit',
     'Upgrade-Name',
 ];
+// ===== ArNS purchases paid with fiat (Stripe) — no Turbo Credits in between ====
+/**
+ * Stripe integration mode for a fiat ArNS purchase quote.
+ *
+ * - `payment-intent` — returns a Stripe PaymentIntent. Confirm it client-side
+ *   with `stripe.confirmCardPayment(paymentSession.client_secret, ...)`.
+ * - `checkout-session` — returns a Stripe Checkout Session to redirect to
+ *   (`uiMode: 'hosted'`) or embed (`uiMode: 'embedded'`).
+ *
+ * Widened with `string & Record<never, never>` so a method added service-side is
+ * still callable without an SDK bump, while the known values keep autocomplete.
+ * (`string & {}` is the usual idiom but trips the `ban-types` lint rule.)
+ */
+exports.arNSFiatPurchaseMethods = [
+    'payment-intent',
+    'checkout-session',
+];

package/lib/cjs/utils/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbortError = exports.InsufficientCreditsError = exports.ProvidedInputError = exports.FailedRequestError = exports.UnauthenticatedRequestError = exports.BaseError = void 0;
+exports.AbortError = exports.FiatPaymentsDisabledError = exports.InsufficientCreditsError = exports.ProvidedInputError = exports.FailedRequestError = exports.UnauthenticatedRequestError = exports.BaseError = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -60,6 +60,25 @@ class InsufficientCreditsError extends BaseError {
     }
 }
 exports.InsufficientCreditsError = InsufficientCreditsError;
+/**
+ * Raised when the payment service has fiat (Stripe) payments switched off, which
+ * it signals with `503` and the body "Fiat (Stripe) ArNS payments are disabled".
+ * This is a normal state in the testnet sandbox, not an outage.
+ *
+ * Distinguished from a generic `503` deliberately: the same status is also used
+ * for internal errors (body "Internal Server Error: ..."), so status alone is
+ * ambiguous. Recovery: fall back to the credit-paid path (`buyArNSName` and
+ * friends), or surface fiat checkout as unavailable.
+ */
+class FiatPaymentsDisabledError extends BaseError {
+    constructor(message) {
+        super(message ??
+            'Fiat (Stripe) payments are disabled on this payment service. Use the credit-paid purchase path instead.');
+        /** Always the HTTP status that produced this error. */
+        this.status = 503;
+    }
+}
+exports.FiatPaymentsDisabledError = FiatPaymentsDisabledError;
 class AbortError extends BaseError {
     constructor(message = 'Request was aborted') {
         super(message);

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 { arnsPrice, arnsPurchaseStatus, buyArNSName, extendArNSLease, increaseArNSUndernames, removeArNSRecord, setArNSRecord, transferArNSAnt, upgradeArNSName, } from './commands/arns.js';
+import { arnsFiatQuote, arnsPrice, arnsPurchaseStatus, buyArNSName, extendArNSLease, increaseArNSUndernames, removeArNSRecord, setArNSRecord, transferArNSAnt, 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 { arnsPriceOptions, arnsPurchaseStatusOptions, buyArNSNameOptions, extendArNSLeaseOptions, globalOptions, increaseArNSUndernamesOptions, listSharesOptions, optionMap, removeArNSRecordOptions, revokeCreditsOptions, setArNSRecordOptions, shareCreditsOptions, transferArNSAntOptions, upgradeArNSNameOptions, uploadFileOptions, uploadFolderOptions, walletOptions, } from './options.js';
+import { arnsFiatQuoteOptions, arnsPriceOptions, arnsPurchaseStatusOptions, buyArNSNameOptions, extendArNSLeaseOptions, globalOptions, increaseArNSUndernamesOptions, listSharesOptions, optionMap, removeArNSRecordOptions, revokeCreditsOptions, setArNSRecordOptions, shareCreditsOptions, transferArNSAntOptions, upgradeArNSNameOptions, uploadFileOptions, uploadFolderOptions, walletOptions, } from './options.js';
 import { applyOptions, runCommand } from './utils.js';
 applyOptions(program
     .name('turbo')
@@ -100,6 +100,11 @@ applyOptions(program
     .description('Get the Turbo Credit (winc + mARIO) price to buy, extend, increase undernames, or upgrade an ArNS name'), arnsPriceOptions).action(async (_commandOptions, command) => {
     await runCommand(command, arnsPrice);
 });
+applyOptions(program
+    .command('arns-fiat-quote')
+    .description('Quote an ArNS purchase paid by credit card (Stripe) - no credits needed'), arnsFiatQuoteOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, arnsFiatQuote);
+});
 applyOptions(program
     .command('buy-arns-name')
     .description('Buy an ArNS name (lease or permabuy) with Turbo Credits'), buyArNSNameOptions).action(async (_commandOptions, command) => {

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

@@ -15,7 +15,7 @@
  */
 import { BigNumber } from 'bignumber.js';
 import { TurboFactory } from '../../node/factory.js';
-import { InsufficientCreditsError } from '../../utils/errors.js';
+import { FiatPaymentsDisabledError, InsufficientCreditsError, } from '../../utils/errors.js';
 import { wincPerCredit } from '../constants.js';
 import { configFromOptions, turboFromOptions } from '../utils.js';
 export function requiredNameFromOptions(options) {
@@ -130,6 +130,53 @@ export async function arnsPrice(options, turbo) {
         mARIO,
     }, null, 2));
 }
+export async function arnsFiatQuote(options, turbo) {
+    const params = arnsPriceParamsFromOptions(options);
+    // `arnsPriceParamsFromOptions` substitutes PRICING_PLACEHOLDER_PROCESS_ID for
+    // an omitted Buy-Name `processId`, which is fine for a price lookup but NOT
+    // here: a quote records a real purchase, and that placeholder is not a valid
+    // ANT. Send `processId` only when the caller actually supplied one — omitting
+    // it is what tells Turbo to custodially provision the ANT.
+    if (options.processId === undefined) {
+        delete params.processId;
+    }
+    const address = options.address;
+    if (address === undefined) {
+        throw new Error('A destination --address is required for a fiat ArNS quote.');
+    }
+    const client = turbo ?? TurboFactory.unauthenticated(configFromOptions(options));
+    try {
+        const { purchaseQuote, paymentSession, adjustments, fees } = await client.getArNSFiatPurchaseQuote({
+            ...params,
+            address,
+            currency: (options.currency ?? 'usd'),
+            method: options.method,
+            promoCodes: options.promoCode,
+        });
+        console.log(JSON.stringify({
+            name: purchaseQuote.name,
+            intent: purchaseQuote.intent,
+            nonce: purchaseQuote.nonce,
+            paymentAmount: purchaseQuote.paymentAmount,
+            currency: purchaseQuote.currencyType,
+            quoteExpirationDate: purchaseQuote.quoteExpirationDate,
+            paymentSessionId: paymentSession.id,
+            // Present for a payment intent / embedded checkout; a hosted
+            // checkout session returns `url` instead.
+            clientSecret: paymentSession.client_secret ?? undefined,
+            checkoutUrl: paymentSession.url ?? undefined,
+            adjustments,
+            fees,
+        }, null, 2));
+    }
+    catch (error) {
+        if (error instanceof FiatPaymentsDisabledError) {
+            console.error('Fiat (Stripe) payments are disabled on this payment service. Use the credit-paid commands (buy-arns-name, extend-arns-lease, ...) instead.');
+            throw error;
+        }
+        throw error;
+    }
+}
 export async function buyArNSName(options, turbo) {
     const name = requiredNameFromOptions(options);
     const type = typeFromOptions(options.type);

package/lib/esm/cli/options.js

@@ -301,6 +301,23 @@ export const arnsPriceOptions = [
     optionMap.arnsIncreaseQty,
     optionMap.arnsProcessId,
 ];
+export const arnsFiatQuoteOptions = [
+    optionMap.arnsName,
+    optionMap.arnsType,
+    optionMap.arnsYears,
+    optionMap.arnsIncreaseQty,
+    optionMap.arnsProcessId,
+    optionMap.address,
+    optionMap.currency,
+    {
+        alias: '--method <method>',
+        description: 'Stripe integration mode: payment-intent (default) or checkout-session',
+    },
+    {
+        alias: '--promo-code <promoCode...>',
+        description: 'Promo code(s) to apply to the fiat price',
+    },
+];
 export const buyArNSNameOptions = [
     ...walletOptions,
     optionMap.arnsName,