@pepu-chain/sdk 0.0.0-stage → 0.2.1

package/dist/chunk-7MNJF2OB.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+var chunkA5LP2UCS_cjs = require('./chunk-A5LP2UCS.cjs');
+var chunkVF3D6KLQ_cjs = require('./chunk-VF3D6KLQ.cjs');
+var chunkDPCZJLB3_cjs = require('./chunk-DPCZJLB3.cjs');
+var chunkYQL7NISX_cjs = require('./chunk-YQL7NISX.cjs');
+var viem = require('viem');
+var accountAbstraction = require('viem/account-abstraction');
+
+var ENTRY_POINT_V07 = {
+  address: "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
+  version: "0.7"
+};
+var FEE_HEADROOM_NUM = 12n;
+var FEE_HEADROOM_DEN = 10n;
+async function estimatePepuUserOpFees(publicClient) {
+  const fees = await publicClient.estimateFeesPerGas();
+  return {
+    maxFeePerGas: fees.maxFeePerGas * FEE_HEADROOM_NUM / FEE_HEADROOM_DEN,
+    maxPriorityFeePerGas: fees.maxPriorityFeePerGas
+  };
+}
+function requireBundlerUrl(explicit) {
+  const { bundlerUrl } = chunkVF3D6KLQ_cjs.resolvePepuEndpoints(explicit === void 0 ? {} : { bundlerUrl: explicit });
+  if (bundlerUrl === null) {
+    throw new chunkYQL7NISX_cjs.PepuConfigError("CONFIG_MISSING_ENV", `No bundler URL. Set ${chunkVF3D6KLQ_cjs.PEPU_ENV.bundlerUrl} or pass bundlerUrl.`, {
+      hint: "The hosted PEPU bundler is the default; if it was cleared, set PEPU_BUNDLER_URL to https://bundler.pepeunchained.com or your own bundler."
+    });
+  }
+  return bundlerUrl;
+}
+function requirePaymasterUrl(explicit, token) {
+  const { paymasterUrl, paymasterBaseUrl } = chunkVF3D6KLQ_cjs.resolvePepuEndpoints(explicit === void 0 ? {} : { paymasterUrl: explicit });
+  if (paymasterUrl !== null) return paymasterUrl;
+  if (token !== void 0 && token.trim() !== "" && paymasterBaseUrl !== null) {
+    return chunkA5LP2UCS_cjs.buildErc7677Url({ baseUrl: paymasterBaseUrl, token });
+  }
+  throw new chunkYQL7NISX_cjs.PepuConfigError("CONFIG_MISSING_ENV", `No ERC-7677 paymaster URL. Set ${chunkVF3D6KLQ_cjs.PEPU_ENV.paymasterUrl} or pass paymasterUrl / paymasterToken.`, {
+    hint: "The hosted paymaster (https://paymaster.pepeunchained.com) needs your project's client token: set PEPU_PAYMASTER_URL to https://paymaster.pepeunchained.com/v2/paymaster/<client token>."
+  });
+}
+function createPepuPaymasterClient(o = {}) {
+  const client = accountAbstraction.createPaymasterClient({ transport: viem.http(requirePaymasterUrl(o.paymasterUrl, o.paymasterToken)) });
+  const ctx = o.context;
+  if (!ctx) return client;
+  return {
+    ...client,
+    getPaymasterData: (p) => client.getPaymasterData({ ...p, context: p.context ?? ctx }),
+    getPaymasterStubData: (p) => client.getPaymasterStubData({ ...p, context: p.context ?? ctx })
+  };
+}
+function createPepuBundlerClient(o) {
+  const rpcUrl = chunkVF3D6KLQ_cjs.resolvePepuEndpoints().rpcUrl;
+  const publicClient = o.publicClient ?? viem.createPublicClient({ chain: chunkDPCZJLB3_cjs.pepuMainnet, transport: viem.http(rpcUrl) });
+  return accountAbstraction.createBundlerClient({
+    account: o.account,
+    chain: chunkDPCZJLB3_cjs.pepuMainnet,
+    client: publicClient,
+    transport: viem.http(requireBundlerUrl(o.bundlerUrl)),
+    ...o.paymaster ? { paymaster: o.paymaster } : {},
+    ...o.paymasterContext ? { paymasterContext: o.paymasterContext } : {},
+    userOperation: { estimateFeesPerGas: async () => estimatePepuUserOpFees(publicClient) }
+  });
+}
+
+exports.ENTRY_POINT_V07 = ENTRY_POINT_V07;
+exports.createPepuBundlerClient = createPepuBundlerClient;
+exports.createPepuPaymasterClient = createPepuPaymasterClient;
+exports.estimatePepuUserOpFees = estimatePepuUserOpFees;
+exports.requireBundlerUrl = requireBundlerUrl;
+//# sourceMappingURL=chunk-7MNJF2OB.cjs.map
+//# sourceMappingURL=chunk-7MNJF2OB.cjs.map

