@getpara/aa-biconomy 2.16.0

package/dist/action.d.ts

@@ -0,0 +1,21 @@
+import type { MeeClient } from '@biconomy/abstractjs';
+import type { SmartAccount4337, SmartAccount7702 } from '@getpara/viem-v2-integration';
+import type { CreateBiconomySmartAccountParams } from './types.js';
+export type { CreateBiconomySmartAccountParams } from './types.js';
+/**
+ * Creates a Biconomy MEE smart account using Para for signing.
+ *
+ * Uses the @biconomy/abstractjs SDK with toMultichainNexusAccount and createMeeClient.
+ * Transactions are executed via MEE's getQuote + executeQuote flow which handles
+ * gas sponsorship and cross-chain orchestration.
+ *
+ * @param params - Configuration parameters
+ * @returns Unified SmartAccount interface wrapping Biconomy MEE client, or null if no EVM wallet exists
+ */
+export declare function createBiconomySmartAccount(params: CreateBiconomySmartAccountParams & {
+    mode: '7702';
+}): Promise<SmartAccount7702<MeeClient> | null>;
+export declare function createBiconomySmartAccount(params: CreateBiconomySmartAccountParams & {
+    mode?: '4337';
+}): Promise<SmartAccount4337<MeeClient> | null>;
+export declare function createBiconomySmartAccount(params: CreateBiconomySmartAccountParams): Promise<SmartAccount4337<MeeClient> | SmartAccount7702<MeeClient> | null>;

package/dist/action.js

