npm - @rhinestone/shared-configs - Versions diffs - 1.11.2 → 1.12.0 - Mend

@rhinestone/shared-configs 1.11.2 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/configs/chains.json +47 -0
package/dist/scripts/__tests__/validation.test.js +145 -0
package/dist/scripts/generate.js +19 -1
package/dist/scripts/validation.d.ts +51 -0
package/dist/scripts/validation.js +194 -0
package/dist/src/chains.d.ts +8 -0
package/dist/src/chains.js +47 -0
package/dist/src/generated/packageVersion.d.ts +1 -1
package/dist/src/generated/packageVersion.js +1 -1
package/dist/src/types.d.ts +40 -0
package/package.json +1 -1

package/dist/configs/chains.json CHANGED Viewed

@@ -6,6 +6,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "mainnet",
         "name": "Ethereum",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -13,6 +14,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://eth.merkle.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -96,6 +98,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "optimism",
         "name": "OP Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -103,6 +106,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.optimism.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -197,6 +201,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "bsc",
         "name": "BNB Smart Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -204,6 +209,7 @@
             "symbol": "BNB"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://56.rpc.thirdweb.com",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -271,6 +277,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "gnosis",
         "name": "Gnosis",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -278,6 +285,7 @@
             "symbol": "XDAI"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.gnosischain.com",
         "settlementLayers": [
             "RELAY",
             "NEAR",
@@ -312,6 +320,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "unichain",
         "name": "Unichain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -319,6 +328,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.unichain.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -401,6 +411,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "polygon",
         "name": "Polygon",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -408,6 +419,7 @@
             "symbol": "POL"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://polygon.drpc.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -478,6 +490,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "monad",
         "name": "Monad",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -485,6 +498,7 @@
             "symbol": "MON"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.monad.xyz",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
@@ -553,6 +567,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "sonic",
         "name": "Sonic",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -560,6 +575,7 @@
             "symbol": "S"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.soniclabs.com",
         "settlementLayers": [
             "ECO",
             "RELAY",
@@ -600,6 +616,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperEVM",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -607,6 +624,7 @@
             "symbol": "HYPE"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.hyperliquid.xyz/evm",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -658,6 +676,7 @@
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -697,6 +716,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "soneium",
         "name": "Soneium Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -704,6 +724,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.soneium.org",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
@@ -771,6 +792,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "robinhood",
         "name": "Robinhood Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -778,6 +800,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.mainnet.chain.robinhood.com",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
@@ -834,6 +857,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "base",
         "name": "Base",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -841,6 +865,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.base.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -909,6 +934,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "plasma",
         "name": "Plasma",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -916,6 +942,7 @@
             "symbol": "XPL"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.plasma.to",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -958,6 +985,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "plasma",
         "name": "Plasma Testnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -965,6 +993,7 @@
             "symbol": "XPL"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://testnet-rpc.plasma.to",
         "settlementLayers": [
             "ECO"
         ],
@@ -1009,6 +1038,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "arbitrum",
         "name": "Arbitrum One",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1016,6 +1046,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://arb1.arbitrum.io/rpc",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1099,6 +1130,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "avalanche",
         "name": "Avalanche",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1106,6 +1138,7 @@
             "symbol": "AVAX"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://api.avax.network/ext/bc/C/rpc",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
@@ -1182,6 +1215,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "base",
         "name": "Base Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1189,6 +1223,7 @@
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia.base.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1263,6 +1298,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "arbitrum",
         "name": "Arbitrum Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1270,6 +1306,7 @@
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia-rollup.arbitrum.io/rpc",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1330,6 +1367,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "katana",
         "name": "Katana",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1337,6 +1375,7 @@
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.katana.network",
         "settlementLayers": [
             "RELAY",
             "RHINO"
@@ -1394,6 +1433,7 @@
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore Spot",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1433,6 +1473,7 @@
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore Perp",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1472,6 +1513,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "mainnet",
         "name": "Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1479,6 +1521,7 @@
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://11155111.rpc.thirdweb.com",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1549,6 +1592,7 @@
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "optimism",
         "name": "OP Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1556,6 +1600,7 @@
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia.optimism.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1616,6 +1661,7 @@
             "txPath": "/#/transaction/",
             "url": "https://tronscan.org"
         },
+        "iconSlug": "tron",
         "name": "Tron",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1662,6 +1708,7 @@
             "txPath": "/tx/",
             "url": "https://solscan.io"
         },
+        "iconSlug": "solana",
         "name": "Solana",
         "nativeToken": {
             "address": "11111111111111111111111111111111",

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

@@ -73,6 +73,12 @@ function errorsFor(chain) {
         ["an explorer url with a trailing slash", {
                 explorer: { url: "https://etherscan.io/", addressPath: "/address/", txPath: "/tx/" },
             }],
+        // A stem, not a path or a URL — the whole point of publishing a slug is that
+        // the artifact says nothing about where the file is served from.
+        ["an iconSlug that is a full URL", { iconSlug: "https://s3.rhinestone.dev/chains/base.svg" }],
+        ["an iconSlug carrying its extension", { iconSlug: "base.svg" }],
+        ["an iconSlug carrying a directory", { iconSlug: "chains/base" }],
+        ["an iconSlug that is not a string", { iconSlug: 42 }],
     ])("rejects %s", (_label, overrides) => {
         (0, bun_test_1.expect)(errorsFor(validChain(overrides)).length).toBeGreaterThan(0);
     });
@@ -387,6 +393,145 @@ function errorsFor(chain) {
         }
     });
 });
