@cardananium/cquisitor-lib 0.1.0-beta.3 → 0.1.0-beta.30

package/node/cquisitor_lib.d.ts

@@ -1,3 +1,15 @@
+/**
+* @param {string} tx_hex
+* @returns {string}
+*/
+export function get_necessary_data_list_js(tx_hex: string): string;
+/**
+* @param {string} tx_hex
+* @param {ValidationInputContext} validation_context
+* @returns {string}
+*/
+export function validate_transaction_js(tx_hex: string, validation_context: string): string;
+
 /**
  * @returns {(string)[]}
  */
@@ -45,6 +57,12 @@ export function decode_plutus_program_uplc_json(hex: string): ProgramJson;
  * @returns {string}
  */
 export function decode_plutus_program_pretty_uplc(hex: string): string;
+/**
+ * @param {string} tx_hex
+ * @param {number} output_index
+ * @returns {string}
+ */
+export function get_ref_script_bytes(tx_hex: string, output_index: number): string;
 
 export interface CborPosition {
     offset: number;
@@ -73,6 +91,7 @@ export type CborSimpleType =
     | "Break";
 
 export interface CborSimple {
+    type: CborSimpleType;
     position_info: CborPosition;
     struct_position_info?: CborPosition;
     value: any;
@@ -414,4 +433,927 @@ export interface CostModels {
     plutusV1?: number[];
     plutusV2?: number[];
     plutusV3?: number[];
-}
+}
+
+
+///AUTOGENERATED
+
+// Auto-generated TypeScript types from JSON schemas
+// Generated at: 2025-08-03T17:09:36.018Z
+//
+// 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[];
+    committeeMembersHot: LocalCredential[];
+    dReps: string[];
+    govActions: GovernanceActionId[];
+    lastEnactedGovAction: GovernanceActionType[];
+    pools: string[];
+    utxos: TxInput[];
+  }
+  
+  /**
+   * Phase 1 validation errors
+   */
+  export type Phase1Error =
+    | (
+        | "GenesisKeyDelegationCertificateIsNotSupported"
+        | "MoveInstantaneousRewardsCertificateIsNotSupported"
+      )
+    | {
+        BadInputsUTxO: {
+          invalid_input: TxInput;
+        };
+      }
+    | {
+        OutsideValidityIntervalUTxO: {
+          current_slot: bigint;
+          interval_end: bigint;
+          interval_start: bigint;
+        };
+      }
+    | {
+        MaxTxSizeUTxO: {
+          actual_size: bigint;
+          max_size: bigint;
+        };
+      }
+    | "InputSetEmptyUTxO"
+    | {
+        FeeTooSmallUTxO: {
+          actual_fee: bigint;
+          fee_decomposition: FeeDecomposition;
+          min_fee: bigint;
+        };
+      }
+    | {
+        ValueNotConservedUTxO: {
+          difference: Value;
+          input_sum: Value;
+          output_sum: Value;
+        };
+      }
+    | {
+        WrongNetwork: {
+          wrong_addresses: string[];
+        };
+      }
+    | {
+        WrongNetworkWithdrawal: {
+          wrong_addresses: string[];
+        };
+      }
+    | {
+        WrongNetworkInTxBody: {
+          actual_network: number;
+          expected_network: number;
+        };
+      }
+    | {
+        OutputTooSmallUTxO: {
+          min_amount: number;
+          output_amount: number;
+        };
+      }
+    | {
+        CollateralReturnTooSmall: {
+          min_amount: number;
+          output_amount: number;
+        };
+      }
+    | {
+        OutputBootAddrAttrsTooBig: {
+          actual_size: bigint;
+          max_size: bigint;
+          output: unknown;
+        };
+      }
+    | {
+        OutputsValueTooBig: {
+          actual_size: bigint;
+          max_size: bigint;
+        };
+      }
+    | {
+        InsufficientCollateral: {
+          required_collateral: number;
+          total_collateral: number;
+        };
+      }
+    | {
+        ExUnitsTooBigUTxO: {
+          actual_memory_units: bigint;
+          actual_steps_units: bigint;
+          max_memory_units: bigint;
+          max_steps_units: bigint;
+        };
+      }
+    | "CalculatedCollateralContainsNonAdaAssets"
+    | {
+        CollateralInputContainsNonAdaAssets: {
+          collateral_input: string;
+        };
+      }
+    | {
+        CollateralIsLockedByScript: {
+          invalid_collateral: string;
+        };
+      }
+    | {
+        TooManyCollateralInputs: {
+          actual_count: number;
+          max_count: number;
+        };
+      }
+    | "NoCollateralInputs"
+    | {
+        IncorrectTotalCollateralField: {
+          actual_sum: number;
+          declared_total: number;
+        };
+      }
+    | {
+        InvalidSignature: {
+          invalid_signature: string;
+        };
+      }
+    | {
+        ExtraneousSignature: {
+          extraneous_signature: string;
+        };
+      }
+    | {
+        NativeScriptIsUnsuccessful: {
+          native_script_hash: string;
+        };
+      }
+    | {
+        PlutusScriptIsUnsuccessful: {
+          plutus_script_hash: string;
+        };
+      }
+    | {
+        MissingVKeyWitnesses: {
+          missing_key_hash: string;
+        };
+      }
+    | {
+        MissingScriptWitnesses: {
+          missing_script_hash: string;
+        };
+      }
+    | {
+        MissingRedeemer: {
+          index: bigint;
+          tag: string;
+        };
+      }
+    | "MissingTxBodyMetadataHash"
+    | "MissingTxMetadata"
+    | {
+        ConflictingMetadataHash: {
+          actual_hash: string;
+          expected_hash: string;
+        };
+      }
+    | {
+        InvalidMetadata: {
+          message: string;
+        };
+      }
+    | {
+        ExtraneousScriptWitnesses: {
+          extraneous_script: string;
+        };
+      }
+    | {
+        StakeAlreadyRegistered: {
+          reward_address: string;
+        };
+      }
+    | {
+        StakeNotRegistered: {
+          reward_address: string;
+        };
+      }
+    | {
+        StakeNonZeroAccountBalance: {
+          remaining_balance: bigint;
+          reward_address: string;
+        };
+      }
+    | {
+        RewardAccountNotExisting: {
+          reward_address: string;
+        };
+      }
+    | {
+        WrongRequestedWithdrawalAmount: {
+          expected_amount: number;
+          requested_amount: bigint;
+          reward_address: string;
+        };
+      }
+    | {
+        StakePoolNotRegistered: {
+          pool_id: string;
+        };
+      }
+    | {
+        WrongRetirementEpoch: {
+          current_epoch: bigint;
+          max_epoch: bigint;
+          min_epoch: bigint;
+          specified_epoch: bigint;
+        };
+      }
+    | {
+        StakePoolCostTooLow: {
+          min_cost: bigint;
+          specified_cost: bigint;
+        };
+      }
+    | {
+        InsufficientFundsForMir: {
+          available_amount: bigint;
+          requested_amount: bigint;
+        };
+      }
+    | {
+        InvalidCommitteeVote: {
+          message: string;
+          voter: unknown;
+        };
+      }
+    | {
+        DRepIncorrectDeposit: {
+          required_deposit: number;
+          supplied_deposit: number;
+        };
+      }
+    | {
+        DRepDeregistrationWrongRefund: {
+          required_refund: number;
+          supplied_refund: number;
+        };
+      }
+    | {
+        StakeRegistrationWrongDeposit: {
+          required_deposit: number;
+          supplied_deposit: number;
+        };
+      }
+    | {
+        StakeDeregistrationWrongRefund: {
+          required_refund: number;
+          supplied_refund: number;
+        };
+      }
+    | {
+        PoolRegistrationWrongDeposit: {
+          required_deposit: number;
+          supplied_deposit: number;
+        };
+      }
+    | {
+        CommitteeHasPreviouslyResigned: {
+          committee_credential: LocalCredential;
+        };
+      }
+    | {
+        TreasuryValueMismatch: {
+          actual_value: bigint;
+          declared_value: bigint;
+        };
+      }
+    | {
+        RefScriptsSizeTooBig: {
+          actual_size: bigint;
+          max_size: bigint;
+        };
+      }
+    | {
+        WithdrawalNotAllowedBecauseNotDelegatedToDRep: {
+          reward_address: string;
+        };
+      }
+    | {
+        CommitteeIsUnknown: {
+          /**
+           * The committee key hash
+           */
+          committee_key_hash:
+            | {
+                keyHash: number[];
+              }
+            | {
+                scriptHash: number[];
+              };
+        };
+      }
+    | {
+        GovActionsDoNotExist: {
+          /**
+           * The list of invalid governance action IDs
+           */
+          invalid_action_ids: GovernanceActionId[];
+        };
+      }
+    | {
+        MalformedProposal: {
+          gov_action: GovernanceActionId;
+        };
+      }
+    | {
+        ProposalProcedureNetworkIdMismatch: {
+          /**
+           * The expected network ID
+           */
+          expected_network: number;
+          /**
+           * The reward account
+           */
+          reward_account: string;
+        };
+      }
+    | {
+        TreasuryWithdrawalsNetworkIdMismatch: {
+          /**
+           * The expected network ID
+           */
+          expected_network: number;
+          /**
+           * The set of mismatched reward accounts
+           */
+          mismatched_account: string;
+        };
+      }
+    | {
+        VotingProposalIncorrectDeposit: {
+          proposal_index: number;
+          /**
+           * The required deposit amount
+           */
+          required_deposit: number;
+          /**
+           * The supplied deposit amount
+           */
+          supplied_deposit: number;
+        };
+      }
+    | {
+        DisallowedVoters: {
+          /**
+           * List of disallowed voter and action ID pairs
+           */
+          disallowed_pairs: [unknown, unknown][];
+        };
+      }
+    | {
+        ConflictingCommitteeUpdate: {
+          /**
+           * The set of conflicting credentials
+           */
+          conflicting_credentials:
+            | {
+                keyHash: number[];
+              }
+            | {
+                scriptHash: number[];
+              };
+        };
+      }
+    | {
+        ExpirationEpochTooSmall: {
+          /**
+           * Map of credentials to their invalid expiration epochs
+           */
+          invalid_expirations: {
+            [k: string]: number;
+          };
+        };
+      }
+    | {
+        InvalidPrevGovActionId: {
+          /**
+           * The invalid proposal
+           */
+          proposal: {
+            [k: string]: unknown;
+          };
+        };
+      }
+    | {
+        VotingOnExpiredGovAction: {
+          expired_gov_action: GovernanceActionId;
+        };
+      }
+    | {
+        ProposalCantFollow: {
+          /**
+           * The expected protocol version
+           */
+          expected_versions: ProtocolVersion[];
+          /**
+           * Previous governance action ID
+           */
+          prev_gov_action_id?: GovernanceActionId | null;
+          supplied_version: ProtocolVersion;
+        };
+      }
+    | {
+        InvalidConstitutionPolicyHash: {
+          /**
+           * The expected policy hash
+           */
+          expected_hash?: string | null;
+          /**
+           * The supplied policy hash
+           */
+          supplied_hash?: string | null;
+        };
+      }
+    | {
+        VoterDoNotExist: {
+          /**
+           * List of non-existent voters
+           */
+          missing_voter: {
+            [k: string]: unknown;
+          };
+        };
+      }
+    | {
+        ZeroTreasuryWithdrawals: {
+          gov_action: GovernanceActionId;
+        };
+      }
+    | {
+        ProposalReturnAccountDoesNotExist: {
+          /**
+           * The invalid return account
+           */
+          return_account: string;
+        };
+      }
+    | {
+        TreasuryWithdrawalReturnAccountsDoNotExist: {
+          /**
+           * List of non-existent return accounts
+           */
+          missing_account: string;
+        };
+      }
+    | {
+        AuxiliaryDataHashMismatch: {
+          /**
+           * The actual auxiliary data hash
+           */
+          actual_hash?: string | null;
+          /**
+           * The expected auxiliary data hash
+           */
+          expected_hash: string;
+        };
+      }
+    | "AuxiliaryDataHashMissing"
+    | "AuxiliaryDataHashPresentButNotExpected"
+    | {
+        UnknownError: {
+          message: string;
+        };
+      }
+    | {
+        MissingDatum: {
+          datum_hash: string;
+        };
+      }
+    | {
+        ExtraneousDatumWitnesses: {
+          datum_hash: string;
+        };
+      }
+    | {
+        ScriptDataHashMismatch: {
+          /**
+           * The expected script data hash
+           */
+          expected_hash?: string | null;
+          /**
+           * The actual script data hash
+           */
+          provided_hash?: string | null;
+        };
+      }
+    | {
+        ReferenceInputOverlapsWithInput: {
+          input: TxInput;
+        };
+      };
+  
+  /**
+   * Phase 1 validation errors
+   */
+  export type Phase2Error =
+    | "NativeScriptIsReferencedByRedeemer"
+    | {
+        NoEnoughBudget: {
+          actual_budget: ExUnits;
+          expected_budget: ExUnits;
+        };
+      }
+    | {
+        InvalidRedeemerIndex: {
+          index: bigint;
+          tag: string;
+        };
+      }
+    | {
+        MachineError: {
+          error: string;
+        };
+      }
+    | {
+        CostModelNotFound: {
+          language: string;
+        };
+      }
+    | {
+        ScriptDecodeError: {
+          error: string;
+        };
+      }
+    | {
+        ResolvedInputNotFound: {
+          tx_hash: string;
+          tx_index: bigint;
+        };
+      }
+    | "ByronAddressNotAllowed"
+    | "InlineDatumNotAllowedForPlutusV1"
+    | "ReferenceInputsNotAllowedForPlutusV1"
+    | {
+        SlotTooFarInThePast: {
+          oldest_allowed: bigint;
+        };
+      }
+    | "NoPaymentCredential"
+    | {
+        ExtraneousRedeemer: {
+          index: bigint;
+          tag: string;
+        };
+      }
+    | {
+        BuildTxContextError: {
+          error: string;
+        };
+      }
+    | {
+        RedeemerIndexOutOfBounds: {
+          index: bigint;
+          max_index?: number | null;
+          tag: string;
+        };
+      }
+    | {
+        MissingRequiredScript: {
+          script_hash: string;
+        };
+      }
+    | {
+        MissingRequiredDatum: {
+          datum_hash: string;
+        };
+      }
+    | "NonScriptWithdrawal"
+    | "NonScriptCredential"
+    | "UnsupportedCertificateType"
+    | "NoGuardrailScriptForProcedure"
+    | "MissingRequiredInlineDatumOrHash"
+    | {
+        ScriptLookupError: {
+          error: string;
+        };
+      };
+  export type Phase2Warning = {
+    BudgetIsBiggerThanExpected: {
+      actual_budget: ExUnits;
+      expected_budget: ExUnits;
+    };
+  };
+  export type Phase1Warning =
+    | ("InputsAreNotSorted" | "CollateralIsUnnecessary" | "TotalCollateralIsNotDeclared")
+    | {
+        FeeIsBiggerThanMinFee: {
+          actual_fee: bigint;
+          fee_decomposition: FeeDecomposition;
+          min_fee: bigint;
+        };
+      }
+    | {
+        InputUsesRewardAddress: {
+          invalid_input: string;
+        };
+      }
+    | {
+        CollateralInputUsesRewardAddress: {
+          invalid_collateral: string;
+        };
+      }
+    | "CannotCheckStakeDeregistrationRefund"
+    | "CannotCheckDRepDeregistrationRefund"
+    | {
+        PoolAlreadyRegistered: {
+          pool_id: string;
+        };
+      }
+    | {
+        DRepAlreadyRegistered: {
+          drep_id: string;
+        };
+      }
+    | {
+        CommitteeAlreadyAuthorized: {
+          committee_key: string;
+        };
+      }
+    | {
+        DRepNotRegistered: {
+          cert_index: number;
+        };
+      }
+    | {
+        DuplicateRegistrationInTx: {
+          cert_index: number;
+          entity_id: string;
+          entity_type: string;
+        };
+      }
+    | {
+        DuplicateCommitteeColdResignationInTx: {
+          cert_index: number;
+          committee_credential: LocalCredential;
+        };
+      }
+    | {
+        DuplicateCommitteeHotRegistrationInTx: {
+          cert_index: number;
+          committee_credential: LocalCredential;
+        };
+      };
+  
+  export interface ValidationResult {
+    errors: ValidationPhase1Error[];
+    eval_redeemer_results: EvalRedeemerResult[];
+    phase2_errors: ValidationPhase2Error[];
+    phase2_warnings: ValidationPhase2Warning[];
+    warnings: ValidationPhase1Warning[];
+  }
+  export interface ValidationPhase1Error {
+    error: Phase1Error;
+    error_message: string;
+    hint?: string | null;
+    locations: string[];
+  }
+  /**
+   * The invalid input UTxO
+   */
+  
+  export interface FeeDecomposition {
+    executionUnitsFee: bigint;
+    referenceScriptsFee: bigint;
+    txSizeFee: bigint;
+  }
+  export interface Value {
+    assets: MultiAsset;
+    coins: number;
+  }
+  export interface MultiAsset {
+    assets: ValidatorAsset[];
+  }
+  export interface ValidatorAsset {
+    asset_name: string;
+    policy_id: string;
+    quantity: number;
+  }
+  
+  /**
+   * The invalid governance action
+   */
+  
+  /**
+   * The expired governance action
+   */
+  
+  export interface ProtocolVersion {
+    major: bigint;
+    minor: bigint;
+  }
+  /**
+   * The supplied protocol version
+   */
+  
+  /**
+   * The governance action with zero withdrawals
+   */
+  
+  export interface EvalRedeemerResult {
+    calculated_ex_units: ExUnits;
+    error?: string | null;
+    index: bigint;
+    logs: string[];
+    provided_ex_units: ExUnits;
+    success: boolean;
+    tag: RedeemerTag;
+  }
+  
+  export interface ValidationPhase2Error {
+    error: Phase2Error;
+    error_message: string;
+    hint?: string | null;
+    locations: string[];
+  }
+  export interface ValidationPhase2Warning {
+    hint?: string | null;
+    locations: string[];
+    warning: Phase2Warning;
+  }
+  export interface ValidationPhase1Warning {
+    hint?: string | null;
+    locations: string[];
+    warning: Phase1Warning;
+  }
+  
+  export type LocalCredential =
+    | {
+        keyHash: number[];
+      }
+    | {
+        scriptHash: number[];
+      };
+  export type GovernanceActionType =
+    | "parameterChangeAction"
+    | "hardForkInitiationAction"
+    | "treasuryWithdrawalsAction"
+    | "noConfidenceAction"
+    | "updateCommitteeAction"
+    | "newConstitutionAction"
+    | "infoAction";
+  export type NetworkType = "mainnet" | "preview" | "preprod";
+  
+  export interface ValidationInputContext {
+    accountContexts: AccountInputContext[];
+    currentCommitteeMembers: CommitteeInputContext[];
+    drepContexts: DrepInputContext[];
+    govActionContexts: GovActionInputContext[];
+    lastEnactedGovAction: GovActionInputContext[];
+    networkType: NetworkType;
+    poolContexts: PoolInputContext[];
+    potentialCommitteeMembers: CommitteeInputContext[];
+    protocolParameters: ProtocolParameters;
+    slot: bigint;
+    treasuryValue: bigint;
+    utxoSet: UtxoInputContext[];
+  }
+  export interface AccountInputContext {
+    balance?: number | null;
+    bech32Address: string;
+    delegatedToDrep?: string | null;
+    delegatedToPool?: string | null;
+    isRegistered: boolean;
+    payedDeposit?: number | null;
+  }
+  export interface CommitteeInputContext {
+    committeeMemberCold: LocalCredential;
+    committeeMemberHot?: LocalCredential | null;
+    isResigned: boolean;
+  }
+  export interface DrepInputContext {
+    bech32Drep: string;
+    isRegistered: boolean;
+    payedDeposit?: number | null;
+  }
+  export interface GovActionInputContext {
+    actionId: GovernanceActionId;
+    actionType: GovernanceActionType;
+    isActive: boolean;
+  }
+  export interface GovernanceActionId {
+    index: bigint;
+    txHash: number[];
+  }
+  export interface PoolInputContext {
+    isRegistered: boolean;
+    poolId: string;
+    retirementEpoch?: number | null;
+  }
+  export interface ProtocolParameters {
+    /**
+     * Cost per UTxO byte in lovelace
+     */
+    adaPerUtxoByte: bigint;
+    /**
+     * Percentage of transaction fee required as collateral
+     */
+    collateralPercentage: number;
+    costModels: CostModels;
+    /**
+     * Deposit amount required for registering as a DRep
+     */
+    drepDeposit: bigint;
+    executionPrices: ExUnitPrices;
+    /**
+     * Deposit amount required for submitting a governance action
+     */
+    governanceActionDeposit: bigint;
+    /**
+     * Maximum block body size in bytes
+     */
+    maxBlockBodySize: number;
+    maxBlockExecutionUnits: ExUnits;
+    /**
+     * Maximum block header size in bytes
+     */
+    maxBlockHeaderSize: number;
+    /**
+     * Maximum number of collateral inputs
+     */
+    maxCollateralInputs: number;
+    /**
+     * Maximum number of epochs that can be used for pool retirement ahead
+     */
+    maxEpochForPoolRetirement: number;
+    /**
+     * Maximum transaction size in bytes
+     */
+    maxTransactionSize: number;
+    maxTxExecutionUnits: ExUnits;
+    /**
+     * Maximum size of a Value in bytes
+     */
+    maxValueSize: number;
+    /**
+     * Linear factor for the minimum fee calculation formula
+     */
+    minFeeCoefficientA: bigint;
+    /**
+     * Constant factor for the minimum fee calculation formula
+     */
+    minFeeConstantB: bigint;
+    /**
+     * Minimum pool cost in lovelace
+     */
+    minPoolCost: bigint;
+    /**
+     * Protocol version (major, minor)
+     *
+     * @minItems 2
+     * @maxItems 2
+     */
+    protocolVersion: [unknown, unknown];
+    referenceScriptCostPerByte: SubCoin;
+    /**
+     * Deposit amount required for registering a stake key
+     */
+    stakeKeyDeposit: bigint;
+    /**
+     * Deposit amount required for registering a stake pool
+     */
+    stakePoolDeposit: bigint;
+  }
+
+  /**
+   * Price of execution units for script execution
+   */
+  export interface ExUnitPrices {
+    memPrice: SubCoin;
+    stepPrice: SubCoin;
+  }
+  export interface SubCoin {
+    denominator: bigint;
+    numerator: bigint;
+  }
+
+  
+  export interface UtxoInputContext {
+    isSpent: boolean;
+    utxo: UTxO;
+  }
+  export interface UTxO {
+    input: TxInput;
+    output: TxOutput;
+  }
+  export interface TxInput {
+    outputIndex: number;
+    txHash: string;
+  }
+
+  export interface Asset {
+    quantity: string;
+    unit: string;
+  }
+