@lerna-labs/hydra-sdk 1.0.0-beta.15 → 1.0.0-beta.17

package/dist/mesh/get-admin.d.ts

@@ -5,7 +5,10 @@ import { MeshWallet } from '@meshsdk/core';
  * Reads the Cardano signing key from `HYDRA_ADMIN_KEY_FILE` (preferred)
  * or falls back to `HYDRA_ADMIN_CARDANO_PK`. Network is selected via `HYDRA_NETWORK`.
  *
+ * @param blockfrostProjectId - Optional Blockfrost project ID. When provided, the wallet
+ *   is configured with a Blockfrost fetcher and submitter for L1 operations (e.g. preparing
+ *   the Hydra head, querying UTxOs, submitting commit transactions).
  * @returns An initialized MeshWallet ready for signing transactions.
  * @throws If no signing key is available or the wallet fails to initialize.
  */
-export declare function getAdmin(): Promise<MeshWallet>;
+export declare function getAdmin(blockfrostProjectId?: string): Promise<MeshWallet>;

package/dist/mesh/get-admin.js

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { MeshWallet } from '@meshsdk/core';
+import { BlockfrostProvider, MeshWallet } from '@meshsdk/core';
 import { optionalEnv } from '../config.js';
 /**
  * Create and initialize a MeshWallet for the Hydra head admin.
@@ -7,10 +7,13 @@ import { optionalEnv } from '../config.js';
  * Reads the Cardano signing key from `HYDRA_ADMIN_KEY_FILE` (preferred)
  * or falls back to `HYDRA_ADMIN_CARDANO_PK`. Network is selected via `HYDRA_NETWORK`.
  *
+ * @param blockfrostProjectId - Optional Blockfrost project ID. When provided, the wallet
+ *   is configured with a Blockfrost fetcher and submitter for L1 operations (e.g. preparing
+ *   the Hydra head, querying UTxOs, submitting commit transactions).
  * @returns An initialized MeshWallet ready for signing transactions.
  * @throws If no signing key is available or the wallet fails to initialize.
  */
-export async function getAdmin() {
+export async function getAdmin(blockfrostProjectId) {
     let keyCborHex = null;
     // Preferred: read the instance's cardano.sk file directly (no secrets in .env)
     const keyFile = process.env.HYDRA_ADMIN_KEY_FILE;
@@ -32,13 +35,19 @@ export async function getAdmin() {
     else if (networkId > 1) {
         networkId = 1;
     }
-    const wallet = new MeshWallet({
+    const walletOptions = {
         networkId: networkId,
         key: {
             type: 'cli',
             payment: keyCborHex,
         },
-    });
+    };
+    if (blockfrostProjectId) {
+        const blockfrost = new BlockfrostProvider(blockfrostProjectId);
+        walletOptions.fetcher = blockfrost;
+        walletOptions.submitter = blockfrost;
+    }
+    const wallet = new MeshWallet(walletOptions);
     await wallet.init();
     if (!wallet.addresses.enterpriseAddressBech32) {
         throw new Error('Wallet failed to initialize!');

package/dist/mesh/wrangler.js

@@ -81,11 +81,19 @@ export class Wrangler {
                 clearTimeout(timer);
                 fn(value);
             };
-            this.provider.onMessage((message) => {
-                handler(message, (value) => settle(resolve, value), (reason) => settle(reject, reason));
-            });
             const timer = setTimeout(() => settle(reject, new Error(timeoutMessage)), timeoutMs);
-            this.connectWithRetry().catch((err) => settle(reject, new Error(`Failed to connect: ${String(err)}`)));
+            // Connect first, then register the message handler. HydraProvider.isConnected()
+            // internally calls onMessage() (single-callback replacement), which would overwrite
+            // any handler set beforehand. By connecting first, isConnected() consumes the
+            // Greetings message via its own handler. Once connected, we register our handler —
+            // onMessage() replays the _messageQueue, so the Greetings is re-delivered to us.
+            this.connectWithRetry()
+                .then(() => {
+                this.provider.onMessage((message) => {
+                    handler(message, (value) => settle(resolve, value), (reason) => settle(reject, reason));
+                });
+            })
+                .catch((err) => settle(reject, new Error(`Failed to connect: ${String(err)}`)));
         });
     }
     /** Connect the underlying HydraProvider WebSocket with retry logic. */
@@ -107,14 +115,14 @@ export class Wrangler {
     /** Begin the head-opening sequence: init, commit, and listen for state changes. */
     async startHead(commitArgs) {
         this.mode = 'start';
-        this.provider.onMessage((msg) => this.handleIncoming(msg, commitArgs));
         await this.connectWithRetry();
+        this.provider.onMessage((msg) => this.handleIncoming(msg, commitArgs));
     }
     /** Begin the head-closing sequence: close, fanout, and finalize. */
     async shutdownHead() {
         this.mode = 'shutdown';
-        this.provider.onMessage((msg) => this.handleIncoming(msg));
         await this.connectWithRetry();
+        this.provider.onMessage((msg) => this.handleIncoming(msg));
     }
     /**
      * Wait for the Hydra head to fully close and finalize.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerna-labs/hydra-sdk",
-  "version": "1.0.0-beta.15",
+  "version": "1.0.0-beta.17",
   "description": "TypeScript SDK for managing Cardano Hydra Heads — lifecycle, UTxO queries, wallet management, transaction submission, and signature verification",
   "keywords": [
     "cardano",