@pincerpay/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PincerPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,157 @@
+# @pincerpay/core
+
+Shared types, chain configurations, and constants for the PincerPay ecosystem.
+
+## Install
+
+```bash
+npm install @pincerpay/core
+```
+
+## Quick Start
+
+```typescript
+import { resolveChain, toCAIP2, DEFAULT_FACILITATOR_URL } from "@pincerpay/core";
+import type { ChainConfig, TransactionStatus } from "@pincerpay/core/types";
+
+const chain = resolveChain("solana");
+// { caip2Id: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", name: "Solana Devnet", ... }
+
+const caip2 = toCAIP2("base");
+// "eip155:8453"
+```
+
+## API Reference
+
+### Chain Resolution
+
+```typescript
+function resolveChain(input: string): ChainConfig | undefined;
+function toCAIP2(shorthand: string): string;
+function getMainnetChains(): ChainConfig[];
+function getTestnetChains(): ChainConfig[];
+```
+
+### Chain Config
+
+```typescript
+interface ChainConfig {
+  caip2Id: string;           // CAIP-2 identifier
+  shorthand: string;         // "solana", "base", "polygon"
+  name: string;              // Display name
+  namespace: "eip155" | "solana";
+  chainId?: number;          // EVM only
+  usdcAddress: string;       // USDC token address
+  usdcDecimals: number;      // Always 6
+  rpcUrl: string;            // Default public RPC
+  testnet: boolean;
+  explorerUrl: string;
+  blockTimeMs: number;
+}
+```
+
+### Constants
+
+```typescript
+const DEFAULT_FACILITATOR_URL = "https://facilitator.pincerpay.com";
+const API_VERSION = "v1";
+const USDC_DECIMALS = 6;
+const OPTIMISTIC_THRESHOLD = "1000000"; // 1 USDC
+const API_KEY_HEADER = "x-pincerpay-api-key";
+
+const FACILITATOR_ROUTES = {
+  verify: "/v1/verify",
+  settle: "/v1/settle",
+  status: "/v1/status",
+  supported: "/v1/supported",
+  health: "/health",
+};
+```
+
+### Key Types
+
+```typescript
+type ChainNamespace = "eip155" | "solana";
+type TransactionStatus = "pending" | "mempool" | "optimistic" | "confirmed" | "failed";
+type SettlementType = "x402" | "direct";
+type AgentStatus = "active" | "paused" | "revoked";
+
+interface PincerPayConfig {
+  apiKey: string;
+  merchantAddress: string;
+  facilitatorUrl?: string;
+  routes: Record<string, RoutePaywallConfig>;
+}
+
+interface AgentConfig {
+  chains: string[];
+  evmPrivateKey?: string;
+  solanaPrivateKey?: string;
+  policies?: SpendingPolicy[];
+  facilitatorUrl?: string;
+}
+
+interface SpendingPolicy {
+  maxPerTransaction?: string;
+  maxPerDay?: string;
+  allowedMerchants?: string[];
+  allowedChains?: string[];
+}
+```
+
+### Supported Chains
+
+| Chain | CAIP-2 ID | Shorthand | Testnet |
+|---|---|---|---|
+| Base | `eip155:8453` | `base` | No |
+| Base Sepolia | `eip155:84532` | `base-sepolia` | Yes |
+| Polygon | `eip155:137` | `polygon` | No |
+| Polygon Amoy | `eip155:80002` | `polygon-amoy` | Yes |
+| Solana | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | `solana` | No |
+| Solana Devnet | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` | `solana-devnet` | Yes |
+
+## Common Patterns
+
+### Resolve chain by shorthand or CAIP-2 ID
+
+```typescript
+import { resolveChain } from "@pincerpay/core";
+
+resolveChain("solana");                                  // by shorthand
+resolveChain("eip155:8453");                             // by CAIP-2 ID
+resolveChain("solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"); // by full CAIP-2
+```
+
+### Type-safe transaction handling
+
+```typescript
+import type { TransactionStatus } from "@pincerpay/core/types";
+
+function handleStatus(status: TransactionStatus) {
+  switch (status) {
+    case "optimistic": return "Payment accepted (fast)";
+    case "confirmed":  return "Payment confirmed on-chain";
+    case "failed":     return "Payment failed";
+    default:           return "Processing...";
+  }
+}
+```
+
+## Anti-Patterns
+
+### Don't hardcode CAIP-2 IDs
+
+Use `toCAIP2()` or `resolveChain()` instead of hardcoding chain identifiers.
+
+```typescript
+// Bad
+const network = "eip155:8453";
+
+// Good
+import { toCAIP2 } from "@pincerpay/core";
+const network = toCAIP2("base");
+```
+
+### Don't assume USDC decimals
+
+Always use `USDC_DECIMALS` or `chain.usdcDecimals` instead of hardcoding `6`.

package/dist/chains/index.d.ts

@@ -0,0 +1,25 @@
+import type { ChainConfig } from "../types/index.js";
+export declare const BASE_MAINNET: ChainConfig;
+export declare const POLYGON_MAINNET: ChainConfig;
+export declare const SOLANA_MAINNET: ChainConfig;
+export declare const BASE_SEPOLIA: ChainConfig;
+export declare const POLYGON_AMOY: ChainConfig;
+export declare const SOLANA_DEVNET: ChainConfig;
+export declare const CHAINS: Record<string, ChainConfig>;
+/** Reverse lookup: CAIP-2 ID → ChainConfig */
+export declare const CHAINS_BY_CAIP2: Record<string, ChainConfig>;
+/**
+ * Resolve a chain shorthand (e.g., "base") or CAIP-2 ID (e.g., "eip155:8453")
+ * to a ChainConfig. Returns undefined if not found.
+ */
+export declare function resolveChain(input: string): ChainConfig | undefined;
+/**
+ * Resolve a chain shorthand to its CAIP-2 ID.
+ * Throws if the chain is not recognized.
+ */
+export declare function toCAIP2(shorthand: string): string;
+/** Get all supported mainnet chain configs */
+export declare function getMainnetChains(): ChainConfig[];
+/** Get all supported testnet chain configs */
+export declare function getTestnetChains(): ChainConfig[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,YAAY,EAAE,WAa1B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAa7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAY5B,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,WAY1B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAY1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC;AAIF,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAS9C,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAEvD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD"}

package/dist/chains/index.js

@@ -0,0 +1,121 @@
+// ─── Mainnet Chains ───
+export const BASE_MAINNET = {
+    caip2Id: "eip155:8453",
+    shorthand: "base",
+    name: "Base",
+    namespace: "eip155",
+    chainId: 8453,
+    usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    usdcDecimals: 6,
+    rpcUrl: "https://mainnet.base.org",
+    wsRpcUrl: "wss://base-mainnet.g.alchemy.com/v2",
+    testnet: false,
+    explorerUrl: "https://basescan.org",
+    blockTimeMs: 2000,
+};
+export const POLYGON_MAINNET = {
+    caip2Id: "eip155:137",
+    shorthand: "polygon",
+    name: "Polygon",
+    namespace: "eip155",
+    chainId: 137,
+    usdcAddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    usdcDecimals: 6,
+    rpcUrl: "https://polygon-rpc.com",
+    wsRpcUrl: "wss://polygon-mainnet.g.alchemy.com/v2",
+    testnet: false,
+    explorerUrl: "https://polygonscan.com",
+    blockTimeMs: 2000,
+};
+export const SOLANA_MAINNET = {
+    caip2Id: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+    shorthand: "solana",
+    name: "Solana",
+    namespace: "solana",
+    usdcAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+    usdcDecimals: 6,
+    rpcUrl: "https://api.mainnet-beta.solana.com",
+    wsRpcUrl: "wss://api.mainnet-beta.solana.com",
+    testnet: false,
+    explorerUrl: "https://explorer.solana.com",
+    blockTimeMs: 400,
+};
+// ─── Testnet Chains ───
+export const BASE_SEPOLIA = {
+    caip2Id: "eip155:84532",
+    shorthand: "base-sepolia",
+    name: "Base Sepolia",
+    namespace: "eip155",
+    chainId: 84532,
+    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    usdcDecimals: 6,
+    rpcUrl: "https://sepolia.base.org",
+    testnet: true,
+    explorerUrl: "https://sepolia.basescan.org",
+    blockTimeMs: 2000,
+};
+export const POLYGON_AMOY = {
+    caip2Id: "eip155:80002",
+    shorthand: "polygon-amoy",
+    name: "Polygon Amoy",
+    namespace: "eip155",
+    chainId: 80002,
+    usdcAddress: "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
+    usdcDecimals: 6,
+    rpcUrl: "https://rpc-amoy.polygon.technology",
+    testnet: true,
+    explorerUrl: "https://amoy.polygonscan.com",
+    blockTimeMs: 2000,
+};
+export const SOLANA_DEVNET = {
+    caip2Id: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+    shorthand: "solana-devnet",
+    name: "Solana Devnet",
+    namespace: "solana",
+    usdcAddress: "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
+    usdcDecimals: 6,
+    rpcUrl: "https://api.devnet.solana.com",
+    testnet: true,
+    explorerUrl: "https://explorer.solana.com?cluster=devnet",
+    blockTimeMs: 400,
+};
+// ─── Chain Registry ───
+export const CHAINS = {
+    // Mainnets
+    base: BASE_MAINNET,
+    polygon: POLYGON_MAINNET,
+    solana: SOLANA_MAINNET,
+    // Testnets
+    "base-sepolia": BASE_SEPOLIA,
+    "polygon-amoy": POLYGON_AMOY,
+    "solana-devnet": SOLANA_DEVNET,
+};
+/** Reverse lookup: CAIP-2 ID → ChainConfig */
+export const CHAINS_BY_CAIP2 = Object.fromEntries(Object.values(CHAINS).map((c) => [c.caip2Id, c]));
+/**
+ * Resolve a chain shorthand (e.g., "base") or CAIP-2 ID (e.g., "eip155:8453")
+ * to a ChainConfig. Returns undefined if not found.
+ */
+export function resolveChain(input) {
+    return CHAINS[input] ?? CHAINS_BY_CAIP2[input];
+}
+/**
+ * Resolve a chain shorthand to its CAIP-2 ID.
+ * Throws if the chain is not recognized.
+ */
+export function toCAIP2(shorthand) {
+    const chain = resolveChain(shorthand);
+    if (!chain) {
+        throw new Error(`Unknown chain: "${shorthand}". Valid chains: ${Object.keys(CHAINS).join(", ")}`);
+    }
+    return chain.caip2Id;
+}
+/** Get all supported mainnet chain configs */
+export function getMainnetChains() {
+    return Object.values(CHAINS).filter((c) => !c.testnet);
+}
+/** Get all supported testnet chain configs */
+export function getTestnetChains() {
+    return Object.values(CHAINS).filter((c) => c.testnet);
+}
+//# sourceMappingURL=index.js.map

package/dist/chains/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,32 @@
+/** Default PincerPay facilitator URL */
+export declare const DEFAULT_FACILITATOR_URL = "https://facilitator.pincerpay.com";
+/** Facilitator API version prefix */
+export declare const API_VERSION = "v1";
+/** Facilitator routes */
+export declare const FACILITATOR_ROUTES: {
+    readonly verify: "/v1/verify";
+    readonly settle: "/v1/settle";
+    readonly status: "/v1/status";
+    readonly supported: "/v1/supported";
+    readonly health: "/health";
+};
+/** USDC decimals (consistent across all chains) */
+export declare const USDC_DECIMALS = 6;
+/** Optimistic finality threshold in USDC base units (1 USDC = 1_000_000) */
+export declare const OPTIMISTIC_THRESHOLD = "1000000";
+/** API key prefix length (shown to users, e.g., "pp_live_abc...") */
+export declare const API_KEY_PREFIX_LENGTH = 12;
+/** API key header name */
+export declare const API_KEY_HEADER = "x-pincerpay-api-key";
+/** Rate limit defaults */
+export declare const RATE_LIMIT: {
+    /** Max requests per minute per API key */
+    readonly perMinute: 120;
+    /** Max requests per second per API key (burst) */
+    readonly perSecond: 20;
+};
+/** Transaction status poll interval in ms */
+export declare const TX_POLL_INTERVAL_MS = 2000;
+/** Maximum time to wait for tx confirmation in ms */
+export declare const TX_CONFIRMATION_TIMEOUT_MS = 120000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,sCAAsC,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,yBAAyB;AACzB,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,0BAA0B;AAC1B,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,0BAA0B;AAC1B,eAAO,MAAM,UAAU;IACrB,0CAA0C;;IAE1C,kDAAkD;;CAE1C,CAAC;AAEX,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,qDAAqD;AACrD,eAAO,MAAM,0BAA0B,SAAU,CAAC"}

package/dist/constants.js

@@ -0,0 +1,32 @@
+/** Default PincerPay facilitator URL */
+export const DEFAULT_FACILITATOR_URL = "https://facilitator.pincerpay.com";
+/** Facilitator API version prefix */
+export const API_VERSION = "v1";
+/** Facilitator routes */
+export const FACILITATOR_ROUTES = {
+    verify: `/${API_VERSION}/verify`,
+    settle: `/${API_VERSION}/settle`,
+    status: `/${API_VERSION}/status`,
+    supported: `/${API_VERSION}/supported`,
+    health: "/health",
+};
+/** USDC decimals (consistent across all chains) */
+export const USDC_DECIMALS = 6;
+/** Optimistic finality threshold in USDC base units (1 USDC = 1_000_000) */
+export const OPTIMISTIC_THRESHOLD = "1000000";
+/** API key prefix length (shown to users, e.g., "pp_live_abc...") */
+export const API_KEY_PREFIX_LENGTH = 12;
+/** API key header name */
+export const API_KEY_HEADER = "x-pincerpay-api-key";
+/** Rate limit defaults */
+export const RATE_LIMIT = {
+    /** Max requests per minute per API key */
+    perMinute: 120,
+    /** Max requests per second per API key (burst) */
+    perSecond: 20,
+};
+/** Transaction status poll interval in ms */
+export const TX_POLL_INTERVAL_MS = 2000;
+/** Maximum time to wait for tx confirmation in ms */
+export const TX_CONFIRMATION_TIMEOUT_MS = 120_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,mCAAmC,CAAC;AAE3E,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEhC,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,IAAI,WAAW,SAAS;IAChC,MAAM,EAAE,IAAI,WAAW,SAAS;IAChC,MAAM,EAAE,IAAI,WAAW,SAAS;IAChC,SAAS,EAAE,IAAI,WAAW,YAAY;IACtC,MAAM,EAAE,SAAS;CACT,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEpD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,0CAA0C;IAC1C,SAAS,EAAE,GAAG;IACd,kDAAkD;IAClD,SAAS,EAAE,EAAE;CACL,CAAC;AAEX,6CAA6C;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,qDAAqD;AACrD,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types/index.js";
+export * from "./chains/index.js";
+export * from "./constants.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":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./types/index.js";
+export * from "./chains/index.js";
+export * from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,246 @@
+import { z } from "zod";
+export type ChainNamespace = "eip155" | "solana";
+export interface ChainConfig {
+    /** CAIP-2 chain ID (e.g., "eip155:8453" for Base) */
+    caip2Id: string;
+    /** Human-readable shorthand (e.g., "base", "solana") */
+    shorthand: string;
+    /** Display name */
+    name: string;
+    /** Chain namespace */
+    namespace: ChainNamespace;
+    /** Numeric chain ID (EVM only) */
+    chainId?: number;
+    /** USDC contract address on this chain */
+    usdcAddress: string;
+    /** USDC decimals (6 for all current deployments) */
+    usdcDecimals: number;
+    /** Default RPC URL (overridable) */
+    rpcUrl: string;
+    /** WebSocket RPC URL (optional, for mempool monitoring) */
+    wsRpcUrl?: string;
+    /** Whether this is a testnet */
+    testnet: boolean;
+    /** Block explorer URL */
+    explorerUrl: string;
+    /** Average block time in milliseconds */
+    blockTimeMs: number;
+}
+export interface MerchantProfile {
+    id: string;
+    name: string;
+    walletAddress: string;
+    supportedChains: string[];
+    webhookUrl?: string;
+    createdAt: Date;
+}
+export interface ApiKeyRecord {
+    id: string;
+    merchantId: string;
+    keyHash: string;
+    prefix: string;
+    label: string;
+    isActive: boolean;
+    createdAt: Date;
+    lastUsedAt?: Date;
+}
+export interface PaywallConfig {
+    id: string;
+    merchantId: string;
+    /** HTTP method + path pattern (e.g., "GET /api/weather") */
+    endpointPattern: string;
+    /** USDC amount as string (e.g., "0.01") */
+    amount: string;
+    /** Supported chains for this paywall (defaults to merchant's chains) */
+    chains?: string[];
+    /** Human-readable description */
+    description: string;
+    isActive: boolean;
+}
+export type TransactionStatus = "pending" | "mempool" | "optimistic" | "confirmed" | "failed";
+/** Settlement type: x402 (off-chain via x402 protocol) or direct (on-chain via Anchor program) */
+export type SettlementType = "x402" | "direct";
+/** Solana commitment levels for confirmation */
+export type SolanaConfirmationLevel = "processed" | "confirmed" | "finalized";
+export interface Transaction {
+    id: string;
+    merchantId: string;
+    /** CAIP-2 chain ID */
+    chainId: string;
+    txHash: string;
+    fromAddress: string;
+    toAddress: string;
+    /** USDC amount in base units (e.g., "1000000" = 1 USDC) */
+    amount: string;
+    /** Gas/fee cost in base units of gasToken */
+    gasCost: string;
+    /** Token used for transaction fees (e.g., "ETH", "SOL", "MATIC", "USDC") */
+    gasToken: string;
+    status: TransactionStatus;
+    /** Whether optimistic finality was used */
+    optimistic: boolean;
+    /** Settlement path used: x402 (off-chain) or direct (on-chain Anchor program) */
+    settlementType?: SettlementType;
+    /** On-chain settlement nonce (links to SettlementRecord PDA) */
+    programNonce?: string;
+    /** Solana slot number (null for EVM) */
+    slot?: string;
+    /** Solana priority fee in microlamports (null for EVM) */
+    priorityFee?: string;
+    /** Solana compute units consumed (null for EVM) */
+    computeUnits?: string;
+    createdAt: Date;
+    confirmedAt?: Date;
+}
+/** On-chain settlement record from the Anchor program */
+export interface OnChainSettlement {
+    nonce: string;
+    agent: string;
+    merchant: string;
+    merchantAccount: string;
+    amount: string;
+    slot: string;
+    /** 0 = direct on-chain, 1 = x402 recorded */
+    txType: number;
+    x402TxHash: string;
+    timestamp: number;
+}
+export type AgentStatus = "active" | "paused" | "revoked";
+export interface AgentProfile {
+    id: string;
+    merchantId: string;
+    name: string;
+    solanaAddress: string;
+    smartAccountPda?: string;
+    settingsPda?: string;
+    spendingLimitPda?: string;
+    maxPerTransaction?: string;
+    maxPerDay?: string;
+    status: AgentStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SolanaSmartAgentConfig extends AgentConfig {
+    /** Squads Settings PDA */
+    settingsPda?: string;
+    /** Smart Account index for PDA derivation */
+    smartAccountIndex?: number;
+    /** Spending Limit index for PDA derivation */
+    spendingLimitIndex?: number;
+}
+export interface SpendingPolicy {
+    /** Max USDC per transaction (base units) */
+    maxPerTransaction?: string;
+    /** Max USDC per day (base units) */
+    maxPerDay?: string;
+    /** Allowed merchant addresses */
+    allowedMerchants?: string[];
+    /** Allowed chains (shorthands) */
+    allowedChains?: string[];
+}
+export interface PincerPayConfig {
+    /** Merchant API key */
+    apiKey: string;
+    /** Merchant wallet address */
+    merchantAddress: string;
+    /** Facilitator URL (defaults to PincerPay hosted) */
+    facilitatorUrl?: string;
+    /** Route-level paywall configs */
+    routes: Record<string, RoutePaywallConfig>;
+}
+export interface RoutePaywallConfig {
+    /** USDC price as string (e.g., "0.01") */
+    price: string;
+    /** Preferred chain shorthand */
+    chain?: string;
+    /** Multiple chain shorthands */
+    chains?: string[];
+    /** Description shown in 402 response */
+    description?: string;
+}
+export interface AgentConfig {
+    /** Supported chain shorthands */
+    chains: string[];
+    /** EVM private key (hex) */
+    evmPrivateKey?: string;
+    /** Solana private key (base58) */
+    solanaPrivateKey?: string;
+    /** Spending policies */
+    policies?: SpendingPolicy[];
+    /** Custom facilitator URL */
+    facilitatorUrl?: string;
+}
+export declare const RoutePaywallConfigSchema: z.ZodObject<{
+    price: z.ZodString;
+    chain: z.ZodOptional<z.ZodString>;
+    chains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    price: string;
+    chain?: string | undefined;
+    chains?: string[] | undefined;
+    description?: string | undefined;
+}, {
+    price: string;
+    chain?: string | undefined;
+    chains?: string[] | undefined;
+    description?: string | undefined;
+}>;
+export declare const PincerPayConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    merchantAddress: z.ZodString;
+    facilitatorUrl: z.ZodOptional<z.ZodString>;
+    routes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        price: z.ZodString;
+        chain: z.ZodOptional<z.ZodString>;
+        chains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        price: string;
+        chain?: string | undefined;
+        chains?: string[] | undefined;
+        description?: string | undefined;
+    }, {
+        price: string;
+        chain?: string | undefined;
+        chains?: string[] | undefined;
+        description?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    merchantAddress: string;
+    routes: Record<string, {
+        price: string;
+        chain?: string | undefined;
+        chains?: string[] | undefined;
+        description?: string | undefined;
+    }>;
+    facilitatorUrl?: string | undefined;
+}, {
+    apiKey: string;
+    merchantAddress: string;
+    routes: Record<string, {
+        price: string;
+        chain?: string | undefined;
+        chains?: string[] | undefined;
+        description?: string | undefined;
+    }>;
+    facilitatorUrl?: string | undefined;
+}>;
+export declare const SpendingPolicySchema: z.ZodObject<{
+    maxPerTransaction: z.ZodOptional<z.ZodString>;
+    maxPerDay: z.ZodOptional<z.ZodString>;
+    allowedMerchants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowedChains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    maxPerTransaction?: string | undefined;
+    maxPerDay?: string | undefined;
+    allowedMerchants?: string[] | undefined;
+    allowedChains?: string[] | undefined;
+}, {
+    maxPerTransaction?: string | undefined;
+    maxPerDay?: string | undefined;
+    allowedMerchants?: string[] | undefined;
+    allowedChains?: string[] | undefined;
+}>;
+//# 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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,CAAC,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/C,gDAAgD;AAChD,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAID,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+// ─── Zod Schemas ───
+export const RoutePaywallConfigSchema = z.object({
+    price: z.string().regex(/^\d+\.?\d*$/, "Must be a valid USDC amount"),
+    chain: z.string().optional(),
+    chains: z.array(z.string()).optional(),
+    description: z.string().optional(),
+});
+export const PincerPayConfigSchema = z.object({
+    apiKey: z.string().min(1),
+    merchantAddress: z.string().min(1),
+    facilitatorUrl: z.string().url().optional(),
+    routes: z.record(z.string(), RoutePaywallConfigSchema),
+});
+export const SpendingPolicySchema = z.object({
+    maxPerTransaction: z.string().optional(),
+    maxPerDay: z.string().optional(),
+    allowedMerchants: z.array(z.string()).optional(),
+    allowedChains: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiNxB,sBAAsB;AAEtB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,6BAA6B,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@pincerpay/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Shared types, chain configs, and constants for PincerPay on-chain payment gateway",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://pincerpay.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds1/pincerpay.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/ds1/pincerpay/issues"
+  },
+  "keywords": [
+    "pincerpay",
+    "x402",
+    "usdc",
+    "payments",
+    "ai-agents",
+    "solana",
+    "payment-gateway",
+    "stablecoin"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./chains": {
+      "types": "./dist/chains/index.d.ts",
+      "import": "./dist/chains/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.24"
+  },
+  "devDependencies": {
+    "typescript": "^5.7"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}