@miden-sdk/miden-wallet-adapter-react 0.13.0

package/docs/interfaces/MidenFiSignerProviderProps.md

@@ -0,0 +1,87 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / MidenFiSignerProviderProps
+
+# Interface: MidenFiSignerProviderProps
+
+## Properties
+
+### allowedPrivateData?
+
+> `optional` **allowedPrivateData**: `AllowedPrivateData`
+
+Allowed private data types
+
+***
+
+### appName?
+
+> `optional` **appName**: `string`
+
+App name passed to the default MidenWalletAdapter
+
+***
+
+### autoConnect?
+
+> `optional` **autoConnect**: `boolean`
+
+Auto-connect to previously selected wallet on mount. Defaults to true
+
+***
+
+### children
+
+> **children**: `ReactNode`
+
+***
+
+### localStorageKey?
+
+> `optional` **localStorageKey**: `string`
+
+LocalStorage key for persisting wallet selection
+
+***
+
+### network?
+
+> `optional` **network**: `WalletAdapterNetwork`
+
+Network to connect to
+
+***
+
+### onError()?
+
+> `optional` **onError**: (`error`) => `void`
+
+Error handler
+
+#### Parameters
+
+##### error
+
+`WalletError`
+
+#### Returns
+
+`void`
+
+***
+
+### privateDataPermission?
+
+> `optional` **privateDataPermission**: `PrivateDataPermission`
+
+Private data permission level
+
+***
+
+### wallets?
+
+> `optional` **wallets**: `Adapter`[]
+
+Wallet adapters to use. Defaults to [MidenWalletAdapter]

package/docs/interfaces/Wallet.md

@@ -0,0 +1,19 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / Wallet
+
+# Interface: Wallet
+
+## Properties
+
+### adapter
+
+> **adapter**: `Adapter`
+
+***
+
+### readyState
+
+> **readyState**: `WalletReadyState`

package/docs/interfaces/WalletContextState.md

