@skalenetwork/upgrade-tools 4.0.0-update-verify.6 → 4.0.0-update-gnosis-service.1

package/dist/src/ownership-transfer/instanceAdmin.d.ts

@@ -0,0 +1,51 @@
+import { EoaSubmitter, SafeSubmitter } from "../submitters";
+import { Instance } from "@skalenetwork/skale-contracts-ethers-v6";
+export interface InstanceAdminOptions {
+    oldOwner: string;
+    submitter: SafeSubmitter | EoaSubmitter;
+    renounceRoles: boolean;
+    newOwner: string;
+    readonly: boolean;
+    testMode: boolean;
+    rolesToCheck?: string[];
+    managerRolesToCheck?: bigint[];
+}
+interface ContractId {
+    name: string;
+    address?: string;
+}
+export declare class InstanceAdmin {
+    private instance?;
+    private contractMetadata;
+    private contractIds;
+    private bytes32RolesToCheck;
+    private managerRolesToCheck;
+    private oldOwner;
+    private newOwner;
+    private readonly;
+    private submitter;
+    private renounceRoles;
+    private testMode;
+    constructor(contractIds: ContractId[], options: InstanceAdminOptions, instance?: Instance);
+    executeOwnershipTransfer(): Promise<void>;
+    private initialize;
+    private processGrantStepIfRequired;
+    private processRenounceStepIfRequired;
+    private submitRenounceRolesTransactions;
+    private confirmAndSubmitTransactions;
+    private submitGrantOwnershipTransactions;
+    private ownershipGrantingRequired;
+    private ownershipRevokingRequired;
+    private resolveContractAddress;
+    private loadContractMetadataAndCreateTransactions;
+    private confirmData;
+    private processOptions;
+    private createRequiredTransactions;
+    private getColumnWidths;
+    private displayPatternGroup;
+    private displayFindings;
+    private handleUserRejection;
+    private groupMetadataByPattern;
+    private promptConfirmation;
+}
+export {};

