@raac/rpc 1.2.0-beta.1 → 1.2.0-beta.10

package/dist/configs/chains/11155111.json

@@ -1,7 +1,7 @@
 {
     "chainId": 11155111,
     "name": "sepolia",
-    "rpcs": ["https://eth-sepolia.g.alchemy.com/v2/GRu4-s8cjabOCnh-3ZFzapF-MwUcURV_"],
+    "rpcs": ["https://ethereum-sepolia-rpc.publicnode.com", "https://1rpc.io/sepolia"],
     "nativeCurrency": {
         "name": "ETH",
         "symbol": "ETH",
@@ -17,7 +17,7 @@
         "raachouseprices": {
             "id": "raachouseprices",
             "name": "RAAC House Prices",
-            "contract": "0xF122d4Dcc791c6735d937E7118087A505c81b2b3"
+            "contract": "0x96EBC781867cF33F0Fac64e44388CBF065c78e92"
         },
         "auctionfactory": {
             "id": "auctionfactory",
@@ -32,17 +32,17 @@
         "raacminter": {
             "id": "raacminter",
             "name": "RAAC Minter",
-            "contract": "0x303ADC6A0c391b19103Cd678CF0761b5c29E131E"
+            "contract": "0x46CCfE1D93a5448BC31103617D676Dab321f7401"
         },
         "feecollector": {
             "id": "feecollector",
             "name": "Fee Collector",
-            "contract": "0x297d74333c285d5F39820c268C9e9AAb788e3625"
+            "contract": "0x789f62Ee0471B369b28D4A5345Fe12a70Bd8Be3B"
         },
         "treasury": {
             "id": "treasury",
             "name": "Treasury",
-            "contract": "0x7FaE0737292cD3B7Dc9067AA30a67C42c205015c"
+            "contract": "0xFE72Afa6e52E041B036B0E28e25ffE5CA5fD6170"
         },
         "pmtreasury": {
             "id": "pmtreasury",
@@ -72,17 +72,17 @@
         "rwavault": {
             "id": "rwavault",
             "name": "RWA Vault",
-            "contract": "0x7D819769ADDbBcc7D482E7e8FcC2812De0929875"
+            "contract": "0xEC9e67e9b6ceD5e48b5Dd39915414e7BbDf952f2"
         },
         "complianceregistry": {
             "id": "complianceregistry",
             "name": "Compliance Registry",
-            "contract": "0x74E2aEcC41F096Dca69368A7D10604142C44CfF0"
+            "contract": "0x95bc6FCfB69BDbF723De06bCa1a689ad68762CC5"
         },
         "rwaindextokencollector": {
             "id": "rwaindextokencollector",
             "name": "RWA Index Token Collector",
-            "contract": "0xc4999Db2fd4A58d870F9c8D18fBe4177308e2481"
+            "contract": "0xdbEd45218e5c040Cdf696C740937997162cFb720"
         },
         "raactokencollector": {
             "id": "raactokencollector",
@@ -92,29 +92,29 @@
         "raachousepriceoracle": {
             "id": "raachousepriceoracle",
             "name": "RAAC House Price Oracle",
-            "contract": "0x6e15A7037cB6EEA74F8a5fCD20EBaa77e331093D"
+            "contract": "0x8C881051D397014E6D4ea711764E6875506d88D1"
         },
         "raacprimerateoracle": {
             "id": "raacprimerateoracle",
             "name": "RAAC Prime Rate Oracle",
-            "contract": "0x158c6c40DF3E7f9B1AdA92Ab7D4B8b437749BF6b"
+            "contract": "0x312F47A51F398C6504B31794dfCf604acF174c67"
         },
         "crvusdtousdoracle": {
             "id": "crvusdtousdoracle",
             "name": "CRVUSD to USD Oracle",
-            "contract": "0x8A2E4B94ebf21A4b9CAF52958B2B8b6099CE46cA"
+            "contract": "0x627897baf46851500F116cec76346921C3292246"
         }
     },
     "governance": {
         "gaugerewardsdistributor": {
             "id": "gaugerewardsdistributor",
             "name": "Gauge Rewards Distributor",
-            "contract": "0x7a7f847fb60b0000e24cce07298dc73df8b8e56a"
+            "contract": "0xe4E0600af62588E60B460012C65E39fD8158e4a2"
         },
         "gaugecontroller": {
             "id": "gaugecontroller",
             "name": "Gauge Controller",
-            "contract": "0x045857BDEAE7C1c7252d611eB24eB55564198b4C"
+            "contract": "0xbE8A81ab91e779da07d1E5E13e5be29B30Ad58Af"
         },
         "gauge": {
             "id": "gauge",
@@ -123,42 +123,55 @@
         },
         "raacgauge": {
             "id": "raacgauge",
-            "name": "RAAC Gauge",
-            "contract": "0xB6B18cae509Fcf3542FF6975C2Da06CAAc9773c5"
+            "name": "RAAC Gauge (alias: primary crvUSD/RAAC LP gauge)",
+            "contract": "0x04F3e12A814b21B9F947c726be512719a41b980f"
         },
         "rwagauge": {
             "id": "rwagauge",
             "name": "RWA Gauge",
             "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "governance": {
-            "id": "governance",
-            "name": "Governance",
-            "contract": "0x922303763a4fE3A51bfB8aC5c16451d8803a7bFc"
-        },
-        "timelockcontroller": {
-            "id": "timelockcontroller",
-            "name": "Timelock Controller",
-            "contract": "0x3dbcac9385d582881812DdcD90a46480f58bA325"
         }
     },
+    "proposals": [
+        {
+            "id": "default",
+            "label": "default",
+            "governance": "0x3b5A1aEa6FFdF9e2a7eCad2F7cB7a2f20324Bc6b",
+            "timelock": "0x88CeA6036f003D6307A334bA472cD84342023532"
+        }
+    ],
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",
             "name": "Stability Pool",
-            "contract": "0xF88967cbdEf88063b4c4d0F4F5E93b429C39689A"
+            "contract": "0x647dE5B6Db7f4a3e0E1f4D9DB478B86b7B430248"
         },
         "lendingpool": {
             "id": "lendingpool",
             "name": "Lending Pool",
-            "contract": "0x90d4e68C41333053248784e570C998EC915d5161"
+            "contract": "0xd8cd0194c1Dc3287f2666ECEB45A1Ac3450dD38a"
+        },
+        "crvusdraacpool": {
+            "id": "crvusdraacpool",
+            "name": "Curve pmUSD/RAAC twocrypto-ng Pool",
+            "contract": "0xAe98A7EF8557491fD34b45036Aada075c9385c6C"
+        },
+        "pmusdireetpool": {
+            "id": "pmusdireetpool",
+            "name": "pmUSD/iREET Mock Pool",
+            "contract": "0x4b9b6D1468846B00dB898698a13E11f2C2347EC1"
         }
     },
     "nfts": {
         "raacnft": {
             "id": "raacnft",
             "name": "RAAC NFT",
-            "contract": "0xbac60A20C0B932b65E18F636C94e9f4b41F3A426"
+            "contract": "0xb16453caAFF3c75e9D090793dD60C46668c1de52"
+        },
+        "raacbotnft": {
+            "id": "raacbotnft",
+            "name": "RAAC Bot NFT (mock)",
+            "contract": "0xef6F57a37D2Ff59371716F673Eaf43e940CC4fc8"
         }
     },
     "assets": {
@@ -182,45 +195,51 @@
         },
         "crvusd": {
             "id": "crvusd",
-            "name": "CRVUSD",
+            "name": "pmUSD",
             "decimals": 18,
-            "contract": "0xf939e0a03fb07f59a73314e73794be0e57ac1b4e"
+            "contract": "0x970697EF41A89f7448BC658B5308dcADaC2a663c"
         },
         "rtoken": {
             "id": "rtoken",
             "name": "RToken",
             "decimals": 18,
-            "contract": "0xeb957D30f3F3c3534D3Dcd0828C7747602803B7A"
+            "contract": "0x6F713079002a0a485E91fB276E4682CB01d18439"
         },
         "detoken": {
             "id": "detoken",
             "name": "DEToken",
             "decimals": 18,
-            "contract": "0x229495b726Bdc55917DBE89674306D3F3Daa5aE5"
+            "contract": "0x7099e48A96eEeCd93c9a1bBA535d8715826df70e"
         },
         "raactoken": {
             "id": "raactoken",
             "name": "RAAC",
             "decimals": 18,
-            "contract": "0xDc91D5409a665a2f454C9AB26a18646837Fd9772"
+            "contract": "0x6F858708bDBB1551aA910e5a7AdE27467EAf6Bc6"
         },
         "veraac": {
             "id": "veraac",
             "name": "VERAAC",
             "decimals": 18,
-            "contract": "0xF49A5C2f5468c2d43188B2B64C6c2d7f13897DE4"
+            "contract": "0xE01eCF9FDF78D7F675a73E09633726BfcF2dfd56"
+        },
+        "leraac": {
+            "id": "leraac",
+            "name": "Liquid Escrowed RAAC",
+            "decimals": 18,
+            "contract": "0x50f4ad0db57474480E87D49E3993B7e9653c9ff0"
         },
         "debttoken": {
             "id": "debttoken",
             "name": "Debt Token",
             "decimals": 18,
-            "contract": "0xd4bE0b77c07C58fc5cAea5629587f54572090F88"
+            "contract": "0x90f1f1431c46F851c54DD9518a28e4C20AB0aC4c"
         },
         "rwaindextoken": {
             "id": "rwaindextoken",
             "name": "RWA Index Token",
             "decimals": 18,
-            "contract": "0xa96a1578dCBd8bca443142567C19d61DF1513937"
+            "contract": "0x1c1789629B2511821aC78618eBd23d41E7b04989"
         }
     },
     "adapters": {
@@ -228,13 +247,13 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
-                "contract": "0xd8Cb90b0A5b288F5f0c9a519Ae4B1B47D5E69353",
+                "contract": "0x608aD2608DAdDb633ceBe22d6Fcb7C9e660FfA65",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
-                "contract": "0x216433c8408A349B4b7342d60F948d89317E3366",
+                "contract": "0x075c96D803E64f25bA28C7a765F3911BBf773B56",
                 "type": "ERC20"
             }
         },
