npm - satonomous - Versions diffs - 0.2.2 → 0.3.0 - Mend

satonomous 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs CHANGED Viewed

@@ -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.
-   *
-   * 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.
+   * 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
    *
-   * @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,10 +260,14 @@ 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) {
+    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,
@@ -221,55 +279,80 @@ var L402Agent = class {
   }
   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 CHANGED Viewed

	@@ -1 +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 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 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":[]}
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\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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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.
-   *
-   * 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.
+   * 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
    *
-   * @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,10 +233,14 @@ 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) {
+    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,
@@ -194,55 +252,80 @@ var L402Agent = class {
   }
   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 CHANGED Viewed

	@@ -1 +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 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 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":[]}
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\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 CHANGED Viewed

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