Merge pull request #140 from ardriveapp/alpha

chore: release v1.11.0

.env.test

@@ -2,3 +2,15 @@ NODE_ENV=test
 UPLOAD_SERVICE_URL=http://localhost:3000
 PAYMENT_SERVICE_URL=http://localhost:4000
 ARWEAVE_GATEWAY=http://localhost:1984
+BUNDLER_ARWEAVE_WALLET='{
+  "kty": "RSA",
+  "n": "hlziBgDh3L-NoSdLryUOOV-RTcti5RviXGhuYoYyDclC48xIvJAUlxAS9oX2VHJz-Y8lxtkLa-nr5_XjsIsb5TbKepW0hCkAnLvR9VRx000nk6hOjJddkfjB1qpFallH4sWoXYLcHFhRvnMBOn9S3bJTDWl1lo0Ncjfw61vfoOoPLSgfgLK5jpHPrzhRnyNFaJgkEe_OBI1ehttzFPQ9Re6h3qQRRipGl7pb2UsStyfbWfZ6302Ae3oiHTZfRYEkzTtswEcVkFMI35h1-o_-UfD8F__5LDpSM2XMEbP9B5DfMihdBLTunZRCPeGzxHwDcduXxmOlmmSZeCdKmDEO-4EfmhtVzM2PCc1yspbcgwX45jdt0v593YNUGZXNhi17g4ldmk60hn-zbiVKJLghjL-0iwUt6xeb6xRzpOejM5IMj4O_IPIfTD_ThNtpOMOj93TXzzNQzZZEWaLi5IvNJB-Ic5mHii3PC2hoSdtzEB5k86bAH-Nc3xru69UCrj7Ch5NcPnmqCHY5A0Adamw9HrcVCZtDvb2QhTd7oXguRcF4nkXBMVhS56lfrTcOoeTrVr3Nq5jU9HqGH8Zss_VN3j1mjD8hcS2JOi9FAHeFQWyXSuXRhroLWKtXi2KIQ51a5ecBF5QknoRpQaa6RDQTtBn-sH-SStUg-rVhvEZcd50",
+  "e": "AQAB",
+  "d": "Axuq7tCeaOjVceDi005cId-gENiflQUsG08fHpBUIBWDwpk7JYF_uG7awXEf3Zw4KpGxIgRrSzfCCT-a4L6XCppV3LgR0OzR4s5FcRNe_rBONhAyoPXvaC0E7t5JdMhT7V79Igyg4tb4LRuj76J6XD5_xVOnMLBam0XIAOnDJonDiBvhfqyjtjSRRVBcMv4x4NWEIBYYAerzQNNauiVcNX3rqKbK74CS2XeqIECoUixN2qrk9L1qN3D_0QUs9wKhw02YmmoKiagiEGoKcJ1cGLEmY7e8H9XJiP7V1aMAO2iSgSqF3FIDIwoG7j-GVQk5WyzlOeWcMxIYqrrd8t9PpWETbm6Oc-b_e9W5O3j-WZL1ho7EAhkevrNsabHjc11qDTr1FHAaaG6rXslxHeuOE9GJUhZgs6svmrisAXnsHtDVie-v-mGzTIYUN7wKRLo_KhSAdJtjjgM4vScAphsiYnLnqouVp26LWCj_k1UneoQU78bqmEFnBMhT3v9gEjZCUGV3MbekhrWijuFT6IYeEgnmXJHNEGw1IfAUf0xBebAfi0cepIuiBHAwVdlg7VCxxi3PkAs0JzqTHl-KPIlVOqQYfh9zJs2PoCHuFx1NBONFZubtdy0twhLpFrnOxOM__FsiKRrklzMe2PKcjWPW28rQXxpx6G5ufO2Q92VZhwE",
+  "p": "07L891sss3FxqITCgYdkfq5fCq3PPVB4nfiKEBK66R7nLnWE24ttNdNgxEvPhmGzJ3Sqco0kjiyg3STOUliIS1zBPwQBLsYZ1785c4q2uC8wU__4dmZmubE5vCC8UFtvHfNnf-1Rrb_dPDN_TR0sieChhyo8laSfV8A5cV0slE1eptW87QFfc4tJK4ElMkkQt2fqD60sWk6uAJMER6KIGykt8U74tNydnjN_BG9IgTl06wARCHVfvtmeDPrHyimFdCXQ9i3B35CcO9-CfatQpbealEwFNy0oWo-3JiCwIb0se_XbeoOsjL1RV8Lltse9RK3VbrssZbTS7jepYXEObQ",
+  "q": "onrhs7P2UO6CU1spHyga7h0EFgbK00W9sNJAx7tCAJONUxYeB_T_cGjs0c_VayoA1jMbY4zXcT2ou-nU6BqWLPWV_4K2G4zU9c0QmNbywoZI35IUOzMdcWMaipdqds1NcVoJhlFv2scf7hu-RkMIIRr4_LyHcPdfnpjbuDyKupR1Sc7rHi4BIYkqOfclIzmZ0wc31ZzycID4yGWt8vLCG6HyPoHQO68EGToFYW-cqWvTCIvFU4xtGH29ZDvfaE-UrbSJT33GJmJg5YMJOVJ6haSOfV1MYO_gf4diRO7jhZm88bYWGKq5RwfKPHm7oxSjeBMQoIr7QP-DobGt2_uP8Q",
+  "dp": "CfIjzl87N2cCBv_Nv5Yj04vPrUnDLcdFE27k1aJ7o44vIFCnIEVpqRi4OCCzrEWUzCrAA0e8Su2v1RPwmY_NP3UpIxPGFnN6LVevlE0VDowxAhFJlA51jw3Tf5IuJrxU-RxBZZI5vyb_dt-YgH_5YrTqAdarKACm99FxIXFWMdV8t-vcx2nEGUKW-nND0xv5rBQ2u-vP5KJDrIU7sz3glR4XKXojVyPyR8d1lTjBOEkBxDSpmDMjf2zr7wItNsNCoNVR_u7hZ-Z8YJe8orjUviRlH8h-ijwV5ENSQHlSrRMdLum7GQNsrOQMGUpvzmmN69ca6uviRxj6u_Rjgc909Q",
+  "dq": "B33_FlhADW9SFyHm_YbN5xjzbUiW5bMbkiG_1vXtjzU-mQw2Ckvj030jHnGk97ISI85rfuWpsZEUTMX1iVZggmY4qnWOjCqsT0FLeKDAxPOIPLbxs-EhhG77dFSTFjNVVNrAAa-TptTzxfkFhxvkLhKeVJkk7bKaeCe4SgCQrRXXarXd5aBdcPxwNAgPcFZhn3d_vZvlGgb4cdUudjt3c-q9zuARiA8D813Xjayl3rIYIxa-3KFnDnAN4adZH-g7hN8ETeQQ1QhIS40FSd1hxPPXljRNJ1MoWPkXMPKLD0gNjF_HGRAWRw425x795gE3oHvQknaWK2Mc4MHesHwjIQ",
+  "qi": "ZOjI2OvOmYL8X4TJWxesIptxLNQkf9SRULT4sx7mN2BMPjiNAYFy6qGT3NnPbKhODuGtGAJE77eT0UgA8N9ZKnJAHKrPqxCAHzvLoKmI0AB-0BIUDVbLbdlGD9EWLHQuo_dxo_paYjzF5E_D9OapElUVVmPt5iudYFmvEdxzDhDUzJmuhnDWivjeDV79uxJDJe7Fd01Hbjmn7E4iYv0whQOzRsz_Rjjh56Tu5rHRETacZveofBz-g1lGZsuOth6oS-xabNRDsizgDq55nLp4F3V0OJLxrTR4b1xAFJGX1Fsxf5FXIsBr1ClRWjD_o6CMOvjtLHG4T8-10-6_suVZFA",
+  "kid": "2011-04-29"
+}'

