@baliola/smart-account-sdk 0.3.1

package/dist/writeContract-CdcmYmx0.d.ts

@@ -0,0 +1,184 @@
+import { i as IUserOperation, n as ISmartAccount, t as Call } from "./types-CD0TvpY4.js";
+import { t as UserOperationReceipt } from "./receipt-Ceeclfnv.js";
+import { Abi, Address, Chain, ContractFunctionArgs, ContractFunctionName, Hex, Log, PublicClient, Transport } from "viem";
+
+//#region src/clients/createBundlerClient.d.ts
+interface CreateBundlerClientParams {
+  transport: Transport;
+  /** Optional chain tag forwarded to the transport (viem requires it for some transports). */
+  chain?: Chain;
+}
+interface BundlerClient {
+  request<TResult = unknown>(method: string, params: readonly unknown[]): Promise<TResult>;
+}
+/**
+ * Thin JSON-RPC wrapper over a viem `Transport`. Speaks the ERC-4337 v0.7
+ * bundler methods without pulling in the rest of viem's client surface,
+ * because the bundler endpoint is a different service than the chain RPC.
+ *
+ * Every error thrown out of `request` is first classified into a typed
+ * SDK error (`InvalidUserOperationError`, `UserOperationRejectedError`,
+ * `BundlerUnreachableError`, or one of the `UserOperationRevertError`
+ * subclasses for AA-code reverts). Callers never see a raw viem error.
+ */
+declare function createBundlerClient({
+  transport,
+  chain
+}: CreateBundlerClientParams): BundlerClient;
+//#endregion
+//#region src/paymaster/types.d.ts
+interface PaymasterContext {
+  userOp: IUserOperation;
+  entryPoint: Address;
+  chainId: number;
+}
+interface PaymasterFields {
+  paymaster: Address;
+  paymasterData: Hex;
+  paymasterVerificationGasLimit?: bigint;
+  paymasterPostOpGasLimit?: bigint;
+}
+/**
+ * Called exactly once per UserOp just before signing. Returns the fields
+ * to merge into the op. Internal-only — public callers configure paymaster
+ * via the top-level `paymasterAddress` option on `createSmartAccountClient`.
+ */
+type PaymasterResolver = (ctx: PaymasterContext) => Promise<PaymasterFields>;
+//#endregion
+//#region src/actions/types.d.ts
+/**
+ * Execution context every action receives. `createSmartAccountClient`
+ * builds this once and binds each action to it via `.extend()`.
+ */
+interface SmartAccountActionContext {
+  account: ISmartAccount;
+  publicClient: PublicClient;
+  bundler: BundlerClient;
+  entryPoint: Address;
+  paymaster: PaymasterResolver;
+}
+/** The five UserOp gas fields the bundler returns from `eth_estimateUserOperationGas`. */
+interface UserOperationGasEstimate {
+  callGasLimit: bigint;
+  verificationGasLimit: bigint;
+  preVerificationGas: bigint;
+  paymasterVerificationGasLimit?: bigint;
+  paymasterPostOpGasLimit?: bigint;
+}
+//#endregion
+//#region src/actions/estimateUserOperationGas.d.ts
+interface EstimateUserOperationGasParams {
+  calls: Call[];
+  overrides?: Partial<IUserOperation>;
+  paymasterFields?: PaymasterFields | null;
+}
+/**
+ * Low-level estimate that skips paymaster resolution — callers that want
+ * the full `{ calls, overrides }` surface should use the higher-level
+ * `estimateUserOperationGas` action below.
+ */
+declare function estimateUserOpGasRaw(ctx: SmartAccountActionContext, op: IUserOperation): Promise<UserOperationGasEstimate>;
+declare function estimateUserOperationGas(ctx: SmartAccountActionContext, params: EstimateUserOperationGasParams): Promise<UserOperationGasEstimate>;
+//#endregion
+//#region ../shared/src/chains/events.d.ts
+/**
+ * Slice receipt logs for one userop's execution frame: all logs between the
+ * BeforeExecution marker (or the prior UserOperationEvent) and this op's
+ * UserOperationEvent.
+ */
+declare function sliceUserOpLogs(receiptLogs: readonly Log[], userOpHash: Hex): Log[];
+//#endregion
+//#region src/actions/getUserOperationReceipt.d.ts
+interface GetUserOperationReceiptParams {
+  userOpHash: Hex;
+}
+declare function getUserOperationReceipt(ctx: SmartAccountActionContext, {
+  userOpHash
+}: GetUserOperationReceiptParams): Promise<UserOperationReceipt | null>;
+//#endregion
+//#region src/actions/waitForUserOperationReceipt.d.ts
+interface WaitForUserOperationReceiptParams {
+  userOpHash: Hex;
+  /** Maximum time to wait, in milliseconds. Defaults to 60s. */
+  timeout?: number;
+  /** Polling interval in milliseconds. Defaults to 1000ms. */
+  pollingInterval?: number;
+  /** Optional abort signal to cancel the wait early. */
+  signal?: AbortSignal;
+}
+declare function waitForUserOperationReceipt(ctx: SmartAccountActionContext, params: WaitForUserOperationReceiptParams): Promise<UserOperationReceipt>;
+//#endregion
+//#region src/actions/watchUserOperations.d.ts
+interface UserOperationEventMatch {
+  userOpHash: Hex;
+  sender: Address;
+  paymaster: Address;
+  nonce: bigint;
+  success: boolean;
+  actualGasCost: bigint;
+  actualGasUsed: bigint;
+  log: Log;
+}
+interface WatchUserOperationsParams {
+  /** Defaults to `ctx.account.address` when neither sender nor userOpHash is given. */
+  sender?: Address;
+  /** Narrows the filter to a single op. */
+  userOpHash?: Hex;
+  onUserOp: (event: UserOperationEventMatch) => void;
+  onError?: (err: unknown) => void;
+}
+/** Returned from `watchUserOperations` to stop the subscription. */
+type UnwatchFn = () => void;
+declare function watchUserOperations(ctx: SmartAccountActionContext, params: WatchUserOperationsParams): UnwatchFn;
+//#endregion
+//#region src/actions/writeContract.d.ts
+/** Typed contract call — `args` are ABI-encoded by the SDK. */
+interface TypedCall<TAbi extends Abi = Abi, TFn extends ContractFunctionName<TAbi, "nonpayable" | "payable"> = ContractFunctionName<TAbi, "nonpayable" | "payable">> {
+  address: Address;
+  abi: TAbi;
+  functionName: TFn;
+  args?: ContractFunctionArgs<TAbi, "nonpayable" | "payable", TFn>;
+  value?: bigint;
+}
+/** Raw call — ETH transfers, pre-encoded calldata, or calls to non-typed targets. */
+interface RawCall {
+  to: Address;
+  value?: bigint;
+  data?: Hex;
+}
+/** Single entry, or a batch of mixed typed/raw entries (one UserOperation, `executeBatch`). */
+type WriteContractInput = TypedCall | RawCall | ReadonlyArray<TypedCall | RawCall>;
+/** UserOperation-level overrides for power users. */
+interface WriteContractOverrides {
+  callGasLimit?: bigint;
+  verificationGasLimit?: bigint;
+  preVerificationGas?: bigint;
+  maxFeePerGas?: bigint;
+  maxPriorityFeePerGas?: bigint;
+  paymasterFields?: PaymasterFields;
+  nonce?: bigint;
+}
+/**
+ * Bound write-verb shape exposed on `SmartAccountClient`. Same overload set
+ * as the underlying `writeContract` but without the leading `ctx` argument.
+ */
+interface BoundWriteContract {
+  <TAbi extends Abi, TFn extends ContractFunctionName<TAbi, "nonpayable" | "payable">>(input: TypedCall<TAbi, TFn>, overrides?: WriteContractOverrides): Promise<Hex>;
+  (input: RawCall, overrides?: WriteContractOverrides): Promise<Hex>;
+  (input: ReadonlyArray<TypedCall | RawCall>, overrides?: WriteContractOverrides): Promise<Hex>;
+}
+/**
+ * The single public write verb. Accepts:
+ *   - a typed call: `{ address, abi, functionName, args?, value? }`
+ *   - a raw call:   `{ to, value?, data? }`
+ *   - an array of either (batched into one UserOperation via `executeBatch`)
+ *
+ * Returns the `userOpHash`. Use `waitForUserOperationReceipt` to await inclusion.
+ */
+declare function writeContract<TAbi extends Abi, TFn extends ContractFunctionName<TAbi, "nonpayable" | "payable">>(ctx: SmartAccountActionContext, input: TypedCall<TAbi, TFn>, overrides?: WriteContractOverrides): Promise<Hex>;
+declare function writeContract(ctx: SmartAccountActionContext, input: RawCall, overrides?: WriteContractOverrides): Promise<Hex>;
+declare function writeContract(ctx: SmartAccountActionContext, input: ReadonlyArray<TypedCall | RawCall>, overrides?: WriteContractOverrides): Promise<Hex>;
+/** Build a context-bound `writeContract` for use on `SmartAccountClient`. */
+declare function bindWriteContract(ctx: SmartAccountActionContext): BoundWriteContract;
+//#endregion
+export { CreateBundlerClientParams as C, BundlerClient as S, EstimateUserOperationGasParams as _, WriteContractOverrides as a, SmartAccountActionContext as b, UnwatchFn as c, watchUserOperations as d, WaitForUserOperationReceiptParams as f, sliceUserOpLogs as g, getUserOperationReceipt as h, WriteContractInput as i, UserOperationEventMatch as l, GetUserOperationReceiptParams as m, RawCall as n, bindWriteContract as o, waitForUserOperationReceipt as p, TypedCall as r, writeContract as s, BoundWriteContract as t, WatchUserOperationsParams as u, estimateUserOpGasRaw as v, createBundlerClient as w, UserOperationGasEstimate as x, estimateUserOperationGas as y };

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@baliola/smart-account-sdk",
+  "version": "0.3.1",
+  "description": "Client-side SDK for Baliola's Smart Account (ERC-4337) stack on MAC",
+  "keywords": [
+    "erc-4337",
+    "account-abstraction",
+    "smart-account",
+    "viem",
+    "mac",
+    "baliola"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Baliola Development Team",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/baliola/smart-account.git",
+    "directory": "sdk"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./accounts": {
+      "types": "./dist/accounts/index.d.ts",
+      "import": "./dist/accounts/index.js"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    },
+    "./chains": {
+      "types": "./dist/chains/index.d.ts",
+      "import": "./dist/chains/index.js"
+    },
+    "./clients": {
+      "types": "./dist/clients/index.d.ts",
+      "import": "./dist/clients/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test test/unit test/integration",
+    "test:e2e": "LIVE=1 bun test --env-file=../bundler/.env test/e2e",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "viem": "^2.46"
+  },
+  "devDependencies": {
+    "@baliola/smart-account-shared": "workspace:*",
+    "@types/bun": "latest",
+    "tsdown": "^0.21.10",
+    "typescript": "^5.7.3",
+    "viem": "^2.46.3"
+  }
+}