@seapay-ai/erc3009 0.1.0 → 0.2.0

package/README.md

@@ -1,80 +1,286 @@
 # @seapay-ai/erc3009
 
-TypeScript utilities for ERC-3009 (Transfer With Authorization) EIP-712 signing.
+Simplified TypeScript library for ERC-3009 (TransferWithAuthorization) EIP-712 signing and verification.
 
 ## Installation
 
 ```bash
-npm install @seapay-ai/erc3009
-# or
 pnpm add @seapay-ai/erc3009
 # or
-yarn add @seapay-ai/erc3009
+npm install @seapay-ai/erc3009
 ```
 
-## Usage
-
-### Basic Example
+## Quick Start
 
 ```typescript
+import {
+  buildTypedData,
+  buildMessage,
+  resolveDomain,
+  nowPlusSeconds,
+} from "@seapay-ai/erc3009";
 import { Wallet } from "ethers";
+
+// 1. Build the message
+const message = buildMessage({
+  from: wallet.address,
+  to: "0xRecipient...",
+  value: 1000000n, // 1 USDC (6 decimals)
+  validBefore: nowPlusSeconds(300), // Valid for 5 minutes
+});
+
+// 2. Build typed data (includes domain resolution from registry)
+const {
+  domain,
+  types,
+  message: msg,
+} = buildTypedData({
+  chainId: 8453, // Base mainnet
+  token: "USDC",
+  message,
+});
+
+// 3. Sign with ethers wallet
+const signature = await wallet.signTypedData(domain, types, msg);
+```
+
+## Core Functions
+
+### 1. Build Message
+
+```typescript
+import { buildMessage, nowPlusSeconds, randomNonce } from "@seapay-ai/erc3009";
+
+const message = buildMessage({
+  from: "0xSender...",
+  to: "0xRecipient...",
+  value: 1000000n, // Amount in token's smallest unit
+  validAfter: 0n, // Optional, defaults to 0
+  validBefore: nowPlusSeconds(300), // Unix timestamp
+  nonce: randomNonce(), // Optional, auto-generated if not provided
+});
+```
+
+### 2. Build Typed Data
+
+Automatically resolves token info from the registry:
+
+```typescript
+import { buildTypedData } from "@seapay-ai/erc3009";
+
+const typedData = buildTypedData({
+  chainId: 8453, // Base mainnet
+  token: "USDC", // Symbol from registry
+  message,
+});
+
+// Returns:
+// {
+//   domain: { name, version, chainId, verifyingContract },
+//   types: { TransferWithAuthorization: [...] },
+//   message: { from, to, value, ... },
+//   primaryType: "TransferWithAuthorization"
+// }
+```
+
+For custom tokens not in the registry:
+
+```typescript
+const typedData = buildTypedData({
+  chainId: 8453,
+  token: "0xCustomTokenAddress",
+  message,
+  domainOverrides: {
+    name: "My Token",
+    version: "1",
+    verifyingContract: "0xCustomTokenAddress",
+  },
+});
+```
+
+### 3. Resolve Domain
+
+Resolve EIP-712 domain from chain ID and token:
+
+```typescript
+import { resolveDomain } from "@seapay-ai/erc3009";
+
+// Resolve USDC domain on Base
+const domain = resolveDomain(8453, "USDC");
+// Returns:
+// {
+//   name: "USD Coin",
+//   version: "2",
+//   chainId: 8453,
+//   verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+// }
+
+// For custom tokens
+const customDomain = resolveDomain(8453, "0xCustomTokenAddress", {
+  name: "My Token",
+  version: "1",
+  verifyingContract: "0xCustomTokenAddress",
+});
+```
+
+This function is useful when you need just the domain object without building the complete typed data structure. It's used internally by `buildTypedData`.
+
+### 4. Verify Signature
+
+```typescript
+import { verifySignature, recoverSigner } from "@seapay-ai/erc3009";
+
+// Verify signature matches expected signer
+const isValid = verifySignature(domain, message, signature, expectedSigner);
+
+// Or recover the signer address
+const signer = recoverSigner(domain, message, signature);
+console.log("Signed by:", signer);
+```
+
+## Registry
+
+The package includes a built-in registry of USDC deployments across multiple chains.
+
+### Query the Registry
+
+```typescript
+import { registry, getTokenInfo } from "@seapay-ai/erc3009";
+
+// Get token config
+const usdcBase = registry.getToken("USDC", 8453);
+// => { symbol: "USDC", chainId: 8453, address: "0x...", name: "USD Coin", version: "2", decimals: 6 }
+
+// Check if token is supported
+if (registry.isSupported("USDC", 8453)) {
+  console.log("USDC supported on Base");
+}
+
+// List all chains
+const chains = registry.listChains();
+
+// List tokens on a chain
+const tokens = registry.listTokensOnChain(8453);
+
+// Get chain info
+const baseChain = registry.getChain(8453);
+// => { chainId: 8453, name: "Base", testnet: false }
+```
+
+### Supported Chains
+
+| Chain            | Chain ID | Testnet |
+| ---------------- | -------- | ------- |
+| Ethereum         | 1        | -       |
+| Sepolia          | 11155111 | ✅      |
+| Base             | 8453     | -       |
+| Base Sepolia     | 84532    | ✅      |
+| Arbitrum One     | 42161    | -       |
+| Arbitrum Sepolia | 421614   | ✅      |
+| Optimism         | 10       | -       |
+| Optimism Sepolia | 11155420 | ✅      |
+| Polygon          | 137      | -       |
+| Polygon Amoy     | 80002    | ✅      |
+
+### Supported Tokens
+
+Currently includes **USDC** on all chains above.
+
+### ⚠️ Important: Base Network Domain Names
+
+USDC has **different EIP-712 domain names** on Base networks:
+
+| Network      | Chain ID | Domain Name  |
+| ------------ | -------- | ------------ |
+| Base Mainnet | 8453     | `"USD Coin"` |
+| Base Sepolia | 84532    | `"USDC"`     |
+
+The registry handles this automatically. Always use the registry to ensure correct domain parameters.
+
+## Complete Example
+
+```typescript
 import {
   buildTypedData,
-  buildTypes,
-  message_5_minutes,
-  signTransferWithAuthorization,
-  type EIP712Domain,
-  type TransferWithAuthorization,
+  buildMessage,
+  nowPlusSeconds,
+  verifySignature,
 } from "@seapay-ai/erc3009";
+import { Wallet } from "ethers";
 
-// Create a wallet
+// Create wallet
 const wallet = new Wallet("0x...");
 
-// Define the token domain (EIP-712 domain)
-const domain: EIP712Domain = {
-  name: "USD Coin",
-  version: "2",
+// Build message
+const message = buildMessage({
+  from: wallet.address,
+  to: "0xRecipient...",
+  value: 1000000n, // 1 USDC
+  validBefore: nowPlusSeconds(300), // 5 minutes
+});
+
+// Build typed data
+const {
+  domain,
+  types,
+  message: msg,
+} = buildTypedData({
   chainId: 84532, // Base Sepolia
-  verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
-};
-
-// Create a transfer authorization message
-const message = message_5_minutes(
-  wallet.address, // from
-  "0x...", // to
-  BigInt("1000000") // value (1 USDC if 6 decimals)
-);
-
-// Sign the authorization
-const signature = await signTransferWithAuthorization(wallet, domain, message);
-
-// Or build typed data manually
-const typedData = buildTypedData({ domain, message });
-const types = buildTypes();
-// Use with wallet.signTypedData(typedData.domain, types, typedData.message)
+  token: "USDC",
+  message,
+});
+
+// Sign
+const signature = await wallet.signTypedData(domain, types, msg);
+
+// Verify
+const isValid = verifySignature(domain, message, signature, wallet.address);
+console.log("Signature valid:", isValid);
 ```
 
