@pay-skill/sdk 0.1.1 → 0.1.3

package/src/eip3009.ts

@@ -1,79 +1,79 @@
-/**
- * EIP-3009 TransferWithAuthorization signing for x402 direct settlement.
- *
- * Unlike EIP-2612 permits (which need a nonce from the USDC contract),
- * EIP-3009 uses a random nonce chosen by the signer. Fully local — no
- * server round-trip needed.
- *
- * Domain: { name: "USD Coin", version: "2", chainId, verifyingContract: usdcAddress }
- * Type: TransferWithAuthorization(address from, address to, uint256 value,
- *       uint256 validAfter, uint256 validBefore, bytes32 nonce)
- */
-
-import { type Hex, type Address } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
-import { randomBytes } from "node:crypto";
-
-export interface TransferAuthorization {
-  from: string;
-  to: string;
-  amount: number;
-  nonce: string;
-  v: number;
-  r: string;
-  s: string;
-}
-
-const TRANSFER_AUTH_TYPES = {
-  TransferWithAuthorization: [
-    { name: "from", type: "address" },
-    { name: "to", type: "address" },
-    { name: "value", type: "uint256" },
-    { name: "validAfter", type: "uint256" },
-    { name: "validBefore", type: "uint256" },
-    { name: "nonce", type: "bytes32" },
-  ],
-} as const;
-
-export async function signTransferAuthorization(
-  privateKey: Hex,
-  to: Address,
-  amount: number,
-  chainId: number,
-  usdcAddress: Address,
-): Promise<TransferAuthorization> {
-  const account = privateKeyToAccount(privateKey);
-  const nonce = ("0x" + randomBytes(32).toString("hex")) as Hex;
-
-  const signature = await account.signTypedData({
-    domain: {
-      name: "USD Coin",
-      version: "2",
-      chainId,
-      verifyingContract: usdcAddress,
-    },
-    types: TRANSFER_AUTH_TYPES,
-    primaryType: "TransferWithAuthorization",
-    message: {
-      from: account.address,
-      to,
-      value: BigInt(amount),
-      validAfter: 0n,
-      validBefore: 0n,
-      nonce,
-    },
-  });
-
-  const sigHex = signature.slice(2);
-  const r = `0x${sigHex.slice(0, 64)}`;
-  const s = `0x${sigHex.slice(64, 128)}`;
-  const v = parseInt(sigHex.slice(128, 130), 16);
-
-  return { from: account.address, to, amount, nonce, v, r, s };
-}
-
-export function combinedSignature(auth: TransferAuthorization): string {
-  const r = auth.r.startsWith("0x") ? auth.r.slice(2) : auth.r;
-  const s = auth.s.startsWith("0x") ? auth.s.slice(2) : auth.s;
-  return `0x${r}${s}${auth.v.toString(16).padStart(2, "0")}`;
-}
+/**
+ * EIP-3009 TransferWithAuthorization signing for x402 direct settlement.
+ *
+ * Unlike EIP-2612 permits (which need a nonce from the USDC contract),
+ * EIP-3009 uses a random nonce chosen by the signer. Fully local — no
+ * server round-trip needed.
+ *
+ * Domain: { name: "USD Coin", version: "2", chainId, verifyingContract: usdcAddress }
+ * Type: TransferWithAuthorization(address from, address to, uint256 value,
+ *       uint256 validAfter, uint256 validBefore, bytes32 nonce)
+ */
+
+import { type Hex, type Address } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { randomBytes } from "node:crypto";
+
+export interface TransferAuthorization {
+  from: string;
+  to: string;
+  amount: number;
+  nonce: string;
+  v: number;
+  r: string;
+  s: string;
+}
+
+const TRANSFER_AUTH_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" },
+  ],
+} as const;
+
+export async function signTransferAuthorization(
+  privateKey: Hex,
+  to: Address,
+  amount: number,
+  chainId: number,
+  usdcAddress: Address,
+): Promise<TransferAuthorization> {
+  const account = privateKeyToAccount(privateKey);
+  const nonce = ("0x" + randomBytes(32).toString("hex")) as Hex;
+
+  const signature = await account.signTypedData({
+    domain: {
+      name: "USD Coin",
+      version: "2",
+      chainId,
+      verifyingContract: usdcAddress,
+    },
+    types: TRANSFER_AUTH_TYPES,
+    primaryType: "TransferWithAuthorization",
+    message: {
+      from: account.address,
+      to,
+      value: BigInt(amount),
+      validAfter: 0n,
+      validBefore: 0n,
+      nonce,
+    },
+  });
+
+  const sigHex = signature.slice(2);
+  const r = `0x${sigHex.slice(0, 64)}`;
+  const s = `0x${sigHex.slice(64, 128)}`;
+  const v = parseInt(sigHex.slice(128, 130), 16);
+
+  return { from: account.address, to, amount, nonce, v, r, s };
+}
+
+export function combinedSignature(auth: TransferAuthorization): string {
+  const r = auth.r.startsWith("0x") ? auth.r.slice(2) : auth.r;
+  const s = auth.s.startsWith("0x") ? auth.s.slice(2) : auth.s;
+  return `0x${r}${s}${auth.v.toString(16).padStart(2, "0")}`;
+}

