@hyperlane-xyz/sdk 1.4.3-beta0 → 1.4.3-beta2

package/dist/providers/MultiProtocolProvider.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiProtocolProvider = void 0;
+const debug_1 = require("debug");
+const utils_1 = require("@hyperlane-xyz/utils");
+const chainMetadata_1 = require("../consts/chainMetadata");
+const ChainMetadataManager_1 = require("../metadata/ChainMetadataManager");
+const ProviderType_1 = require("./ProviderType");
+const providerBuilders_1 = require("./providerBuilders");
+/**
+ * A version of MultiProvider that can support different
+ * provider types across different protocol types.
+ *
+ * This uses a different interface for provider/signer related methods
+ * so it isn't strictly backwards compatible with MultiProvider.
+ *
+ * Unlike MultiProvider, this class does not support signer/signing methods (yet).
+ * @typeParam MetaExt - Extra metadata fields for chains (such as contract addresses)
+ */
+class MultiProtocolProvider extends ChainMetadataManager_1.ChainMetadataManager {
+    constructor(chainMetadata = chainMetadata_1.chainMetadata, options = {}) {
+        super(chainMetadata, options);
+        this.options = options;
+        this.providers = {};
+        this.signers = {}; // TODO signer support
+        this.logger = (0, debug_1.debug)(options?.loggerName || 'hyperlane:MultiProtocolProvider');
+        this.providerBuilders =
+            options.providerBuilders || providerBuilders_1.defaultProviderBuilderMap;
+    }
+    static fromMultiProvider(mp, options = {}) {
+        const newMp = new MultiProtocolProvider(mp.metadata, options);
+        const typedProviders = (0, utils_1.objMap)(mp.providers, (_, provider) => ({
+            type: ProviderType_1.ProviderType.EthersV5,
+            provider,
+        }));
+        newMp.setProviders(typedProviders);
+        return newMp;
+    }
+    extendChainMetadata(additionalMetadata) {
+        const newMetadata = super.extendChainMetadata(additionalMetadata).metadata;
+        return new MultiProtocolProvider(newMetadata, this.options);
+    }
+    tryGetProvider(chainNameOrId, type) {
+        var _a;
+        const metadata = this.tryGetChainMetadata(chainNameOrId);
+        if (!metadata)
+            return null;
+        const { name, chainId, rpcUrls } = metadata;
+        if (this.providers[name]?.[type])
+            return this.providers[name][type];
+        const builder = this.providerBuilders[type];
+        if (!rpcUrls.length || !builder)
+            return null;
+        const provider = builder(rpcUrls, chainId);
+        (_a = this.providers)[name] || (_a[name] = {});
+        this.providers[name][type] = provider;
+        return provider;
+    }
+    getProvider(chainNameOrId, type) {
+        const provider = this.tryGetProvider(chainNameOrId, type);
+        if (!provider)
+            throw new Error(`No provider available for ${chainNameOrId}`);
+        return provider;
+    }
+    getEthersV5Provider(chainNameOrId) {
+        const provider = this.getProvider(chainNameOrId, ProviderType_1.ProviderType.EthersV5);
+        if (provider.type !== ProviderType_1.ProviderType.EthersV5)
+            throw new Error('Invalid provider type');
+        return provider.provider;
+    }
+    // getEthersV6Provider(
+    //   chainNameOrId: ChainName | number,
+    // ): EthersV6Provider['provider'] {
+    //   const provider = this.getProvider(chainNameOrId, ProviderType.EthersV5);
+    //   if (provider.type !== ProviderType.EthersV6)
+    //     throw new Error('Invalid provider type');
+    //   return provider.provider;
+    // }
+    getViemProvider(chainNameOrId) {
+        const provider = this.getProvider(chainNameOrId, ProviderType_1.ProviderType.EthersV5);
+        if (provider.type !== ProviderType_1.ProviderType.Viem)
+            throw new Error('Invalid provider type');
+        return provider.provider;
+    }
+    getSolanaWeb3Provider(chainNameOrId) {
+        const provider = this.getProvider(chainNameOrId, ProviderType_1.ProviderType.EthersV5);
+        if (provider.type !== ProviderType_1.ProviderType.SolanaWeb3)
+            throw new Error('Invalid provider type');
+        return provider.provider;
+    }
+    setProvider(chainNameOrId, provider) {
+        var _a;
+        const chainName = this.getChainName(chainNameOrId);
+        (_a = this.providers)[chainName] || (_a[chainName] = {});
+        this.providers[chainName][provider.type] = provider;
+        return provider;
+    }
+    setProviders(providers) {
+        for (const chain of Object.keys(providers)) {
+            this.setProvider(chain, providers[chain]);
+        }
+    }
+}
+exports.MultiProtocolProvider = MultiProtocolProvider;
+//# sourceMappingURL=MultiProtocolProvider.js.map

package/dist/providers/MultiProtocolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiProtocolProvider.js","sourceRoot":"","sources":["../../src/providers/MultiProtocolProvider.ts"],"names":[],"mappings":"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"}

package/dist/providers/MultiProtocolProvider.test.d.ts

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

package/dist/providers/MultiProtocolProvider.test.d.ts.map

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

package/dist/providers/MultiProtocolProvider.test.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const chainMetadata_1 = require("../consts/chainMetadata");
+const chains_1 = require("../consts/chains");
+const MultiProtocolProvider_1 = require("../providers/MultiProtocolProvider");
+describe('MultiProtocolProvider', () => {
+    describe('constructs', () => {
+        it('creates a multi protocol provider without type extension', async () => {
+            const multiProvider = new MultiProtocolProvider_1.MultiProtocolProvider();
+            const ethMetadata = multiProvider.getChainMetadata(chains_1.Chains.ethereum);
+            (0, chai_1.expect)(ethMetadata.name).to.equal(chains_1.Chains.ethereum);
+        });
+        it('creates a multi protocol provider with type extension', async () => {
+            const multiProvider = new MultiProtocolProvider_1.MultiProtocolProvider({
+                [chains_1.Chains.ethereum]: { ...chainMetadata_1.ethereum, foo: '0x123', bar: 1 },
+            });
+            const ethMetadata = multiProvider.getChainMetadata(chains_1.Chains.ethereum);
+            (0, chai_1.expect)(ethMetadata.foo).to.equal('0x123');
+            (0, chai_1.expect)(ethMetadata.bar).to.equal(1);
+        });
+    });
+});
+//# sourceMappingURL=MultiProtocolProvider.test.js.map

package/dist/providers/MultiProtocolProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiProtocolProvider.test.js","sourceRoot":"","sources":["../../src/providers/MultiProtocolProvider.test.ts"],"names":[],"mappings":";;AAAA,+BAA8B;AAE9B,2DAAmD;AACnD,6CAA0C;AAC1C,8EAA2E;AAE3E,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,aAAa,GAAG,IAAI,6CAAqB,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,aAAa,CAAC,gBAAgB,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC;YACpE,IAAA,aAAM,EAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,aAAa,GAAG,IAAI,6CAAqB,CAG5C;gBACD,CAAC,eAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,wBAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;aACzD,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,aAAa,CAAC,gBAAgB,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC;YACpE,IAAA,aAAM,EAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAA,aAAM,EAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/providers/MultiProvider.d.ts

@@ -1,87 +1,33 @@
 import { Debugger } from 'debug';
 import { BigNumber, ContractReceipt, ContractTransaction, PopulatedTransaction, Signer, providers } from 'ethers';
-import { types } from '@hyperlane-xyz/utils';
+import { Address } from '@hyperlane-xyz/utils';
+import { ChainMetadataManager } from '../metadata/ChainMetadataManager';
 import { ChainMetadata } from '../metadata/chainMetadataTypes';
 import { ChainMap, ChainName } from '../types';
-import { RetryProviderOptions } from './RetryProvider';
+import { ProviderBuilderFn } from './providerBuilders';
 type Provider = providers.Provider;
-export declare function defaultProviderBuilder(rpcUrls: ChainMetadata['rpcUrls'], network: providers.Networkish, retryOverride?: RetryProviderOptions): Provider;
-export type ProviderBuilderFn = typeof defaultProviderBuilder;
-interface MultiProviderOptions {
+export interface MultiProviderOptions {
     loggerName?: string;
-    providerBuilder?: ProviderBuilderFn;
+    providerBuilder?: ProviderBuilderFn<Provider>;
 }
-export declare class MultiProvider {
-    readonly metadata: ChainMap<ChainMetadata>;
-    protected readonly providers: ChainMap<Provider>;
-    protected readonly providerBuilder: ProviderBuilderFn;
-    protected signers: ChainMap<Signer>;
-    protected useSharedSigner: boolean;
-    protected readonly logger: Debugger;
+/**
+ * A utility class to create and manage providers and signers for multiple chains
+ * @typeParam MetaExt - Extra metadata fields for chains (such as contract addresses)
+ */
+export declare class MultiProvider<MetaExt = {}> extends ChainMetadataManager<MetaExt> {
+    readonly options: MultiProviderOptions;
+    readonly providers: ChainMap<Provider>;
+    readonly providerBuilder: ProviderBuilderFn<Provider>;
+    signers: ChainMap<Signer>;
+    useSharedSigner: boolean;
+    readonly logger: Debugger;
     /**
      * Create a new MultiProvider with the given chainMetadata,
      * or the SDK's default metadata if not provided
      */
-    constructor(chainMetadata?: ChainMap<ChainMetadata>, options?: MultiProviderOptions);
-    /**
-     * Add a chain to the MultiProvider
-     * @throws if chain's name or domain/chain ID collide
-     */
-    addChain(metadata: ChainMetadata): void;
-    /**
-     * Get the metadata for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    tryGetChainMetadata(chainNameOrId: ChainName | number): ChainMetadata | null;
-    /**
-     * Get the metadata for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainMetadata(chainNameOrId: ChainName | number): ChainMetadata;
-    /**
-     * Get the name for a given chain name, chain id, or domain id
-     */
-    tryGetChainName(chainNameOrId: ChainName | number): string | null;
-    /**
-     * Get the name for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainName(chainNameOrId: ChainName | number): string;
-    /**
-     * Get the names for all chains known to this MultiProvider
-     */
-    getKnownChainNames(): string[];
-    /**
-     * Get the id for a given chain name, chain id, or domain id
-     */
-    tryGetChainId(chainNameOrId: ChainName | number): number | null;
-    /**
-     * Get the id for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainId(chainNameOrId: ChainName | number): number;
-    /**
-     * Get the ids for all chains known to this MultiProvider
-     */
-    getKnownChainIds(): number[];
-    /**
-     * Get the domain id for a given chain name, chain id, or domain id
-     */
-    tryGetDomainId(chainNameOrId: ChainName | number): number | null;
-    /**
-     * Get the domain id for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getDomainId(chainNameOrId: ChainName | number): number;
-    /**
-     * Get the domain ids for a list of chain names, chain ids, or domain ids
-     * @throws if any chain's metadata has not been set
-     */
-    getDomainIds(chainNamesOrIds: Array<ChainName | number>): number[];
-    /**
-     * Get the ids for all chains known to this MultiProvider
-     */
-    getKnownDomainIds(): number[];
+    constructor(chainMetadata?: ChainMap<ChainMetadata<MetaExt>>, options?: MultiProviderOptions);
+    addChain(metadata: ChainMetadata<MetaExt>): void;
+    extendChainMetadata<NewExt = {}>(additionalMetadata: ChainMap<NewExt>): MultiProvider<MetaExt & NewExt>;
     /**
      * Get an Ethers provider for a given chain name, chain id, or domain id
      */
@@ -116,7 +62,7 @@ export declare class MultiProvider {
      * Get an Ethers signer for a given chain name, chain id, or domain id
      * @throws if chain's metadata or signer has not been set
      */
-    getSignerAddress(chainNameOrId: ChainName | number): Promise<types.Address>;
+    getSignerAddress(chainNameOrId: ChainName | number): Promise<Address>;
     /**
      * Sets an Ethers Signer for a given chain name, chain id, or domain id
      * @throws if chain's metadata has not been set or shared signer has already been set
@@ -148,48 +94,8 @@ export declare class MultiProvider {
      */
     intersect(chains: ChainName[], throwIfNotSubset?: boolean): {
         intersection: ChainName[];
-        multiProvider: MultiProvider;
+        multiProvider: MultiProvider<MetaExt>;
     };
-    /**
-     * Get chain names excluding given chain name
-     */
-    getRemoteChains(name: ChainName): ChainName[];
-    /**
-     * Get an RPC URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getRpcUrl(chainNameOrId: ChainName | number): string;
-    /**
-     * Get a block explorer URL for a given chain name, chain id, or domain id
-     */
-    tryGetExplorerUrl(chainNameOrId: ChainName | number): string | null;
-    /**
-     * Get a block explorer URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerUrl(chainNameOrId: ChainName | number): string;
-    /**
-     * Get a block explorer's API URL for a given chain name, chain id, or domain id
-     */
-    tryGetExplorerApiUrl(chainNameOrId: ChainName | number): string | null;
-    /**
-     * Get a block explorer API URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerApiUrl(chainNameOrId: ChainName | number): string;
-    /**
-     * Get a block explorer URL for given chain's tx
-     */
-    tryGetExplorerTxUrl(chainNameOrId: ChainName | number, response: {
-        hash: string;
-    }): string | null;
-    /**
-     * Get a block explorer URL for given chain's tx
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerTxUrl(chainNameOrId: ChainName | number, response: {
-        hash: string;
-    }): string;
     /**
      * Get a block explorer URL for given chain's address
      */
@@ -224,10 +130,6 @@ export declare class MultiProvider {
      * @throws if chain's metadata or signer has not been set or tx fails
      */
     sendTransaction(chainNameOrId: ChainName | number, tx: PopulatedTransaction): Promise<ContractReceipt>;
-    /**
-     * Run given function on all known chains
-     */
-    mapKnownChains<Output>(fn: (n: ChainName) => Output): ChainMap<Output>;
     /**
      * Creates a MultiProvider using the given signer for all test networks
      */

package/dist/providers/MultiProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MultiProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MultiProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MultiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAS,MAAM,OAAO,CAAC;AACxC,OAAO,EACL,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,EACN,SAAS,EACV,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,EAAQ,MAAM,sBAAsB,CAAC;AAIrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAEL,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEnC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,qBAAa,aAAa,CAAC,OAAO,GAAG,EAAE,CAAE,SAAQ,oBAAoB,CAAC,OAAO,CAAC;IAa1E,QAAQ,CAAC,OAAO,EAAE,oBAAoB;IAZxC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAM;IAC5C,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAM;IAC/B,eAAe,UAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAE1B;;;OAGG;gBAED,aAAa,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EACvC,OAAO,GAAE,oBAAyB;IAOpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI;IAUhD,mBAAmB,CAAC,MAAM,GAAG,EAAE,EACtC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC;IAKlC;;OAEG;IACH,cAAc,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI;IAyBlE;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ;IAOxD;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAU5E;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI;IAOjD;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAW9D;;;;OAIG;IACH,SAAS,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM;IAMpD;;;OAGG;IACG,gBAAgB,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3E;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAYpE;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAU3C;;OAEG;IACH,sBAAsB,CACpB,aAAa,EAAE,SAAS,GAAG,MAAM,GAChC,MAAM,GAAG,QAAQ,GAAG,IAAI;IAM3B;;;OAGG;IACH,mBAAmB,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ;IAIzE;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IAa3D;;;OAGG;IACH,SAAS,CACP,MAAM,EAAE,SAAS,EAAE,EACnB,gBAAgB,UAAQ,GACvB;QACD,YAAY,EAAE,SAAS,EAAE,CAAC;QAC1B,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;KACvC;IA8BD;;OAEG;IACG,wBAAwB,CAC5B,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzB;;;OAGG;IACG,qBAAqB,CACzB,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAOlB;;;OAGG;IACH,uBAAuB,CACrB,aAAa,EAAE,SAAS,GAAG,MAAM,GAChC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC;IAIxC;;;OAGG;IACG,QAAQ,CACZ,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,GACrD,OAAO,CAAC,eAAe,CAAC;IAa3B;;;OAGG;IACG,SAAS,CACb,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,EAAE,EAAE,oBAAoB,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC;IAUxC;;;OAGG;IACG,WAAW,CACf,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,EAAE,EAAE,oBAAoB,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,CAAC;IAarB;;;OAGG;IACG,eAAe,CACnB,aAAa,EAAE,SAAS,GAAG,MAAM,EACjC,EAAE,EAAE,oBAAoB,GACvB,OAAO,CAAC,eAAe,CAAC;IAQ3B;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAO,EACrD,MAAM,GAAE,SAAS,EAAe,GAC/B,aAAa;CAejB"}

package/dist/providers/MultiProvider.js

@@ -1,75 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MultiProvider = exports.defaultProviderBuilder = void 0;
+exports.MultiProvider = void 0;
 const debug_1 = require("debug");
 const ethers_1 = require("ethers");
 const utils_1 = require("@hyperlane-xyz/utils");
 const chainMetadata_1 = require("../consts/chainMetadata");
 const chains_1 = require("../consts/chains");
-const chainMetadataTypes_1 = require("../metadata/chainMetadataTypes");
-const objects_1 = require("../utils/objects");
-const RetryProvider_1 = require("./RetryProvider");
-const DEFAULT_RETRY_OPTIONS = {
-    maxRequests: 3,
-    baseRetryMs: 250,
-};
-function defaultProviderBuilder(rpcUrls, network, retryOverride) {
-    const createProvider = (r) => {
-        const retry = r.retry || retryOverride;
-        return retry
-            ? new RetryProvider_1.RetryJsonRpcProvider(retry, r.http, network)
-            : new ethers_1.providers.StaticJsonRpcProvider(r.http, network);
-    };
-    if (rpcUrls.length > 1) {
-        return new ethers_1.providers.FallbackProvider(rpcUrls.map(createProvider), 1);
-    }
-    else if (rpcUrls.length === 1) {
-        return createProvider(rpcUrls[0]);
-    }
-    else {
-        throw new Error('No RPC URLs provided');
-    }
-}
-exports.defaultProviderBuilder = defaultProviderBuilder;
-class MultiProvider {
+const ChainMetadataManager_1 = require("../metadata/ChainMetadataManager");
+const providerBuilders_1 = require("./providerBuilders");
+/**
+ * A utility class to create and manage providers and signers for multiple chains
+ * @typeParam MetaExt - Extra metadata fields for chains (such as contract addresses)
+ */
+class MultiProvider extends ChainMetadataManager_1.ChainMetadataManager {
     /**
      * Create a new MultiProvider with the given chainMetadata,
      * or the SDK's default metadata if not provided
      */
-    constructor(chainMetadata = chainMetadata_1.chainMetadata, options = {}) {
-        this.metadata = {};
+    constructor(chainMetadata, options = {}) {
+        super(chainMetadata, options);
+        this.options = options;
         this.providers = {};
         this.signers = {};
         this.useSharedSigner = false; // A single signer to be used for all chains
-        Object.entries(chainMetadata).forEach(([key, cm]) => {
-            if (key !== cm.name)
-                throw new Error(`Chain name mismatch: Key was ${key}, but name is ${cm.name}`);
-            this.addChain(cm);
-        });
         this.logger = (0, debug_1.debug)(options?.loggerName || 'hyperlane:MultiProvider');
-        this.providerBuilder = options?.providerBuilder || defaultProviderBuilder;
+        this.providerBuilder = options?.providerBuilder || providerBuilders_1.defaultProviderBuilder;
     }
-    /**
-     * Add a chain to the MultiProvider
-     * @throws if chain's name or domain/chain ID collide
-     */
     addChain(metadata) {
-        if (!(0, chainMetadataTypes_1.isValidChainMetadata)(metadata))
-            throw new Error(`Invalid chain metadata for ${metadata.name}`);
-        // Ensure no two chains have overlapping names/domainIds/chainIds
-        for (const chainMetadata of Object.values(this.metadata)) {
-            const { name, chainId, domainId } = chainMetadata;
-            if (name == metadata.name)
-                throw new Error(`Duplicate chain name: ${name}`);
-            // Chain and Domain Ids should be globally unique
-            const idCollision = chainId == metadata.chainId ||
-                domainId == metadata.chainId ||
-                (metadata.domainId &&
-                    (chainId == metadata.domainId || domainId === metadata.domainId));
-            if (idCollision)
-                throw new Error(`Chain/Domain id collision: ${name} and ${metadata.name}`);
-        }
-        this.metadata[metadata.name] = metadata;
+        super.addChain(metadata);
         if (this.useSharedSigner) {
             const signers = Object.values(this.signers);
             if (signers.length > 0) {
@@ -77,95 +35,9 @@ class MultiProvider {
             }
         }
     }
-    /**
-     * Get the metadata for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    tryGetChainMetadata(chainNameOrId) {
-        let chainMetadata;
-        if (typeof chainNameOrId === 'string') {
-            chainMetadata = this.metadata[chainNameOrId];
-        }
-        else if (typeof chainNameOrId === 'number') {
-            chainMetadata = Object.values(this.metadata).find((m) => m.chainId === chainNameOrId || m.domainId === chainNameOrId);
-        }
-        return chainMetadata || null;
-    }
-    /**
-     * Get the metadata for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainMetadata(chainNameOrId) {
-        const chainMetadata = this.tryGetChainMetadata(chainNameOrId);
-        if (!chainMetadata)
-            throw new Error(`No chain metadata set for ${chainNameOrId}`);
-        return chainMetadata;
-    }
-    /**
-     * Get the name for a given chain name, chain id, or domain id
-     */
-    tryGetChainName(chainNameOrId) {
-        return this.tryGetChainMetadata(chainNameOrId)?.name ?? null;
-    }
-    /**
-     * Get the name for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainName(chainNameOrId) {
-        return this.getChainMetadata(chainNameOrId).name;
-    }
-    /**
-     * Get the names for all chains known to this MultiProvider
-     */
-    getKnownChainNames() {
-        return Object.keys(this.metadata);
-    }
-    /**
-     * Get the id for a given chain name, chain id, or domain id
-     */
-    tryGetChainId(chainNameOrId) {
-        return this.tryGetChainMetadata(chainNameOrId)?.chainId ?? null;
-    }
-    /**
-     * Get the id for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getChainId(chainNameOrId) {
-        return this.getChainMetadata(chainNameOrId).chainId;
-    }
-    /**
-     * Get the ids for all chains known to this MultiProvider
-     */
-    getKnownChainIds() {
-        return Object.values(this.metadata).map((c) => c.chainId);
-    }
-    /**
-     * Get the domain id for a given chain name, chain id, or domain id
-     */
-    tryGetDomainId(chainNameOrId) {
-        const metadata = this.tryGetChainMetadata(chainNameOrId);
-        return metadata?.domainId ?? metadata?.chainId ?? null;
-    }
-    /**
-     * Get the domain id for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getDomainId(chainNameOrId) {
-        const metadata = this.getChainMetadata(chainNameOrId);
-        return (0, chainMetadataTypes_1.getDomainId)(metadata);
-    }
-    /**
-     * Get the domain ids for a list of chain names, chain ids, or domain ids
-     * @throws if any chain's metadata has not been set
-     */
-    getDomainIds(chainNamesOrIds) {
-        return chainNamesOrIds.map((c) => this.getDomainId(c));
-    }
-    /**
-     * Get the ids for all chains known to this MultiProvider
-     */
-    getKnownDomainIds() {
-        return this.getKnownChainNames().map(this.getDomainId);
+    extendChainMetadata(additionalMetadata) {
+        const newMetadata = super.extendChainMetadata(additionalMetadata).metadata;
+        return new MultiProvider(newMetadata, this.options);
     }
     /**
      * Get an Ethers provider for a given chain name, chain id, or domain id
@@ -181,7 +53,7 @@ class MultiProvider {
             this.providers[name] = new ethers_1.providers.JsonRpcProvider('http://127.0.0.1:8545', 31337);
         }
         else if (rpcUrls.length) {
-            this.providers[name] = this.providerBuilder(rpcUrls, chainId, DEFAULT_RETRY_OPTIONS);
+            this.providers[name] = this.providerBuilder(rpcUrls, chainId, providerBuilders_1.DEFAULT_RETRY_OPTIONS);
         }
         else {
             return null;
@@ -334,87 +206,14 @@ class MultiProvider {
         if (!intersection.length) {
             throw new Error(`No chains shared between MultiProvider and list (${ownChains} and ${chains})`);
         }
-        const intersectionMetadata = (0, objects_1.pick)(this.metadata, intersection);
-        const intersectionProviders = (0, objects_1.pick)(this.providers, intersection);
-        const intersectionSigners = (0, objects_1.pick)(this.signers, intersection);
+        const intersectionMetadata = (0, utils_1.pick)(this.metadata, intersection);
+        const intersectionProviders = (0, utils_1.pick)(this.providers, intersection);
+        const intersectionSigners = (0, utils_1.pick)(this.signers, intersection);
         const multiProvider = new MultiProvider(intersectionMetadata);
         multiProvider.setProviders(intersectionProviders);
         multiProvider.setSigners(intersectionSigners);
         return { intersection, multiProvider };
     }
-    /**
-     * Get chain names excluding given chain name
-     */
-    getRemoteChains(name) {
-        return utils_1.utils.exclude(name, this.getKnownChainNames());
-    }
-    /**
-     * Get an RPC URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata has not been set
-     */
-    getRpcUrl(chainNameOrId) {
-        const { rpcUrls } = this.getChainMetadata(chainNameOrId);
-        if (!rpcUrls?.length || !rpcUrls[0].http)
-            throw new Error(`No RPC URl configured for ${chainNameOrId}`);
-        return rpcUrls[0].http;
-    }
-    /**
-     * Get a block explorer URL for a given chain name, chain id, or domain id
-     */
-    tryGetExplorerUrl(chainNameOrId) {
-        const explorers = this.tryGetChainMetadata(chainNameOrId)?.blockExplorers;
-        if (!explorers?.length)
-            return null;
-        return explorers[0].url;
-    }
-    /**
-     * Get a block explorer URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerUrl(chainNameOrId) {
-        const url = this.tryGetExplorerUrl(chainNameOrId);
-        if (!url)
-            throw new Error(`No explorer url set for ${chainNameOrId}`);
-        return url;
-    }
-    /**
-     * Get a block explorer's API URL for a given chain name, chain id, or domain id
-     */
-    tryGetExplorerApiUrl(chainNameOrId) {
-        const explorers = this.tryGetChainMetadata(chainNameOrId)?.blockExplorers;
-        if (!explorers?.length || !explorers[0].apiUrl)
-            return null;
-        const { apiUrl, apiKey } = explorers[0];
-        if (!apiKey)
-            return apiUrl;
-        const url = new URL(apiUrl);
-        url.searchParams.set('apikey', apiKey);
-        return url.toString();
-    }
-    /**
-     * Get a block explorer API URL for a given chain name, chain id, or domain id
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerApiUrl(chainNameOrId) {
-        const url = this.tryGetExplorerApiUrl(chainNameOrId);
-        if (!url)
-            throw new Error(`No explorer api url set for ${chainNameOrId}`);
-        return url;
-    }
-    /**
-     * Get a block explorer URL for given chain's tx
-     */
-    tryGetExplorerTxUrl(chainNameOrId, response) {
-        const baseUrl = this.tryGetExplorerUrl(chainNameOrId);
-        return baseUrl ? `${baseUrl}/tx/${response.hash}` : null;
-    }
-    /**
-     * Get a block explorer URL for given chain's tx
-     * @throws if chain's metadata or block explorer data has no been set
-     */
-    getExplorerTxUrl(chainNameOrId, response) {
-        return `${this.getExplorerUrl(chainNameOrId)}/tx/${response.hash}`;
-    }
     /**
      * Get a block explorer URL for given chain's address
      */
@@ -497,22 +296,12 @@ class MultiProvider {
         this.logger(`Sent tx ${response.hash}`);
         return this.handleTx(chainNameOrId, response);
     }
-    /**
-     * Run given function on all known chains
-     */
-    mapKnownChains(fn) {
-        const result = {};
-        for (const chain of this.getKnownChainNames()) {
-            result[chain] = fn(chain);
-        }
-        return result;
-    }
     /**
      * Creates a MultiProvider using the given signer for all test networks
      */
     static createTestMultiProvider(params = {}, chains = chains_1.TestChains) {
         const { signer, provider } = params;
-        const chainMetadata = (0, objects_1.pick)(chainMetadata_1.chainMetadata, chains);
+        const chainMetadata = (0, utils_1.pick)(chainMetadata_1.chainMetadata, chains);
         const mp = new MultiProvider(chainMetadata);
         if (signer) {
             mp.setSharedSigner(signer);