@healchain/sdk 0.4.0 → 0.5.0

package/package.json

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

@@ -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]       - Chain name, 'auto' (default), or specific chain
+   * @param {string}  [options.chain]         - Chain name, 'auto' (default), or specific chain
+   * @param {string}  [options.network]       - Deprecated: use chain instead
    * @param {string}  [options.preference]    - 'cheapest' | 'fastest' | 'redundant' | '' (auto weighted)
    */
   constructor(options = {}) {
@@ -74,7 +75,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      ?? 'auto';
+    this.chain        = options.chain ?? options.network ?? 'auto';
+    this.network      = this.chain; // backward compat
     this.preference   = options.preference   ?? '';
   }
 
@@ -128,7 +130,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]             - Chain name or 'auto' (default)
+   * @param {string}  [options.chain]               - Chain name or 'auto' (default)
+   * @param {string}  [options.network]             - Deprecated: use chain instead
    * @param {string}  [options.preference]          - 'cheapest' | 'fastest' | 'redundant' | ''
    * @param {function} [options.onPending]          - Called with requestId when submitted
    * @param {function} [options.onFulfilled]        - Called when oracle fulfills
@@ -148,7 +151,7 @@ class HealChain {
     const label       = options.label        ?? 'sdk upload';
     const dataShards  = options.dataShards   ?? this.dataShards;
     const parityShards = options.parityShards ?? this.parityShards;
-    const network     = options.network      ?? this.network;
+    const network     = options.chain ?? options.network ?? this.chain;
     const preference  = options.preference   ?? this.preference;
 
     // Submit store request
@@ -277,6 +280,34 @@ class HealChain {
     return this._fetch(`/listRecords?page=${page}&limit=${limit}`);
   }
 
+  // ── chainScores() ──────────────────────────────────────────────────────────
+
+  /**
+   * Get scored and ranked list of all available chains.
+   * No API key required — public endpoint.
+   * Useful for displaying chain selection UI or debugging auto-selection.
+   *
+   * @returns {Promise<ChainScoresResult>}
+   *
+   * @typedef {object} ChainScore
+   * @property {number}  chainId           - Chain ID
+   * @property {string}  label             - Chain name
+   * @property {number}  score             - Weighted score (higher = better)
+   * @property {boolean} viable            - Whether chain meets minimum threshold
+   * @property {number}  avgGasPriceGwei   - Average gas price in Gwei
+   * @property {number}  avgBlockTimeSec   - Average block time in seconds
+   * @property {number}  reliabilityScore  - Reliability score 0-1
+   * @property {number}  fulfillRate       - Oracle fulfillment success rate 0-1
+   * @property {number}  rpcResponseMs     - Average RPC response time in ms
+   *
+   * @typedef {object} ChainScoresResult
+   * @property {string}      status - 'ok'
+   * @property {ChainScore[]} chains - Chains sorted by score descending
+   */
+  async chainScores() {
+    return this._fetch('/chainScores');
+  }
+
   // ── getBillingBalance() ───────────────────────────────────────────────────
   /**
    * Get credit balances for a wallet address. No API key required.