@lerna-labs/hydra-sdk 1.0.0-beta.14 → 1.0.0-beta.16

package/README.md

@@ -126,7 +126,7 @@ const chunks = chunkString("abcdef", 2); // ["ab", "cd", "ef"]
 |--------|-------------|
 | `getAdmin()` | Create a `MeshWallet` from env-configured signing key |
 | `createMultisigAddress(addr1, addr2, networkId?, scriptType?)` | Build a multisig address from two participant addresses |
-| `createNativeScript(addr, networkId?, scriptType?, invalidBefore?, invalidHereafter?)` | Build a native script address with optional time bounds |
+| `createNativeScript(addr, opts?)` | Build a native script policy — bare `sig` by default, or time-bound `all:[sig, before]` when `opts.invalidHereafter` is set |
 | `getUtxoSet()` | Fetch all UTxOs in the Hydra Head |
 | `queryUtxoByAddress(address)` | Fetch UTxOs for a specific address |
 | `submitTx(endpoint, payload, id)` | Submit a signed transaction to the Hydra node |

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/native-script.d.ts

@@ -15,14 +15,22 @@ export declare function createMultisigAddress(address1: string, address2: string
 /**
  * Create a native script policy for minting tokens.
  *
- * @param address1 - Address (bech32) whose key hash is the required signer.
- * @param networkId - `0` for testnet, `1` for mainnet.
- * @param scriptType - `"any"` or `"all"` when combined with time-lock scripts.
- * @param invalidBefore - Optional slot number before which the script is invalid.
- * @param invalidHereafter - Optional slot number after which the script is invalid.
+ * Without options, produces a bare `sig(keyHash)` script suitable for
+ * in-head voter tokens that must remain burnable by the admin.
+ *
+ * When `invalidHereafter` is provided, produces a compound time-bound
+ * script: `all: [sig(keyHash), before(slot)]` — each ballot gets its
+ * own time-bound policy.
+ *
+ * @param address - Address (bech32) whose key hash is the required signer.
+ * @param opts.invalidHereafter - Slot after which minting is no longer possible.
+ * @param opts.networkId - `0` for testnet (default), `1` for mainnet.
  * @returns The script address, serialized CBOR, and script hash.
  */
-export declare function createNativeScript(address1: string, networkId?: number, scriptType?: 'any' | 'all', invalidBefore?: number | null, invalidHereafter?: number | null): {
+export declare function createNativeScript(address: string, opts?: {
+    invalidHereafter?: number;
+    networkId?: number;
+}): {
     address: string;
     scriptCbor?: string;
     scriptHash?: string;

package/dist/mesh/native-script.js

@@ -31,37 +31,29 @@ export function createMultisigAddress(address1, address2, networkId = 0, scriptT
 /**
  * Create a native script policy for minting tokens.
  *
- * @param address1 - Address (bech32) whose key hash is the required signer.
- * @param networkId - `0` for testnet, `1` for mainnet.
- * @param scriptType - `"any"` or `"all"` when combined with time-lock scripts.
- * @param invalidBefore - Optional slot number before which the script is invalid.
- * @param invalidHereafter - Optional slot number after which the script is invalid.
+ * Without options, produces a bare `sig(keyHash)` script suitable for
+ * in-head voter tokens that must remain burnable by the admin.
+ *
+ * When `invalidHereafter` is provided, produces a compound time-bound
+ * script: `all: [sig(keyHash), before(slot)]` — each ballot gets its
+ * own time-bound policy.
+ *
+ * @param address - Address (bech32) whose key hash is the required signer.
+ * @param opts.invalidHereafter - Slot after which minting is no longer possible.
+ * @param opts.networkId - `0` for testnet (default), `1` for mainnet.
  * @returns The script address, serialized CBOR, and script hash.
  */
-export function createNativeScript(address1, networkId = 0, scriptType = 'all', invalidBefore = null, invalidHereafter = null) {
-    const keyHash = deserializeAddress(address1).pubKeyHash;
-    const script = {
-        type: scriptType,
-        scripts: [
-            {
-                type: 'sig',
-                keyHash,
-            },
-        ],
-    };
-    if (invalidBefore) {
-        script.scripts.push({
-            type: 'after',
-            slot: invalidBefore.toString(),
-        });
-    }
-    if (invalidHereafter) {
-        script.scripts.push({
-            type: 'before',
-            slot: invalidHereafter.toString(),
-        });
-    }
-    const { address, scriptCbor } = serializeNativeScript(script, undefined, networkId);
+export function createNativeScript(address, opts) {
+    const networkId = opts?.networkId ?? 0;
+    const keyHash = deserializeAddress(address).pubKeyHash;
+    const sigScript = { type: 'sig', keyHash };
+    const script = opts?.invalidHereafter != null
+        ? {
+            type: 'all',
+            scripts: [sigScript, { type: 'before', slot: opts.invalidHereafter.toString() }],
+        }
+        : sigScript;
+    const { address: scriptAddress, scriptCbor } = serializeNativeScript(script, undefined, networkId);
     const scriptHash = scriptCbor != null ? resolveScriptHash(scriptCbor) : undefined;
-    return { address, scriptCbor, scriptHash };
+    return { address: scriptAddress, scriptCbor, scriptHash };
 }

package/package.json

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