gate-evm-tools 1.0.22 → 1.0.24

package/dist-cjs/core/syncUpgradeJson.js

@@ -0,0 +1,315 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncNetworkFile = syncNetworkFile;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const openzeppelin_js_1 = require("../utils/openzeppelin.js");
+const manifestTransaction_js_1 = require("../utils/manifestTransaction.js");
+/**
+ * 同步链上合约状态到本地 .openzeppelin 网络文件
+ *
+ * 使用场景：
+ * 当合约升级是通过 calldata 方式由其他人执行时，本地的 .openzeppelin 文件不会自动更新
+ * 使用此脚本可以从链上读取最新状态并更新本地文件，确保下次升级验证时有正确的参考
+ *
+ * @param options - 同步选项
+ */
+async function syncNetworkFile(options) {
+    const { proxyAddress, contractName, networkName, constructorArgs, skipTxHash, hre } = options;
+    console.log('\n🔄 开始同步链上状态到本地网络文件...');
+    console.log('=====================================\n');
+    const PROXY_ADDRESS = proxyAddress;
+    const CONTRACT_NAME = contractName;
+    const CONSTRUCTOR_ARGS = constructorArgs || [];
+    // 获取网络名称和 chainId
+    const network = await hre.ethers.provider.getNetwork();
+    const chainId = Number(network.chainId);
+    const NETWORK_NAME = networkName || network.name;
+    console.log('📋 同步配置:');
+    console.log('-------------------------------------');
+    console.log('代理合约地址:', PROXY_ADDRESS);
+    console.log('合约名称:', CONTRACT_NAME);
+    console.log('网络:', NETWORK_NAME);
+    console.log('Chain ID:', chainId);
+    if (CONSTRUCTOR_ARGS.length > 0) {
+        console.log('构造函数参数:', CONSTRUCTOR_ARGS);
+    }
+    console.log('-------------------------------------\n');
+    // Step 1: 编译合约以获取最新的存储布局
+    console.log('🔨 Step 1: 编译合约获取存储布局...');
+    try {
+        await hre.run('compile', { quiet: true });
+        console.log('✅ 编译完成\n');
+    }
+    catch (error) {
+        console.error('❌ 编译失败:', error.message);
+        throw error;
+    }
+    // Step 2: 从链上读取当前实现合约地址
+    console.log('🔍 Step 2: 读取链上实现合约地址...');
+    let currentImplementation;
+    try {
+        currentImplementation = await hre.upgrades.erc1967.getImplementationAddress(PROXY_ADDRESS);
+        console.log('✅ 当前实现合约:', currentImplementation);
+        console.log('');
+    }
+    catch (error) {
+        console.error('❌ 读取实现地址失败:', error.message);
+        throw error;
+    }
+    // Step 3: 获取实现合约的部署交易哈希（尝试从事件获取）
+    console.log('🔍 Step 3: 获取实现合约部署信息...');
+    let implTxHash = '0x0'; // 默认值，如果无法获取
+    if (skipTxHash) {
+        console.log('⏭️  已通过参数禁用 txHash 补充，跳过事件查询');
+    }
+    else {
+        try {
+            // 尝试通过 Upgraded 事件获取升级交易哈希
+            const proxyContract = await hre.ethers.getContractAt('UUPSUpgradeable', PROXY_ADDRESS);
+            const currentBlock = await hre.ethers.provider.getBlockNumber();
+            // 免费 RPC 节点通常限制查询范围，使用较小的区块范围
+            // 可以分批查询，从最近的区块开始往前查
+            const batchSize = 5000; // 每次查询 5000 个区块
+            const maxBatches = 3000; // 最多查 3000 批（15000000 个区块）
+            let found = false;
+            for (let i = 0; i < maxBatches && !found; i++) {
+                const toBlock = currentBlock - (i * batchSize);
+                const fromBlock = Math.max(0, toBlock - batchSize);
+                try {
+                    const filter = proxyContract.filters.Upgraded();
+                    const events = await proxyContract.queryFilter(filter, fromBlock, toBlock);
+                    if (events.length > 0) {
+                        // 找到最后一次升级到当前实现的事件
+                        const latestUpgrade = events
+                            .reverse()
+                            .find((event) => event.args && event.args[0].toLowerCase() === currentImplementation.toLowerCase());
+                        if (latestUpgrade) {
+                            implTxHash = latestUpgrade.transactionHash;
+                            console.log('✅ 找到升级交易:', implTxHash);
+                            found = true;
+                            break;
+                        }
+                    }
+                }
+                catch (batchError) {
+                    if (i === 0) {
+                        console.log(`⚠️  查询区块范围 ${fromBlock}-${toBlock} 失败: ${batchError.message}`);
+                    }
+                }
+            }
+            if (!found) {
+                console.log('⚠️  未找到对应的升级事件（可能需要查询更早的区块），使用默认交易哈希');
+            }
+        }
+        catch (error) {
+            console.log('⚠️  获取交易哈希失败，使用默认值:', error.message);
+        }
+    }
+    console.log('');
+    const projectRoot = process.cwd();
+    const manifestPaths = await (0, openzeppelin_js_1.getOpenZeppelinManifestPaths)(hre);
+    const networkFilePath = manifestPaths.file;
+    const transaction = await (0, manifestTransaction_js_1.withManifestTransaction)({
+        root: projectRoot,
+        manifestFile: networkFilePath,
+        fallbackFile: manifestPaths.fallbackFile,
+        operation: async ({ writeManifestAtomic }) => {
+            // Step 4: 使用 OpenZeppelin 官方的 forceImport 方法同步状态
+            console.log('📊 Step 4: 使用 forceImport 同步链上状态...');
+            console.log('   这会自动更新 .openzeppelin 文件，包括完整的存储布局和命名空间');
+            console.log('');
+            try {
+                const ContractFactory = await hre.ethers.getContractFactory(CONTRACT_NAME);
+                if (CONSTRUCTOR_ARGS.length > 0) {
+                    console.log(`   📝 使用构造函数参数:`, CONSTRUCTOR_ARGS);
+                    console.log('');
+                }
+                // forceImport: 强制导入已存在的代理，更新本地 .openzeppelin 文件
+                // 这是 OpenZeppelin 官方推荐的同步方式
+                const importOptions = {
+                    kind: 'uups',
+                    unsafeAllow: (0, openzeppelin_js_1.mergeUnsafeAllow)()
+                };
+                // 如果有构造函数参数，添加到选项中
+                if (CONSTRUCTOR_ARGS.length > 0) {
+                    importOptions.constructorArgs = CONSTRUCTOR_ARGS;
+                }
+                await (0, openzeppelin_js_1.forceImportWithRetry)(hre, PROXY_ADDRESS, ContractFactory, importOptions);
+                console.log('✅ forceImport 完成！');
+                console.log('');
+            }
+            catch (error) {
+                console.error('❌ forceImport 失败:', error.message);
+                console.error(`   代理合约状态: ${await (0, openzeppelin_js_1.getCodeStatus)(hre, PROXY_ADDRESS)}`);
+                console.error(`   实现合约状态: ${await (0, openzeppelin_js_1.getCodeStatus)(hre, currentImplementation)}`);
+                console.error('');
+                throw error;
+            }
+            // Step 5: 查找正确的网络文件并补充交易哈希
+            console.log('📊 Step 5: 查找网络文件并补充交易哈希...');
+            const actualNetworkName = path.basename(networkFilePath, '.json');
+            console.log('   ✅ OpenZeppelin manifest 文件:', path.basename(networkFilePath));
+            if (!fs.existsSync(networkFilePath)) {
+                const error = new Error('未找到 .openzeppelin 网络文件');
+                console.error('❌ 错误: 未找到 .openzeppelin 网络文件');
+                console.error(`   OpenZeppelin 预期文件: ${networkFilePath}`);
+                console.error('   请确认 forceImport 已成功执行');
+                throw error;
+            }
+            console.log('   📄 使用网络文件:', actualNetworkName + '.json');
+            console.log('');
+            let networkFile = JSON.parse(fs.readFileSync(networkFilePath, 'utf8'));
+            // 查找当前代理的实现信息
+            const proxyInfo = networkFile.proxies?.find((p) => p.address.toLowerCase() === PROXY_ADDRESS.toLowerCase());
+            if (!proxyInfo) {
+                const error = new Error('代理信息未找到');
+                console.error('❌ 错误: 代理信息未找到');
+                throw error;
+            }
+            // 查找实现合约的布局信息
+            let layoutInfo = null;
+            let layoutHash = '';
+            let needsSave = false;
+            for (const [hash, impl] of Object.entries(networkFile.impls || {})) {
+                const implData = impl;
+                // 检查是否匹配：
+                // 1. 直接匹配 address 字段
+                // 2. 在 allAddresses 数组中查找（多次升级可能共享相同布局）
+                const isMatch = implData.address.toLowerCase() === currentImplementation.toLowerCase() ||
+                    (implData.allAddresses && Array.isArray(implData.allAddresses) &&
+                        implData.allAddresses.some((addr) => addr.toLowerCase() === currentImplementation.toLowerCase()));
+                if (isMatch) {
+                    layoutHash = hash;
+                    layoutInfo = implData.layout;
+                    console.log('   ✅ 找到实现合约的布局信息');
+                    if (implData.allAddresses && implData.allAddresses.length > 1) {
+                        console.log(`   📋 该布局被 ${implData.allAddresses.length} 个实现合约共享`);
+                        console.log(`      主地址: ${implData.address}`);
+                        console.log(`      所有地址: ${implData.allAddresses.join(', ')}`);
+                    }
+                    console.log('');
+                    // 检查并补充交易哈希（只对主地址有效）
+                    if (implData.address.toLowerCase() === currentImplementation.toLowerCase()) {
+                        if (!implData.txHash && implTxHash && implTxHash !== '0x0') {
+                            console.log('   💾 补充交易哈希到记录...');
+                            console.log('      交易哈希:', implTxHash);
+                            // 重新构建对象，确保字段顺序
+                            const newImpl = {
+                                address: implData.address,
+                                txHash: implTxHash,
+                                layout: implData.layout
+                            };
+                            // 保留 allAddresses 字段（如果存在）
+                            if (implData.allAddresses) {
+                                newImpl.allAddresses = implData.allAddresses;
+                            }
+                            // 替换原有的实现记录
+                            networkFile.impls[hash] = newImpl;
+                            needsSave = true;
+                        }
+                        else if (implData.txHash) {
+                            console.log('   ✅ 交易哈希已存在:', implData.txHash);
+                        }
+                        else {
+                            console.log('   ⚠️  未获取到交易哈希');
+                        }
+                    }
+                    break;
+                }
+            }
+            // 保存更新后的文件
+            if (needsSave) {
+                try {
+                    writeManifestAtomic(Buffer.from(`${JSON.stringify(networkFile, null, 2)}\n`));
+                    console.log('   💾 文件已保存');
+                }
+                catch (error) {
+                    console.error('   ❌ 保存文件失败:', error.message);
+                    throw error;
+                }
+            }
+            console.log('');
+            if (!layoutInfo) {
+                const error = new Error('未找到实现合约的布局信息');
+                console.error('❌ 错误: 未找到实现合约的布局信息');
+                throw error;
+            }
+            console.log('✅ 同步结果验证通过！');
+            console.log('');
+            // 总结
+            console.log('=====================================');
+            console.log('✅ 同步完成！');
+            console.log('=====================================');
+            console.log('');
+            console.log('📋 同步摘要:');
+            console.log('-------------------------------------');
+            console.log('代理合约:', PROXY_ADDRESS);
+            console.log('实现合约:', currentImplementation);
+            console.log('布局哈希:', layoutHash.substring(0, 16) + '...');
+            console.log('存储变量:', layoutInfo.storage?.length || 0, '个');
+            console.log('命名空间:', Object.keys(layoutInfo.namespaces || {}).length, '个');
+            console.log('类型定义:', Object.keys(layoutInfo.types || {}).length, '个');
+            console.log('网络文件:', networkFilePath);
+            console.log('-------------------------------------');
+            console.log('');
+            // 显示命名空间详情
+            if (layoutInfo.namespaces && Object.keys(layoutInfo.namespaces).length > 0) {
+                console.log('📦 命名空间详情:');
+                for (const [namespace, vars] of Object.entries(layoutInfo.namespaces)) {
+                    console.log(`   - ${namespace}: ${vars.length} 个变量`);
+                }
+                console.log('');
+            }
+            return {
+                proxyAddress: PROXY_ADDRESS,
+                implementationAddress: currentImplementation,
+                layoutHash: layoutHash.substring(0, 16) + '...',
+                networkFile: networkFilePath,
+                success: true,
+            };
+        },
+    });
+    console.log('Manifest before hash:', transaction.report.beforeHash);
+    console.log('Manifest after hash:', transaction.report.afterHash);
+    console.log('Sync report:', transaction.reportFile);
+    return {
+        ...transaction.value,
+        manifestTransaction: transaction.report,
+        syncReport: transaction.reportFile,
+    };
+}
+//# sourceMappingURL=syncUpgradeJson.js.map