-### API Reference
+## API Reference
 
-#### Types
+### Build Functions
 
-- `TransferWithAuthorization`: The message structure for ERC-3009 transfers
-- `EIP712Domain`: The EIP-712 domain structure
+- **`buildMessage(params)`** - Create TransferWithAuthorization message
+- **`buildTypedData(params)`** - Create complete EIP-712 typed data with domain resolution
 
-#### Functions
+### Domain Resolution
 
-- `buildDomain(domain: EIP712Domain)`: Converts EIP712Domain to TypedDataDomain
-- `buildTypes()`: Returns the EIP-712 types for TransferWithAuthorization
-- `buildMessage(message: TransferWithAuthorization)`: Normalizes message values
-- `buildTypedData(params)`: Builds complete typed data for signing
-- `signTransferWithAuthorization(wallet, domain, message)`: Convenience function to sign
-- `message_5_minutes(from, to, value)`: Creates a message valid for 5 minutes
-- `USDC_Domain()`: Returns USDC domain for Base Sepolia (example)
+- **`resolveDomain(chainId, token, domainOverrides?)`** - Resolve EIP-712 domain from chain and token
 
-## Requirements
+### Verification Functions
 
-- Node.js 18+
-- ethers v6
+- **`verifySignature(domain, message, signature, expectedSigner)`** - Verify signature
+- **`recoverSigner(domain, message, signature)`** - Recover signer address
+
+### Registry Functions
+
+- **`getTokenInfo(symbol, chainId)`** - Get token configuration
+- **`registry.getToken(symbol, chainId)`** - Get token config
+- **`registry.getChain(chainId)`** - Get chain config
+- **`registry.listChains()`** - List all chains
+- **`registry.listChainIds()`** - List all chain IDs
+- **`registry.isSupported(symbol, chainId)`** - Check if token is supported
+- **`registry.listTokensOnChain(chainId)`** - List tokens on a chain
+
+### Utility Functions
+
+- **`randomNonce()`** - Generate random bytes32 nonce
+- **`nowPlusSeconds(seconds)`** - Get Unix timestamp N seconds from now
+- **`nowSeconds()`** - Get current Unix timestamp
+
+## TypeScript Types
+
+```typescript
+import type {
+  TransferWithAuthorization,
+  EIP712Domain,
+  TypedData,
+  TokenConfig,
+  ChainConfig,
+} from "@seapay-ai/erc3009";
+```
 
 ## License
 

