@healchain/sdk 0.1.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@healchain/sdk",
-  "version": "0.1.0",
+  "version": "0.4.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

@@ -1,5 +1,5 @@
 /**
- * HealChain SDK v0.1.0
+ * HealChain SDK v0.4.0
  * REST API client for HealChain — self-healing decentralized storage.
  *
  * Browser (ESM) and Node.js compatible.
@@ -64,7 +64,8 @@ class HealChain {
    * @param {number}  [options.pollTimeout]   - Fulfillment poll timeout in ms
    * @param {number}  [options.dataShards]    - Default RS data shards
    * @param {number}  [options.parityShards]  - Default RS parity shards
-   * @param {string}  [options.network]       - 'sepolia' | 'arbitrum' (for store routing)
+   * @param {string}  [options.network]       - Chain name, 'auto' (default), or specific chain
+   * @param {string}  [options.preference]    - 'cheapest' | 'fastest' | 'redundant' | '' (auto weighted)
    */
   constructor(options = {}) {
     this.apiUrl       = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, '');
@@ -73,7 +74,8 @@ class HealChain {
     this.pollTimeout  = options.pollTimeout  ?? DEFAULT_POLL_TIMEOUT;
     this.dataShards   = options.dataShards   ?? DEFAULT_DATA_SHARDS;
     this.parityShards = options.parityShards ?? DEFAULT_PARITY_SHARDS;
-    this.network      = options.network      ?? 'sepolia';
+    this.network      = options.network      ?? 'auto';
+    this.preference   = options.preference   ?? '';
   }
 
   // ── Internal fetch wrapper ──────────────────────────────────────────────────
@@ -126,7 +128,8 @@ class HealChain {
    * @param {string}  [options.label='sdk upload']  - Record label
    * @param {number}  [options.dataShards]          - Override RS data shards
    * @param {number}  [options.parityShards]        - Override RS parity shards
-   * @param {string}  [options.network]             - Override network for this call
+   * @param {string}  [options.network]             - Chain name or 'auto' (default)
+   * @param {string}  [options.preference]          - 'cheapest' | 'fastest' | 'redundant' | ''
    * @param {function} [options.onPending]          - Called with requestId when submitted
    * @param {function} [options.onFulfilled]        - Called when oracle fulfills
    *
@@ -146,11 +149,12 @@ class HealChain {
     const dataShards  = options.dataShards   ?? this.dataShards;
     const parityShards = options.parityShards ?? this.parityShards;
     const network     = options.network      ?? this.network;
+    const preference  = options.preference   ?? this.preference;
 
     // Submit store request
     const submitted = await this._fetch('/storeOnChain', {
       method: 'POST',
-      body: JSON.stringify({ data: hex, label, network, dataShards, parityShards }),
+      body: JSON.stringify({ data: hex, label, network, preference, dataShards, parityShards }),
     });
 
     // Devnet returns synchronously
@@ -272,6 +276,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 ───────────────────────────────────────────────────────────────────