@owney/sdk 0.7.25-beta.6 → 0.7.25-beta.7

package/README.md

@@ -16,11 +16,7 @@ import { OwneySDK } from "@owney/sdk";
 // Create the SDK instance
 const sdk = new OwneySDK({
   apiKey: "your-owney-api-key",
-  rpcUrls: {
-    1: "https://eth-mainnet.g.alchemy.com/v2/<key>",
-    8453: "https://base-mainnet.g.alchemy.com/v2/<key>",
-    42161: "https://arb-mainnet.g.alchemy.com/v2/<key>",
-  },
+  routingApiBaseUrl: "https://your-routing-api.example",
 });
 
 // Connect with an EIP-1193 wallet provider
@@ -42,6 +38,7 @@ Create a new SDK instance.
 | Param                                   | Type                                                        | Description                                                                                       |
 | --------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
 | `config.apiKey`                         | `string`                                                    | Your Owney API key, used to authenticate with the routing API and fetch agent-specific keys       |
+| `config.routingApiBaseUrl`              | `string` (optional)                                         | Routing API URL; required for proxy reads unless the SDK build has `OWNEY_ROUTING_API_BASE_URL` or all `rpcUrls` are set |
 | `config.rpcUrls`                        | `{ 1?: string; 8453?: string; 42161?: string }` (optional)  | Per-chain RPC overrides used by agent reads and transaction-receipt polling                       |
 | `config.zyfaiRpcUrls`                   | Same as `rpcUrls` (deprecated)                              | Legacy Zyfai-only override; use `rpcUrls` for all application-owned reads                         |
 
@@ -50,11 +47,7 @@ import { OwneySDK } from "@owney/sdk";
 
 const sdk = new OwneySDK({
   apiKey: "your-owney-api-key",
-  rpcUrls: {
-    1: "https://eth-mainnet.g.alchemy.com/v2/<key>",
-    8453: "https://base-mainnet.g.alchemy.com/v2/<key>",
-    42161: "https://arb-mainnet.g.alchemy.com/v2/<key>",
-  },
+  routingApiBaseUrl: "https://your-routing-api.example",
 });
 ```
 
@@ -68,16 +61,18 @@ switching, signatures, and transaction submission.
 supported chain using this precedence:
 
 1. The caller-provided `rpcUrls[chainId]`, when present and non-empty.
-2. The Owney SDK default URL for that chain.
+2. The Owney routing API read-only RPC proxy for that chain.
 
-The SDK defaults are Owney-managed Alchemy endpoints embedded in the SDK. They
-keep zero-configuration integrations working, but their capacity is shared by
-every consumer that does not provide an override.
+The Alchemy credential stays on the routing API server. The SDK sends its
+existing organization key to the proxy for per-organization rate limiting.
+The proxy base URL must be provided through `routingApiBaseUrl` or the SDK
+build's `OWNEY_ROUTING_API_BASE_URL`; there is no hardcoded production fallback.
 
 ```typescript
