@ardrive/turbo-sdk 1.41.3 → 1.42.0-alpha.10

package/lib/esm/common/token/ario.js

@@ -13,106 +13,124 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ArconnectSigner, DataItem, createData } from '@dha-team/arbundles';
-import { connect, createDataItemSigner } from '@permaweb/aoconnect';
+import { createAssociatedTokenAccountIdempotentInstruction, createTransferCheckedInstruction, getAssociatedTokenAddressSync, } from '@solana/spl-token';
+import { Connection, PublicKey, Transaction, TransactionInstruction, } from '@solana/web3.js';
 import { BigNumber } from 'bignumber.js';
-import { defaultProdAoConfigs, sleep } from '../../utils/common.js';
-import { version } from '../../version.js';
+import bs58 from 'bs58';
+import { defaultProdGatewayUrls, sleep } from '../../utils/common.js';
 import { Logger } from '../logger.js';
+import { memoProgramId } from './solana.js';
+const ARIO_SPL_MINT_ADDRESS = 'DcNnMuFxwhgV4WY1HVSaSEgr92bv2b1vUvEKiNxWqHdF';
+const DEVNET_ARIO_SPL_MINT_ADDRESS = '6vTw5CysRXQ4ybbHkDUiisHWVsBeMtUzYvJqs2iqHyaN';
+const ARIO_TOKEN_DECIMALS = 6;
 export class ARIOToken {
-    constructor({ cuUrl = defaultProdAoConfigs.ario.cuUrl, logger = Logger.default, pollingOptions = {
+    constructor({ gatewayUrl = defaultProdGatewayUrls.solana, logger = Logger.default, pollingOptions = {
+        maxAttempts: 10,
+        pollingIntervalMs: 2_500,
         initialBackoffMs: 500,
-        pollingIntervalMs: 0, // no polling for ARIO process
-        maxAttempts: 0, // no polling for ARIO process
-    }, processId = defaultProdAoConfigs.ario.processId, } = {}) {
-        this.ao = connect({
-            CU_URL: cuUrl,
-        });
-        this.processId = processId;
+    }, } = {}) {
+        this.gatewayUrl = gatewayUrl;
+        this.connection = new Connection(gatewayUrl, 'confirmed');
         this.pollingOptions = pollingOptions;
         this.logger = logger;
+        if (gatewayUrl.includes('devnet')) {
+            this.mintAddress = DEVNET_ARIO_SPL_MINT_ADDRESS;
+        }
+        else {
+            this.mintAddress = ARIO_SPL_MINT_ADDRESS;
+        }
     }
-    async createAndSubmitTx({ target, signer: { signer }, tokenAmount, turboCreditDestinationAddress, }) {
-        const tags = [
-            {
-                name: 'Action',
-                value: 'Transfer',
-            },
-            {
-                name: 'Recipient',
-                value: target,
-            },
-            {
-                name: 'Quantity',
-                value: tokenAmount.toString(),
-            },
-            {
-                name: 'Turbo-SDK',
-                value: version,
-            },
-        ];
+    async createAndSubmitTx({ target, signer, tokenAmount, turboCreditDestinationAddress, }) {
+        const ownerPublicKey = new PublicKey(bs58.encode(Uint8Array.from(await signer.getPublicKey())));
+        const recipient = new PublicKey(target);
+        const mint = new PublicKey(this.mintAddress);
+        const fromAta = getAssociatedTokenAddressSync(mint, ownerPublicKey);
+        const toAta = getAssociatedTokenAddressSync(mint, recipient);
+        const tx = new Transaction({
+            feePayer: ownerPublicKey,
+            ...(await this.connection.getLatestBlockhash()),
+        });
+        tx.add(createAssociatedTokenAccountIdempotentInstruction(ownerPublicKey, toAta, recipient, mint));
+        tx.add(createTransferCheckedInstruction(fromAta, mint, toAta, ownerPublicKey, BigInt(new BigNumber(tokenAmount).toFixed(0)), ARIO_TOKEN_DECIMALS));
         if (turboCreditDestinationAddress !== undefined) {
-            tags.push({
-                name: 'Turbo-Credit-Destination-Address',
-                value: turboCreditDestinationAddress,
-            });
+            tx.add(new TransactionInstruction({
+                programId: new PublicKey(memoProgramId),
+                keys: [],
+                data: Buffer.from('turboCreditDestinationAddress=' + turboCreditDestinationAddress),
+            }));
         }
-        const txId = await this.ao.message({
-            signer: createAoSigner(signer),
-            process: this.processId,
-            tags,
-        });
-        this.logger.debug('Submitted Transfer message to ARIO process...', {
+        const serializedTx = tx.serializeMessage();
+        const signature = await signer.signData(Uint8Array.from(serializedTx));
+        tx.addSignature(ownerPublicKey, Buffer.from(signature));
+        const txId = bs58.encode(signature);
+        await this.submitTx(tx, txId);
+        this.logger.debug('Submitted ARIO SPL transfer transaction...', {
             id: txId,
             target,
             tokenAmount,
-            processId: this.processId,
-            tags,
+            fromAta: fromAta.toBase58(),
+            toAta: toAta.toBase58(),
+            mint: mint.toBase58(),
         });
         return { id: txId, target, reward: '0' };
     }
-    async pollTxAvailability() {
-        // AO finality should be instant -- but we'll wait initial backoff to
-        // provide infra some time to crank without reading the whole result
-        return sleep(this.pollingOptions.initialBackoffMs);
-    }
-}
-export const mARIOToTokenAmount = (mARIO) => mARIO;
-export const ARIOToTokenAmount = (ario) => new BigNumber(ario).times(1e6).valueOf();
-function createAoSigner(signer) {
-    if (!('publicKey' in signer)) {
-        return createDataItemSigner(signer);
-    }
-    const aoSigner = async ({ data, tags, target, anchor }) => {
-        // ensure appropriate permissions are granted with injected signers.
-        if (signer.publicKey === undefined &&
-            'setPublicKey' in signer &&
-            typeof signer.setPublicKey === 'function') {
-            await signer.setPublicKey();
+    async submitTx(tx, id) {
+        this.logger.debug('Submitting ARIO fund transaction...', { id });
+        await this.connection.sendRawTransaction(tx.serialize(), {
+            maxRetries: this.pollingOptions.maxAttempts,
+        });
+        if (tx.recentBlockhash === undefined ||
+            tx.lastValidBlockHeight === undefined) {
+            throw new Error('Failed to submit Transaction -- missing blockhash or lastValidBlockHeight from transaction creation. Solana Gateway Url:' +
+                this.gatewayUrl);
         }
-        if (signer instanceof ArconnectSigner) {
-            // Sign using Arconnect signDataItem API
-            const signedDataItem = await signer['signer'].signDataItem({
-                data,
-                tags,
-                target,
-                anchor,
+        await this.connection.confirmTransaction({
+            signature: id,
+            blockhash: tx.recentBlockhash,
+            lastValidBlockHeight: tx.lastValidBlockHeight,
+        }, 'finalized');
+    }
+    async pollTxAvailability({ txId }) {
+        const { maxAttempts, pollingIntervalMs, initialBackoffMs } = this.pollingOptions;
+        this.logger.debug('Polling for ARIO SPL transaction...', {
+            txId,
+            pollingOptions: this.pollingOptions,
+            gatewayUrl: this.gatewayUrl,
+        });
+        await sleep(initialBackoffMs);
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            let status;
+            attempts++;
+            try {
+                const statuses = await this.connection.getSignatureStatuses([txId], {
+                    searchTransactionHistory: true,
+                });
+                status = {
+                    context: statuses.context,
+                    value: statuses.value[0],
+                };
+            }
+            catch (err) {
+                this.logger.debug('Failed to poll ARIO SPL transaction...', { err });
+            }
+            if (status && status.value && status.value.err !== null) {
+                throw new Error(`Transaction failed: ${status.value.err}`);
+            }
+            if (status && status.value && status.value.slot !== null) {
+                this.logger.debug('Transaction found!', { txId, status });
+                return;
+            }
+            this.logger.debug('ARIO SPL transaction not found, polling...', {
+                txId,
+                attempts,
+                maxAttempts,
+                pollingIntervalMs,
             });
-            const dataItem = new DataItem(Buffer.from(signedDataItem));
-            return {
-                id: dataItem.id,
-                raw: dataItem.getRaw(),
-            };
+            await sleep(pollingIntervalMs);
         }
-        const dataItem = createData(data ?? '', signer, { tags, target, anchor });
-        await dataItem.sign(signer);
-        const signedData = {
-            id: dataItem.id,
-            raw: dataItem.getRaw(),
-        };
-        return signedData;
-    };
-    // eslint-disable-next-line
-    // @ts-ignore Buffer vs ArrayBuffer type mismatch
-    return aoSigner;
+        throw new Error('Transaction not found after polling, transaction id: ' + txId);
+    }
 }
+export const mARIOToTokenAmount = (mARIO) => mARIO;
+export const ARIOToTokenAmount = (ario) => new BigNumber(ario).times(1e6).valueOf();

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

@@ -1,15 +1,12 @@
 import { tokenTypes, } from '../../types.js';
-import { defaultProdGatewayUrls } from '../../utils/common.js';
 import { ARIOToTokenAmount, ARIOToken } from './ario.js';
 import { ARToTokenAmount, ArweaveToken } from './arweave.js';
-import { BaseEthToken, defaultBaseNetworkPollingOptions } from './baseEth.js';
-import { ERC20Token } from './erc20.js';
+import { BaseEthToken } from './baseEth.js';
 import { ETHToTokenAmount, EthereumToken } from './ethereum.js';
 import { KYVEToTokenAmount, KyveToken } from './kyve.js';
 import { POLToTokenAmount, PolygonToken } from './polygon.js';
 import { SOLToTokenAmount, SolanaToken } from './solana.js';
 import { USDCToTokenAmount, USDCToken } from './usdc.js';
-const baseARIOContractAddress = '0x138746adfA52909E5920def027f5a8dc1C7EfFb6';
 export const defaultTokenMap = {
     arweave: (config) => new ArweaveToken(config),
     ario: (config) => new ARIOToken(config),
@@ -22,12 +19,6 @@ export const defaultTokenMap = {
     usdc: (config) => new USDCToken({ network: 'ethereum', ...config }),
     'base-usdc': (config) => new USDCToken({ network: 'base', ...config }),
     'polygon-usdc': (config) => new USDCToken({ network: 'polygon', ...config }),
-    'base-ario': (config) => new ERC20Token({
-        ...config,
-        pollingOptions: config.pollingOptions ?? defaultBaseNetworkPollingOptions,
-        tokenContractAddress: baseARIOContractAddress,
-        gatewayUrl: config.gatewayUrl ?? defaultProdGatewayUrls['base-ario'],
-    }),
 };
 const ethExponent = 18;
 const usdcExponent = 6;
@@ -35,7 +26,6 @@ const arioExponent = 6;
 export const exponentMap = {
     arweave: 12,
     ario: arioExponent,
-    'base-ario': arioExponent,
     solana: 9,
     ethereum: ethExponent,
     'base-eth': ethExponent,
@@ -49,7 +39,6 @@ export const exponentMap = {
 export const tokenToBaseMap = {
     arweave: (a) => ARToTokenAmount(a),
     ario: (a) => ARIOToTokenAmount(a),
-    'base-ario': (a) => USDCToTokenAmount(a),
     solana: (a) => SOLToTokenAmount(a),
     ethereum: (a) => ETHToTokenAmount(a),
     'base-eth': (a) => ETHToTokenAmount(a),

package/lib/esm/common/token/solana.js

@@ -106,6 +106,7 @@ export class SolanaToken {
                 throw new Error(`Transaction failed: ${status.value.err}`);
             }
             if (status && status.value && status.value.slot !== null) {
+                this.logger.debug('Transaction found!', { txId, status });
                 return;
             }
             this.logger.debug('Transaction not found, polling...', {

package/lib/esm/common/turbo.js

@@ -51,6 +51,45 @@ export class TurboUnauthenticatedClient {
     getBalance(address) {
         return this.paymentService.getBalance(address);
     }
+    getFreeStatus(address) {
+        return this.paymentService.getFreeStatus(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 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.
      */
@@ -155,6 +194,98 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     getBalance(userAddress) {
         return this.paymentService.getBalance(userAddress);
     }
+    /**
+     * Returns how many free-tier bytes the wallet can still upload for free
+     * (`bytesRemaining`), or `null` for an unlimited (exempt/partner) wallet.
+     */
+    getFreeStatus(userAddress) {
+        return this.paymentService.getFreeStatus(userAddress);
+    }
+    /**
+     * Returns the signer's OWN completed top-up history (crypto + fiat), newest
+     * first and keyset-paginated. Signature-required and self-scoped: it only ever
+     * returns the signing wallet's rows. Pass `cursor` from a prior response's
+     * `cursor` field (with `hasMore === true`) to fetch the next page.
+     */
+    getPaymentHistory(params) {
+        return this.paymentService.getPaymentHistory(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);
+    }
+    /** 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
+     * 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);
+    }
+    /**
+     * 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);
+    }
+    /** Raise the undername limit. No owner signature needed. */
+    increaseArNSUndernameLimit(params) {
+        return this.paymentService.increaseArNSUndernameLimit(params);
+    }
+    /** Upgrade a lease to a permanent name. No owner signature needed. */
+    upgradeArNSName(params) {
+        return this.paymentService.upgradeArNSName(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/common/upload.js

@@ -22,7 +22,7 @@ import { FailedRequestError } from '../utils/errors.js';
 import { ChunkedUploader } from './chunked.js';
 import { TurboEventEmitter, createStreamWithUploadEvents } from './events.js';
 import { defaultRetryConfig } from './http.js';
-import { TurboHTTPService } from './http.js';
+import { TurboHTTPService, x402UploadEndpoints } from './http.js';
 import { exponentMap, tokenToBaseMap } from './index.js';
 import { Logger } from './logger.js';
 import { makeX402Signer } from './signer.js';
@@ -120,7 +120,9 @@ export 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: x402UploadEndpoints.unsigned,
             signal,
             headers: tags !== undefined
                 ? { 'x-data-item-tags': JSON.stringify(tags) }
@@ -138,7 +140,6 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
             'solana',
             'base-eth',
             'base-usdc',
-            'base-ario',
         ];
         this.signer = signer;
         this.paymentService = paymentService;

package/lib/esm/node/factory.js

@@ -34,7 +34,7 @@ export class TurboFactory extends TurboBaseFactory {
         // Import the TurboAuthenticatedUploadService class from the node upload module
         return new TurboAuthenticatedUploadService(config);
     }
-    static authenticated({ privateKey, signer: providedSigner, paymentServiceConfig = {}, uploadServiceConfig = {}, token, tokenMap, gatewayUrl, tokenTools, walletAdapter, cuUrl, processId, }) {
+    static authenticated({ privateKey, signer: providedSigner, paymentServiceConfig = {}, uploadServiceConfig = {}, token, tokenMap, gatewayUrl, tokenTools, walletAdapter, }) {
         return new TurboFactory().getAuthenticatedTurbo({
             privateKey,
             signer: providedSigner,
@@ -45,8 +45,6 @@ export class TurboFactory extends TurboBaseFactory {
             gatewayUrl,
             tokenTools,
             walletAdapter,
-            processId,
-            cuUrl,
             logger: this.logger,
         });
     }

package/lib/esm/types.js

@@ -17,7 +17,6 @@ export function isCurrency(currency) {
 export const tokenTypes = [
     'arweave',
     'ario',
-    'base-ario',
     'solana',
     'ethereum',
     'kyve',
@@ -36,7 +35,6 @@ export const supportedEvmSignerTokens = new Set([
     'polygon-usdc',
     'usdc',
     'base-usdc',
-    'base-ario',
 ]);
 export class ExistingBalanceFunding {
 }
@@ -94,3 +92,46 @@ 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',
+];
+// ===== 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.
+ *
+ * - `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.)
+ */
+export const arNSFiatPurchaseMethods = [
+    'payment-intent',
+    'checkout-session',
+];

package/lib/esm/utils/common.js

@@ -34,8 +34,7 @@ const polygonTestnetRpc = 'https://rpc-amoy.polygon.technology';
 const baseMainnetRpc = 'https://mainnet.base.org';
 export const tokenToDevGatewayMap = {
     arweave: 'https://turbo-gateway.com', // No arweave test net
-    ario: 'https://turbo-gateway.com', // No arweave test net
-    'base-ario': baseMainnetRpc, // No base-ario test net contract deployed
+    ario: 'https://api.devnet.solana.com',
     solana: 'https://api.devnet.solana.com',
     ethereum: ethTestnetRpc,
     'base-eth': baseTestnetRpc,
@@ -46,16 +45,9 @@ export const tokenToDevGatewayMap = {
     'base-usdc': baseTestnetRpc,
     'polygon-usdc': polygonTestnetRpc,
 };
-export const tokenToDevAoConfigMap = {
-    ario: {
-        processId: 'agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA',
-        cuUrl: 'https://cu.ardrive.io',
-    },
-};
 export const defaultProdGatewayUrls = {
     arweave: 'https://turbo-gateway.com',
-    ario: 'https://turbo-gateway.com',
-    'base-ario': baseMainnetRpc,
+    ario: 'https://api.mainnet-beta.solana.com',
     solana: 'https://api.mainnet-beta.solana.com',
     ethereum: 'https://cloudflare-eth.com/',
     'base-eth': baseMainnetRpc,
@@ -66,12 +58,6 @@ export const defaultProdGatewayUrls = {
     'base-usdc': baseMainnetRpc,
     'polygon-usdc': 'https://polygon-rpc.com/',
 };
-export const defaultProdAoConfigs = {
-    ario: {
-        processId: 'qNvAoz0TgcH7DMg8BCVn8jF32QH5L6T29VjHxhHqqGE',
-        cuUrl: 'https://cu.ardrive.io',
-    },
-};
 export function createTurboSigner({ signer: clientProvidedSigner, privateKey: clientProvidedPrivateKey, token = 'arweave', }) {
     if (clientProvidedSigner !== undefined) {
         if (clientProvidedSigner instanceof InjectedEthereumSigner) {
@@ -91,6 +77,7 @@ export function createTurboSigner({ signer: clientProvidedSigner, privateKey: cl
     }
     switch (token) {
         case 'solana':
+        case 'ario':
             return new HexSolanaSigner(clientProvidedPrivateKey);
         case 'ethereum':
         case 'pol':
@@ -98,7 +85,6 @@ export function createTurboSigner({ signer: clientProvidedSigner, privateKey: cl
         case 'base-eth':
         case 'usdc':
         case 'base-usdc':
-        case 'base-ario':
         case 'polygon-usdc':
             if (!isEthPrivateKey(clientProvidedPrivateKey)) {
                 throw new Error('A valid Ethereum private key must be provided for EthereumSigner.');
@@ -110,7 +96,6 @@ export function createTurboSigner({ signer: clientProvidedSigner, privateKey: cl
             }
             return signerFromKyvePrivateKey(clientProvidedPrivateKey);
         case 'arweave':
-        case 'ario':
             if (!isJWK(clientProvidedPrivateKey)) {
                 throw new Error('A JWK must be provided for ArweaveSigner.');
             }
@@ -155,8 +140,8 @@ export function isValidKyveAddress(address) {
 export function isValidUserAddress(address, type) {
     switch (type) {
         case 'arweave':
-        case 'ario':
             return isValidArweaveBase64URL(address);
+        case 'ario':
         case 'solana':
             return isValidSolanaAddress(address);
         case 'ethereum':
@@ -164,7 +149,6 @@ export function isValidUserAddress(address, type) {
         case 'matic':
         case 'pol':
         case 'base-usdc':
-        case 'base-ario':
         case 'usdc':
         case 'polygon-usdc':
             return isValidECDSAAddress(address);

package/lib/esm/utils/errors.js

@@ -35,6 +35,41 @@ 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;
+    }
+}
+/**
+ * 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.
+ */
+export 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;
+    }
+}
 export class AbortError extends BaseError {
     constructor(message = 'Request was aborted') {
         super(message);