@ardrive/turbo-sdk 1.31.1 → 1.32.0

package/lib/esm/cli/utils.js

@@ -15,7 +15,7 @@
  */
 import bs58 from 'bs58';
 import { readFileSync, statSync } from 'fs';
-import { TurboFactory, defaultTurboConfiguration, developmentTurboConfiguration, fiatCurrencyTypes, isCurrency, isTokenType, privateKeyFromKyveMnemonic, } from '../node/index.js';
+import { ExistingBalanceFunding, OnDemandFunding, TurboFactory, defaultTurboConfiguration, developmentTurboConfiguration, fiatCurrencyTypes, isCurrency, isTokenType, privateKeyFromKyveMnemonic, tokenToBaseMap, } from '../node/index.js';
 import { defaultProdAoConfigs, tokenToDevAoConfigMap, tokenToDevGatewayMap, } from '../utils/common.js';
 import { NoWalletProvidedError } from './errors.js';
 export function exitWithErrorLog(error) {
@@ -245,6 +245,30 @@ export function parseTags(tagsArr) {
 export function getTagsFromOptions(options) {
     return parseTags(options.tags);
 }
+export function onDemandOptionsFromOptions(options) {
+    if (!options.onDemand) {
+        return { fundingMode: new ExistingBalanceFunding() };
+    }
+    const value = options.maxCryptoTopUpValue;
+    let maxTokenAmount = undefined;
+    if (value !== undefined) {
+        if (isNaN(+value) || +value <= 0) {
+            throw new Error('maxTokenAmount must be a positive number');
+        }
+        const token = tokenFromOptions(options);
+        maxTokenAmount = tokenToBaseMap[token](value).toString();
+    }
+    if (options.topUpBufferMultiplier !== undefined &&
+        (isNaN(options.topUpBufferMultiplier) || options.topUpBufferMultiplier < 1)) {
+        throw new Error('topUpBufferMultiplier must be a number >= 1');
+    }
+    return {
+        fundingMode: new OnDemandFunding({
+            maxTokenAmount,
+            topUpBufferMultiplier: options.topUpBufferMultiplier,
+        }),
+    };
+}
 export function currencyFromOptions(options) {
     const currency = options.currency?.toLowerCase();
     if (!isCurrency(currency)) {

package/lib/esm/common/factory.js

@@ -106,6 +106,7 @@ export class TurboBaseFactory {
             signer: turboSigner,
             logger,
             token,
+            paymentService,
         });
         return new TurboAuthenticatedClient({
             uploadService,

package/lib/esm/common/payment.js

@@ -287,7 +287,7 @@ export class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymen
         const txId = fundTx.id;
         try {
             // Let transaction settle some time
-            await this.tokenTools.pollForTxBeingAvailable({ txId });
+            await this.tokenTools.pollTxAvailability({ txId });
         }
         catch (e) {
             this.logger.error(`Failed to poll for transaction being available from ${this.token} gateway... Attempting to submit fund tx to Turbo...`, e);

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

@@ -63,7 +63,7 @@ export class ARIOToken {
         });
         return { id: txId, target, reward: '0' };
     }
-    async pollForTxBeingAvailable() {
+    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);

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

@@ -72,7 +72,7 @@ export class ArweaveToken {
         await this.submitTx(tx);
         return { id, target, reward: tx.reward };
     }
-    async pollForTxBeingAvailable({ txId, }) {
+    async pollTxAvailability({ txId }) {
         const { maxAttempts, pollingIntervalMs, initialBackoffMs } = this.pollingOptions;
         this.logger.debug('Polling for transaction...', { txId });
         await sleep(initialBackoffMs);

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

@@ -2,7 +2,7 @@ import { defaultProdGatewayUrls } from '../../utils/common.js';
 import { EthereumToken } from './ethereum.js';
 export class BaseEthToken extends EthereumToken {
     constructor({ logger, gatewayUrl = defaultProdGatewayUrls['base-eth'], pollingOptions = {
-        initialBackoffMs: 1_000,
+        initialBackoffMs: 2_500,
         maxAttempts: 10,
         pollingIntervalMs: 2_500,
     }, } = {}) {
@@ -12,4 +12,20 @@ export class BaseEthToken extends EthereumToken {
             pollingOptions,
         });
     }
+    async getTxAvailability(txId) {
+        const tx = await this.rpcProvider.getTransactionReceipt(txId);
+        if (tx) {
+            const confirmations = await tx.confirmations();
+            if (confirmations >= 1) {
+                this.logger.debug('Transaction is available on chain', {
+                    txId,
+                    tx,
+                    confirmations,
+                });
+                return true;
+            }
+        }
+        this.logger.debug('Transaction not yet available on chain', { txId, tx });
+        return false;
+    }
 }

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

@@ -43,13 +43,22 @@ export class EthereumToken {
             target,
         };
     }
-    async pollForTxBeingAvailable({ txId, }) {
+    async getTxAvailability(txId) {
+        const tx = await this.rpcProvider.getTransaction(txId);
+        if (tx) {
+            this.logger.debug('Transaction is available on chain', { txId, tx });
+            return true;
+        }
+        this.logger.debug('Transaction not yet available on chain', { txId });
+        return false;
+    }
+    async pollTxAvailability({ txId }) {
         await new Promise((resolve) => setTimeout(resolve, this.pollingOptions.initialBackoffMs));
         let attempts = 0;
         while (attempts < this.pollingOptions.maxAttempts) {
             try {
-                const tx = await this.rpcProvider.getTransaction(txId);
-                if (tx) {
+                const txIsAvailable = await this.getTxAvailability(txId);
+                if (txIsAvailable) {
                     return;
                 }
             }
@@ -59,6 +68,6 @@ export class EthereumToken {
             await new Promise((resolve) => setTimeout(resolve, this.pollingOptions.pollingIntervalMs));
             attempts++;
         }
-        throw new Error('Transaction not found after polling!');
+        throw new Error(`Transaction ${txId} not found after polling!`);
     }
 }

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

@@ -58,7 +58,7 @@ export class KyveToken {
         });
         return { id: txHash, target };
     }
-    async pollForTxBeingAvailable({ txId, }) {
+    async pollTxAvailability({ txId }) {
         const { maxAttempts, pollingIntervalMs, initialBackoffMs } = this.pollingOptions;
         this.logger.debug('Polling for transaction...', {
             txId,

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

@@ -66,7 +66,7 @@ export class SolanaToken {
             lastValidBlockHeight: tx.lastValidBlockHeight,
         }, 'finalized');
     }
-    async pollForTxBeingAvailable({ txId, }) {
+    async pollTxAvailability({ txId }) {
         const { maxAttempts, pollingIntervalMs, initialBackoffMs } = this.pollingOptions;
         this.logger.debug('Polling for transaction...', {
             txId,

package/lib/esm/common/turbo.js

@@ -156,7 +156,7 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     /**
      * Signs and uploads raw data to the Turbo Upload Service.
      */
-    upload({ data, dataItemOpts, signal, events, chunkByteCount, chunkingMode, maxChunkConcurrency, }) {
+    upload({ data, dataItemOpts, signal, events, chunkByteCount, chunkingMode, maxChunkConcurrency, maxFinalizeMs, fundingMode, }) {
         return this.uploadService.upload({
             data,
             dataItemOpts,
@@ -165,6 +165,8 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
             chunkByteCount,
             chunkingMode,
             maxChunkConcurrency,
+            fundingMode,
+            maxFinalizeMs,
         });
     }
     uploadFile(params) {

package/lib/esm/common/upload.js

@@ -14,13 +14,16 @@
  * limitations under the License.
  */
 import { CanceledError } from 'axios';
+import { BigNumber } from 'bignumber.js';
 import { pLimit } from 'plimit-lit';
+import { ExistingBalanceFunding, OnDemandFunding, } from '../types.js';
 import { defaultRetryConfig } from '../utils/axiosClient.js';
 import { isBlob, sleep } from '../utils/common.js';
 import { FailedRequestError } from '../utils/errors.js';
 import { ChunkedUploader } from './chunked.js';
 import { TurboEventEmitter, createStreamWithUploadEvents } from './events.js';
 import { TurboHTTPService } from './http.js';
+import { exponentMap, tokenToBaseMap } from './index.js';
 import { TurboWinstonLogger } from './logger.js';
 function isTurboUploadFileWithStreamFactoryParams(params) {
     return 'fileStreamFactory' in params;
@@ -85,14 +88,16 @@ export class TurboUnauthenticatedUploadService {
 }
 // NOTE: to avoid redundancy, we use inheritance here - but generally prefer composition over inheritance
 export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUploadService {
-    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, }) {
+    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, paymentService, }) {
         super({ url, retryConfig, logger, token });
+        this.enabledOnDemandTokens = ['ario', 'solana', 'base-eth'];
         this.signer = signer;
+        this.paymentService = paymentService;
     }
     /**
      * Signs and uploads raw data to the Turbo Upload Service.
      */
-    upload({ data, dataItemOpts, signal, events, chunkByteCount, chunkingMode, maxChunkConcurrency, }) {
+    upload({ data, dataItemOpts, signal, events, chunkByteCount, chunkingMode, maxChunkConcurrency, fundingMode, maxFinalizeMs, }) {
         // This function is intended to be usable in both Node and browser environments.
         if (isBlob(data)) {
             const streamFactory = () => data.stream();
@@ -103,6 +108,11 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
                 signal,
                 dataItemOpts,
                 events,
+                chunkByteCount,
+                chunkingMode,
+                maxChunkConcurrency,
+                fundingMode,
+                maxFinalizeMs,
             });
         }
         const dataBuffer = (() => {
@@ -123,6 +133,8 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
             chunkByteCount,
             chunkingMode,
             maxChunkConcurrency,
+            fundingMode,
+            maxFinalizeMs,
         });
     }
     resolveUploadFileConfig(params) {
@@ -154,7 +166,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
         };
     }
     async uploadFile(params) {
-        const { signal, dataItemOpts, events, fileStreamFactory, fileSizeFactory } = this.resolveUploadFileConfig(params);
+        const { signal, dataItemOpts, events, fileStreamFactory, fileSizeFactory, fundingMode = new ExistingBalanceFunding(), } = this.resolveUploadFileConfig(params);
         let retries = 0;
         const maxRetries = this.retryConfig.retries ?? 3;
         const retryDelay = this.retryConfig.retryDelay ??
@@ -163,6 +175,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
         let lastStatusCode = undefined; // Store the last status code for throwing
         const emitter = new TurboEventEmitter(events);
         // avoid duplicating signing on failures here - these errors will immediately be thrown
+        let cryptoFundResult;
         // TODO: move the retry implementation to the http class, and avoid awaiting here. This will standardize the retry logic across all upload methods.
         while (retries < maxRetries) {
             if (signal?.aborted) {
@@ -175,6 +188,14 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
                 dataItemOpts,
                 emitter,
             });
+            if (fundingMode instanceof OnDemandFunding &&
+                cryptoFundResult === undefined) {
+                const totalByteCount = dataItemSizeFactory();
+                cryptoFundResult = await this.onDemand({
+                    totalByteCount,
+                    onDemandFunding: fundingMode,
+                });
+            }
             // Now that we have the signed data item, we can upload it using the uploadSignedDataItem method
             // which will create a new emitter with upload events. We await
             // this result due to the wrapped retry logic of this method.
@@ -198,7 +219,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
                         signal,
                         events,
                     });
-                    return response;
+                    return { ...response, cryptoFundResult };
                 }
                 const response = await this.uploadSignedDataItem({
                     dataItemStreamFactory,
@@ -207,7 +228,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
                     signal,
                     events,
                 });
-                return response;
+                return { ...response, cryptoFundResult };
             }
             catch (error) {
                 // Store the last encountered error and status for re-throwing after retries
@@ -285,7 +306,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
      */
     async uploadFolder(params) {
         this.logger.debug('Uploading folder...', { params });
-        const { dataItemOpts, signal, manifestOptions = {}, maxConcurrentUploads = 1, throwOnFailure = true, maxChunkConcurrency, chunkByteCount, chunkingMode, maxFinalizeMs, } = params;
+        const { dataItemOpts, signal, manifestOptions = {}, maxConcurrentUploads = 1, throwOnFailure = true, maxChunkConcurrency, chunkByteCount, chunkingMode, fundingMode = new ExistingBalanceFunding(), maxFinalizeMs, } = params;
         const { disableManifest, indexFile, fallbackFile } = manifestOptions;
         const paths = {};
         const response = {
@@ -327,6 +348,16 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
         };
         const files = await this.getFiles(params);
         const limit = pLimit(maxConcurrentUploads);
+        let cryptoFundResult;
+        if (fundingMode instanceof OnDemandFunding) {
+            const totalByteCount = files.reduce((acc, file) => {
+                return acc + this.getFileSize(file) + 1200; // allow extra per file for ANS-104 headers
+            }, 0);
+            cryptoFundResult = await this.onDemand({
+                totalByteCount,
+                onDemandFunding: fundingMode,
+            });
+        }
         await Promise.all(files.map((file) => limit(() => uploadFile(file))));
         this.logger.debug('Finished uploading files', {
             numFiles: files.length,
@@ -366,6 +397,7 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
             ...response,
             manifest,
             manifestResponse,
+            cryptoFundResult,
         };
     }
     async shareCredits({ approvedAddress, approvedWincAmount, expiresBySeconds, }) {
@@ -420,4 +452,90 @@ export class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUpl
         }
         return revokedApprovals;
     }
+    /**
+     * Triggers an upload that will top-up the wallet with Credits for the amount before uploading.
+     * First, it calculates the expected cost of the upload. Next, it checks the wallet for existing
+     * balance. If the balance is insufficient, it will attempt the top-up with the wallet in the specified `token`
+     * and await for the balance to be credited.
+     * Note: Only `ario`, `solana`, and `base-eth` tokens are currently supported for on-demand uploads.
+     */
+    async onDemand({ totalByteCount, onDemandFunding, }) {
+        const { maxTokenAmount, topUpBufferMultiplier } = onDemandFunding;
+        const currentBalance = await this.paymentService.getBalance();
+        const wincPriceForOneGiB = (await this.paymentService.getUploadCosts({
+            bytes: [2 ** 30],
+        }))[0].winc;
+        const expectedWincPrice = new BigNumber(wincPriceForOneGiB)
+            .multipliedBy(totalByteCount)
+            .dividedBy(2 ** 30)
+            .toFixed(0, BigNumber.ROUND_UP);
+        if (BigNumber(currentBalance.effectiveBalance).isGreaterThanOrEqualTo(expectedWincPrice)) {
+            this.logger.debug('Sufficient balance for on demand upload', {
+                currentBalance,
+                expectedWincPrice,
+            });
+            return undefined;
+        }
+        this.logger.debug('Insufficient balance for on demand upload', {
+            currentBalance,
+            expectedWincPrice,
+        });
+        if (!this.enabledOnDemandTokens.includes(this.token)) {
+            throw new Error(`On-demand uploads are not supported for token: ${this.token}`);
+        }
+        const topUpWincAmount = BigNumber(expectedWincPrice)
+            .minus(currentBalance.effectiveBalance)
+            .multipliedBy(topUpBufferMultiplier) // add buffer to avoid underpayment
+            .toFixed(0, BigNumber.ROUND_UP);
+        const wincPriceForOneToken = (await this.paymentService.getWincForToken({
+            tokenAmount: tokenToBaseMap[this.token](1),
+        })).winc;
+        const topUpTokenAmount = new BigNumber(topUpWincAmount)
+            .dividedBy(wincPriceForOneToken)
+            .multipliedBy(tokenToBaseMap[this.token](1))
+            .toFixed(0, BigNumber.ROUND_UP);
+        if (maxTokenAmount !== undefined) {
+            if (new BigNumber(topUpTokenAmount).isGreaterThan(maxTokenAmount)) {
+                throw new Error(`Top up token amount ${new BigNumber(topUpTokenAmount).div(exponentMap[this.token])} is greater than the maximum allowed amount of ${maxTokenAmount}`);
+            }
+        }
+        this.logger.debug(`Topping up wallet with ${topUpTokenAmount} ${this.token} for ${topUpWincAmount} winc`);
+        const topUpResponse = await this.paymentService.topUpWithTokens({
+            tokenAmount: topUpTokenAmount,
+        });
+        this.logger.debug('Top up transaction submitted', { topUpResponse });
+        const pollingOptions = {
+            pollIntervalMs: 3 * 1000, // poll every 3 seconds
+            timeoutMs: 120 * 1000, // wait up to 2 minutes
+        };
+        let tries = 1;
+        const maxTries = Math.ceil(pollingOptions.timeoutMs / pollingOptions.pollIntervalMs) - 1; // -1 because we already tried once with the initial request
+        while (topUpResponse.status !== 'confirmed' && tries < maxTries) {
+            this.logger.debug('Tx not yet confirmed, waiting to poll again', {
+                tries,
+                maxTries,
+            });
+            await sleep(pollingOptions.pollIntervalMs);
+            tries++;
+            try {
+                const submitFundResult = await this.paymentService.submitFundTransaction({
+                    txId: topUpResponse.id,
+                });
+                if (submitFundResult.status === 'confirmed') {
+                    this.logger.debug('Top-up transaction confirmed and balance updated', { submitFundResult });
+                    topUpResponse.status = 'confirmed';
+                    break;
+                }
+            }
+            catch (error) {
+                this.logger.warn('Error fetching fund transaction during polling', {
+                    message: error instanceof Error ? error.message : error,
+                });
+            }
+        }
+        if (tries >= maxTries) {
+            this.logger.warn('Timed out waiting for fund tx to confirm after top-up. Will continue to attempt upload but it may fail if balance is insufficient.');
+        }
+        return topUpResponse;
+    }
 }

package/lib/esm/node/upload.js

@@ -20,13 +20,14 @@ import { Readable } from 'stream';
 import { TurboAuthenticatedBaseUploadService, defaultUploadServiceURL, } from '../common/upload.js';
 import { isNodeUploadFolderParams, } from '../types.js';
 export class TurboAuthenticatedUploadService extends TurboAuthenticatedBaseUploadService {
-    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, }) {
+    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, paymentService, }) {
         super({
             url,
             retryConfig,
             logger,
             token,
             signer,
+            paymentService,
         });
     }
     async getAbsoluteFilePathsFromFolder(folderPath) {

package/lib/esm/types.js

@@ -1,3 +1,4 @@
+import { BigNumber } from 'bignumber.js';
 export const fiatCurrencyTypes = [
     'usd',
     'eur',
@@ -23,6 +24,22 @@ export const tokenTypes = [
     'pol',
     'base-eth',
 ];
+export class ExistingBalanceFunding {
+}
+export class OnDemandFunding {
+    constructor({ maxTokenAmount, topUpBufferMultiplier = 1.1, }) {
+        if (maxTokenAmount !== undefined &&
+            new BigNumber(maxTokenAmount).isLessThan(0)) {
+            throw new Error('maxTokenAmount must be non-negative');
+        }
+        this.maxTokenAmount =
+            maxTokenAmount !== undefined ? new BigNumber(maxTokenAmount) : undefined;
+        if (topUpBufferMultiplier < 1) {
+            throw new Error('topUpBufferMultiplier must be >= 1');
+        }
+        this.topUpBufferMultiplier = topUpBufferMultiplier;
+    }
+}
 export const multipartPendingStatus = [
     'ASSEMBLING',
     'VALIDATING',

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '1.31.1';
+export const version = '1.32.0';

package/lib/esm/web/upload.js

@@ -16,8 +16,8 @@
 import { TurboAuthenticatedBaseUploadService, defaultUploadServiceURL, } from '../common/upload.js';
 import { isWebUploadFolderParams, } from '../types.js';
 export class TurboAuthenticatedUploadService extends TurboAuthenticatedBaseUploadService {
-    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, }) {
-        super({ url, retryConfig, logger, token, signer });
+    constructor({ url = defaultUploadServiceURL, retryConfig, signer, logger, token, paymentService, }) {
+        super({ url, retryConfig, logger, token, signer, paymentService });
     }
     getFiles(params) {
         if (!isWebUploadFolderParams(params)) {

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

@@ -1 +1 @@
-{"version":3,"file":"uploadFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploadFile.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQhD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB1E"}
+{"version":3,"file":"uploadFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploadFile.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB1E"}

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

@@ -1 +1 @@
-{"version":3,"file":"uploadFolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploadFolder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQlD,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"uploadFolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploadFolder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/lib/types/cli/options.d.ts

@@ -173,6 +173,19 @@ export declare const optionMap: {
         readonly description: "Chunking mode to use for the upload. Can be \"auto\", \"force\" or \"disabled\". Defaults to \"auto\".";
         readonly default: "auto";
     };
+    readonly onDemand: {
+        readonly alias: "--on-demand";
+        readonly description: "Enable on-demand crypto top-ups during upload if balance is insufficient";
+        readonly default: false;
+    };
+    readonly topUpBufferMultiplier: {
+        readonly alias: "--top-up-buffer-multiplier <topUpBufferMultiplier>";
+        readonly description: "Multiplier to apply to the estimated top-up amount to avoid underpayment during on-demand top-ups. Defaults to 1.1 (10% buffer).";
+    };
+    readonly maxCryptoTopUpValue: {
+        readonly alias: "--max-crypto-top-up-value <maxCryptoTopUpValue>";
+        readonly description: "Maximum crypto top-up value to use for the upload. Defaults to no limit.";
+    };
 };
 export declare const walletOptions: ({
     readonly alias: "-w, --wallet-file <filePath>";
@@ -259,6 +272,16 @@ export declare const uploadOptions: ({
     readonly alias: "--chunking-mode <chunkingMode>";
     readonly description: "Chunking mode to use for the upload. Can be \"auto\", \"force\" or \"disabled\". Defaults to \"auto\".";
     readonly default: "auto";
+} | {
+    readonly alias: "--on-demand";
+    readonly description: "Enable on-demand crypto top-ups during upload if balance is insufficient";
+    readonly default: false;
+} | {
+    readonly alias: "--top-up-buffer-multiplier <topUpBufferMultiplier>";
+    readonly description: "Multiplier to apply to the estimated top-up amount to avoid underpayment during on-demand top-ups. Defaults to 1.1 (10% buffer).";
+} | {
+    readonly alias: "--max-crypto-top-up-value <maxCryptoTopUpValue>";
+    readonly description: "Maximum crypto top-up value to use for the upload. Defaults to no limit.";
 })[];
 export declare const uploadFolderOptions: ({
     readonly description: "An array of additional tags for the write action, in \"--tags name1 value1 name2 value2\" format";
@@ -314,6 +337,16 @@ export declare const uploadFolderOptions: ({
     readonly alias: "--chunking-mode <chunkingMode>";
     readonly description: "Chunking mode to use for the upload. Can be \"auto\", \"force\" or \"disabled\". Defaults to \"auto\".";
     readonly default: "auto";
+} | {
+    readonly alias: "--on-demand";
+    readonly description: "Enable on-demand crypto top-ups during upload if balance is insufficient";
+    readonly default: false;
+} | {
+    readonly alias: "--top-up-buffer-multiplier <topUpBufferMultiplier>";
+    readonly description: "Multiplier to apply to the estimated top-up amount to avoid underpayment during on-demand top-ups. Defaults to 1.1 (10% buffer).";
+} | {
+    readonly alias: "--max-crypto-top-up-value <maxCryptoTopUpValue>";
+    readonly description: "Maximum crypto top-up value to use for the upload. Defaults to no limit.";
 })[];
 export declare const uploadFileOptions: ({
     readonly description: "An array of additional tags for the write action, in \"--tags name1 value1 name2 value2\" format";
@@ -356,6 +389,16 @@ export declare const uploadFileOptions: ({
     readonly alias: "--chunking-mode <chunkingMode>";
     readonly description: "Chunking mode to use for the upload. Can be \"auto\", \"force\" or \"disabled\". Defaults to \"auto\".";
     readonly default: "auto";
+} | {
+    readonly alias: "--on-demand";
+    readonly description: "Enable on-demand crypto top-ups during upload if balance is insufficient";
+    readonly default: false;
+} | {
+    readonly alias: "--top-up-buffer-multiplier <topUpBufferMultiplier>";
+    readonly description: "Multiplier to apply to the estimated top-up amount to avoid underpayment during on-demand top-ups. Defaults to 1.1 (10% buffer).";
+} | {
+    readonly alias: "--max-crypto-top-up-value <maxCryptoTopUpValue>";
+    readonly description: "Maximum crypto top-up value to use for the upload. Defaults to no limit.";
 })[];
 export declare const shareCreditsOptions: ({
     readonly alias: "-a, --address <nativeAddress>";

package/lib/types/cli/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyKZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUzB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;IAK/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;IAAwC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;IAAuB,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyLZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUzB,CAAC;AAQF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWzB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;IAK/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;IAAwC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;IAAuB,CAAC"}

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

@@ -48,6 +48,10 @@ export type UploadOptions = WalletOptions & {
     maxFinalizeMs: string | undefined;
     chunkByteCount: string | undefined;
     chunkingMode: TurboChunkingMode | undefined;
+    onDemand: boolean;
+    maxCryptoTopUpValue: string | undefined;
+    topUpBufferMultiplier: number | undefined;
+    feeMultiplier: number | undefined;
 };
 export type UploadFolderOptions = UploadOptions & {
     folderPath: string | undefined;

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

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

package/lib/types/cli/utils.d.ts

@@ -1,5 +1,5 @@
 import { Command, OptionValues } from 'commander';
-import { Currency, TokenType, TurboAuthenticatedClient, TurboChunkingParams, TurboUnauthenticatedConfiguration } from '../node/index.js';
+import { Currency, ExistingBalanceFunding, OnDemandFunding, TokenType, TurboAuthenticatedClient, TurboChunkingParams, TurboUnauthenticatedConfiguration } from '../node/index.js';
 import { AddressOptions, GlobalOptions, TokenPriceOptions, UploadFolderOptions, UploadOptions, WalletOptions } from './types.js';
 export declare function exitWithErrorLog(error: unknown): void;
 export declare function runCommand<T extends OptionValues>(command: Command, action: (options: T) => Promise<void>): Promise<void>;
@@ -42,6 +42,9 @@ export declare function getTagsFromOptions(options: UploadOptions): {
     name: string;
     value: string;
 }[];
+export declare function onDemandOptionsFromOptions(options: UploadOptions): {
+    fundingMode: OnDemandFunding | ExistingBalanceFunding;
+};
 export declare function currencyFromOptions<T extends GlobalOptions & {
     currency?: string;
 }>(options: T): Currency | undefined;

package/lib/types/cli/utils.d.ts.map

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

package/lib/types/common/factory.d.ts

@@ -1,5 +1,6 @@
 import { GetTurboSignerParams, TurboAuthenticatedConfiguration, TurboAuthenticatedUploadServiceConfiguration, TurboAuthenticatedUploadServiceInterface, TurboUnauthenticatedConfiguration } from '../types.js';
 import { TurboWinstonLogger } from './logger.js';
+import { TurboAuthenticatedPaymentService } from './payment.js';
 import { TurboDataItemAbstractSigner } from './signer.js';
 import { TurboAuthenticatedClient, TurboUnauthenticatedClient } from './turbo.js';
 export declare abstract class TurboBaseFactory {
@@ -8,7 +9,9 @@ export declare abstract class TurboBaseFactory {
     static setLogFormat(format: string): void;
     static unauthenticated({ paymentServiceConfig, uploadServiceConfig, token, }?: TurboUnauthenticatedConfiguration): TurboUnauthenticatedClient;
     protected abstract getSigner({ providedPrivateKey, providedSigner, providedWalletAdapter, logger, token, }: GetTurboSignerParams): TurboDataItemAbstractSigner;
-    protected abstract getAuthenticatedUploadService(config: TurboAuthenticatedUploadServiceConfiguration): TurboAuthenticatedUploadServiceInterface;
+    protected abstract getAuthenticatedUploadService(config: TurboAuthenticatedUploadServiceConfiguration & {
+        paymentService: TurboAuthenticatedPaymentService;
+    }): TurboAuthenticatedUploadServiceInterface;
     protected getAuthenticatedTurbo({ privateKey, signer: providedSigner, paymentServiceConfig, uploadServiceConfig, token, gatewayUrl, tokenMap, tokenTools, logger, walletAdapter, processId, cuUrl, }: TurboAuthenticatedConfiguration & {
         logger: TurboWinstonLogger;
     }): TurboAuthenticatedClient;