package/dist/build.d.ts

@@ -0,0 +1,27 @@
+import type { TransferWithAuthorization, EIP712Domain, TypedData } from "./types/index.js";
+/**
+ * Build TransferWithAuthorization message
+ */
+export declare function buildMessage(params: {
+    from: string;
+    to: string;
+    value: bigint;
+    validAfter?: bigint;
+    validBefore: bigint;
+    nonce?: string;
+}): TransferWithAuthorization;
+/**
+ * Build complete EIP-712 typed data for signing
+ *
+ * @param chainId - Chain ID (e.g. 8453 for Base)
+ * @param token - Token symbol (e.g. "USDC") or contract address
+ * @param message - TransferWithAuthorization message
+ * @param domainOverrides - Optional domain parameter overrides for custom tokens
+ */
+export declare function buildTypedData(params: {
+    chainId: number;
+    token: string;
+    message: TransferWithAuthorization;
+    domainOverrides?: Partial<EIP712Domain>;
+}): TypedData;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,YAAY,EACZ,SAAS,EACV,MAAM,kBAAkB,CAAC;AAgB1B;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,yBAAyB,CAS5B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,yBAAyB,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACzC,GAAG,SAAS,CAcZ"}

package/dist/build.js

@@ -0,0 +1,47 @@
+import { randomNonce } from "./utils.js";
+import { resolveDomain } from "./domain.js";
+/**
+ * ERC-3009 TransferWithAuthorization type definition
+ */
+const TRANSFER_WITH_AUTHORIZATION_TYPE = [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" },
+];
+/**
+ * Build TransferWithAuthorization message
+ */
+export function buildMessage(params) {
+    return {
+        from: params.from,
+        to: params.to,
+        value: params.value,
+        validAfter: params.validAfter ?? 0n,
+        validBefore: params.validBefore,
+        nonce: params.nonce ?? randomNonce(),
+    };
+}
+/**
+ * Build complete EIP-712 typed data for signing
+ *
+ * @param chainId - Chain ID (e.g. 8453 for Base)
+ * @param token - Token symbol (e.g. "USDC") or contract address
+ * @param message - TransferWithAuthorization message
+ * @param domainOverrides - Optional domain parameter overrides for custom tokens
+ */
+export function buildTypedData(params) {
+    const { chainId, token, message, domainOverrides } = params;
+    // Resolve domain using the resolveDomain function
+    const domain = resolveDomain(chainId, token, domainOverrides);
+    return {
+        domain,
+        types: {
+            TransferWithAuthorization: TRANSFER_WITH_AUTHORIZATION_TYPE,
+        },
+        message,
+        primaryType: "TransferWithAuthorization",
+    };
+}

