@meshsdk/wallet 1.9.0-beta.74 → 1.9.0-beta.76

package/dist/index.cjs

@@ -1734,6 +1734,18 @@ var MeshWallet = class {
     }
     return this.addresses.enterpriseAddressBech32;
   }
+  /**
+   * Returns an address owned by the wallet that should be used as a change address to return leftover assets during transaction creation back to the connected wallet in hex format.
+   *
+   * @returns an address in hex format
+   */
+  async getChangeAddressHex(addressType = "payment") {
+    await this.init();
+    if (this.addresses.baseAddress && addressType === "payment") {
+      return this.addresses.baseAddress.toBytes().toString();
+    }
+    return this.addresses.enterpriseAddress.toBytes().toString();
+  }
   /**
    * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
    *
@@ -1749,6 +1761,21 @@ var MeshWallet = class {
       return (0, import_core_cst5.fromTxUnspentOutput)(utxo);
     });
   }
+  /**
+   * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
+   *
+   * If this cannot be attained, an error message with an explanation of the blocking problem shall be returned. NOTE: wallets are free to return UTXOs that add up to a greater total ADA value than requested in the amount parameter, but wallets must never return any result where UTXOs would sum up to a smaller total ADA value, instead in a case like that an error message must be returned.
+   *
+   * @param addressType - the type of address to fetch UTXOs from (default: payment)
+   * @returns a list of UTXOs in hex format
+   */
+  async getCollateralHex(addressType = "payment") {
+    await this.init();
+    const utxos = await this.getCollateralUnspentOutput(addressType);
+    return utxos.map((utxo) => {
+      return utxo.toCbor().toString();
+    });
+  }
   /**
    * Return a list of supported CIPs of the wallet.
    *
@@ -1813,6 +1840,13 @@ var MeshWallet = class {
   async getRewardAddresses() {
     return [this.addresses.rewardAddressBech32];
   }
+  /**
+   * Returns a list of reward addresses owned by the wallet. A reward address is a stake address that is used to receive rewards from staking.
+   * @returns a list of reward addresses in hex format
+   */
+  async getRewardAddressesHex() {
+    return [this.addresses.rewardAddress.toBytes().toString()];
+  }
   /**
    * Returns a list of unused addresses controlled by the wallet.
    *
@@ -1821,6 +1855,14 @@ var MeshWallet = class {
   async getUnusedAddresses() {
     return [await this.getChangeAddress()];
   }
+  /**
+   * Returns a list of unused addresses controlled by the wallet.
+   *
+   * @returns a list of unused addresses in hex format
+   */
+  async getUnusedAddressesHex() {
+    return [await this.getChangeAddressHex()];
+  }
   /**
    * Returns a list of used addresses controlled by the wallet.
    *
@@ -1829,6 +1871,14 @@ var MeshWallet = class {
   async getUsedAddresses() {
     return [await this.getChangeAddress()];
   }
+  /**
+   * Returns a list of used addresses controlled by the wallet.
+   *
+   * @returns a list of used addresses in hex format
+   */
+  async getUsedAddressesHex() {
+    return [await this.getChangeAddressHex()];
+  }
   /**
    * Get a list of UTXOs to be used for transaction building.
    *
@@ -1851,6 +1901,16 @@ var MeshWallet = class {
     const utxos = await this.getUsedUTxOs(addressType);
     return utxos.map((c) => (0, import_core_cst5.fromTxUnspentOutput)(c));
   }
+  /**
+   * Return a list of all UTXOs (unspent transaction outputs) controlled by the wallet.
+   *
+   * @param addressType - the type of address to fetch UTXOs from (default: payment)
+   * @returns a list of UTXOs in hex format
+   */
+  async getUtxosHex(addressType = "payment") {
+    const utxos = await this.getUsedUTxOs(addressType);
+    return utxos.map((c) => c.toCbor().toString());
+  }
   /**
    * This endpoint utilizes the [CIP-8 - Message Signing](https://cips.cardano.org/cips/cip8/) to sign arbitrary data, to verify the data was signed by the owner of the private key.
    *
@@ -1909,7 +1969,7 @@ var MeshWallet = class {
           import_core_cst5.VkeyWitness.fromCore
         )
       );
-      return witnessSet.toCbor();
+      return witnessSet.toCbor().toString();
     }
     let signedTx = EmbeddedWallet.addWitnessSets(unsignedTx, [newSignatures]);
     return signedTx;
@@ -1921,7 +1981,7 @@ var MeshWallet = class {
    * @param partialSign - if the transactions are signed partially
    * @returns array of signed transactions CborHex string
    */
