@rhinestone/1auth 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,267 @@
+import { P as PasskeyProviderClient, W as WebAuthnSignature, I as IntentCall, S as SendIntentResult } from './client-C1inywuT.mjs';
+export { A as AuthenticateOptions, k as AuthenticateResult, B as BalanceRequirement, y as CloseOnStatus, C as CreateSigningRequestResponse, p as EIP712Domain, r as EIP712TypeField, q as EIP712Types, E as EmbedOptions, D as ExecuteIntentResponse, w as IntentQuote, x as IntentStatus, u as IntentTokenRequest, L as LoginOptions, j as LoginResult, M as MerchantSignedIntent, O as OrchestratorStatus, h as PasskeyCredential, a as PasskeyProviderConfig, z as PrepareIntentResponse, R as RegisterOptions, i as RegisterResult, v as SendIntentOptions, F as SendSwapOptions, G as SendSwapResult, l as SignMessageOptions, m as SignMessageResult, n as SignTypedDataOptions, o as SignTypedDataResult, e as SigningError, f as SigningErrorCode, b as SigningRequestOptions, g as SigningRequestStatus, c as SigningResult, d as SigningSuccess, H as SwapQuote, J as ThemeConfig, T as TransactionAction, t as TransactionDetails, s as TransactionFees, U as UserPasskeysResponse } from './client-C1inywuT.mjs';
+export { P as PasskeyProvider, a as PasskeyProviderOptions, c as createPasskeyProvider } from './provider-Dgh51NRc.mjs';
+import { Address, LocalAccount, Chain, Transport, Hex, WalletClient, Hash } from 'viem';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+export { getTokenAddress, getTokenDecimals } from '@rhinestone/sdk';
+
+type PasskeyAccount = LocalAccount<"1auth"> & {
+    username: string;
+};
+declare function createPasskeyAccount(client: PasskeyProviderClient, params: {
+    address: Address;
+    username: string;
+}): PasskeyAccount;
+
+/**
+ * Configuration for creating a passkey-enabled WalletClient
+ */
+interface PasskeyWalletClientConfig {
+    /** User's smart account address */
+    accountAddress: Address;
+    /** Username for the passkey provider */
+    username: string;
+    /** Base URL of the auth API */
+    providerUrl: string;
+    /** Client identifier for this application */
+    clientId: string;
+    /** Optional URL of the dialog UI */
+    dialogUrl?: string;
+    /** Chain configuration */
+    chain: Chain;
+    /** Transport (e.g., http(), webSocket()) */
+    transport: Transport;
+    /** Wait for a transaction hash before resolving send calls. */
+    waitForHash?: boolean;
+    /** Maximum time to wait for a transaction hash in ms. */
+    hashTimeoutMs?: number;
+    /** Poll interval for transaction hash in ms. */
+    hashIntervalMs?: number;
+}
+/**
+ * A single call in a batch transaction
+ */
+interface TransactionCall {
+    /** Target contract address */
+    to: Address;
+    /** Calldata to send */
+    data?: Hex;
+    /** Value in wei to send */
+    value?: bigint;
+    /** Optional label for the transaction review UI (e.g., "Swap ETH for USDC") */
+    label?: string;
+    /** Optional sublabel for additional context (e.g., "1 ETH → 2,500 USDC") */
+    sublabel?: string;
+}
+/**
+ * Parameters for sendCalls (batched transactions)
+ */
+interface SendCallsParams {
+    /** Array of calls to execute */
+    calls: TransactionCall[];
+}
+
+/**
+ * Encode a WebAuthn signature for ERC-1271 verification on-chain
+ *
+ * @param sig - The WebAuthn signature from the passkey
+ * @returns ABI-encoded signature bytes
+ */
+declare function encodeWebAuthnSignature(sig: WebAuthnSignature): Hex;
+/**
+ * Hash an array of transaction calls for signing
+ *
+ * @param calls - Array of transaction calls
+ * @returns keccak256 hash of the encoded calls
+ */
+declare function hashCalls(calls: TransactionCall[]): Hex;
+
+/**
+ * Extended WalletClient with passkey signing and batch transaction support
+ */
+type PasskeyWalletClient = WalletClient & {
+    /**
+     * Send multiple calls as a single batched transaction
+     * Opens the passkey modal for user approval
+     */
+    sendCalls: (params: SendCallsParams) => Promise<Hash>;
+};
+/**
+ * Create a viem-compatible WalletClient that uses passkeys for signing
+ *
+ * @example
+ * ```typescript
+ * import { createPasskeyWalletClient } from '@rhinestone/1auth';
+ * import { baseSepolia } from 'viem/chains';
+ * import { http } from 'viem';
+ *
+ * const walletClient = createPasskeyWalletClient({
+ *   accountAddress: '0x...',
+ *   username: 'alice',
+ *   providerUrl: 'https://auth.example.com',
+ *   clientId: 'my-dapp',
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * // Standard viem API
+ * const hash = await walletClient.sendTransaction({
+ *   to: '0x...',
+ *   data: '0x...',
+ *   value: 0n,
+ * });
+ *
+ * // Batched transactions
+ * const batchHash = await walletClient.sendCalls({
+ *   calls: [
+ *     { to: '0x...', data: '0x...' },
+ *     { to: '0x...', data: '0x...' },
+ *   ],
+ * });
+ * ```
+ */
+declare function createPasskeyWalletClient(config: PasskeyWalletClientConfig): PasskeyWalletClient;
+
+/**
+ * A batched call in the queue
+ */
+interface BatchedCall {
+    /** Unique ID for removal */
+    id: string;
+    /** The actual call data */
+    call: IntentCall;
+    /** Chain ID for execution */
+    targetChain: number;
+    /** Timestamp when added */
+    addedAt: number;
+}
+declare function getChainName(chainId: number): string;
+/**
+ * Batch queue context value
+ */
+interface BatchQueueContextValue {
+    /** Current queue of batched calls */
+    queue: BatchedCall[];
+    /** Chain ID of the current batch (from first call) */
+    batchChainId: number | null;
+    /** Add a call to the batch */
+    addToBatch: (call: IntentCall, targetChain: number) => {
+        success: boolean;
+        error?: string;
+    };
+    /** Remove a call from the batch */
+    removeFromBatch: (id: string) => void;
+    /** Clear all calls from the batch */
+    clearBatch: () => void;
+    /** Sign and execute all batched calls */
+    signAll: (username: string) => Promise<SendIntentResult>;
+    /** Whether the widget is expanded */
+    isExpanded: boolean;
+    /** Set widget expanded state */
+    setExpanded: (expanded: boolean) => void;
+    /** Whether signing is in progress */
+    isSigning: boolean;
+    /** Animation trigger for bounce effect */
+    animationTrigger: number;
+}
+/**
+ * Hook to access the batch queue context
+ */
+declare function useBatchQueue(): BatchQueueContextValue;
+interface BatchQueueProviderProps {
+    /** The PasskeyProviderClient instance */
+    client: PasskeyProviderClient;
+    /** Optional username for localStorage persistence key */
+    username?: string;
+    /** Children to render */
+    children: React.ReactNode;
+}
+/**
+ * Provider component for the batch queue
+ */
+declare function BatchQueueProvider({ client, username, children, }: BatchQueueProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BatchQueueWidgetProps {
+    /** Callback when "Sign All" is clicked - should provide username */
+    onSignAll: () => void;
+}
+/**
+ * Floating widget showing the batch queue
+ */
+declare function BatchQueueWidget({ onSignAll }: BatchQueueWidgetProps): react_jsx_runtime.JSX.Element | null;
+
+type TokenConfig = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+    supportsMultichain?: boolean;
+    [key: string]: unknown;
+};
+type ChainFilterOptions = {
+    includeTestnets?: boolean;
+    chainIds?: number[];
+};
+declare function getSupportedChainIds(options?: ChainFilterOptions): number[];
+declare function getSupportedChains(options?: ChainFilterOptions): Chain[];
+declare function getAllSupportedChainsAndTokens(options?: ChainFilterOptions): Array<{
+    chainId: number;
+    tokens: TokenConfig[];
+}>;
+declare function getChainById(chainId: number): Chain;
+declare function getChainExplorerUrl(chainId: number): string | undefined;
+declare function getChainRpcUrl(chainId: number): string | undefined;
+declare function getSupportedTokens(chainId: number): TokenConfig[];
+declare function getSupportedTokenSymbols(chainId: number): string[];
+declare function resolveTokenAddress(token: string, chainId: number): Address;
+declare function isTestnet(chainId: number): boolean;
+declare function getTokenSymbol(tokenAddress: Address, chainId: number): string;
+declare function isTokenAddressSupported(tokenAddress: Address, chainId: number): boolean;
+
+/**
+ * The domain separator prefix used for passkey message signing.
+ * This ensures message signatures cannot be replayed for transaction signing.
+ */
+declare const PASSKEY_MESSAGE_PREFIX = "\u0019Passkey Signed Message:\n";
+/**
+ * Hash a message with the passkey domain separator.
+ *
+ * This is the same hashing function used by the passkey sign dialog.
+ * Use this to verify that the `signedHash` returned from `signMessage()`
+ * matches your original message.
+ *
+ * Format: keccak256("\x19Passkey Signed Message:\n" + len + message)
+ *
+ * @example
+ * ```typescript
+ * const message = "Sign in to MyApp\nTimestamp: 1234567890";
+ * const result = await client.signMessage({ username: 'alice', message });
+ *
+ * // Verify the hash matches
+ * const expectedHash = hashMessage(message);
+ * if (result.signedHash === expectedHash) {
+ *   console.log('Hash matches - signature is for this message');
+ * }
+ * ```
+ */
+declare function hashMessage(message: string): `0x${string}`;
+/**
+ * Verify that a signedHash matches the expected message.
+ *
+ * This is a convenience wrapper around `hashMessage()` that returns
+ * a boolean. For full cryptographic verification of the P256 signature,
+ * use on-chain verification via the WebAuthn.sol contract.
+ *
+ * @example
+ * ```typescript
+ * const result = await client.signMessage({ username: 'alice', message });
+ *
+ * if (result.success && verifyMessageHash(message, result.signedHash)) {
+ *   // The signature is for this exact message
+ *   // For full verification, verify the P256 signature on-chain or server-side
+ * }
+ * ```
+ */
+declare function verifyMessageHash(message: string, signedHash: string | undefined): boolean;
+
+export { type BatchQueueContextValue, BatchQueueProvider, type BatchQueueProviderProps, BatchQueueWidget, type BatchQueueWidgetProps, type BatchedCall, type ChainFilterOptions, IntentCall, PASSKEY_MESSAGE_PREFIX, type PasskeyAccount, PasskeyProviderClient, type PasskeyWalletClient, type PasskeyWalletClientConfig, type SendCallsParams, SendIntentResult, type TokenConfig, type TransactionCall, WebAuthnSignature, createPasskeyAccount, createPasskeyWalletClient, encodeWebAuthnSignature, getAllSupportedChainsAndTokens, getChainById, getChainExplorerUrl, getChainName, getChainRpcUrl, getSupportedChainIds, getSupportedChains, getSupportedTokenSymbols, getSupportedTokens, getTokenSymbol, hashCalls, hashMessage, isTestnet, isTokenAddressSupported, resolveTokenAddress, useBatchQueue, verifyMessageHash };

