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

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,45 @@ async function arnsPrice(options, turbo) {
         mARIO,
     }, null, 2));
 }
+async function arnsFiatQuote(options, turbo) {
+    const params = arnsPriceParamsFromOptions(options);
+    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/http.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TurboHTTPService = exports.defaultRetryConfig = void 0;
+exports.TurboHTTPService = exports.x402UploadEndpoints = exports.defaultRetryConfig = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -34,6 +34,18 @@ const defaultHeaders = {
     'x-turbo-source-version': version_js_1.version,
     'x-turbo-source-identifier': 'turbo-sdk',
 };
+/**
+ * Canonical x402 upload routes on the upload service.
+ *
+ * These were previously `/x402/data-item/{signed,unsigned}`. The service
+ * renamed them to `/x402/upload/*` and kept a `data-item/signed` alias, but not
+ * a `data-item/unsigned` one — so every unsigned x402 upload 404ed. Both
+ * canonical paths are served by all released upload-service versions.
+ */
+exports.x402UploadEndpoints = {
+    signed: '/x402/upload/signed',
+    unsigned: '/x402/upload/unsigned',
+};
 class TurboHTTPService {
     constructor({ url, logger, retryConfig = (0, exports.defaultRetryConfig)(logger), }) {
         this.logger = logger;
@@ -124,7 +136,9 @@ class TurboHTTPService {
         throw new errors_js_1.FailedRequestError('Max retries reached - ' + lastError?.message, lastError?.status);
     }
     async x402Post({ signal, allowedStatuses, headers, data, x402Options, }) {
-        const endpoint = '/x402/data-item/' + (x402Options.unsignedData ? 'unsigned' : 'signed');
+        const endpoint = x402Options.unsignedData
+            ? exports.x402UploadEndpoints.unsigned
+            : exports.x402UploadEndpoints.signed;
         this.logger.debug('Using X402 options for POST request', {
             endpoint,
             x402Options,

package/lib/cjs/common/payment.js

@@ -190,6 +190,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 +444,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);

package/lib/cjs/common/signer.js

@@ -60,7 +60,6 @@ class TurboDataItemAbstractSigner {
             case 'base-eth':
             case 'usdc':
             case 'base-usdc':
-            case 'base-ario':
             case 'polygon-usdc':
                 return (0, ethers_2.computeAddress)((0, signing_key_1.computePublicKey)((0, base64_js_1.fromB64Url)(owner)));
             case 'kyve':
@@ -172,13 +171,23 @@ class TurboDataItemAbstractSigner {
     }
 }
 exports.TurboDataItemAbstractSigner = TurboDataItemAbstractSigner;
+/**
+ * Builds the wallet client x402-fetch signs payment authorizations with.
+ *
+ * The chain matters because `wrapFetchWithPayment` maps `walletClient.chain.id`
+ * to a network name and prefers the matching entry in the service's `accepts`
+ * list. The upload service advertises Base mainnet (`base`), and x402 support
+ * here is limited to `base-usdc`, so mainnet is the correct default. Callers
+ * needing another network can supply their own signer via
+ * `X402Funding({ signer })`.
+ */
 async function makeX402Signer(arbundlesSigner) {
     // Node: our SDK uses EthereumSigner with a raw private key
     if (arbundlesSigner instanceof arbundles_1.EthereumSigner) {
         return (0, viem_1.createWalletClient)({
             account: (0, accounts_1.privateKeyToAccount)(('0x' +
                 Buffer.from(arbundlesSigner.key).toString('hex'))),
-            chain: chains_1.baseSepolia,
+            chain: chains_1.base,
             transport: (0, viem_1.http)(),
         });
     }
@@ -197,7 +206,7 @@ async function makeX402Signer(arbundlesSigner) {
         const account = accounts[0];
         return (0, viem_1.createWalletClient)({
             account,
-            chain: chains_1.baseSepolia,
+            chain: chains_1.base,
             transport: (0, viem_1.custom)(provider),
         });
     }

package/lib/cjs/common/token/index.js

@@ -17,17 +17,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.tokenToBaseMap = exports.exponentMap = exports.defaultTokenMap = void 0;
 exports.isTokenType = isTokenType;
 const types_js_1 = require("../../types.js");
-const common_js_1 = require("../../utils/common.js");
 const ario_js_1 = require("./ario.js");
 const arweave_js_1 = require("./arweave.js");
 const baseEth_js_1 = require("./baseEth.js");
-const erc20_js_1 = require("./erc20.js");
 const ethereum_js_1 = require("./ethereum.js");
 const kyve_js_1 = require("./kyve.js");
 const polygon_js_1 = require("./polygon.js");
 const solana_js_1 = require("./solana.js");
 const usdc_js_1 = require("./usdc.js");
-const baseARIOContractAddress = '0x138746adfA52909E5920def027f5a8dc1C7EfFb6';
 exports.defaultTokenMap = {
     arweave: (config) => new arweave_js_1.ArweaveToken(config),
     ario: (config) => new ario_js_1.ARIOToken(config),
@@ -40,12 +37,6 @@ exports.defaultTokenMap = {
     usdc: (config) => new usdc_js_1.USDCToken({ network: 'ethereum', ...config }),
     'base-usdc': (config) => new usdc_js_1.USDCToken({ network: 'base', ...config }),
     'polygon-usdc': (config) => new usdc_js_1.USDCToken({ network: 'polygon', ...config }),
-    'base-ario': (config) => new erc20_js_1.ERC20Token({
-        ...config,
-        pollingOptions: config.pollingOptions ?? baseEth_js_1.defaultBaseNetworkPollingOptions,
-        tokenContractAddress: baseARIOContractAddress,
-        gatewayUrl: config.gatewayUrl ?? common_js_1.defaultProdGatewayUrls['base-ario'],
-    }),
 };
 const ethExponent = 18;
 const usdcExponent = 6;
@@ -53,7 +44,6 @@ const arioExponent = 6;
 exports.exponentMap = {
     arweave: 12,
     ario: arioExponent,
-    'base-ario': arioExponent,
     solana: 9,
     ethereum: ethExponent,
     'base-eth': ethExponent,
@@ -67,7 +57,6 @@ exports.exponentMap = {
 exports.tokenToBaseMap = {
     arweave: (a) => (0, arweave_js_1.ARToTokenAmount)(a),
     ario: (a) => (0, ario_js_1.ARIOToTokenAmount)(a),
-    'base-ario': (a) => (0, usdc_js_1.USDCToTokenAmount)(a),
     solana: (a) => (0, solana_js_1.SOLToTokenAmount)(a),
     ethereum: (a) => (0, ethereum_js_1.ETHToTokenAmount)(a),
     'base-eth': (a) => (0, ethereum_js_1.ETHToTokenAmount)(a),

package/lib/cjs/common/turbo.js

@@ -69,6 +69,17 @@ class TurboUnauthenticatedClient {
     getArNSPurchaseStatus(p) {
         return this.paymentService.getArNSPurchaseStatus(p);
     }
+    /**
+     * 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 +212,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);

package/lib/cjs/common/upload.js

@@ -123,7 +123,9 @@ class TurboUnauthenticatedUploadService {
             };
         return this.httpService.post({
             data: dataBuffer,
-            endpoint: '/x402/data-item/unsigned',
+            // Only reached when no signer was supplied; the x402 path recomputes this
+            // from `unsignedData`. Both must name the same route.
+            endpoint: http_js_2.x402UploadEndpoints.unsigned,
             signal,
             headers: tags !== undefined
                 ? { 'x-data-item-tags': JSON.stringify(tags) }
@@ -142,7 +144,6 @@ class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUploadServ
             'solana',
             'base-eth',
             'base-usdc',
-            'base-ario',
         ];
         this.signer = signer;
         this.paymentService = paymentService;

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;
@@ -25,7 +25,6 @@ function isCurrency(currency) {
 exports.tokenTypes = [
     'arweave',
     'ario',
-    'base-ario',
     'solana',
     'ethereum',
     'kyve',
@@ -44,7 +43,6 @@ exports.supportedEvmSignerTokens = new Set([
     'polygon-usdc',
     'usdc',
     'base-usdc',
-    'base-ario',
 ]);
 class ExistingBalanceFunding {
 }
@@ -115,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/common.js

@@ -50,7 +50,6 @@ const baseMainnetRpc = 'https://mainnet.base.org';
 exports.tokenToDevGatewayMap = {
     arweave: 'https://turbo-gateway.com', // No arweave test net
     ario: 'https://api.devnet.solana.com',
-    'base-ario': baseMainnetRpc, // No base-ario test net contract deployed
     solana: 'https://api.devnet.solana.com',
     ethereum: ethTestnetRpc,
     'base-eth': baseTestnetRpc,
@@ -64,7 +63,6 @@ exports.tokenToDevGatewayMap = {
 exports.defaultProdGatewayUrls = {
     arweave: 'https://turbo-gateway.com',
     ario: 'https://api.mainnet-beta.solana.com',
-    'base-ario': baseMainnetRpc,
     solana: 'https://api.mainnet-beta.solana.com',
     ethereum: 'https://cloudflare-eth.com/',
     'base-eth': baseMainnetRpc,
@@ -102,7 +100,6 @@ function createTurboSigner({ signer: clientProvidedSigner, privateKey: clientPro
         case 'base-eth':
         case 'usdc':
         case 'base-usdc':
-        case 'base-ario':
         case 'polygon-usdc':
             if (!(0, types_js_1.isEthPrivateKey)(clientProvidedPrivateKey)) {
                 throw new Error('A valid Ethereum private key must be provided for EthereumSigner.');
@@ -167,7 +164,6 @@ function isValidUserAddress(address, type) {
         case 'matic':
         case 'pol':
         case 'base-usdc':
-        case 'base-ario':
         case 'usdc':
         case 'polygon-usdc':
             return isValidECDSAAddress(address);

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,45 @@ export async function arnsPrice(options, turbo) {
         mARIO,
     }, null, 2));
 }
+export async function arnsFiatQuote(options, turbo) {
+    const params = arnsPriceParamsFromOptions(options);
+    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,

package/lib/esm/common/http.js

@@ -30,6 +30,18 @@ const defaultHeaders = {
     'x-turbo-source-version': version,
     'x-turbo-source-identifier': 'turbo-sdk',
 };
+/**
+ * Canonical x402 upload routes on the upload service.
+ *
+ * These were previously `/x402/data-item/{signed,unsigned}`. The service
+ * renamed them to `/x402/upload/*` and kept a `data-item/signed` alias, but not
+ * a `data-item/unsigned` one — so every unsigned x402 upload 404ed. Both
+ * canonical paths are served by all released upload-service versions.
+ */
+export const x402UploadEndpoints = {
+    signed: '/x402/upload/signed',
+    unsigned: '/x402/upload/unsigned',
+};
 export class TurboHTTPService {
     constructor({ url, logger, retryConfig = defaultRetryConfig(logger), }) {
         this.logger = logger;
@@ -120,7 +132,9 @@ export class TurboHTTPService {
         throw new FailedRequestError('Max retries reached - ' + lastError?.message, lastError?.status);
     }
     async x402Post({ signal, allowedStatuses, headers, data, x402Options, }) {
-        const endpoint = '/x402/data-item/' + (x402Options.unsignedData ? 'unsigned' : 'signed');
+        const endpoint = x402Options.unsignedData
+            ? x402UploadEndpoints.unsigned
+            : x402UploadEndpoints.signed;
         this.logger.debug('Using X402 options for POST request', {
             endpoint,
             x402Options,