@ardrive/turbo-sdk 1.34.0 → 1.35.0-alpha.2

package/README.md

@@ -340,11 +340,11 @@ const turbo = TurboFactory.authenticated({
   }
 });
 
-// Ethereum Holesky
+// Ethereum Sepolia
 const turbo = TurboFactory.authenticated({
-  privateKey: process.env.HOLESKY_PRIVATE_KEY,
+  privateKey: process.env.SEPOLIA_PRIVATE_KEY,
   token: 'ethereum',
-  gatewayUrl: 'https://ethereum-holesky-rpc.publicnode.com',
+  gatewayUrl: 'https://eth-sepolia.public.blastapi.io',
   paymentServiceConfig: {
     url: 'https://payment.ardrive.dev',
   },
@@ -358,7 +358,7 @@ const turbo = TurboFactory.authenticated({
 
 - **Base Sepolia** (`base-eth`) - Supports on-demand funding
 - **Solana Devnet** (`solana`) - Supports on-demand funding
-- **Ethereum Holesky** (`ethereum`) - Manual top-up only
+- **Ethereum Sepolia** (`ethereum`) - Manual top-up only
 - **Polygon Amoy** (`pol`) - Manual top-up only
 
 ### TurboUnauthenticatedClient
@@ -730,7 +730,7 @@ With the upload methods, you can choose to Top Up with selected crypto token on
 
 This is done by providing the `OnDemandFunding` class to the `fundingMode` parameter on upload methods. The `maxTokenAmount` (optional) is the maximum amount of tokens in the token type's smallest unit value (e.g: Winston for arweave token type) to fund the wallet with. The `topUpBufferMultiplier` (optional) is the multiplier to apply to the estimated top-up amount to avoid underpayment during on-demand top-ups due to price fluctuations on longer uploads. Defaults to 1.1, meaning a 10% buffer.
 
-Note: On demand API currently only available for $ARIO (`ario`), $SOL (`solana`), and $ETH on Base Network (`base-eth`) token types.
+Note: On demand API currently only available for $ARIO (`ario`), $SOL (`solana`), $ETH on Base Network (`base-eth`) and $USDC on Base Network (`base-usdc`) token types.
 
 ```typescript
 const turbo = TurboFactory.authenticated({
@@ -899,6 +899,36 @@ const { winc, status, id, ...fundResult } = await turbo.topUpWithTokens({
 });
 ```
 
+##### USDC Crypto Top Up
+
+```typescript
+
+// USDC on Ethereum Mainnet
+const { winc, status, id, ...fundResult } = await TurboFactory.authenticated({
+  signer,
+  token: 'usdc',
+}).topUpWithTokens({
+  tokenAmount: USDCToTokenAmount(1), // 1 USDC
+});
+
+// USDC on Base Network
+const { winc, status, id, ...fundResult } = await TurboFactory.authenticated({
+  signer,
+  token: 'base-usdc',
+}).topUpWithTokens({
+  tokenAmount: USDCToTokenAmount(1), // 1 USDC
+});
+
+
+// USDC on Polygon Network
+const { winc, status, id, ...fundResult } = await TurboFactory.authenticated({
+  signer,
+  token: 'polygon-usdc',
+}).topUpWithTokens({
+  tokenAmount: USDCToTokenAmount(1), // 1 USDC
+});
+```
+
 ##### Ethereum (ETH) Crypto Top Up
 
 ```typescript
@@ -1191,6 +1221,11 @@ Command Options:
 
 e.g:
 
+```shell
+# Fund any valid destination wallet with 10 USDC worth of Turbo Credits on Base Network
+turbo crypto-fund --value 10 --token base-usdc --private-key '0xabc...123' --address 'any-valid-evm-sol-ar-kyve-native-address'
+```
+
 ```shell
 turbo crypto-fund --value 0.0001 --token kyve --private-key 'b27...45c'
 ```

package/bundles/web.bundle.min.js

@@ -222361,8 +222361,20 @@ var tokenTypes = [
   "kyve",
   "matic",
   "pol",
-  "base-eth"
+  "base-eth",
+  "usdc",
+  "base-usdc",
+  "polygon-usdc"
 ];
+var supportedEvmSignerTokens = /* @__PURE__ */ new Set([
+  "ethereum",
+  "base-eth",
+  "matic",
+  "pol",
+  "polygon-usdc",
+  "usdc",
+  "base-usdc"
+]);
 var ExistingBalanceFunding = class {
 };
 var OnDemandFunding = class {
@@ -222423,7 +222435,7 @@ var import_winston = __toESM(require_winston(), 1);
 init_dirname();
 init_buffer2();
 init_process2();
-var version21 = "1.33.1";
+var version21 = "1.35.0-alpha.1";
 
 // src/common/logger.ts
 var TurboWinstonLogger = class _TurboWinstonLogger {
@@ -259254,6 +259266,24 @@ var wordlists2 = {
 function sleep2(ms2) {
   return new Promise((resolve3) => setTimeout(resolve3, ms2));
 }
+var ethTestnetRpc = "https://eth-sepolia.public.blastapi.io";
+var baseTestnetRpc = "https://sepolia.base.org";
+var polygonTestnetRpc = "https://rpc-amoy.polygon.technology";
+var tokenToDevGatewayMap = {
+  arweave: "https://arweave.net",
+  // No arweave test net
+  ario: "https://arweave.net",
+  // No arweave test net
+  solana: "https://api.devnet.solana.com",
+  ethereum: ethTestnetRpc,
+  "base-eth": baseTestnetRpc,
+  kyve: "https://api.korellia.kyve.network",
+  matic: polygonTestnetRpc,
+  pol: polygonTestnetRpc,
+  usdc: ethTestnetRpc,
+  "base-usdc": baseTestnetRpc,
+  "polygon-usdc": polygonTestnetRpc
+};
 var defaultProdGatewayUrls = {
   arweave: "https://arweave.net",
   ario: "https://arweave.net",
@@ -259262,7 +259292,10 @@ var defaultProdGatewayUrls = {
   "base-eth": "https://mainnet.base.org",
   kyve: "https://api.kyve.network/",
   matic: "https://polygon-rpc.com/",
-  pol: "https://polygon-rpc.com/"
+  pol: "https://polygon-rpc.com/",
+  usdc: "https://cloudflare-eth.com/",
+  "base-usdc": "https://mainnet.base.org",
+  "polygon-usdc": "https://polygon-rpc.com/"
 };
 var defaultProdAoConfigs = {
   ario: {
@@ -259297,6 +259330,9 @@ function createTurboSigner({
     case "pol":
     case "matic":
     case "base-eth":
+    case "usdc":
+    case "base-usdc":
+    case "polygon-usdc":
       if (!isEthPrivateKey(clientProvidedPrivateKey)) {
         throw new Error(
           "A valid Ethereum private key must be provided for EthereumSigner."
@@ -259354,6 +259390,9 @@ function isValidUserAddress(address, type4) {
     case "base-eth":
     case "matic":
     case "pol":
+    case "base-usdc":
+    case "usdc":
+    case "polygon-usdc":
       return isValidECDSAAddress(address);
     case "kyve":
       return isValidKyveAddress(address);
@@ -273336,15 +273375,16 @@ init_buffer2();
 init_process2();
 var weiToTokenAmount = (wei) => wei;
 var ETHToTokenAmount = (eth) => new BigNumber2(eth).times(1e18).valueOf();
+var defaultEthereumPollingOptions = {
+  initialBackoffMs: 25e3,
+  maxAttempts: 10,
+  pollingIntervalMs: 1500
+};
 var EthereumToken = class {
   constructor({
     logger: logger19 = TurboWinstonLogger.default,
     gatewayUrl = defaultProdGatewayUrls.ethereum,
-    pollingOptions = {
-      maxAttempts: 10,
-      pollingIntervalMs: 4e3,
-      initialBackoffMs: 25e3
-    }
+    pollingOptions = defaultEthereumPollingOptions
   } = {}) {
     this.logger = logger19;
     this.gatewayUrl = gatewayUrl;
@@ -273422,15 +273462,16 @@ function ethDataFromTurboCreditDestinationAddress(turboCreditDestinationAddress)
 }
 
 // src/common/token/baseEth.ts
+var defaultBaseNetworkPollingOptions = {
+  initialBackoffMs: 2500,
+  maxAttempts: 10,
+  pollingIntervalMs: 750
+};
 var BaseEthToken = class extends EthereumToken {
   constructor({
     logger: logger19,
     gatewayUrl = defaultProdGatewayUrls["base-eth"],
-    pollingOptions = {
-      initialBackoffMs: 2500,
-      maxAttempts: 10,
-      pollingIntervalMs: 2500
-    }
+    pollingOptions = defaultBaseNetworkPollingOptions
   } = {}) {
     super({
       logger: logger19,
@@ -273678,15 +273719,16 @@ init_dirname();
 init_buffer2();
 init_process2();
 var POLToTokenAmount = ETHToTokenAmount;
+var defaultPolygonPollingOptions = {
+  maxAttempts: 10,
+  initialBackoffMs: 5e3,
+  pollingIntervalMs: 1e3
+};
 var PolygonToken = class extends EthereumToken {
   constructor({
     logger: logger19 = TurboWinstonLogger.default,
     gatewayUrl = defaultProdGatewayUrls.pol,
-    pollingOptions = {
-      maxAttempts: 10,
-      pollingIntervalMs: 4e3,
-      initialBackoffMs: 5e3
-    }
+    pollingOptions = defaultPolygonPollingOptions
   } = {}) {
     super({ logger: logger19, gatewayUrl, pollingOptions });
   }
@@ -273817,6 +273859,149 @@ var SolanaToken = class {
   }
 };
 
+// src/common/token/usdc.ts
+init_dirname();
+init_buffer2();
+init_process2();
+
+// src/common/token/erc20.ts
+init_dirname();
+init_buffer2();
+init_process2();
+var ERC20Token = class extends EthereumToken {
+  constructor({
+    tokenContractAddress,
+    logger: logger19 = TurboWinstonLogger.default,
+    gatewayUrl = defaultProdGatewayUrls.ethereum,
+    pollingOptions
+  }) {
+    super({ logger: logger19, gatewayUrl, pollingOptions });
+    this.tokenContract = new ethers_exports.Contract(
+      tokenContractAddress,
+      [
+        "function decimals() view returns (uint8)",
+        "function balanceOf(address) view returns (uint256)",
+        "function transfer(address to, uint256 value) returns (bool)"
+      ],
+      this.rpcProvider
+    );
+  }
+  async createAndSubmitTx({
+    target,
+    tokenAmount,
+    signer,
+    turboCreditDestinationAddress
+  }) {
+    try {
+      let connected;
+      let walletOrSigner;
+      if (signer.signer instanceof EthereumSigner) {
+        const provider = new JsonRpcProvider(this.gatewayUrl);
+        const keyHex = Buffer2.from(signer.signer.key).toString("hex");
+        walletOrSigner = new Wallet2(keyHex, provider);
+        connected = this.tokenContract.connect(walletOrSigner);
+      } else if (signer.walletAdapter !== void 0 && isEthereumWalletAdapter(signer.walletAdapter)) {
+        walletOrSigner = signer.walletAdapter.getSigner();
+        connected = this.tokenContract.connect(walletOrSigner);
+      } else {
+        throw new Error(
+          "Unsupported signer -- must be EthereumSigner or have a walletAdapter implementing getSigner"
+        );
+      }
+      const baseTransferData = connected.interface.encodeFunctionData(
+        "transfer",
+        [target, tokenAmount.toString()]
+      );
+      let finalData = baseTransferData;
+      const memoData = ethDataFromTurboCreditDestinationAddress(
+        turboCreditDestinationAddress
+      );
+      if (memoData !== void 0) {
+        finalData += memoData.slice(2);
+      }
+      const txRequest = {
+        to: await connected.getAddress(),
+        data: finalData
+      };
+      this.logger.debug("Submitting ERC20 transfer", {
+        target,
+        tokenAmount: tokenAmount.toString(),
+        rpcEndpoint: this.gatewayUrl,
+        txRequest
+      });
+      const tx = await walletOrSigner.sendTransaction(txRequest);
+      this.logger.debug("ERC20 transfer submitted", {
+        txHash: tx.hash,
+        target,
+        tx
+      });
+      return { id: tx.hash, target };
+    } catch (e12) {
+      this.logger.error("Error creating/submitting ERC20 tx", {
+        error: e12 instanceof Error ? e12.message : e12,
+        target,
+        tokenAmount,
+        rpcEndpoint: this.gatewayUrl
+      });
+      throw e12;
+    }
+  }
+};
+
+// src/common/token/usdc.ts
+var usdcNetworks = (useDevnet = false) => ({
+  ethereum: {
+    tokenContractAddress: useDevnet ? ethSepoliaUsdcAddress : ethMainnetUsdcAddress,
+    rpcEndpoint: useDevnet ? tokenToDevGatewayMap.ethereum : defaultProdGatewayUrls.ethereum,
+    defaultPollingOptions: defaultEthereumPollingOptions
+  },
+  base: {
+    tokenContractAddress: useDevnet ? baseSepoliaUsdcAddress : baseMainnetUsdcAddress,
+    rpcEndpoint: useDevnet ? tokenToDevGatewayMap["base-eth"] : defaultProdGatewayUrls["base-eth"],
+    defaultPollingOptions: defaultBaseNetworkPollingOptions
+  },
+  polygon: {
+    tokenContractAddress: useDevnet ? polygonAmoyUsdcAddress : polygonMainnetUsdcAddress,
+    rpcEndpoint: useDevnet ? tokenToDevGatewayMap.pol : defaultProdGatewayUrls.pol,
+    defaultPollingOptions: defaultPolygonPollingOptions
+  }
+});
+var ethMainnetUsdcAddress = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+var baseMainnetUsdcAddress = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var polygonMainnetUsdcAddress = "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359";
+var ethSepoliaUsdcAddress = "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238";
+var baseSepoliaUsdcAddress = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+var polygonAmoyUsdcAddress = "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582";
+var USDCToTokenAmount = (usdc) => new BigNumber2(usdc).times(1e6).valueOf();
+var USDCToken = class extends ERC20Token {
+  constructor({
+    network = "ethereum",
+    logger: logger19,
+    gatewayUrl,
+    tokenContractAddress,
+    pollingOptions,
+    useDevnet
+  } = {}) {
+    if (useDevnet === void 0) {
+      const keywords = ["sepolia", "amoy"];
+      useDevnet = keywords.some(
+        (keyword) => (gatewayUrl ?? "").toLowerCase().includes(keyword)
+      );
+    }
+    const {
+      tokenContractAddress: usdcContractAddress,
+      rpcEndpoint,
+      defaultPollingOptions
+    } = usdcNetworks(useDevnet)[network];
+    super({
+      tokenContractAddress: tokenContractAddress ?? usdcContractAddress,
+      logger: logger19,
+      gatewayUrl: gatewayUrl ?? rpcEndpoint,
+      pollingOptions: pollingOptions ?? defaultPollingOptions
+    });
+  }
+};
+
 // src/common/token/index.ts
 var defaultTokenMap = {
   arweave: (config2) => new ArweaveToken(config2),
@@ -273826,9 +274011,13 @@ var defaultTokenMap = {
   "base-eth": (config2) => new BaseEthToken(config2),
   kyve: (config2) => new KyveToken(config2),
   matic: (config2) => new PolygonToken(config2),
-  pol: (config2) => new PolygonToken(config2)
+  pol: (config2) => new PolygonToken(config2),
+  usdc: (config2) => new USDCToken({ network: "ethereum", ...config2 }),
+  "base-usdc": (config2) => new USDCToken({ network: "base", ...config2 }),
+  "polygon-usdc": (config2) => new USDCToken({ network: "polygon", ...config2 })
 };
 var ethExponent = 18;
+var usdcExponent = 6;
 var exponentMap = {
   arweave: 12,
   ario: 6,
@@ -273837,7 +274026,10 @@ var exponentMap = {
   "base-eth": ethExponent,
   kyve: 6,
   matic: ethExponent,
-  pol: ethExponent
+  pol: ethExponent,
+  usdc: usdcExponent,
+  "base-usdc": usdcExponent,
+  "polygon-usdc": usdcExponent
 };
 var tokenToBaseMap = {
   arweave: (a8) => ARToTokenAmount(a8),
@@ -273847,7 +274039,10 @@ var tokenToBaseMap = {
   "base-eth": (a8) => ETHToTokenAmount(a8),
   kyve: (a8) => KYVEToTokenAmount(a8),
   matic: (a8) => POLToTokenAmount(a8),
-  pol: (a8) => POLToTokenAmount(a8)
+  pol: (a8) => POLToTokenAmount(a8),
+  usdc: (a8) => USDCToTokenAmount(a8),
+  "base-usdc": (a8) => USDCToTokenAmount(a8),
+  "polygon-usdc": (a8) => USDCToTokenAmount(a8)
 };
 function isTokenType(token) {
   return tokenTypes.includes(token);
@@ -275133,7 +275328,12 @@ var TurboAuthenticatedBaseUploadService = class extends TurboUnauthenticatedUplo
     paymentService
   }) {
     super({ url, retryConfig, logger: logger19, token });
-    this.enabledOnDemandTokens = ["ario", "solana", "base-eth"];
+    this.enabledOnDemandTokens = [
+      "ario",
+      "solana",
+      "base-eth",
+      "base-usdc"
+    ];
     this.signer = signer;
     this.paymentService = paymentService;
   }
@@ -276057,8 +276257,7 @@ var TurboBaseFactory = class {
       }
       return new HexSolanaSigner(walletAdapter);
     }
-    const ethTokens = /* @__PURE__ */ new Set(["ethereum", "base-eth", "matic", "pol"]);
-    if (ethTokens.has(token)) {
+    if (supportedEvmSignerTokens.has(token)) {
       if (!isEthereumWalletAdapter(walletAdapter)) {
         throw new Error(
           "Unsupported wallet adapter -- must implement getSigner"
@@ -276107,6 +276306,9 @@ var TurboDataItemAbstractSigner = class {
       case "matic":
       case "pol":
       case "base-eth":
+      case "usdc":
+      case "base-usdc":
+      case "polygon-usdc":
         return computeAddress2(computePublicKey(fromB64Url(owner)));
       case "kyve":
         return (0, import_amino3.pubkeyToAddress)(
@@ -276629,7 +276831,10 @@ export {
   createStreamWithUploadEvents,
   creditSharingTagNames,
   currencyMap,
+  defaultBaseNetworkPollingOptions,
+  defaultEthereumPollingOptions,
   defaultPaymentServiceURL,
+  defaultPolygonPollingOptions,
   defaultTokenMap,
   defaultTurboConfiguration,
   defaultUploadServiceURL,
@@ -276660,6 +276865,7 @@ export {
   signerFromKyveMnemonic,
   signerFromKyvePrivateKey2 as signerFromKyvePrivateKey,
   streamSignerReadableStream,
+  supportedEvmSignerTokens,
   tokenToBaseMap,
   tokenTypes,
   ukyveToTokenAmount,

package/lib/cjs/common/factory.js

@@ -141,8 +141,7 @@ class TurboBaseFactory {
             }
             return new arbundles_1.HexInjectedSolanaSigner(walletAdapter);
         }
-        const ethTokens = new Set(['ethereum', 'base-eth', 'matic', 'pol']);
-        if (ethTokens.has(token)) {
+        if (types_js_1.supportedEvmSignerTokens.has(token)) {
             if (!(0, types_js_1.isEthereumWalletAdapter)(walletAdapter)) {
                 throw new Error('Unsupported wallet adapter -- must implement getSigner');
             }

package/lib/cjs/common/signer.js

@@ -54,6 +54,9 @@ class TurboDataItemAbstractSigner {
             case 'matic':
             case 'pol':
             case 'base-eth':
+            case 'usdc':
+            case 'base-usdc':
+            case 'polygon-usdc':
                 return (0, ethers_2.computeAddress)((0, signing_key_1.computePublicKey)((0, base64_js_1.fromB64Url)(owner)));
             case 'kyve':
                 return (0, amino_1.pubkeyToAddress)({

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

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseEthToken = void 0;
+exports.BaseEthToken = exports.defaultBaseNetworkPollingOptions = void 0;
 const common_js_1 = require("../../utils/common.js");
 const ethereum_js_1 = require("./ethereum.js");
+exports.defaultBaseNetworkPollingOptions = {
+    initialBackoffMs: 2_500,
+    maxAttempts: 10,
+    pollingIntervalMs: 750,
+};
 class BaseEthToken extends ethereum_js_1.EthereumToken {
-    constructor({ logger, gatewayUrl = common_js_1.defaultProdGatewayUrls['base-eth'], pollingOptions = {
-        initialBackoffMs: 2_500,
-        maxAttempts: 10,
-        pollingIntervalMs: 2_500,
-    }, } = {}) {
+    constructor({ logger, gatewayUrl = common_js_1.defaultProdGatewayUrls['base-eth'], pollingOptions = exports.defaultBaseNetworkPollingOptions, } = {}) {
         super({
             logger,
             gatewayUrl,

package/lib/cjs/common/token/erc20.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC20Token = void 0;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const arbundles_1 = require("@dha-team/arbundles");
+const ethers_1 = require("ethers");
+const types_js_1 = require("../../types.js");
+const common_js_1 = require("../../utils/common.js");
+const logger_js_1 = require("../logger.js");
+const ethereum_js_1 = require("./ethereum.js");
+class ERC20Token extends ethereum_js_1.EthereumToken {
+    constructor({ tokenContractAddress, logger = logger_js_1.TurboWinstonLogger.default, gatewayUrl = common_js_1.defaultProdGatewayUrls.ethereum, pollingOptions, }) {
+        super({ logger, gatewayUrl, pollingOptions });
+        this.tokenContract = new ethers_1.ethers.Contract(tokenContractAddress, [
+            'function decimals() view returns (uint8)',
+            'function balanceOf(address) view returns (uint256)',
+            'function transfer(address to, uint256 value) returns (bool)',
+        ], this.rpcProvider);
+    }
+    async createAndSubmitTx({ target, tokenAmount, signer, turboCreditDestinationAddress, }) {
+        try {
+            let connected;
+            let walletOrSigner;
+            if (signer.signer instanceof arbundles_1.EthereumSigner) {
+                const provider = new ethers_1.JsonRpcProvider(this.gatewayUrl);
+                // 🧩 CLI / Node path
+                const keyHex = Buffer.from(signer.signer.key).toString('hex');
+                walletOrSigner = new ethers_1.Wallet(keyHex, provider);
+                connected = this.tokenContract.connect(walletOrSigner);
+            }
+            else if (signer.walletAdapter !== undefined &&
+                (0, types_js_1.isEthereumWalletAdapter)(signer.walletAdapter)) {
+                walletOrSigner = signer.walletAdapter.getSigner();
+                connected = this.tokenContract.connect(walletOrSigner);
+            }
+            else {
+                throw new Error('Unsupported signer -- must be EthereumSigner or have a walletAdapter implementing getSigner');
+            }
+            // Encode transfer data
+            const baseTransferData = connected.interface.encodeFunctionData('transfer', [target, tokenAmount.toString()]);
+            let finalData = baseTransferData;
+            // Append optional memo data with turbo credit destination address
+            const memoData = (0, ethereum_js_1.ethDataFromTurboCreditDestinationAddress)(turboCreditDestinationAddress);
+            if (memoData !== undefined) {
+                // remove the "0x" prefix and append
+                finalData += memoData.slice(2);
+            }
+            const txRequest = {
+                to: await connected.getAddress(),
+                data: finalData,
+            };
+            this.logger.debug('Submitting ERC20 transfer', {
+                target,
+                tokenAmount: tokenAmount.toString(),
+                rpcEndpoint: this.gatewayUrl,
+                txRequest,
+            });
+            const tx = await walletOrSigner.sendTransaction(txRequest);
+            this.logger.debug('ERC20 transfer submitted', {
+                txHash: tx.hash,
+                target,
+                tx,
+            });
+            return { id: tx.hash, target };
+        }
+        catch (e) {
+            this.logger.error('Error creating/submitting ERC20 tx', {
+                error: e instanceof Error ? e.message : e,
+                target,
+                tokenAmount,
+                rpcEndpoint: this.gatewayUrl,
+            });
+            throw e;
+        }
+    }
+}
+exports.ERC20Token = ERC20Token;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EthereumToken = exports.ETHToTokenAmount = exports.weiToTokenAmount = void 0;
+exports.EthereumToken = exports.defaultEthereumPollingOptions = exports.ETHToTokenAmount = exports.weiToTokenAmount = void 0;
 exports.ethDataFromTurboCreditDestinationAddress = ethDataFromTurboCreditDestinationAddress;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
@@ -25,12 +25,13 @@ const weiToTokenAmount = (wei) => wei;
 exports.weiToTokenAmount = weiToTokenAmount;
 const ETHToTokenAmount = (eth) => new bignumber_js_1.BigNumber(eth).times(1e18).valueOf();
 exports.ETHToTokenAmount = ETHToTokenAmount;
+exports.defaultEthereumPollingOptions = {
+    initialBackoffMs: 25_000,
+    maxAttempts: 10,
+    pollingIntervalMs: 1_500,
+};
 class EthereumToken {
-    constructor({ logger = logger_js_1.TurboWinstonLogger.default, gatewayUrl = common_js_1.defaultProdGatewayUrls.ethereum, pollingOptions = {
-        maxAttempts: 10,
-        pollingIntervalMs: 4_000,
-        initialBackoffMs: 25_000,
-    }, } = {}) {
+    constructor({ logger = logger_js_1.TurboWinstonLogger.default, gatewayUrl = common_js_1.defaultProdGatewayUrls.ethereum, pollingOptions = exports.defaultEthereumPollingOptions, } = {}) {
         this.logger = logger;
         this.gatewayUrl = gatewayUrl;
         this.pollingOptions = pollingOptions;

package/lib/cjs/common/token/index.js

@@ -24,6 +24,7 @@ const ethereum_js_1 = require("./ethereum.js");
 const kyve_js_1 = require("./kyve.js");
 const polygon_js_1 = require("./polygon.js");
 const solana_js_1 = require("./solana.js");
+const usdc_js_1 = require("./usdc.js");
 exports.defaultTokenMap = {
     arweave: (config) => new arweave_js_1.ArweaveToken(config),
     ario: (config) => new ario_js_1.ARIOToken(config),
@@ -33,8 +34,12 @@ exports.defaultTokenMap = {
     kyve: (config) => new kyve_js_1.KyveToken(config),
     matic: (config) => new polygon_js_1.PolygonToken(config),
     pol: (config) => new polygon_js_1.PolygonToken(config),
+    usdc: (config) => new usdc_js_1.USDCToken({ network: 'ethereum', ...config }),
+    'base-usdc': (config) => new usdc_js_1.USDCToken({ network: 'base', ...config }),
+    'polygon-usdc': (config) => new usdc_js_1.USDCToken({ network: 'polygon', ...config }),
 };
 const ethExponent = 18;
+const usdcExponent = 6;
 exports.exponentMap = {
     arweave: 12,
     ario: 6,
@@ -44,6 +49,9 @@ exports.exponentMap = {
     kyve: 6,
     matic: ethExponent,
     pol: ethExponent,
+    usdc: usdcExponent,
+    'base-usdc': usdcExponent,
+    'polygon-usdc': usdcExponent,
 };
 exports.tokenToBaseMap = {
     arweave: (a) => (0, arweave_js_1.ARToTokenAmount)(a),
@@ -54,6 +62,9 @@ exports.tokenToBaseMap = {
     kyve: (a) => (0, kyve_js_1.KYVEToTokenAmount)(a),
     matic: (a) => (0, polygon_js_1.POLToTokenAmount)(a),
     pol: (a) => (0, polygon_js_1.POLToTokenAmount)(a),
+    usdc: (a) => (0, usdc_js_1.USDCToTokenAmount)(a),
+    'base-usdc': (a) => (0, usdc_js_1.USDCToTokenAmount)(a),
+    'polygon-usdc': (a) => (0, usdc_js_1.USDCToTokenAmount)(a),
 };
 function isTokenType(token) {
     return types_js_1.tokenTypes.includes(token);