@ardrive/turbo-sdk 1.20.0-alpha.1 → 1.20.0-alpha.2

package/README.md

@@ -65,9 +65,9 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [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)
-    - [`createDelegatedPaymentApproval({ approvedAddress, approvedWincAmount, expiresBySeconds })`](#createdelegatedpaymentapproval-approvedaddress-approvedwincamount-expiresbyseconds-)
-    - [`revokeDelegatedPaymentApprovals({ approvedAddress })`](#revokedelegatedpaymentapprovals-approvedaddress-)
-    - [`getDelegatedPaymentApprovals({ userAddress })`](#getdelegatedpaymentapprovals-useraddress-)
+    - [`shareCredits({ approvedAddress, approvedWincAmount, expiresBySeconds })`](#sharecredits-approvedaddress-approvedwincamount-expiresbyseconds-)
+    - [`revokeCredits({ approvedAddress })`](#revokecredits-approvedaddress-)
+    - [`getCreditShareApprovals({ userAddress })`](#getcreditshareapprovals-useraddress-)
 - [CLI](#cli)
   - [Install CLI](#install-cli)
   - [CLI Usage](#cli-usage)
@@ -79,9 +79,10 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [`upload-folder`](#upload-folder)
       - [`upload-file`](#upload-file)
       - [`price`](#price)
-      - [`create-approval`](#create-approval)
-      - [`revoke-approvals`](#revoke-approvals)
-      - [`list-approvals`](#list-approvals)
+      - [`share-credits`](#share-credits)
+      - [`revoke-credits`](#revoke-credits)
+      - [`list-shares`](#list-shares)
+- [Turbo Credit Sharing](#turbo-credit-sharing)
 - [Developers](#developers)
   - [Requirements](#requirements)
   - [Setup & Build](#setup--build)
@@ -683,36 +684,35 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
-#### `createDelegatedPaymentApproval({ approvedAddress, approvedWincAmount, expiresBySeconds })`
+#### `shareCredits({ approvedAddress, approvedWincAmount, expiresBySeconds })`
 
-Creates a delegated payment approval from the connected wallet to the provided native address and approved winc amount. This action will create a data item for the approval
+Shares credits from the connected wallet to the provided native address and approved winc amount. This action will create a signed data item for the approval
 
 ```typescript
-const { approvalDataItemId, approvedWincAmount } =
-  await turbo.createDelegatedPaymentApproval({
-    approvedAddress: '2cor...VUa',
-    approvedWincAmount: 0.08315565032,
-    expiresBySeconds: 3600,
-  });
+const { approvalDataItemId, approvedWincAmount } = await turbo.shareCredits({
+  approvedAddress: '2cor...VUa',
+  approvedWincAmount: 0.08315565032,
+  expiresBySeconds: 3600,
+});
 ```
 
-#### `revokeDelegatedPaymentApprovals({ approvedAddress })`
+#### `revokeCredits({ approvedAddress })`
 
-Revokes all delegated payment approvals from the connected wallet to the provided native address.
+Revokes all credits shared from the connected wallet to the provided native address.
 
 ```typescript
-const revokedApprovals = await turbo.revokeDelegatePaymentApprovals({
+const revokedApprovals = await turbo.revokeCredits({
   approvedAddress: '2cor...VUa',
 });
 ```
 
-#### `getDelegatedPaymentApprovals({ userAddress })`
+#### `getCreditShareApprovals({ userAddress })`
 
-Returns all delegated payment approvals from the connected wallet or the provided native address.
+Returns all given or received credit share approvals for the connected wallet or the provided native address.
 
 ```typescript
 const { givenApprovals, receivedApprovals } =
-  await turbo.getDelegatedPaymentApprovals({
+  await turbo.getCreditShareApprovals({
     userAddress: '2cor...VUa',
   });
 ```
@@ -781,9 +781,9 @@ Wallet options:
 
 Upload options:
 
-- `--paid-by <paidBy...>` - An array of native addresses to pay for the upload
-- `--ignore-approvals` - The CLI will normally use any delegated payment approvals for the upload. This flag will ignore any approvals and only use the connected wallet's balance for upload payment. Default: false
-- `--use-signer-balance-first` - Use the connected wallet's balance before using any delegated payment approvals for the upload. Default: false
+- `--paid-by <paidBy...>` - A list of native addresses to pay for the upload.
+- `--ignore-approvals` - When no paid by is provided, the CLI will look for and use any received credit share approvals to pay for the upload. This flag will ignore any approvals and only use the connected wallet's balance for upload payment. Default: false
+- `--use-signer-balance-first` - Use the connected wallet's balance before using any credit share approvals for the upload. Default: false
 
 #### Commands
 
@@ -870,7 +870,7 @@ Command Options:
 e.g:
 
 ```shell
-turbo upload-file --file-path '../path/to/my/file.txt' --token ethereum --wallet-file ../path/to/eth/private/key.txt --paid-by '0x...address' '0x...another-address'
+turbo upload-file --file-path '../path/to/my/file.txt' --token ethereum --wallet-file ../path/to/eth/private/key.txt --paid-by '0x...first-payer-address' '0x...second-payer-address' '0x...third-payer-address' 'etc...'
 ```
 
 ##### `price`
@@ -896,50 +896,78 @@ turbo price --value 1024 --type bytes
 turbo price --value 1.1 --type arweave
 ```
 
-##### `create-approval`
+##### `share-credits`
 
-Create a delegated payment approval from the connected wallet to the provided native address and approved winc amount.
+Shares credits from the connected wallet to the provided native address and approved winc amount.
 
 Command Options:
 
-- `-a, --address <nativeAddress>` - Native address to that will receive the delegated payment approval
-- `-v, --value <value>` - Value of winc to create delegated payment approval for
-- `-e, --expires-by-seconds <seconds>` - Expiry time in seconds for the delegated payment approval
+- `-a, --address <nativeAddress>` - Native address to that will receive the Credits
+- `-v, --value <value>` - Value of winc to share to the target address
+- `-e, --expires-by-seconds <seconds>` - Expiry time in seconds for the credit share approval
 
 e.g:
 
 ```shell
-turbo create-approval --address 2cor...VUa --value 0.083155650320 --wallet-file ../path/to/my/wallet --expires-by-seconds 3600
+turbo share-credits --address 2cor...VUa --value 0.083155650320 --wallet-file ../path/to/my/wallet --expires-by-seconds 3600
 ```
 
-##### `revoke-approvals`
+##### `revoke-credits`
 
-Revoke all delegated payment approvals from the connected wallet to the provided native address.
+Revoke all credits shared from the connected wallet to the provided native address.
 
 Command Options:
 
-- `-a, --address <nativeAddress>` - Native address to revoke delegated payment approvals for
+- `-a, --address <nativeAddress>` - Native address to revoke credit share approvals for
 
 e.g:
 
 ```shell
-turbo revoke-approvals --wallet-file ../path/to/my/wallet
+turbo revoke-credits --wallet-file ../path/to/my/wallet
 ```
 
-##### `list-approvals`
+##### `list-shares`
 
-List all given and received delegated payment approvals from the connected wallet or the provided native address.
+List all given and received credit share approvals from the connected wallet or the provided native address.
 
 Command Options:
 
-- `-a, --address <nativeAddress>` - Native address to list delegated payment approvals for
+- `-a, --address <nativeAddress>` - Native address to list credit share approvals for
 
 e.g:
 
 ```shell
-turbo list-approvals --address 2cor...VUa --wallet-file ../path/to/my/wallet
+turbo list-shares --address 2cor...VUa --wallet-file ../path/to/my/wallet
 ```
 
+## Turbo Credit Sharing
+
+Users can share their purchased Credits with other user's wallets by creating Credit Share Approvals. These approvals are created by uploading a signed data item with tags indicating the recipient's wallet address, the amount of Credits to share, and an optional amount of seconds that the approval will expire in. The recipient can then use the shared Credits to pay for their own uploads to Turbo.
+
+Shared Credits cannot be re-shared by the recipient to other recipients. Only the owner of the Credits can share or revoke Credit Share Approvals. Credits that are shared to other wallets may not be used by the original owner of the Credits for sharing or uploading unless the Credit Share Approval is revoked or expired.
+
+Approvals can be revoked at any time by similarly uploading a signed data item with tags indicating the recipient's wallet address. This will remove all approvals and prevent the recipient from using the shared Credits. All unused Credits from expired or revoked approvals are returned to the original owner of the Credits.
+
+To use the shared Credits, recipient users must provide the wallet address of the user who shared the Credits with them in the `x-paid-by` HTTP header when uploading data. This tells Turbo services to look for and use Credit Share Approvals to pay for the upload before using the signer's balance.
+
+For user convenience, during upload the Turbo CLI will use any available Credit Share Approvals found for the connected wallet before using the signing wallet's balance. To instead ignore all Credit shares and only use the signer's balance, use the `--ignore-approvals` flag. To use the signer's balance first before using Credit shares, use the `--use-signer-balance-first` flag. The Turbo SDK layer does not provide this functionality and will always use the signer's balance unless `paidBy` is provided.
+
+The Turbo SDK provides the following methods to manage Credit Share Approvals:
+
+- `shareCredits`: Creates a Credit Share Approval for the specified wallet address and amount of Credits.
+- `revokeCredits`: Revokes all Credit Share Approvals for the specified wallet address.
+- `listShares`: Lists all Credit Share Approvals for the specified wallet address or connected wallet.
+- `dataItemOpts: { ...opts, paidBy: string[] }`: Upload methods now accept an array of wallet addresses to pay for the upload.
+
+The Turbo CLI provides the following commands to manage Credit Share Approvals:
+
+- `share-credits`: Creates a Credit Share Approval for the specified wallet address and amount of Credits.
+- `revoke-credits`: Revokes all Credit Share Approvals for the specified wallet address.
+- `list-shares`: Lists all Credit Share Approvals for the specified wallet address or connected wallet.
+- `paidBy: --paid-by <paidBy...>`: Upload commands now accept an array of wallet addresses to pay for the upload.
+- `--ignore-approvals`: Ignore all Credit Share Approvals and only use the signer's balance.
+- `--use-signer-balance-first`: Use the signer's balance first before using Credit Share Approvals.
+
 ## Developers
 
 ### Requirements

package/bundles/web.bundle.min.js

@@ -310551,7 +310551,7 @@ var import_winston = __toESM(require_winston(), 1);
 init_dirname();
 init_buffer2();
 init_process2();
-var version16 = "1.19.2";
+var version16 = "1.20.0-alpha.1";
 
 // src/common/logger.ts
 var TurboWinstonLogger = class _TurboWinstonLogger {
@@ -314897,7 +314897,7 @@ var TurboUnauthenticatedPaymentService = class {
     }
     throw new Error("Unknown response from payment service: " + response);
   }
-  async getDelegatedPaymentApprovals({
+  async getCreditShareApprovals({
     userAddress
   }) {
     const response = await this.httpService.get({
@@ -314930,11 +314930,11 @@ var TurboAuthenticatedPaymentService = class extends TurboUnauthenticatedPayment
     userAddress ??= await this.signer.getNativeAddress();
     return super.getBalance(userAddress);
   }
-  async getDelegatedPaymentApprovals({
+  async getCreditShareApprovals({
     userAddress
   }) {
     userAddress ??= await this.signer.getNativeAddress();
-    return super.getDelegatedPaymentApprovals({ userAddress });
+    return super.getCreditShareApprovals({ userAddress });
   }
   async getWincForFiat({
     amount,
@@ -349652,10 +349652,12 @@ function pLimit(concurrency) {
 }
 
 // src/common/upload.ts
-var createDelegatedPaymentApprovalTagName = "x-approve-payment";
-var approvalAmountTagName = "x-amount";
-var approvalExpiresBySecondsTagName = "x-expires-seconds";
-var revokeDelegatePaymentApprovalTagName = "x-delete-payment-approval";
+var creditSharingTagNames = {
+  shareCredits: "x-approve-payment",
+  sharedWincAmount: "x-amount",
+  approvalExpiresBySeconds: "x-expires-seconds",
+  revokeCredits: "x-delete-payment-approval"
+};
 var developmentUploadServiceURL = "https://upload.ardrive.dev";
 var defaultUploadServiceURL = "https://upload.ardrive.io";
 var TurboUnauthenticatedUploadService = class {
@@ -349854,20 +349856,26 @@ var TurboAuthenticatedBaseUploadService = class extends TurboUnauthenticatedUplo
       manifestResponse
     };
   }
-  async createDelegatedPaymentApproval({
+  async shareCredits({
     approvedAddress,
     approvedWincAmount,
     expiresBySeconds
   }) {
     const dataItemOpts = {
       tags: [
-        { name: createDelegatedPaymentApprovalTagName, value: approvedAddress },
-        { name: approvalAmountTagName, value: approvedWincAmount.toString() }
+        {
+          name: creditSharingTagNames.shareCredits,
+          value: approvedAddress
+        },
+        {
+          name: creditSharingTagNames.sharedWincAmount,
+          value: approvedWincAmount.toString()
+        }
       ]
     };
     if (expiresBySeconds !== void 0) {
       dataItemOpts.tags.push({
-        name: approvalExpiresBySecondsTagName,
+        name: creditSharingTagNames.approvalExpiresBySeconds,
         value: expiresBySeconds.toString()
       });
     }
@@ -349881,18 +349889,18 @@ var TurboAuthenticatedBaseUploadService = class extends TurboUnauthenticatedUplo
     });
     if (!createdApproval) {
       throw new Error(
-        "Failed to create delegated payment approval but upload has succeeded\n" + JSON.stringify(uploadResponse)
+        "Failed to create credit share approval but upload has succeeded\n" + JSON.stringify(uploadResponse)
       );
     }
     return createdApproval;
   }
-  async revokeDelegatedPaymentApprovals({
+  async revokeCredits({
     revokedAddress
   }) {
     const dataItemOpts = {
       tags: [
         {
-          name: revokeDelegatePaymentApprovalTagName,
+          name: creditSharingTagNames.revokeCredits,
           value: revokedAddress
         }
       ]
@@ -349905,7 +349913,7 @@ var TurboAuthenticatedBaseUploadService = class extends TurboUnauthenticatedUplo
     });
     if (!revokedApprovals) {
       throw new Error(
-        "Failed to revoke delegated payment approvals but upload has succeeded\n" + JSON.stringify(uploadResponse)
+        "Failed to revoke credit share approvals but upload has succeeded\n" + JSON.stringify(uploadResponse)
       );
     }
     return revokedApprovals;
@@ -350024,10 +350032,10 @@ var TurboUnauthenticatedClient = class {
     return wallets;
   }
   /**
-   * Returns a list of all delegated payment approvals for the user.
+   * Returns a list of all credit share approvals for the user.
    */
-  getDelegatedPaymentApprovals(p8) {
-    return this.paymentService.getDelegatedPaymentApprovals(p8);
+  getCreditShareApprovals(p8) {
+    return this.paymentService.getCreditShareApprovals(p8);
   }
 };
 var TurboAuthenticatedClient = class extends TurboUnauthenticatedClient {
@@ -350046,10 +350054,10 @@ var TurboAuthenticatedClient = class extends TurboUnauthenticatedClient {
     return this.paymentService.getBalance(userAddress);
   }
   /**
-   * Returns a list of all delegated payment approvals for the user.
+   * Returns a list of all credit share approvals for the user.
    */
-  getDelegatedPaymentApprovals(p8 = {}) {
-    return this.paymentService.getDelegatedPaymentApprovals(p8);
+  getCreditShareApprovals(p8 = {}) {
+    return this.paymentService.getCreditShareApprovals(p8);
   }
   /**
    * Signs and uploads raw data to the Turbo Upload Service.
@@ -350078,21 +350086,21 @@ var TurboAuthenticatedClient = class extends TurboUnauthenticatedClient {
     return this.paymentService.topUpWithTokens(p8);
   }
   /**
-   * Creates a data item with tags that designate it as a delegated payment approval.
+   * Creates a data item with tags that designate it as a credit share approval.
    * Signs the data item and sends it to the Turbo Upload Service, which will verify
    * the signature and forward the admin action towards the Turbo Payment Service.
    */
-  createDelegatedPaymentApproval(p8) {
-    return this.uploadService.createDelegatedPaymentApproval(p8);
+  shareCredits(p8) {
+    return this.uploadService.shareCredits(p8);
   }
   /**
-   * Creates a data item with tags that designate it as a revoke action for delegated
-   * payment approvals for target revokedAddress. Signs the data item and sends it to
+   * Creates a data item with tags that designate it as a revoke action for credit
+   * share approvals for target revokedAddress. Signs the data item and sends it to
    * the Turbo Upload Service, which will verify the signature and forward the admin
    * action towards the Turbo Payment Service.
    */
-  revokeDelegatedPaymentApprovals(p8) {
-    return this.uploadService.revokeDelegatedPaymentApprovals(p8);
+  revokeCredits(p8) {
+    return this.uploadService.revokeCredits(p8);
   }
 };
 
@@ -350629,9 +350637,7 @@ export {
   USD,
   WinstonToTokenAmount,
   ZeroDecimalCurrency,
-  approvalAmountTagName,
-  approvalExpiresBySecondsTagName,
-  createDelegatedPaymentApprovalTagName,
+  creditSharingTagNames,
   currencyMap,
   defaultPaymentServiceURL,
   defaultTokenMap,
@@ -350652,7 +350658,6 @@ export {
   isWebUploadFolderParams,
   lamportToTokenAmount,
   privateKeyFromKyveMnemonic,
-  revokeDelegatePaymentApprovalTagName,
   signerFromKyveMnemonic,
   signerFromKyvePrivateKey2 as signerFromKyvePrivateKey,
   tokenToBaseMap,

package/lib/cjs/cli/cli.js

@@ -20,10 +20,10 @@ 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 createApproval_js_1 = require("./commands/createApproval.js");
 const index_js_1 = require("./commands/index.js");
-const listApprovals_js_1 = require("./commands/listApprovals.js");
-const revokeApprovals_js_1 = require("./commands/revokeApprovals.js");
+const listShares_js_1 = require("./commands/listShares.js");
+const revokeCredits_js_1 = require("./commands/revokeCredits.js");
+const shareCredits_js_1 = require("./commands/shareCredits.js");
 const options_js_1 = require("./options.js");
 const utils_js_1 = require("./utils.js");
 (0, utils_js_1.applyOptions)(commander_1.program
@@ -52,19 +52,19 @@ const utils_js_1 = require("./utils.js");
     await (0, utils_js_1.runCommand)(command, index_js_1.price);
 });
 (0, utils_js_1.applyOptions)(commander_1.program
-    .command('create-approval')
-    .description('Create a Turbo delegated payment approval'), options_js_1.createApprovalOptions).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, createApproval_js_1.createApproval);
+    .command('share-credits')
+    .description('Create a Turbo credit share approval'), options_js_1.shareCreditsOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, shareCredits_js_1.shareCredits);
 });
 (0, utils_js_1.applyOptions)(commander_1.program
-    .command('revoke-approvals')
-    .description('Revokes all Turbo delegated payment approvals for given address'), options_js_1.revokeApprovalsOptions).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, revokeApprovals_js_1.revokeApprovals);
+    .command('revoke-credits')
+    .description('Revokes all Turbo credit share approvals for given address'), options_js_1.revokeCreditsOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, revokeCredits_js_1.revokeCredits);
 });
 (0, utils_js_1.applyOptions)(commander_1.program
-    .command('list-approvals')
-    .description('Lists all Turbo delegated payment approvals for given address or wallet'), options_js_1.listApprovalsOptions).action(async (_commandOptions, command) => {
-    await (0, utils_js_1.runCommand)(command, listApprovals_js_1.listApprovals);
+    .command('list-shares')
+    .description('Lists all given or received Turbo credit share approvals for specified address or connected wallet'), options_js_1.listSharesOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, listShares_js_1.listShares);
 });
 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/{listApprovals.js → listShares.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listApprovals = listApprovals;
+exports.listShares = listShares;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -18,12 +18,12 @@ exports.listApprovals = listApprovals;
  */
 const factory_js_1 = require("../../node/factory.js");
 const utils_js_1 = require("../utils.js");
-async function listApprovals(options) {
+async function listShares(options) {
     const config = (0, utils_js_1.configFromOptions)(options);
     const { address, privateKey } = await (0, utils_js_1.addressOrPrivateKeyFromOptions)(options);
     const { givenApprovals, receivedApprovals, nativeAddress } = await (async () => {
         if (address !== undefined) {
-            const approvals = await factory_js_1.TurboFactory.unauthenticated(config).getDelegatedPaymentApprovals({
+            const approvals = await factory_js_1.TurboFactory.unauthenticated(config).getCreditShareApprovals({
                 userAddress: address,
             });
             return { ...approvals, nativeAddress: address };
@@ -35,7 +35,7 @@ async function listApprovals(options) {
             ...config,
             privateKey,
         });
-        const approvals = await turbo.getDelegatedPaymentApprovals();
+        const approvals = await turbo.getCreditShareApprovals();
         return {
             ...approvals,
             nativeAddress: await turbo.signer.getNativeAddress(),
@@ -43,8 +43,8 @@ async function listApprovals(options) {
     })();
     const hasApprovals = givenApprovals?.length === 0 && receivedApprovals?.length === 0;
     const body = {
-        message: `${hasApprovals ? 'No approvals found' : 'Approvals found'}` +
-            ` for native address '${nativeAddress}'`,
+        message: `${hasApprovals ? 'No ' : ''}` +
+            `Credit Share Approvals found for native address '${nativeAddress}'`,
         givenApprovals,
         receivedApprovals,
     };

package/lib/cjs/cli/commands/{revokeApprovals.js → revokeCredits.js}

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.revokeApprovals = revokeApprovals;
+exports.revokeCredits = revokeCredits;
 const utils_js_1 = require("../utils.js");
-async function revokeApprovals(options) {
+async function revokeCredits(options) {
     const { address: revokedAddress } = options;
     if (revokedAddress === undefined) {
         throw new Error('Must provide an approved --address to revoke approvals for');
     }
     const turbo = await (0, utils_js_1.turboFromOptions)(options);
-    const revokedApprovals = await turbo.revokeDelegatedPaymentApprovals({
+    const revokedApprovals = await turbo.revokeCredits({
         revokedAddress,
     });
-    console.log(JSON.stringify({ message: 'Revoked approvals', revokedApprovals }, null, 2));
+    console.log(JSON.stringify({ message: 'Revoked credit share approvals!', revokedApprovals }, null, 2));
 }

package/lib/cjs/cli/commands/{createApproval.js → shareCredits.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createApproval = createApproval;
+exports.shareCredits = shareCredits;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -18,7 +18,7 @@ exports.createApproval = createApproval;
  */
 const bignumber_js_1 = require("bignumber.js");
 const utils_js_1 = require("../utils.js");
-async function createApproval(options) {
+async function shareCredits(options) {
     const { address: approvedAddress, value: creditAmount, expiresBySeconds, } = options;
     if (approvedAddress === undefined) {
         throw new Error('Must provide an approved --address to create approval for');
@@ -30,10 +30,10 @@ async function createApproval(options) {
     const approvedWincAmount = new bignumber_js_1.BigNumber(creditAmount)
         .shiftedBy(12)
         .toFixed(0);
-    const result = await turbo.createDelegatedPaymentApproval({
+    const result = await turbo.shareCredits({
         approvedAddress,
         approvedWincAmount,
         expiresBySeconds,
     });
-    console.log(JSON.stringify({ message: 'Created approval:', ...result }, null, 2));
+    console.log(JSON.stringify({ message: 'Created credit share approval!', ...result }, null, 2));
 }

package/lib/cjs/cli/options.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listApprovalsOptions = exports.revokeApprovalsOptions = exports.createApprovalOptions = exports.uploadFileOptions = exports.uploadFolderOptions = exports.uploadOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+exports.listSharesOptions = exports.revokeCreditsOptions = exports.shareCreditsOptions = exports.uploadFileOptions = exports.uploadFolderOptions = exports.uploadOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
 exports.optionMap = {
     token: {
         alias: '-t, --token <type>',
@@ -134,12 +134,12 @@ exports.optionMap = {
     },
     ignoreApprovals: {
         alias: '--ignore-approvals',
-        description: "Ignore all delegated payment approvals, only use signing wallet's balance",
+        description: "Ignore all credit share approvals, only use signing wallet's balance",
         default: false,
     },
     useSignerBalanceFirst: {
         alias: '--use-signer-balance-first',
-        description: 'Use the signer balance first before using delegated payment approvals',
+        description: 'Use the signer balance first before using credit share approvals',
         default: false,
     },
 };
@@ -174,11 +174,11 @@ exports.uploadFolderOptions = [
     exports.optionMap.maxConcurrency,
 ];
 exports.uploadFileOptions = [...exports.uploadOptions, exports.optionMap.filePath];
-exports.createApprovalOptions = [
+exports.shareCreditsOptions = [
     ...exports.walletOptions,
     exports.optionMap.value,
     exports.optionMap.address,
     exports.optionMap.expiresBySeconds,
 ];
-exports.revokeApprovalsOptions = [...exports.walletOptions, exports.optionMap.address];
-exports.listApprovalsOptions = exports.revokeApprovalsOptions;
+exports.revokeCreditsOptions = [...exports.walletOptions, exports.optionMap.address];
+exports.listSharesOptions = exports.revokeCreditsOptions;

package/lib/cjs/common/payment.js

@@ -164,7 +164,7 @@ class TurboUnauthenticatedPaymentService {
         }
         throw new Error('Unknown response from payment service: ' + response);
     }
-    async getDelegatedPaymentApprovals({ userAddress, }) {
+    async getCreditShareApprovals({ userAddress, }) {
         const response = await this.httpService.get({
             endpoint: `/account/approvals/get?userAddress=${userAddress}`,
             allowedStatuses: [200, 404],
@@ -191,9 +191,9 @@ class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentServic
         userAddress ??= await this.signer.getNativeAddress();
         return super.getBalance(userAddress);
     }
-    async getDelegatedPaymentApprovals({ userAddress, }) {
+    async getCreditShareApprovals({ userAddress, }) {
         userAddress ??= await this.signer.getNativeAddress();
-        return super.getDelegatedPaymentApprovals({ userAddress });
+        return super.getCreditShareApprovals({ userAddress });
     }
     async getWincForFiat({ amount, promoCodes = [], }) {
         return super.getWincForFiat({

package/lib/cjs/common/turbo.js

@@ -109,10 +109,10 @@ class TurboUnauthenticatedClient {
         return wallets;
     }
     /**
-     * Returns a list of all delegated payment approvals for the user.
+     * Returns a list of all credit share approvals for the user.
      */
-    getDelegatedPaymentApprovals(p) {
-        return this.paymentService.getDelegatedPaymentApprovals(p);
+    getCreditShareApprovals(p) {
+        return this.paymentService.getCreditShareApprovals(p);
     }
 }
 exports.TurboUnauthenticatedClient = TurboUnauthenticatedClient;
@@ -128,10 +128,10 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
         return this.paymentService.getBalance(userAddress);
     }
     /**
-     * Returns a list of all delegated payment approvals for the user.
+     * Returns a list of all credit share approvals for the user.
      */
-    getDelegatedPaymentApprovals(p = {}) {
-        return this.paymentService.getDelegatedPaymentApprovals(p);
+    getCreditShareApprovals(p = {}) {
+        return this.paymentService.getCreditShareApprovals(p);
     }
     /**
      * Signs and uploads raw data to the Turbo Upload Service.
@@ -155,21 +155,21 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
         return this.paymentService.topUpWithTokens(p);
     }
     /**
-     * Creates a data item with tags that designate it as a delegated payment approval.
+     * Creates a data item with tags that designate it as a credit share approval.
      * Signs the data item and sends it to the Turbo Upload Service, which will verify
      * the signature and forward the admin action towards the Turbo Payment Service.
      */
-    createDelegatedPaymentApproval(p) {
-        return this.uploadService.createDelegatedPaymentApproval(p);
+    shareCredits(p) {
+        return this.uploadService.shareCredits(p);
     }
     /**
-     * Creates a data item with tags that designate it as a revoke action for delegated
-     * payment approvals for target revokedAddress. Signs the data item and sends it to
+     * Creates a data item with tags that designate it as a revoke action for credit
+     * share approvals for target revokedAddress. Signs the data item and sends it to
      * the Turbo Upload Service, which will verify the signature and forward the admin
      * action towards the Turbo Payment Service.
      */
-    revokeDelegatedPaymentApprovals(p) {
-        return this.uploadService.revokeDelegatedPaymentApprovals(p);
+    revokeCredits(p) {
+        return this.uploadService.revokeCredits(p);
     }
 }
 exports.TurboAuthenticatedClient = TurboAuthenticatedClient;