@dappql/react 1.0.7 → 1.0.10

package/README.md

@@ -0,0 +1,143 @@
+# @dappql/react
+
+> React hooks for [DappQL](https://github.com/dappql/core). Typed, batched smart-contract reads and writes on top of [wagmi](https://wagmi.sh) + [viem](https://viem.sh), with automatic multicall fusion across your entire component tree, per-block reactivity, iterator queries, and mutation tracking.
+
+## Install
+
+```bash
+npm install @dappql/react wagmi viem @tanstack/react-query
+```
+
+Pair with the [`dappql`](https://www.npmjs.com/package/dappql) CLI to generate your typed contract modules.
+
+## Provider
+
+```tsx
+import { WagmiProvider } from 'wagmi'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import { DappQLProvider } from '@dappql/react'
+
+const queryClient = new QueryClient()
+
+export function Root({ children }) {
+  return (
+    <WagmiProvider config={wagmiConfig}>
+      <QueryClientProvider client={queryClient}>
+        <DappQLProvider watchBlocks>{children}</DappQLProvider>
+      </QueryClientProvider>
+    </WagmiProvider>
+  )
+}
+```
+
+Provider options:
+
+| Option | Purpose |
+| --- | --- |
+| `watchBlocks` | Refetch on every new block, makes reads reactive to chain state. |
+| `simulateMutations` | Preflight every tx via `eth_call`. Aborts on revert. |
+| `onMutationUpdate` | Single callback for every transaction lifecycle event, one place to drive toasts, analytics, receipts. |
+| `addressResolver` | Function that resolves contract names to addresses, for registries, proxies, multi-deploy. |
+| `AddressResolverComponent` | Async alternative to `addressResolver` when the resolver needs hooks. |
+
+## Reads
+
+### `useContextQuery`: the default
+
+Batches calls across your **entire** component tree into one multicall.
+
+```tsx
+import { Token, ToDo } from './contracts'
+import { useContextQuery } from '@dappql/react'
+
+function Dashboard({ account }) {
+  const { data, isLoading } = useContextQuery({
+    balance: Token.call.balanceOf(account),
+    symbol: Token.call.symbol(),
+    totalTasks: ToDo.call.totalTasks(),
+  })
+
+  if (isLoading) return <Spinner />
+  return <p>{data.balance.toString()} {data.symbol}</p>
+}
+```
+
+If `<Dashboard>` and `<Sidebar>` both use `useContextQuery`, their calls fuse into one RPC, not two.
+
+### `useQuery`: component-scoped batching
+
+Same shape as `useContextQuery`, but scoped to this hook call. Use when you need `blockNumber`, `paused`, custom `refetchInterval`, or `batchSize` overrides.
+
+### `useSingleQuery` / `useSingleContextQuery`
+
+```tsx
+const { data } = useSingleContextQuery(Token.call.balanceOf(account))
+// data: bigint (inferred from the ABI)
+```
+
+### `useIteratorQuery`: on-chain arrays
+
+```tsx
+import { useIteratorQuery } from '@dappql/react'
+
+const { data } = useIteratorQuery(totalTasks, (i) => ToDo.call.taskAt(account, i))
+```
+
+## Writes
+
+```tsx
+import { useMutation } from '@dappql/react'
+import { ToDo } from './contracts'
+
+function NewTask() {
+  const mutation = useMutation(ToDo.mutation.addItem, 'Add task')
+
+  return (
+    <button
+      disabled={mutation.isLoading}
+      onClick={() => mutation.send('Buy milk', 0n)}
+    >
+      {mutation.confirmation.isSuccess ? 'Added' : 'Add task'}
+    </button>
+  )
+}
+```
+
+Surface:
+
+```ts
+mutation.send(...args)              // broadcast; spread args, not array
+mutation.simulate(...args)          // manual preflight
+mutation.estimate(...args)          // gas estimate
+mutation.isPending                  // awaiting signature
+mutation.isLoading                  // awaiting signature OR mining
+mutation.confirmation.isSuccess     // receipt confirmed
+mutation.reset()
+```
+
+## Fluent request API
+
+Every generated call exposes a small fluent API for overrides:
+
+```ts
+Token.call.balanceOf(account)
+  .at('0x...')       // override deploy address
+  .defaultTo(0n)     // default value until the call resolves
+```
+
+## Related packages
+
+| Package | Purpose |
+| --- | --- |
+| [`dappql`](https://www.npmjs.com/package/dappql) | Codegen CLI, generates the typed contract modules you import above |
+| [`@dappql/async`](https://www.npmjs.com/package/@dappql/async) | Non-React runtime, same typed calls, no React required |
+| [`@dappql/codegen`](https://www.npmjs.com/package/@dappql/codegen) | Framework-agnostic codegen engine |
+| [`@dappql/mcp`](https://www.npmjs.com/package/@dappql/mcp) | MCP server, live contract context for AI coding agents |
+
+## Full documentation
+
+[github.com/dappql/core](https://github.com/dappql/core)
+
+## License
+
+MIT

package/dist/Mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mutation.d.ts","sourceRoot":"","sources":["../src/Mutation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGxD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAEtD,iBAAS,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EAChE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,YAAY,GAAG,SAAS,aAGd,IAAI,8KAYvB;AAED,iBAAS,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EAChE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,YAAY,GAAG,SAAS,aAGd,IAAI,qBAYvB;AAED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS;;;;;;;;;;;;;;;;;;;GAE/D;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GACD,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EACvE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,wBAAwB,CAAC,EAAE,eAAe,GACzC;IACD,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IAChD,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;IACzB,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACpC,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC5C,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACxD,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC7B,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;IACjD,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;CAClD,CA6HA;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Mutation.d.ts","sourceRoot":"","sources":["../src/Mutation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGxD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAEtD,iBAAS,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EAChE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,YAAY,GAAG,SAAS,aAGd,IAAI,8KAYvB;AAED,iBAAS,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EAChE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,YAAY,GAAG,SAAS,aAGd,IAAI,qBAYvB;AAED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS;;;;;;;;;;;;;;;;;;;GAE/D;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GACD,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,EACvE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,wBAAwB,CAAC,EAAE,eAAe,GACzC;IACD,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IAChD,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;IACzB,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACpC,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC5C,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACxD,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC7B,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;IACjD,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;CAClD,CA2IA;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,GAAG,EAAE,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA"}

package/dist/Mutation.js

@@ -49,7 +49,7 @@ function useMutationConfirmation(hash) {
  */
 export function useMutation(config, optionsOrTransactionName) {
     const { addressResolver, onMutationUpdate, simulateMutations } = useDappQL();
-    const { chain, address: account } = useAccount();
+    const { chain, address: account, connector } = useAccount();
     const tx = useWriteContract();
     const client = usePublicClient();
     const address = useMemo(() => optionsOrTransactionName && typeof optionsOrTransactionName !== 'string' && optionsOrTransactionName.address
@@ -70,6 +70,16 @@ export function useMutation(config, optionsOrTransactionName) {
     const send = useCallback((...args) => {
         const now = Date.now();
         const id = mutationInfo.address + mutationInfo.functionName + now.toString();
+        // Captured when the caller asks to send, and used for the write below.
+        //
+        // `writeContract` resolves the active connection inside its own mutation
+        // function, which runs after a yield — and after `simulate` below, which
+        // is awaited. A wallet event landing in either gap would otherwise sign
+        // with whoever is connected then, against arguments built and simulated
+        // for whoever was connected when the caller decided to send. Binding both
+        // makes wagmi fail that write instead of retargeting it.
+        const boundAccount = account;
+        const boundConnector = connector;
         if (!account || !chain?.id) {
             const error = !account ? 'No account connected' : 'Invalid chain';
             onMutationUpdate?.({
@@ -88,6 +98,8 @@ export function useMutation(config, optionsOrTransactionName) {
                 address,
                 chainId: chain?.id,
                 args,
+                account: boundAccount,
+                connector: boundConnector,
             }, {
                 onSettled(data, error) {
                     const status = error ? 'error' : 'signed';
@@ -124,7 +136,7 @@ export function useMutation(config, optionsOrTransactionName) {
         else {
             sendTx();
         }
-    }, [address, tx, config, account, chain?.id, options?.simulate, simulateMutations, client, simulate]);
+    }, [address, tx, config, account, connector, chain?.id, options?.simulate, simulateMutations, client, simulate]);
     const confirmation = useMutationConfirmation(tx.data);
     return useMemo(() => ({
         status: tx.status,

package/dist/blocksHandler.d.ts

@@ -3,7 +3,7 @@ export declare class BlockSubscriptionManager {
     private subscribers;
     private currentBlock;
     subscribe(callback: Subscriber): () => boolean;
-    onBlockUptated(newBlock: bigint): void;
+    onBlockUpdated(newBlock: bigint): void;
 }
 export declare function useBlockNumberSubscriber(): (callback: Subscriber) => () => boolean;
 export {};

package/dist/blocksHandler.js

@@ -13,7 +13,7 @@ export class BlockSubscriptionManager {
         }
         return () => this.subscribers.delete(callback);
     }
-    onBlockUptated(newBlock) {
+    onBlockUpdated(newBlock) {
         this.currentBlock = newBlock;
         this.subscribers.forEach((sub) => sub(newBlock));
     }
@@ -24,7 +24,7 @@ export function useBlockNumberSubscriber() {
     useEffect(() => {
         return client?.watchBlockNumber({
             onBlockNumber: (blockNumber) => {
-                manager.onBlockUptated(blockNumber);
+                manager.onBlockUpdated(blockNumber);
             },
         });
     }, [client, manager]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dappql/react",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "Streamlined smart contract data fetching library for React dApps with TypeScript support",
   "author": "DappQL Team",
   "type": "module",
@@ -28,12 +28,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/dappql/monorepo.git"
+    "url": "git+https://github.com/dappql/core.git"
   },
   "bugs": {
-    "url": "https://github.com/dappql/monorepo/issues"
+    "url": "https://github.com/dappql/core/issues"
   },
-  "homepage": "https://github.com/dappql/monorepo#readme",
+  "homepage": "https://github.com/dappql/core#readme",
   "license": "MIT",
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",