package/dist/domain.d.ts

@@ -0,0 +1,29 @@
+import type { EIP712Domain } from "./types/index.js";
+/**
+ * Resolve EIP-712 domain from chain ID and token
+ *
+ * @param chainId - Chain ID (e.g. 8453 for Base)
+ * @param token - Token symbol (e.g. "USDC") or contract address (0x...)
+ * @param domainOverrides - Optional domain parameter overrides for custom tokens
+ * @returns EIP-712 Domain object
+ *
+ * @example
+ * // Resolve USDC on Base
+ * const domain = resolveDomain(8453, "USDC");
+ * // Returns:
+ * // {
+ * //   name: "USD Coin",
+ * //   version: "2",
+ * //   chainId: 8453,
+ * //   verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+ * // }
+ *
+ * @example
+ * // Resolve custom token with overrides
+ * const domain = resolveDomain(8453, "0x123...", {
+ *   name: "My Token",
+ *   version: "1"
+ * });
+ */
+export declare function resolveDomain(chainId: number, token: string, domainOverrides?: Partial<EIP712Domain>): EIP712Domain;
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACtC,YAAY,CAmCd"}

package/dist/domain.js

@@ -0,0 +1,57 @@
+import { getTokenInfo } from "./registry.js";
+/**
+ * Resolve EIP-712 domain from chain ID and token
+ *
+ * @param chainId - Chain ID (e.g. 8453 for Base)
+ * @param token - Token symbol (e.g. "USDC") or contract address (0x...)
+ * @param domainOverrides - Optional domain parameter overrides for custom tokens
+ * @returns EIP-712 Domain object
+ *
+ * @example
+ * // Resolve USDC on Base
+ * const domain = resolveDomain(8453, "USDC");
+ * // Returns:
+ * // {
+ * //   name: "USD Coin",
+ * //   version: "2",
+ * //   chainId: 8453,
+ * //   verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+ * // }
+ *
+ * @example
+ * // Resolve custom token with overrides
+ * const domain = resolveDomain(8453, "0x123...", {
+ *   name: "My Token",
+ *   version: "1"
+ * });
+ */
+export function resolveDomain(chainId, token, domainOverrides) {
+    let domain;
+    if (token.startsWith("0x")) {
+        // Custom token address - use overrides or fail
+        if (!domainOverrides?.name || !domainOverrides?.verifyingContract) {
+            throw new Error("Custom token address requires domain overrides (name, verifyingContract)");
+        }
+        domain = {
+            name: domainOverrides.name,
+            version: domainOverrides.version ?? "1",
+            chainId,
+            verifyingContract: domainOverrides.verifyingContract,
+        };
+    }
+    else {
+        // Try registry lookup
+        const tokenInfo = getTokenInfo(token, chainId);
+        if (!tokenInfo) {
+            throw new Error(`Token ${token} not found in registry for chain ${chainId}. Use domainOverrides for custom tokens.`);
+        }
+        domain = {
+            name: tokenInfo.name,
+            version: tokenInfo.version,
+            chainId: tokenInfo.chainId,
+            verifyingContract: tokenInfo.address,
+            ...domainOverrides, // Allow overriding registry values
+        };
+    }
+    return domain;
+}

