@ocap/tx-protocols 1.29.5 → 1.29.6

package/esm/execute.d.mts

@@ -27,6 +27,10 @@ interface IExecutionContext extends IGasContext {
   txn?: unknown;
   cacheStates?: unknown;
   senderState?: IAccountState;
+  /** Ledger sequence number set by WriteLedger pipe */
+  ledgerSequence?: number;
+  /** State commit hash set by onCommit callback (Dolt only) */
+  stateCommitHash?: string;
 }
 /** Protocol runner interface */
 interface IProtocolRunner {
@@ -41,6 +45,7 @@ interface IExecuteOptions {
     cleanWorkingSet: boolean;
     verifyHash: boolean;
     context: IExecutionContext;
+    onCommit?: (commitHash?: string) => void | Promise<void>;
   }) => Promise<T>;
 }
 /** Execute function type */

package/esm/execute.mjs

@@ -1,5 +1,6 @@
 import ensure_cost_default from "./pipes/ensure-cost.mjs";
 import ensure_gas_default from "./pipes/ensure-gas.mjs";
+import { WriteLedger } from "./pipes/write-ledger.mjs";
 import { Runner, pipes } from "@ocap/tx-pipeline";
 import { CustomError } from "@ocap/util/lib/error";
 import camelCase from "lodash/camelCase.js";
@@ -52,6 +53,7 @@ const createExecute = ({ filter, runAsLambda }) => {
 	});
 	pre.use(pipes.VerifyTxSize);
 	pre.use(pipes.VerifySignature);
+	pre.use(WriteLedger);
 	const ensureGasFeePaid = (context) => {
 		const gasRunner = new Runner("ensure-gas-fee-paid");
 		gasRunner.use(ensureTxGas);
@@ -142,11 +144,13 @@ const createExecute = ({ filter, runAsLambda }) => {
 					"txBase64",
 					"statedb",
 					"indexdb",
+					"ledger",
 					"config",
 					"states",
 					"filter",
 					"extra",
-					"logger"
+					"logger",
+					"ledgerSequence"
 				]);
 				ctx.txn = txn;
 				await execute(ctx, protocols, true);
@@ -156,9 +160,27 @@ const createExecute = ({ filter, runAsLambda }) => {
 			}, {
 				cleanWorkingSet: true,
 				verifyHash: true,
-				context: ctx
+				context: ctx,
+				onCommit: async (stateCommitHash) => {
+					if (ctx.txHash && ctx.ledger && ctx.ledgerSequence && ctx.txBase64) try {
+						await ctx.ledger.finalizeEntry(ctx.txHash, stateCommitHash || "", ctx.ledgerSequence, ctx.txBase64);
+						ctx.stateCommitHash = stateCommitHash || "";
+					} catch (err) {
+						ctx.logger?.error("Failed to finalize ledger entry", {
+							txHash: ctx.txHash,
+							stateCommitHash,
+							error: err
+						});
+					}
+				}
 			});
 			flushEvents(ctx, { txState });
+			ctx.ledger?.createCheckpointIfNeeded()?.catch((err) => {
+				ctx.logger?.error("Background checkpoint creation failed", {
+					txHash: ctx.txHash,
+					error: err
+				});
+			});
 			ctx.logger?.info("Tx finalized", {
 				txHash: ctx.txHash,
 				txState,
@@ -190,9 +212,27 @@ const createExecute = ({ filter, runAsLambda }) => {
 					}, {
 						cleanWorkingSet: true,
 						verifyHash: true,
-						context: ctx
+						context: ctx,
+						onCommit: async (stateCommitHash) => {
+							if (ctx.txHash && ctx.ledger && ctx.ledgerSequence && ctx.txBase64) try {
+								await ctx.ledger.finalizeEntry(ctx.txHash, stateCommitHash || "", ctx.ledgerSequence, ctx.txBase64);
+								ctx.stateCommitHash = stateCommitHash || "";
+							} catch (err$1) {
+								ctx.logger?.error("Failed to finalize ledger entry", {
+									txHash: ctx.txHash,
+									stateCommitHash,
+									error: err$1
+								});
+							}
+						}
 					});
 					flushEvents(ctx, { txState });
+					ctx.ledger?.createCheckpointIfNeeded()?.catch((err$1) => {
+						ctx.logger?.error("Background checkpoint creation failed", {
+							txHash: ctx.txHash,
+							error: err$1
+						});
+					});
 					ctx.logger?.info("Tx finalized", {
 						txHash: ctx.txHash,
 						txState,
@@ -217,7 +257,24 @@ const createExecute = ({ filter, runAsLambda }) => {
 		}
 		return ctx;
 	};
-	return execute;
+	return async (context, protocols) => {
+		const result = await execute(context, protocols);
+		if (result.ledger && result.txHash && result.ledgerSequence && result.txBase64) try {
+			await result.ledger.finalizeEntry(result.txHash, "", result.ledgerSequence, result.txBase64);
+		} catch (err) {
+			result.logger?.error("Failed to finalize ledger entry (fallback)", {
+				txHash: result.txHash,
+				error: err
+			});
+		}
+		result.ledger?.createCheckpointIfNeeded()?.catch((err) => {
+			result.logger?.error("Background checkpoint creation failed", {
+				txHash: result.txHash,
+				error: err
+			});
+		});
+		return result;
+	};
 };
 var execute_default = createExecute;