@@ -0,0 +1,116 @@
+import {
+  createMeeClient,
+  toMultichainNexusAccount,
+  getMEEVersion,
+  MEEVersion,
+  getDefaultMEENetworkUrl,
+  getDefaultMeeGasTank
+} from "@biconomy/abstractjs";
+import { createParaAccount } from "@getpara/viem-v2-integration";
+import { SmartAccountError, wrapProviderError, resolveWalletIdentifier } from "@getpara/viem-v2-integration";
+import { http } from "viem";
+const TESTNET_MEE_NETWORK_API_KEY = "mee_3Zmc7H6Pbd5wUfUGu27aGzdf";
+async function createBiconomySmartAccount(params) {
+  const { para, chain, rpcUrl, meeUrl, apiKey, mode = "4337" } = params;
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  const viemAccount = createParaAccount(para, walletAddress);
+  const isTestnet = chain.testnet;
+  const resolvedUrl = meeUrl || (isTestnet ? getDefaultMEENetworkUrl(true) : void 0);
+  const resolvedApiKey = isTestnet ? TESTNET_MEE_NETWORK_API_KEY : apiKey;
+  const chainConfig = {
+    chain,
+    transport: http(rpcUrl),
+    version: getMEEVersion(MEEVersion.V2_1_0),
+    ...mode === "7702" && { accountAddress: viemAccount.address }
+  };
+  const mcNexus = await toMultichainNexusAccount({
+    signer: viemAccount,
+    chainConfigurations: [chainConfig]
+  });
+  const chainId = chain.id;
+  const needsDelegation = mode === "7702" && !await mcNexus.isDelegated();
+  if (needsDelegation) {
+    for (const dep of mcNexus.deployments) {
+      dep.isDeployed = async () => false;
+    }
+  }
+  const meeClient = await createMeeClient({
+    account: mcNexus,
+    url: resolvedUrl,
+    apiKey: resolvedApiKey
+  });
+  const deployment = meeClient.account.deployments.find(
+    (d) => (d.chainId ?? d.chain?.id) === chainId
+  );
+  const accountAddress = deployment?.address ?? meeClient.account.deployments[0]?.address;
+  if (!accountAddress) {
+    throw new SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: "Unable to determine account address from Biconomy MEE client",
+      provider: "BICONOMY"
+    });
+  }
+  const sponsorshipConfig = {
+    sponsorship: true,
+    sponsorshipOptions: {
+      gasTank: isTestnet ? getDefaultMeeGasTank(isTestnet) : void 0,
+      url: meeUrl || (isTestnet ? getDefaultMEENetworkUrl(isTestnet) : void 0),
+      ...apiKey ? { apiKey } : {}
+    }
+  };
+  const sendBatchTransaction = async (calls) => {
+    const quoteParams = {
+      instructions: [
+        {
+          calls: calls.map((c) => ({
+            to: c.to,
+            value: c.value || BigInt(0),
+            data: c.data || "0x"
+          })),
+          chainId
+        }
+      ],
+      ...sponsorshipConfig,
+      ...needsDelegation ? { delegate: true, multichain7702Auth: true } : {}
+    };
+    try {
+      const quote = await meeClient.getQuote(quoteParams);
+      const { hash } = await meeClient.executeQuote({ quote });
+      const superReceipt = await Promise.race([
+        meeClient.waitForSupertransactionReceipt({
+          hash
+        }),
+        new Promise(
+          (_, reject) => setTimeout(() => reject(new Error("Biconomy supertransaction timed out after 120s")), 12e4)
+        )
+      ]);
+      const receipt = superReceipt.receipts?.[0];
+      if (!receipt) {
+        throw new SmartAccountError({
+          code: "RECEIPT_MISSING",
+          message: "Biconomy supertransaction completed but no on-chain receipt was returned",
+          provider: "BICONOMY"
+        });
+      }
+      return receipt;
+    } catch (error) {
+      throw wrapProviderError(error, "BICONOMY");
+    }
+  };
+  const sendTransaction = async (tx) => sendBatchTransaction([tx]);
+  const resolvedChain = deployment?.chain;
+  return {
+    smartAccountAddress: accountAddress,
+    signer: viemAccount,
+    chain: resolvedChain,
+    mode,
+    provider: "BICONOMY",
+    sendTransaction,
+    sendBatchTransaction,
+    client: meeClient
+  };
+}
+export {
+  createBiconomySmartAccount
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createBiconomySmartAccount } from './action.js';
+export type { BiconomySmartAccountConfig, CreateBiconomySmartAccountParams, UseBiconomySmartAccountParams, } from './types.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+import { createBiconomySmartAccount } from "./action.js";
+export {
+  createBiconomySmartAccount
+};

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+import type { Url } from '@biconomy/abstractjs';
+import type { ChainBasedSmartAccountConfig, CreateSmartAccountParams, SmartAccountModeParam } from '@getpara/viem-v2-integration';
+/**
+ * Configuration for Biconomy smart account.
+ *
+ * Supports both EIP-4337 and EIP-7702 modes. Transactions are executed via
+ * Biconomy's MEE (Multi-chain Execution Environment).
+ *
+ * @example
+ * ```ts
+ * const config: BiconomySmartAccountConfig = {
+ *   chain: baseSepolia,
+ *   apiKey: 'YOUR_BICONOMY_API_KEY',
+ * };
+ * ```
+ */
+export interface BiconomySmartAccountConfig extends ChainBasedSmartAccountConfig, SmartAccountModeParam {
+    /** Optional MEE node URL */
+    meeUrl?: Url;
+    /** MEE API key (required for gas sponsorship) */
+    apiKey: string;
+}
+/**
+ * Parameters for `createBiconomySmartAccount`.
+ * Includes all config fields plus `para` (the Para SDK instance).
+ */
+export type CreateBiconomySmartAccountParams = CreateSmartAccountParams<BiconomySmartAccountConfig>;
+/**
+ * Parameters for the `useBiconomySmartAccount` hook.
+ * Same as {@link BiconomySmartAccountConfig} — `para` is provided automatically via context.
+ */
+export type UseBiconomySmartAccountParams = BiconomySmartAccountConfig;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@getpara/aa-biconomy",
+  "version": "2.16.0",
+  "description": "Biconomy smart account integration for Para",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && yarn typegen && node ./scripts/build.mjs",
+    "typegen": "tsc --emitDeclarationOnly --outDir dist",
+    "test": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@biconomy/abstractjs": "1.1.21",
+    "@getpara/viem-v2-integration": "2.16.0",
+    "@safe-global/types-kit": "^3.0.0"
+  },
+  "peerDependencies": {
+    "viem": ">=2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798"
+}