@pepu-chain/sdk 0.0.0-stage → 0.2.0

package/dist/store-CjmLgp9g.d.ts

@@ -0,0 +1,64 @@
+import { Address, Hex } from 'viem';
+
+/**
+ * Server-side session records for the Kernel (on-chain) session flow, keyed by
+ * Privy user id. Ported from templates/sponsored-session-app/lib/session-store.ts.
+ *
+ * WHAT IS STORED: the session private key (a hot key whose power is limited
+ * ON-CHAIN by the call and timestamp policies until `validUntil`) and the
+ * public approval. The owner's key never reaches the server.
+ *
+ * PRODUCTION: {@link createMemoryStore} is DEV-GRADE. It is lost on every
+ * restart (the user simply starts a new session) and is not shared between
+ * serverless instances. A production deployment must implement
+ * {@link SessionStore} on a persistent database or KV AND keep
+ * `sessionPrivateKey` encrypted at rest (KMS or an envelope key). Nothing else
+ * in the SDK changes.
+ */
+interface SessionRecord {
+    userId: string;
+    ownerAddress: Address;
+    kernelAddress: Address;
+    /** The session key's private half. Encrypt it at rest in any persistent store. */
+    sessionPrivateKey: Hex;
+    sessionKeyAddress: Address;
+    permissionId: string;
+    /** Unix seconds. The on-chain permission is invalid at and after this time. */
+    validUntil: number;
+    /** Present once the owner has signed the grant. */
+    approval: string | null;
+    /** Number of successful sponsored actions in this session. */
+    actions: number;
+}
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Pluggable storage for {@link SessionRecord}s. Every method may be sync or
+ * async. `tryLock` must be atomic per user: it returns `false` when an action
+ * is already running for that user (a multi-instance deployment needs a
+ * distributed lock, for example a Redis `SET NX PX`).
+ */
+interface SessionStore {
+    get(userId: string): MaybePromise<SessionRecord | undefined>;
+    set(record: SessionRecord): MaybePromise<void>;
+    delete(userId: string): MaybePromise<void>;
+    tryLock(userId: string): MaybePromise<boolean>;
+    unlock(userId: string): MaybePromise<void>;
+}
+/**
+ * An in-memory {@link SessionStore} for development and tests. DEV-GRADE: not
+ * persistent, not shared across instances, and the session key is held in
+ * plaintext in process memory. Production needs an encrypted persistent store.
+ *
+ * @example
+ * const store = createMemoryStore();
+ */
+declare function createMemoryStore(): SessionStore;
+/**
+ * True while the on-chain permission is still valid: approved and before expiry.
+ *
+ * @example
+ * isLive(record, Math.floor(Date.now() / 1000));
+ */
+declare function isLive(record: SessionRecord, nowSeconds: number): boolean;
+
+export { type SessionStore as S, type SessionRecord as a, createMemoryStore as c, isLive as i };

package/dist/types-BEEM7WdG.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Wire types shared by the combo server routes and the browser hook. Types
+ * only: safe to import from both entries.
+ */
+/**
+ * What `createSponsoredSessionRoutes(...).act.POST` returns after one sponsored
+ * action. `actualGasCostWei` is a decimal string (JSON has no bigint).
+ *
+ * @example
+ * const session = useSponsoredSession<undefined, SponsoredActResult>({ scope });
+ */
+interface SponsoredActResult {
+    userOpHash: string;
+    transactionHash: string;
+    kernelAddress: string;
+    success: boolean;
+    /** The paymaster that sponsored the operation, or `null` when none did. */
+    paymaster: string | null;
+    actualGasCostWei: string;
+    explorerUrl: string;
+    /** Successful actions in this session, as counted by the server. */
+    actions: number;
+}
+
+export type { SponsoredActResult as S };

