feat(crypto fund): add --tx-id parameter with submitFundTransaction c…

…ompatibility and docs PE-6732

README.md

@@ -727,18 +727,23 @@ turbo top-up --address 'crypto-wallet-public-native-address' --token ethereum --
 
 ##### `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.
+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. Alternatively, submit a transaction ID of an existing funding transaction to Turbo Payment Service for top up processing.
 
 Command Options:
 
 - `-v, --value <value>` - Value of crypto token for fund. e.g: 0.0001 for 0.0001 KYVE
+- `-i, --tx-id <txId>` - Transaction ID of an existing funding transaction
 
 e.g:
 
 ```shell
 turbo crypto-fund --value 0.0001 --token kyve --private-key 'b27...45c'
 ```
 
+```shell
+turbo crypto-fund --tx-id 'my-valid-arweave-fund-transaction-id' --token arweave
+```
+
 ##### `upload-folder`
 
 Upload a folder of files and create and upload a manifest file for the folder upload to the Turbo Upload Service.

src/cli/cli.ts

@@ -62,7 +62,7 @@ applyOptions(
 
 applyOptions(
   program.command('crypto-fund').description('Top up a wallet with crypto'),
-  [...walletOptions, optionMap.value],
+  [...walletOptions, optionMap.value, optionMap.txId],
 ).action(async (_commandOptions, command: Command) => {
   await runCommand(command, cryptoFund);
 });

src/cli/commands.ts

@@ -78,8 +78,23 @@ export async function getBalance(options: AddressOptions) {
 /** Fund the connected signer with crypto */
 export async function cryptoFund(options: CryptoFundOptions) {
   const value = options.value;
+  const txId = options.txId;
+
+  if (txId !== undefined) {
+    const turbo = TurboFactory.unauthenticated(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 to top up');
+    throw new Error(
+      'Must provide a --value or --transaction-id for crypto-fund command',
+    );
   }
 
   const turbo = await turboFromOptions(options);

src/cli/options.ts

@@ -26,6 +26,10 @@ export const optionMap = {
     description: 'Fiat currency type to use for the action',
     default: 'usd',
   },
+  txId: {
+    alias: '-i, --tx-id <txId>',
+    description: 'Transaction ID or hash to use for action',
+  },
   address: {
     alias: '-a, --address <nativeAddress>',
     description: 'Native address to use for action',

src/cli/types.ts

@@ -52,4 +52,5 @@ export type UploadFileOptions = WalletOptions & {
 
 export type CryptoFundOptions = WalletOptions & {
   value: string | undefined;
+  txId: string | undefined;
 };