@lit-protocol/vincent-ability-sdk 2.3.4 → 2.4.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## 2.4.0 (2026-01-07)
+
+### 🚀 Features
+
+- feat: add Relay.link gated signer ability ([3eec29cb](https://github.com/LIT-Protocol/Vincent/commit/3eec29cb))
+  - **ability-relay-link**: New package - a Vincent Ability that acts as a secure gated signer for Relay.link swap operations. Supports ERC-4337 Smart Accounts (ZeroDev, Crossmint, Safe) and EOAs. Includes transaction decoding, simulation-based validation, and helpers for building/submitting UserOps.
+  - **ability-sdk**: Allow `validateSimulation` and `validateTransaction` lifecycle functions to be async to support dynamic address fetching.
+  - **e2e-test-utils**: Add Safe account setup helper, export Crossmint client from setup function, and rename `TEST_PLATFORM_USER_WALLET_OWNER_PRIVATE_KEY` env var to `TEST_AGENT_WALLET_PKP_OWNER_PRIVATE_KEY`. Update ENVs to be more chain-abstract.
+
+- Export Vincent Gated Signer abilities builder function and use it in the aave ability to convert it into a gated signer one ([ce148136](https://github.com/LIT-Protocol/Vincent/commit/ce148136))
+
+### 🩹 Fixes
+
+- Fix address checksum format ([#437](https://github.com/LIT-Protocol/Vincent/pull/437))
+- Export simulation type ([#434](https://github.com/LIT-Protocol/Vincent/pull/434))
+
+### 🧱 Updated Dependencies
+
+- Updated contracts-sdk to 6.0.0
+
+### ❤️ Thank You
+
+- awisniew207 @awisniew207
+- Federico Amura @FedericoAmura
+- FedericoAmura @FedericoAmura
+
 ## 2.3.4 (2025-11-23)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -208,6 +208,54 @@ export const myTokenSwapAbility = createVincentAbility({
 });
 ```
 
+---
+
+### Gated Signer Ability
+
+A **Gated Signer Ability** is a specialized ability designed to validate and sign EOA transactions or AA user operations. It enforces a strict validation lifecycle before using the delegated PKP to sign the request.
+
+#### Lifecycle
+
+1. **Decode**: The ability decodes the transaction data using the provided `decodeTransaction` function.
+2. **Simulation**: The ability simulates the transaction/userOperation on-chain to determine asset changes.
+3. **Validate Simulation**: The `validateSimulation` function checks if the simulation results are acceptable (e.g., no unexpected asset transfers).
+4. **Validate Transaction**: The `validateTransaction` function inspects the decoded transaction to ensure it complies with security policies (e.g., allowed contracts, methods, arguments).
+5. **Sign**: If all validations pass, the ability signs the transaction or userOperation using the PKP.
+
+#### Creating a Gated Signer Ability
+
+You can create a Gated Signer Ability using `createVincentGatedSignerAbility`:
+
+```ts
+import { createVincentGatedSignerAbility } from '@lit-protocol/vincent-ability-sdk/gatedSigner';
+
+import { decodeTransaction } from './decodeTransaction';
+import { validateSimulation } from './validateSimulation';
+import { validateTransaction } from './validateTransaction';
+
+export const myGatedSignerAbility = createVincentGatedSignerAbility({
+  packageName: '@my-org/my-gated-signer',
+  abilityDescription: 'Safely signs transactions for My Protocol',
+
+  // Lifecycle functions
+  decodeTransaction,
+  validateSimulation,
+  validateTransaction,
+});
+```
+
+The lifecycle functions must implement the `LifecycleFunctionSteps` interface:
+
+```ts
+interface LifecycleFunctionSteps {
+  decodeTransaction: (params: DecodeTransactionParams) => DecodedTransaction;
+  validateSimulation: (params: ValidateSimulationParams) => void;
+  validateTransaction: (params: ValidateTransactionParams) => void;
+}
+```
+
+This abstraction simplifies the creation of abilities that act as secure signers, ensuring consistent validation logic across different implementations.
+
 ## Tip
 
-Ability and policy authors should export the result of `createVincentPolicy()` / `createVincentAbility()`
+Ability and policy authors should export the result of `createVincentPolicy()` / `createVincentAbility()` / `createVincentGatedSignerAbility()`

package/dist/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 2.3.4 (2025-11-23)
+
+### 🧱 Updated Dependencies
+
+- Updated contracts-sdk to 5.0.0
+
 ## 2.3.1 (2025-10-08)
 
 ### 🧱 Updated Dependencies

package/dist/README.md

@@ -208,6 +208,54 @@ export const myTokenSwapAbility = createVincentAbility({
 });
 ```
 
+---
+
+### Gated Signer Ability
+
+A **Gated Signer Ability** is a specialized ability designed to validate and sign EOA transactions or AA user operations. It enforces a strict validation lifecycle before using the delegated PKP to sign the request.
+
+#### Lifecycle
+
+1. **Decode**: The ability decodes the transaction data using the provided `decodeTransaction` function.
+2. **Simulation**: The ability simulates the transaction/userOperation on-chain to determine asset changes.
+3. **Validate Simulation**: The `validateSimulation` function checks if the simulation results are acceptable (e.g., no unexpected asset transfers).
+4. **Validate Transaction**: The `validateTransaction` function inspects the decoded transaction to ensure it complies with security policies (e.g., allowed contracts, methods, arguments).
+5. **Sign**: If all validations pass, the ability signs the transaction or userOperation using the PKP.
+
+#### Creating a Gated Signer Ability
+
+You can create a Gated Signer Ability using `createVincentGatedSignerAbility`:
+
+```ts
+import { createVincentGatedSignerAbility } from '@lit-protocol/vincent-ability-sdk/gatedSigner';
+
+import { decodeTransaction } from './decodeTransaction';
+import { validateSimulation } from './validateSimulation';
+import { validateTransaction } from './validateTransaction';
+
+export const myGatedSignerAbility = createVincentGatedSignerAbility({
+  packageName: '@my-org/my-gated-signer',
+  abilityDescription: 'Safely signs transactions for My Protocol',
+
+  // Lifecycle functions
+  decodeTransaction,
+  validateSimulation,
+  validateTransaction,
+});
+```
+
+The lifecycle functions must implement the `LifecycleFunctionSteps` interface:
+
+```ts
+interface LifecycleFunctionSteps {
+  decodeTransaction: (params: DecodeTransactionParams) => DecodedTransaction;
+  validateSimulation: (params: ValidateSimulationParams) => void;
+  validateTransaction: (params: ValidateTransactionParams) => void;
+}
+```
+
+This abstraction simplifies the creation of abilities that act as secure signers, ensuring consistent validation logic across different implementations.
+
 ## Tip
 
-Ability and policy authors should export the result of `createVincentPolicy()` / `createVincentAbility()`
+Ability and policy authors should export the result of `createVincentPolicy()` / `createVincentAbility()` / `createVincentGatedSignerAbility()`

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lit-protocol/vincent-ability-sdk",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "publishConfig": {
     "access": "public"
   },
@@ -12,6 +12,7 @@
     "ethers-v6": "npm:ethers@^6",
     "semver": "^7.7.2",
     "tslib": "^2.8.1",
+    "viem": "^2.40.3",
     "zod": "^3.25.64"
   },
   "scripts": {
@@ -32,6 +33,11 @@
     "./internal": {
       "require": "./dist/src/internal.js",
       "import": "./dist/src/internal.js"
+    },
+    "./gatedSigner": {
+      "require": "./dist/src/gatedSigner.js",
+      "import": "./dist/src/gatedSigner.js",
+      "types": "./dist/src/gatedSigner.d.ts"
     }
   },
   "devDependencies": {

package/dist/src/gatedSigner.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/gatedSigner';
+//# sourceMappingURL=gatedSigner.d.ts.map

package/dist/src/gatedSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatedSigner.d.ts","sourceRoot":"","sources":["../../src/gatedSigner.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/src/gatedSigner.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/gatedSigner"), exports);
+//# sourceMappingURL=gatedSigner.js.map

package/dist/src/gatedSigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatedSigner.js","sourceRoot":"","sources":["../../src/gatedSigner.ts"],"names":[],"mappings":";;;AAAA,4DAAkC"}

package/dist/src/lib/abilityHelpers/gasSponsorship/get-alchemy-chain-config.js

@@ -51,7 +51,7 @@ function getAlchemyChainConfig(chainId) {
         infra_1.riseTestnet,
         infra_1.storyMainnet,
         infra_1.storyAeneid,
-        infra_1.celoAlfajores,
+        infra_1.celoSepolia,
         infra_1.celoMainnet,
         infra_1.teaSepolia,
         infra_1.bobaSepolia,

package/dist/src/lib/abilityHelpers/gasSponsorship/get-alchemy-chain-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-alchemy-chain-config.js","sourceRoot":"","sources":["../../../../../src/lib/abilityHelpers/gasSponsorship/get-alchemy-chain-config.ts"],"names":[],"mappings":";;AAsDA,sDA6DC;AAnHD,8CA8C4B;AAE5B;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,uCAAuC;IACvC,MAAM,eAAe,GAAG;QACtB,gBAAQ;QACR,sBAAc;QACd,oBAAY;QACZ,uBAAe;QACf,YAAI;QACJ,kBAAU;QACV,mBAAW;QACX,eAAO;QACP,sBAAc;QACd,cAAM;QACN,eAAO;QACP,gBAAQ;QACR,sBAAc;QACd,uBAAe;QACf,eAAO;QACP,mBAAW;QACX,qBAAa;QACb,eAAO;QACP,aAAK;QACL,oBAAY;QACZ,kBAAU;QACV,yBAAiB;QACjB,YAAI;QACJ,mBAAW;QACX,uBAAe;QACf,oBAAY;QACZ,oBAAY;QACZ,qBAAa;QACb,sBAAc;QACd,uBAAe;QACf,uBAAe;QACf,kBAAU;QACV,kBAAU;QACV,cAAM;QACN,oBAAY;QACZ,uBAAe;QACf,qBAAa;QACb,mBAAW;QACX,oBAAY;QACZ,mBAAW;QACX,qBAAa;QACb,mBAAW;QACX,kBAAU;QACV,mBAAW;QACX,mBAAW;KACZ,CAAC;IAEF,oDAAoD;IACpD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,wCAAwC;YACzD,wBAAwB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"get-alchemy-chain-config.js","sourceRoot":"","sources":["../../../../../src/lib/abilityHelpers/gasSponsorship/get-alchemy-chain-config.ts"],"names":[],"mappings":";;AAsDA,sDA6DC;AAnHD,8CA8C4B;AAE5B;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,uCAAuC;IACvC,MAAM,eAAe,GAAG;QACtB,gBAAQ;QACR,sBAAc;QACd,oBAAY;QACZ,uBAAe;QACf,YAAI;QACJ,kBAAU;QACV,mBAAW;QACX,eAAO;QACP,sBAAc;QACd,cAAM;QACN,eAAO;QACP,gBAAQ;QACR,sBAAc;QACd,uBAAe;QACf,eAAO;QACP,mBAAW;QACX,qBAAa;QACb,eAAO;QACP,aAAK;QACL,oBAAY;QACZ,kBAAU;QACV,yBAAiB;QACjB,YAAI;QACJ,mBAAW;QACX,uBAAe;QACf,oBAAY;QACZ,oBAAY;QACZ,qBAAa;QACb,sBAAc;QACd,uBAAe;QACf,uBAAe;QACf,kBAAU;QACV,kBAAU;QACV,cAAM;QACN,oBAAY;QACZ,uBAAe;QACf,qBAAa;QACb,mBAAW;QACX,oBAAY;QACZ,mBAAW;QACX,mBAAW;QACX,mBAAW;QACX,kBAAU;QACV,mBAAW;QACX,mBAAW;KACZ,CAAC;IAEF,oDAAoD;IACpD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,wCAAwC;YACzD,wBAAwB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/lib/gatedSigner/helpers/eip712.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const eip712ParamsSchema: z.ZodObject<{
+    domain: z.ZodRecord<z.ZodString, z.ZodAny>;
+    types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+    }, {
+        type: string;
+        name: string;
+    }>, "many">>;
+    primaryType: z.ZodString;
+    message: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>, Record<string, string | Record<string, any>>, Record<string, string | Record<string, any>>>;
+}, "strip", z.ZodTypeAny, {
+    message: Record<string, string | Record<string, any>>;
+    domain: Record<string, any>;
+    types: Record<string, {
+        type: string;
+        name: string;
+    }[]>;
+    primaryType: string;
+}, {
+    message: Record<string, string | Record<string, any>>;
+    domain: Record<string, any>;
+    types: Record<string, {
+        type: string;
+        name: string;
+    }[]>;
+    primaryType: string;
+}>;
+export type Eip712Params = z.infer<typeof eip712ParamsSchema>;
+//# sourceMappingURL=eip712.d.ts.map

package/dist/src/lib/gatedSigner/helpers/eip712.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip712.d.ts","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/eip712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/src/lib/gatedSigner/helpers/eip712.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eip712ParamsSchema = void 0;
+const zod_1 = require("zod");
+exports.eip712ParamsSchema = zod_1.z.object({
+    domain: zod_1.z.record(zod_1.z.any()).describe('EIP-712 domain'),
+    types: zod_1.z
+        .record(zod_1.z.array(zod_1.z.object({ name: zod_1.z.string(), type: zod_1.z.string() })))
+        .describe('EIP-712 types'),
+    primaryType: zod_1.z.string().describe('EIP-712 primary type'),
+    message: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.any())]))
+        .describe('EIP-712 message template. Values must be strings starting with $ that resolve to a valid param (e.g. $userOp.sender, $validUntil).')
+        .refine((data) => {
+        const validateValue = (value) => {
+            if (typeof value === 'string') {
+                return (value.startsWith('$') &&
+                    /^\$(userOp\.(sender|nonce|initCode|callData|callGasLimit|verificationGasLimit|preVerificationGas|maxFeePerGas|maxPriorityFeePerGas|paymasterAndData|signature|factory|factoryData|paymaster|paymasterData|paymasterPostOpGasLimit|paymasterVerificationGasLimit)|entryPointAddress|validAfter|validUntil|safe4337ModuleAddress)$/.test(value));
+            }
+            if (typeof value === 'object' && value !== null) {
+                return Object.values(value).every(validateValue);
+            }
+            return false;
+        };
+        return Object.values(data).every(validateValue);
+    }, {
+        message: 'Invalid message value. Must be a reference string starting with $ (e.g. $userOp.sender) or a nested object containing references.',
+    }),
+});
+//# sourceMappingURL=eip712.js.map

