@mycelium-sdk/core 1.0.0 → 2.0.0-alpha.0

package/dist/index.js

@@ -1,10 +1,9 @@
 // src/wallet/DefaultSmartWallet.ts
 import {
-  encodeFunctionData,
-  erc20Abi as erc20Abi2,
+  encodeFunctionData as encodeFunctionData2,
+  erc20Abi as erc20Abi3,
   pad
 } from "viem";
-import { toCoinbaseSmartAccount } from "viem/account-abstraction";
 
 // src/abis/smartWalletFactory.ts
 var smartWalletFactoryAbi = [
@@ -231,6 +230,159 @@ function parseAssetAmount(amount, decimals) {
 var SmartWallet = class {
 };
 
+// src/wallet/DefaultSmartWallet.ts
+import { toCoinbaseSmartAccount } from "viem/account-abstraction";
+
+// src/tools/Paymaster.ts
+import { encodeFunctionData, erc20Abi as erc20Abi2, http, maxUint256 } from "viem";
+import "viem/account-abstraction";
+import { createSmartAccountClient } from "permissionless";
+
+// src/constants/paymaster.ts
+var ERC20_PAYMASTER_ADDRESS = "0x6666666666667849c56f2850848ce1c4da65c68b";
+
+// src/tools/Paymaster.ts
+var Paymaster = class {
+  constructor(chainManager) {
+    this.chainManager = chainManager;
+  }
+  /**
+   * Gets paymaster client for the specified chain
+   *
+   * @internal
+   * @category Paymaster
+   * @param chainId Target chain ID
+   * @returns PimlicoClient instance
+   * @throws Error if no paymaster URL is configured
+   */
+  getPaymasterClient(chainId) {
+    return this.chainManager.getPaymasterClient(chainId);
+  }
+  /**
+   * Prepares approval transaction if needed for ERC-20 paymaster
+   *
+   * @internal
+   * @category Paymaster
+   * @param paymasterToken Paymaster token address
+   * @param walletAddress Wallet address
+   * @param chainId Target chain ID
+   * @returns Promise resolving to the approval transaction data or null if allowance exists
+   * @throws Error if no public client is available
+   */
+  async preparePaymasterApproval(paymasterToken, walletAddress, chainId) {
+    const publicClient = this.chainManager.getPublicClient(chainId);
+    const allowance = await publicClient.readContract({
+      address: paymasterToken,
+      abi: erc20Abi2,
+      functionName: "allowance",
+      args: [walletAddress, ERC20_PAYMASTER_ADDRESS]
+    });
+    if (allowance > 0n) {
+      return null;
+    }
+    return {
+      to: paymasterToken,
+      value: 0n,
+      data: encodeFunctionData({
+        abi: erc20Abi2,
+        functionName: "approve",
+        args: [ERC20_PAYMASTER_ADDRESS, maxUint256]
+      })
+    };
+  }
+  /**
+   * Prepares calls array with approval if needed for ERC-20 paymaster
+   *
+   * @internal
+   * @category Paymaster
+   * @param transactionData Transaction data to prepare
+   * @param paymasterToken Paymaster token address
+   * @param walletAddress Wallet address
+   * @param chainId Target chain ID
+   * @returns Prepared calls array with approval if needed
+   * @throws Error if no paymaster URL is configured
+   */
+  async prepareCallsWithApproval(transactionData, paymasterToken, walletAddress, chainId) {
+    const approvalTx = await this.preparePaymasterApproval(paymasterToken, walletAddress, chainId);
+    const calls = Array.isArray(transactionData) ? transactionData : [transactionData];
+    const callsWithApproval = approvalTx ? [approvalTx, ...calls] : calls;
+    return {
+      calls: callsWithApproval,
+      paymasterContext: {
+        token: paymasterToken
+      }
+    };
+  }
+  /**
+   * Creates a SmartAccountClient configured with ERC-20 paymaster
+   *
+   * @internal
+   * @category Paymaster
+   * @param account Coinbase smart account
+   * @param chainId Target chain ID
+   * @returns SmartAccountClient instance
+   * @throws Error if no bundler URL is configured
+   */
+  createSmartAccountClient(account, chainId) {
+    const pimlicoClient = this.getPaymasterClient(chainId);
+    if (!pimlicoClient) {
+      throw new Error(
+        "Paymaster client is not available. Probably the paymaster URL is not configured for this chain"
+      );
+    }
+    const chain = this.chainManager.getChain(chainId);
+    const bundlerUrl = this.chainManager.getBundlerUrl(chainId);
+    if (!bundlerUrl) {
+      throw new Error(`Bundler URL not configured for chain ID: ${chainId}`);
+    }
+    return createSmartAccountClient({
+      account,
+      chain,
+      bundlerTransport: http(bundlerUrl),
+      paymaster: pimlicoClient,
+      userOperation: {
+        estimateFeesPerGas: async () => {
+          const gasPrice = await pimlicoClient.getUserOperationGasPrice();
+          const bump = (value, pct = 20n) => value + value * pct / 100n;
+          return {
+            maxFeePerGas: bump(gasPrice.fast.maxFeePerGas),
+            maxPriorityFeePerGas: bump(gasPrice.fast.maxPriorityFeePerGas)
+          };
+        }
+      }
+    });
+  }
+  /**
+   * Sends transaction(s) with ERC-20 paymaster
+   *
+   * @internal
+   * @category Paymaster
+   * @param transactionData Transaction data to send
+   * @param account Coinbase smart account
+   * @param walletAddress Wallet address
+   * @param chainId Target chain ID
+   * @param paymasterToken Paymaster token address
+   * @returns Promise resolving to the transaction hash
+   */
+  async sendWithERC20Paymaster(transactionData, account, walletAddress, chainId, paymasterToken) {
+    const smartAccountClient = this.createSmartAccountClient(account, chainId);
+    const { calls, paymasterContext } = await this.prepareCallsWithApproval(
+      transactionData,
+      paymasterToken,
+      walletAddress,
+      chainId
+    );
+    return smartAccountClient.sendTransaction({
+      calls: calls.map((call) => ({
+        to: call.to,
+        data: call.data,
+        value: call.value ?? 0n
+      })),
+      paymasterContext
+    });
+  }
+};
+
 // src/wallet/DefaultSmartWallet.ts
 var DefaultSmartWallet = class extends SmartWallet {
   /**
@@ -247,6 +399,7 @@ var DefaultSmartWallet = class extends SmartWallet {
    */
   constructor(owners, signer, chainManager, protocolProvider, coinbaseCDP, deploymentAddress, signerOwnerIndex, nonce) {
     super();
+    this.bumpGasLimits = (x, pct = 40n) => x + x * pct / 100n;
     this.owners = owners;
     this._signer = signer;
     this.signerOwnerIndex = signerOwnerIndex;
@@ -255,6 +408,7 @@ var DefaultSmartWallet = class extends SmartWallet {
     this.nonce = nonce;
     this.protocolProvider = protocolProvider;
     this.coinbaseCDP = coinbaseCDP;
+    this.paymaster = new Paymaster(this.chainManager);
   }
   /**
    * Returns the signer account for this smart wallet
@@ -387,14 +541,25 @@ var DefaultSmartWallet = class extends SmartWallet {
      *
      * @param transactionData Transaction details (`to`, `value`, `data`)
      * @param chainId Target chain ID
+     * @param options Optional parameters
+     * @param options.paymasterToken ERC-20 token address to use for gas payment (e.g., USDC)
      * @returns Promise that resolves to the UserOperation hash
      * @throws Error with a readable message if submission or inclusion fails
      */
-  async send(transactionData, chainId) {
+  async send(transactionData, chainId, options) {
     try {
       const account = await this.getCoinbaseSmartAccount(chainId);
+      if (options?.paymasterToken) {
+        const walletAddress = await this.getAddress();
+        return this.paymaster.sendWithERC20Paymaster(
+          transactionData,
+          account,
+          walletAddress,
+          chainId,
+          options.paymasterToken
+        );
+      }
       const bundlerClient = this.chainManager.getBundlerClient(chainId, account);
-      const bump = (x, pct = 40n) => x + x * pct / 100n;
       const gas = await bundlerClient.estimateUserOperationGas({
         account,
         calls: [transactionData]
@@ -402,9 +567,9 @@ var DefaultSmartWallet = class extends SmartWallet {
       const hash = await bundlerClient.sendUserOperation({
         account,
         calls: [transactionData],
-        callGasLimit: bump(gas.callGasLimit),
-        verificationGasLimit: bump(gas.verificationGasLimit),
-        preVerificationGas: bump(gas.preVerificationGas)
+        callGasLimit: this.bumpGasLimits(gas.callGasLimit),
+        verificationGasLimit: this.bumpGasLimits(gas.verificationGasLimit),
+        preVerificationGas: this.bumpGasLimits(gas.preVerificationGas)
       });
       await bundlerClient.waitForUserOperationReceipt({
         hash
@@ -424,14 +589,25 @@ var DefaultSmartWallet = class extends SmartWallet {
    *
    * @param transactionData An array of calls to execute
    * @param chainId Target chain ID
+   * @param options Optional parameters
+   * @param options.paymasterToken ERC-20 token address to use for gas payment (e.g., USDC)
    * @returns Promise that resolves to the UserOperation hash for the batch
    * @throws Error with a readable message if submission or inclusion fails
    */
-  async sendBatch(transactionData, chainId) {
+  async sendBatch(transactionData, chainId, options) {
     try {
       const account = await this.getCoinbaseSmartAccount(chainId);
+      if (options?.paymasterToken) {
+        const walletAddress = await this.getAddress();
+        return this.paymaster.sendWithERC20Paymaster(
+          transactionData,
+          account,
+          walletAddress,
+          chainId,
+          options.paymasterToken
+        );
+      }
       const bundlerClient = this.chainManager.getBundlerClient(chainId, account);
-      const bump = (x, pct = 40n) => x + x * pct / 100n;
       const gas = await bundlerClient.estimateUserOperationGas({
         account,
         calls: transactionData
@@ -439,9 +615,9 @@ var DefaultSmartWallet = class extends SmartWallet {
       const hash = await bundlerClient.sendUserOperation({
         account,
         calls: transactionData,
-        callGasLimit: bump(gas.callGasLimit),
-        verificationGasLimit: bump(gas.verificationGasLimit),
-        preVerificationGas: bump(gas.preVerificationGas)
+        callGasLimit: this.bumpGasLimits(gas.callGasLimit),
+        verificationGasLimit: this.bumpGasLimits(gas.verificationGasLimit),
+        preVerificationGas: this.bumpGasLimits(gas.preVerificationGas)
       });
       await bundlerClient.waitForUserOperationReceipt({
         hash
@@ -558,8 +734,8 @@ var DefaultSmartWallet = class extends SmartWallet {
     }
     const resolvedAsset = resolveAsset(asset, chainId);
     const parsedAmount = parseAssetAmount(amount, resolvedAsset.decimals);
-    const transferData = encodeFunctionData({
-      abi: erc20Abi2,
+    const transferData = encodeFunctionData2({
+      abi: erc20Abi3,
       functionName: "transfer",
       args: [recipientAddress, parsedAmount]
     });
@@ -608,10 +784,12 @@ var FundingNamespace = class {
 };
 
 // src/tools/ChainManager.ts
-import { createPublicClient, http } from "viem";
+import { createPublicClient, http as http2 } from "viem";
 import {
-  createBundlerClient
+  createBundlerClient,
+  entryPoint07Address
 } from "viem/account-abstraction";
+import { createPimlicoClient } from "permissionless/clients/pimlico";
 
 // src/constants/chains.ts
 import { base as base2, baseSepolia as baseSepolia2 } from "viem/chains";
@@ -692,12 +870,12 @@ var ChainManager = class {
     }
     const client = createPublicClient({
       chain: this.getChain(chainId),
-      transport: http(rpcUrl)
+      transport: http2(rpcUrl)
     });
     return createBundlerClient({
       account,
       client,
-      transport: http(bundlerUrl),
+      transport: http2(bundlerUrl),
       chain: this.getChain(chainId)
     });
   }
@@ -777,10 +955,53 @@ var ChainManager = class {
     const chainObject = chainById[chain.chainId];
     const client = createPublicClient({
       chain: chainObject,
-      transport: http(chain.rpcUrl)
+      transport: http2(chain.rpcUrl)
     });
     return client;
   }
+  /**
+   * Returns the paymaster URL for the given chain ID
+   *
+   * @internal
+   * @category URLs
+   * @param chainId Target chain ID
+   * @returns Paymaster URL string
+   * @throws Error if chain config is missing or URL is invalid
+   */
+  getPaymasterUrl(chainId) {
+    const chainConfig = this.chainConfigs;
+    if (!chainConfig) {
+      throw new Error(`No chain config found for chain ID: ${chainId}`);
+    }
+    if (chainConfig.paymasterUrl && !this.isValidUrl(chainConfig.paymasterUrl)) {
+      throw new Error(`Invalid paymaster URL for chain ID: ${chainId}`);
+    }
+    return chainConfig.paymasterUrl || "";
+  }
+  /**
+   * Creates a {@link PimlicoClient} for the given chain ID
+   *
+   * @internal
+   * @category Clients
+   * @param chainId Target chain ID
+   * @returns PimlicoClient instance
+   * @throws Error if no paymaster URL is configured
+   */
+  getPaymasterClient(chainId) {
+    const paymasterUrl = this.getPaymasterUrl(chainId);
+    if (!paymasterUrl) {
+      throw new Error(`No paymaster URL configured for chain ID: ${chainId}`);
+    }
+    const chain = this.getChain(chainId);
+    return createPimlicoClient({
+      chain,
+      transport: http2(paymasterUrl),
+      entryPoint: {
+        address: entryPoint07Address,
+        version: "0.7"
+      }
+    });
+  }
 };
 
 // src/wallet/WalletNamespace.ts
@@ -1212,7 +1433,7 @@ import { getAddress } from "viem";
 import { createViemAccount } from "@privy-io/server-auth/viem";
 import {
   createWalletClient,
-  http as http2
+  http as http3
 } from "viem";
 import { unichain as unichain2 } from "viem/chains";
 
@@ -1402,7 +1623,7 @@ var PrivyWallet = class extends EmbeddedWallet {
     return createWalletClient({
       account,
       chain: this.chainManager.getChain(chainId),
-      transport: http2(this.chainManager.getRpcUrl(chainId))
+      transport: http3(this.chainManager.getRpcUrl(chainId))
     });
   }
   /**
@@ -1612,9 +1833,9 @@ import { PrivyClient } from "@privy-io/server-auth";
 
 // src/protocols/base/BaseProtocol.ts
 import {
-  erc20Abi as erc20Abi3,
+  erc20Abi as erc20Abi4,
   createWalletClient as createWalletClient2,
-  http as http3,
+  http as http4,
   parseGwei
 } from "viem";
 var BaseProtocol = class {
@@ -1641,11 +1862,11 @@ var BaseProtocol = class {
     const walletClient = createWalletClient2({
       account,
       chain: this.chainManager.getChain(chainId),
-      transport: http3(this.chainManager.getRpcUrl(chainId))
+      transport: http4(this.chainManager.getRpcUrl(chainId))
     });
     const hash = await walletClient.writeContract({
       address: tokenAddress,
-      abi: erc20Abi3,
+      abi: erc20Abi4,
       functionName: "approve",
       args: [spenderAddress, amount],
       gas: 100000n,
@@ -1667,7 +1888,7 @@ var BaseProtocol = class {
     const publicClient = this.chainManager.getPublicClient(chainId);
     return await publicClient.readContract({
       address: tokenAddress,
-      abi: erc20Abi3,
+      abi: erc20Abi4,
       functionName: "allowance",
       args: [walletAddress, spenderAddress]
     });
@@ -1675,7 +1896,7 @@ var BaseProtocol = class {
 };
 
 // src/protocols/implementations/SparkProtocol.ts
-import { encodeFunctionData as encodeFunctionData2, erc20Abi as erc20Abi4, formatUnits as formatUnits2, parseUnits as parseUnits2 } from "viem";
+import { encodeFunctionData as encodeFunctionData3, erc20Abi as erc20Abi5, formatUnits as formatUnits2, parseUnits as parseUnits2 } from "viem";
 
 // src/abis/protocols/spark.ts
 var SPARK_VAULT_ABI = [
@@ -1835,8 +2056,8 @@ var SparkProtocol = class extends BaseProtocol {
     if (allowance < assets) {
       ops.push({
         to: vaultInfo.tokenAddress,
-        data: encodeFunctionData2({
-          abi: erc20Abi4,
+        data: encodeFunctionData3({
+          abi: erc20Abi5,
           functionName: "approve",
           args: [vaultInfo.vaultAddress, assets]
         })
@@ -1844,7 +2065,7 @@ var SparkProtocol = class extends BaseProtocol {
     }
     ops.push({
       to: vaultInfo.vaultAddress,
-      data: encodeFunctionData2({
+      data: encodeFunctionData3({
         abi: SPARK_VAULT_ABI,
         functionName: "deposit",
         args: [assets, owner]
@@ -1868,7 +2089,7 @@ var SparkProtocol = class extends BaseProtocol {
       const assets = parseUnits2(amount, vaultInfo.tokenDecimals);
       withdrawData = {
         to: vaultInfo.vaultAddress,
-        data: encodeFunctionData2({
+        data: encodeFunctionData3({
           abi: SPARK_VAULT_ABI,
           functionName: "withdraw",
           args: [assets, owner, owner]
@@ -1878,7 +2099,7 @@ var SparkProtocol = class extends BaseProtocol {
       const maxShares = await this.getMaxRedeemableShares(vaultInfo, owner);
       withdrawData = {
         to: vaultInfo.vaultAddress,
-        data: encodeFunctionData2({
+        data: encodeFunctionData3({
           abi: SPARK_VAULT_ABI,
           functionName: "redeem",
           args: [maxShares, owner, owner]
@@ -1949,7 +2170,7 @@ var availableProtocols = [
       name: "Spark",
       website: "https://spark.fi/",
       logo: "/logos/spark.png",
-      supportedChains: [8453],
+      supportedChains: [8453, 84532],
       riskLevel: "low",
       isActive: true
     },
@@ -1958,7 +2179,7 @@ var availableProtocols = [
 ];
 
 // src/protocols/implementations/ProxyProtocol.ts
-import { encodeFunctionData as encodeFunctionData3, erc20Abi as erc20Abi5, parseUnits as parseUnits3 } from "viem";
+import { encodeFunctionData as encodeFunctionData4, erc20Abi as erc20Abi6, parseUnits as parseUnits3 } from "viem";
 var ProxyProtocol = class extends BaseProtocol {
   /**
    * Initialize the Spark protocol with the provided chain manager
@@ -2060,8 +2281,8 @@ var ProxyProtocol = class extends BaseProtocol {
     if (allowance < rawDepositAmount) {
       const approveData = {
         to: depositTokenAddress,
-        data: encodeFunctionData3({
-          abi: erc20Abi5,
+        data: encodeFunctionData4({
+          abi: erc20Abi6,
           functionName: "approve",
           args: [vaultAddress, rawDepositAmount]
         })
@@ -2459,7 +2680,7 @@ var ProtocolsNamespace = class {
 };
 
 // src/constants/general.ts
-var BACKEND_HOSTNAME = process.env.NODE_ENV === "dev" ? "http://localhost:3000" : "https://mycelium-cloud-production.up.railway.app";
+var BACKEND_HOSTNAME = process.env.NODE_ENV === "dev" ? "http://localhost:3000" : "https://staging.mycelium.sh";
 
 // src/tools/ApiClient.ts
 import axios2 from "axios";
@@ -2689,7 +2910,8 @@ var MyceliumSDK = class _MyceliumSDK {
           chain: {
             chainId: config.chainId || backendConfig.chainId,
             rpcUrl: backendConfig.rpcUrl,
-            bundlerUrl: backendConfig.bundlerUrl
+            bundlerUrl: backendConfig.bundlerUrl,
+            paymasterUrl: backendConfig.paymasterUrl
           },
           protocolsSecurityConfig: config.protocolsSecurityConfig,
           coinbaseCDPConfig: {