@miden-sdk/react 0.15.4 → 0.15.6

package/CLAUDE.md

@@ -165,6 +165,22 @@ await bridge({
 });
 ```
 
+### Create a Network Note
+```tsx
+const { createNetworkNote } = useCreateNetworkNote();
+
+// Builds a Public custom-script note carrying a NetworkAccountTarget
+// attachment; the targeted network account auto-consumes it on-chain.
+// Provide exactly one of `script` or `recipient`.
+const { txId, note } = await createNetworkNote({
+  accountId: senderAccountId,
+  target: networkAccountId,
+  script: myNoteScript, // or: recipient: myRecipient
+});
+
+note.isNetworkNote(); // true
+```
+
 ### Create Faucet
 ```tsx
 const { createFaucet } = useCreateFaucet();
@@ -427,6 +443,7 @@ Query hooks return `{ ...data, isLoading, error, refetch }`. Mutation hooks retu
 | `useMultiSend()` | `multiSend({ from, recipients })` | `TransactionResult` |
 | `useMint()` | `mint({ faucetId, to, amount })` | `TransactionResult` |
 | `useBridge()` | `bridge({ from, bridgeAccount, assetId, amount, destinationNetwork, destinationAddress })` | `TransactionResult` (emits an AggLayer B2AGG bridge-out note) |
+| `useCreateNetworkNote()` | `createNetworkNote({ accountId, target, script \| recipient, ... })` | `NetworkNoteResult` (`{ txId, note }`; note satisfies `note.isNetworkNote()`) |
 | `useConsume()` | `consume({ accountId, notes })` | `TransactionResult` |
 | `useSwap()` | `swap({ ... })` | `TransactionResult` |
 | `usePswapCreate()` | `pswapCreate({ accountId, offeredFaucetId, offeredAmount, requestedFaucetId, requestedAmount, ... })` | `TransactionResult` (creates partial-swap note) |

package/README.md

@@ -13,6 +13,7 @@ React hooks library for the Miden Web Client. Provides a simple, ergonomic inter
 - **Temporal Note Tracking** - `useNoteStream()` tracks when notes first appear, with built-in filtering, handled-note exclusion, and phase snapshots
 - **Session Wallets** - `useSessionAccount()` manages the create-fund-consume lifecycle for temporary wallets
 - **AggLayer Bridge-Out** - `useBridge()` emits a B2AGG note to bridge a fungible asset out to another network via the AggLayer
