@raac/rpc 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/RPCLibrary.js

@@ -98,6 +98,7 @@ const getContractAddress_1 = __importDefault(require("./contracts/getContractAdd
 const getContract_1 = __importDefault(require("./contracts/getContract"));
 const findContract_1 = require("./contracts/findContract");
 const decodeCall_1 = require("./contracts/decodeCall");
+const resolveName_1 = require("./contracts/resolveName");
 // House Prices
 const getLatestPrice_1 = __importDefault(require("./contracts/housePrices/getLatestPrice"));
 const setOracle_1 = __importDefault(require("./contracts/housePrices/setOracle"));
@@ -457,6 +458,8 @@ class RPCLibrary {
             getContract: getContract_1.default,
             findContract: findContract_1.findContract,
             decodeCall: decodeCall_1.decodeCall,
+            resolveName: resolveName_1.resolveName,
+            resolveNames: resolveName_1.resolveNames,
             feeCollector: {
                 claimRewardFromPool: claimRewardFromPool_1.default,
             },

package/dist/configs/chains/1.json

@@ -224,12 +224,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "Lending Pool",
                 "contract": "0xd8Cb90b0A5b288F5f0c9a519Ae4B1B47D5E69353",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
+                "label": "Lending Pool",
                 "contract": "0x216433c8408A349B4b7342d60F948d89317E3366",
                 "type": "ERC20"
             }
@@ -238,6 +240,7 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "RWA Vault",
                 "contract": "0xB1b35C62B99a450c474e9dAd75fA121d3Daa1d34",
                 "type": "ERC721"
             }

package/dist/configs/chains/11155111.json

@@ -276,12 +276,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "Lending Pool",
                 "contract": "0x0000000000000000000000000000000000000000",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
+                "label": "Lending Pool",
                 "contract": "0xeBab0C5152C406F74E76cB01f4eA9b57BdFad184",
                 "type": "ERC20"
             }
@@ -290,12 +292,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "RWA Vault",
                 "contract": "0xd545a0a87571122f07F2B2367b5257DC8aa34640",
                 "type": "ERC721"
             },
             "crvusdadapter": {
                 "id": "crvusdadapter",
                 "name": "CRVUSD Adapter",
+                "label": "RWA Vault",
                 "contract": "0x0000000000000000000000000000000000000000",
                 "type": "ERC20"
             }

package/dist/configs/chains/17000.json

@@ -229,12 +229,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "Lending Pool",
                 "contract": "",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
+                "label": "Lending Pool",
                 "contract": "",
                 "type": "ERC20"
             }
@@ -243,12 +245,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "RWA Vault",
                 "contract": "",
                 "type": "ERC721"
             },
             "crvusdadapter": {
                 "id": "crvusdadapter",
                 "name": "CRVUSD",
+                "label": "RWA Vault",
                 "contract": "",
                 "type": "ERC20"
             }

package/dist/configs/chains/18453.json

@@ -229,12 +229,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "Lending Pool",
                 "contract": "0x998abeb3E57409262aE5b751f60747921B33613E",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
+                "label": "Lending Pool",
                 "contract": "0x95401dc811bb5740090279Ba06cfA8fcF6113778",
                 "type": "ERC20"
             }
@@ -243,12 +245,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "RWA Vault",
                 "contract": "0x99bbA657f2BbC93c02D617f8bA121cB8Fc104Acf",
                 "type": "ERC721"
             },
             "crvusdadapter": {
                 "id": "crvusdadapter",
                 "name": "CRVUSD Adapter",
+                "label": "RWA Vault",
                 "contract": "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
                 "type": "ERC20"
             }

package/dist/configs/chains/8453.json

@@ -325,12 +325,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "Lending Pool",
                 "contract": "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
                 "type": "ERC721"
             },
             "rwaindextokenadapter": {
                 "id": "rwaindextokenadapter",
                 "name": "RWA Index Token",
+                "label": "Lending Pool",
                 "contract": "0x4A679253410272dd5232B3Ff7cF5dbB88f295319",
                 "type": "ERC20"
             }
