@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/providers/MinimalProviderRegistry.js

@@ -0,0 +1,122 @@
+import { ProtocolType, pick, rootLogger } from '@recoillink/utils';
+import { ChainMetadataManager } from '../metadata/ChainMetadataManager.js';
+import { PROTOCOL_TO_DEFAULT_PROVIDER_TYPE, ProviderType, } from './ProviderType.js';
+// Lightweight provider registry for metadata-backed reads. It owns typed
+// provider instances/builders, but intentionally does not carry the legacy
+// MultiProvider bridge behavior layered on top by derived classes.
+export class MinimalProviderRegistry extends ChainMetadataManager {
+    options;
+    providers;
+    providerBuilders;
+    logger;
+    constructor(chainMetadata, options = {}) {
+        super(chainMetadata, options);
+        this.options = options;
+        const loggerModule = new.target?.name || 'MinimalProviderRegistry';
+        this.logger =
+            options.logger ||
+                rootLogger.child({
+                    module: loggerModule,
+                });
+        this.providers = options.providers ?? {};
+        this.providerBuilders = options.providerBuilders ?? {};
+    }
+    extendChainMetadata(additionalMetadata) {
+        const newMetadata = super.extendChainMetadata(additionalMetadata).metadata;
+        return new MinimalProviderRegistry(newMetadata, {
+            ...this.options,
+            providers: this.providers,
+            providerBuilders: this.providerBuilders,
+        });
+    }
+    getProviderBuilder(_protocol, type) {
+        return this.providerBuilders[type];
+    }
+    tryGetProvider(chainNameOrId, type) {
+        const metadata = this.tryGetChainMetadata(chainNameOrId);
+        if (!metadata)
+            return null;
+        const { protocol, name, rpcUrls } = metadata;
+        if (protocol === ProtocolType.Unknown)
+            return null;
+        type = type || PROTOCOL_TO_DEFAULT_PROVIDER_TYPE[protocol];
+        if (!type)
+            return null;
+        if (this.providers[name]?.[type])
+            return this.providers[name][type];
+        const builder = this.getProviderBuilder(protocol, type);
+        if (!rpcUrls.length || !builder)
+            return null;
+        const provider = builder(metadata);
+        this.providers[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;
+    }
+    getSpecificProvider(chainNameOrId, type) {
+        const provider = this.getProvider(chainNameOrId, type);
+        if (provider.type !== type)
+            throw new Error(`Invalid provider type, expected ${type} but found ${provider.type}`);
+        // CAST: provider.type is checked against `type` immediately above, so the
+        // wrapped provider payload matches the requested generic T.
+        return provider.provider;
+    }
+    getEthersV5Provider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.EthersV5);
+    }
+    getViemProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.Viem);
+    }
+    getSolanaWeb3Provider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.SolanaWeb3);
+    }
+    getCosmJsProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.CosmJs);
+    }
+    getCosmJsWasmProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.CosmJsWasm);
+    }
+    getCosmJsNativeProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.CosmJsNative);
+    }
+    getStarknetProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.Starknet);
+    }
+    getRadixProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.Radix);
+    }
+    getAleoProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.Aleo);
+    }
+    getTronProvider(chainNameOrId) {
+        return this.getSpecificProvider(chainNameOrId, ProviderType.Tron);
+    }
+    setProvider(chainNameOrId, provider) {
+        const chainName = this.getChainName(chainNameOrId);
+        this.providers[chainName] ||= {};
+        this.providers[chainName][provider.type] = provider;
+        return provider;
+    }
+    setProviders(providers) {
+        for (const chain of Object.keys(providers)) {
+            this.setProvider(chain, providers[chain]);
+        }
+    }
+    intersect(chains, throwIfNotSubset = false) {
+        const { intersection, result } = super.intersect(chains, throwIfNotSubset);
+        return {
+            intersection,
+            result: new MinimalProviderRegistry(result.metadata, {
+                ...this.options,
+                providers: pick(this.providers, intersection),
+                providerBuilders: this.providerBuilders,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=MinimalProviderRegistry.js.map

package/dist/providers/MinimalProviderRegistry.js.map

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

package/dist/providers/MultiProtocolProvider.d.ts

@@ -0,0 +1,23 @@
+import { ProtocolType } from '@recoillink/utils';
+import { multiProtocolTestChainMetadata } from '../consts/testChains.js';
+import type { ChainMetadata } from '../metadata/chainMetadataTypes.js';
+import type { ChainMap, ChainName } from '../types.js';
+import { MultiProviderAdapter, MultiProviderAdapterOptions } from './MultiProviderAdapter.js';
+import { MultiProvider } from './MultiProvider.js';
+import { ProviderType, TypedProvider } from './ProviderType.js';
+import type { ProviderBuilderFn } from './providerBuilders.js';
+export interface MultiProtocolProviderOptions extends MultiProviderAdapterOptions {
+}
+export declare class MultiProtocolProvider<MetaExt = {}> extends MultiProviderAdapter<MetaExt> {
+    static fromMultiProvider<MetaExt = {}>(mp: MultiProvider<MetaExt>, options?: MultiProtocolProviderOptions): MultiProtocolProvider<MetaExt>;
+    constructor(chainMetadata: ChainMap<ChainMetadata<MetaExt>>, options?: MultiProtocolProviderOptions);
+    protected getProviderBuilder(protocol: ProtocolType, type: ProviderType): ProviderBuilderFn<TypedProvider> | undefined;
+    extendChainMetadata<NewExt = {}>(additionalMetadata: ChainMap<NewExt>): MultiProtocolProvider<MetaExt & NewExt>;
+    intersect(chains: ChainName[], throwIfNotSubset?: boolean): {
+        intersection: ChainName[];
+        result: MultiProtocolProvider<MetaExt>;
+    };
+    static createTestMultiProtocolProvider(metadata?: typeof multiProtocolTestChainMetadata, providers?: Partial<Record<ProtocolType, TypedProvider>>): MultiProtocolProvider;
+    static createTestMultiProtocolProvider<MetaExt>(metadata: ChainMap<ChainMetadata<MetaExt>>, providers?: Partial<Record<ProtocolType, TypedProvider>>): MultiProtocolProvider<MetaExt>;
+}
+//# sourceMappingURL=MultiProtocolProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MultiProtocolProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MultiProtocolProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAQ,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAEL,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,4BAA6B,SAAQ,2BAA2B;CAAG;AAEpF,qBAAa,qBAAqB,CAChC,OAAO,GAAG,EAAE,CACZ,SAAQ,oBAAoB,CAAC,OAAO,CAAC;IACrC,MAAM,CAAC,iBAAiB,CAAC,OAAO,GAAG,EAAE,EACnC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,EAC1B,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAAC,OAAO,CAAC,CAEhC;IAED,YACE,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAC/C,OAAO,GAAE,4BAAiC,EAS3C;IAED,UAAmB,kBAAkB,CACnC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,YAAY,GACjB,iBAAiB,CAAC,aAAa,CAAC,GAAG,SAAS,CAQ9C;IAEQ,mBAAmB,CAAC,MAAM,GAAG,EAAE,EACtC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,qBAAqB,CAAC,OAAO,GAAG,MAAM,CAAC,CAQzC;IAEQ,SAAS,CAChB,MAAM,EAAE,SAAS,EAAE,EACnB,gBAAgB,UAAQ,GACvB;QACD,YAAY,EAAE,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;KACxC,CAWA;IAED,MAAM,CAAC,+BAA+B,CACpC,QAAQ,CAAC,EAAE,OAAO,8BAA8B,EAChD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,GACvD,qBAAqB,CAAC;IACzB,MAAM,CAAC,+BAA+B,CAAC,OAAO,EAC5C,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAC1C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,GACvD,qBAAqB,CAAC,OAAO,CAAC,CAAC;CAuBnC"}

package/dist/providers/MultiProtocolProvider.js

@@ -0,0 +1,64 @@
+import { ProtocolType, pick } from '@recoillink/utils';
+import { multiProtocolTestChainMetadata } from '../consts/testChains.js';
+import { createAdapterFromMultiProvider, MultiProviderAdapter, } from './MultiProviderAdapter.js';
+import { ProviderType } from './ProviderType.js';
+import { defaultTronEthersProviderBuilder } from './providerBuilders.js';
+import { defaultProviderBuilderMap } from './defaultProviderBuilderMaps.js';
+export class MultiProtocolProvider extends MultiProviderAdapter {
+    static fromMultiProvider(mp, options = {}) {
+        return createAdapterFromMultiProvider(MultiProtocolProvider, mp, options);
+    }
+    constructor(chainMetadata, options = {}) {
+        super(chainMetadata, {
+            ...options,
+            providerBuilders: {
+                ...defaultProviderBuilderMap,
+                ...options.providerBuilders,
+            },
+        });
+    }
+    getProviderBuilder(protocol, type) {
+        if (protocol === ProtocolType.Tron && type === ProviderType.EthersV5) {
+            return (metadata) => ({
+                type: ProviderType.EthersV5,
+                provider: defaultTronEthersProviderBuilder(metadata),
+            });
+        }
+        return this.providerBuilders[type];
+    }
+    extendChainMetadata(additionalMetadata) {
+        const newMetadata = super.extendChainMetadata(additionalMetadata).metadata;
+        return new MultiProtocolProvider(newMetadata, {
+            ...this.options,
+            providers: this.providers,
+            providerBuilders: this.providerBuilders,
+            seismicSigners: this.seismicSigners,
+        });
+    }
+    intersect(chains, throwIfNotSubset = false) {
+        const { intersection, result } = super.intersect(chains, throwIfNotSubset);
+        return {
+            intersection,
+            result: new MultiProtocolProvider(result.metadata, {
+                ...this.options,
+                providers: pick(this.providers, intersection),
+                providerBuilders: this.providerBuilders,
+                seismicSigners: pick(this.seismicSigners, intersection),
+            }),
+        };
+    }
+    static createTestMultiProtocolProvider(metadata = multiProtocolTestChainMetadata, providers = {}) {
+        // CAST: the generic overload now requires callers to supply matching
+        // metadata. The shared implementation still handles the non-generic
+        // default-fixture overload through the same code path.
+        const mp = new MultiProtocolProvider(metadata);
+        const providerMap = {};
+        for (const [protocol, provider] of Object.entries(providers)) {
+            const chains = Object.values(metadata).filter((m) => m.protocol === protocol);
+            chains.forEach((c) => (providerMap[c.name] = provider));
+        }
+        mp.setProviders(providerMap);
+        return mp;
+    }
+}
+//# 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,126 @@
+import { expect } from 'chai';
+import { Wallet, providers as ethersProviders } from 'ethers';
+import { Provider as ZKSyncProvider } from 'zksync-ethers';
+import { TestChainName, test1, test2 } from '../consts/testChains.js';
+import { ChainTechnicalStack } from '../metadata/chainMetadataTypes.js';
+import { defaultProviderBuilderMap } from '../providers/defaultProviderBuilderMaps.js';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { MultiProviderAdapter } from '../providers/MultiProviderAdapter.js';
+import { MultiProtocolProvider } from '../providers/MultiProtocolProvider.js';
+import { ProviderType } from '../providers/ProviderType.js';
+import { SeismicSigner } from '../providers/SeismicSigner.js';
+describe('MultiProtocolProvider', () => {
+    describe('seismic signers', () => {
+        const seismic = {
+            ...test2,
+            name: 'seismic',
+            technicalStack: ChainTechnicalStack.Seismic,
+        };
+        function multiProviderWithSigners() {
+            const multiProvider = new MultiProvider({ test1, seismic });
+            const provider = new ethersProviders.JsonRpcProvider('http://127.0.0.1:8545');
+            multiProvider.setSharedSigner(Wallet.createRandom().connect(provider));
+            return multiProvider;
+        }
+        it("exposes only Seismic chains' signers to adapters", () => {
+            const adapted = MultiProtocolProvider.fromMultiProvider(multiProviderWithSigners());
+            const signer = adapted.tryGetSeismicSigner('seismic');
+            expect(signer).to.be.instanceOf(SeismicSigner);
+            // Non-Seismic chains never get one, even though the MultiProvider has it.
+            expect(adapted.tryGetSeismicSigner(TestChainName.test1)).to.equal(undefined);
+        });
+        it('has no signers for read-only instances', () => {
+            const readOnly = new MultiProtocolProvider({ test1, seismic });
+            expect(readOnly.tryGetSeismicSigner('seismic')).to.equal(undefined);
+        });
+        it('adopts Seismic signers after construction and keeps them in derived instances', () => {
+            // The CLI builds its MultiProtocolProvider from metadata first and
+            // attaches keys later; signers are adopted in place.
+            const adapted = new MultiProtocolProvider({ test1, seismic });
+            adapted.setSeismicSigners(multiProviderWithSigners());
+            expect(adapted.tryGetSeismicSigner('seismic')).to.be.instanceOf(SeismicSigner);
+            expect(adapted.tryGetSeismicSigner(TestChainName.test1)).to.equal(undefined);
+            const extended = adapted.extendChainMetadata({
+                seismic: { mailbox: '0x1' },
+            });
+            expect(extended.tryGetSeismicSigner('seismic')).to.be.instanceOf(SeismicSigner);
+        });
+        it('drops Seismic signers the source MultiProvider no longer has', () => {
+            const source = multiProviderWithSigners();
+            const adapted = new MultiProtocolProvider({ test1, seismic });
+            adapted.setSeismicSigners(source);
+            expect(adapted.tryGetSeismicSigner('seismic')).to.be.instanceOf(SeismicSigner);
+            source.setSharedSigner(null);
+            adapted.setSeismicSigners(source);
+            expect(adapted.tryGetSeismicSigner('seismic')).to.equal(undefined);
+        });
+        it('keeps Seismic signers across extendChainMetadata and intersect', () => {
+            const adapted = MultiProtocolProvider.fromMultiProvider(multiProviderWithSigners());
+            const extended = adapted.extendChainMetadata({
+                seismic: { mailbox: '0x1' },
+                test1: { mailbox: '0x2' },
+            });
+            expect(extended.tryGetSeismicSigner('seismic')).to.be.instanceOf(SeismicSigner);
+            const { result } = extended.intersect(['seismic']);
+            expect(result.tryGetSeismicSigner('seismic')).to.be.instanceOf(SeismicSigner);
+        });
+    });
+    describe('constructs', () => {
+        it('creates a multi protocol provider without type extension', async () => {
+            const multiProvider = new MultiProtocolProvider({ test1 });
+            const metadata = multiProvider.getChainMetadata(TestChainName.test1);
+            expect(metadata.name).to.equal(TestChainName.test1);
+        });
+        it('creates a multi protocol provider with type extension', async () => {
+            const multiProvider = new MultiProtocolProvider({
+                test1: { ...test1, foo: '0x123', bar: 1 },
+            });
+            const metadata = multiProvider.getChainMetadata(TestChainName.test1);
+            expect(metadata.foo).to.equal('0x123');
+            expect(metadata.bar).to.equal(1);
+        });
+        it('keeps distinct logger module names for base and derived providers', () => {
+            const adapter = new MultiProviderAdapter({
+                test1,
+            });
+            const multiProvider = new MultiProtocolProvider({ test1 });
+            expect(adapter.logger.bindings().module).to.equal('MultiProviderAdapter');
+            expect(multiProvider.logger.bindings().module).to.equal('MultiProtocolProvider');
+        });
+        it('preserves zksync provider typing when adapting a MultiProvider', () => {
+            const provider = new ZKSyncProvider('http://127.0.0.1:3050', 324);
+            const multiProvider = new MultiProvider({
+                zksync: {
+                    ...test1,
+                    name: 'zksync',
+                    domainId: 324,
+                    chainId: 324,
+                    technicalStack: ChainTechnicalStack.ZkSync,
+                },
+            });
+            multiProvider.setProvider('zksync', provider);
+            const adapted = MultiProtocolProvider.fromMultiProvider(multiProvider);
+            expect(adapted.getProvider('zksync', ProviderType.ZkSync).type).to.equal(ProviderType.ZkSync);
+        });
+        it('preserves zksync lazy provider typing when adapting a MultiProvider', () => {
+            const multiProvider = new MultiProvider({
+                zksync: {
+                    ...test1,
+                    name: 'zksync',
+                    domainId: 324,
+                    chainId: 324,
+                    technicalStack: ChainTechnicalStack.ZkSync,
+                },
+            });
+            const adapter = MultiProviderAdapter.fromMultiProvider(multiProvider);
+            const adapted = MultiProtocolProvider.fromMultiProvider(multiProvider);
+            expect(adapter.getProvider('zksync').type).to.equal(ProviderType.ZkSync);
+            expect(adapted.getProvider('zksync').type).to.equal(ProviderType.ZkSync);
+        });
+        it('returns a gnosis-typed builder entry', () => {
+            const provider = defaultProviderBuilderMap[ProviderType.GnosisTxBuilder](test1);
+            expect(provider.type).to.equal(ProviderType.GnosisTxBuilder);
+        });
+    });
+});
+//# 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":"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"}

package/dist/providers/MultiProvider.d.ts

@@ -0,0 +1,196 @@
+import { BigNumber, ContractFactory, ContractReceipt, ContractTransaction, PopulatedTransaction, Signer, providers } from 'ethers';
+import { Logger } from 'pino';
+import { ContractFactory as ZKSyncContractFactory, Provider as ZKSyncProvider } from 'zksync-ethers';
+import { ZKSyncArtifact } from '@recoillink/core';
+import { Address } from '@recoillink/utils';
+import { ChainMetadataManager } from '../metadata/ChainMetadataManager.js';
+import { ChainMetadata, EthJsonRpcBlockParameterTag } from '../metadata/chainMetadataTypes.js';
+import { ChainMap, ChainName, ChainNameOrId } from '../types.js';
+import { AnnotatedEV5Transaction } from './ProviderType.js';
+import { ProviderBuilderFn } from './builders/types.js';
+type Provider = providers.Provider | ZKSyncProvider;
+export interface MultiProviderOptions {
+    logger?: Logger;
+    providers?: ChainMap<Provider>;
+    providerBuilder?: ProviderBuilderFn<Provider>;
+    signers?: ChainMap<Signer>;
+    minConfirmationTimeoutMs?: number;
+}
+export interface SendTransactionOptions {
+    /**
+     * Number of confirmations to wait for, or a block tag like "finalized" or "safe".
+     * If not provided, uses chain metadata's blocks.confirmations (default: 1).
+     */
+    waitConfirmations?: number | EthJsonRpcBlockParameterTag;
+    /**
+     * Timeout in ms when waiting for confirmations.
+     * Default: max(2 × confirmations × estimateBlockTime, 30s) when available, otherwise 300000 (5 min).
+     */
+    timeoutMs?: number;
+}
+/**
+ * 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: Logger;
+    /**
+     * Create a new MultiProvider with the given chainMetadata,
+     * or the SDK's default metadata if not provided
+     */
+    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 or domain id
+     */
+    tryGetProvider(chainNameOrId: ChainNameOrId): Provider | null;
+    /**
+     * Get an Ethers provider for a given chain name or domain id
+     * @throws if chain's metadata has not been set
+     */
+    getProvider(chainNameOrId: ChainNameOrId): Provider;
+    /**
+     * Sets an Ethers provider for a given chain name or domain id
+     * @throws if chain's metadata has not been set
+     */
+    setProvider(chainNameOrId: ChainNameOrId, provider: Provider): Provider;
+    /**
+     * Sets Ethers providers for a set of chains
+     * @throws if chain's metadata has not been set
+     */
+    setProviders(providers: ChainMap<Provider>): void;
+    /**
+     * Get an Ethers signer for a given chain name or domain id
+     * If signer is not yet connected, it will be connected
+     */
+    tryGetSigner(chainNameOrId: ChainNameOrId): Signer | null;
+    /**
+     * Wraps a connected signer in a SeismicSigner for Seismic chains, so that
+     * gas estimation (and static calls) for owner-gated functions are sent as
+     * signed reads. No-op for non-Seismic chains or already-wrapped signers.
+     */
+    maybeWrapSeismicSigner(chainName: ChainName, signer: Signer): Signer;
+    /**
+     * Get an Ethers signer for a given chain name or domain id
+     * If signer is not yet connected, it will be connected
+     * @throws if chain's metadata or signer has not been set
+     */
+    getSigner(chainNameOrId: ChainNameOrId): Signer;
+    /**
+     * Get an Ethers signer for a given chain name or domain id
+     * @throws if chain's metadata or signer has not been set
+     */
+    getSignerAddress(chainNameOrId: ChainNameOrId): Promise<Address>;
+    /**
+     * Sets an Ethers Signer for a given chain name or domain id
+     * @throws if chain's metadata has not been set or shared signer has already been set
+     */
+    setSigner(chainNameOrId: ChainNameOrId, signer: Signer): Signer;
+    /**
+     * Sets Ethers Signers for a set of chains
+     * @throws if chain's metadata has not been set or shared signer has already been set
+     */
+    setSigners(signers: ChainMap<Signer>): void;
+    /**
+     * Gets the Signer if it's been set, otherwise the provider
+     */
+    tryGetSignerOrProvider(chainNameOrId: ChainNameOrId): Signer | Provider | null;
+    /**
+     * Gets the Signer if it's been set, otherwise the provider
+     * @throws if chain metadata has not been set
+     */
+    getSignerOrProvider(chainNameOrId: ChainNameOrId): Signer | Provider;
+    /**
+     * Sets Ethers Signers to be used for all chains
+     * Any subsequent calls to getSigner will return given signer
+     * Setting sharedSigner to null clears all signers
+     */
+    setSharedSigner(sharedSigner: Signer | null): Signer | null;
+    /**
+     * Create a new MultiProvider from the intersection
+     * of current's chains and the provided chain list
+     */
+    intersect(chains: ChainName[], throwIfNotSubset?: boolean): {
+        intersection: ChainName[];
+        result: MultiProvider<MetaExt>;
+    };
+    /**
+     * Get a block explorer URL for given chain's address
+     */
+    tryGetExplorerAddressUrl(chainNameOrId: ChainNameOrId, address?: string): Promise<string | null>;
+    /**
+     * Get the latest block range for a given chain's RPC provider
+     */
+    getLatestBlockRange(chainNameOrId: ChainNameOrId, rangeSize?: number): Promise<{
+        fromBlock: number;
+        toBlock: number;
+    }>;
+    /**
+     * Get the transaction overrides for a given chain name or domain id
+     * @throws if chain's metadata has not been set
+     */
+    getTransactionOverrides(chainNameOrId: ChainNameOrId): Partial<providers.TransactionRequest>;
+    /**
+     * Wait for deploy tx to be confirmed
+     * @throws if chain's metadata or signer has not been set or tx fails
+     */
+    handleDeploy<F extends ZKSyncContractFactory | ContractFactory>(chainNameOrId: ChainNameOrId, factory: F, params: Parameters<F['deploy']>, artifact?: ZKSyncArtifact): Promise<Awaited<ReturnType<F['deploy']>>>;
+    /**
+     * Resolve a core typechain factory to its Tron-compiled equivalent
+     * wrapped with TronContractFactory for deployment.
+     *
+     * @recoillink/tron-sdk exports typechain factories with class names identical to
+     * @recoillink/core (e.g. Mailbox__factory), generated from the same Solidity source.
+     * They share the same ABIs and deploy signatures, differing only in TVM bytecode.
+     *
+     * Looks up the tron factory by factory.constructor.name and wraps it
+     * with TronContractFactory to handle Tron's deployment flow.
+     * @throws if no matching Tron factory is found
+     */
+    resolveTronFactory<F extends ContractFactory>(factory: F): Promise<F>;
+    /**
+     * Wait for given tx to be confirmed
+     * @param options - Optional configuration including waitConfirmations and timeoutMs
+     * @throws if chain's metadata or signer has not been set, tx fails, block tag unsupported, or timeout exceeded
+     */
+    handleTx(chainNameOrId: ChainNameOrId, tx: ContractTransaction | Promise<ContractTransaction>, options?: SendTransactionOptions): Promise<ContractReceipt>;
+    /**
+     * Wait for a transaction to be included in a block with the given tag (e.g., "finalized", "safe").
+     * Polls until the tagged block number >= transaction block number.
+     * @param timeoutMs - Timeout in ms (default: 300000 = 5 min)
+     * @throws if block tag is unsupported by the RPC provider or timeout exceeded
+     * @internal - Prefer using handleTx with waitConfirmations parameter.
+     */
+    waitForBlockTag(chainNameOrId: ChainNameOrId, response: ContractTransaction, blockTag: EthJsonRpcBlockParameterTag, timeoutMs?: number): Promise<ContractReceipt>;
+    /**
+     * Populate a transaction's fields using signer address and overrides
+     * @throws if chain's metadata has not been set or tx fails
+     */
+    prepareTx(chainNameOrId: ChainNameOrId, tx: PopulatedTransaction, from?: string): Promise<providers.TransactionRequest>;
+    /**
+     * Estimate gas for given tx
+     * @throws if chain's metadata has not been set or tx fails
+     */
+    estimateGas(chainNameOrId: ChainNameOrId, tx: PopulatedTransaction, from?: string): Promise<BigNumber>;
+    /**
+     * Send a transaction and wait for confirmation
+     * @param options - Optional configuration including waitConfirmations
+     * @throws if chain's metadata or signer has not been set or tx fails
+     */
+    sendTransaction(chainNameOrId: ChainNameOrId, txProm: AnnotatedEV5Transaction | Promise<AnnotatedEV5Transaction>, options?: SendTransactionOptions): Promise<ContractReceipt>;
+    /**
+     * Creates a MultiProvider using the given signer for all test networks
+     */
+    static createTestMultiProvider(params?: {
+        signer?: Signer;
+        provider?: Provider;
+    }, chains?: ChainName[]): MultiProvider;
+}
+export {};
+//# sourceMappingURL=MultiProvider.d.ts.map

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

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