package/dist/src/ownership-transfer/instanceAdmin.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceAdmin = void 0;
+// Cspell:words keccak
+const contractAdmin_1 = require("./contractAdmin");
+const submitters_1 = require("../submitters");
+const utils_1 = require("./utils");
+const chalk_1 = __importDefault(require("chalk"));
+const hardhat_1 = require("hardhat");
+const ZERO = 0;
+class InstanceAdmin {
+    constructor(contractIds, options, instance) {
+        this.contractMetadata = new Map();
+        this.bytes32RolesToCheck = [];
+        this.managerRolesToCheck = [];
+        this.instance = instance;
+        this.contractIds = contractIds;
+        this.readonly = options.readonly;
+        this.newOwner = options.newOwner;
+        this.submitter = options.submitter;
+        this.oldOwner = options.oldOwner;
+        this.renounceRoles = options.renounceRoles;
+        this.testMode = options.testMode;
+        this.processOptions(options);
+    }
+    async executeOwnershipTransfer() {
+        // Confirm data found in initialization
+        await this.initialize();
+        if (this.readonly) {
+            return;
+        }
+        await this.processGrantStepIfRequired();
+        await this.processRenounceStepIfRequired();
+        this.displayFindings();
+        if (this.ownershipGrantingRequired() || (this.ownershipRevokingRequired() && this.renounceRoles)) {
+            console.error(chalk_1.default.red("Unexpected state: There are still actions required."));
+        }
+        else {
+            console.log(chalk_1.default.green("Ownership transfer process completed. - Nothing more to do."));
+        }
+    }
+    async initialize() {
+        await this.loadContractMetadataAndCreateTransactions();
+        await this.confirmData();
+    }
+    async processGrantStepIfRequired() {
+        if (this.ownershipGrantingRequired()) {
+            await this.submitGrantOwnershipTransactions();
+            if (this.renounceRoles) {
+                await this.createRequiredTransactions();
+            }
+            await this.confirmData();
+        }
+    }
+    async processRenounceStepIfRequired() {
+        if (this.renounceRoles && this.ownershipRevokingRequired() === true) {
+            await this.submitRenounceRolesTransactions();
+            await this.createRequiredTransactions();
+        }
+    }
+    async submitRenounceRolesTransactions() {
+        const txsToSubmit = [];
+        for (const contract of this.contractMetadata.values()) {
+            txsToSubmit.push(...contract.getRenounceOwnershipTransactions());
+            contract.clearRenounceTransactions();
+        }
+        console.log(chalk_1.default.green(`Submitting ${txsToSubmit.length} renounce ownership transactions...`));
+        for (const [index, txData] of txsToSubmit.entries()) {
+            console.log(chalk_1.default.grey(`    -> Transaction ${index}: ${txData.description || "No description"}`));
+        }
+        await this.confirmAndSubmitTransactions(txsToSubmit);
+    }
+    async confirmAndSubmitTransactions(txsToSubmit) {
+        const confirmation = await this.promptConfirmation("Do you want to proceed with submitting these transactions?");
+        if (!confirmation) {
+            throw new Error("Transaction submission aborted by user.");
+        }
+        await this.submitter.submit(txsToSubmit.map(tx => tx.transaction));
+        if (this.submitter instanceof submitters_1.SafeSubmitter) {
+            await this.promptConfirmation("Please proceed only AFTER the Safe transactions have been executed on-chain.\n" +
+                "Do you want to proceed?");
+        }
+    }
+    async submitGrantOwnershipTransactions() {
+        const txsToSubmit = [];
+        for (const contract of this.contractMetadata.values()) {
+            txsToSubmit.push(...contract.getGrantOwnershipTransactions());
+            contract.clearGrantTransactions();
+        }
+        // Required for ProxyAdmins shared among multiple contracts
+        const txsToSubmitFiltered = (0, utils_1.removeDuplicateTransactions)(txsToSubmit);
+        console.log(chalk_1.default.green(`Submitting ${txsToSubmitFiltered.length} unique grant ownership transactions...`));
+        for (const [index, txData] of txsToSubmitFiltered.entries()) {
+            console.log(chalk_1.default.grey(`    -> Transaction ${index}: ${txData.description || "No description"}`));
+        }
+        await this.confirmAndSubmitTransactions(txsToSubmit);
+    }
+    ownershipGrantingRequired() {
+        return Array.from(this.contractMetadata.values()).some(contract => contract.requiresGrantingOwnership());
+    }
+    ownershipRevokingRequired() {
+        return Array.from(this.contractMetadata.values()).some(contract => contract.requiresRenouncingOwnership());
+    }
+    async resolveContractAddress(contractName) {
+        if (!this.instance) {
+            throw new Error(`Instance is not defined. Cannot resolve ${contractName} address.`);
+        }
+        return await this.instance.getContractAddress(contractName);
+    }
+    async loadContractMetadataAndCreateTransactions() {
+        /* eslint-disable no-await-in-loop */
+        // Do not parallelize to avoid rate limit issues which CAN produce wrong outputs - sensitive
+        for (const { name: contractName, address } of this.contractIds) {
+            const resolvedAddress = address || await this.resolveContractAddress(contractName);
+            if (!this.contractMetadata.has(resolvedAddress)) {
+                const details = {
+                    address: resolvedAddress,
+                    name: contractName,
+                };
+                const contractAdmin = new contractAdmin_1.ContractAdmin(details, this.oldOwner, this.newOwner);
+                await contractAdmin.scanPatternAndPermissionModels();
+                this.contractMetadata.set(resolvedAddress, contractAdmin);
+            }
+        }
+        /* eslint-enable no-await-in-loop */
+        await this.createRequiredTransactions();
+    }
+    async confirmData() {
+        this.displayFindings();
+        const userConfirmed = await this.promptConfirmation();
+        if (!userConfirmed) {
+            this.handleUserRejection();
+        }
+        console.log(chalk_1.default.green("\nUser confirmed. Proceeding...\n"));
+    }
+    processOptions(options) {
+        this.bytes32RolesToCheck = (options.rolesToCheck ?? []).map(role => ({
+            // Never will include "0x00..." as role - default admin handled separately
+            identifier: hardhat_1.ethers.id(role),
+            name: role
+        }));
+        this.bytes32RolesToCheck.push({ identifier: hardhat_1.ethers.ZeroHash, name: "DEFAULT_ADMIN_ROLE" });
+        if (!this.readonly && this.newOwner === hardhat_1.ethers.ZeroAddress) {
+            throw new Error("New owner address must be provided in options when in write mode.");
+        }
+        this.managerRolesToCheck = (options.managerRolesToCheck ?? []).map(role => {
+            if (typeof role !== "bigint" || role <= ZERO) {
+                throw new Error(`Invalid manager role: ${role}. Must be a non-zero bigint.`);
+            }
+            return { identifier: role, name: `Role ${role}` };
+        });
+        this.managerRolesToCheck.push({ identifier: BigInt(ZERO), name: "ADMIN_ROLE" });
+    }
+    async createRequiredTransactions() {
+        console.log(chalk_1.default.grey("INFO: The next Following steps will NOT submit any transactions to the blockchain."));
+        // Preferred to create sequentially due to rate limits of RPC providers - sensitive
+        /* eslint-disable no-await-in-loop */
+        for (const contract of this.contractMetadata.values()) {
+            await contract.createGrantOwnershipTransactions(this.bytes32RolesToCheck, this.managerRolesToCheck);
+            if (!contract.requiresGrantingOwnership()) {
+                await contract.createRenounceOwnershipTransactions(this.bytes32RolesToCheck, this.managerRolesToCheck);
+            }
+        }
+        /* eslint-enable no-await-in-loop */
+    }
+    getColumnWidths() {
+        let maxNameWidth = 0;
+        let maxAddressWidth = 0;
+        let maxPermissionsWidth = 0;
+        for (const contract of this.contractMetadata.values()) {
+            maxNameWidth = Math.max(maxNameWidth, contract.contractName.length);
+            maxAddressWidth = Math.max(maxAddressWidth, contract.address.length);
+            const permissions = contract.permissionModel?.join(", ") || "None";
+            maxPermissionsWidth = Math.max(maxPermissionsWidth, permissions.length);
+        }
+        return { maxAddressWidth, maxNameWidth, maxPermissionsWidth };
+    }
+    displayPatternGroup(pattern, contracts) {
+        const columnWidths = this.getColumnWidths();
+        console.log(chalk_1.default.bold(`\n${pattern} Pattern (${contracts.length} contracts):`));
+        for (const contract of contracts) {
+            contract.displayData(columnWidths);
+        }
+    }
+    displayFindings() {
+        console.log(chalk_1.default.cyan("\n=== Ownership Status Results ===\n"));
+        const groupedByPattern = this.groupMetadataByPattern();
+        for (const [pattern, contracts] of Object.entries(groupedByPattern)) {
+            if (contracts.length) {
+                this.displayPatternGroup(pattern, contracts);
+            }
+        }
+        console.log(chalk_1.default.cyan("\n==========================================\n"));
+    }
+    handleUserRejection() {
+        console.log(chalk_1.default.red("User did not confirm. Aborting and clearing all data..."));
+        this.contractMetadata.clear();
+        throw new Error("User aborted because some data was inaccurate. Data has been cleared.");
+    }
+    groupMetadataByPattern() {
+        const grouped = Object.values(utils_1.Pattern).
+            reduce((acc, pattern) => {
+            acc[pattern] = [];
+            return acc;
+        }, {});
+        for (const metadata of this.contractMetadata.values()) {
+            // Used only after scan - will be defined if it reaches here
+            grouped[metadata.pattern].push(metadata);
+        }
+        return grouped;
+    }
+    async promptConfirmation(msg) {
+        if (this.testMode) {
+            return true;
+        }
+        return await (0, utils_1.promptUserConfirmation)(msg);
+    }
+}
+exports.InstanceAdmin = InstanceAdmin;
+//# sourceMappingURL=instanceAdmin.js.map

