@rhinestone/shared-configs 1.9.0 → 1.10.1

package/dist/configs/chains.json

@@ -1,5 +1,11 @@
 {
     "1": {
+        "caip2": "eip155:1",
+        "explorer": {
+            "url": "https://etherscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Ethereum",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -84,6 +90,12 @@
         }
     },
     "10": {
+        "caip2": "eip155:10",
+        "explorer": {
+            "url": "https://optimistic.etherscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "OP Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -179,6 +191,12 @@
         }
     },
     "56": {
+        "caip2": "eip155:56",
+        "explorer": {
+            "url": "https://bscscan.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "BNB Smart Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -247,6 +265,12 @@
         }
     },
     "100": {
+        "caip2": "eip155:100",
+        "explorer": {
+            "url": "https://gnosisscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Gnosis",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -282,6 +306,12 @@
         }
     },
     "130": {
+        "caip2": "eip155:130",
+        "explorer": {
+            "url": "https://uniscan.xyz",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Unichain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -365,6 +395,12 @@
         }
     },
     "137": {
+        "caip2": "eip155:137",
+        "explorer": {
+            "url": "https://polygonscan.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Polygon",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -436,6 +472,12 @@
         }
     },
     "143": {
+        "caip2": "eip155:143",
+        "explorer": {
+            "url": "https://monadscan.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Monad",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -505,6 +547,12 @@
         }
     },
     "146": {
+        "caip2": "eip155:146",
+        "explorer": {
+            "url": "https://sonicscan.org",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Sonic",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -546,6 +594,12 @@
         }
     },
     "999": {
+        "caip2": "eip155:999",
+        "explorer": {
+            "url": "https://hyperevmscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "HyperEVM",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -599,6 +653,11 @@
     },
     "1337": {
         "caip2": "hypercore:mainnet",
+        "explorer": {
+            "addressPath": "/explorer/address/",
+            "txPath": "/explorer/tx/",
+            "url": "https://app.hyperliquid.xyz"
+        },
         "name": "HyperCore",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -628,6 +687,12 @@
         }
     },
     "1868": {
+        "caip2": "eip155:1868",
+        "explorer": {
+            "url": "https://soneium.blockscout.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Soneium Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -696,6 +761,12 @@
         }
     },
     "4663": {
+        "caip2": "eip155:4663",
+        "explorer": {
+            "url": "https://robinhoodchain.blockscout.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Robinhood Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -753,6 +824,12 @@
         }
     },
     "8453": {
+        "caip2": "eip155:8453",
+        "explorer": {
+            "url": "https://basescan.org",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Base",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -822,6 +899,12 @@
         }
     },
     "9745": {
+        "caip2": "eip155:9745",
+        "explorer": {
+            "url": "https://plasmascan.to",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Plasma",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -865,6 +948,12 @@
         }
     },
     "9746": {
+        "caip2": "eip155:9746",
+        "explorer": {
+            "url": "https://testnet.plasmascan.to",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Plasma Testnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -910,6 +999,12 @@
         }
     },
     "42161": {
+        "caip2": "eip155:42161",
+        "explorer": {
+            "url": "https://arbiscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Arbitrum One",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -994,6 +1089,12 @@
         }
     },
     "43114": {
+        "caip2": "eip155:43114",
+        "explorer": {
+            "url": "https://snowtrace.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Avalanche",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1071,6 +1172,12 @@
         }
     },
     "84532": {
+        "caip2": "eip155:84532",
+        "explorer": {
+            "url": "https://sepolia.basescan.org",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Base Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1146,6 +1253,12 @@
         }
     },
     "421614": {
+        "caip2": "eip155:421614",
+        "explorer": {
+            "url": "https://sepolia.arbiscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Arbitrum Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1207,6 +1320,12 @@
         }
     },
     "747474": {
+        "caip2": "eip155:747474",
+        "explorer": {
+            "url": "https://katanascan.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Katana",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1265,6 +1384,12 @@
         }
     },
     "11155111": {
+        "caip2": "eip155:11155111",
+        "explorer": {
+            "url": "https://sepolia.etherscan.io",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1326,6 +1451,12 @@
         }
     },
     "11155420": {
+        "caip2": "eip155:11155420",
+        "explorer": {
+            "url": "https://optimism-sepolia.blockscout.com",
+            "addressPath": "/address/",
+            "txPath": "/tx/"
+        },
         "name": "OP Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1388,6 +1519,11 @@
     },
     "728126428": {
         "caip2": "tron:mainnet",
+        "explorer": {
+            "addressPath": "/#/address/",
+            "txPath": "/#/transaction/",
+            "url": "https://tronscan.org"
+        },
         "name": "Tron",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1429,6 +1565,11 @@
     },
     "792703809": {
         "caip2": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+        "explorer": {
+            "addressPath": "/address/",
+            "txPath": "/tx/",
+            "url": "https://solscan.io"
+        },
         "name": "Solana",
         "nativeToken": {
             "address": "11111111111111111111111111111111",

package/dist/scripts/__tests__/validation.test.js

@@ -11,6 +11,12 @@ function validChain(overrides = {}) {
         vmType: "evm",
         network: "mainnet",
         stack: "vanilla",
+        caip2: "eip155:1",
+        explorer: {
+            url: "https://etherscan.io",
+            addressPath: "/address/",
+            txPath: "/tx/",
+        },
         nativeToken,
         wrappedNativeToken: { ...nativeToken, symbol: "WETH" },
         tokens: [{ ...nativeToken, balanceSlot: null, approvalSlot: null }],
@@ -53,9 +59,26 @@ function errorsFor(chain) {
         ["a non-boolean virtual flag", { virtual: "true" }],
         ["a missing network", { network: undefined }],
         ["an unknown network", { network: "devnet" }],
+        // `explorer` is required (nullable) in the public ChainEntry, so the build
+        // gate has to reject what the type says cannot happen.
+        ["a missing explorer", { explorer: undefined }],
+        ["an explorer that is not an object", { explorer: "https://etherscan.io" }],
+        ["an explorer missing txPath", {
+                explorer: { url: "https://etherscan.io", addressPath: "/address/" },
+            }],
+        // Links are built by concatenation, so the slash convention is load-bearing.
+        ["an explorer path with no leading slash", {
+                explorer: { url: "https://etherscan.io", addressPath: "address/", txPath: "/tx/" },
+            }],
+        ["an explorer url with a trailing slash", {
+                explorer: { url: "https://etherscan.io/", addressPath: "/address/", txPath: "/tx/" },
+            }],
     ])("rejects %s", (_label, overrides) => {
         (0, bun_test_1.expect)(errorsFor(validChain(overrides)).length).toBeGreaterThan(0);
     });
+    (0, bun_test_1.it)("accepts a null explorer, the answer for a chain that has none", () => {
+        (0, bun_test_1.expect)(errorsFor(validChain({ explorer: null }))).toEqual([]);
+    });
     (0, bun_test_1.it)("names the offending value so the build failure is actionable", () => {
         const [error] = errorsFor(validChain({ settlementLayers: ["TELEPORT"] }));
         (0, bun_test_1.expect)(error.message).toContain("TELEPORT");
@@ -214,6 +237,153 @@ function errorsFor(chain) {
         (0, bun_test_1.expect)(Object.keys(chains)).toHaveLength(Object.keys(index_1.chainRegistry).length);
     });
 });
+(0, bun_test_1.describe)("classifyChainCaip2", () => {
+    (0, bun_test_1.it)("derives eip155:<chainId> for a chain that declares none", () => {
+        const { chains, issues } = (0, validation_1.classifyChainCaip2)({
+            "8453": validChain({ name: "Base", caip2: undefined }),
+        });
+        (0, bun_test_1.expect)(chains["8453"].caip2).toBe("eip155:8453");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    (0, bun_test_1.it)("keeps a declared id for a chain whose key is not an eip155 one", () => {
+        const { chains, issues } = (0, validation_1.classifyChainCaip2)({
+            "792703809": validChain({ name: "Solana", vmType: "svm", caip2: "solana:abc" }),
+        });
+        (0, bun_test_1.expect)(chains["792703809"].caip2).toBe("solana:abc");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // The whole reason the field is authored rather than derived: HyperCore's
+    // registry key is 1337, but `eip155:1337` is the Hardhat local chain id.
+    (0, bun_test_1.it)("keeps a virtual EVM chain's declared id instead of deriving from its key", () => {
+        const { chains, issues } = (0, validation_1.classifyChainCaip2)({
+            "1337": validChain({
+                name: "HyperCore",
+                virtual: true,
+                caip2: "hypercore:mainnet",
+            }),
+        });
+        (0, bun_test_1.expect)(chains["1337"].caip2).toBe("hypercore:mainnet");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // Deriving here would hand the entry an `eip155:` id that is confidently
+    // wrong — HyperCore's `eip155:1337` failure, reintroduced by the mechanism
+    // meant to prevent it.
+    bun_test_1.it.each([
+        ["a non-EVM chain", { vmType: "svm" }],
+        ["a virtual chain", { virtual: true }],
+    ])("errors when %s declares no caip2, rather than deriving one", (_label, overrides) => {
+        const { issues } = (0, validation_1.classifyChainCaip2)({
+            "424242": validChain({ ...overrides, caip2: undefined }),
+        });
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("error");
+        (0, bun_test_1.expect)(issues[0].message).toContain("must author its caip2");
+    });
+    (0, bun_test_1.it)("errors when a real EVM chain declares an id that isn't its own", () => {
+        const { issues } = (0, validation_1.classifyChainCaip2)({
+            "8453": validChain({ name: "Base", caip2: "eip155:84532" }),
+        });
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("error");
+        (0, bun_test_1.expect)(issues[0].message).toContain("eip155:8453");
+    });
+    (0, bun_test_1.it)("errors on a malformed declaration rather than falling back to the derived id", () => {
+        const { chains, issues } = (0, validation_1.classifyChainCaip2)({
+            "1337": validChain({ name: "HyperCore", virtual: true, caip2: "hypercore" }),
+        });
+        // Left as authored, so the structural check rejects it too — silently
+        // publishing eip155:1337 here is the exact failure being guarded against.
+        (0, bun_test_1.expect)(chains["1337"].caip2).toBe("hypercore");
+        (0, bun_test_1.expect)(issues.some((i) => i.message.includes("malformed"))).toBe(true);
+    });
+    // chainIdFromCaip2 is a reverse lookup over this field, so a collision makes
+    // it silently return whichever entry was iterated first.
+    (0, bun_test_1.it)("errors when two chains resolve to the same id", () => {
+        const { issues } = (0, validation_1.classifyChainCaip2)({
+            "1": validChain(),
+            "1337": validChain({ name: "Impostor", virtual: true, caip2: "eip155:1" }),
+        });
+        (0, bun_test_1.expect)(issues.some((i) => i.message.includes("already uses"))).toBe(true);
+    });
+    (0, bun_test_1.it)("leaves the real generated registry issue-free", () => {
+        const { issues } = (0, validation_1.classifyChainCaip2)(index_1.chainRegistry);
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+});
+(0, bun_test_1.describe)("classifyChainExplorers", () => {
+    const nets = (mainnets, testnets = []) => ({ mainnets, testnets });
+    // The classifier's input is pre-stamp, i.e. whatever the jsonnet authored —
+    // which for most chains is nothing. `validChain` carries an explorer so the
+    // structural checks pass, so strip it to exercise the derivation path.
+    const unauthored = (overrides = {}) => validChain({ ...overrides, explorer: undefined });
+    (0, bun_test_1.it)("derives the explorer from viem's own chain definition", () => {
+        const { chains, issues } = (0, validation_1.classifyChainExplorers)({ "8453": unauthored({ name: "Base" }) }, nets([{ id: 8453, viemChain: "base" }]));
+        (0, bun_test_1.expect)(chains["8453"].explorer).toEqual({
+            url: "https://basescan.org",
+            addressPath: "/address/",
+            txPath: "/tx/",
+        });
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // The regression this exists for: viem's chain 1337 is `localhost`, and
+    // HyperCore's registry key is 1337. Resolving by id would hand HyperCore
+    // Localhost's metadata — the `eip155:1337` mistake from the other direction.
+    (0, bun_test_1.it)("resolves by declared viemChain name, never by chain id", () => {
+        const { chains } = (0, validation_1.classifyChainExplorers)({ "1337": unauthored({ name: "HyperCore", virtual: true }) }, 
+        // No viemChain declared, exactly as the registry has it.
+        nets([{ id: 1337 }]));
+        (0, bun_test_1.expect)(chains["1337"].explorer).toBeNull();
+    });
+    (0, bun_test_1.it)("lets an authored explorer win, for paths viem cannot express", () => {
+        const tronscan = {
+            url: "https://tronscan.org",
+            addressPath: "/#/address/",
+            txPath: "/#/transaction/",
+        };
+        const { chains, issues } = (0, validation_1.classifyChainExplorers)({
+            "728126428": validChain({
+                name: "Tron",
+                vmType: "tvm",
+                explorer: tronscan,
+            }),
+        }, nets([{ id: 728126428 }]));
+        (0, bun_test_1.expect)(chains["728126428"].explorer).toEqual(tronscan);
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    (0, bun_test_1.it)("errors on a malformed authored explorer", () => {
+        const { issues } = (0, validation_1.classifyChainExplorers)({ "1": validChain({ explorer: { url: "https://etherscan.io" } }) }, nets([{ id: 1, viemChain: "mainnet" }]));
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("error");
+    });
+    // A missing explorer costs a hyperlink, not a wrong answer, so it warns
+    // rather than failing the build.
+    (0, bun_test_1.it)("warns rather than errors when nothing can supply one", () => {
+        const { chains, issues } = (0, validation_1.classifyChainExplorers)({ "424242": unauthored({ name: "Newchain" }) }, nets([{ id: 424242 }]));
+        (0, bun_test_1.expect)(chains["424242"].explorer).toBeNull();
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("warning");
+    });
+    // Asserted against the shipped registry rather than by re-running the
+    // classifier, so this covers what actually reaches the artifact.
+    (0, bun_test_1.it)("leaves every shipped chain with a well-formed explorer", () => {
+        // HyperCore was the last null. Its explorer is authored (viem ships no
+        // HyperCore chain) and must stay Hyperliquid's own — a HyperCore txHash is
+        // a Core L1 hash that a HyperEVM scanner cannot resolve.
+        const withoutExplorer = Object.entries(index_1.chainRegistry)
+            .filter(([, e]) => e.explorer == null)
+            .map(([id]) => id);
+        (0, bun_test_1.expect)(withoutExplorer).toEqual([]);
+        (0, bun_test_1.expect)(index_1.chainRegistry["1337"].explorer.url).toBe("https://app.hyperliquid.xyz");
+        for (const [id, entry] of Object.entries(index_1.chainRegistry)) {
+            const explorer = entry.explorer;
+            if (explorer === null)
+                continue;
+            (0, bun_test_1.expect)(explorer.url, id).toMatch(/^https:\/\/[^/]+$/);
+            (0, bun_test_1.expect)(explorer.addressPath, id).toMatch(/^\/.*\/$/);
+            (0, bun_test_1.expect)(explorer.txPath, id).toMatch(/^\/.*\/$/);
+        }
+    });
+});
 (0, bun_test_1.describe)("classifyChainStacks", () => {
     const nets = (mainnets, testnets = []) => ({ mainnets, testnets });
     // The common case: nothing is authored anywhere. viem already knows what Base

package/dist/scripts/generate.js

@@ -111,6 +111,15 @@ function renderChains(chainRegistry, mainnets, testnets) {
         "  decimals: number;",
         "}",
         "",
+        "interface Explorer {",
+        "  /** Origin, no trailing slash. */",
+        "  url: string;",
+        "  /** Path to an address page, with both slashes (`/address/`). */",
+        "  addressPath: string;",
+        "  /** Path to a transaction page, with both slashes (`/tx/`). */",
+        "  txPath: string;",
+        "}",
+        "",
         "interface Chain {",
         "  name: string;",
         "  vmType: VmType;",
@@ -118,8 +127,11 @@ function renderChains(chainRegistry, mainnets, testnets) {
         "  network: ChainNetwork;",
         "  /** Execution stack, for consumers that must synthesise a viem `Chain`. */",
         "  stack: ChainStack;",
-        "  /** CAIP-2 chain identifier; populated for non-eip155 chains only. */",
-        "  caip2?: string;",
+        "  /** CAIP-2 chain identifier. Present on every chain: authored for the",
+        "   *  non-eip155 ones, derived as `eip155:<chainId>` for the rest. */",
+        "  caip2: string;",
+        "  /** Block explorer, or null for a chain that has none (render plain text). */",
+        "  explorer: Explorer | null;",
         "  /** True for virtual chains (e.g. HyperCore) that settle on another chain. */",
         "  virtual?: boolean;",
         "  nativeToken: NativeToken;",
@@ -134,7 +146,7 @@ function renderChains(chainRegistry, mainnets, testnets) {
         `const chains: Record<SupportedChain, Chain> = ${JSON.stringify(chains, null, 2)};`,
         "",
         "export { chains };",
-        "export type { Chain, Token, NativeToken };",
+        "export type { Chain, Token, NativeToken, Explorer };",
     ].join("\n");
 }
 function runJsonnet(yeetRoot) {
@@ -367,8 +379,19 @@ async function generate() {
     const { chains: networkClassified, issues: networkIssues } = (0, validation_1.classifyChainNetworks)(output.chains, output.mainnets, output.testnets);
     // Then the execution stack, for consumers that have to build a viem `Chain`
     // themselves because the chain postdates their pinned viem.
-    const { chains: classifiedChains, issues: stackIssues } = (0, validation_1.classifyChainStacks)(networkClassified, output.networks);
-    const classificationIssues = [...networkIssues, ...stackIssues];
+    const { chains: stackClassified, issues: stackIssues } = (0, validation_1.classifyChainStacks)(networkClassified, output.networks);
+    // Then the canonical CAIP-2 id, so consumers key a chain by the id the wire
+    // uses instead of each deriving `eip155:<id>` for themselves.
+    const { chains: caip2Classified, issues: caip2Issues } = (0, validation_1.classifyChainCaip2)(stackClassified);
+    // Then the block explorer, so a consumer rendering a link for a chain added
+    // after its release does not need a hand-maintained table of its own.
+    const { chains: classifiedChains, issues: explorerIssues } = (0, validation_1.classifyChainExplorers)(caip2Classified, output.networks);
+    const classificationIssues = [
+        ...networkIssues,
+        ...stackIssues,
+        ...caip2Issues,
+        ...explorerIssues,
+    ];
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "chains.json"), `${JSON.stringify(classifiedChains, null, 2)}\n`);
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "mainnets.json"), `${JSON.stringify(output.mainnets, null, 2)}\n`);
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "testnets.json"), `${JSON.stringify(output.testnets, null, 2)}\n`);

package/dist/scripts/validation.d.ts

@@ -65,6 +65,63 @@ export declare function classifyChainNetworks(chains: ChainRegistry, mainnets: R
     chains: ChainRegistry;
     issues: ValidationIssue[];
 };
+/**
+ * Stamps every chain with its canonical CAIP-2 id, deriving `eip155:<chainId>`
+ * for the chains that do not declare one.
+ *
+ * Why this exists: `caip2` was authored only for the chains whose id is not an
+ * EIP-155 one (Solana, Tron, HyperCore), so every consumer that wanted a CAIP-2
+ * id had to carry the same `entry.caip2 ?? \`eip155:${id}\`` fallback — the
+ * orchestrator, deposit-service, the SDK and the indexers each had their own.
+ * A fallback repeated in five places is a rule with five chances to drift, and
+ * the one place it is genuinely load-bearing (HyperCore, whose `eip155:1337`
+ * spelling is wrong) is exactly where getting it wrong is silent.
+ *
+ * Derived rather than authored per chain for the same reason `network` is: an
+ * EVM chain's CAIP-2 id is a restatement of its chain id, so authoring it would
+ * only create a second copy that could disagree with the first.
+ *
+ * Uniqueness is checked because `chainIdFromCaip2` is a reverse lookup over this
+ * field — two chains sharing an id makes that lookup silently return whichever
+ * came first.
+ */
+export declare function classifyChainCaip2(chains: ChainRegistry): {
+    chains: ChainRegistry;
+    issues: ValidationIssue[];
+};
+/**
+ * Where a chain's transactions and addresses can be looked at by a human.
+ * `url` has no trailing slash; the paths carry their own leading and trailing
+ * ones, so a link is `${url}${addressPath}${value}`.
+ */
+export interface ChainExplorer {
+    url: string;
+    addressPath: string;
+    txPath: string;
+}
+/**
+ * Stamps every chain with its block explorer, derived from the chain's viem
+ * definition where it has one and authored in the jsonnet where it does not.
+ *
+ * Resolved by the entry's declared `viemChain` **name**, never by chain id. A
+ * lookup by id is actively wrong here: viem's chain 1337 is `localhost`, so
+ * HyperCore — whose registry key is 1337 — would silently inherit Localhost's
+ * metadata. That is the same mistake as addressing HyperCore by `eip155:1337`,
+ * arrived at from the other direction.
+ *
+ * A missing explorer is not an error. It resolves to `null`, which consumers
+ * render as plain text instead of a link; the cost of not knowing one is a
+ * missing hyperlink, not a wrong answer. It is still worth a warning, because
+ * the usual cause is a chain added without one rather than a chain that
+ * genuinely has none.
+ */
+export declare function classifyChainExplorers(chains: ChainRegistry, networks: {
+    mainnets: StackNetworkEntry[];
+    testnets: StackNetworkEntry[];
+}): {
+    chains: ChainRegistry;
+    issues: ValidationIssue[];
+};
 /** The subset of a generated network entry that stack classification needs. */
 export interface StackNetworkEntry {
     id: number;

package/dist/scripts/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../scripts/validation.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D;+DAC2D;IAC3D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,yDAAyD;IACzD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgKD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAiBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAwEtD;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;0EACsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE;IACR,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,GACA;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAyFtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAiE3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAWvE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../scripts/validation.ts"],"names":[],"mappings":"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"}