@@ -339,12 +341,14 @@
             "raacnftadapter": {
                 "id": "raacnftadapter",
                 "name": "RAAC NFT Adapter",
+                "label": "RWA Vault",
                 "contract": "0x322813Fd9A801c5507c9de605d63CEA4f2CE6c44",
                 "type": "ERC721"
             },
             "crvusdadapter": {
                 "id": "crvusdadapter",
                 "name": "CRVUSD Adapter",
+                "label": "RWA Vault",
                 "contract": "0x4ed7c70F96B99c776995fB64377f0d4aB3B0e1C1",
                 "type": "ERC20"
             }

package/dist/configs/registry/1.json

@@ -0,0 +1 @@
+{}

package/dist/configs/registry/11155111.json

@@ -0,0 +1 @@
+{}

package/dist/configs/registry/17000.json

@@ -0,0 +1 @@
+{}

package/dist/configs/registry/18453.json

@@ -0,0 +1 @@
+{}

package/dist/configs/registry/8453.json

@@ -0,0 +1 @@
+{}

package/dist/configs/registry/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
+const _1_json_1 = __importDefault(require("./1.json"));
+const _8453_json_1 = __importDefault(require("./8453.json"));
+const _17000_json_1 = __importDefault(require("./17000.json"));
+const _11155111_json_1 = __importDefault(require("./11155111.json"));
+const _18453_json_1 = __importDefault(require("./18453.json"));
+/**
+ * Curated, off-chain-known addresses per chain (wallets, external protocols),
+ * keyed by checksummed address. Empty until entries are reviewed and added -
+ * see resolveName.ts for why this ships empty rather than with guessed data.
+ */
+const registries = {
+    1: _1_json_1.default,
+    8453: _8453_json_1.default,
+    17000: _17000_json_1.default,
+    11155111: _11155111_json_1.default,
+    18453: _18453_json_1.default,
+};
+exports.default = registries;

package/dist/contracts/findContract.js

@@ -24,32 +24,48 @@ function listContracts(chainId) {
     };
     // gauges: { <system>: { label, gaugeType, controller, distributor, gauges: [{ id, name, contract }] } }
     for (const [key, system] of Object.entries((config.gauges ?? {}))) {
-        push({ address: system.controller, id: `${key}.controller`, name: `${system.label} Controller`, section: "gauges", abi: "gaugecontroller" });
-        push({ address: system.distributor, id: `${key}.distributor`, name: `${system.label} Distributor`, section: "gauges", abi: "gaugerewardsdistributor" });
+        push({ address: system.controller, id: `${key}.controller`, name: `${system.label} Controller`, label: `${system.label} Controller`, section: "gauges", abi: "gaugecontroller" });
+        push({ address: system.distributor, id: `${key}.distributor`, name: `${system.label} Distributor`, label: `${system.label} Distributor`, section: "gauges", abi: "gaugerewardsdistributor" });
         for (const gauge of system.gauges ?? []) {
-            push({ address: gauge.contract, id: gauge.id, name: gauge.name, section: "gauges", abi: abiKey(system.gaugeType.toLowerCase()) });
+            push({ address: gauge.contract, id: gauge.id, name: gauge.name, label: gauge.name, section: "gauges", abi: abiKey(system.gaugeType.toLowerCase()) });
         }
     }
     for (const section of FLAT_SECTIONS) {
         for (const [key, value] of Object.entries((config[section] ?? {}))) {
-            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section, abi: abiKey(key.toLowerCase()) });
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, label: value.name ?? key, section, abi: abiKey(key.toLowerCase()) });
         }
     }
