@meshsdk/transaction 1.9.0-beta.101 → 1.9.0-beta.103

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   ForgeScript: () => ForgeScript,
   LargestFirstInputSelector: () => LargestFirstInputSelector,
   MeshTxBuilder: () => MeshTxBuilder,
+  MeshTxBuilderV2: () => MeshTxBuilderV2,
   Transaction: () => Transaction,
   TxParser: () => TxParser,
   cloneOutput: () => cloneOutput,
@@ -1422,7 +1423,7 @@ var BuilderCallbacksSdkBridge = class {
       change: selectionSkeleton.change.map(
         (output) => CSDKOutputToMeshOutput(output)
       ),
-      fee: selectionSkeleton.fee
+      fee: BigInt(1e9)
     });
     return {
       fee: costs.fee,
@@ -1764,7 +1765,6 @@ var CSDKRedeemerTagToMeshRedeemerTag = (tag) => {
 };
 
 // src/mesh-tx-builder/coin-selection/largest-first-selector.ts
-var MAX_U64 = 18446744073709551615n;
 var mergeValue = (a, b) => {
   const merged = new Map(a);
   b.forEach((quantity, unit) => {
@@ -2011,7 +2011,7 @@ var LargestFirstInputSelector = class {
           newInputs: selectedUtxos,
           newOutputs: /* @__PURE__ */ new Set(),
           change: changeOutputs,
-          fee: MAX_U64
+          fee: BigInt(1e9)
         })).fee;
       }
     }