package/dist/src/ownership-transfer/instanceAdmin.js.map

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

package/dist/src/ownership-transfer/permission-utils.d.ts

@@ -0,0 +1,32 @@
+import { AddressLike, Transaction } from "ethers";
+export declare enum PermissionModel {
+    OWNABLE = "OWNABLE",
+    ROLE_BASED = "ROLE_BASED",
+    ACCESS_MANAGED = "ACCESS_MANAGED",
+    ACCESS_MANAGER = "ACCESS_MANAGER"
+}
+export declare const isOwnable: (contractAddress: AddressLike) => Promise<boolean>;
+export declare const isAccessControl: (contractAddress: AddressLike) => Promise<boolean>;
+export declare const isAccessManager: (contractAddress: AddressLike) => Promise<boolean>;
+export declare const isAccessManaged: (contractAddress: AddressLike) => Promise<boolean>;
+export declare const transferOwnership: (contractAddress: string, newOwner: string, oldOwner: string) => Promise<Transaction | false>;
+export declare const grantRole: (input: {
+    contractAddress: string;
+    role: string;
+    newAccount: AddressLike;
+    oldAccount: AddressLike;
+}) => Promise<Transaction | false>;
+export declare const renounceRole: (contractAddress: string, role: string, oldAccount: AddressLike) => Promise<Transaction | boolean>;
+export declare const getPermissionModels: (address: AddressLike) => Promise<PermissionModel[]>;
+export declare const grantAccessManagerRole: (input: {
+    contractAddress: string;
+    role: bigint;
+    newAccount: AddressLike;
+    oldAccount: AddressLike;
+}) => Promise<Transaction | false>;
+export declare const renounceAccessManagerRole: (input: {
+    contractAddress: string;
+    role: bigint;
+    newAccount: AddressLike;
+    oldAccount: AddressLike;
+}) => Promise<Transaction | boolean>;

