@blazephoenix/sdk 1.0.1 → 1.1.0

package/dist/index.d.cts

@@ -385,6 +385,12 @@ interface RegistryOptions {
      *  delay a call, and by at most this much; later refreshes run in the
      *  background (stale-while-revalidate). */
     timeoutMs?: number;
+    /** Route to addresses that only the fetched document supplies (a version
+     *  released after this SDK). Default false: the document can list them, but
+     *  resolve() only returns Router/Quoter addresses pinned in this package —
+     *  the on-chain check of a remote entry reads the entry's own contracts, so
+     *  it cannot tell a real deployment from a look-alike. */
+    remoteVersions?: boolean;
     /** Called for every pin conflict or rejected document — never silently. */
     onWarning?: (msg: string) => void;
 }
@@ -394,6 +400,7 @@ declare class Registry {
     private fetchedAt;
     private lastError?;
     private readonly mode;
+    private readonly remoteVersions;
     private readonly url;
     private readonly ttlMs;
     private readonly fetchFn?;
@@ -422,6 +429,8 @@ declare class Registry {
     /** Every deployed version on a chain, newest first. */
     versionsOn(chainId: SupportedChainId): string[];
     resolve(chainId: SupportedChainId, selector?: VersionSelector): ResolvedDeployment;
+    /** Router and Quoter both pinned in this package (not filled by a fetched document). */
+    private isPinned;
     private latestKnownVersion;
     /** chains × versions table (for dashboards, the MCP, debugging). */
     table(): {

package/dist/index.d.ts

@@ -385,6 +385,12 @@ interface RegistryOptions {
      *  delay a call, and by at most this much; later refreshes run in the
      *  background (stale-while-revalidate). */
     timeoutMs?: number;
+    /** Route to addresses that only the fetched document supplies (a version
+     *  released after this SDK). Default false: the document can list them, but
+     *  resolve() only returns Router/Quoter addresses pinned in this package —
+     *  the on-chain check of a remote entry reads the entry's own contracts, so
+     *  it cannot tell a real deployment from a look-alike. */
+    remoteVersions?: boolean;
     /** Called for every pin conflict or rejected document — never silently. */
     onWarning?: (msg: string) => void;
 }
@@ -394,6 +400,7 @@ declare class Registry {
     private fetchedAt;
     private lastError?;
     private readonly mode;
+    private readonly remoteVersions;
     private readonly url;
     private readonly ttlMs;
     private readonly fetchFn?;
@@ -422,6 +429,8 @@ declare class Registry {
     /** Every deployed version on a chain, newest first. */
     versionsOn(chainId: SupportedChainId): string[];
     resolve(chainId: SupportedChainId, selector?: VersionSelector): ResolvedDeployment;
+    /** Router and Quoter both pinned in this package (not filled by a fetched document). */
+    private isPinned;
     private latestKnownVersion;
     /** chains × versions table (for dashboards, the MCP, debugging). */
     table(): {

package/dist/index.js

@@ -5354,6 +5354,7 @@ var Registry = class {
   fetchedAt = 0;
   lastError;
   mode;
+  remoteVersions;
   url;
   ttlMs;
   fetchFn;
@@ -5362,6 +5363,7 @@ var Registry = class {
   overrides = /* @__PURE__ */ new Map();
   constructor(opts = {}, overrides) {
     this.mode = opts.mode ?? "auto";
+    this.remoteVersions = opts.remoteVersions ?? false;
     this.url = opts.url ?? DEPLOYMENTS_URL;
     this.ttlMs = opts.ttlMs ?? 10 * 6e4;
     this.fetchFn = opts.fetchFn ?? globalThis.fetch;
@@ -5493,7 +5495,7 @@ var Registry = class {
     if (!isValidSelector(selector)) throw new BlazeError("bad_request", `bad version selector "${selector}"`);
     const ov = this.overrides.get(chainId);
     const sel = ov?.version && selector === "latest" ? ov.version : selector;
-    const candidates = this.doc.versions.filter((v) => matchesSelector(v.version, sel) && isDeployed(v.chains[chainId])).sort((a, b) => compareVersions(b.version, a.version));
+    const candidates = this.doc.versions.filter((v) => matchesSelector(v.version, sel) && isDeployed(v.chains[chainId])).filter((v) => this.remoteVersions || this.isPinned(v.version, chainId)).sort((a, b) => compareVersions(b.version, a.version));
     const pick = candidates[0];
     if (ov && (ov.router || ov.quoter)) {
       const base = pick ? { ...pick.chains[chainId] } : {
@@ -5513,9 +5515,10 @@ var Registry = class {
     }
     if (!pick) {
       const deployed = this.versionsOn(chainId);
+      const remoteOnly = this.remoteVersions ? [] : deployed.filter((v) => matchesSelector(v, sel) && !this.isPinned(v, chainId));
       throw new BlazeError(
         "not_deployed",
-        `no BlazePhoenix deployment matching version "${selector}" on chain ${chainId}` + (deployed.length ? ` (deployed: ${deployed.join(", ")})` : ""),
+        `no BlazePhoenix deployment matching version "${selector}" on chain ${chainId}` + (deployed.length ? ` (deployed: ${deployed.join(", ")})` : "") + (remoteOnly.length ? ` \u2014 ${remoteOnly.join(", ")} is known only from the fetched registry; update the SDK, or set registry.remoteVersions after checking the addresses yourself` : ""),
         { details: { chainId, selector, deployed } }
       );
     }
@@ -5524,6 +5527,11 @@ var Registry = class {
     const source = src("router") === "remote" || src("quoter") === "remote" ? "remote" : "embedded";
     return { chainId, version: pick.version, status: pick.status, contracts: { ...set }, source };
   }
+  /** Router and Quoter both pinned in this package (not filled by a fetched document). */
+  isPinned(version, chainId) {
+    const src = (k) => this.fieldSource[`${version}|${chainId}|${k}`];
+    return src("router") === "embedded" && src("quoter") === "embedded";
+  }
   latestKnownVersion(selector) {
     const all = this.doc.versions.map((v) => v.version).sort((a, b) => compareVersions(b, a));
     const m = selector ? all.find((v) => matchesSelector(v, selector)) : void 0;
@@ -5771,16 +5779,19 @@ var BlazePhoenix = class {
         return { address: c.weth, native: true };
       case "WETH":
         return { address: c.weth, native: false };
+      // `usdc` holds each chain's one dollar asset: USDG on Robinhood Chain, USDC
+      // elsewhere. The other symbol names a different token there, so it is refused.
       case "USDC":
       case "USDG":
-        return { address: c.usdc, native: false };
+        if (s.toUpperCase() === (chainId === 4663 ? "USDG" : "USDC")) return { address: c.usdc, native: false };
+        break;
       case "BZPX":
         if (c.bzpx) return { address: c.bzpx, native: false };
         break;
     }
     throw new BlazeError(
       "bad_request",
-      `${side}: "${ref}" is not a 0x address or a built-in symbol (ETH, WETH, USDC, BZPX) on ${c.name} \u2014 pass the token address`
+      `${side}: "${ref}" is not a 0x address or a built-in symbol (ETH, WETH, ${chainId === 4663 ? "USDG" : "USDC"}, BZPX) on ${c.name} \u2014 pass the token address`
     );
   }
   async decimalsOf(client, chainId, t) {
@@ -6170,6 +6181,12 @@ var BlazePhoenix = class {
         if (r.status !== "success") throw new BlazeError("reverted", `approval transaction reverted (${approvalHash})`);
       }
       plan = { ...plan, approval: { ...plan.approval, current: plan.approval.amount } };
+      if (Date.now() - plan.quote.quotedAt > maxAge) {
+        if (!req) {
+          throw new BlazeError("bad_request", `plan went older than ${maxAge}ms while the approval confirmed${approvalHash ? ` (${approvalHash})` : ""} \u2014 the swap was NOT sent; rebuild the plan, or pass \`request\` so it can be rebuilt`);
+        }
+        plan = await this.buildSwap({ ...req, from: req.from ?? account.address });
+      }
     }
     if (opts.simulate ?? true) {
       const sim = await this.simulate(plan, account.address);