package/dist/index.d.ts

@@ -0,0 +1,267 @@
+import { P as PasskeyProviderClient, W as WebAuthnSignature, I as IntentCall, S as SendIntentResult } from './client-C1inywuT.js';
+export { A as AuthenticateOptions, k as AuthenticateResult, B as BalanceRequirement, y as CloseOnStatus, C as CreateSigningRequestResponse, p as EIP712Domain, r as EIP712TypeField, q as EIP712Types, E as EmbedOptions, D as ExecuteIntentResponse, w as IntentQuote, x as IntentStatus, u as IntentTokenRequest, L as LoginOptions, j as LoginResult, M as MerchantSignedIntent, O as OrchestratorStatus, h as PasskeyCredential, a as PasskeyProviderConfig, z as PrepareIntentResponse, R as RegisterOptions, i as RegisterResult, v as SendIntentOptions, F as SendSwapOptions, G as SendSwapResult, l as SignMessageOptions, m as SignMessageResult, n as SignTypedDataOptions, o as SignTypedDataResult, e as SigningError, f as SigningErrorCode, b as SigningRequestOptions, g as SigningRequestStatus, c as SigningResult, d as SigningSuccess, H as SwapQuote, J as ThemeConfig, T as TransactionAction, t as TransactionDetails, s as TransactionFees, U as UserPasskeysResponse } from './client-C1inywuT.js';
+export { P as PasskeyProvider, a as PasskeyProviderOptions, c as createPasskeyProvider } from './provider-q7M728Mn.js';
+import { Address, LocalAccount, Chain, Transport, Hex, WalletClient, Hash } from 'viem';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+export { getTokenAddress, getTokenDecimals } from '@rhinestone/sdk';
+
+type PasskeyAccount = LocalAccount<"1auth"> & {
+    username: string;
+};
+declare function createPasskeyAccount(client: PasskeyProviderClient, params: {
+    address: Address;
+    username: string;
+}): PasskeyAccount;
+
+/**
+ * Configuration for creating a passkey-enabled WalletClient
+ */
+interface PasskeyWalletClientConfig {
+    /** User's smart account address */
+    accountAddress: Address;
+    /** Username for the passkey provider */
+    username: string;
+    /** Base URL of the auth API */
+    providerUrl: string;
+    /** Client identifier for this application */
+    clientId: string;
+    /** Optional URL of the dialog UI */
+    dialogUrl?: string;
+    /** Chain configuration */
+    chain: Chain;
+    /** Transport (e.g., http(), webSocket()) */
+    transport: Transport;
+    /** Wait for a transaction hash before resolving send calls. */
+    waitForHash?: boolean;
+    /** Maximum time to wait for a transaction hash in ms. */
+    hashTimeoutMs?: number;
+    /** Poll interval for transaction hash in ms. */
+    hashIntervalMs?: number;
+}
+/**
+ * A single call in a batch transaction
+ */
+interface TransactionCall {
+    /** Target contract address */
+    to: Address;
+    /** Calldata to send */
+    data?: Hex;
+    /** Value in wei to send */
+    value?: bigint;
+    /** Optional label for the transaction review UI (e.g., "Swap ETH for USDC") */
+    label?: string;
+    /** Optional sublabel for additional context (e.g., "1 ETH → 2,500 USDC") */
+    sublabel?: string;
+}
+/**
+ * Parameters for sendCalls (batched transactions)
+ */
+interface SendCallsParams {
+    /** Array of calls to execute */
+    calls: TransactionCall[];
+}
+
+/**
+ * Encode a WebAuthn signature for ERC-1271 verification on-chain
+ *
+ * @param sig - The WebAuthn signature from the passkey
+ * @returns ABI-encoded signature bytes
+ */
+declare function encodeWebAuthnSignature(sig: WebAuthnSignature): Hex;
+/**
+ * Hash an array of transaction calls for signing
+ *
+ * @param calls - Array of transaction calls
+ * @returns keccak256 hash of the encoded calls
+ */
+declare function hashCalls(calls: TransactionCall[]): Hex;
+
+/**
+ * Extended WalletClient with passkey signing and batch transaction support
+ */
+type PasskeyWalletClient = WalletClient & {
+    /**
+     * Send multiple calls as a single batched transaction
+     * Opens the passkey modal for user approval
+     */
+    sendCalls: (params: SendCallsParams) => Promise<Hash>;
+};
+/**
+ * Create a viem-compatible WalletClient that uses passkeys for signing
+ *
+ * @example
+ * ```typescript
+ * import { createPasskeyWalletClient } from '@rhinestone/1auth';
+ * import { baseSepolia } from 'viem/chains';
+ * import { http } from 'viem';
+ *
+ * const walletClient = createPasskeyWalletClient({
+ *   accountAddress: '0x...',
+ *   username: 'alice',
+ *   providerUrl: 'https://auth.example.com',
+ *   clientId: 'my-dapp',
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * // Standard viem API
+ * const hash = await walletClient.sendTransaction({
+ *   to: '0x...',
+ *   data: '0x...',
+ *   value: 0n,
+ * });
+ *
+ * // Batched transactions
+ * const batchHash = await walletClient.sendCalls({
+ *   calls: [
+ *     { to: '0x...', data: '0x...' },
+ *     { to: '0x...', data: '0x...' },
+ *   ],
+ * });
+ * ```
+ */
+declare function createPasskeyWalletClient(config: PasskeyWalletClientConfig): PasskeyWalletClient;
+
+/**
+ * A batched call in the queue
+ */
+interface BatchedCall {
+    /** Unique ID for removal */
+    id: string;
+    /** The actual call data */
+    call: IntentCall;
+    /** Chain ID for execution */
+    targetChain: number;
+    /** Timestamp when added */
+    addedAt: number;
+}
+declare function getChainName(chainId: number): string;
+/**
+ * Batch queue context value
+ */
+interface BatchQueueContextValue {
+    /** Current queue of batched calls */
+    queue: BatchedCall[];
+    /** Chain ID of the current batch (from first call) */
+    batchChainId: number | null;
+    /** Add a call to the batch */
+    addToBatch: (call: IntentCall, targetChain: number) => {
+        success: boolean;
+        error?: string;
+    };
+    /** Remove a call from the batch */
+    removeFromBatch: (id: string) => void;
+    /** Clear all calls from the batch */
+    clearBatch: () => void;
+    /** Sign and execute all batched calls */
+    signAll: (username: string) => Promise<SendIntentResult>;
+    /** Whether the widget is expanded */
+    isExpanded: boolean;
+    /** Set widget expanded state */
+    setExpanded: (expanded: boolean) => void;
+    /** Whether signing is in progress */
+    isSigning: boolean;
+    /** Animation trigger for bounce effect */
+    animationTrigger: number;
+}
+/**
+ * Hook to access the batch queue context
+ */
+declare function useBatchQueue(): BatchQueueContextValue;
+interface BatchQueueProviderProps {
+    /** The PasskeyProviderClient instance */
+    client: PasskeyProviderClient;
+    /** Optional username for localStorage persistence key */
+    username?: string;
+    /** Children to render */
+    children: React.ReactNode;
+}
+/**
+ * Provider component for the batch queue
+ */
+declare function BatchQueueProvider({ client, username, children, }: BatchQueueProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BatchQueueWidgetProps {
+    /** Callback when "Sign All" is clicked - should provide username */
+    onSignAll: () => void;
+}
+/**
+ * Floating widget showing the batch queue
+ */
+declare function BatchQueueWidget({ onSignAll }: BatchQueueWidgetProps): react_jsx_runtime.JSX.Element | null;
+
+type TokenConfig = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+    supportsMultichain?: boolean;
+    [key: string]: unknown;
+};
+type ChainFilterOptions = {
+    includeTestnets?: boolean;
+    chainIds?: number[];
+};
+declare function getSupportedChainIds(options?: ChainFilterOptions): number[];
+declare function getSupportedChains(options?: ChainFilterOptions): Chain[];
+declare function getAllSupportedChainsAndTokens(options?: ChainFilterOptions): Array<{
+    chainId: number;
+    tokens: TokenConfig[];
+}>;
+declare function getChainById(chainId: number): Chain;
+declare function getChainExplorerUrl(chainId: number): string | undefined;
+declare function getChainRpcUrl(chainId: number): string | undefined;
+declare function getSupportedTokens(chainId: number): TokenConfig[];
+declare function getSupportedTokenSymbols(chainId: number): string[];
+declare function resolveTokenAddress(token: string, chainId: number): Address;
+declare function isTestnet(chainId: number): boolean;
+declare function getTokenSymbol(tokenAddress: Address, chainId: number): string;
+declare function isTokenAddressSupported(tokenAddress: Address, chainId: number): boolean;
+
+/**
+ * The domain separator prefix used for passkey message signing.
+ * This ensures message signatures cannot be replayed for transaction signing.
+ */
+declare const PASSKEY_MESSAGE_PREFIX = "\u0019Passkey Signed Message:\n";
+/**
+ * Hash a message with the passkey domain separator.
+ *
+ * This is the same hashing function used by the passkey sign dialog.
+ * Use this to verify that the `signedHash` returned from `signMessage()`
+ * matches your original message.
+ *
+ * Format: keccak256("\x19Passkey Signed Message:\n" + len + message)
+ *
+ * @example
+ * ```typescript
+ * const message = "Sign in to MyApp\nTimestamp: 1234567890";
+ * const result = await client.signMessage({ username: 'alice', message });
+ *
+ * // Verify the hash matches
+ * const expectedHash = hashMessage(message);
+ * if (result.signedHash === expectedHash) {
+ *   console.log('Hash matches - signature is for this message');
+ * }
+ * ```
+ */
+declare function hashMessage(message: string): `0x${string}`;
+/**
+ * Verify that a signedHash matches the expected message.
+ *
+ * This is a convenience wrapper around `hashMessage()` that returns
+ * a boolean. For full cryptographic verification of the P256 signature,
+ * use on-chain verification via the WebAuthn.sol contract.
+ *
+ * @example
+ * ```typescript
+ * const result = await client.signMessage({ username: 'alice', message });
+ *
+ * if (result.success && verifyMessageHash(message, result.signedHash)) {
+ *   // The signature is for this exact message
+ *   // For full verification, verify the P256 signature on-chain or server-side
+ * }
+ * ```
+ */
+declare function verifyMessageHash(message: string, signedHash: string | undefined): boolean;
+
+export { type BatchQueueContextValue, BatchQueueProvider, type BatchQueueProviderProps, BatchQueueWidget, type BatchQueueWidgetProps, type BatchedCall, type ChainFilterOptions, IntentCall, PASSKEY_MESSAGE_PREFIX, type PasskeyAccount, PasskeyProviderClient, type PasskeyWalletClient, type PasskeyWalletClientConfig, type SendCallsParams, SendIntentResult, type TokenConfig, type TransactionCall, WebAuthnSignature, createPasskeyAccount, createPasskeyWalletClient, encodeWebAuthnSignature, getAllSupportedChainsAndTokens, getChainById, getChainExplorerUrl, getChainName, getChainRpcUrl, getSupportedChainIds, getSupportedChains, getSupportedTokenSymbols, getSupportedTokens, getTokenSymbol, hashCalls, hashMessage, isTestnet, isTokenAddressSupported, resolveTokenAddress, useBatchQueue, verifyMessageHash };