package/dist/src/lib/gatedSigner/helpers/eip712.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip712.js","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/eip712.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACpD,KAAK,EAAE,OAAC;SACL,MAAM,CAAC,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;SACjE,QAAQ,CAAC,eAAe,CAAC;IAC5B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACxD,OAAO,EAAE,OAAC;SACP,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;SACxE,QAAQ,CACP,oIAAoI,CACrI;SACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,aAAa,GAAG,CAAC,KAAU,EAAW,EAAE;YAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;oBACrB,kUAAkU,CAAC,IAAI,CACrU,KAAK,CACN,CACF,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC,EACD;QACE,OAAO,EACL,mIAAmI;KACtI,CACF;CACJ,CAAC,CAAC"}

package/dist/src/lib/gatedSigner/helpers/hex.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const addressSchema: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+export declare const hexSchema: z.ZodType<`0x${string}`, z.ZodTypeDef, `0x${string}`>;
+export declare const hexOfBytesSchema: (bytes: number) => z.ZodType<`0x${string}`, z.ZodTypeDef, `0x${string}`>;
+//# sourceMappingURL=hex.d.ts.map

package/dist/src/lib/gatedSigner/helpers/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/hex.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,kDAItB,CAAC;AAEL,eAAO,MAAM,SAAS,uDAEpB,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,0DAI3C,CAAC"}