package/dist/index.d.ts

@@ -1,38 +1,13 @@
-import { type TypedDataDomain, type TypedDataField, Wallet } from "ethers";
-export type TransferWithAuthorization = {
-    from: string;
-    to: string;
-    value: bigint;
-    validAfter: bigint;
-    validBefore: bigint;
-    nonce: string;
-};
-export type EIP712Domain = {
-    name: string;
-    version: string;
-    chainId: bigint | number;
-    verifyingContract: string;
-};
-export declare const TRANSFER_WITH_AUTHORIZATION_TYPE = "TransferWithAuthorization";
-export declare function buildDomain(domain: EIP712Domain): TypedDataDomain;
-export declare function USDC_Domain(): EIP712Domain;
-export declare function message_5_minutes(from: string, to: string, value: bigint): TransferWithAuthorization;
-export declare function buildTypes(): Record<string, TypedDataField[]>;
-export declare function buildMessage(message: TransferWithAuthorization): TransferWithAuthorization;
 /**
- * Produce the parameters needed for EIP-712 signing (domain, types, message).
+ * @seapay-ai/erc3009
+ *
+ * Simplified ERC-3009 (TransferWithAuthorization) library
+ * for building, signing, and verifying EIP-712 typed data.
  */
-export declare function buildTypedData(params: {
-    domain: EIP712Domain;
-    message: TransferWithAuthorization;
-}): {
-    domain: TypedDataDomain;
-    types: Record<string, TypedDataField[]>;
-    message: TransferWithAuthorization;
-};
-/**
- * Convenience helper to sign the ERC-3009 TransferWithAuthorization payload.
- * Requires an ethers Wallet (or Signer with signTypedData support).
- */
-export declare function signTransferWithAuthorization(wallet: Wallet, domain: EIP712Domain, message: TransferWithAuthorization): Promise<string>;
+export type { TransferWithAuthorization, EIP712Domain, TokenConfig, ChainConfig, } from "./types/index.js";
+export { registry, getTokenInfo } from "./registry.js";
+export { resolveDomain } from "./domain.js";
+export { buildTypedData, buildMessage } from "./build.js";
+export { verifySignature, recoverSigner } from "./verify.js";
+export { randomNonce, nowPlusSeconds } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,EACP,MAAM,QAAQ,CAAC;AAEhB,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAWF,eAAO,MAAM,gCAAgC,8BAA8B,CAAC;AAE5E,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAOjE;AAED,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,yBAAyB,CAS3B;AAED,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAI7D;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,yBAAyB,GACjC,yBAAyB,CAO3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,yBAAyB,CAAC;CACpC,GAAG;IACF,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACxC,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAMA;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,yBAAyB,EACzB,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,67 +1,16 @@
-import { randomBytes, hexlify, } from "ethers";
-const TRANSFER_WITH_AUTHORIZATION_FIELDS = [
-    { name: "from", type: "address" },
-    { name: "to", type: "address" },
-    { name: "value", type: "uint256" },
-    { name: "validAfter", type: "uint256" },
-    { name: "validBefore", type: "uint256" },
-    { name: "nonce", type: "bytes32" },
-];
-export const TRANSFER_WITH_AUTHORIZATION_TYPE = "TransferWithAuthorization";
-export function buildDomain(domain) {
-    return {
-        name: domain.name,
-        version: domain.version,
-        chainId: domain.chainId,
-        verifyingContract: domain.verifyingContract,
-    };
-}
-export function USDC_Domain() {
-    return {
-        name: "USD Coin",
-        version: "2",
-        chainId: 84532,
-        verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
-    };
-}
-export function message_5_minutes(from, to, value) {
-    return {
-        from: from,
-        to: to,
-        value: value,
-        validAfter: 0n,
-        validBefore: BigInt(Math.floor(Date.now() / 1000) + 300),
-        nonce: hexlify(randomBytes(32)),
-    };
-}
-export function buildTypes() {
-    return {
-        [TRANSFER_WITH_AUTHORIZATION_TYPE]: TRANSFER_WITH_AUTHORIZATION_FIELDS,
-    };
-}
-export function buildMessage(message) {
-    return {
-        ...message,
-        value: BigInt(message.value),
-        validAfter: BigInt(message.validAfter),
-        validBefore: BigInt(message.validBefore),
-    };
-}
 /**
- * Produce the parameters needed for EIP-712 signing (domain, types, message).
+ * @seapay-ai/erc3009
+ *
+ * Simplified ERC-3009 (TransferWithAuthorization) library
+ * for building, signing, and verifying EIP-712 typed data.
  */