package/dist-cjs/core/syncUpgradeJson.js.map

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

package/dist-cjs/custody/credential.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJECT_SECRET_PATTERN = exports.PRIVATE_KEY_PATTERN = void 0;
+exports.parseWalletCredential = parseWalletCredential;
+exports.resolveWalletCredential = resolveWalletCredential;
+exports.resolveHardhatAccounts = resolveHardhatAccounts;
+exports.PRIVATE_KEY_PATTERN = /^(?:0x)?[0-9a-fA-F]{64}$/;
+exports.PROJECT_SECRET_PATTERN = /^sk-(?:test|live)-[A-Z0-9_-]+\.[A-Za-z0-9_-]{32}$/;
+const ADDRESS_PATTERN = /^0x[0-9a-fA-F]{40}$/;
+const ZERO_ADDRESS = /^0x0{40}$/i;
+const CUSTODY_PREFIX = 'custody:';
+function parseWalletCredential(value) {
+    const credential = value.trim();
+    if (exports.PRIVATE_KEY_PATTERN.test(credential)) {
+        return {
+            kind: 'private-key',
+            privateKey: credential.startsWith('0x')
+                ? credential
+                : `0x${credential}`,
+        };
+    }
+    if (credential.startsWith(CUSTODY_PREFIX)) {
+        return parseCustodyCredential(credential);
+    }
+    throw new Error('不支持的钱包凭证格式：请传入 64 位十六进制私钥或 custody 凭证');
+}
+function resolveWalletCredential(env = process.env) {
+    const unified = normalizeOptionalValue(env.WALLET_CREDENTIAL);
+    const legacy = normalizeOptionalValue(env.PRIVATE_KEY);
+    if (unified !== undefined && legacy !== undefined && unified !== legacy) {
+        throw new Error('WALLET_CREDENTIAL 与 PRIVATE_KEY 配置冲突');
+    }
+    const value = unified ?? legacy;
+    return value === undefined ? undefined : parseWalletCredential(value);
+}
+function resolveHardhatAccounts(value) {
+    const normalized = normalizeOptionalValue(value);
+    if (normalized === undefined) {
+        return [];
+    }
+    const credential = parseWalletCredential(normalized);
+    return credential.kind === 'private-key' ? [credential.privateKey] : [];
+}
+function parseCustodyCredential(value) {
+    const remainder = value.slice(CUSTODY_PREFIX.length);
+    const separatorIndex = remainder.lastIndexOf(':');
+    if (separatorIndex <= 0) {
+        throw new Error('托管钱包凭证格式无效');
+    }
+    const secret = remainder.slice(0, separatorIndex);
+    const address = remainder.slice(separatorIndex + 1);
+    if (!exports.PROJECT_SECRET_PATTERN.test(secret)) {
+        throw new Error('托管钱包凭证中的 Project Secret 格式无效');
+    }
+    if (!ADDRESS_PATTERN.test(address)) {
+        throw new Error('托管钱包凭证中的钱包地址格式无效');
+    }
+    if (ZERO_ADDRESS.test(address)) {
+        throw new Error('托管钱包地址不能是零地址');
+    }
+    return {
+        kind: 'custody',
+        secret,
+        address,
+    };
+}
+function normalizeOptionalValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized === '' ? undefined : normalized;
+}
+//# sourceMappingURL=credential.js.map

