@gnosis-guild/zodiac 4.2.0 → 5.0.0

package/dist/esm/contracts.js

@@ -1,89 +1,64 @@
-import BridgeAbi from "./abi/Bridge.json";
-import CirculatingSupplyErc20Abi from "./abi/CirculatingSupplyErc20.json";
-import CirculatingSupplyErc721Abi from "./abi/CirculatingSupplyErc721.json";
-import ConnextAbi from "./abi/Connext.json";
-import DelayAbi from "./abi/Delay.json";
-import Erc20VotesAbi from "./abi/Erc20Votes.json";
-import Erc721VotesAbi from "./abi/Erc721Votes.json";
-import ExitErc20Abi from "./abi/ExitErc20.json";
-import ExitErc721Abi from "./abi/ExitErc721.json";
-import MetaGuardAbi from "./abi/MetaGuard.json";
-import ModuleProxyFactoryAbi from "./abi/ModuleProxyFactory.json";
-import MultisendEncoderAbi from "./abi/MultisendEncoder.json";
-import OptimisticGovernorAbi from "./abi/OptimisticGovernor.json";
-import OzGovernorAbi from "./abi/OzGovernor.json";
-import PermissionsAbi from "./abi/Permissions.json";
-import RealityErc20Abi from "./abi/RealityErc20.json";
-import RealityEthAbi from "./abi/RealityEth.json";
-import RolesV1Abi from "./abi/RolesV1.json";
-import RolesV2Abi from "./abi/RolesV2.json";
-import ScopeGuardAbi from "./abi/ScopeGuard.json";
-import TellorAbi from "./abi/Tellor.json";
-import { KnownContracts } from "./factory/types";
-import * as BridgeInitData from "./initData/Bridge";
-import * as CirculatingSupplyErc20InitData from "./initData/CirculatingSupplyErc20";
-import * as CirculatingSupplyErc721InitData from "./initData/CirculatingSupplyErc721";
-import * as ConnextInitData from "./initData/Connext";
-import * as DelayInitData from "./initData/Delay";
-import * as Erc20VotesInitData from "./initData/Erc20Votes";
-import * as Erc721VotesInitData from "./initData/Erc721Votes";
-import * as ExitErc20InitData from "./initData/ExitErc20";
-import * as ExitErc721InitData from "./initData/ExitErc721";
-import * as ModuleProxyFactoryInitData from "./initData/ModuleProxyFactory";
-import * as MultisendEncoderInitData from "./initData/MultisendEncoder";
-import * as OzGovernorInitData from "./initData/OzGovernor";
-import * as PermissionsInitData from "./initData/Permissions";
-import * as RealityErc20InitData from "./initData/RealityErc20";
-import * as RealityEthInitData from "./initData/RealityEth";
-import * as RolesV1InitData from "./initData/RolesV1";
-import * as RolesV2InitData from "./initData/RolesV2";
-import * as ScopeGuardInitData from "./initData/ScopeGuard";
-import { factories } from "./types";
-export var SupportedNetworks;
-(function (SupportedNetworks) {
-    SupportedNetworks[SupportedNetworks["Mainnet"] = 1] = "Mainnet";
-    SupportedNetworks[SupportedNetworks["GnosisChain"] = 100] = "GnosisChain";
-    SupportedNetworks[SupportedNetworks["Goerli"] = 5] = "Goerli";
-    SupportedNetworks[SupportedNetworks["ArbitrumOne"] = 42161] = "ArbitrumOne";
-    SupportedNetworks[SupportedNetworks["Optimism"] = 10] = "Optimism";
-    SupportedNetworks[SupportedNetworks["Polygon"] = 137] = "Polygon";
-    SupportedNetworks[SupportedNetworks["ZkEvm"] = 1101] = "ZkEvm";
-    SupportedNetworks[SupportedNetworks["Mumbai"] = 80001] = "Mumbai";
-    SupportedNetworks[SupportedNetworks["Avalanche"] = 43114] = "Avalanche";
-    SupportedNetworks[SupportedNetworks["BinanceSmartChain"] = 56] = "BinanceSmartChain";
-    SupportedNetworks[SupportedNetworks["HardhatNetwork"] = 31337] = "HardhatNetwork";
-    SupportedNetworks[SupportedNetworks["Linea"] = 59144] = "Linea";
-    SupportedNetworks[SupportedNetworks["LineaGoerli"] = 59140] = "LineaGoerli";
-    SupportedNetworks[SupportedNetworks["Sepolia"] = 11155111] = "Sepolia";
-    SupportedNetworks[SupportedNetworks["CoreTestnet"] = 1115] = "CoreTestnet";
-    SupportedNetworks[SupportedNetworks["Core"] = 1116] = "Core";
-    SupportedNetworks[SupportedNetworks["Base"] = 8453] = "Base";
-    SupportedNetworks[SupportedNetworks["BaseSepolia"] = 84532] = "BaseSepolia";
-    SupportedNetworks[SupportedNetworks["Mantle"] = 5000] = "Mantle";
-    SupportedNetworks[SupportedNetworks["Berachain"] = 80094] = "Berachain";
-    SupportedNetworks[SupportedNetworks["Sonic"] = 146] = "Sonic";
-    SupportedNetworks[SupportedNetworks["Celo"] = 42220] = "Celo";
-    SupportedNetworks[SupportedNetworks["Bob"] = 60808] = "Bob";
-    SupportedNetworks[SupportedNetworks["HyperEvm"] = 999] = "HyperEvm";
-    SupportedNetworks[SupportedNetworks["WorldChain"] = 480] = "WorldChain";
-    SupportedNetworks[SupportedNetworks["Flare"] = 14] = "Flare";
-    SupportedNetworks[SupportedNetworks["Ink"] = 57073] = "Ink";
-    SupportedNetworks[SupportedNetworks["Hemi"] = 43111] = "Hemi";
-    SupportedNetworks[SupportedNetworks["Katana"] = 747474] = "Katana";
-    SupportedNetworks[SupportedNetworks["Lens"] = 232] = "Lens";
-    SupportedNetworks[SupportedNetworks["Peaq"] = 3338] = "Peaq";
-    SupportedNetworks[SupportedNetworks["Unichain"] = 130] = "Unichain";
-    SupportedNetworks[SupportedNetworks["ZkSync"] = 324] = "ZkSync";
-    SupportedNetworks[SupportedNetworks["Scroll"] = 534352] = "Scroll";
-    SupportedNetworks[SupportedNetworks["Aurora"] = 1313161554] = "Aurora";
-    SupportedNetworks[SupportedNetworks["GnosisChiado"] = 10200] = "GnosisChiado";
-})(SupportedNetworks || (SupportedNetworks = {}));
-// const canonicalMasterCopyAddress = (contract: KnownContracts) => {
-//   const { initCode, salt } = MasterCopyInitData[contract];
-//   return getCreate2Address(SingletonFactoryAddress, salt, keccak256(initCode));
-// };
-/** The canonical mastercopy addresses when deployed using the singleton factory.  */
-const CanonicalAddresses = {
+/**
+ * Known Zodiac contracts and their canonical mastercopy addresses.
+ *
+ * Canonical mastercopy addresses by `name@version`. Most are deployed through
+ * CREATE2 singleton factories, but the registry itself is pure address/name
+ * data — no ABIs, bytecode or typechain types (use `extract` to capture
+ * per-version artifacts into `mastercopies/`).
+ */
+export var KnownContracts;
+(function (KnownContracts) {
+    KnownContracts["META_GUARD"] = "metaGuard";
+    KnownContracts["OPTIMISTIC_GOVERNOR"] = "optimisticGovernor";
+    KnownContracts["TELLOR"] = "tellor";
+    KnownContracts["REALITY_ETH"] = "realityETH";
+    KnownContracts["REALITY_ERC20"] = "realityERC20";
+    KnownContracts["BRIDGE"] = "bridge";
+    KnownContracts["DELAY"] = "delay";
+    KnownContracts["EXIT_ERC20"] = "exit";
+    KnownContracts["EXIT_ERC721"] = "exitERC721";
+    KnownContracts["CIRCULATING_SUPPLY_ERC20"] = "circulatingSupplyERC20";
+    KnownContracts["CIRCULATING_SUPPLY_ERC721"] = "circulatingSupplyERC721";
+    KnownContracts["SCOPE_GUARD"] = "scopeGuard";
+    KnownContracts["FACTORY"] = "factory";
+    KnownContracts["ROLES"] = "roles";
+    KnownContracts["ROLES_V1"] = "roles";
+    KnownContracts["ROLES_V2"] = "roles";
+    KnownContracts["OZ_GOVERNOR"] = "ozGovernor";
+    KnownContracts["ERC20_VOTES"] = "erc20Votes";
+    KnownContracts["ERC721_VOTES"] = "erc721Votes";
+    KnownContracts["MULTISEND_ENCODER"] = "multisendEncoder";
+    KnownContracts["CONNEXT"] = "connext";
+})(KnownContracts || (KnownContracts = {}));
+export const SupportedNetworks = Object.freeze({
+    MAINNET: 1,
+    OPTIMISM: 10,
+    FLARE: 14,
+    BSC: 56,
+    BNB: 56,
+    GNOSIS: 100,
+    UNICHAIN: 130,
+    POLYGON: 137,
+    SONIC: 146,
+    WORLDCHAIN: 480,
+    HYPEREVM: 999,
+    MEGAETH: 4326,
+    MANTLE: 5000,
+    BASE: 8453,
+    PLASMA: 9745,
+    ARBITRUM: 42161,
+    CELO: 42220,
+    AVALANCHE: 43114,
+    INK: 57073,
+    LINEA: 59144,
+    BOB: 60808,
+    BERACHAIN: 80094,
+    SCROLL: 534352,
+    KATANA: 747474,
+    SEPOLIA: 11155111,
+});
+/** Canonical mastercopy address for each known contract, by version. */
+export const CanonicalAddresses = {
     [KnownContracts.META_GUARD]: {
         "1.0.0": "0xe2847462a574bfd43014d1c7BB6De5769C294691",
     },
@@ -100,6 +75,7 @@ const CanonicalAddresses = {
         "1.0.0": "0xD62129BF40CD1694b3d9D9847367783a1A4d5cB4",
         "1.0.1": "0xd54895B1121A2eE3f37b502F507631FA1331BED6",
         "1.1.0": "0x01F8cabB808D7dE0dF4202D4B60C8310d2f1339b",
+        "1.1.1": "0x824175b945838d127c1ca83cbce11d8e44f6df01",
     },
     [KnownContracts.FACTORY]: {
         "1.0.0": "0x00000000062c52e29e8029dc2413172f6d619d85",
@@ -130,22 +106,15 @@ const CanonicalAddresses = {
     [KnownContracts.ROLES]: {
         "1.0.0": "0x85388a8cd772b19a468F982Dc264C238856939C9",
         "1.1.0": "0xD8DfC1d938D7D163C5231688341e9635E9011889",
-    },
-    [KnownContracts.ROLES_V1]: {
-        "1.0.0": "0x85388a8cd772b19a468F982Dc264C238856939C9",
-        "1.1.0": "0xD8DfC1d938D7D163C5231688341e9635E9011889",
-    },
-    [KnownContracts.PERMISSIONS]: {
-        "1.0.0": "0x33D1C5A5B6a7f3885c7467e829aaa21698937597",
-    },
-    [KnownContracts.ROLES_V2]: {
         "2.1.0": "0x9646fDAD06d3e24444381f44362a3B0eB343D337",
+        "2.1.1": "0xf2964ce6161ce0e75964fe7927ce114cb0b283d5",
     },
     [KnownContracts.TELLOR]: {
         "2.1.0": "0xa89EC2C1e218CfBb0F82829E95352CeAbDEe9A69",
     },
     [KnownContracts.OPTIMISTIC_GOVERNOR]: {
         "1.0.0": "",
+        "1.2.0": "0x28CeBFE94a03DbCA9d17143e9d2Bd1155DC26D5d",
     },
     [KnownContracts.OZ_GOVERNOR]: {
         "1.0.0": "0xe28c39FAC73cce2B33C4C003049e2F3AE43f77d5",
@@ -163,159 +132,11 @@ const CanonicalAddresses = {
         "1.0.0": "0x7dE07b9De0bf0FABf31A188DE1527034b2aF36dB",
     },
 };
-/**
- * Canonical addresses of head versions of each contract.
- * This export will be removed in a future version. Use `ContractAddresses` instead.
- * @deprecated
- **/
-export const MasterCopyAddresses = Object.fromEntries(Object.entries(CanonicalAddresses).map(([key, value]) => [
-    key,
-    Object.values(value).pop() || "",
-]));
-/** Addresses of all deployed contracts in all versions */
-export const ContractVersions = {
-    [SupportedNetworks.Mainnet]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x28CeBFE94a03DbCA9d17143e9d2Bd1155DC26D5d",
-        }, [KnownContracts.TELLOR]: {
-            "2.1.0": "0xaB80413Ab8C4aF91Af5F349352a0c92CF3A30D18",
-        } }),
-    [SupportedNetworks.Goerli]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x07a7Be7AA4AaD42696A17e974486cb64A4daC47b",
-        }, [KnownContracts.TELLOR]: {
-            "2.1.0": "0x4FCba614bf5df50b2575a5825adbc4739aE6FDF5",
-        } }),
-    [SupportedNetworks.BinanceSmartChain]: CanonicalAddresses,
-    [SupportedNetworks.GnosisChain]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x972396Ab668cd11dc1F6321A5ae30c6A8d3759F0",
-        } }),
-    [SupportedNetworks.Polygon]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x3Cc4b597E9c3f51288c6Cd0c087DC14c3FfdD966",
-        } }),
-    [SupportedNetworks.ZkEvm]: CanonicalAddresses,
-    [SupportedNetworks.HardhatNetwork]: CanonicalAddresses,
-    [SupportedNetworks.Mumbai]: CanonicalAddresses,
-    [SupportedNetworks.ArbitrumOne]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x30679ca4ea452d3df8a6c255a806e08810321763",
-        } }),
-    [SupportedNetworks.Optimism]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x357fe84E438B3150d2F68AB9167bdb8f881f3b9A",
-        } }),
-    [SupportedNetworks.Avalanche]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.TELLOR]: {}, [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0xEF8b46765ae805537053C59f826C3aD61924Db45",
-        } }),
-    [SupportedNetworks.Linea]: CanonicalAddresses,
-    [SupportedNetworks.LineaGoerli]: CanonicalAddresses,
-    [SupportedNetworks.Sepolia]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.TELLOR]: {
-            "2.1.0": "0x5F05cd402BF4017970fe390D43B20C3dC3832CD9",
-        }, [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x40153DdFAd90C49dbE3F5c9F96f2a5B25ec67461",
-        } }),
-    [SupportedNetworks.CoreTestnet]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0xD43463Fadd73373bE260b67F5825274F4403dAF0",
-        } }),
-    [SupportedNetworks.Core]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x596Fd6A5A185c67aBD1c845b39f593fBA9C233aa",
-        } }),
-    [SupportedNetworks.Base]: Object.assign(Object.assign({}, CanonicalAddresses), { [KnownContracts.OPTIMISTIC_GOVERNOR]: {
-            "1.2.0": "0x80bCA2E1c272239AdFDCdc87779BC8Af6E12e633",
-        } }),
-    [SupportedNetworks.BaseSepolia]: CanonicalAddresses,
-    [SupportedNetworks.Berachain]: CanonicalAddresses,
-    [SupportedNetworks.Sonic]: CanonicalAddresses,
-    [SupportedNetworks.Celo]: CanonicalAddresses,
-    [SupportedNetworks.Mantle]: CanonicalAddresses,
-    [SupportedNetworks.Bob]: CanonicalAddresses,
-    [SupportedNetworks.HyperEvm]: CanonicalAddresses,
-    [SupportedNetworks.Flare]: CanonicalAddresses,
-    [SupportedNetworks.Ink]: CanonicalAddresses,
-    [SupportedNetworks.WorldChain]: CanonicalAddresses,
-    [SupportedNetworks.Hemi]: CanonicalAddresses,
-    [SupportedNetworks.Katana]: CanonicalAddresses,
-    [SupportedNetworks.Lens]: CanonicalAddresses,
-    [SupportedNetworks.Peaq]: CanonicalAddresses,
-    [SupportedNetworks.Unichain]: CanonicalAddresses,
-    [SupportedNetworks.ZkSync]: CanonicalAddresses,
-    [SupportedNetworks.Scroll]: CanonicalAddresses,
-    [SupportedNetworks.Aurora]: CanonicalAddresses,
-    [SupportedNetworks.GnosisChiado]: CanonicalAddresses,
-};
-/** Addresses of the head versions of all contracts */
-export const ContractAddresses = Object.fromEntries(Object.entries(ContractVersions).map(([network, contracts]) => [
-    network,
-    Object.fromEntries(Object.entries(contracts).map(([contract, versions]) => [
-        contract,
-        Object.values(versions).pop() || "",
-    ])),
-]));
-export const ContractAbis = {
-    [KnownContracts.BRIDGE]: BridgeAbi,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC20]: CirculatingSupplyErc20Abi,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC721]: CirculatingSupplyErc721Abi,
-    [KnownContracts.DELAY]: DelayAbi,
-    [KnownContracts.ERC20_VOTES]: Erc20VotesAbi,
-    [KnownContracts.ERC721_VOTES]: Erc721VotesAbi,
-    [KnownContracts.EXIT_ERC20]: ExitErc20Abi,
-    [KnownContracts.EXIT_ERC721]: ExitErc721Abi,
-    [KnownContracts.FACTORY]: ModuleProxyFactoryAbi,
-    [KnownContracts.META_GUARD]: MetaGuardAbi,
-    [KnownContracts.OPTIMISTIC_GOVERNOR]: OptimisticGovernorAbi,
-    [KnownContracts.OZ_GOVERNOR]: OzGovernorAbi,
-    [KnownContracts.REALITY_ERC20]: RealityErc20Abi,
-    [KnownContracts.REALITY_ETH]: RealityEthAbi,
-    [KnownContracts.ROLES]: RolesV1Abi,
-    [KnownContracts.ROLES_V1]: RolesV1Abi,
-    [KnownContracts.ROLES_V2]: RolesV2Abi,
-    [KnownContracts.SCOPE_GUARD]: ScopeGuardAbi,
-    [KnownContracts.TELLOR]: TellorAbi,
-    [KnownContracts.MULTISEND_ENCODER]: MultisendEncoderAbi,
-    [KnownContracts.PERMISSIONS]: PermissionsAbi,
-    [KnownContracts.CONNEXT]: ConnextAbi,
-};
-export const ContractFactories = {
-    [KnownContracts.BRIDGE]: factories.Bridge__factory,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC20]: factories.CirculatingSupplyErc20__factory,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC721]: factories.CirculatingSupplyErc721__factory,
-    [KnownContracts.DELAY]: factories.Delay__factory,
-    [KnownContracts.ERC20_VOTES]: factories.Erc20Votes__factory,
-    [KnownContracts.ERC721_VOTES]: factories.Erc721Votes__factory,
-    [KnownContracts.EXIT_ERC20]: factories.ExitErc20__factory,
-    [KnownContracts.EXIT_ERC721]: factories.ExitErc721__factory,
-    [KnownContracts.FACTORY]: factories.ModuleProxyFactory__factory,
-    [KnownContracts.META_GUARD]: factories.MetaGuard__factory,
-    [KnownContracts.OPTIMISTIC_GOVERNOR]: factories.OptimisticGovernor__factory,
-    [KnownContracts.OZ_GOVERNOR]: factories.OzGovernor__factory,
-    [KnownContracts.REALITY_ERC20]: factories.RealityErc20__factory,
-    [KnownContracts.REALITY_ETH]: factories.RealityEth__factory,
-    [KnownContracts.ROLES]: factories.RolesV1__factory,
-    [KnownContracts.ROLES_V1]: factories.RolesV1__factory,
-    [KnownContracts.ROLES_V2]: factories.RolesV2__factory,
-    [KnownContracts.SCOPE_GUARD]: factories.ScopeGuard__factory,
-    [KnownContracts.TELLOR]: factories.Tellor__factory,
-    [KnownContracts.MULTISEND_ENCODER]: factories.MultisendEncoder__factory,
-    [KnownContracts.PERMISSIONS]: factories.Permissions__factory,
-    [KnownContracts.CONNEXT]: factories.Connext__factory,
-};
-export const MasterCopyInitData = {
-    [KnownContracts.BRIDGE]: BridgeInitData,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC20]: CirculatingSupplyErc20InitData,
-    [KnownContracts.CIRCULATING_SUPPLY_ERC721]: CirculatingSupplyErc721InitData,
-    [KnownContracts.DELAY]: DelayInitData,
-    [KnownContracts.ERC20_VOTES]: Erc20VotesInitData,
-    [KnownContracts.ERC721_VOTES]: Erc721VotesInitData,
-    [KnownContracts.EXIT_ERC20]: ExitErc20InitData,
-    [KnownContracts.EXIT_ERC721]: ExitErc721InitData,
-    [KnownContracts.FACTORY]: ModuleProxyFactoryInitData,
-    [KnownContracts.META_GUARD]: undefined,
-    [KnownContracts.OPTIMISTIC_GOVERNOR]: undefined,
-    [KnownContracts.OZ_GOVERNOR]: OzGovernorInitData,
-    [KnownContracts.REALITY_ERC20]: RealityErc20InitData,
-    [KnownContracts.REALITY_ETH]: RealityEthInitData,
-    [KnownContracts.ROLES]: RolesV1InitData,
-    [KnownContracts.ROLES_V1]: RolesV1InitData,
-    [KnownContracts.ROLES_V2]: RolesV2InitData,
-    [KnownContracts.SCOPE_GUARD]: ScopeGuardInitData,
-    [KnownContracts.TELLOR]: undefined,
-    [KnownContracts.MULTISEND_ENCODER]: MultisendEncoderInitData,
-    [KnownContracts.PERMISSIONS]: PermissionsInitData,
-    [KnownContracts.CONNEXT]: ConnextInitData,
+export const FAULTY = {
+    [KnownContracts.DELAY]: {
+        "1.1.0": "0x01F8cabB808D7dE0dF4202D4B60C8310d2f1339b",
+    },
+    [KnownContracts.ROLES]: {
+        "2.1.0": "0x9646fDAD06d3e24444381f44362a3B0eB343D337",
+    },
 };

