@buildersgarden/siwa 0.0.19 → 0.0.20

package/dist/addresses.js

@@ -8,6 +8,7 @@
 // Identity Registries
 // ---------------------------------------------------------------------------
 export const REGISTRY_ADDRESSES = {
+    1: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432', // Ethereum
     8453: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432', // Base
     84532: '0x8004A818BFB912233c491871b3d84c89A494BD9e', // Base Sepolia
     11155111: '0x8004a6090Cd10A7288092483047B097295Fb8847', // ETH Sepolia
@@ -18,6 +19,7 @@ export const REGISTRY_ADDRESSES = {
 // Reputation Registries
 // ---------------------------------------------------------------------------
 export const REPUTATION_ADDRESSES = {
+    1: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63', // Ethereum
     8453: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63', // Base
     84532: '0x8004B663056A597Dffe9eCcC1965A193B7388713', // Base Sepolia
 };
@@ -25,6 +27,7 @@ export const REPUTATION_ADDRESSES = {
 // RPC Endpoints (public, rate-limited)
 // ---------------------------------------------------------------------------
 export const RPC_ENDPOINTS = {
+    1: 'https://cloudflare-eth.com',
     8453: 'https://mainnet.base.org',
     84532: 'https://sepolia.base.org',
     11155111: 'https://rpc.sepolia.org',
@@ -35,6 +38,7 @@ export const RPC_ENDPOINTS = {
 // Chain Names
 // ---------------------------------------------------------------------------
 export const CHAIN_NAMES = {
+    1: 'Ethereum',
     8453: 'Base',
     84532: 'Base Sepolia',
     11155111: 'Ethereum Sepolia',
@@ -54,6 +58,7 @@ export const FAUCETS = {
 // Block Explorers
 // ---------------------------------------------------------------------------
 export const BLOCK_EXPLORERS = {
+    1: 'https://etherscan.io',
     8453: 'https://basescan.org',
     84532: 'https://sepolia.basescan.org',
     11155111: 'https://sepolia.etherscan.io',

package/dist/client-resolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * client-resolver.ts
+ *
+ * Dynamic PublicClient resolution for multi-chain SIWA servers.
+ * Lazily creates and caches viem PublicClient instances per chain ID.
+ */
+import { type PublicClient } from 'viem';
+export interface ClientResolverOptions {
+    /** Explicit RPC URL overrides per chain ID. */
+    rpcOverrides?: Record<number, string>;
+    /** Restrict which chain IDs are accepted. When set, only these chains can be resolved. */
+    allowedChainIds?: number[];
+}
+export interface ClientResolver {
+    /** Get (or lazily create) a PublicClient for the given chain ID. Throws if unsupported. */
+    getClient(chainId: number): PublicClient;
+    /** Check whether a chain ID can be resolved. */
+    isSupported(chainId: number): boolean;
+    /** List all chain IDs that can be resolved. */
+    supportedChainIds(): number[];
+}
+/**
+ * Extract the chain ID from an `eip155:{chainId}:{address}` agent registry string.
+ * Returns `null` if the format is invalid.
+ */
+export declare function parseChainId(agentRegistry: string): number | null;
+/**
+ * Create a ClientResolver that lazily creates and caches PublicClient instances.
+ *
+ * RPC resolution order:
+ * 1. Explicit `rpcOverrides` map
+ * 2. Environment variable `RPC_URL_{chainId}` (e.g. `RPC_URL_42161`)
+ * 3. Built-in `RPC_ENDPOINTS` from addresses.ts
+ * 4. Throw with a helpful error listing supported chains
+ */
+export declare function createClientResolver(options?: ClientResolverOptions): ClientResolver;

package/dist/client-resolver.js

@@ -0,0 +1,92 @@
+/**
+ * client-resolver.ts
+ *
+ * Dynamic PublicClient resolution for multi-chain SIWA servers.
+ * Lazily creates and caches viem PublicClient instances per chain ID.
+ */
+import { createPublicClient, http } from 'viem';
+import { RPC_ENDPOINTS, CHAIN_NAMES } from './addresses.js';
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Extract the chain ID from an `eip155:{chainId}:{address}` agent registry string.
+ * Returns `null` if the format is invalid.
+ */
+export function parseChainId(agentRegistry) {
+    const parts = agentRegistry.split(':');
+    if (parts.length !== 3 || parts[0] !== 'eip155')
+        return null;
+    const id = parseInt(parts[1], 10);
+    return Number.isFinite(id) ? id : null;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+/**
+ * Create a ClientResolver that lazily creates and caches PublicClient instances.
+ *
+ * RPC resolution order:
+ * 1. Explicit `rpcOverrides` map
+ * 2. Environment variable `RPC_URL_{chainId}` (e.g. `RPC_URL_42161`)
+ * 3. Built-in `RPC_ENDPOINTS` from addresses.ts
+ * 4. Throw with a helpful error listing supported chains
+ */
+export function createClientResolver(options) {
+    const cache = new Map();
+    const overrides = options?.rpcOverrides ?? {};
+    const allowed = options?.allowedChainIds
+        ? new Set(options.allowedChainIds)
+        : null;
+    function resolveRpcUrl(chainId) {
+        // 1. Explicit override
+        if (overrides[chainId])
+            return overrides[chainId];
+        // 2. Environment variable
+        const envKey = `RPC_URL_${chainId}`;
+        const envVal = typeof process !== 'undefined' ? process.env?.[envKey] : undefined;
+        if (envVal)
+            return envVal;
+        // 3. Built-in defaults
+        if (RPC_ENDPOINTS[chainId])
+            return RPC_ENDPOINTS[chainId];
+        // 4. Not found
+        const supported = getSupportedChainIds();
+        const names = supported.map((id) => `${id} (${CHAIN_NAMES[id] || 'unknown'})`).join(', ');
+        throw new Error(`No RPC endpoint for chain ${chainId}. Supported chains: ${names}. ` +
+            `Set RPC_URL_${chainId} or pass rpcOverrides to createClientResolver().`);
+    }
+    function getSupportedChainIds() {
+        const ids = new Set([
+            ...Object.keys(overrides).map(Number),
+            ...Object.keys(RPC_ENDPOINTS).map(Number),
+        ]);
+        if (allowed) {
+            return [...ids].filter((id) => allowed.has(id));
+        }
+        return [...ids];
+    }
+    return {
+        getClient(chainId) {
+            if (allowed && !allowed.has(chainId)) {
+                const names = [...allowed].map((id) => `${id} (${CHAIN_NAMES[id] || 'unknown'})`).join(', ');
+                throw new Error(`Chain ${chainId} is not in the allowed list. Allowed: ${names}`);
+            }
+            let client = cache.get(chainId);
+            if (!client) {
+                const rpcUrl = resolveRpcUrl(chainId);
+                client = createPublicClient({ transport: http(rpcUrl) });
+                cache.set(chainId, client);
+            }
+            return client;
+        },
+        isSupported(chainId) {
+            if (allowed && !allowed.has(chainId))
+                return false;
+            try {
+                resolveRpcUrl(chainId);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        supportedChainIds: getSupportedChainIds,
+    };
+}

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export * from './erc8128.js';
 export * from './nonce-store.js';
 export * from './tba.js';
 export * from './x402.js';
+export * from './client-resolver.js';

package/dist/index.js

@@ -10,3 +10,4 @@ export * from './erc8128.js';
 export * from './nonce-store.js';
 export * from './tba.js';
 export * from './x402.js';
+export * from './client-resolver.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildersgarden/siwa",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "type": "module",
   "exports": {
     ".": {
@@ -70,6 +70,10 @@
     "./x402": {
       "types": "./dist/x402.d.ts",
       "default": "./dist/x402.js"
+    },
+    "./client-resolver": {
+      "types": "./dist/client-resolver.d.ts",
+      "default": "./dist/client-resolver.js"
     }
   },
   "main": "./dist/index.js",