-export function buildTypedData(params) {
-    return {
-        domain: buildDomain(params.domain),
-        types: buildTypes(),
-        message: buildMessage(params.message),
-    };
-}
-/**
- * Convenience helper to sign the ERC-3009 TransferWithAuthorization payload.
- * Requires an ethers Wallet (or Signer with signTypedData support).
- */
-export async function signTransferWithAuthorization(wallet, domain, message) {
-    const typed = buildTypedData({ domain, message });
-    return await wallet.signTypedData(typed.domain, typed.types, typed.message);
-}
+// === Registry ===
+export { registry, getTokenInfo } from "./registry.js";
+// === Domain Resolution ===
+export { resolveDomain } from "./domain.js";
+// === Build Functions ===
+export { buildTypedData, buildMessage } from "./build.js";
+// === Verify Functions ===
+export { verifySignature, recoverSigner } from "./verify.js";
+// === Utils ===
+export { randomNonce, nowPlusSeconds } from "./utils.js";

package/dist/registry.d.ts

@@ -0,0 +1,44 @@
+import type { TokenConfig, ChainConfig } from "./types/index.js";
+/**
+ * Chain registry - supported chains
+ */
+export declare const CHAINS: Record<number, ChainConfig>;
+/**
+ * Token registry - USDC addresses and domain parameters per chain
+ * Note: Base mainnet uses "USD Coin" while Base Sepolia uses "USDC"
+ */
+export declare const TOKENS: Record<string, Record<number, TokenConfig>>;
+/**
+ * Get token information for a given chain
+ */
+export declare function getTokenInfo(tokenSymbol: string, chainId: number): TokenConfig | null;
+/**
+ * Registry utilities
+ */
+export declare const registry: {
+    /**
+     * Get token configuration
+     */
+    readonly getToken: (symbol: string, chainId: number) => TokenConfig | null;
+    /**
+     * Get chain configuration
+     */
+    readonly getChain: (chainId: number) => ChainConfig | null;
+    /**
+     * List all supported chains
+     */
+    readonly listChains: () => ChainConfig[];
+    /**
+     * List all supported chain IDs
+     */
+    readonly listChainIds: () => number[];
+    /**
+     * Check if a token is supported on a chain
+     */
+    readonly isSupported: (symbol: string, chainId: number) => boolean;
+    /**
+     * List all tokens on a chain
+     */
+    readonly listTokensOnChain: (chainId: number) => TokenConfig[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAW9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAwF9D,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAMpB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;gCACgB,MAAM,WAAW,MAAM,KAAG,WAAW,GAAG,IAAI;IAI/D;;OAEG;iCACiB,MAAM,KAAG,WAAW,GAAG,IAAI;IAI/C;;OAEG;+BACa,WAAW,EAAE;IAI7B;;OAEG;iCACe,MAAM,EAAE;IAI1B;;OAEG;mCACmB,MAAM,WAAW,MAAM,KAAG,OAAO;IAIvD;;OAEG;0CAC0B,MAAM,KAAG,WAAW,EAAE;CAU3C,CAAC"}

package/dist/registry.js

@@ -0,0 +1,166 @@
+/**
+ * Chain registry - supported chains
+ */
+export const CHAINS = {
+    1: { chainId: 1, name: "Ethereum", testnet: false },
+    11155111: { chainId: 11155111, name: "Sepolia", testnet: true },
+    8453: { chainId: 8453, name: "Base", testnet: false },
+    84532: { chainId: 84532, name: "Base Sepolia", testnet: true },
+    42161: { chainId: 42161, name: "Arbitrum One", testnet: false },
+    421614: { chainId: 421614, name: "Arbitrum Sepolia", testnet: true },
+    10: { chainId: 10, name: "Optimism", testnet: false },
+    11155420: { chainId: 11155420, name: "Optimism Sepolia", testnet: true },
+    137: { chainId: 137, name: "Polygon", testnet: false },
+    80002: { chainId: 80002, name: "Polygon Amoy", testnet: true },
+};
+/**
+ * Token registry - USDC addresses and domain parameters per chain
+ * Note: Base mainnet uses "USD Coin" while Base Sepolia uses "USDC"
+ */
+export const TOKENS = {
+    USDC: {
+        // Ethereum
+        1: {
+            symbol: "USDC",
+            chainId: 1,
+            address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        11155111: {
+            symbol: "USDC",
+            chainId: 11155111,
+            address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        // Base
+        8453: {
+            symbol: "USDC",
+            chainId: 8453,
+            address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+            name: "USD Coin", // Important: Base mainnet uses "USD Coin"
+            version: "2",
+            decimals: 6,
+        },
+        84532: {
+            symbol: "USDC",
+            chainId: 84532,
+            address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+            name: "USDC", // Important: Base Sepolia uses "USDC"
+            version: "2",
+            decimals: 6,
+        },
+        // Arbitrum
+        42161: {
+            symbol: "USDC",
+            chainId: 42161,
+            address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        421614: {
+            symbol: "USDC",
+            chainId: 421614,
+            address: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        // Optimism
+        10: {
+            symbol: "USDC",
+            chainId: 10,
+            address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        11155420: {
+            symbol: "USDC",
+            chainId: 11155420,
+            address: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        // Polygon
+        137: {
+            symbol: "USDC",
+            chainId: 137,
+            address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+        80002: {
+            symbol: "USDC",
+            chainId: 80002,
+            address: "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
+            name: "USD Coin",
+            version: "2",
+            decimals: 6,
+        },
+    },
+};
+/**
+ * Get token information for a given chain
+ */
+export function getTokenInfo(tokenSymbol, chainId) {
+    const token = TOKENS[tokenSymbol.toUpperCase()];
+    if (!token)
+        return null;
+    const config = token[chainId];
+    return config || null;
+}
+/**
+ * Registry utilities
+ */
+export const registry = {
+    /**
+     * Get token configuration
+     */
+    getToken: (symbol, chainId) => {
+        return getTokenInfo(symbol, chainId);
+    },
+    /**
+     * Get chain configuration
+     */
+    getChain: (chainId) => {
+        return CHAINS[chainId] || null;
+    },
+    /**
+     * List all supported chains
+     */
+    listChains: () => {
+        return Object.values(CHAINS);
+    },
+    /**
+     * List all supported chain IDs
+     */
+    listChainIds: () => {
+        return Object.keys(CHAINS).map(Number);
+    },
+    /**
+     * Check if a token is supported on a chain
+     */
+    isSupported: (symbol, chainId) => {
+        return getTokenInfo(symbol, chainId) !== null;
+    },
+    /**
+     * List all tokens on a chain
+     */
+    listTokensOnChain: (chainId) => {
+        const tokens = [];
+        for (const symbol of Object.keys(TOKENS)) {
+            const config = TOKENS[symbol][chainId];
+            if (config) {
+                tokens.push(config);
+            }
+        }
+        return tokens;
+    },
+};

package/dist/types/index.d.ts

@@ -0,0 +1,45 @@
+import type { TypedDataDomain, TypedDataField } from "ethers";
+/**
+ * ERC-3009 TransferWithAuthorization message
+ */
+export interface TransferWithAuthorization {
+    from: string;
+    to: string;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: string;
+}
+/**
+ * EIP-712 Domain
+ */
+export type EIP712Domain = TypedDataDomain;
+/**
+ * Token configuration
+ */
+export interface TokenConfig {
+    symbol: string;
+    chainId: number;
+    address: string;
+    name: string;
+    version: string;
+    decimals: number;
+}
+/**
+ * Chain configuration
+ */
+export interface ChainConfig {
+    chainId: number;
+    name: string;
+    testnet: boolean;
+}
+/**
+ * Complete EIP-712 typed data structure
+ */
+export interface TypedData {
+    domain: EIP712Domain;
+    types: Record<string, TypedDataField[]>;
+    message: TransferWithAuthorization;
+    primaryType: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACxC,OAAO,EAAE,yBAAyB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate a random bytes32 nonce for TransferWithAuthorization
+ */
+export declare function randomNonce(): string;
+/**
+ * Get current Unix timestamp + N seconds (for validBefore)
+ */
+export declare function nowPlusSeconds(seconds: number): bigint;
+/**
+ * Get current Unix timestamp in seconds
+ */
+export declare function nowSeconds(): bigint;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils.js

@@ -0,0 +1,19 @@
+import { randomBytes, hexlify } from "ethers";
+/**
+ * Generate a random bytes32 nonce for TransferWithAuthorization
+ */
+export function randomNonce() {
+    return hexlify(randomBytes(32));
+}
+/**
+ * Get current Unix timestamp + N seconds (for validBefore)
+ */
+export function nowPlusSeconds(seconds) {
+    return BigInt(Math.floor(Date.now() / 1000) + seconds);
+}
+/**
+ * Get current Unix timestamp in seconds
+ */
+export function nowSeconds() {
+    return BigInt(Math.floor(Date.now() / 1000));
+}

package/dist/verify.d.ts

@@ -0,0 +1,14 @@
+import type { TransferWithAuthorization, EIP712Domain } from "./types/index.js";
+/**
+ * Recover the signer address from a signature
+ */
+export declare function recoverSigner(domain: EIP712Domain, message: TransferWithAuthorization, signature: string): string;
+/**
+ * Verify that a signature was created by the expected signer
+ */
+export declare function verifySignature(domain: EIP712Domain, message: TransferWithAuthorization, signature: string, expectedSigner: string): boolean;
+/**
+ * Get the EIP-712 hash for a message (useful for debugging)
+ */
+export declare function getMessageHash(domain: EIP712Domain, message: TransferWithAuthorization): string;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAc1B;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,yBAAyB,EAClC,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,yBAAyB,EAClC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,yBAAyB,GACjC,MAAM,CAMR"}

package/dist/verify.js

@@ -0,0 +1,36 @@
+import { TypedDataEncoder, verifyTypedData } from "ethers";
+/**
+ * ERC-3009 type definition for signature recovery
+ */
+const TRANSFER_WITH_AUTHORIZATION_TYPE = [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" },
+];
+/**
+ * Recover the signer address from a signature
+ */
+export function recoverSigner(domain, message, signature) {
+    return verifyTypedData(domain, { TransferWithAuthorization: TRANSFER_WITH_AUTHORIZATION_TYPE }, message, signature);
+}
+/**
+ * Verify that a signature was created by the expected signer
+ */
+export function verifySignature(domain, message, signature, expectedSigner) {
+    try {
+        const recovered = recoverSigner(domain, message, signature);
+        return recovered.toLowerCase() === expectedSigner.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the EIP-712 hash for a message (useful for debugging)
+ */
+export function getMessageHash(domain, message) {
+    return TypedDataEncoder.hash(domain, { TransferWithAuthorization: TRANSFER_WITH_AUTHORIZATION_TYPE }, message);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seapay-ai/erc3009",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript utilities for ERC-3009 (Transfer With Authorization) EIP-712 signing",
   "keywords": [
     "erc3009",