package/dist/src/lib/gatedSigner/helpers/hex.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexOfBytesSchema = exports.hexSchema = exports.addressSchema = void 0;
+const viem_1 = require("viem");
+const zod_1 = require("zod");
+exports.addressSchema = zod_1.z
+    .string()
+    .refine((v) => (0, viem_1.isAddress)(v, { strict: false }), {
+    message: 'Invalid Ethereum address',
+});
+exports.hexSchema = zod_1.z.custom((v) => typeof v === 'string' && (0, viem_1.isHex)(v, { strict: true }), {
+    message: 'Invalid hex (must be 0x-prefixed, even length)',
+});
+const hexOfBytesSchema = (bytes) => zod_1.z.custom((v) => typeof v === 'string' && (0, viem_1.isHex)(v, { strict: true }) && (v.length - 2) / 2 === bytes, { message: `Invalid hex (must be 0x + ${bytes} bytes)` });
+exports.hexOfBytesSchema = hexOfBytesSchema;
+//# sourceMappingURL=hex.js.map

package/dist/src/lib/gatedSigner/helpers/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/hex.ts"],"names":[],"mappings":";;;AAEA,+BAAwC;AACxC,6BAAwB;AAEX,QAAA,aAAa,GAAG,OAAC;KAC3B,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,CAAC,EAAgB,EAAE,CAAC,IAAA,gBAAS,EAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;IAC5D,OAAO,EAAE,0BAA0B;CACpC,CAAC,CAAC;AAEQ,QAAA,SAAS,GAAG,OAAC,CAAC,MAAM,CAAM,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAA,YAAK,EAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE;IACjG,OAAO,EAAE,gDAAgD;CAC1D,CAAC,CAAC;AAEI,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,EAAE,CAChD,OAAC,CAAC,MAAM,CACN,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAA,YAAK,EAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,EAC1F,EAAE,OAAO,EAAE,6BAA6B,KAAK,SAAS,EAAE,CACzD,CAAC;AAJS,QAAA,gBAAgB,oBAIzB"}

package/dist/src/lib/gatedSigner/helpers/lifecycleFunctions.d.ts

@@ -0,0 +1,56 @@
+import type { Address } from 'viem';
+import type { z } from 'zod';
+import type { AbilityConfigLifecycleFunction } from '../../abilityCore/abilityConfig/types';
+import type { LowLevelCall } from './lowLevelCall';
+import type { SimulateAssetChangesResponse } from './simulation';
+export interface DecodedTransactionError {
+    kind: 'error';
+    message: string;
+}
+export interface DecodedTransactionSuccess extends Omit<LowLevelCall, 'data'> {
+    args: readonly unknown[] | undefined;
+    kind: string;
+    fn: string;
+}
+export type DecodedTransaction = DecodedTransactionSuccess | DecodedTransactionError;
+interface ValidationBaseParams {
+    chainId: number;
+    sender: Address;
+}
+export interface DecodeTransactionParams {
+    transaction: LowLevelCall;
+}
+export interface ValidateSimulationParams extends ValidationBaseParams {
+    simulation: SimulateAssetChangesResponse;
+}
+export interface ValidateTransactionParams extends ValidationBaseParams {
+    decodedTransaction: DecodedTransaction;
+}
+/**
+ * Interface defining the steps required to implement the lifecycle of a Gated Signer Ability.
+ */
+export interface LifecycleFunctionSteps {
+    /**
+     * Decodes the transaction data into a more usable format.
+     */
+    decodeTransaction: (params: DecodeTransactionParams) => DecodedTransaction;
+    /**
+     * Validates the result of the simulation.
+     * Should throw an error if the simulation result is invalid.
+     * Can be async to support dynamic address fetching.
+     */
+    validateSimulation: (params: ValidateSimulationParams) => void | Promise<void>;
+    /**
+     * Validates the decoded transaction.
+     * Should throw an error if the transaction is invalid.
+     * Can be async to support dynamic address fetching.
+     */
+    validateTransaction: (params: ValidateTransactionParams) => void | Promise<void>;
+}
+interface LifecycleFunctions<AbilityParamsSchema extends z.ZodType, ExecutePolicies, PrecheckPolicies, ExecuteSuccessSchema extends z.ZodType, ExecuteFailSchema extends z.ZodType, PrecheckSuccessSchema extends z.ZodType, PrecheckFailSchema extends z.ZodType> {
+    execute: AbilityConfigLifecycleFunction<AbilityParamsSchema, ExecutePolicies, ExecuteSuccessSchema, ExecuteFailSchema>;
+    precheck: AbilityConfigLifecycleFunction<AbilityParamsSchema, PrecheckPolicies, PrecheckSuccessSchema, PrecheckFailSchema>;
+}
+export declare function buildLifecycleFunctions<AbilityParamsSchema extends z.ZodType, ExecutePolicies, PrecheckPolicies, ExecuteSuccessSchema extends z.ZodType, ExecuteFailSchema extends z.ZodType, PrecheckSuccessSchema extends z.ZodType, PrecheckFailSchema extends z.ZodType>({ decodeTransaction, validateSimulation, validateTransaction, }: LifecycleFunctionSteps): LifecycleFunctions<AbilityParamsSchema, ExecutePolicies, PrecheckPolicies, ExecuteSuccessSchema, ExecuteFailSchema, PrecheckSuccessSchema, PrecheckFailSchema>;
+export {};
+//# sourceMappingURL=lifecycleFunctions.d.ts.map

package/dist/src/lib/gatedSigner/helpers/lifecycleFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleFunctions.d.ts","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/lifecycleFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAO,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAOjE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAC3E,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAErF,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,UAAU,EAAE,4BAA4B,CAAC;CAC1C;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,iBAAiB,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,kBAAkB,CAAC;IAC3E;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,UAAU,kBAAkB,CAC1B,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,eAAe,EACf,gBAAgB,EAChB,oBAAoB,SAAS,CAAC,CAAC,OAAO,EACtC,iBAAiB,SAAS,CAAC,CAAC,OAAO,EACnC,qBAAqB,SAAS,CAAC,CAAC,OAAO,EACvC,kBAAkB,SAAS,CAAC,CAAC,OAAO;IAEpC,OAAO,EAAE,8BAA8B,CACrC,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,CAClB,CAAC;IACF,QAAQ,EAAE,8BAA8B,CACtC,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,CACnB,CAAC;CACH;AAED,wBAAgB,uBAAuB,CACrC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,eAAe,EACf,gBAAgB,EAChB,oBAAoB,SAAS,CAAC,CAAC,OAAO,EACtC,iBAAiB,SAAS,CAAC,CAAC,OAAO,EACnC,qBAAqB,SAAS,CAAC,CAAC,OAAO,EACvC,kBAAkB,SAAS,CAAC,CAAC,OAAO,EACpC,EACA,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,EAAE,sBAAsB,GAAG,kBAAkB,CAC5C,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,CACnB,CAqHA"}

package/dist/src/lib/gatedSigner/helpers/lifecycleFunctions.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLifecycleFunctions = buildLifecycleFunctions;
+const schemas_1 = require("./schemas");
+const signTransaction_1 = require("./signTransaction");
+const signUserOperation_1 = require("./signUserOperation");
+const validation_1 = require("./validation");
+function buildLifecycleFunctions({ decodeTransaction, validateSimulation, validateTransaction, }) {
+    async function assertIsValidOperation(abilityParams) {
+        if ((0, schemas_1.isUserOpAbilityParams)(abilityParams)) {
+            const { alchemyRpcUrl, entryPointAddress, userOp } = abilityParams;
+            const simulationChanges = await (0, validation_1.assertIsValidUserOp)({
+                alchemyRpcUrl,
+                decodeTransaction,
+                entryPointAddress,
+                userOp,
+                validateSimulation,
+                validateTransaction,
+            });
+            return simulationChanges;
+        }
+        if ((0, schemas_1.isTransactionAbilityParams)(abilityParams)) {
+            const { alchemyRpcUrl, transaction } = abilityParams;
+            const simulationChanges = await (0, validation_1.assertIsValidTransaction)({
+                alchemyRpcUrl,
+                decodeTransaction,
+                transaction,
+                validateSimulation,
+                validateTransaction,
+            });
+            return simulationChanges;
+        }
+        throw new Error('Unsupported ability params payload. Must pass transaction or userOp');
+    }
+    const precheck = async ({ abilityParams }, { succeed, fail, delegation: { delegatorPkpInfo } }) => {
+        try {
+            console.log('[@lit-protocol/vincent-gated-signer]');
+            console.log('[@lit-protocol/vincent-gated-signer] params:', {
+                abilityParams,
+            });
+            console.log('[@lit-protocol/vincent-gated-signer] delegator:', {
+                delegatorPkpInfo,
+            });
+            const simulationChanges = await assertIsValidOperation(abilityParams);
+            return succeed({ simulationChanges });
+        }
+        catch (error) {
+            console.error('[@lit-protocol/vincent-gated-signer] Error:', error);
+            return fail({
+                error: `[@lit-protocol/vincent-gated-signer] Precheck failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    };
+    const execute = async ({ abilityParams }, { succeed, fail, delegation: { delegatorPkpInfo } }) => {
+        try {
+            const simulationChanges = await assertIsValidOperation(abilityParams);
+            // Sign user operation
+            const { alchemyRpcUrl, eip712Params, entryPointAddress, safe4337ModuleAddress, transaction, userOp, validAfter, validUntil, } = abilityParams;
+            const signature = (0, schemas_1.isTransactionAbilityParams)(abilityParams)
+                ? await (0, signTransaction_1.signTransaction)({
+                    transaction,
+                    pkpPublicKey: delegatorPkpInfo.publicKey,
+                })
+                : await (0, signUserOperation_1.signUserOperation)({
+                    alchemyRpcUrl,
+                    entryPointAddress,
+                    userOp,
+                    pkpPublicKey: delegatorPkpInfo.publicKey,
+                    validAfter,
+                    validUntil,
+                    safe4337ModuleAddress,
+                    eip712Params,
+                });
+            return succeed({
+                signature,
+                simulationChanges,
+            });
+        }
+        catch (error) {
+            console.error('[@lit-protocol/vincent-gated-signer] Error:', error);
+            return fail({
+                error: `[@lit-protocol/vincent-gated-signer] Execute failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    };
+    return {
+        execute,
+        precheck,
+    };
+}
+//# sourceMappingURL=lifecycleFunctions.js.map

package/dist/src/lib/gatedSigner/helpers/lifecycleFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleFunctions.js","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/lifecycleFunctions.ts"],"names":[],"mappings":";;AAuFA,0DAyIC;AAzND,uCAA8E;AAC9E,uDAAoD;AACpD,2DAAwD;AACxD,6CAA6E;AA6E7E,SAAgB,uBAAuB,CAQrC,EACA,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACI;IASvB,KAAK,UAAU,sBAAsB,CAAC,aAA2C;QAC/E,IAAI,IAAA,+BAAqB,EAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;YAEnE,MAAM,iBAAiB,GAAG,MAAM,IAAA,gCAAmB,EAAC;gBAClD,aAAa;gBACb,iBAAiB;gBACjB,iBAAiB;gBACjB,MAAM;gBACN,kBAAkB;gBAClB,mBAAmB;aACpB,CAAC,CAAC;YAEH,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAED,IAAI,IAAA,oCAA0B,EAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;YAErD,MAAM,iBAAiB,GAAG,MAAM,IAAA,qCAAwB,EAAC;gBACvD,aAAa;gBACb,iBAAiB;gBACjB,WAAW;gBACX,kBAAkB;gBAClB,mBAAmB;aACpB,CAAC,CAAC;YAEH,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,QAAQ,GAKV,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,8CAA8C,EAAE;gBAC1D,aAAa;aACd,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;gBAC7D,gBAAgB;aACjB,CAAC,CAAC;YAEH,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;YAEtE,OAAO,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;gBACV,KAAK,EAAE,yDACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAC3C,EAAE;aACH,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAKT,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;YAEtE,sBAAsB;YACtB,MAAM,EACJ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,MAAM,EACN,UAAU,EACV,UAAU,GACX,GAAG,aAAa,CAAC;YAElB,MAAM,SAAS,GAAG,IAAA,oCAA0B,EAAC,aAAa,CAAC;gBACzD,CAAC,CAAC,MAAM,IAAA,iCAAe,EAAC;oBACpB,WAAW;oBACX,YAAY,EAAE,gBAAgB,CAAC,SAAgB;iBAChD,CAAC;gBACJ,CAAC,CAAC,MAAM,IAAA,qCAAiB,EAAC;oBACtB,aAAa;oBACb,iBAAiB;oBACjB,MAAM;oBACN,YAAY,EAAE,gBAAgB,CAAC,SAAgB;oBAC/C,UAAU;oBACV,UAAU;oBACV,qBAAqB;oBACrB,YAAY;iBACb,CAAC,CAAC;YAEP,OAAO,OAAO,CAAC;gBACb,SAAS;gBACT,iBAAiB;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;gBACV,KAAK,EAAE,wDACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAC3C,EAAE;aACH,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/src/lib/gatedSigner/helpers/lowLevelCall.d.ts

@@ -0,0 +1,13 @@
+import type { Address, Hex } from 'viem';
+import type { UserOp } from './userOperation';
+export interface LowLevelCall {
+    to: Address;
+    value: bigint;
+    data: Hex;
+}
+export interface DecodedFunctionCall<Args = unknown[] | null> {
+    functionName: string;
+    args: Args;
+}
+export declare const getUserOpCalls: (userOp: UserOp) => LowLevelCall[];
+//# sourceMappingURL=lowLevelCall.d.ts.map

package/dist/src/lib/gatedSigner/helpers/lowLevelCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowLevelCall.d.ts","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/lowLevelCall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,mBAAmB,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,YAAY,EAiB3D,CAAC"}

package/dist/src/lib/gatedSigner/helpers/lowLevelCall.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserOpCalls = void 0;
+const kernel_1 = require("./smartAccounts/kernel");
+const safe_1 = require("./smartAccounts/safe");
+const getUserOpCalls = (userOp) => {
+    const callData = userOp.callData;
+    const kernelCalls = (0, kernel_1.tryDecodeKernelCalldataToLowLevelCalls)(callData);
+    const safeCalls = (0, safe_1.tryDecodeSafeCalldataToLowLevelCalls)(callData);
+    const decodedLowLevelCalls = [kernelCalls, safeCalls].filter(Boolean);
+    if (decodedLowLevelCalls.length > 1) {
+        throw new Error('Multiple decodings found');
+    }
+    else if (!decodedLowLevelCalls.length) {
+        throw new Error('Unsupported callData shape');
+    }
+    // Length is 1, we are good
+    return decodedLowLevelCalls[0];
+};
+exports.getUserOpCalls = getUserOpCalls;
+//# sourceMappingURL=lowLevelCall.js.map

package/dist/src/lib/gatedSigner/helpers/lowLevelCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowLevelCall.js","sourceRoot":"","sources":["../../../../../src/lib/gatedSigner/helpers/lowLevelCall.ts"],"names":[],"mappings":";;;AAIA,mDAAgF;AAChF,+CAA4E;AAarE,MAAM,cAAc,GAAG,CAAC,MAAc,EAAkB,EAAE;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEjC,MAAM,WAAW,GAAG,IAAA,+CAAsC,EAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,IAAA,2CAAoC,EAAC,QAAQ,CAAC,CAAC;IAEjE,MAAM,oBAAoB,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,MAAM,CAC1D,OAAO,CACuB,CAAC;IACjC,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,2BAA2B;IAC3B,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC,CAAC;AAjBW,QAAA,cAAc,kBAiBzB"}