@seapay-ai/erc3009 0.1.0 → 0.1.1

package/dist/registry/tokens/usdc.d.ts

@@ -0,0 +1,27 @@
+import type { TokenConfig } from "../../types/registry.js";
+/**
+ * USDC token configurations across supported chains
+ *
+ * Note: These are the proxy addresses and EIP-712 domain parameters
+ * for the USDC contract on each chain.
+ *
+ * **IMPORTANT**: Domain names vary by network:
+ * - Base Mainnet (8453): name = "USD Coin"
+ * - Base Sepolia (84532): name = "USDC"
+ *
+ * Always use the correct domain name for signature verification to work.
+ */
+export declare const USDC: Record<number, TokenConfig>;
+/**
+ * Get USDC configuration for a specific chain
+ */
+export declare function getUSDC(chainId: number): TokenConfig | undefined;
+/**
+ * Check if USDC is supported on a chain
+ */
+export declare function isUSDCSupported(chainId: number): boolean;
+/**
+ * List all chains where USDC is configured
+ */
+export declare function listUSDCChains(): number[];
+//# sourceMappingURL=usdc.d.ts.map

package/dist/registry/tokens/usdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdc.d.ts","sourceRoot":"","sources":["../../../src/registry/tokens/usdc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyE5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC"}

package/dist/registry/tokens/usdc.js