-  async signTxs(unsignedTxs, partialSign = false) {
+  async signTxs(unsignedTxs, partialSign = false, returnFullTx = true) {
     await this.init();
     if (!this._wallet) {
       throw new Error(
@@ -1930,7 +1990,7 @@ var MeshWallet = class {
     }
     const signedTxs = [];
     for (const unsignedTx of unsignedTxs) {
-      const signedTx = await this.signTx(unsignedTx, partialSign);
+      const signedTx = await this.signTx(unsignedTx, partialSign, returnFullTx);
       signedTxs.push(signedTx);
     }
     return signedTxs;

package/dist/index.d.cts

@@ -577,6 +577,12 @@ declare class MeshWallet implements IWallet {
      * @returns an address
      */
     getChangeAddress(addressType?: GetAddressType): Promise<string>;
+    /**
+     * Returns an address owned by the wallet that should be used as a change address to return leftover assets during transaction creation back to the connected wallet in hex format.
+     *
+     * @returns an address in hex format
+     */
+    getChangeAddressHex(addressType?: GetAddressType): Promise<string>;
     /**
      * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
      *
@@ -586,6 +592,15 @@ declare class MeshWallet implements IWallet {
      * @returns a list of UTXOs
      */
     getCollateral(addressType?: GetAddressType): Promise<UTxO[]>;
+    /**
+     * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
+     *
+     * If this cannot be attained, an error message with an explanation of the blocking problem shall be returned. NOTE: wallets are free to return UTXOs that add up to a greater total ADA value than requested in the amount parameter, but wallets must never return any result where UTXOs would sum up to a smaller total ADA value, instead in a case like that an error message must be returned.
+     *
+     * @param addressType - the type of address to fetch UTXOs from (default: payment)
+     * @returns a list of UTXOs in hex format
+     */
+    getCollateralHex(addressType?: GetAddressType): Promise<string[]>;
     /**
      * Return a list of supported CIPs of the wallet.
      *
@@ -624,18 +639,35 @@ declare class MeshWallet implements IWallet {
      * @returns a list of reward addresses
      */
     getRewardAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of reward addresses owned by the wallet. A reward address is a stake address that is used to receive rewards from staking.
+     * @returns a list of reward addresses in hex format
+     */
+    getRewardAddressesHex(): Promise<string[]>;
     /**
      * Returns a list of unused addresses controlled by the wallet.
      *
      * @returns a list of unused addresses
      */
     getUnusedAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of unused addresses controlled by the wallet.
+     *
+     * @returns a list of unused addresses in hex format
+     */
+    getUnusedAddressesHex(): Promise<string[]>;
     /**
      * Returns a list of used addresses controlled by the wallet.
      *
      * @returns a list of used addresses
      */
     getUsedAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of used addresses controlled by the wallet.
+     *
+     * @returns a list of used addresses in hex format
+     */
+    getUsedAddressesHex(): Promise<string[]>;
     /**
      * Get a list of UTXOs to be used for transaction building.
      *
@@ -652,6 +684,13 @@ declare class MeshWallet implements IWallet {
      * @returns a list of UTXOs
      */
     getUtxos(addressType?: GetAddressType): Promise<UTxO[]>;
+    /**
+     * Return a list of all UTXOs (unspent transaction outputs) controlled by the wallet.
+     *
+     * @param addressType - the type of address to fetch UTXOs from (default: payment)
+     * @returns a list of UTXOs in hex format
+     */
+    getUtxosHex(addressType?: GetAddressType): Promise<string[]>;
     /**
      * This endpoint utilizes the [CIP-8 - Message Signing](https://cips.cardano.org/cips/cip8/) to sign arbitrary data, to verify the data was signed by the owner of the private key.
      *
@@ -676,7 +715,7 @@ declare class MeshWallet implements IWallet {
      * @param partialSign - if the transactions are signed partially
      * @returns array of signed transactions CborHex string
      */
-    signTxs(unsignedTxs: string[], partialSign?: boolean): Promise<string[]>;
+    signTxs(unsignedTxs: string[], partialSign?: boolean, returnFullTx?: boolean): Promise<string[]>;
     /**
      * Submits the signed transaction to the blockchain network.
      *

package/dist/index.d.ts

@@ -577,6 +577,12 @@ declare class MeshWallet implements IWallet {
      * @returns an address
      */
     getChangeAddress(addressType?: GetAddressType): Promise<string>;
+    /**
+     * Returns an address owned by the wallet that should be used as a change address to return leftover assets during transaction creation back to the connected wallet in hex format.
+     *
+     * @returns an address in hex format
+     */
+    getChangeAddressHex(addressType?: GetAddressType): Promise<string>;
     /**
      * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
      *
@@ -586,6 +592,15 @@ declare class MeshWallet implements IWallet {
      * @returns a list of UTXOs
      */
     getCollateral(addressType?: GetAddressType): Promise<UTxO[]>;
+    /**
+     * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
+     *
+     * If this cannot be attained, an error message with an explanation of the blocking problem shall be returned. NOTE: wallets are free to return UTXOs that add up to a greater total ADA value than requested in the amount parameter, but wallets must never return any result where UTXOs would sum up to a smaller total ADA value, instead in a case like that an error message must be returned.
+     *
+     * @param addressType - the type of address to fetch UTXOs from (default: payment)
+     * @returns a list of UTXOs in hex format
+     */
+    getCollateralHex(addressType?: GetAddressType): Promise<string[]>;
     /**
      * Return a list of supported CIPs of the wallet.
      *
@@ -624,18 +639,35 @@ declare class MeshWallet implements IWallet {
      * @returns a list of reward addresses
      */
     getRewardAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of reward addresses owned by the wallet. A reward address is a stake address that is used to receive rewards from staking.
+     * @returns a list of reward addresses in hex format
+     */
+    getRewardAddressesHex(): Promise<string[]>;
     /**
      * Returns a list of unused addresses controlled by the wallet.
      *
      * @returns a list of unused addresses
      */
     getUnusedAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of unused addresses controlled by the wallet.
+     *
+     * @returns a list of unused addresses in hex format
+     */
+    getUnusedAddressesHex(): Promise<string[]>;
     /**
      * Returns a list of used addresses controlled by the wallet.
      *
      * @returns a list of used addresses
      */
     getUsedAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of used addresses controlled by the wallet.
+     *
+     * @returns a list of used addresses in hex format
+     */
+    getUsedAddressesHex(): Promise<string[]>;
     /**
      * Get a list of UTXOs to be used for transaction building.
      *
@@ -652,6 +684,13 @@ declare class MeshWallet implements IWallet {
      * @returns a list of UTXOs
      */
     getUtxos(addressType?: GetAddressType): Promise<UTxO[]>;
+    /**
+     * Return a list of all UTXOs (unspent transaction outputs) controlled by the wallet.
+     *
+     * @param addressType - the type of address to fetch UTXOs from (default: payment)
+     * @returns a list of UTXOs in hex format
+     */
+    getUtxosHex(addressType?: GetAddressType): Promise<string[]>;
     /**
      * This endpoint utilizes the [CIP-8 - Message Signing](https://cips.cardano.org/cips/cip8/) to sign arbitrary data, to verify the data was signed by the owner of the private key.
      *
@@ -676,7 +715,7 @@ declare class MeshWallet implements IWallet {
      * @param partialSign - if the transactions are signed partially
      * @returns array of signed transactions CborHex string
      */
-    signTxs(unsignedTxs: string[], partialSign?: boolean): Promise<string[]>;
+    signTxs(unsignedTxs: string[], partialSign?: boolean, returnFullTx?: boolean): Promise<string[]>;
     /**
      * Submits the signed transaction to the blockchain network.
      *

package/dist/index.js

@@ -1787,6 +1787,18 @@ var MeshWallet = class {
     }
     return this.addresses.enterpriseAddressBech32;
   }
+  /**
+   * Returns an address owned by the wallet that should be used as a change address to return leftover assets during transaction creation back to the connected wallet in hex format.
+   *
+   * @returns an address in hex format
+   */
+  async getChangeAddressHex(addressType = "payment") {
+    await this.init();
+    if (this.addresses.baseAddress && addressType === "payment") {
+      return this.addresses.baseAddress.toBytes().toString();
+    }
+    return this.addresses.enterpriseAddress.toBytes().toString();
+  }
   /**
    * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
    *
@@ -1802,6 +1814,21 @@ var MeshWallet = class {
       return fromTxUnspentOutput2(utxo);
     });
   }
+  /**
+   * This function shall return a list of one or more UTXOs (unspent transaction outputs) controlled by the wallet that are required to reach AT LEAST the combined ADA value target specified in amount AND the best suitable to be used as collateral inputs for transactions with plutus script inputs (pure ADA-only UTXOs).
+   *
+   * If this cannot be attained, an error message with an explanation of the blocking problem shall be returned. NOTE: wallets are free to return UTXOs that add up to a greater total ADA value than requested in the amount parameter, but wallets must never return any result where UTXOs would sum up to a smaller total ADA value, instead in a case like that an error message must be returned.
+   *
+   * @param addressType - the type of address to fetch UTXOs from (default: payment)
+   * @returns a list of UTXOs in hex format
+   */
+  async getCollateralHex(addressType = "payment") {
+    await this.init();
+    const utxos = await this.getCollateralUnspentOutput(addressType);
+    return utxos.map((utxo) => {
+      return utxo.toCbor().toString();
+    });
+  }
   /**
    * Return a list of supported CIPs of the wallet.
    *
@@ -1866,6 +1893,13 @@ var MeshWallet = class {
   async getRewardAddresses() {
     return [this.addresses.rewardAddressBech32];
   }
+  /**
+   * Returns a list of reward addresses owned by the wallet. A reward address is a stake address that is used to receive rewards from staking.
+   * @returns a list of reward addresses in hex format
+   */
+  async getRewardAddressesHex() {
+    return [this.addresses.rewardAddress.toBytes().toString()];
+  }
   /**
    * Returns a list of unused addresses controlled by the wallet.
    *
@@ -1874,6 +1908,14 @@ var MeshWallet = class {
   async getUnusedAddresses() {
     return [await this.getChangeAddress()];
   }
+  /**
+   * Returns a list of unused addresses controlled by the wallet.
+   *
+   * @returns a list of unused addresses in hex format
+   */
+  async getUnusedAddressesHex() {
+    return [await this.getChangeAddressHex()];
+  }
   /**
    * Returns a list of used addresses controlled by the wallet.
    *
@@ -1882,6 +1924,14 @@ var MeshWallet = class {
   async getUsedAddresses() {
     return [await this.getChangeAddress()];
   }
+  /**
+   * Returns a list of used addresses controlled by the wallet.
+   *
+   * @returns a list of used addresses in hex format
+   */
+  async getUsedAddressesHex() {
+    return [await this.getChangeAddressHex()];
+  }
   /**
    * Get a list of UTXOs to be used for transaction building.
    *
@@ -1904,6 +1954,16 @@ var MeshWallet = class {
     const utxos = await this.getUsedUTxOs(addressType);
     return utxos.map((c) => fromTxUnspentOutput2(c));
   }
+  /**
+   * Return a list of all UTXOs (unspent transaction outputs) controlled by the wallet.
+   *
+   * @param addressType - the type of address to fetch UTXOs from (default: payment)
+   * @returns a list of UTXOs in hex format
+   */
+  async getUtxosHex(addressType = "payment") {
+    const utxos = await this.getUsedUTxOs(addressType);
+    return utxos.map((c) => c.toCbor().toString());
+  }
   /**
    * This endpoint utilizes the [CIP-8 - Message Signing](https://cips.cardano.org/cips/cip8/) to sign arbitrary data, to verify the data was signed by the owner of the private key.
    *
@@ -1962,7 +2022,7 @@ var MeshWallet = class {
           VkeyWitness4.fromCore
         )
       );
-      return witnessSet.toCbor();
+      return witnessSet.toCbor().toString();
     }
     let signedTx = EmbeddedWallet.addWitnessSets(unsignedTx, [newSignatures]);
     return signedTx;
@@ -1974,7 +2034,7 @@ var MeshWallet = class {
    * @param partialSign - if the transactions are signed partially
    * @returns array of signed transactions CborHex string
    */
-  async signTxs(unsignedTxs, partialSign = false) {
+  async signTxs(unsignedTxs, partialSign = false, returnFullTx = true) {
     await this.init();
     if (!this._wallet) {
       throw new Error(
@@ -1983,7 +2043,7 @@ var MeshWallet = class {
     }
     const signedTxs = [];
     for (const unsignedTx of unsignedTxs) {
-      const signedTx = await this.signTx(unsignedTx, partialSign);
+      const signedTx = await this.signTx(unsignedTx, partialSign, returnFullTx);
       signedTxs.push(signedTx);
     }
     return signedTxs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshsdk/wallet",
-  "version": "1.9.0-beta.74",
+  "version": "1.9.0-beta.76",
   "description": "Wallets - https://meshjs.dev/apis/wallets",
   "main": "./dist/index.cjs",
   "browser": "./dist/index.js",
@@ -35,9 +35,9 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.9.0-beta.74",
-    "@meshsdk/core-cst": "1.9.0-beta.74",
-    "@meshsdk/transaction": "1.9.0-beta.74",
+    "@meshsdk/common": "1.9.0-beta.76",
+    "@meshsdk/core-cst": "1.9.0-beta.76",
+    "@meshsdk/transaction": "1.9.0-beta.76",
     "@simplewebauthn/browser": "^13.0.0"
   },
   "prettier": "@meshsdk/configs/prettier",