@pay-skill/sdk 0.1.1

package/README.md

@@ -0,0 +1,154 @@
+# @pay-skill/sdk
+
+TypeScript SDK for [pay](https://pay-skill.com) — payment infrastructure for AI agents. USDC on Base.
+
+Three primitives: direct payments, tabs (pre-funded metered accounts), and x402 HTTP paywalls.
+
+## Install
+
+```bash
+npm install @pay-skill/sdk
+```
+
+Requires Node.js 20+.
+
+## Quick Start
+
+```typescript
+import { PayClient } from "@pay-skill/sdk";
+
+const client = new PayClient({ signer: "cli" }); // uses `pay sign` subprocess
+
+// Pay another agent $5
+const result = await client.payDirect("0xprovider...", 5_000_000, { memo: "task-42" });
+console.log(result.txHash);
+
+// Open a metered tab
+const tab = await client.openTab("0xprovider...", 20_000_000, { maxChargePerCall: 500_000 });
+
+// x402 request (SDK handles payment automatically)
+const response = await client.request("https://api.example.com/data");
+```
+
+All amounts are in USDC micro-units (6 decimals). `$1.00 = 1_000_000`.
+
+## API Reference
+
+### PayClient
+
+```typescript
+import { PayClient } from "@pay-skill/sdk";
+
+const client = new PayClient({
+  apiUrl: "https://pay-skill.com/api/v1", // default
+  signer: "cli", // "cli", "raw", "custom", or a Signer instance
+});
+```
+
+### Direct Payment
+
+One-shot USDC transfer. $1.00 minimum.
+
+```typescript
+const result = await client.payDirect(to, amount, { memo });
+// Returns: { txHash, status, amount, fee }
+```
+
+### Tab Management
+
+Pre-funded metered account. $5.00 minimum to open.
+
+```typescript
+// Open
+const tab = await client.openTab(provider, amount, { maxChargePerCall });
+
+// Query
+const tabs = await client.listTabs();
+const tab = await client.getTab(tabId);
+
+// Top up (no extra activation fee)
+const tab = await client.topUpTab(tabId, amount);
+
+// Close (either party, unilateral)
+const tab = await client.closeTab(tabId);
+```
+
+Returns `Tab { tabId, provider, amount, balanceRemaining, totalCharged, chargeCount, maxChargePerCall, status }`.
+
+### x402 Requests
+
+Transparent HTTP 402 handling. The SDK detects `402 Payment Required`, pays (via direct or tab), and retries.
+
+```typescript
+const response = await client.request(url, { method, body, headers });
+// Returns: Response (native fetch Response)
+```
+
+If the provider requires tab settlement, the SDK auto-opens a tab at 10x the per-call price (minimum $5).
+
+### Wallet
+
+```typescript
+const status = await client.getStatus();
+// Returns: { address, balance, openTabs }
+```
+
+### Webhooks
+
+```typescript
+const wh = await client.registerWebhook(url, { events: ["tab.opened"], secret: "whsec_..." });
+const webhooks = await client.listWebhooks();
+await client.deleteWebhook(webhookId);
+```
+
+### Funding
+
+```typescript
+const fundUrl = await client.createFundLink(10_000_000);    // Coinbase Onramp
+const withdrawUrl = await client.createWithdrawLink(5_000_000);
+```
+
+## Signer Modes
+
+| Mode | Usage | When |
+|------|-------|------|
+| `"cli"` | Subprocess call to `pay sign` | Default. Key in OS keychain. |
+| `"raw"` | `PAYSKILL_KEY` env var | Dev/testing only. |
+| `"custom"` | Your own callback | Custom key management. |
+
+```typescript
+// CLI signer (default)
+const client = new PayClient({ signer: "cli" });
+
+// Raw key (dev only)
+const client = new PayClient({ signer: "raw", signerOptions: { key: "0xdead..." } });
+
+// Custom callback
+import { CallbackSigner } from "@pay-skill/sdk";
+const signer = new CallbackSigner((hash: Uint8Array) => mySign(hash));
+const client = new PayClient({ signer });
+```
+
+## Error Handling
+
+```typescript
+import {
+  PayError,                  // Base class
+  PayValidationError,        // Bad input (has .field)
+  PayNetworkError,           // Connection failed
+  PayServerError,            // Server returned error (has .statusCode)
+  PayInsufficientFundsError, // Not enough USDC
+} from "@pay-skill/sdk";
+```
+
+## Configuration
+
+| Env Var | Purpose |
+|---------|---------|
+| `PAYSKILL_KEY` | Private key for raw signer mode |
+
+The API URL is configurable via the `apiUrl` option. Default: `https://pay-skill.com/api/v1`.
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,47 @@
+/**
+ * EIP-712 authentication for pay API requests.
+ *
+ * Every authenticated request includes four headers:
+ *   X-Pay-Agent     — wallet address (0x-prefixed, checksummed)
+ *   X-Pay-Signature — EIP-712 signature (0x-prefixed hex, 65 bytes)
+ *   X-Pay-Timestamp — unix timestamp in seconds
+ *   X-Pay-Nonce     — random 32-byte hex (0x-prefixed)
+ *
+ * The EIP-712 domain:
+ *   name: "pay"
+ *   version: "0.1"
+ *   chainId: <from config>
+ *   verifyingContract: <router address>
+ *
+ * The typed data:
+ *   APIRequest(string method, string path, uint256 timestamp, bytes32 nonce)
+ */
+import { type Hex, type Address } from "viem";
+export interface AuthConfig {
+    chainId: number;
+    routerAddress: Address;
+}
+export interface AuthHeaders {
+    "X-Pay-Agent": string;
+    "X-Pay-Signature": string;
+    "X-Pay-Timestamp": string;
+    "X-Pay-Nonce": string;
+}
+/**
+ * Build auth headers for an API request using a private key.
+ */
+export declare function buildAuthHeaders(privateKey: Hex, method: string, path: string, config: AuthConfig): Promise<AuthHeaders>;
+/**
+ * Build auth headers using a generic signer (Signer interface).
+ * Computes the EIP-712 hash manually and delegates signing to the signer.
+ */
+export declare function buildAuthHeadersWithSigner(signer: {
+    sign(hash: Uint8Array): Uint8Array;
+    address: string;
+}, method: string, path: string, config: AuthConfig): AuthHeaders;
+/**
+ * Compute the EIP-712 hash for an APIRequest.
+ * Must match the server's computation exactly.
+ */
+export declare function computeEip712Hash(method: string, path: string, timestamp: bigint, nonce: Hex, chainId: number, verifyingContract: Address): Uint8Array;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAkC,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAI9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAgBD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,GAAG,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,WAAW,CAAC,CA2BtB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE;IAAE,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC/D,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,WAAW,CAsBb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,OAAO,GACzB,UAAU,CA4DZ"}

package/dist/auth.js

@@ -0,0 +1,121 @@
+/**
+ * EIP-712 authentication for pay API requests.
+ *
+ * Every authenticated request includes four headers:
+ *   X-Pay-Agent     — wallet address (0x-prefixed, checksummed)
+ *   X-Pay-Signature — EIP-712 signature (0x-prefixed hex, 65 bytes)
+ *   X-Pay-Timestamp — unix timestamp in seconds
+ *   X-Pay-Nonce     — random 32-byte hex (0x-prefixed)
+ *
+ * The EIP-712 domain:
+ *   name: "pay"
+ *   version: "0.1"
+ *   chainId: <from config>
+ *   verifyingContract: <router address>
+ *
+ * The typed data:
+ *   APIRequest(string method, string path, uint256 timestamp, bytes32 nonce)
+ */
+import { keccak256, encodePacked } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { randomBytes } from "node:crypto";
+const EIP712_DOMAIN = {
+    name: "pay",
+    version: "0.1",
+};
+const API_REQUEST_TYPES = {
+    APIRequest: [
+        { name: "method", type: "string" },
+        { name: "path", type: "string" },
+        { name: "timestamp", type: "uint256" },
+        { name: "nonce", type: "bytes32" },
+    ],
+};
+/**
+ * Build auth headers for an API request using a private key.
+ */
+export async function buildAuthHeaders(privateKey, method, path, config) {
+    const account = privateKeyToAccount(privateKey);
+    const timestamp = BigInt(Math.floor(Date.now() / 1000));
+    const nonce = ("0x" + randomBytes(32).toString("hex"));
+    const signature = await account.signTypedData({
+        domain: {
+            ...EIP712_DOMAIN,
+            chainId: config.chainId,
+            verifyingContract: config.routerAddress,
+        },
+        types: API_REQUEST_TYPES,
+        primaryType: "APIRequest",
+        message: {
+            method: method.toUpperCase(),
+            path,
+            timestamp,
+            nonce,
+        },
+    });
+    return {
+        "X-Pay-Agent": account.address,
+        "X-Pay-Signature": signature,
+        "X-Pay-Timestamp": timestamp.toString(),
+        "X-Pay-Nonce": nonce,
+    };
+}
+/**
+ * Build auth headers using a generic signer (Signer interface).
+ * Computes the EIP-712 hash manually and delegates signing to the signer.
+ */
+export function buildAuthHeadersWithSigner(signer, method, path, config) {
+    const timestamp = BigInt(Math.floor(Date.now() / 1000));
+    const nonce = ("0x" + randomBytes(32).toString("hex"));
+    const hash = computeEip712Hash(method.toUpperCase(), path, timestamp, nonce, config.chainId, config.routerAddress);
+    const sigBytes = signer.sign(hash);
+    const signature = ("0x" + Buffer.from(sigBytes).toString("hex"));
+    return {
+        "X-Pay-Agent": signer.address,
+        "X-Pay-Signature": signature,
+        "X-Pay-Timestamp": timestamp.toString(),
+        "X-Pay-Nonce": nonce,
+    };
+}
+/**
+ * Compute the EIP-712 hash for an APIRequest.
+ * Must match the server's computation exactly.
+ */
+export function computeEip712Hash(method, path, timestamp, nonce, chainId, verifyingContract) {
+    // Type hashes
+    const domainTypehash = keccak256(encodePacked(["string"], [
+        "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)",
+    ]));
+    const structTypehash = keccak256(encodePacked(["string"], [
+        "APIRequest(string method,string path,uint256 timestamp,bytes32 nonce)",
+    ]));
+    // Domain separator
+    const nameHash = keccak256(encodePacked(["string"], ["pay"]));
+    const versionHash = keccak256(encodePacked(["string"], ["0.1"]));
+    const domainSeparator = keccak256(encodePacked(["bytes32", "bytes32", "bytes32", "uint256", "address"], [
+        domainTypehash,
+        nameHash,
+        versionHash,
+        BigInt(chainId),
+        verifyingContract,
+    ]));
+    // Struct hash
+    const methodHash = keccak256(encodePacked(["string"], [method]));
+    const pathHash = keccak256(encodePacked(["string"], [path]));
+    // Pad nonce to bytes32
+    const nonceClean = nonce.startsWith("0x") ? nonce.slice(2) : nonce;
+    const noncePadded = ("0x" + nonceClean.padEnd(64, "0"));
+    const structHash = keccak256(encodePacked(["bytes32", "bytes32", "bytes32", "uint256", "bytes32"], [structTypehash, methodHash, pathHash, timestamp, noncePadded]));
+    // Final hash: keccak256("\x19\x01" || domainSeparator || structHash)
+    const finalHash = keccak256(encodePacked(["bytes2", "bytes32", "bytes32"], ["0x1901", domainSeparator, structHash]));
+    return hexToBytes(finalHash);
+}
+function hexToBytes(hex) {
+    const clean = hex.startsWith("0x") ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,93 @@
+/**
+ * PayClient — single entry point for the pay SDK.
+ */
+import type { DirectPaymentResult, StatusResponse, Tab, WebhookRegistration } from "./models.js";
+import type { Signer } from "./signer.js";
+export declare const DEFAULT_API_URL = "https://pay-skill.com/api/v1";
+export interface PayClientOptions {
+    apiUrl?: string;
+    signer?: Signer | "cli" | "raw" | "custom";
+    signerOptions?: {
+        command?: string;
+        key?: string;
+        address?: string;
+        callback?: (hash: Uint8Array) => Uint8Array;
+    };
+    /** Private key for direct auth signing (alternative to signer). */
+    privateKey?: string;
+    /** Chain ID for EIP-712 domain (default: 8453 for Base). */
+    chainId?: number;
+    /** Router contract address for EIP-712 domain. */
+    routerAddress?: string;
+}
+export declare class PayClient {
+    private readonly apiUrl;
+    /** URL path prefix extracted from apiUrl (e.g., "/api/v1"). */
+    private readonly _basePath;
+    private readonly signer;
+    private readonly _privateKey;
+    private readonly _authConfig;
+    constructor(options?: PayClientOptions);
+    payDirect(to: string, amount: number, options?: {
+        memo?: string;
+    }): Promise<DirectPaymentResult>;
+    openTab(provider: string, amount: number, options: {
+        maxChargePerCall: number;
+    }): Promise<Tab>;
+    closeTab(tabId: string): Promise<Tab>;
+    withdrawTab(tabId: string): Promise<Tab>;
+    topUpTab(tabId: string, amount: number): Promise<Tab>;
+    listTabs(): Promise<Tab[]>;
+    getTab(tabId: string): Promise<Tab>;
+    private static readonly X402_TAB_MULTIPLIER;
+    request(url: string, options?: {
+        method?: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<Response>;
+    /**
+     * Parse x402 V2 payment requirements from a 402 response.
+     *
+     * Checks PAYMENT-REQUIRED header first (base64-encoded JSON),
+     * falls back to response body. Requires x402Version 2 with
+     * a non-empty `accepts` array.
+     */
+    private parse402Requirements;
+    /** Decode a base64 header and extract v2 requirements, or null if not v2. */
+    private tryParseV2;
+    private extractFromAccepted;
+    private handle402;
+    private settleViaDirect;
+    private settleViaTab;
+    getStatus(): Promise<StatusResponse>;
+    registerWebhook(url: string, options?: {
+        events?: string[];
+        secret?: string;
+    }): Promise<WebhookRegistration>;
+    listWebhooks(): Promise<WebhookRegistration[]>;
+    deleteWebhook(webhookId: string): Promise<void>;
+    /** Create a one-time fund link via the server. Returns the dashboard URL. */
+    createFundLink(options?: {
+        messages?: unknown[];
+        agentName?: string;
+    }): Promise<string>;
+    /** Create a one-time withdraw link via the server. Returns the dashboard URL. */
+    createWithdrawLink(options?: {
+        messages?: unknown[];
+        agentName?: string;
+    }): Promise<string>;
+    /**
+     * Prepare and sign a USDC EIP-2612 permit.
+     *
+     * 1. Calls GET /api/v1/permit/prepare to get the EIP-712 hash
+     * 2. Signs the hash with the agent's private key
+     * 3. Returns {nonce, deadline, v, r, s} for inclusion in payment body
+     */
+    private prepareAndSignPermit;
+    private authHeaders;
+    private get;
+    private post;
+    private del;
+    private handleResponse;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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