gate-evm-tools 1.0.22 → 1.0.24

package/dist/core/preparation/zksync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zksync.js","sourceRoot":"","sources":["../../../src/core/preparation/zksync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EACL,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC;AAElC,MAAM,sBAAsB,GAC1B,qEAAqE,CAAC;AAExE,MAAM,2BAA2B,GAAG,IAAI,SAAS,CAAC;IAChD,qFAAqF;CACtF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAC;IACtC,4IAA4I;CAC7I,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAC;IACtC,0EAA0E;CAC3E,CAAC,CAAC;AAmBH,MAAM,mBAAmB,GAAG,CAC1B,gBAAwB,EACxB,MAAyC,EACzC,KAAa,EACP,EAAE;IACR,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,UAAU,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,eAAe,IAAI,UAAU,KAAK,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,UAAU,iBAAiB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB,KAAK,SAAS;WAClC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,EACtF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,KAAa,EAAU,EAAE;IAC/D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iCAAiC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAuC,EAAQ,EAAE;IAC7E,IACE,MAAM,CAAC,OAAO,CAAC,mBAAmB,IAAI,GAAG,CAAC,KAAK,EAAE;WAC9C,MAAM,CAAC,OAAO,CAAC,gBAAgB,IAAI,GAAG,CAAC,KAAK,EAAE,EACjD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,KAAK,EAAE,KAQ9B,EAIE,EAAE;IACH,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzF,MAAM,gBAAgB,GAAG,eAAe,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACvF,MAAM,oBAAoB,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC;IAC7F,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,CAC3C,KAAK,CAAC,OAAO,EACb,oBAAoB,EACpB,KAAK,CAAC,IAAI,EACV,gBAAgB,CACjB,CAAC;IACF,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,YAAY,IAAI,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7E,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,IAAI,oBAAoB,CAAC,CAAC;QACnF,IAAI,YAAY,KAAK,oBAAoB,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,IAAI,yBAAyB,gBAAgB,IAAI;kBACxD,UAAU,YAAY,aAAa,oBAAoB,EAAE,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAA2B;QACzC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM;QACN,gBAAgB;QAChB,YAAY,EAAE,oBAAoB;QAClC,oBAAoB,EAAE,SAAS,CAAC,gBAAgB,CAAC;KAClD,CAAC;IACF,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAEhE,MAAM,aAAa,GAAG,2BAA2B,CAAC,kBAAkB,CAAC,SAAS,EAAE;QAC9E,KAAK,CAAC,IAAI;QACV,oBAAoB;QACpB,gBAAgB;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,UAAU;QACvC,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB;YAC/B,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,cAAc,CAAC;IACrB,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO;QACL,UAAU;QACV,eAAe;QACf,WAAW,EAAE;YACX,EAAE,EAAE,OAAO;YACX,OAAO;YACP,EAAE,EAAE,KAAK,CAAC,OAAO;YACjB,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,QAAQ,EAAE;gBACnD,KAAK,CAAC,IAAI;gBACV,aAAa;gBACb,IAAI;gBACJ,EAAE;gBACF,EAAE;aACH,CAAC;YACF,SAAS,EAAE,CAAC;YACZ,WAAW;SACZ;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EACxB,GAAqB,EACrB,OAAuC,EACvC,QAA0B,EACU,EAAE;IACtC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,GAAG;QACH,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,aAAa;KAC9B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvD,OAAO,wBAAwB,CAAC;QAC9B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC;QACpD,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,sBAAsB;SACvC;QACD,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QAClC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;KACjE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,OAAwB,EACxB,IAA2F,EACnF,EAAE,CAAC,CACX,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC3E,CAAC;AAEF,MAAM,kBAAkB,GAAG,KAAK,EAC9B,GAAqB,EACrB,OAA+C,EAC/C,QAA0B,EAC1B,YAAuC,EACH,EAAE;IACtC,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAC/C,GAAG,EACH,OAAO,EACP,QAAQ,EACR,YAAY,CAAC,UAAU,CACxB,CAAC;IACF,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;QAC3C,GAAG;QACH,IAAI,EAAE,gBAAgB;QACtB,QAAQ;QACR,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,kBAAkB;KACjC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAC/E,oBAAoB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC;QAClC,GAAG;QACH,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,CAAC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;QAC1D,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,SAAS;QACvB,MAAM,EAAE,OAAO,CAAC,kBAAkB;KACnC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC;SACjE,MAAM,CAAC,CAAC,WAAW,EAA0C,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;IAC9F,YAAY,CAAC,IAAI,CAAC;QAChB,EAAE,EAAE,eAAe;QACnB,OAAO,EAAE,eAAe;QACxB,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO;QAC5B,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE;YAC7D,cAAc,CAAC,UAAU,CAAC,OAAO;YACjC,eAAe,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC;SAC9D,CAAC;QACF,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,EAAE;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvD,OAAO,wBAAwB,CAAC;QAC9B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC;QACpD,UAAU;QACV,WAAW,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;QAC1D,YAAY;KACb,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,KAAK,EAC9B,GAAqB,EACrB,OAAqC,EACrC,QAA0B,EAC1B,YAAuC,EACH,EAAE;IACtC,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAC/C,GAAG,EACH,OAAO,EACP,QAAQ,EACR,YAAY,CAAC,UAAU,CACxB,CAAC;IACF,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;QAC3C,GAAG;QACH,IAAI,EAAE,gBAAgB;QACtB,QAAQ;QACR,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,kBAAkB;QAChC,MAAM,EAAE,OAAO,CAAC,2BAA2B;KAC5C,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,YAAY,CAAC,IAAI,CAAC;QAChB,EAAE,EAAE,eAAe;QACnB,OAAO,EAAE,eAAe;QACxB,EAAE,EAAE,OAAO,CAAC,KAAK;QACjB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE;YAC7D,cAAc,CAAC,UAAU,CAAC,OAAO;YACjC,eAAe,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC;SAC9D,CAAC;QACF,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,EAAE;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvD,OAAO,wBAAwB,CAAC;QAC9B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC;QACpD,UAAU;QACV,WAAW,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC;QACxC,YAAY;KACb,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,GAAqB,EACrB,OAAqC,EACrC,eAA0C,EAAE,EACR,EAAE;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,oBAAoB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC/C,OAAO,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC,CAAC"}

package/dist/custody/credential.d.ts

@@ -0,0 +1,16 @@
+export declare const PRIVATE_KEY_PATTERN: RegExp;
+export declare const PROJECT_SECRET_PATTERN: RegExp;
+export type PrivateKeyCredential = {
+    kind: 'private-key';
+    privateKey: string;
+};
+export type CustodyCredential = {
+    kind: 'custody';
+    secret: string;
+    address: string;
+};
+export type ParsedWalletCredential = PrivateKeyCredential | CustodyCredential;
+export declare function parseWalletCredential(value: string): ParsedWalletCredential;
+export declare function resolveWalletCredential(env?: NodeJS.ProcessEnv): ParsedWalletCredential | undefined;
+export declare function resolveHardhatAccounts(value?: string): string[];
+//# sourceMappingURL=credential.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credential.d.ts","sourceRoot":"","sources":["../../src/custody/credential.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAA6B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,QACkB,CAAC;AAMtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAE9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAmB3E;AAED,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,GAAG,SAAS,CAUpC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ/D"}

package/dist/custody/credential.js

@@ -0,0 +1,68 @@
+export const PRIVATE_KEY_PATTERN = /^(?:0x)?[0-9a-fA-F]{64}$/;
+export const 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:';
+export function parseWalletCredential(value) {
+    const credential = value.trim();
+    if (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 凭证');
+}
+export 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);
+}
+export 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 (!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/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/custody/hardhat-runtime.d.ts

@@ -0,0 +1,16 @@
+type HardhatRuntimeLike = {
+    ethers: Record<string, any> & {
+        version?: unknown;
+        provider: Record<string, any>;
+        getSigner: (...args: any[]) => Promise<any>;
+        getSigners: (...args: any[]) => Promise<any[]>;
+    };
+};
+export type InstallCustodyHardhatRuntimeOptions = {
+    env?: NodeJS.ProcessEnv;
+    logger?: (message: string) => void;
+    fetchImpl?: typeof fetch;
+};
+export declare function installCustodyHardhatRuntime(hre: HardhatRuntimeLike, options?: InstallCustodyHardhatRuntimeOptions): void;
+export {};
+//# sourceMappingURL=hardhat-runtime.d.ts.map

package/dist/custody/hardhat-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat-runtime.d.ts","sourceRoot":"","sources":["../../src/custody/hardhat-runtime.ts"],"names":[],"mappings":"AAOA,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;KAChD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAIF,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE,mCAAwC,GAChD,IAAI,CA4GN"}

package/dist/custody/hardhat-runtime.js

@@ -0,0 +1,101 @@
+import { resolveWalletCredential, } from './credential.js';
+import { createSigner } from './signer.js';
+import { detectEthersMajor } from './version.js';
+const installedEnvironments = new WeakSet();
+export 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 = 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 = createSigner({
+            ethers: ethersRuntime,
+            credential: credentialValue,
+            provider: ethersRuntime.provider,
+            baseUrl,
+            fetchImpl: options.fetchImpl,
+        });
+        cachedKey = cacheKey;
+        const major = 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 detectEthersMajor(ethersRuntime) === 6
+                ? Promise.resolve(signer)
+                : signer;
+        }
+        return originalProviderGetSigner.apply(ethersRuntime.provider, args);
+    };
+    installedEnvironments.add(hre);
+}
+function addressesMatch(ethersRuntime, first, second) {
+    try {
+        const major = 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/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/custody/hardhat.d.ts

@@ -0,0 +1,3 @@
+export { installCustodyHardhatRuntime, type InstallCustodyHardhatRuntimeOptions, } from './hardhat-runtime.js';
+export { parseWalletCredential, resolveHardhatAccounts, resolveWalletCredential, type ParsedWalletCredential, } from './credential.js';
+//# sourceMappingURL=hardhat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat.d.ts","sourceRoot":"","sources":["../../src/custody/hardhat.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,4BAA4B,EAC5B,KAAK,mCAAmC,GACzC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/custody/hardhat.js

@@ -0,0 +1,8 @@
+import { extendEnvironment } from 'hardhat/config.js';
+import { installCustodyHardhatRuntime } from './hardhat-runtime.js';
+extendEnvironment((hre) => {
+    installCustodyHardhatRuntime(hre);
+});
+export { installCustodyHardhatRuntime, } from './hardhat-runtime.js';
+export { parseWalletCredential, resolveHardhatAccounts, resolveWalletCredential, } from './credential.js';
+//# sourceMappingURL=hardhat.js.map

package/dist/custody/hardhat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat.js","sourceRoot":"","sources":["../../src/custody/hardhat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE,iBAAiB,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,4BAA4B,CAAC,GAAU,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEH,OAAO,EACL,4BAA4B,GAE7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,iBAAiB,CAAC"}

package/dist/custody/index.d.ts

@@ -0,0 +1,6 @@
+export { PRIVATE_KEY_PATTERN, PROJECT_SECRET_PATTERN, parseWalletCredential, resolveHardhatAccounts, resolveWalletCredential, type CustodyCredential, type ParsedWalletCredential, type PrivateKeyCredential, } from './credential.js';
+export { detectEthersMajor } from './version.js';
+export { createSigner, type CreateSignerOptions } from './signer.js';
+export { CustodyServiceClient, type CustodyServiceClientOptions, } from './service.js';
+export { installCustodyHardhatRuntime, type InstallCustodyHardhatRuntimeOptions, } from './hardhat-runtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/custody/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,KAAK,mCAAmC,GACzC,MAAM,sBAAsB,CAAC"}

package/dist/custody/index.js

@@ -0,0 +1,6 @@
+export { PRIVATE_KEY_PATTERN, PROJECT_SECRET_PATTERN, parseWalletCredential, resolveHardhatAccounts, resolveWalletCredential, } from './credential.js';
+export { detectEthersMajor } from './version.js';
+export { createSigner } from './signer.js';
+export { CustodyServiceClient, } from './service.js';
+export { installCustodyHardhatRuntime, } from './hardhat-runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/custody/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/custody/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,GAIxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,oBAAoB,GAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,GAE7B,MAAM,sBAAsB,CAAC"}

package/dist/custody/service.d.ts

@@ -0,0 +1,16 @@
+export type JsonObject = Record<string, unknown>;
+export type CustodyServiceClientOptions = {
+    credential: string;
+    address: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+};
+export declare class CustodyServiceClient {
+    #private;
+    constructor(options: CustodyServiceClientOptions);
+    signTransaction(body: JsonObject): Promise<JsonObject>;
+    signMessage(body: JsonObject): Promise<JsonObject>;
+    signTypedData(body: JsonObject): Promise<JsonObject>;
+}
+export declare function requireResponseString(payload: JsonObject, field: string): string;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/custody/service.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,qBAAa,oBAAoB;;gBAMnB,OAAO,EAAE,2BAA2B;IAWhD,eAAe,CAAC,IAAI,EAAE,UAAU;IAIhC,WAAW,CAAC,IAAI,EAAE,UAAU;IAI5B,aAAa,CAAC,IAAI,EAAE,UAAU;CA+B/B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhF"}

package/dist/custody/service.js

@@ -0,0 +1,100 @@
+import { randomUUID } from 'node:crypto';
+export 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': 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;
+    }
+}
+export 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

package/dist/custody/service.js.map

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

package/dist/custody/signer.d.ts

@@ -0,0 +1,13 @@
+type EthersRuntime = Record<string, any> & {
+    version?: unknown;
+};
+export type CreateSignerOptions = {
+    ethers: EthersRuntime;
+    credential: string;
+    provider?: any;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+};
+export declare function createSigner(options: CreateSignerOptions): any;
+export {};
+//# sourceMappingURL=signer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/custody/signer.ts"],"names":[],"mappings":"AASA,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CAyB9D"}