gate-evm-tools 1.0.22 → 1.0.23

package/dist/custody/signer.js

@@ -0,0 +1,258 @@
+import { parseWalletCredential } from './credential.js';
+import { CustodyServiceClient, requireResponseString, } from './service.js';
+import { detectEthersMajor } from './version.js';
+export function createSigner(options) {
+    const credential = parseWalletCredential(options.credential);
+    const major = detectEthersMajor(options.ethers);
+    if (credential.kind === 'private-key') {
+        const Wallet = requireRuntimeConstructor(options.ethers, 'Wallet');
+        return new Wallet(credential.privateKey, options.provider ?? null);
+    }
+    if (options.provider === undefined || options.provider === null) {
+        throw new Error('托管钱包凭证必须同时提供 ethers Provider');
+    }
+    const address = normalizeAddress(options.ethers, major, credential.address);
+    const clientOptions = {
+        credential: options.credential.trim(),
+        address,
+        baseUrl: options.baseUrl,
+        fetchImpl: options.fetchImpl,
+    };
+    const client = new CustodyServiceClient(clientOptions);
+    return major === 6
+        ? createEthersV6Signer(options.ethers, address, options.provider, client)
+        : createEthersV5Signer(options.ethers, address, options.provider, client);
+}
+function createEthersV6Signer(ethersRuntime, address, provider, client) {
+    const AbstractSigner = requireRuntimeConstructor(ethersRuntime, 'AbstractSigner');
+    const Transaction = requireRuntimeConstructor(ethersRuntime, 'Transaction');
+    return new (class CustodyEthersV6Signer extends AbstractSigner {
+        address = address;
+        constructor(connectedProvider) {
+            super(connectedProvider);
+        }
+        async getAddress() {
+            return this.address;
+        }
+        connect(connectedProvider) {
+            return new CustodyEthersV6Signer(connectedProvider);
+        }
+        async signTransaction(transactionRequest) {
+            assertTransactionFrom(ethersRuntime, 6, transactionRequest.from, this.address);
+            const transactionInput = transactionRequest instanceof Transaction
+                ? transactionRequest
+                : { ...transactionRequest };
+            if (!(transactionRequest instanceof Transaction)) {
+                delete transactionInput.from;
+            }
+            let unsignedTransaction;
+            try {
+                unsignedTransaction = Transaction.from(transactionInput);
+            }
+            catch {
+                throw new Error('交易必须是字段完整且地址已解析的未签名交易');
+            }
+            if (unsignedTransaction.signature) {
+                throw new Error('交易必须是未签名交易');
+            }
+            const result = await client.signTransaction({
+                transaction: unsignedTransaction.toJSON(),
+                chainId: unsignedTransaction.chainId.toString(),
+            });
+            const serialized = requireResponseString(result, 'signedTransaction');
+            let signedTransaction;
+            try {
+                signedTransaction = Transaction.from(serialized);
+            }
+            catch {
+                throw new Error('托管服务返回了无效的已签名交易');
+            }
+            if (!signedTransaction.signature || !signedTransaction.from) {
+                throw new Error('托管服务返回的交易缺少有效签名');
+            }
+            if (signedTransaction.unsignedHash !== unsignedTransaction.unsignedHash) {
+                throw new Error('托管服务返回的交易与原始交易不一致');
+            }
+            assertRecoveredAddress(ethersRuntime, 6, signedTransaction.from, this.address);
+            return signedTransaction.serialized;
+        }
+        async signMessage(message) {
+            const result = await client.signMessage(typeof message === 'string'
+                ? { message }
+                : { messageHex: ethersRuntime.hexlify(message) });
+            const signature = normalizeV6Signature(ethersRuntime, result);
+            assertRecoveredAddress(ethersRuntime, 6, ethersRuntime.verifyMessage(message, signature), this.address);
+            return signature;
+        }
+        async signTypedData(domain, types, value) {
+            const result = await client.signTypedData({ domain, types, value });
+            const signature = normalizeV6Signature(ethersRuntime, result);
+            assertRecoveredAddress(ethersRuntime, 6, ethersRuntime.verifyTypedData(domain, types, value, signature), this.address);
+            return signature;
+        }
+    })(provider);
+}
+function createEthersV5Signer(ethersRuntime, address, provider, client) {
+    const Signer = requireRuntimeConstructor(ethersRuntime, 'Signer');
+    const utils = requireRuntimeObject(ethersRuntime, 'utils');
+    return new (class CustodyEthersV5Signer extends Signer {
+        address = address;
+        constructor(connectedProvider) {
+            super();
+            Object.defineProperty(this, 'provider', {
+                value: connectedProvider,
+                enumerable: true,
+                configurable: false,
+                writable: false,
+            });
+        }
+        async getAddress() {
+            return this.address;
+        }
+        connect(connectedProvider) {
+            return new CustodyEthersV5Signer(connectedProvider);
+        }
+        async signTransaction(transactionRequest) {
+            const resolvedRequest = await utils.resolveProperties(transactionRequest);
+            assertTransactionFrom(ethersRuntime, 5, resolvedRequest.from, this.address);
+            const unsignedTransaction = selectV5TransactionFields(resolvedRequest);
+            let unsignedSerialized;
+            try {
+                unsignedSerialized = utils.serializeTransaction(unsignedTransaction);
+            }
+            catch {
+                throw new Error('交易必须是字段完整且地址已解析的未签名交易');
+            }
+            const result = await client.signTransaction({
+                transaction: serializeV5TransactionForService(unsignedTransaction),
+                chainId: String(unsignedTransaction.chainId),
+            });
+            const serialized = requireResponseString(result, 'signedTransaction');
+            let signedTransaction;
+            try {
+                signedTransaction = utils.parseTransaction(serialized);
+            }
+            catch {
+                throw new Error('托管服务返回了无效的已签名交易');
+            }
+            if (!signedTransaction.from || !signedTransaction.r || !signedTransaction.s) {
+                throw new Error('托管服务返回的交易缺少有效签名');
+            }
+            const returnedUnsigned = utils.serializeTransaction(selectV5TransactionFields(signedTransaction));
+            if (returnedUnsigned.toLowerCase() !== unsignedSerialized.toLowerCase()) {
+                throw new Error('托管服务返回的交易与原始交易不一致');
+            }
+            assertRecoveredAddress(ethersRuntime, 5, signedTransaction.from, this.address);
+            return serialized;
+        }
+        async signMessage(message) {
+            const result = await client.signMessage(typeof message === 'string'
+                ? { message }
+                : { messageHex: utils.hexlify(message) });
+            const signature = normalizeV5Signature(utils, result);
+            assertRecoveredAddress(ethersRuntime, 5, utils.verifyMessage(message, signature), this.address);
+            return signature;
+        }
+        async _signTypedData(domain, types, value) {
+            const result = await client.signTypedData({ domain, types, value });
+            const signature = normalizeV5Signature(utils, result);
+            assertRecoveredAddress(ethersRuntime, 5, utils.verifyTypedData(domain, types, value, signature), this.address);
+            return signature;
+        }
+    })(provider);
+}
+function selectV5TransactionFields(transaction) {
+    const result = {};
+    for (const field of [
+        'type',
+        'chainId',
+        'nonce',
+        'to',
+        'value',
+        'gasLimit',
+        'gasPrice',
+        'data',
+        'accessList',
+        'maxFeePerGas',
+        'maxPriorityFeePerGas',
+    ]) {
+        if (transaction[field] !== undefined && transaction[field] !== null) {
+            result[field] = transaction[field];
+        }
+    }
+    return result;
+}
+function serializeV5TransactionForService(transaction) {
+    const result = {};
+    for (const [field, value] of Object.entries(transaction)) {
+        if (value !== null &&
+            typeof value === 'object' &&
+            typeof value.toString === 'function' &&
+            ['chainId', 'nonce', 'value', 'gasLimit', 'gasPrice', 'maxFeePerGas', 'maxPriorityFeePerGas'].includes(field)) {
+            result[field] = value.toString();
+        }
+        else {
+            result[field] = value;
+        }
+    }
+    return result;
+}
+function normalizeV6Signature(ethersRuntime, payload) {
+    const value = requireResponseString(payload, 'signature');
+    try {
+        return ethersRuntime.Signature.from(value).serialized;
+    }
+    catch {
+        throw new Error('托管服务返回了无效签名');
+    }
+}
+function normalizeV5Signature(utils, payload) {
+    const value = requireResponseString(payload, 'signature');
+    try {
+        return utils.joinSignature(utils.splitSignature(value));
+    }
+    catch {
+        throw new Error('托管服务返回了无效签名');
+    }
+}
+function assertTransactionFrom(ethersRuntime, major, from, expectedAddress) {
+    if (from === undefined || from === null) {
+        return;
+    }
+    if (typeof from !== 'string') {
+        throw new Error('交易 from 必须是已解析的钱包地址');
+    }
+    assertRecoveredAddress(ethersRuntime, major, from, expectedAddress);
+}
+function assertRecoveredAddress(ethersRuntime, major, actual, expected) {
+    let normalizedActual;
+    try {
+        normalizedActual = normalizeAddress(ethersRuntime, major, actual);
+    }
+    catch {
+        throw new Error('托管服务返回的签名地址无效');
+    }
+    if (normalizedActual !== expected) {
+        throw new Error('托管服务返回的签名地址与配置钱包地址不一致');
+    }
+}
+function normalizeAddress(ethersRuntime, major, address) {
+    return major === 6
+        ? ethersRuntime.getAddress(address)
+        : requireRuntimeObject(ethersRuntime, 'utils').getAddress(address);
+}
+function requireRuntimeConstructor(ethersRuntime, field) {
+    const value = ethersRuntime[field];
+    if (typeof value !== 'function') {
+        throw new Error(`当前 ethers runtime 缺少 ${field}`);
+    }
+    return value;
+}
+function requireRuntimeObject(ethersRuntime, field) {
+    const value = ethersRuntime[field];
+    if (typeof value !== 'object' || value === null) {
+        throw new Error(`当前 ethers runtime 缺少 ${field}`);
+    }
+    return value;
+}
+//# sourceMappingURL=signer.js.map

package/dist/custody/signer.js.map

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

package/dist/custody/version.d.ts

@@ -0,0 +1,4 @@
+export declare function detectEthersMajor(ethersRuntime: {
+    version?: unknown;
+}): 5 | 6;
+//# sourceMappingURL=version.d.ts.map

package/dist/custody/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/custody/version.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,aAAa,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,GAAG,CAAC,CAa7E"}

package/dist/custody/version.js

@@ -0,0 +1,13 @@
+export function detectEthersMajor(ethersRuntime) {
+    const { version } = ethersRuntime;
+    if (typeof version !== 'string') {
+        throw new Error('无法识别当前 ethers 版本');
+    }
+    const match = /^(?:ethers\/)?(\d+)(?:\.|$)/.exec(version.trim());
+    const major = match === null ? Number.NaN : Number.parseInt(match[1], 10);
+    if (major === 5 || major === 6) {
+        return major;
+    }
+    throw new Error(`不支持的 ethers 版本：${version}`);
+}
+//# sourceMappingURL=version.js.map

package/dist/custody/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/custody/version.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,aAAoC;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC;IAClC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC"}

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"}

package/dist-cjs/custody/service.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustodyServiceClient = void 0;
+exports.requireResponseString = requireResponseString;
+const node_crypto_1 = require("node:crypto");
+class CustodyServiceClient {
+    #credential;
+    #address;
+    #baseUrl;
+    #fetchImpl;
+    constructor(options) {
+        this.#credential = options.credential;
+        this.#address = options.address;
+        this.#baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.#fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        if (typeof this.#fetchImpl !== 'function') {
+            throw new Error('当前运行环境不支持 fetch，请显式传入 fetchImpl');
+        }
+    }
+    signTransaction(body) {
+        return this.#post('sign-transaction', body);
+    }
+    signMessage(body) {
+        return this.#post('sign-message', body);
+    }
+    signTypedData(body) {
+        return this.#post('sign-typed-data', body);
+    }
+    async #post(operation, body) {
+        const path = `/api/custody/wallets/${encodeURIComponent(this.#address)}/${operation}`;
+        let response;
+        try {
+            response = await this.#fetchImpl(`${this.#baseUrl}${path}`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bearer ${this.#credential}`,
+                    'idempotency-key': (0, node_crypto_1.randomUUID)(),
+                },
+                body: stringifyJson(body),
+            });
+        }
+        catch (error) {
+            throw new Error('无法连接托管签名服务', { cause: error });
+        }
+        const payload = await readJsonResponse(response);
+        if (!response.ok) {
+            const message = typeof payload.error === 'string'
+                ? payload.error
+                : `托管签名请求失败（HTTP ${response.status}）`;
+            throw new Error(message);
+        }
+        return payload;
+    }
+}
+exports.CustodyServiceClient = CustodyServiceClient;
+function requireResponseString(payload, field) {
+    const value = payload[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`托管服务响应缺少 ${field}`);
+    }
+    return value;
+}
+async function readJsonResponse(response) {
+    let payload;
+    try {
+        payload = await response.json();
+    }
+    catch {
+        throw new Error(`托管签名服务返回了无效 JSON（HTTP ${response.status}）`);
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+        throw new Error(`托管签名服务返回了无效响应（HTTP ${response.status}）`);
+    }
+    return payload;
+}
+function normalizeBaseUrl(baseUrl) {
+    if (baseUrl === undefined || baseUrl.trim() === '') {
+        return '';
+    }
+    const normalized = baseUrl.trim();
+    if (normalized.includes('?') || normalized.includes('#')) {
+        throw invalidBaseUrl();
+    }
+    let parsed;
+    try {
+        parsed = new URL(normalized);
+    }
+    catch {
+        throw invalidBaseUrl();
+    }
+    if ((parsed.protocol !== 'http:' && parsed.protocol !== 'https:') ||
+        parsed.username !== '' ||
+        parsed.password !== '') {
+        throw invalidBaseUrl();
+    }
+    return normalized.replace(/\/+$/, '');
+}
+function invalidBaseUrl() {
+    return new Error('CUSTODY_API_BASE_URL 必须是无账号、查询参数和片段的 HTTP(S) 地址');
+}
+function stringifyJson(value) {
+    return JSON.stringify(value, (_key, fieldValue) => typeof fieldValue === 'bigint' ? fieldValue.toString() : fieldValue);
+}
+//# sourceMappingURL=service.js.map