@lit-protocol/vincent-ability-sdk 2.3.1 → 2.4.0-mma

package/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/README.md

@@ -12,7 +12,7 @@ Run `nx build ability-sdk` to build the library.
 
 This library provides a type-safe lifecycle system for defining and composing **policies** and **abilities**, with strong TypeScript inference support throughout.
 
-## 🧩 Core Concepts
+## Core Concepts
 
 - **Policies** encapsulate decision logic (precheck, evaluate, commit) and define their input/output schemas.
 - **Abilities** orchestrate multiple policies and expose `precheck` and `execute` lifecycle methods.
@@ -21,7 +21,7 @@ This library provides a type-safe lifecycle system for defining and composing **
 
 ---
 
-### 🔁 Calling `commit()` on a Policy from within a Ability
+### Calling `commit()` on a Policy from within a Ability
 
 Policies can define a `commit()` lifecycle method to finalize changes once an ability executes successfully. These `commit()` functions are injected automatically into the `allowedPolicies` object of the `AbilityContext`.
 
@@ -208,6 +208,54 @@ export const myTokenSwapAbility = createVincentAbility({
 });
 ```
 
-## 🧠 Tip
+---
+
+### 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

@@ -12,7 +12,7 @@ Run `nx build ability-sdk` to build the library.
 
 This library provides a type-safe lifecycle system for defining and composing **policies** and **abilities**, with strong TypeScript inference support throughout.
 
-## 🧩 Core Concepts
+## Core Concepts
 
 - **Policies** encapsulate decision logic (precheck, evaluate, commit) and define their input/output schemas.
 - **Abilities** orchestrate multiple policies and expose `precheck` and `execute` lifecycle methods.
@@ -21,7 +21,7 @@ This library provides a type-safe lifecycle system for defining and composing **
 
 ---
 
-### 🔁 Calling `commit()` on a Policy from within a Ability
+### Calling `commit()` on a Policy from within a Ability
 
 Policies can define a `commit()` lifecycle method to finalize changes once an ability executes successfully. These `commit()` functions are injected automatically into the `allowedPolicies` object of the `AbilityContext`.
 
@@ -208,6 +208,54 @@ export const myTokenSwapAbility = createVincentAbility({
 });
 ```
 
-## 🧠 Tip
+---
+
+### 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.1",
+  "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/index.d.ts

@@ -12,5 +12,5 @@ export type { PolicyConfigLifecycleFunction, PolicyConfigCommitFunction, } from
 export type { PolicyContext } from './lib/policyCore/policyConfig/context/types';
 export type { VincentAbilityPolicy, BaseContext, PolicyEvaluationResultContext, VincentAbility, AbilityConsumerContext, PolicyConsumerContext, SchemaValidationError, } from './lib/types';
 export type { BaseAbilityContext } from './lib/abilityCore/abilityConfig/context/types';
-export { populateTransaction, sponsoredGasRawTransaction, sponsoredGasContractCall, } from './lib/abilityHelpers';
+export { populateTransaction, sponsoredGasRawTransaction, sponsoredGasContractCall, ERC20_ABI, bigIntReplacer, } from './lib/abilityHelpers';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AAEpG,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,6BAA6B,EAC7B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAExF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AAEpG,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,6BAA6B,EAC7B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAExF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,SAAS,EACT,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sponsoredGasContractCall = exports.sponsoredGasRawTransaction = exports.populateTransaction = exports.supportedPoliciesForAbility = exports.asBundledVincentPolicy = exports.asBundledVincentAbility = exports.vincentAbilityHandler = exports.vincentPolicyHandler = exports.VINCENT_TOOL_API_VERSION = exports.createVincentAbility = exports.createVincentAbilityPolicy = exports.createVincentPolicy = void 0;
+exports.bigIntReplacer = exports.ERC20_ABI = exports.sponsoredGasContractCall = exports.sponsoredGasRawTransaction = exports.populateTransaction = exports.supportedPoliciesForAbility = exports.asBundledVincentPolicy = exports.asBundledVincentAbility = exports.vincentAbilityHandler = exports.vincentPolicyHandler = exports.VINCENT_TOOL_API_VERSION = exports.createVincentAbility = exports.createVincentAbilityPolicy = exports.createVincentPolicy = void 0;
 var vincentPolicy_1 = require("./lib/policyCore/vincentPolicy");
 Object.defineProperty(exports, "createVincentPolicy", { enumerable: true, get: function () { return vincentPolicy_1.createVincentPolicy; } });
 Object.defineProperty(exports, "createVincentAbilityPolicy", { enumerable: true, get: function () { return vincentPolicy_1.createVincentAbilityPolicy; } });
