@hyperlane-xyz/registry 1.1.1 → 1.2.0

package/dist/chainAddresses.d.ts

@@ -261,6 +261,24 @@ export declare const chainAddresses: {
         timelockController: string;
         validatorAnnounce: string;
     };
+    holesky: {
+        mailbox: string;
+        proxyAdmin: string;
+        validatorAnnounce: string;
+        testRecipient: string;
+        staticMerkleRootMultisigIsmFactory: string;
+        staticMessageIdMultisigIsmFactory: string;
+        staticAggregationIsmFactory: string;
+        staticAggregationHookFactory: string;
+        domainRoutingIsmFactory: string;
+        interchainSecurityModule: string;
+        merkleTreeHook: string;
+        fallbackRoutingHook: string;
+        pausableHook: string;
+        storageGasOracle: string;
+        interchainGasPaymaster: string;
+        protocolFee: string;
+    };
     inevm: {
         aggregationHook: string;
         domainRoutingIsm: string;

package/dist/chainAddresses.js

@@ -261,6 +261,24 @@ export const chainAddresses = {
         "timelockController": "0x0000000000000000000000000000000000000000",
         "validatorAnnounce": "0x87ED6926abc9E38b9C7C19f835B41943b622663c"
     },
+    "holesky": {
+        "mailbox": "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc",
+        "proxyAdmin": "0x33dB966328Ea213b0f76eF96CA368AB37779F065",
+        "validatorAnnounce": "0xAb9B273366D794B7F80B4378bc8Aaca75C6178E2",
+        "testRecipient": "0x86fb9F1c124fB20ff130C41a79a432F770f67AFD",
+        "staticMerkleRootMultisigIsmFactory": "0xC2E36cd6e32e194EE11f15D9273B64461A4D49A2",
+        "staticMessageIdMultisigIsmFactory": "0x6966b0E55883d49BFB24539356a2f8A673E02039",
+        "staticAggregationIsmFactory": "0x54148470292C24345fb828B003461a9444414517",
+        "staticAggregationHookFactory": "0x589C201a07c26b4725A4A829d772f24423da480B",
+        "domainRoutingIsmFactory": "0xDDcFEcF17586D08A5740B7D91735fcCE3dfe3eeD",
+        "interchainSecurityModule": "0x751f2b684EeBb916dB777767CCb8fd793C8b2956",
+        "merkleTreeHook": "0x98AAE089CaD930C64a76dD2247a2aC5773a4B8cE",
+        "fallbackRoutingHook": "0x07009DA2249c388aD0f416a235AfE90D784e1aAc",
+        "pausableHook": "0xF7561c34f17A32D5620583A3397C304e7038a7F6",
+        "storageGasOracle": "0x2b2a158B4059C840c7aC67399B153bb567D06303",
+        "interchainGasPaymaster": "0x5CBf4e70448Ed46c2616b04e9ebc72D29FF0cfA9",
+        "protocolFee": "0x6b1bb4ce664Bb4164AEB4d3D2E7DE7450DD8084C"
+    },
     "inevm": {
         "aggregationHook": "0xe0dDb5dE7D52918237cC1Ae131F29dcAbcb0F62B",
         "domainRoutingIsm": "0xBD70Ea9D599a0FC8158B026797177773C3445730",

package/dist/chainMetadata.js

@@ -485,6 +485,36 @@ export const chainMetadata = {
             }
         ]
     },
