@bigmi/react 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 0.0.1 (2024-10-15)
+
+
+### Bug Fixes
+
+* biome checks ([bc348fa](https://github.com/lifinance/bigmi/commit/bc348faad5cec9ddada1a0c82f4d34e68b85c1c4))
+* tsconfig ([bf6ccea](https://github.com/lifinance/bigmi/commit/bf6cceae3a1602b99b4825ee3695b367d5935226))

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Bigmi
+
+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,137 @@
+<div align="center">
+
+<h1 align="center">Bigmi</h1>
+<p align="center"><strong>TypeScript library and reactive primitives for Bitcoin apps.</strong></p>
+
+[![license](https://img.shields.io/npm/l/@bigmi/core)](/LICENSE.md)
+[![npm latest package](https://img.shields.io/npm/v/@bigmi/core/latest.svg)](https://www.npmjs.com/package/@bigmi/core)
+[![npm downloads](https://img.shields.io/npm/dm/@bigmi/core.svg)](https://www.npmjs.com/package/@bigmi/core)
+
+</div>
+
+**Bigmi** (short for *Bitcoin Is Gonna Make It*) is a TypeScript library that provides reactive primitives for building Bitcoin applications. Bigmi simplifies Bitcoin app development by offering:
+
+- Abstractions over the [Bitcoin JSON-RPC API](https://developer.bitcoin.org/reference/rpc/)
+- First-class APIs for interacting with the [Bitcoin](https://bitcoin.design/) network, including sending transactions and tracking with [Replace-By-Fee (RBF)](https://github.com/bitcoin/bips/blob/master/bip-0125.mediawiki) support
+- Connectors for popular Bitcoin wallet extensions
+- TypeScript support
+  
+Whether you're building a Node.js application or a client-side app, Bigmi provides the tools you need to interact with the Bitcoin.
+
+### Packages
+
+Bigmi is modularized into several packages, each suited to different use cases:
+
+- [@bigmi/core](https://www.npmjs.com/package/@bigmi/core) - Actions, transports, utilities, and other core primitives for Node.js or client-side applications.
+- [@bigmi/react](https://www.npmjs.com/package/@bigmi/react) - Hooks, providers, and other useful primitives for React applications.
+- [@bigmi/client](https://www.npmjs.com/package/@bigmi/client) - Wallet connectors and other tools to connect wallet extensions with Bitcoin applications.
+
+## Installation
+
+```sh
+pnpm add @bigmi/react
+```
+```sh
+pnpm add @bigmi/core
+```
+```sh
+pnpm add @bigmi/client
+```
+
+## Getting Started
+
+Here is an example of a basic usage:
+
+```tsx
+import {
+  type UTXOAPISchema,
+  bitcoin,
+  getBalance,
+  getBlockCount,
+  sendUTXOTransaction,
+  utxo,
+  waitForTransaction,
+} from '@bigmi/core'
+import { createClient, fallback, rpcSchema } from 'viem'
+
+// Create a public client for interactions with the Bitcoin
+const publicClient = createClient({
+  chain: bitcoin,
+  rpcSchema: rpcSchema<UTXOAPISchema>(),
+  transport: fallback([
+    utxo('https://api.blockchair.com', {
+      key: 'blockchair',
+      includeChainToURL: true,
+    }),
+    utxo('https://rpc.ankr.com/http/btc_blockbook/api/v2', {
+      key: 'ankr',
+    }),
+    utxo('https://api.blockcypher.com/v1/btc/main', {
+      key: 'blockcypher',
+    }),
+    utxo('https://mempool.space/api', {
+      key: 'mempool',
+    }),
+  ]),
+})
+
+// Define the Bitcoin address you're working with
+const address = 'BITCOIN_ADDRESS';
+
+// Fetch the balance of the address
+const balance = await getBalance(publicClient, { address });
+console.log(`Balance for ${address}:`, balance);
+
+// Fetch the current block count (height)
+const blockCount = await getBlockCount(publicClient);
+console.log('Current block count:', blockCount);
+
+// Prepare the transaction hex (as a string)
+const txHex = 'TRANSACTION_HEX';
+
+// Send the transaction to the network
+const txId = await sendUTXOTransaction(publicClient, { hex: txHex });
+console.log('Transaction sent with ID:', txId);
+
+// Wait for the transaction to be confirmed
+const transaction = await waitForTransaction(publicClient, {
+  txId,
+  txHex,
+  senderAddress: address,
+  onReplaced: (response) => {
+    console.log('Transaction replaced due to:', response.reason);
+  },
+});
+
+console.log('Transaction confirmed:', transaction);
+```
+
+## Examples
+
+We are working on examples to showcase Bigmi's capabilities. Stay tuned!
+
+In the meantime, explore the [LI.FI Widget](https://github.com/lifinance/widget) and [LI.FI SDK](https://github.com/lifinance/sdk) for inspiration.
+
+## Documentation
+
+Detailed documentation is coming soon. For now, refer to the source code and type definitions for guidance.
+
+## Support
+
+If you encounter any issues or have questions, please open an issue.
+
+## Contributing
+
+We welcome contributions from the community!
+
+## Changelog
+
+The [changelog](/CHANGELOG.md) is regularly updated to reflect what's changed in each new release.
+
+## License
+
+This project is licensed under the terms of the [MIT License](/LICENSE.md).
+
+## Acknowledgments
+
+Bigmi is inspired by the [wevm](https://github.com/wevm) stack. We appreciate the open-source community's contributions to advancing blockchain development.

package/dist/esm/context.d.ts

@@ -0,0 +1,9 @@
+import { type PropsWithChildren } from 'react';
+import type { ResolvedRegister, State } from 'wagmi';
+export declare const BigmiContext: import("react").Context<import("wagmi").Config | undefined>;
+export type BigmiProviderProps = {
+    config: ResolvedRegister['config'];
+    initialState?: State | undefined;
+    reconnectOnMount?: boolean | undefined;
+};
+export declare function BigmiProvider(parameters: PropsWithChildren<BigmiProviderProps>): import("react").FunctionComponentElement<PropsWithChildren<import("wagmi").HydrateProps>>;

package/dist/esm/context.js

@@ -0,0 +1,10 @@
+'use client';
+import { createContext, createElement } from 'react';
+import { Hydrate } from 'wagmi';
+export const BigmiContext = createContext(undefined);
+export function BigmiProvider(parameters) {
+    const { children, config } = parameters;
+    const props = { value: config };
+    return createElement(Hydrate, parameters, createElement(BigmiContext.Provider, props, children));
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAA0B,aAAa,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAEvC,SAAS,CAAC,CAAA;AAQZ,MAAM,UAAU,aAAa,CAC3B,UAAiD;IAEjD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;IAEvC,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC/B,OAAO,aAAa,CAClB,OAAO,EACP,UAAU,EACV,aAAa,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CACtD,CAAA;AACH,CAAC"}

package/dist/esm/errors/context.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from 'wagmi';
+export type BigmiProviderNotFoundErrorType = BigmiProviderNotFoundError & {
+    name: 'BigmiProviderNotFoundError';
+};
+export declare class BigmiProviderNotFoundError extends BaseError {
+    name: string;
+    constructor();
+}

package/dist/esm/errors/context.js

@@ -0,0 +1,8 @@
+import { BaseError } from 'wagmi';
+export class BigmiProviderNotFoundError extends BaseError {
+    constructor() {
+        super('`useConfig` must be used within `BigmiProvider`.');
+        this.name = 'BigmiProviderNotFoundError';
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/errors/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/errors/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKjC,MAAM,OAAO,0BAA2B,SAAQ,SAAS;IAEvD;QACE,KAAK,CAAC,kDAAkD,CAAC,CAAA;QAFlD,SAAI,GAAG,4BAA4B,CAAA;IAG5C,CAAC;CACF"}

package/dist/esm/hooks/useAccount.d.ts

@@ -0,0 +1,3 @@
+import type { Config, ResolvedRegister, UseAccountParameters, UseAccountReturnType } from 'wagmi';
+/** https://wagmi.sh/react/api/hooks/useAccount */
+export declare function useAccount<C extends Config = ResolvedRegister['config']>(parameters?: UseAccountParameters<C>): UseAccountReturnType<C>;

package/dist/esm/hooks/useAccount.js

@@ -0,0 +1,10 @@
+'use client';
+import { getAccount, watchAccount } from 'wagmi/actions';
+import { useConfig } from './useConfig.js';
+import { useSyncExternalStoreWithTracked } from './useSyncExternalStoreWithTracked.js';
+/** https://wagmi.sh/react/api/hooks/useAccount */
+export function useAccount(parameters = {}) {
+    const config = useConfig(parameters);
+    return useSyncExternalStoreWithTracked((onChange) => watchAccount(config, { onChange }), () => getAccount(config));
+}
+//# sourceMappingURL=useAccount.js.map

package/dist/esm/hooks/useAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccount.js","sourceRoot":"","sources":["../../../src/hooks/useAccount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAOZ,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAEtF,kDAAkD;AAClD,MAAM,UAAU,UAAU,CACxB,aAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;IAEpC,OAAO,+BAA+B,CACpC,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAChD,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CACzB,CAAA;AACH,CAAC"}

package/dist/esm/hooks/useConfig.d.ts

@@ -0,0 +1,3 @@
+import type { Config, ResolvedRegister, UseConfigParameters, UseConfigReturnType } from 'wagmi';
+/** https://wagmi.sh/react/api/hooks/useConfig */
+export declare function useConfig<C extends Config = ResolvedRegister['config']>(parameters?: UseConfigParameters<C>): UseConfigReturnType<C>;

package/dist/esm/hooks/useConfig.js

@@ -0,0 +1,14 @@
+'use client';
+import { useContext } from 'react';
+import { BigmiContext } from '../context.js';
+import { BigmiProviderNotFoundError } from '../errors/context.js';
+/** https://wagmi.sh/react/api/hooks/useConfig */
+export function useConfig(parameters = {}) {
+    // biome-ignore lint/correctness/useHookAtTopLevel:
+    const config = parameters.config ?? useContext(BigmiContext);
+    if (!config) {
+        throw new BigmiProviderNotFoundError();
+    }
+    return config;
+}
+//# sourceMappingURL=useConfig.js.map

package/dist/esm/hooks/useConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfig.js","sourceRoot":"","sources":["../../../src/hooks/useConfig.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAOlC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAEjE,iDAAiD;AACjD,MAAM,UAAU,SAAS,CACvB,aAAqC,EAAE;IAEvC,mDAAmD;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,CAAA;IAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,0BAA0B,EAAE,CAAA;IACxC,CAAC;IACD,OAAO,MAAgC,CAAA;AACzC,CAAC"}

package/dist/esm/hooks/useReconnect.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from 'wagmi';
+export declare const useReconnect: (config: Config) => void;

package/dist/esm/hooks/useReconnect.js

@@ -0,0 +1,8 @@
+import { reconnect } from '@bigmi/client';
+import { useEffect } from 'react';
+export const useReconnect = (config) => {
+    useEffect(() => {
+        reconnect(config);
+    }, [config]);
+};
+//# sourceMappingURL=useReconnect.js.map

package/dist/esm/hooks/useReconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReconnect.js","sourceRoot":"","sources":["../../../src/hooks/useReconnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGjC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,EAAE;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,MAAM,CAAC,CAAA;IACnB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AACd,CAAC,CAAA"}

package/dist/esm/hooks/useSyncExternalStoreWithTracked.d.ts

@@ -0,0 +1 @@
+export declare function useSyncExternalStoreWithTracked<snapshot extends selection, selection = snapshot>(subscribe: (onStoreChange: () => void) => () => void, getSnapshot: () => snapshot, getServerSnapshot?: undefined | null | (() => snapshot), isEqual?: (a: selection, b: selection) => boolean): snapshot;

package/dist/esm/hooks/useSyncExternalStoreWithTracked.js

@@ -0,0 +1,43 @@
+'use client';
+import { useRef } from 'react';
+import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/shim/with-selector.js';
+import { deepEqual } from 'wagmi';
+const isPlainObject = (obj) => typeof obj === 'object' && !Array.isArray(obj);
+export function useSyncExternalStoreWithTracked(subscribe, getSnapshot, getServerSnapshot = getSnapshot, isEqual = deepEqual) {
+    const trackedKeys = useRef([]);
+    const result = useSyncExternalStoreWithSelector(subscribe, getSnapshot, getServerSnapshot, (x) => x, (a, b) => {
+        if (isPlainObject(a) && isPlainObject(b) && trackedKeys.current.length) {
+            for (const key of trackedKeys.current) {
+                const equal = isEqual(a[key], b[key]);
+                if (!equal) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        return isEqual(a, b);
+    });
+    if (isPlainObject(result)) {
+        const trackedResult = { ...result };
+        let properties = {};
+        for (const [key, value] of Object.entries(trackedResult)) {
+            properties = {
+                ...properties,
+                [key]: {
+                    configurable: false,
+                    enumerable: true,
+                    get: () => {
+                        if (!trackedKeys.current.includes(key)) {
+                            trackedKeys.current.push(key);
+                        }
+                        return value;
+                    },
+                },
+            };
+        }
+        Object.defineProperties(trackedResult, properties);
+        return trackedResult;
+    }
+    return result;
+}
+//# sourceMappingURL=useSyncExternalStoreWithTracked.js.map

package/dist/esm/hooks/useSyncExternalStoreWithTracked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSyncExternalStoreWithTracked.js","sourceRoot":"","sources":["../../../src/hooks/useSyncExternalStoreWithTracked.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,MAAM,aAAa,GAAG,CAAC,GAAY,EAAE,EAAE,CACrC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AAEhD,MAAM,UAAU,+BAA+B,CAI7C,SAAoD,EACpD,WAA2B,EAC3B,oBAAyD,WAAW,EACpE,UAAmD,SAAS;IAE5D,MAAM,WAAW,GAAG,MAAM,CAAW,EAAE,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,gCAAgC,CAC7C,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EACR,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACP,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACvE,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,OAAO,CAClB,CAA2B,CAAC,GAAG,CAAC,EAChC,CAA2B,CAAC,GAAG,CAAC,CAClC,CAAA;gBACD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtB,CAAC,CACF,CAAA;IAED,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;QACnC,IAAI,UAAU,GAAG,EAAE,CAAA;QACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACvC,aAAuC,CACxC,EAAE,CAAC;YACF,UAAU,GAAG;gBACX,GAAG,UAAU;gBACb,CAAC,GAAG,CAAC,EAAE;oBACL,YAAY,EAAE,KAAK;oBACnB,UAAU,EAAE,IAAI;oBAChB,GAAG,EAAE,GAAG,EAAE;wBACR,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;4BACvC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;wBAC/B,CAAC;wBACD,OAAO,KAAK,CAAA;oBACd,CAAC;iBACF;aACF,CAAA;QACH,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;QAClD,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export { BigmiContext, BigmiProvider } from './context.js';
+export type { BigmiProviderProps } from './context.js';
+export { useConfig } from './hooks/useConfig.js';
+export { useReconnect } from './hooks/useReconnect.js';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export { BigmiContext, BigmiProvider } from './context.js';
+export { useConfig } from './hooks/useConfig.js';
+export { useReconnect } from './hooks/useReconnect.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@bigmi/react",
+  "version": "0.0.1",
+  "description": "React primitives for Bitcoin apps.",
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "sideEffects": false,
+  "author": "Eugene Chybisov <eugene@li.finance>",
+  "homepage": "https://github.com/lifinance/bigmi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lifinance/bigmi.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/lifinance/bigmi/issues"
+  },
+  "license": "MIT",
+  "keywords": [
+    "bitcoin",
+    "bitcoinjs",
+    "btc",
+    "utxo",
+    "web3",
+    "dapp",
+    "typescript",
+    "react",
+    "hooks"
+  ],
+  "dependencies": {
+    "use-sync-external-store": "^1.2.2",
+    "viem": "^2.21.25",
+    "wagmi": "^2.12.16",
+    "@bigmi/client": "^0.0.1",
+    "@bigmi/core": "^0.0.1"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "viem": "^2.21.0",
+    "wagmi": "^2.12.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
+    },
+    "./package.json": "./package.json"
+  }
+}

package/src/context.ts

@@ -0,0 +1,27 @@
+'use client'
+import { type PropsWithChildren, createContext, createElement } from 'react'
+import type { ResolvedRegister, State } from 'wagmi'
+import { Hydrate } from 'wagmi'
+
+export const BigmiContext = createContext<
+  ResolvedRegister['config'] | undefined
+>(undefined)
+
+export type BigmiProviderProps = {
+  config: ResolvedRegister['config']
+  initialState?: State | undefined
+  reconnectOnMount?: boolean | undefined
+}
+
+export function BigmiProvider(
+  parameters: PropsWithChildren<BigmiProviderProps>
+) {
+  const { children, config } = parameters
+
+  const props = { value: config }
+  return createElement(
+    Hydrate,
+    parameters,
+    createElement(BigmiContext.Provider, props, children)
+  )
+}

package/src/errors/context.ts

@@ -0,0 +1,11 @@
+import { BaseError } from 'wagmi'
+
+export type BigmiProviderNotFoundErrorType = BigmiProviderNotFoundError & {
+  name: 'BigmiProviderNotFoundError'
+}
+export class BigmiProviderNotFoundError extends BaseError {
+  override name = 'BigmiProviderNotFoundError'
+  constructor() {
+    super('`useConfig` must be used within `BigmiProvider`.')
+  }
+}

package/src/hooks/useAccount.ts

@@ -0,0 +1,22 @@
+'use client'
+import type {
+  Config,
+  ResolvedRegister,
+  UseAccountParameters,
+  UseAccountReturnType,
+} from 'wagmi'
+import { getAccount, watchAccount } from 'wagmi/actions'
+import { useConfig } from './useConfig.js'
+import { useSyncExternalStoreWithTracked } from './useSyncExternalStoreWithTracked.js'
+
+/** https://wagmi.sh/react/api/hooks/useAccount */
+export function useAccount<C extends Config = ResolvedRegister['config']>(
+  parameters: UseAccountParameters<C> = {}
+): UseAccountReturnType<C> {
+  const config = useConfig(parameters)
+
+  return useSyncExternalStoreWithTracked(
+    (onChange) => watchAccount(config, { onChange }),
+    () => getAccount(config)
+  )
+}

package/src/hooks/useConfig.ts

@@ -0,0 +1,22 @@
+'use client'
+import { useContext } from 'react'
+import type {
+  Config,
+  ResolvedRegister,
+  UseConfigParameters,
+  UseConfigReturnType,
+} from 'wagmi'
+import { BigmiContext } from '../context.js'
+import { BigmiProviderNotFoundError } from '../errors/context.js'
+
+/** https://wagmi.sh/react/api/hooks/useConfig */
+export function useConfig<C extends Config = ResolvedRegister['config']>(
+  parameters: UseConfigParameters<C> = {}
+): UseConfigReturnType<C> {
+  // biome-ignore lint/correctness/useHookAtTopLevel:
+  const config = parameters.config ?? useContext(BigmiContext)
+  if (!config) {
+    throw new BigmiProviderNotFoundError()
+  }
+  return config as UseConfigReturnType<C>
+}

package/src/hooks/useReconnect.ts

@@ -0,0 +1,9 @@
+import { reconnect } from '@bigmi/client'
+import { useEffect } from 'react'
+import type { Config } from 'wagmi'
+
+export const useReconnect = (config: Config) => {
+  useEffect(() => {
+    reconnect(config)
+  }, [config])
+}

package/src/hooks/useSyncExternalStoreWithTracked.ts

@@ -0,0 +1,66 @@
+'use client'
+import { useRef } from 'react'
+import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/shim/with-selector.js'
+import { deepEqual } from 'wagmi'
+
+const isPlainObject = (obj: unknown) =>
+  typeof obj === 'object' && !Array.isArray(obj)
+
+export function useSyncExternalStoreWithTracked<
+  snapshot extends selection,
+  selection = snapshot,
+>(
+  subscribe: (onStoreChange: () => void) => () => void,
+  getSnapshot: () => snapshot,
+  getServerSnapshot: undefined | null | (() => snapshot) = getSnapshot,
+  isEqual: (a: selection, b: selection) => boolean = deepEqual
+) {
+  const trackedKeys = useRef<string[]>([])
+  const result = useSyncExternalStoreWithSelector(
+    subscribe,
+    getSnapshot,
+    getServerSnapshot,
+    (x) => x,
+    (a, b) => {
+      if (isPlainObject(a) && isPlainObject(b) && trackedKeys.current.length) {
+        for (const key of trackedKeys.current) {
+          const equal = isEqual(
+            (a as { [_a: string]: any })[key],
+            (b as { [_b: string]: any })[key]
+          )
+          if (!equal) {
+            return false
+          }
+        }
+        return true
+      }
+      return isEqual(a, b)
+    }
+  )
+
+  if (isPlainObject(result)) {
+    const trackedResult = { ...result }
+    let properties = {}
+    for (const [key, value] of Object.entries(
+      trackedResult as { [key: string]: any }
+    )) {
+      properties = {
+        ...properties,
+        [key]: {
+          configurable: false,
+          enumerable: true,
+          get: () => {
+            if (!trackedKeys.current.includes(key)) {
+              trackedKeys.current.push(key)
+            }
+            return value
+          },
+        },
+      }
+    }
+    Object.defineProperties(trackedResult, properties)
+    return trackedResult
+  }
+
+  return result
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { BigmiContext, BigmiProvider } from './context.js'
+export type { BigmiProviderProps } from './context.js'
+export { useConfig } from './hooks/useConfig.js'
+export { useReconnect } from './hooks/useReconnect.js'

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "declaration": true,
+    "sourceMap": true,
+    "outDir": "dist/esm",
+    "rootDir": "./src",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext"
+  },
+  "include": [
+    "./src/**/*",
+    "./src/**/*.json",
+    "../client/src/createDefaultBigmiConfig.ts"
+  ]
+}