@zerodev/sdk 5.2.15 → 5.2.17

package/_types/clients/fallbackKernelAccountClient.d.ts

@@ -2,5 +2,5 @@ import type { EntryPoint } from "permissionless/types";
 import type { Chain, Transport } from "viem";
 import type { KernelSmartAccount } from "../accounts/index.js";
 import type { KernelAccountClient } from "./kernelAccountClient.js";
-export declare const createFallbackKernelAccountClient: <TEntryPoint extends EntryPoint, TTransport extends Transport, TChain extends Chain | undefined, TSmartAccount extends KernelSmartAccount<TEntryPoint> | undefined>(clients: KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount>[]) => KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount>;
+export declare const createFallbackKernelAccountClient: <TEntryPoint extends EntryPoint, TTransport extends Transport, TChain extends Chain | undefined, TSmartAccount extends KernelSmartAccount<TEntryPoint> | undefined>(clients: KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount>[], onError?: ((error: Error, clientUrl: string) => Promise<void>) | undefined) => KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount>;
 //# sourceMappingURL=fallbackKernelAccountClient.d.ts.map

package/_types/clients/fallbackKernelAccountClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallbackKernelAccountClient.d.ts","sourceRoot":"","sources":["../../clients/fallbackKernelAccountClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,eAAO,MAAM,iCAAiC,4TAwD7C,CAAA"}
+{"version":3,"file":"fallbackKernelAccountClient.d.ts","sourceRoot":"","sources":["../../clients/fallbackKernelAccountClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,eAAO,MAAM,iCAAiC,yQASxB,KAAK,aAAa,MAAM,KAAK,QAAQ,IAAI,CAAC,qFAmE/D,CAAA"}

package/_types/index.d.ts

@@ -5,7 +5,7 @@ export { zerodevPaymasterActions, type ZeroDevPaymasterClientActions, kernelAcco
 export { createZeroDevPaymasterClient, type ZeroDevPaymasterClient } from "./clients/paymasterClient.js";
 export { createKernelAccountClient, type KernelAccountClient } from "./clients/kernelAccountClient.js";
 export { createFallbackKernelAccountClient } from "./clients/fallbackKernelAccountClient.js";
-export { type KernelValidator, type ZeroDevPaymasterRpcSchema, type KernelPluginManager, type Action } from "./types/kernel.js";
+export { type KernelValidator, type KernelValidatorHook, type ZeroDevPaymasterRpcSchema, type KernelPluginManager, type Action } from "./types/kernel.js";
 export { KernelAccountAbi } from "./accounts/kernel/abi/KernelAccountAbi.js";
 export { KernelFactoryAbi } from "./accounts/kernel/abi/KernelFactoryAbi.js";
 export { KernelV3AccountAbi, KernelV3ExecuteAbi, KernelV3InitAbi } from "./accounts/kernel/abi/kernel_v_3_0_0/KernelAccountAbi.js";

package/_types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,oBAAoB,EACpB,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACtC,MAAM,6CAA6C,CAAA;AACpD,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,EACH,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,0BAA0B,EAC1B,KAAK,0BAA0B,EAClC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACH,4BAA4B,EAC5B,KAAK,sBAAsB,EAC9B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACH,yBAAyB,EACzB,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAA;AAC5F,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAClB,MAAM,0DAA0D,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAA;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAA;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EACH,sBAAsB,EACtB,2BAA2B,EAC9B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAA;AACtG,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,oBAAoB,EACpB,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACtC,MAAM,6CAA6C,CAAA;AACpD,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,EACH,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,0BAA0B,EAC1B,KAAK,0BAA0B,EAClC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACH,4BAA4B,EAC5B,KAAK,sBAAsB,EAC9B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACH,yBAAyB,EACzB,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAA;AAC5F,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAClB,MAAM,0DAA0D,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAA;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAA;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EACH,sBAAsB,EACtB,2BAA2B,EAC9B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAA;AACtG,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAA"}

package/_types/types/kernel.d.ts

@@ -101,6 +101,10 @@ export type KernelValidator<entryPoint extends EntryPoint, Name extends string =
     isEnabled(accountAddress: Address, selector: Hex): Promise<boolean>;
     getIdentifier: () => Hex;
 };
+export type KernelValidatorHook = {
+    getEnableData(accountAddress?: Address): Promise<Hex>;
+    getIdentifier: () => Hex;
+};
 export type ValidatorInitData = {
     validatorAddress: Address;
     enableData: Hex;
@@ -108,6 +112,7 @@ export type ValidatorInitData = {
 };
 export type KernelPluginManager<entryPoint extends EntryPoint> = KernelValidator<entryPoint> & {
     sudoValidator?: KernelValidator<entryPoint>;
+    hook?: KernelValidatorHook;
     getPluginEnableSignature(accountAddress: Address): Promise<Hex>;
     getValidatorInitData(): Promise<ValidatorInitData>;
     getAction(): Action;
@@ -128,6 +133,7 @@ export type PluginInstallData<entryPoint extends EntryPoint> = entryPoint extend
 export type KernelPluginManagerParams<entryPoint extends EntryPoint> = {
     sudo?: KernelValidator<entryPoint>;
     regular?: KernelValidator<entryPoint>;
+    hook?: KernelValidatorHook;
     pluginEnableSignature?: Hex;
     validatorInitData?: ValidatorInitData;
     action?: Action;

package/_types/types/kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../types/kernel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../types/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,2BAA2B,EAC3B,UAAU,EACb,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EACR,aAAa,EACb,4BAA4B,EAC/B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,MAAM,MAAM,yBAAyB,CAAC,UAAU,SAAS,UAAU,IAAI;IACnE;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR;gBACI,OAAO,EAAE,MAAM,CAAA;gBACf,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,SAAS,MAAM,GACjD,SAAS,CACL,4BAA4B,CAAC,MAAM,CAAC,EAClC,cAAc,GACd,oBAAoB,GACpB,sBAAsB,CAC3B,GACD,SAAS,CACL,4BAA4B,CAAC,MAAM,CAAC,EAClC,cAAc,GACd,oBAAoB,GACpB,sBAAsB,GACtB,+BAA+B,GAC/B,yBAAyB,CAC9B,CAAA;gBACP,iBAAiB,EAAE,OAAO,CAAA;gBAC1B,YAAY,CAAC,EAAE;oBACX,YAAY,EAAE,GAAG,CAAA;iBACpB,CAAA;gBACD,iBAAiB,CAAC,EAAE,OAAO,CAAA;gBAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAA;gBAC7B,aAAa,CAAC,EAAE,OAAO,CAAA;aAC1B;SACJ,CAAA;QACD,UAAU,EAAE,oBAAoB,CAAC,UAAU,CAAC,SAAS,MAAM,GACrD;YACI,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;YACjB,YAAY,CAAC,EAAE,GAAG,CAAA;YAClB,oBAAoB,CAAC,EAAE,GAAG,CAAA;YAC1B,SAAS,CAAC,EAAE,KAAK,CAAA;YACjB,6BAA6B,CAAC,EAAE,KAAK,CAAA;YACrC,uBAAuB,CAAC,EAAE,KAAK,CAAA;YAC/B,aAAa,CAAC,EAAE,KAAK,CAAA;SACxB,GACD;YACI,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;YACjB,SAAS,EAAE,OAAO,CAAA;YAClB,6BAA6B,EAAE,GAAG,CAAA;YAClC,uBAAuB,EAAE,GAAG,CAAA;YAC5B,aAAa,EAAE,GAAG,CAAA;YAClB,YAAY,CAAC,EAAE,GAAG,CAAA;YAClB,oBAAoB,CAAC,EAAE,GAAG,CAAA;YAC1B,gBAAgB,CAAC,EAAE,KAAK,CAAA;SAC3B,CAAA;KACV;IACD;QACI,MAAM,EAAE,gBAAgB,CAAA;QACxB,UAAU,EAAE;YACR;gBACI,OAAO,EAAE,MAAM,CAAA;gBACf,iBAAiB,EAAE,OAAO,CAAA;aAC7B;SACJ,CAAA;QACD,UAAU,EAAE,OAAO,EAAE,CAAA;KACxB;IACD;QACI,MAAM,EAAE,6BAA6B,CAAA;QACrC,UAAU,EAAE;YACR;gBACI,OAAO,EAAE,MAAM,CAAA;gBACf,MAAM,EAAE,4BAA4B,CAAC,MAAM,CAAC,CAAA;gBAC5C,iBAAiB,EAAE,OAAO,CAAA;gBAC1B,YAAY,EAAE,OAAO,CAAA;aACxB;SACJ,CAAA;QACD,UAAU,EAAE;YACR,eAAe,EAAE,MAAM,CAAA;YACvB,aAAa,EAAE,MAAM,CAAA;SACxB,CAAA;KACJ;CACJ,CAAA;AAED,MAAM,MAAM,2CAA2C,GAAG;IACtD,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,QAAQ,EAAE;QACN,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IACxC;QACI,MAAM,EAAE,6BAA6B,CAAA;QACrC,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,2CAA2C,CAAA;KAC1D;CACJ,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAC/B,MAAM,OAAO,cAAc,EAC3B,YAAY,GAAG,WAAW,CAC7B,CAAA;AAED,MAAM,MAAM,eAAe,CACvB,UAAU,SAAS,UAAU,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM,IAC5B,YAAY,CAAC,IAAI,CAAC,GAAG;IACrB,aAAa,EAAE,aAAa,CAAA;IAC5B,WAAW,EAAE,CACT,cAAc,CAAC,EAAE,OAAO,EACxB,cAAc,CAAC,EAAE,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAA;IACpB,iBAAiB,CACb,aAAa,EAAE,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,EAC9D,qBAAqB,CAAC,EAAE,GAAG,GAC5B,OAAO,CAAC,GAAG,CAAC,CAAA;IACf,iBAAiB,EAAE,CACf,aAAa,EAAE,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,EAC9D,qBAAqB,CAAC,EAAE,GAAG,KAC1B,OAAO,CAAC,GAAG,CAAC,CAAA;IACjB,aAAa,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACrD,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnE,aAAa,EAAE,MAAM,GAAG,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,aAAa,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACrD,aAAa,EAAE,MAAM,GAAG,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,GAAG,CAAA;IACf,UAAU,EAAE,GAAG,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,UAAU,SAAS,UAAU,IACzD,eAAe,CAAC,UAAU,CAAC,GAAG;IAC1B,aAAa,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;IAC3C,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,wBAAwB,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/D,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClD,SAAS,IAAI,MAAM,CAAA;IACnB,eAAe,IAAI,kBAAkB,CAAA;IACrC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,GAAG,CAAA;IACpC,2BAA2B,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACtE,yBAAyB,EAAE,CACvB,cAAc,EAAE,OAAO,KACtB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1D,oCAAoC,EAAE,CAClC,aAAa,EAAE,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,KAC7D,OAAO,CAAC,GAAG,CAAC,CAAA;CACpB,CAAA;AAEL,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,UAAU,IACvD,UAAU,SAAS,2BAA2B,GACxC;IACI,QAAQ,EAAE,GAAG,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,GAAG,CAAA;CAClB,GAED,KAAK,CAAA;AAEf,MAAM,MAAM,yBAAyB,CAAC,UAAU,SAAS,UAAU,IAAI;IACnE,IAAI,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,qBAAqB,CAAC,EAAE,GAAG,CAAA;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAE/B,MAAM,MAAM,IAAI,GAAG;IACf,OAAO,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAA;IACb,IAAI,CAAC,EAAE,IAAI,CAAA;CACd,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,oBAAY,aAAa;IACrB,IAAI,eAAe;IACnB,MAAM,eAAe;IACrB,MAAM,eAAe;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAA;AAE9C,MAAM,MAAM,wBAAwB,GAC9B;IACI,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,GAAG,CAAA;IACT,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;CACjC,GACD;IACI,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,GAAG,CAAA;IACT,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;CACjC,EAAE,CAAA;AAET,MAAM,MAAM,SAAS,GAAG;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,GAAG,CAAA;CAChB,CAAA"}

package/accounts/kernel/createKernelAccount.ts

@@ -129,10 +129,12 @@ export const KERNEL_ADDRESSES: {
 
 const getKernelInitData = async <entryPoint extends EntryPoint>({
     entryPoint: entryPointAddress,
-    kernelPluginManager
+    kernelPluginManager,
+    initHook
 }: {
     entryPoint: entryPoint
     kernelPluginManager: KernelPluginManager<entryPoint>
+    initHook: boolean
 }) => {
     const entryPointVersion = getEntryPointVersion(entryPointAddress)
     const { enableData, identifier, validatorAddress } =
@@ -149,7 +151,16 @@ const getKernelInitData = async <entryPoint extends EntryPoint>({
     return encodeFunctionData({
         abi: KernelV3InitAbi,
         functionName: "initialize",
-        args: [identifier, zeroAddress, enableData, "0x"]
+        args: [
+            identifier,
+            initHook && kernelPluginManager.hook
+                ? kernelPluginManager.hook?.getIdentifier()
+                : zeroAddress,
+            enableData,
+            initHook && kernelPluginManager.hook
+                ? await kernelPluginManager.hook?.getEnableData()
+                : "0x"
+        ]
     })
 }
 
@@ -166,7 +177,8 @@ const getAccountInitCode = async <entryPoint extends EntryPoint>({
     accountLogicAddress,
     factoryStakerAddress,
     entryPoint: entryPointAddress,
-    kernelPluginManager
+    kernelPluginManager,
+    initHook
 }: {
     index: bigint
     factoryAddress: Address
@@ -174,11 +186,13 @@ const getAccountInitCode = async <entryPoint extends EntryPoint>({
     factoryStakerAddress: Address
     entryPoint: entryPoint
     kernelPluginManager: KernelPluginManager<entryPoint>
+    initHook: boolean
 }): Promise<Hex> => {
     // Build the account initialization data
     const initialisationData = await getKernelInitData<entryPoint>({
         entryPoint: entryPointAddress,
-        kernelPluginManager
+        kernelPluginManager,
+        initHook
     })
     const entryPointVersion = getEntryPointVersion(entryPointAddress)
 
@@ -291,10 +305,22 @@ export async function createKernelAccount<
         : await toKernelPluginManager<entryPoint>(client, {
               sudo: plugins.sudo,
               regular: plugins.regular,
+              hook: plugins.hook,
               action: plugins.action,
               pluginEnableSignature: plugins.pluginEnableSignature,
               entryPoint: entryPointAddress
           })
+
+    // initHook flag is activated only if both the hook and sudo validator are given
+    // if the hook is given with regular plugins, then consider it as a hook for regular plugins
+    const initHook = Boolean(
+        isKernelPluginManager<entryPoint>(plugins)
+            ? plugins.hook &&
+                  plugins.getIdentifier() ===
+                      plugins.sudoValidator?.getIdentifier()
+            : plugins.hook && !plugins.regular
+    )
+
     // Helper to generate the init code for the smart account
     const generateInitCode = async () => {
         if (!accountLogicAddress || !factoryAddress)
@@ -305,7 +331,8 @@ export async function createKernelAccount<
             accountLogicAddress,
             factoryStakerAddress,
             entryPoint: entryPointAddress,
-            kernelPluginManager
+            kernelPluginManager,
+            initHook
         })
     }
 
@@ -358,6 +385,10 @@ export async function createKernelAccount<
                 if (entryPointVersion === "v0.6") {
                     return encodeCallDataEpV06(tx)
                 }
+
+                if (plugins.hook) {
+                    return encodeCallDataEpV07(tx, true)
+                }
                 return encodeCallDataEpV07(tx)
             },
             async getFactory() {

package/accounts/kernel/utils/account/ep0_7/encodeCallData.ts

@@ -1,4 +1,4 @@
-import type { EntryPoint } from "permissionless/types/entrypoint.js"
+import type { EntryPoint } from "permissionless/types"
 import { EXEC_TYPE } from "../../../../../constants.js"
 import type { KernelSmartAccount } from "../../../createKernelAccount.js"
 import { encodeExecuteBatchCall } from "../../ep0_7/encodeExecuteBatchCall.js"
@@ -8,23 +8,32 @@ import { encodeExecuteSingleCall } from "../../ep0_7/encodeExecuteSingleCall.js"
 export const encodeCallData = async <
     entryPoint extends EntryPoint = EntryPoint
 >(
-    tx: Parameters<KernelSmartAccount<entryPoint>["encodeCallData"]>[0]
+    tx: Parameters<KernelSmartAccount<entryPoint>["encodeCallData"]>[0],
+    includeHooks?: boolean
 ) => {
     if (Array.isArray(tx)) {
         if (tx.some((t) => t.callType === "delegatecall")) {
             throw new Error("Cannot batch delegatecall")
         }
         // Encode a batched call
-        return encodeExecuteBatchCall(tx, {
-            execType: EXEC_TYPE.DEFAULT
-        })
+        return encodeExecuteBatchCall(
+            tx,
+            {
+                execType: EXEC_TYPE.DEFAULT
+            },
+            includeHooks
+        )
     }
 
     // Default to `call`
     if (!tx.callType || tx.callType === "call") {
-        return encodeExecuteSingleCall(tx, {
-            execType: EXEC_TYPE.DEFAULT
-        })
+        return encodeExecuteSingleCall(
+            tx,
+            {
+                execType: EXEC_TYPE.DEFAULT
+            },
+            includeHooks
+        )
     }
 
     if (tx.callType === "delegatecall") {
@@ -32,7 +41,8 @@ export const encodeCallData = async <
             { to: tx.to, data: tx.data },
             {
                 execType: EXEC_TYPE.DEFAULT
-            }
+            },
+            includeHooks
         )
     }
 

package/accounts/kernel/utils/ep0_7/encodeExecuteBatchCall.ts

@@ -8,7 +8,8 @@ import {
 
 export const encodeExecuteBatchCall = (
     args: CallArgs[],
-    options: Omit<EncodeExecuteOptions, "callType">
+    options: Omit<EncodeExecuteOptions, "callType">,
+    includeHooks?: boolean
 ) => {
     const calldata = encodeAbiParameters(
         [
@@ -46,6 +47,7 @@ export const encodeExecuteBatchCall = (
         {
             callType: CALL_TYPE.BATCH,
             execType: options.execType
-        }
+        },
+        includeHooks
     )
 }

package/accounts/kernel/utils/ep0_7/encodeExecuteCall.ts

@@ -1,4 +1,11 @@
-import { type Hex, concatHex, encodeFunctionData, toHex } from "viem"
+import {
+    type Hex,
+    concatHex,
+    encodeFunctionData,
+    getAbiItem,
+    toFunctionSelector,
+    toHex
+} from "viem"
 import { CALL_TYPE } from "../../../../constants.js"
 import { getExecMode } from "../../../../utils.js"
 import { KernelV3ExecuteAbi } from "../../abi/kernel_v_3_0_0/KernelAccountAbi.js"
@@ -16,7 +23,8 @@ type EncodeExecuteCallArgs<TOptions> =
 
 export const encodeExecuteCall = <TOptions extends EncodeExecuteOptions>(
     args: EncodeExecuteCallArgs<TOptions>,
-    options: TOptions
+    options: TOptions,
+    includeHooks = false
 ) => {
     let calldata: Hex
     if ("calldata" in args) {
@@ -30,6 +38,26 @@ export const encodeExecuteCall = <TOptions extends EncodeExecuteOptions>(
             args.data
         ])
     }
+
+    const executeUserOpSig = toFunctionSelector(
+        getAbiItem({ abi: KernelV3ExecuteAbi, name: "executeUserOp" })
+    )
+
+    // The calldata using hook plugin should be as follows:
+    // [0:4] - `executeUserOp` function signature
+    // [4:8] - `execute` function signature
+    // [8:] - `execute` function arguments
+    if (includeHooks) {
+        return concatHex([
+            executeUserOpSig,
+            encodeFunctionData({
+                abi: KernelV3ExecuteAbi,
+                functionName: "execute",
+                args: [getExecMode(options), calldata]
+            })
+        ])
+    }
+
     return encodeFunctionData({
         abi: KernelV3ExecuteAbi,
         functionName: "execute",

package/accounts/kernel/utils/ep0_7/encodeExecuteDelegateCall.ts

@@ -7,10 +7,15 @@ import {
 
 export const encodeExecuteDelegateCall = (
     args: DelegateCallArgs,
-    options: Omit<EncodeExecuteOptions, "callType">
+    options: Omit<EncodeExecuteOptions, "callType">,
+    includeHooks?: boolean
 ) => {
-    return encodeExecuteCall(args, {
-        callType: CALL_TYPE.DELEGATE_CALL,
-        execType: options.execType
-    })
+    return encodeExecuteCall(
+        args,
+        {
+            callType: CALL_TYPE.DELEGATE_CALL,
+            execType: options.execType
+        },
+        includeHooks
+    )
 }

package/accounts/kernel/utils/ep0_7/encodeExecuteSingleCall.ts

@@ -7,10 +7,15 @@ import {
 
 export const encodeExecuteSingleCall = (
     args: CallArgs,
-    options: Omit<EncodeExecuteOptions, "callType">
+    options: Omit<EncodeExecuteOptions, "callType">,
+    includeHooks?: boolean
 ) => {
-    return encodeExecuteCall(args, {
-        callType: CALL_TYPE.SINGLE,
-        execType: options.execType
-    })
+    return encodeExecuteCall(
+        args,
+        {
+            callType: CALL_TYPE.SINGLE,
+            execType: options.execType
+        },
+        includeHooks
+    )
 }

package/accounts/kernel/utils/plugins/ep0_7/getEncodedPluginsData.ts

@@ -6,28 +6,33 @@ import {
     zeroAddress
 } from "viem"
 import { CALL_TYPE } from "../../../../../constants.js"
-import type { Action } from "../../../../../types/kernel.js"
+import type {
+    Action,
+    KernelValidatorHook
+} from "../../../../../types/kernel.js"
 
 export const getEncodedPluginsData = async ({
     enableSignature,
     userOpSignature,
     action,
-    enableData
+    enableData,
+    hook
 }: {
     enableSignature: Hex
     userOpSignature: Hex
     action: Action
     enableData: Hex
+    hook?: KernelValidatorHook
 }) => {
     return concat([
-        zeroAddress, // hook address 20 bytes
+        hook?.getIdentifier() ?? zeroAddress, // hook address 20 bytes
         encodeAbiParameters(
             parseAbiParameters(
                 "bytes validatorData, bytes hookData, bytes selectorData, bytes enableSig, bytes userOpSig"
             ),
             [
                 enableData,
-                "0x",
+                (await hook?.getEnableData()) ?? "0x",
                 concat([
                     action.selector,
                     action.address,

package/accounts/kernel/utils/plugins/ep0_7/getPluginsEnableTypedData.ts

@@ -12,6 +12,7 @@ import {
     zeroAddress
 } from "viem"
 import { CALL_TYPE, VALIDATOR_TYPE } from "../../../../../constants.js"
+import type { KernelValidatorHook } from "../../../../../types/kernel.js"
 import type { Kernel2_0_plugins } from "../ep0_6/getPluginsEnableTypedData.js"
 
 export const getPluginsEnableTypedData = async <
@@ -21,6 +22,7 @@ export const getPluginsEnableTypedData = async <
     chainId,
     kernelVersion,
     action,
+    hook,
     validator,
     validatorNonce
 }: {
@@ -28,6 +30,7 @@ export const getPluginsEnableTypedData = async <
     chainId: number
     kernelVersion: string
     validatorNonce: number
+    hook?: KernelValidatorHook
 } & Kernel2_0_plugins<entryPoint>): Promise<
     Parameters<CustomSource["signTypedData"]>[0]
 > => {
@@ -54,9 +57,9 @@ export const getPluginsEnableTypedData = async <
                 pad(validator.getIdentifier(), { size: 20, dir: "right" })
             ]),
             nonce: validatorNonce,
-            hook: zeroAddress,
+            hook: hook?.getIdentifier() ?? zeroAddress,
             validatorData: await validator.getEnableData(accountAddress),
-            hookData: "0x",
+            hookData: (await hook?.getEnableData(accountAddress)) ?? "0x",
             selectorData: concat([
                 action.selector,
                 action.address,

package/accounts/utils/toKernelPluginManager.ts

@@ -51,6 +51,7 @@ export async function toKernelPluginManager<
     {
         sudo,
         regular,
+        hook,
         pluginEnableSignature,
         validatorInitData,
         action,
@@ -130,7 +131,8 @@ export async function toKernelPluginManager<
                 enableSignature,
                 userOpSignature,
                 action,
-                enableData: await regular.getEnableData(accountAddress)
+                enableData: await regular.getEnableData(accountAddress),
+                hook
             })
         } else if (sudo) {
             return userOpSignature
@@ -190,6 +192,7 @@ export async function toKernelPluginManager<
             chainId,
             kernelVersion: version,
             action,
+            hook,
             validator: regular,
             validatorNonce
         })
@@ -238,6 +241,7 @@ export async function toKernelPluginManager<
     return {
         sudoValidator: sudo,
         ...activeValidator,
+        hook,
         getIdentifier,
         encodeModuleInstallCallData: async (accountAddress: Address) => {
             if (!action) {

package/clients/fallbackKernelAccountClient.ts

@@ -11,50 +11,70 @@ export const createFallbackKernelAccountClient = <
 >(
     clients: Array<
         KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount>
-    >
+    >,
+    onError?: (error: Error, clientUrl: string) => Promise<void>
 ): KernelAccountClient<TEntryPoint, TTransport, TChain, TSmartAccount> => {
+    // Function to create a fallback method for a given property.
+    // This method will try each client in sequence until one succeeds or all fail.
+    function createFallbackMethod(prop: PropertyKey) {
+        // biome-ignore lint/suspicious/noExplicitAny: expected any
+        return async (...args: any[]) => {
+            for (let i = 0; i < clients.length; i++) {
+                try {
+                    const method = Reflect.get(clients[i], prop)
+                    if (typeof method === "function") {
+                        return await method(...args)
+                    }
+                } catch (error) {
+                    console.error(
+                        `Action ${String(prop)} failed with client ${
+                            clients[i].transport.url
+                        }, trying next if available.`
+                    )
+                    // Call the error handler if provided.
+                    if (onError !== undefined) {
+                        await onError(error as Error, clients[i].transport.url)
+                    }
+                    if (i === clients.length - 1) {
+                        throw error
+                    }
+                }
+            }
+        }
+    }
+
     const proxyClient = new Proxy(clients[0], {
         get(_target, prop, receiver) {
-            for (const client of clients) {
-                const value = Reflect.get(client, prop, receiver)
-                if (value !== undefined) {
-                    // If the property is a function, wrap it to add fallback logic
-                    if (typeof value === "function") {
-                        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
-                        return async (...args: any[]) => {
-                            for (let i = 0; i < clients.length; i++) {
-                                try {
-                                    const method = Reflect.get(
-                                        clients[i],
-                                        prop,
-                                        receiver
-                                    )
-                                    if (typeof method === "function") {
-                                        // Attempt to call the function on the current client
-                                        return await method(...args)
-                                    }
-                                } catch (error) {
-                                    console.error(
-                                        `Action ${String(
-                                            prop
-                                        )} failed with client ${
-                                            client.transport.url
-                                        }, trying next if available.`,
-                                        error
-                                    )
-                                    if (i === clients.length - 1) {
-                                        throw error
-                                    }
-                                }
+            if (prop === "extend") {
+                // biome-ignore lint/suspicious/noExplicitAny: expected any
+                return (fn: any) => {
+                    const modifications = fn(proxyClient)
+                    for (const [key, modification] of Object.entries(
+                        modifications
+                    )) {
+                        if (typeof modification === "function") {
+                            // biome-ignore lint/suspicious/noExplicitAny: expected any
+                            ;(proxyClient as any)[key] = async (
+                                // biome-ignore lint/suspicious/noExplicitAny: expected any
+                                ...args: any[]
+                            ) => {
+                                return modification(...args)
                             }
+                        } else {
+                            console.error(
+                                `Expected a function for modification of ${key}, but received type ${typeof modification}`
+                            )
                         }
                     }
-                    // For non-function properties, return the first defined value found
-                    return value
+                    return proxyClient
                 }
             }
-            // If no clients have a defined value for the property, return undefined
-            return undefined
+
+            const value = Reflect.get(_target, prop, receiver)
+            if (typeof value === "function") {
+                return createFallbackMethod(prop)
+            }
+            return value
         }
     })
 

package/index.ts

@@ -30,6 +30,7 @@ export {
 export { createFallbackKernelAccountClient } from "./clients/fallbackKernelAccountClient.js"
 export {
     type KernelValidator,
+    type KernelValidatorHook,
     type ZeroDevPaymasterRpcSchema,
     type KernelPluginManager,
     type Action

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zerodev/sdk",
-    "version": "5.2.15",
+    "version": "5.2.17",
     "author": "ZeroDev",
     "main": "./_cjs/index.js",
     "module": "./_esm/index.js",

package/types/kernel.ts

@@ -143,6 +143,11 @@ export type KernelValidator<
     getIdentifier: () => Hex
 }
 
+export type KernelValidatorHook = {
+    getEnableData(accountAddress?: Address): Promise<Hex>
+    getIdentifier: () => Hex
+}
+
 export type ValidatorInitData = {
     validatorAddress: Address
     enableData: Hex
@@ -152,6 +157,7 @@ export type ValidatorInitData = {
 export type KernelPluginManager<entryPoint extends EntryPoint> =
     KernelValidator<entryPoint> & {
         sudoValidator?: KernelValidator<entryPoint>
+        hook?: KernelValidatorHook
         getPluginEnableSignature(accountAddress: Address): Promise<Hex>
         getValidatorInitData(): Promise<ValidatorInitData>
         getAction(): Action
@@ -182,6 +188,7 @@ export type PluginInstallData<entryPoint extends EntryPoint> =
 export type KernelPluginManagerParams<entryPoint extends EntryPoint> = {
     sudo?: KernelValidator<entryPoint>
     regular?: KernelValidator<entryPoint>
+    hook?: KernelValidatorHook
     pluginEnableSignature?: Hex
     validatorInitData?: ValidatorInitData
     action?: Action