+    "holesky": {
+        "blockExplorers": [
+            {
+                "apiUrl": "https://api-holesky.etherscan.io/api",
+                "family": "etherscan",
+                "name": "Etherscan",
+                "url": "https://holesky.etherscan.io"
+            }
+        ],
+        "blocks": {
+            "confirmations": 1,
+            "estimateBlockTime": 13,
+            "reorgPeriod": 2
+        },
+        "name": "holesky",
+        "chainId": 17000,
+        "isTestnet": true,
+        "domainId": 17000,
+        "protocol": "ethereum",
+        "nativeToken": {
+            "decimals": 18,
+            "name": "Ether",
+            "symbol": "ETH"
+        },
+        "rpcUrls": [
+            {
+                "http": "https://ethereum-holesky-rpc.publicnode.com"
+            }
+        ]
+    },
     "inevm": {
         "blockExplorers": [
             {

package/dist/chains/holesky/addresses.d.ts

@@ -0,0 +1,18 @@
+export declare const addresses: {
+    mailbox: string;
+    proxyAdmin: string;
+    validatorAnnounce: string;
+    testRecipient: string;
+    staticMerkleRootMultisigIsmFactory: string;
+    staticMessageIdMultisigIsmFactory: string;
+    staticAggregationIsmFactory: string;
+    staticAggregationHookFactory: string;
+    domainRoutingIsmFactory: string;
+    interchainSecurityModule: string;
+    merkleTreeHook: string;
+    fallbackRoutingHook: string;
+    pausableHook: string;
+    storageGasOracle: string;
+    interchainGasPaymaster: string;
+    protocolFee: string;
+};

package/dist/chains/holesky/addresses.js

@@ -0,0 +1,18 @@
+export const addresses = {
+    "mailbox": "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc",
+    "proxyAdmin": "0x33dB966328Ea213b0f76eF96CA368AB37779F065",
+    "validatorAnnounce": "0xAb9B273366D794B7F80B4378bc8Aaca75C6178E2",
+    "testRecipient": "0x86fb9F1c124fB20ff130C41a79a432F770f67AFD",
+    "staticMerkleRootMultisigIsmFactory": "0xC2E36cd6e32e194EE11f15D9273B64461A4D49A2",
+    "staticMessageIdMultisigIsmFactory": "0x6966b0E55883d49BFB24539356a2f8A673E02039",
+    "staticAggregationIsmFactory": "0x54148470292C24345fb828B003461a9444414517",
+    "staticAggregationHookFactory": "0x589C201a07c26b4725A4A829d772f24423da480B",
+    "domainRoutingIsmFactory": "0xDDcFEcF17586D08A5740B7D91735fcCE3dfe3eeD",
+    "interchainSecurityModule": "0x751f2b684EeBb916dB777767CCb8fd793C8b2956",
+    "merkleTreeHook": "0x98AAE089CaD930C64a76dD2247a2aC5773a4B8cE",
+    "fallbackRoutingHook": "0x07009DA2249c388aD0f416a235AfE90D784e1aAc",
+    "pausableHook": "0xF7561c34f17A32D5620583A3397C304e7038a7F6",
+    "storageGasOracle": "0x2b2a158B4059C840c7aC67399B153bb567D06303",
+    "interchainGasPaymaster": "0x5CBf4e70448Ed46c2616b04e9ebc72D29FF0cfA9",
+    "protocolFee": "0x6b1bb4ce664Bb4164AEB4d3D2E7DE7450DD8084C"
+};

package/dist/chains/holesky/addresses.json

@@ -0,0 +1,18 @@
+{
+  "mailbox": "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc",
+  "proxyAdmin": "0x33dB966328Ea213b0f76eF96CA368AB37779F065",
+  "validatorAnnounce": "0xAb9B273366D794B7F80B4378bc8Aaca75C6178E2",
+  "testRecipient": "0x86fb9F1c124fB20ff130C41a79a432F770f67AFD",
+  "staticMerkleRootMultisigIsmFactory": "0xC2E36cd6e32e194EE11f15D9273B64461A4D49A2",
+  "staticMessageIdMultisigIsmFactory": "0x6966b0E55883d49BFB24539356a2f8A673E02039",
+  "staticAggregationIsmFactory": "0x54148470292C24345fb828B003461a9444414517",
+  "staticAggregationHookFactory": "0x589C201a07c26b4725A4A829d772f24423da480B",
+  "domainRoutingIsmFactory": "0xDDcFEcF17586D08A5740B7D91735fcCE3dfe3eeD",
+  "interchainSecurityModule": "0x751f2b684EeBb916dB777767CCb8fd793C8b2956",
+  "merkleTreeHook": "0x98AAE089CaD930C64a76dD2247a2aC5773a4B8cE",
+  "fallbackRoutingHook": "0x07009DA2249c388aD0f416a235AfE90D784e1aAc",
+  "pausableHook": "0xF7561c34f17A32D5620583A3397C304e7038a7F6",
+  "storageGasOracle": "0x2b2a158B4059C840c7aC67399B153bb567D06303",
+  "interchainGasPaymaster": "0x5CBf4e70448Ed46c2616b04e9ebc72D29FF0cfA9",
+  "protocolFee": "0x6b1bb4ce664Bb4164AEB4d3D2E7DE7450DD8084C"
+}

package/dist/chains/holesky/addresses.yaml

@@ -0,0 +1,16 @@
+mailbox: "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc"
+proxyAdmin: "0x33dB966328Ea213b0f76eF96CA368AB37779F065"
+validatorAnnounce: "0xAb9B273366D794B7F80B4378bc8Aaca75C6178E2"
+testRecipient: "0x86fb9F1c124fB20ff130C41a79a432F770f67AFD"
+staticMerkleRootMultisigIsmFactory: "0xC2E36cd6e32e194EE11f15D9273B64461A4D49A2"
+staticMessageIdMultisigIsmFactory: "0x6966b0E55883d49BFB24539356a2f8A673E02039"
+staticAggregationIsmFactory: "0x54148470292C24345fb828B003461a9444414517"
+staticAggregationHookFactory: "0x589C201a07c26b4725A4A829d772f24423da480B"
+domainRoutingIsmFactory: "0xDDcFEcF17586D08A5740B7D91735fcCE3dfe3eeD"
+interchainSecurityModule: "0x751f2b684EeBb916dB777767CCb8fd793C8b2956"
+merkleTreeHook: "0x98AAE089CaD930C64a76dD2247a2aC5773a4B8cE"
+fallbackRoutingHook: "0x07009DA2249c388aD0f416a235AfE90D784e1aAc"
+pausableHook: "0xF7561c34f17A32D5620583A3397C304e7038a7F6"
+storageGasOracle: "0x2b2a158B4059C840c7aC67399B153bb567D06303"
+interchainGasPaymaster: "0x5CBf4e70448Ed46c2616b04e9ebc72D29FF0cfA9"
+protocolFee: "0x6b1bb4ce664Bb4164AEB4d3D2E7DE7450DD8084C"

package/dist/chains/holesky/index.d.ts

@@ -0,0 +1,2 @@
+export { metadata } from './metadata.js';
+export { addresses } from './addresses.js';

package/dist/chains/holesky/index.js

@@ -0,0 +1,2 @@
+export { metadata } from './metadata.js';
+export { addresses } from './addresses.js';

package/dist/chains/holesky/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" fill-rule="evenodd" clip-rule="evenodd" viewBox="-150 0 1100 1277.4"><g fill-rule="nonzero"><path fill="#343434" d="m392.1 0-8.6 29.1v844.6l8.6 8.6 392-231.8z"/><path fill="#8C8C8C" d="M392.1 0 0 650.5l392.1 231.8v-410z"/><path fill="#3C3C3B" d="m392.1 956.5-4.9 5.9v300.9l4.9 14.1 392.3-552.5z"/><path fill="#8C8C8C" d="M392.1 1277.4V956.5L0 724.9z"/><path fill="#141414" d="m392.1 882.3 392-231.8-392-178.2z"/><path fill="#393939" d="m0 650.5 392.1 231.8v-410z"/></g></svg>

package/dist/chains/holesky/metadata.d.ts

@@ -0,0 +1,2 @@
+import type { ChainMetadata } from '@hyperlane-xyz/sdk';
+export declare const metadata: ChainMetadata;

package/dist/chains/holesky/metadata.js

@@ -0,0 +1,30 @@
+export const metadata = {
+    "blockExplorers": [
+        {
+            "apiUrl": "https://api-holesky.etherscan.io/api",
+            "family": "etherscan",
+            "name": "Etherscan",
+            "url": "https://holesky.etherscan.io"
+        }
+    ],
+    "blocks": {
+        "confirmations": 1,
+        "estimateBlockTime": 13,
+        "reorgPeriod": 2
+    },
+    "name": "holesky",
+    "chainId": 17000,
+    "isTestnet": true,
+    "domainId": 17000,
+    "protocol": "ethereum",
+    "nativeToken": {
+        "decimals": 18,
+        "name": "Ether",
+        "symbol": "ETH"
+    },
+    "rpcUrls": [
+        {
+            "http": "https://ethereum-holesky-rpc.publicnode.com"
+        }
+    ]
+};

package/dist/chains/holesky/metadata.json

@@ -0,0 +1,30 @@
+{
+  "blockExplorers": [
+    {
+      "apiUrl": "https://api-holesky.etherscan.io/api",
+      "family": "etherscan",
+      "name": "Etherscan",
+      "url": "https://holesky.etherscan.io"
+    }
+  ],
+  "blocks": {
+    "confirmations": 1,
+    "estimateBlockTime": 13,
+    "reorgPeriod": 2
+  },
+  "name": "holesky",
+  "chainId": 17000,
+  "isTestnet": true,
+  "domainId": 17000,
+  "protocol": "ethereum",
+  "nativeToken": {
+    "decimals": 18,
+    "name": "Ether",
+    "symbol": "ETH"
+  },
+  "rpcUrls": [
+    {
+      "http": "https://ethereum-holesky-rpc.publicnode.com"
+    }
+  ]
+}

package/dist/chains/holesky/metadata.yaml

@@ -0,0 +1,21 @@
+# yaml-language-server: $schema=../schema.json
+blockExplorers:
+  - apiUrl: https://api-holesky.etherscan.io/api
+    family: etherscan
+    name: Etherscan
+    url: https://holesky.etherscan.io
+blocks:
+  confirmations: 1
+  estimateBlockTime: 13
+  reorgPeriod: 2
+name: holesky
+chainId: 17000
+isTestnet: true
+domainId: 17000
+protocol: ethereum
+nativeToken:
+  decimals: 18
+  name: Ether
+  symbol: ETH
+rpcUrls:
+  - http: https://ethereum-holesky-rpc.publicnode.com

package/dist/index.d.ts

@@ -34,6 +34,8 @@ export { metadata as fuji } from './chains/fuji/metadata.js';
 export { addresses as fujiAddresses } from './chains/fuji/addresses.js';
 export { metadata as gnosis } from './chains/gnosis/metadata.js';
 export { addresses as gnosisAddresses } from './chains/gnosis/addresses.js';
+export { metadata as holesky } from './chains/holesky/metadata.js';
+export { addresses as holeskyAddresses } from './chains/holesky/addresses.js';
 export { metadata as inevm } from './chains/inevm/metadata.js';
 export { addresses as inevmAddresses } from './chains/inevm/addresses.js';
 export { metadata as injective } from './chains/injective/metadata.js';

package/dist/index.js

@@ -34,6 +34,8 @@ export { metadata as fuji } from './chains/fuji/metadata.js';
 export { addresses as fujiAddresses } from './chains/fuji/addresses.js';
 export { metadata as gnosis } from './chains/gnosis/metadata.js';
 export { addresses as gnosisAddresses } from './chains/gnosis/addresses.js';
+export { metadata as holesky } from './chains/holesky/metadata.js';
+export { addresses as holeskyAddresses } from './chains/holesky/addresses.js';
 export { metadata as inevm } from './chains/inevm/metadata.js';
 export { addresses as inevmAddresses } from './chains/inevm/addresses.js';
 export { metadata as injective } from './chains/injective/metadata.js';

package/dist/registry/BaseRegistry.d.ts

@@ -9,7 +9,9 @@ export declare abstract class BaseRegistry implements IRegistry {
     protected readonly logger: Logger;
     protected listContentCache?: RegistryContent;
     protected metadataCache?: ChainMap<ChainMetadata>;
+    protected isMetadataCacheFull: boolean;
     protected addressCache?: ChainMap<ChainAddresses>;
+    protected isAddressCacheFull: boolean;
     constructor({ uri, logger }: {
         uri: string;
         logger?: Logger;
@@ -25,6 +27,7 @@ export declare abstract class BaseRegistry implements IRegistry {
     abstract getChainMetadata(chainName: ChainName): MaybePromise<ChainMetadata | null>;
     abstract getAddresses(): MaybePromise<ChainMap<ChainAddresses>>;
     abstract getChainAddresses(chainName: ChainName): MaybePromise<ChainAddresses | null>;
+    getChainLogoUri(chainName: ChainName): Promise<string | null>;
     abstract addChain(chain: {
         chainName: ChainName;
         metadata?: ChainMetadata;

package/dist/registry/BaseRegistry.js

@@ -1,11 +1,13 @@
-export const CHAIN_FILE_REGEX = /chains\/([a-z0-9]+)\/([a-z]+)\.yaml/;
+export const CHAIN_FILE_REGEX = /chains\/([a-z0-9]+)\/([a-z]+)\.(yaml|svg)/;
 export class BaseRegistry {
     uri;
     logger;
     // Caches
     listContentCache;
     metadataCache;
+    isMetadataCacheFull = false;
     addressCache;
+    isAddressCacheFull = false;
     constructor({ uri, logger }) {
         this.uri = uri;
         // @ts-ignore forcing in to avoid a @hyperlane-xyz/utils
@@ -30,4 +32,9 @@ export class BaseRegistry {
         const basePath = `deployments/warp_routes/${symbol}/${chains}`;
         return { configPath: `${basePath}-config.yaml`, addressesPath: `${basePath}-addresses.yaml` };
     }
+    async getChainLogoUri(chainName) {
+        const registryContent = await this.listRegistryContent();
+        const chain = registryContent.chains[chainName];
+        return chain?.logo ?? null;
+    }
 }

package/dist/registry/GithubRegistry.d.ts

@@ -19,9 +19,9 @@ export declare class GithubRegistry extends BaseRegistry implements IRegistry {
     listRegistryContent(): Promise<RegistryContent>;
     getChains(): Promise<Array<ChainName>>;
     getMetadata(): Promise<ChainMap<ChainMetadata>>;
-    getChainMetadata(chainName: ChainName): Promise<ChainMetadata>;
+    getChainMetadata(chainName: ChainName): Promise<ChainMetadata | null>;
     getAddresses(): Promise<ChainMap<ChainAddresses>>;
-    getChainAddresses(chainName: ChainName): Promise<ChainAddresses>;
+    getChainAddresses(chainName: ChainName): Promise<ChainAddresses | null>;
     addChain(_chains: {
         chainName: ChainName;
         metadata?: ChainMetadata;
@@ -35,6 +35,7 @@ export declare class GithubRegistry extends BaseRegistry implements IRegistry {
     removeChain(_chains: ChainName): Promise<void>;
     addWarpRoute(_config: WarpCoreConfig): Promise<void>;
     protected getRawContentUrl(path: string): string;
-    protected fetchChainFiles<T>(fileName: keyof ChainFiles): Promise<ChainMap<T>>;
+    protected fetchChainFiles<T>(fileName: keyof ChainFiles, chainNames?: ChainName[]): Promise<ChainMap<T>>;
+    protected fetchSingleChainFile<T>(fileName: keyof ChainFiles, chainName: ChainName): Promise<T | null>;
     protected fetch(url: string): Promise<Response>;
 }

package/dist/registry/GithubRegistry.js

@@ -1,6 +1,5 @@
 import { parse as yamlParse } from 'yaml';
 import { DEFAULT_GITHUB_REGISTRY, GITHUB_FETCH_CONCURRENCY_LIMIT } from '../consts.js';
-import { ChainAddressesSchema } from '../types.js';
 import { concurrentMap } from '../utils.js';
 import { BaseRegistry, CHAIN_FILE_REGEX } from './BaseRegistry.js';
 import { RegistryType, } from './IRegistry.js';
@@ -33,10 +32,10 @@ export class GithubRegistry extends BaseRegistry {
         const chains = {};
         for (const node of tree) {
             if (CHAIN_FILE_REGEX.test(node.path)) {
-                const [_, chainName, fileName] = node.path.match(CHAIN_FILE_REGEX);
+                const [_, chainName, fileName, extension] = node.path.match(CHAIN_FILE_REGEX);
                 chains[chainName] ??= {};
                 // @ts-ignore allow dynamic key assignment
-                chains[chainName][fileName] = this.getRawContentUrl(`${chainPath}/${chainName}/${fileName}.yaml`);
+                chains[chainName][fileName] = this.getRawContentUrl(`${chainPath}/${chainName}/${fileName}.${extension}`);
             }
             // TODO add handling for deployment artifact files here too
         }
@@ -47,32 +46,36 @@ export class GithubRegistry extends BaseRegistry {
         return Object.keys(repoContents.chains);
     }
     async getMetadata() {
-        if (this.metadataCache)
+        if (this.metadataCache && this.isMetadataCacheFull)
             return this.metadataCache;
         const chainMetadata = await this.fetchChainFiles('metadata');
+        this.isMetadataCacheFull = true;
         return (this.metadataCache = chainMetadata);
     }
     async getChainMetadata(chainName) {
         if (this.metadataCache?.[chainName])
             return this.metadataCache[chainName];
-        const url = this.getRawContentUrl(`${this.getChainsPath()}/${chainName}/metadata.yaml`);
-        const response = await this.fetch(url);
-        const data = await response.text();
-        return yamlParse(data);
+        const data = await this.fetchSingleChainFile('metadata', chainName);
+        if (!data)
+            return null;
+        this.metadataCache = { ...this.metadataCache, [chainName]: data };
+        return data;
     }
     async getAddresses() {
-        if (this.addressCache)
+        if (this.addressCache && this.isAddressCacheFull)
             return this.addressCache;
         const chainAddresses = await this.fetchChainFiles('addresses');
+        this.isAddressCacheFull = true;
         return (this.addressCache = chainAddresses);
     }
     async getChainAddresses(chainName) {
         if (this.addressCache?.[chainName])
             return this.addressCache[chainName];
-        const url = this.getRawContentUrl(`${this.getChainsPath()}/${chainName}/addresses.yaml`);
-        const response = await this.fetch(url);
-        const data = await response.text();
-        return ChainAddressesSchema.parse(yamlParse(data));
+        const data = await this.fetchSingleChainFile('addresses', chainName);
+        if (!data)
+            return null;
+        this.addressCache = { ...this.addressCache, [chainName]: data };
+        return data;
     }
     async addChain(_chains) {
         throw new Error('TODO: Implement');
@@ -89,9 +92,11 @@ export class GithubRegistry extends BaseRegistry {
     getRawContentUrl(path) {
         return `https://raw.githubusercontent.com/${this.repoOwner}/${this.repoName}/${this.branch}/${path}`;
     }
-    async fetchChainFiles(fileName) {
+    // Fetches all files of a particular type in parallel
+    // Defaults to all known chains if chainNames is not provided
+    async fetchChainFiles(fileName, chainNames) {
         const repoContents = await this.listRegistryContent();
-        const chainNames = Object.keys(repoContents.chains);
+        chainNames ||= Object.keys(repoContents.chains);
         const fileUrls = chainNames.reduce((acc, chainName) => {
             const fileUrl = repoContents.chains[chainName][fileName];
             if (fileUrl)
@@ -105,6 +110,10 @@ export class GithubRegistry extends BaseRegistry {
         });
         return Object.fromEntries(results);
     }
+    async fetchSingleChainFile(fileName, chainName) {
+        const results = await this.fetchChainFiles(fileName, [chainName]);
+        return results[chainName] ?? null;
+    }
     async fetch(url) {
         this.logger.debug(`Fetching from github: ${url}`);
         const response = await fetch(url);

package/dist/registry/IRegistry.d.ts

@@ -3,6 +3,7 @@ import type { ChainAddresses, MaybePromise } from '../types.js';
 export interface ChainFiles {
     metadata?: string;
     addresses?: string;
+    logo?: string;
 }
 export interface RegistryContent {
     chains: ChainMap<ChainFiles>;
@@ -21,6 +22,7 @@ export interface IRegistry {
     getChainMetadata(chainName: ChainName): MaybePromise<ChainMetadata | null>;
     getAddresses(): MaybePromise<ChainMap<ChainAddresses>>;
     getChainAddresses(chainName: ChainName): MaybePromise<ChainAddresses | null>;
+    getChainLogoUri(chainName: ChainName): Promise<string | null>;
     addChain(chain: {
         chainName: ChainName;
         metadata?: ChainMetadata;

package/dist/registry/LocalRegistry.d.ts

@@ -13,9 +13,9 @@ export declare class LocalRegistry extends BaseRegistry implements IRegistry {
     listRegistryContent(): RegistryContent;
     getChains(): Array<ChainName>;
     getMetadata(): ChainMap<ChainMetadata>;
-    getChainMetadata(chainName: ChainName): ChainMetadata;
+    getChainMetadata(chainName: ChainName): ChainMetadata | null;
     getAddresses(): ChainMap<ChainAddresses>;
-    getChainAddresses(chainName: ChainName): ChainAddresses;
+    getChainAddresses(chainName: ChainName): ChainAddresses | null;
     addChain(chain: {
         chainName: ChainName;
         metadata?: ChainMetadata;

package/dist/registry/LocalRegistry.js

@@ -47,9 +47,7 @@ export class LocalRegistry extends BaseRegistry {
     }
     getChainMetadata(chainName) {
         const metadata = this.getMetadata();
-        if (!metadata[chainName])
-            throw new Error(`Metadata not found in registry for chain: ${chainName}`);
-        return metadata[chainName];
+        return metadata[chainName] ?? null;
     }
     getAddresses() {
         if (this.addressCache)
@@ -66,9 +64,7 @@ export class LocalRegistry extends BaseRegistry {
     }
     getChainAddresses(chainName) {
         const addresses = this.getAddresses();
-        if (!addresses[chainName])
-            throw new Error(`Addresses not found in registry for chain: ${chainName}`);
-        return addresses[chainName];
+        return addresses[chainName] ?? null;
     }
     addChain(chain) {
         const currentChains = this.listRegistryContent().chains;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hyperlane-xyz/registry",
   "description": "A collection of configs, artifacts, and schemas for Hyperlane",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "dependencies": {
     "yaml": "^2",
     "zod": "^3.21.2"