@@ -242,7 +261,7 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
-                "contract": "0x5b10F4F746f10632e4Bb832A2e93bd5543830D7d",
+                "contract": "0x531F5d54Fda86f103E297ECE796c8B799B835E0c",
                 "type": "ERC721"
             },
             "crvusdadapter": {
@@ -252,5 +271,75 @@
                 "type": "ERC20"
             }
         }
+    },
+    "lockers": {
+        "raacliquidlocker": {
+            "id": "raacliquidlocker",
+            "name": "RAAC Liquid Locker",
+            "contract": "0xf0F8d028bB7590889f7d183e1eB95a3e71715fE6"
+        },
+        "raacmaturityvault": {
+            "id": "raacmaturityvault",
+            "name": "RAAC Maturity Vault",
+            "contract": "0xCD069A826E8001D8FA1Bb26eed83ad4aE6b63651"
+        },
+        "raacbotlocker": {
+            "id": "raacbotlocker",
+            "name": "RAAC Bot Locker",
+            "contract": "0xF7F7e841bc123f6e11aE5144852c43882289AdBD"
+        }
+    },
+    "zap": {
+        "aladdinzap": {
+            "id": "aladdinzap",
+            "name": "Aladdin Zap",
+            "contract": "0x3b1325d1D220f2b78d4EFF8786654572193112d1"
+        }
+    },
+    "gauges": {
+        "raac_pmusd": {
+            "id": "RAAC_pmUSD",
+            "name": "RAAC pmUSD Gauge",
+            "type": "RAACGauge",
+            "contract": "0xc6471c956a6f77Af1D35Ea639a46544eE9340838",
+            "stakingToken": "0x0bd4E860e5e7A0C7c9d221Fa336976bF001F81fa",
+            "wrapped": true,
+            "underlying": "0x6F713079002a0a485E91fB276E4682CB01d18439",
+            "wrapper": "0x0bd4E860e5e7A0C7c9d221Fa336976bF001F81fa"
+        },
+        "raac_pmusd_lp": {
+            "id": "RAAC_pmUSD_LP",
+            "name": "RAAC pmUSD/RAAC LP Gauge",
+            "type": "RAACGauge",
+            "contract": "0xac6A07DEbbc683042478987f7BceEdb934161311",
+            "stakingToken": "0xAe98A7EF8557491fD34b45036Aada075c9385c6C"
+        },
+        "raac_rcrvusd": {
+            "id": "RAAC_RcrvUSD",
+            "name": "RAAC RcrvUSD Gauge (deprecated)",
+            "type": "RAACGauge",
+            "contract": "0xc6e49678e7a7D797Cb11EE5D2834A3896200096D",
+            "stakingToken": "0xa610498F28448Eb379BFD3179381F6f094ad110b",
+            "wrapped": true,
+            "underlying": "0x062a641EF54810B321f123487fFf083cadB50989",
+            "wrapper": "0xa610498F28448Eb379BFD3179381F6f094ad110b",
+            "_note": "Deprecated — being removed from the controller (replaced by raac_pmusd). Reclaim stuck votes via removePowerFromGauge."
+        },
+        "raac_crvusd_lp": {
+            "id": "RAAC_crvUSD_LP",
+            "name": "RAAC crvUSD/RAAC LP Gauge (deprecated)",
+            "type": "RAACGauge",
+            "contract": "0x04F3e12A814b21B9F947c726be512719a41b980f",
+            "stakingToken": "0xCfDBbad91770fb7Fd57e623A59dcbD14670164c7",
+            "_note": "Deprecated — being removed from the controller (replaced by raac_pmusd_lp). Reclaim stuck votes via removePowerFromGauge."
+        },
+        "raac_rcrvusd_old": {
+            "id": "RAAC_RcrvUSD_old",
+            "name": "RAAC RcrvUSD Gauge (raw rebasing, removed)",
+            "type": "RAACGauge",
+            "contract": "0xE8eBe8294542d47f481c17036C8165CB8935554a",
+            "stakingToken": "0x062a641EF54810B321f123487fFf083cadB50989",
+            "_note": "Already removed from controller. Reclaim stuck votes via removePowerFromGauge."
+        }
     }
 }

