@jaw.id/wagmi 0.0.1

package/README.md

@@ -0,0 +1,147 @@
+# @jaw.id/wagmi
+
+Wagmi connector and React hooks for JAW (JustaName Account Wallet) smart accounts.
+
+## Installation
+
+```bash
+npm install @jaw.id/wagmi wagmi @tanstack/react-query
+# or
+yarn add @jaw.id/wagmi wagmi @tanstack/react-query
+# or
+bun add @jaw.id/wagmi wagmi @tanstack/react-query
+```
+
+## Quick Start
+
+### 1. Configure Wagmi with JAW Connector
+
+```typescript
+import { createConfig, http } from 'wagmi';
+import { mainnet, sepolia } from 'wagmi/chains';
+import { jaw } from '@jaw.id/wagmi';
+
+export const config = createConfig({
+  chains: [mainnet, sepolia],
+  connectors: [
+    jaw({
+     apiKey: 'your-api-key',
+    }),
+  ],
+  transports: {
+    [mainnet.id]: http(),
+    [sepolia.id]: http(),
+  },
+});
+```
+
+### 2. Use React Hooks
+
+```tsx
+import { useConnect, useDisconnect, useGrantPermissions } from '@jaw.id/wagmi';
+import { useAccount } from 'wagmi';
+
+function App() {
+  const { connect } = useConnect();
+  const { disconnect } = useDisconnect();
+  const { address, isConnected } = useAccount();
+  const { grantPermissions } = useGrantPermissions();
+
+  if (isConnected) {
+    return (
+      <div>
+        <p>Connected: {address}</p>
+        <button onClick={() => disconnect()}>Disconnect</button>
+        <button onClick={() => grantPermissions({ permissions: [...] })}>
+          Grant Permissions
+        </button>
+      </div>
+    );
+  }
+
+  return <button onClick={() => connect()}>Connect</button>;
+}
+```
+
+## Exports
+
+### Connector
+
+- `jaw(options)` - Wagmi connector factory
+
+```typescript
+import { jaw } from '@jaw.id/wagmi';
+
+const connector = jaw({
+    apiKey: 'your-api-key',
+});
+```
+
+### React Hooks
+
+Available as named exports or via the `Hooks` namespace:
+
+```typescript
+import { useConnect, Hooks } from '@jaw.id/wagmi';
+
+// Both are equivalent:
+useConnect();
+Hooks.useConnect();
+```
+
+| Hook | Description |
+|------|-------------|
+| `useConnect` | Connect to JAW wallet |
+| `useDisconnect` | Disconnect from wallet |
+| `useGrantPermissions` | Grant permissions to apps (EIP-7715) |
+| `useRevokePermissions` | Revoke previously granted permissions |
+| `usePermissions` | Query current permissions |
+| `useGetAssets` | Query wallet assets (EIP-7811) |
+| `useCapabilities` | Query wallet capabilities |
+
+### Actions (Non-React)
+
+For use outside React components or with other state managers:
+
+```typescript
+import { connect, Actions } from '@jaw.id/wagmi';
+
+// Both are equivalent:
+await connect(config, { connector });
+await Actions.connect(config, { connector });
+```
+
+| Action | Description |
+|--------|-------------|
+| `connect` | Connect to wallet |
+| `disconnect` | Disconnect from wallet |
+| `grantPermissions` | Grant permissions |
+| `revokePermissions` | Revoke permissions |
+| `getPermissions` | Get current permissions |
+| `getAssets` | Get wallet assets |
+| `getCapabilities` | Get wallet capabilities |
+
+### TanStack Query Utilities
+
+Query key factories for custom query implementations:
+
+```typescript
+import { Query, getPermissionsQueryKey } from '@jaw.id/wagmi';
+
+// Use with TanStack Query
+const queryKey = getPermissionsQueryKey({ address, chainId });
+```
+
+## Peer Dependencies
+
+- `react` >= 18.0.0
+- `wagmi` >= 3.0.0
+- `@tanstack/react-query` >= 5.0.0
+
+## Documentation
+
+For detailed guides, API reference, and examples, visit **[docs.jaw.id](https://docs.jaw.id)**.
+
+## License
+
+[MIT](../../LICENSE.md)

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { jaw, type JawParameters, type WalletConnectCapabilities, type AccountWithCapabilities, } from './lib/Connector.js';
+export type { PersonalSignRequestData, TypedDataRequestData, PermissionsDetail, CallPermissionDetail, SpendPermissionDetail, } from '@jaw.id/core';
+export * as Actions from './lib/Actions.js';
+export * as Hooks from './lib/Hooks.js';
+export * as Query from './lib/Query.js';
+export { useConnect, useDisconnect, useGrantPermissions, useRevokePermissions, usePermissions, useGetAssets, useCapabilities, useSign, useGetCallsHistory, } from './lib/Hooks.js';
+export { connect, disconnect, grantPermissions, getPermissions, revokePermissions, getAssets, getCapabilities, sign, getCallsHistory, } from './lib/Actions.js';
+export { getPermissionsQueryKey, getAssetsQueryKey, getCapabilitiesQueryKey, getCallsHistoryQueryKey } from './lib/Query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,GAAG,EACH,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAG5C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAGxC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EACL,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,OAAO,EACP,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,IAAI,EACJ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Connector
+export { jaw, } from './lib/Connector.js';
+// Actions namespace
+export * as Actions from './lib/Actions.js';
+// Hooks namespace
+export * as Hooks from './lib/Hooks.js';
+// Query namespace
+export * as Query from './lib/Query.js';
+// Also export individual hooks for convenience
+export { useConnect, useDisconnect, useGrantPermissions, useRevokePermissions, usePermissions, useGetAssets, useCapabilities, useSign, useGetCallsHistory, } from './lib/Hooks.js';
+// Also export individual actions for convenience
+export { connect, disconnect, grantPermissions, getPermissions, revokePermissions, getAssets, getCapabilities, sign, getCallsHistory, } from './lib/Actions.js';
+// Also export query keys for convenience
+export { getPermissionsQueryKey, getAssetsQueryKey, getCapabilitiesQueryKey, getCallsHistoryQueryKey } from './lib/Query.js';

package/dist/lib/Actions.d.ts

@@ -0,0 +1,2 @@
+export { connect, disconnect, grantPermissions, getPermissions, revokePermissions, getAssets, getCapabilities, sign, getCallsHistory, } from './internal/core.js';
+//# sourceMappingURL=Actions.d.ts.map

package/dist/lib/Actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actions.d.ts","sourceRoot":"","sources":["../../src/lib/Actions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,IAAI,EACJ,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/lib/Actions.js

@@ -0,0 +1 @@
+export { connect, disconnect, grantPermissions, getPermissions, revokePermissions, getAssets, getCapabilities, sign, getCallsHistory, } from './internal/core.js';

package/dist/lib/Connector.d.ts

@@ -0,0 +1,30 @@
+import { type CreateJAWSDKOptions, type ProviderInterface, type WalletConnectCapabilities, type WalletConnectResponse } from '@jaw.id/core';
+import { type ProviderConnectInfo } from 'viem';
+export type JawParameters = CreateJAWSDKOptions;
+export type { WalletConnectCapabilities } from '@jaw.id/core';
+type ConnectParameters = {
+    chainId?: number | undefined;
+    isReconnecting?: boolean | undefined;
+    /**
+     * Capabilities to request during wallet_connect.
+     * When provided, uses wallet_connect instead of eth_requestAccounts.
+     */
+    capabilities?: WalletConnectCapabilities | undefined;
+};
+/** Account with capabilities returned from wallet_connect */
+export type AccountWithCapabilities = {
+    address: `0x${string}`;
+    capabilities?: WalletConnectResponse['accounts'][number]['capabilities'];
+};
+type ConnectorProperties = {
+    connect(parameters?: ConnectParameters): Promise<{
+        accounts: readonly `0x${string}`[] | readonly AccountWithCapabilities[];
+        chainId: number;
+    }>;
+    onConnect(connectInfo: ProviderConnectInfo): void;
+};
+export declare function jaw(parameters: JawParameters): import("@wagmi/core").CreateConnectorFn<ProviderInterface, ConnectorProperties, Record<string, unknown>>;
+export declare namespace jaw {
+    var type: "jaw";
+}
+//# sourceMappingURL=Connector.d.ts.map

package/dist/lib/Connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.d.ts","sourceRoot":"","sources":["../../src/lib/Connector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAG3B,MAAM,cAAc,CAAC;AAMtB,OAAO,EAGL,KAAK,mBAAmB,EAIzB,MAAM,MAAM,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAGhD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAwB9D,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACtD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;CAC1E,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAC/C,QAAQ,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,GAAG,SAAS,uBAAuB,EAAE,CAAC;QACxE,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,SAAS,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF,wBAAgB,GAAG,CAAC,UAAU,EAAE,aAAa,4GAkQ5C;yBAlQe,GAAG"}

package/dist/lib/Connector.js

@@ -0,0 +1,254 @@
+import { JAW, JAW_WALLET_ICON, } from '@jaw.id/core';
+import { ChainNotConfiguredError, createConnector, } from '@wagmi/core';
+import { getAddress, numberToHex, SwitchChainError, UserRejectedRequestError, withRetry, } from 'viem';
+import { JAW_WALLET_ID, JAW_WALLET_NAME, JAW_WALLET_RDNS } from "@jaw.id/core";
+jaw.type = 'jaw';
+/**
+ * Helper to parse accounts from various response formats
+ */
+function parseAccounts(accountsResult) {
+    if (Array.isArray(accountsResult)) {
+        return accountsResult.map((x) => getAddress(x));
+    }
+    if (accountsResult && typeof accountsResult === 'object' && 'accounts' in accountsResult) {
+        const response = accountsResult;
+        if (Array.isArray(response.accounts) && response.accounts.length > 0) {
+            const first = response.accounts[0];
+            if (typeof first === 'string') {
+                return response.accounts.map((x) => getAddress(x));
+            }
+            return response.accounts.map((acc) => getAddress(acc.address));
+        }
+    }
+    return [];
+}
+export function jaw(parameters) {
+    let sdk;
+    let provider_;
+    let accountsChanged;
+    let chainChanged;
+    let connect;
+    let disconnect;
+    return createConnector((config) => ({
+        id: JAW_WALLET_ID,
+        name: JAW_WALLET_NAME,
+        type: jaw.type,
+        rdns: JAW_WALLET_RDNS,
+        icon: JAW_WALLET_ICON,
+        async setup() {
+            // Setup connect listener for auto-reconnection
+            if (!connect) {
+                const provider = await this.getProvider();
+                connect = this.onConnect.bind(this);
+                provider.on('connect', connect);
+            }
+        },
+        async connect({ chainId, isReconnecting, capabilities } = {}) {
+            const targetChainId = chainId;
+            let accounts = [];
+            let accountsWithCapabilities = [];
+            let currentChainId;
+            // Handle reconnection
+            if (isReconnecting) {
+                [accounts, currentChainId] = await Promise.all([
+                    this.getAccounts().catch(() => []),
+                    this.getChainId().catch(() => undefined),
+                ]);
+                if (targetChainId && currentChainId !== targetChainId) {
+                    const chain = await this.switchChain?.({ chainId: targetChainId }).catch((error) => {
+                        if (error.code === UserRejectedRequestError.code)
+                            throw error;
+                        return { id: currentChainId };
+                    });
+                    currentChainId = chain?.id ?? currentChainId;
+                }
+            }
+            const provider = await this.getProvider();
+            try {
+                if (!accounts?.length && !isReconnecting) {
+                    // Use wallet_connect if capabilities are requested, otherwise use eth_requestAccounts
+                    if (capabilities && Object.keys(capabilities).length > 0) {
+                        const walletConnectResponse = await provider.request({
+                            method: 'wallet_connect',
+                            params: [{ capabilities }],
+                        });
+                        // Extract accounts with their capabilities
+                        accountsWithCapabilities = walletConnectResponse.accounts.map((acc) => ({
+                            address: getAddress(acc.address),
+                            capabilities: acc.capabilities,
+                        }));
+                        accounts = accountsWithCapabilities.map((acc) => acc.address);
+                    }
+                    else {
+                        const accountsResult = await provider.request({
+                            method: 'eth_requestAccounts',
+                        });
+                        accounts = parseAccounts(accountsResult);
+                    }
+                    currentChainId = await this.getChainId();
+                }
+                if (!currentChainId)
+                    throw new ChainNotConfiguredError();
+                // Manage EIP-1193 event listeners
+                if (connect) {
+                    provider.removeListener('connect', connect);
+                    connect = undefined;
+                }
+                if (!accountsChanged) {
+                    accountsChanged = this.onAccountsChanged.bind(this);
+                    provider.on('accountsChanged', accountsChanged);
+                }
+                if (!chainChanged) {
+                    chainChanged = this.onChainChanged.bind(this);
+                    provider.on('chainChanged', chainChanged);
+                }
+                if (!disconnect) {
+                    disconnect = this.onDisconnect.bind(this);
+                    provider.on('disconnect', disconnect);
+                }
+                // Switch chain if requested and different from current (skip if handled during reconnection)
+                if (targetChainId && currentChainId !== targetChainId && !isReconnecting) {
+                    const chain = await this.switchChain?.({ chainId: targetChainId }).catch((error) => {
+                        if (error.code === UserRejectedRequestError.code)
+                            throw error;
+                        return { id: currentChainId };
+                    });
+                    currentChainId = chain?.id ?? currentChainId;
+                }
+                // Return accounts with capabilities if wallet_connect was used, otherwise plain accounts
+                return {
+                    accounts: (accountsWithCapabilities.length > 0
+                        ? accountsWithCapabilities
+                        : accounts),
+                    chainId: currentChainId,
+                };
+            }
+            catch (error) {
+                if (/(user closed modal|accounts received is empty|user denied account|request rejected)/i.test(error.message))
+                    throw new UserRejectedRequestError(error);
+                throw error;
+            }
+        },
+        async disconnect() {
+            const provider = await this.getProvider();
+            // Remove listeners
+            if (accountsChanged) {
+                provider.removeListener('accountsChanged', accountsChanged);
+                accountsChanged = undefined;
+            }
+            if (chainChanged) {
+                provider.removeListener('chainChanged', chainChanged);
+                chainChanged = undefined;
+            }
+            if (disconnect) {
+                provider.removeListener('disconnect', disconnect);
+                disconnect = undefined;
+            }
+            // Re-add connect listener for future connections
+            if (!connect) {
+                connect = this.onConnect.bind(this);
+                provider.on('connect', connect);
+            }
+            // Call provider disconnect
+            await provider.disconnect();
+        },
+        async getAccounts() {
+            const provider = await this.getProvider();
+            const accountsResult = await provider.request({
+                method: 'eth_accounts',
+            });
+            return parseAccounts(accountsResult);
+        },
+        async getChainId() {
+            const provider = await this.getProvider();
+            const chainId = await provider.request({ method: 'eth_chainId' });
+            return Number(chainId);
+        },
+        async getProvider() {
+            if (!provider_) {
+                sdk = JAW.create(parameters);
+                provider_ = sdk.provider;
+            }
+            return provider_;
+        },
+        async isAuthorized() {
+            try {
+                // Use retry strategy for reliability
+                const accounts = await withRetry(() => this.getAccounts());
+                return accounts.length > 0;
+            }
+            catch {
+                return false;
+            }
+        },
+        async switchChain({ chainId }) {
+            const chain = config.chains.find((x) => x.id === chainId);
+            if (!chain)
+                throw new SwitchChainError(new ChainNotConfiguredError());
+            const provider = await this.getProvider();
+            await provider.request({
+                method: 'wallet_switchEthereumChain',
+                params: [{ chainId: numberToHex(chainId) }],
+            });
+            return chain;
+        },
+        onAccountsChanged(accounts) {
+            if (accounts.length === 0)
+                this.onDisconnect();
+            else
+                config.emitter.emit('change', {
+                    accounts: accounts.map((x) => getAddress(x)),
+                });
+        },
+        onChainChanged(chain) {
+            const chainId = Number(chain);
+            config.emitter.emit('change', { chainId });
+        },
+        async onConnect(connectInfo) {
+            const accounts = await this.getAccounts();
+            if (accounts.length === 0)
+                return;
+            const chainId = Number(connectInfo.chainId);
+            config.emitter.emit('connect', { accounts, chainId });
+            // Manage EIP-1193 event listeners
+            const provider = await this.getProvider();
+            if (connect) {
+                provider.removeListener('connect', connect);
+                connect = undefined;
+            }
+            if (!accountsChanged) {
+                accountsChanged = this.onAccountsChanged.bind(this);
+                provider.on('accountsChanged', accountsChanged);
+            }
+            if (!chainChanged) {
+                chainChanged = this.onChainChanged.bind(this);
+                provider.on('chainChanged', chainChanged);
+            }
+            if (!disconnect) {
+                disconnect = this.onDisconnect.bind(this);
+                provider.on('disconnect', disconnect);
+            }
+        },
+        async onDisconnect(_error) {
+            const provider = await this.getProvider();
+            config.emitter.emit('disconnect');
+            // Manage EIP-1193 event listeners
+            if (accountsChanged) {
+                provider.removeListener('accountsChanged', accountsChanged);
+                accountsChanged = undefined;
+            }
+            if (chainChanged) {
+                provider.removeListener('chainChanged', chainChanged);
+                chainChanged = undefined;
+            }
+            if (disconnect) {
+                provider.removeListener('disconnect', disconnect);
+                disconnect = undefined;
+            }
+            if (!connect) {
+                connect = this.onConnect.bind(this);
+                provider.on('connect', connect);
+            }
+        },
+    }));
+}

package/dist/lib/Connector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Connector.test.d.ts.map

package/dist/lib/Connector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.test.d.ts","sourceRoot":"","sources":["../../src/lib/Connector.test.ts"],"names":[],"mappings":""}

package/dist/lib/Connector.test.js

@@ -0,0 +1,18 @@
+import { expect, test } from 'vitest';
+import { jaw } from './Connector.js';
+test('setup', () => {
+    const connectorFn = jaw({
+        apiKey: 'test-api-key',
+    });
+    expect(jaw.type).toEqual('jaw');
+    expect(typeof connectorFn).toBe('function');
+});
+test('setup with parameters', () => {
+    const connectorFn = jaw({
+        apiKey: 'test-api-key',
+        appName: 'Test App',
+        appLogoUrl: 'https://example.com/logo.png',
+    });
+    expect(jaw.type).toEqual('jaw');
+    expect(typeof connectorFn).toBe('function');
+});

package/dist/lib/Hooks.d.ts

@@ -0,0 +1,2 @@
+export { useConnect, useDisconnect, useGrantPermissions, useRevokePermissions, usePermissions, useGetAssets, useCapabilities, useSign, useGetCallsHistory, } from './internal/react.js';
+//# sourceMappingURL=Hooks.d.ts.map

package/dist/lib/Hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/lib/Hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,OAAO,EACP,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/lib/Hooks.js

@@ -0,0 +1 @@
+export { useConnect, useDisconnect, useGrantPermissions, useRevokePermissions, usePermissions, useGetAssets, useCapabilities, useSign, useGetCallsHistory, } from './internal/react.js';

package/dist/lib/Query.d.ts

@@ -0,0 +1,2 @@
+export { getPermissionsQueryKey, getAssetsQueryKey, getCapabilitiesQueryKey, getCallsHistoryQueryKey } from './internal/query.js';
+//# sourceMappingURL=Query.d.ts.map

package/dist/lib/Query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.d.ts","sourceRoot":"","sources":["../../src/lib/Query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/Query.js

@@ -0,0 +1 @@
+export { getPermissionsQueryKey, getAssetsQueryKey, getCapabilitiesQueryKey, getCallsHistoryQueryKey } from './internal/query.js';