satonomous 0.2.1 → 0.3.0

package/dist/index.cjs

@@ -26,6 +26,55 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var HASH_RE = /^[0-9a-f]{64}$/i;
+function validateId(value, label) {
+  if (!value || typeof value !== "string") {
+    throw new Error(`${label} is required`);
+  }
+  if (!UUID_RE.test(value)) {
+    throw new Error(`${label} must be a valid UUID, got: ${value.slice(0, 50)}`);
+  }
+}
+function validateHash(value, label) {
+  if (!value || typeof value !== "string") {
+    throw new Error(`${label} is required`);
+  }
+  if (!HASH_RE.test(value)) {
+    throw new Error(`${label} must be a valid 64-char hex hash`);
+  }
+}
+function validateSats(amount, label) {
+  if (typeof amount !== "number" || !Number.isFinite(amount) || !Number.isInteger(amount) || amount < 1) {
+    throw new Error(`${label} must be a positive integer, got: ${amount}`);
+  }
+}
+function validateUrl(url) {
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      throw new Error("URL must use https:// or http://");
+    }
+  } catch (e) {
+    throw new Error(`Invalid API URL: ${e.message}`);
+  }
+}
+function enforceHttps(url) {
+  const parsed = new URL(url);
+  if (parsed.protocol !== "https:") {
+    throw new Error(
+      `API URL must use HTTPS to protect your API key in transit. Got: ${parsed.protocol}//... Use http:// only for local development (localhost/127.0.0.1).`
+    );
+  }
+}
+function isLocalhost(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "::1";
+  } catch {
+    return false;
+  }
+}
 var L402Error = class extends Error {
   constructor(message, status, code) {
     super(message);
@@ -36,14 +85,19 @@ var L402Error = class extends Error {
 };
 var L402Agent = class {
   constructor(options) {
-    if (!options.apiKey) {
+    if (!options.apiKey || typeof options.apiKey !== "string") {
       throw new Error("apiKey is required");
     }
+    const apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    validateUrl(apiUrl);
+    if (!isLocalhost(apiUrl)) {
+      enforceHttps(apiUrl);
+    }
     this.apiKey = options.apiKey;
-    this.apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    this.apiUrl = apiUrl.replace(/\/+$/, "");
     this.onPaymentNeeded = options.onPaymentNeeded;
     this.paymentTimeoutMs = options.paymentTimeoutMs ?? 3e5;
-    this.paymentPollIntervalMs = options.paymentPollIntervalMs ?? 5e3;
+    this.paymentPollIntervalMs = Math.max(options.paymentPollIntervalMs ?? 5e3, 1e3);
   }
   async request(method, path, body) {
     const url = `${this.apiUrl}${path}`;
@@ -63,40 +117,49 @@ var L402Agent = class {
       let errorCode;
       try {
         const data = await res.json();
-        errorMsg = data.error || errorMsg;
-        errorCode = data.code;
+        if (data.error && typeof data.error === "string") {
+          errorMsg = data.error;
+        }
+        if (data.code && typeof data.code === "string") {
+          errorCode = data.code;
+        }
       } catch {
       }
       throw new L402Error(errorMsg, res.status, errorCode);
     }
     return res.json();
   }
-  // Static: register a new agent (no auth needed)
+  // ─── Static: register ────────────────────────────────────────────────────
   static async register(options) {
-    const apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    if (!options.name || typeof options.name !== "string" || options.name.trim().length < 1) {
+      throw new Error("name is required (non-empty string)");
+    }
+    const apiUrl = (options.apiUrl ?? "https://l402gw.nosaltres2.info").replace(/\/+$/, "");
+    validateUrl(apiUrl);
+    if (!isLocalhost(apiUrl)) enforceHttps(apiUrl);
     const url = `${apiUrl}/api/v1/agents/register`;
     const res = await fetch(url, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
-        name: options.name,
-        description: options.description,
+        name: options.name.trim(),
+        description: options.description?.trim(),
         wallet_type: options.wallet_type ?? "custodial",
-        lightning_address: options.lightning_address
+        lightning_address: options.lightning_address?.trim()
       })
     });
     if (!res.ok) {
       let errorMsg = `HTTP ${res.status}`;
       try {
         const data = await res.json();
-        errorMsg = data.error || errorMsg;
+        if (data.error && typeof data.error === "string") errorMsg = data.error;
       } catch {
       }
       throw new L402Error(errorMsg, res.status);
     }
     return res.json();
   }
-  // Wallet
+  // ─── Wallet ──────────────────────────────────────────────────────────────
   async getBalance() {
     return this.request("GET", "/api/v1/wallet/balance");
   }
@@ -105,6 +168,7 @@ var L402Agent = class {
    * Most agents should use `deposit()` instead, which notifies the human and waits.
    */
   async createDeposit(amount_sats) {
+    validateSats(amount_sats, "amount_sats");
     const result = await this.request("POST", "/api/v1/wallet/deposit", { amount_sats });
     return {
       ...result,
@@ -115,42 +179,24 @@ var L402Agent = class {
    * Check if a deposit invoice has been paid.
    */
   async checkDeposit(paymentHash) {
+    validateHash(paymentHash, "paymentHash");
     return this.request("GET", `/api/v1/wallet/deposit/${paymentHash}`);
   }
   /**
    * High-level deposit: creates invoice, notifies human, waits for payment.
    *
-   * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay
-   * invoices. When an agent needs sats, it must ask a human to pay.
+   * AI agents don't have Lightning wallets. When an agent needs sats, it must
+   * ask a human to pay. This method handles the full flow:
+   * 1. Creates a Lightning invoice
+   * 2. Calls `onPaymentNeeded` to notify the human
+   * 3. Polls until paid or timeout
    *
-   * This method:
-   * 1. Creates a Lightning invoice for the requested amount
-   * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)
-   * 3. Polls until the invoice is paid or times out
-   * 4. Returns the confirmed deposit status
-   *
-   * If `onPaymentNeeded` is not configured, throws with the invoice so the
-   * caller can handle notification manually.
-   *
-   * @param amount_sats - Amount to deposit
-   * @param reason - Human-readable reason (shown in the notification)
-   * @returns Confirmed deposit status
+   * @param amount_sats - Amount to deposit (positive integer)
+   * @param reason - Human-readable reason (shown in notification)
    * @throws {L402Error} if payment times out or fails
-   *
-   * @example
-   * const agent = new L402Agent({
-   *   apiKey: 'sk_...',
-   *   onPaymentNeeded: async (invoice) => {
-   *     // Send to Slack, Discord, Signal, email, etc.
-   *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);
-   *   },
-   * });
-   *
-   * // Agent requests funding and waits
-   * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');
-   * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);
    */
   async deposit(amount_sats, reason) {
+    validateSats(amount_sats, "amount_sats");
     const invoice = await this.createDeposit(amount_sats);
     if (!this.onPaymentNeeded) {
       throw new L402Error(
@@ -170,18 +216,31 @@ var L402Agent = class {
         invoice.invoice
       ].join("\n")
     };
-    await this.onPaymentNeeded(enrichedInvoice);
+    const callbackTimeout = 3e4;
+    try {
+      await Promise.race([
+        this.onPaymentNeeded(enrichedInvoice),
+        new Promise(
+          (_, reject) => setTimeout(() => reject(new Error("onPaymentNeeded callback timed out after 30s")), callbackTimeout)
+        )
+      ]);
+    } catch (err) {
+      console.warn(`[satonomous] Payment notification warning: ${err.message}`);
+    }
     if (this.paymentTimeoutMs === 0) {
       return { status: "pending", amount_sats, paid_at: null };
     }
     const deadline = Date.now() + this.paymentTimeoutMs;
+    let pollInterval = this.paymentPollIntervalMs;
+    const maxInterval = 3e4;
     while (Date.now() < deadline) {
-      await new Promise((r) => setTimeout(r, this.paymentPollIntervalMs));
+      await new Promise((r) => setTimeout(r, pollInterval));
       const status = await this.checkDeposit(invoice.payment_hash);
       if (status.status === "paid") return status;
       if (status.status === "expired") {
         throw new L402Error("Deposit invoice expired before payment", 408, "PAYMENT_EXPIRED");
       }
+      pollInterval = Math.min(pollInterval * 1.5, maxInterval);
     }
     throw new L402Error(
       `Payment not received within ${this.paymentTimeoutMs / 1e3}s. Invoice may still be valid \u2014 check with checkDeposit('${invoice.payment_hash}')`,
@@ -191,14 +250,9 @@ var L402Agent = class {
   }
   /**
    * Ensure the agent has at least `minBalance` sats. If not, request a deposit.
-   * Convenience method that checks balance first, then deposits the difference.
-   *
-   * @example
-   * // Before accepting an offer, make sure you can pay
-   * await agent.ensureBalance(500, 'Need funds for code-review contract');
-   * await agent.fundContract(contractId);
    */
   async ensureBalance(minBalance, reason) {
+    validateSats(minBalance, "minBalance");
     const current = await this.getBalance();
     if (current.balance_sats >= minBalance) return current;
     const needed = minBalance - current.balance_sats;
@@ -206,63 +260,99 @@ var L402Agent = class {
     return this.getBalance();
   }
   async withdraw(amount_sats) {
+    if (amount_sats !== void 0) validateSats(amount_sats, "amount_sats");
     return this.request("POST", "/api/v1/wallet/withdraw", amount_sats ? { amount_sats } : {});
   }
-  // Offers
+  // ─── Offers ──────────────────────────────────────────────────────────────
   async createOffer(params) {
-    return this.request("POST", "/api/v1/offers", params);
+    if (!params.title || typeof params.title !== "string") throw new Error("title is required");
+    if (!params.service_type || typeof params.service_type !== "string") throw new Error("service_type is required");
+    validateSats(params.price_sats, "price_sats");
+    const { sla_minutes, dispute_window_minutes, ...rest } = params;
+    return this.request("POST", "/api/v1/offers", {
+      ...rest,
+      terms: {
+        sla_minutes: sla_minutes ?? 30,
+        dispute_window_minutes: dispute_window_minutes ?? 1440
+      }
+    });
   }
   async listOffers() {
     const result = await this.request("GET", "/api/v1/offers");
-    return result.offers || [];
+    return Array.isArray(result.offers) ? result.offers : [];
   }
   async getOffer(offerId) {
+    validateId(offerId, "offerId");
     return this.request("GET", `/api/v1/offers/${offerId}`);
   }
   async updateOffer(offerId, active) {
+    validateId(offerId, "offerId");
+    if (typeof active !== "boolean") throw new Error("active must be a boolean");
     return this.request("PATCH", `/api/v1/offers/${offerId}`, { active });
   }
-  // Contracts
+  // ─── Contracts ───────────────────────────────────────────────────────────
   async acceptOffer(offerId) {
+    validateId(offerId, "offerId");
     return this.request("POST", "/api/v1/contracts", { offer_id: offerId });
   }
   async fundContract(contractId) {
+    validateId(contractId, "contractId");
     return this.request("POST", `/api/v1/contracts/${contractId}/fund`, {});
   }
   async listContracts(filters) {
     let path = "/api/v1/contracts";
     const params = new URLSearchParams();
-    if (filters?.role) params.append("role", filters.role);
-    if (filters?.status) params.append("status", filters.status);
+    if (filters?.role) {
+      if (filters.role !== "buyer" && filters.role !== "seller") {
+        throw new Error("role must be 'buyer' or 'seller'");
+      }
+      params.append("role", filters.role);
+    }
+    if (filters?.status) {
+      if (typeof filters.status !== "string") throw new Error("status must be a string");
+      params.append("status", filters.status);
+    }
     if (params.toString()) path += "?" + params.toString();
     const result = await this.request("GET", path);
-    return result.contracts || [];
+    return Array.isArray(result.contracts) ? result.contracts : [];
   }
   async getContract(contractId) {
+    validateId(contractId, "contractId");
     return this.request("GET", `/api/v1/contracts/${contractId}`);
   }
-  // Delivery
+  // ─── Delivery ────────────────────────────────────────────────────────────
   async submitDelivery(contractId, proofUrl, proofData) {
+    validateId(contractId, "contractId");
+    if (!proofUrl || typeof proofUrl !== "string") throw new Error("proofUrl is required");
     return this.request("POST", `/api/v1/contracts/${contractId}/deliver`, {
       proof_url: proofUrl,
       proof_data: proofData
     });
   }
   async confirmDelivery(contractId) {
+    validateId(contractId, "contractId");
     return this.request("POST", `/api/v1/contracts/${contractId}/confirm`, {});
   }
   async disputeDelivery(contractId, reason, evidenceUrl) {
+    validateId(contractId, "contractId");
+    if (!reason || typeof reason !== "string") throw new Error("reason is required");
     return this.request("POST", `/api/v1/contracts/${contractId}/dispute`, {
       reason,
       evidence_url: evidenceUrl
     });
   }
-  // Ledger
+  // ─── Ledger ──────────────────────────────────────────────────────────────
   async getLedger(limit, offset) {
     let path = "/api/v1/ledger";
     const params = new URLSearchParams();
-    if (limit) params.append("limit", String(limit));
-    if (offset) params.append("offset", String(offset));
+    if (limit !== void 0) {
+      if (!Number.isInteger(limit) || limit < 1) throw new Error("limit must be a positive integer");
+      params.append("limit", String(limit));
+    }
+    if (offset !== void 0) {
+      if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be a non-negative integer");
+      params.append("offset", String(offset));
+    }
     if (params.toString()) path += "?" + params.toString();
     return this.request("GET", path);
   }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["/**\n * satonomous — SDK for autonomous AI agents to earn and spend sats\n *\n * AI agents can't pay Lightning invoices — they don't have wallets.\n * This SDK bridges that gap: when an agent needs funds, it notifies\n * a human (via callback) and waits for payment.\n *\n * @example\n * ```ts\n * import { L402Agent } from 'satonomous';\n *\n * const agent = new L402Agent({\n *   apiKey: 'sk_...',\n *   // This is the key part: how the agent asks a human for money\n *   onPaymentNeeded: async (invoice) => {\n *     await sendSlackMessage(`⚡ Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);\n *   },\n * });\n *\n * // Agent ensures it has funds before working\n * await agent.ensureBalance(500, 'Need funds for code-review contract');\n * ```\n *\n * @module\n */\n\nexport { L402Agent, L402Error } from './client.js';\nexport type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n","import type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n\nexport class L402Error extends Error {\n  status: number;\n  code?: string;\n\n  constructor(message: string, status: number, code?: string) {\n    super(message);\n    this.name = 'L402Error';\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class L402Agent {\n  private apiKey: string;\n  private apiUrl: string;\n\n  private onPaymentNeeded?: PaymentNeededCallback;\n  private paymentTimeoutMs: number;\n  private paymentPollIntervalMs: number;\n\n  constructor(options: L402AgentOptions) {\n    if (!options.apiKey) {\n      throw new Error('apiKey is required');\n    }\n    this.apiKey = options.apiKey;\n    this.apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    this.onPaymentNeeded = options.onPaymentNeeded;\n    this.paymentTimeoutMs = options.paymentTimeoutMs ?? 300_000;\n    this.paymentPollIntervalMs = options.paymentPollIntervalMs ?? 5_000;\n  }\n\n  private async request<T>(method: string, path: string, body?: any): Promise<T> {\n    const url = `${this.apiUrl}${path}`;\n    const options: RequestInit = {\n      method,\n      headers: {\n        'X-L402-Key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const res = await fetch(url, options);\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      let errorCode: string | undefined;\n\n      try {\n        const data = await res.json() as { error?: string; code?: string };\n        errorMsg = data.error || errorMsg;\n        errorCode = data.code;\n      } catch {\n        // Use default error message\n      }\n\n      throw new L402Error(errorMsg, res.status, errorCode);\n    }\n\n    return res.json() as Promise<T>;\n  }\n\n  // Static: register a new agent (no auth needed)\n  static async register(options: {\n    name: string;\n    description?: string;\n    wallet_type?: 'custodial' | 'external';\n    lightning_address?: string;\n    apiUrl?: string;\n  }): Promise<AgentRegistration> {\n    const apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    const url = `${apiUrl}/api/v1/agents/register`;\n\n    const res = await fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        name: options.name,\n        description: options.description,\n        wallet_type: options.wallet_type ?? 'custodial',\n        lightning_address: options.lightning_address,\n      }),\n    });\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      try {\n        const data = await res.json() as { error?: string };\n        errorMsg = data.error || errorMsg;\n      } catch {\n        // Use default error message\n      }\n      throw new L402Error(errorMsg, res.status);\n    }\n\n    return res.json() as Promise<AgentRegistration>;\n  }\n\n  // Wallet\n  async getBalance(): Promise<BalanceInfo> {\n    return this.request('GET', '/api/v1/wallet/balance');\n  }\n\n  /**\n   * Low-level: create a deposit invoice. Returns the invoice for manual handling.\n   * Most agents should use `deposit()` instead, which notifies the human and waits.\n   */\n  async createDeposit(amount_sats: number): Promise<DepositInvoice> {\n    const result = await this.request<DepositInvoice>('POST', '/api/v1/wallet/deposit', { amount_sats });\n    // Add pay_url for easy wallet linking\n    return {\n      ...result,\n      pay_url: `lightning:${result.invoice}`,\n    };\n  }\n\n  /**\n   * Check if a deposit invoice has been paid.\n   */\n  async checkDeposit(paymentHash: string): Promise<DepositStatus> {\n    return this.request('GET', `/api/v1/wallet/deposit/${paymentHash}`);\n  }\n\n  /**\n   * High-level deposit: creates invoice, notifies human, waits for payment.\n   *\n   * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay\n   * invoices. When an agent needs sats, it must ask a human to pay.\n   *\n   * This method:\n   * 1. Creates a Lightning invoice for the requested amount\n   * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)\n   * 3. Polls until the invoice is paid or times out\n   * 4. Returns the confirmed deposit status\n   *\n   * If `onPaymentNeeded` is not configured, throws with the invoice so the\n   * caller can handle notification manually.\n   *\n   * @param amount_sats - Amount to deposit\n   * @param reason - Human-readable reason (shown in the notification)\n   * @returns Confirmed deposit status\n   * @throws {L402Error} if payment times out or fails\n   *\n   * @example\n   * const agent = new L402Agent({\n   *   apiKey: 'sk_...',\n   *   onPaymentNeeded: async (invoice) => {\n   *     // Send to Slack, Discord, Signal, email, etc.\n   *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);\n   *   },\n   * });\n   *\n   * // Agent requests funding and waits\n   * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');\n   * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);\n   */\n  async deposit(amount_sats: number, reason?: string): Promise<DepositStatus> {\n    const invoice = await this.createDeposit(amount_sats);\n\n    // If no callback, throw with invoice details so caller can handle it\n    if (!this.onPaymentNeeded) {\n      throw new L402Error(\n        `Payment needed: ${amount_sats} sats. ` +\n        `Invoice: ${invoice.invoice}. ` +\n        `No onPaymentNeeded callback configured — pay this invoice manually ` +\n        `and call checkDeposit('${invoice.payment_hash}') to confirm.`,\n        402,\n        'PAYMENT_NEEDED'\n      );\n    }\n\n    // Notify the human with clear payment instructions\n    const enrichedInvoice: DepositInvoice = {\n      ...invoice,\n      message: [\n        reason\n          ? `⚡ Agent needs ${amount_sats} sats: ${reason}`\n          : `⚡ Agent needs ${amount_sats} sats deposited`,\n        '',\n        `📱 Tap to pay: ${invoice.pay_url}`,\n        '',\n        `Or paste this invoice into any Lightning wallet:`,\n        invoice.invoice,\n      ].join('\\n'),\n    };\n    await this.onPaymentNeeded(enrichedInvoice);\n\n    // Poll for payment\n    if (this.paymentTimeoutMs === 0) {\n      return { status: 'pending', amount_sats, paid_at: null };\n    }\n\n    const deadline = Date.now() + this.paymentTimeoutMs;\n    while (Date.now() < deadline) {\n      await new Promise(r => setTimeout(r, this.paymentPollIntervalMs));\n      const status = await this.checkDeposit(invoice.payment_hash);\n      if (status.status === 'paid') return status;\n      if (status.status === 'expired') {\n        throw new L402Error('Deposit invoice expired before payment', 408, 'PAYMENT_EXPIRED');\n      }\n    }\n\n    throw new L402Error(\n      `Payment not received within ${this.paymentTimeoutMs / 1000}s. ` +\n      `Invoice may still be valid — check with checkDeposit('${invoice.payment_hash}')`,\n      408,\n      'PAYMENT_TIMEOUT'\n    );\n  }\n\n  /**\n   * Ensure the agent has at least `minBalance` sats. If not, request a deposit.\n   * Convenience method that checks balance first, then deposits the difference.\n   *\n   * @example\n   * // Before accepting an offer, make sure you can pay\n   * await agent.ensureBalance(500, 'Need funds for code-review contract');\n   * await agent.fundContract(contractId);\n   */\n  async ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo> {\n    const current = await this.getBalance();\n    if (current.balance_sats >= minBalance) return current;\n\n    const needed = minBalance - current.balance_sats;\n    await this.deposit(needed, reason ?? `Need ${needed} more sats (have ${current.balance_sats}, need ${minBalance})`);\n    return this.getBalance();\n  }\n\n  async withdraw(amount_sats?: number): Promise<WithdrawResult> {\n    return this.request('POST', '/api/v1/wallet/withdraw', amount_sats ? { amount_sats } : {});\n  }\n\n  // Offers\n  async createOffer(params: CreateOfferParams): Promise<Offer> {\n    return this.request('POST', '/api/v1/offers', params);\n  }\n\n  async listOffers(): Promise<Offer[]> {\n    const result = await this.request<{ offers: Offer[] }>('GET', '/api/v1/offers');\n    return result.offers || [];\n  }\n\n  async getOffer(offerId: string): Promise<Offer> {\n    return this.request('GET', `/api/v1/offers/${offerId}`);\n  }\n\n  async updateOffer(offerId: string, active: boolean): Promise<Offer> {\n    return this.request('PATCH', `/api/v1/offers/${offerId}`, { active });\n  }\n\n  // Contracts\n  async acceptOffer(offerId: string): Promise<Contract> {\n    return this.request('POST', '/api/v1/contracts', { offer_id: offerId });\n  }\n\n  async fundContract(contractId: string): Promise<FundResult> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/fund`, {});\n  }\n\n  async listContracts(filters?: { role?: 'buyer' | 'seller'; status?: string }): Promise<Contract[]> {\n    let path = '/api/v1/contracts';\n    const params = new URLSearchParams();\n    if (filters?.role) params.append('role', filters.role);\n    if (filters?.status) params.append('status', filters.status);\n    if (params.toString()) path += '?' + params.toString();\n    const result = await this.request<{ contracts: Contract[] }>('GET', path);\n    return result.contracts || [];\n  }\n\n  async getContract(contractId: string): Promise<Contract> {\n    return this.request('GET', `/api/v1/contracts/${contractId}`);\n  }\n\n  // Delivery\n  async submitDelivery(contractId: string, proofUrl: string, proofData?: any): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/deliver`, {\n      proof_url: proofUrl,\n      proof_data: proofData,\n    });\n  }\n\n  async confirmDelivery(contractId: string): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/confirm`, {});\n  }\n\n  async disputeDelivery(contractId: string, reason: string, evidenceUrl?: string): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/dispute`, {\n      reason,\n      evidence_url: evidenceUrl,\n    });\n  }\n\n  // Ledger\n  async getLedger(limit?: number, offset?: number): Promise<{ balance_sats: number; entries: LedgerEntry[] }> {\n    let path = '/api/v1/ledger';\n    const params = new URLSearchParams();\n    if (limit) params.append('limit', String(limit));\n    if (offset) params.append('offset', String(offset));\n    if (params.toString()) path += '?' + params.toString();\n    return this.request('GET', path);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACeO,IAAM,YAAN,cAAwB,MAAM;AAAA,EAInC,YAAY,SAAiB,QAAgB,MAAe;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,YAAN,MAAgB;AAAA,EAQrB,YAAY,SAA2B;AACrC,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AACA,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ,UAAU;AAChC,SAAK,kBAAkB,QAAQ;AAC/B,SAAK,mBAAmB,QAAQ,oBAAoB;AACpD,SAAK,wBAAwB,QAAQ,yBAAyB;AAAA,EAChE;AAAA,EAEA,MAAc,QAAW,QAAgB,MAAc,MAAwB;AAC7E,UAAM,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI;AACjC,UAAM,UAAuB;AAAA,MAC3B;AAAA,MACA,SAAS;AAAA,QACP,cAAc,KAAK;AAAA,QACnB,gBAAgB;AAAA,MAClB;AAAA,IACF;AAEA,QAAI,MAAM;AACR,cAAQ,OAAO,KAAK,UAAU,IAAI;AAAA,IACpC;AAEA,UAAM,MAAM,MAAM,MAAM,KAAK,OAAO;AAEpC,QAAI,CAAC,IAAI,IAAI;AACX,UAAI,WAAW,QAAQ,IAAI,MAAM;AACjC,UAAI;AAEJ,UAAI;AACF,cAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,mBAAW,KAAK,SAAS;AACzB,oBAAY,KAAK;AAAA,MACnB,QAAQ;AAAA,MAER;AAEA,YAAM,IAAI,UAAU,UAAU,IAAI,QAAQ,SAAS;AAAA,IACrD;AAEA,WAAO,IAAI,KAAK;AAAA,EAClB;AAAA;AAAA,EAGA,aAAa,SAAS,SAMS;AAC7B,UAAM,SAAS,QAAQ,UAAU;AACjC,UAAM,MAAM,GAAG,MAAM;AAErB,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM,QAAQ;AAAA,QACd,aAAa,QAAQ;AAAA,QACrB,aAAa,QAAQ,eAAe;AAAA,QACpC,mBAAmB,QAAQ;AAAA,MAC7B,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,UAAI,WAAW,QAAQ,IAAI,MAAM;AACjC,UAAI;AACF,cAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,mBAAW,KAAK,SAAS;AAAA,MAC3B,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,UAAU,UAAU,IAAI,MAAM;AAAA,IAC1C;AAEA,WAAO,IAAI,KAAK;AAAA,EAClB;AAAA;AAAA,EAGA,MAAM,aAAmC;AACvC,WAAO,KAAK,QAAQ,OAAO,wBAAwB;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cAAc,aAA8C;AAChE,UAAM,SAAS,MAAM,KAAK,QAAwB,QAAQ,0BAA0B,EAAE,YAAY,CAAC;AAEnG,WAAO;AAAA,MACL,GAAG;AAAA,MACH,SAAS,aAAa,OAAO,OAAO;AAAA,IACtC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,aAA6C;AAC9D,WAAO,KAAK,QAAQ,OAAO,0BAA0B,WAAW,EAAE;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCA,MAAM,QAAQ,aAAqB,QAAyC;AAC1E,UAAM,UAAU,MAAM,KAAK,cAAc,WAAW;AAGpD,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI;AAAA,QACR,mBAAmB,WAAW,mBAClB,QAAQ,OAAO,oGAED,QAAQ,YAAY;AAAA,QAC9C;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAGA,UAAM,kBAAkC;AAAA,MACtC,GAAG;AAAA,MACH,SAAS;AAAA,QACP,SACI,sBAAiB,WAAW,UAAU,MAAM,KAC5C,sBAAiB,WAAW;AAAA,QAChC;AAAA,QACA,yBAAkB,QAAQ,OAAO;AAAA,QACjC;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,MACV,EAAE,KAAK,IAAI;AAAA,IACb;AACA,UAAM,KAAK,gBAAgB,eAAe;AAG1C,QAAI,KAAK,qBAAqB,GAAG;AAC/B,aAAO,EAAE,QAAQ,WAAW,aAAa,SAAS,KAAK;AAAA,IACzD;AAEA,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK;AACnC,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,YAAM,IAAI,QAAQ,OAAK,WAAW,GAAG,KAAK,qBAAqB,CAAC;AAChE,YAAM,SAAS,MAAM,KAAK,aAAa,QAAQ,YAAY;AAC3D,UAAI,OAAO,WAAW,OAAQ,QAAO;AACrC,UAAI,OAAO,WAAW,WAAW;AAC/B,cAAM,IAAI,UAAU,0CAA0C,KAAK,iBAAiB;AAAA,MACtF;AAAA,IACF;AAEA,UAAM,IAAI;AAAA,MACR,+BAA+B,KAAK,mBAAmB,GAAI,iEACF,QAAQ,YAAY;AAAA,MAC7E;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,cAAc,YAAoB,QAAuC;AAC7E,UAAM,UAAU,MAAM,KAAK,WAAW;AACtC,QAAI,QAAQ,gBAAgB,WAAY,QAAO;AAE/C,UAAM,SAAS,aAAa,QAAQ;AACpC,UAAM,KAAK,QAAQ,QAAQ,UAAU,QAAQ,MAAM,oBAAoB,QAAQ,YAAY,UAAU,UAAU,GAAG;AAClH,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA,EAEA,MAAM,SAAS,aAA+C;AAC5D,WAAO,KAAK,QAAQ,QAAQ,2BAA2B,cAAc,EAAE,YAAY,IAAI,CAAC,CAAC;AAAA,EAC3F;AAAA;AAAA,EAGA,MAAM,YAAY,QAA2C;AAC3D,WAAO,KAAK,QAAQ,QAAQ,kBAAkB,MAAM;AAAA,EACtD;AAAA,EAEA,MAAM,aAA+B;AACnC,UAAM,SAAS,MAAM,KAAK,QAA6B,OAAO,gBAAgB;AAC9E,WAAO,OAAO,UAAU,CAAC;AAAA,EAC3B;AAAA,EAEA,MAAM,SAAS,SAAiC;AAC9C,WAAO,KAAK,QAAQ,OAAO,kBAAkB,OAAO,EAAE;AAAA,EACxD;AAAA,EAEA,MAAM,YAAY,SAAiB,QAAiC;AAClE,WAAO,KAAK,QAAQ,SAAS,kBAAkB,OAAO,IAAI,EAAE,OAAO,CAAC;AAAA,EACtE;AAAA;AAAA,EAGA,MAAM,YAAY,SAAoC;AACpD,WAAO,KAAK,QAAQ,QAAQ,qBAAqB,EAAE,UAAU,QAAQ,CAAC;AAAA,EACxE;AAAA,EAEA,MAAM,aAAa,YAAyC;AAC1D,WAAO,KAAK,QAAQ,QAAQ,qBAAqB,UAAU,SAAS,CAAC,CAAC;AAAA,EACxE;AAAA,EAEA,MAAM,cAAc,SAA+E;AACjG,QAAI,OAAO;AACX,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,SAAS,KAAM,QAAO,OAAO,QAAQ,QAAQ,IAAI;AACrD,QAAI,SAAS,OAAQ,QAAO,OAAO,UAAU,QAAQ,MAAM;AAC3D,QAAI,OAAO,SAAS,EAAG,SAAQ,MAAM,OAAO,SAAS;AACrD,UAAM,SAAS,MAAM,KAAK,QAAmC,OAAO,IAAI;AACxE,WAAO,OAAO,aAAa,CAAC;AAAA,EAC9B;AAAA,EAEA,MAAM,YAAY,YAAuC;AACvD,WAAO,KAAK,QAAQ,OAAO,qBAAqB,UAAU,EAAE;AAAA,EAC9D;AAAA;AAAA,EAGA,MAAM,eAAe,YAAoB,UAAkB,WAAoC;AAC7F,WAAO,KAAK,QAAQ,QAAQ,qBAAqB,UAAU,YAAY;AAAA,MACrE,WAAW;AAAA,MACX,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,gBAAgB,YAAuC;AAC3D,WAAO,KAAK,QAAQ,QAAQ,qBAAqB,UAAU,YAAY,CAAC,CAAC;AAAA,EAC3E;AAAA,EAEA,MAAM,gBAAgB,YAAoB,QAAgB,aAAyC;AACjG,WAAO,KAAK,QAAQ,QAAQ,qBAAqB,UAAU,YAAY;AAAA,MACrE;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UAAU,OAAgB,QAA4E;AAC1G,QAAI,OAAO;AACX,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,MAAO,QAAO,OAAO,SAAS,OAAO,KAAK,CAAC;AAC/C,QAAI,OAAQ,QAAO,OAAO,UAAU,OAAO,MAAM,CAAC;AAClD,QAAI,OAAO,SAAS,EAAG,SAAQ,MAAM,OAAO,SAAS;AACrD,WAAO,KAAK,QAAQ,OAAO,IAAI;AAAA,EACjC;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["/**\n * satonomous — SDK for autonomous AI agents to earn and spend sats\n *\n * AI agents can't pay Lightning invoices — they don't have wallets.\n * This SDK bridges that gap: when an agent needs funds, it notifies\n * a human (via callback) and waits for payment.\n *\n * @example\n * ```ts\n * import { L402Agent } from 'satonomous';\n *\n * const agent = new L402Agent({\n *   apiKey: 'sk_...',\n *   // This is the key part: how the agent asks a human for money\n *   onPaymentNeeded: async (invoice) => {\n *     await sendSlackMessage(`⚡ Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);\n *   },\n * });\n *\n * // Agent ensures it has funds before working\n * await agent.ensureBalance(500, 'Need funds for code-review contract');\n * ```\n *\n * @module\n */\n\nexport { L402Agent, L402Error } from './client.js';\nexport type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n","import type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n\n// ─── Validation helpers ──────────────────────────────────────────────────────\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst HASH_RE = /^[0-9a-f]{64}$/i;\n\nfunction validateId(value: string, label: string): void {\n  if (!value || typeof value !== 'string') {\n    throw new Error(`${label} is required`);\n  }\n  if (!UUID_RE.test(value)) {\n    throw new Error(`${label} must be a valid UUID, got: ${value.slice(0, 50)}`);\n  }\n}\n\nfunction validateHash(value: string, label: string): void {\n  if (!value || typeof value !== 'string') {\n    throw new Error(`${label} is required`);\n  }\n  if (!HASH_RE.test(value)) {\n    throw new Error(`${label} must be a valid 64-char hex hash`);\n  }\n}\n\nfunction validateSats(amount: number, label: string): void {\n  if (typeof amount !== 'number' || !Number.isFinite(amount) || !Number.isInteger(amount) || amount < 1) {\n    throw new Error(`${label} must be a positive integer, got: ${amount}`);\n  }\n}\n\nfunction validateUrl(url: string): void {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n      throw new Error('URL must use https:// or http://');\n    }\n  } catch (e: any) {\n    throw new Error(`Invalid API URL: ${e.message}`);\n  }\n}\n\nfunction enforceHttps(url: string): void {\n  const parsed = new URL(url);\n  if (parsed.protocol !== 'https:') {\n    throw new Error(\n      `API URL must use HTTPS to protect your API key in transit. Got: ${parsed.protocol}//... ` +\n      `Use http:// only for local development (localhost/127.0.0.1).`\n    );\n  }\n}\n\nfunction isLocalhost(url: string): boolean {\n  try {\n    const parsed = new URL(url);\n    return parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';\n  } catch {\n    return false;\n  }\n}\n\n// ─── Error class ─────────────────────────────────────────────────────────────\n\nexport class L402Error extends Error {\n  status: number;\n  code?: string;\n\n  constructor(message: string, status: number, code?: string) {\n    super(message);\n    this.name = 'L402Error';\n    this.status = status;\n    this.code = code;\n  }\n}\n\n// ─── Main client ─────────────────────────────────────────────────────────────\n\nexport class L402Agent {\n  private apiKey: string;\n  private apiUrl: string;\n\n  private onPaymentNeeded?: PaymentNeededCallback;\n  private paymentTimeoutMs: number;\n  private paymentPollIntervalMs: number;\n\n  constructor(options: L402AgentOptions) {\n    if (!options.apiKey || typeof options.apiKey !== 'string') {\n      throw new Error('apiKey is required');\n    }\n\n    const apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    validateUrl(apiUrl);\n\n    // Enforce HTTPS unless localhost (development)\n    if (!isLocalhost(apiUrl)) {\n      enforceHttps(apiUrl);\n    }\n\n    this.apiKey = options.apiKey;\n    this.apiUrl = apiUrl.replace(/\\/+$/, ''); // strip trailing slashes\n    this.onPaymentNeeded = options.onPaymentNeeded;\n    this.paymentTimeoutMs = options.paymentTimeoutMs ?? 300_000;\n    this.paymentPollIntervalMs = Math.max(options.paymentPollIntervalMs ?? 5_000, 1_000); // min 1s\n  }\n\n  private async request<T>(method: string, path: string, body?: any): Promise<T> {\n    const url = `${this.apiUrl}${path}`;\n    const options: RequestInit = {\n      method,\n      headers: {\n        'X-L402-Key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const res = await fetch(url, options);\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      let errorCode: string | undefined;\n\n      try {\n        const data = await res.json() as { error?: string; code?: string };\n        if (data.error && typeof data.error === 'string') {\n          errorMsg = data.error;\n        }\n        if (data.code && typeof data.code === 'string') {\n          errorCode = data.code;\n        }\n      } catch {\n        // Use default error message\n      }\n\n      throw new L402Error(errorMsg, res.status, errorCode);\n    }\n\n    return res.json() as Promise<T>;\n  }\n\n  // ─── Static: register ────────────────────────────────────────────────────\n\n  static async register(options: {\n    name: string;\n    description?: string;\n    wallet_type?: 'custodial' | 'external';\n    lightning_address?: string;\n    apiUrl?: string;\n  }): Promise<AgentRegistration> {\n    if (!options.name || typeof options.name !== 'string' || options.name.trim().length < 1) {\n      throw new Error('name is required (non-empty string)');\n    }\n\n    const apiUrl = (options.apiUrl ?? 'https://l402gw.nosaltres2.info').replace(/\\/+$/, '');\n    validateUrl(apiUrl);\n    if (!isLocalhost(apiUrl)) enforceHttps(apiUrl);\n\n    const url = `${apiUrl}/api/v1/agents/register`;\n\n    const res = await fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        name: options.name.trim(),\n        description: options.description?.trim(),\n        wallet_type: options.wallet_type ?? 'custodial',\n        lightning_address: options.lightning_address?.trim(),\n      }),\n    });\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      try {\n        const data = await res.json() as { error?: string };\n        if (data.error && typeof data.error === 'string') errorMsg = data.error;\n      } catch {\n        // Use default\n      }\n      throw new L402Error(errorMsg, res.status);\n    }\n\n    return res.json() as Promise<AgentRegistration>;\n  }\n\n  // ─── Wallet ──────────────────────────────────────────────────────────────\n\n  async getBalance(): Promise<BalanceInfo> {\n    return this.request('GET', '/api/v1/wallet/balance');\n  }\n\n  /**\n   * Low-level: create a deposit invoice. Returns the invoice for manual handling.\n   * Most agents should use `deposit()` instead, which notifies the human and waits.\n   */\n  async createDeposit(amount_sats: number): Promise<DepositInvoice> {\n    validateSats(amount_sats, 'amount_sats');\n    const result = await this.request<DepositInvoice>('POST', '/api/v1/wallet/deposit', { amount_sats });\n    return {\n      ...result,\n      pay_url: `lightning:${result.invoice}`,\n    };\n  }\n\n  /**\n   * Check if a deposit invoice has been paid.\n   */\n  async checkDeposit(paymentHash: string): Promise<DepositStatus> {\n    validateHash(paymentHash, 'paymentHash');\n    return this.request('GET', `/api/v1/wallet/deposit/${paymentHash}`);\n  }\n\n  /**\n   * High-level deposit: creates invoice, notifies human, waits for payment.\n   *\n   * AI agents don't have Lightning wallets. When an agent needs sats, it must\n   * ask a human to pay. This method handles the full flow:\n   * 1. Creates a Lightning invoice\n   * 2. Calls `onPaymentNeeded` to notify the human\n   * 3. Polls until paid or timeout\n   *\n   * @param amount_sats - Amount to deposit (positive integer)\n   * @param reason - Human-readable reason (shown in notification)\n   * @throws {L402Error} if payment times out or fails\n   */\n  async deposit(amount_sats: number, reason?: string): Promise<DepositStatus> {\n    validateSats(amount_sats, 'amount_sats');\n    const invoice = await this.createDeposit(amount_sats);\n\n    if (!this.onPaymentNeeded) {\n      throw new L402Error(\n        `Payment needed: ${amount_sats} sats. ` +\n        `Invoice: ${invoice.invoice}. ` +\n        `No onPaymentNeeded callback configured — pay this invoice manually ` +\n        `and call checkDeposit('${invoice.payment_hash}') to confirm.`,\n        402,\n        'PAYMENT_NEEDED'\n      );\n    }\n\n    // Notify the human with payment instructions\n    const enrichedInvoice: DepositInvoice = {\n      ...invoice,\n      message: [\n        reason\n          ? `⚡ Agent needs ${amount_sats} sats: ${reason}`\n          : `⚡ Agent needs ${amount_sats} sats deposited`,\n        '',\n        `📱 Tap to pay: ${invoice.pay_url}`,\n        '',\n        `Or paste this invoice into any Lightning wallet:`,\n        invoice.invoice,\n      ].join('\\n'),\n    };\n\n    // Timeout-protect the callback (30s max)\n    const callbackTimeout = 30_000;\n    try {\n      await Promise.race([\n        this.onPaymentNeeded(enrichedInvoice),\n        new Promise((_, reject) =>\n          setTimeout(() => reject(new Error('onPaymentNeeded callback timed out after 30s')), callbackTimeout)\n        ),\n      ]);\n    } catch (err: any) {\n      // Log but don't fail — the invoice is still valid, just notification may have failed\n      console.warn(`[satonomous] Payment notification warning: ${err.message}`);\n    }\n\n    // Poll for payment with exponential backoff\n    if (this.paymentTimeoutMs === 0) {\n      return { status: 'pending', amount_sats, paid_at: null };\n    }\n\n    const deadline = Date.now() + this.paymentTimeoutMs;\n    let pollInterval = this.paymentPollIntervalMs;\n    const maxInterval = 30_000; // cap at 30s\n\n    while (Date.now() < deadline) {\n      await new Promise(r => setTimeout(r, pollInterval));\n      const status = await this.checkDeposit(invoice.payment_hash);\n      if (status.status === 'paid') return status;\n      if (status.status === 'expired') {\n        throw new L402Error('Deposit invoice expired before payment', 408, 'PAYMENT_EXPIRED');\n      }\n      // Exponential backoff: 5s → 7.5s → 11.25s → ... → 30s max\n      pollInterval = Math.min(pollInterval * 1.5, maxInterval);\n    }\n\n    throw new L402Error(\n      `Payment not received within ${this.paymentTimeoutMs / 1000}s. ` +\n      `Invoice may still be valid — check with checkDeposit('${invoice.payment_hash}')`,\n      408,\n      'PAYMENT_TIMEOUT'\n    );\n  }\n\n  /**\n   * Ensure the agent has at least `minBalance` sats. If not, request a deposit.\n   */\n  async ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo> {\n    validateSats(minBalance, 'minBalance');\n    const current = await this.getBalance();\n    if (current.balance_sats >= minBalance) return current;\n\n    const needed = minBalance - current.balance_sats;\n    await this.deposit(needed, reason ?? `Need ${needed} more sats (have ${current.balance_sats}, need ${minBalance})`);\n    return this.getBalance();\n  }\n\n  async withdraw(amount_sats?: number): Promise<WithdrawResult> {\n    if (amount_sats !== undefined) validateSats(amount_sats, 'amount_sats');\n    return this.request('POST', '/api/v1/wallet/withdraw', amount_sats ? { amount_sats } : {});\n  }\n\n  // ─── Offers ──────────────────────────────────────────────────────────────\n\n  async createOffer(params: CreateOfferParams): Promise<Offer> {\n    if (!params.title || typeof params.title !== 'string') throw new Error('title is required');\n    if (!params.service_type || typeof params.service_type !== 'string') throw new Error('service_type is required');\n    validateSats(params.price_sats, 'price_sats');\n\n    const { sla_minutes, dispute_window_minutes, ...rest } = params;\n    return this.request('POST', '/api/v1/offers', {\n      ...rest,\n      terms: {\n        sla_minutes: sla_minutes ?? 30,\n        dispute_window_minutes: dispute_window_minutes ?? 1440,\n      },\n    });\n  }\n\n  async listOffers(): Promise<Offer[]> {\n    const result = await this.request<{ offers: Offer[] }>('GET', '/api/v1/offers');\n    return Array.isArray(result.offers) ? result.offers : [];\n  }\n\n  async getOffer(offerId: string): Promise<Offer> {\n    validateId(offerId, 'offerId');\n    return this.request('GET', `/api/v1/offers/${offerId}`);\n  }\n\n  async updateOffer(offerId: string, active: boolean): Promise<Offer> {\n    validateId(offerId, 'offerId');\n    if (typeof active !== 'boolean') throw new Error('active must be a boolean');\n    return this.request('PATCH', `/api/v1/offers/${offerId}`, { active });\n  }\n\n  // ─── Contracts ───────────────────────────────────────────────────────────\n\n  async acceptOffer(offerId: string): Promise<Contract> {\n    validateId(offerId, 'offerId');\n    return this.request('POST', '/api/v1/contracts', { offer_id: offerId });\n  }\n\n  async fundContract(contractId: string): Promise<FundResult> {\n    validateId(contractId, 'contractId');\n    return this.request('POST', `/api/v1/contracts/${contractId}/fund`, {});\n  }\n\n  async listContracts(filters?: { role?: 'buyer' | 'seller'; status?: string }): Promise<Contract[]> {\n    let path = '/api/v1/contracts';\n    const params = new URLSearchParams();\n    if (filters?.role) {\n      if (filters.role !== 'buyer' && filters.role !== 'seller') {\n        throw new Error(\"role must be 'buyer' or 'seller'\");\n      }\n      params.append('role', filters.role);\n    }\n    if (filters?.status) {\n      if (typeof filters.status !== 'string') throw new Error('status must be a string');\n      params.append('status', filters.status);\n    }\n    if (params.toString()) path += '?' + params.toString();\n    const result = await this.request<{ contracts: Contract[] }>('GET', path);\n    return Array.isArray(result.contracts) ? result.contracts : [];\n  }\n\n  async getContract(contractId: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    return this.request('GET', `/api/v1/contracts/${contractId}`);\n  }\n\n  // ─── Delivery ────────────────────────────────────────────────────────────\n\n  async submitDelivery(contractId: string, proofUrl: string, proofData?: any): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    if (!proofUrl || typeof proofUrl !== 'string') throw new Error('proofUrl is required');\n    return this.request('POST', `/api/v1/contracts/${contractId}/deliver`, {\n      proof_url: proofUrl,\n      proof_data: proofData,\n    });\n  }\n\n  async confirmDelivery(contractId: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    return this.request('POST', `/api/v1/contracts/${contractId}/confirm`, {});\n  }\n\n  async disputeDelivery(contractId: string, reason: string, evidenceUrl?: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    if (!reason || typeof reason !== 'string') throw new Error('reason is required');\n    return this.request('POST', `/api/v1/contracts/${contractId}/dispute`, {\n      reason,\n      evidence_url: evidenceUrl,\n    });\n  }\n\n  // ─── Ledger ──────────────────────────────────────────────────────────────\n\n  async getLedger(limit?: number, offset?: number): Promise<{ balance_sats: number; entries: LedgerEntry[] }> {\n    let path = '/api/v1/ledger';\n    const params = new URLSearchParams();\n    if (limit !== undefined) {\n      if (!Number.isInteger(limit) || limit < 1) throw new Error('limit must be a positive integer');\n      params.append('limit', String(limit));\n    }\n    if (offset !== undefined) {\n      if (!Number.isInteger(offset) || offset < 0) throw new Error('offset must be a non-negative integer');\n      params.append('offset', String(offset));\n    }\n    if (params.toString()) path += '?' + params.toString();\n    return this.request('GET', path);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -176,45 +176,19 @@ declare class L402Agent {
     /**
      * High-level deposit: creates invoice, notifies human, waits for payment.
      *
-     * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay
-     * invoices. When an agent needs sats, it must ask a human to pay.
+     * AI agents don't have Lightning wallets. When an agent needs sats, it must
+     * ask a human to pay. This method handles the full flow:
+     * 1. Creates a Lightning invoice
+     * 2. Calls `onPaymentNeeded` to notify the human
+     * 3. Polls until paid or timeout
      *
-     * This method:
-     * 1. Creates a Lightning invoice for the requested amount
-     * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)
-     * 3. Polls until the invoice is paid or times out
-     * 4. Returns the confirmed deposit status
-     *
-     * If `onPaymentNeeded` is not configured, throws with the invoice so the
-     * caller can handle notification manually.
-     *
-     * @param amount_sats - Amount to deposit
-     * @param reason - Human-readable reason (shown in the notification)
-     * @returns Confirmed deposit status
+     * @param amount_sats - Amount to deposit (positive integer)
+     * @param reason - Human-readable reason (shown in notification)
      * @throws {L402Error} if payment times out or fails
-     *
-     * @example
-     * const agent = new L402Agent({
-     *   apiKey: 'sk_...',
-     *   onPaymentNeeded: async (invoice) => {
-     *     // Send to Slack, Discord, Signal, email, etc.
-     *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);
-     *   },
-     * });
-     *
-     * // Agent requests funding and waits
-     * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');
-     * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);
      */
     deposit(amount_sats: number, reason?: string): Promise<DepositStatus>;
     /**
      * Ensure the agent has at least `minBalance` sats. If not, request a deposit.
-     * Convenience method that checks balance first, then deposits the difference.
-     *
-     * @example
-     * // Before accepting an offer, make sure you can pay
-     * await agent.ensureBalance(500, 'Need funds for code-review contract');
-     * await agent.fundContract(contractId);
      */
     ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo>;
     withdraw(amount_sats?: number): Promise<WithdrawResult>;

package/dist/index.d.ts

@@ -176,45 +176,19 @@ declare class L402Agent {
     /**
      * High-level deposit: creates invoice, notifies human, waits for payment.
      *
-     * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay
-     * invoices. When an agent needs sats, it must ask a human to pay.
+     * AI agents don't have Lightning wallets. When an agent needs sats, it must
+     * ask a human to pay. This method handles the full flow:
+     * 1. Creates a Lightning invoice
+     * 2. Calls `onPaymentNeeded` to notify the human
+     * 3. Polls until paid or timeout
      *
-     * This method:
-     * 1. Creates a Lightning invoice for the requested amount
-     * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)
-     * 3. Polls until the invoice is paid or times out
-     * 4. Returns the confirmed deposit status
-     *
-     * If `onPaymentNeeded` is not configured, throws with the invoice so the
-     * caller can handle notification manually.
-     *
-     * @param amount_sats - Amount to deposit
-     * @param reason - Human-readable reason (shown in the notification)
-     * @returns Confirmed deposit status
+     * @param amount_sats - Amount to deposit (positive integer)
+     * @param reason - Human-readable reason (shown in notification)
      * @throws {L402Error} if payment times out or fails
-     *
-     * @example
-     * const agent = new L402Agent({
-     *   apiKey: 'sk_...',
-     *   onPaymentNeeded: async (invoice) => {
-     *     // Send to Slack, Discord, Signal, email, etc.
-     *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);
-     *   },
-     * });
-     *
-     * // Agent requests funding and waits
-     * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');
-     * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);
      */
     deposit(amount_sats: number, reason?: string): Promise<DepositStatus>;
     /**
      * Ensure the agent has at least `minBalance` sats. If not, request a deposit.
-     * Convenience method that checks balance first, then deposits the difference.
-     *
-     * @example
-     * // Before accepting an offer, make sure you can pay
-     * await agent.ensureBalance(500, 'Need funds for code-review contract');
-     * await agent.fundContract(contractId);
      */
     ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo>;
     withdraw(amount_sats?: number): Promise<WithdrawResult>;

package/dist/index.js

@@ -1,4 +1,53 @@
 // src/client.ts
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var HASH_RE = /^[0-9a-f]{64}$/i;
+function validateId(value, label) {
+  if (!value || typeof value !== "string") {
+    throw new Error(`${label} is required`);
+  }
+  if (!UUID_RE.test(value)) {
+    throw new Error(`${label} must be a valid UUID, got: ${value.slice(0, 50)}`);
+  }
+}
+function validateHash(value, label) {
+  if (!value || typeof value !== "string") {
+    throw new Error(`${label} is required`);
+  }
+  if (!HASH_RE.test(value)) {
+    throw new Error(`${label} must be a valid 64-char hex hash`);
+  }
+}
+function validateSats(amount, label) {
+  if (typeof amount !== "number" || !Number.isFinite(amount) || !Number.isInteger(amount) || amount < 1) {
+    throw new Error(`${label} must be a positive integer, got: ${amount}`);
+  }
+}
+function validateUrl(url) {
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      throw new Error("URL must use https:// or http://");
+    }
+  } catch (e) {
+    throw new Error(`Invalid API URL: ${e.message}`);
+  }
+}
+function enforceHttps(url) {
+  const parsed = new URL(url);
+  if (parsed.protocol !== "https:") {
+    throw new Error(
+      `API URL must use HTTPS to protect your API key in transit. Got: ${parsed.protocol}//... Use http:// only for local development (localhost/127.0.0.1).`
+    );
+  }
+}
+function isLocalhost(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "::1";
+  } catch {
+    return false;
+  }
+}
 var L402Error = class extends Error {
   constructor(message, status, code) {
     super(message);
@@ -9,14 +58,19 @@ var L402Error = class extends Error {
 };
 var L402Agent = class {
   constructor(options) {
-    if (!options.apiKey) {
+    if (!options.apiKey || typeof options.apiKey !== "string") {
       throw new Error("apiKey is required");
     }
+    const apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    validateUrl(apiUrl);
+    if (!isLocalhost(apiUrl)) {
+      enforceHttps(apiUrl);
+    }
     this.apiKey = options.apiKey;
-    this.apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    this.apiUrl = apiUrl.replace(/\/+$/, "");
     this.onPaymentNeeded = options.onPaymentNeeded;
     this.paymentTimeoutMs = options.paymentTimeoutMs ?? 3e5;
-    this.paymentPollIntervalMs = options.paymentPollIntervalMs ?? 5e3;
+    this.paymentPollIntervalMs = Math.max(options.paymentPollIntervalMs ?? 5e3, 1e3);
   }
   async request(method, path, body) {
     const url = `${this.apiUrl}${path}`;
@@ -36,40 +90,49 @@ var L402Agent = class {
       let errorCode;
       try {
         const data = await res.json();
-        errorMsg = data.error || errorMsg;
-        errorCode = data.code;
+        if (data.error && typeof data.error === "string") {
+          errorMsg = data.error;
+        }
+        if (data.code && typeof data.code === "string") {
+          errorCode = data.code;
+        }
       } catch {
       }
       throw new L402Error(errorMsg, res.status, errorCode);
     }
     return res.json();
   }
-  // Static: register a new agent (no auth needed)
+  // ─── Static: register ────────────────────────────────────────────────────
   static async register(options) {
-    const apiUrl = options.apiUrl ?? "https://l402gw.nosaltres2.info";
+    if (!options.name || typeof options.name !== "string" || options.name.trim().length < 1) {
+      throw new Error("name is required (non-empty string)");
+    }
+    const apiUrl = (options.apiUrl ?? "https://l402gw.nosaltres2.info").replace(/\/+$/, "");
+    validateUrl(apiUrl);
+    if (!isLocalhost(apiUrl)) enforceHttps(apiUrl);
     const url = `${apiUrl}/api/v1/agents/register`;
     const res = await fetch(url, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
-        name: options.name,
-        description: options.description,
+        name: options.name.trim(),
+        description: options.description?.trim(),
         wallet_type: options.wallet_type ?? "custodial",
-        lightning_address: options.lightning_address
+        lightning_address: options.lightning_address?.trim()
       })
     });
     if (!res.ok) {
       let errorMsg = `HTTP ${res.status}`;
       try {
         const data = await res.json();
-        errorMsg = data.error || errorMsg;
+        if (data.error && typeof data.error === "string") errorMsg = data.error;
       } catch {
       }
       throw new L402Error(errorMsg, res.status);
     }
     return res.json();
   }
-  // Wallet
+  // ─── Wallet ──────────────────────────────────────────────────────────────
   async getBalance() {
     return this.request("GET", "/api/v1/wallet/balance");
   }
@@ -78,6 +141,7 @@ var L402Agent = class {
    * Most agents should use `deposit()` instead, which notifies the human and waits.
    */
   async createDeposit(amount_sats) {
+    validateSats(amount_sats, "amount_sats");
     const result = await this.request("POST", "/api/v1/wallet/deposit", { amount_sats });
     return {
       ...result,
@@ -88,42 +152,24 @@ var L402Agent = class {
    * Check if a deposit invoice has been paid.
    */
   async checkDeposit(paymentHash) {
+    validateHash(paymentHash, "paymentHash");
     return this.request("GET", `/api/v1/wallet/deposit/${paymentHash}`);
   }
   /**
    * High-level deposit: creates invoice, notifies human, waits for payment.
    *
-   * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay
-   * invoices. When an agent needs sats, it must ask a human to pay.
+   * AI agents don't have Lightning wallets. When an agent needs sats, it must
+   * ask a human to pay. This method handles the full flow:
+   * 1. Creates a Lightning invoice
+   * 2. Calls `onPaymentNeeded` to notify the human
+   * 3. Polls until paid or timeout
    *
-   * This method:
-   * 1. Creates a Lightning invoice for the requested amount
-   * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)
-   * 3. Polls until the invoice is paid or times out
-   * 4. Returns the confirmed deposit status
-   *
-   * If `onPaymentNeeded` is not configured, throws with the invoice so the
-   * caller can handle notification manually.
-   *
-   * @param amount_sats - Amount to deposit
-   * @param reason - Human-readable reason (shown in the notification)
-   * @returns Confirmed deposit status
+   * @param amount_sats - Amount to deposit (positive integer)
+   * @param reason - Human-readable reason (shown in notification)
    * @throws {L402Error} if payment times out or fails
-   *
-   * @example
-   * const agent = new L402Agent({
-   *   apiKey: 'sk_...',
-   *   onPaymentNeeded: async (invoice) => {
-   *     // Send to Slack, Discord, Signal, email, etc.
-   *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);
-   *   },
-   * });
-   *
-   * // Agent requests funding and waits
-   * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');
-   * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);
    */
   async deposit(amount_sats, reason) {
+    validateSats(amount_sats, "amount_sats");
     const invoice = await this.createDeposit(amount_sats);
     if (!this.onPaymentNeeded) {
       throw new L402Error(
@@ -143,18 +189,31 @@ var L402Agent = class {
         invoice.invoice
       ].join("\n")
     };
-    await this.onPaymentNeeded(enrichedInvoice);
+    const callbackTimeout = 3e4;
+    try {
+      await Promise.race([
+        this.onPaymentNeeded(enrichedInvoice),
+        new Promise(
+          (_, reject) => setTimeout(() => reject(new Error("onPaymentNeeded callback timed out after 30s")), callbackTimeout)
+        )
+      ]);
+    } catch (err) {
+      console.warn(`[satonomous] Payment notification warning: ${err.message}`);
+    }
     if (this.paymentTimeoutMs === 0) {
       return { status: "pending", amount_sats, paid_at: null };
     }
     const deadline = Date.now() + this.paymentTimeoutMs;
+    let pollInterval = this.paymentPollIntervalMs;
+    const maxInterval = 3e4;
     while (Date.now() < deadline) {
-      await new Promise((r) => setTimeout(r, this.paymentPollIntervalMs));
+      await new Promise((r) => setTimeout(r, pollInterval));
       const status = await this.checkDeposit(invoice.payment_hash);
       if (status.status === "paid") return status;
       if (status.status === "expired") {
         throw new L402Error("Deposit invoice expired before payment", 408, "PAYMENT_EXPIRED");
       }
+      pollInterval = Math.min(pollInterval * 1.5, maxInterval);
     }
     throw new L402Error(
       `Payment not received within ${this.paymentTimeoutMs / 1e3}s. Invoice may still be valid \u2014 check with checkDeposit('${invoice.payment_hash}')`,
@@ -164,14 +223,9 @@ var L402Agent = class {
   }
   /**
    * Ensure the agent has at least `minBalance` sats. If not, request a deposit.
-   * Convenience method that checks balance first, then deposits the difference.
-   *
-   * @example
-   * // Before accepting an offer, make sure you can pay
-   * await agent.ensureBalance(500, 'Need funds for code-review contract');
-   * await agent.fundContract(contractId);
    */
   async ensureBalance(minBalance, reason) {
+    validateSats(minBalance, "minBalance");
     const current = await this.getBalance();
     if (current.balance_sats >= minBalance) return current;
     const needed = minBalance - current.balance_sats;
@@ -179,63 +233,99 @@ var L402Agent = class {
     return this.getBalance();
   }
   async withdraw(amount_sats) {
+    if (amount_sats !== void 0) validateSats(amount_sats, "amount_sats");
     return this.request("POST", "/api/v1/wallet/withdraw", amount_sats ? { amount_sats } : {});
   }
-  // Offers
+  // ─── Offers ──────────────────────────────────────────────────────────────
   async createOffer(params) {
-    return this.request("POST", "/api/v1/offers", params);
+    if (!params.title || typeof params.title !== "string") throw new Error("title is required");
+    if (!params.service_type || typeof params.service_type !== "string") throw new Error("service_type is required");
+    validateSats(params.price_sats, "price_sats");
+    const { sla_minutes, dispute_window_minutes, ...rest } = params;
+    return this.request("POST", "/api/v1/offers", {
+      ...rest,
+      terms: {
+        sla_minutes: sla_minutes ?? 30,
+        dispute_window_minutes: dispute_window_minutes ?? 1440
+      }
+    });
   }
   async listOffers() {
     const result = await this.request("GET", "/api/v1/offers");
-    return result.offers || [];
+    return Array.isArray(result.offers) ? result.offers : [];
   }
   async getOffer(offerId) {
+    validateId(offerId, "offerId");
     return this.request("GET", `/api/v1/offers/${offerId}`);
   }
   async updateOffer(offerId, active) {
+    validateId(offerId, "offerId");
+    if (typeof active !== "boolean") throw new Error("active must be a boolean");
     return this.request("PATCH", `/api/v1/offers/${offerId}`, { active });
   }
-  // Contracts
+  // ─── Contracts ───────────────────────────────────────────────────────────
   async acceptOffer(offerId) {
+    validateId(offerId, "offerId");
     return this.request("POST", "/api/v1/contracts", { offer_id: offerId });
   }
   async fundContract(contractId) {
+    validateId(contractId, "contractId");
     return this.request("POST", `/api/v1/contracts/${contractId}/fund`, {});
   }
   async listContracts(filters) {
     let path = "/api/v1/contracts";
     const params = new URLSearchParams();
-    if (filters?.role) params.append("role", filters.role);
-    if (filters?.status) params.append("status", filters.status);
+    if (filters?.role) {
+      if (filters.role !== "buyer" && filters.role !== "seller") {
+        throw new Error("role must be 'buyer' or 'seller'");
+      }
+      params.append("role", filters.role);
+    }
+    if (filters?.status) {
+      if (typeof filters.status !== "string") throw new Error("status must be a string");
+      params.append("status", filters.status);
+    }
     if (params.toString()) path += "?" + params.toString();
     const result = await this.request("GET", path);
-    return result.contracts || [];
+    return Array.isArray(result.contracts) ? result.contracts : [];
   }
   async getContract(contractId) {
+    validateId(contractId, "contractId");
     return this.request("GET", `/api/v1/contracts/${contractId}`);
   }
-  // Delivery
+  // ─── Delivery ────────────────────────────────────────────────────────────
   async submitDelivery(contractId, proofUrl, proofData) {
+    validateId(contractId, "contractId");
+    if (!proofUrl || typeof proofUrl !== "string") throw new Error("proofUrl is required");
     return this.request("POST", `/api/v1/contracts/${contractId}/deliver`, {
       proof_url: proofUrl,
       proof_data: proofData
     });
   }
   async confirmDelivery(contractId) {
+    validateId(contractId, "contractId");
     return this.request("POST", `/api/v1/contracts/${contractId}/confirm`, {});
   }
   async disputeDelivery(contractId, reason, evidenceUrl) {
+    validateId(contractId, "contractId");
+    if (!reason || typeof reason !== "string") throw new Error("reason is required");
     return this.request("POST", `/api/v1/contracts/${contractId}/dispute`, {
       reason,
       evidence_url: evidenceUrl
     });
   }
-  // Ledger
+  // ─── Ledger ──────────────────────────────────────────────────────────────
   async getLedger(limit, offset) {
     let path = "/api/v1/ledger";
     const params = new URLSearchParams();
-    if (limit) params.append("limit", String(limit));
-    if (offset) params.append("offset", String(offset));
+    if (limit !== void 0) {
+      if (!Number.isInteger(limit) || limit < 1) throw new Error("limit must be a positive integer");
+      params.append("limit", String(limit));
+    }
+    if (offset !== void 0) {
+      if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be a non-negative integer");
+      params.append("offset", String(offset));
+    }
     if (params.toString()) path += "?" + params.toString();
     return this.request("GET", path);
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n\nexport class L402Error extends Error {\n  status: number;\n  code?: string;\n\n  constructor(message: string, status: number, code?: string) {\n    super(message);\n    this.name = 'L402Error';\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class L402Agent {\n  private apiKey: string;\n  private apiUrl: string;\n\n  private onPaymentNeeded?: PaymentNeededCallback;\n  private paymentTimeoutMs: number;\n  private paymentPollIntervalMs: number;\n\n  constructor(options: L402AgentOptions) {\n    if (!options.apiKey) {\n      throw new Error('apiKey is required');\n    }\n    this.apiKey = options.apiKey;\n    this.apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    this.onPaymentNeeded = options.onPaymentNeeded;\n    this.paymentTimeoutMs = options.paymentTimeoutMs ?? 300_000;\n    this.paymentPollIntervalMs = options.paymentPollIntervalMs ?? 5_000;\n  }\n\n  private async request<T>(method: string, path: string, body?: any): Promise<T> {\n    const url = `${this.apiUrl}${path}`;\n    const options: RequestInit = {\n      method,\n      headers: {\n        'X-L402-Key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const res = await fetch(url, options);\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      let errorCode: string | undefined;\n\n      try {\n        const data = await res.json() as { error?: string; code?: string };\n        errorMsg = data.error || errorMsg;\n        errorCode = data.code;\n      } catch {\n        // Use default error message\n      }\n\n      throw new L402Error(errorMsg, res.status, errorCode);\n    }\n\n    return res.json() as Promise<T>;\n  }\n\n  // Static: register a new agent (no auth needed)\n  static async register(options: {\n    name: string;\n    description?: string;\n    wallet_type?: 'custodial' | 'external';\n    lightning_address?: string;\n    apiUrl?: string;\n  }): Promise<AgentRegistration> {\n    const apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    const url = `${apiUrl}/api/v1/agents/register`;\n\n    const res = await fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        name: options.name,\n        description: options.description,\n        wallet_type: options.wallet_type ?? 'custodial',\n        lightning_address: options.lightning_address,\n      }),\n    });\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      try {\n        const data = await res.json() as { error?: string };\n        errorMsg = data.error || errorMsg;\n      } catch {\n        // Use default error message\n      }\n      throw new L402Error(errorMsg, res.status);\n    }\n\n    return res.json() as Promise<AgentRegistration>;\n  }\n\n  // Wallet\n  async getBalance(): Promise<BalanceInfo> {\n    return this.request('GET', '/api/v1/wallet/balance');\n  }\n\n  /**\n   * Low-level: create a deposit invoice. Returns the invoice for manual handling.\n   * Most agents should use `deposit()` instead, which notifies the human and waits.\n   */\n  async createDeposit(amount_sats: number): Promise<DepositInvoice> {\n    const result = await this.request<DepositInvoice>('POST', '/api/v1/wallet/deposit', { amount_sats });\n    // Add pay_url for easy wallet linking\n    return {\n      ...result,\n      pay_url: `lightning:${result.invoice}`,\n    };\n  }\n\n  /**\n   * Check if a deposit invoice has been paid.\n   */\n  async checkDeposit(paymentHash: string): Promise<DepositStatus> {\n    return this.request('GET', `/api/v1/wallet/deposit/${paymentHash}`);\n  }\n\n  /**\n   * High-level deposit: creates invoice, notifies human, waits for payment.\n   *\n   * WHY THIS EXISTS: AI agents don't have Lightning wallets. They can't pay\n   * invoices. When an agent needs sats, it must ask a human to pay.\n   *\n   * This method:\n   * 1. Creates a Lightning invoice for the requested amount\n   * 2. Calls `onPaymentNeeded` so you can notify the human (chat, email, UI)\n   * 3. Polls until the invoice is paid or times out\n   * 4. Returns the confirmed deposit status\n   *\n   * If `onPaymentNeeded` is not configured, throws with the invoice so the\n   * caller can handle notification manually.\n   *\n   * @param amount_sats - Amount to deposit\n   * @param reason - Human-readable reason (shown in the notification)\n   * @returns Confirmed deposit status\n   * @throws {L402Error} if payment times out or fails\n   *\n   * @example\n   * const agent = new L402Agent({\n   *   apiKey: 'sk_...',\n   *   onPaymentNeeded: async (invoice) => {\n   *     // Send to Slack, Discord, Signal, email, etc.\n   *     await notify(`Pay ${invoice.amount_sats} sats: ${invoice.invoice}`);\n   *   },\n   * });\n   *\n   * // Agent requests funding and waits\n   * const deposit = await agent.deposit(1000, 'Need funds to accept code-review offer');\n   * console.log(`Funded! Balance: ${deposit.amount_sats} sats`);\n   */\n  async deposit(amount_sats: number, reason?: string): Promise<DepositStatus> {\n    const invoice = await this.createDeposit(amount_sats);\n\n    // If no callback, throw with invoice details so caller can handle it\n    if (!this.onPaymentNeeded) {\n      throw new L402Error(\n        `Payment needed: ${amount_sats} sats. ` +\n        `Invoice: ${invoice.invoice}. ` +\n        `No onPaymentNeeded callback configured — pay this invoice manually ` +\n        `and call checkDeposit('${invoice.payment_hash}') to confirm.`,\n        402,\n        'PAYMENT_NEEDED'\n      );\n    }\n\n    // Notify the human with clear payment instructions\n    const enrichedInvoice: DepositInvoice = {\n      ...invoice,\n      message: [\n        reason\n          ? `⚡ Agent needs ${amount_sats} sats: ${reason}`\n          : `⚡ Agent needs ${amount_sats} sats deposited`,\n        '',\n        `📱 Tap to pay: ${invoice.pay_url}`,\n        '',\n        `Or paste this invoice into any Lightning wallet:`,\n        invoice.invoice,\n      ].join('\\n'),\n    };\n    await this.onPaymentNeeded(enrichedInvoice);\n\n    // Poll for payment\n    if (this.paymentTimeoutMs === 0) {\n      return { status: 'pending', amount_sats, paid_at: null };\n    }\n\n    const deadline = Date.now() + this.paymentTimeoutMs;\n    while (Date.now() < deadline) {\n      await new Promise(r => setTimeout(r, this.paymentPollIntervalMs));\n      const status = await this.checkDeposit(invoice.payment_hash);\n      if (status.status === 'paid') return status;\n      if (status.status === 'expired') {\n        throw new L402Error('Deposit invoice expired before payment', 408, 'PAYMENT_EXPIRED');\n      }\n    }\n\n    throw new L402Error(\n      `Payment not received within ${this.paymentTimeoutMs / 1000}s. ` +\n      `Invoice may still be valid — check with checkDeposit('${invoice.payment_hash}')`,\n      408,\n      'PAYMENT_TIMEOUT'\n    );\n  }\n\n  /**\n   * Ensure the agent has at least `minBalance` sats. If not, request a deposit.\n   * Convenience method that checks balance first, then deposits the difference.\n   *\n   * @example\n   * // Before accepting an offer, make sure you can pay\n   * await agent.ensureBalance(500, 'Need funds for code-review contract');\n   * await agent.fundContract(contractId);\n   */\n  async ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo> {\n    const current = await this.getBalance();\n    if (current.balance_sats >= minBalance) return current;\n\n    const needed = minBalance - current.balance_sats;\n    await this.deposit(needed, reason ?? `Need ${needed} more sats (have ${current.balance_sats}, need ${minBalance})`);\n    return this.getBalance();\n  }\n\n  async withdraw(amount_sats?: number): Promise<WithdrawResult> {\n    return this.request('POST', '/api/v1/wallet/withdraw', amount_sats ? { amount_sats } : {});\n  }\n\n  // Offers\n  async createOffer(params: CreateOfferParams): Promise<Offer> {\n    return this.request('POST', '/api/v1/offers', params);\n  }\n\n  async listOffers(): Promise<Offer[]> {\n    const result = await this.request<{ offers: Offer[] }>('GET', '/api/v1/offers');\n    return result.offers || [];\n  }\n\n  async getOffer(offerId: string): Promise<Offer> {\n    return this.request('GET', `/api/v1/offers/${offerId}`);\n  }\n\n  async updateOffer(offerId: string, active: boolean): Promise<Offer> {\n    return this.request('PATCH', `/api/v1/offers/${offerId}`, { active });\n  }\n\n  // Contracts\n  async acceptOffer(offerId: string): Promise<Contract> {\n    return this.request('POST', '/api/v1/contracts', { offer_id: offerId });\n  }\n\n  async fundContract(contractId: string): Promise<FundResult> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/fund`, {});\n  }\n\n  async listContracts(filters?: { role?: 'buyer' | 'seller'; status?: string }): Promise<Contract[]> {\n    let path = '/api/v1/contracts';\n    const params = new URLSearchParams();\n    if (filters?.role) params.append('role', filters.role);\n    if (filters?.status) params.append('status', filters.status);\n    if (params.toString()) path += '?' + params.toString();\n    const result = await this.request<{ contracts: Contract[] }>('GET', path);\n    return result.contracts || [];\n  }\n\n  async getContract(contractId: string): Promise<Contract> {\n    return this.request('GET', `/api/v1/contracts/${contractId}`);\n  }\n\n  // Delivery\n  async submitDelivery(contractId: string, proofUrl: string, proofData?: any): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/deliver`, {\n      proof_url: proofUrl,\n      proof_data: proofData,\n    });\n  }\n\n  async confirmDelivery(contractId: string): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/confirm`, {});\n  }\n\n  async disputeDelivery(contractId: string, reason: string, evidenceUrl?: string): Promise<Contract> {\n    return this.request('POST', `/api/v1/contracts/${contractId}/dispute`, {\n      reason,\n      evidence_url: evidenceUrl,\n    });\n  }\n\n  // Ledger\n  async getLedger(limit?: number, offset?: number): Promise<{ balance_sats: number; entries: LedgerEntry[] }> {\n    let path = '/api/v1/ledger';\n    const params = new URLSearchParams();\n    if (limit) params.append('limit', String(limit));\n    if (offset) params.append('offset', String(offset));\n    if (params.toString()) path += '?' + params.toString();\n    return this.request('GET', path);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  L402AgentOptions,\n  BalanceInfo,\n  Offer,\n  CreateOfferParams,\n  Contract,\n  FundResult,\n  DepositInvoice,\n  DepositStatus,\n  LedgerEntry,\n  WithdrawResult,\n  AgentRegistration,\n  PaymentNeededCallback,\n} from './types.js';\n\n// ─── Validation helpers ──────────────────────────────────────────────────────\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst HASH_RE = /^[0-9a-f]{64}$/i;\n\nfunction validateId(value: string, label: string): void {\n  if (!value || typeof value !== 'string') {\n    throw new Error(`${label} is required`);\n  }\n  if (!UUID_RE.test(value)) {\n    throw new Error(`${label} must be a valid UUID, got: ${value.slice(0, 50)}`);\n  }\n}\n\nfunction validateHash(value: string, label: string): void {\n  if (!value || typeof value !== 'string') {\n    throw new Error(`${label} is required`);\n  }\n  if (!HASH_RE.test(value)) {\n    throw new Error(`${label} must be a valid 64-char hex hash`);\n  }\n}\n\nfunction validateSats(amount: number, label: string): void {\n  if (typeof amount !== 'number' || !Number.isFinite(amount) || !Number.isInteger(amount) || amount < 1) {\n    throw new Error(`${label} must be a positive integer, got: ${amount}`);\n  }\n}\n\nfunction validateUrl(url: string): void {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n      throw new Error('URL must use https:// or http://');\n    }\n  } catch (e: any) {\n    throw new Error(`Invalid API URL: ${e.message}`);\n  }\n}\n\nfunction enforceHttps(url: string): void {\n  const parsed = new URL(url);\n  if (parsed.protocol !== 'https:') {\n    throw new Error(\n      `API URL must use HTTPS to protect your API key in transit. Got: ${parsed.protocol}//... ` +\n      `Use http:// only for local development (localhost/127.0.0.1).`\n    );\n  }\n}\n\nfunction isLocalhost(url: string): boolean {\n  try {\n    const parsed = new URL(url);\n    return parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';\n  } catch {\n    return false;\n  }\n}\n\n// ─── Error class ─────────────────────────────────────────────────────────────\n\nexport class L402Error extends Error {\n  status: number;\n  code?: string;\n\n  constructor(message: string, status: number, code?: string) {\n    super(message);\n    this.name = 'L402Error';\n    this.status = status;\n    this.code = code;\n  }\n}\n\n// ─── Main client ─────────────────────────────────────────────────────────────\n\nexport class L402Agent {\n  private apiKey: string;\n  private apiUrl: string;\n\n  private onPaymentNeeded?: PaymentNeededCallback;\n  private paymentTimeoutMs: number;\n  private paymentPollIntervalMs: number;\n\n  constructor(options: L402AgentOptions) {\n    if (!options.apiKey || typeof options.apiKey !== 'string') {\n      throw new Error('apiKey is required');\n    }\n\n    const apiUrl = options.apiUrl ?? 'https://l402gw.nosaltres2.info';\n    validateUrl(apiUrl);\n\n    // Enforce HTTPS unless localhost (development)\n    if (!isLocalhost(apiUrl)) {\n      enforceHttps(apiUrl);\n    }\n\n    this.apiKey = options.apiKey;\n    this.apiUrl = apiUrl.replace(/\\/+$/, ''); // strip trailing slashes\n    this.onPaymentNeeded = options.onPaymentNeeded;\n    this.paymentTimeoutMs = options.paymentTimeoutMs ?? 300_000;\n    this.paymentPollIntervalMs = Math.max(options.paymentPollIntervalMs ?? 5_000, 1_000); // min 1s\n  }\n\n  private async request<T>(method: string, path: string, body?: any): Promise<T> {\n    const url = `${this.apiUrl}${path}`;\n    const options: RequestInit = {\n      method,\n      headers: {\n        'X-L402-Key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const res = await fetch(url, options);\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      let errorCode: string | undefined;\n\n      try {\n        const data = await res.json() as { error?: string; code?: string };\n        if (data.error && typeof data.error === 'string') {\n          errorMsg = data.error;\n        }\n        if (data.code && typeof data.code === 'string') {\n          errorCode = data.code;\n        }\n      } catch {\n        // Use default error message\n      }\n\n      throw new L402Error(errorMsg, res.status, errorCode);\n    }\n\n    return res.json() as Promise<T>;\n  }\n\n  // ─── Static: register ────────────────────────────────────────────────────\n\n  static async register(options: {\n    name: string;\n    description?: string;\n    wallet_type?: 'custodial' | 'external';\n    lightning_address?: string;\n    apiUrl?: string;\n  }): Promise<AgentRegistration> {\n    if (!options.name || typeof options.name !== 'string' || options.name.trim().length < 1) {\n      throw new Error('name is required (non-empty string)');\n    }\n\n    const apiUrl = (options.apiUrl ?? 'https://l402gw.nosaltres2.info').replace(/\\/+$/, '');\n    validateUrl(apiUrl);\n    if (!isLocalhost(apiUrl)) enforceHttps(apiUrl);\n\n    const url = `${apiUrl}/api/v1/agents/register`;\n\n    const res = await fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        name: options.name.trim(),\n        description: options.description?.trim(),\n        wallet_type: options.wallet_type ?? 'custodial',\n        lightning_address: options.lightning_address?.trim(),\n      }),\n    });\n\n    if (!res.ok) {\n      let errorMsg = `HTTP ${res.status}`;\n      try {\n        const data = await res.json() as { error?: string };\n        if (data.error && typeof data.error === 'string') errorMsg = data.error;\n      } catch {\n        // Use default\n      }\n      throw new L402Error(errorMsg, res.status);\n    }\n\n    return res.json() as Promise<AgentRegistration>;\n  }\n\n  // ─── Wallet ──────────────────────────────────────────────────────────────\n\n  async getBalance(): Promise<BalanceInfo> {\n    return this.request('GET', '/api/v1/wallet/balance');\n  }\n\n  /**\n   * Low-level: create a deposit invoice. Returns the invoice for manual handling.\n   * Most agents should use `deposit()` instead, which notifies the human and waits.\n   */\n  async createDeposit(amount_sats: number): Promise<DepositInvoice> {\n    validateSats(amount_sats, 'amount_sats');\n    const result = await this.request<DepositInvoice>('POST', '/api/v1/wallet/deposit', { amount_sats });\n    return {\n      ...result,\n      pay_url: `lightning:${result.invoice}`,\n    };\n  }\n\n  /**\n   * Check if a deposit invoice has been paid.\n   */\n  async checkDeposit(paymentHash: string): Promise<DepositStatus> {\n    validateHash(paymentHash, 'paymentHash');\n    return this.request('GET', `/api/v1/wallet/deposit/${paymentHash}`);\n  }\n\n  /**\n   * High-level deposit: creates invoice, notifies human, waits for payment.\n   *\n   * AI agents don't have Lightning wallets. When an agent needs sats, it must\n   * ask a human to pay. This method handles the full flow:\n   * 1. Creates a Lightning invoice\n   * 2. Calls `onPaymentNeeded` to notify the human\n   * 3. Polls until paid or timeout\n   *\n   * @param amount_sats - Amount to deposit (positive integer)\n   * @param reason - Human-readable reason (shown in notification)\n   * @throws {L402Error} if payment times out or fails\n   */\n  async deposit(amount_sats: number, reason?: string): Promise<DepositStatus> {\n    validateSats(amount_sats, 'amount_sats');\n    const invoice = await this.createDeposit(amount_sats);\n\n    if (!this.onPaymentNeeded) {\n      throw new L402Error(\n        `Payment needed: ${amount_sats} sats. ` +\n        `Invoice: ${invoice.invoice}. ` +\n        `No onPaymentNeeded callback configured — pay this invoice manually ` +\n        `and call checkDeposit('${invoice.payment_hash}') to confirm.`,\n        402,\n        'PAYMENT_NEEDED'\n      );\n    }\n\n    // Notify the human with payment instructions\n    const enrichedInvoice: DepositInvoice = {\n      ...invoice,\n      message: [\n        reason\n          ? `⚡ Agent needs ${amount_sats} sats: ${reason}`\n          : `⚡ Agent needs ${amount_sats} sats deposited`,\n        '',\n        `📱 Tap to pay: ${invoice.pay_url}`,\n        '',\n        `Or paste this invoice into any Lightning wallet:`,\n        invoice.invoice,\n      ].join('\\n'),\n    };\n\n    // Timeout-protect the callback (30s max)\n    const callbackTimeout = 30_000;\n    try {\n      await Promise.race([\n        this.onPaymentNeeded(enrichedInvoice),\n        new Promise((_, reject) =>\n          setTimeout(() => reject(new Error('onPaymentNeeded callback timed out after 30s')), callbackTimeout)\n        ),\n      ]);\n    } catch (err: any) {\n      // Log but don't fail — the invoice is still valid, just notification may have failed\n      console.warn(`[satonomous] Payment notification warning: ${err.message}`);\n    }\n\n    // Poll for payment with exponential backoff\n    if (this.paymentTimeoutMs === 0) {\n      return { status: 'pending', amount_sats, paid_at: null };\n    }\n\n    const deadline = Date.now() + this.paymentTimeoutMs;\n    let pollInterval = this.paymentPollIntervalMs;\n    const maxInterval = 30_000; // cap at 30s\n\n    while (Date.now() < deadline) {\n      await new Promise(r => setTimeout(r, pollInterval));\n      const status = await this.checkDeposit(invoice.payment_hash);\n      if (status.status === 'paid') return status;\n      if (status.status === 'expired') {\n        throw new L402Error('Deposit invoice expired before payment', 408, 'PAYMENT_EXPIRED');\n      }\n      // Exponential backoff: 5s → 7.5s → 11.25s → ... → 30s max\n      pollInterval = Math.min(pollInterval * 1.5, maxInterval);\n    }\n\n    throw new L402Error(\n      `Payment not received within ${this.paymentTimeoutMs / 1000}s. ` +\n      `Invoice may still be valid — check with checkDeposit('${invoice.payment_hash}')`,\n      408,\n      'PAYMENT_TIMEOUT'\n    );\n  }\n\n  /**\n   * Ensure the agent has at least `minBalance` sats. If not, request a deposit.\n   */\n  async ensureBalance(minBalance: number, reason?: string): Promise<BalanceInfo> {\n    validateSats(minBalance, 'minBalance');\n    const current = await this.getBalance();\n    if (current.balance_sats >= minBalance) return current;\n\n    const needed = minBalance - current.balance_sats;\n    await this.deposit(needed, reason ?? `Need ${needed} more sats (have ${current.balance_sats}, need ${minBalance})`);\n    return this.getBalance();\n  }\n\n  async withdraw(amount_sats?: number): Promise<WithdrawResult> {\n    if (amount_sats !== undefined) validateSats(amount_sats, 'amount_sats');\n    return this.request('POST', '/api/v1/wallet/withdraw', amount_sats ? { amount_sats } : {});\n  }\n\n  // ─── Offers ──────────────────────────────────────────────────────────────\n\n  async createOffer(params: CreateOfferParams): Promise<Offer> {\n    if (!params.title || typeof params.title !== 'string') throw new Error('title is required');\n    if (!params.service_type || typeof params.service_type !== 'string') throw new Error('service_type is required');\n    validateSats(params.price_sats, 'price_sats');\n\n    const { sla_minutes, dispute_window_minutes, ...rest } = params;\n    return this.request('POST', '/api/v1/offers', {\n      ...rest,\n      terms: {\n        sla_minutes: sla_minutes ?? 30,\n        dispute_window_minutes: dispute_window_minutes ?? 1440,\n      },\n    });\n  }\n\n  async listOffers(): Promise<Offer[]> {\n    const result = await this.request<{ offers: Offer[] }>('GET', '/api/v1/offers');\n    return Array.isArray(result.offers) ? result.offers : [];\n  }\n\n  async getOffer(offerId: string): Promise<Offer> {\n    validateId(offerId, 'offerId');\n    return this.request('GET', `/api/v1/offers/${offerId}`);\n  }\n\n  async updateOffer(offerId: string, active: boolean): Promise<Offer> {\n    validateId(offerId, 'offerId');\n    if (typeof active !== 'boolean') throw new Error('active must be a boolean');\n    return this.request('PATCH', `/api/v1/offers/${offerId}`, { active });\n  }\n\n  // ─── Contracts ───────────────────────────────────────────────────────────\n\n  async acceptOffer(offerId: string): Promise<Contract> {\n    validateId(offerId, 'offerId');\n    return this.request('POST', '/api/v1/contracts', { offer_id: offerId });\n  }\n\n  async fundContract(contractId: string): Promise<FundResult> {\n    validateId(contractId, 'contractId');\n    return this.request('POST', `/api/v1/contracts/${contractId}/fund`, {});\n  }\n\n  async listContracts(filters?: { role?: 'buyer' | 'seller'; status?: string }): Promise<Contract[]> {\n    let path = '/api/v1/contracts';\n    const params = new URLSearchParams();\n    if (filters?.role) {\n      if (filters.role !== 'buyer' && filters.role !== 'seller') {\n        throw new Error(\"role must be 'buyer' or 'seller'\");\n      }\n      params.append('role', filters.role);\n    }\n    if (filters?.status) {\n      if (typeof filters.status !== 'string') throw new Error('status must be a string');\n      params.append('status', filters.status);\n    }\n    if (params.toString()) path += '?' + params.toString();\n    const result = await this.request<{ contracts: Contract[] }>('GET', path);\n    return Array.isArray(result.contracts) ? result.contracts : [];\n  }\n\n  async getContract(contractId: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    return this.request('GET', `/api/v1/contracts/${contractId}`);\n  }\n\n  // ─── Delivery ────────────────────────────────────────────────────────────\n\n  async submitDelivery(contractId: string, proofUrl: string, proofData?: any): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    if (!proofUrl || typeof proofUrl !== 'string') throw new Error('proofUrl is required');\n    return this.request('POST', `/api/v1/contracts/${contractId}/deliver`, {\n      proof_url: proofUrl,\n      proof_data: proofData,\n    });\n  }\n\n  async confirmDelivery(contractId: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    return this.request('POST', `/api/v1/contracts/${contractId}/confirm`, {});\n  }\n\n  async disputeDelivery(contractId: string, reason: string, evidenceUrl?: string): Promise<Contract> {\n    validateId(contractId, 'contractId');\n    if (!reason || typeof reason !== 'string') throw new Error('reason is required');\n    return this.request('POST', `/api/v1/contracts/${contractId}/dispute`, {\n      reason,\n      evidence_url: evidenceUrl,\n    });\n  }\n\n  // ─── Ledger ──────────────────────────────────────────────────────────────\n\n  async getLedger(limit?: number, offset?: number): Promise<{ balance_sats: number; entries: LedgerEntry[] }> {\n    let path = '/api/v1/ledger';\n    const params = new URLSearchParams();\n    if (limit !== undefined) {\n      if (!Number.isInteger(limit) || limit < 1) throw new Error('limit must be a positive integer');\n      params.append('limit', String(limit));\n    }\n    if (offset !== undefined) {\n      if (!Number.isInteger(offset) || offset < 0) throw new Error('offset must be a non-negative integer');\n      params.append('offset', String(offset));\n    }\n    if (params.toString()) path += '?' + params.toString();\n    return this.request('GET', path);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "satonomous",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "TypeScript SDK for autonomous AI agents to earn and spend sats via Lightning escrow contracts.",
   "keywords": [
     "l402",