+(0, bun_test_1.describe)("classifyChainPublicRpcUrls", () => {
+    const nets = (mainnets, testnets = []) => ({ mainnets, testnets });
+    (0, bun_test_1.it)("derives the endpoint from viem's own chain definition", () => {
+        const { chains, issues } = (0, validation_1.classifyChainPublicRpcUrls)({ "8453": validChain({ name: "Base" }) }, nets([{ id: 8453, viemChain: "base" }]));
+        (0, bun_test_1.expect)(chains["8453"].publicRpcUrl).toBe("https://mainnet.base.org");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // The regression this exists for, and the reason it is worse here than for
+    // explorers: viem's id 999 is claimed by hyperEvm, hyperliquid, wanchainTestnet
+    // and zoraTestnet. An id lookup would publish a live endpoint for the wrong
+    // chain, which fails at connect time rather than at render time.
+    (0, bun_test_1.it)("resolves by declared viemChain name, never by chain id", () => {
+        const { chains } = (0, validation_1.classifyChainPublicRpcUrls)({ "999": validChain({ name: "HyperEVM", caip2: "eip155:999" }) }, nets([{ id: 999, viemChain: "hyperEvm" }]));
+        (0, bun_test_1.expect)(chains["999"].publicRpcUrl).toBe("https://rpc.hyperliquid.xyz/evm");
+    });
+    (0, bun_test_1.it)("lets an authored endpoint win, for a chain viem does not ship", () => {
+        const { chains, issues } = (0, validation_1.classifyChainPublicRpcUrls)({
+            "424242": validChain({
+                name: "Newchain",
+                publicRpcUrl: "https://rpc.newchain.example",
+            }),
+        }, nets([{ id: 424242 }]));
+        (0, bun_test_1.expect)(chains["424242"].publicRpcUrl).toBe("https://rpc.newchain.example");
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // A browser on an https page cannot call an http endpoint at all, so an
+    // authored one is a URL that never connects rather than a working fallback.
+    (0, bun_test_1.it)("errors on an authored endpoint that is not https", () => {
+        const { issues } = (0, validation_1.classifyChainPublicRpcUrls)({ "1": validChain({ publicRpcUrl: "http://rpc.example" }) }, nets([{ id: 1, viemChain: "mainnet" }]));
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("error");
+    });
+    // Absent is a real answer — the chain is display-only — so a real EVM chain
+    // with nothing to derive warns rather than failing the build.
+    (0, bun_test_1.it)("warns and leaves the field absent when nothing can supply one", () => {
+        const { chains, issues } = (0, validation_1.classifyChainPublicRpcUrls)({ "424242": validChain({ name: "Newchain" }) }, nets([{ id: 424242 }]));
+        (0, bun_test_1.expect)("publicRpcUrl" in chains["424242"]).toBe(false);
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].severity).toBe("warning");
+    });
+    // Non-EVM and virtual chains are never synthesised as viem chains, so there
+    // is nothing for them to be missing and nothing worth reporting.
+    (0, bun_test_1.it)("stays silent for chains that are never built as viem chains", () => {
+        const { issues } = (0, validation_1.classifyChainPublicRpcUrls)({
+            "792703809": validChain({ name: "Solana", vmType: "svm" }),
+            "1337": validChain({ name: "HyperCore", virtual: true }),
+        }, nets([{ id: 792703809 }, { id: 1337 }]));
+        (0, bun_test_1.expect)(issues).toEqual([]);
+    });
+    // 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)("gives every real EVM chain a well-formed https endpoint", () => {
+        for (const [id, entry] of Object.entries(index_1.chainRegistry)) {
+            const e = entry;
+            const isSynthesisable = e.vmType === "evm" && e.virtual !== true;
+            if (!isSynthesisable) {
+                (0, bun_test_1.expect)("publicRpcUrl" in e, id).toBe(false);
+                continue;
+            }
+            (0, bun_test_1.expect)(e.publicRpcUrl, id).toMatch(/^https:\/\/\S+$/);
+            (0, bun_test_1.expect)(e.publicRpcUrl.endsWith("/"), id).toBe(false);
+        }
+    });
+});
+(0, bun_test_1.describe)("validateChainIconSlugs", () => {
+    (0, bun_test_1.it)("passes a chain that carries a mark", () => {
+        (0, bun_test_1.expect)((0, validation_1.validateChainIconSlugs)({ "8453": validChain({ name: "Base", iconSlug: "base" }) })).toEqual([]);
+    });
+    // The whole point of the gate. `iconSlug` is authored by hand, so a chain
+    // added without one produces a blank tile in production and nothing anywhere
+    // reports it — no type, no test, no log. This turns that into a build failure
+    // while someone is already editing the registry.
+    (0, bun_test_1.it)("errors when a chain has neither a mark nor an exemption", () => {
+        const issues = (0, validation_1.validateChainIconSlugs)({
+            "424242": validChain({ name: "Newchain" }),
+        });
+        (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("424242");
+        // Both remedies are named, because which one is right is a product call.
+        (0, bun_test_1.expect)(issues[0].message).toContain("s3-public");
+        (0, bun_test_1.expect)(issues[0].message).toContain("CHAINS_WITHOUT_ICON");
+    });
+    // Absence is allowed, but only as a decision written down in code. The real
+    // exemption map is empty, so these two inject one rather than requiring some
+    // chain be left un-iconed purely to have something to assert against.
+    const exempt = new Map([["424242", "Newchain — no mark published"]]);
+    (0, bun_test_1.it)("accepts an absent mark for a chain listed in CHAINS_WITHOUT_ICON", () => {
+        (0, bun_test_1.expect)((0, validation_1.validateChainIconSlugs)({ "424242": validChain({ name: "Newchain" }) }, exempt)).toEqual([]);
+    });
+    // A stale exemption permanently excuses the chain it names, so the next person
+    // to drop that slug gets no warning at all.
+    (0, bun_test_1.it)("errors when an exempted chain gains a mark, so the exemption cannot rot", () => {
+        const issues = (0, validation_1.validateChainIconSlugs)({ "424242": validChain({ name: "Newchain", iconSlug: "newchain" }) }, exempt);
+        (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("remove the exemption");
+    });
+    bun_test_1.it.each([
+        ["a full URL", "https://s3.rhinestone.dev/chains/base.svg"],
+        ["an extension", "base.svg"],
+        ["a directory", "chains/base"],
+        ["uppercase", "Base"],
+    ])("errors on a slug carrying %s", (_label, iconSlug) => {
+        const issues = (0, validation_1.validateChainIconSlugs)({
+            "8453": validChain({ name: "Base", iconSlug }),
+        });
+        (0, bun_test_1.expect)(issues).toHaveLength(1);
+        (0, bun_test_1.expect)(issues[0].message).toContain("malformed");
+    });
+    (0, bun_test_1.it)("passes the real generated registry", () => {
+        (0, bun_test_1.expect)((0, validation_1.validateChainIconSlugs)(index_1.chainRegistry)).toEqual([]);
+    });
+    // Asserted against the shipped registry rather than by re-running the check,
+    // so this covers what actually reaches the artifact.
+    (0, bun_test_1.it)("gives every shipped chain a mark", () => {
+        const withoutIcon = Object.entries(index_1.chainRegistry)
+            .filter(([, e]) => e.iconSlug === undefined)
+            .map(([id]) => id);
+        (0, bun_test_1.expect)(withoutIcon).toEqual([]);
+    });
+    // Two reuse rules that would otherwise look like copy-paste errors in the
+    // jsonnet. A testnet is visually the same chain as its mainnet, and all three
+    // HyperCore ids are Hyperliquid — the same branding as HyperEVM.
+    bun_test_1.it.each([
+        ["11155111", "1"],
+        ["11155420", "10"],
+        ["84532", "8453"],
+        ["421614", "42161"],
+        ["9746", "9745"],
+        ["1337", "999"],
+        ["1337001", "999"],
+        ["1337002", "999"],
+    ])("reuses chain %s's glyph from chain %s", (child, parent) => {
+        const slug = index_1.chainRegistry[parent].iconSlug;
+        (0, bun_test_1.expect)(slug).toBeDefined();
+        (0, bun_test_1.expect)(index_1.chainRegistry[child].iconSlug).toBe(slug);
+    });
+});
 (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 CHANGED Viewed

@@ -132,6 +132,14 @@ function renderChains(chainRegistry, mainnets, testnets) {
         "  caip2: string;",
         "  /** Block explorer, or null for a chain that has none (render plain text). */",
         "  explorer: Explorer | null;",
+        "  /** Filename stem of this chain's mark in s3-public's `chains/` directory,",
+        "   *  served today at `https://s3.rhinestone.dev/chains/<slug>.svg`. A slug and",
+        "   *  not a URL so the CDN stays a consumer's concern. Absent means no mark —",
+        "   *  render a coloured initial chip, never an error. */",
+        "  iconSlug?: string;",
+        "  /** Public, unauthenticated https JSON-RPC endpoint — what a browser needs to",
+        "   *  build this chain with `defineChain`. Absent means display-only. */",
+        "  publicRpcUrl?: string;",
         "  /** True for virtual chains (e.g. HyperCore) that settle on another chain. */",
         "  virtual?: boolean;",
         "  /** Which directions of transfer the chain supports; absent means both.",
@@ -394,12 +402,22 @@ async function generate() {
     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 { chains: explorerClassified, issues: explorerIssues } = (0, validation_1.classifyChainExplorers)(caip2Classified, output.networks);
+    // Then the public RPC endpoint, the last thing a browser consumer needs to
+    // build a viem `Chain` for a chain it was never compiled against — and the
+    // one that decides whether that chain is connectable or only displayable.
+    const { chains: classifiedChains, issues: publicRpcUrlIssues } = (0, validation_1.classifyChainPublicRpcUrls)(explorerClassified, output.networks);
+    // `iconSlug` is authored, not derived, so there is nothing to classify — only
+    // to insist on. A chain added without one would otherwise reach production as
+    // a blank tile, which nothing anywhere reports.
+    const iconSlugIssues = (0, validation_1.validateChainIconSlugs)(classifiedChains);
     const classificationIssues = [
         ...networkIssues,
         ...stackIssues,
         ...caip2Issues,
         ...explorerIssues,
+        ...publicRpcUrlIssues,
+        ...iconSlugIssues,
     ];
     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`);

package/dist/scripts/validation.d.ts CHANGED Viewed

@@ -122,6 +122,57 @@ export declare function classifyChainExplorers(chains: ChainRegistry, networks:
     chains: ChainRegistry;
     issues: ValidationIssue[];
 };
+/**
+ * Fails the build for a chain that has neither a mark nor an explicit exemption.
+ *
+ * Why an error and not a warning: `iconSlug` is authored by hand, so the failure
+ * mode of a new chain is silence — nobody forgets a field they were never
+ * prompted for, and the result is a blank tile in production that no test, type
+ * or log names. The gate turns that into a build failure at the moment someone
+ * is already editing the registry, which is the only point where the decision is
+ * cheap. CHAINS_WITHOUT_ICON is how "this chain genuinely has no mark" is said
+ * out loud, in code review, rather than being indistinguishable from an oversight.
+ *
+ * Deliberately offline. Whether `chains/<slug>.svg` actually exists on the CDN is
+ * not checked and must not be: the build would then fail on a CDN blip or in a
+ * sandboxed CI runner, which is a far more frequent failure than a typo'd slug
+ * and produces a red build with nothing wrong in the diff. The cost of a bad slug
+ * is one missing image; the cost of a network-dependent build gate is every build.
+ */
+export declare function validateChainIconSlugs(chains: ChainRegistry, exemptions?: ReadonlyMap<string, string>): ValidationIssue[];
+/**
+ * Stamps every chain with a public JSON-RPC endpoint, derived from the chain's
+ * viem definition where it has one and authored in the jsonnet where it does
+ * not.
+ *
+ * Why this exists: a browser consumer building a viem `Chain` with
+ * `defineChain` — for a chain newer than its pinned viem — already gets id,
+ * name, native currency, `explorer` and `stack` from this registry. The RPC
+ * endpoint was the only missing piece, and it is the piece that decides whether
+ * a newly added chain is a first-class wallet-connect target or display-only.
+ * It is the PUBLIC endpoint on purpose: the rpc-proxy path needs an API key,
+ * which is the one thing a browser cannot have.
+ *
+ * Resolved by the entry's declared `viemChain` **name**, never by chain id, for
+ * the same reason as `classifyChainExplorers` — only worse here, because the
+ * consequence is a live endpoint for the wrong chain rather than a dead link.
+ * viem 2.55 has 23 chain ids claimed by more than one export: id 999 is
+ * `hyperEvm`, `hyperliquid`, `wanchainTestnet` and `zoraTestnet`, so an id
+ * lookup for HyperEVM can hand out a Zora testnet RPC.
+ *
+ * A missing endpoint is not an error — it resolves to the field being absent,
+ * and a consumer treats that chain as display-only. It is worth a warning for a
+ * real EVM chain, where the usual cause is a chain viem does not ship yet; for
+ * a non-EVM or virtual chain there is nothing to warn about, since none of them
+ * is ever built as a viem chain.
+ */
+export declare function classifyChainPublicRpcUrls(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.js CHANGED Viewed

@@ -36,6 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.classifyChainNetworks = classifyChainNetworks;
 exports.classifyChainCaip2 = classifyChainCaip2;
 exports.classifyChainExplorers = classifyChainExplorers;
+exports.validateChainIconSlugs = validateChainIconSlugs;
+exports.classifyChainPublicRpcUrls = classifyChainPublicRpcUrls;
 exports.classifyChainStacks = classifyChainStacks;
 exports.validateChainConfig = validateChainConfig;
 exports.formatValidationIssues = formatValidationIssues;
@@ -141,6 +143,18 @@ function structuralProblems(chain) {
     else if (chain.explorer !== null && !isChainExplorer(chain.explorer)) {
         problems.push(`explorer ${JSON.stringify(chain.explorer)} is not null or { url (no trailing slash), addressPath, txPath (both slash-wrapped) }`);
     }
+    // Optional, like publicRpcUrl below: a chain with no mark renders as a
+    // coloured initial chip. Only the shape is checked here — whether a chain is
+    // ALLOWED to have none is validateChainIconSlugs' job.
+    if (!isAbsentOr(chain.iconSlug, isIconSlug)) {
+        problems.push(`iconSlug ${JSON.stringify(chain.iconSlug)} is not a bare filename stem (lowercase letters, digits and hyphens)`);
+    }
+    // Optional, unlike the four above: a chain with no known public endpoint is
+    // display-only, which is a real answer. Only its shape is checked, and only
+    // when present — see classifyChainPublicRpcUrls for why it must be https.
+    if (!isAbsentOr(chain.publicRpcUrl, isPublicRpcUrl)) {
+        problems.push(`publicRpcUrl ${JSON.stringify(chain.publicRpcUrl)} is not an https:// URL`);
+    }
     if (!isAbsentOr(chain.virtual, (v) => typeof v === 'boolean')) {
         problems.push('virtual is not a boolean');
     }
@@ -499,6 +513,186 @@ function classifyChainExplorers(chains, networks) {
     }
     return { chains: stamped, issues };
 }
+/**
+ * A bare filename stem: no directory, no extension, no scheme.
+ *
+ * The shape is what keeps the field a chain fact rather than a URL. A value
+ * carrying `https://`, a `chains/` prefix or a `.svg` suffix would have baked
+ * this CDN's layout into a signed artifact every service reads — the exact
+ * coupling the field is a slug to avoid.
+ */
+const ICON_SLUG = /^[a-z0-9][a-z0-9-]*$/;
+const isIconSlug = (value) => typeof value === 'string' && ICON_SLUG.test(value);
+/**
+ * Chain ids that are allowed to ship with no `iconSlug`.
+ *
+ * An entry here is a decision that this chain renders as a coloured initial
+ * chip. Every id needs a reason next to it, and the reason should stop being
+ * true eventually — when a mark is published, the entry goes.
+ */
+// Empty, and worth keeping that way: every chain in the registry has a mark.
+// An entry here permanently excuses a chain from the check below, so it is for
+// a chain whose mark genuinely cannot be obtained — not for one nobody has got
+// round to yet.
+const CHAINS_WITHOUT_ICON = new Map();
+/**
+ * Fails the build for a chain that has neither a mark nor an explicit exemption.
+ *
+ * Why an error and not a warning: `iconSlug` is authored by hand, so the failure
+ * mode of a new chain is silence — nobody forgets a field they were never
+ * prompted for, and the result is a blank tile in production that no test, type
+ * or log names. The gate turns that into a build failure at the moment someone
+ * is already editing the registry, which is the only point where the decision is
+ * cheap. CHAINS_WITHOUT_ICON is how "this chain genuinely has no mark" is said
+ * out loud, in code review, rather than being indistinguishable from an oversight.
+ *
+ * Deliberately offline. Whether `chains/<slug>.svg` actually exists on the CDN is
+ * not checked and must not be: the build would then fail on a CDN blip or in a
+ * sandboxed CI runner, which is a far more frequent failure than a typo'd slug
+ * and produces a red build with nothing wrong in the diff. The cost of a bad slug
+ * is one missing image; the cost of a network-dependent build gate is every build.
+ */
+function validateChainIconSlugs(chains,
+// Injectable so the exemption paths stay covered while the real map is empty.
+// Testing them against a live entry would mean keeping a chain un-iconed just
+// to have something to assert on.
+exemptions = CHAINS_WITHOUT_ICON) {
+    const issues = [];
+    for (const [chainId, chain] of Object.entries(chains)) {
+        const chainName = isNonEmptyString(chain?.name)
+            ? chain.name
+            : '<unnamed>';
+        const slug = chain?.iconSlug;
+        const exemption = exemptions.get(chainId);
+        if (slug === undefined) {
+            if (exemption === undefined) {
+                issues.push({
+                    severity: 'error',
+                    chainId,
+                    chainName,
+                    message: 'has no iconSlug — add the filename stem of its mark in rhinestonewtf/s3-public ' +
+                        "(`chains/<slug>.svg`) to this chain's chainMeta entry in " +
+                        'config/shared-configs.jsonnet, or, if it genuinely has none, add its id to ' +
+                        'CHAINS_WITHOUT_ICON in scripts/validation.ts with the reason. It is not ' +
+                        'defaulted: a chain with no mark renders as a blank tile with nothing logged',
+                });
+            }
+            continue;
+        }
+        // A stale exemption is worse than no exemption: it permanently excuses the
+        // one chain it names, so the next person to drop the slug gets no warning.
+        if (exemption !== undefined) {
+            issues.push({
+                severity: 'error',
+                chainId,
+                chainName,
+                message: `has an iconSlug ${JSON.stringify(slug)} but is still listed in CHAINS_WITHOUT_ICON (${exemption}) — remove the exemption`,
+            });
+        }
+        // Shape is also checked structurally; repeated here so this function is a
+        // complete gate on its own and a malformed slug cannot pass as "present".
+        if (!isIconSlug(slug)) {
+            issues.push({
+                severity: 'error',
+                chainId,
+                chainName,
+                message: `declares a malformed iconSlug ${JSON.stringify(slug)} — expected a bare filename stem, with no directory, extension or scheme`,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * `https://` only, and deliberately so. The field exists for a browser, which
+ * cannot hold an API key and — on an https page — cannot call an `http://`
+ * endpoint at all: the request is blocked as mixed content. Publishing one
+ * would hand consumers a URL that never connects, which is strictly worse than
+ * publishing nothing and letting the chain fall back to display-only.
+ */
+const isPublicRpcUrl = (value) => typeof value === 'string' && /^https:\/\/\S+$/.test(value);
+/**
+ * Stamps every chain with a public JSON-RPC endpoint, derived from the chain's
+ * viem definition where it has one and authored in the jsonnet where it does
+ * not.
+ *
+ * Why this exists: a browser consumer building a viem `Chain` with
+ * `defineChain` — for a chain newer than its pinned viem — already gets id,
+ * name, native currency, `explorer` and `stack` from this registry. The RPC
+ * endpoint was the only missing piece, and it is the piece that decides whether
+ * a newly added chain is a first-class wallet-connect target or display-only.
+ * It is the PUBLIC endpoint on purpose: the rpc-proxy path needs an API key,
+ * which is the one thing a browser cannot have.
+ *
+ * Resolved by the entry's declared `viemChain` **name**, never by chain id, for
+ * the same reason as `classifyChainExplorers` — only worse here, because the
+ * consequence is a live endpoint for the wrong chain rather than a dead link.
+ * viem 2.55 has 23 chain ids claimed by more than one export: id 999 is
+ * `hyperEvm`, `hyperliquid`, `wanchainTestnet` and `zoraTestnet`, so an id
+ * lookup for HyperEVM can hand out a Zora testnet RPC.
+ *
+ * A missing endpoint is not an error — it resolves to the field being absent,
+ * and a consumer treats that chain as display-only. It is worth a warning for a
+ * real EVM chain, where the usual cause is a chain viem does not ship yet; for
+ * a non-EVM or virtual chain there is nothing to warn about, since none of them
+ * is ever built as a viem chain.
+ */
+function classifyChainPublicRpcUrls(chains, networks) {
+    const issues = [];
+    const stamped = {};
+    const entriesById = new Map();
+    for (const entry of [...networks.mainnets, ...networks.testnets]) {
+        entriesById.set(String(entry.id), entry);
+    }
+    for (const [chainId, chain] of Object.entries(chains)) {
+        const chainName = isNonEmptyString(chain?.name)
+            ? chain.name
+            : '<unnamed>';
+        const authored = chain?.publicRpcUrl;
+        // Authoring wins outright, as with `explorer`: the jsonnet is the only place
+        // an endpoint can be given for a chain viem does not ship, or a better one
+        // preferred over viem's default.
+        if (authored !== undefined) {
+            if (!isPublicRpcUrl(authored)) {
+                issues.push({
+                    severity: 'error',
+                    chainId,
+                    chainName,
+                    message: `declares a malformed publicRpcUrl ${JSON.stringify(authored)} — expected an https:// URL`,
+                });
+                stamped[chainId] = withSortedKeys({ ...chain });
+                continue;
+            }
+            stamped[chainId] = withSortedKeys({ ...chain, publicRpcUrl: authored });
+            continue;
+        }
+        const viemChainName = entriesById.get(chainId)?.viemChain;
+        const url = viemChainName
+            ? viemChains[viemChainName]?.rpcUrls?.default?.http?.[0]
+            : undefined;
+        // viem's own value carries a trailing slash on some chains (`unichain`) and
+        // not others. Both address the same endpoint, so it is normalised here
+        // rather than published as an inconsistency every consumer has to absorb.
+        const normalised = typeof url === 'string' ? url.replace(/\/+$/, '') : undefined;
+        if (!isPublicRpcUrl(normalised)) {
+            // A chain that is never synthesised as a viem chain has nothing to be
+            // missing — only a real EVM chain is worth reporting.
+            if (chain.vmType === 'evm' && chain.virtual !== true) {
+                issues.push({
+                    severity: 'warning',
+                    chainId,
+                    chainName,
+                    message: viemChainName
+                        ? `viem chain "${viemChainName}" ships no usable https rpc url — the chain stays display-only for consumers that synthesise it until one is authored`
+                        : 'has no viemChain to derive a public rpc url from and authors none — the chain stays display-only for consumers that synthesise it',
+                });
+            }
+            stamped[chainId] = withSortedKeys({ ...chain });
+            continue;
+        }
+        stamped[chainId] = withSortedKeys({ ...chain, publicRpcUrl: normalised });
+    }
+    return { chains: stamped, issues };
+}
 const isChainStack = (v) => typeof v === 'string' && STACKS.has(v);
 const STACK_FORMATTERS = [
     ['op-stack', op_stack_1.chainConfig.formatters],

package/dist/src/chains.d.ts CHANGED Viewed

@@ -38,6 +38,14 @@ interface Chain {
     caip2: string;
     /** Block explorer, or null for a chain that has none (render plain text). */
     explorer: Explorer | null;
+    /** Filename stem of this chain's mark in s3-public's `chains/` directory,
+     *  served today at `https://s3.rhinestone.dev/chains/<slug>.svg`. A slug and
+     *  not a URL so the CDN stays a consumer's concern. Absent means no mark —
+     *  render a coloured initial chip, never an error. */
+    iconSlug?: string;
+    /** Public, unauthenticated https JSON-RPC endpoint — what a browser needs to
+     *  build this chain with `defineChain`. Absent means display-only. */
+    publicRpcUrl?: string;
     /** True for virtual chains (e.g. HyperCore) that settle on another chain. */
     virtual?: boolean;
     /** Which directions of transfer the chain supports; absent means both.

package/dist/src/chains.js CHANGED Viewed

@@ -9,6 +9,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "mainnet",
         "name": "Ethereum",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -16,6 +17,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://eth.merkle.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -103,6 +105,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "optimism",
         "name": "OP Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -110,6 +113,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.optimism.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -208,6 +212,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "bsc",
         "name": "BNB Smart Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -215,6 +220,7 @@ const chains = {
             "symbol": "BNB"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://56.rpc.thirdweb.com",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -286,6 +292,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "gnosis",
         "name": "Gnosis",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -293,6 +300,7 @@ const chains = {
             "symbol": "XDAI"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.gnosischain.com",
         "settlementLayers": [
             "RELAY",
             "NEAR",
@@ -332,6 +340,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "unichain",
         "name": "Unichain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -339,6 +348,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.unichain.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -425,6 +435,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "polygon",
         "name": "Polygon",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -432,6 +443,7 @@ const chains = {
             "symbol": "POL"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://polygon.drpc.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -506,6 +518,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "monad",
         "name": "Monad",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -513,6 +526,7 @@ const chains = {
             "symbol": "MON"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.monad.xyz",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
@@ -585,6 +599,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "sonic",
         "name": "Sonic",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -592,6 +607,7 @@ const chains = {
             "symbol": "S"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.soniclabs.com",
         "settlementLayers": [
             "ECO",
             "RELAY",
@@ -636,6 +652,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperEVM",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -643,6 +660,7 @@ const chains = {
             "symbol": "HYPE"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.hyperliquid.xyz/evm",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -699,6 +717,7 @@ const chains = {
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -739,6 +758,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "soneium",
         "name": "Soneium Mainnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -746,6 +766,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.soneium.org",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
@@ -817,6 +838,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "robinhood",
         "name": "Robinhood Chain",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -824,6 +846,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.mainnet.chain.robinhood.com",
         "settlementLayers": [
             "ACROSS",
             "RELAY"
@@ -884,6 +907,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "base",
         "name": "Base",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -891,6 +915,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://mainnet.base.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -963,6 +988,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "plasma",
         "name": "Plasma",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -970,6 +996,7 @@ const chains = {
             "symbol": "XPL"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.plasma.to",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1017,6 +1044,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "plasma",
         "name": "Plasma Testnet",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1024,6 +1052,7 @@ const chains = {
             "symbol": "XPL"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://testnet-rpc.plasma.to",
         "settlementLayers": [
             "ECO"
         ],
@@ -1073,6 +1102,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "arbitrum",
         "name": "Arbitrum One",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1080,6 +1110,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://arb1.arbitrum.io/rpc",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1167,6 +1198,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "avalanche",
         "name": "Avalanche",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1174,6 +1206,7 @@ const chains = {
             "symbol": "AVAX"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://api.avax.network/ext/bc/C/rpc",
         "settlementLayers": [
             "ACROSS",
             "RELAY",
@@ -1254,6 +1287,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "base",
         "name": "Base Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1261,6 +1295,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia.base.org",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1339,6 +1374,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "arbitrum",
         "name": "Arbitrum Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1346,6 +1382,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia-rollup.arbitrum.io/rpc",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1410,6 +1447,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "katana",
         "name": "Katana",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1417,6 +1455,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "mainnet",
+        "publicRpcUrl": "https://rpc.katana.network",
         "settlementLayers": [
             "RELAY",
             "RHINO"
@@ -1478,6 +1517,7 @@ const chains = {
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore Spot",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1518,6 +1558,7 @@ const chains = {
             "txPath": "/explorer/tx/",
             "url": "https://app.hyperliquid.xyz"
         },
+        "iconSlug": "hyperevm",
         "name": "HyperCore Perp",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1558,6 +1599,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "mainnet",
         "name": "Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1565,6 +1607,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://11155111.rpc.thirdweb.com",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1639,6 +1682,7 @@ const chains = {
             "addressPath": "/address/",
             "txPath": "/tx/"
         },
+        "iconSlug": "optimism",
         "name": "OP Sepolia",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1646,6 +1690,7 @@ const chains = {
             "symbol": "ETH"
         },
         "network": "testnet",
+        "publicRpcUrl": "https://sepolia.optimism.io",
         "settlementLayers": [
             "ACROSS",
             "ECO",
@@ -1710,6 +1755,7 @@ const chains = {
             "txPath": "/#/transaction/",
             "url": "https://tronscan.org"
         },
+        "iconSlug": "tron",
         "name": "Tron",
         "nativeToken": {
             "address": "0x0000000000000000000000000000000000000000",
@@ -1757,6 +1803,7 @@ const chains = {
             "txPath": "/tx/",
             "url": "https://solscan.io"
         },
+        "iconSlug": "solana",
         "name": "Solana",
         "nativeToken": {
             "address": "11111111111111111111111111111111",

package/dist/src/generated/packageVersion.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-declare const PACKAGE_VERSION = "1.11.2";
+declare const PACKAGE_VERSION = "1.12.0";
 export { PACKAGE_VERSION };

package/dist/src/generated/packageVersion.js CHANGED Viewed

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PACKAGE_VERSION = void 0;
 // Auto-generated by scripts/generate.ts. Do not edit manually.
-const PACKAGE_VERSION = "1.11.2";
+const PACKAGE_VERSION = "1.12.0";
 exports.PACKAGE_VERSION = PACKAGE_VERSION;

package/dist/src/types.d.ts CHANGED Viewed

@@ -128,6 +128,46 @@ interface ChainEntry {
      * jsonnet where it does not — see `classifyChainExplorers`.
      */
     explorer: ChainExplorer | null;
+    /**
+     * Filename stem of this chain's mark in the `chains/` directory of
+     * rhinestonewtf/s3-public — today `https://s3.rhinestone.dev/chains/<slug>.svg`.
+     *
+     * The other half of the same problem `publicRpcUrl` solves: a frontend can
+     * already name, link and connect to a chain it was never compiled against,
+     * but it could not draw it. Every consumer instead carried a hand-maintained
+     * chain-id → asset table, which is the kind of table that is always one chain
+     * behind the registry.
+     *
+     * Deliberately a SLUG, not a URL. This artifact describes chain identity; the
+     * CDN it happens to be served from is deployment, and it is the consumer (the
+     * deposit-processor) that composes the URL. Publishing full URLs would put the
+     * host in a signed artifact read by every service, so moving the CDN would
+     * mean re-publishing facts and rolling the fleet rather than changing one
+     * template string.
+     *
+     * Optional, and absence is a normal answer — a chain with no mark renders as a
+     * coloured initial chip. A consumer must never treat it as an error. Which
+     * chains may be absent is decided at build time, not here: see
+     * `validateChainIconSlugs`.
+     */
+    iconSlug?: string;
+    /**
+     * A public, unauthenticated JSON-RPC endpoint over HTTPS, when one is known.
+     *
+     * The one thing a browser consumer cannot get from anywhere else in this
+     * artifact. Building a viem `Chain` with `defineChain` — which the deposit
+     * modal does at runtime for chains it was never compiled against — needs the
+     * id, name, native currency, explorer and stack, all of which are above, plus
+     * an RPC endpoint. That single field is what decides whether a newly added
+     * chain is a first-class wallet-connect target or display-only.
+     *
+     * Deliberately the PUBLIC endpoint, never the rpc-proxy/eRPC one: that path
+     * requires an API key, and a browser cannot hold one.
+     *
+     * Optional. A chain without one degrades to display-only, which is not an
+     * error — non-EVM chains are never built as viem chains and never carry it.
+     */
+    publicRpcUrl?: string;
     /**
      * True for virtual chains (e.g. HyperCore, chain id 1337) that are addressed
      * as a distinct destination but have no RPC / providers / contracts / gas

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@rhinestone/shared-configs",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "Reusable configuration files for Rhinestone services",
   "author": {
     "name": "Rhinestone",