@@ -0,0 +1,235 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / WalletContextState
+
+# Interface: WalletContextState
+
+## Properties
+
+### address
+
+> **address**: `string`
+
+***
+
+### autoConnect
+
+> **autoConnect**: `boolean`
+
+***
+
+### connected
+
+> **connected**: `boolean`
+
+***
+
+### connecting
+
+> **connecting**: `boolean`
+
+***
+
+### disconnecting
+
+> **disconnecting**: `boolean`
+
+***
+
+### importPrivateNote()?
+
+> `optional` **importPrivateNote**: (`note`) => `Promise`\<`string`\>
+
+#### Parameters
+
+##### note
+
+`Uint8Array`
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### publicKey
+
+> **publicKey**: `Uint8Array`\<`ArrayBufferLike`\>
+
+***
+
+### requestAssets()?
+
+> `optional` **requestAssets**: () => `Promise`\<`Asset`[]\>
+
+#### Returns
+
+`Promise`\<`Asset`[]\>
+
+***
+
+### requestConsumableNotes()?
+
+> `optional` **requestConsumableNotes**: () => `Promise`\<`InputNoteDetails`[]\>
+
+#### Returns
+
+`Promise`\<`InputNoteDetails`[]\>
+
+***
+
+### requestConsume()?
+
+> `optional` **requestConsume**: (`transaction`) => `Promise`\<`string`\>
+
+#### Parameters
+
+##### transaction
+
+`MidenConsumeTransaction`
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### requestPrivateNotes()?
+
+> `optional` **requestPrivateNotes**: (`noteFilterType`, `noteIds?`) => `Promise`\<`InputNoteDetails`[]\>
+
+#### Parameters
+
+##### noteFilterType
+
+`NoteFilterTypes`
+
+##### noteIds?
+
+`string`[]
+
+#### Returns
+
+`Promise`\<`InputNoteDetails`[]\>
+
+***
+
+### requestSend()?
+
+> `optional` **requestSend**: (`transaction`) => `Promise`\<`string`\>
+
+#### Parameters
+
+##### transaction
+
+`MidenSendTransaction`
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### requestTransaction()?
+
+> `optional` **requestTransaction**: (`transaction`) => `Promise`\<`string`\>
+
+#### Parameters
+
+##### transaction
+
+`MidenTransaction`
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### signBytes()?
+
+> `optional` **signBytes**: (`data`, `kind`) => `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
+
+#### Parameters
+
+##### data
+
+`Uint8Array`
+
+##### kind
+
+`SignKind`
+
+#### Returns
+
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
+
+***
+
+### waitForTransaction()?
+
+> `optional` **waitForTransaction**: (`txId`, `timeout?`) => `Promise`\<`TransactionOutput`\>
+
+#### Parameters
+
+##### txId
+
+`string`
+
+##### timeout?
+
+`number`
+
+#### Returns
+
+`Promise`\<`TransactionOutput`\>
+
+***
+
+### wallet
+
+> **wallet**: [`Wallet`](Wallet.md)
+
+***
+
+### wallets
+
+> **wallets**: [`Wallet`](Wallet.md)[]
+
+## Methods
+
+### connect()
+
+> **connect**(): `Promise`\<`void`\>
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### disconnect()
+
+> **disconnect**(): `Promise`\<`void`\>
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### select()
+
+> **select**(`walletName`): `void`
+
+#### Parameters
+
+##### walletName
+
+`WalletName`
+
+#### Returns
+
+`void`

package/docs/interfaces/WalletProviderProps.md

@@ -0,0 +1,65 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / WalletProviderProps
+
+# Interface: WalletProviderProps
+
+## Properties
+
+### allowedPrivateData?
+
+> `optional` **allowedPrivateData**: `AllowedPrivateData`
+
+***
+
+### autoConnect?
+
+> `optional` **autoConnect**: `boolean`
+
+***
+
+### children
+
+> **children**: `ReactNode`
+
+***
+
+### localStorageKey?
+
+> `optional` **localStorageKey**: `string`
+
+***
+
+### network?
+
+> `optional` **network**: `WalletAdapterNetwork`
+
+***
+
+### onError()?
+
+> `optional` **onError**: (`error`) => `void`
+
+#### Parameters
+
+##### error
+
+`WalletError`
+
+#### Returns
+
+`void`
+
+***
+
+### privateDataPermission?
+
+> `optional` **privateDataPermission**: `PrivateDataPermission`
+
+***
+
+### wallets
+
+> **wallets**: `Adapter`[]

package/docs/variables/MidenFiSignerProvider.md

@@ -0,0 +1,54 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / MidenFiSignerProvider
+
+# Variable: MidenFiSignerProvider
+
+> `const` **MidenFiSignerProvider**: `FC`\<[`MidenFiSignerProviderProps`](../interfaces/MidenFiSignerProviderProps.md)\>
+
+MidenFiSignerProvider bridges the MidenFi wallet with MidenProvider.
+
+This is a unified provider that handles both wallet connection and signer context.
+
+## Examples
+
+```tsx
+// Simplest usage - uses MidenWalletAdapter by default
+<MidenFiSignerProvider>
+  <MidenProvider config={{ rpcUrl: "testnet" }}>
+    <App />
+  </MidenProvider>
+</MidenFiSignerProvider>
+
+// With custom options
+<MidenFiSignerProvider
+  appName="My DApp"
+  network={WalletAdapterNetwork.Testnet}
+  autoConnect={true}
+>
+  <MidenProvider config={{ rpcUrl: "testnet" }}>
+    <App />
+  </MidenProvider>
+</MidenFiSignerProvider>
+
+// With custom wallets
+<MidenFiSignerProvider wallets={[new CustomWalletAdapter()]}>
+  <MidenProvider config={{ rpcUrl: "testnet" }}>
+    <App />
+  </MidenProvider>
+</MidenFiSignerProvider>
+```
+
+For wallet operations, use the useMidenFiWallet hook:
+
+```tsx
+const { connected, connect, disconnect, select, wallets } = useMidenFiWallet();
+
+// If multiple wallets, select one first
+select(wallets[0].adapter.name);
+
+// Then connect
+await connect();
+```

package/docs/variables/WalletContext.md

@@ -0,0 +1,9 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / WalletContext
+
+# Variable: WalletContext
+
+> `const` **WalletContext**: `Context`\<[`WalletContextState`](../interfaces/WalletContextState.md)\>

package/docs/variables/WalletProvider.md

@@ -0,0 +1,9 @@
+[**@miden-sdk/miden-wallet-adapter-react**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-react](../README.md) / WalletProvider
+
+# Variable: WalletProvider
+
+> `const` **WalletProvider**: `FC`\<[`WalletProviderProps`](../interfaces/WalletProviderProps.md)\>

package/index.ts

@@ -0,0 +1,15 @@
+// Legacy exports for backward compatibility
+export * from './WalletProvider';
+export * from './useLocalStorage';
+export * from './useWallet';
+
+// MidenFi Signer Provider - unified provider for @miden-sdk/react integration
+export {
+  MidenFiSignerProvider,
+  useMidenFiWallet,
+  WalletContext,
+  type MidenFiSignerProviderProps,
+  type Wallet,
+  type WalletContextState,
+  type MidenFiWalletContextState,
+} from './MidenFiSignerProvider';

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@miden-sdk/miden-wallet-adapter-react",
+  "version": "0.13.0",
+  "description": "Core react infrastructure for connecting Miden-compatible wallets to your dApp.",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/demox-labs/miden-wallet-adapter.git"
+  },
+  "author": "Demox Labs",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist/ node_modules/",
+    "doc": "typedoc --disableSources --plugin typedoc-plugin-markdown --entryPoints index.ts",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@miden-sdk/miden-wallet-adapter-base": "workspace:^",
+    "@miden-sdk/miden-wallet-adapter-miden": "workspace:^"
+  },
+  "devDependencies": {
+    "@miden-sdk/miden-sdk": "^0.13.0",
+    "@miden-sdk/react": "^0.13.0",
+    "@testing-library/react": "^14.0.0",
+    "jsdom": "^24.0.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@miden-sdk/react": "^0.13.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@miden-sdk/react": {
+      "optional": true
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "target": "ESNext",
+    "module": "ESNext",
+    "declaration": true,
+    "outDir": "dist",
+    "sourceMap": true,
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true
+  },
+  "exclude": ["node_modules", "dist", "__tests__"]
+}

package/useLocalStorage.ts

@@ -0,0 +1,39 @@
+import type { Dispatch, SetStateAction } from 'react';
+import { useEffect, useRef, useState } from 'react';
+
+export function useLocalStorage<T>(key: string, defaultState: T): [T, Dispatch<SetStateAction<T>>] {
+    const state = useState<T>(() => {
+        try {
+            const value = localStorage.getItem(key);
+            if (value) return JSON.parse(value) as T;
+        } catch (error: any) {
+            if (typeof window !== 'undefined') {
+                console.error(error);
+            }
+        }
+
+        return defaultState;
+    });
+    const value = state[0];
+
+    const isFirstRender = useRef(true);
+    useEffect(() => {
+        if (isFirstRender.current) {
+            isFirstRender.current = false;
+            return;
+        }
+        try {
+            if (value === null) {
+                localStorage.removeItem(key);
+            } else {
+                localStorage.setItem(key, JSON.stringify(value));
+            }
+        } catch (error: any) {
+            if (typeof window !== 'undefined') {
+                console.error(error);
+            }
+        }
+    }, [value, key]);
+
+    return state;
+}