@healchain/sdk 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@healchain/sdk",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "JavaScript SDK for HealChain — self-healing decentralized storage via Reed-Solomon erasure coding",
   "main": "src/index.js",
   "module": "src/index.js",

package/src/index.js

@@ -272,6 +272,51 @@ class HealChain {
   async list(page = 0, limit = 10) {
     return this._fetch(`/listRecords?page=${page}&limit=${limit}`);
   }
+
+  // ── getBillingBalance() ───────────────────────────────────────────────────
+  /**
+   * Get credit balances for a wallet address. No API key required.
+   *
+   * @param {string} walletAddress - Wallet address (0x...)
+   * @returns {Promise<object>} Production and testnet balances
+   */
+  async getBillingBalance(walletAddress) {
+    const path = `/billing/balance?wallet=${encodeURIComponent(walletAddress)}`;
+    return this._fetch(path, { headers: { 'User-Agent': 'healchain-sdk/0.3.0' } });
+  }
+
+  // ── createCheckout() ──────────────────────────────────────────────────────
+
+  /**
+   * Create a Stripe Checkout session for topping up credits.
+   * Redirects user to Stripe hosted payment page.
+   *
+   * @param {string} walletAddress - Wallet address to credit
+   * @param {number} amountCents   - Amount in cents (min 500 = $5.00)
+   * @returns {Promise<object>} { checkout_url, session_id, amount_usd }
+   */
+  async createCheckout(walletAddress, amountCents) {
+    return this._fetch('/checkout/create', {
+      method: 'POST',
+      body: JSON.stringify({ wallet_address: walletAddress, amount_cents: amountCents }),
+    });
+  }
+
+  // ── requestTestnetCredits() ───────────────────────────────────────────────
+
+  /**
+   * Request free testnet credits ($1.00 per wallet per 24 hours).
+   * Wallet must be whitelisted during early access phase.
+   *
+   * @param {string} walletAddress - Wallet address to credit
+   * @returns {Promise<object>} { granted_usd, balance_usd, expires_in_days }
+   */
+  async requestTestnetCredits(walletAddress) {
+    return this._fetch('/testnet/requestCredits', {
+      method: 'POST',
+      body: JSON.stringify({ wallet_address: walletAddress }),
+    });
+  }
 }
 
 // ── Exports ───────────────────────────────────────────────────────────────────