.gitignore

@@ -6,6 +6,8 @@ coverage
 dist
 .husky/_
 
+data
+
 # Example files
 *.min.js
 

.husky/commit-msg

@@ -2,3 +2,4 @@
 . "$(dirname -- "$0")/_/husky.sh"
 
 yarn commitlint --edit $1
+yarn docs

.vscode/settings.json

@@ -6,22 +6,30 @@
     "Blockhash",
     "codecov",
     "commitlint",
+    "cosmjs",
+    "Cosmoshub",
     "holesky",
     "iife",
     "irys",
     "Keypair",
+    "korellia",
+    "kyve",
+    "kyvejs",
     "lamport",
     "lamports",
     "mocharc",
     "nacl",
     "nvmrc",
     "outfile",
     "plimit",
+    "privkey",
+    "Secp",
     "solana",
     "tocstop",
     "trivago",
     "tweetnacl",
     "typecheck",
+    "ukyve",
     "webkitdirectory",
     "Winc"
   ],

CHANGELOG.md

@@ -5,12 +5,6 @@
 
 * expose `token` on unauthenticated turbo factory PE-6569 ([7f0c44c](https://github.com/ardriveapp/turbo-sdk/commit/7f0c44cfc319d0f303d252d0aa73f0d42a635e03))
 
-## [1.10.1-alpha.1](https://github.com/ardriveapp/turbo-sdk/compare/v1.10.0...v1.10.1-alpha.1) (2024-08-16)
-
-
-### Bug Fixes
-
-* expose `token` on unauthenticated turbo factory PE-6569 ([7f0c44c](https://github.com/ardriveapp/turbo-sdk/commit/7f0c44cfc319d0f303d252d0aa73f0d42a635e03))
 
 # [1.10.0](https://github.com/ardriveapp/turbo-sdk/compare/v1.9.0...v1.10.0) (2024-08-15)
 

README.md

@@ -31,6 +31,8 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [Ethereum Private Key](#ethereum-private-key)
       - [HexSolanaSigner](#hexsolanasigner)
       - [Solana Secret Key](#solana-secret-key)
+      - [KYVE Private Key](#kyve-private-key)
+      - [KYVE Mnemonic](#kyve-mnemonic)
   - [TurboUnauthenticatedClient](#turbounauthenticatedclient)
     - [`getSupportedCurrencies()`](#getsupportedcurrencies)
     - [`getSupportedCountries()`](#getsupportedcountries)
@@ -40,9 +42,10 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
     - [`getUploadCosts({ bytes })`](#getuploadcosts-bytes-)
     - [`uploadSignedDataItem({ dataItemStreamFactory, dataItemSizeFactory, signal })`](#uploadsigneddataitem-dataitemstreamfactory-dataitemsizefactory-signal-)
     - [`createCheckoutSession({ amount, owner })`](#createcheckoutsession-amount-owner-)
-      - [Arweave (AR)](#arweave-ar)
-      - [Ethereum (ETH)](#ethereum-eth)
-      - [Solana (SOL)](#solana-sol)
+      - [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)
+      - [KYVE Fiat Top Up](#kyve-fiat-top-up)
     - [`submitFundTransaction({ txId })`](#submitfundtransaction-txid-)
   - [TurboAuthenticatedClient](#turboauthenticatedclient)
     - [`getBalance()`](#getbalance)
@@ -53,8 +56,16 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [NodeJS Upload Folder](#nodejs-upload-folder)
       - [Browser Upload Folder](#browser-upload-folder)
     - [`topUpWithTokens({ tokenAmount, feeMultiplier })`](#topupwithtokens-tokenamount-feemultiplier-)
-      - [Ethereum (ETH)](#ethereum-eth-1)
-      - [Solana (SOL)](#solana-sol-1)
+      - [Arweave (AR) Crypto Top Up](#arweave-ar-crypto-top-up)
+      - [Ethereum (ETH) Crypto Top Up](#ethereum-eth-crypto-top-up)
+      - [Solana (SOL) Crypto Top Up](#solana-sol-crypto-top-up)
+      - [KYVE Crypto Top Up](#kyve-crypto-top-up)
+- [CLI](#cli)
+  - [Install CLI](#install-cli)
+  - [CLI Usage](#cli-usage)
+    - [Options](#options)
+    - [Commands](#commands)
+      - [`crypto-fund`](#crypto-fund)
 - [Developers](#developers)
   - [Requirements](#requirements)
   - [Setup & Build](#setup--build)
@@ -268,6 +279,26 @@ const turbo = TurboFactory.authenticated({
 });
 ```
 
+##### KYVE Private Key
+
+```typescript
+const turbo = TurboFactory.authenticated({
+  privateKey: kyveHexadecimalPrivateKey,
+  token: 'kyve',
+});
+```
+
+##### KYVE Mnemonic
+
+```typescript
+import { privateKeyFromKyveMnemonic } from '@ardrive/turbo-sdk';
+
+const turbo = TurboFactory.authenticated({
+  privateKey: privateKeyFromKyveMnemonic(mnemonic),
+  token: 'kyve',
+});
+```
+
 ### TurboUnauthenticatedClient
 
 #### `getSupportedCurrencies()`
@@ -341,7 +372,7 @@ const uploadResponse = await turbo.uploadSignedDataItem({
 
 Creates a Stripe checkout session for a Turbo Top Up with the provided amount, currency, owner. The returned URL can be opened in the browser, all payments are processed by Stripe. To leverage promo codes, see [TurboAuthenticatedClient].
 
-##### Arweave (AR)
+##### Arweave (AR) Fiat Top Up
 
 ```typescript
 const { url, winc, paymentAmount, quotedPaymentAmount, adjustments } =
@@ -364,7 +395,7 @@ if (process.platform === 'darwin') {
 }
 ```
 
-##### Ethereum (ETH)
+##### Ethereum (ETH) Fiat Top Up
 
 ```ts
 const turbo = TurboFactory.unauthenticated({ token: 'ethereum' });
@@ -375,7 +406,7 @@ const { url, winc, paymentAmount } = await turbo.createCheckoutSession({
 });
 ```
 
-##### Solana (SOL)
+##### Solana (SOL) Fiat Top Up
 
 ```ts
 const turbo = TurboFactory.unauthenticated({ token: 'solana' });
@@ -386,6 +417,17 @@ const { url, winc, paymentAmount } = await turbo.createCheckoutSession({
 });
 ```
 
+##### KYVE Fiat Top Up
+
+```ts
+const turbo = TurboFactory.unauthenticated({ token: 'kyve' });
+
+const { url, winc, paymentAmount } = await turbo.createCheckoutSession({
+  amount: USD(10.0), // $10.00 USD
+  owner: publicKyveAddress,
+});
+```
+
 #### `submitFundTransaction({ txId })`
 
 Submits the transaction ID of a funding transaction to Turbo Payment Service for top up processing. The `txId` is the transaction ID of the transaction to be submitted.
@@ -536,6 +578,8 @@ Tops up the connected wallet with Credits by submitting a payment transaction fo
 - The `tokenAmount` is the amount of tokens in the token type's smallest unit value (e.g: Winston for arweave token type) to fund the wallet with.
 - The `feeMultiplier` (optional) is the multiplier to apply to the reward for the transaction to modify its chances of being mined. Credits will be added to the wallet balance after the transaction is confirmed on the given blockchain. Defaults to 1.0, meaning no multiplier.
 
+##### Arweave (AR) Crypto Top Up
+
 ```typescript
 const turbo = TurboFactory.authenticated({ signer, token: 'arweave' });
 
@@ -545,7 +589,7 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
-##### Ethereum (ETH)
+##### Ethereum (ETH) Crypto Top Up
 
 ```ts
 const turbo = TurboFactory.authenticated({ signer, token: 'ethereum' });
@@ -555,7 +599,7 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
-##### Solana (SOL)
+##### Solana (SOL) Crypto Top Up
 
 ```ts
 const turbo = TurboFactory.authenticated({ signer, token: 'solana' });
@@ -565,6 +609,88 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
+##### KYVE Crypto Top Up
+
+```ts
+const turbo = TurboFactory.authenticated({ signer, token: 'kyve' });
+
+const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
+  tokenAmount: KYVEToTokenAmount(0.00001), // 0.00001 KYVE
+});
+```
+
+## CLI
+
+### Install CLI
+
+Global installation:
+
+```shell
+npm install -g @ardrive/turbo-sdk
+```
+
+or
+
+```shell
+yarn global add @ardrive/turbo-sdk
+```
+
+or install locally as a dev dependency:
+
+```shell
+npm install --save-dev @ardrive/turbo-sdk
+```
+
+or
+
+```shell
+yarn add -D @ardrive/turbo-sdk
+```
+
+### CLI Usage
+
+```shell
+turbo --help
+```
+
+or from local installation:
+
+```shell
+yarn turbo --help
+```
+
+```shell
+npx turbo --help
+```
+
+#### Options
+
+- `-V, --version` - output the version number
+- `-h, --help` - display help for command
+- `--dev` - Enable development endpoints (default: false)
+- `-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
+- `-m, --mnemonic <phrase>` - Mnemonic to use with the action (KYVE only)
+- `-p, --private-key <key>` - Private key to use with the action
+
+#### Commands
+
+##### `crypto-fund`
+
+Fund a wallet with Turbo Credits by submitting a payment transaction for the crypto amount to the Turbo wallet and then submitting that transaction id to Turbo Payment Service for top up processing.
+
+Command Options:
+
+- `-v, --value <value>` - Amount of tokens in the token type's smallest unit value to fund the wallet with
+
+e.g:
+
+```shell
+turbo crypto-fund --value 0.0001 --token kyve --private-key 'b27...45c'
+```
+
 ## Developers
 
 ### Requirements

bundle.mjs

@@ -20,6 +20,7 @@ const bundle = () => {
         },
       }),
     ],
+    external: ['commander'],
     tsconfig: './tsconfig.web.json',
     outfile: './bundles/web.bundle.min.js',
   })

codecov.yml

@@ -2,5 +2,7 @@ coverage:
   status:
     project:
       default:
-        target: 95%
+        target: 80%
         threshold: 1%
+  ignore:
+    - 'src/cli/*'