@haven_ai/sdk 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/signer.ts","../src/x402.ts","../src/client.ts","../src/tools.ts"],"names":["ethers"],"mappings":"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","file":"index.cjs","sourcesContent":["// ── Client Configuration ─────────────────────────────────────────\n\nexport interface HavenClientConfig {\n  /** Haven API key (sk_agent_xxx) */\n  apiKey: string\n\n  /** Agent's delegate EOA private key. If provided, the SDK handles signing automatically. */\n  delegateKey?: string\n\n  /** Haven API base URL (default: http://localhost:3001) */\n  baseUrl?: string\n\n  /** Timeout in ms for individual HTTP requests (default: 30000) */\n  requestTimeout?: number\n\n  /** Timeout in ms when polling for tx confirmation (default: 90000) */\n  confirmationTimeout?: number\n\n  /** Polling interval in ms when waiting for confirmation (default: 3000) */\n  pollingInterval?: number\n}\n\n// ── Payment Types ────────────────────────────────────────────────\n\nexport interface PaymentRequest {\n  /** Token symbol: \"EURe\", \"USDC.e\", or \"xDAI\" */\n  token: string\n\n  /** Amount as a decimal string, e.g. \"5.00\" */\n  amount: string\n\n  /** Recipient Ethereum address (0x...) */\n  to: string\n}\n\nexport interface SignData {\n  /** The hash to sign (keccak256, 0x-prefixed) */\n  hash: string\n\n  /** Breakdown of values that were hashed — useful for debugging */\n  components: {\n    safe: string\n    token: string\n    to: string\n    amount: string\n    payment_token: string\n    payment: string\n    nonce: number\n  }\n\n  /** Human-readable signing instructions */\n  instructions: string\n}\n\nexport interface PaymentIntent {\n  /** Unique payment ID */\n  paymentId: string\n\n  /** Current status */\n  status: 'pending_signature'\n\n  /** ISO 8601 expiry timestamp */\n  expiresAt: string\n\n  /** Data needed to sign the payment */\n  signData: SignData\n}\n\nexport type PaymentStatus =\n  | 'pending_signature'\n  | 'submitted'\n  | 'confirmed'\n  | 'expired'\n  | 'failed'\n\nexport interface PaymentResult {\n  /** Unique payment ID */\n  paymentId: string\n\n  /** Final status */\n  status: PaymentStatus\n\n  /** Token that was sent */\n  token: string\n\n  /** Amount that was sent (human-readable) */\n  amount: string\n\n  /** Recipient address */\n  to: string\n\n  /** On-chain transaction hash (present when confirmed) */\n  txHash: string | null\n\n  /** Error message (present when failed) */\n  errorMessage: string | null\n\n  /** Block explorer URL for the transaction (chain-dependent) */\n  explorerUrl: string | null\n\n  /** ISO 8601 timestamps */\n  createdAt: string\n  signedAt: string | null\n  submittedAt: string | null\n  confirmedAt: string | null\n  expiresAt: string\n}\n\n// ── x402 Types ──────────────────────────────────────────────────\n\n/** Payment requirements from an HTTP 402 response (x402 protocol). */\nexport interface X402PaymentRequired {\n  x402Version: number\n  resource: {\n    url: string\n    description?: string\n    mimeType?: string\n  }\n  accepts: X402PaymentOption[]\n  error?: string\n}\n\n/** A single payment option from x402 PaymentRequired. */\nexport interface X402PaymentOption {\n  scheme: string             // \"exact\"\n  network: string            // CAIP-2 chain ID, e.g. \"eip155:100\"\n  amount: string             // Atomic units\n  asset: string              // Token contract address\n  payTo: string              // Recipient address\n  maxTimeoutSeconds: number\n  extra?: Record<string, unknown>\n}\n\n/** Receipt returned after a successful x402 payment. */\nexport interface X402Receipt {\n  success: boolean\n  paymentId: string\n  txHash: string\n  token: string\n  amount: string\n  to: string\n  resourceUrl: string\n  explorerUrl: string\n}\n\n/** @internal */\nexport interface RawX402AuthorizeResponse {\n  success?: boolean\n  payment_id: string\n  status: string\n  tx_hash?: string\n  chain_id?: number\n  token?: string\n  amount?: string\n  to?: string\n  resource_url?: string\n  explorer_url?: string\n  expires_at?: string\n  sign_data?: {\n    hash: string\n    components: {\n      safe: string\n      token: string\n      to: string\n      amount: string\n      payment_token: string\n      payment: string\n      nonce: number\n    }\n    instructions: string\n  }\n  error?: string\n}\n\n// ── API Response Shapes (raw, snake_case from server) ────────────\n\n/** @internal */\nexport interface RawCreateResponse {\n  payment_id: string\n  status: string\n  expires_at: string\n  sign_data: {\n    hash: string\n    components: {\n      safe: string\n      token: string\n      to: string\n      amount: string\n      payment_token: string\n      payment: string\n      nonce: number\n    }\n    instructions: string\n  }\n  error?: string\n  supported?: string[]\n}\n\n/** @internal */\nexport interface RawSignResponse {\n  payment_id: string\n  status: string\n  tx_hash?: string\n  token?: string\n  amount?: string\n  to?: string\n  explorer_url?: string\n  chain_id?: number\n  error?: string\n  details?: string\n}\n\n/** @internal */\nexport interface RawStatusResponse {\n  payment_id: string\n  status: string\n  token: string\n  amount: string\n  to: string\n  tx_hash: string | null\n  explorer_url?: string | null\n  chain_id?: number\n  error_message: string | null\n  created_at: string\n  signed_at: string | null\n  submitted_at: string | null\n  confirmed_at: string | null\n  expires_at: string\n}\n\n// ── Error Types ──────────────────────────────────────────────────\n\nexport class HavenError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly statusCode?: number,\n    public readonly paymentId?: string,\n  ) {\n    super(message)\n    this.name = 'HavenError'\n  }\n}\n\nexport class HavenApiError extends HavenError {\n  constructor(\n    message: string,\n    statusCode: number,\n    public readonly body?: unknown,\n  ) {\n    super(message, 'API_ERROR', statusCode)\n    this.name = 'HavenApiError'\n  }\n}\n\nexport class HavenSigningError extends HavenError {\n  constructor(message: string) {\n    super(message, 'SIGNING_ERROR')\n    this.name = 'HavenSigningError'\n  }\n}\n\nexport class HavenTimeoutError extends HavenError {\n  constructor(paymentId: string) {\n    super(\n      `Timed out waiting for payment ${paymentId} to confirm`,\n      'TIMEOUT',\n      undefined,\n      paymentId,\n    )\n    this.name = 'HavenTimeoutError'\n  }\n}\n","import { ethers } from 'ethers'\nimport { HavenSigningError } from './types.js'\n\n/**\n * Sign a hash using raw ECDSA (no Ethereum message prefix).\n *\n * This matches what Safe's AllowanceModule `checkSignature` expects —\n * a direct ecrecover over the hash, NOT the \"\\x19Ethereum Signed Message\" variant.\n *\n * Uses ethers.SigningKey.sign() instead of wallet.signMessage() to avoid the prefix.\n */\nexport function signHash(privateKey: string, hash: string): string {\n  try {\n    const signingKey = new ethers.SigningKey(privateKey)\n    const sig = signingKey.sign(hash)\n    return sig.serialized // 0x + r(32) + s(32) + v(1)\n  } catch (err) {\n    throw new HavenSigningError(\n      `Failed to sign hash: ${err instanceof Error ? err.message : String(err)}`,\n    )\n  }\n}\n\n/**\n * Derive the Ethereum address from a private key.\n */\nexport function addressFromKey(privateKey: string): string {\n  try {\n    return new ethers.Wallet(privateKey).address\n  } catch (err) {\n    throw new HavenSigningError(\n      `Invalid private key: ${err instanceof Error ? err.message : String(err)}`,\n    )\n  }\n}\n\n/**\n * Verify that a signature over a hash recovers to the expected address.\n */\nexport function verifySignature(hash: string, signature: string, expectedAddress: string): boolean {\n  try {\n    const recovered = ethers.recoverAddress(hash, signature)\n    return recovered.toLowerCase() === expectedAddress.toLowerCase()\n  } catch {\n    return false\n  }\n}\n","/**\n * x402 protocol support for the Haven SDK.\n *\n * Provides:\n * - parsePaymentRequired() — extract payment requirements from a 402 response\n * - encodePaymentProof()   — encode a receipt as a PAYMENT-SIGNATURE header\n *\n * The main authorizeX402() and fetchWithPayment() are methods on HavenClient\n * (see client.ts) since they need API access and signing.\n */\n\nimport type { X402PaymentRequired, X402PaymentOption } from './types.js'\n\n// ── Supported networks (CAIP-2 chain IDs) ────────────────────────\n\n/** CAIP-2 chain IDs that Haven supports for x402 payments. */\nexport const SUPPORTED_X402_NETWORKS: Record<string, string> = {\n  'eip155:100':  'Gnosis Chain',\n  'eip155:8453': 'Base',\n}\n\n// ── Token address maps ────────────────────────────────────────────\n\n/** Known tokens on Gnosis Chain (chainId 100). */\nconst GNOSIS_TOKENS: Record<string, { symbol: string; decimals: number }> = {\n  '0x0000000000000000000000000000000000000000': { symbol: 'xDAI',   decimals: 18 },\n  '0xcb444e90d8198415266c6a2724b7900fb12fc56e': { symbol: 'EURe',   decimals: 18 },\n  '0x2a22f9c3b484c3629090feed35f17ff8f88f76f0': { symbol: 'USDC.e', decimals: 6  },\n}\n\n/** Known tokens on Base (chainId 8453). */\nconst BASE_TOKENS: Record<string, { symbol: string; decimals: number }> = {\n  '0x0000000000000000000000000000000000000000': { symbol: 'ETH',  decimals: 18 },\n  '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913': { symbol: 'USDC', decimals: 6  },\n}\n\n/** All known tokens across all supported chains (for display / resolution). */\nconst ALL_TOKENS: Record<string, { symbol: string; decimals: number }> = {\n  ...GNOSIS_TOKENS,\n  ...BASE_TOKENS,\n}\n\n/** Maps CAIP-2 network ID → token address map. */\nconst NETWORK_TOKENS: Record<string, Record<string, { symbol: string; decimals: number }>> = {\n  'eip155:100':  GNOSIS_TOKENS,\n  'eip155:8453': BASE_TOKENS,\n}\n\n// ── Parser ───────────────────────────────────────────────────────\n\n/**\n * Parse an HTTP 402 response into x402 PaymentRequired data.\n *\n * Supports:\n * - v2: PAYMENT-REQUIRED header (base64 JSON)\n * - v1 fallback: X-PAYMENT header or response body\n */\nexport function parsePaymentRequired(response: Response): X402PaymentRequired {\n  // v2: PAYMENT-REQUIRED header\n  const v2Header = response.headers.get('PAYMENT-REQUIRED')\n  if (v2Header) {\n    try {\n      return JSON.parse(atob(v2Header)) as X402PaymentRequired\n    } catch {\n      throw new Error('Failed to decode PAYMENT-REQUIRED header')\n    }\n  }\n\n  // v1: X-PAYMENT header\n  const v1Header = response.headers.get('X-PAYMENT')\n  if (v1Header) {\n    try {\n      return JSON.parse(atob(v1Header)) as X402PaymentRequired\n    } catch {\n      throw new Error('Failed to decode X-PAYMENT header')\n    }\n  }\n\n  throw new Error(\n    'No x402 payment headers found in 402 response. ' +\n    'Expected PAYMENT-REQUIRED (v2) or X-PAYMENT (v1) header.',\n  )\n}\n\n/**\n * Select the best payment option from the x402 accepts array.\n *\n * Preference order:\n * 1. Option on a Haven-supported network with a known token\n * 2. Any option on a Haven-supported network\n * 3. null — no compatible option\n */\nexport function selectPaymentOption(\n  accepts: X402PaymentOption[],\n): X402PaymentOption | null {\n  if (!accepts || accepts.length === 0) return null\n\n  // First pass: find a supported network with a known token\n  for (const opt of accepts) {\n    if (opt.network in SUPPORTED_X402_NETWORKS) {\n      const networkTokens = NETWORK_TOKENS[opt.network]\n      if (networkTokens?.[opt.asset.toLowerCase()]) return opt\n    }\n  }\n\n  // Second pass: any supported network\n  for (const opt of accepts) {\n    if (opt.network in SUPPORTED_X402_NETWORKS) {\n      return opt\n    }\n  }\n\n  // No compatible option found\n  return null\n}\n\n/**\n * Encode a payment receipt as a base64 PAYMENT-SIGNATURE header value.\n *\n * This follows the x402 v2 protocol — the server's facilitator will\n * verify the on-chain transaction referenced by tx_hash.\n */\nexport function encodePaymentProof(receipt: {\n  txHash: string\n  paymentId: string\n  token: string\n  amount: string\n  to: string\n}): string {\n  const payload = {\n    x402Version: 2,\n    payload: {\n      txHash: receipt.txHash,\n      paymentId: receipt.paymentId,\n      settledVia: 'haven',\n    },\n  }\n  return btoa(JSON.stringify(payload))\n}\n\n/**\n * Resolve a token symbol from a contract address.\n *\n * Checks all supported chains. For chain-specific resolution,\n * pass the optional `network` CAIP-2 string (e.g. \"eip155:100\").\n */\nexport function resolveTokenFromAddress(\n  address: string,\n  network?: string,\n): { symbol: string; decimals: number } | null {\n  const lower = address.toLowerCase()\n\n  if (network && network in NETWORK_TOKENS) {\n    return NETWORK_TOKENS[network][lower] ?? null\n  }\n\n  return ALL_TOKENS[lower] ?? null\n}\n","import { signHash, addressFromKey, verifySignature } from './signer.js'\nimport type {\n  HavenClientConfig,\n  PaymentRequest,\n  PaymentIntent,\n  PaymentResult,\n  PaymentStatus,\n  SignData,\n  RawCreateResponse,\n  RawSignResponse,\n  RawStatusResponse,\n  X402PaymentRequired,\n  X402Receipt,\n  RawX402AuthorizeResponse,\n} from './types.js'\nimport {\n  HavenApiError,\n  HavenSigningError,\n  HavenTimeoutError,\n} from './types.js'\nimport {\n  parsePaymentRequired,\n  selectPaymentOption,\n  encodePaymentProof,\n} from './x402.js'\n\nconst DEFAULT_BASE_URL = 'http://localhost:3001'\n\nconst CHAIN_EXPLORER_TX: Record<number, string> = {\n  100:  'https://gnosisscan.io/tx',\n  8453: 'https://basescan.org/tx',\n}\n\nfunction buildExplorerUrl(chainId: number | undefined, txHash: string): string {\n  const base = CHAIN_EXPLORER_TX[chainId ?? 100] ?? CHAIN_EXPLORER_TX[100]\n  return `${base}/${txHash}`\n}\nconst DEFAULT_REQUEST_TIMEOUT = 30_000\nconst DEFAULT_CONFIRMATION_TIMEOUT = 90_000\nconst DEFAULT_POLLING_INTERVAL = 3_000\n\nexport class HavenClient {\n  private readonly apiKey: string\n  private readonly delegateKey: string | undefined\n  private readonly baseUrl: string\n  private readonly requestTimeout: number\n  private readonly confirmationTimeout: number\n  private readonly pollingInterval: number\n\n  /** Delegate address derived from the private key (if provided) */\n  readonly delegateAddress: string | undefined\n\n  constructor(config: HavenClientConfig) {\n    this.apiKey = config.apiKey\n    this.delegateKey = config.delegateKey\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, '')\n    this.requestTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT\n    this.confirmationTimeout = config.confirmationTimeout ?? DEFAULT_CONFIRMATION_TIMEOUT\n    this.pollingInterval = config.pollingInterval ?? DEFAULT_POLLING_INTERVAL\n\n    if (this.delegateKey) {\n      this.delegateAddress = addressFromKey(this.delegateKey)\n    }\n  }\n\n  // ── High-Level API ───────────────────────────────────────────────\n\n  /**\n   * Send a payment in one call.\n   *\n   * Creates the intent, signs the hash, submits the signature,\n   * and polls until confirmed (or throws on failure/timeout).\n   *\n   * Requires `delegateKey` to be set in the client config.\n   */\n  async pay(request: PaymentRequest): Promise<PaymentResult> {\n    if (!this.delegateKey) {\n      throw new HavenSigningError(\n        'Cannot use pay() without a delegateKey. Use createIntent() + submitSignature() for manual signing.',\n      )\n    }\n\n    // Step 1: Create intent\n    const intent = await this.createIntent(request)\n\n    // Step 2: Sign\n    const signature = this.sign(intent.signData.hash)\n\n    // Step 3: Submit\n    await this.submitSignature(intent.paymentId, signature)\n\n    // Step 4: Wait for confirmation\n    return this.waitForConfirmation(intent.paymentId)\n  }\n\n  // ── Step-by-Step API ─────────────────────────────────────────────\n\n  /**\n   * Step 1: Create a payment intent.\n   *\n   * Returns the intent with the hash to sign.\n   */\n  async createIntent(request: PaymentRequest): Promise<PaymentIntent> {\n    const raw = await this.post<RawCreateResponse>('/payments', {\n      token: request.token,\n      amount: request.amount,\n      to: request.to,\n    })\n\n    return {\n      paymentId: raw.payment_id,\n      status: 'pending_signature',\n      expiresAt: raw.expires_at,\n      signData: raw.sign_data,\n    }\n  }\n\n  /**\n   * Step 2: Sign a hash with the delegate key.\n   *\n   * Returns the 65-byte signature (0x-prefixed).\n   * Requires `delegateKey` to be set in the client config.\n   */\n  sign(hash: string): string {\n    if (!this.delegateKey) {\n      throw new HavenSigningError(\n        'Cannot sign without a delegateKey. Pass the private key in HavenClient config, or sign externally.',\n      )\n    }\n\n    const signature = signHash(this.delegateKey, hash)\n\n    // Verify the signature locally before submitting\n    if (!verifySignature(hash, signature, this.delegateAddress!)) {\n      throw new HavenSigningError(\n        'Local signature verification failed — recovered address does not match delegate key.',\n      )\n    }\n\n    return signature\n  }\n\n  /**\n   * Step 3: Submit a signature to execute the payment.\n   *\n   * The signature can come from `client.sign()` or from external signing.\n   */\n  async submitSignature(\n    paymentId: string,\n    signature: string,\n  ): Promise<{ status: string; txHash?: string }> {\n    const raw = await this.post<RawSignResponse>(\n      `/payments/${paymentId}/sign`,\n      { signature },\n    )\n\n    return {\n      status: raw.status,\n      txHash: raw.tx_hash,\n    }\n  }\n\n  /**\n   * Get the current status of a payment.\n   */\n  async getPayment(paymentId: string): Promise<PaymentResult> {\n    const raw = await this.get<RawStatusResponse>(`/payments/${paymentId}`)\n    return this.mapPaymentResult(raw)\n  }\n\n  /**\n   * Poll until a payment reaches a terminal status (confirmed, failed, expired).\n   */\n  async waitForConfirmation(paymentId: string): Promise<PaymentResult> {\n    const deadline = Date.now() + this.confirmationTimeout\n\n    while (Date.now() < deadline) {\n      const result = await this.getPayment(paymentId)\n\n      if (result.status === 'confirmed' || result.status === 'failed' || result.status === 'expired') {\n        return result\n      }\n\n      await sleep(this.pollingInterval)\n    }\n\n    throw new HavenTimeoutError(paymentId)\n  }\n\n  // ── x402 Protocol Support ────────────────────────────────────────\n\n  /**\n   * Authorize an x402 payment.\n   *\n   * Takes the parsed PaymentRequired from a 402 response, selects a\n   * compatible payment option, signs and executes the payment through Haven.\n   *\n   * Requires `delegateKey` to be set in the client config.\n   */\n  async authorizeX402(paymentRequired: X402PaymentRequired): Promise<X402Receipt> {\n    if (!this.delegateKey) {\n      throw new HavenSigningError(\n        'delegateKey is required for x402 payments. Pass it in the HavenClient config.',\n      )\n    }\n\n    // 1. Select best payment option\n    const option = selectPaymentOption(paymentRequired.accepts)\n    if (!option) {\n      throw new HavenApiError(\n        'No compatible payment option found in x402 requirements. ' +\n        'Haven supports Gnosis Chain (eip155:100) and Base (eip155:8453).',\n        400,\n      )\n    }\n\n    // 2. Create intent via x402/authorize (without signature first to get hash)\n    const raw = await this.post<RawX402AuthorizeResponse>('/x402', {\n      url: paymentRequired.resource.url,\n      payTo: option.payTo,\n      amount: option.amount,\n      asset: option.asset,\n      network: option.network,\n      description: paymentRequired.resource.description,\n    })\n\n    // If the backend already executed (shouldn't happen without sig), return\n    if (raw.success && raw.tx_hash) {\n      return {\n        success: true,\n        paymentId: raw.payment_id,\n        txHash: raw.tx_hash,\n        token: raw.token ?? '',\n        amount: raw.amount ?? '',\n        to: raw.to ?? '',\n        resourceUrl: paymentRequired.resource.url,\n        explorerUrl: raw.explorer_url ?? (raw.tx_hash ? buildExplorerUrl(raw.chain_id, raw.tx_hash) : ''),\n      }\n    }\n\n    // 3. Sign the hash\n    if (!raw.sign_data?.hash) {\n      throw new HavenApiError('No sign_hash returned from x402/authorize', 500, raw)\n    }\n    const sig = signHash(this.delegateKey, raw.sign_data.hash)\n\n    // 4. Submit signature (reuse existing payments/:id/sign endpoint)\n    const execResult = await this.post<RawSignResponse>(\n      `/payments/${raw.payment_id}/sign`,\n      { signature: sig },\n    )\n\n    if (execResult.status !== 'confirmed') {\n      throw new HavenApiError(\n        execResult.error ?? `x402 payment ${execResult.status}`,\n        502,\n        execResult,\n      )\n    }\n\n    return {\n      success: true,\n      paymentId: raw.payment_id,\n      txHash: execResult.tx_hash ?? '',\n      token: execResult.token ?? raw.token ?? '',\n      amount: execResult.amount ?? raw.amount ?? '',\n      to: execResult.to ?? raw.to ?? '',\n      resourceUrl: paymentRequired.resource.url,\n      explorerUrl: execResult.explorer_url ?? (execResult.tx_hash ? buildExplorerUrl(execResult.chain_id, execResult.tx_hash) : ''),\n    }\n  }\n\n  /**\n   * Fetch wrapper that automatically handles HTTP 402 responses.\n   *\n   * Works like the standard `fetch()` but intercepts 402 responses,\n   * pays via x402 through Haven, and retries the request.\n   *\n   * ```ts\n   * const response = await haven.fetch('https://paid-api.com/data')\n   * const data = await response.json()\n   * ```\n   *\n   * Requires `delegateKey` to be set in the client config.\n   */\n  async fetch(url: string, init?: RequestInit): Promise<Response> {\n    // 1. Make the original request\n    const response = await globalThis.fetch(url, init)\n\n    // 2. Not a 402 — return as-is\n    if (response.status !== 402) return response\n\n    // 3. Parse x402 payment requirements\n    let paymentRequired: X402PaymentRequired\n    try {\n      paymentRequired = parsePaymentRequired(response)\n    } catch {\n      // Not an x402 402 — return original response\n      return response\n    }\n\n    // 4. Pay through Haven\n    const receipt = await this.authorizeX402(paymentRequired)\n\n    // 5. Retry with payment proof\n    const retryHeaders = new Headers(init?.headers)\n    retryHeaders.set('PAYMENT-SIGNATURE', encodePaymentProof(receipt))\n\n    return globalThis.fetch(url, {\n      ...init,\n      headers: retryHeaders,\n    })\n  }\n\n  // ── Tool Execution (for agent frameworks) ────────────────────────\n\n  /**\n   * Execute a tool call by name and input.\n   *\n   * Designed to plug directly into agent tool-call handlers:\n   *\n   * ```ts\n   * if (block.type === 'tool_use') {\n   *   const result = await haven.executeTool(block.name, block.input)\n   *   // send result back to the model\n   * }\n   * ```\n   */\n  async executeTool(\n    toolName: string,\n    input: Record<string, unknown>,\n  ): Promise<Record<string, unknown>> {\n    if (toolName === 'make_payment') {\n      const { token, amount, to } = input as {\n        token: string\n        amount: string\n        to: string\n      }\n\n      try {\n        const result = await this.pay({ token, amount, to })\n        return {\n          success: result.status === 'confirmed',\n          payment_id: result.paymentId,\n          status: result.status,\n          tx_hash: result.txHash,\n          token: result.token,\n          amount: result.amount,\n          to: result.to,\n          explorer_url: result.explorerUrl,\n          error: result.errorMessage,\n        }\n      } catch (err) {\n        return {\n          success: false,\n          error: err instanceof Error ? err.message : String(err),\n        }\n      }\n    }\n\n    if (toolName === 'authorize_x402_payment') {\n      const { url, payTo, amount, asset, network, description } = input as {\n        url: string\n        payTo: string\n        amount: string\n        asset: string\n        network: string\n        description?: string\n      }\n\n      try {\n        const receipt = await this.authorizeX402({\n          x402Version: 2,\n          resource: { url, description },\n          accepts: [\n            {\n              scheme: 'exact',\n              network,\n              amount,\n              asset,\n              payTo,\n              maxTimeoutSeconds: 30,\n            },\n          ],\n        })\n        return {\n          success: true,\n          payment_id: receipt.paymentId,\n          tx_hash: receipt.txHash,\n          token: receipt.token,\n          amount: receipt.amount,\n          to: receipt.to,\n          resource_url: receipt.resourceUrl,\n          explorer_url: receipt.explorerUrl,\n        }\n      } catch (err) {\n        return {\n          success: false,\n          error: err instanceof Error ? err.message : String(err),\n        }\n      }\n    }\n\n    if (toolName === 'get_payment_status') {\n      const { payment_id } = input as { payment_id: string }\n      const result = await this.getPayment(payment_id)\n      return {\n        payment_id: result.paymentId,\n        status: result.status,\n        tx_hash: result.txHash,\n        token: result.token,\n        amount: result.amount,\n        to: result.to,\n        explorer_url: result.explorerUrl,\n      }\n    }\n\n    throw new Error(`Unknown tool: ${toolName}`)\n  }\n\n  // ── HTTP Helpers ─────────────────────────────────────────────────\n\n  private async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    return this.request<T>('POST', path, body)\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    return this.request<T>('GET', path)\n  }\n\n  private async request<T>(\n    method: 'GET' | 'POST',\n    path: string,\n    body?: Record<string, unknown>,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`\n    const controller = new AbortController()\n    const timeout = setTimeout(() => controller.abort(), this.requestTimeout)\n\n    try {\n      const res = await fetch(url, {\n        method,\n        headers: {\n          'Content-Type': 'application/json',\n          'Authorization': `Bearer ${this.apiKey}`,\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      })\n\n      const data = await res.json()\n\n      if (!res.ok) {\n        const message =\n          (data as Record<string, unknown>).error as string\n          ?? (data as Record<string, unknown>).details as string\n          ?? `API request failed`\n        throw new HavenApiError(message, res.status, data)\n      }\n\n      return data as T\n    } catch (err) {\n      if (err instanceof HavenApiError) throw err\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw new HavenApiError(`Request to ${path} timed out`, 408)\n      }\n      throw new HavenApiError(\n        `Request to ${path} failed: ${err instanceof Error ? err.message : String(err)}`,\n        0,\n      )\n    } finally {\n      clearTimeout(timeout)\n    }\n  }\n\n  // ── Mapping Helpers ──────────────────────────────────────────────\n\n  private mapPaymentResult(raw: RawStatusResponse): PaymentResult {\n    return {\n      paymentId: raw.payment_id,\n      status: raw.status as PaymentStatus,\n      token: raw.token,\n      amount: raw.amount,\n      to: raw.to,\n      txHash: raw.tx_hash,\n      errorMessage: raw.error_message,\n      explorerUrl: raw.explorer_url ?? (raw.tx_hash ? buildExplorerUrl(raw.chain_id, raw.tx_hash) : null),\n      createdAt: raw.created_at,\n      signedAt: raw.signed_at,\n      submittedAt: raw.submitted_at,\n      confirmedAt: raw.confirmed_at,\n      expiresAt: raw.expires_at,\n    }\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n","/**\n * Pre-built tool definitions for AI agent frameworks.\n *\n * These definitions describe the `make_payment` and `get_payment_status` tools\n * in the formats expected by Claude (Anthropic) and OpenAI.\n *\n * Usage with Claude:\n *   const response = await anthropic.messages.create({\n *     tools: havenTools.claude(),\n *     ...\n *   })\n *\n * Usage with OpenAI:\n *   const response = await openai.chat.completions.create({\n *     tools: havenTools.openai(),\n *     ...\n *   })\n */\n\n// ── JSON Schema (shared across formats) ──────────────────────────\n\nconst makePaymentSchema = {\n  type: 'object' as const,\n  properties: {\n    token: {\n      type: 'string' as const,\n      description: 'Token to send. Gnosis Chain: EURe, USDC.e, xDAI. Base: USDC, ETH.',\n    },\n    amount: {\n      type: 'string' as const,\n      description: 'Amount to send as a decimal string, e.g. \"5.00\"',\n    },\n    to: {\n      type: 'string' as const,\n      description: 'Recipient Ethereum address (0x...)',\n    },\n    reason: {\n      type: 'string' as const,\n      description: 'Brief reason for this payment (for audit trail)',\n    },\n  },\n  required: ['token', 'amount', 'to', 'reason'] as const,\n}\n\nconst getPaymentStatusSchema = {\n  type: 'object' as const,\n  properties: {\n    payment_id: {\n      type: 'string' as const,\n      description: 'The payment ID returned from make_payment',\n    },\n  },\n  required: ['payment_id'] as const,\n}\n\nconst authorizeX402Schema = {\n  type: 'object' as const,\n  properties: {\n    url: {\n      type: 'string' as const,\n      description: 'The URL that returned HTTP 402',\n    },\n    payTo: {\n      type: 'string' as const,\n      description: 'Payment recipient address from the 402 response',\n    },\n    amount: {\n      type: 'string' as const,\n      description: 'Payment amount in atomic units (e.g. \"1000000\" for 1 USDC)',\n    },\n    asset: {\n      type: 'string' as const,\n      description: 'Token contract address from the 402 response',\n    },\n    network: {\n      type: 'string' as const,\n      description: 'CAIP-2 chain ID. \"eip155:100\" for Gnosis Chain, \"eip155:8453\" for Base.',\n    },\n    description: {\n      type: 'string' as const,\n      description: 'Description of the resource being paid for',\n    },\n  },\n  required: ['url', 'payTo', 'amount', 'asset', 'network'] as const,\n}\n\nconst MAKE_PAYMENT_DESCRIPTION =\n  'Send a payment from the Haven-managed Safe wallet. ' +\n  \"The payment will be validated against the agent's on-chain spending policy. \" +\n  'Gnosis Chain tokens: EURe, USDC.e, xDAI. Base tokens: USDC, ETH.'\n\nconst GET_STATUS_DESCRIPTION =\n  'Check the status of a previously initiated payment. ' +\n  'Returns the current status, transaction hash (if confirmed), and payment details.'\n\nconst AUTHORIZE_X402_DESCRIPTION =\n  'Authorize payment for an HTTP 402 (Payment Required) response. ' +\n  'When a paid API returns 402 with x402 payment requirements, use this tool to pay and get access. ' +\n  'Haven evaluates the payment against policy and executes from the Safe wallet.'\n\n// ── Claude (Anthropic) format ────────────────────────────────────\n\nexport interface ClaudeTool {\n  name: string\n  description: string\n  input_schema: {\n    type: 'object'\n    properties: Record<string, unknown>\n    required: readonly string[]\n  }\n}\n\nfunction claudeTools(): ClaudeTool[] {\n  return [\n    {\n      name: 'make_payment',\n      description: MAKE_PAYMENT_DESCRIPTION,\n      input_schema: makePaymentSchema,\n    },\n    {\n      name: 'get_payment_status',\n      description: GET_STATUS_DESCRIPTION,\n      input_schema: getPaymentStatusSchema,\n    },\n    {\n      name: 'authorize_x402_payment',\n      description: AUTHORIZE_X402_DESCRIPTION,\n      input_schema: authorizeX402Schema,\n    },\n  ]\n}\n\n// ── OpenAI format ────────────────────────────────────────────────\n\nexport interface OpenAITool {\n  type: 'function'\n  function: {\n    name: string\n    description: string\n    parameters: {\n      type: 'object'\n      properties: Record<string, unknown>\n      required: readonly string[]\n    }\n  }\n}\n\nfunction openaiTools(): OpenAITool[] {\n  return [\n    {\n      type: 'function',\n      function: {\n        name: 'make_payment',\n        description: MAKE_PAYMENT_DESCRIPTION,\n        parameters: makePaymentSchema,\n      },\n    },\n    {\n      type: 'function',\n      function: {\n        name: 'get_payment_status',\n        description: GET_STATUS_DESCRIPTION,\n        parameters: getPaymentStatusSchema,\n      },\n    },\n    {\n      type: 'function',\n      function: {\n        name: 'authorize_x402_payment',\n        description: AUTHORIZE_X402_DESCRIPTION,\n        parameters: authorizeX402Schema,\n      },\n    },\n  ]\n}\n\n// ── Public API ───────────────────────────────────────────────────\n\nexport const havenTools = {\n  /** Tool definitions in Anthropic/Claude format */\n  claude: claudeTools,\n\n  /** Tool definitions in OpenAI function-calling format */\n  openai: openaiTools,\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,322 @@
+interface HavenClientConfig {
+    /** Haven API key (sk_agent_xxx) */
+    apiKey: string;
+    /** Agent's delegate EOA private key. If provided, the SDK handles signing automatically. */
+    delegateKey?: string;
+    /** Haven API base URL (default: http://localhost:3001) */
+    baseUrl?: string;
+    /** Timeout in ms for individual HTTP requests (default: 30000) */
+    requestTimeout?: number;
+    /** Timeout in ms when polling for tx confirmation (default: 90000) */
+    confirmationTimeout?: number;
+    /** Polling interval in ms when waiting for confirmation (default: 3000) */
+    pollingInterval?: number;
+}
+interface PaymentRequest {
+    /** Token symbol: "EURe", "USDC.e", or "xDAI" */
+    token: string;
+    /** Amount as a decimal string, e.g. "5.00" */
+    amount: string;
+    /** Recipient Ethereum address (0x...) */
+    to: string;
+}
+interface SignData {
+    /** The hash to sign (keccak256, 0x-prefixed) */
+    hash: string;
+    /** Breakdown of values that were hashed — useful for debugging */
+    components: {
+        safe: string;
+        token: string;
+        to: string;
+        amount: string;
+        payment_token: string;
+        payment: string;
+        nonce: number;
+    };
+    /** Human-readable signing instructions */
+    instructions: string;
+}
+interface PaymentIntent {
+    /** Unique payment ID */
+    paymentId: string;
+    /** Current status */
+    status: 'pending_signature';
+    /** ISO 8601 expiry timestamp */
+    expiresAt: string;
+    /** Data needed to sign the payment */
+    signData: SignData;
+}
+type PaymentStatus = 'pending_signature' | 'submitted' | 'confirmed' | 'expired' | 'failed';
+interface PaymentResult {
+    /** Unique payment ID */
+    paymentId: string;
+    /** Final status */
+    status: PaymentStatus;
+    /** Token that was sent */
+    token: string;
+    /** Amount that was sent (human-readable) */
+    amount: string;
+    /** Recipient address */
+    to: string;
+    /** On-chain transaction hash (present when confirmed) */
+    txHash: string | null;
+    /** Error message (present when failed) */
+    errorMessage: string | null;
+    /** Block explorer URL for the transaction (chain-dependent) */
+    explorerUrl: string | null;
+    /** ISO 8601 timestamps */
+    createdAt: string;
+    signedAt: string | null;
+    submittedAt: string | null;
+    confirmedAt: string | null;
+    expiresAt: string;
+}
+/** Payment requirements from an HTTP 402 response (x402 protocol). */
+interface X402PaymentRequired {
+    x402Version: number;
+    resource: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts: X402PaymentOption[];
+    error?: string;
+}
+/** A single payment option from x402 PaymentRequired. */
+interface X402PaymentOption {
+    scheme: string;
+    network: string;
+    amount: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: Record<string, unknown>;
+}
+/** Receipt returned after a successful x402 payment. */
+interface X402Receipt {
+    success: boolean;
+    paymentId: string;
+    txHash: string;
+    token: string;
+    amount: string;
+    to: string;
+    resourceUrl: string;
+    explorerUrl: string;
+}
+declare class HavenError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    readonly paymentId?: string | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, paymentId?: string | undefined);
+}
+declare class HavenApiError extends HavenError {
+    readonly body?: unknown | undefined;
+    constructor(message: string, statusCode: number, body?: unknown | undefined);
+}
+declare class HavenSigningError extends HavenError {
+    constructor(message: string);
+}
+declare class HavenTimeoutError extends HavenError {
+    constructor(paymentId: string);
+}
+
+declare class HavenClient {
+    private readonly apiKey;
+    private readonly delegateKey;
+    private readonly baseUrl;
+    private readonly requestTimeout;
+    private readonly confirmationTimeout;
+    private readonly pollingInterval;
+    /** Delegate address derived from the private key (if provided) */
+    readonly delegateAddress: string | undefined;
+    constructor(config: HavenClientConfig);
+    /**
+     * Send a payment in one call.
+     *
+     * Creates the intent, signs the hash, submits the signature,
+     * and polls until confirmed (or throws on failure/timeout).
+     *
+     * Requires `delegateKey` to be set in the client config.
+     */
+    pay(request: PaymentRequest): Promise<PaymentResult>;
+    /**
+     * Step 1: Create a payment intent.
+     *
+     * Returns the intent with the hash to sign.
+     */
+    createIntent(request: PaymentRequest): Promise<PaymentIntent>;
+    /**
+     * Step 2: Sign a hash with the delegate key.
+     *
+     * Returns the 65-byte signature (0x-prefixed).
+     * Requires `delegateKey` to be set in the client config.
+     */
+    sign(hash: string): string;
+    /**
+     * Step 3: Submit a signature to execute the payment.
+     *
+     * The signature can come from `client.sign()` or from external signing.
+     */
+    submitSignature(paymentId: string, signature: string): Promise<{
+        status: string;
+        txHash?: string;
+    }>;
+    /**
+     * Get the current status of a payment.
+     */
+    getPayment(paymentId: string): Promise<PaymentResult>;
+    /**
+     * Poll until a payment reaches a terminal status (confirmed, failed, expired).
+     */
+    waitForConfirmation(paymentId: string): Promise<PaymentResult>;
+    /**
+     * Authorize an x402 payment.
+     *
+     * Takes the parsed PaymentRequired from a 402 response, selects a
+     * compatible payment option, signs and executes the payment through Haven.
+     *
+     * Requires `delegateKey` to be set in the client config.
+     */
+    authorizeX402(paymentRequired: X402PaymentRequired): Promise<X402Receipt>;
+    /**
+     * Fetch wrapper that automatically handles HTTP 402 responses.
+     *
+     * Works like the standard `fetch()` but intercepts 402 responses,
+     * pays via x402 through Haven, and retries the request.
+     *
+     * ```ts
+     * const response = await haven.fetch('https://paid-api.com/data')
+     * const data = await response.json()
+     * ```
+     *
+     * Requires `delegateKey` to be set in the client config.
+     */
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Execute a tool call by name and input.
+     *
+     * Designed to plug directly into agent tool-call handlers:
+     *
+     * ```ts
+     * if (block.type === 'tool_use') {
+     *   const result = await haven.executeTool(block.name, block.input)
+     *   // send result back to the model
+     * }
+     * ```
+     */
+    executeTool(toolName: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private post;
+    private get;
+    private request;
+    private mapPaymentResult;
+}
+
+/**
+ * Pre-built tool definitions for AI agent frameworks.
+ *
+ * These definitions describe the `make_payment` and `get_payment_status` tools
+ * in the formats expected by Claude (Anthropic) and OpenAI.
+ *
+ * Usage with Claude:
+ *   const response = await anthropic.messages.create({
+ *     tools: havenTools.claude(),
+ *     ...
+ *   })
+ *
+ * Usage with OpenAI:
+ *   const response = await openai.chat.completions.create({
+ *     tools: havenTools.openai(),
+ *     ...
+ *   })
+ */
+interface ClaudeTool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required: readonly string[];
+    };
+}
+declare function claudeTools(): ClaudeTool[];
+interface OpenAITool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required: readonly string[];
+        };
+    };
+}
+declare function openaiTools(): OpenAITool[];
+declare const havenTools: {
+    /** Tool definitions in Anthropic/Claude format */
+    claude: typeof claudeTools;
+    /** Tool definitions in OpenAI function-calling format */
+    openai: typeof openaiTools;
+};
+
+/**
+ * Sign a hash using raw ECDSA (no Ethereum message prefix).
+ *
+ * This matches what Safe's AllowanceModule `checkSignature` expects —
+ * a direct ecrecover over the hash, NOT the "\x19Ethereum Signed Message" variant.
+ *
+ * Uses ethers.SigningKey.sign() instead of wallet.signMessage() to avoid the prefix.
+ */
+declare function signHash(privateKey: string, hash: string): string;
+/**
+ * Derive the Ethereum address from a private key.
+ */
+declare function addressFromKey(privateKey: string): string;
+/**
+ * Verify that a signature over a hash recovers to the expected address.
+ */
+declare function verifySignature(hash: string, signature: string, expectedAddress: string): boolean;
+
+/**
+ * x402 protocol support for the Haven SDK.
+ *
+ * Provides:
+ * - parsePaymentRequired() — extract payment requirements from a 402 response
+ * - encodePaymentProof()   — encode a receipt as a PAYMENT-SIGNATURE header
+ *
+ * The main authorizeX402() and fetchWithPayment() are methods on HavenClient
+ * (see client.ts) since they need API access and signing.
+ */
+
+/**
+ * Parse an HTTP 402 response into x402 PaymentRequired data.
+ *
+ * Supports:
+ * - v2: PAYMENT-REQUIRED header (base64 JSON)
+ * - v1 fallback: X-PAYMENT header or response body
+ */
+declare function parsePaymentRequired(response: Response): X402PaymentRequired;
+/**
+ * Select the best payment option from the x402 accepts array.
+ *
+ * Preference order:
+ * 1. Option on a Haven-supported network with a known token
+ * 2. Any option on a Haven-supported network
+ * 3. null — no compatible option
+ */
+declare function selectPaymentOption(accepts: X402PaymentOption[]): X402PaymentOption | null;
+/**
+ * Encode a payment receipt as a base64 PAYMENT-SIGNATURE header value.
+ *
+ * This follows the x402 v2 protocol — the server's facilitator will
+ * verify the on-chain transaction referenced by tx_hash.
+ */
+declare function encodePaymentProof(receipt: {
+    txHash: string;
+    paymentId: string;
+    token: string;
+    amount: string;
+    to: string;
+}): string;
+
+export { type ClaudeTool, HavenApiError, HavenClient, type HavenClientConfig, HavenError, HavenSigningError, HavenTimeoutError, type OpenAITool, type PaymentIntent, type PaymentRequest, type PaymentResult, type PaymentStatus, type SignData, type X402PaymentOption, type X402PaymentRequired, type X402Receipt, addressFromKey, encodePaymentProof, havenTools, parsePaymentRequired, selectPaymentOption, signHash, verifySignature };