package/dist/types-BEEM7WdG.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Wire types shared by the combo server routes and the browser hook. Types
+ * only: safe to import from both entries.
+ */
+/**
+ * What `createSponsoredSessionRoutes(...).act.POST` returns after one sponsored
+ * action. `actualGasCostWei` is a decimal string (JSON has no bigint).
+ *
+ * @example
+ * const session = useSponsoredSession<undefined, SponsoredActResult>({ scope });
+ */
+interface SponsoredActResult {
+    userOpHash: string;
+    transactionHash: string;
+    kernelAddress: string;
+    success: boolean;
+    /** The paymaster that sponsored the operation, or `null` when none did. */
+    paymaster: string | null;
+    actualGasCostWei: string;
+    explorerUrl: string;
+    /** Successful actions in this session, as counted by the server. */
+    actions: number;
+}
+
+export type { SponsoredActResult as S };

package/dist/types-BilBTDqK.d.cts

@@ -0,0 +1,27 @@
+import { Address, Hex, Abi } from 'viem';
+
+/**
+ * One call inside a (possibly batched) sponsored UserOperation. Give either
+ * raw `data`, or `abi` plus `functionName` (plus `args`) and the SDK encodes it.
+ */
+interface Call {
+    to: Address;
+    value?: bigint;
+    data?: Hex;
+    abi?: Abi;
+    functionName?: string;
+    args?: readonly unknown[];
+}
+/** What a sponsored send resolves to once the UserOperation is included. */
+interface SponsoredResult {
+    /** `null` when the transport only exposes the bundle transaction (Privy Smart Wallets). */
+    userOpHash: Hex | null;
+    transactionHash: Hex;
+    success: boolean;
+    /** The paymaster the EntryPoint charged, or `null` when the account paid for itself. */
+    paymaster: Address | null;
+    actualGasCostWei: bigint;
+    explorerUrl: string;
+}
+
+export type { Call as C, SponsoredResult as S };

package/dist/types-BilBTDqK.d.ts

@@ -0,0 +1,27 @@
+import { Address, Hex, Abi } from 'viem';
+
+/**
+ * One call inside a (possibly batched) sponsored UserOperation. Give either
+ * raw `data`, or `abi` plus `functionName` (plus `args`) and the SDK encodes it.
+ */
+interface Call {
+    to: Address;
+    value?: bigint;
+    data?: Hex;
+    abi?: Abi;
+    functionName?: string;
+    args?: readonly unknown[];
+}
+/** What a sponsored send resolves to once the UserOperation is included. */
+interface SponsoredResult {
+    /** `null` when the transport only exposes the bundle transaction (Privy Smart Wallets). */
+    userOpHash: Hex | null;
+    transactionHash: Hex;
+    success: boolean;
+    /** The paymaster the EntryPoint charged, or `null` when the account paid for itself. */
+    paymaster: Address | null;
+    actualGasCostWei: bigint;
+    explorerUrl: string;
+}
+
+export type { Call as C, SponsoredResult as S };

package/package.json

