@andrewkimjoseph/celina-sdk 0.13.0 → 0.14.0

package/build/types/prepared.d.ts

@@ -1,5 +1,9 @@
+import { CHAIN } from "../config/chains.js";
 export type PreparedTxKind = "native" | "erc20" | "contract";
-/** Single unsigned transaction step in a prepared flow. */
+/**
+ * One unsigned transaction in a prepared list (`steps`).
+ * Calldata may already include Celina dual attribution suffixes from `prepare*`.
+ */
 export interface PreparedTx {
     /** Step category for UI and wallet routing. */
     kind: PreparedTxKind;
@@ -9,20 +13,31 @@ export interface PreparedTx {
     value?: string;
     description: string;
 }
-/** In-memory prepared flow before JSON serialization. */
+/**
+ * Prepared flow = ordered unsigned transactions ready to sign (wagmi/EOA) or
+ * submit as UserOps (`createAAClient.sendPreparedFlow`) — not a runtime workflow engine.
+ * The primary payload is `steps`.
+ */
 export interface PreparedFlow {
     steps: PreparedTx[];
     summary: string;
-    network: "mainnet";
+    /** Celo chain id (`celo.id` / {@link CHAIN}.id); always `42220` for Celina today. */
+    chainId: typeof CHAIN.id;
     from: `0x${string}`;
 }
 /**
- * JSON-safe prepared flow returned by prepare* tools and chat APIs.
- * Consumers simulate each step (see @andrewkimjoseph/celina-sdk/simulation), then call sendTransactionAsync (wagmi) or walletClient.sendTransaction (viem).
+ * Prepared flow = ordered unsigned transactions ready to sign or submit as UserOps —
+ * not a runtime workflow engine. JSON-safe form returned by `prepare*` tools and chat APIs.
+ * Primary payload is `steps`. Consumers simulate each step (see `@andrewkimjoseph/celina-sdk/simulation`),
+ * then call `sendTransactionAsync` (wagmi), `walletClient.sendTransaction` (viem), or
+ * `createAAClient().sendPreparedFlow` for sponsored UserOps.
  */
 export interface SerializedPreparedFlow extends Omit<PreparedFlow, "steps"> {
     steps: PreparedTx[];
     preparedFlow: true;
 }
-/** Marks a prepared flow as JSON-safe for API and chat tool responses. */
+/**
+ * Marks an ordered prepared-transaction list as JSON-safe for API and chat tool responses.
+ * @param flow - In-memory prepared transactions (`PreparedFlow`) to serialize
+ */
 export declare function serializePreparedFlow(flow: PreparedFlow): SerializedPreparedFlow;

package/build/types/prepared.js

@@ -1,4 +1,7 @@
-/** Marks a prepared flow as JSON-safe for API and chat tool responses. */
+/**
+ * Marks an ordered prepared-transaction list as JSON-safe for API and chat tool responses.
+ * @param flow - In-memory prepared transactions (`PreparedFlow`) to serialize
+ */
 export function serializePreparedFlow(flow) {
     return {
         ...flow,

package/build/types/prepared.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepared.js","sourceRoot":"","sources":["../../src/types/prepared.ts"],"names":[],"mappings":"AA8BA,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"prepared.js","sourceRoot":"","sources":["../../src/types/prepared.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,
@@ -99,6 +99,7 @@
     "@uniswap/universal-router-sdk": "^5.5.1",
     "@uniswap/v4-sdk": "^2.2.1",
     "ethers": "^6.15.0",
+    "permissionless": "^0.2.57",
     "viem": "^2.39.3",
     "zod": "^3.24.3"
   },