@rhinestone/shared-configs 1.4.132 → 1.4.133

package/dist/scripts/__tests__/fixtures/chains-base.json

@@ -0,0 +1,36 @@
+{
+    "1": {
+        "name": "Ethereum",
+        "settlementLayers": ["ACROSS", "ECO", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "decimals": 6 },
+            { "symbol": "WETH", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "100": {
+        "name": "Gnosis",
+        "settlementLayers": ["RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "xDAI" },
+        "wrappedNativeToken": { "address": "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", "decimals": 18, "symbol": "WXDAI" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "10": {
+        "name": "OP Mainnet",
+        "settlementLayers": ["ACROSS", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    }
+}

package/dist/scripts/__tests__/fixtures/chains-pr-add-chain.json

@@ -0,0 +1,47 @@
+{
+    "1": {
+        "name": "Ethereum",
+        "settlementLayers": ["ACROSS", "ECO", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "decimals": 6 },
+            { "symbol": "WETH", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "100": {
+        "name": "Gnosis",
+        "settlementLayers": ["RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "xDAI" },
+        "wrappedNativeToken": { "address": "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", "decimals": 18, "symbol": "WXDAI" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "10": {
+        "name": "OP Mainnet",
+        "settlementLayers": ["ACROSS", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "42161": {
+        "name": "Arbitrum One",
+        "settlementLayers": ["ACROSS", "ECO", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    }
+}

package/dist/scripts/__tests__/fixtures/chains-pr-orphan.json

@@ -0,0 +1,36 @@
+{
+    "1": {
+        "name": "Ethereum",
+        "settlementLayers": ["ACROSS", "ECO", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "decimals": 6 },
+            { "symbol": "WETH", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "100": {
+        "name": "Gnosis",
+        "settlementLayers": [],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "xDAI" },
+        "wrappedNativeToken": { "address": "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", "decimals": 18, "symbol": "WXDAI" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "10": {
+        "name": "OP Mainnet",
+        "settlementLayers": ["ACROSS", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    }
+}

package/dist/scripts/__tests__/fixtures/chains-pr-remove-layer.json

@@ -0,0 +1,36 @@
+{
+    "1": {
+        "name": "Ethereum",
+        "settlementLayers": ["ACROSS", "ECO", "RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "decimals": 6 },
+            { "symbol": "WETH", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "100": {
+        "name": "Gnosis",
+        "settlementLayers": ["RELAY"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "xDAI" },
+        "wrappedNativeToken": { "address": "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", "decimals": 18, "symbol": "WXDAI" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    },
+    "10": {
+        "name": "OP Mainnet",
+        "settlementLayers": ["ACROSS"],
+        "tokens": [
+            { "symbol": "USDC", "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "decimals": 6 }
+        ],
+        "nativeToken": { "address": "0x0000000000000000000000000000000000000000", "decimals": 18, "symbol": "ETH" },
+        "wrappedNativeToken": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18, "symbol": "WETH" },
+        "swapQuoters": [],
+        "swapQuoterConfig": {}
+    }
+}

package/dist/scripts/__tests__/impact-analysis.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=impact-analysis.test.d.ts.map

package/dist/scripts/__tests__/impact-analysis.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-analysis.test.d.ts","sourceRoot":"","sources":["../../../scripts/__tests__/impact-analysis.test.ts"],"names":[],"mappings":""}

package/dist/scripts/__tests__/impact-analysis.test.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const impact_analysis_1 = require("../impact-analysis");
+const chains_base_json_1 = __importDefault(require("./fixtures/chains-base.json"));
+const chains_pr_remove_layer_json_1 = __importDefault(require("./fixtures/chains-pr-remove-layer.json"));
+const chains_pr_add_chain_json_1 = __importDefault(require("./fixtures/chains-pr-add-chain.json"));
+const chains_pr_orphan_json_1 = __importDefault(require("./fixtures/chains-pr-orphan.json"));
+(0, bun_test_1.describe)("analyzeImpact", () => {
+    (0, bun_test_1.it)("detects no changes when configs are identical", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_base_json_1.default);
+        (0, bun_test_1.expect)(analysis.hasChanges).toBe(false);
+        (0, bun_test_1.expect)(analysis.chainChanges).toHaveLength(0);
+    });
+    (0, bun_test_1.it)("detects added chain", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_add_chain_json_1.default);
+        (0, bun_test_1.expect)(analysis.hasChanges).toBe(true);
+        const added = analysis.chainChanges.filter((c) => c.type === "added");
+        (0, bun_test_1.expect)(added).toHaveLength(1);
+        (0, bun_test_1.expect)(added[0].chainName).toBe("Arbitrum One");
+        (0, bun_test_1.expect)(added[0].layersAfter).toEqual(["ACROSS", "ECO", "RELAY"]);
+    });
+    (0, bun_test_1.it)("detects removed settlement layer", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_remove_layer_json_1.default);
+        (0, bun_test_1.expect)(analysis.hasChanges).toBe(true);
+        const modified = analysis.chainChanges.filter((c) => c.type === "modified");
+        (0, bun_test_1.expect)(modified).toHaveLength(1);
+        (0, bun_test_1.expect)(modified[0].chainName).toBe("OP Mainnet");
+        (0, bun_test_1.expect)(modified[0].layersRemoved).toContain("RELAY");
+        (0, bun_test_1.expect)(modified[0].layersAfter).toEqual(["ACROSS"]);
+    });
+    (0, bun_test_1.it)("detects removed chain (orphan = chain with zero layers effectively removed)", () => {
+        // Compare base with a config where Gnosis has no layers
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_orphan_json_1.default);
+        (0, bun_test_1.expect)(analysis.hasChanges).toBe(true);
+        const modified = analysis.chainChanges.filter((c) => c.type === "modified");
+        (0, bun_test_1.expect)(modified).toHaveLength(1);
+        (0, bun_test_1.expect)(modified[0].chainName).toBe("Gnosis");
+        (0, bun_test_1.expect)(modified[0].layersRemoved).toContain("RELAY");
+        (0, bun_test_1.expect)(modified[0].layersAfter).toEqual([]);
+    });
+    (0, bun_test_1.it)("computes layer summaries correctly", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_remove_layer_json_1.default);
+        const relaySummary = analysis.layerSummaries.find((s) => s.layer === "RELAY");
+        (0, bun_test_1.expect)(relaySummary).toBeDefined();
+        (0, bun_test_1.expect)(relaySummary.chainsBefore).toBe(3); // Ethereum, Gnosis, OP Mainnet
+        (0, bun_test_1.expect)(relaySummary.chainsAfter).toBe(2); // Ethereum, Gnosis
+        (0, bun_test_1.expect)(relaySummary.chainsRemoved).toContain("OP Mainnet");
+    });
+    (0, bun_test_1.it)("identifies fragile chains in PR config", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_remove_layer_json_1.default);
+        // Gnosis is still single-layer, and now OP Mainnet is also single-layer
+        (0, bun_test_1.expect)(analysis.fragileChains.length).toBeGreaterThanOrEqual(2);
+        const gnosis = analysis.fragileChains.find((c) => c.chainName === "Gnosis");
+        (0, bun_test_1.expect)(gnosis).toBeDefined();
+        (0, bun_test_1.expect)(gnosis.singleLayer).toBe("RELAY");
+        const op = analysis.fragileChains.find((c) => c.chainName === "OP Mainnet");
+        (0, bun_test_1.expect)(op).toBeDefined();
+        (0, bun_test_1.expect)(op.singleLayer).toBe("ACROSS");
+    });
+});
+(0, bun_test_1.describe)("renderMarkdown", () => {
+    (0, bun_test_1.it)("renders 'no changes' message when nothing changed", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_base_json_1.default);
+        const md = (0, impact_analysis_1.renderMarkdown)(analysis);
+        (0, bun_test_1.expect)(md).toContain("No config changes detected");
+    });
+    (0, bun_test_1.it)("renders chain changes table for modifications", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_remove_layer_json_1.default);
+        const md = (0, impact_analysis_1.renderMarkdown)(analysis);
+        (0, bun_test_1.expect)(md).toContain("Chain Changes");
+        (0, bun_test_1.expect)(md).toContain("OP Mainnet");
+        (0, bun_test_1.expect)(md).toContain("Settlement Layer Impact");
+    });
+    (0, bun_test_1.it)("renders fragile chains section", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_remove_layer_json_1.default);
+        const md = (0, impact_analysis_1.renderMarkdown)(analysis);
+        (0, bun_test_1.expect)(md).toContain("Fragile Chains");
+        (0, bun_test_1.expect)(md).toContain("Gnosis");
+        (0, bun_test_1.expect)(md).toContain("RELAY only");
+    });
+    (0, bun_test_1.it)("renders added chain", () => {
+        const analysis = (0, impact_analysis_1.analyzeImpact)(chains_base_json_1.default, chains_pr_add_chain_json_1.default);
+        const md = (0, impact_analysis_1.renderMarkdown)(analysis);
+        (0, bun_test_1.expect)(md).toContain("Arbitrum One");
+        (0, bun_test_1.expect)(md).toContain("added");
+    });
+});

package/dist/scripts/__tests__/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../scripts/__tests__/validation.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const validation_1 = require("../validation");
+(0, bun_test_1.describe)("validateChainConfig", () => {
+    (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);
+        (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: [] },
+        };
+        const result = (0, validation_1.validateChainConfig)(chains);
+        (0, bun_test_1.expect)(result.issues).toHaveLength(1);
+        (0, bun_test_1.expect)(result.issues[0].severity).toBe("error");
+        (0, bun_test_1.expect)(result.issues[0].chainId).toBe("100");
+        (0, bun_test_1.expect)(result.issues[0].message).toContain("no settlement layers");
+        (0, bun_test_1.expect)(result.hasErrors).toBe(true);
+    });
+    (0, bun_test_1.it)("returns warning for chain with single settlement layer", () => {
+        const chains = {
+            "100": { name: "Gnosis", settlementLayers: ["RELAY"], tokens: [] },
+        };
+        const result = (0, validation_1.validateChainConfig)(chains);
+        (0, bun_test_1.expect)(result.issues).toHaveLength(1);
+        (0, bun_test_1.expect)(result.issues[0].severity).toBe("warning");
+        (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)("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: [] },
+        };
+        const result = (0, validation_1.validateChainConfig)(chains);
+        (0, bun_test_1.expect)(result.issues).toHaveLength(2);
+        (0, bun_test_1.expect)(result.hasErrors).toBe(true);
+        const errors = result.issues.filter((i) => i.severity === "error");
+        const warnings = result.issues.filter((i) => i.severity === "warning");
+        (0, bun_test_1.expect)(errors).toHaveLength(1);
+        (0, bun_test_1.expect)(warnings).toHaveLength(1);
+        (0, bun_test_1.expect)(errors[0].chainId).toBe("999");
+        (0, bun_test_1.expect)(warnings[0].chainId).toBe("100");
+    });
+    (0, bun_test_1.it)("returns no issues for empty chain registry", () => {
+        const result = (0, validation_1.validateChainConfig)({});
+        (0, bun_test_1.expect)(result.issues).toHaveLength(0);
+        (0, bun_test_1.expect)(result.hasErrors).toBe(false);
+    });
+});
+(0, bun_test_1.describe)("formatValidationIssues", () => {
+    (0, bun_test_1.it)("returns empty string for no issues", () => {
+        (0, bun_test_1.expect)((0, validation_1.formatValidationIssues)({ issues: [], hasErrors: false })).toBe("");
+    });
+    (0, bun_test_1.it)("formats errors with cross mark", () => {
+        const result = {
+            issues: [
+                {
+                    severity: "error",
+                    chainId: "100",
+                    chainName: "Gnosis",
+                    message: "no settlement layers",
+                },
+            ],
+            hasErrors: true,
+        };
+        const output = (0, validation_1.formatValidationIssues)(result);
+        (0, bun_test_1.expect)(output).toContain("\u2717");
+        (0, bun_test_1.expect)(output).toContain("Gnosis (100)");
+    });
+    (0, bun_test_1.it)("formats warnings with warning sign", () => {
+        const result = {
+            issues: [
+                {
+                    severity: "warning",
+                    chainId: "100",
+                    chainName: "Gnosis",
+                    message: "single settlement layer [RELAY]",
+                },
+            ],
+            hasErrors: false,
+        };
+        const output = (0, validation_1.formatValidationIssues)(result);
+        (0, bun_test_1.expect)(output).toContain("\u26A0");
+        (0, bun_test_1.expect)(output).toContain("Gnosis (100)");
+    });
+});

package/dist/scripts/generate.js

@@ -8,6 +8,7 @@ const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
+const validation_1 = require("./validation");
 function renderNetworkEnum(name, entries) {
     const lines = entries.map((entry) => `  ${entry.enumKey} = ${entry.viemChain}.id,`);
     return `enum ${name} {\n${lines.join("\n")}\n}\n`;
@@ -338,6 +339,17 @@ async function generate() {
     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`);
+    // Validate chain configuration
+    const validationResult = (0, validation_1.validateChainConfig)(output.chains);
+    const validationOutput = (0, validation_1.formatValidationIssues)(validationResult);
+    if (validationOutput) {
+        console.log('\nChain config validation:');
+        console.log(validationOutput);
+        console.log('');
+    }
+    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(generatedDir, "networks.ts"), `${renderNetworks(output.networks)}\n`);
     const prodAddrConfig = runOrchestratorFile(yeetRoot, "prod", output.chainNames);

package/dist/scripts/impact-analysis.d.ts

@@ -0,0 +1,31 @@
+import type { ChainRegistry } from "./validation";
+export interface ChainChange {
+    chainId: string;
+    chainName: string;
+    type: 'added' | 'removed' | 'modified';
+    layersBefore: string[];
+    layersAfter: string[];
+    layersAdded: string[];
+    layersRemoved: string[];
+}
+export interface LayerSummary {
+    layer: string;
+    chainsBefore: number;
+    chainsAfter: number;
+    chainsRemoved: string[];
+    chainsAdded: string[];
+}
+export interface FragileChain {
+    chainId: string;
+    chainName: string;
+    singleLayer: string;
+}
+export interface ImpactAnalysis {
+    chainChanges: ChainChange[];
+    layerSummaries: LayerSummary[];
+    fragileChains: FragileChain[];
+    hasChanges: boolean;
+}
+export declare function analyzeImpact(base: ChainRegistry, pr: ChainRegistry): ImpactAnalysis;
+export declare function renderMarkdown(analysis: ImpactAnalysis): string;
+//# sourceMappingURL=impact-analysis.d.ts.map

package/dist/scripts/impact-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-analysis.d.ts","sourceRoot":"","sources":["../../scripts/impact-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,cAAc,CAiHpF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAyF/D"}

package/dist/scripts/impact-analysis.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeImpact = analyzeImpact;
+exports.renderMarkdown = renderMarkdown;
+function analyzeImpact(base, pr) {
+    const chainChanges = [];
+    const allChainIds = new Set([...Object.keys(base), ...Object.keys(pr)]);
+    for (const chainId of allChainIds) {
+        const baseChain = base[chainId];
+        const prChain = pr[chainId];
+        if (!baseChain && prChain) {
+            chainChanges.push({
+                chainId,
+                chainName: prChain.name,
+                type: 'added',
+                layersBefore: [],
+                layersAfter: [...prChain.settlementLayers],
+                layersAdded: [...prChain.settlementLayers],
+                layersRemoved: [],
+            });
+        }
+        else if (baseChain && !prChain) {
+            chainChanges.push({
+                chainId,
+                chainName: baseChain.name,
+                type: 'removed',
+                layersBefore: [...baseChain.settlementLayers],
+                layersAfter: [],
+                layersAdded: [],
+                layersRemoved: [...baseChain.settlementLayers],
+            });
+        }
+        else if (baseChain && prChain) {
+            const baseLayers = [...baseChain.settlementLayers].sort();
+            const prLayers = [...prChain.settlementLayers].sort();
+            if (baseLayers.join(',') !== prLayers.join(',')) {
+                const layersAdded = prChain.settlementLayers.filter((l) => !baseChain.settlementLayers.includes(l));
+                const layersRemoved = baseChain.settlementLayers.filter((l) => !prChain.settlementLayers.includes(l));
+                chainChanges.push({
+                    chainId,
+                    chainName: prChain.name,
+                    type: 'modified',
+                    layersBefore: [...baseChain.settlementLayers],
+                    layersAfter: [...prChain.settlementLayers],
+                    layersAdded,
+                    layersRemoved,
+                });
+            }
+        }
+    }
+    // Compute per-layer summaries
+    const allLayers = new Set();
+    for (const chain of Object.values(base)) {
+        for (const layer of chain.settlementLayers) {
+            allLayers.add(layer);
+        }
+    }
+    for (const chain of Object.values(pr)) {
+        for (const layer of chain.settlementLayers) {
+            allLayers.add(layer);
+        }
+    }
+    const layerSummaries = [];
+    for (const layer of [...allLayers].sort()) {
+        const baseChainsWithLayer = [];
+        for (const chain of Object.values(base)) {
+            if (chain.settlementLayers.includes(layer)) {
+                baseChainsWithLayer.push(chain.name);
+            }
+        }
+        const prChainsWithLayer = [];
+        for (const chain of Object.values(pr)) {
+            if (chain.settlementLayers.includes(layer)) {
+                prChainsWithLayer.push(chain.name);
+            }
+        }
+        const chainsAdded = prChainsWithLayer.filter((name) => !baseChainsWithLayer.includes(name));
+        const chainsRemoved = baseChainsWithLayer.filter((name) => !prChainsWithLayer.includes(name));
+        layerSummaries.push({
+            layer,
+            chainsBefore: baseChainsWithLayer.length,
+            chainsAfter: prChainsWithLayer.length,
+            chainsAdded,
+            chainsRemoved,
+        });
+    }
+    // Identify fragile chains in PR config
+    const fragileChains = [];
+    for (const [chainId, chain] of Object.entries(pr)) {
+        if (chain.settlementLayers.length === 1) {
+            fragileChains.push({
+                chainId,
+                chainName: chain.name,
+                singleLayer: chain.settlementLayers[0],
+            });
+        }
+    }
+    return {
+        chainChanges,
+        layerSummaries,
+        fragileChains,
+        hasChanges: chainChanges.length > 0,
+    };
+}
+function renderMarkdown(analysis) {
+    if (!analysis.hasChanges) {
+        return '## Config Impact Analysis\n\nNo config changes detected.';
+    }
+    const sections = ['## Config Impact Analysis'];
+    // Chain Changes table
+    if (analysis.chainChanges.length > 0) {
+        const lines = [
+            '',
+            '### Chain Changes',
+            '',
+            '| Chain | Type | Settlement Layers | Change |',
+            '|-------|------|-------------------|--------|',
+        ];
+        for (const change of analysis.chainChanges) {
+            const icon = change.type === 'added' ? '\u{1F7E2}' : change.type === 'removed' ? '\u{1F534}' : '\u{1F7E1}';
+            const typeLabel = `${icon} ${change.type}`;
+            let layers;
+            let changeDetail;
+            if (change.type === 'added') {
+                layers = change.layersAfter.join(', ');
+                changeDetail = `Added with ${change.layersAfter.join(', ')}`;
+            }
+            else if (change.type === 'removed') {
+                layers = `~~${change.layersBefore.join(', ')}~~`;
+                changeDetail = `Removed (was ${change.layersBefore.join(', ')})`;
+            }
+            else {
+                layers = `${change.layersBefore.join(', ')} \u2192 ${change.layersAfter.join(', ')}`;
+                const parts = [];
+                if (change.layersAdded.length > 0) {
+                    parts.push(`+${change.layersAdded.join(', ')}`);
+                }
+                if (change.layersRemoved.length > 0) {
+                    parts.push(`-${change.layersRemoved.join(', ')}`);
+                }
+                changeDetail = parts.join(', ');
+            }
+            lines.push(`| ${change.chainName} (${change.chainId}) | ${typeLabel} | ${layers} | ${changeDetail} |`);
+        }
+        sections.push(lines.join('\n'));
+    }
+    // Settlement Layer Impact table
+    const layersWithChanges = analysis.layerSummaries.filter((s) => s.chainsAdded.length > 0 || s.chainsRemoved.length > 0);
+    if (layersWithChanges.length > 0) {
+        const lines = [
+            '',
+            '### Settlement Layer Impact',
+            '',
+            '| Layer | Chains Before | Chains After | Added | Removed |',
+            '|-------|---------------|--------------|-------|---------|',
+        ];
+        for (const summary of layersWithChanges) {
+            const added = summary.chainsAdded.length > 0 ? summary.chainsAdded.join(', ') : '-';
+            const removed = summary.chainsRemoved.length > 0 ? summary.chainsRemoved.join(', ') : '-';
+            lines.push(`| ${summary.layer} | ${summary.chainsBefore} | ${summary.chainsAfter} | ${added} | ${removed} |`);
+        }
+        sections.push(lines.join('\n'));
+    }
+    // Fragile Chains section
+    if (analysis.fragileChains.length > 0) {
+        const lines = [
+            '',
+            '### Fragile Chains',
+            '',
+            'These chains have only a single settlement layer:',
+            '',
+        ];
+        for (const chain of analysis.fragileChains) {
+            lines.push(`- **${chain.chainName} (${chain.chainId})**: ${chain.singleLayer} only`);
+        }
+        sections.push(lines.join('\n'));
+    }
+    return sections.join('\n');
+}
+// CLI entry point — runs when invoked directly via `bun run scripts/impact-analysis.ts`
+const cliArgs = process.argv.slice(2);
+if (cliArgs.length >= 2) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const fs = require("fs");
+    const base = JSON.parse(fs.readFileSync(cliArgs[0], 'utf8'));
+    const pr = JSON.parse(fs.readFileSync(cliArgs[1], 'utf8'));
+    const analysis = analyzeImpact(base, pr);
+    console.log(renderMarkdown(analysis));
+}

package/dist/scripts/validation.d.ts

@@ -0,0 +1,38 @@
+export type SettlementLayer = 'ACROSS' | 'ECO' | 'RELAY' | 'OFT';
+export interface ChainData {
+    name: string;
+    settlementLayers: SettlementLayer[];
+    tokens: Array<{
+        symbol: string;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+}
+export type ChainRegistry = Record<string, ChainData>;
+export type ValidationSeverity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    chainId: string;
+    chainName: string;
+    message: string;
+}
+export interface ValidationResult {
+    issues: ValidationIssue[];
+    hasErrors: boolean;
+}
+/**
+ * Validates a chain registry for configuration problems.
+ *
+ * Checks performed:
+ * - Orphaned chains: chains with no settlement layers (error)
+ * - Single-layer fragility: chains with exactly one settlement layer (warning)
+ */
+export declare function validateChainConfig(chains: ChainRegistry): ValidationResult;
+/**
+ * Formats validation issues for console output.
+ *
+ * Errors are prefixed with a cross mark, warnings with a warning sign.
+ * Returns an empty string when there are no issues.
+ */
+export declare function formatValidationIssues(result: ValidationResult): string;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../scripts/validation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;AAEjE,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,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,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;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CA4B3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAWvE"}

package/dist/scripts/validation.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateChainConfig = validateChainConfig;
+exports.formatValidationIssues = formatValidationIssues;
+/**
+ * Validates a chain registry for configuration problems.
+ *
+ * Checks performed:
+ * - Orphaned chains: chains with no settlement layers (error)
+ * - Single-layer fragility: chains with exactly one settlement layer (warning)
+ */
+function validateChainConfig(chains) {
+    const issues = [];
+    for (const [chainId, chain] of Object.entries(chains)) {
+        const layers = chain.settlementLayers;
+        if (layers.length === 0) {
+            issues.push({
+                severity: 'error',
+                chainId,
+                chainName: chain.name,
+                message: 'no settlement layers \u2014 chain is unreachable',
+            });
+        }
+        else if (layers.length === 1) {
+            const layer = layers[0];
+            issues.push({
+                severity: 'warning',
+                chainId,
+                chainName: chain.name,
+                message: `single settlement layer [${layer}] \u2014 disabling ${layer} removes this chain entirely`,
+            });
+        }
+    }
+    return {
+        issues,
+        hasErrors: issues.some((issue) => issue.severity === 'error'),
+    };
+}
+/**
+ * Formats validation issues for console output.
+ *
+ * Errors are prefixed with a cross mark, warnings with a warning sign.
+ * Returns an empty string when there are no issues.
+ */
+function formatValidationIssues(result) {
+    if (result.issues.length === 0) {
+        return '';
+    }
+    return result.issues
+        .map((issue) => {
+        const prefix = issue.severity === 'error' ? '\u2717' : '\u26A0';
+        return `${prefix} ${issue.chainName} (${issue.chainId}): ${issue.message}`;
+    })
+        .join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhinestone/shared-configs",
-  "version": "1.4.132",
+  "version": "1.4.133",
   "description": "Reusable configuration files for Rhinestone services",
   "author": {
     "name": "Rhinestone",
@@ -23,6 +23,7 @@
     "generate:abis:extract": "bun run scripts/generate-abis.ts --extract",
     "sync:abis": "bun run scripts/sync-abis.ts",
     "compile": "tsc",
+    "test": "bun test",
     "build": "bun run clean && bun run generate && bun run sync:abis --generate && bun run compile",
     "changeset:release": "bun run build && changeset publish"
   },