@@ -3142,9 +3142,12 @@ var MeshTxBuilderCore = class {
    * @returns The MeshTxBuilder instance
    */
   proposalRedeemerValue = (redeemer, type = "Mesh", exUnits = { ...import_common.DEFAULT_REDEEMER_BUDGET }) => {
-    if (!this.proposalItem) throw Error("proposalRedeemerValue: Undefined proposal");
+    if (!this.proposalItem)
+      throw Error("proposalRedeemerValue: Undefined proposal");
     if (!(this.proposalItem.type === "ScriptProposal"))
-      throw Error("proposalRedeemerValue: Adding redeemer to non plutus proposal");
+      throw Error(
+        "proposalRedeemerValue: Adding redeemer to non plutus proposal"
+      );
     this.proposalItem.redeemer = this.castBuilderDataToRedeemer(
       redeemer,
       type,
@@ -3532,6 +3535,15 @@ var MeshTxBuilderCore = class {
     this.meshTxBuilderBody.network = network;
     return this;
   };
+  /**
+   * Alias for setNetwork for custom cost models
+   * @param costModels
+   * @returns The MeshTxBuilder instance
+   */
+  setCostModels = (costModels) => {
+    this.setNetwork(costModels);
+    return this;
+  };
   /**
    * Add a transaction that is used as input, but not yet reflected on the global blockchain
    * @param txHex The transaction hex of chained transaction
@@ -4024,6 +4036,37 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
       this._protocolParams
     );
   };
+  completeCostModels = async () => {
+    console.log("completing cost models...");
+    if (Array.isArray(this.meshTxBuilderBody.network)) {
+      return;
+    }
+    const defaults = [
+      import_common3.DEFAULT_V1_COST_MODEL_LIST,
+      import_common3.DEFAULT_V2_COST_MODEL_LIST,
+      import_common3.DEFAULT_V3_COST_MODEL_LIST
+    ];
+    if (this.fetcher) {
+      try {
+        console.log("fetching cost models from fetcher...");
+        const costModels = await this.fetcher.fetchCostModels();
+        if (Array.isArray(costModels) && costModels.length > 0) {
+          this.meshTxBuilderBody.network = costModels;
+          return;
+        }
+        console.warn(
+          "fetchCostModels returned an invalid value, using default cost models:",
+          costModels
+        );
+      } catch (error) {
+        console.warn(
+          "Failed to fetch cost models, using default cost models. Error: ",
+          error
+        );
+      }
+    }
+    this.meshTxBuilderBody.network = defaults;
+  };
   /**
    * It builds the transaction query the blockchain for missing information
    * @param customizedTx The optional customized transaction body
@@ -4067,6 +4110,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
         this.setFee(customizedTx.fee);
       }
     }
+    await this.completeCostModels();
     this.queueAllLastItem();
     if (this.verbose) {
       console.log(
@@ -4124,7 +4168,15 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     const selectionCallbacks = {
       computeMinimumCost: async (selectionSkeleton) => {
         const clonedBuilder = this.clone();
-        await clonedBuilder.updateByTxPrototype(selectionSkeleton);
+        if (this.manualFee) {
+          const newSelectionSkeleton = {
+            ...selectionSkeleton,
+            fee: BigInt(this.manualFee)
+          };
+          await clonedBuilder.updateByTxPrototype(newSelectionSkeleton);
+        } else {
+          await clonedBuilder.updateByTxPrototype(selectionSkeleton);
+        }
         try {
           await clonedBuilder.evaluateRedeemers();
         } catch (error) {
@@ -6205,6 +6257,8 @@ var TxParser = class {
     this.serializer = serializer;
     this.fetcher = fetcher;
   }
+  serializer;
+  fetcher;
   parse = async (txHex, providedUtxos = []) => {
     const resolvedUtxos = [...providedUtxos];
     const resolvedUtxosSet = new Set(
@@ -6247,11 +6301,224 @@ var TxParser = class {
   getBuilderBodyWithoutChange = () => this.serializer.parser.getBuilderBodyWithoutChange();
   toTester = () => this.serializer.parser.toTester();
 };
+
+// src/mesh-tx-builder-v2/index.ts
+var import_common5 = require("@meshsdk/common");
+var SpendBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.txInScript(scriptCbor);
+    return this;
+  }
+  referenceScript(refTxHash, refTxIndex, scriptSize, scriptHash) {
+    this.builder.spendingTxInReference(
+      refTxHash,
+      refTxIndex,
+      scriptSize,
+      scriptHash
+    );
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.txInRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.txInRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this;
+  }
+  txOut(address, amount) {
+    this.builder.txInInlineDatumPresent();
+    this.builder.txOut(address, amount);
+    return this;
+  }
+  datumJson(datum) {
+    this.builder.txOutInlineDatumValue(datum, "JSON");
+    return this.builder;
+  }
+  datumCbor(datum) {
+    this.builder.txOutInlineDatumValue(datum, "CBOR");
+    return this.builder;
+  }
+  datumHash(datumHash) {
+    this.builder.txOutDatumHashValue(datumHash);
+    return this.builder;
+  }
+};
+var MintBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.mintingScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.mintTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.mintRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.mintRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this;
+  }
+  txOut(address, amount) {
+    this.builder.txOut(address, amount);
+    return this.builder;
+  }
+};
+var WithdrawBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.withdrawalScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.withdrawalTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.withdrawalRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this.builder;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.withdrawalRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this.builder;
+  }
+};
+var VoteBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.voteScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.voteTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.voteRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this.builder;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.voteRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...import_common5.DEFAULT_REDEEMER_BUDGET }
+    );
+    return this.builder;
+  }
+};
+var TxBuilderV2 = class extends MeshTxBuilder {
+  spendPlutusV1(txHash, txIndex) {
+    this.spendingPlutusScriptV1();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  spendPlutusV2(txHash, txIndex) {
+    this.spendingPlutusScriptV2();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  spendPlutusV3(txHash, txIndex) {
+    this.spendingPlutusScriptV3();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  mintPlutusV1(quantity, policyId, assetName) {
+    this.mintPlutusScriptV1();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  mintPlutusV2(quantity, policyId, assetName) {
+    this.mintPlutusScriptV2();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  mintPlutusV3(quantity, policyId, assetName) {
+    this.mintPlutusScriptV3();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  withdrawPlutusV1(rewardAddress, amount) {
+    this.withdrawalPlutusScriptV1();
+    this.withdrawal(rewardAddress, amount);
+    return new WithdrawBuilderImpl(this);
+  }
+  withdrawPlutusV2(rewardAddress, coin) {
+    this.withdrawalPlutusScriptV2();
+    this.withdrawal(rewardAddress, coin);
+    return new WithdrawBuilderImpl(this);
+  }
+  withdrawPlutusV3(rewardAddress, coin) {
+    this.withdrawalPlutusScriptV3();
+    this.withdrawal(rewardAddress, coin);
+    return new WithdrawBuilderImpl(this);
+  }
+  votePlutusV1(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV1();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+  votePlutusV2(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV2();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+  votePlutusV3(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV3();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+};
+var MeshTxBuilderV2 = TxBuilderV2;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ForgeScript,
   LargestFirstInputSelector,
   MeshTxBuilder,
+  MeshTxBuilderV2,
   Transaction,
   TxParser,
   cloneOutput,

package/dist/index.d.cts

@@ -582,6 +582,12 @@ declare class MeshTxBuilderCore {
      * @returns The MeshTxBuilder instance
      */
     setNetwork: (network: Network | number[][]) => this;
+    /**
+     * Alias for setNetwork for custom cost models
+     * @param costModels
+     * @returns The MeshTxBuilder instance
+     */
+    setCostModels: (costModels: number[][]) => this;
     /**
      * Add a transaction that is used as input, but not yet reflected on the global blockchain
      * @param txHex The transaction hex of chained transaction
@@ -652,6 +658,7 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
     protected utxosWithRefScripts: UTxO[];
     constructor({ serializer, selector, fetcher, submitter, evaluator, params, isHydra, verbose, }?: MeshTxBuilderOptions);
     serializeMockTx: () => string;
+    completeCostModels: () => Promise<void>;
     /**
      * It builds the transaction query the blockchain for missing information
      * @param customizedTx The optional customized transaction body
@@ -1053,4 +1060,87 @@ declare class TxParser {
     toTester: () => _meshsdk_common.TxTester;
 }
 
-export { ForgeScript, LargestFirstInputSelector, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };
+interface _MeshTxBuilderV2 extends Omit<MeshTxBuilder, ScriptMethodsToDrop> {
+    spendPlutusV1(txHash: string, txIndex: number): SpendScriptBuilder;
+    spendPlutusV2(txHash: string, txIndex: number): SpendScriptBuilder;
+    spendPlutusV3(txHash: string, txIndex: number): SpendScriptBuilder;
+    mintPlutusV1(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    mintPlutusV2(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    mintPlutusV3(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    withdrawPlutusV1(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    withdrawPlutusV2(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    withdrawPlutusV3(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    votePlutusV1(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+    votePlutusV2(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+    votePlutusV3(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+}
+type ScriptMethodsToDrop = "spendingPlutusScript" | "spendingPlutusScriptV1" | "spendingPlutusScriptV2" | "spendingPlutusScriptV3" | "spendingTxInReference" | "spendingReferenceTxInInlineDatumPresent" | "spendingReferenceTxInRedeemerValue" | "mintPlutusScript" | "mintPlutusScriptV1" | "mintPlutusScriptV2" | "mintPlutusScriptV3" | "mintingScript" | "mintTxInReference" | "mintReferenceTxInRedeemerValue" | "mintRedeemerValue" | "withdrawalPlutusScript" | "withdrawalPlutusScriptV1" | "withdrawalPlutusScriptV2" | "withdrawalPlutusScriptV3" | "withdrawalScript" | "withdrawalTxInReference" | "withdrawalReferenceTxInRedeemerValue" | "withdrawalRedeemerValue" | "votePlutusScript" | "votePlutusScriptV1" | "votePlutusScriptV2" | "votePlutusScriptV3" | "voteScript" | "voteTxInReference" | "voteReferenceTxInRedeemerValue" | "voteRedeemerValue" | "txInScript" | "txInDatumValue" | "txInInlineDatumPresent" | "txInRedeemerValue";
+interface SpendScriptBuilder {
+    script(scriptCbor: string): SpendRedeemerBuilder;
+    referenceScript(refTxHash: string, refTxIndex: number, scriptSize?: string, scriptHash?: string): SpendRedeemerBuilder;
+}
+interface SpendRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): SpendTxOutBuilder;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): SpendTxOutBuilder;
+}
+interface SpendTxOutBuilder {
+    txOut(address: string, amount: Asset[]): SpendDatumBuilder;
+}
+interface SpendDatumBuilder {
+    datumHash(datumHash: string): _MeshTxBuilderV2;
+    datumCbor(datumCbor: BuilderData["content"]): _MeshTxBuilderV2;
+    datumJson(datumJson: BuilderData["content"]): _MeshTxBuilderV2;
+}
+interface MintScriptBuilder {
+    script(scriptCbor: string): MintRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): MintRedeemerBuilder;
+}
+interface MintRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): MintTxOutBuilder;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): MintTxOutBuilder;
+}
+interface MintTxOutBuilder {
+    txOut(address: string, amount: Asset[]): _MeshTxBuilderV2;
+}
+interface VoteScriptBuilder {
+    script(scriptCbor: string): VoteRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): VoteRedeemerBuilder;
+}
+interface VoteRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+}
+interface WithdrawScriptBuilder {
+    script(scriptCbor: string): WithdrawRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): WithdrawRedeemerBuilder;
+}
+interface WithdrawRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+}
+
+/**
+ * \`MeshTxBuilderV2\` is a strongly-typed wrapper around the core \`MeshTxBuilder\`
+ * that enforces a rigid Type-State machine for Plutus operations.
+ *
+ * It natively provides TypeScript autocomplete restrictions (Script -> Redeemer -> TxOut -> Datum)
+ * for transactions like spending, minting, withdrawing, and voting, dropping standalone
+ * script methods to prevent incorrect chained execution ordering.
+ *
+ * @example
+ * ```typescript
+ * const tx = new MeshTxBuilderV2({
+ *   fetcher: provider,
+ *   evaluator: provider,
+ * });
+ *
+ * tx.spendPlutusV3(txHash, index)
+ *   .script(scriptCbor)
+ *   .redeemerJson(redeemerValue)
+ *   .txOut(address, assets)
+ *   .datumJson(datumValue); // Drops you back into the main builder methods
+ * ```
+ */
+declare const MeshTxBuilderV2: new (options?: MeshTxBuilderOptions) => _MeshTxBuilderV2;
+
+export { ForgeScript, LargestFirstInputSelector, MeshTxBuilder, type MeshTxBuilderOptions, MeshTxBuilderV2, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };

package/dist/index.d.ts

@@ -582,6 +582,12 @@ declare class MeshTxBuilderCore {
      * @returns The MeshTxBuilder instance
      */
     setNetwork: (network: Network | number[][]) => this;
+    /**
+     * Alias for setNetwork for custom cost models
+     * @param costModels
+     * @returns The MeshTxBuilder instance
+     */
+    setCostModels: (costModels: number[][]) => this;
     /**
      * Add a transaction that is used as input, but not yet reflected on the global blockchain
      * @param txHex The transaction hex of chained transaction
@@ -652,6 +658,7 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
     protected utxosWithRefScripts: UTxO[];
     constructor({ serializer, selector, fetcher, submitter, evaluator, params, isHydra, verbose, }?: MeshTxBuilderOptions);
     serializeMockTx: () => string;
+    completeCostModels: () => Promise<void>;
     /**
      * It builds the transaction query the blockchain for missing information
      * @param customizedTx The optional customized transaction body
@@ -1053,4 +1060,87 @@ declare class TxParser {
     toTester: () => _meshsdk_common.TxTester;
 }
 
-export { ForgeScript, LargestFirstInputSelector, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };
+interface _MeshTxBuilderV2 extends Omit<MeshTxBuilder, ScriptMethodsToDrop> {
+    spendPlutusV1(txHash: string, txIndex: number): SpendScriptBuilder;
+    spendPlutusV2(txHash: string, txIndex: number): SpendScriptBuilder;
+    spendPlutusV3(txHash: string, txIndex: number): SpendScriptBuilder;
+    mintPlutusV1(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    mintPlutusV2(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    mintPlutusV3(quantity: string, policyId: string, assetName: string): MintScriptBuilder;
+    withdrawPlutusV1(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    withdrawPlutusV2(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    withdrawPlutusV3(rewardAddress: string, amount: string): WithdrawScriptBuilder;
+    votePlutusV1(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+    votePlutusV2(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+    votePlutusV3(voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure): VoteScriptBuilder;
+}
+type ScriptMethodsToDrop = "spendingPlutusScript" | "spendingPlutusScriptV1" | "spendingPlutusScriptV2" | "spendingPlutusScriptV3" | "spendingTxInReference" | "spendingReferenceTxInInlineDatumPresent" | "spendingReferenceTxInRedeemerValue" | "mintPlutusScript" | "mintPlutusScriptV1" | "mintPlutusScriptV2" | "mintPlutusScriptV3" | "mintingScript" | "mintTxInReference" | "mintReferenceTxInRedeemerValue" | "mintRedeemerValue" | "withdrawalPlutusScript" | "withdrawalPlutusScriptV1" | "withdrawalPlutusScriptV2" | "withdrawalPlutusScriptV3" | "withdrawalScript" | "withdrawalTxInReference" | "withdrawalReferenceTxInRedeemerValue" | "withdrawalRedeemerValue" | "votePlutusScript" | "votePlutusScriptV1" | "votePlutusScriptV2" | "votePlutusScriptV3" | "voteScript" | "voteTxInReference" | "voteReferenceTxInRedeemerValue" | "voteRedeemerValue" | "txInScript" | "txInDatumValue" | "txInInlineDatumPresent" | "txInRedeemerValue";
+interface SpendScriptBuilder {
+    script(scriptCbor: string): SpendRedeemerBuilder;
+    referenceScript(refTxHash: string, refTxIndex: number, scriptSize?: string, scriptHash?: string): SpendRedeemerBuilder;
+}
+interface SpendRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): SpendTxOutBuilder;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): SpendTxOutBuilder;
+}
+interface SpendTxOutBuilder {
+    txOut(address: string, amount: Asset[]): SpendDatumBuilder;
+}
+interface SpendDatumBuilder {
+    datumHash(datumHash: string): _MeshTxBuilderV2;
+    datumCbor(datumCbor: BuilderData["content"]): _MeshTxBuilderV2;
+    datumJson(datumJson: BuilderData["content"]): _MeshTxBuilderV2;
+}
+interface MintScriptBuilder {
+    script(scriptCbor: string): MintRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): MintRedeemerBuilder;
+}
+interface MintRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): MintTxOutBuilder;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): MintTxOutBuilder;
+}
+interface MintTxOutBuilder {
+    txOut(address: string, amount: Asset[]): _MeshTxBuilderV2;
+}
+interface VoteScriptBuilder {
+    script(scriptCbor: string): VoteRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): VoteRedeemerBuilder;
+}
+interface VoteRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+}
+interface WithdrawScriptBuilder {
+    script(scriptCbor: string): WithdrawRedeemerBuilder;
+    referenceScript(txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string): WithdrawRedeemerBuilder;
+}
+interface WithdrawRedeemerBuilder {
+    redeemerJson(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+    redeemerCbor(redeemer: BuilderData["content"], exUnits?: Budget): _MeshTxBuilderV2;
+}
+
+/**
+ * \`MeshTxBuilderV2\` is a strongly-typed wrapper around the core \`MeshTxBuilder\`
+ * that enforces a rigid Type-State machine for Plutus operations.
+ *
+ * It natively provides TypeScript autocomplete restrictions (Script -> Redeemer -> TxOut -> Datum)
+ * for transactions like spending, minting, withdrawing, and voting, dropping standalone
+ * script methods to prevent incorrect chained execution ordering.
+ *
+ * @example
+ * ```typescript
+ * const tx = new MeshTxBuilderV2({
+ *   fetcher: provider,
+ *   evaluator: provider,
+ * });
+ *
+ * tx.spendPlutusV3(txHash, index)
+ *   .script(scriptCbor)
+ *   .redeemerJson(redeemerValue)
+ *   .txOut(address, assets)
+ *   .datumJson(datumValue); // Drops you back into the main builder methods
+ * ```
+ */
+declare const MeshTxBuilderV2: new (options?: MeshTxBuilderOptions) => _MeshTxBuilderV2;
+
+export { ForgeScript, LargestFirstInputSelector, MeshTxBuilder, type MeshTxBuilderOptions, MeshTxBuilderV2, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };

package/dist/index.js

@@ -1345,7 +1345,10 @@ var bignumber_default = BigNumber;
 // src/mesh-tx-builder/index.ts
 import JSONBig3 from "json-bigint";
 import {
-  DEFAULT_PROTOCOL_PARAMETERS as DEFAULT_PROTOCOL_PARAMETERS3
+  DEFAULT_PROTOCOL_PARAMETERS as DEFAULT_PROTOCOL_PARAMETERS3,
+  DEFAULT_V1_COST_MODEL_LIST,
+  DEFAULT_V2_COST_MODEL_LIST,
+  DEFAULT_V3_COST_MODEL_LIST
 } from "@meshsdk/common";
 import {
   CardanoSDKSerializer,
@@ -1390,7 +1393,7 @@ var BuilderCallbacksSdkBridge = class {
       change: selectionSkeleton.change.map(
         (output) => CSDKOutputToMeshOutput(output)
       ),
-      fee: selectionSkeleton.fee
+      fee: BigInt(1e9)
     });
     return {
       fee: costs.fee,
@@ -1732,7 +1735,6 @@ var CSDKRedeemerTagToMeshRedeemerTag = (tag) => {
 };
 
 // src/mesh-tx-builder/coin-selection/largest-first-selector.ts
-var MAX_U64 = 18446744073709551615n;
 var mergeValue = (a, b) => {
   const merged = new Map(a);
   b.forEach((quantity, unit) => {
@@ -1979,7 +1981,7 @@ var LargestFirstInputSelector = class {
           newInputs: selectedUtxos,
           newOutputs: /* @__PURE__ */ new Set(),
           change: changeOutputs,
-          fee: MAX_U64
+          fee: BigInt(1e9)
         })).fee;
       }
     }
@@ -2033,8 +2035,8 @@ import {
   DEFAULT_PROTOCOL_PARAMETERS,
   DEFAULT_REDEEMER_BUDGET,
   DREP_DEPOSIT,
-  VOTING_PROPOSAL_DEPOSIT,
-  emptyTxBuilderBody
+  emptyTxBuilderBody,
+  VOTING_PROPOSAL_DEPOSIT
 } from "@meshsdk/common";
 import { Address, CredentialType } from "@meshsdk/core-cst";
 
@@ -3117,9 +3119,12 @@ var MeshTxBuilderCore = class {
    * @returns The MeshTxBuilder instance
    */
   proposalRedeemerValue = (redeemer, type = "Mesh", exUnits = { ...DEFAULT_REDEEMER_BUDGET }) => {
-    if (!this.proposalItem) throw Error("proposalRedeemerValue: Undefined proposal");
+    if (!this.proposalItem)
+      throw Error("proposalRedeemerValue: Undefined proposal");
     if (!(this.proposalItem.type === "ScriptProposal"))
-      throw Error("proposalRedeemerValue: Adding redeemer to non plutus proposal");
+      throw Error(
+        "proposalRedeemerValue: Adding redeemer to non plutus proposal"
+      );
     this.proposalItem.redeemer = this.castBuilderDataToRedeemer(
       redeemer,
       type,
@@ -3507,6 +3512,15 @@ var MeshTxBuilderCore = class {
     this.meshTxBuilderBody.network = network;
     return this;
   };
+  /**
+   * Alias for setNetwork for custom cost models
+   * @param costModels
+   * @returns The MeshTxBuilder instance
+   */
+  setCostModels = (costModels) => {
+    this.setNetwork(costModels);
+    return this;
+  };
   /**
    * Add a transaction that is used as input, but not yet reflected on the global blockchain
    * @param txHex The transaction hex of chained transaction
@@ -4001,6 +4015,37 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
       this._protocolParams
     );
   };
+  completeCostModels = async () => {
+    console.log("completing cost models...");
+    if (Array.isArray(this.meshTxBuilderBody.network)) {
+      return;
+    }
+    const defaults = [
+      DEFAULT_V1_COST_MODEL_LIST,
+      DEFAULT_V2_COST_MODEL_LIST,
+      DEFAULT_V3_COST_MODEL_LIST
+    ];
+    if (this.fetcher) {
+      try {
+        console.log("fetching cost models from fetcher...");
+        const costModels = await this.fetcher.fetchCostModels();
+        if (Array.isArray(costModels) && costModels.length > 0) {
+          this.meshTxBuilderBody.network = costModels;
+          return;
+        }
+        console.warn(
+          "fetchCostModels returned an invalid value, using default cost models:",
+          costModels
+        );
+      } catch (error) {
+        console.warn(
+          "Failed to fetch cost models, using default cost models. Error: ",
+          error
+        );
+      }
+    }
+    this.meshTxBuilderBody.network = defaults;
+  };
   /**
    * It builds the transaction query the blockchain for missing information
    * @param customizedTx The optional customized transaction body
@@ -4044,6 +4089,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
         this.setFee(customizedTx.fee);
       }
     }
+    await this.completeCostModels();
     this.queueAllLastItem();
     if (this.verbose) {
       console.log(
@@ -4101,7 +4147,15 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     const selectionCallbacks = {
       computeMinimumCost: async (selectionSkeleton) => {
         const clonedBuilder = this.clone();
-        await clonedBuilder.updateByTxPrototype(selectionSkeleton);
+        if (this.manualFee) {
+          const newSelectionSkeleton = {
+            ...selectionSkeleton,
+            fee: BigInt(this.manualFee)
+          };
+          await clonedBuilder.updateByTxPrototype(newSelectionSkeleton);
+        } else {
+          await clonedBuilder.updateByTxPrototype(selectionSkeleton);
+        }
         try {
           await clonedBuilder.evaluateRedeemers();
         } catch (error) {
@@ -6205,6 +6259,8 @@ var TxParser = class {
     this.serializer = serializer;
     this.fetcher = fetcher;
   }
+  serializer;
+  fetcher;
   parse = async (txHex, providedUtxos = []) => {
     const resolvedUtxos = [...providedUtxos];
     const resolvedUtxosSet = new Set(
@@ -6247,10 +6303,225 @@ var TxParser = class {
   getBuilderBodyWithoutChange = () => this.serializer.parser.getBuilderBodyWithoutChange();
   toTester = () => this.serializer.parser.toTester();
 };
+
+// src/mesh-tx-builder-v2/index.ts
+import {
+  DEFAULT_REDEEMER_BUDGET as DEFAULT_REDEEMER_BUDGET3
+} from "@meshsdk/common";
+var SpendBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.txInScript(scriptCbor);
+    return this;
+  }
+  referenceScript(refTxHash, refTxIndex, scriptSize, scriptHash) {
+    this.builder.spendingTxInReference(
+      refTxHash,
+      refTxIndex,
+      scriptSize,
+      scriptHash
+    );
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.txInRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.txInRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this;
+  }
+  txOut(address, amount) {
+    this.builder.txInInlineDatumPresent();
+    this.builder.txOut(address, amount);
+    return this;
+  }
+  datumJson(datum) {
+    this.builder.txOutInlineDatumValue(datum, "JSON");
+    return this.builder;
+  }
+  datumCbor(datum) {
+    this.builder.txOutInlineDatumValue(datum, "CBOR");
+    return this.builder;
+  }
+  datumHash(datumHash) {
+    this.builder.txOutDatumHashValue(datumHash);
+    return this.builder;
+  }
+};
+var MintBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.mintingScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.mintTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.mintRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.mintRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this;
+  }
+  txOut(address, amount) {
+    this.builder.txOut(address, amount);
+    return this.builder;
+  }
+};
+var WithdrawBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.withdrawalScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.withdrawalTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.withdrawalRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this.builder;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.withdrawalRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this.builder;
+  }
+};
+var VoteBuilderImpl = class {
+  constructor(builder) {
+    this.builder = builder;
+  }
+  builder;
+  script(scriptCbor) {
+    this.builder.voteScript(scriptCbor);
+    return this;
+  }
+  referenceScript(txHash, txIndex, scriptSize, scriptHash) {
+    this.builder.voteTxInReference(txHash, txIndex, scriptSize, scriptHash);
+    return this;
+  }
+  redeemerJson(redeemer, exUnits) {
+    this.builder.voteRedeemerValue(
+      redeemer,
+      "JSON",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this.builder;
+  }
+  redeemerCbor(redeemer, exUnits) {
+    this.builder.voteRedeemerValue(
+      redeemer,
+      "CBOR",
+      exUnits ?? { ...DEFAULT_REDEEMER_BUDGET3 }
+    );
+    return this.builder;
+  }
+};
+var TxBuilderV2 = class extends MeshTxBuilder {
+  spendPlutusV1(txHash, txIndex) {
+    this.spendingPlutusScriptV1();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  spendPlutusV2(txHash, txIndex) {
+    this.spendingPlutusScriptV2();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  spendPlutusV3(txHash, txIndex) {
+    this.spendingPlutusScriptV3();
+    this.txIn(txHash, txIndex);
+    return new SpendBuilderImpl(this);
+  }
+  mintPlutusV1(quantity, policyId, assetName) {
+    this.mintPlutusScriptV1();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  mintPlutusV2(quantity, policyId, assetName) {
+    this.mintPlutusScriptV2();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  mintPlutusV3(quantity, policyId, assetName) {
+    this.mintPlutusScriptV3();
+    this.mint(quantity, policyId, assetName);
+    return new MintBuilderImpl(this);
+  }
+  withdrawPlutusV1(rewardAddress, amount) {
+    this.withdrawalPlutusScriptV1();
+    this.withdrawal(rewardAddress, amount);
+    return new WithdrawBuilderImpl(this);
+  }
+  withdrawPlutusV2(rewardAddress, coin) {
+    this.withdrawalPlutusScriptV2();
+    this.withdrawal(rewardAddress, coin);
+    return new WithdrawBuilderImpl(this);
+  }
+  withdrawPlutusV3(rewardAddress, coin) {
+    this.withdrawalPlutusScriptV3();
+    this.withdrawal(rewardAddress, coin);
+    return new WithdrawBuilderImpl(this);
+  }
+  votePlutusV1(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV1();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+  votePlutusV2(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV2();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+  votePlutusV3(voter, govActionId, votingProcedure) {
+    this.votePlutusScriptV3();
+    this.vote(voter, govActionId, votingProcedure);
+    return new VoteBuilderImpl(this);
+  }
+};
+var MeshTxBuilderV2 = TxBuilderV2;
 export {
   ForgeScript,
   LargestFirstInputSelector,
   MeshTxBuilder,
+  MeshTxBuilderV2,
   Transaction,
   TxParser,
   cloneOutput,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshsdk/transaction",
-  "version": "1.9.0-beta.101",
+  "version": "1.9.0-beta.103",
   "description": "Transactions - https://meshjs.dev/apis/transaction",
   "main": "./dist/index.cjs",
   "browser": "./dist/index.js",
@@ -35,8 +35,8 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.9.0-beta.101",
-    "@meshsdk/core-cst": "1.9.0-beta.101",
+    "@meshsdk/common": "1.9.0-beta.103",
+    "@meshsdk/core-cst": "1.9.0-beta.103",
     "@cardano-sdk/core": "0.46.12",
     "@cardano-sdk/util": "0.17.1",
     "@cardano-sdk/input-selection": "0.14.28",