@@ -0,0 +1,104 @@
+/**
+ * USDC token configurations across supported chains
+ *
+ * Note: These are the proxy addresses and EIP-712 domain parameters
+ * for the USDC contract on each chain.
+ *
+ * **IMPORTANT**: Domain names vary by network:
+ * - Base Mainnet (8453): name = "USD Coin"
+ * - Base Sepolia (84532): name = "USDC"
+ *
+ * Always use the correct domain name for signature verification to work.
+ */
+export const USDC = {
+    // Ethereum Mainnet
+    1: {
+        symbol: "USDC",
+        chainId: 1,
+        verifyingContract: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Ethereum Sepolia Testnet
+    11155111: {
+        symbol: "USDC",
+        chainId: 11155111,
+        verifyingContract: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Base Mainnet (domain name: "USD Coin")
+    8453: {
+        symbol: "USDC",
+        chainId: 8453,
+        verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Base Sepolia Testnet (domain name: "USDC")
+    84532: {
+        symbol: "USDC",
+        chainId: 84532,
+        verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        name: "USDC",
+        version: "2",
+        decimals: 6,
+    },
+    // Arbitrum One
+    42161: {
+        symbol: "USDC",
+        chainId: 42161,
+        verifyingContract: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Arbitrum Sepolia Testnet
+    421614: {
+        symbol: "USDC",
+        chainId: 421614,
+        verifyingContract: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Polygon
+    137: {
+        symbol: "USDC",
+        chainId: 137,
+        verifyingContract: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+    // Optimism
+    10: {
+        symbol: "USDC",
+        chainId: 10,
+        verifyingContract: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+        name: "USD Coin",
+        version: "2",
+        decimals: 6,
+    },
+};
+/**
+ * Get USDC configuration for a specific chain
+ */
+export function getUSDC(chainId) {
+    return USDC[chainId];
+}
+/**
+ * Check if USDC is supported on a chain
+ */
+export function isUSDCSupported(chainId) {
+    return chainId in USDC;
+}
+/**
+ * List all chains where USDC is configured
+ */
+export function listUSDCChains() {
+    return Object.keys(USDC).map(Number);
+}

package/dist/types/domain.d.ts

@@ -0,0 +1,24 @@
+/**
+ * EIP-712 Domain structure
+ */
+export type EIP712Domain = {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+};
+/**
+ * Partial domain for overrides
+ */
+export type DomainOverrides = Partial<EIP712Domain>;
+/**
+ * Domain resolution parameters
+ */
+export type ResolveDomainParams = {
+    chainId: number;
+    token: string;
+    name?: string;
+    version?: string;
+    verifyingContract?: string;
+};
+//# sourceMappingURL=domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/types/domain.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC"}

package/dist/types/domain.js

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

package/dist/types/erc3009.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ERC-3009 TransferWithAuthorization message structure
+ */
+export type TransferWithAuthorization = {
+    from: string;
+    to: string;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: string;
+};
+/**
+ * ERC-3009 constants
+ */
+export declare const TRANSFER_WITH_AUTHORIZATION_TYPE = "TransferWithAuthorization";
+/**
+ * EIP-712 type fields for TransferWithAuthorization
+ */
+export declare const TRANSFER_WITH_AUTHORIZATION_FIELDS: readonly [{
+    readonly name: "from";
+    readonly type: "address";
+}, {
+    readonly name: "to";
+    readonly type: "address";
+}, {
+    readonly name: "value";
+    readonly type: "uint256";
+}, {
+    readonly name: "validAfter";
+    readonly type: "uint256";
+}, {
+    readonly name: "validBefore";
+    readonly type: "uint256";
+}, {
+    readonly name: "nonce";
+    readonly type: "bytes32";
+}];
+//# sourceMappingURL=erc3009.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"erc3009.d.ts","sourceRoot":"","sources":["../../src/types/erc3009.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,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;;GAEG;AACH,eAAO,MAAM,gCAAgC,8BAA8B,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;EAOrC,CAAC"}

package/dist/types/erc3009.js

@@ -0,0 +1,15 @@
+/**
+ * ERC-3009 constants
+ */
+export const TRANSFER_WITH_AUTHORIZATION_TYPE = "TransferWithAuthorization";
+/**
+ * EIP-712 type fields for TransferWithAuthorization
+ */
+export 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" },
+];

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./erc3009.js";
+export * from "./domain.js";
+export * from "./registry.js";
+//# 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,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export * from "./erc3009.js";
+export * from "./domain.js";
+export * from "./registry.js";

package/dist/types/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Chain metadata
+ */
+export type ChainConfig = {
+    chainId: number;
+    name: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    rpcUrls?: string[];
+    blockExplorerUrls?: string[];
+    testnet?: boolean;
+};
+/**
+ * Token configuration for a specific chain
+ */
+export type TokenConfig = {
+    symbol: string;
+    chainId: number;
+    verifyingContract: `0x${string}`;
+    name: string;
+    version: string;
+    decimals?: number;
+};
+/**
+ * Token registry (symbol -> chainId -> config)
+ */
+export type TokenRegistry = {
+    [symbol: string]: {
+        [chainId: number]: TokenConfig;
+    };
+};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,MAAM,EAAE,MAAM,GAAG;QAChB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;KAChC,CAAC;CACH,CAAC"}

package/dist/types/registry.js

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

package/dist/utils/hex.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensure hex string has 0x prefix
+ */
+export declare function ensureHex(value: string): string;
+/**
+ * Normalize address to lowercase with 0x prefix
+ */
+export declare function normalizeAddress(address: string): string;
+/**
+ * Check if string is valid bytes32 hex
+ */
+export declare function isBytes32Hex(value: string): boolean;
+//# sourceMappingURL=hex.d.ts.map

package/dist/utils/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD"}

package/dist/utils/hex.js

@@ -0,0 +1,19 @@
+/**
+ * Ensure hex string has 0x prefix
+ */
+export function ensureHex(value) {
+    return value.startsWith("0x") ? value : `0x${value}`;
+}
+/**
+ * Normalize address to lowercase with 0x prefix
+ */
+export function normalizeAddress(address) {
+    return ensureHex(address.toLowerCase());
+}
+/**
+ * Check if string is valid bytes32 hex
+ */
+export function isBytes32Hex(value) {
+    const hex = ensureHex(value);
+    return /^0x[0-9a-fA-F]{64}$/.test(hex);
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./nonce.js";
+export * from "./time.js";
+export * from "./hex.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export * from "./nonce.js";
+export * from "./time.js";
+export * from "./hex.js";

package/dist/utils/nonce.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate a random bytes32 nonce (hex string)
+ */
+export declare function randomNonce(): string;
+//# sourceMappingURL=nonce.d.ts.map

package/dist/utils/nonce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.d.ts","sourceRoot":"","sources":["../../src/utils/nonce.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/utils/nonce.js

@@ -0,0 +1,7 @@
+import { randomBytes, hexlify } from "ethers";
+/**
+ * Generate a random bytes32 nonce (hex string)
+ */
+export function randomNonce() {
+    return hexlify(randomBytes(32));
+}

package/dist/utils/time.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get current Unix timestamp in seconds
+ */
+export declare function nowSeconds(): bigint;
+/**
+ * Get Unix timestamp N seconds from now
+ */
+export declare function nowPlusSeconds(seconds: number): bigint;
+/**
+ * Convert seconds to bigint
+ */
+export declare function toBigInt(value: number | bigint | string): bigint;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

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

package/dist/utils/time.js

@@ -0,0 +1,18 @@
+/**
+ * Get current Unix timestamp in seconds
+ */
+export function nowSeconds() {
+    return BigInt(Math.floor(Date.now() / 1000));
+}
+/**
+ * Get Unix timestamp N seconds from now
+ */
+export function nowPlusSeconds(seconds) {
+    return nowSeconds() + BigInt(seconds);
+}
+/**
+ * Convert seconds to bigint
+ */
+export function toBigInt(value) {
+    return BigInt(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seapay-ai/erc3009",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript utilities for ERC-3009 (Transfer With Authorization) EIP-712 signing",
   "keywords": [
     "erc3009",
@@ -30,12 +30,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -b",
-    "prepublishOnly": "pnpm build",
-    "lint": "echo \"no lint configured\"",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
     "ethers": "^6.16.0"
   },
@@ -49,5 +43,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "lint": "echo \"no lint configured\"",
+    "typecheck": "tsc --noEmit"
   }
-}
+}