package/dist/esm/explorer.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Minimal Etherscan-compatible explorer client.
+ *
+ * Everything `extract` needs is reachable through the explorer:
+ *  - `getsourcecode`     -> verified source, ABI, compiler input, constructor args
+ *  - `getcontractcreation` -> the deployment transaction hash
+ *  - `eth_getTransactionByHash` (proxy module) -> the raw deployment calldata
+ *
+ * so no separate JSON-RPC endpoint is required for extraction.
+ */
+export interface SourceCode {
+    contractName: string;
+    sourceName: string;
+    compilerVersion: string;
+    compilerInput: any;
+    abi: any;
+    /** abi-encoded constructor arguments (hex, no leading 0x). */
+    constructorArguments: string;
+}
+export interface ContractCreation {
+    txHash?: string;
+    creationBytecode?: string;
+}
+export interface VerificationRequest {
+    address: string;
+    network: string | number;
+    sourceCode: string;
+    contractName: string;
+    compilerVersion: string;
+    constructorArguments?: string;
+    evmVersion?: string;
+    licenseType?: string;
+    apiKey?: string;
+}
+/**
+ * Fetch verified source, ABI and compiler input for a deployed contract.
+ */
+export declare function getSourceCode({ address, network, apiKey, }: {
+    address: string;
+    network: string | number;
+    apiKey?: string;
+}): Promise<SourceCode>;
+/**
+ * Get creation metadata (tx hash and bytecode) for a contract.
+ */
+export declare function getContractCreation({ address, network, apiKey, }: {
+    address: string;
+    network: string | number;
+    apiKey?: string;
+}): Promise<ContractCreation | undefined>;
+/**
+ * Fetch a transaction (input + to) via the explorer's proxy module.
+ */
+export declare function getTransaction({ txHash, network, apiKey, }: {
+    txHash: string;
+    network: string | number;
+    apiKey?: string;
+}): Promise<{
+    to: string | null;
+    input: string;
+} | undefined>;
+/**
+ * Fetch the deployed (runtime) bytecode at an address via the proxy module.
+ */
+export declare function getCode({ address, network, apiKey, }: {
+    address: string;
+    network: string | number;
+    apiKey?: string;
+}): Promise<string>;
+/**
+ * Submit standard-JSON Solidity source for verification.
+ */
+export declare function verifySourceCode({ address, network, sourceCode, contractName, compilerVersion, constructorArguments, evmVersion, licenseType, apiKey, }: VerificationRequest): Promise<string>;
+/**
+ * Check the async source verification status for a submitted GUID.
+ */
+export declare function checkVerificationStatus({ guid, network, apiKey, }: {
+    guid: string;
+    network: string | number;
+    apiKey?: string;
+}): Promise<string>;