@@ -22,4 +22,6 @@ var abilityHelpers_1 = require("./lib/abilityHelpers");
 Object.defineProperty(exports, "populateTransaction", { enumerable: true, get: function () { return abilityHelpers_1.populateTransaction; } });
 Object.defineProperty(exports, "sponsoredGasRawTransaction", { enumerable: true, get: function () { return abilityHelpers_1.sponsoredGasRawTransaction; } });
 Object.defineProperty(exports, "sponsoredGasContractCall", { enumerable: true, get: function () { return abilityHelpers_1.sponsoredGasContractCall; } });
+Object.defineProperty(exports, "ERC20_ABI", { enumerable: true, get: function () { return abilityHelpers_1.ERC20_ABI; } });
+Object.defineProperty(exports, "bigIntReplacer", { enumerable: true, get: function () { return abilityHelpers_1.bigIntReplacer; } });
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAiG;AAAxF,oHAAA,mBAAmB,OAAA;AAAE,2HAAA,0BAA0B,OAAA;AACxD,mEAAwE;AAA/D,sHAAA,oBAAoB,OAAA;AAC7B,6CAA2D;AAAlD,qHAAA,wBAAwB,OAAA;AAEjC,4EAA2E;AAAlE,4HAAA,oBAAoB,OAAA;AAC7B,8EAA6E;AAApE,8HAAA,qBAAqB,OAAA;AAE9B,kFAA0F;AAAjF,yHAAA,uBAAuB,OAAA;AAChC,8EAAsF;AAA7E,uHAAA,sBAAsB,OAAA;AAC/B,qGAAoG;AAA3F,0IAAA,2BAA2B,OAAA;AAsBpC,uDAI8B;AAH5B,qHAAA,mBAAmB,OAAA;AACnB,4HAAA,0BAA0B,OAAA;AAC1B,0HAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAiG;AAAxF,oHAAA,mBAAmB,OAAA;AAAE,2HAAA,0BAA0B,OAAA;AACxD,mEAAwE;AAA/D,sHAAA,oBAAoB,OAAA;AAC7B,6CAA2D;AAAlD,qHAAA,wBAAwB,OAAA;AAEjC,4EAA2E;AAAlE,4HAAA,oBAAoB,OAAA;AAC7B,8EAA6E;AAApE,8HAAA,qBAAqB,OAAA;AAE9B,kFAA0F;AAAjF,yHAAA,uBAAuB,OAAA;AAChC,8EAAsF;AAA7E,uHAAA,sBAAsB,OAAA;AAC/B,qGAAoG;AAA3F,0IAAA,2BAA2B,OAAA;AAsBpC,uDAM8B;AAL5B,qHAAA,mBAAmB,OAAA;AACnB,4HAAA,0BAA0B,OAAA;AAC1B,0HAAA,wBAAwB,OAAA;AACxB,2GAAA,SAAS,OAAA;AACT,gHAAA,cAAc,OAAA"}

package/dist/src/lib/abilityHelpers/bigint-replace.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Replace bigint values with strings in JSON.stringify
+ * @param key - The key of the value
+ * @param value - The value to replace
+ * @returns The replaced value
+ */
+export declare const bigIntReplacer: (key: string, value: unknown) => unknown;
+//# sourceMappingURL=bigint-replace.d.ts.map

package/dist/src/lib/abilityHelpers/bigint-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint-replace.d.ts","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/bigint-replace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,OAAO,OAAO,KAAG,OAE5D,CAAC"}

package/dist/src/lib/abilityHelpers/bigint-replace.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bigIntReplacer = void 0;
+/**
+ * Replace bigint values with strings in JSON.stringify
+ * @param key - The key of the value
+ * @param value - The value to replace
+ * @returns The replaced value
+ */
+const bigIntReplacer = (key, value) => {
+    return typeof value === 'bigint' ? value.toString() : value;
+};
+exports.bigIntReplacer = bigIntReplacer;
+//# sourceMappingURL=bigint-replace.js.map

package/dist/src/lib/abilityHelpers/bigint-replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint-replace.js","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/bigint-replace.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,KAAc,EAAW,EAAE;IACrE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}

package/dist/src/lib/abilityHelpers/erc20-abi.d.ts

@@ -0,0 +1,2 @@
+export declare const ERC20_ABI: any[];
+//# sourceMappingURL=erc20-abi.d.ts.map

package/dist/src/lib/abilityHelpers/erc20-abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20-abi.d.ts","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/erc20-abi.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,EAAE,GAAG,EAqH1B,CAAC"}

package/dist/src/lib/abilityHelpers/erc20-abi.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC20_ABI = void 0;
+exports.ERC20_ABI = [
+    {
+        inputs: [],
+        name: 'name',
+        outputs: [{ internalType: 'string', name: '', type: 'string' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'symbol',
+        outputs: [{ internalType: 'string', name: '', type: 'string' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'decimals',
+        outputs: [{ internalType: 'uint8', name: '', type: 'uint8' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'totalSupply',
+        outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [{ internalType: 'address', name: 'account', type: 'address' }],
+        name: 'balanceOf',
+        outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'to', type: 'address' },
+            { internalType: 'uint256', name: 'value', type: 'uint256' },
+        ],
+        name: 'transfer',
+        outputs: [{ internalType: 'bool', name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'owner', type: 'address' },
+            { internalType: 'address', name: 'spender', type: 'address' },
+        ],
+        name: 'allowance',
+        outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'spender', type: 'address' },
+            { internalType: 'uint256', name: 'value', type: 'uint256' },
+        ],
+        name: 'approve',
+        outputs: [{ internalType: 'bool', name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'from', type: 'address' },
+            { internalType: 'address', name: 'to', type: 'address' },
+            { internalType: 'uint256', name: 'value', type: 'uint256' },
+        ],
+        name: 'transferFrom',
+        outputs: [{ internalType: 'bool', name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'spender', type: 'address' },
+            { internalType: 'uint256', name: 'addedValue', type: 'uint256' },
+        ],
+        name: 'increaseAllowance',
+        outputs: [{ internalType: 'bool', name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { internalType: 'address', name: 'spender', type: 'address' },
+            { internalType: 'uint256', name: 'subtractedValue', type: 'uint256' },
+        ],
+        name: 'decreaseAllowance',
+        outputs: [{ internalType: 'bool', name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            { indexed: true, internalType: 'address', name: 'from', type: 'address' },
+            { indexed: true, internalType: 'address', name: 'to', type: 'address' },
+            { indexed: false, internalType: 'uint256', name: 'value', type: 'uint256' },
+        ],
+        name: 'Transfer',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            { indexed: true, internalType: 'address', name: 'owner', type: 'address' },
+            { indexed: true, internalType: 'address', name: 'spender', type: 'address' },
+            { indexed: false, internalType: 'uint256', name: 'value', type: 'uint256' },
+        ],
+        name: 'Approval',
+        type: 'event',
+    },
+];
+//# sourceMappingURL=erc20-abi.js.map

package/dist/src/lib/abilityHelpers/erc20-abi.js.map

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

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/abilityHelpers/index.d.ts

@@ -1,3 +1,5 @@
 export { populateTransaction } from './populateTransaction';
 export { sponsoredGasRawTransaction, sponsoredGasContractCall } from './gasSponsorship';
+export { ERC20_ABI } from './erc20-abi';
+export { bigIntReplacer } from './bigint-replace';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/lib/abilityHelpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/lib/abilityHelpers/index.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sponsoredGasContractCall = exports.sponsoredGasRawTransaction = exports.populateTransaction = void 0;
+exports.bigIntReplacer = exports.ERC20_ABI = exports.sponsoredGasContractCall = exports.sponsoredGasRawTransaction = exports.populateTransaction = void 0;
 var populateTransaction_1 = require("./populateTransaction");
 Object.defineProperty(exports, "populateTransaction", { enumerable: true, get: function () { return populateTransaction_1.populateTransaction; } });
 var gasSponsorship_1 = require("./gasSponsorship");
 Object.defineProperty(exports, "sponsoredGasRawTransaction", { enumerable: true, get: function () { return gasSponsorship_1.sponsoredGasRawTransaction; } });
 Object.defineProperty(exports, "sponsoredGasContractCall", { enumerable: true, get: function () { return gasSponsorship_1.sponsoredGasContractCall; } });
+var erc20_abi_1 = require("./erc20-abi");
+Object.defineProperty(exports, "ERC20_ABI", { enumerable: true, get: function () { return erc20_abi_1.ERC20_ABI; } });
+var bigint_replace_1 = require("./bigint-replace");
+Object.defineProperty(exports, "bigIntReplacer", { enumerable: true, get: function () { return bigint_replace_1.bigIntReplacer; } });
 //# sourceMappingURL=index.js.map

package/dist/src/lib/abilityHelpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/index.ts"],"names":[],"mappings":";;;AAAA,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAwF;AAA/E,4HAAA,0BAA0B,OAAA;AAAE,0HAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/abilityHelpers/index.ts"],"names":[],"mappings":";;;AAAA,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAwF;AAA/E,4HAAA,0BAA0B,OAAA;AAAE,0HAAA,wBAAwB,OAAA;AAC7D,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA"}

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