package/dist-cjs/custody/credential.js.map

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

package/dist-cjs/custody/hardhat-runtime.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCustodyHardhatRuntime = installCustodyHardhatRuntime;
+const credential_js_1 = require("./credential.js");
+const signer_js_1 = require("./signer.js");
+const version_js_1 = require("./version.js");
+const installedEnvironments = new WeakSet();
+function installCustodyHardhatRuntime(hre, options = {}) {
+    if (installedEnvironments.has(hre)) {
+        return;
+    }
+    const ethersRuntime = hre.ethers;
+    if (typeof ethersRuntime !== 'object' ||
+        ethersRuntime === null ||
+        typeof ethersRuntime.getSigners !== 'function' ||
+        typeof ethersRuntime.getSigner !== 'function' ||
+        typeof ethersRuntime.provider?.getSigner !== 'function') {
+        throw new Error('gate-evm-tools/hardhat 必须在 Hardhat ethers 插件之后加载');
+    }
+    const env = options.env ?? process.env;
+    const logger = options.logger ?? ((message) => console.info(message));
+    const originalGetSigners = ethersRuntime.getSigners;
+    const originalGetSigner = ethersRuntime.getSigner;
+    const originalProviderGetSigner = ethersRuntime.provider.getSigner;
+    let cachedKey;
+    let cachedSigner;
+    const readCustodyCredential = () => {
+        if (env.GATE_MIGRATION_READ_ONLY?.trim() === '1') {
+            return undefined;
+        }
+        const credential = (0, credential_js_1.resolveWalletCredential)(env);
+        return credential?.kind === 'custody' ? credential : undefined;
+    };
+    const getCustodySigner = (credential) => {
+        const baseUrl = env.CUSTODY_API_BASE_URL?.trim();
+        if (!baseUrl) {
+            throw new Error('托管钱包模式必须配置 CUSTODY_API_BASE_URL');
+        }
+        const credentialValue = `custody:${credential.secret}:${credential.address}`;
+        const cacheKey = `${credentialValue}\n${baseUrl}`;
+        if (cachedSigner !== undefined && cachedKey === cacheKey) {
+            return cachedSigner;
+        }
+        cachedSigner = (0, signer_js_1.createSigner)({
+            ethers: ethersRuntime,
+            credential: credentialValue,
+            provider: ethersRuntime.provider,
+            baseUrl,
+            fetchImpl: options.fetchImpl,
+        });
+        cachedKey = cacheKey;
+        const major = (0, version_js_1.detectEthersMajor)(ethersRuntime);
+        logger(`[gate-evm-tools] custody signer enabled (ethers v${major}, ${credential.address})`);
+        return cachedSigner;
+    };
+    ethersRuntime.getSigners = async (...args) => {
+        const credential = readCustodyCredential();
+        if (credential === undefined) {
+            return originalGetSigners.apply(ethersRuntime, args);
+        }
+        return [getCustodySigner(credential)];
+    };
+    ethersRuntime.getSigner = async (...args) => {
+        const credential = readCustodyCredential();
+        const requestedAddress = args[0];
+        if (credential !== undefined &&
+            typeof requestedAddress === 'string' &&
+            addressesMatch(ethersRuntime, credential.address, requestedAddress)) {
+            return getCustodySigner(credential);
+        }
+        return originalGetSigner.apply(ethersRuntime, args);
+    };
+    ethersRuntime.provider.getSigner = (...args) => {
+        const credential = readCustodyCredential();
+        const requestedAccount = args[0];
+        if (credential !== undefined &&
+            (requestedAccount === undefined ||
+                requestedAccount === null ||
+                requestedAccount === 0 ||
+                (typeof requestedAccount === 'string' &&
+                    addressesMatch(ethersRuntime, credential.address, requestedAccount)))) {
+            const signer = getCustodySigner(credential);
+            return (0, version_js_1.detectEthersMajor)(ethersRuntime) === 6
+                ? Promise.resolve(signer)
+                : signer;
+        }
+        return originalProviderGetSigner.apply(ethersRuntime.provider, args);
+    };
+    installedEnvironments.add(hre);
+}
+function addressesMatch(ethersRuntime, first, second) {
+    try {
+        const major = (0, version_js_1.detectEthersMajor)(ethersRuntime);
+        const getAddress = major === 6 ? ethersRuntime.getAddress : ethersRuntime.utils?.getAddress;
+        if (typeof getAddress !== 'function') {
+            return first.toLowerCase() === second.toLowerCase();
+        }
+        return getAddress(first) === getAddress(second);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hardhat-runtime.js.map

package/dist-cjs/custody/hardhat-runtime.js.map

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

package/dist-cjs/custody/hardhat.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWalletCredential = exports.resolveHardhatAccounts = exports.parseWalletCredential = exports.installCustodyHardhatRuntime = void 0;
+const config_js_1 = require("hardhat/config.js");
+const hardhat_runtime_js_1 = require("./hardhat-runtime.js");
+(0, config_js_1.extendEnvironment)((hre) => {
+    (0, hardhat_runtime_js_1.installCustodyHardhatRuntime)(hre);
+});
+var hardhat_runtime_js_2 = require("./hardhat-runtime.js");
+Object.defineProperty(exports, "installCustodyHardhatRuntime", { enumerable: true, get: function () { return hardhat_runtime_js_2.installCustodyHardhatRuntime; } });
+var credential_js_1 = require("./credential.js");
+Object.defineProperty(exports, "parseWalletCredential", { enumerable: true, get: function () { return credential_js_1.parseWalletCredential; } });
+Object.defineProperty(exports, "resolveHardhatAccounts", { enumerable: true, get: function () { return credential_js_1.resolveHardhatAccounts; } });
+Object.defineProperty(exports, "resolveWalletCredential", { enumerable: true, get: function () { return credential_js_1.resolveWalletCredential; } });
+//# sourceMappingURL=hardhat.js.map

package/dist-cjs/custody/hardhat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat.js","sourceRoot":"","sources":["../../src/custody/hardhat.ts"],"names":[],"mappings":";;;AAAA,iDAAsD;AAEtD,6DAAoE;AAEpE,IAAA,6BAAiB,EAAC,CAAC,GAAG,EAAE,EAAE;IACxB,IAAA,iDAA4B,EAAC,GAAU,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEH,2DAG8B;AAF5B,kIAAA,4BAA4B,OAAA;AAG9B,iDAKyB;AAJvB,sHAAA,qBAAqB,OAAA;AACrB,uHAAA,sBAAsB,OAAA;AACtB,wHAAA,uBAAuB,OAAA"}

package/dist-cjs/custody/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCustodyHardhatRuntime = exports.CustodyServiceClient = exports.createSigner = exports.detectEthersMajor = exports.resolveWalletCredential = exports.resolveHardhatAccounts = exports.parseWalletCredential = exports.PROJECT_SECRET_PATTERN = exports.PRIVATE_KEY_PATTERN = void 0;
+var credential_js_1 = require("./credential.js");
+Object.defineProperty(exports, "PRIVATE_KEY_PATTERN", { enumerable: true, get: function () { return credential_js_1.PRIVATE_KEY_PATTERN; } });
+Object.defineProperty(exports, "PROJECT_SECRET_PATTERN", { enumerable: true, get: function () { return credential_js_1.PROJECT_SECRET_PATTERN; } });
+Object.defineProperty(exports, "parseWalletCredential", { enumerable: true, get: function () { return credential_js_1.parseWalletCredential; } });
+Object.defineProperty(exports, "resolveHardhatAccounts", { enumerable: true, get: function () { return credential_js_1.resolveHardhatAccounts; } });
+Object.defineProperty(exports, "resolveWalletCredential", { enumerable: true, get: function () { return credential_js_1.resolveWalletCredential; } });
+var version_js_1 = require("./version.js");
+Object.defineProperty(exports, "detectEthersMajor", { enumerable: true, get: function () { return version_js_1.detectEthersMajor; } });
+var signer_js_1 = require("./signer.js");
+Object.defineProperty(exports, "createSigner", { enumerable: true, get: function () { return signer_js_1.createSigner; } });
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "CustodyServiceClient", { enumerable: true, get: function () { return service_js_1.CustodyServiceClient; } });
+var hardhat_runtime_js_1 = require("./hardhat-runtime.js");
+Object.defineProperty(exports, "installCustodyHardhatRuntime", { enumerable: true, get: function () { return hardhat_runtime_js_1.installCustodyHardhatRuntime; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/custody/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/custody/index.ts"],"names":[],"mappings":";;;AAAA,iDASyB;AARvB,oHAAA,mBAAmB,OAAA;AACnB,uHAAA,sBAAsB,OAAA;AACtB,sHAAA,qBAAqB,OAAA;AACrB,uHAAA,sBAAsB,OAAA;AACtB,wHAAA,uBAAuB,OAAA;AAKzB,2CAAiD;AAAxC,+GAAA,iBAAiB,OAAA;AAC1B,yCAAqE;AAA5D,yGAAA,YAAY,OAAA;AACrB,2CAGsB;AAFpB,kHAAA,oBAAoB,OAAA;AAGtB,2DAG8B;AAF5B,kIAAA,4BAA4B,OAAA"}