-    // adapters: { <pool or vault>: { <adapter>: { contract, type: "ERC20" | "ERC721" } } }
+    // adapters: { <pool or vault>: { <adapter>: { contract, type: "ERC20" | "ERC721", label } } }
+    // `label` names the pool or vault the adapter belongs to - the adapter itself is internal.
     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}`) });
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, label: value.label ?? 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" });
+        push({ address: instance.governance, id: `${instance.id}.governance`, name: `${instance.label} Governance`, label: `${instance.label} Governance`, section: "proposals", abi: "governance" });
+        push({ address: instance.timelock, id: `${instance.id}.timelock`, name: `${instance.label} Timelock`, label: `${instance.label} Timelock`, section: "proposals", abi: "timelockcontroller" });
     }
     return found;
 }
+const contractsByAddress = new Map();
+/** Address -> entry index for a chain, built on first use. First match wins, as in `listContracts`. */
+function getContractIndex(chainId) {
+    const key = String(chainId);
+    let index = contractsByAddress.get(key);
+    if (!index) {
+        index = {};
+        for (const entry of listContracts(chainId)) {
+            if (!(entry.address in index))
+                index[entry.address] = entry;
+        }
+        contractsByAddress.set(key, index);
+    }
+    return index;
+}
 /**
  * Finds a contract by address in the chain config.
  * Reads the chain config only; no RPC call is made.
@@ -61,8 +77,7 @@ function listContracts(chainId) {
 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;
+    return getContractIndex(chainId)[ethers_1.ethers.getAddress(address)] ?? null;
 };
 exports.findContract = findContract;
 exports.default = exports.findContract;

package/dist/contracts/resolveName.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveName = resolveName;
+exports.resolveNames = resolveNames;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const findContract_1 = require("./findContract");
+const registry_1 = __importDefault(require("../configs/registry"));
+const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+const BURN_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+/** Universal, chain-agnostic entries that do not belong in a per-chain registry file. */
+const BUILTIN_REGISTRY = {
+    [ZERO_ADDRESS]: { name: "None", kind: "external" },
+    [ethers_1.ethers.getAddress(BURN_ADDRESS)]: { name: "Burn", kind: "external" },
+};
+/** address -> { name, expiresAt } | null (a confirmed miss, cached too so a repeat lookup does not re-hit the network). */
+const ensCache = new Map();
+const ENS_TTL_MS = 60 * 60 * 1000;
+function contractInfoToAddressName(info) {
+    return {
+        address: info.address,
+        name: info.label ?? info.name,
+        kind: info.section === "gauges" ? "gauge" : "contract",
+        source: "config",
+    };
+}
+function lookupRegistry(chainId, address) {
+    const builtin = BUILTIN_REGISTRY[address];
+    if (builtin)
+        return { address, ...builtin, source: "registry" };
+    const registry = registry_1.default[String(chainId)];
+    const entry = registry?.[address];
+    if (!entry)
+        return null;
+    return { address, ...entry, source: "registry" };
+}
+async function lookupEns(address, provider) {
+    const cached = ensCache.get(address);
+    if (cached && cached.expiresAt > Date.now()) {
+        return cached.name ? { address, name: cached.name, kind: "ens", source: "ens" } : null;
+    }
+    try {
+        const runner = provider ?? new ethers_1.ethers.JsonRpcProvider(chains_1.default[1].rpcs[0]);
+        const ensName = await runner.lookupAddress(address);
+        // Forward-verify: an ENS reverse record is set by its owner and can point anywhere,
+        // so trust it only once the name's forward resolution points back to this address.
+        const verified = ensName && ethers_1.ethers.getAddress((await runner.resolveName(ensName)) ?? "") === address;
+        const name = verified ? ensName : null;
+        ensCache.set(address, { name, expiresAt: Date.now() + ENS_TTL_MS });
+        return name ? { address, name, kind: "ens", source: "ens" } : null;
+    }
+    catch {
+        // A broken or slow ENS lookup must not fail the rest of resolution.
+        return null;
+    }
+}
+/**
+ * Resolves an address to a readable name.
+ *
+ * Checks the chain config (via `findContract`), then a curated registry of
+ * off-chain-known addresses (wallets, external protocols), then - mainnet
+ * only, and only once the first two miss - an ENS reverse lookup, forward-
+ * verified against the name it returns.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - Any-case address.
+ * @param options - `ens: false` skips the ENS step; `provider` reuses an existing connection for it.
+ * @returns The resolved name, or null when nothing matches.
+ */
+async function resolveName(chainId, address, options) {
+    if (!ethers_1.ethers.isAddress(address))
+        return null;
+    const target = ethers_1.ethers.getAddress(address);
+    const configMatch = (0, findContract_1.findContract)(chainId, target);
+    if (configMatch)
+        return contractInfoToAddressName(configMatch);
+    const registryMatch = lookupRegistry(chainId, target);
+    if (registryMatch)
+        return registryMatch;
+    if (options?.ens === false || String(chainId) !== "1")
+        return null;
+    return lookupEns(target, options?.provider);
+}
+/**
+ * Batch form of {@link resolveName}. Config and registry lookups run
+ * synchronously per address; only addresses that fall through to ENS pay for
+ * a network round trip, and those run concurrently.
+ *
+ * @param chainId - The chain/network to use.
+ * @param addresses - Any-case addresses.
+ * @param options - Same as {@link resolveName}.
+ * @returns A map from the (checksummed) input address to its resolved name, or null.
+ */
+async function resolveNames(chainId, addresses, options) {
+    const result = {};
+    const pending = [];
+    for (const raw of addresses) {
+        if (!ethers_1.ethers.isAddress(raw))
+            continue;
+        const target = ethers_1.ethers.getAddress(raw);
+        const configMatch = (0, findContract_1.findContract)(chainId, target);
+        if (configMatch) {
+            result[target] = contractInfoToAddressName(configMatch);
+            continue;
+        }
+        const registryMatch = lookupRegistry(chainId, target);
+        if (registryMatch) {
+            result[target] = registryMatch;
+            continue;
+        }
+        if (options?.ens === false || String(chainId) !== "1") {
+            result[target] = null;
+            continue;
+        }
+        pending.push(target);
+    }
+    if (pending.length > 0) {
+        const ensResults = await Promise.all(pending.map((address) => lookupEns(address, options?.provider)));
+        pending.forEach((address, i) => {
+            result[address] = ensResults[i];
+        });
+    }
+    return result;
+}
+exports.default = resolveName;

package/dist/types/RPCLibrary.d.ts

@@ -44,6 +44,7 @@ import getContractAddress from "./contracts/getContractAddress";
 import getContract from "./contracts/getContract";
 import { findContract } from "./contracts/findContract";
 import { decodeCall } from "./contracts/decodeCall";
+import { resolveName, resolveNames } from "./contracts/resolveName";
 import getLatestPrice from "./contracts/housePrices/getLatestPrice";
 import setOracle from "./contracts/housePrices/setOracle";
 import tick from "./minter/tick";
@@ -338,6 +339,8 @@ declare class RPCLibrary {
         getContract: typeof getContract;
         findContract: typeof findContract;
         decodeCall: typeof decodeCall;
+        resolveName: typeof resolveName;
+        resolveNames: typeof resolveNames;
         feeCollector: {
             claimRewardFromPool: typeof claimRewardFromPool;
         };

package/dist/types/configs/chains/index.d.ts

@@ -222,12 +222,14 @@ declare const chains: {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
                 rwaindextokenadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -236,6 +238,7 @@ declare const chains: {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -471,12 +474,14 @@ export declare const configs: {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
                 rwaindextokenadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -485,6 +490,7 @@ export declare const configs: {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };

package/dist/types/configs/index.d.ts

@@ -222,12 +222,14 @@ declare function getChainsConfig(): {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
                 rwaindextokenadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -236,6 +238,7 @@ declare function getChainsConfig(): {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };

package/dist/types/configs/registry/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Curated, off-chain-known addresses per chain (wallets, external protocols),
+ * keyed by checksummed address. Empty until entries are reviewed and added -
+ * see resolveName.ts for why this ships empty rather than with guessed data.
+ */
+declare const registries: {
+    1: {};
+    8453: {};
+    17000: {};
+    11155111: {};
+    18453: {};
+};
+export default registries;

package/dist/types/contracts/findContract.d.ts

@@ -5,8 +5,10 @@ export interface ContractInfo {
     address: string;
     /** The entry's id in the chain config, e.g. "treasury" or "RAAC_pmUSD". */
     id: string;
-    /** The entry's display name, e.g. "Treasury". */
+    /** The entry's internal name, e.g. "Treasury". */
     name: string;
+    /** The user-facing name, e.g. "Treasury". Same as `name` except for adapters, which report their pool or vault ("RWA Vault"). */
+    label: string;
     /** Top-level config section the entry came from, e.g. "contracts", "gauges", "proposals". */
     section: string;
     /** Key into `ABIS`, or null when this library ships no ABI for the contract. */

package/dist/types/contracts/resolveName.d.ts

@@ -0,0 +1,42 @@
+import { Provider } from "ethers";
+import { ChainId } from "../configs/chains";
+export interface AddressName {
+    /** Checksummed. */
+    address: string;
+    name: string;
+    kind: "contract" | "gauge" | "wallet" | "external" | "ens";
+    source: "config" | "registry" | "ens";
+    url?: string;
+}
+export interface ResolveNameOptions {
+    /** Attempt an ENS reverse lookup when nothing else matches. Mainnet only regardless of this flag. Default true. */
+    ens?: boolean;
+    /** Reuse an existing provider for the ENS lookup instead of constructing one from the chain config. */
+    provider?: Provider;
+}
+/**
+ * Resolves an address to a readable name.
+ *
+ * Checks the chain config (via `findContract`), then a curated registry of
+ * off-chain-known addresses (wallets, external protocols), then - mainnet
+ * only, and only once the first two miss - an ENS reverse lookup, forward-
+ * verified against the name it returns.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - Any-case address.
+ * @param options - `ens: false` skips the ENS step; `provider` reuses an existing connection for it.
+ * @returns The resolved name, or null when nothing matches.
+ */
+export declare function resolveName(chainId: ChainId, address: string, options?: ResolveNameOptions): Promise<AddressName | null>;
+/**
+ * Batch form of {@link resolveName}. Config and registry lookups run
+ * synchronously per address; only addresses that fall through to ENS pay for
+ * a network round trip, and those run concurrently.
+ *
+ * @param chainId - The chain/network to use.
+ * @param addresses - Any-case addresses.
+ * @param options - Same as {@link resolveName}.
+ * @returns A map from the (checksummed) input address to its resolved name, or null.
+ */
+export declare function resolveNames(chainId: ChainId, addresses: string[], options?: ResolveNameOptions): Promise<Record<string, AddressName | null>>;
+export default resolveName;

package/dist/types/utils/contracts.d.ts

@@ -224,12 +224,14 @@ export declare const getConfigs: () => {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
                 rwaindextokenadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -238,6 +240,7 @@ export declare const getConfigs: () => {
                 raacnftadapter: {
                     id: string;
                     name: string;
+                    label: string;
                     contract: string;
                     type: string;
                 };
@@ -481,12 +484,14 @@ declare const _default: {
                     raacnftadapter: {
                         id: string;
                         name: string;
+                        label: string;
                         contract: string;
                         type: string;
                     };
                     rwaindextokenadapter: {
                         id: string;
                         name: string;
+                        label: string;
                         contract: string;
                         type: string;
                     };
@@ -495,6 +500,7 @@ declare const _default: {
                     raacnftadapter: {
                         id: string;
                         name: string;
+                        label: string;
                         contract: string;
                         type: string;
                     };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@raac/rpc",
-	"version": "2.0.0-beta.0",
+	"version": "2.0.0-beta.2",
 	"description": "RPC Library for RAAC",
 	"main": "dist/index.js",
 	"types": "dist/types/index.d.ts",