package/dist/src/ownership-transfer/permission-utils.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renounceAccessManagerRole = exports.grantAccessManagerRole = exports.getPermissionModels = exports.renounceRole = exports.grantRole = exports.transferOwnership = exports.isAccessManaged = exports.isAccessManager = exports.isAccessControl = exports.isOwnable = exports.PermissionModel = void 0;
+const constants_1 = require("./constants");
+const ethers_1 = require("ethers");
+const utils_1 = require("./utils");
+const hardhat_1 = require("hardhat");
+var PermissionModel;
+(function (PermissionModel) {
+    // Does not fully complete the process of Ownable2Step
+    PermissionModel["OWNABLE"] = "OWNABLE";
+    PermissionModel["ROLE_BASED"] = "ROLE_BASED";
+    PermissionModel["ACCESS_MANAGED"] = "ACCESS_MANAGED";
+    PermissionModel["ACCESS_MANAGER"] = "ACCESS_MANAGER";
+})(PermissionModel || (exports.PermissionModel = PermissionModel = {}));
+const ZERO = 0;
+const MIN_ROLE_HOLDERS = 2n;
+const verifyOwnableInterface = async (contract, contractAddress) => {
+    const owner = await contract.owner();
+    return owner !== hardhat_1.ethers.ZeroAddress &&
+        await (0, utils_1.hasFunctionSelector)(contractAddress, "transferOwnership(address)");
+};
+const isOwnable = async (contractAddress) => {
+    try {
+        const resolvedAddress = await hardhat_1.ethers.resolveAddress(contractAddress);
+        if (!await (0, utils_1.isContractAddress)(resolvedAddress)) {
+            return false;
+        }
+        const contract = new ethers_1.Contract(resolvedAddress, constants_1.OWNABLE_ABI, hardhat_1.ethers.provider);
+        return await verifyOwnableInterface(contract, resolvedAddress);
+    }
+    catch {
+        return false;
+    }
+};
+exports.isOwnable = isOwnable;
+const verifyAccessControlInterface = async (contract, contractAddress) => {
+    await contract.hasRole(hardhat_1.ethers.ZeroHash, hardhat_1.ethers.ZeroAddress);
+    return await (0, utils_1.hasFunctionSelector)(contractAddress, "grantRole(bytes32,address)") &&
+        await (0, utils_1.hasFunctionSelector)(contractAddress, "renounceRole(bytes32,address)");
+};
+const isAccessControl = async (contractAddress) => {
+    try {
+        const resolvedAddress = await hardhat_1.ethers.resolveAddress(contractAddress);
+        if (!await (0, utils_1.isContractAddress)(resolvedAddress)) {
+            return false;
+        }
+        const contract = new ethers_1.Contract(resolvedAddress, constants_1.ACCESS_CONTROL_ABI, hardhat_1.ethers.provider);
+        return await verifyAccessControlInterface(contract, resolvedAddress);
+    }
+    catch {
+        return false;
+    }
+};
+exports.isAccessControl = isAccessControl;
+const verifyAccessManagerInterface = async (contract, contractAddress) => {
+    const zeroRole = 0n;
+    await contract.hasRole(zeroRole, hardhat_1.ethers.ZeroAddress);
+    return await (0, utils_1.hasFunctionSelector)(contractAddress, "grantRole(uint64,address,uint32)") &&
+        await (0, utils_1.hasFunctionSelector)(contractAddress, "renounceRole(uint64,address)");
+};
+const isAccessManager = async (contractAddress) => {
+    try {
+        const resolvedAddress = await hardhat_1.ethers.resolveAddress(contractAddress);
+        if (!await (0, utils_1.isContractAddress)(resolvedAddress)) {
+            return false;
+        }
+        const contract = new ethers_1.Contract(resolvedAddress, constants_1.ACCESS_MANAGER_ABI, hardhat_1.ethers.provider);
+        return await verifyAccessManagerInterface(contract, resolvedAddress);
+    }
+    catch {
+        return false;
+    }
+};
+exports.isAccessManager = isAccessManager;
+const isAccessManaged = async (contractAddress) => {
+    try {
+        const resolvedAddress = await hardhat_1.ethers.resolveAddress(contractAddress);
+        if (!await (0, utils_1.isContractAddress)(resolvedAddress)) {
+            return false;
+        }
+        const contract = new ethers_1.Contract(resolvedAddress, constants_1.ACCESS_MANAGED_ABI, hardhat_1.ethers.provider);
+        const authorityAddress = await contract.authority();
+        return await (0, exports.isAccessManager)(authorityAddress);
+    }
+    catch {
+        return false;
+    }
+};
+exports.isAccessManaged = isAccessManaged;
+const transferOwnership = async (contractAddress, newOwner, oldOwner) => {
+    const contract = new ethers_1.Contract(contractAddress, constants_1.OWNABLE_ABI, hardhat_1.ethers.provider);
+    if (await contract.owner() === newOwner) {
+        return false;
+    }
+    if (await contract.owner() !== oldOwner) {
+        throw new Error(`Current owner of contract ${contractAddress} does not match the provided old owner address.`);
+    }
+    const data = contract.interface.encodeFunctionData("transferOwnership", [newOwner]);
+    const transaction = new ethers_1.Transaction();
+    transaction.to = contractAddress;
+    transaction.data = data;
+    return transaction;
+};
+exports.transferOwnership = transferOwnership;
+const grantRole = async (input) => {
+    const contract = new ethers_1.Contract(input.contractAddress, constants_1.ACCESS_CONTROL_ABI, hardhat_1.ethers.provider);
+    // If new account already has role or old account never had it in the first place - no action
+    if (await contract.hasRole(input.role, input.newAccount) || !await contract.hasRole(input.role, input.oldAccount)) {
+        return false;
+    }
+    if (!await contract.hasRole(hardhat_1.ethers.ZeroHash, input.oldAccount)) {
+        // Currently we do not support roleAdmins - must be ran by owner
+        throw new Error(`Account ${input.oldAccount} does not have permission to grant roles on contract ${input.contractAddress}.`);
+    }
+    const data = contract.interface.encodeFunctionData("grantRole", [input.role, input.newAccount]);
+    const transaction = new ethers_1.Transaction();
+    transaction.to = input.contractAddress;
+    transaction.data = data;
+    return transaction;
+};
+exports.grantRole = grantRole;
+const renounceRole = async (contractAddress, role, oldAccount) => {
+    const contract = new ethers_1.Contract(contractAddress, constants_1.ACCESS_CONTROL_ABI, hardhat_1.ethers.provider);
+    if (!await contract.hasRole(role, oldAccount)) {
+        return true;
+    }
+    // Prevent revoking last role holder of default admin role
+    if (role === hardhat_1.ethers.ZeroHash && (await contract.getRoleMemberCount(role)) < MIN_ROLE_HOLDERS) {
+        return false;
+    }
+    const data = contract.interface.encodeFunctionData("renounceRole", [role, oldAccount]);
+    const transaction = new ethers_1.Transaction();
+    transaction.to = contractAddress;
+    transaction.data = data;
+    return transaction;
+};
+exports.renounceRole = renounceRole;
+const getPermissionModels = async (address) => {
+    const checks = [
+        { check: exports.isOwnable, model: PermissionModel.OWNABLE },
+        { check: exports.isAccessControl, model: PermissionModel.ROLE_BASED },
+        { check: exports.isAccessManager, model: PermissionModel.ACCESS_MANAGER },
+        { check: exports.isAccessManaged, model: PermissionModel.ACCESS_MANAGED }
+    ];
+    const models = [];
+    // Change to await in loop if rate-limiting becomes an issue
+    await Promise.all(checks.map(async ({ check, model }) => {
+        if (await check(address)) {
+            models.push(model);
+        }
+    }));
+    if (models.includes(PermissionModel.ACCESS_MANAGER) && models.includes(PermissionModel.ROLE_BASED)) {
+        throw new Error(`Address ${address} cannot be both ACCESS_MANAGER and ROLE_BASED permission models.`);
+    }
+    return models;
+};
+exports.getPermissionModels = getPermissionModels;
+const grantAccessManagerRole = async (input) => {
+    const contract = new ethers_1.Contract(input.contractAddress, constants_1.ACCESS_MANAGER_ABI, hardhat_1.ethers.provider);
+    // If new account already has role or old account never had it in the first place - no action
+    if (await contract.hasRole(input.role, input.newAccount) || !await contract.hasRole(input.role, input.oldAccount)) {
+        return false;
+    }
+    if (!await contract.hasRole(ZERO, input.oldAccount)) {
+        // Currently we do not support roleAdmins - must be ran by owner
+        throw new Error(`Account ${input.oldAccount} does not have permission to grant roles on contract ${input.contractAddress}.`);
+    }
+    const data = contract.interface.encodeFunctionData("grantRole", [input.role, input.newAccount, ZERO]);
+    const transaction = new ethers_1.Transaction();
+    transaction.to = input.contractAddress;
+    transaction.data = data;
+    return transaction;
+};
+exports.grantAccessManagerRole = grantAccessManagerRole;
+const renounceAccessManagerRole = async (input) => {
+    const contract = new ethers_1.Contract(input.contractAddress, constants_1.ACCESS_MANAGER_ABI, hardhat_1.ethers.provider);
+    if (!await contract.hasRole(input.role, input.oldAccount)) {
+        return true;
+    }
+    // Ensure role was granted to newAccount before renouncing
+    if (input.role === BigInt(ZERO) && !(await contract.hasRole(input.role, input.newAccount))) {
+        return false;
+    }
+    const data = contract.interface.encodeFunctionData("renounceRole", [input.role, input.oldAccount]);
+    const transaction = new ethers_1.Transaction();
+    transaction.to = input.contractAddress;
+    transaction.data = data;
+    return transaction;
+};
+exports.renounceAccessManagerRole = renounceAccessManagerRole;
+//# sourceMappingURL=permission-utils.js.map

