@waaskey/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Waaskey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @waaskey/react
+
+React hooks + provider for the [Waaskey](https://waaskey.com) SDK — embedded,
+non-custodial **MPC wallets**. A thin layer over [`@waaskey/sdk`](../sdk); the same
+hooks work in React Native.
+
+## Install
+
+```bash
+pnpm add @waaskey/react @waaskey/sdk react
+```
+
+## Use
+
+```tsx
+import { WaaskeyProvider, useCreateWallet, useBalance } from '@waaskey/react';
+import { WasmMpcCore, EncryptedShareStore } from '@waaskey/sdk';
+
+const options = {
+  apiKey: import.meta.env.VITE_WAASKEY_KEY,
+  mpc: new WasmMpcCore(loadClientWasm),
+  shareStore: EncryptedShareStore.browser(sessionSecret),
+};
+
+function App() {
+  return (
+    <WaaskeyProvider options={options}>
+      <Wallet />
+    </WaaskeyProvider>
+  );
+}
+
+function Wallet() {
+  const { create, wallet, isPending } = useCreateWallet();
+  const { data: balance } = useBalance('ethereum', wallet?.address);
+  return isPending ? <Spinner /> : <button onClick={() => create({ chain: 'ethereum' })}>Create</button>;
+}
+```
+
+| Export                       | Description                                             |
+| ---------------------------- | ------------------------------------------------------- |
+| `WaaskeyProvider`            | Provides a configured client (`options` or `client`).   |
+| `useWaaskey()`               | The `Waaskey` client from context.                      |
+| `useCreateWallet()`          | `{ create, wallet, error, isPending }`.                 |
+| `useWallet(id)`              | `{ data, loading, error, refresh }`.                    |
+| `useBalance(chain, address)` | `{ data, loading, error, refresh }` — client-side read. |
+
+All of `@waaskey/sdk` is re-exported, so a single import covers types and values.
+
+## Widget kit (Privy-style, drop-in)
+
+Wrap the app once and drop in prebuilt, themeable components instead of building wallet
+UI from scratch. Everything reads the client + theme from the provider:
+
+```tsx
+import { WaasProvider, ConnectModal, WalletWidget, FundWidget, useSignPrompt, darkTheme } from '@waaskey/react';
+
+function App() {
+  return (
+    <WaasProvider options={options} theme={darkTheme}>
+      <Connect />
+    </WaasProvider>
+  );
+}
+
+function Connect() {
+  const [open, setOpen] = useState(true);
+  return <ConnectModal open={open} onClose={() => setOpen(false)} onConnect={(s) => console.log(s.endUser)} />;
+}
+```
+
+| Component / hook              | What it does                                                                             |
+| ----------------------------- | ---------------------------------------------------------------------------------------- |
+| `<WaasProvider config/theme>` | Client + theme context (alias of `WaaskeyProvider`).                                     |
+| `useWaas()`                   | `{ client, theme, auth }` — the unified surface.                                         |
+| `<ConnectModal>`              | Email-OTP login modal (`auth`), `onConnect(session)`.                                    |
+| `<WalletWidget>`              | Assets / Receive (QR) / Send / Activity panel.                                           |
+| `<FundWidget>`                | Fiat on-ramp (provider widget URL) to fund the wallet.                                   |
+| `useSignPrompt()`             | `requestSignature(tx)` → resolves on approve, rejects on cancel; renders `<SignPrompt>`. |
+
+### Theming / white-label
+
+Pass a partial `theme` to the provider (merged onto `lightTheme`); `darkTheme` and
+`lightTheme` are exported, and every component is themed from that single source — no
+hardcoded brand. The same kit ships for React Native from `@waaskey/react-native` (the
+visual components are RN-native; hooks/theme are shared).
+
+```tsx
+<WaasProvider options={options} theme={{ accent: '#10b981', radius: '20px' }} />
+```
+
+## License
+
+[MIT](./LICENSE) © WAASKey