package/src/index.ts

@@ -1,51 +1,51 @@
-export { PayClient, DEFAULT_API_URL } from "./client.js";
-export type { PayClientOptions } from "./client.js";
-
-export {
-  PayError,
-  PayValidationError,
-  PayNetworkError,
-  PayServerError,
-  PayInsufficientFundsError,
-} from "./errors.js";
-
-export type {
-  DirectPaymentResult,
-  DiscoverOptions,
-  DiscoverService,
-  Tab,
-  TabStatus,
-  StatusResponse,
-  WebhookRegistration,
-} from "./models.js";
-
-export type { Signer } from "./signer.js";
-export {
-  CliSigner,
-  RawKeySigner,
-  CallbackSigner,
-  createSigner,
-} from "./signer.js";
-
-export { OwsSigner } from "./ows-signer.js";
-export type { OwsSignerOptions } from "./ows-signer.js";
-
-export { Wallet, PrivateKeySigner } from "./wallet.js";
-export type {
-  WalletOptions,
-  FundLinkOptions,
-  PermitResult,
-} from "./wallet.js";
-
-export {
-  buildAuthHeaders,
-  buildAuthHeadersWithSigner,
-  computeEip712Hash,
-} from "./auth.js";
-export type { AuthConfig, AuthHeaders } from "./auth.js";
-
-export {
-  signTransferAuthorization,
-  combinedSignature,
-} from "./eip3009.js";
-export type { TransferAuthorization } from "./eip3009.js";
+export { PayClient, DEFAULT_API_URL } from "./client.js";
+export type { PayClientOptions } from "./client.js";
+
+export {
+  PayError,
+  PayValidationError,
+  PayNetworkError,
+  PayServerError,
+  PayInsufficientFundsError,
+} from "./errors.js";
+
+export type {
+  DirectPaymentResult,
+  DiscoverOptions,
+  DiscoverService,
+  Tab,
+  TabStatus,
+  StatusResponse,
+  WebhookRegistration,
+} from "./models.js";
+
+export type { Signer } from "./signer.js";
+export {
+  CliSigner,
+  RawKeySigner,
+  CallbackSigner,
+  createSigner,
+} from "./signer.js";
+
+export { OwsSigner } from "./ows-signer.js";
+export type { OwsSignerOptions } from "./ows-signer.js";
+
+export { Wallet, PrivateKeySigner } from "./wallet.js";
+export type {
+  WalletOptions,
+  FundLinkOptions,
+  PermitResult,
+} from "./wallet.js";
+
+export {
+  buildAuthHeaders,
+  buildAuthHeadersWithSigner,
+  computeEip712Hash,
+} from "./auth.js";
+export type { AuthConfig, AuthHeaders } from "./auth.js";
+
+export {
+  signTransferAuthorization,
+  combinedSignature,
+} from "./eip3009.js";
+export type { TransferAuthorization } from "./eip3009.js";

package/src/models.ts

