@ocap/tx-protocols 1.29.4 → 1.29.6

package/esm/protocols/trade/transfer-v2.d.mts

@@ -1,9 +1,40 @@
+import { Runner } from "@ocap/tx-pipeline";
+import { IAssetState, IReadyContext, ITokenState, IWithDelegation, IWithDelegator, IWithReceiver, IWithSender, TTransferV2Tx } from "@ocap/types";
+
 //#region src/protocols/trade/transfer-v2.d.ts
 /** Token input */
 interface TokenInput {
   address: string;
   value: string;
 }
-declare const runner: any;
+/**
+ * Context type for transfer-v2 protocol.
+ * Phase: IReadyContext (after TakeStateSnapshot)
+ * Mixins: IWithSender, IWithReceiver, IWithDelegator, IWithDelegation (all optional as states may not exist)
+ */
+type Context = IReadyContext<TTransferV2Tx> & Partial<IWithSender> & Partial<IWithReceiver> & Partial<IWithDelegator> & Partial<IWithDelegation> & {
+  /** Asset addresses to transfer */
+  assets?: string[];
+  /** Token inputs to transfer */
+  tokens?: TokenInput[];
+  /** Token addresses extracted from inputs */
+  tokenAddress?: string[];
+  /** Token conditions for balance verification */
+  tokenConditions?: {
+    owner: string;
+    tokens: TokenInput[];
+  };
+  /** Token states for transferred tokens */
+  tokenStates?: ITokenState[];
+  /** Asset states for transferred assets */
+  assetStates?: IAssetState[];
+  /** Receiver address (extracted from itx.to) */
+  receiver?: string;
+  /** Resolved receiver address */
+  receiverAddr?: string;
+  /** Whether delegation was changed during tx */
+  isDelegationChanged?: boolean;
+};
+declare const runner: Runner<Context>;
 //#endregion
 export { TokenInput, runner as default };

package/esm/protocols/trade/transfer-v3.d.mts

@@ -1,3 +1,6 @@
+import { Runner } from "@ocap/tx-pipeline";
+import { IAssetState, IReadyContext, ITokenState, IWithReceivers, IWithSender, IWithSigners, TTransferV3Tx } from "@ocap/types";
+
 //#region src/protocols/trade/transfer-v3.d.ts
 /** Token input type */
 interface TokenInput {
@@ -12,6 +15,33 @@ interface MultiInput {
   assetsList?: string[];
   assets?: string[];
 }
-declare const runner: any;
+/**
+ * Context type for transfer-v3 protocol.
+ * Phase: IReadyContext (after TakeStateSnapshot)
+ * Mixins: IWithSender, IWithSigners, IWithReceivers (all optional as states may not exist initially)
+ */
+type Context = IReadyContext<TTransferV3Tx> & Partial<IWithSender> & Partial<IWithSigners> & Partial<IWithReceivers> & {
+  /** Parsed inputs from itx */
+  inputs?: MultiInput[];
+  /** Parsed outputs from itx */
+  outputs?: MultiInput[];
+  /** Sender addresses extracted from inputs */
+  senders?: string[];
+  /** Receiver addresses extracted from outputs */
+  receivers?: string[];
+  /** Token addresses from inputs */
+  inputTokens?: string[];
+  /** Asset addresses from inputs */
+  inputAssets?: string[];
+  /** Token addresses from outputs */
+  outputTokens?: string[];
+  /** Asset addresses from outputs */
+  outputAssets?: string[];
+  /** Token states for transferred tokens */
+  tokenStates?: ITokenState[];
+  /** Asset states for transferred assets */
+  assetStates?: IAssetState[];
+};
+declare const runner: Runner<Context>;
 //#endregion
 export { MultiInput, TokenInput, runner as default };

package/esm/util.d.mts

@@ -111,7 +111,7 @@ interface ITokenInputForFix {
     value: string;
   }>;
 }
-declare const RATE_BASE: any;
+declare const RATE_BASE: BN;
 declare const decodeAnySafe: (encoded: AnyData | null) => AnyData | null;
 declare const applyTokenUpdates: (tokens: ITokenUpdateInput[], state: IStateWithTokens | IStateWithTokens[] | null | undefined, operator: "add" | "sub") => IStateWithTokens | IStateWithTokens[] | Record<string, string>;
 declare const applyTokenChange: (state: IStateWithTokens | IStateWithTokens[], change: ITokenChange) => IStateWithTokens | IStateWithTokens[] | Record<string, never>;

package/lib/execute.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_pipes_ensure_cost = require('./pipes/ensure-cost.cjs');
 const require_pipes_ensure_gas = require('./pipes/ensure-gas.cjs');
+const require_pipes_write_ledger = require('./pipes/write-ledger.cjs');
 let _ocap_tx_pipeline = require("@ocap/tx-pipeline");
 let _ocap_util_lib_error = require("@ocap/util/lib/error");
 let lodash_camelCase = require("lodash/camelCase");
@@ -58,6 +59,7 @@ const createExecute = ({ filter, runAsLambda }) => {
 	});
 	pre.use(_ocap_tx_pipeline.pipes.VerifyTxSize);
 	pre.use(_ocap_tx_pipeline.pipes.VerifySignature);
+	pre.use(require_pipes_write_ledger.WriteLedger);
 	const ensureGasFeePaid = (context) => {
 		const gasRunner = new _ocap_tx_pipeline.Runner("ensure-gas-fee-paid");
 		gasRunner.use(ensureTxGas);
@@ -148,11 +150,13 @@ const createExecute = ({ filter, runAsLambda }) => {
 					"txBase64",
 					"statedb",
 					"indexdb",
+					"ledger",
 					"config",
 					"states",
 					"filter",
 					"extra",
-					"logger"
+					"logger",
+					"ledgerSequence"
 				]);
 				ctx.txn = txn;
 				await execute(ctx, protocols, true);
@@ -162,9 +166,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,
@@ -196,9 +218,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,
@@ -223,7 +263,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;
 

package/lib/execute.d.cts

@@ -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/lib/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_pipes_write_ledger = require('./pipes/write-ledger.cjs');
 const require_execute = require('./execute.cjs');
 const require_protocols_account_delegate = require('./protocols/account/delegate.cjs');
 const require_protocols_account_migrate = require('./protocols/account/migrate.cjs');
@@ -100,6 +101,7 @@ const { execute } = defaultExecutor;
 var src_default = defaultExecutor;
 
 //#endregion
+exports.WriteLedger = require_pipes_write_ledger.WriteLedger;
 exports.createExecutor = createExecutor;
 exports.default = src_default;
 exports.execute = execute;