@getpara/aa-alchemy 2.16.0

package/dist/action.d.ts

@@ -0,0 +1,37 @@
+import { type SmartAccountClient } from '@aa-sdk/core';
+import type { SmartAccount4337, SmartAccount7702 } from '@getpara/viem-v2-integration';
+import type { CreateAlchemySmartAccountParams } from './types.js';
+export type { CreateAlchemySmartAccountParams, AlchemyTransactionOptions } from './types.js';
+/**
+ * Creates an Alchemy smart account using Para for signing.
+ *
+ * Supports both EIP-4337 (modular account) and EIP-7702 (modular account v2) modes.
+ * Uses Alchemy's infrastructure for bundler and paymaster via the Account Kit SDK.
+ *
+ * @param params - Configuration parameters
+ * @returns Unified SmartAccount interface wrapping Alchemy client, or null if no EVM wallet exists
+ *
+ * @example
+ * ```typescript
+ * import { createAlchemySmartAccount } from '@getpara/aa-alchemy';
+ * import { sepolia } from 'viem/chains';
+ *
+ * const account = await createAlchemySmartAccount({
+ *   para,
+ *   apiKey: 'your-alchemy-api-key',
+ *   chain: sepolia,
+ *   gasPolicyId: 'your-gas-policy-id',
+ * });
+ *
+ * if (account) {
+ *   const hash = await account.sendTransaction({ to, data, value });
+ * }
+ * ```
+ */
+export declare function createAlchemySmartAccount(params: CreateAlchemySmartAccountParams & {
+    mode: '7702';
+}): Promise<SmartAccount7702<SmartAccountClient> | null>;
+export declare function createAlchemySmartAccount(params: CreateAlchemySmartAccountParams & {
+    mode?: '4337';
+}): Promise<SmartAccount4337<SmartAccountClient> | null>;
+export declare function createAlchemySmartAccount(params: CreateAlchemySmartAccountParams): Promise<SmartAccount4337<SmartAccountClient> | SmartAccount7702<SmartAccountClient> | null>;

package/dist/action.js

@@ -0,0 +1,94 @@
+import { createModularAccountAlchemyClient, createModularAccountV2Client } from "@account-kit/smart-contracts";
+import * as alchemyInfra from "@account-kit/infra";
+import { WalletClientSigner } from "@aa-sdk/core";
+import { createParaAccount } from "@getpara/viem-v2-integration";
+import { SmartAccountError, wrapProviderError, resolveWalletIdentifier } from "@getpara/viem-v2-integration";
+import { createWalletClient, createPublicClient, http } from "viem";
+const ALCHEMY_7702_DELEGATION_ADDRESS = "0x69007702764179f14F51cdce752f4f775d74E139";
+const alchemyChainById = new Map(
+  Object.values(alchemyInfra).filter((v) => v !== null && typeof v === "object" && "id" in v && v.rpcUrls?.alchemy).map((v) => [v.id, v])
+);
+function ensureAlchemyChain(chain) {
+  if (chain.rpcUrls?.alchemy) return chain;
+  const alchemyChain = alchemyChainById.get(chain.id);
+  if (alchemyChain) return alchemyChain;
+  throw new SmartAccountError({
+    code: "INVALID_CONFIG",
+    message: `Chain "${chain.name}" (id: ${chain.id}) is not supported by Alchemy. Use a chain from @account-kit/infra or pass one with rpcUrls.alchemy configured via defineAlchemyChain.`,
+    provider: "ALCHEMY"
+  });
+}
+async function createAlchemySmartAccount(params) {
+  const { para, apiKey, chain: rawChain, rpcUrl, gasPolicyId, mode = "4337" } = params;
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  const chain = ensureAlchemyChain(rawChain);
+  const viemAccount = createParaAccount(para, walletAddress);
+  const viemClient = createWalletClient({ account: viemAccount, chain, transport: http(rpcUrl) });
+  const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+  const walletClientSigner = new WalletClientSigner(viemClient, "para");
+  let alchemyClient;
+  if (mode === "7702") {
+    alchemyClient = await createModularAccountV2Client({
+      mode: "7702",
+      transport: alchemyInfra.alchemy({ apiKey }),
+      chain,
+      signer: walletClientSigner,
+      policyId: gasPolicyId
+    });
+  } else {
+    alchemyClient = await createModularAccountAlchemyClient({
+      transport: alchemyInfra.alchemy({ apiKey }),
+      chain,
+      signer: walletClientSigner,
+      policyId: gasPolicyId
+    });
+  }
+  const accountAddress = alchemyClient.account?.address;
+  if (!accountAddress) {
+    throw new SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: "Unable to determine account address from Alchemy client",
+      provider: "ALCHEMY"
+    });
+  }
+  const sendBatchTransaction = async (calls, txOptions) => {
+    const alchemyOptions = txOptions;
+    if (!alchemyClient.sendUserOperation) {
+      throw new SmartAccountError({
+        code: "INVALID_CONFIG",
+        message: "sendUserOperation not available on client",
+        provider: "ALCHEMY"
+      });
+    }
+    try {
+      const result = await alchemyClient.sendUserOperation({
+        uo: calls.map((call) => ({
+          target: call.to,
+          value: call.value || BigInt(0),
+          data: call.data || "0x"
+        })),
+        ...alchemyOptions?.overrides && { overrides: alchemyOptions.overrides }
+      });
+      const txHash = alchemyClient.waitForUserOperationTransaction ? await alchemyClient.waitForUserOperationTransaction({ hash: result.hash }) : result.hash;
+      return publicClient.getTransactionReceipt({ hash: txHash });
+    } catch (error) {
+      throw wrapProviderError(error, "ALCHEMY");
+    }
+  };
+  const sendTransaction = async (tx, txOptions) => sendBatchTransaction([tx], txOptions);
+  return {
+    smartAccountAddress: accountAddress,
+    signer: viemAccount,
+    chain,
+    mode,
+    provider: "ALCHEMY",
+    sendTransaction,
+    sendBatchTransaction,
+    ...mode === "7702" && { delegationAddress: ALCHEMY_7702_DELEGATION_ADDRESS },
+    client: alchemyClient
+  };
+}
+export {
+  createAlchemySmartAccount
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createAlchemySmartAccount } from './action.js';
+export type { AlchemySmartAccountConfig, CreateAlchemySmartAccountParams, UseAlchemySmartAccountParams, AlchemyTransactionOptions, } from './types.js';

