@ardrive/turbo-sdk 1.16.1 → 1.17.0-alpha.2

package/README.md

@@ -29,6 +29,7 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [ArconnectSigner](#arconnectsigner)
       - [EthereumSigner](#ethereumsigner)
       - [Ethereum Private Key](#ethereum-private-key)
+      - [POL (MATIC) Private Key](#pol-matic-private-key)
       - [HexSolanaSigner](#hexsolanasigner)
       - [Solana Secret Key](#solana-secret-key)
       - [KYVE Private Key](#kyve-private-key)
@@ -46,6 +47,7 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [Arweave (AR) Fiat Top Up](#arweave-ar-fiat-top-up)
       - [Ethereum (ETH) Fiat Top Up](#ethereum-eth-fiat-top-up)
       - [Solana (SOL) Fiat Top Up](#solana-sol-fiat-top-up)
+      - [Polygon (POL / MATIC) Fiat Top Up](#polygon-pol--matic-fiat-top-up)
       - [KYVE Fiat Top Up](#kyve-fiat-top-up)
     - [`submitFundTransaction({ txId })`](#submitfundtransaction-txid-)
   - [TurboAuthenticatedClient](#turboauthenticatedclient)
@@ -60,6 +62,7 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
     - [`topUpWithTokens({ tokenAmount, feeMultiplier })`](#topupwithtokens-tokenamount-feemultiplier-)
       - [Arweave (AR) Crypto Top Up](#arweave-ar-crypto-top-up)
       - [Ethereum (ETH) Crypto Top Up](#ethereum-eth-crypto-top-up)
+      - [Polygon (POL / MATIC) Crypto Top Up](#polygon-pol--matic-crypto-top-up)
       - [Solana (SOL) Crypto Top Up](#solana-sol-crypto-top-up)
       - [KYVE Crypto Top Up](#kyve-crypto-top-up)
 - [CLI](#cli)
@@ -72,6 +75,7 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [`crypto-fund`](#crypto-fund)
       - [`upload-folder`](#upload-folder)
       - [`upload-file`](#upload-file)
+      - [`price`](#price)
 - [Developers](#developers)
   - [Requirements](#requirements)
   - [Setup & Build](#setup--build)
@@ -269,6 +273,15 @@ const turbo = TurboFactory.authenticated({
 });
 ```
 
+##### POL (MATIC) Private Key
+
+```typescript
+const turbo = TurboFactory.authenticated({
+  privateKey: ethHexadecimalPrivateKey,
+  token: 'pol',
+});
+```
+
 ##### HexSolanaSigner
 
 ```typescript
@@ -433,6 +446,17 @@ const { url, winc, paymentAmount } = await turbo.createCheckoutSession({
 });
 ```
 
+##### Polygon (POL / MATIC) Fiat Top Up
+
+```ts
+const turbo = TurboFactory.unauthenticated({ token: 'pol' });
+
+const { url, winc, paymentAmount } = await turbo.createCheckoutSession({
+  amount: USD(10.0), // $10.00 USD
+  owner: publicPolygonAddress,
+});
+```
+
 ##### KYVE Fiat Top Up
 
 ```ts
@@ -623,6 +647,16 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
+##### Polygon (POL / MATIC) Crypto Top Up
+
+```ts
+const turbo = TurboFactory.authenticated({ signer, token: 'pol' });
+
+const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
+  tokenAmount: POLToTokenAmount(0.00001), // 0.00001 POL
+});
+```
+
 ##### Solana (SOL) Crypto Top Up
 
 ```ts
@@ -695,7 +729,7 @@ npx turbo --help
 - `-g, --gateway <url>` - Set a custom crypto gateway URL
 - `-t, --token <token>` - Token type for the command or connected wallet (default: "arweave")
 
-- `-w, --wallet-file <filePath>` - Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array
+- `-w, --wallet-file <filePath>` - Wallet file to use with the action. Formats accepted: JWK.json, KYVE, ETH, or POL private key as a string, or SOL Secret Key as a Uint8Array
 - `-m, --mnemonic <phrase>` - Mnemonic to use with the action (KYVE only)
 - `-p, --private-key <key>` - Private key to use with the action
 
@@ -787,6 +821,29 @@ e.g:
 turbo upload-file --file-path '../path/to/my/file.txt' --token ethereum --wallet-file ../path/to/eth/private/key.txt
 ```
 
+##### `price`
+
+Get the current credit price estimate from Turbo Payment Service for a given value and price type.
+
+Command Options:
+
+- `--value <value>` - Value to get the price for. e.g: 10.50 for $10.50 USD, 1024 for 1 KiB, 1.1 for 1.1 AR
+- `--type <type>` - Type of price to get. e.g: 'bytes', 'arweave', 'usd', 'kyve'. Default: 'bytes'
+
+e.g:
+
+```shell
+turbo price --value 10.50 --type usd
+```
+
+```shell
+turbo price --value 1024 --type bytes
+```
+
+```shell
+turbo price --value 1.1 --type arweave
+```
+
 ## Developers
 
 ### Requirements

package/bundles/web.bundle.min.js

@@ -310504,7 +310504,7 @@ var import_winston = __toESM(require_winston(), 1);
 init_dirname();
 init_buffer2();
 init_process2();
-var version16 = "1.16.0";
+var version16 = "1.17.0-alpha.1";
 
 // src/common/logger.ts
 var TurboWinstonLogger = class _TurboWinstonLogger {
@@ -314606,6 +314606,11 @@ var FailedRequestError = class extends BaseError {
     super(`Failed request: ${status}: ${message}`);
   }
 };
+var ProvidedInputError = class extends BaseError {
+  constructor(message) {
+    super(message ?? `User has provided an invalid input`);
+  }
+};
 
 // src/common/http.ts
 var TurboHTTPService = class {
@@ -315358,8 +315363,10 @@ var TurboUnauthenticatedClient = class {
   /**
    * Returns the connected target Turbo wallet addresses for all supported tokens.
    */
-  getTurboCryptoWallets() {
-    return this.paymentService.getTurboCryptoWallets();
+  async getTurboCryptoWallets() {
+    const wallets = await this.paymentService.getTurboCryptoWallets();
+    wallets.pol = wallets.matic;
+    return wallets;
   }
 };
 var TurboAuthenticatedClient = class extends TurboUnauthenticatedClient {
@@ -315423,6 +315430,7 @@ var TurboBaseFactory = class {
     uploadServiceConfig = {},
     token
   } = {}) {
+    token = token === "pol" ? "matic" : token;
     const paymentService = new TurboUnauthenticatedPaymentService({
       ...paymentServiceConfig,
       logger: this.logger,
@@ -315450,16 +315458,40 @@ init_dirname();
 init_buffer2();
 init_process2();
 var ZeroDecimalCurrency = class {
-  constructor(amount, type3) {
-    this.amount = amount;
+  constructor(amt, type3) {
+    this.amt = amt;
     this.type = type3;
+    if (amt < 0) {
+      throw new ProvidedInputError(
+        `${type3} currency amount cannot be negative`
+      );
+    }
+    this.assertDecimalPlaces(amt);
+  }
+  assertDecimalPlaces(a8) {
+    if (a8 % 1 !== 0) {
+      throw new ProvidedInputError(
+        `${this.type} currency amount must have zero decimal places`
+      );
+    }
+  }
+  get amount() {
+    return this.amt;
   }
 };
-var TwoDecimalCurrency = class {
+var TwoDecimalCurrency = class extends ZeroDecimalCurrency {
   constructor(a8, type3) {
+    super(a8, type3);
     this.a = a8;
     this.type = type3;
   }
+  assertDecimalPlaces(a8) {
+    if (a8 * 100 % 1 !== 0) {
+      throw new ProvidedInputError(
+        `${this.type} currency amount must have two decimal places`
+      );
+    }
+  }
   get amount() {
     return this.a * 100;
   }
@@ -315511,7 +315543,14 @@ var fiatCurrencyTypes = [
 function isCurrency(currency) {
   return fiatCurrencyTypes.includes(currency);
 }
-var tokenTypes = ["arweave", "solana", "ethereum", "kyve"];
+var tokenTypes = [
+  "arweave",
+  "solana",
+  "ethereum",
+  "kyve",
+  "matic",
+  "pol"
+];
 var isNodeUploadFolderParams = (p8) => p8.folderPath !== void 0;
 var isWebUploadFolderParams = (p8) => p8.files !== void 0;
 function isKyvePrivateKey(wallet) {
@@ -315580,6 +315619,7 @@ function createTurboSigner({
     case "solana":
       return new HexSolanaSigner2(clientProvidedPrivateKey);
     case "ethereum":
+    case "matic":
       if (!isEthPrivateKey(clientProvidedPrivateKey)) {
         throw new Error(
           "A valid Ethereum private key must be provided for EthereumSigner."
@@ -339329,6 +339369,25 @@ async function signerFromKyveMnemonic(mnemonic) {
   return signerFromKyvePrivateKey2(privateKey);
 }
 
+// src/common/token/polygon.ts
+init_dirname();
+init_buffer2();
+init_process2();
+var POLToTokenAmount = ETHToTokenAmount;
+var PolygonToken = class extends EthereumToken {
+  constructor({
+    logger: logger15 = TurboWinstonLogger.default,
+    gatewayUrl = "https://polygon-rpc.com/",
+    pollingOptions = {
+      maxAttempts: 10,
+      pollingIntervalMs: 4e3,
+      initialBackoffMs: 5e3
+    }
+  } = {}) {
+    super({ logger: logger15, gatewayUrl, pollingOptions });
+  }
+};
+
 // src/common/token/solana.ts
 init_dirname();
 init_buffer2();
@@ -349997,13 +350056,17 @@ var defaultTokenMap = {
   arweave: (config2) => new ArweaveToken(config2),
   solana: (config2) => new SolanaToken(config2),
   ethereum: (config2) => new EthereumToken(config2),
-  kyve: (config2) => new KyveToken(config2)
+  kyve: (config2) => new KyveToken(config2),
+  matic: (config2) => new PolygonToken(config2),
+  pol: (config2) => new PolygonToken(config2)
 };
 var tokenToBaseMap = {
   arweave: (a8) => ARToTokenAmount(a8),
   solana: (a8) => SOLToTokenAmount(a8),
   ethereum: (a8) => ETHToTokenAmount(a8),
-  kyve: (a8) => KYVEToTokenAmount(a8)
+  kyve: (a8) => KYVEToTokenAmount(a8),
+  matic: (a8) => POLToTokenAmount(a8),
+  pol: (a8) => POLToTokenAmount(a8)
 };
 function isTokenType(token) {
   return tokenTypes.includes(token);
@@ -350041,6 +350104,8 @@ var TurboDataItemAbstractSigner = class {
       case "solana":
         return import_bs584.default.encode(fromB64Url(owner));
       case "ethereum":
+      case "matic":
+      case "pol":
         return computeAddress2(computePublicKey(fromB64Url(owner)));
       case "kyve":
         return (0, import_amino3.pubkeyToAddress)(
@@ -350264,6 +350329,7 @@ var TurboFactory = class extends TurboBaseFactory {
     tokenMap,
     tokenTools
   }) {
+    token = token === "pol" ? "matic" : token;
     if (!token) {
       if (providedSigner) {
         if (providedSigner instanceof EthereumSigner) {

package/lib/cjs/cli/cli.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // eslint-disable-next-line header/header -- This is a CLI file
 const commander_1 = require("commander");
 const version_js_1 = require("../version.js");
-const commands_js_1 = require("./commands.js");
+const index_js_1 = require("./commands/index.js");
 const options_js_1 = require("./options.js");
 const utils_js_1 = require("./utils.js");
 (0, utils_js_1.applyOptions)(commander_1.program
@@ -29,19 +29,24 @@ const utils_js_1 = require("./utils.js");
     .description('Turbo CLI')
     .helpCommand(true), options_js_1.globalOptions);
 (0, utils_js_1.applyOptions)(commander_1.program.command('balance').description('Get balance of a Turbo address'), [options_js_1.optionMap.address, ...options_js_1.walletOptions]).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, commands_js_1.getBalance);
+    await (0, utils_js_1.runCommand)(command, index_js_1.balance);
 });
 (0, utils_js_1.applyOptions)(commander_1.program.command('top-up').description('Top up a Turbo address with Fiat'), [...options_js_1.walletOptions, options_js_1.optionMap.address, options_js_1.optionMap.value, options_js_1.optionMap.currency]).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, commands_js_1.topUp);
+    await (0, utils_js_1.runCommand)(command, index_js_1.topUp);
 });
 (0, utils_js_1.applyOptions)(commander_1.program.command('crypto-fund').description('Top up a wallet with crypto'), [...options_js_1.walletOptions, options_js_1.optionMap.value, options_js_1.optionMap.txId]).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, commands_js_1.cryptoFund);
+    await (0, utils_js_1.runCommand)(command, index_js_1.cryptoFund);
 });
 (0, utils_js_1.applyOptions)(commander_1.program.command('upload-folder').description('Upload a folder using Turbo'), options_js_1.uploadFolderOptions).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, commands_js_1.uploadFolder);
+    await (0, utils_js_1.runCommand)(command, index_js_1.uploadFolder);
 });
 (0, utils_js_1.applyOptions)(commander_1.program.command('upload-file').description('Upload a file using Turbo'), options_js_1.uploadFileOptions).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, commands_js_1.uploadFile);
+    await (0, utils_js_1.runCommand)(command, index_js_1.uploadFile);
+});
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('price')
+    .description('Get the current Credits estimate for byte, crypto, or fiat value'), [options_js_1.optionMap.value, options_js_1.optionMap.type]).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, index_js_1.price);
 });
 if (process.argv[1].includes('bin/turbo') || // Running from global .bin
     process.argv[1].includes('cli/cli') // Running from source

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.balance = balance;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const factory_js_1 = require("../../node/factory.js");
+const utils_js_1 = require("../utils.js");
+async function balance(options) {
+    const config = (0, utils_js_1.configFromOptions)(options);
+    const { address, privateKey } = await (0, utils_js_1.addressOrPrivateKeyFromOptions)(options);
+    if (address !== undefined) {
+        const turbo = factory_js_1.TurboFactory.unauthenticated(config);
+        const { winc } = await turbo.getBalance(address);
+        console.log(`Turbo Balance for Native Address "${address}"\nCredits: ${+winc / 1_000_000_000_000}`);
+        return;
+    }
+    if (privateKey === undefined) {
+        throw new Error('Must provide an (--address) or use a valid wallet');
+    }
+    const turbo = factory_js_1.TurboFactory.authenticated({
+        ...config,
+        privateKey,
+    });
+    const { winc } = await turbo.getBalance();
+    console.log(`Turbo Balance for Wallet Address "${await turbo.signer.getNativeAddress()}"\nCredits: ${+winc / 1_000_000_000_000}`);
+}

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

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cryptoFund = cryptoFund;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const prompts_1 = __importDefault(require("prompts"));
+const index_js_1 = require("../../common/index.js");
+const factory_js_1 = require("../../node/factory.js");
+const utils_js_1 = require("../utils.js");
+async function cryptoFund(options) {
+    const value = options.value;
+    const txId = options.txId;
+    if (txId !== undefined) {
+        const turbo = factory_js_1.TurboFactory.unauthenticated((0, utils_js_1.configFromOptions)(options));
+        const result = await turbo.submitFundTransaction({ txId: txId });
+        console.log('Submitted existing crypto fund transaction to payment service: \n', JSON.stringify(result, null, 2));
+        return;
+    }
+    if (value === undefined) {
+        throw new Error('Must provide a --value or --transaction-id for crypto-fund command');
+    }
+    const turbo = await (0, utils_js_1.turboFromOptions)(options);
+    const token = (0, utils_js_1.tokenFromOptions)(options);
+    const tokenAmount = index_js_1.tokenToBaseMap[token](value);
+    if (!options.skipConfirmation) {
+        const { winc } = await turbo.getWincForToken({ tokenAmount });
+        const targetWallet = (await turbo.getTurboCryptoWallets())[token];
+        const credits = (+winc / 1_000_000_000_000).toFixed(12);
+        const { confirm } = await (0, prompts_1.default)({
+            type: 'confirm',
+            name: 'confirm',
+            message: `\nTransaction details:\n\n  Amount: ${value} ${token}\n  Target: ${targetWallet}\n  Credits received: ${credits}\n  Credit recipient: ${await turbo.signer.getNativeAddress()}\n  Network fees: (Gas fees apply)\n\nThis payment is non-refundable.  Proceed with transaction?`,
+            initial: true,
+        });
+        if (!confirm) {
+            console.log('Aborted crypto fund transaction');
+            return;
+        }
+    }
+    const result = await turbo.topUpWithTokens({
+        tokenAmount,
+    });
+    console.log('Sent crypto fund transaction: \n', JSON.stringify(result, null, 2));
+}

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

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./balance.js"), exports);
+__exportStar(require("./cryptoFund.js"), exports);
+__exportStar(require("./price.js"), exports);
+__exportStar(require("./topUp.js"), exports);
+__exportStar(require("./uploadFile.js"), exports);
+__exportStar(require("./uploadFolder.js"), exports);

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

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.price = price;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const currency_js_1 = require("../../common/currency.js");
+const index_js_1 = require("../../common/index.js");
+const factory_js_1 = require("../../node/factory.js");
+const types_js_1 = require("../../types.js");
+const utils_js_1 = require("../utils.js");
+async function price(options) {
+    const value = options.value;
+    if (value === undefined || +value <= 0 || isNaN(+value)) {
+        throw new Error('Must provide a positive number --value to get price');
+    }
+    const type = options.type ?? 'bytes';
+    const winc = await (async () => {
+        if ((0, index_js_1.isTokenType)(type)) {
+            const turbo = factory_js_1.TurboFactory.unauthenticated({
+                ...(0, utils_js_1.configFromOptions)(options),
+                token: type,
+            });
+            return (await turbo.getWincForToken({
+                tokenAmount: index_js_1.tokenToBaseMap[type](value),
+            })).winc;
+        }
+        const turbo = factory_js_1.TurboFactory.unauthenticated((0, utils_js_1.configFromOptions)(options));
+        if (type === 'bytes') {
+            return (await turbo.getUploadCosts({ bytes: [+value] }))[0].winc;
+        }
+        if ((0, types_js_1.isCurrency)(type)) {
+            return (await turbo.getWincForFiat({
+                amount: currency_js_1.currencyMap[type](+value),
+            })).winc;
+        }
+        throw new Error(`Invalid price type!\nMust be one of: bytes, ${types_js_1.fiatCurrencyTypes.join(', ') + ' ' + types_js_1.tokenTypes.join(', ')}`);
+    })();
+    console.log(`Current price estimate for ${value} ${type} is ~${(+winc / 1_000_000_000_000).toFixed(12)} Credits`);
+}

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

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.topUp = topUp;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const child_process_1 = require("child_process");
+const currency_js_1 = require("../../common/currency.js");
+const factory_js_1 = require("../../node/factory.js");
+const types_js_1 = require("../../types.js");
+const common_js_1 = require("../../utils/common.js");
+const utils_js_1 = require("../utils.js");
+function openUrl(url) {
+    if (process.platform === 'darwin') {
+        // macOS
+        (0, child_process_1.exec)(`open ${url}`);
+    }
+    else if (process.platform === 'win32') {
+        // Windows
+        (0, child_process_1.exec)(`start "" "${url}"`, { windowsHide: true });
+    }
+    else {
+        // Linux/Unix
+        open(url);
+    }
+}
+async function topUp(options) {
+    const config = (0, utils_js_1.configFromOptions)(options);
+    const { address, privateKey } = await (0, utils_js_1.addressOrPrivateKeyFromOptions)(options);
+    const value = options.value;
+    if (value === undefined) {
+        throw new Error('Must provide a --value to top up');
+    }
+    const currency = (options.currency ?? 'usd').toLowerCase();
+    if (!(0, types_js_1.isCurrency)(currency)) {
+        throw new Error(`Invalid fiat currency type ${currency}!\nPlease use one of these:\n${JSON.stringify(types_js_1.fiatCurrencyTypes, null, 2)}`);
+    }
+    // TODO: Pay in CLI prompts via --cli options
+    const { url, paymentAmount, winc } = await (async () => {
+        const amount = currency_js_1.currencyMap[currency](+value);
+        if (address !== undefined) {
+            const turbo = factory_js_1.TurboFactory.unauthenticated(config);
+            return turbo.createCheckoutSession({
+                amount,
+                owner: address,
+            });
+        }
+        if (privateKey === undefined) {
+            throw new Error('Must provide a wallet to top up');
+        }
+        const turbo = factory_js_1.TurboFactory.authenticated({
+            ...config,
+            privateKey,
+        });
+        return turbo.createCheckoutSession({
+            amount,
+            owner: await turbo.signer.getNativeAddress(),
+        });
+    })();
+    if (url === undefined) {
+        throw new Error('Failed to create checkout session');
+    }
+    console.log('Got Checkout Session\n' + JSON.stringify({ url, paymentAmount, winc }));
+    console.log('Opening checkout session in browser...');
+    await (0, common_js_1.sleep)(2000);
+    openUrl(url);
+}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = uploadFile;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const fs_1 = require("fs");
+const constants_js_1 = require("../constants.js");
+const utils_js_1 = require("../utils.js");
+async function uploadFile(options) {
+    const { filePath } = options;
+    if (filePath === undefined) {
+        throw new Error('Must provide a --file-path to upload');
+    }
+    const turbo = await (0, utils_js_1.turboFromOptions)(options);
+    const fileSize = (0, fs_1.statSync)(filePath).size;
+    const result = await turbo.uploadFile({
+        fileStreamFactory: () => (0, fs_1.createReadStream)(filePath),
+        fileSizeFactory: () => fileSize,
+        dataItemOpts: { tags: [...constants_js_1.turboCliTags] }, // TODO: Inject user tags
+    });
+    console.log('Uploaded file:', JSON.stringify(result, null, 2));
+}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFolder = uploadFolder;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+const constants_js_1 = require("../constants.js");
+const utils_js_1 = require("../utils.js");
+async function uploadFolder(options) {
+    const turbo = await (0, utils_js_1.turboFromOptions)(options);
+    const { disableManifest, fallbackFile, folderPath, indexFile, maxConcurrentUploads, } = (0, utils_js_1.getUploadFolderOptions)(options);
+    const result = await turbo.uploadFolder({
+        folderPath: folderPath,
+        dataItemOpts: { tags: [...constants_js_1.turboCliTags] }, // TODO: Inject user tags
+        manifestOptions: {
+            disableManifest,
+            indexFile,
+            fallbackFile,
+        },
+        maxConcurrentUploads,
+    });
+    console.log('Uploaded folder:', JSON.stringify(result, null, 2));
+}