@andrewkimjoseph/celina-sdk 0.9.5 → 0.9.6

package/build/simulation/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Browser-safe prepared-step simulation (no Node analytics / wallet product logic).
+ */
+export type { PreparedTx } from "../types/prepared.js";
+export { simulatePreparedStep, type SimulatePreparedStepOptions, type SimulatePreparedStepParams, } from "./simulate-prepared-step.js";

package/build/simulation/index.js

@@ -0,0 +1,2 @@
+export { simulatePreparedStep, } from "./simulate-prepared-step.js";
+//# sourceMappingURL=index.js.map

package/build/simulation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/simulation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,GAGrB,MAAM,6BAA6B,CAAC"}

package/build/simulation/simulate-prepared-step.d.ts

@@ -0,0 +1,17 @@
+import { type PublicClient, type StateOverride } from "viem";
+import type { PreparedTx } from "../types/prepared.js";
+/** Optional host overrides for Celo fee abstraction or custom state. */
+export type SimulatePreparedStepOptions = {
+    /** Celo fee-abstraction currency — host-provided, never auto-resolved by the SDK. */
+    feeCurrency?: `0x${string}`;
+    stateOverride?: StateOverride;
+};
+export type SimulatePreparedStepParams = {
+    account: `0x${string}`;
+    step: PreparedTx;
+};
+/**
+ * Simulate a prepared transaction step against current chain state.
+ * Throws when the transaction would revert — call immediately before send.
+ */
+export declare function simulatePreparedStep(publicClient: PublicClient, params: SimulatePreparedStepParams, options?: SimulatePreparedStepOptions): Promise<void>;

package/build/simulation/simulate-prepared-step.js

@@ -0,0 +1,42 @@
+import { isInsufficientBalanceSimulationError } from "../utils/transaction-errors.js";
+function stepRequest(account, step) {
+    return {
+        account,
+        to: step.to,
+        data: (step.data ?? "0x"),
+        value: step.value ? BigInt(step.value) : 0n,
+    };
+}
+function simulationErrorMessage(step, cause) {
+    const base = cause instanceof Error ? cause.message : String(cause);
+    if (isInsufficientBalanceSimulationError(cause)) {
+        return (`Simulation failed for "${step.description}": insufficient balance. (${base})`);
+    }
+    return `Simulation failed for "${step.description}": ${base}`;
+}
+/**
+ * Simulate a prepared transaction step against current chain state.
+ * Throws when the transaction would revert — call immediately before send.
+ */
+export async function simulatePreparedStep(publicClient, params, options) {
+    const request = stepRequest(params.account, params.step);
+    const stateOverride = options?.stateOverride;
+    try {
+        if (options?.feeCurrency) {
+            await publicClient.estimateGas({
+                ...request,
+                feeCurrency: options.feeCurrency,
+                ...(stateOverride ? { stateOverride } : {}),
+            });
+            return;
+        }
+        await publicClient.call({
+            ...request,
+            ...(stateOverride ? { stateOverride } : {}),
+        });
+    }
+    catch (error) {
+        throw new Error(simulationErrorMessage(params.step, error));
+    }
+}
+//# sourceMappingURL=simulate-prepared-step.js.map

package/build/simulation/simulate-prepared-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-prepared-step.js","sourceRoot":"","sources":["../../src/simulation/simulate-prepared-step.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAC;AActF,SAAS,WAAW,CAClB,OAAsB,EACtB,IAAgB;IAOhB,OAAO;QACL,OAAO;QACP,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAQ;QAChC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAgB,EAAE,KAAc;IAC9D,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpE,IAAI,oCAAoC,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,CACL,0BAA0B,IAAI,CAAC,WAAW,6BAA6B,IAAI,GAAG,CAC/E,CAAC;IACJ,CAAC;IAED,OAAO,0BAA0B,IAAI,CAAC,WAAW,MAAM,IAAI,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAA0B,EAC1B,MAAkC,EAClC,OAAqC;IAErC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;IAE7C,IAAI,CAAC;QACH,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACzB,MAAM,YAAY,CAAC,WAAW,CAAC;gBAC7B,GAAG,OAAO;gBACV,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACE,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,YAAY,CAAC,IAAI,CAAC;YACtB,GAAG,OAAO;YACV,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,
@@ -31,6 +31,11 @@
       "types": "./build/oasf/index.d.ts",
       "import": "./build/oasf/index.js",
       "default": "./build/oasf/index.js"
+    },
+    "./simulation": {
+      "types": "./build/simulation/index.d.ts",
+      "import": "./build/simulation/index.js",
+      "default": "./build/simulation/index.js"
     }
   },
   "files": [