package/dist/configs/chains/17000.json

@@ -135,18 +135,9 @@
             "id": "rwagauge",
             "name": "RWA Gauge",
             "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "governance": {
-            "id": "governance",
-            "name": "Governance",
-            "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "timelockcontroller": {
-            "id": "timelockcontroller",
-            "name": "Timelock Controller",
-            "contract": "0x0000000000000000000000000000000000000000"
         }
     },
+    "proposals": [],
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",

package/dist/configs/chains/18453.json

@@ -135,18 +135,9 @@
             "id": "rwagauge",
             "name": "RWA Gauge",
             "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "governance": {
-            "id": "governance",
-            "name": "Governance",
-            "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "timelockcontroller": {
-            "id": "timelockcontroller",
-            "name": "Timelock Controller",
-            "contract": "0x0000000000000000000000000000000000000000"
         }
     },
+    "proposals": [],
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",

package/dist/configs/chains/8453.json

@@ -1,7 +1,9 @@
 {
     "chainId": 8453,
     "name": "localhost",
-    "rpcs": ["http://127.0.0.1:8545"],
+    "rpcs": [
+        "http://127.0.0.1:8545"
+    ],
     "nativeCurrency": {
         "name": "ETH",
         "symbol": "ETH",
@@ -109,12 +111,12 @@
         "gaugerewardsdistributor": {
             "id": "gaugerewardsdistributor",
             "name": "Gauge Rewards Distributor",
-            "contract": "0x610178dA211FEF7D417bC0e6FeD39F05609AD788"
+            "contract": "0xB06c856C8eaBd1d8321b687E188204C1018BC4E5"
         },
         "gaugecontroller": {
             "id": "gaugecontroller",
             "name": "Gauge Controller",
-            "contract": "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318"
+            "contract": "0xddE78e6202518FF4936b5302cC2891ec180E8bFf"
         },
         "gauge": {
             "id": "gauge",
@@ -124,24 +126,28 @@
         "raacgauge": {
             "id": "raacgauge",
             "name": "RAAC Gauge",
-            "contract": "0xB6B18cae509Fcf3542FF6975C2Da06CAAc9773c5"
+            "contract": "0xaB7B4c595d3cE8C85e16DA86630f2fc223B05057"
         },
         "rwagauge": {
             "id": "rwagauge",
             "name": "RWA Gauge",
-            "contract": "0x0000000000000000000000000000000000000000"
-        },
-        "governance": {
-            "id": "governance",
-            "name": "Governance",
-            "contract": "0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6"
-        },
-        "timelockcontroller": {
-            "id": "timelockcontroller",
-            "name": "Timelock Controller",
-            "contract": "0xa513E6E4b8f2a923D98304ec87F64353C4D5C853"
+            "contract": "0xAD523115cd35a8d4E60B3C0953E0E0ac10418309"
         }
     },
+    "proposals": [
+        {
+            "id": "a",
+            "label": "Pair A: Protocol Parameters",
+            "governance": "0xf7Cd8fa9b94DB2Aa972023b379c7f72c65E4De9D",
+            "timelock": "0xeD1DB453C3156Ff3155a97AD217b3087D5Dc5f6E"
+        },
+        {
+            "id": "b",
+            "label": "Pair B: Gauge Management",
+            "governance": "0x33b1B5Aa9Aa4Da83a332F0bC5cAC6A903FDE5d92",
+            "timelock": "0x5B3120d0dA5FDcBA7aef87A9c3c64829C1c0D76B"
+        }
+    ],
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",
@@ -184,7 +190,7 @@
             "id": "crvusd",
             "name": "CRVUSD",
             "decimals": 18,
-            "contract": "0xf939e0a03fb07f59a73314e73794be0e57ac1b4e"
+            "contract": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512"
         },
         "rtoken": {
             "id": "rtoken",
@@ -202,13 +208,13 @@
             "id": "raactoken",
             "name": "RAAC",
             "decimals": 18,
-            "contract": "0x5FbDB2315678afecb367f032d93F642f64180aa3"
+            "contract": "0x700b6A60ce7EaaEA56F065753d8dcB9653dbAD35"
         },
         "veraac": {
             "id": "veraac",
             "name": "VERAAC",
             "decimals": 18,
-            "contract": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
+            "contract": "0xe1DA8919f262Ee86f9BE05059C9280142CF23f48"
         },
         "debttoken": {
             "id": "debttoken",
@@ -239,6 +245,36 @@
             "name": "RAAC Token Collector",
             "decimals": 18,
             "contract": "0x0000000000000000000000000000000000000000"
+        },
+        "leraac": {
+            "id": "leraac",
+            "name": "Liquid Escrowed RAAC",
+            "decimals": 18,
+            "contract": "0xa513E6E4b8f2a923D98304ec87F64353C4D5C853"
+        }
+    },
+    "lockers": {
+        "raacliquidlocker": {
+            "id": "raacliquidlocker",
+            "name": "RAAC Liquid Locker",
+            "contract": "0x9A676e781A523b5d0C0e43731313A708CB607508"
+        },
+        "raacmaturityvault": {
+            "id": "raacmaturityvault",
+            "name": "RAAC Maturity Vault",
+            "contract": "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318"
+        },
+        "raacbotlocker": {
+            "id": "raacbotlocker",
+            "name": "RAAC Bot Locker",
+            "contract": "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82"
+        }
+    },
+    "zap": {
+        "aladdinzap": {
+            "id": "aladdinzap",
+            "name": "Aladdin Zap",
+            "contract": "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e"
         }
     },
     "adapters": {

package/dist/contracts/decodeCall.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeCall = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../utils/artifacts");
+const findContract_1 = require("./findContract");
+function formatValue(type, value) {
+    if (type.isArray()) {
+        return `[${value.map((item) => formatValue(type.arrayChildren, item)).join(", ")}]`;
+    }
+    if (type.isTuple()) {
+        return `(${type.components.map((component, i) => formatValue(component, value[i])).join(", ")})`;
+    }
+    if (type.baseType === "address")
+        return ethers_1.ethers.getAddress(value);
+    return String(value);
+}
+/**
+ * Decodes a call to a known contract: finds the target in the chain config,
+ * takes its ABI, and matches the calldata's selector to a function.
+ * Reads the chain config and bundled ABIs only; no RPC call is made.
+ *
+ * Arguments are returned raw, not formatted for display, so callers show
+ * exactly what the call would send.
+ *
+ * @param chainId - The chain/network to use.
+ * @param target - The address the call is sent to.
+ * @param calldata - The call's data, "0x" for a plain ETH transfer.
+ * @returns The contract, selector, signature and arguments; unknown parts are null.
+ */
+const decodeCall = (chainId, target, calldata) => {
+    const contract = (0, findContract_1.findContract)(chainId, target);
+    const data = calldata && calldata !== "0x" ? calldata : null;
+    const selector = data ? data.slice(0, 10).toLowerCase() : null;
+    if (!data || !contract?.abi) {
+        return { contract, selector, signature: null, args: [] };
+    }
+    const iface = new ethers_1.ethers.Interface((0, artifacts_1.getABI)(contract.abi));
+    let parsed = null;
+    try {
+        parsed = iface.parseTransaction({ data });
+    }
+    catch {
+        parsed = null;
+    }
+    if (!parsed) {
+        return { contract, selector, signature: null, args: [] };
+    }
+    return {
+        contract,
+        selector,
+        signature: parsed.signature,
+        args: parsed.fragment.inputs.map((input, i) => ({
+            name: input.name || `arg${i}`,
+            type: input.format("sighash"),
+            value: formatValue(input, parsed.args[i]),
+        })),
+    };
+};
+exports.decodeCall = decodeCall;
+exports.default = exports.decodeCall;

package/dist/contracts/findContract.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findContract = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const artifacts_1 = require("../utils/artifacts");
+/** Sections scanned in order; the first match wins, so specific entries (gauges) come before aliases (governance.raacgauge). */
+const FLAT_SECTIONS = ["gauges", "contracts", "governance", "pools", "lockers", "zap", "nfts", "assets"];
+const abiKey = (key) => (key in artifacts_1.ABIS ? key : null);
+const isDeployed = (address) => !!address && ethers_1.ethers.isAddress(address) && address !== ethers_1.ethers.ZeroAddress;
+/** Builds every configured contract on the chain with its name and ABI key. */
+function listContracts(chainId) {
+    const config = chains_1.default[chainId];
+    if (!config) {
+        throw new Error(`Chain configuration not found for chainId: ${chainId}`);
+    }
+    const found = [];
+    const push = (entry) => {
+        if (isDeployed(entry.address))
+            found.push({ ...entry, address: ethers_1.ethers.getAddress(entry.address) });
+    };
+    for (const section of FLAT_SECTIONS) {
+        for (const [key, value] of Object.entries((config[section] ?? {}))) {
+            const abi = section === "gauges" ? abiKey((value.type ?? "raacgauge").toLowerCase()) : abiKey(key.toLowerCase());
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section, abi });
+        }
+    }
+    // adapters: { <pool or vault>: { <adapter>: { contract, type: "ERC20" | "ERC721" } } }
+    for (const [owner, adapters] of Object.entries((config.adapters ?? {}))) {
+        for (const [key, value] of Object.entries(adapters)) {
+            const standard = (value.type ?? "").toLowerCase();
+            const kind = owner === "lendingpool" ? "assetadapter" : "vaultadapter";
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section: "adapters", abi: abiKey(`${standard}${kind}`) });
+        }
+    }
+    // proposals: [{ id, label, governance, timelock }]
+    for (const instance of (config.proposals ?? [])) {
+        push({ address: instance.governance, id: `${instance.id}.governance`, name: `${instance.label} Governance`, section: "proposals", abi: "governance" });
+        push({ address: instance.timelock, id: `${instance.id}.timelock`, name: `${instance.label} Timelock`, section: "proposals", abi: "timelockcontroller" });
+    }
+    return found;
+}
+/**
+ * Finds a contract by address in the chain config.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - Any-case contract address.
+ * @returns The contract's config entry and ABI key, or null if the chain config does not list it.
+ */
+const findContract = (chainId, address) => {
+    if (!ethers_1.ethers.isAddress(address))
+        return null;
+    const target = ethers_1.ethers.getAddress(address);
+    return listContracts(chainId).find((c) => c.address === target) ?? null;
+};
+exports.findContract = findContract;
+exports.default = exports.findContract;