package/dist/index.js

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

package/dist/package.json

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

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+import type { UserOperationOverrides } from '@aa-sdk/core';
+import type { ApiKeySmartAccountConfig, CreateSmartAccountParams, SmartAccountModeParam } from '@getpara/viem-v2-integration';
+/**
+ * Configuration for Alchemy smart account.
+ *
+ * Supports both EIP-4337 (modular account) and EIP-7702 (modular account v2) modes.
+ * Uses Alchemy's Account Kit for bundler and paymaster infrastructure.
+ *
+ * @example
+ * ```ts
+ * const config: AlchemySmartAccountConfig = {
+ *   apiKey: 'YOUR_ALCHEMY_API_KEY',
+ *   chain: sepolia,
+ *   gasPolicyId: 'YOUR_GAS_POLICY_ID',
+ * };
+ * ```
+ */
+export interface AlchemySmartAccountConfig extends ApiKeySmartAccountConfig, SmartAccountModeParam {
+    /** Gas policy ID for sponsorship (optional — omit to skip gas sponsorship) */
+    gasPolicyId?: string;
+}
+/**
+ * Parameters for `createAlchemySmartAccount`.
+ * Includes all config fields plus `para` (the Para SDK instance).
+ */
+export type CreateAlchemySmartAccountParams = CreateSmartAccountParams<AlchemySmartAccountConfig>;
+/**
+ * Parameters for the `useAlchemySmartAccount` hook.
+ * Same as {@link AlchemySmartAccountConfig} — `para` is provided automatically via context.
+ */
+export type UseAlchemySmartAccountParams = AlchemySmartAccountConfig;
+/**
+ * Alchemy-specific transaction options.
+ * Pass as the second argument to `sendTransaction` or `sendBatchTransaction`.
+ */
+export interface AlchemyTransactionOptions {
+    /** Override the gas policy for this specific transaction */
+    policyId?: string;
+    /** User operation overrides (gas limits, fees, etc.) */
+    overrides?: UserOperationOverrides;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@getpara/aa-alchemy",
+  "version": "2.16.0",
+  "description": "Alchemy 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": {
+    "@aa-sdk/core": "^4.84.1",
+    "@account-kit/infra": "^4.84.1",
+    "@account-kit/smart-contracts": "^4.84.1",
+    "@getpara/viem-v2-integration": "2.16.0"
+  },
+  "peerDependencies": {
+    "viem": ">=2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798"
+}