@getpara/aa-safe 2.16.0

package/dist/action.d.ts

@@ -0,0 +1,13 @@
+import { type SmartAccountClient } from 'permissionless';
+import type { SmartAccount4337 } from '@getpara/viem-v2-integration';
+import type { CreateSafeSmartAccountParams } from './types.js';
+export type { CreateSafeSmartAccountParams, SafeTransactionOptions } from './types.js';
+/**
+ * Creates a Safe smart account using Para for signing.
+ *
+ * Supports gas sponsorship via Pimlico's paymaster with EntryPoint v0.7.
+ *
+ * @param params - Configuration parameters
+ * @returns Unified SmartAccount interface wrapping Safe client, or null if no EVM wallet exists
+ */
+export declare function createSafeSmartAccount(params: CreateSafeSmartAccountParams): Promise<SmartAccount4337<SmartAccountClient> | null>;

package/dist/action.js

@@ -0,0 +1,83 @@
+import { createSmartAccountClient } from "permissionless";
+import { toSafeSmartAccount } from "permissionless/accounts";
+import { createPimlicoClient } from "permissionless/clients/pimlico";
+import { createParaAccount } from "@getpara/viem-v2-integration";
+import { SmartAccountError, wrapProviderError, resolveWalletIdentifier } from "@getpara/viem-v2-integration";
+import { buildPimlicoRpcUrl } from "@getpara/aa-pimlico";
+import { createPublicClient, http } from "viem";
+import { entryPoint07Address } from "viem/account-abstraction";
+async function createSafeSmartAccount(params) {
+  const { para, pimlicoApiKey, chain, rpcUrl, safeVersion = "1.4.1", saltNonce } = params;
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  const pimlicoRpcUrl = buildPimlicoRpcUrl(chain, pimlicoApiKey);
+  const viemAccount = createParaAccount(para, walletAddress);
+  const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+  const paymasterClient = createPimlicoClient({
+    entryPoint: {
+      address: entryPoint07Address,
+      version: "0.7"
+    },
+    transport: http(pimlicoRpcUrl)
+  });
+  const safeAccount = await toSafeSmartAccount({
+    client: publicClient,
+    owners: [viemAccount],
+    entryPoint: {
+      address: entryPoint07Address,
+      version: "0.7"
+    },
+    version: safeVersion,
+    ...saltNonce !== void 0 && { saltNonce }
+  });
+  const smartAccountClient = createSmartAccountClient({
+    account: safeAccount,
+    chain,
+    paymaster: paymasterClient,
+    bundlerTransport: http(pimlicoRpcUrl),
+    userOperation: {
+      estimateFeesPerGas: async () => {
+        const gasPrice = await paymasterClient.getUserOperationGasPrice();
+        return gasPrice.fast;
+      }
+    }
+  });
+  if (!smartAccountClient.account?.address) {
+    throw new SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: "Safe client must have an account address",
+      provider: "SAFE"
+    });
+  }
+  const sendBatchTransaction = async (calls, options) => {
+    const safeOptions = options;
+    try {
+      const hash = await smartAccountClient.sendTransaction({
+        account: safeOptions?.account || smartAccountClient.account,
+        chain: safeOptions?.chain || smartAccountClient.chain,
+        calls,
+        ...safeOptions?.middleware
+      });
+      if ("waitForTransactionReceipt" in smartAccountClient && typeof smartAccountClient.waitForTransactionReceipt === "function") {
+        return smartAccountClient.waitForTransactionReceipt({ hash });
+      }
+      return publicClient.getTransactionReceipt({ hash });
+    } catch (error) {
+      throw wrapProviderError(error, "SAFE");
+    }
+  };
+  const sendTransaction = async (tx, options) => sendBatchTransaction([tx], options);
+  return {
+    smartAccountAddress: smartAccountClient.account.address,
+    signer: viemAccount,
+    chain,
+    mode: "4337",
+    provider: "SAFE",
+    sendBatchTransaction,
+    sendTransaction,
+    client: smartAccountClient
+  };
+}
+export {
+  createSafeSmartAccount
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createSafeSmartAccount } from './action.js';
+export type { SafeSmartAccountConfig, CreateSafeSmartAccountParams, UseSafeSmartAccountParams, SafeTransactionOptions, } from './types.js';

package/dist/index.js

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

package/dist/package.json

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+import type { Chain } from 'viem';
+import type { ChainBasedSmartAccountConfig, CreateSmartAccountParams } from '@getpara/viem-v2-integration';
+/**
+ * Configuration for Safe smart account.
+ *
+ * EIP-4337 only. Uses permissionless's Safe implementation with Pimlico's
+ * bundler and paymaster infrastructure.
+ *
+ * @example
+ * ```ts
+ * const config: SafeSmartAccountConfig = {
+ *   chain: baseSepolia,
+ *   pimlicoApiKey: 'YOUR_PIMLICO_API_KEY',
+ * };
+ * ```
+ */
+export interface SafeSmartAccountConfig extends ChainBasedSmartAccountConfig {
+    /** Pimlico API key for bundler and paymaster services */
+    pimlicoApiKey: string;
+    /**
+     * Safe version to use
+     * @default '1.4.1'
+     */
+    safeVersion?: '1.4.1';
+    /** Optional salt nonce for deterministic address generation */
+    saltNonce?: bigint;
+}
+/**
+ * Parameters for `createSafeSmartAccount`.
+ * Includes all config fields plus `para` (the Para SDK instance).
+ */
+export type CreateSafeSmartAccountParams = CreateSmartAccountParams<SafeSmartAccountConfig>;
+/**
+ * Parameters for the `useSafeSmartAccount` hook.
+ * Same as {@link SafeSmartAccountConfig} — `para` is provided automatically via context.
+ */
+export type UseSafeSmartAccountParams = SafeSmartAccountConfig;
+/**
+ * Safe-specific transaction options.
+ * Pass as the second argument to `sendTransaction` or `sendBatchTransaction`.
+ */
+export interface SafeTransactionOptions {
+    /** Custom gas and sponsorship middleware */
+    middleware?: {
+        gasPrice?: () => Promise<{
+            maxFeePerGas: bigint;
+            maxPriorityFeePerGas: bigint;
+        }>;
+        sponsorUserOperation?: (args: {
+            userOperation: Record<string, unknown>;
+        }) => Promise<Record<string, unknown>>;
+    };
+    /** Override the account address */
+    account?: `0x${string}`;
+    /** Override the chain */
+    chain?: Chain;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@getpara/aa-safe",
+  "version": "2.16.0",
+  "description": "Safe 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": {
+    "@getpara/aa-pimlico": "2.16.0",
+    "@getpara/viem-v2-integration": "2.16.0",
+    "permissionless": "^0.2.12"
+  },
+  "peerDependencies": {
+    "viem": ">=2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798"
+}