ton-provider-system 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -1032,6 +1032,9 @@ declare class HealthChecker {
     clearResults(): void;
     /**
      * Mark a provider as degraded (e.g., on 429 error)
+     *
+     * Providers marked as degraded have failed health checks (e.g., rate limit errors)
+     * and should not be selected. The system will failover to the next available provider.
      */
     markDegraded(providerId: string, network: Network, error?: string): void;
     /**
@@ -1909,7 +1912,10 @@ declare class TatumProvider extends BaseProvider {
  * Documentation: https://documentation.onfinality.io/support/ton
  *
  * Endpoint format: https://ton-{network}.api.onfinality.io/public or /rpc
- * API key: Optional, in apikey header (preferred) or query params
+ * API key: Required for /rpc endpoint, passed as query parameter ?apikey=YOUR_API_KEY
+ *
+ * IMPORTANT: OnFinality uses query parameters for API key authentication, NOT headers.
+ * The API key must be included in the URL as ?apikey=YOUR_API_KEY
  */
 
 declare class OnFinalityProvider extends BaseProvider {

package/dist/index.d.ts

@@ -1032,6 +1032,9 @@ declare class HealthChecker {
     clearResults(): void;
     /**
      * Mark a provider as degraded (e.g., on 429 error)
+     *
+     * Providers marked as degraded have failed health checks (e.g., rate limit errors)
+     * and should not be selected. The system will failover to the next available provider.
      */
     markDegraded(providerId: string, network: Network, error?: string): void;
     /**
@@ -1909,7 +1912,10 @@ declare class TatumProvider extends BaseProvider {
  * Documentation: https://documentation.onfinality.io/support/ton
  *
  * Endpoint format: https://ton-{network}.api.onfinality.io/public or /rpc
- * API key: Optional, in apikey header (preferred) or query params
+ * API key: Required for /rpc endpoint, passed as query parameter ?apikey=YOUR_API_KEY
+ *
+ * IMPORTANT: OnFinality uses query parameters for API key authentication, NOT headers.
+ * The API key must be included in the URL as ?apikey=YOUR_API_KEY
  */
 
 declare class OnFinalityProvider extends BaseProvider {

package/dist/index.js

@@ -750,17 +750,43 @@ var OnFinalityProvider = class extends BaseProvider {
     if (normalized.includes("onfinality.io")) {
       try {
         const url = new URL(normalized);
-        const baseUrl = normalized.split("?")[0];
+        const hasQueryParams = normalized.includes("?");
+        const queryString = hasQueryParams ? normalized.split("?")[1] : "";
+        const hasApiKeyInQuery = queryString.includes("apikey=");
         if (!url.pathname || url.pathname === "/") {
           if (this.provider.apiKey) {
-            return baseUrl.replace(/\/?$/, "/rpc");
+            const baseUrl2 = normalized.split("?")[0];
+            if (hasApiKeyInQuery) {
+              return normalized.replace(/\/?$/, "/rpc");
+            }
+            if (hasQueryParams) {
+              return `${baseUrl2.replace(/\/?$/, "/rpc")}?${queryString}&apikey=${encodeURIComponent(this.provider.apiKey)}`;
+            }
+            return `${baseUrl2.replace(/\/?$/, "/rpc")}?apikey=${encodeURIComponent(this.provider.apiKey)}`;
           }
+          const baseUrl = normalized.split("?")[0];
           return baseUrl.replace(/\/?$/, "/public");
         }
         if (url.pathname === "/rpc" || url.pathname === "/public") {
-          return baseUrl;
+          if (url.pathname === "/rpc") {
+            if (hasApiKeyInQuery) {
+              return normalized;
+            }
+            if (this.provider.apiKey) {
+              const baseUrl = normalized.split("?")[0];
+              if (hasQueryParams) {
+                return `${baseUrl}?${queryString}&apikey=${encodeURIComponent(this.provider.apiKey)}`;
+              }
+              return `${baseUrl}?apikey=${encodeURIComponent(this.provider.apiKey)}`;
+            }
+            return normalized;
+          }
+          if (url.pathname === "/public") {
+            return normalized.split("?")[0];
+          }
+          return normalized;
         }
-        return baseUrl;
+        return normalized;
       } catch {
         if (normalized.includes("{key}")) {
           return normalized.split("?")[0].replace(/\/?$/, "/public");
@@ -768,7 +794,7 @@ var OnFinalityProvider = class extends BaseProvider {
         if (!normalized.includes("/rpc") && !normalized.includes("/public")) {
           return normalized.split("?")[0] + "/public";
         }
-        return normalized.split("?")[0];
+        return normalized;
       }
     }
     return normalized;
@@ -777,9 +803,6 @@ var OnFinalityProvider = class extends BaseProvider {
     const headers = {
       "Content-Type": "application/json"
     };
-    if (this.provider.apiKey) {
-      headers["apikey"] = this.provider.apiKey;
-    }
     return headers;
   }
   parseResponse(data) {
@@ -1083,7 +1106,8 @@ var HealthChecker = class {
       } catch (error) {
         if (provider.type === "onfinality" && normalizedEndpoint.includes("/rpc") && provider.apiKey && error.message?.includes("backend error")) {
           this.logger.debug(`OnFinality /rpc failed, retrying with /public endpoint`);
-          const publicEndpoint = normalizedEndpoint.replace("/rpc", "/public");
+          const baseUrl = normalizedEndpoint.split("?")[0];
+          const publicEndpoint = baseUrl.replace("/rpc", "/public");
           const publicProvider = { ...provider, apiKey: void 0 };
           const publicProviderImpl = createProvider(publicProvider);
           info = await this.callGetMasterchainInfo(publicEndpoint, publicProvider, publicProviderImpl);
@@ -1232,14 +1256,17 @@ var HealthChecker = class {
   }
   /**
    * Mark a provider as degraded (e.g., on 429 error)
+   * 
+   * Providers marked as degraded have failed health checks (e.g., rate limit errors)
+   * and should not be selected. The system will failover to the next available provider.
    */
   markDegraded(providerId, network, error) {
     const key = this.getResultKey(providerId, network);
     const existing = this.results.get(key);
     const result = existing ? {
       ...existing,
-      success: true,
-      // Degraded providers are still usable, just slower/rate-limited
+      success: false,
+      // Degraded providers with errors should not be selected
       status: "degraded",
       error: error || "Marked as degraded",
       lastTested: /* @__PURE__ */ new Date(),
@@ -1247,8 +1274,8 @@ var HealthChecker = class {
     } : {
       id: providerId,
       network,
-      success: true,
-      // Degraded providers are still usable
+      success: false,
+      // Degraded providers with errors should not be selected
       status: "degraded",
       latencyMs: null,
       seqno: null,