@ocap/types 1.30.2 → 1.30.4

package/interfaces/pipeline.ts

@@ -53,7 +53,16 @@ export interface IPipelineLogger {
   error: (message: string, ...args: unknown[]) => void;
 }
 
-/** Decoded transaction structure from protobuf */
+/**
+ * Decoded transaction — canonical camelCase shape (Phase 4 decision q11).
+ *
+ * Repeated fields use the `xxx` name (`signatures`, `tags`, `slashers`). The
+ * protobuf-wire `xxxList` alias is an `@ocap/proto/runtime` implementation
+ * detail and is not part of this interface. Pipe code still accessing
+ * `tx.signaturesList` at runtime (protobuf-decoded txs) falls through the
+ * index signature as `unknown`; prefer `getListField(tx, 'signatures')` to
+ * read either shape safely.
+ */
 export interface IDecodedTransaction {
   from: string;
   delegator?: string;
@@ -63,8 +72,6 @@ export interface IDecodedTransaction {
   pk: Uint8Array;
   signature?: Uint8Array | string;
   signatures?: IMultiSigData[];
-  /** Used during signature verification to hold processed signatures */
-  signaturesList?: Array<Omit<IMultiSigData, 'signature'>>;
   itx: IAny;
   /** Index signature for dynamic field access during verification */
   [key: string]: unknown;
@@ -167,6 +174,17 @@ export interface IInput {
 export interface IBaseContext<TItx = unknown> {
   /** Base64 encoded transaction */
   txBase64: string;
+  /**
+   * Wire encoding detected by `DecodeTx` from the first three bytes of the
+   * decoded payload. Downstream pipes (verify-signature, verify-multisig,
+   * and tx-protocols' `toItxAddress` call sites) must select the matching
+   * serializer. Literal union (not `string`) to catch typos at compile time.
+   *
+   * Populated by DecodeTx on Phase 1+; optional on `IBaseContext` so the
+   * pipeline can still type-check callers that build a bare base context
+   * (e.g. test harnesses that exercise DecodeTx first).
+   */
+  txEncoding?: 'cbor' | 'protobuf';
   /** State database instance */
   statedb: IStateDB;
   /** Chain configuration */
@@ -230,6 +248,12 @@ export interface ITxOnlyContext extends IBaseContext {
   txSize: number;
   /** Whether to charge base gas */
   txBaseGas: boolean;
+  /**
+   * Wire encoding of the transaction. Always populated by `DecodeTx` before
+   * any downstream pipe runs, hence required here and inherited by the
+   * decoded / gas / ready / executed phases via the extends chain.
+   */
+  txEncoding: 'cbor' | 'protobuf';
 }
 
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocap/types",
-  "version": "1.30.2",
+  "version": "1.30.4",
   "description": "Typescript definitions generated from protobuf",
   "keywords": [
     "ocap",