@rhinestone/shared-configs 1.7.16 → 1.8.0

package/dist/configs/chains.json

@@ -6,6 +6,7 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -15,6 +16,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -72,6 +74,7 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -81,6 +84,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "op-stack",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -146,6 +150,7 @@
             "decimals": 18,
             "symbol": "BNB"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -153,6 +158,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "1inch",
             "0x",
@@ -200,11 +206,13 @@
             "decimals": 18,
             "symbol": "XDAI"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "RELAY",
             "NEAR",
             "RHINO"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "1inch",
             "velora"
@@ -233,6 +241,7 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -241,6 +250,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "op-stack",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -298,6 +308,7 @@
             "decimals": 18,
             "symbol": "POL"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -307,6 +318,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -356,11 +368,13 @@
             "decimals": 18,
             "symbol": "MON"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "0x"
         ],
@@ -411,12 +425,14 @@
             "decimals": 18,
             "symbol": "S"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ECO",
             "RELAY",
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -447,12 +463,14 @@
             "decimals": 18,
             "symbol": "HYPE"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
             "RELAY",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "0x"
         ],
@@ -490,7 +508,9 @@
             "decimals": 18,
             "symbol": "HYPE"
         },
+        "network": "mainnet",
         "settlementLayers": [],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -517,10 +537,12 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
         ],
