@meshsdk/core 1.2.1 → 1.4.0

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export * from './common/contracts';
 export * from './common/types';
+export { generateNonce } from './common/helpers';
 export * from './common/utils/resolver';
 export * from './core/CIP2';
+export { checkSignature } from './core/CIP8';
 export * from './providers';
 export * from './scripts';
 export * from './transaction';

package/dist/providers/blockfrost.provider.d.ts

@@ -1,7 +1,8 @@
-import { IFetcher, ISubmitter } from '@mesh/common/contracts';
-import type { AccountInfo, AssetMetadata, Protocol, UTxO } from '@mesh/common/types';
-export declare class BlockfrostProvider implements IFetcher, ISubmitter {
+import { IFetcher, IListener, ISubmitter } from '@mesh/common/contracts';
+import type { AccountInfo, AssetMetadata, BlockInfo, Protocol, TransactionInfo, UTxO } from '@mesh/common/types';
+export declare class BlockfrostProvider implements IFetcher, IListener, ISubmitter {
     private readonly _axiosInstance;
+    constructor(baseUrl: string);
     constructor(projectId: string, version?: number);
     fetchAccountInfo(address: string): Promise<AccountInfo>;
     fetchAddressUTxOs(address: string, asset?: string): Promise<UTxO[]>;
@@ -10,8 +11,11 @@ export declare class BlockfrostProvider implements IFetcher, ISubmitter {
         quantity: string;
     }[]>;
     fetchAssetMetadata(asset: string): Promise<AssetMetadata>;
+    fetchBlockInfo(hash: string): Promise<BlockInfo>;
     fetchHandleAddress(handle: string): Promise<string>;
     fetchProtocolParameters(epoch?: number): Promise<Protocol>;
+    fetchTxInfo(hash: string): Promise<TransactionInfo>;
+    onTxConfirmed(txHash: string, callback: () => void, limit?: number): void;
     submitTx(tx: string): Promise<string>;
     private fetchPlutusScriptCBOR;
     private fetchNativeScriptJSON;

package/dist/providers/index.d.ts

@@ -1,4 +1,5 @@
 export * from './blockfrost.provider';
 export * from './infura.provider';
 export * from './koios.provider';
+export * from './ogmios.provider';
 export * from './tango.provider';

package/dist/providers/koios.provider.d.ts

@@ -1,7 +1,8 @@
-import { IFetcher, ISubmitter } from '@mesh/common/contracts';
-import type { AccountInfo, AssetMetadata, Protocol, UTxO } from '@mesh/common/types';
-export declare class KoiosProvider implements IFetcher, ISubmitter {
+import { IFetcher, IListener, ISubmitter } from '@mesh/common/contracts';
+import type { AccountInfo, AssetMetadata, BlockInfo, Protocol, TransactionInfo, UTxO } from '@mesh/common/types';
+export declare class KoiosProvider implements IFetcher, IListener, ISubmitter {
     private readonly _axiosInstance;
+    constructor(baseUrl: string);
     constructor(network: 'api' | 'preview' | 'preprod' | 'guild', version?: number);
     fetchAccountInfo(address: string): Promise<AccountInfo>;
     fetchAddressUTxOs(address: string, asset?: string): Promise<UTxO[]>;
@@ -10,7 +11,10 @@ export declare class KoiosProvider implements IFetcher, ISubmitter {
         quantity: string;
     }[]>;
     fetchAssetMetadata(asset: string): Promise<AssetMetadata>;
+    fetchBlockInfo(hash: string): Promise<BlockInfo>;
     fetchHandleAddress(handle: string): Promise<string>;
     fetchProtocolParameters(epoch: number): Promise<Protocol>;
+    fetchTxInfo(hash: string): Promise<TransactionInfo>;
+    onTxConfirmed(txHash: string, callback: () => void, limit?: number): void;
     submitTx(tx: string): Promise<string>;
 }

package/dist/providers/ogmios.provider.d.ts

@@ -0,0 +1,12 @@
+import { IEvaluator, ISubmitter } from '@mesh/common/contracts';
+import { Action, Network } from '@mesh/common/types';
+export declare class OgmiosProvider implements IEvaluator, ISubmitter {
+    private readonly _baseUrl;
+    constructor(baseUrl: string);
+    constructor(network: Network);
+    evaluateTx(tx: string): Promise<Omit<Action, 'data'>[]>;
+    onNextTx(callback: (tx: unknown) => void): Promise<() => void>;
+    submitTx(tx: string): Promise<string>;
+    private open;
+    private send;
+}

package/dist/providers/tango.provider.d.ts

@@ -1,8 +1,9 @@
-import { IFetcher, ISubmitter } from '@mesh/common/contracts';
-import type { AccountInfo, AssetMetadata, Protocol, UTxO } from '@mesh/common/types';
-export declare class TangoProvider implements IFetcher, ISubmitter {
+import { IEvaluator, IFetcher, IListener, ISubmitter } from '@mesh/common/contracts';
+import type { AccountInfo, Action, AssetMetadata, BlockInfo, Protocol, TransactionInfo, UTxO } from '@mesh/common/types';
+export declare class TangoProvider implements IEvaluator, IFetcher, IListener, ISubmitter {
     private readonly _axiosInstance;
     constructor(network: 'mainnet' | 'testnet', appId: string, appKey: string, version?: number);
+    evaluateTx(tx: string): Promise<Omit<Action, 'data'>[]>;
     fetchAccountInfo(address: string): Promise<AccountInfo>;
     fetchAddressUTxOs(address: string, asset?: string): Promise<UTxO[]>;
     fetchAssetAddresses(asset: string): Promise<{
@@ -10,7 +11,10 @@ export declare class TangoProvider implements IFetcher, ISubmitter {
         quantity: string;
     }[]>;
     fetchAssetMetadata(asset: string): Promise<AssetMetadata>;
+    fetchBlockInfo(hash: string): Promise<BlockInfo>;
     fetchHandleAddress(handle: string): Promise<string>;
     fetchProtocolParameters(epoch: number): Promise<Protocol>;
+    fetchTxInfo(hash: string): Promise<TransactionInfo>;
+    onTxConfirmed(txHash: string, callback: () => void, limit?: number): void;
     submitTx(tx: string): Promise<string>;
 }

package/dist/transaction/transaction.service.d.ts

@@ -7,23 +7,24 @@ export declare class Transaction {
     private _totalMints;
     private readonly _era?;
     private readonly _initiator?;
+    private readonly _mintBuilder;
     private readonly _protocolParameters;
     private readonly _txBuilder;
     private readonly _txCertificates;
     private readonly _txInputsBuilder;
     private readonly _txWithdrawals;
     constructor(options?: Partial<CreateTxOptions>);
-    static maskMetadata(cborTx: string): string;
+    static maskMetadata(cborTx: string, era?: Era): string;
     static readMetadata(cborTx: string): string;
-    static writeMetadata(cborTx: string, cborTxMetadata: string): string;
+    static writeMetadata(cborTx: string, cborTxMetadata: string, era?: Era): string;
     get size(): number;
     build(): Promise<string>;
-    burnAsset(forgeScript: string, asset: Asset): Transaction;
+    burnAsset(forgeScript: string | PlutusScript | UTxO, asset: Asset, redeemer?: Partial<Action>): Transaction;
     delegateStake(rewardAddress: string, poolId: string): Transaction;
     deregisterStake(rewardAddress: string): Transaction;
-    mintAsset(forgeScript: string, mint: Mint): Transaction;
+    mintAsset(forgeScript: string | PlutusScript | UTxO, mint: Mint, redeemer?: Partial<Action>): Transaction;
     redeemValue(options: {
-        value: UTxO | Mint;
+        value: UTxO;
         script: PlutusScript | UTxO;
         datum: Data | UTxO;
         redeemer?: Action;
@@ -31,15 +32,84 @@ export declare class Transaction {
     registerStake(rewardAddress: string): Transaction;
     registerPool(params: PoolParams): Transaction;
     retirePool(poolId: string, epochNo: number): Transaction;
+    /**
+     * Adds an output to the transaction.
+     *
+     * @param recipient The recipient of the output.
+     * @param assets The assets to send.
+     * @returns The transaction builder.
+     * @see {@link https://meshjs.dev/apis/transaction#sendAssets}
+     */
     sendAssets(recipient: Recipient, assets: Asset[]): Transaction;
+    /**
+     * Adds a transaction output to the transaction.
+     *
+     * @param {Recipient} recipient The recipient of the transaction.
+     * @param {string} lovelace The amount of lovelace to send.
+     * @returns {Transaction} The Transaction object.
+     * @see {@link https://meshjs.dev/apis/transaction#sendAda}
+     */
     sendLovelace(recipient: Recipient, lovelace: string): Transaction;
+    /**
+     * Adds an output to the transaction.
+     *
+     * @param {Recipient} recipient The recipient of the output.
+     * @param {UTxO} value The UTxO value of the output.
+     * @returns {Transaction} The Transaction object.
+     */
     sendValue(recipient: Recipient, value: UTxO): Transaction;
+    /**
+     * Sets the change address for the transaction.
+     *
+     * @param {string} changeAddress The change address.
+     * @returns {Transaction} The Transaction object.
+     */
     setChangeAddress(changeAddress: string): Transaction;
+    /**
+     * Sets the collateral for the transaction.
+     *
+     * @param {UTxO[]} collateral - Set the UTxO for collateral.
+     * @returns {Transaction} The Transaction object.
+     */
     setCollateral(collateral: UTxO[]): Transaction;
+    /**
+     * Add a JSON metadata entry to the transaction.
+     *
+     * @param {number} key The key to use for the metadata entry.
+     * @param {unknown} value The value to use for the metadata entry.
+     * @returns {Transaction} The Transaction object.
+     * @see {@link https://meshjs.dev/apis/transaction#setMetadata}
+     */
     setMetadata(key: number, value: unknown): Transaction;
+    /**
+     * Sets the required signers for the transaction.
+     *
+     * @param {string[]} addresses The addresses of the required signers.
+     * @returns {Transaction} The Transaction object.
+     */
     setRequiredSigners(addresses: string[]): Transaction;
+    /**
+     * Sets the start slot for the transaction.
+     *
+     * @param {string} slot The start slot for the transaction.
+     * @returns {Transaction} The Transaction object.
+     * @see {@link https://meshjs.dev/apis/transaction#setTimeLimit}
+     */
     setTimeToStart(slot: string): Transaction;
+    /**
+     * Set the time to live for the transaction.
+     *
+     * @param {string} slot The slot number to expire the transaction at.
+     * @returns {Transaction} The Transaction object.
+     * @see {@link https://meshjs.dev/apis/transaction#setTimeLimit}
+     */
     setTimeToExpire(slot: string): Transaction;
+    /**
+     * Sets the inputs for the transaction.
+     *
+     * @param {UTxO[]} inputs The inputs to set.
+     * @returns {Transaction} The transaction.
+     */
     setTxInputs(inputs: UTxO[]): Transaction;
     withdrawRewards(rewardAddress: string, lovelace: string): Transaction;
     private addBurnInputsIfNeeded;

package/package.json

@@ -3,7 +3,7 @@
   "description": "Rapidly build Web3 apps on the Cardano Blockchain.",
   "homepage": "https://meshjs.dev",
   "author": "MeshJS",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -66,8 +66,8 @@
   "dependencies": {
     "@emurgo/cardano-message-signing-browser": "1.0.1",
     "@emurgo/cardano-message-signing-nodejs": "1.0.1",
-    "@emurgo/cardano-serialization-lib-browser": "11.1.1",
-    "@emurgo/cardano-serialization-lib-nodejs": "11.1.1",
+    "@emurgo/cardano-serialization-lib-browser": "11.2.1",
+    "@emurgo/cardano-serialization-lib-nodejs": "11.2.1",
     "@emurgo/cip14-js": "3.0.1",
     "axios": "0.27.2",
     "bip39": "3.0.4",