@ardrive/turbo-sdk 1.42.0 → 1.43.0-alpha.2

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/turbo.js

@@ -51,6 +51,53 @@ 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);
+    }
+    /**
+     * Previews what one of the eight non-purchase ArNS actions will debit,
+     * without creating it. Use {@link getArNSPriceForName} for the four
+     * ARIO-purchase actions instead.
+     */
+    getArNSActionPrice(action) {
+        return this.paymentService.getArNSActionPrice(action);
+    }
+    /**
+     * 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 +202,121 @@ 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. Debits a flat credits margin (Turbo
+     * pays the SOL); preview it with `getArNSActionPrice`. Handles both shapes.
+     */
+    setArNSRecord(params) {
+        return this.paymentService.setArNSRecord(params);
+    }
+    /**
+     * Remove a record. Debits a flat credits margin (Turbo pays the SOL);
+     * preview it with `getArNSActionPrice`. Handles both shapes.
+     */
+    removeArNSRecord(params) {
+        return this.paymentService.removeArNSRecord(params);
+    }
+    /** Grant controller rights — omit `target` for Turbo itself. Costs credits. */
+    addArNSController(params) {
+        return this.paymentService.addArNSController(params);
+    }
+    /** Revoke controller rights. Always available; costs credits, never SOL. */
+    removeArNSController(params) {
+        return this.paymentService.removeArNSController(params);
+    }
+    /**
+     * Edit a RECORD's metadata (display name, logo, description, keywords).
+     * Debits a flat credits margin (Turbo pays the SOL); preview it with
+     * `getArNSActionPrice`. Handles both shapes. Fields are tri-state — omit to
+     * leave unchanged, pass `null` to clear.
+     */
+    setArNSRecordMetadata(params) {
+        return this.paymentService.setArNSRecordMetadata(params);
+    }
+    /** Clear a record's metadata. Costs credits, never SOL; handles both shapes. */
+    removeArNSRecordMetadata(params) {
+        return this.paymentService.removeArNSRecordMetadata(params);
+    }
+    /** Hand ONE record over — not the whole ANT. Costs credits, never SOL. */
+    transferArNSRecord(params) {
+        return this.paymentService.transferArNSRecord(params);
+    }
+    /** Hand the ANT to a new owner. Irreversible. Costs credits, never SOL. */
+    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.
      */