+        "stack": "op-stack",
         "swapQuoters": [],
         "tokens": [
             {
@@ -571,10 +593,12 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "1inch",
             "0x"
@@ -620,6 +644,7 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -628,6 +653,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "op-stack",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -675,6 +701,7 @@
             "decimals": 18,
             "symbol": "XPL"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -682,9 +709,11 @@
             "OFT",
             "RHINO"
         ],
+        "stack": "vanilla",
         "swapQuoterConfig": {},
         "swapQuoters": [
-            "0x"
+            "0x",
+            "fynd"
         ],
         "tokens": [
             {
@@ -711,9 +740,11 @@
             "decimals": 18,
             "symbol": "XPL"
         },
+        "network": "testnet",
         "settlementLayers": [
             "ECO"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -748,6 +779,7 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -757,6 +789,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoterConfig": {},
         "swapQuoters": [
             "1inch",
@@ -814,6 +847,7 @@
             "decimals": 18,
             "symbol": "AVAX"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
@@ -821,6 +855,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [
             "1inch",
             "0x",
@@ -883,11 +918,13 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "testnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
             "CCTP"
         ],
+        "stack": "op-stack",
         "swapQuoters": [],
         "tokens": [
             {
@@ -940,11 +977,13 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "testnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -987,10 +1026,12 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "RELAY",
             "RHINO"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -1043,11 +1084,13 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "testnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -1090,11 +1133,13 @@
             "decimals": 18,
             "symbol": "ETH"
         },
+        "network": "testnet",
         "settlementLayers": [
             "ACROSS",
             "ECO",
             "CCTP"
         ],
+        "stack": "op-stack",
         "swapQuoters": [],
         "tokens": [
             {
@@ -1138,12 +1183,14 @@
             "decimals": 6,
             "symbol": "TRX"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "RELAY",
             "OFT",
             "NEAR",
             "RHINO"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {
@@ -1177,6 +1224,7 @@
             "decimals": 9,
             "symbol": "SOL"
         },
+        "network": "mainnet",
         "settlementLayers": [
             "RELAY",
             "OFT",
@@ -1184,6 +1232,7 @@
             "RHINO",
             "CCTP"
         ],
+        "stack": "vanilla",
         "swapQuoters": [],
         "tokens": [
             {

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

@@ -2,18 +2,75 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const bun_test_1 = require("bun:test");
 const validation_1 = require("../validation");
-(0, bun_test_1.describe)("validateChainConfig", () => {
+const index_1 = require("../../src/index");
+const nativeToken = { address: "0x0", symbol: "ETH", decimals: 18 };
+/** A structurally complete entry, so semantic tests don't trip structural checks. */
+function validChain(overrides = {}) {
+    return {
+        name: "Ethereum",
+        vmType: "evm",
+        network: "mainnet",
+        stack: "vanilla",
+        nativeToken,
+        wrappedNativeToken: { ...nativeToken, symbol: "WETH" },
+        tokens: [{ ...nativeToken, balanceSlot: null, approvalSlot: null }],
+        settlementLayers: ["ACROSS", "ECO", "RELAY"],
+        swapQuoters: ["0x"],
+        ...overrides,
+    };
+}
+function errorsFor(chain) {
+    return (0, validation_1.validateChainConfig)({ "1": chain }).issues.filter((i) => i.severity === "error");
+}
+(0, bun_test_1.describe)("validateChainConfig — structure", () => {
+    // The real generated registry is the thing this actually has to accept; if
+    // the checks drift stricter than the generator, the build breaks on good data.
+    (0, bun_test_1.it)("accepts the real generated chain registry", () => {
+        const result = (0, validation_1.validateChainConfig)(index_1.chainRegistry);
+        const errors = result.issues.filter((i) => i.severity === "error");
+        (0, bun_test_1.expect)(errors).toEqual([]);
+        (0, bun_test_1.expect)(result.hasErrors).toBe(false);
+    });
+    (0, bun_test_1.it)("rejects a key that is not a canonical chain id", () => {
+        const result = (0, validation_1.validateChainConfig)({ "01": validChain() });
+        (0, bun_test_1.expect)(result.hasErrors).toBe(true);
+        (0, bun_test_1.expect)(result.issues[0].message).toContain("canonical chain id");
+    });
+    bun_test_1.it.each([
+        ["a missing name", { name: undefined }],
+        ["an unknown vmType", { vmType: "wasm" }],
+        ["a non-object nativeToken", { nativeToken: "0x0" }],
+        ["a nativeToken missing decimals", { nativeToken: { address: "0x0", symbol: "ETH" } }],
+        ["tokens not an array", { tokens: {} }],
+        ["a token missing its slots", { tokens: [nativeToken] }],
+        ["a token with a bad pegGroup", {
+                tokens: [{ ...nativeToken, balanceSlot: null, approvalSlot: null, pegGroup: "GBP" }],
+            }],
+        ["an unknown settlement layer", { settlementLayers: ["ACROSS", "TELEPORT"] }],
+        ["an unknown swap quoter", { swapQuoters: ["mystery-dex"] }],
+        ["a malformed swapQuoterConfig", { swapQuoterConfig: { "0x": { slug: 5 } } }],
+        ["a swapQuoterConfig for an unknown quoter", { swapQuoterConfig: { nope: {} } }],
+        ["a non-boolean virtual flag", { virtual: "true" }],
+        ["a missing network", { network: undefined }],
+        ["an unknown network", { network: "devnet" }],
+    ])("rejects %s", (_label, overrides) => {
+        (0, bun_test_1.expect)(errorsFor(validChain(overrides)).length).toBeGreaterThan(0);
+    });
+    (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");
+        (0, bun_test_1.expect)(error.message).toContain("src/types.ts");
+    });
+});
+(0, bun_test_1.describe)("validateChainConfig — reachability", () => {
     (0, bun_test_1.it)("returns no issues for chains with multiple settlement layers", () => {
-        const chains = {
-            "1": { name: "Ethereum", settlementLayers: ["ACROSS", "ECO", "RELAY"], tokens: [] },
-        };
-        const result = (0, validation_1.validateChainConfig)(chains);
+        const result = (0, validation_1.validateChainConfig)({ "1": validChain() });
         (0, bun_test_1.expect)(result.issues).toHaveLength(0);
         (0, bun_test_1.expect)(result.hasErrors).toBe(false);
     });
     (0, bun_test_1.it)("returns error for chain with zero settlement layers", () => {
         const chains = {
-            "100": { name: "Gnosis", settlementLayers: [], tokens: [] },
+            "100": validChain({ name: "Gnosis", settlementLayers: [] }),
         };
         const result = (0, validation_1.validateChainConfig)(chains);
         (0, bun_test_1.expect)(result.issues).toHaveLength(1);
@@ -24,7 +81,7 @@ const validation_1 = require("../validation");
     });
     (0, bun_test_1.it)("returns warning for chain with single settlement layer", () => {
         const chains = {
-            "100": { name: "Gnosis", settlementLayers: ["RELAY"], tokens: [] },
+            "100": validChain({ name: "Gnosis", settlementLayers: ["RELAY"] }),
         };
         const result = (0, validation_1.validateChainConfig)(chains);
         (0, bun_test_1.expect)(result.issues).toHaveLength(1);
@@ -32,11 +89,18 @@ const validation_1 = require("../validation");
         (0, bun_test_1.expect)(result.issues[0].message).toContain("RELAY");
         (0, bun_test_1.expect)(result.hasErrors).toBe(false);
     });
+    (0, bun_test_1.it)("skips the reachability check for virtual chains", () => {
+        const chains = {
+            "1337": validChain({ name: "HyperCore", virtual: true, settlementLayers: [] }),
+        };
+        const result = (0, validation_1.validateChainConfig)(chains);
+        (0, bun_test_1.expect)(result.issues).toHaveLength(0);
+    });
     (0, bun_test_1.it)("handles mixed chains correctly", () => {
         const chains = {
-            "1": { name: "Ethereum", settlementLayers: ["ACROSS", "ECO", "RELAY"], tokens: [] },
-            "100": { name: "Gnosis", settlementLayers: ["RELAY"], tokens: [] },
-            "999": { name: "Broken", settlementLayers: [], tokens: [] },
+            "1": validChain(),
+            "100": validChain({ name: "Gnosis", settlementLayers: ["RELAY"] }),
+            "999": validChain({ name: "Broken", settlementLayers: [] }),
         };
         const result = (0, validation_1.validateChainConfig)(chains);
         (0, bun_test_1.expect)(result.issues).toHaveLength(2);
@@ -91,3 +155,144 @@ const validation_1 = require("../validation");
         (0, bun_test_1.expect)(output).toContain("Gnosis (100)");
     });
 });
+(0, bun_test_1.describe)("classifyChainNetworks", () => {
+    const providers = { providers: ["DRPC"] };
+    (0, bun_test_1.it)("stamps the network from whichever map holds the chain id", () => {
+        const { chains, issues } = (0, validation_1.classifyChainNetworks)({ "1": validChain(), "11155111": validChain({ name: "Sepolia" }) }, { "1": providers }, { "11155111": providers });
+        (0, bun_test_1.expect)(chains["1"].network).toBe("mainnet");
+        (0, bun_test_1.expect)(chains["11155111"].network).toBe("testnet");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    (0, bun_test_1.it)("overwrites any network the jsonnet happens to carry, so the maps stay the one source", () => {
+        const { chains } = (0, validation_1.classifyChainNetworks)({ "1": validChain({ network: "testnet" }) }, { "1": providers }, {});
+        (0, bun_test_1.expect)(chains["1"].network).toBe("mainnet");
+    });
+    // The silent-miss case this guard exists for: an unclassified chain would
+    // otherwise reach the signed artifact with no way for a consumer to place it.
+    (0, bun_test_1.it)("errors when a chain is in neither network map", () => {
+        const { chains, issues } = (0, validation_1.classifyChainNetworks)({ "1": validChain() }, {}, {});
+        (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].chainId).toBe("1");
+        (0, bun_test_1.expect)(issues[0].message).toContain("neither");
+        (0, bun_test_1.expect)(chains["1"].network).toBeUndefined();
+    });
+    (0, bun_test_1.it)("errors when a chain is in both network maps", () => {
+        const { issues } = (0, validation_1.classifyChainNetworks)({ "1": validChain() }, { "1": providers }, { "1": providers });
+        (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("both");
+    });
+    (0, bun_test_1.it)("warns when a network map lists a chain the registry does not define", () => {
+        const { issues } = (0, validation_1.classifyChainNetworks)({ "1": validChain() }, { "1": providers, "999999": providers }, {});
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("warning");
+        (0, bun_test_1.expect)(issues[0].chainId).toBe("999999");
+        (0, bun_test_1.expect)(issues[0].message).toContain("absent from the chain registry");
+    });
+    // The artifact is signed over these exact bytes, so the serialisation has to
+    // stay canonical rather than depending on where the field was spliced in.
+    (0, bun_test_1.it)("keeps entry keys sorted so the generated JSON stays canonical", () => {
+        const { chains } = (0, validation_1.classifyChainNetworks)({ "1": validChain() }, { "1": providers }, {});
+        const keys = Object.keys(chains["1"]);
+        (0, bun_test_1.expect)(keys).toEqual([...keys].sort());
+        (0, bun_test_1.expect)(keys).toContain("network");
+    });
+    (0, bun_test_1.it)("classifies the real registry with no issues", () => {
+        // Round-trips the shipped registry through its own maps: every real chain
+        // must land in exactly one, which is what makes the field derivable at all.
+        const mainnets = Object.fromEntries(Object.entries(index_1.chainRegistry)
+            .filter(([, c]) => c.network === "mainnet")
+            .map(([id]) => [id, providers]));
+        const testnets = Object.fromEntries(Object.entries(index_1.chainRegistry)
+            .filter(([, c]) => c.network === "testnet")
+            .map(([id]) => [id, providers]));
+        const { chains, issues } = (0, validation_1.classifyChainNetworks)(index_1.chainRegistry, mainnets, testnets);
+        (0, bun_test_1.expect)(issues).toEqual([]);
+        (0, bun_test_1.expect)(Object.keys(mainnets).length).toBeGreaterThan(0);
+        (0, bun_test_1.expect)(Object.keys(testnets).length).toBeGreaterThan(0);
+        (0, bun_test_1.expect)(Object.keys(chains)).toHaveLength(Object.keys(index_1.chainRegistry).length);
+    });
+});
+(0, bun_test_1.describe)("classifyChainStacks", () => {
+    const nets = (mainnets, testnets = []) => ({ mainnets, testnets });
+    // The common case: nothing is authored anywhere. viem already knows what Base
+    // is, so the value is read off its definition and cannot drift from it.
+    (0, bun_test_1.it)("derives the stack from viem's own chain definition", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)({ "8453": validChain({ name: "Base" }), "42161": validChain({ name: "Arbitrum One" }) }, nets([
+            { id: 8453, viemChain: "base" },
+            { id: 42161, viemChain: "arbitrum" },
+        ]));
+        (0, bun_test_1.expect)(chains["8453"].stack).toBe("op-stack");
+        // viem's arbitrum carries no formatters — Orbit is genuinely vanilla here.
+        (0, bun_test_1.expect)(chains["42161"].stack).toBe("vanilla");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // The whole reason the field exists, and the reason it is not defaulted: this
+    // is the shape of a chain added faster than viem ships it, and guessing
+    // "vanilla" for an OP-stack L2 would misprice its gas with no error anywhere.
+    (0, bun_test_1.it)("refuses to guess for an EVM chain viem does not ship", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)({ "1234": validChain({ name: "Newchain" }) }, nets([{ id: 1234 }]));
+        (0, bun_test_1.expect)(chains["1234"].stack).toBeUndefined();
+        (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("author `stack`");
+    });
+    (0, bun_test_1.it)("takes the authored stack for a chain viem does not ship", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)({ "1234": validChain({ name: "Newchain" }) }, nets([{ id: 1234, stack: "op-stack" }]));
+        (0, bun_test_1.expect)(chains["1234"].stack).toBe("op-stack");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    (0, bun_test_1.it)("rejects an authored value outside the union", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)({ "1234": validChain({ name: "Newchain" }) }, nets([{ id: 1234, stack: "orbit" }]));
+        (0, bun_test_1.expect)(chains["1234"].stack).toBeUndefined();
+        (0, bun_test_1.expect)(issues[0]?.message).toContain('"orbit" is not one of');
+    });
+    // Authoring may agree with viem, never override it: for a chain viem ships,
+    // viem's definition is what the consumer actually uses.
+    (0, bun_test_1.it)("rejects an authored stack that contradicts viem", () => {
+        const { issues } = (0, validation_1.classifyChainStacks)({ "8453": validChain({ name: "Base" }) }, nets([{ id: 8453, viemChain: "base", stack: "vanilla" }]));
+        (0, bun_test_1.expect)(issues[0]?.severity).toBe("error");
+        (0, bun_test_1.expect)(issues[0]?.message).toContain("contradicts viem");
+    });
+    (0, bun_test_1.it)("errors when viemChain names an export viem does not have", () => {
+        const { issues } = (0, validation_1.classifyChainStacks)({ "1234": validChain({ name: "Nope" }) }, nets([{ id: 1234, viemChain: "definitelyNotAChain" }]));
+        (0, bun_test_1.expect)(issues[0]?.message).toContain("no export");
+    });
+    // Non-EVM and virtual chains are never built as viem chains, so they must not
+    // be forced to declare a stack — that would be authoring noise on 3 of 24
+    // entries for a value nothing reads.
+    (0, bun_test_1.it)("stamps vanilla for non-EVM and virtual chains without authoring", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)({
+            "792703809": validChain({ name: "Solana", vmType: "svm" }),
+            "1337": validChain({ name: "HyperCore", virtual: true }),
+        }, nets([{ id: 792703809 }, { id: 1337 }]));
+        (0, bun_test_1.expect)(chains["792703809"].stack).toBe("vanilla");
+        (0, bun_test_1.expect)(chains["1337"].stack).toBe("vanilla");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // Same invariant classifyChainNetworks holds for `network`: the field is
+    // present if and only if it was derived here, so the structural check in
+    // validateChainConfig stays an independent second gate rather than re-reading
+    // whatever the jsonnet happened to emit.
+    (0, bun_test_1.it)("ignores a stack carried in on the input, including when it then fails", () => {
+        const { chains } = (0, validation_1.classifyChainStacks)({ "8453": validChain({ name: "Base", stack: "zksync" }) }, nets([{ id: 8453, viemChain: "base" }]));
+        (0, bun_test_1.expect)(chains["8453"].stack).toBe("op-stack");
+        const { chains: failed } = (0, validation_1.classifyChainStacks)({ "1234": validChain({ name: "Newchain", stack: "op-stack" }) }, nets([{ id: 1234 }]));
+        (0, bun_test_1.expect)(failed["1234"].stack).toBeUndefined();
+    });
+    (0, bun_test_1.it)("stamps every chain in the real registry", () => {
+        const { chains, issues } = (0, validation_1.classifyChainStacks)(index_1.chainRegistry, 
+        // The real network entries are not exported, so re-derive from the
+        // registry: every EVM chain in it is one viem ships today, which is the
+        // property that keeps the field authored nowhere.
+        nets(Object.keys(index_1.chainRegistry).map((id) => ({
+            id: Number(id),
+            stack: "vanilla",
+        }))));
+        (0, bun_test_1.expect)(issues.filter((i) => i.severity === "error")).toEqual([]);
+        for (const entry of Object.values(chains)) {
+            (0, bun_test_1.expect)(entry.stack).toBeDefined();
+        }
+    });
+});

package/dist/scripts/generate.js

@@ -88,7 +88,7 @@ function renderChains(chainRegistry, mainnets, testnets) {
     }
     return [
         "// Auto-generated by scripts/generate.ts. Do not edit manually.",
-        'import type { PegGroup, ProviderName, SettlementLayer, SupportedChain, SwapQuoter, SwapQuoterConfig, VmType } from "./types";',
+        'import type { ChainNetwork, ChainStack, PegGroup, ProviderName, SettlementLayer, SupportedChain, SwapQuoter, SwapQuoterConfig, VmType } from "./types";',
         "",
         "interface Token {",
         "  /** EVM: 0x-prefixed hex. SVM: base58 SPL mint. TVM: base58 (T-prefixed). */",
@@ -112,6 +112,10 @@ function renderChains(chainRegistry, mainnets, testnets) {
         "interface Chain {",
         "  name: string;",
         "  vmType: VmType;",
+        "  /** Whether this chain is a mainnet or a testnet. */",
+        "  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;",
         "  /** True for virtual chains (e.g. HyperCore) that settle on another chain. */",
@@ -354,14 +358,30 @@ async function generate() {
     const output = runJsonnet(yeetRoot);
     await (0, promises_1.mkdir)(configsDir, { recursive: true });
     await (0, promises_1.mkdir)(generatedDir, { recursive: true });
-    await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "chains.json"), `${JSON.stringify(output.chains, null, 2)}\n`);
+    // Stamp mainnet/testnet onto each entry before anything is written, so the
+    // registry that reaches configs/chains.json — and from there the published
+    // facts artifact and the read-client's bundled fallback — carries the
+    // classification rather than leaving it implicit in the network maps.
+    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];
+    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`);
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "providers.json"), `${JSON.stringify(output.providers, null, 2)}\n`);
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "oft.json"), `${JSON.stringify(output.oft, null, 2)}\n`);
     await (0, promises_1.writeFile)(node_path_1.default.join(configsDir, "oft-programs.json"), `${JSON.stringify(output.oftProgramIds ?? {}, null, 2)}\n`);
-    // Validate chain configuration
-    const validationResult = (0, validation_1.validateChainConfig)(output.chains);
+    // Validate chain configuration. Classification problems are reported in the
+    // same pass so one run surfaces everything wrong with the registry, rather than
+    // failing on the partition and hiding the rest.
+    const structural = (0, validation_1.validateChainConfig)(classifiedChains);
+    const validationResult = {
+        issues: [...classificationIssues, ...structural.issues],
+        hasErrors: structural.hasErrors ||
+            classificationIssues.some((issue) => issue.severity === 'error'),
+    };
     const validationOutput = (0, validation_1.formatValidationIssues)(validationResult);
     if (validationOutput) {
         console.log('\nChain config validation:');
@@ -371,7 +391,13 @@ async function generate() {
     if (validationResult.hasErrors) {
         throw new Error('Chain configuration has errors — see above');
     }
-    await (0, promises_1.writeFile)(node_path_1.default.join(sharedConfigsRoot, "src", "chains.ts"), `${renderChains(output.chains, output.mainnets, output.testnets)}\n`);
+    await (0, promises_1.writeFile)(node_path_1.default.join(sharedConfigsRoot, "src", "chains.ts"), `${renderChains(classifiedChains, output.mainnets, output.testnets)}\n`);
+    // Stamp the package version so the read-client knows how fresh its BUNDLED
+    // registry is, and can refuse a remote artifact from an older release. The
+    // release workflow bumps package.json before building for exactly this
+    // reason — see shared-configs-publish.yml.
+    const packageVersion = JSON.parse(await (0, promises_1.readFile)(node_path_1.default.join(sharedConfigsRoot, "package.json"), "utf8")).version;
+    await (0, promises_1.writeFile)(node_path_1.default.join(generatedDir, "packageVersion.ts"), `// Auto-generated by scripts/generate.ts. Do not edit manually.\nconst PACKAGE_VERSION = "${packageVersion}";\n\nexport { PACKAGE_VERSION };\n`);
     await (0, promises_1.writeFile)(node_path_1.default.join(generatedDir, "networks.ts"), `${renderNetworks(output.networks)}\n`);
     const prodAddrConfig = runOrchestratorFile(yeetRoot, "prod", output.chainNames);
     const stagingAddrConfig = runOrchestratorFile(yeetRoot, "staging", output.chainNames);