permissionless 0.0.14 → 0.0.15

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # permissionless
 
+## 0.0.15
+
+### Patch Changes
+
+- 2857b89: Added getRequiredPrefund utility function
+- 7c54173: Added support for pm_validateSponsorshipPolicies for pimlicoPaymasterClient
+
 ## 0.0.14
 
 ### Patch Changes

package/_cjs/accounts/signerToSafeSmartAccount.js

@@ -22,7 +22,7 @@ const EIP712_SAFE_OPERATION_TYPE = {
 const SAFE_VERSION_TO_ADDRESSES_MAP = {
     "1.4.1": {
         ADD_MODULES_LIB_ADDRESS: "0x8EcD4ec46D4D2a6B64fE960B3D64e8B94B2234eb",
-        SAFE_4337_MODULE_ADDRESS: "0x39E54Bb2b3Aa444b4B39DEe15De3b7809c36Fc38",
+        SAFE_4337_MODULE_ADDRESS: "0xa581c4A4DB7175302464fF3C06380BC3270b4037",
         SAFE_PROXY_FACTORY_ADDRESS: "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
         SAFE_SINGLETON_ADDRESS: "0x41675C099F32341bf84BFc5382aF534df5C7461a",
         MULTI_SEND_ADDRESS: "0x38869bf66a61cF6bDB996A6aE40D5853Fd43B526",

package/_cjs/actions/pimlico/validateSponsorshipPolicies.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSponsorshipPolicies = void 0;
+const deepHexlify_js_1 = require("../../utils/deepHexlify.js");
+const validateSponsorshipPolicies = async (client, args) => {
+    return await client.request({
+        method: "pm_validateSponsorshipPolicies",
+        params: [
+            (0, deepHexlify_js_1.deepHexlify)(args.userOperation),
+            args.entryPoint,
+            args.sponsorshipPolicyIds
+        ]
+    });
+};
+exports.validateSponsorshipPolicies = validateSponsorshipPolicies;
+//# sourceMappingURL=validateSponsorshipPolicies.js.map

package/_cjs/actions/pimlico/validateSponsorshipPolicies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSponsorshipPolicies.js","sourceRoot":"","sources":["../../../actions/pimlico/validateSponsorshipPolicies.ts"],"names":[],"mappings":";;;AAMA,+DAAwD;AAqDjD,MAAM,2BAA2B,GAAG,KAAK,EAK5C,MAAuE,EACvE,IAA2C,EACG,EAAE;IAChD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE,gCAAgC;QACxC,MAAM,EAAE;YACJ,IAAA,4BAAW,EAAC,IAAI,CAAC,aAAa,CAAiC;YAC/D,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,oBAAoB;SAC5B;KACJ,CAAC,CAAA;AACN,CAAC,CAAA;AAhBY,QAAA,2BAA2B,+BAgBvC"}

package/_cjs/actions/pimlico.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pimlicoPaymasterActions = exports.pimlicoBundlerActions = exports.sponsorUserOperation = exports.getUserOperationStatus = exports.getUserOperationGasPrice = void 0;
+exports.validateSponsorshipPolicies = exports.pimlicoPaymasterActions = exports.pimlicoBundlerActions = exports.sponsorUserOperation = exports.getUserOperationStatus = exports.getUserOperationGasPrice = void 0;
 const getUserOperationGasPrice_js_1 = require("./pimlico/getUserOperationGasPrice.js");
 Object.defineProperty(exports, "getUserOperationGasPrice", { enumerable: true, get: function () { return getUserOperationGasPrice_js_1.getUserOperationGasPrice; } });
 const getUserOperationStatus_js_1 = require("./pimlico/getUserOperationStatus.js");
@@ -10,4 +10,6 @@ Object.defineProperty(exports, "sponsorUserOperation", { enumerable: true, get:
 const pimlico_js_1 = require("../clients/decorators/pimlico.js");
 Object.defineProperty(exports, "pimlicoBundlerActions", { enumerable: true, get: function () { return pimlico_js_1.pimlicoBundlerActions; } });
 Object.defineProperty(exports, "pimlicoPaymasterActions", { enumerable: true, get: function () { return pimlico_js_1.pimlicoPaymasterActions; } });
+const validateSponsorshipPolicies_js_1 = require("./pimlico/validateSponsorshipPolicies.js");
+Object.defineProperty(exports, "validateSponsorshipPolicies", { enumerable: true, get: function () { return validateSponsorshipPolicies_js_1.validateSponsorshipPolicies; } });
 //# sourceMappingURL=pimlico.js.map

package/_cjs/actions/pimlico.js.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":";;;AAAA,uFAG8C;AAgC1C,yGAjCA,sDAAwB,OAiCA;AA/B5B,mFAI4C;AA4BxC,uGA7BA,kDAAsB,OA6BA;AA3B1B,+EAI0C;AAwBtC,qGAzBA,8CAAoB,OAyBA;AAlBxB,iEAGyC;AAgBrC,sGAlBA,kCAAqB,OAkBA;AACrB,wGAlBA,oCAAuB,OAkBA"}
+{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":";;;AAAA,uFAG8C;AAwC1C,yGAzCA,sDAAwB,OAyCA;AAvC5B,mFAI4C;AAoCxC,uGArCA,kDAAsB,OAqCA;AAnC1B,+EAI0C;AAgCtC,qGAjCA,8CAAoB,OAiCA;AA1BxB,iEAGyC;AAwBrC,sGA1BA,kCAAqB,OA0BA;AACrB,wGA1BA,oCAAuB,OA0BA;AAvB3B,6FAIiD;AAoB7C,4GArBA,4DAA2B,OAqBA"}

package/_cjs/clients/decorators/pimlico.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pimlicoPaymasterActions = exports.pimlicoBundlerActions = void 0;
+const pimlico_js_1 = require("../../actions/pimlico.js");
 const getUserOperationGasPrice_js_1 = require("../../actions/pimlico/getUserOperationGasPrice.js");
 const getUserOperationStatus_js_1 = require("../../actions/pimlico/getUserOperationStatus.js");
 const sponsorUserOperation_js_1 = require("../../actions/pimlico/sponsorUserOperation.js");
@@ -10,7 +11,8 @@ const pimlicoBundlerActions = (client) => ({
 });
 exports.pimlicoBundlerActions = pimlicoBundlerActions;
 const pimlicoPaymasterActions = (client) => ({
-    sponsorUserOperation: async (args) => (0, sponsorUserOperation_js_1.sponsorUserOperation)(client, args)
+    sponsorUserOperation: async (args) => (0, sponsorUserOperation_js_1.sponsorUserOperation)(client, args),
+    validateSponsorshipPolicies: async (args) => (0, pimlico_js_1.validateSponsorshipPolicies)(client, args)
 });
 exports.pimlicoPaymasterActions = pimlicoPaymasterActions;
 //# sourceMappingURL=pimlico.js.map

package/_cjs/clients/decorators/pimlico.js.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":";;;AACA,mGAG0D;AAC1D,+FAIwD;AACxD,2FAIsD;AAmD/C,MAAM,qBAAqB,GAAG,CACjC,MAAc,EACO,EAAE,CAAC,CAAC;IACzB,wBAAwB,EAAE,KAAK,IAAI,EAAE,CACjC,IAAA,sDAAwB,EAAC,MAA8B,CAAC;IAC5D,sBAAsB,EAAE,KAAK,EAAE,IAAsC,EAAE,EAAE,CACrE,IAAA,kDAAsB,EAAC,MAA8B,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AAPW,QAAA,qBAAqB,yBAOhC;AA+BK,MAAM,uBAAuB,GAAG,CACnC,MAAc,EACe,EAAE,CAAC,CAAC;IACjC,oBAAoB,EAAE,KAAK,EAAE,IAA2C,EAAE,EAAE,CACxE,IAAA,8CAAoB,EAAC,MAAgC,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AALW,QAAA,uBAAuB,2BAKlC"}
+{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":";;;AACA,yDAIiC;AACjC,mGAG0D;AAC1D,+FAIwD;AACxD,2FAIsD;AAmD/C,MAAM,qBAAqB,GAAG,CACjC,MAAc,EACO,EAAE,CAAC,CAAC;IACzB,wBAAwB,EAAE,KAAK,IAAI,EAAE,CACjC,IAAA,sDAAwB,EAAC,MAA8B,CAAC;IAC5D,sBAAsB,EAAE,KAAK,EAAE,IAAsC,EAAE,EAAE,CACrE,IAAA,kDAAsB,EAAC,MAA8B,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AAPW,QAAA,qBAAqB,yBAOhC;AAsEK,MAAM,uBAAuB,GAAG,CACnC,MAAc,EACe,EAAE,CAAC,CAAC;IACjC,oBAAoB,EAAE,KAAK,EAAE,IAA2C,EAAE,EAAE,CACxE,IAAA,8CAAoB,EAAC,MAAgC,EAAE,IAAI,CAAC;IAChE,2BAA2B,EAAE,KAAK,EAC9B,IAA2C,EAC7C,EAAE,CAAC,IAAA,wCAA2B,EAAC,MAAgC,EAAE,IAAI,CAAC;CAC3E,CAAC,CAAA;AARW,QAAA,uBAAuB,2BAQlC"}

package/_cjs/utils/getRequiredPrefund.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequiredPrefund = void 0;
+const getRequiredPrefund = ({ userOperation }) => {
+    const multiplier = userOperation.paymasterAndData.length > 2 ? 3n : 1n;
+    const requiredGas = userOperation.callGasLimit +
+        userOperation.verificationGasLimit * multiplier +
+        userOperation.preVerificationGas;
+    return BigInt(requiredGas) * BigInt(userOperation.maxFeePerGas);
+};
+exports.getRequiredPrefund = getRequiredPrefund;
+//# sourceMappingURL=getRequiredPrefund.js.map

package/_cjs/utils/getRequiredPrefund.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequiredPrefund.js","sourceRoot":"","sources":["../../utils/getRequiredPrefund.ts"],"names":[],"mappings":";;;AAoBO,MAAM,kBAAkB,GAAG,CAAC,EAC/B,aAAa,EACc,EAAU,EAAE;IACvC,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACtE,MAAM,WAAW,GACb,aAAa,CAAC,YAAY;QAC1B,aAAa,CAAC,oBAAoB,GAAG,UAAU;QAC/C,aAAa,CAAC,kBAAkB,CAAA;IAEpC,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;AACnE,CAAC,CAAA;AAVY,QAAA,kBAAkB,sBAU9B"}

package/_cjs/utils/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AccountOrClientNotFoundError = exports.signUserOperationHashWithECDSA = exports.getUserOperationHash = exports.parseAccount = void 0;
+exports.AccountOrClientNotFoundError = exports.signUserOperationHashWithECDSA = exports.getRequiredPrefund = exports.getUserOperationHash = exports.parseAccount = void 0;
+const getRequiredPrefund_js_1 = require("./getRequiredPrefund.js");
+Object.defineProperty(exports, "getRequiredPrefund", { enumerable: true, get: function () { return getRequiredPrefund_js_1.getRequiredPrefund; } });
 const getUserOperationHash_js_1 = require("./getUserOperationHash.js");
 Object.defineProperty(exports, "getUserOperationHash", { enumerable: true, get: function () { return getUserOperationHash_js_1.getUserOperationHash; } });
 const signUserOperationHashWithECDSA_js_1 = require("./signUserOperationHashWithECDSA.js");

package/_cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":";;;AACA,uEAGkC;AAa9B,qGAdA,8CAAoB,OAcA;AAZxB,2FAG4C;AAYxC,6GAdA,gEAA4B,OAcA;AAD5B,+GAZA,kEAA8B,OAYA;AATlC,SAAgB,YAAY,CAAC,OAA0B;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACjD,OAAO,OAAO,CAAA;AAClB,CAAC;AAJD,oCAIC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":";;;AACA,mEAGgC;AAkB5B,mGAnBA,0CAAkB,OAmBA;AAjBtB,uEAGkC;AAa9B,qGAdA,8CAAoB,OAcA;AAZxB,2FAG4C;AAcxC,6GAhBA,gEAA4B,OAgBA;AAD5B,+GAdA,kEAA8B,OAcA;AAXlC,SAAgB,YAAY,CAAC,OAA0B;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACjD,OAAO,OAAO,CAAA;AAClB,CAAC;AAJD,oCAIC"}

package/_esm/accounts/signerToSafeSmartAccount.js

@@ -19,7 +19,7 @@ const EIP712_SAFE_OPERATION_TYPE = {
 const SAFE_VERSION_TO_ADDRESSES_MAP = {
     "1.4.1": {
         ADD_MODULES_LIB_ADDRESS: "0x8EcD4ec46D4D2a6B64fE960B3D64e8B94B2234eb",
-        SAFE_4337_MODULE_ADDRESS: "0x39E54Bb2b3Aa444b4B39DEe15De3b7809c36Fc38",
+        SAFE_4337_MODULE_ADDRESS: "0xa581c4A4DB7175302464fF3C06380BC3270b4037",
         SAFE_PROXY_FACTORY_ADDRESS: "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
         SAFE_SINGLETON_ADDRESS: "0x41675C099F32341bf84BFc5382aF534df5C7461a",
         MULTI_SEND_ADDRESS: "0x38869bf66a61cF6bDB996A6aE40D5853Fd43B526",

package/_esm/actions/pimlico/validateSponsorshipPolicies.js

@@ -0,0 +1,47 @@
+import { deepHexlify } from "../../utils/deepHexlify.js";
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param client {@link PimlicoBundlerClient} that you created using viem's createClient whose transport url is pointing to the Pimlico's bundler.
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * })
+ *
+ * await validateSponsorshipPolicies(bundlerClient, {
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
+export const validateSponsorshipPolicies = async (client, args) => {
+    return await client.request({
+        method: "pm_validateSponsorshipPolicies",
+        params: [
+            deepHexlify(args.userOperation),
+            args.entryPoint,
+            args.sponsorshipPolicyIds
+        ]
+    });
+};
+//# sourceMappingURL=validateSponsorshipPolicies.js.map

package/_esm/actions/pimlico/validateSponsorshipPolicies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSponsorshipPolicies.js","sourceRoot":"","sources":["../../../actions/pimlico/validateSponsorshipPolicies.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAkBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAK5C,MAAuE,EACvE,IAA2C,EACG,EAAE;IAChD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE,gCAAgC;QACxC,MAAM,EAAE;YACJ,WAAW,CAAC,IAAI,CAAC,aAAa,CAAiC;YAC/D,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,oBAAoB;SAC5B;KACJ,CAAC,CAAA;AACN,CAAC,CAAA"}

package/_esm/actions/pimlico.js

@@ -2,5 +2,6 @@ import { getUserOperationGasPrice } from "./pimlico/getUserOperationGasPrice.js"
 import { getUserOperationStatus } from "./pimlico/getUserOperationStatus.js";
 import { sponsorUserOperation } from "./pimlico/sponsorUserOperation.js";
 import { pimlicoBundlerActions, pimlicoPaymasterActions } from "../clients/decorators/pimlico.js";
-export { getUserOperationGasPrice, getUserOperationStatus, sponsorUserOperation, pimlicoBundlerActions, pimlicoPaymasterActions };
+import { validateSponsorshipPolicies } from "./pimlico/validateSponsorshipPolicies.js";
+export { getUserOperationGasPrice, getUserOperationStatus, sponsorUserOperation, pimlicoBundlerActions, pimlicoPaymasterActions, validateSponsorshipPolicies };
 //# sourceMappingURL=pimlico.js.map

package/_esm/actions/pimlico.js.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,wBAAwB,EAC3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAGH,sBAAsB,EACzB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAGH,oBAAoB,EACvB,MAAM,mCAAmC,CAAA;AAM1C,OAAO,EACH,qBAAqB,EACrB,uBAAuB,EAC1B,MAAM,kCAAkC,CAAA;AAYzC,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAC1B,CAAA"}
+{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,wBAAwB,EAC3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAGH,sBAAsB,EACzB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAGH,oBAAoB,EACvB,MAAM,mCAAmC,CAAA;AAM1C,OAAO,EACH,qBAAqB,EACrB,uBAAuB,EAC1B,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EAGH,2BAA2B,EAC9B,MAAM,0CAA0C,CAAA;AAcjD,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC9B,CAAA"}

package/_esm/clients/decorators/pimlico.js

@@ -1,3 +1,4 @@
+import { validateSponsorshipPolicies } from "../../actions/pimlico.js";
 import { getUserOperationGasPrice } from "../../actions/pimlico/getUserOperationGasPrice.js";
 import { getUserOperationStatus } from "../../actions/pimlico/getUserOperationStatus.js";
 import { sponsorUserOperation } from "../../actions/pimlico/sponsorUserOperation.js";
@@ -5,8 +6,44 @@ export const pimlicoBundlerActions = (client) => ({
     getUserOperationGasPrice: async () => getUserOperationGasPrice(client),
     getUserOperationStatus: async (args) => getUserOperationStatus(client, args)
 });
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * }).extend(pimlicoPaymasterActions)
+
+ *
+ * await bundlerClient.validateSponsorshipPolicies({
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
 export const pimlicoPaymasterActions = (client) => ({
-    sponsorUserOperation: async (args) => sponsorUserOperation(client, args)
+    sponsorUserOperation: async (args) => sponsorUserOperation(client, args),
+    validateSponsorshipPolicies: async (args) => validateSponsorshipPolicies(client, args)
 });
 /**
  * TODO: Add support for pimlicoActions after we support all the actions of v2 of the Pimlico API.

package/_esm/clients/decorators/pimlico.js.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,wBAAwB,EAC3B,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAGH,sBAAsB,EACzB,MAAM,iDAAiD,CAAA;AACxD,OAAO,EAGH,oBAAoB,EACvB,MAAM,+CAA+C,CAAA;AAmDtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,MAAc,EACO,EAAE,CAAC,CAAC;IACzB,wBAAwB,EAAE,KAAK,IAAI,EAAE,CACjC,wBAAwB,CAAC,MAA8B,CAAC;IAC5D,sBAAsB,EAAE,KAAK,EAAE,IAAsC,EAAE,EAAE,CACrE,sBAAsB,CAAC,MAA8B,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AA+BF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACnC,MAAc,EACe,EAAE,CAAC,CAAC;IACjC,oBAAoB,EAAE,KAAK,EAAE,IAA2C,EAAE,EAAE,CACxE,oBAAoB,CAAC,MAAgC,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AAEF;;GAEG;AACH,sDAAsD;AACtD,eAAe;AACf,4CAA4C;AAC5C,6CAA6C;AAC7C,QAAQ;AACR,IAAI"}
+{"version":3,"file":"pimlico.js","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,2BAA2B,EAC9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAEH,wBAAwB,EAC3B,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAGH,sBAAsB,EACzB,MAAM,iDAAiD,CAAA;AACxD,OAAO,EAGH,oBAAoB,EACvB,MAAM,+CAA+C,CAAA;AAmDtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,MAAc,EACO,EAAE,CAAC,CAAC;IACzB,wBAAwB,EAAE,KAAK,IAAI,EAAE,CACjC,wBAAwB,CAAC,MAA8B,CAAC;IAC5D,sBAAsB,EAAE,KAAK,EAAE,IAAsC,EAAE,EAAE,CACrE,sBAAsB,CAAC,MAA8B,EAAE,IAAI,CAAC;CACnE,CAAC,CAAA;AAmCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACnC,MAAc,EACe,EAAE,CAAC,CAAC;IACjC,oBAAoB,EAAE,KAAK,EAAE,IAA2C,EAAE,EAAE,CACxE,oBAAoB,CAAC,MAAgC,EAAE,IAAI,CAAC;IAChE,2BAA2B,EAAE,KAAK,EAC9B,IAA2C,EAC7C,EAAE,CAAC,2BAA2B,CAAC,MAAgC,EAAE,IAAI,CAAC;CAC3E,CAAC,CAAA;AAEF;;GAEG;AACH,sDAAsD;AACtD,eAAe;AACf,4CAA4C;AAC5C,6CAA6C;AAC7C,QAAQ;AACR,IAAI"}

package/_esm/utils/getRequiredPrefund.js

@@ -0,0 +1,22 @@
+/**
+ *
+ * Returns the minimum required funds in the senders's smart account to execute the user operation.
+ *
+ * @param arags: {userOperation} as {@link UserOperation}
+ * @returns requiredPrefund as {@link bigint}
+ *
+ * @example
+ * import { getRequiredPrefund } from "permissionless/utils"
+ *
+ * const requiredPrefund = getRequiredPrefund({
+ *     userOperation
+ * })
+ */
+export const getRequiredPrefund = ({ userOperation }) => {
+    const multiplier = userOperation.paymasterAndData.length > 2 ? 3n : 1n;
+    const requiredGas = userOperation.callGasLimit +
+        userOperation.verificationGasLimit * multiplier +
+        userOperation.preVerificationGas;
+    return BigInt(requiredGas) * BigInt(userOperation.maxFeePerGas);
+};
+//# sourceMappingURL=getRequiredPrefund.js.map

package/_esm/utils/getRequiredPrefund.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequiredPrefund.js","sourceRoot":"","sources":["../../utils/getRequiredPrefund.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAC/B,aAAa,EACc,EAAU,EAAE;IACvC,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACtE,MAAM,WAAW,GACb,aAAa,CAAC,YAAY;QAC1B,aAAa,CAAC,oBAAoB,GAAG,UAAU;QAC/C,aAAa,CAAC,kBAAkB,CAAA;IAEpC,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/_esm/utils/index.js

@@ -1,3 +1,4 @@
+import { getRequiredPrefund } from "./getRequiredPrefund.js";
 import { getUserOperationHash } from "./getUserOperationHash.js";
 import { AccountOrClientNotFoundError, signUserOperationHashWithECDSA } from "./signUserOperationHashWithECDSA.js";
 export function parseAccount(account) {
@@ -5,5 +6,5 @@ export function parseAccount(account) {
         return { address: account, type: "json-rpc" };
     return account;
 }
-export { getUserOperationHash, signUserOperationHashWithECDSA, AccountOrClientNotFoundError };
+export { getUserOperationHash, getRequiredPrefund, signUserOperationHashWithECDSA, AccountOrClientNotFoundError };
 //# sourceMappingURL=index.js.map

package/_esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,oBAAoB,EACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,4BAA4B,EAC5B,8BAA8B,EACjC,MAAM,qCAAqC,CAAA;AAE5C,MAAM,UAAU,YAAY,CAAC,OAA0B;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACjD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,OAAO,EACH,oBAAoB,EAEpB,8BAA8B,EAC9B,4BAA4B,EAC/B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,kBAAkB,EACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAEH,oBAAoB,EACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,4BAA4B,EAC5B,8BAA8B,EACjC,MAAM,qCAAqC,CAAA;AAE5C,MAAM,UAAU,YAAY,CAAC,OAA0B;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACjD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,OAAO,EACH,oBAAoB,EACpB,kBAAkB,EAGlB,8BAA8B,EAC9B,4BAA4B,EAC/B,CAAA"}

package/_types/actions/pimlico/validateSponsorshipPolicies.d.ts

@@ -0,0 +1,54 @@
+import type { Account, Address, Chain, Client, Transport } from "viem";
+import type { PimlicoPaymasterRpcSchema } from "../../types/pimlico.js";
+import type { UserOperation } from "../../types/userOperation.js";
+export type ValidateSponsorshipPoliciesParameters = {
+    userOperation: UserOperation;
+    entryPoint: Address;
+    sponsorshipPolicyIds: string[];
+};
+export type ValidateSponsorshipPoliciesReturnType = {
+    sponsorshipPolicyId: string;
+    data: {
+        name: string | null;
+        author: string | null;
+        icon: string | null;
+        description: string | null;
+    };
+}[];
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param client {@link PimlicoBundlerClient} that you created using viem's createClient whose transport url is pointing to the Pimlico's bundler.
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * })
+ *
+ * await validateSponsorshipPolicies(bundlerClient, {
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
+export declare const validateSponsorshipPolicies: <TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined>(client: Client<TTransport, TChain, TAccount, PimlicoPaymasterRpcSchema>, args: ValidateSponsorshipPoliciesParameters) => Promise<ValidateSponsorshipPoliciesReturnType>;
+//# sourceMappingURL=validateSponsorshipPolicies.d.ts.map

package/_types/actions/pimlico/validateSponsorshipPolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSponsorshipPolicies.d.ts","sourceRoot":"","sources":["../../../actions/pimlico/validateSponsorshipPolicies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AACvE,OAAO,KAAK,EACR,aAAa,EAEhB,MAAM,8BAA8B,CAAA;AAGrC,MAAM,MAAM,qCAAqC,GAAG;IAChD,aAAa,EAAE,aAAa,CAAA;IAC5B,UAAU,EAAE,OAAO,CAAA;IACnB,oBAAoB,EAAE,MAAM,EAAE,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,qCAAqC,GAAG;IAChD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,IAAI,EAAE;QACF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,CAAA;CACJ,EAAE,CAAA;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,2BAA2B,8OAM9B,qCAAqC,KAC5C,QAAQ,qCAAqC,CAS/C,CAAA"}

package/_types/actions/pimlico.d.ts

@@ -3,6 +3,7 @@ import { type GetUserOperationStatusParameters, type GetUserOperationStatusRetur
 import { type PimlocoSponsorUserOperationParameters, type SponsorUserOperationReturnType, sponsorUserOperation } from "./pimlico/sponsorUserOperation.js";
 import type { PimlicoBundlerActions, PimlicoPaymasterClientActions } from "../clients/decorators/pimlico.js";
 import { pimlicoBundlerActions, pimlicoPaymasterActions } from "../clients/decorators/pimlico.js";
-export type { GetUserOperationGasPriceReturnType, GetUserOperationStatusParameters, GetUserOperationStatusReturnType, PimlocoSponsorUserOperationParameters, SponsorUserOperationReturnType, PimlicoBundlerActions, PimlicoPaymasterClientActions };
-export { getUserOperationGasPrice, getUserOperationStatus, sponsorUserOperation, pimlicoBundlerActions, pimlicoPaymasterActions };
+import { type ValidateSponsorshipPoliciesParameters, type ValidateSponsorshipPoliciesReturnType, validateSponsorshipPolicies } from "./pimlico/validateSponsorshipPolicies.js";
+export type { GetUserOperationGasPriceReturnType, GetUserOperationStatusParameters, GetUserOperationStatusReturnType, PimlocoSponsorUserOperationParameters, SponsorUserOperationReturnType, PimlicoBundlerActions, PimlicoPaymasterClientActions, ValidateSponsorshipPoliciesParameters, ValidateSponsorshipPoliciesReturnType };
+export { getUserOperationGasPrice, getUserOperationStatus, sponsorUserOperation, pimlicoBundlerActions, pimlicoPaymasterActions, validateSponsorshipPolicies };
 //# sourceMappingURL=pimlico.d.ts.map

package/_types/actions/pimlico.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,kCAAkC,EACvC,wBAAwB,EAC3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,sBAAsB,EACzB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,oBAAoB,EACvB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,KAAK,EACR,qBAAqB,EACrB,6BAA6B,EAChC,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACH,qBAAqB,EACrB,uBAAuB,EAC1B,MAAM,kCAAkC,CAAA;AAEzC,YAAY,EACR,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,qCAAqC,EACrC,8BAA8B,EAC9B,qBAAqB,EACrB,6BAA6B,EAChC,CAAA;AAED,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAC1B,CAAA"}
+{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../actions/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,kCAAkC,EACvC,wBAAwB,EAC3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,sBAAsB,EACzB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,oBAAoB,EACvB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,KAAK,EACR,qBAAqB,EACrB,6BAA6B,EAChC,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACH,qBAAqB,EACrB,uBAAuB,EAC1B,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAC1C,2BAA2B,EAC9B,MAAM,0CAA0C,CAAA;AAEjD,YAAY,EACR,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,qCAAqC,EACrC,8BAA8B,EAC9B,qBAAqB,EACrB,6BAA6B,EAC7B,qCAAqC,EACrC,qCAAqC,EACxC,CAAA;AAED,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC9B,CAAA"}

package/_types/clients/decorators/pimlico.d.ts

@@ -1,4 +1,5 @@
 import type { Client } from "viem";
+import { type ValidateSponsorshipPoliciesParameters, type ValidateSponsorshipPoliciesReturnType } from "../../actions/pimlico.js";
 import { type GetUserOperationGasPriceReturnType } from "../../actions/pimlico/getUserOperationGasPrice.js";
 import { type GetUserOperationStatusParameters, type GetUserOperationStatusReturnType } from "../../actions/pimlico/getUserOperationStatus.js";
 import { type PimlocoSponsorUserOperationParameters, type SponsorUserOperationReturnType } from "../../actions/pimlico/sponsorUserOperation.js";
@@ -70,7 +71,43 @@ export type PimlicoPaymasterClientActions = {
      *
      */
     sponsorUserOperation: (args: PimlocoSponsorUserOperationParameters) => Promise<SponsorUserOperationReturnType>;
+    validateSponsorshipPolicies: (args: ValidateSponsorshipPoliciesParameters) => Promise<ValidateSponsorshipPoliciesReturnType>;
 };
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * }).extend(pimlicoPaymasterActions)
+
+ *
+ * await bundlerClient.validateSponsorshipPolicies({
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
 export declare const pimlicoPaymasterActions: (client: Client) => PimlicoPaymasterClientActions;
 /**
  * TODO: Add support for pimlicoActions after we support all the actions of v2 of the Pimlico API.

package/_types/clients/decorators/pimlico.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAQ,MAAM,MAAM,CAAA;AACxC,OAAO,EACH,KAAK,kCAAkC,EAE1C,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAExC,MAAM,iDAAiD,CAAA;AACxD,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EAEtC,MAAM,+CAA+C,CAAA;AAMtD,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAAwB,EAAE,MAAM,OAAO,CAAC,kCAAkC,CAAC,CAAA;IAC3E;;;;;;;;;;;;;;;;;;OAkBG;IACH,sBAAsB,EAAE,CACpB,IAAI,EAAE,gCAAgC,KACrC,OAAO,CAAC,gCAAgC,CAAC,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,qBAAqB,WACtB,MAAM,KACf,qBAKD,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG;IACxC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,oBAAoB,EAAE,CAClB,IAAI,EAAE,qCAAqC,KAC1C,OAAO,CAAC,8BAA8B,CAAC,CAAA;CAC/C,CAAA;AAED,eAAO,MAAM,uBAAuB,WACxB,MAAM,KACf,6BAGD,CAAA;AAEF;;GAEG"}
+{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../../clients/decorators/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAQ,MAAM,MAAM,CAAA;AACxC,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAE7C,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACH,KAAK,kCAAkC,EAE1C,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAExC,MAAM,iDAAiD,CAAA;AACxD,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EAEtC,MAAM,+CAA+C,CAAA;AAMtD,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAAwB,EAAE,MAAM,OAAO,CAAC,kCAAkC,CAAC,CAAA;IAC3E;;;;;;;;;;;;;;;;;;OAkBG;IACH,sBAAsB,EAAE,CACpB,IAAI,EAAE,gCAAgC,KACrC,OAAO,CAAC,gCAAgC,CAAC,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,qBAAqB,WACtB,MAAM,KACf,qBAKD,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG;IACxC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,oBAAoB,EAAE,CAClB,IAAI,EAAE,qCAAqC,KAC1C,OAAO,CAAC,8BAA8B,CAAC,CAAA;IAE5C,2BAA2B,EAAE,CACzB,IAAI,EAAE,qCAAqC,KAC1C,OAAO,CAAC,qCAAqC,CAAC,CAAA;CACtD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,uBAAuB,WACxB,MAAM,KACf,6BAMD,CAAA;AAEF;;GAEG"}

package/_types/types/pimlico.d.ts

@@ -47,6 +47,23 @@ export type PimlicoPaymasterRpcSchema = [
             verificationGasLimit: Hex;
             callGasLimit: Hex;
         };
+    },
+    {
+        Method: "pm_validateSponsorshipPolicies";
+        Parameters: [
+            userOperation: UserOperationWithBigIntAsHex,
+            entryPoint: Address,
+            sponsorshipPolicyIds: string[]
+        ];
+        ReturnType: {
+            sponsorshipPolicyId: string;
+            data: {
+                name: string | null;
+                author: string | null;
+                icon: string | null;
+                description: string | null;
+            };
+        }[];
     }
 ];
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../types/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,KAAK,2CAA2C,GAAG;IAC/C,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,0BAA0B,GAAG;IACrC,MAAM,EACA,WAAW,GACX,eAAe,GACf,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,CAAA;IACd,eAAe,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC;QACI,MAAM,EAAE,kCAAkC,CAAA;QAC1C,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,2CAA2C,CAAA;KAC1D;IACD;QACI,MAAM,EAAE,gCAAgC,CAAA;QACxC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,0BAA0B,CAAA;KACzC;CACJ,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC1B,cAAc,GACd,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,CACvB;YACD,UAAU,EAAE,OAAO;YACnB,QAAQ,CAAC,EAAE;gBACP,mBAAmB,CAAC,EAAE,MAAM,CAAA;aAC/B;SACJ,CAAA;QACD,UAAU,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;CACJ,CAAA"}
+{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../types/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,KAAK,2CAA2C,GAAG;IAC/C,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,0BAA0B,GAAG;IACrC,MAAM,EACA,WAAW,GACX,eAAe,GACf,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,CAAA;IACd,eAAe,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC;QACI,MAAM,EAAE,kCAAkC,CAAA;QAC1C,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,2CAA2C,CAAA;KAC1D;IACD;QACI,MAAM,EAAE,gCAAgC,CAAA;QACxC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,0BAA0B,CAAA;KACzC;CACJ,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC1B,cAAc,GACd,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,CACvB;YACD,UAAU,EAAE,OAAO;YACnB,QAAQ,CAAC,EAAE;gBACP,mBAAmB,CAAC,EAAE,MAAM,CAAA;aAC/B;SACJ,CAAA;QACD,UAAU,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,gCAAgC,CAAA;QACxC,UAAU,EAAE;YACR,aAAa,EAAE,4BAA4B;YAC3C,UAAU,EAAE,OAAO;YACnB,oBAAoB,EAAE,MAAM,EAAE;SACjC,CAAA;QACD,UAAU,EAAE;YACR,mBAAmB,EAAE,MAAM,CAAA;YAC3B,IAAI,EAAE;gBACF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;gBACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;gBACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;gBACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;aAC7B,CAAA;SACJ,EAAE,CAAA;KACN;CACJ,CAAA"}

package/_types/utils/getRequiredPrefund.d.ts

@@ -0,0 +1,20 @@
+import type { UserOperation } from "../types";
+export type GetRequiredPrefundReturnType = {
+    userOperation: UserOperation;
+};
+/**
+ *
+ * Returns the minimum required funds in the senders's smart account to execute the user operation.
+ *
+ * @param arags: {userOperation} as {@link UserOperation}
+ * @returns requiredPrefund as {@link bigint}
+ *
+ * @example
+ * import { getRequiredPrefund } from "permissionless/utils"
+ *
+ * const requiredPrefund = getRequiredPrefund({
+ *     userOperation
+ * })
+ */
+export declare const getRequiredPrefund: ({ userOperation }: GetRequiredPrefundReturnType) => bigint;
+//# sourceMappingURL=getRequiredPrefund.d.ts.map

package/_types/utils/getRequiredPrefund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequiredPrefund.d.ts","sourceRoot":"","sources":["../../utils/getRequiredPrefund.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,MAAM,4BAA4B,GAAG;IACvC,aAAa,EAAE,aAAa,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,sBAE5B,4BAA4B,KAAG,MAQjC,CAAA"}

package/_types/utils/index.d.ts

@@ -1,6 +1,7 @@
 import type { Account, Address } from "viem";
+import { type GetRequiredPrefundReturnType, getRequiredPrefund } from "./getRequiredPrefund.js";
 import { type GetUserOperationHashParams, getUserOperationHash } from "./getUserOperationHash.js";
 import { AccountOrClientNotFoundError, signUserOperationHashWithECDSA } from "./signUserOperationHashWithECDSA.js";
 export declare function parseAccount(account: Address | Account): Account;
-export { getUserOperationHash, type GetUserOperationHashParams, signUserOperationHashWithECDSA, AccountOrClientNotFoundError };
+export { getUserOperationHash, getRequiredPrefund, type GetRequiredPrefundReturnType, type GetUserOperationHashParams, signUserOperationHashWithECDSA, AccountOrClientNotFoundError };
 //# sourceMappingURL=index.d.ts.map

package/_types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EACH,KAAK,0BAA0B,EAC/B,oBAAoB,EACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,4BAA4B,EAC5B,8BAA8B,EACjC,MAAM,qCAAqC,CAAA;AAE5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAIhE;AAED,OAAO,EACH,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC/B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EACH,KAAK,4BAA4B,EACjC,kBAAkB,EACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACH,KAAK,0BAA0B,EAC/B,oBAAoB,EACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,4BAA4B,EAC5B,8BAA8B,EACjC,MAAM,qCAAqC,CAAA;AAE5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAIhE;AAED,OAAO,EACH,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC/B,CAAA"}

package/accounts/signerToSafeSmartAccount.ts

@@ -62,7 +62,7 @@ const SAFE_VERSION_TO_ADDRESSES_MAP: {
 } = {
     "1.4.1": {
         ADD_MODULES_LIB_ADDRESS: "0x8EcD4ec46D4D2a6B64fE960B3D64e8B94B2234eb",
-        SAFE_4337_MODULE_ADDRESS: "0x39E54Bb2b3Aa444b4B39DEe15De3b7809c36Fc38",
+        SAFE_4337_MODULE_ADDRESS: "0xa581c4A4DB7175302464fF3C06380BC3270b4037",
         SAFE_PROXY_FACTORY_ADDRESS:
             "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
         SAFE_SINGLETON_ADDRESS: "0x41675C099F32341bf84BFc5382aF534df5C7461a",

package/actions/pimlico/validateSponsorshipPolicies.ts

@@ -0,0 +1,76 @@
+import type { Account, Address, Chain, Client, Transport } from "viem"
+import type { PimlicoPaymasterRpcSchema } from "../../types/pimlico.js"
+import type {
+    UserOperation,
+    UserOperationWithBigIntAsHex
+} from "../../types/userOperation.js"
+import { deepHexlify } from "../../utils/deepHexlify.js"
+
+export type ValidateSponsorshipPoliciesParameters = {
+    userOperation: UserOperation
+    entryPoint: Address
+    sponsorshipPolicyIds: string[]
+}
+
+export type ValidateSponsorshipPoliciesReturnType = {
+    sponsorshipPolicyId: string
+    data: {
+        name: string | null
+        author: string | null
+        icon: string | null
+        description: string | null
+    }
+}[]
+
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param client {@link PimlicoBundlerClient} that you created using viem's createClient whose transport url is pointing to the Pimlico's bundler.
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * })
+ *
+ * await validateSponsorshipPolicies(bundlerClient, {
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
+export const validateSponsorshipPolicies = async <
+    TTransport extends Transport = Transport,
+    TChain extends Chain | undefined = Chain | undefined,
+    TAccount extends Account | undefined = Account | undefined
+>(
+    client: Client<TTransport, TChain, TAccount, PimlicoPaymasterRpcSchema>,
+    args: ValidateSponsorshipPoliciesParameters
+): Promise<ValidateSponsorshipPoliciesReturnType> => {
+    return await client.request({
+        method: "pm_validateSponsorshipPolicies",
+        params: [
+            deepHexlify(args.userOperation) as UserOperationWithBigIntAsHex,
+            args.entryPoint,
+            args.sponsorshipPolicyIds
+        ]
+    })
+}

package/actions/pimlico.ts

@@ -22,6 +22,12 @@ import {
     pimlicoPaymasterActions
 } from "../clients/decorators/pimlico.js"
 
+import {
+    type ValidateSponsorshipPoliciesParameters,
+    type ValidateSponsorshipPoliciesReturnType,
+    validateSponsorshipPolicies
+} from "./pimlico/validateSponsorshipPolicies.js"
+
 export type {
     GetUserOperationGasPriceReturnType,
     GetUserOperationStatusParameters,
@@ -29,7 +35,9 @@ export type {
     PimlocoSponsorUserOperationParameters,
     SponsorUserOperationReturnType,
     PimlicoBundlerActions,
-    PimlicoPaymasterClientActions
+    PimlicoPaymasterClientActions,
+    ValidateSponsorshipPoliciesParameters,
+    ValidateSponsorshipPoliciesReturnType
 }
 
 export {
@@ -37,5 +45,6 @@ export {
     getUserOperationStatus,
     sponsorUserOperation,
     pimlicoBundlerActions,
-    pimlicoPaymasterActions
+    pimlicoPaymasterActions,
+    validateSponsorshipPolicies
 }

package/clients/decorators/pimlico.ts

@@ -1,4 +1,9 @@
 import type { Client, Hash } from "viem"
+import {
+    type ValidateSponsorshipPoliciesParameters,
+    type ValidateSponsorshipPoliciesReturnType,
+    validateSponsorshipPolicies
+} from "../../actions/pimlico.js"
 import {
     type GetUserOperationGasPriceReturnType,
     getUserOperationGasPrice
@@ -99,13 +104,55 @@ export type PimlicoPaymasterClientActions = {
     sponsorUserOperation: (
         args: PimlocoSponsorUserOperationParameters
     ) => Promise<SponsorUserOperationReturnType>
+
+    validateSponsorshipPolicies: (
+        args: ValidateSponsorshipPoliciesParameters
+    ) => Promise<ValidateSponsorshipPoliciesReturnType>
 }
 
+/**
+ * Returns valid sponsorship policies for a userOperation from the list of ids passed
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-paymaster-actions/ValidateSponsorshipPolicies
+ *
+ * @param args {@link ValidateSponsorshipPoliciesParameters} UserOperation you want to sponsor & entryPoint.
+ * @returns valid sponsorship policies, see {@link ValidateSponsorshipPoliciesReturnType}
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { validateSponsorshipPolicies } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *   chain: goerli,
+ *   transport: http("https://api.pimlico.io/v2/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * }).extend(pimlicoPaymasterActions)
+
+ *
+ * await bundlerClient.validateSponsorshipPolicies({
+ *   userOperation: userOperationWithDummySignature,
+ *   entryPoint: entryPoint,
+ *   sponsorshipPolicyIds: ["sp_shiny_puma"]
+ * })
+ * Returns
+ * [
+ *   {
+ *     sponsorshipPolicyId: "sp_shiny_puma",
+ *     data: {
+ *       name: "Shiny Puma",
+ *       author: "Pimlico",
+ *       icon: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4...",
+ *       description: "This policy is for testing purposes only"
+ *    }
+ *   }
+ * ]
+ */
 export const pimlicoPaymasterActions = (
     client: Client
 ): PimlicoPaymasterClientActions => ({
     sponsorUserOperation: async (args: PimlocoSponsorUserOperationParameters) =>
-        sponsorUserOperation(client as PimlicoPaymasterClient, args)
+        sponsorUserOperation(client as PimlicoPaymasterClient, args),
+    validateSponsorshipPolicies: async (
+        args: ValidateSponsorshipPoliciesParameters
+    ) => validateSponsorshipPolicies(client as PimlicoPaymasterClient, args)
 })
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "permissionless",
-    "version": "0.0.14",
+    "version": "0.0.15",
     "author": "Pimlico",
     "main": "./_cjs/index.js",
     "module": "./_esm/index.js",

package/types/pimlico.ts

@@ -64,5 +64,22 @@ export type PimlicoPaymasterRpcSchema = [
             verificationGasLimit: Hex
             callGasLimit: Hex
         }
+    },
+    {
+        Method: "pm_validateSponsorshipPolicies"
+        Parameters: [
+            userOperation: UserOperationWithBigIntAsHex,
+            entryPoint: Address,
+            sponsorshipPolicyIds: string[]
+        ]
+        ReturnType: {
+            sponsorshipPolicyId: string
+            data: {
+                name: string | null
+                author: string | null
+                icon: string | null
+                description: string | null
+            }
+        }[]
     }
 ]

package/utils/getRequiredPrefund.ts

@@ -0,0 +1,31 @@
+import type { UserOperation } from "../types"
+
+export type GetRequiredPrefundReturnType = {
+    userOperation: UserOperation
+}
+
+/**
+ *
+ * Returns the minimum required funds in the senders's smart account to execute the user operation.
+ *
+ * @param arags: {userOperation} as {@link UserOperation}
+ * @returns requiredPrefund as {@link bigint}
+ *
+ * @example
+ * import { getRequiredPrefund } from "permissionless/utils"
+ *
+ * const requiredPrefund = getRequiredPrefund({
+ *     userOperation
+ * })
+ */
+export const getRequiredPrefund = ({
+    userOperation
+}: GetRequiredPrefundReturnType): bigint => {
+    const multiplier = userOperation.paymasterAndData.length > 2 ? 3n : 1n
+    const requiredGas =
+        userOperation.callGasLimit +
+        userOperation.verificationGasLimit * multiplier +
+        userOperation.preVerificationGas
+
+    return BigInt(requiredGas) * BigInt(userOperation.maxFeePerGas)
+}

package/utils/index.ts

@@ -1,4 +1,8 @@
 import type { Account, Address } from "viem"
+import {
+    type GetRequiredPrefundReturnType,
+    getRequiredPrefund
+} from "./getRequiredPrefund.js"
 import {
     type GetUserOperationHashParams,
     getUserOperationHash
@@ -16,6 +20,8 @@ export function parseAccount(account: Address | Account): Account {
 
 export {
     getUserOperationHash,
+    getRequiredPrefund,
+    type GetRequiredPrefundReturnType,
     type GetUserOperationHashParams,
     signUserOperationHashWithECDSA,
     AccountOrClientNotFoundError