@@ -1,6 +1,212 @@
 {
   "name": "@pepu-chain/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Chain definitions, contract registry, token list, and viem helpers for Pepe Unchained V2.",
+  "license": "MIT",
+  "author": "Pepe Unchained <contact@pepeunchained.com> (https://pepeunchained.com)",
+  "homepage": "https://guide.pepeunchained.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pepu-org/pepu-devkit.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/pepu-org/pepu-devkit/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./privy": {
+      "types": "./dist/privy.d.ts",
+      "import": "./dist/privy.js",
+      "require": "./dist/privy.cjs"
+    },
+    "./privy/react": {
+      "types": "./dist/privy/react.d.ts",
+      "import": "./dist/privy/react.js",
+      "require": "./dist/privy/react.cjs"
+    },
+    "./privy/wagmi": {
+      "types": "./dist/privy/wagmi.d.ts",
+      "import": "./dist/privy/wagmi.js"
+    },
+    "./privy/server": {
+      "types": "./dist/privy/server.d.ts",
+      "import": "./dist/privy/server.js",
+      "require": "./dist/privy/server.cjs"
+    },
+    "./session": {
+      "types": "./dist/session.d.ts",
+      "import": "./dist/session.js",
+      "require": "./dist/session.cjs"
+    },
+    "./session/server": {
+      "types": "./dist/session/server.d.ts",
+      "import": "./dist/session/server.js",
+      "require": "./dist/session/server.cjs"
+    },
+    "./session/react": {
+      "types": "./dist/session/react.d.ts",
+      "import": "./dist/session/react.js",
+      "require": "./dist/session/react.cjs"
+    },
+    "./session/kernel": {
+      "types": "./dist/session/kernel.d.ts",
+      "import": "./dist/session/kernel.js",
+      "require": "./dist/session/kernel.cjs"
+    },
+    "./aa": {
+      "types": "./dist/aa.d.ts",
+      "import": "./dist/aa.js",
+      "require": "./dist/aa.cjs"
+    },
+    "./aa/kernel": {
+      "types": "./dist/aa/kernel.d.ts",
+      "import": "./dist/aa/kernel.js",
+      "require": "./dist/aa/kernel.cjs"
+    },
+    "./aa/react": {
+      "types": "./dist/aa/react.d.ts",
+      "import": "./dist/aa/react.js",
+      "require": "./dist/aa/react.cjs"
+    },
+    "./aa/react-direct": {
+      "types": "./dist/aa/react-direct.d.ts",
+      "import": "./dist/aa/react-direct.js",
+      "require": "./dist/aa/react-direct.cjs"
+    },
+    "./paymaster": {
+      "types": "./dist/paymaster.d.ts",
+      "import": "./dist/paymaster.js",
+      "require": "./dist/paymaster.cjs"
+    },
+    "./paymaster/server": {
+      "types": "./dist/paymaster/server.d.ts",
+      "import": "./dist/paymaster/server.js",
+      "require": "./dist/paymaster/server.cjs"
+    },
+    "./combo": {
+      "types": "./dist/combo.d.ts",
+      "import": "./dist/combo.js",
+      "require": "./dist/combo.cjs"
+    },
+    "./combo/react": {
+      "types": "./dist/combo/react.d.ts",
+      "import": "./dist/combo/react.js",
+      "require": "./dist/combo/react.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./doctor": {
+      "types": "./dist/doctor.d.ts",
+      "import": "./dist/doctor.js",
+      "require": "./dist/doctor.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "LICENSE",
+    "dist"
+  ],
+  "peerDependencies": {
+    "viem": "^2.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "@privy-io/react-auth": "^3.44.0",
+    "@privy-io/node": "^0.34.0",
+    "@privy-io/wagmi": "^4.0.0",
+    "wagmi": "^3.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "@zerodev/sdk": "^5.5.0",
+    "@zerodev/permissions": "^5.6.0",
+    "@zerodev/ecdsa-validator": "^5.4.0",
+    "permissionless": "^0.2.47"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "@privy-io/react-auth": {
+      "optional": true
+    },
+    "@privy-io/node": {
+      "optional": true
+    },
+    "@privy-io/wagmi": {
+      "optional": true
+    },
+    "wagmi": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "@zerodev/sdk": {
+      "optional": true
+    },
+    "@zerodev/permissions": {
+      "optional": true
+    },
+    "@zerodev/ecdsa-validator": {
+      "optional": true
+    },
+    "permissionless": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@privy-io/node": "^0.34.0",
+    "@privy-io/react-auth": "^3.44.0",
+    "@privy-io/wagmi": "^4.0.17",
+    "@tanstack/react-query": "^5.103.1",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.2",
+    "@zerodev/ecdsa-validator": "^5.4.9",
+    "@zerodev/permissions": "^5.6.3",
+    "@zerodev/sdk": "^5.5.10",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "jsdom": "^25.0.1",
+    "publint": "^0.3.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "viem": "^2.56.8",
+    "vitest": "^2.1.9",
+    "wagmi": "^3.7.7"
+  },
+  "keywords": [
+    "pepu",
+    "pepe-unchained",
+    "viem",
+    "evm",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/prune-esm-only.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "live-check": "node scripts/live-check.mjs",
+    "prove-session": "node scripts/prove-session.mjs"
+  }
 }