@miden-sdk/react 0.14.1 → 0.14.2

package/CLAUDE.md

@@ -393,6 +393,7 @@ account.bech32id();  // "miden1qy35..."
 | `useConsume()` | `TransactionResult` | Claim notes |
 | `useSwap()` | `TransactionResult` | Atomic swap |
 | `useTransaction()` | `TransactionResult` | Custom transaction |
+| `useCompile()` | `{ component, txScript, noteScript }` | Compile MASM into `AccountComponent` / `TransactionScript` / `NoteScript` |
 
 ## Type Imports
 

package/README.md

@@ -952,6 +952,51 @@ function CustomTransactionButton({ accountId }: { accountId: string }) {
 }
 ```
 
+#### `useCompile()`
+
+Compile MASM source into an `AccountComponent`, `TransactionScript`, or
+`NoteScript`. Mirrors `MidenClient.compile` from `@miden-sdk/miden-sdk`, so the
+shape is identical whether you're in a React app or calling the SDK directly.
+
+Returns three async methods, one per output type:
+
+| Method | Input | Output |
+|---|---|---|
+| `component(options)` | `{ code, slots?, supportAllTypes? }` | `AccountComponent` |
+| `txScript(options)`  | `{ code, libraries? }` | `TransactionScript` |
+| `noteScript(options)` | `{ code, libraries? }` | `NoteScript` |
+
+Each `libraries` entry takes `{ namespace, code, linking? }`. `linking` accepts
+the `Linking` enum (`Linking.Dynamic`, `Linking.Static`) or the raw strings
+`"dynamic"` / `"static"`. Dynamic is the default and matches the FPI pattern
+used in the tutorials.
+
+```tsx
+import { useCompile } from '@miden-sdk/react';
+import { Linking } from '@miden-sdk/miden-sdk';
+
+function ScriptBuilder({ libSource, noteSource }: { libSource: string; noteSource: string }) {
+  const { noteScript, isReady } = useCompile();
+
+  const handleBuild = async () => {
+    const script = await noteScript({
+      code: noteSource,
+      libraries: [
+        { namespace: 'my_lib::module', code: libSource, linking: Linking.Dynamic },
+      ],
+    });
+    // pass `script` to useTransaction, useExecuteProgram, or your own flow
+  };
+
+  return <button onClick={handleBuild} disabled={!isReady}>Compile</button>;
+}
+```
+
+Compile is local and synchronous in practice — the hook doesn't expose
+`isLoading` / `stage` / `error` state. Errors from the underlying compiler
+(bad MASM, unresolved imports) throw from the returned promise; handle them
+with regular `try`/`catch`.
+
 #### `useExecuteProgram()`
 
 Execute a program (view call) against an account and read the resulting stack

package/dist/index.d.mts

@@ -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, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, NoteAttachment } from '@miden-sdk/miden-sdk';
+import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteScript, NoteAttachment } from '@miden-sdk/miden-sdk';
 export { Account, AccountFile, AccountHeader, AccountId, AccountStorageMode, AuthScheme, ConsumableNoteRecord, InputNoteRecord, Note, NoteType, TransactionFilter, TransactionId, TransactionRecord, TransactionRequest, WasmWebClient as WebClient } from '@miden-sdk/miden-sdk';
 
 declare module "@miden-sdk/miden-sdk" {
@@ -1168,6 +1168,33 @@ interface UseExecuteProgramResult {
 }
 declare function useExecuteProgram(): UseExecuteProgramResult;
 
+interface UseCompileResult {
+    /** Compile MASM source into an AccountComponent. */
+    component: (options: CompileComponentOptions) => Promise<AccountComponent>;
+    /** Compile MASM source into a TransactionScript. */
+    txScript: (options: CompileTxScriptOptions) => Promise<TransactionScript>;
+    /** Compile MASM source into a NoteScript. */
+    noteScript: (options: CompileNoteScriptOptions) => Promise<NoteScript>;
+    /** Whether the underlying client is ready to compile. */
+    isReady: boolean;
+}
+/**
+ * Hook for compiling MASM source into `AccountComponent`, `TransactionScript`,
+ * or `NoteScript`. Wraps `CompilerResource` from `@miden-sdk/miden-sdk` so the
+ * shape is identical to `MidenClient.compile`.
+ *
+ * @example
+ * ```tsx
+ * const { noteScript, isReady } = useCompile();
+ *
+ * const script = await noteScript({
+ *   code: noteSource,
+ *   libraries: [{ namespace: "my_lib", code: libSource, linking: Linking.Dynamic }],
+ * });
+ * ```
+ */
+declare function useCompile(): UseCompileResult;
+
 /**
  * Hook to manage a session wallet lifecycle: create -> fund -> consume.
  *
@@ -1467,4 +1494,4 @@ declare function createMidenStorage(prefix: string): {
     clear(): void;
 };
 
-export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, 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 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 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 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, formatAssetAmount, formatNoteSummary, getNoteSummary, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };
+export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, 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 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 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 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, formatAssetAmount, formatNoteSummary, getNoteSummary, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useCompile, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };

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, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, NoteAttachment } from '@miden-sdk/miden-sdk';
+import { AccountId, Account, AccountHeader, AccountStorageMode, AccountComponent, NoteId, InputNoteRecord, Note, StorageMode, AuthScheme, TransactionScript, AdviceInputs, AccountStorageRequirements, TransactionRequest, WasmWebClient, AccountFile, NoteVisibility, ConsumableNoteRecord, TransactionId, TransactionFilter, TransactionRecord, TransactionProver, CompileComponentOptions, CompileTxScriptOptions, CompileNoteScriptOptions, NoteScript, NoteAttachment } from '@miden-sdk/miden-sdk';
 export { Account, AccountFile, AccountHeader, AccountId, AccountStorageMode, AuthScheme, ConsumableNoteRecord, InputNoteRecord, Note, NoteType, TransactionFilter, TransactionId, TransactionRecord, TransactionRequest, WasmWebClient as WebClient } from '@miden-sdk/miden-sdk';
 
 declare module "@miden-sdk/miden-sdk" {
@@ -1168,6 +1168,33 @@ interface UseExecuteProgramResult {
 }
 declare function useExecuteProgram(): UseExecuteProgramResult;
 
+interface UseCompileResult {
+    /** Compile MASM source into an AccountComponent. */
+    component: (options: CompileComponentOptions) => Promise<AccountComponent>;
+    /** Compile MASM source into a TransactionScript. */
+    txScript: (options: CompileTxScriptOptions) => Promise<TransactionScript>;
+    /** Compile MASM source into a NoteScript. */
+    noteScript: (options: CompileNoteScriptOptions) => Promise<NoteScript>;
+    /** Whether the underlying client is ready to compile. */
+    isReady: boolean;
+}
+/**
+ * Hook for compiling MASM source into `AccountComponent`, `TransactionScript`,
+ * or `NoteScript`. Wraps `CompilerResource` from `@miden-sdk/miden-sdk` so the
+ * shape is identical to `MidenClient.compile`.
+ *
+ * @example
+ * ```tsx
+ * const { noteScript, isReady } = useCompile();
+ *
+ * const script = await noteScript({
+ *   code: noteSource,
+ *   libraries: [{ namespace: "my_lib", code: libSource, linking: Linking.Dynamic }],
+ * });
+ * ```
+ */
+declare function useCompile(): UseCompileResult;
+
 /**
  * Hook to manage a session wallet lifecycle: create -> fund -> consume.
  *
@@ -1467,4 +1494,4 @@ declare function createMidenStorage(prefix: string): {
     clear(): void;
 };
 
-export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, 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 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 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 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, formatAssetAmount, formatNoteSummary, getNoteSummary, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };
+export { type AccountRef, type AccountResult, type AccountsResult, type AssetBalance, type AssetMetadata, 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 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 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 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, formatAssetAmount, formatNoteSummary, getNoteSummary, migrateStorage, normalizeAccountId, parseAssetAmount, readNoteAttachment, toBech32AccountId, useAccount, useAccounts, useAssetMetadata, useCompile, useConsume, useCreateFaucet, useCreateWallet, useExecuteProgram, useExportNote, useExportStore, useImportAccount, useImportNote, useImportStore, useMiden, useMidenClient, useMint, useMultiSend, useMultiSigner, useNoteStream, useNotes, useSend, useSessionAccount, useSigner, useSwap, useSyncControl, useSyncState, useTransaction, useTransactionHistory, useWaitForCommit, useWaitForNotes, waitForWalletDetection, wrapWasmError };

package/dist/index.js

@@ -55,6 +55,7 @@ __export(index_exports, {
   useAccount: () => useAccount,
   useAccounts: () => useAccounts,
   useAssetMetadata: () => useAssetMetadata,
+  useCompile: () => useCompile,
   useConsume: () => useConsume,
   useCreateFaucet: () => useCreateFaucet,
   useCreateWallet: () => useCreateWallet,
@@ -3099,26 +3100,56 @@ function useExecuteProgram() {
   };
 }
 
-// src/hooks/useSessionAccount.ts
+// src/hooks/useCompile.ts
 var import_react23 = require("react");
 var import_miden_sdk22 = require("@miden-sdk/miden-sdk");
+function useCompile() {
+  const { client, isReady } = useMiden();
+  const resource = (0, import_react23.useMemo)(
+    () => client && isReady ? new import_miden_sdk22.CompilerResource(client, import_miden_sdk22.getWasmOrThrow) : null,
+    [client, isReady]
+  );
+  const requireResource = (0, import_react23.useCallback)(() => {
+    if (!resource) {
+      throw new Error("Miden client is not ready");
+    }
+    return resource;
+  }, [resource]);
+  const component = (0, import_react23.useCallback)(
+    async (options) => requireResource().component(options),
+    [requireResource]
+  );
+  const txScript = (0, import_react23.useCallback)(
+    async (options) => requireResource().txScript(options),
+    [requireResource]
+  );
+  const noteScript = (0, import_react23.useCallback)(
+    async (options) => requireResource().noteScript(options),
+    [requireResource]
+  );
+  return { component, txScript, noteScript, isReady };
+}
+
+// src/hooks/useSessionAccount.ts
+var import_react24 = require("react");
+var import_miden_sdk23 = require("@miden-sdk/miden-sdk");
 function useSessionAccount(options) {
   const { client, isReady, sync } = useMiden();
   const setAccounts = useMidenStore((state) => state.setAccounts);
-  const [sessionAccountId, setSessionAccountId] = (0, import_react23.useState)(null);
-  const [step, setStep] = (0, import_react23.useState)("idle");
-  const [error, setError] = (0, import_react23.useState)(null);
-  const cancelledRef = (0, import_react23.useRef)(false);
-  const isBusyRef = (0, import_react23.useRef)(false);
+  const [sessionAccountId, setSessionAccountId] = (0, import_react24.useState)(null);
+  const [step, setStep] = (0, import_react24.useState)("idle");
+  const [error, setError] = (0, import_react24.useState)(null);
+  const cancelledRef = (0, import_react24.useRef)(false);
+  const isBusyRef = (0, import_react24.useRef)(false);
   const storagePrefix = options.storagePrefix ?? "miden-session";
   const pollIntervalMs = options.pollIntervalMs ?? 3e3;
   const maxWaitMs = options.maxWaitMs ?? 6e4;
   const storageMode = options.walletOptions?.storageMode ?? "public";
   const mutable = options.walletOptions?.mutable ?? DEFAULTS.WALLET_MUTABLE;
   const authScheme = options.walletOptions?.authScheme ?? DEFAULTS.AUTH_SCHEME;
-  const fundRef = (0, import_react23.useRef)(options.fund);
+  const fundRef = (0, import_react24.useRef)(options.fund);
   fundRef.current = options.fund;
-  (0, import_react23.useEffect)(() => {
+  (0, import_react24.useEffect)(() => {
     try {
       const stored = localStorage.getItem(`${storagePrefix}:accountId`);
       const storedReady = localStorage.getItem(`${storagePrefix}:ready`);
@@ -3135,7 +3166,7 @@ function useSessionAccount(options) {
       localStorage.removeItem(`${storagePrefix}:ready`);
     }
   }, [storagePrefix]);
-  const initialize = (0, import_react23.useCallback)(async () => {
+  const initialize = (0, import_react24.useCallback)(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3204,7 +3235,7 @@ function useSessionAccount(options) {
     maxWaitMs,
     setAccounts
   ]);
-  const reset = (0, import_react23.useCallback)(() => {
+  const reset = (0, import_react24.useCallback)(() => {
     cancelledRef.current = true;
     isBusyRef.current = false;
     setSessionAccountId(null);
@@ -3225,11 +3256,11 @@ function useSessionAccount(options) {
 function getStorageMode3(mode) {
   switch (mode) {
     case "private":
-      return import_miden_sdk22.AccountStorageMode.private();
+      return import_miden_sdk23.AccountStorageMode.private();
     case "public":
-      return import_miden_sdk22.AccountStorageMode.public();
+      return import_miden_sdk23.AccountStorageMode.public();
     default:
-      return import_miden_sdk22.AccountStorageMode.public();
+      return import_miden_sdk23.AccountStorageMode.public();
   }
 }
 async function waitAndConsume(client, walletId, pollIntervalMs, maxWaitMs, cancelledRef) {
@@ -3253,13 +3284,13 @@ async function waitAndConsume(client, walletId, pollIntervalMs, maxWaitMs, cance
 }
 
 // src/hooks/useExportStore.ts
-var import_react24 = require("react");
-var import_miden_sdk23 = require("@miden-sdk/miden-sdk");
+var import_react25 = require("react");
+var import_miden_sdk24 = require("@miden-sdk/miden-sdk");
 function useExportStore() {
   const { client, isReady, runExclusive } = useMiden();
-  const [isExporting, setIsExporting] = (0, import_react24.useState)(false);
-  const [error, setError] = (0, import_react24.useState)(null);
-  const exportStore = (0, import_react24.useCallback)(async () => {
+  const [isExporting, setIsExporting] = (0, import_react25.useState)(false);
+  const [error, setError] = (0, import_react25.useState)(null);
+  const exportStore = (0, import_react25.useCallback)(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3267,7 +3298,7 @@ function useExportStore() {
     setError(null);
     try {
       const storeName = client.storeIdentifier();
-      const snapshot = await runExclusive(() => (0, import_miden_sdk23.exportStore)(storeName));
+      const snapshot = await runExclusive(() => (0, import_miden_sdk24.exportStore)(storeName));
       return snapshot;
     } catch (err) {
       const error2 = err instanceof Error ? err : new Error(String(err));
@@ -3277,7 +3308,7 @@ function useExportStore() {
       setIsExporting(false);
     }
   }, [client, isReady, runExclusive]);
-  const reset = (0, import_react24.useCallback)(() => {
+  const reset = (0, import_react25.useCallback)(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3290,13 +3321,13 @@ function useExportStore() {
 }
 
 // src/hooks/useImportStore.ts
-var import_react25 = require("react");
-var import_miden_sdk24 = require("@miden-sdk/miden-sdk");
+var import_react26 = require("react");
+var import_miden_sdk25 = require("@miden-sdk/miden-sdk");
 function useImportStore() {
   const { client, isReady, runExclusive, sync } = useMiden();
-  const [isImporting, setIsImporting] = (0, import_react25.useState)(false);
-  const [error, setError] = (0, import_react25.useState)(null);
-  const importStore = (0, import_react25.useCallback)(
+  const [isImporting, setIsImporting] = (0, import_react26.useState)(false);
+  const [error, setError] = (0, import_react26.useState)(null);
+  const importStore = (0, import_react26.useCallback)(
     async (storeDump, storeName, options) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3304,7 +3335,7 @@ function useImportStore() {
       setIsImporting(true);
       setError(null);
       try {
-        await runExclusive(() => (0, import_miden_sdk24.importStore)(storeName, storeDump));
+        await runExclusive(() => (0, import_miden_sdk25.importStore)(storeName, storeDump));
         if (!options?.skipSync) {
           await sync();
         }
@@ -3318,7 +3349,7 @@ function useImportStore() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = (0, import_react25.useCallback)(() => {
+  const reset = (0, import_react26.useCallback)(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3331,13 +3362,13 @@ function useImportStore() {
 }
 
 // src/hooks/useImportNote.ts
-var import_react26 = require("react");
-var import_miden_sdk25 = require("@miden-sdk/miden-sdk");
+var import_react27 = require("react");
+var import_miden_sdk26 = require("@miden-sdk/miden-sdk");
 function useImportNote() {
   const { client, isReady, runExclusive, sync } = useMiden();
-  const [isImporting, setIsImporting] = (0, import_react26.useState)(false);
-  const [error, setError] = (0, import_react26.useState)(null);
-  const importNote = (0, import_react26.useCallback)(
+  const [isImporting, setIsImporting] = (0, import_react27.useState)(false);
+  const [error, setError] = (0, import_react27.useState)(null);
+  const importNote = (0, import_react27.useCallback)(
     async (noteBytes) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3345,7 +3376,7 @@ function useImportNote() {
       setIsImporting(true);
       setError(null);
       try {
-        const noteFile = import_miden_sdk25.NoteFile.deserialize(noteBytes);
+        const noteFile = import_miden_sdk26.NoteFile.deserialize(noteBytes);
         const noteId = await runExclusive(
           () => client.importNoteFile(noteFile)
         );
@@ -3361,7 +3392,7 @@ function useImportNote() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = (0, import_react26.useCallback)(() => {
+  const reset = (0, import_react27.useCallback)(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3374,13 +3405,13 @@ function useImportNote() {
 }
 
 // src/hooks/useExportNote.ts
-var import_react27 = require("react");
-var import_miden_sdk26 = require("@miden-sdk/miden-sdk");
+var import_react28 = require("react");
+var import_miden_sdk27 = require("@miden-sdk/miden-sdk");
 function useExportNote() {
   const { client, isReady, runExclusive } = useMiden();
-  const [isExporting, setIsExporting] = (0, import_react27.useState)(false);
-  const [error, setError] = (0, import_react27.useState)(null);
-  const exportNote = (0, import_react27.useCallback)(
+  const [isExporting, setIsExporting] = (0, import_react28.useState)(false);
+  const [error, setError] = (0, import_react28.useState)(null);
+  const exportNote = (0, import_react28.useCallback)(
     async (noteId) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3389,7 +3420,7 @@ function useExportNote() {
       setError(null);
       try {
         const noteFile = await runExclusive(
-          () => client.exportNoteFile(noteId, import_miden_sdk26.NoteExportFormat.Full)
+          () => client.exportNoteFile(noteId, import_miden_sdk27.NoteExportFormat.Full)
         );
         return noteFile.serialize();
       } catch (err) {
@@ -3402,7 +3433,7 @@ function useExportNote() {
     },
     [client, isReady, runExclusive]
   );
-  const reset = (0, import_react27.useCallback)(() => {
+  const reset = (0, import_react28.useCallback)(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3415,12 +3446,12 @@ function useExportNote() {
 }
 
 // src/hooks/useSyncControl.ts
-var import_react28 = require("react");
+var import_react29 = require("react");
 function useSyncControl() {
   const isPaused = useMidenStore((state) => state.syncPaused);
   const setSyncPaused = useMidenStore((state) => state.setSyncPaused);
-  const pauseSync = (0, import_react28.useCallback)(() => setSyncPaused(true), [setSyncPaused]);
-  const resumeSync = (0, import_react28.useCallback)(() => setSyncPaused(false), [setSyncPaused]);
+  const pauseSync = (0, import_react29.useCallback)(() => setSyncPaused(true), [setSyncPaused]);
+  const resumeSync = (0, import_react29.useCallback)(() => setSyncPaused(false), [setSyncPaused]);
   return {
     pauseSync,
     resumeSync,
@@ -3604,6 +3635,7 @@ installAccountBech32();
   useAccount,
   useAccounts,
   useAssetMetadata,
+  useCompile,
   useConsume,
   useCreateFaucet,
   useCreateWallet,

package/dist/index.mjs

@@ -3066,8 +3066,38 @@ function useExecuteProgram() {
   };
 }
 
+// src/hooks/useCompile.ts
+import { useCallback as useCallback21, useMemo as useMemo8 } from "react";
+import { CompilerResource, getWasmOrThrow } from "@miden-sdk/miden-sdk";
+function useCompile() {
+  const { client, isReady } = useMiden();
+  const resource = useMemo8(
+    () => client && isReady ? new CompilerResource(client, getWasmOrThrow) : null,
+    [client, isReady]
+  );
+  const requireResource = useCallback21(() => {
+    if (!resource) {
+      throw new Error("Miden client is not ready");
+    }
+    return resource;
+  }, [resource]);
+  const component = useCallback21(
+    async (options) => requireResource().component(options),
+    [requireResource]
+  );
+  const txScript = useCallback21(
+    async (options) => requireResource().txScript(options),
+    [requireResource]
+  );
+  const noteScript = useCallback21(
+    async (options) => requireResource().noteScript(options),
+    [requireResource]
+  );
+  return { component, txScript, noteScript, isReady };
+}
+
 // src/hooks/useSessionAccount.ts
-import { useCallback as useCallback21, useEffect as useEffect9, useRef as useRef8, useState as useState17 } from "react";
+import { useCallback as useCallback22, useEffect as useEffect9, useRef as useRef8, useState as useState17 } from "react";
 import { AccountStorageMode as AccountStorageMode3 } from "@miden-sdk/miden-sdk";
 function useSessionAccount(options) {
   const { client, isReady, sync } = useMiden();
@@ -3102,7 +3132,7 @@ function useSessionAccount(options) {
       localStorage.removeItem(`${storagePrefix}:ready`);
     }
   }, [storagePrefix]);
-  const initialize = useCallback21(async () => {
+  const initialize = useCallback22(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3171,7 +3201,7 @@ function useSessionAccount(options) {
     maxWaitMs,
     setAccounts
   ]);
-  const reset = useCallback21(() => {
+  const reset = useCallback22(() => {
     cancelledRef.current = true;
     isBusyRef.current = false;
     setSessionAccountId(null);
@@ -3220,13 +3250,13 @@ async function waitAndConsume(client, walletId, pollIntervalMs, maxWaitMs, cance
 }
 
 // src/hooks/useExportStore.ts
-import { useCallback as useCallback22, useState as useState18 } from "react";
+import { useCallback as useCallback23, useState as useState18 } from "react";
 import { exportStore as sdkExportStore } from "@miden-sdk/miden-sdk";
 function useExportStore() {
   const { client, isReady, runExclusive } = useMiden();
   const [isExporting, setIsExporting] = useState18(false);
   const [error, setError] = useState18(null);
-  const exportStore = useCallback22(async () => {
+  const exportStore = useCallback23(async () => {
     if (!client || !isReady) {
       throw new Error("Miden client is not ready");
     }
@@ -3244,7 +3274,7 @@ function useExportStore() {
       setIsExporting(false);
     }
   }, [client, isReady, runExclusive]);
-  const reset = useCallback22(() => {
+  const reset = useCallback23(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3257,13 +3287,13 @@ function useExportStore() {
 }
 
 // src/hooks/useImportStore.ts
-import { useCallback as useCallback23, useState as useState19 } from "react";
+import { useCallback as useCallback24, useState as useState19 } from "react";
 import { importStore as sdkImportStore } from "@miden-sdk/miden-sdk";
 function useImportStore() {
   const { client, isReady, runExclusive, sync } = useMiden();
   const [isImporting, setIsImporting] = useState19(false);
   const [error, setError] = useState19(null);
-  const importStore = useCallback23(
+  const importStore = useCallback24(
     async (storeDump, storeName, options) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3285,7 +3315,7 @@ function useImportStore() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback23(() => {
+  const reset = useCallback24(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3298,13 +3328,13 @@ function useImportStore() {
 }
 
 // src/hooks/useImportNote.ts
-import { useCallback as useCallback24, useState as useState20 } from "react";
+import { useCallback as useCallback25, useState as useState20 } from "react";
 import { NoteFile } from "@miden-sdk/miden-sdk";
 function useImportNote() {
   const { client, isReady, runExclusive, sync } = useMiden();
   const [isImporting, setIsImporting] = useState20(false);
   const [error, setError] = useState20(null);
-  const importNote = useCallback24(
+  const importNote = useCallback25(
     async (noteBytes) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3328,7 +3358,7 @@ function useImportNote() {
     },
     [client, isReady, runExclusive, sync]
   );
-  const reset = useCallback24(() => {
+  const reset = useCallback25(() => {
     setIsImporting(false);
     setError(null);
   }, []);
@@ -3341,13 +3371,13 @@ function useImportNote() {
 }
 
 // src/hooks/useExportNote.ts
-import { useCallback as useCallback25, useState as useState21 } from "react";
+import { useCallback as useCallback26, useState as useState21 } from "react";
 import { NoteExportFormat } from "@miden-sdk/miden-sdk";
 function useExportNote() {
   const { client, isReady, runExclusive } = useMiden();
   const [isExporting, setIsExporting] = useState21(false);
   const [error, setError] = useState21(null);
-  const exportNote = useCallback25(
+  const exportNote = useCallback26(
     async (noteId) => {
       if (!client || !isReady) {
         throw new Error("Miden client is not ready");
@@ -3369,7 +3399,7 @@ function useExportNote() {
     },
     [client, isReady, runExclusive]
   );
-  const reset = useCallback25(() => {
+  const reset = useCallback26(() => {
     setIsExporting(false);
     setError(null);
   }, []);
@@ -3382,12 +3412,12 @@ function useExportNote() {
 }
 
 // src/hooks/useSyncControl.ts
-import { useCallback as useCallback26 } from "react";
+import { useCallback as useCallback27 } from "react";
 function useSyncControl() {
   const isPaused = useMidenStore((state) => state.syncPaused);
   const setSyncPaused = useMidenStore((state) => state.setSyncPaused);
-  const pauseSync = useCallback26(() => setSyncPaused(true), [setSyncPaused]);
-  const resumeSync = useCallback26(() => setSyncPaused(false), [setSyncPaused]);
+  const pauseSync = useCallback27(() => setSyncPaused(true), [setSyncPaused]);
+  const resumeSync = useCallback27(() => setSyncPaused(false), [setSyncPaused]);
   return {
     pauseSync,
     resumeSync,
@@ -3570,6 +3600,7 @@ export {
   useAccount,
   useAccounts,
   useAssetMetadata,
+  useCompile,
   useConsume,
   useCreateFaucet,
   useCreateWallet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miden-sdk/react",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "React hooks library for Miden Web Client",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,7 +28,7 @@
     "test:all": "VITE_CJS_IGNORE_WARNING=1 vitest run && playwright test"
   },
   "peerDependencies": {
-    "@miden-sdk/miden-sdk": "^0.14.1",
+    "@miden-sdk/miden-sdk": "^0.14.2",
     "react": ">=18.0.0"
   },
   "dependencies": {