package/dist/chunk-7MNJF2OB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/aa/clients.ts"],"names":["resolvePepuEndpoints","PepuConfigError","PEPU_ENV","buildErc7677Url","createPaymasterClient","http","createPublicClient","pepuMainnet","createBundlerClient"],"mappings":"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","file":"chunk-7MNJF2OB.cjs","sourcesContent":["import { createPublicClient, http } from \"viem\";\nimport type { PublicClient } from \"viem\";\nimport { createBundlerClient, createPaymasterClient } from \"viem/account-abstraction\";\nimport type { BundlerClient, PaymasterClient, SmartAccount } from \"viem/account-abstraction\";\n\nimport { pepuMainnet } from \"../chains.js\";\nimport { PEPU_ENV, resolvePepuEndpoints } from \"../endpoints.js\";\nimport { PepuConfigError } from \"../errors.js\";\nimport type { PaymasterContext } from \"../erc7677.js\";\nimport { buildErc7677Url } from \"../paymaster/api.js\";\n\n/** EntryPoint v0.7, the only version PEPU's bundler and paymaster speak. */\nexport const ENTRY_POINT_V07 = {\n  address: \"0x0000000071727De22E5E9d8BAf0edAc6f37da032\",\n  version: \"0.7\",\n} as const;\n\n/** Fee headroom numerator/denominator: 12/10 = +20%. */\nconst FEE_HEADROOM_NUM = 12n;\nconst FEE_HEADROOM_DEN = 10n;\n\n/**\n * The Alto-compatible fee estimator: the chain's own `estimateFeesPerGas`,\n * with `maxFeePerGas` x 1.2. Alto does not implement ZeroDev's\n * `zd_getUserOperationGasPrice`, so the default estimator would fail.\n * Ported from `templates/sponsored-session-app/lib/kernel.ts`.\n *\n * @example\n * const fees = await estimatePepuUserOpFees(publicClient);\n */\nexport async function estimatePepuUserOpFees(\n  publicClient: Pick<PublicClient, \"estimateFeesPerGas\">,\n): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }> {\n  const fees = await publicClient.estimateFeesPerGas();\n  return {\n    maxFeePerGas: (fees.maxFeePerGas * FEE_HEADROOM_NUM) / FEE_HEADROOM_DEN,\n    maxPriorityFeePerGas: fees.maxPriorityFeePerGas,\n  };\n}\n\n/** Resolve the bundler URL or throw `CONFIG_MISSING_ENV` naming the variable. */\nexport function requireBundlerUrl(explicit?: string): string {\n  const { bundlerUrl } = resolvePepuEndpoints(explicit === undefined ? {} : { bundlerUrl: explicit });\n  if (bundlerUrl === null) {\n    throw new PepuConfigError(\"CONFIG_MISSING_ENV\", `No bundler URL. Set ${PEPU_ENV.bundlerUrl} or pass bundlerUrl.`, {\n      hint: \"The hosted PEPU bundler is the default; if it was cleared, set PEPU_BUNDLER_URL to https://bundler.pepeunchained.com or your own bundler.\",\n    });\n  }\n  return bundlerUrl;\n}\n\n/**\n * Resolve the complete ERC-7677 paymaster URL or throw `CONFIG_MISSING_ENV`.\n * Order: `explicit` URL, then `PEPU_PAYMASTER_URL`, then `token` (a project client token, built against the\n * paymaster base: the hosted service unless a custom URL is configured). The hosted paymaster has no tokenless\n * ERC-7677 URL, because the token names the project (or free-tier app) that is billed.\n */\nexport function requirePaymasterUrl(explicit?: string, token?: string): string {\n  const { paymasterUrl, paymasterBaseUrl } = resolvePepuEndpoints(explicit === undefined ? {} : { paymasterUrl: explicit });\n  if (paymasterUrl !== null) return paymasterUrl;\n  if (token !== undefined && token.trim() !== \"\" && paymasterBaseUrl !== null) {\n    return buildErc7677Url({ baseUrl: paymasterBaseUrl, token });\n  }\n  throw new PepuConfigError(\"CONFIG_MISSING_ENV\", `No ERC-7677 paymaster URL. Set ${PEPU_ENV.paymasterUrl} or pass paymasterUrl / paymasterToken.`, {\n    hint: \"The hosted paymaster (https://paymaster.pepeunchained.com) needs your project's client token: set PEPU_PAYMASTER_URL to https://paymaster.pepeunchained.com/v2/paymaster/<client token>.\",\n  });\n}\n\n/**\n * An ERC-7677 paymaster client for PEPU (viem `createPaymasterClient`), using\n * the endpoints registry for the URL. A `context` (for example\n * `buildPaymasterContext({ privyAccessToken })`) is injected into every\n * `pm_getPaymasterStubData` and `pm_getPaymasterData` call unless the caller\n * passes one.\n *\n * @example\n * const paymaster = createPepuPaymasterClient({\n *   context: buildPaymasterContext({ privyAccessToken }),\n * });\n */\nexport function createPepuPaymasterClient(\n  o: { paymasterUrl?: string; paymasterToken?: string; context?: PaymasterContext } = {},\n): PaymasterClient {\n  const client = createPaymasterClient({ transport: http(requirePaymasterUrl(o.paymasterUrl, o.paymasterToken)) });\n  const ctx = o.context;\n  if (!ctx) return client;\n  return {\n    ...client,\n    getPaymasterData: (p) => client.getPaymasterData({ ...p, context: p.context ?? ctx }),\n    getPaymasterStubData: (p) => client.getPaymasterStubData({ ...p, context: p.context ?? ctx }),\n  };\n}\n\n/**\n * A viem bundler client for PEPU's bundler, with the fee estimator\n * pre-wired ({@link estimatePepuUserOpFees}).\n *\n * @example\n * const bundler = createPepuBundlerClient({ account, paymaster: createPepuPaymasterClient() });\n * const hash = await bundler.sendUserOperation({ calls: [{ to, data }] });\n */\nexport function createPepuBundlerClient(o: {\n  bundlerUrl?: string;\n  account: SmartAccount;\n  paymaster?: PaymasterClient;\n  paymasterContext?: PaymasterContext;\n  publicClient?: PublicClient;\n}): BundlerClient {\n  const rpcUrl = resolvePepuEndpoints().rpcUrl;\n  const publicClient = o.publicClient ?? createPublicClient({ chain: pepuMainnet, transport: http(rpcUrl) });\n  return createBundlerClient({\n    account: o.account,\n    chain: pepuMainnet,\n    client: publicClient,\n    transport: http(requireBundlerUrl(o.bundlerUrl)),\n    ...(o.paymaster ? { paymaster: o.paymaster } : {}),\n    ...(o.paymasterContext ? { paymasterContext: o.paymasterContext } : {}),\n    userOperation: { estimateFeesPerGas: async () => estimatePepuUserOpFees(publicClient) },\n  }) as BundlerClient;\n}\n"]}

package/dist/chunk-7PVR7QSE.js

@@ -0,0 +1,45 @@
+import { getContract } from './chunk-KJYNF5KH.js';
+import { pepuMainnet } from './chunk-VTQIHMF3.js';
+import { toHex } from 'viem';
+
+function buildPaymasterContext(entries = {}) {
+  const context = {};
+  for (const [key, value] of Object.entries(entries)) {
+    if (value === void 0) continue;
+    const kind = typeof value;
+    if (kind === "bigint" || kind === "function" || kind === "symbol") {
+      throw new Error(
+        `buildPaymasterContext: "${key}" is a ${kind}, which is not JSON-serializable. Convert it to a string or number first.`
+      );
+    }
+    context[key] = value;
+  }
+  return context;
+}
+function buildParams(options) {
+  const entryPointEntry = getContract(pepuMainnet.id, "entryPoint07");
+  const entryPoint = options.entryPoint ?? (entryPointEntry?.status === "deployed" ? entryPointEntry.address : void 0);
+  if (!entryPoint) throw new Error("buildPaymasterRequest: no EntryPoint v0.7 address available.");
+  const chainId = toHex(options.chainId ?? pepuMainnet.id);
+  return options.context ? [options.userOperation, entryPoint, chainId, options.context] : [options.userOperation, entryPoint, chainId];
+}
+function buildPaymasterStubDataRequest(options) {
+  return {
+    jsonrpc: "2.0",
+    id: options.id ?? 1,
+    method: "pm_getPaymasterStubData",
+    params: buildParams(options)
+  };
+}
+function buildPaymasterDataRequest(options) {
+  return {
+    jsonrpc: "2.0",
+    id: options.id ?? 1,
+    method: "pm_getPaymasterData",
+    params: buildParams(options)
+  };
+}
+
+export { buildPaymasterContext, buildPaymasterDataRequest, buildPaymasterStubDataRequest };
+//# sourceMappingURL=chunk-7PVR7QSE.js.map
+//# sourceMappingURL=chunk-7PVR7QSE.js.map