-// Zero configuration: all supported chains use Owney SDK defaults.
+// All supported chains use the Owney routing API proxy.
 const sdk = new OwneySDK({
   apiKey: "your-owney-api-key",
+  routingApiBaseUrl: "https://your-routing-api.example",
 });
 ```
 
@@ -86,9 +81,10 @@ Overrides can be complete or partial:
 ```typescript
 const sdk = new OwneySDK({
   apiKey: "your-owney-api-key",
+  routingApiBaseUrl: "https://your-routing-api.example",
   rpcUrls: {
-    // Ethereum and Arbitrum continue using Owney SDK defaults.
-    8453: "https://base-mainnet.g.alchemy.com/v2/<key>",
+    // Ethereum and Arbitrum continue using the routing API proxy.
+    8453: "https://your-own-rpc.example/rpc",
   },
 });
 ```
@@ -106,12 +102,10 @@ The resolved URLs are shared across Owney-owned reads and agent integrations:
 
 Notes:
 
-- Owney mini-apps should continue passing explicit environment-specific URLs,
-  even though the SDK defaults provide a fallback.
-- Production SDK consumers should provide their own endpoints for quota
-  isolation, origin restrictions, and predictable capacity.
-- Partial maps override only the supplied chains; missing chains retain Owney
-  SDK defaults.
+- Owney mini-apps pass the same routing API proxy URLs to Wagmi and the SDK.
+- SDK consumers may override endpoints if they operate their own RPC provider.
+- Partial maps override only the supplied chains; missing chains use Owney's
+  routing API proxy.
 - HTTP reads use bounded retries and honor provider `Retry-After` responses.
 - `zyfaiRpcUrls` remains available for compatibility but applies only to Zyfai.
 

package/dist/index.cjs

@@ -1133,21 +1133,32 @@ function protocolsPolicyNeedsUpdate(current, desiredProtocols, desiredAutoSelect
 var import_viem = require("viem");
 var PAID_RPC_RETRY_COUNT = 3;
 var PAID_RPC_RETRY_DELAY_MS = 1e3;
-var DEFAULT_RPC_URLS = {
-  1: "https://eth-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
-  8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
-  42161: "https://arb-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V"
-};
-function resolveRpcUrl(rpcUrls, chainId) {
+function configuredRpcProxyBaseUrl(baseUrl) {
+  const configured = (baseUrl ?? "")?.trim();
+  if (!configured) {
+    throw new Error(
+      "OWNEY_ROUTING_API_BASE_URL is required for RPC proxy requests unless routingApiBaseUrl or all rpcUrls are configured."
+    );
+  }
+  return configured;
+}
+function rpcProxyUrl(chainId, apiKey, baseUrl) {
+  const url = new URL(
+    `${configuredRpcProxyBaseUrl(baseUrl).replace(/\/$/, "")}/api/v1/rpc/${chainId}`
+  );
+  if (apiKey) url.searchParams.set("apiKey", apiKey);
+  return url.toString();
+}
+function resolveRpcUrl(rpcUrls, chainId, apiKey = "", baseUrl) {
   const url = rpcUrls?.[chainId]?.trim();
   if (url) return url;
-  return DEFAULT_RPC_URLS[chainId];
+  return rpcProxyUrl(chainId, apiKey, baseUrl);
 }
-function resolveRpcUrls(rpcUrls) {
+function resolveRpcUrls(rpcUrls, apiKey = "", baseUrl) {
   return {
-    1: resolveRpcUrl(rpcUrls, 1),
-    8453: resolveRpcUrl(rpcUrls, 8453),
-    42161: resolveRpcUrl(rpcUrls, 42161)
+    1: resolveRpcUrl(rpcUrls, 1, apiKey, baseUrl),
+    8453: resolveRpcUrl(rpcUrls, 8453, apiKey, baseUrl),
+    42161: resolveRpcUrl(rpcUrls, 42161, apiKey, baseUrl)
   };
 }
 function createPaidRpcClient(chain, rpcUrls) {
@@ -1173,7 +1184,13 @@ function headerValue(error, name) {
     seen.add(candidate);
     const record = candidate;
     const headers = record.headers;
-    const found = typeof headers?.get === "function" ? headers.get(name) : headers?.[name] ?? headers?.[name.toLowerCase()];
+    let found;
+    if (typeof headers?.get === "function") {
+      found = headers.get(name);
+    } else {
+      const headerRecord = headers;
+      found = headerRecord?.[name] ?? headerRecord?.[name.toLowerCase()];
+    }
     if (typeof found === "string" && found) {
       value = found;
       return;
@@ -5137,8 +5154,12 @@ var OwneySDK = class {
   constructor(config) {
     this.apiKey = config.apiKey;
     if (config.debug) setOwneyDebug(true);
-    this.rpcUrls = config.rpcUrls;
-    this.zyfaiRpcUrls = config.zyfaiRpcUrls;
+    this.rpcUrls = resolveRpcUrls(
+      config.rpcUrls,
+      config.apiKey,
+      config.routingApiBaseUrl
+    );
+    this.zyfaiRpcUrls = config.rpcUrls ? void 0 : config.zyfaiRpcUrls;
     this.yieldseekerApiBaseUrl = config.yieldseekerApiBaseUrl;
     this.yieldseekerSiweOrigin = config.yieldseekerSiweOrigin;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
@@ -5413,7 +5434,11 @@ var OwneySDK = class {
       if (!key2) return null;
       return new ZyfaiAgent(
         key2,
-        this.rpcUrls ?? this.zyfaiRpcUrls,
+        this.zyfaiRpcUrls ? resolveRpcUrls(
+          this.zyfaiRpcUrls,
+          this.apiKey,
+          this.routingApiBaseUrl
+        ) : this.rpcUrls,
         this.referralSource
       );
     }

package/dist/index.d.cts

@@ -8,7 +8,8 @@ interface OwneySDKConfig {
     apiKey: string;
     /**
      * Optional per-chain RPC overrides used for application-owned reads and
-     * transaction receipt polling. Missing chains use Owney SDK defaults.
+     * transaction receipt polling. Missing chains use the Owney routing API's
+     * read-only RPC proxy. No upstream RPC credentials are included in the SDK.
      * Wallet providers remain responsible for account access, chain switching,
      * signatures, and transaction submission.
      */
@@ -25,9 +26,9 @@ interface OwneySDKConfig {
     yieldseekerSiweOrigin?: string;
     /**
      * Optional override for the Owney routing API base URL used by all routing
-     * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
-     * production URL). Set this to point at a local/staging routing API,
-     * e.g. "http://localhost:3000", when testing sponsor changes.
+     * calls. RPC proxy requests use OWNEY_ROUTING_API_BASE_URL when this is
+     * omitted; without either value, all rpcUrls must be configured.
+     * Set this to a local/staging routing API when testing sponsor changes.
      */
     routingApiBaseUrl?: string;
     /**

package/dist/index.d.ts

@@ -8,7 +8,8 @@ interface OwneySDKConfig {
     apiKey: string;
     /**
      * Optional per-chain RPC overrides used for application-owned reads and
-     * transaction receipt polling. Missing chains use Owney SDK defaults.
+     * transaction receipt polling. Missing chains use the Owney routing API's
+     * read-only RPC proxy. No upstream RPC credentials are included in the SDK.
      * Wallet providers remain responsible for account access, chain switching,
      * signatures, and transaction submission.
      */
@@ -25,9 +26,9 @@ interface OwneySDKConfig {
     yieldseekerSiweOrigin?: string;
     /**
      * Optional override for the Owney routing API base URL used by all routing
-     * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
-     * production URL). Set this to point at a local/staging routing API,
-     * e.g. "http://localhost:3000", when testing sponsor changes.
+     * calls. RPC proxy requests use OWNEY_ROUTING_API_BASE_URL when this is
+     * omitted; without either value, all rpcUrls must be configured.
+     * Set this to a local/staging routing API when testing sponsor changes.
      */
     routingApiBaseUrl?: string;
     /**

package/dist/index.js

@@ -1102,21 +1102,32 @@ import {
 } from "viem";
 var PAID_RPC_RETRY_COUNT = 3;
 var PAID_RPC_RETRY_DELAY_MS = 1e3;
-var DEFAULT_RPC_URLS = {
-  1: "https://eth-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
-  8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
-  42161: "https://arb-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V"
-};
-function resolveRpcUrl(rpcUrls, chainId) {
+function configuredRpcProxyBaseUrl(baseUrl) {
+  const configured = (baseUrl ?? "")?.trim();
+  if (!configured) {
+    throw new Error(
+      "OWNEY_ROUTING_API_BASE_URL is required for RPC proxy requests unless routingApiBaseUrl or all rpcUrls are configured."
+    );
+  }
+  return configured;
+}
+function rpcProxyUrl(chainId, apiKey, baseUrl) {
+  const url = new URL(
+    `${configuredRpcProxyBaseUrl(baseUrl).replace(/\/$/, "")}/api/v1/rpc/${chainId}`
+  );
+  if (apiKey) url.searchParams.set("apiKey", apiKey);
+  return url.toString();
+}
+function resolveRpcUrl(rpcUrls, chainId, apiKey = "", baseUrl) {
   const url = rpcUrls?.[chainId]?.trim();
   if (url) return url;
-  return DEFAULT_RPC_URLS[chainId];
+  return rpcProxyUrl(chainId, apiKey, baseUrl);
 }
-function resolveRpcUrls(rpcUrls) {
+function resolveRpcUrls(rpcUrls, apiKey = "", baseUrl) {
   return {
-    1: resolveRpcUrl(rpcUrls, 1),
-    8453: resolveRpcUrl(rpcUrls, 8453),
-    42161: resolveRpcUrl(rpcUrls, 42161)
+    1: resolveRpcUrl(rpcUrls, 1, apiKey, baseUrl),
+    8453: resolveRpcUrl(rpcUrls, 8453, apiKey, baseUrl),
+    42161: resolveRpcUrl(rpcUrls, 42161, apiKey, baseUrl)
   };
 }
 function createPaidRpcClient(chain, rpcUrls) {
@@ -1142,7 +1153,13 @@ function headerValue(error, name) {
     seen.add(candidate);
     const record = candidate;
     const headers = record.headers;
-    const found = typeof headers?.get === "function" ? headers.get(name) : headers?.[name] ?? headers?.[name.toLowerCase()];
+    let found;
+    if (typeof headers?.get === "function") {
+      found = headers.get(name);
+    } else {
+      const headerRecord = headers;
+      found = headerRecord?.[name] ?? headerRecord?.[name.toLowerCase()];
+    }
     if (typeof found === "string" && found) {
       value = found;
       return;
@@ -5127,8 +5144,12 @@ var OwneySDK = class {
   constructor(config) {
     this.apiKey = config.apiKey;
     if (config.debug) setOwneyDebug(true);
-    this.rpcUrls = config.rpcUrls;
-    this.zyfaiRpcUrls = config.zyfaiRpcUrls;
+    this.rpcUrls = resolveRpcUrls(
+      config.rpcUrls,
+      config.apiKey,
+      config.routingApiBaseUrl
+    );
+    this.zyfaiRpcUrls = config.rpcUrls ? void 0 : config.zyfaiRpcUrls;
     this.yieldseekerApiBaseUrl = config.yieldseekerApiBaseUrl;
     this.yieldseekerSiweOrigin = config.yieldseekerSiweOrigin;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
@@ -5403,7 +5424,11 @@ var OwneySDK = class {
       if (!key2) return null;
       return new ZyfaiAgent(
         key2,
-        this.rpcUrls ?? this.zyfaiRpcUrls,
+        this.zyfaiRpcUrls ? resolveRpcUrls(
+          this.zyfaiRpcUrls,
+          this.apiKey,
+          this.routingApiBaseUrl
+        ) : this.rpcUrls,
         this.referralSource
       );
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.7.25-beta.6",
+  "version": "0.7.25-beta.7",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",