package/dist/contracts/getContractAddress.js

@@ -26,6 +26,9 @@ const getContractAddress = (chainId, contractName) => {
         "assets",
         "pools",
         "nfts",
+        "lockers",
+        "zap",
+        "gauges",
     ];
     let address = null;
     for (const key of lookupKeys) {

package/dist/contracts/governance/_helpers.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toGovernanceTxError = exports.requireAddress = void 0;
+const ethers_1 = require("ethers");
+const errorDecoder_1 = require("../../utils/errorDecoder");
+/**
+ * Validates and checksums a contract address passed by the caller.
+ *
+ * @param address - The address to validate.
+ * @param name - Contract name used in the error message.
+ * @returns The checksummed address.
+ */
+const requireAddress = (address, name) => {
+    if (!address || !ethers_1.ethers.isAddress(address)) {
+        throw new Error(`Invalid ${name} address: ${address}`);
+    }
+    return ethers_1.ethers.getAddress(address);
+};
+exports.requireAddress = requireAddress;
+/**
+ * Wraps a failed write so the message says what failed while the original
+ * error stays reachable: its code (a wallet rejection is ACTION_REJECTED), its
+ * revert data and the decoded custom error name.
+ *
+ * @param prefix - What was being attempted, e.g. "Failed to cast vote".
+ * @param error - The error ethers threw.
+ * @returns An Error carrying `code`, `data`, `errorName` and `cause`.
+ */
+const toGovernanceTxError = (prefix, error) => {
+    const data = error?.data ?? error?.error?.data ?? error?.info?.error?.data;
+    const errorName = error?.revert?.name ?? (0, errorDecoder_1.decodeErrorName)(typeof data === "string" ? data : undefined) ?? undefined;
+    const wrapped = new Error(`${(0, errorDecoder_1.attachDecodedError)(prefix, error)}: ${error?.shortMessage ?? error?.message ?? String(error)}`);
+    wrapped.code = error?.code;
+    wrapped.data = typeof data === "string" ? data : undefined;
+    wrapped.errorName = errorName;
+    wrapped.cause = error;
+    return wrapped;
+};
+exports.toGovernanceTxError = toGovernanceTxError;