package/dist/chunk-7PVR7QSE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/erc7677.ts"],"names":[],"mappings":";;;;AAkGO,SAAS,qBAAA,CACd,OAAA,GAA6C,EAAC,EAC5B;AAClB,EAAA,MAAM,UAA4B,EAAC;AACnC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,IAAI,UAAU,MAAA,EAAW;AACzB,IAAA,MAAM,OAAO,OAAO,KAAA;AACpB,IAAA,IAAI,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,UAAA,IAAc,SAAS,QAAA,EAAU;AACjE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,wBAAA,EAA2B,GAAG,CAAA,OAAA,EAAU,IAAI,CAAA,yEAAA;AAAA,OAC9C;AAAA,IACF;AACA,IAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,KAAA;AAAA,EACjB;AACA,EAAA,OAAO,OAAA;AACT;AAYA,SAAS,YAAY,OAAA,EAA2D;AAC9E,EAAA,MAAM,eAAA,GAAkB,WAAA,CAAY,WAAA,CAAY,EAAA,EAAI,cAAc,CAAA;AAClE,EAAA,MAAM,aACJ,OAAA,CAAQ,UAAA,KACP,iBAAiB,MAAA,KAAW,UAAA,GAAa,gBAAgB,OAAA,GAAU,MAAA,CAAA;AACtE,EAAA,IAAI,CAAC,UAAA,EAAY,MAAM,IAAI,MAAM,8DAA8D,CAAA;AAC/F,EAAA,MAAM,OAAA,GAAU,KAAA,CAAM,OAAA,CAAQ,OAAA,IAAW,YAAY,EAAE,CAAA;AACvD,EAAA,OAAO,OAAA,CAAQ,OAAA,GACX,CAAC,OAAA,CAAQ,eAAe,UAAA,EAAY,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,GAC5D,CAAC,OAAA,CAAQ,aAAA,EAAe,YAAY,OAAO,CAAA;AACjD;AAGO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA;AAAA,IACT,EAAA,EAAI,QAAQ,EAAA,IAAM,CAAA;AAAA,IAClB,MAAA,EAAQ,yBAAA;AAAA,IACR,MAAA,EAAQ,YAAY,OAAO;AAAA,GAC7B;AACF;AAGO,SAAS,0BACd,OAAA,EACsB;AACtB,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA;AAAA,IACT,EAAA,EAAI,QAAQ,EAAA,IAAM,CAAA;AAAA,IAClB,MAAA,EAAQ,qBAAA;AAAA,IACR,MAAA,EAAQ,YAAY,OAAO;AAAA,GAC7B;AACF","file":"chunk-7PVR7QSE.js","sourcesContent":["import { toHex } from \"viem\";\nimport type { Address, Hex } from \"viem\";\n\nimport { pepuMainnet } from \"./chains.js\";\nimport { getContract } from \"./contracts.js\";\n\n/**\n * ERC-7677 paymaster web-service types, for the two JSON-RPC methods PEPU's\n * paymaster policy service implements: `pm_getPaymasterStubData` and\n * `pm_getPaymasterData`. See https://eips.ethereum.org/EIPS/eip-7677.\n *\n * Pure types plus a few tiny builders: no network, no secrets, safe in a\n * browser bundle. Quantities are `0x`-prefixed hex strings, as on the wire.\n *\n * Note this package never implies sponsorship is available to an app: see\n * `getSponsorshipStatus()`. These types describe the protocol only.\n */\n\n/** An ERC-4337 v0.7 UserOperation in its unpacked JSON-RPC shape. */\nexport interface Erc7677UserOperation {\n  sender: Address;\n  nonce: Hex;\n  factory?: Address;\n  factoryData?: Hex;\n  callData: Hex;\n  callGasLimit: Hex;\n  verificationGasLimit: Hex;\n  preVerificationGas: Hex;\n  maxFeePerGas: Hex;\n  maxPriorityFeePerGas: Hex;\n  paymaster?: Address;\n  paymasterVerificationGasLimit?: Hex;\n  paymasterPostOpGasLimit?: Hex;\n  paymasterData?: Hex;\n  signature: Hex;\n}\n\n/** Paymaster-defined, JSON-serializable context (params[3]). */\nexport type PaymasterContext = Record<string, unknown>;\n\nexport type PaymasterRpcParams = readonly [\n  userOperation: Partial<Erc7677UserOperation> & Pick<Erc7677UserOperation, \"sender\" | \"callData\">,\n  entryPoint: Address,\n  chainId: Hex,\n  context?: PaymasterContext,\n];\n\nexport interface PaymasterStubDataRequest {\n  jsonrpc: \"2.0\";\n  id: number | string;\n  method: \"pm_getPaymasterStubData\";\n  params: PaymasterRpcParams;\n}\n\nexport interface PaymasterDataRequest {\n  jsonrpc: \"2.0\";\n  id: number | string;\n  method: \"pm_getPaymasterData\";\n  params: PaymasterRpcParams;\n}\n\n/** Result of `pm_getPaymasterStubData`. Stub values are for gas estimation only. */\nexport interface PaymasterStubDataResult {\n  paymaster: Address;\n  paymasterData: Hex;\n  paymasterVerificationGasLimit?: Hex;\n  paymasterPostOpGasLimit?: Hex;\n  /** `true` when the stub values are also the final values. */\n  isFinal?: boolean;\n  sponsor?: { name: string; icon?: string };\n}\n\n/** Result of `pm_getPaymasterData`: the signed values to submit. */\nexport interface PaymasterDataResult {\n  paymaster: Address;\n  paymasterData: Hex;\n  paymasterVerificationGasLimit?: Hex;\n  paymasterPostOpGasLimit?: Hex;\n}\n\nexport interface PaymasterRpcError {\n  code: number;\n  message: string;\n  /** PEPU's policy service puts the machine-readable denial reason in `data.reason`. */\n  data?: { reason?: string } & Record<string, unknown>;\n}\n\nexport type PaymasterRpcResponse<TResult> =\n  | { jsonrpc: \"2.0\"; id: number | string | null; result: TResult }\n  | { jsonrpc: \"2.0\"; id: number | string | null; error: PaymasterRpcError };\n\n/**\n * Build a paymaster `context` object: drops `undefined` entries and throws on\n * anything that would not survive `JSON.stringify` (bigint, function, symbol),\n * so a bad value fails here instead of as an opaque RPC error. Returns `{}`\n * for no input. The context is paymaster-defined; PEPU's policy service\n * currently accepts and ignores it.\n */\nexport function buildPaymasterContext(\n  entries: Readonly<Record<string, unknown>> = {},\n): PaymasterContext {\n  const context: PaymasterContext = {};\n  for (const [key, value] of Object.entries(entries)) {\n    if (value === undefined) continue;\n    const kind = typeof value;\n    if (kind === \"bigint\" || kind === \"function\" || kind === \"symbol\") {\n      throw new Error(\n        `buildPaymasterContext: \"${key}\" is a ${kind}, which is not JSON-serializable. Convert it to a string or number first.`,\n      );\n    }\n    context[key] = value;\n  }\n  return context;\n}\n\nexport interface BuildPaymasterRequestOptions {\n  userOperation: PaymasterRpcParams[0];\n  /** Defaults to PEPU mainnet's EntryPoint v0.7. */\n  entryPoint?: Address;\n  /** Defaults to 97741 (PEPU mainnet). */\n  chainId?: number;\n  context?: PaymasterContext;\n  id?: number | string;\n}\n\nfunction buildParams(options: BuildPaymasterRequestOptions): PaymasterRpcParams {\n  const entryPointEntry = getContract(pepuMainnet.id, \"entryPoint07\");\n  const entryPoint =\n    options.entryPoint ??\n    (entryPointEntry?.status === \"deployed\" ? entryPointEntry.address : undefined);\n  if (!entryPoint) throw new Error(\"buildPaymasterRequest: no EntryPoint v0.7 address available.\");\n  const chainId = toHex(options.chainId ?? pepuMainnet.id);\n  return options.context\n    ? [options.userOperation, entryPoint, chainId, options.context]\n    : [options.userOperation, entryPoint, chainId];\n}\n\n/** Build a `pm_getPaymasterStubData` JSON-RPC request body. */\nexport function buildPaymasterStubDataRequest(\n  options: BuildPaymasterRequestOptions,\n): PaymasterStubDataRequest {\n  return {\n    jsonrpc: \"2.0\",\n    id: options.id ?? 1,\n    method: \"pm_getPaymasterStubData\",\n    params: buildParams(options),\n  };\n}\n\n/** Build a `pm_getPaymasterData` JSON-RPC request body. */\nexport function buildPaymasterDataRequest(\n  options: BuildPaymasterRequestOptions,\n): PaymasterDataRequest {\n  return {\n    jsonrpc: \"2.0\",\n    id: options.id ?? 1,\n    method: \"pm_getPaymasterData\",\n    params: buildParams(options),\n  };\n}\n"]}