@arcenpay/react 0.0.1

package/dist/zerodev.js

@@ -0,0 +1,420 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/zerodev.ts
+var zerodev_exports = {};
+__export(zerodev_exports, {
+  cancelSubscription: () => cancelSubscription,
+  deploySmartAccount: () => deploySmartAccount,
+  isRecoverableSmartAccountFundingError: () => isRecoverableSmartAccountFundingError,
+  revokeAutopayModule: () => revokeAutopayModule,
+  sendSmartAccountTransaction: () => sendSmartAccountTransaction,
+  updateAutopayConfig: () => updateAutopayConfig
+});
+module.exports = __toCommonJS(zerodev_exports);
+
+// src/lib/zerodev.ts
+var import_sdk = require("@zerodev/sdk");
+var import_ecdsa_validator = require("@zerodev/ecdsa-validator");
+var import_viem = require("viem");
+var import_chains = require("viem/chains");
+var import_sdk2 = require("@arcenpay/sdk");
+var CHAIN_MAP = {
+  11155111: import_chains.sepolia,
+  84532: import_chains.baseSepolia,
+  8453: import_chains.base
+};
+var ENTRY_POINT = import_sdk.constants.getEntryPoint("0.7");
+var ENTRY_POINT_ADDRESS = ENTRY_POINT.address;
+var KERNEL_VERSION = import_sdk.constants.KERNEL_V3_1;
+function getZeroDevChainLabel(chainId) {
+  if (chainId === 84532) return "Base Sepolia";
+  if (chainId === 8453) return "Base";
+  if (chainId === 11155111) return "Sepolia";
+  return `Chain ${chainId}`;
+}
+function resolveZeroDevUrls(params) {
+  const specificUnified = process.env[`NEXT_PUBLIC_ZERODEV_RPC_${params.chainId}`];
+  const specificBundler = process.env[`NEXT_PUBLIC_ZERODEV_BUNDLER_RPC_${params.chainId}`];
+  const specificPaymaster = process.env[`NEXT_PUBLIC_ZERODEV_PAYMASTER_RPC_${params.chainId}`];
+  const genericUnified = process.env.NEXT_PUBLIC_ZERODEV_RPC;
+  const genericBundler = process.env.NEXT_PUBLIC_ZERODEV_BUNDLER_RPC;
+  const genericPaymaster = process.env.NEXT_PUBLIC_ZERODEV_PAYMASTER_RPC;
+  const defaultUnifiedV3 = `https://rpc.zerodev.app/api/v3/${params.projectId}/chain/${params.chainId}`;
+  const hasConfiguredUrls = !!(params.bundlerUrl || params.paymasterUrl || specificUnified || specificBundler || specificPaymaster || genericUnified || genericBundler || genericPaymaster);
+  return {
+    bundlerUrl: params.bundlerUrl || specificUnified || specificBundler || genericUnified || genericBundler || defaultUnifiedV3 || `https://rpc.zerodev.app/api/v2/bundler/${params.projectId}`,
+    paymasterUrl: params.paymasterUrl || specificUnified || specificPaymaster || genericUnified || genericPaymaster || defaultUnifiedV3 || `https://rpc.zerodev.app/api/v2/paymaster/${params.projectId}`,
+    hasConfiguredUrls
+  };
+}
+function normalizeZeroDevError(error, params) {
+  const message = error instanceof Error ? error.message : String(error ?? "");
+  const chainLabel = getZeroDevChainLabel(params.chainId);
+  const usingDefaultUrls = !params.hasConfiguredUrls;
+  if (message.includes("ChainId not found")) {
+    const nextStep = usingDefaultUrls ? `Enable ${chainLabel} for ZeroDev project ${params.projectId}, or set NEXT_PUBLIC_ZERODEV_BUNDLER_RPC_${params.chainId} and NEXT_PUBLIC_ZERODEV_PAYMASTER_RPC_${params.chainId} to chain-specific endpoints.` : `The configured ZeroDev endpoint does not recognize ${chainLabel} for project ${params.projectId}. Verify the project supports chain ${params.chainId} or replace the override URLs. Bundler URL: ${params.bundlerUrl ?? "n/a"}. Paymaster URL: ${params.paymasterUrl ?? "n/a"}.`;
+    return new Error(
+      `ZeroDev project ${params.projectId} is not configured for ${chainLabel} (chain ${params.chainId}). ${nextStep}`
+    );
+  }
+  return error instanceof Error ? error : new Error(message);
+}
+function isRecoverableSmartAccountFundingError(error) {
+  const message = error instanceof Error ? error.message : String(error ?? "");
+  const lower = message.toLowerCase();
+  return lower.includes("smart account does not have sufficient funds") || lower.includes("sufficient funds to execute the user operation") || lower.includes("insufficient funds") || lower.includes("user operation") && lower.includes("paymaster");
+}
+async function createKernelExecutionContext(config) {
+  const chain = CHAIN_MAP[config.chainId] || import_chains.baseSepolia;
+  const { bundlerUrl, paymasterUrl, hasConfiguredUrls } = resolveZeroDevUrls({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+  const publicClient = (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)()
+  });
+  const ecdsaValidator = await (0, import_ecdsa_validator.signerToEcdsaValidator)(publicClient, {
+    signer: config.walletClient,
+    entryPoint: ENTRY_POINT,
+    kernelVersion: KERNEL_VERSION
+  });
+  const kernelAccount = await (0, import_sdk.createKernelAccount)(publicClient, {
+    plugins: { sudo: ecdsaValidator },
+    entryPoint: ENTRY_POINT,
+    kernelVersion: KERNEL_VERSION
+  });
+  const paymasterClient = (0, import_sdk.createZeroDevPaymasterClient)({
+    chain,
+    transport: (0, import_viem.http)(paymasterUrl)
+  });
+  const kernelClient = (0, import_sdk.createKernelAccountClient)({
+    account: kernelAccount,
+    chain,
+    bundlerTransport: (0, import_viem.http)(bundlerUrl),
+    middleware: {
+      sponsorUserOperation: async ({ userOperation }) => {
+        return paymasterClient.sponsorUserOperation({
+          userOperation,
+          entryPoint: ENTRY_POINT_ADDRESS
+        });
+      }
+    }
+  });
+  return {
+    publicClient,
+    kernelAccount,
+    kernelClient,
+    bundlerUrl,
+    paymasterUrl,
+    hasConfiguredUrls
+  };
+}
+async function deploySmartAccount(config) {
+  const chain = CHAIN_MAP[config.chainId] || import_chains.baseSepolia;
+  const contracts = (0, import_sdk2.getContractAddresses)(config.chainId);
+  const { bundlerUrl, paymasterUrl, hasConfiguredUrls } = resolveZeroDevUrls({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+  const publicClient = (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)()
+  });
+  const ecdsaValidator = await (0, import_ecdsa_validator.signerToEcdsaValidator)(publicClient, {
+    signer: config.walletClient,
+    entryPoint: ENTRY_POINT,
+    kernelVersion: KERNEL_VERSION
+  });
+  const kernelAccount = await (0, import_sdk.createKernelAccount)(publicClient, {
+    plugins: {
+      sudo: ecdsaValidator
+    },
+    entryPoint: ENTRY_POINT,
+    kernelVersion: KERNEL_VERSION
+  });
+  const smartAccountAddress = kernelAccount.address;
+  const code = await publicClient.getCode({ address: smartAccountAddress });
+  const alreadyDeployed = !!code && code !== "0x";
+  const paymasterClient = (0, import_sdk.createZeroDevPaymasterClient)({
+    chain,
+    transport: (0, import_viem.http)(paymasterUrl)
+  });
+  const kernelClient = (0, import_sdk.createKernelAccountClient)({
+    account: kernelAccount,
+    chain,
+    bundlerTransport: (0, import_viem.http)(bundlerUrl),
+    middleware: {
+      sponsorUserOperation: async ({ userOperation }) => {
+        return paymasterClient.sponsorUserOperation({
+          userOperation,
+          entryPoint: ENTRY_POINT_ADDRESS
+        });
+      }
+    }
+  });
+  let installTxHash;
+  if (contracts.autopayModule) {
+    try {
+      const initialized = await publicClient.readContract({
+        address: contracts.autopayModule,
+        abi: import_sdk2.ERC7579AutopayModuleABI,
+        functionName: "isInitialized",
+        args: [smartAccountAddress]
+      });
+      if (initialized) {
+        console.log(
+          `[ZeroDev] AutopayModule already initialized for ${smartAccountAddress}`
+        );
+        return {
+          smartAccountAddress,
+          installTxHash,
+          alreadyDeployed
+        };
+      }
+      const installData = (0, import_viem.encodeFunctionData)({
+        abi: [
+          {
+            type: "function",
+            name: "installModule",
+            inputs: [
+              { name: "moduleType", type: "uint256" },
+              { name: "module", type: "address" },
+              { name: "initData", type: "bytes" }
+            ],
+            outputs: [],
+            stateMutability: "nonpayable"
+          }
+        ],
+        functionName: "installModule",
+        args: [
+          2n,
+          // Module type 2 = Executor
+          contracts.autopayModule,
+          "0x"
+          // Empty init data
+        ]
+      });
+      installTxHash = await kernelClient.sendTransaction({
+        to: smartAccountAddress,
+        data: installData,
+        value: 0n
+      });
+      console.log(
+        `[ZeroDev] AutopayModule installed on ${smartAccountAddress} \u2014 tx: ${installTxHash}`
+      );
+    } catch (err) {
+      if (err?.message?.includes("already installed") || err?.message?.includes("AlreadyInitialized")) {
+        console.log(
+          `[ZeroDev] AutopayModule already installed on ${smartAccountAddress}`
+        );
+      } else {
+        const normalizedError = normalizeZeroDevError(err, {
+          projectId: config.projectId,
+          chainId: config.chainId,
+          bundlerUrl,
+          paymasterUrl,
+          hasConfiguredUrls
+        });
+        if (isRecoverableSmartAccountFundingError(normalizedError)) {
+          console.warn(
+            "[ZeroDev] Module installation needs prefund or sponsorship; callers may fall back to the connected wallet:",
+            normalizedError.message
+          );
+        } else {
+          console.error("[ZeroDev] Module installation failed:", normalizedError.message);
+        }
+        throw normalizedError;
+      }
+    }
+  }
+  return {
+    smartAccountAddress,
+    installTxHash,
+    alreadyDeployed
+  };
+}
+async function revokeAutopayModule(config) {
+  const chain = CHAIN_MAP[config.chainId] || import_chains.baseSepolia;
+  const contracts = (0, import_sdk2.getContractAddresses)(config.chainId);
+  if (!contracts.autopayModule) {
+    throw new Error("Autopay module address not configured for this chain.");
+  }
+  const { bundlerUrl, paymasterUrl, hasConfiguredUrls } = resolveZeroDevUrls({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+  const publicClient = (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)()
+  });
+  const initialized = await publicClient.readContract({
+    address: contracts.autopayModule,
+    abi: import_sdk2.ERC7579AutopayModuleABI,
+    functionName: "isInitialized",
+    args: [config.smartAccountAddress]
+  });
+  if (!initialized) {
+    return { alreadyRevoked: true };
+  }
+  const { kernelAccount, kernelClient } = await createKernelExecutionContext({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    walletClient: config.walletClient,
+    bundlerUrl,
+    paymasterUrl
+  });
+  if (kernelAccount.address.toLowerCase() !== config.smartAccountAddress.toLowerCase()) {
+    throw new Error(
+      `Kernel account mismatch. Expected ${config.smartAccountAddress}, got ${kernelAccount.address}.`
+    );
+  }
+  const revokeData = (0, import_viem.encodeFunctionData)({
+    abi: import_sdk2.ERC7579AutopayModuleABI,
+    functionName: "onUninstall",
+    args: ["0x"]
+  });
+  try {
+    const txHash = await kernelClient.sendTransaction({
+      to: contracts.autopayModule,
+      data: revokeData,
+      value: 0n
+    });
+    return { txHash, alreadyRevoked: false };
+  } catch (error) {
+    throw normalizeZeroDevError(error, {
+      projectId: config.projectId,
+      chainId: config.chainId,
+      bundlerUrl,
+      paymasterUrl,
+      hasConfiguredUrls
+    });
+  }
+}
+async function sendSmartAccountTransaction(config) {
+  const {
+    publicClient,
+    kernelAccount,
+    kernelClient,
+    bundlerUrl,
+    paymasterUrl,
+    hasConfiguredUrls
+  } = await createKernelExecutionContext({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    walletClient: config.walletClient,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+  if (config.smartAccountAddress && kernelAccount.address.toLowerCase() !== config.smartAccountAddress.toLowerCase()) {
+    throw new Error(
+      `Kernel account mismatch. Expected ${config.smartAccountAddress}, got ${kernelAccount.address}.`
+    );
+  }
+  try {
+    const txHash = await kernelClient.sendTransaction({
+      to: config.to,
+      data: config.data,
+      value: config.value ?? 0n
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return {
+      smartAccountAddress: kernelAccount.address,
+      txHash
+    };
+  } catch (error) {
+    throw normalizeZeroDevError(error, {
+      projectId: config.projectId,
+      chainId: config.chainId,
+      bundlerUrl,
+      paymasterUrl,
+      hasConfiguredUrls
+    });
+  }
+}
+async function updateAutopayConfig(config) {
+  const contracts = (0, import_sdk2.getContractAddresses)(config.chainId);
+  if (!contracts.autopayModule) {
+    throw new Error("Autopay module address is not configured for this chain.");
+  }
+  const data = (0, import_viem.encodeFunctionData)({
+    abi: import_sdk2.ERC7579AutopayModuleABI,
+    functionName: "updateConfig",
+    args: [
+      {
+        merchant: config.merchant,
+        maxAmount: config.maxAmount,
+        token: config.token,
+        interval: config.interval,
+        startTime: config.startTime,
+        planId: config.planId,
+        maxTotalAmount: config.maxTotalAmount ?? 0n
+      }
+    ]
+  });
+  return sendSmartAccountTransaction({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    walletClient: config.walletClient,
+    smartAccountAddress: config.smartAccountAddress,
+    to: contracts.autopayModule,
+    data,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+}
+async function cancelSubscription(config) {
+  const contracts = (0, import_sdk2.getContractAddresses)(config.chainId);
+  if (!contracts.subscriptionRegistry) {
+    throw new Error(
+      "Subscription registry address is not configured for this chain."
+    );
+  }
+  const data = (0, import_viem.encodeFunctionData)({
+    abi: import_sdk2.SubscriptionRegistryABI,
+    functionName: "cancelSubscription",
+    args: [config.tokenId]
+  });
+  return sendSmartAccountTransaction({
+    projectId: config.projectId,
+    chainId: config.chainId,
+    walletClient: config.walletClient,
+    smartAccountAddress: config.smartAccountAddress,
+    to: contracts.subscriptionRegistry,
+    data,
+    bundlerUrl: config.bundlerUrl,
+    paymasterUrl: config.paymasterUrl
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cancelSubscription,
+  deploySmartAccount,
+  isRecoverableSmartAccountFundingError,
+  revokeAutopayModule,
+  sendSmartAccountTransaction,
+  updateAutopayConfig
+});

package/dist/zerodev.mjs

@@ -0,0 +1,17 @@
+import {
+  cancelSubscription,
+  deploySmartAccount,
+  isRecoverableSmartAccountFundingError,
+  revokeAutopayModule,
+  sendSmartAccountTransaction,
+  updateAutopayConfig
+} from "./chunk-LACDYDLO.mjs";
+import "./chunk-X2BMVUAF.mjs";
+export {
+  cancelSubscription,
+  deploySmartAccount,
+  isRecoverableSmartAccountFundingError,
+  revokeAutopayModule,
+  sendSmartAccountTransaction,
+  updateAutopayConfig
+};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@arcenpay/react",
+  "version": "0.0.1",
+  "description": "ArcenPay SDK — React components for Web3 subscription billing",
+  "license": "UNLICENSED",
+  "homepage": "https://app.arcenpay.com",
+  "keywords": [
+    "arcenpay",
+    "react",
+    "web3",
+    "subscriptions",
+    "billing",
+    "wagmi"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "typings": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.mjs"
+    },
+    "./zerodev": {
+      "types": "./dist/zerodev.d.ts",
+      "import": "./dist/zerodev.mjs",
+      "require": "./dist/zerodev.js",
+      "default": "./dist/zerodev.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/zerodev.ts --clean --format cjs,esm --dts --dts-resolve --external react --external @zerodev/sdk --external @zerodev/ecdsa-validator",
+    "dev": "tsup src/index.ts src/zerodev.ts --clean --format cjs,esm --dts --external react --external @zerodev/sdk --external @zerodev/ecdsa-validator --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "@zerodev/sdk": "^5.0.0",
+    "@zerodev/ecdsa-validator": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@zerodev/sdk": {
+      "optional": true
+    },
+    "@zerodev/ecdsa-validator": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@arcenpay/sdk": "0.0.1",
+    "@tanstack/react-query": "^5.62.0",
+    "viem": "^2.21.0",
+    "wagmi": "^2.14.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@zerodev/ecdsa-validator": "^5.4.9",
+    "@zerodev/sdk": "^5.5.7",
+    "react": "^19.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}