@@ -1,77 +1,77 @@
-/** Tab lifecycle states. */
-export type TabStatus = "open" | "closed";
-
-/** Result of a direct payment. */
-export interface DirectPaymentResult {
-  txHash: string;
-  status: string;
-  /** Amount in USDC micro-units (6 decimals). */
-  amount: number;
-  /** Fee deducted in USDC micro-units. */
-  fee: number;
-}
-
-/** Tab state. */
-export interface Tab {
-  tabId: string;
-  provider: string;
-  /** Total locked amount in USDC micro-units. */
-  amount: number;
-  /** Remaining balance in USDC micro-units. */
-  balanceRemaining: number;
-  /** Total charged so far in USDC micro-units. */
-  totalCharged: number;
-  /** Number of charges made. */
-  chargeCount: number;
-  /** Max per-charge limit in USDC micro-units. */
-  maxChargePerCall: number;
-  /** Total withdrawn so far in USDC micro-units. */
-  totalWithdrawn: number;
-  status: TabStatus;
-  /** Number of charges buffered awaiting batch settlement. */
-  pendingChargeCount: number;
-  /** Total amount of pending charges in USDC micro-units. */
-  pendingChargeTotal: number;
-  /** balance_remaining minus pending charges — the true available balance. */
-  effectiveBalance: number;
-}
-
-/** Wallet status. */
-export interface StatusResponse {
-  address: string;
-  /** USDC balance in micro-units. */
-  balance: number;
-  openTabs: Tab[];
-}
-
-/** Discoverable service from the facilitator catalog. */
-export interface DiscoverService {
-  name: string;
-  description: string;
-  /** Public base URL for pay request (e.g. "https://weather.example.com"). */
-  baseUrl: string;
-  category: string;
-  keywords: string[];
-  routes: { path: string; method?: string; price?: string; settlement?: string; free?: boolean }[];
-  /** URL to API documentation (OpenAPI spec, docs page, etc). */
-  docsUrl?: string;
-}
-
-/** Options for discover search. */
-export interface DiscoverOptions {
-  /** Search query (matches keywords and description). */
-  query?: string;
-  /** Sort order: "volume" (default), "newest", "price_asc", "price_desc". */
-  sort?: string;
-  /** Filter by category. */
-  category?: string;
-  /** Filter by settlement mode: "direct" or "tab". */
-  settlement?: string;
-}
-
-/** Registered webhook. */
-export interface WebhookRegistration {
-  webhookId: string;
-  url: string;
-  events: string[];
-}
+/** Tab lifecycle states. */
+export type TabStatus = "open" | "closed";
+
+/** Result of a direct payment. */
+export interface DirectPaymentResult {
+  txHash: string;
+  status: string;
+  /** Amount in USDC micro-units (6 decimals). */
+  amount: number;
+  /** Fee deducted in USDC micro-units. */
+  fee: number;
+}
+
+/** Tab state. */
+export interface Tab {
+  tabId: string;
+  provider: string;
+  /** Total locked amount in USDC micro-units. */
+  amount: number;
+  /** Remaining balance in USDC micro-units. */
+  balanceRemaining: number;
+  /** Total charged so far in USDC micro-units. */
+  totalCharged: number;
+  /** Number of charges made. */
+  chargeCount: number;
+  /** Max per-charge limit in USDC micro-units. */
+  maxChargePerCall: number;
+  /** Total withdrawn so far in USDC micro-units. */
+  totalWithdrawn: number;
+  status: TabStatus;
+  /** Number of charges buffered awaiting batch settlement. */
+  pendingChargeCount: number;
+  /** Total amount of pending charges in USDC micro-units. */
+  pendingChargeTotal: number;
+  /** balance_remaining minus pending charges — the true available balance. */
+  effectiveBalance: number;
+}
+
+/** Wallet status. */
+export interface StatusResponse {
+  address: string;
+  /** USDC balance in micro-units. */
+  balance: number;
+  openTabs: Tab[];
+}
+
+/** Discoverable service from the facilitator catalog. */
+export interface DiscoverService {
+  name: string;
+  description: string;
+  /** Public base URL for pay request (e.g. "https://weather.example.com"). */
+  baseUrl: string;
+  category: string;
+  keywords: string[];
+  routes: { path: string; method?: string; price?: string; settlement?: string; free?: boolean }[];
+  /** URL to API documentation (OpenAPI spec, docs page, etc). */
+  docsUrl?: string;
+}
+
+/** Options for discover search. */
+export interface DiscoverOptions {
+  /** Search query (matches keywords and description). */
+  query?: string;
+  /** Sort order: "volume" (default), "newest", "price_asc", "price_desc". */
+  sort?: string;
+  /** Filter by category. */
+  category?: string;
+  /** Filter by settlement mode: "direct" or "tab". */
+  settlement?: string;
+}
+
+/** Registered webhook. */
+export interface WebhookRegistration {
+  webhookId: string;
+  url: string;
+  events: string[];
+}