package/dist/src/ownership-transfer/permission-utils.js.map

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

package/dist/src/ownership-transfer/utils.d.ts

@@ -0,0 +1,19 @@
+import { AddressLike } from "ethers";
+import { TransactionData } from "./contractAdmin";
+export declare enum Pattern {
+    TUPP = "TUPP",
+    BEACON = "BEACON",
+    REGULAR = "REGULAR"
+}
+export declare const isContractAddress: (address: string) => Promise<boolean>;
+export declare const extractAddressFromSlot: (slotValue: string) => string;
+export declare const getAdminAddress: (address: string) => Promise<string>;
+export declare const getTUPPImplementationAddress: (address: string) => Promise<string>;
+export declare const isTUPPPattern: (address: string) => Promise<boolean>;
+export declare const hasFunctionSelector: (address: string, signature: string) => Promise<boolean>;
+export declare const isMultisig: (contractAddress: AddressLike) => Promise<boolean>;
+export declare const isBeaconPattern: (address: string) => Promise<boolean>;
+export declare const identifyProxyPattern: (address: string) => Promise<Pattern>;
+export declare const promptUserConfirmation: (message?: string) => Promise<boolean>;
+export declare const detectPattern: (address: AddressLike) => Promise<Pattern>;
+export declare const removeDuplicateTransactions: (items: TransactionData[]) => TransactionData[];