@cardananium/cquisitor-lib 0.1.0-beta.37 → 0.1.0-beta.39

package/node/cquisitor_lib.d.ts

@@ -509,13 +509,6 @@ export interface CostModels {
 
 
 ///AUTOGENERATED
-
-// Auto-generated TypeScript types from JSON schemas
-// Generated at: 2025-12-26T19:20:24.371Z
-//
-// This file contains exported TypeScript types that can be imported in other modules.
-// Large integers (uint64, int64) are represented as bigint for safe handling.
-
 export interface NecessaryInputData {
   accounts: string[];
   committeeMembersCold: LocalCredential[];
@@ -1011,11 +1004,15 @@ export type Phase1Error =
   | {
       ScriptDataHashMismatch: {
         /**
-         * The expected script data hash
+         * Decomposition of the expected hash computation
+         */
+        expected_decomposition?: ScriptDataHashDecomposition | null;
+        /**
+         * The expected script data hash (computed from witness set)
          */
         expected_hash?: string | null;
         /**
-         * The actual script data hash
+         * The provided script data hash (from transaction body)
          */
         provided_hash?: string | null;
       };
@@ -1026,9 +1023,6 @@ export type Phase1Error =
       };
     };
 
-/**
- * Phase 1 validation errors
- */
 export type Phase2Error =
   | "NativeScriptIsReferencedByRedeemer"
   | {
@@ -1238,6 +1232,76 @@ export interface ProtocolVersion {
  * The governance action with zero withdrawals
  */
 
+/**
+ * Decomposition of script_data_hash computation for debugging.
+ *
+ *  The script_data_hash is computed as blake2b256 of concatenated bytes in a specific format.
+ *  This structure provides the raw CBOR data and explains the encoding used.
+ *
+ *  ## script_data_hash format (Alonzo+ ledger spec):
+ *
+ *  Standard: `blake2b256(redeemers || datums || used_cost_models)`
+ *  Datums-only: `blake2b256(0xA0 || datums || 0xA0)` (when no redeemers)
+ *
+ *  All components must be serialized according to the ledger CDDL specification.
+ *
+ *  ### Redeemers
+ *  - **Pre-Conway**: array format
+ *  - **Conway+**: map format
+ *  - Original format from deserialization is preserved
+ *
+ *  ### Datums
+ *  - For hash: uses CBOR set encoding (tag 258) with deduplication
+ *  - May use indefinite length encoding
+ *
+ *  ### Cost Models
+ *
+ *  **Encoding rules:**
+ *  - Keys sorted by **length first**, then lexicographically
+ *  - **PlutusV1 special case** (cardano-node bug workaround):
+ *    - Key `0` serialized as `bytes(0x00)` instead of integer
+ *    - Value wrapped in bytestring containing **indefinite length array**
+ *    - Format: `{ bytes(0x00): bytes(9F cost1 cost2 ... FF) }`
+ *  - **PlutusV2** (key=1) and **PlutusV3** (key=2): standard integer key with array value
+ */
+export interface ScriptDataHashDecomposition {
+  /**
+   * Cost models CBOR hex (standard map encoding)
+   */
+  costModelsCbor?: string | null;
+  /**
+   * Datums CBOR hex (standard array encoding)
+   *  Note: for hash computation uses set encoding (tag 258 + deduplication)
+   */
+  datumsCbor?: string | null;
+  /**
+   * Number of datums
+   */
+  datumsCount?: number | null;
+  /**
+   * Which encoding format was used for script_data_hash
+   *  - "standard": redeemers || datums || used_cost_models
+   *  - "datums_only": 0xA0 || datums || 0xA0 (when no redeemers but has datums)
+   */
+  encodingFormat: string;
+  /**
+   * Description of what is actually concatenated for hashing
+   */
+  hashInputDescription: string;
+  /**
+   * Plutus versions used (e.g. ["PlutusV1", "PlutusV2", "PlutusV3"])
+   */
+  plutusVersionsUsed: string[];
+  /**
+   * Redeemers CBOR hex (serialized per CDDL, preserves original Map or Array format)
+   */
+  redeemersCbor?: string | null;
+  /**
+   * Number of redeemers
+   */
+  redeemersCount: number;
+}
+
 export interface EvalRedeemerResult {
   calculated_ex_units: ExUnits;
   error?: string | null;
@@ -1404,6 +1468,7 @@ export interface ProtocolParameters {
    */
   stakePoolDeposit: bigint;
 }
+
 /**
  * Price of execution units for script execution
  */
@@ -1415,15 +1480,8 @@ export interface SubCoin {
   denominator: bigint;
   numerator: bigint;
 }
-/**
- * Maximum execution units allowed for a transaction
- */
-
-/**
- * Coins per byte for reference scripts
- */
 
 export interface UtxoInputContext {
   isSpent: boolean;
   utxo: UTxO;
-}
+}