+- **Network Notes** - `useCreateNetworkNote()` creates custom-script network notes
 - **Concurrency Safety** - Transaction hooks prevent double-sends with built-in concurrency guards
 - **Auto Pre-Sync** - Transaction hooks sync before executing by default (opt out with `skipSync`)
 - **WASM Error Wrapping** - Cryptic WASM errors are intercepted and replaced with actionable messages

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, NoteInput, PswapLineageRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteScript, NoteAttachment } from '@miden-sdk/miden-sdk';
+import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, NoteExecutionHint, NoteRecipient, NoteScript, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, NoteInput, PswapLineageRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteAttachment } from '@miden-sdk/miden-sdk';
 export { Account, AccountFile, AccountHeader, AccountId, AccountStorageMode, AuthScheme, ConsumableNoteRecord, InputNoteRecord, Note, NoteType, PswapLineageRecord, TransactionFilter, TransactionId, TransactionRecord, TransactionRequest, WasmWebClient as WebClient } from '@miden-sdk/miden-sdk';
 
 declare module "@miden-sdk/miden-sdk" {
@@ -392,6 +392,30 @@ interface MintOptions {
     /** Note type. Default: private */
     noteType?: NoteVisibility;
 }
+interface CreateNetworkNoteOptions {
+    /** Account that creates, funds, and submits the note (executing sender). */
+    accountId: AccountRef;
+    /** The network account the note targets. */
+    target: AccountRef;
+    /** Execution hint. Defaults to `always`. */
+    executionHint?: NoteExecutionHint;
+    /** Recipient carrying the custom script (advanced; else pass `script`). */
+    recipient?: NoteRecipient;
+    /** Custom consumption script; the recipient is built for you. */
+    script?: NoteScript;
+    /** Note storage / inputs the script reads (used with `script`). */
+    inputs?: bigint[];
+    /** Single asset to lock into the note. Optional — omit for a zero-asset note. */
+    assetId?: AccountRef;
+    /** Amount for `assetId`. */
+    amount?: bigint | number;
+    /** Extra attachment payload appended after the NetworkAccountTarget. */
+    attachment?: bigint[] | Uint8Array | number[];
+}
+interface NetworkNoteResult {
+    txId: string;
+    note: Note;
+}
 interface BridgeOptions {
     /** Account that creates and funds the bridge note (the sender) */
     from: AccountRef;
@@ -1492,6 +1516,22 @@ interface UsePswapCancelByOrderResult {
  */
 declare function usePswapCancelByOrder(): UsePswapCancelByOrderResult;
 
+interface UseCreateNetworkNoteResult {
+    /** Build + submit a Public custom-script network note. */
+    createNetworkNote: (options: CreateNetworkNoteOptions) => Promise<NetworkNoteResult>;
+    result: NetworkNoteResult | null;
+    isLoading: boolean;
+    stage: TransactionStage;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook that builds a Public custom-script note carrying a `NetworkAccountTarget`
+ * attachment and submits it as an own output note, so a public network account
+ * auto-consumes it. Provide exactly one of `recipient` or `script`.
+ */
+declare function useCreateNetworkNote(): UseCreateNetworkNoteResult;
+
 interface UseTransactionResult {
     /** Execute a transaction request end-to-end */
     execute: (options: ExecuteTransactionOptions) => Promise<TransactionResult>;
@@ -1911,4 +1951,4 @@ declare function createMidenStorage(prefix: string): {
     clear(): void;
 };
 
-export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, type BridgeOptions, type ConsumeOptions, type CreateFaucetOptions, type CreateWalletOptions, DEFAULTS, type ExecuteProgramOptions, type ExecuteProgramResult, type ExecuteTransactionOptions, type ImportAccountOptions, type ImportStoreOptions, type MidenConfig, MidenError, type MidenErrorCode, MidenProvider, type MidenState, type MigrateStorageOptions, type MintOptions, type MultiSendOptions, type MultiSendRecipient, type MultiSignerContextValue, MultiSignerProvider, type MutationResult, type NoteAsset, type NoteAttachmentData, type NoteSummary, type NotesFilter, type NotesResult, type ProverConfig, type ProverTarget, type ProverUrls, type PswapCancelByOrderOptions, type PswapCancelOptions, type PswapConsumeOptions, type PswapCreateOptions, type PswapLineageResult, type PswapLineagesResult, type QueryResult, type RpcUrlConfig, type SendOptions, type SendResult, type SessionAccountStep, type SignCallback, type SignerAccountConfig, type SignerAccountType, SignerContext, type SignerContextValue, SignerSlot, type StreamedNote, type SwapOptions, type SyncState, type TransactionHistoryOptions, type TransactionHistoryResult, type TransactionResult, type TransactionStage, type TransactionStatus, type UseBridgeResult, type UseCompileResult, type UseConsumeResult, type UseCreateFaucetResult, type UseCreateWalletResult, type UseExecuteProgramResult, type UseExportNoteResult, type UseExportStoreResult, type UseImportAccountResult, type UseImportNoteResult, type UseImportStoreResult, type UseMintResult, type UseMultiSendResult, type UseNoteStreamOptions, type UseNoteStreamReturn, type UsePswapCancelByOrderResult, type UsePswapCancelResult, type UsePswapConsumeResult, type UsePswapCreateResult, type UsePswapLineageResult, type UsePswapLineagesForResult, type UsePswapLineagesResult, type UseSendResult, type UseSessionAccountOptions, type UseSessionAccountReturn, type UseSwapResult, type UseSyncControlResult, type UseSyncStateResult, type UseTransactionHistoryResult, type UseTransactionResult, type UseWaitForCommitResult, type UseWaitForNotesResult, type WaitForCommitOptions, type WaitForNotesOptions, type WalletAdapterLike, accountIdsEqual, bigIntToBytes, bytesToBigInt, clearMidenStorage, concatBytes, createMidenStorage, createNoteAttachment, ensureAccountBech32, formatAssetAmount, formatNoteSummary, getNoteSummary, installAccountBech32, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useBridge, useCompile, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, usePswapCancel, usePswapCancelByOrder, usePswapConsume, usePswapCreate, usePswapLineage, usePswapLineages, usePswapLineagesFor, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };
+export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, type BridgeOptions, type ConsumeOptions, type CreateFaucetOptions, type CreateNetworkNoteOptions, type CreateWalletOptions, DEFAULTS, type ExecuteProgramOptions, type ExecuteProgramResult, type ExecuteTransactionOptions, type ImportAccountOptions, type ImportStoreOptions, type MidenConfig, MidenError, type MidenErrorCode, MidenProvider, type MidenState, type MigrateStorageOptions, type MintOptions, type MultiSendOptions, type MultiSendRecipient, type MultiSignerContextValue, MultiSignerProvider, type MutationResult, type NetworkNoteResult, type NoteAsset, type NoteAttachmentData, type NoteSummary, type NotesFilter, type NotesResult, type ProverConfig, type ProverTarget, type ProverUrls, type PswapCancelByOrderOptions, type PswapCancelOptions, type PswapConsumeOptions, type PswapCreateOptions, type PswapLineageResult, type PswapLineagesResult, type QueryResult, type RpcUrlConfig, type SendOptions, type SendResult, type SessionAccountStep, type SignCallback, type SignerAccountConfig, type SignerAccountType, SignerContext, type SignerContextValue, SignerSlot, type StreamedNote, type SwapOptions, type SyncState, type TransactionHistoryOptions, type TransactionHistoryResult, type TransactionResult, type TransactionStage, type TransactionStatus, type UseBridgeResult, type UseCompileResult, type UseConsumeResult, type UseCreateFaucetResult, type UseCreateNetworkNoteResult, type UseCreateWalletResult, type UseExecuteProgramResult, type UseExportNoteResult, type UseExportStoreResult, type UseImportAccountResult, type UseImportNoteResult, type UseImportStoreResult, type UseMintResult, type UseMultiSendResult, type UseNoteStreamOptions, type UseNoteStreamReturn, type UsePswapCancelByOrderResult, type UsePswapCancelResult, type UsePswapConsumeResult, type UsePswapCreateResult, type UsePswapLineageResult, type UsePswapLineagesForResult, type UsePswapLineagesResult, type UseSendResult, type UseSessionAccountOptions, type UseSessionAccountReturn, type UseSwapResult, type UseSyncControlResult, type UseSyncStateResult, type UseTransactionHistoryResult, type UseTransactionResult, type UseWaitForCommitResult, type UseWaitForNotesResult, type WaitForCommitOptions, type WaitForNotesOptions, type WalletAdapterLike, accountIdsEqual, bigIntToBytes, bytesToBigInt, clearMidenStorage, concatBytes, createMidenStorage, createNoteAttachment, ensureAccountBech32, formatAssetAmount, formatNoteSummary, getNoteSummary, installAccountBech32, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useBridge, useCompile, useConsume, useCreateFaucet, useCreateNetworkNote, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, usePswapCancel, usePswapCancelByOrder, usePswapConsume, usePswapCreate, usePswapLineage, usePswapLineages, usePswapLineagesFor, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };

package/dist/index.mjs

@@ -3305,11 +3305,124 @@ function usePswapCancelByOrder() {
   };
 }
 
+// src/hooks/useCreateNetworkNote.ts
+import { useCallback as useCallback27, useState as useState23 } from "react";
+import {
+  Felt,
+  FeltArray,
+  FungibleAsset as FungibleAsset3,
+  Note as Note3,
+  NoteArray as NoteArray3,
+  NoteAssets as NoteAssets3,
+  NoteMetadata,
+  NoteStorage,
+  NoteRecipient,
+  NoteTag,
+  NoteType as NoteType4,
+  NetworkAccountTarget,
+  TransactionRequestBuilder as TransactionRequestBuilder3
+} from "@miden-sdk/miden-sdk";
+function useCreateNetworkNote() {
+  const { client, isReady, sync, runExclusive, prover } = useMiden();
+  const runExclusiveSafe = runExclusive ?? runExclusiveDirect;
+  const [result, setResult] = useState23(null);
+  const [isLoading, setIsLoading] = useState23(false);
+  const [stage, setStage] = useState23("idle");
+  const [error, setError] = useState23(null);
+  const createNetworkNote = useCallback27(
+    async (options) => {
+      if (!client || !isReady) {
+        throw new Error("Miden client is not ready");
+      }
+      if (options.recipient && options.script) {
+        throw new Error(
+          "createNetworkNote requires exactly one of `recipient` or `script`, not both."
+        );
+      }
+      if (!options.recipient && !options.script) {
+        throw new Error(
+          "createNetworkNote requires either `recipient` or `script`."
+        );
+      }
+      setIsLoading(true);
+      setStage("executing");
+      setError(null);
+      try {
+        const built = await runExclusiveSafe(async () => {
+          const senderId = parseAccountId(options.accountId);
+          const targetId = parseAccountId(options.target);
+          const target = new NetworkAccountTarget(
+            targetId,
+            options.executionHint
+          );
+          const noteAssets = options.assetId != null ? new NoteAssets3([
+            new FungibleAsset3(
+              parseAccountId(options.assetId),
+              BigInt(options.amount ?? 0)
+            )
+          ]) : new NoteAssets3();
+          const metadata = new NoteMetadata(
+            senderId,
+            NoteType4.Public,
+            NoteTag.withAccountTarget(target.targetId())
+          );
+          const recipient = options.recipient ?? NoteRecipient.fromScript(
+            options.script,
+            new NoteStorage(
+              new FeltArray(
+                (options.inputs ?? []).map((value) => new Felt(value))
+              )
+            )
+          );
+          const attachments = [target.toAttachment()];
+          if (options.attachment) {
+            attachments.push(createNoteAttachment(options.attachment));
+          }
+          const note = Note3.withAttachments(
+            noteAssets,
+            metadata,
+            recipient,
+            attachments
+          );
+          const ownOutputs = new NoteArray3();
+          ownOutputs.push(note);
+          const txRequest = new TransactionRequestBuilder3().withOwnOutputNotes(ownOutputs).build();
+          const txId = prover ? await client.submitNewTransactionWithProver(
+            senderId,
+            txRequest,
+            prover
+          ) : await client.submitNewTransaction(senderId, txRequest);
+          return { txId: txId.toHex(), note };
+        });
+        setStage("complete");
+        setResult(built);
+        await sync();
+        return built;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        setStage("idle");
+        throw e;
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [client, isReady, prover, runExclusive, sync]
+  );
+  const reset = useCallback27(() => {
+    setResult(null);
+    setIsLoading(false);
+    setStage("idle");
+    setError(null);
+  }, []);
+  return { createNetworkNote, result, isLoading, stage, error, reset };
+}
+
 // src/hooks/useTransaction.ts
-import { useCallback as useCallback27, useRef as useRef9, useState as useState23 } from "react";
+import { useCallback as useCallback28, useRef as useRef9, useState as useState24 } from "react";
 
 // src/utils/transactions.ts
-import { NoteType as NoteType4, TransactionFilter as TransactionFilter4 } from "@miden-sdk/miden-sdk";
+import { NoteType as NoteType5, TransactionFilter as TransactionFilter4 } from "@miden-sdk/miden-sdk";
 async function waitForTransactionCommit2(client, runExclusiveSafe, txId, maxWaitMs = 1e4, delayMs = 1e3) {
   let waited = 0;
   while (waited < maxWaitMs) {
@@ -3337,7 +3450,7 @@ function extractFullNotes(txResult) {
     const notes = executedTx?.outputNotes?.().notes?.() ?? [];
     const result = [];
     for (const note of notes) {
-      if (note.noteType?.() === NoteType4.Private) {
+      if (note.noteType?.() === NoteType5.Private) {
         const full = note.intoFull?.();
         if (full) result.push(full);
       }
@@ -3353,11 +3466,11 @@ function useTransaction() {
   const { client, isReady, sync, runExclusive } = useMiden();
   const runExclusiveSafe = runExclusive ?? runExclusiveDirect;
   const isBusyRef = useRef9(false);
-  const [result, setResult] = useState23(null);
-  const [isLoading, setIsLoading] = useState23(false);
-  const [stage, setStage] = useState23("idle");
-  const [error, setError] = useState23(null);
-  const execute = useCallback27(
+  const [result, setResult] = useState24(null);
+  const [isLoading, setIsLoading] = useState24(false);
+  const [stage, setStage] = useState24("idle");
+  const [error, setError] = useState24(null);
+  const execute = useCallback28(
     async (options) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3424,7 +3537,7 @@ function useTransaction() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback27(() => {
+  const reset = useCallback28(() => {
     setResult(null);
     setIsLoading(false);
     setStage("idle");
@@ -3447,7 +3560,7 @@ async function resolveRequest(request, client) {
 }
 
 // src/hooks/useExecuteProgram.ts
-import { useCallback as useCallback28, useRef as useRef10, useState as useState24 } from "react";
+import { useCallback as useCallback29, useRef as useRef10, useState as useState25 } from "react";
 import {
   AdviceInputs,
   ForeignAccount,
@@ -3461,10 +3574,10 @@ function useExecuteProgram() {
   const { client, isReady, sync, runExclusive } = useMiden();
   const runExclusiveSafe = runExclusive ?? runExclusiveDirect;
   const isBusyRef = useRef10(false);
-  const [result, setResult] = useState24(null);
-  const [isLoading, setIsLoading] = useState24(false);
-  const [error, setError] = useState24(null);
-  const execute = useCallback28(
+  const [result, setResult] = useState25(null);
+  const [isLoading, setIsLoading] = useState25(false);
+  const [error, setError] = useState25(null);
+  const execute = useCallback29(
     async (options) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3523,7 +3636,7 @@ function useExecuteProgram() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback28(() => {
+  const reset = useCallback29(() => {
     setResult(null);
     setIsLoading(false);
     setError(null);
@@ -3538,7 +3651,7 @@ function useExecuteProgram() {
 }
 
 // src/hooks/useCompile.ts
-import { useCallback as useCallback29, useMemo as useMemo9 } from "react";
+import { useCallback as useCallback30, useMemo as useMemo9 } from "react";
 import { CompilerResource, getWasmOrThrow } from "@miden-sdk/miden-sdk";
 function useCompile() {
   const { client, isReady } = useMiden();
@@ -3546,21 +3659,21 @@ function useCompile() {
     () => client && isReady ? new CompilerResource(client, getWasmOrThrow) : null,
     [client, isReady]
   );
-  const requireResource = useCallback29(() => {
+  const requireResource = useCallback30(() => {
     if (!resource) {
       throw new Error("Miden client is not ready");
     }
     return resource;
   }, [resource]);
-  const component = useCallback29(
+  const component = useCallback30(
     async (options) => requireResource().component(options),
     [requireResource]
   );
-  const txScript = useCallback29(
+  const txScript = useCallback30(
     async (options) => requireResource().txScript(options),
     [requireResource]
   );
-  const noteScript = useCallback29(
+  const noteScript = useCallback30(
     async (options) => requireResource().noteScript(options),
     [requireResource]
   );
@@ -3568,14 +3681,14 @@ function useCompile() {
 }
 
 // src/hooks/useSessionAccount.ts
-import { useCallback as useCallback30, useEffect as useEffect12, useRef as useRef11, useState as useState25 } from "react";
+import { useCallback as useCallback31, useEffect as useEffect12, useRef as useRef11, useState as useState26 } from "react";
 import { AccountStorageMode as AccountStorageMode3 } from "@miden-sdk/miden-sdk";
 function useSessionAccount(options) {
   const { client, isReady, sync } = useMiden();
   const setAccounts = useMidenStore((state) => state.setAccounts);
-  const [sessionAccountId, setSessionAccountId] = useState25(null);
-  const [step, setStep] = useState25("idle");
-  const [error, setError] = useState25(null);
+  const [sessionAccountId, setSessionAccountId] = useState26(null);
+  const [step, setStep] = useState26("idle");
+  const [error, setError] = useState26(null);
   const cancelledRef = useRef11(false);
   const isBusyRef = useRef11(false);
   const storagePrefix = options.storagePrefix ?? "miden-session";
@@ -3602,7 +3715,7 @@ function useSessionAccount(options) {
       localStorage.removeItem(`${storagePrefix}:ready`);
     }
   }, [storagePrefix]);
-  const initialize = useCallback30(async () => {
+  const initialize = useCallback31(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3666,7 +3779,7 @@ function useSessionAccount(options) {
     maxWaitMs,
     setAccounts
   ]);
-  const reset = useCallback30(() => {
+  const reset = useCallback31(() => {
     cancelledRef.current = true;
     isBusyRef.current = false;
     setSessionAccountId(null);
@@ -3715,13 +3828,13 @@ async function waitAndConsume(client, walletId, pollIntervalMs, maxWaitMs, cance
 }
 
 // src/hooks/useExportStore.ts
-import { useCallback as useCallback31, useState as useState26 } from "react";
+import { useCallback as useCallback32, useState as useState27 } from "react";
 import { exportStore as sdkExportStore } from "@miden-sdk/miden-sdk";
 function useExportStore() {
   const { client, isReady, runExclusive } = useMiden();
-  const [isExporting, setIsExporting] = useState26(false);
-  const [error, setError] = useState26(null);
-  const exportStore = useCallback31(async () => {
+  const [isExporting, setIsExporting] = useState27(false);
+  const [error, setError] = useState27(null);
+  const exportStore = useCallback32(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3739,7 +3852,7 @@ function useExportStore() {
       setIsExporting(false);
     }
   }, [client, isReady, runExclusive]);
-  const reset = useCallback31(() => {
+  const reset = useCallback32(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3752,13 +3865,13 @@ function useExportStore() {
 }
 
 // src/hooks/useImportStore.ts
-import { useCallback as useCallback32, useState as useState27 } from "react";
+import { useCallback as useCallback33, useState as useState28 } from "react";
 import { importStore as sdkImportStore } from "@miden-sdk/miden-sdk";
 function useImportStore() {
   const { client, isReady, runExclusive, sync } = useMiden();
-  const [isImporting, setIsImporting] = useState27(false);
-  const [error, setError] = useState27(null);
-  const importStore = useCallback32(
+  const [isImporting, setIsImporting] = useState28(false);
+  const [error, setError] = useState28(null);
+  const importStore = useCallback33(
     async (storeDump, storeName, options) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3780,7 +3893,7 @@ function useImportStore() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback32(() => {
+  const reset = useCallback33(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3793,13 +3906,13 @@ function useImportStore() {
 }
 
 // src/hooks/useImportNote.ts
-import { useCallback as useCallback33, useState as useState28 } from "react";
+import { useCallback as useCallback34, useState as useState29 } from "react";
 import { NoteFile } from "@miden-sdk/miden-sdk";
 function useImportNote() {
   const { client, isReady, runExclusive, sync } = useMiden();
-  const [isImporting, setIsImporting] = useState28(false);
-  const [error, setError] = useState28(null);
-  const importNote = useCallback33(
+  const [isImporting, setIsImporting] = useState29(false);
+  const [error, setError] = useState29(null);
+  const importNote = useCallback34(
     async (noteBytes) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3823,7 +3936,7 @@ function useImportNote() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback33(() => {
+  const reset = useCallback34(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3836,13 +3949,13 @@ function useImportNote() {
 }
 
 // src/hooks/useExportNote.ts
-import { useCallback as useCallback34, useState as useState29 } from "react";
+import { useCallback as useCallback35, useState as useState30 } from "react";
 import { NoteExportFormat } from "@miden-sdk/miden-sdk";
 function useExportNote() {
   const { client, isReady, runExclusive } = useMiden();
-  const [isExporting, setIsExporting] = useState29(false);
-  const [error, setError] = useState29(null);
-  const exportNote = useCallback34(
+  const [isExporting, setIsExporting] = useState30(false);
+  const [error, setError] = useState30(null);
+  const exportNote = useCallback35(
     async (noteId) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3864,7 +3977,7 @@ function useExportNote() {
     },
     [client, isReady, runExclusive]
   );
-  const reset = useCallback34(() => {
+  const reset = useCallback35(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3877,12 +3990,12 @@ function useExportNote() {
 }
 
 // src/hooks/useSyncControl.ts
-import { useCallback as useCallback35 } from "react";
+import { useCallback as useCallback36 } from "react";
 function useSyncControl() {
   const isPaused = useMidenStore((state) => state.syncPaused);
   const setSyncPaused = useMidenStore((state) => state.setSyncPaused);
-  const pauseSync = useCallback35(() => setSyncPaused(true), [setSyncPaused]);
-  const resumeSync = useCallback35(() => setSyncPaused(false), [setSyncPaused]);
+  const pauseSync = useCallback36(() => setSyncPaused(true), [setSyncPaused]);
+  const resumeSync = useCallback36(() => setSyncPaused(false), [setSyncPaused]);
   return {
     pauseSync,
     resumeSync,
@@ -4071,6 +4184,7 @@ export {
   useCompile,
   useConsume,
   useCreateFaucet,
+  useCreateNetworkNote,
   useCreateWallet,
   useExecuteProgram,
   useExportNote,

package/dist/lazy.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, NoteInput, PswapLineageRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteScript, NoteAttachment } from '@miden-sdk/miden-sdk';
+import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, NoteExecutionHint, NoteRecipient, NoteScript, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, NoteInput, PswapLineageRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteAttachment } from '@miden-sdk/miden-sdk';
 export { Account, AccountFile, AccountHeader, AccountId, AccountStorageMode, AuthScheme, ConsumableNoteRecord, InputNoteRecord, Note, NoteType, PswapLineageRecord, TransactionFilter, TransactionId, TransactionRecord, TransactionRequest, WasmWebClient as WebClient } from '@miden-sdk/miden-sdk';
 
 declare module "@miden-sdk/miden-sdk" {
@@ -392,6 +392,30 @@ interface MintOptions {
     /** Note type. Default: private */
     noteType?: NoteVisibility;
 }
+interface CreateNetworkNoteOptions {
+    /** Account that creates, funds, and submits the note (executing sender). */
+    accountId: AccountRef;
+    /** The network account the note targets. */
+    target: AccountRef;
+    /** Execution hint. Defaults to `always`. */
+    executionHint?: NoteExecutionHint;
+    /** Recipient carrying the custom script (advanced; else pass `script`). */
+    recipient?: NoteRecipient;
+    /** Custom consumption script; the recipient is built for you. */
+    script?: NoteScript;
+    /** Note storage / inputs the script reads (used with `script`). */
+    inputs?: bigint[];
+    /** Single asset to lock into the note. Optional — omit for a zero-asset note. */
+    assetId?: AccountRef;
+    /** Amount for `assetId`. */
+    amount?: bigint | number;
+    /** Extra attachment payload appended after the NetworkAccountTarget. */
+    attachment?: bigint[] | Uint8Array | number[];
+}
+interface NetworkNoteResult {
+    txId: string;
+    note: Note;
+}
 interface BridgeOptions {
     /** Account that creates and funds the bridge note (the sender) */
     from: AccountRef;
@@ -1492,6 +1516,22 @@ interface UsePswapCancelByOrderResult {
  */
 declare function usePswapCancelByOrder(): UsePswapCancelByOrderResult;
 
+interface UseCreateNetworkNoteResult {
+    /** Build + submit a Public custom-script network note. */
+    createNetworkNote: (options: CreateNetworkNoteOptions) => Promise<NetworkNoteResult>;
+    result: NetworkNoteResult | null;
+    isLoading: boolean;
+    stage: TransactionStage;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook that builds a Public custom-script note carrying a `NetworkAccountTarget`
+ * attachment and submits it as an own output note, so a public network account
+ * auto-consumes it. Provide exactly one of `recipient` or `script`.
+ */
+declare function useCreateNetworkNote(): UseCreateNetworkNoteResult;
+
 interface UseTransactionResult {
     /** Execute a transaction request end-to-end */
     execute: (options: ExecuteTransactionOptions) => Promise<TransactionResult>;
@@ -1911,4 +1951,4 @@ declare function createMidenStorage(prefix: string): {
     clear(): void;
 };
 
-export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, type BridgeOptions, type ConsumeOptions, type CreateFaucetOptions, type CreateWalletOptions, DEFAULTS, type ExecuteProgramOptions, type ExecuteProgramResult, type ExecuteTransactionOptions, type ImportAccountOptions, type ImportStoreOptions, type MidenConfig, MidenError, type MidenErrorCode, MidenProvider, type MidenState, type MigrateStorageOptions, type MintOptions, type MultiSendOptions, type MultiSendRecipient, type MultiSignerContextValue, MultiSignerProvider, type MutationResult, type NoteAsset, type NoteAttachmentData, type NoteSummary, type NotesFilter, type NotesResult, type ProverConfig, type ProverTarget, type ProverUrls, type PswapCancelByOrderOptions, type PswapCancelOptions, type PswapConsumeOptions, type PswapCreateOptions, type PswapLineageResult, type PswapLineagesResult, type QueryResult, type RpcUrlConfig, type SendOptions, type SendResult, type SessionAccountStep, type SignCallback, type SignerAccountConfig, type SignerAccountType, SignerContext, type SignerContextValue, SignerSlot, type StreamedNote, type SwapOptions, type SyncState, type TransactionHistoryOptions, type TransactionHistoryResult, type TransactionResult, type TransactionStage, type TransactionStatus, type UseBridgeResult, type UseCompileResult, type UseConsumeResult, type UseCreateFaucetResult, type UseCreateWalletResult, type UseExecuteProgramResult, type UseExportNoteResult, type UseExportStoreResult, type UseImportAccountResult, type UseImportNoteResult, type UseImportStoreResult, type UseMintResult, type UseMultiSendResult, type UseNoteStreamOptions, type UseNoteStreamReturn, type UsePswapCancelByOrderResult, type UsePswapCancelResult, type UsePswapConsumeResult, type UsePswapCreateResult, type UsePswapLineageResult, type UsePswapLineagesForResult, type UsePswapLineagesResult, type UseSendResult, type UseSessionAccountOptions, type UseSessionAccountReturn, type UseSwapResult, type UseSyncControlResult, type UseSyncStateResult, type UseTransactionHistoryResult, type UseTransactionResult, type UseWaitForCommitResult, type UseWaitForNotesResult, type WaitForCommitOptions, type WaitForNotesOptions, type WalletAdapterLike, accountIdsEqual, bigIntToBytes, bytesToBigInt, clearMidenStorage, concatBytes, createMidenStorage, createNoteAttachment, ensureAccountBech32, formatAssetAmount, formatNoteSummary, getNoteSummary, installAccountBech32, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useBridge, useCompile, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, usePswapCancel, usePswapCancelByOrder, usePswapConsume, usePswapCreate, usePswapLineage, usePswapLineages, usePswapLineagesFor, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };
+export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, type BridgeOptions, type ConsumeOptions, type CreateFaucetOptions, type CreateNetworkNoteOptions, type CreateWalletOptions, DEFAULTS, type ExecuteProgramOptions, type ExecuteProgramResult, type ExecuteTransactionOptions, type ImportAccountOptions, type ImportStoreOptions, type MidenConfig, MidenError, type MidenErrorCode, MidenProvider, type MidenState, type MigrateStorageOptions, type MintOptions, type MultiSendOptions, type MultiSendRecipient, type MultiSignerContextValue, MultiSignerProvider, type MutationResult, type NetworkNoteResult, type NoteAsset, type NoteAttachmentData, type NoteSummary, type NotesFilter, type NotesResult, type ProverConfig, type ProverTarget, type ProverUrls, type PswapCancelByOrderOptions, type PswapCancelOptions, type PswapConsumeOptions, type PswapCreateOptions, type PswapLineageResult, type PswapLineagesResult, type QueryResult, type RpcUrlConfig, type SendOptions, type SendResult, type SessionAccountStep, type SignCallback, type SignerAccountConfig, type SignerAccountType, SignerContext, type SignerContextValue, SignerSlot, type StreamedNote, type SwapOptions, type SyncState, type TransactionHistoryOptions, type TransactionHistoryResult, type TransactionResult, type TransactionStage, type TransactionStatus, type UseBridgeResult, type UseCompileResult, type UseConsumeResult, type UseCreateFaucetResult, type UseCreateNetworkNoteResult, type UseCreateWalletResult, type UseExecuteProgramResult, type UseExportNoteResult, type UseExportStoreResult, type UseImportAccountResult, type UseImportNoteResult, type UseImportStoreResult, type UseMintResult, type UseMultiSendResult, type UseNoteStreamOptions, type UseNoteStreamReturn, type UsePswapCancelByOrderResult, type UsePswapCancelResult, type UsePswapConsumeResult, type UsePswapCreateResult, type UsePswapLineageResult, type UsePswapLineagesForResult, type UsePswapLineagesResult, type UseSendResult, type UseSessionAccountOptions, type UseSessionAccountReturn, type UseSwapResult, type UseSyncControlResult, type UseSyncStateResult, type UseTransactionHistoryResult, type UseTransactionResult, type UseWaitForCommitResult, type UseWaitForNotesResult, type WaitForCommitOptions, type WaitForNotesOptions, type WalletAdapterLike, accountIdsEqual, bigIntToBytes, bytesToBigInt, clearMidenStorage, concatBytes, createMidenStorage, createNoteAttachment, ensureAccountBech32, formatAssetAmount, formatNoteSummary, getNoteSummary, installAccountBech32, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useBridge, useCompile, useConsume, useCreateFaucet, useCreateNetworkNote, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, usePswapCancel, usePswapCancelByOrder, usePswapConsume, usePswapCreate, usePswapLineage, usePswapLineages, usePswapLineagesFor, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };