@meshsdk/core 1.5.11-beta.1 → 1.5.11-beta.3

package/dist/transaction/meshTxBuilder/index.d.ts

@@ -1 +1,2 @@
 export * from './meshTxBuilder.service';
+export * from './type';

package/dist/transaction/meshTxBuilder/meshTxBuilderCore.d.ts

@@ -1,9 +1,10 @@
-import { Action, Asset, Budget, Data, Protocol } from '@mesh/common/types';
+import { Action, Asset, Data, LanguageVersion, Protocol } from '@mesh/common/types';
 import { csl } from '@mesh/core';
-import { MintItem, TxIn, PubKeyTxIn, MeshTxBuilderBody, RefTxIn } from './type';
+import { MintItem, TxIn, PubKeyTxIn, MeshTxBuilderBody, RefTxIn, BuilderData } from './type';
 export declare class MeshTxBuilderCore {
     txHex: string;
     txBuilder: csl.TransactionBuilder;
+    txEvaluationMultiplier: number;
     private _protocolParams;
     private txOutput?;
     private addingScriptInput;
@@ -14,6 +15,17 @@ export declare class MeshTxBuilderCore {
     protected txInQueueItem?: TxIn;
     protected collateralQueueItem?: PubKeyTxIn;
     protected refScriptTxInQueueItem?: RefTxIn;
+    /**
+     * Reset everything in the MeshTxBuilder instance
+     * @returns The MeshTxBuilder instance
+     */
+    reset: () => this;
+    /**
+     * Make an empty transaction body for building transaction in object
+     * @returns An empty transaction body
+     */
+    emptyTxBuilderBody: () => MeshTxBuilderBody;
+    constructor();
     /**
      * Synchronous functions here
      */
@@ -28,7 +40,7 @@ export declare class MeshTxBuilderCore {
      * @returns The signed transaction in hex
      */
     completeSigning: () => string;
-    serializeTxBody: (txBody: MeshTxBuilderBody) => this;
+    private serializeTxBody;
     /**
      * Set the input for transaction
      * @param txHash The transaction hash of the input UTxO
@@ -41,15 +53,17 @@ export declare class MeshTxBuilderCore {
     /**
      * Set the script for transaction input
      * @param {string} scriptCbor The CborHex of the script
+     * @param version Optional - The Plutus script version
      * @returns The MeshTxBuilder instance
      */
-    txInScript: (scriptCbor: string) => this;
+    txInScript: (scriptCbor: string, version?: LanguageVersion) => this;
     /**
      * Set the input datum for transaction input
-     * @param {Data} datum The datum in object format
+     * @param datum The datum in Mesh Data type or Raw constructor like format
+     * @param type The datum type, either Mesh Data type or Raw constructor like format
      * @returns The MeshTxBuilder instance
      */
-    txInDatumValue: (datum: Data) => this;
+    txInDatumValue: (datum: Data | object | string, type?: 'Mesh' | 'Raw') => this;
     /**
      * Tell the transaction builder that the input UTxO has inlined datum
      * @returns The MeshTxBuilder instance
@@ -57,11 +71,15 @@ export declare class MeshTxBuilderCore {
     txInInlineDatumPresent: () => this;
     /**
      * Set the redeemer for the reference input to be spent in same transaction
-     * @param redeemer The redeemer in object format
+     * @param redeemer The redeemer in Mesh Data type or Raw constructor like format
      * @param exUnits The execution units budget for the redeemer
+     * @param type The redeemer data type, either Mesh Data type or Raw constructor like format
      * @returns The MeshTxBuilder instance
      */
-    txInRedeemerValue: (redeemer: Data, exUnits?: Budget) => this;
+    txInRedeemerValue: (redeemer: Data | object | string, exUnits?: {
+        mem: number;
+        steps: number;
+    }, type?: 'Mesh' | 'Raw') => this;
     /**
      * Set the output for transaction
      * @param {string} address The recipient of the output
@@ -71,22 +89,25 @@ export declare class MeshTxBuilderCore {
     txOut: (address: string, amount: Asset[]) => this;
     /**
      * Set the output datum hash for transaction
-     * @param {Data} datum The datum in object format
+     * @param datum The datum in Mesh Data type or Raw constructor like format
+     * @param type The datum type, either Mesh Data type or Raw constructor like format
      * @returns The MeshTxBuilder instance
      */
-    txOutDatumHashValue: (datum: Data) => this;
+    txOutDatumHashValue: (datum: Data | object | string, type?: 'Mesh' | 'Raw') => this;
     /**
      * Set the output inline datum for transaction
-     * @param {Data} datum The datum in object format
+     * @param datum The datum in Mesh Data type or Raw constructor like format
+     * @param type The datum type, either Mesh Data type or Raw constructor like format
      * @returns The MeshTxBuilder instance
      */
-    txOutInlineDatumValue: (datum: Data) => this;
+    txOutInlineDatumValue: (datum: Data | object | string, type?: 'Mesh' | 'Raw') => this;
     /**
      * Set the reference script to be attached with the output
      * @param scriptCbor The CBOR hex of the script to be attached to UTxO as reference script
+     * @param version Optional - The Plutus script version
      * @returns The MeshTxBuilder instance
      */
-    txOutReferenceScript: (scriptCbor: string) => this;
+    txOutReferenceScript: (scriptCbor: string, version?: LanguageVersion) => this;
     /**
      * Set the instruction that it is currently using V2 Plutus spending scripts
      * @returns The MeshTxBuilder instance
@@ -99,7 +120,7 @@ export declare class MeshTxBuilderCore {
      * @param spendingScriptHash The script hash of the spending script
      * @returns The MeshTxBuilder instance
      */
-    spendingTxInReference: (txHash: string, txIndex: number, spendingScriptHash?: string) => this;
+    spendingTxInReference: (txHash: string, txIndex: number, spendingScriptHash?: string, version?: LanguageVersion) => this;
     /**
      * [Alias of txInInlineDatumPresent] Set the instruction that the reference input has inline datum
      * @returns The MeshTxBuilder instance
@@ -111,7 +132,10 @@ export declare class MeshTxBuilderCore {
      * @param exUnits The execution units budget for the redeemer
      * @returns The MeshTxBuilder instance
      */
-    spendingReferenceTxInRedeemerValue: (redeemer: Data, exUnits?: Budget) => this;
+    spendingReferenceTxInRedeemerValue: (redeemer: Data, exUnits?: {
+        mem: number;
+        steps: number;
+    }) => this;
     /**
      * Specify a read only reference input. This reference input is not witnessing anything it is simply provided in the plutus script context.
      * @param txHash The transaction hash of the reference UTxO
@@ -135,30 +159,38 @@ export declare class MeshTxBuilderCore {
     /**
      * Set the minting script of current mint
      * @param scriptCBOR The CBOR hex of the minting policy script
+     * @param version Optional - The Plutus script version
      * @returns The MeshTxBuilder instance
      */
-    mintingScript: (scriptCBOR: string) => this;
+    mintingScript: (scriptCBOR: string, version?: LanguageVersion) => this;
     /**
      * Use reference script for minting
      * @param txHash The transaction hash of the UTxO
      * @param txIndex The transaction index of the UTxO
      * @returns The MeshTxBuilder instance
      */
-    mintTxInReference: (txHash: string, txIndex: number) => this;
+    mintTxInReference: (txHash: string, txIndex: number, version?: LanguageVersion) => this;
     /**
      * Set the redeemer for minting
-     * @param redeemer The redeemer in object format
+     * @param redeemer The redeemer in Mesh Data type or Raw constructor like format
      * @param exUnits The execution units budget for the redeemer
+     * @param type The redeemer data type, either Mesh Data type or Raw constructor like format
      * @returns The MeshTxBuilder instance
      */
-    mintReferenceTxInRedeemerValue: (redeemer: Data, exUnits?: Budget) => this;
+    mintReferenceTxInRedeemerValue: (redeemer: Data | object | string, exUnits?: {
+        mem: number;
+        steps: number;
+    }, type?: 'Mesh' | 'Raw') => this;
     /**
      * Set the redeemer for the reference input to be spent in same transaction
      * @param redeemer The redeemer in object format
      * @param exUnits The execution units budget for the redeemer
      * @returns The MeshTxBuilder instance
      */
-    mintRedeemerValue: (redeemer: Data, exUnits?: Budget) => this;
+    mintRedeemerValue: (redeemer: Data | object | string, exUnits?: {
+        mem: number;
+        steps: number;
+    }, type?: 'Mesh' | 'Raw') => this;
     /**
      * Set the required signer of the transaction
      * @param pubKeyHash The PubKeyHash of the required signer
@@ -236,4 +268,6 @@ export declare class MeshTxBuilderCore {
     private addAllRequiredSignatures;
     private addAllMetadata;
     protected updateRedeemer: (meshTxBuilderBody: MeshTxBuilderBody, txEvaluation: Omit<Action, 'data'>[]) => void;
+    protected castRawDataToJsonString: (rawData: object | string) => string;
+    protected castDataToPlutusData: ({ type, content }: BuilderData) => csl.PlutusData;
 }

package/dist/transaction/meshTxBuilder/type.d.ts

@@ -1,4 +1,4 @@
-import { Asset, Budget, Data } from '@mesh/common/types';
+import { Asset, Budget, Data, LanguageVersion, PlutusScript } from '@mesh/common/types';
 export declare type MeshTxBuilderBody = {
     inputs: TxIn[];
     outputs: Output[];
@@ -11,53 +11,33 @@ export declare type MeshTxBuilderBody = {
     validityRange: ValidityRange;
     signingKey: string[];
 };
-export declare type Output = {
-    address: string;
-    amount: Asset[];
-    datum?: {
-        type: 'Hash' | 'Inline';
-        data: Data;
-    };
-    referenceScript?: string;
-};
-export declare type ValidityRange = {
-    invalidBefore?: number;
-    invalidHereafter?: number;
-};
-export declare type RequiredWith<T, K extends keyof T> = Required<T> & {
-    [P in K]: Required<T[P]>;
-};
-export declare type RefTxIn = {
-    txHash: string;
-    txIndex: number;
-};
 export declare type TxIn = PubKeyTxIn | ScriptTxIn;
 export declare type PubKeyTxIn = {
     type: 'PubKey';
     txIn: TxInParameter;
 };
-export declare type ScriptTxIn = {
-    type: 'Script';
-    txIn: TxInParameter;
-    scriptTxIn: ScriptTxInParameter;
-};
 export declare type TxInParameter = {
     txHash: string;
     txIndex: number;
     amount?: Asset[];
     address?: string;
 };
+export declare type ScriptTxIn = {
+    type: 'Script';
+    txIn: TxInParameter;
+    scriptTxIn: ScriptTxInParameter;
+};
 export declare type ScriptTxInParameter = {
     scriptSource?: {
         type: 'Provided';
-        scriptCbor: string;
+        script: PlutusScript;
     } | {
         type: 'Inline';
         txInInfo: ScriptSourceInfo;
     };
     datumSource?: {
         type: 'Provided';
-        data: Data;
+        data: BuilderData;
     } | {
         type: 'Inline';
         txHash: string;
@@ -69,6 +49,20 @@ export declare type ScriptSourceInfo = {
     txHash: string;
     txIndex: number;
     spendingScriptHash?: string;
+    version: LanguageVersion;
+};
+export declare type RefTxIn = {
+    txHash: string;
+    txIndex: number;
+};
+export declare type Output = {
+    address: string;
+    amount: Asset[];
+    datum?: {
+        type: 'Hash' | 'Inline';
+        data: BuilderData;
+    };
+    referenceScript?: PlutusScript;
 };
 export declare type MintItem = {
     type: 'Plutus' | 'Native';
@@ -78,18 +72,33 @@ export declare type MintItem = {
     redeemer?: Redeemer;
     scriptSource?: {
         type: 'Provided';
-        cbor: string;
+        script: PlutusScript;
     } | {
         type: 'Reference Script';
         txHash: string;
         txIndex: number;
+        version: LanguageVersion;
     };
 };
+export declare type ValidityRange = {
+    invalidBefore?: number;
+    invalidHereafter?: number;
+};
+export declare type BuilderData = {
+    type: 'Mesh';
+    content: Data;
+} | {
+    type: 'Raw';
+    content: string | object;
+};
 export declare type Redeemer = {
-    data: Data;
+    data: BuilderData;
     exUnits: Budget;
 };
 export declare type Metadata = {
     tag: string;
     metadata: object;
 };
+export declare type RequiredWith<T, K extends keyof T> = Required<T> & {
+    [P in K]: Required<T[P]>;
+};

package/package.json

@@ -3,7 +3,7 @@
   "description": "Rapidly build Web3 apps on the Cardano Blockchain.",
   "homepage": "https://meshjs.dev",
   "author": "MeshJS",
-  "version": "1.5.11-beta.1",
+  "version": "1.5.11-beta.3",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {