@mento-protocol/config 0.1.0

package/aggregators.json

@@ -0,0 +1,120 @@
+{
+  "$comment": "Per-chain aggregator/router contract addresses → canonical name. All addresses lowercased. Verified on-chain via celoscan / monadscan (bytecode + tx history) on 2026-05-04 (cluster-7dc08ec28f299c06 expanded 2026-05-08). Adding a new aggregator: lookup canonical address in the project's docs, verify on the explorer, add here. Removing an entry retroactively re-classifies historical AggregatorDailySnapshot rows as 'unknown' — handle via re-sync.",
+  "$clusters": {
+    "$comment": "Multi-contract operators on a single deployer EOA. Naming convention: `cluster-<first-16-hex-of-deployer-EOA>` (16 hex chars = 64 bits, collision-free in practice for the foreseeable cluster count). Tag each contract in the per-chain block below with the same `name: cluster-...`. The cluster label is purely a fact about on-chain deploy provenance — no inference about the operator's identity (MEV / MM / arb / etc.) — added so the volume UI can group volume by operator and link to the deployer for follow-up research. The `chainId` field on each cluster entry is informational (where the contracts have been observed); it does NOT constrain placement and a cross-chain deployer would extend the cluster's contract list across multiple per-chain blocks. Adding a cluster: 1) confirm two or more in-our-data contracts share a deployer EOA via celoscan, 2) add the cluster entry here, 3) tag each contract address with the cluster name in the per-chain block.",
+    "cluster-7dc08ec28f299c06": {
+      "chainId": 42220,
+      "deployer": "0x7dc08ec28f299c062d2941de1f9cfb741df8f022",
+      "explorerUrl": "https://celoscan.io/address/0x7dc08ec28f299c062d2941de1f9cfb741df8f022",
+      "$note": "Operator of a 16-contract MEV fleet on Celo, funded by Binance, deploying via CREATE3 factory 0xba5ed099633d3b313e4d5f7bdc1305d3c28ba5ed. The fleet is code iteration (one fresh build per contract, unique bytecode hash per address, runtime sizes 18–26 KB) — NOT a defensive rotation. A major refactor on 2026-03-29 took success rates from ~37% to >99.7% on Mento legs. Worth re-checking quarterly for new contracts deployed by the operator EOA."
+    }
+  },
+  "42220": {
+    "0xbe729350f8cdfc19db6866e8579841188ee57f67": {
+      "name": "mento-router-v2",
+      "source": "https://celoscan.io/address/0xBE729350F8CdFC19DB6866e8579841188eE57f67",
+      "$note": "Original verified MentoRouter on Celo (deployed 2024-05-29). Not in @mento-protocol/contracts — that package only ships the active deployment (Routerv300 at 0x4861840…). Lives here because we still see traffic via this address from the legacy Mento UI / older SDK builds; without this entry it'd land in the v2 volume table's `unknown` bucket."
+    },
+    "0xce16f69375520ab01377ce7b88f5ba8c48f8d666": {
+      "name": "squid",
+      "source": "https://docs.squidrouter.com/additional-resources/contracts"
+    },
+    "0x1231deb6f5749ef6ce6943a275a1d3e7486f4eae": {
+      "name": "lifi",
+      "source": "https://li.quest/v1/chains?chainTypes=EVM"
+    },
+    "0xdef1c0ded9bec7f1a1670819833240f027b25eff": {
+      "name": "0x",
+      "source": "https://github.com/0xProject/protocol/blob/main/packages/contract-addresses/addresses.json"
+    },
+    "0x6352a56caadc4f1e25cd6c75970fa768a3304e64": {
+      "name": "openocean",
+      "source": "https://apis.openocean.finance/developer/apis/supported-chains"
+    },
+    "0xdec876911cbe9428265af0d12132c52ee8642a99": {
+      "name": "openocean",
+      "source": "https://apis.openocean.finance/developer/apis/supported-chains",
+      "$note": "Per-leg executor that the Exchange Proxy at 0x6352a56c…04E64 delegates to. Same deterministic CREATE2 address on 9+ chains (Arbitrum, Avalanche, Base, BSC, Ethereum, Flare, HyperEVM, Optimism, Polygon — Arkham-attested as the OpenOcean entity on every one)."
+    },
+    "0xf184a8498f4bad5ca6ef538b72142411588792a3": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xf184a8498f4bad5ca6ef538b72142411588792a3"
+    },
+    "0xea99a75e309868a59074e9b0441c14ba62c6ea28": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xea99a75e309868a59074e9b0441c14ba62c6ea28"
+    },
+    "0x953b7173200229f255f83b6f4fa448d753b79301": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x953b7173200229f255f83b6f4fa448d753b79301"
+    },
+    "0xf023c10a9adb0553ce07d37f367630e4e84a944e": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xf023c10a9adb0553ce07d37f367630e4e84a944e"
+    },
+    "0x187c35dbbc8055b267303dd7b351e708f4c5d3bf": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x187c35dbbc8055b267303dd7b351e708f4c5d3bf"
+    },
+    "0x9bfbcd07ea9c3cdc30057d7629beb589fe2d854d": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x9bfbcd07ea9c3cdc30057d7629beb589fe2d854d"
+    },
+    "0xfe8237bcba52339d818c9c9c3c94481196e4b653": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xfe8237bcba52339d818c9c9c3c94481196e4b653"
+    },
+    "0x35f629410baffd35c482a1f77cfb0ec2f0a75c76": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x35f629410baffd35c482a1f77cfb0ec2f0a75c76"
+    },
+    "0x1bbcc3dad88fe33248a9ab6600fe72235c51d7ce": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x1bbcc3dad88fe33248a9ab6600fe72235c51d7ce"
+    },
+    "0x48d5be40f43fd70ed9329dc0e83b8c5d3a3364f4": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x48d5be40f43fd70ed9329dc0e83b8c5d3a3364f4"
+    },
+    "0x93acb2d456edeffa2e2ea97efc4fa4d17c39d4b8": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x93acb2d456edeffa2e2ea97efc4fa4d17c39d4b8"
+    },
+    "0xef6956414006e161fca5f048331d91e472077e9b": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xef6956414006e161fca5f048331d91e472077e9b"
+    },
+    "0x00d1cda22d867e2d2f22931b5567e93cc1e047cd": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x00d1cda22d867e2d2f22931b5567e93cc1e047cd"
+    },
+    "0x2e73e4a7f4c2ee4fb5d5d2fd823821e3975237d7": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x2e73e4a7f4c2ee4fb5d5d2fd823821e3975237d7"
+    },
+    "0x6f9fe2b0acf50874dcb49faefff62382381bf622": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0x6f9fe2b0acf50874dcb49faefff62382381bf622"
+    },
+    "0xc2068e03ca948f54348899eeda1417a901d76285": {
+      "name": "cluster-7dc08ec28f299c06",
+      "source": "https://celoscan.io/address/0xc2068e03ca948f54348899eeda1417a901d76285"
+    }
+  },
+  "143": {
+    "0x026f252016a7c47cdef1f05a3fc9e20c92a49c37": {
+      "name": "lifi",
+      "source": "https://li.quest/v1/chains?chainTypes=EVM",
+      "$note": "Non-default LI.FI diamond on Monad — not the 0x1231… address used on most chains."
+    },
+    "0x0000000000001ff3684f28c67538d4d072c22734": {
+      "name": "0x",
+      "source": "https://docs.0x.org/introduction/0x-cheat-sheet",
+      "$note": "0x V2 AllowanceHolder. Per-pair Settler contracts rotate and are not stable enough to track here; AllowanceHolder is the stable entry point."
+    },
+    "0x6352a56caadc4f1e25cd6c75970fa768a3304e64": {
+      "name": "openocean",
+      "source": "https://apis.openocean.finance/developer/apis/supported-chains"
+    }
+  }
+}

package/chain-metadata.json

@@ -0,0 +1,22 @@
+{
+  "42220": {
+    "slug": "celo",
+    "label": "Celo",
+    "explorerBaseUrl": "https://celoscan.io"
+  },
+  "143": {
+    "slug": "monad",
+    "label": "Monad",
+    "explorerBaseUrl": "https://monadscan.com"
+  },
+  "11142220": {
+    "slug": "celo-sepolia",
+    "label": "Celo Sepolia",
+    "explorerBaseUrl": "https://celo-sepolia.blockscout.com"
+  },
+  "10143": {
+    "slug": "monad-testnet",
+    "label": "Monad Testnet",
+    "explorerBaseUrl": "https://testnet.monadscan.com"
+  }
+}

package/deployment-namespaces.json

@@ -0,0 +1,6 @@
+{
+  "42220": "mainnet",
+  "11142220": "testnet-v2-rc5",
+  "143": "mainnet",
+  "10143": "testnet-v2-rc5"
+}

package/dist/aggregators.d.ts

@@ -0,0 +1,30 @@
+type RawClusterMetadata = {
+    chainId: number;
+    deployer: string;
+    explorerUrl: string;
+    $note?: string;
+};
+export type AggregatorClusterMetadata = {
+    chainId: number;
+    deployer: string;
+    explorerUrl: string;
+    note?: string;
+};
+export declare function _buildClusterMap(raw: unknown): Record<string, RawClusterMetadata>;
+/** Aggregator name (e.g. "squid") for a given (chainId, address), or null
+ *  when the address isn't a known aggregator on that chain. */
+export declare function getAggregatorName(chainId: number, address: string): string | null;
+/** First registered address for a given (chainId, aggregator name), or null
+ *  when no entry matches. Use this when test fixtures or scripts need the
+ *  canonical address for a known aggregator — keeps the address literal in
+ *  one place. Returns the first match if a name has multiple addresses on
+ *  the same chain (e.g. openocean's per-leg executor). */
+export declare function getAggregatorAddress(chainId: number, name: string): string | null;
+/** All `(address → aggregatorName)` entries for a chain, in insertion order
+ *  (matches JSON key order). Use this to enumerate or filter aggregators —
+ *  e.g. dashboard widgets, forensic scripts, monitoring jobs. */
+export declare function aggregatorsByChain(chainId: number): ReadonlyMap<string, string>;
+export declare function getClusterMetadata(aggregatorName: string): AggregatorClusterMetadata | undefined;
+export declare function clusterNames(): string[];
+export {};
+//# sourceMappingURL=aggregators.d.ts.map

package/dist/aggregators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregators.d.ts","sourceRoot":"","sources":["../src/aggregators.ts"],"names":[],"mappings":"AASA,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAQF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAiCF,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CASpC;AAMD;+DAC+D;AAC/D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAEf;AAED;;;;0DAI0D;AAC1D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAMf;AAED;;iEAEiE;AACjE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7B;AAED,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,GACrB,yBAAyB,GAAG,SAAS,CASvC;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/aggregators.js

@@ -0,0 +1,88 @@
+// Canonical aggregator/router registry — chain → address → {name, source}.
+// Source of truth for both the indexer's swap classifier and any UI / forensic
+// tooling that needs to look up an aggregator by name or address. The
+// `indexer-envio/config/aggregators.json` file is a vendored copy of this
+// (indexer builds outside the pnpm workspace); a parity test in
+// `indexer-envio/test/aggregators-parity.test.ts` keeps the two in lockstep.
+import aggregatorsJson from "../aggregators.json" with { type: "json" };
+// The JSON mixes per-chain blocks with `$comment` / `$clusters` keys at the
+// top level, and `$clusters` itself mixes the cluster entries with a nested
+// `$comment`. TypeScript can't express that heterogeneous shape cleanly, so
+// we go through `unknown` once and validate the slices we use at runtime.
+const ROOT = aggregatorsJson;
+// Per-chain `Map<lowercaseAddress, aggregatorName>` derived from the JSON.
+// Built once at module load so consumers can do constant-time lookups.
+const ADDRESSES_BY_CHAIN = (() => {
+    const out = new Map();
+    for (const [key, value] of Object.entries(ROOT)) {
+        if (key.startsWith("$"))
+            continue; // skip $comment, $clusters
+        const chainId = Number(key);
+        if (!Number.isFinite(chainId))
+            continue;
+        const inner = new Map();
+        for (const [addr, entry] of Object.entries(value)) {
+            // Per-chain blocks only ever hold address-keyed entries — `$comment`
+            // / `$clusters` live at the top level, not inside a chain block — so
+            // no `$`-prefix filter is needed here.
+            inner.set(addr.toLowerCase(), entry.name);
+        }
+        out.set(chainId, inner);
+    }
+    return out;
+})();
+// Exposed for unit tests so we can exercise the "missing/malformed
+// $clusters" branch without mocking the JSON import. The module's own
+// CLUSTERS map is built by calling this with `ROOT.$clusters`.
+export function _buildClusterMap(raw) {
+    const out = {};
+    if (raw == null || typeof raw !== "object")
+        return out;
+    for (const [name, value] of Object.entries(raw)) {
+        if (name.startsWith("$"))
+            continue;
+        if (value == null || typeof value !== "object")
+            continue;
+        out[name] = value;
+    }
+    return out;
+}
+const CLUSTERS = _buildClusterMap(ROOT.$clusters);
+/** Aggregator name (e.g. "squid") for a given (chainId, address), or null
+ *  when the address isn't a known aggregator on that chain. */
+export function getAggregatorName(chainId, address) {
+    return ADDRESSES_BY_CHAIN.get(chainId)?.get(address.toLowerCase()) ?? null;
+}
+/** First registered address for a given (chainId, aggregator name), or null
+ *  when no entry matches. Use this when test fixtures or scripts need the
+ *  canonical address for a known aggregator — keeps the address literal in
+ *  one place. Returns the first match if a name has multiple addresses on
+ *  the same chain (e.g. openocean's per-leg executor). */
+export function getAggregatorAddress(chainId, name) {
+    const lower = name.toLowerCase();
+    for (const [addr, entryName] of ADDRESSES_BY_CHAIN.get(chainId) ?? []) {
+        if (entryName.toLowerCase() === lower)
+            return addr;
+    }
+    return null;
+}
+/** All `(address → aggregatorName)` entries for a chain, in insertion order
+ *  (matches JSON key order). Use this to enumerate or filter aggregators —
+ *  e.g. dashboard widgets, forensic scripts, monitoring jobs. */
+export function aggregatorsByChain(chainId) {
+    return ADDRESSES_BY_CHAIN.get(chainId) ?? new Map();
+}
+export function getClusterMetadata(aggregatorName) {
+    const meta = CLUSTERS[aggregatorName];
+    if (!meta)
+        return undefined;
+    return {
+        chainId: meta.chainId,
+        deployer: meta.deployer,
+        explorerUrl: meta.explorerUrl,
+        ...(meta.$note !== undefined && { note: meta.$note }),
+    };
+}
+export function clusterNames() {
+    return Object.keys(CLUSTERS).sort();
+}

package/dist/chains.d.ts

@@ -0,0 +1,7 @@
+export declare function hasChain(chainId: number): boolean;
+export declare function chainSlug(chainId: number): string;
+export declare function chainLabel(chainId: number): string;
+export declare function explorerBaseUrl(chainId: number): string | null;
+export declare function explorerAddressUrl(chainId: number, address: string): string | null;
+export declare function explorerTxUrl(chainId: number, txHash: string): string | null;
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAkBA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9D;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5E"}

package/dist/chains.js

@@ -0,0 +1,29 @@
+import chainMetadataJson from "../chain-metadata.json" with { type: "json" };
+const CHAIN_METADATA = chainMetadataJson;
+function entry(chainId) {
+    return CHAIN_METADATA[String(chainId)];
+}
+// True when the chainId has an entry in chain-metadata.json. Callers that
+// need to detect "missing chain" should use this instead of comparing
+// `chainSlug(id) === String(id)` — `chainSlug` is pass-through on miss
+// and that sentinel string can collide with valid future slugs.
+export function hasChain(chainId) {
+    return entry(chainId) !== undefined;
+}
+export function chainSlug(chainId) {
+    return entry(chainId)?.slug ?? String(chainId);
+}
+export function chainLabel(chainId) {
+    return entry(chainId)?.label ?? chainSlug(chainId);
+}
+export function explorerBaseUrl(chainId) {
+    return entry(chainId)?.explorerBaseUrl ?? null;
+}
+export function explorerAddressUrl(chainId, address) {
+    const base = explorerBaseUrl(chainId);
+    return base ? `${base}/address/${address}` : null;
+}
+export function explorerTxUrl(chainId, txHash) {
+    const base = explorerBaseUrl(chainId);
+    return base ? `${base}/tx/${txHash}` : null;
+}

package/dist/deployment-namespaces.d.ts

@@ -0,0 +1,7 @@
+export declare const DEPLOYMENT_NAMESPACE_CHAIN_IDS: readonly ["42220", "11142220", "143", "10143"];
+export type DeploymentNamespaceChainId = (typeof DEPLOYMENT_NAMESPACE_CHAIN_IDS)[number];
+export type DeploymentNamespaceByChainId = Readonly<Record<DeploymentNamespaceChainId, string>>;
+export declare const DEPLOYMENT_NAMESPACES: DeploymentNamespaceByChainId;
+export declare function deploymentNamespace(chainId: number): string | null;
+export default DEPLOYMENT_NAMESPACES;
+//# sourceMappingURL=deployment-namespaces.d.ts.map

package/dist/deployment-namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-namespaces.d.ts","sourceRoot":"","sources":["../src/deployment-namespaces.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,8BAA8B,gDAKjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAClD,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAC3C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,4BACV,CAAC;AAE3B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED,eAAe,qBAAqB,CAAC"}

package/dist/deployment-namespaces.js

@@ -0,0 +1,12 @@
+import deploymentNamespacesJson from "../deployment-namespaces.json" with { type: "json" };
+export const DEPLOYMENT_NAMESPACE_CHAIN_IDS = [
+    "42220",
+    "11142220",
+    "143",
+    "10143",
+];
+export const DEPLOYMENT_NAMESPACES = deploymentNamespacesJson;
+export function deploymentNamespace(chainId) {
+    return (DEPLOYMENT_NAMESPACES[String(chainId)] ?? null);
+}
+export default DEPLOYMENT_NAMESPACES;

package/dist/erc20-abi.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ERC20 ABI fragments shared by every consumer that walks pool/token contracts
+ * (ui-dashboard's pool-detail probe, metrics-bridge's reserve-collateral
+ * enrichment). String-array form rather than viem-typed ABI so the
+ * shared-config package stays viem-free — consumers feed this list into
+ * `parseAbi(...)` to materialise a typed ABI on their side.
+ *
+ * Drift between the dashboard and the bridge here is harmless (ERC20 +
+ * pool-pair shapes are stable interfaces) but duplicating selectors verbatim
+ * across packages was ~30 LOC of pure copy-paste. Single canonical list
+ * keeps `function symbol()` / `function decimals()` etc. in lockstep.
+ *
+ * Implementation note: the `as const` annotation preserves literal types so
+ * `parseAbi(ERC20_ABI_SOURCES)` produces a strongly-typed ABI on the consumer
+ * side rather than collapsing to `string[]`.
+ */
+export declare const ERC20_ABI_SOURCES: readonly ["function balanceOf(address account) external view returns (uint256)", "function decimals() external view returns (uint8)", "function symbol() external view returns (string)", "function totalSupply() external view returns (uint256)"];
+/**
+ * Pool-pair token-getter ABI. `function token0() / token1()` — used during
+ * reserve-collateral enrichment to identify the non-debt leg of the pool.
+ * Stable across every FPMM pool implementation, kept here for parity with
+ * the ERC20 fragments.
+ */
+export declare const POOL_PAIR_ABI_SOURCES: readonly ["function token0() external view returns (address)", "function token1() external view returns (address)"];
+//# sourceMappingURL=erc20-abi.d.ts.map

package/dist/erc20-abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20-abi.d.ts","sourceRoot":"","sources":["../src/erc20-abi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,qPAKpB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,qHAGxB,CAAC"}

package/dist/erc20-abi.js

@@ -0,0 +1,32 @@
+/**
+ * ERC20 ABI fragments shared by every consumer that walks pool/token contracts
+ * (ui-dashboard's pool-detail probe, metrics-bridge's reserve-collateral
+ * enrichment). String-array form rather than viem-typed ABI so the
+ * shared-config package stays viem-free — consumers feed this list into
+ * `parseAbi(...)` to materialise a typed ABI on their side.
+ *
+ * Drift between the dashboard and the bridge here is harmless (ERC20 +
+ * pool-pair shapes are stable interfaces) but duplicating selectors verbatim
+ * across packages was ~30 LOC of pure copy-paste. Single canonical list
+ * keeps `function symbol()` / `function decimals()` etc. in lockstep.
+ *
+ * Implementation note: the `as const` annotation preserves literal types so
+ * `parseAbi(ERC20_ABI_SOURCES)` produces a strongly-typed ABI on the consumer
+ * side rather than collapsing to `string[]`.
+ */
+export const ERC20_ABI_SOURCES = [
+    "function balanceOf(address account) external view returns (uint256)",
+    "function decimals() external view returns (uint8)",
+    "function symbol() external view returns (string)",
+    "function totalSupply() external view returns (uint256)",
+];
+/**
+ * Pool-pair token-getter ABI. `function token0() / token1()` — used during
+ * reserve-collateral enrichment to identify the non-debt leg of the pool.
+ * Stable across every FPMM pool implementation, kept here for parity with
+ * the ERC20 fragments.
+ */
+export const POOL_PAIR_ABI_SOURCES = [
+    "function token0() external view returns (address)",
+    "function token1() external view returns (address)",
+];

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+export declare function poolIdAddress(poolId: string): string;
+export declare function shortAddress(address: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpD;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/format.js

@@ -0,0 +1,12 @@
+// `42220-0xabc` → `0xabc`. Input returned unchanged if no dash.
+export function poolIdAddress(poolId) {
+    const dash = poolId.indexOf("-");
+    return dash >= 0 ? poolId.slice(dash + 1) : poolId;
+}
+// `0x93e15a22…ead61` → `0x93e1…ad61`. Keeps 4 leading + 4 trailing nibbles
+// so both ends stay distinguishable in Slack without eating 40+ chars.
+export function shortAddress(address) {
+    if (!address.startsWith("0x") || address.length < 12)
+        return address;
+    return `${address.slice(0, 6)}…${address.slice(-4)}`;
+}

package/dist/fx-calendar.d.ts

@@ -0,0 +1,22 @@
+export type FxCalendarConfig = {
+    fxCloseDay: number;
+    fxCloseHourUtc: number;
+    fxReopenDay: number;
+    fxReopenHourUtc: number;
+    anchorFri2100UnixSec: number;
+};
+export declare function assertFxCalendarConfig(value: unknown): asserts value is FxCalendarConfig;
+export declare const FX_CALENDAR: {
+    fxCloseDay: number;
+    fxCloseHourUtc: number;
+    fxReopenDay: number;
+    fxReopenHourUtc: number;
+    anchorFri2100UnixSec: number;
+};
+export declare const FX_CLOSE_DAY: number;
+export declare const FX_CLOSE_HOUR_UTC: number;
+export declare const FX_REOPEN_DAY: number;
+export declare const FX_REOPEN_HOUR_UTC: number;
+export declare const ANCHOR_FRI_2100_UNIX_SEC: number;
+export default FX_CALENDAR;
+//# sourceMappingURL=fx-calendar.d.ts.map

package/dist/fx-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-calendar.d.ts","sourceRoot":"","sources":["../src/fx-calendar.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAUF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAWnC;AAID,eAAO,MAAM,WAAW;;;;;;CAAiB,CAAC;AAE1C,eAAO,MAAM,YAAY,QAAyB,CAAC;AACnD,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,aAAa,QAA0B,CAAC;AACrD,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,wBAAwB,QAAmC,CAAC;AAEzE,eAAe,WAAW,CAAC"}

package/dist/fx-calendar.js

@@ -0,0 +1,27 @@
+import fxCalendarJson from "../fx-calendar.json" with { type: "json" };
+const FX_CALENDAR_NUMBER_FIELDS = [
+    "fxCloseDay",
+    "fxCloseHourUtc",
+    "fxReopenDay",
+    "fxReopenHourUtc",
+    "anchorFri2100UnixSec",
+];
+export function assertFxCalendarConfig(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("fx-calendar.json must be an object");
+    }
+    const record = value;
+    for (const field of FX_CALENDAR_NUMBER_FIELDS) {
+        if (typeof record[field] !== "number") {
+            throw new TypeError(`fx-calendar.json field ${field} must be a number`);
+        }
+    }
+}
+assertFxCalendarConfig(fxCalendarJson);
+export const FX_CALENDAR = fxCalendarJson;
+export const FX_CLOSE_DAY = FX_CALENDAR.fxCloseDay;
+export const FX_CLOSE_HOUR_UTC = FX_CALENDAR.fxCloseHourUtc;
+export const FX_REOPEN_DAY = FX_CALENDAR.fxReopenDay;
+export const FX_REOPEN_HOUR_UTC = FX_CALENDAR.fxReopenHourUtc;
+export const ANCHOR_FRI_2100_UNIX_SEC = FX_CALENDAR.anchorFri2100UnixSec;
+export default FX_CALENDAR;

package/dist/oracle-reporters.d.ts

@@ -0,0 +1,13 @@
+export declare const ORACLE_REPORTER_TYPES: readonly ["CHAINLINK", "REDSTONE", "BRIDGED", "MANUAL"];
+export type OracleReporterType = (typeof ORACLE_REPORTER_TYPES)[number];
+export declare function getRateFeedPair(chainId: number, feedAddress: string): string | null;
+export declare function getRateFeedReporterType(chainId: number, feedAddress: string): OracleReporterType | null;
+export declare function getChainlinkDataFeedUrl(chainId: number, pair: string, slugOverride?: string): string | null;
+export declare function getRateFeedChainlinkDataFeedUrl(chainId: number, feedAddress: string): string | null;
+export declare function getOracleReporterType(chainId: number, reporterAddress: string): OracleReporterType;
+export declare function describeRateFeed(chainId: number, feedAddress: string, reporters: ReadonlyArray<string>): {
+    pair: string;
+    reporterTypes: OracleReporterType[];
+};
+export declare function knownRateFeedsByChain(chainId: number): ReadonlyMap<string, string>;
+//# sourceMappingURL=oracle-reporters.d.ts.map

package/dist/oracle-reporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-reporters.d.ts","sourceRoot":"","sources":["../src/oracle-reporters.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yDAKxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAgDxE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,kBAAkB,GAAG,IAAI,CAG3B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,kBAAkB,CAIpB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,GAC/B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC,CAOA;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAW7B"}

package/dist/oracle-reporters.js

@@ -0,0 +1,65 @@
+import oracleReportersJson from "../oracle-reporters.json" with { type: "json" };
+export const ORACLE_REPORTER_TYPES = [
+    "CHAINLINK",
+    "REDSTONE",
+    "BRIDGED",
+    "MANUAL",
+];
+const ROOT = oracleReportersJson;
+const REPORTER_TYPE_SET = new Set(ORACLE_REPORTER_TYPES);
+const CHAINLINK_FEED_PATH_BY_CHAIN = {
+    42220: "celo/mainnet",
+    143: "monad/monad",
+};
+function chainEntry(chainId) {
+    return ROOT[String(chainId)];
+}
+function normalizeAddress(address) {
+    return address.toLowerCase();
+}
+function feedEntry(chainId, feedAddress) {
+    return chainEntry(chainId)?.feeds?.[normalizeAddress(feedAddress)];
+}
+function isReporterType(value) {
+    return value !== undefined && REPORTER_TYPE_SET.has(value);
+}
+export function getRateFeedPair(chainId, feedAddress) {
+    return feedEntry(chainId, feedAddress)?.pair ?? null;
+}
+export function getRateFeedReporterType(chainId, feedAddress) {
+    const raw = feedEntry(chainId, feedAddress)?.type;
+    return isReporterType(raw) ? raw : null;
+}
+export function getChainlinkDataFeedUrl(chainId, pair, slugOverride) {
+    const path = CHAINLINK_FEED_PATH_BY_CHAIN[chainId];
+    if (!path)
+        return null;
+    const slug = slugOverride ?? pair.toLowerCase().replace(/\//g, "-");
+    return `https://data.chain.link/feeds/${path}/${slug}`;
+}
+export function getRateFeedChainlinkDataFeedUrl(chainId, feedAddress) {
+    const entry = feedEntry(chainId, feedAddress);
+    return entry?.type === "CHAINLINK"
+        ? getChainlinkDataFeedUrl(chainId, entry.pair, entry.chainlinkSlug)
+        : null;
+}
+export function getOracleReporterType(chainId, reporterAddress) {
+    const raw = chainEntry(chainId)?.reporters?.[normalizeAddress(reporterAddress)]?.type;
+    return isReporterType(raw) ? raw : "MANUAL";
+}
+export function describeRateFeed(chainId, feedAddress, reporters) {
+    return {
+        pair: getRateFeedPair(chainId, feedAddress) ?? "Unknown",
+        reporterTypes: reporters.map((reporter) => getOracleReporterType(chainId, reporter)),
+    };
+}
+export function knownRateFeedsByChain(chainId) {
+    const feeds = chainEntry(chainId)?.feeds;
+    if (!feeds) {
+        return new Map();
+    }
+    return new Map(Object.entries(feeds).map(([address, entry]) => [
+        normalizeAddress(address),
+        entry.pair,
+    ]));
+}

package/dist/protocol-fee.d.ts

@@ -0,0 +1,2 @@
+export declare const PROTOCOL_FEE_RECIPIENT_ADDRESS: `0x${string}`;
+//# sourceMappingURL=protocol-fee.d.ts.map

package/dist/protocol-fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-fee.d.ts","sourceRoot":"","sources":["../src/protocol-fee.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,8BAA8B,EACT,KAAK,MAAM,EAAE,CAAC"}

package/dist/protocol-fee.js

@@ -0,0 +1,13 @@
+// Address that receives all protocol fees across every chain. The same
+// address by Mento's deterministic-deploy convention — the contracts package
+// publishes it as `YieldSplitAddress` on Celo mainnet and `ProtocolFeeRecipient`
+// on every other namespace. Derived from `@mento-protocol/contracts` so we
+// don't have to chase address changes through the dashboard + indexer + URLs.
+import contractsData from "@mento-protocol/contracts/contracts.json" with { type: "json" };
+const SOURCE = contractsData["42220"]?.mainnet
+    ?.YieldSplitAddress;
+if (!SOURCE) {
+    throw new Error("YieldSplitAddress missing from @mento-protocol/contracts at 42220/mainnet — " +
+        "package contract may have been renamed; update shared-config/src/protocol-fee.ts");
+}
+export const PROTOCOL_FEE_RECIPIENT_ADDRESS = SOURCE.address.toLowerCase();