@lit-protocol/vincent-e2e-test-utils 1.2.1 → 2.0.1

package/CHANGELOG.md

@@ -1,14 +1,32 @@
-## 1.2.1 (2025-12-10)
+## 2.0.1 (2026-01-08)
 
-### 🩹 Fixes
+### 🧱 Updated Dependencies
 
-- Fix published package to include smart account functionality that was missing from the 1.2.0 release build. ([f327df67](https://github.com/LIT-Protocol/Vincent/commit/f327df67))
+- Updated contracts-sdk to 7.0.0
 
-## 1.2.0 (2025-12-09)
+# 2.0.0 (2026-01-07)
 
 ### 🚀 Features
 
-- Adds a `smartAccountType` parameter to the `setupVincentDevelopmentEnvironment`. Supports `safe`, `crossmint` and `zerodev` smart accounts. When the parameter is set, the development environment will create a Smart Account owned by the `agentWalletOwner` (currently owns the Agent PKP for development). It will then add the Agent PKP as a signer on the Smart Account. ([fe037134](https://github.com/LIT-Protocol/Vincent/commit/fe037134))
+- 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.
+
+- Adds a `enableSmartAccount` flag to the `setupVincentDevelopmentEnvironment`. Supports `safe`, `crossmint` and `zerodev` smart accounts. When the flag is set, the development environment will create a Smart Account owned by the `agentWalletOwner` (currently owns the Agent PKP for development). It will then add the Agent PKP as a signer on the Smart Account. ([77fe226d](https://github.com/LIT-Protocol/Vincent/commit/77fe226d))
+
+### ⚠️ Breaking Changes
+
+- Refactors dev environment to so that the dev EOA mints a Platforum User PKP which mints and owns an Agent PKP for each Vincent App ([d723a4ca](https://github.com/LIT-Protocol/Vincent/commit/d723a4ca))
+
+### 🧱 Updated Dependencies
+
+- Updated contracts-sdk to 6.0.0
+
+### ❤️ Thank You
+
+- awisniew207 @awisniew207
+- Wyatt Barnes @spacesailor24
 
 ## 1.1.3 (2025-11-23)
 

package/dist/CHANGELOG.md

@@ -0,0 +1,59 @@
+# 2.0.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.
+
+- Adds a `enableSmartAccount` flag to the `setupVincentDevelopmentEnvironment`. Supports `safe`, `crossmint` and `zerodev` smart accounts. When the flag is set, the development environment will create a Smart Account owned by the `agentWalletOwner` (currently owns the Agent PKP for development). It will then add the Agent PKP as a signer on the Smart Account. ([77fe226d](https://github.com/LIT-Protocol/Vincent/commit/77fe226d))
+
+### ⚠️ Breaking Changes
+
+- Refactors dev environment to so that the dev EOA mints a Platforum User PKP which mints and owns an Agent PKP for each Vincent App ([d723a4ca](https://github.com/LIT-Protocol/Vincent/commit/d723a4ca))
+
+### 🧱 Updated Dependencies
+
+- Updated contracts-sdk to 6.0.0
+
+### ❤️ Thank You
+
+- awisniew207 @awisniew207
+- Wyatt Barnes @spacesailor24
+
+## 1.1.3 (2025-11-23)
+
+### 🧱 Updated Dependencies
+
+- Updated contracts-sdk to 5.0.0
+
+## 1.1.0 (2025-11-07)
+
+### 🚀 Features
+
+- Adds a `setupVincentDevelopmentEnvironment` function to streamline/abstract the developer experience. ([4ddce811](https://github.com/LIT-Protocol/Vincent/commit/4ddce811))
+
+### ❤️ Thank You
+
+- awisniew207 @awisniew207
+
+# 1.0.0 (2025-11-06)
+
+### 🚀 Features
+
+- Add logic to registerNewAppVersion to avoid registering a new App version if the given Ability and Policy config matches the latest App version. Add logic to permitAppVersionForAgentWalletPkp to avoid permitting the App version if it's already been permitted. ([bbc0b752](https://github.com/LIT-Protocol/Vincent/commit/bbc0b752))
+
+### ⚠️ Breaking Changes
+
+- Initial release of Vincent E2E test util methods taken from the Vincent Ability Start Kit repo ([65b0a4a6](https://github.com/LIT-Protocol/Vincent/commit/65b0a4a6))
+
+### ❤️ Thank You
+
+- Wyatt Barnes @spacesailor24
+
+# Changelog
+
+## 0.1.0
+
+Initial release of @lit-protocol/vincent-e2e-test-utils package.

package/dist/README.md

@@ -0,0 +1,59 @@
+E2E test utilities for the Vincent protocol, providing helper functions for setting up test environments, managing wallets, minting PKPs, and handling permissions.
+
+## Installation
+
+<CodeGroup>
+
+```bash npm
+npm install @lit-protocol/vincent-e2e-test-utils
+```
+
+```bash yarn
+yarn add @lit-protocol/vincent-e2e-test-utils
+```
+
+```bash pnpm
+pnpm add @lit-protocol/vincent-e2e-test-utils
+```
+
+</CodeGroup>
+
+## Features
+
+- **Quick Environment Setup**: `setupVincentDevelopmentEnvironment()` handles all the boilerplate for setting up a complete Vincent test environment
+- **Wallet Management**: Create random wallets and manage test accounts with automatic funding
+- **PKP Management**: Mint new PKPs and configure permissions
+- **Capacity Token Handling**: Ensure unexpired capacity tokens for testing
+- **Chain Helpers**: Access pre-configured providers and wallets for different networks
+
+## Quick Start
+
+The easiest way to get started is with `setupVincentDevelopmentEnvironment()`:
+
+```typescript
+import { setupVincentDevelopmentEnvironment } from '@lit-protocol/vincent-e2e-test-utils';
+
+// Define your abilities and policies
+const permissionData = {
+  [myAbility.ipfsCid]: {
+    [myPolicy.ipfsCid]: {
+      // policy configuration
+    },
+  },
+};
+
+// Set up everything with one call
+const { agentPkpInfo, wallets, appId, appVersion } = await setupVincentDevelopmentEnvironment({
+  permissionData,
+});
+
+// Now you're ready to test!
+```
+
+This single function:
+
+- Checks and funds all required accounts (funder, app delegatee, app manager)
+- Registers or updates your app with abilities and policies
+- Creates or uses an existing agent PKP
+- Sets up permissions for the agent PKP
+- Ensures a valid capacity token exists

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lit-protocol/vincent-e2e-test-utils",
-  "version": "1.2.1",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -11,9 +11,13 @@
     "test:safe": "NODE_OPTIONS=--experimental-vm-modules dotenv -e .env jest test/smartAccount/safe.spec.ts"
   },
   "dependencies": {
+    "@lit-protocol/auth-helpers": "^7",
+    "@lit-protocol/constants": "^7",
     "@crossmint/wallets-sdk": "^0.18.7",
-    "@lit-protocol/constants": "^8.0.4",
     "@lit-protocol/contracts-sdk": "^7.2.3",
+    "@lit-protocol/lit-node-client": "^7",
+    "@lit-protocol/pkp-ethers": "^7.3.1",
+    "@lit-protocol/types": "^7",
     "@lit-protocol/vincent-contracts-sdk": "workspace:*",
     "@t3-oss/env-core": "^0.13.8",
     "@zerodev/ecdsa-validator": "^5.4.9",

package/dist/src/index.d.ts

@@ -1,3 +1,3 @@
 export { delegator, delegatee, funder, chain, appManager, mintNewPkp, ensureUnexpiredCapacityToken, getEnv, getChainHelpers, createRandomVincentWallets, setupVincentDevelopmentEnvironment, setupZerodevAccount, setupCrossmintAccount, setupSafeAccount, } from './lib';
-export type { PkpInfo, SmartAccountInfo, VincentDevEnvironment } from './lib';
+export type { PkpInfo, SmartAccountInfo, ZerodevSmartAccountInfo, CrossmintSmartAccountInfo, SafeSmartAccountInfo, VincentDevEnvironment, } from './lib';
 //# 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,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,UAAU,EACV,UAAU,EACV,4BAA4B,EAC5B,MAAM,EACN,eAAe,EACf,0BAA0B,EAC1B,kCAAkC,EAClC,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,UAAU,EACV,UAAU,EACV,4BAA4B,EAC5B,MAAM,EACN,eAAe,EACf,0BAA0B,EAC1B,kCAAkC,EAClC,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAEf,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,OAAO,CAAC"}

package/dist/src/lib/chain.d.ts

@@ -2,13 +2,12 @@ import { ethers, Wallet } from 'ethers';
 export declare const getChainHelpers: () => Promise<{
     providers: {
         yellowstone: ethers.providers.JsonRpcProvider;
-        base: ethers.providers.JsonRpcProvider;
     };
     wallets: {
         appDelegatee: Wallet;
         funder: Wallet;
         appManager: Wallet;
-        agentWalletOwner: Wallet;
+        platformUserWalletOwner: Wallet;
     };
 }>;
 //# sourceMappingURL=chain.d.ts.map

package/dist/src/lib/chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../src/lib/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAoBxC,eAAO,MAAM,eAAe;eAff;QACT,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;KACxC;aACQ;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;EAqCF,CAAC"}
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../src/lib/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAmBxC,eAAO,MAAM,eAAe;eAdf;QACT,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;KAC/C;aACQ;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,uBAAuB,EAAE,MAAM,CAAC;KACjC;EAqCF,CAAC"}

package/dist/src/lib/chain.js

@@ -11,19 +11,17 @@ const getChainHelpers = async () => {
     if (ethersHelpers) {
         return ethersHelpers;
     }
-    const { YELLOWSTONE_RPC_URL, BASE_RPC_URL, TEST_FUNDER_PRIVATE_KEY, TEST_APP_MANAGER_PRIVATE_KEY, TEST_APP_DELEGATEE_PRIVATE_KEY, TEST_AGENT_WALLET_PKP_OWNER_PRIVATE_KEY, } = (0, env_1.getEnv)();
+    const { YELLOWSTONE_RPC_URL, TEST_FUNDER_PRIVATE_KEY, TEST_APP_MANAGER_PRIVATE_KEY, TEST_APP_DELEGATEE_PRIVATE_KEY, TEST_AGENT_WALLET_PKP_OWNER_PRIVATE_KEY, } = (0, env_1.getEnv)();
     const yellowstoneProvider = new ethers_1.ethers.providers.JsonRpcProvider(YELLOWSTONE_RPC_URL);
-    const baseProvider = new ethers_1.ethers.providers.JsonRpcProvider(BASE_RPC_URL);
     ethersHelpers = {
         providers: {
             yellowstone: yellowstoneProvider,
-            base: baseProvider,
         },
         wallets: {
             appDelegatee: new ethers_1.Wallet(TEST_APP_DELEGATEE_PRIVATE_KEY, yellowstoneProvider),
             funder: new ethers_1.Wallet(TEST_FUNDER_PRIVATE_KEY, yellowstoneProvider),
             appManager: new ethers_1.Wallet(TEST_APP_MANAGER_PRIVATE_KEY, yellowstoneProvider),
-            agentWalletOwner: new ethers_1.Wallet(TEST_AGENT_WALLET_PKP_OWNER_PRIVATE_KEY, yellowstoneProvider),
+            platformUserWalletOwner: new ethers_1.Wallet(TEST_AGENT_WALLET_PKP_OWNER_PRIVATE_KEY, yellowstoneProvider),
         },
     };
     return ethersHelpers;

package/dist/src/lib/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../src/lib/chain.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAExC,+BAA+B;AAE/B,IAAI,aAWH,CAAC;AAEF,kGAAkG;AAClG,wGAAwG;AACxG,iIAAiI;AAC1H,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;IACxC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,EACJ,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,uCAAuC,GACxC,GAAG,IAAA,YAAM,GAAE,CAAC;IAEb,MAAM,mBAAmB,GAAG,IAAI,eAAM,CAAC,SAAS,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACtF,MAAM,YAAY,GAAG,IAAI,eAAM,CAAC,SAAS,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAExE,aAAa,GAAG;QACd,SAAS,EAAE;YACT,WAAW,EAAE,mBAAmB;YAChC,IAAI,EAAE,YAAY;SACnB;QACD,OAAO,EAAE;YACP,YAAY,EAAE,IAAI,eAAM,CAAC,8BAA8B,EAAE,mBAAmB,CAAC;YAC7E,MAAM,EAAE,IAAI,eAAM,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;YAChE,UAAU,EAAE,IAAI,eAAM,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;YACzE,gBAAgB,EAAE,IAAI,eAAM,CAAC,uCAAuC,EAAE,mBAAmB,CAAC;SAC3F;KACF,CAAC;IAEF,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AA/BW,QAAA,eAAe,mBA+B1B"}
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../src/lib/chain.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAExC,+BAA+B;AAE/B,IAAI,aAUH,CAAC;AAEF,kGAAkG;AAClG,wGAAwG;AACxG,iIAAiI;AAC1H,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;IACxC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,EACJ,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,uCAAuC,GACxC,GAAG,IAAA,YAAM,GAAE,CAAC;IAEb,MAAM,mBAAmB,GAAG,IAAI,eAAM,CAAC,SAAS,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;IAEtF,aAAa,GAAG;QACd,SAAS,EAAE;YACT,WAAW,EAAE,mBAAmB;SACjC;QACD,OAAO,EAAE;YACP,YAAY,EAAE,IAAI,eAAM,CAAC,8BAA8B,EAAE,mBAAmB,CAAC;YAC7E,MAAM,EAAE,IAAI,eAAM,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;YAChE,UAAU,EAAE,IAAI,eAAM,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;YACzE,uBAAuB,EAAE,IAAI,eAAM,CACjC,uCAAuC,EACvC,mBAAmB,CACpB;SACF;KACF,CAAC;IAEF,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AA/BW,QAAA,eAAe,mBA+B1B"}

package/dist/src/lib/create-random-vincent-wallets.d.ts

@@ -2,6 +2,6 @@ import { Wallet } from 'ethers';
 export declare function createRandomVincentWallets(): {
     appDelegatee: Wallet;
     appManager: Wallet;
-    agentWalletOwner: Wallet;
+    platformUserWalletOwner: Wallet;
 };
 //# sourceMappingURL=create-random-vincent-wallets.d.ts.map

package/dist/src/lib/create-random-vincent-wallets.js

@@ -6,7 +6,7 @@ function createRandomVincentWallets() {
     return {
         appDelegatee: ethers_1.Wallet.createRandom(),
         appManager: ethers_1.Wallet.createRandom(),
-        agentWalletOwner: ethers_1.Wallet.createRandom(),
+        platformUserWalletOwner: ethers_1.Wallet.createRandom(),
     };
 }
 //# sourceMappingURL=create-random-vincent-wallets.js.map

package/dist/src/lib/create-random-vincent-wallets.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-random-vincent-wallets.js","sourceRoot":"","sources":["../../../src/lib/create-random-vincent-wallets.ts"],"names":[],"mappings":";;AAEA,gEAMC;AARD,mCAAgC;AAEhC,SAAgB,0BAA0B;IACxC,OAAO;QACL,YAAY,EAAE,eAAM,CAAC,YAAY,EAAE;QACnC,UAAU,EAAE,eAAM,CAAC,YAAY,EAAE;QACjC,gBAAgB,EAAE,eAAM,CAAC,YAAY,EAAE;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-random-vincent-wallets.js","sourceRoot":"","sources":["../../../src/lib/create-random-vincent-wallets.ts"],"names":[],"mappings":";;AAEA,gEAMC;AARD,mCAAgC;AAEhC,SAAgB,0BAA0B;IACxC,OAAO;QACL,YAAY,EAAE,eAAM,CAAC,YAAY,EAAE;QACnC,UAAU,EAAE,eAAM,CAAC,YAAY,EAAE;QACjC,uBAAuB,EAAE,eAAM,CAAC,YAAY,EAAE;KAC/C,CAAC;AACJ,CAAC"}

package/dist/src/lib/delegator/add-permission-for-abilities.d.ts

@@ -1,3 +1,4 @@
 import type { Wallet } from 'ethers';
-export declare const addPermissionForAbilities: (wallet: Wallet, pkpTokenId: string, abilityIpfsCids: string[]) => Promise<void>;
+import type { PKPEthersWallet } from '@lit-protocol/pkp-ethers';
+export declare const addPermissionForAbilities: (wallet: Wallet | PKPEthersWallet, pkpTokenId: string, abilityIpfsCids: string[]) => Promise<void>;
 //# sourceMappingURL=add-permission-for-abilities.d.ts.map

package/dist/src/lib/delegator/add-permission-for-abilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-permission-for-abilities.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/add-permission-for-abilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQrC,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,iBAAiB,MAAM,EAAE,kBAe1B,CAAC"}
+{"version":3,"file":"add-permission-for-abilities.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/add-permission-for-abilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAShE,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,GAAG,eAAe,EAChC,YAAY,MAAM,EAClB,iBAAiB,MAAM,EAAE,kBAe1B,CAAC"}

package/dist/src/lib/delegator/add-permission-for-abilities.js

@@ -3,12 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addPermissionForAbilities = void 0;
 const constants_1 = require("@lit-protocol/constants");
 const get_lit_contract_client_1 = require("../litContractsClient/get-lit-contract-client");
-// The LIT network requires that abilities be permitted for the agent PKP to sign on behalf of the user's agent PKP.
-// This is part of the PKP ecosystem and is managed independently of the Vincent Delegation contract
+// The LIT network requires that abilities be permitted for the Agent PKP to execute Lit Actions.
+// This is part of the PKP ecosystem and is managed independently of the Vincent Delegation contract.
+// The Platform User PKP wallet is used to add these permissions to the Agent PKP.
 const addPermissionForAbilities = async (wallet, pkpTokenId, abilityIpfsCids) => {
     const litContractClient = await (0, get_lit_contract_client_1.getLitContractsClient)({ wallet });
     for (const ipfsCid of abilityIpfsCids) {
-        console.log(`Permitting ability: ${ipfsCid} with ability to sign on behalf of user's agent PKP ${pkpTokenId}`);
+        console.log(`Permitting ability: ${ipfsCid} with ability to sign on behalf of Agent PKP ${pkpTokenId}`);
         await litContractClient.addPermittedAction({
             pkpTokenId,
             ipfsId: ipfsCid,

package/dist/src/lib/delegator/add-permission-for-abilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-permission-for-abilities.js","sourceRoot":"","sources":["../../../../src/lib/delegator/add-permission-for-abilities.ts"],"names":[],"mappings":";;;AAEA,uDAA4D;AAE5D,2FAAsF;AAEtF,oHAAoH;AACpH,oGAAoG;AAC7F,MAAM,yBAAyB,GAAG,KAAK,EAC5C,MAAc,EACd,UAAkB,EAClB,eAAyB,EACzB,EAAE;IACF,MAAM,iBAAiB,GAAG,MAAM,IAAA,+CAAqB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAElE,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CACT,uBAAuB,OAAO,uDAAuD,UAAU,EAAE,CAClG,CAAC;QAEF,MAAM,iBAAiB,CAAC,kBAAkB,CAAC;YACzC,UAAU;YACV,MAAM,EAAE,OAAO;YACf,gBAAgB,EAAE,CAAC,6BAAiB,CAAC,YAAY,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAlBW,QAAA,yBAAyB,6BAkBpC"}
+{"version":3,"file":"add-permission-for-abilities.js","sourceRoot":"","sources":["../../../../src/lib/delegator/add-permission-for-abilities.ts"],"names":[],"mappings":";;;AAIA,uDAA4D;AAE5D,2FAAsF;AAEtF,iGAAiG;AACjG,qGAAqG;AACrG,kFAAkF;AAC3E,MAAM,yBAAyB,GAAG,KAAK,EAC5C,MAAgC,EAChC,UAAkB,EAClB,eAAyB,EACzB,EAAE;IACF,MAAM,iBAAiB,GAAG,MAAM,IAAA,+CAAqB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAElE,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CACT,uBAAuB,OAAO,gDAAgD,UAAU,EAAE,CAC3F,CAAC;QAEF,MAAM,iBAAiB,CAAC,kBAAkB,CAAC;YACzC,UAAU;YACV,MAAM,EAAE,OAAO;YACf,gBAAgB,EAAE,CAAC,6BAAiB,CAAC,YAAY,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAlBW,QAAA,yBAAyB,6BAkBpC"}

package/dist/src/lib/delegator/agent-pkp.d.ts

@@ -1,5 +1,20 @@
 import type { PkpInfo } from '../mint-new-pkp';
-export declare const ensureAgentPkpExists: () => Promise<PkpInfo>;
-export declare const ensureFundedAgentPkpExists: () => Promise<PkpInfo>;
-export declare const getFundedAgentPkp: () => Promise<PkpInfo>;
+/**
+ * Get an existing Agent PKP for a specific app ID, or mint a new one if none exists.
+ * The Agent PKP will be owned by the User Platform PKP.
+ * This function queries all Agent PKPs owned by the User Platform PKP and finds the one
+ * that has permissions for the specified app ID.
+ * @param appId the app ID to get or create an Agent PKP for
+ * @returns the Agent PKP info for the specified app
+ */
+export declare const ensureAgentPkpExists: (appId: number) => Promise<PkpInfo>;
+export declare const ensureFundedAgentPkpExists: (appId: number) => Promise<PkpInfo>;
+/**
+ * Returns Agent PKP info for a specific app for this run.
+ * This method will mint a new Agent PKP if none exists for the specified app.
+ * This method will also fund the Agent PKP if it is not already funded.
+ * @param appId the app ID to get a funded Agent PKP for
+ * @returns the funded Agent PKP info for the specified app
+ */
+export declare const getFundedAgentPkp: (appId: number) => Promise<PkpInfo>;
 //# sourceMappingURL=agent-pkp.d.ts.map

package/dist/src/lib/delegator/agent-pkp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-pkp.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/agent-pkp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,eAAO,MAAM,oBAAoB,QAAa,OAAO,CAAC,OAAO,CAkC5D,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAa,OAAO,CAAC,OAAO,CAMlE,CAAC;AAOF,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,OAAO,CAMzD,CAAC"}
+{"version":3,"file":"agent-pkp.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/agent-pkp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAS/C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CA6EzE,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAM/E,CAAC;AAKF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAWtE,CAAC"}

package/dist/src/lib/delegator/agent-pkp.js

@@ -1,45 +1,96 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFundedAgentPkp = exports.ensureFundedAgentPkpExists = exports.ensureAgentPkpExists = void 0;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
 const chain_1 = require("../chain");
 const ensure_wallet_has_test_tokens_1 = require("../funder/ensure-wallet-has-test-tokens");
 const get_lit_contract_client_1 = require("../litContractsClient/get-lit-contract-client");
 const mint_new_pkp_1 = require("../mint-new-pkp");
-// Get an existing, or mint a new one if there is no existing, agent PKP using the agent wallet owner's address
-const ensureAgentPkpExists = async () => {
-    const { wallets: { agentWalletOwner }, } = await (0, chain_1.getChainHelpers)();
-    const litContractClient = await (0, get_lit_contract_client_1.getLitContractsClient)({ wallet: agentWalletOwner });
-    const ownedPkps = await litContractClient.pkpNftContractUtils.read.getTokensInfoByAddress(agentWalletOwner.address);
-    if (ownedPkps.length > 1) {
-        console.warn('> 1 PKP found for agent wallet owner. When e2e testing, we recommend that you use a _dedicated agent wallet owner account_ which always only has a single agent PKP. Using the first PKP found.', ownedPkps);
-    }
+const get_platform_user_pkp_wallet_1 = require("./get-platform-user-pkp-wallet");
+const platform_user_pkp_1 = require("./platform-user-pkp");
+/**
+ * Get an existing Agent PKP for a specific app ID, or mint a new one if none exists.
+ * The Agent PKP will be owned by the User Platform PKP.
+ * This function queries all Agent PKPs owned by the User Platform PKP and finds the one
+ * that has permissions for the specified app ID.
+ * @param appId the app ID to get or create an Agent PKP for
+ * @returns the Agent PKP info for the specified app
+ */
+const ensureAgentPkpExists = async (appId) => {
+    const { wallets: { platformUserWalletOwner }, } = await (0, chain_1.getChainHelpers)();
+    // Get or create the Platform User PKP first
+    const platformUserPkp = await (0, platform_user_pkp_1.getFundedPlatformUserPkp)();
+    // Get all PKPs owned by the Platform User PKP using Lit Contracts Client
+    const litContractClient = await (0, get_lit_contract_client_1.getLitContractsClient)({ wallet: platformUserWalletOwner });
+    await litContractClient.connect();
+    const ownedPkps = await litContractClient.pkpNftContractUtils.read.getTokensInfoByAddress(platformUserPkp.ethAddress);
+    console.log(`Platform User PKP ${platformUserPkp.ethAddress} owns ${ownedPkps.length} Agent PKP(s)`);
+    // If there are owned PKPs, query their permitted apps to find the one for this app ID
     if (ownedPkps.length > 0) {
-        console.log(`${agentWalletOwner.address} has a PKP -- using existing PKP with ethAddress: ${ownedPkps[0].ethAddress}, tokenId: ${ownedPkps[0].tokenId}`);
-        const { tokenId, ethAddress } = ownedPkps[0];
-        return { tokenId, ethAddress };
+        const client = (0, vincent_contracts_sdk_1.getClient)({ signer: platformUserWalletOwner });
+        // Query all owned PKP addresses to find which one has permission for this app
+        const pkpAddresses = ownedPkps.map((pkp) => pkp.ethAddress);
+        // Get permitted apps for all owned PKPs
+        const permittedAppsData = await client.getPermittedAppsForPkps({
+            pkpEthAddresses: pkpAddresses,
+            offset: '0',
+        });
+        // Find the PKP that has permission for the specified app ID
+        for (const pkpData of permittedAppsData) {
+            const hasAppPermission = pkpData.permittedApps.some((app) => app.appId === appId);
+            if (hasAppPermission) {
+                const matchingPkp = ownedPkps.find((pkp) => pkp.tokenId === pkpData.pkpTokenId);
+                if (matchingPkp) {
+                    console.log(`Found existing Agent PKP for app ${appId} with ethAddress: ${matchingPkp.ethAddress}, tokenId: ${matchingPkp.tokenId}`);
+                    const publicKey = await litContractClient.pkpNftContract.read.getPubkey(matchingPkp.tokenId);
+                    return {
+                        tokenId: matchingPkp.tokenId,
+                        ethAddress: matchingPkp.ethAddress,
+                        publicKey,
+                    };
+                }
+            }
+        }
     }
-    console.log(`No agent PKPs found; minting a new agent PKP for ${agentWalletOwner.address}...`);
-    // Be sure the agentWalletOwner has enough test tokens to mint a new PKP
-    await (0, ensure_wallet_has_test_tokens_1.ensureWalletHasTestTokens)({ address: await agentWalletOwner.getAddress() });
-    const { tokenId, ethAddress } = await (0, mint_new_pkp_1.mintNewPkp)({ wallet: agentWalletOwner });
-    return { tokenId, ethAddress };
+    console.log(`No Agent PKP found for app ${appId}; minting a new Agent PKP owned by Platform User PKP ${platformUserPkp.ethAddress}...`);
+    // Be sure the platformUserPkp has enough test tokens to mint a new PKP
+    await (0, ensure_wallet_has_test_tokens_1.ensureWalletHasTestTokens)({ address: platformUserPkp.ethAddress });
+    // Get PKP Ethers Wallet for the Platform User PKP
+    const platformUserPkpWallet = await (0, get_platform_user_pkp_wallet_1.getPlatformUserPkpWallet)(platformUserPkp);
+    // Mint a new PKP using the Platform User PKP's wallet
+    // This makes the Platform User PKP the owner and controller of the Agent PKP
+    const { tokenId, ethAddress, publicKey } = await (0, mint_new_pkp_1.mintNewPkp)({
+        wallet: platformUserPkpWallet,
+    });
+    console.log(`Minted new Agent PKP ${ethAddress} owned by Platform User PKP ${platformUserPkp.ethAddress}`);
+    return { tokenId, ethAddress, publicKey };
 };
 exports.ensureAgentPkpExists = ensureAgentPkpExists;
-const ensureFundedAgentPkpExists = async () => {
-    const agentPkp = await (0, exports.ensureAgentPkpExists)();
+const ensureFundedAgentPkpExists = async (appId) => {
+    const agentPkp = await (0, exports.ensureAgentPkpExists)(appId);
     await (0, ensure_wallet_has_test_tokens_1.ensureWalletHasTestTokens)({ address: agentPkp.ethAddress });
     return agentPkp;
 };
 exports.ensureFundedAgentPkpExists = ensureFundedAgentPkpExists;
-const agentPkpInfo = null;
-// Returns agent Pkp info for this run.
-// This method will mint a new agent Pkp if none exists for the current agent wallet owner.
-// This method will also fund the agent Pkp if it is not already funded.
-const getFundedAgentPkp = async () => {
-    if (agentPkpInfo) {
-        return agentPkpInfo;
+// Map to store Agent PKPs by app ID for the current run
+const agentPkpsByAppId = new Map();
+/**
+ * Returns Agent PKP info for a specific app for this run.
+ * This method will mint a new Agent PKP if none exists for the specified app.
+ * This method will also fund the Agent PKP if it is not already funded.
+ * @param appId the app ID to get a funded Agent PKP for
+ * @returns the funded Agent PKP info for the specified app
+ */
+const getFundedAgentPkp = async (appId) => {
+    const cached = agentPkpsByAppId.get(appId);
+    if (cached) {
+        // Verify that the cached PKP still has sufficient funds
+        await (0, ensure_wallet_has_test_tokens_1.ensureWalletHasTestTokens)({ address: cached.ethAddress });
+        return cached;
     }
-    return await (0, exports.ensureFundedAgentPkpExists)();
+    const agentPkp = await (0, exports.ensureFundedAgentPkpExists)(appId);
+    agentPkpsByAppId.set(appId, agentPkp);
+    return agentPkp;
 };
 exports.getFundedAgentPkp = getFundedAgentPkp;
 //# sourceMappingURL=agent-pkp.js.map

package/dist/src/lib/delegator/agent-pkp.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-pkp.js","sourceRoot":"","sources":["../../../../src/lib/delegator/agent-pkp.ts"],"names":[],"mappings":";;;AAEA,oCAA2C;AAC3C,2FAAoF;AACpF,2FAAsF;AACtF,kDAA6C;AAE7C,+GAA+G;AACxG,MAAM,oBAAoB,GAAG,KAAK,IAAsB,EAAE;IAC/D,MAAM,EACJ,OAAO,EAAE,EAAE,gBAAgB,EAAE,GAC9B,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,MAAM,iBAAiB,GAAG,MAAM,IAAA,+CAAqB,EAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,sBAAsB,CACvF,gBAAgB,CAAC,OAAO,CACzB,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACV,iMAAiM,EACjM,SAAS,CACV,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,GAAG,gBAAgB,CAAC,OAAO,qDAAqD,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,cAAc,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAC5I,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oDAAoD,gBAAgB,CAAC,OAAO,KAAK,CAAC,CAAC;IAE/F,wEAAwE;IACxE,MAAM,IAAA,yDAAyB,EAAC,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,yBAAU,EAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAE/E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC,CAAC;AAlCW,QAAA,oBAAoB,wBAkC/B;AAEK,MAAM,0BAA0B,GAAG,KAAK,IAAsB,EAAE;IACrE,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAoB,GAAE,CAAC;IAE9C,MAAM,IAAA,yDAAyB,EAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAElE,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AANW,QAAA,0BAA0B,8BAMrC;AAEF,MAAM,YAAY,GAAmB,IAAI,CAAC;AAE1C,uCAAuC;AACvC,2FAA2F;AAC3F,wEAAwE;AACjE,MAAM,iBAAiB,GAAG,KAAK,IAAsB,EAAE;IAC5D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,IAAA,kCAA0B,GAAE,CAAC;AAC5C,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B"}
+{"version":3,"file":"agent-pkp.js","sourceRoot":"","sources":["../../../../src/lib/delegator/agent-pkp.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/delegator/get-platform-user-pkp-wallet.d.ts

@@ -0,0 +1,8 @@
+import { PKPEthersWallet } from '@lit-protocol/pkp-ethers';
+import type { PkpInfo } from '../mint-new-pkp';
+/**
+ * Get a PKPEthersWallet instance for the Platform User PKP
+ * This wallet can be used to sign transactions and mint new PKPs on behalf of the Platform User PKP
+ */
+export declare const getPlatformUserPkpWallet: (platformUserPkpInfo: PkpInfo) => Promise<PKPEthersWallet>;
+//# sourceMappingURL=get-platform-user-pkp-wallet.d.ts.map

package/dist/src/lib/delegator/get-platform-user-pkp-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-platform-user-pkp-wallet.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/get-platform-user-pkp-wallet.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAyB/C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,qBAAqB,OAAO,KAC3B,OAAO,CAAC,eAAe,CAkEzB,CAAC"}

package/dist/src/lib/delegator/get-platform-user-pkp-wallet.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformUserPkpWallet = void 0;
+const auth_helpers_1 = require("@lit-protocol/auth-helpers");
+const constants_1 = require("@lit-protocol/constants");
+const lit_node_client_1 = require("@lit-protocol/lit-node-client");
+const pkp_ethers_1 = require("@lit-protocol/pkp-ethers");
+const chain_1 = require("../chain");
+const get_lit_contract_client_1 = require("../litContractsClient/get-lit-contract-client");
+const SELECTED_LIT_NETWORK = constants_1.LIT_NETWORK.Datil;
+let litNodeClient = null;
+const getLitNodeClient = async () => {
+    if (litNodeClient) {
+        return litNodeClient;
+    }
+    litNodeClient = new lit_node_client_1.LitNodeClient({
+        alertWhenUnauthorized: false,
+        litNetwork: SELECTED_LIT_NETWORK,
+        debug: false,
+    });
+    await litNodeClient.connect();
+    return litNodeClient;
+};
+/**
+ * Get a PKPEthersWallet instance for the Platform User PKP
+ * This wallet can be used to sign transactions and mint new PKPs on behalf of the Platform User PKP
+ */
+const getPlatformUserPkpWallet = async (platformUserPkpInfo) => {
+    const { wallets: { platformUserWalletOwner }, } = await (0, chain_1.getChainHelpers)();
+    const litContractClient = await (0, get_lit_contract_client_1.getLitContractsClient)({ wallet: platformUserWalletOwner });
+    await litContractClient.connect();
+    const client = await getLitNodeClient();
+    // Get the PKP's public key
+    const publicKey = await litContractClient.pkpNftContract.read.getPubkey(platformUserPkpInfo.tokenId);
+    console.log(`Creating PKP Ethers Wallet for Platform User PKP ${platformUserPkpInfo.ethAddress}...`);
+    // Get session signatures for controlling the PKP
+    // The EOA wallet owner signs to prove it has authority to use the PKP
+    const sessionSigs = await client.getSessionSigs({
+        chain: 'ethereum',
+        resourceAbilityRequests: [
+            {
+                resource: new auth_helpers_1.LitPKPResource('*'),
+                ability: constants_1.LIT_ABILITY.PKPSigning,
+            },
+            {
+                resource: new auth_helpers_1.LitActionResource('*'),
+                ability: constants_1.LIT_ABILITY.LitActionExecution,
+            },
+        ],
+        authNeededCallback: async ({ resourceAbilityRequests, uri }) => {
+            const [walletAddress, nonce] = await Promise.all([
+                platformUserWalletOwner.getAddress(),
+                client.getLatestBlockhash(),
+            ]);
+            const toSign = await (0, auth_helpers_1.createSiweMessageWithRecaps)({
+                uri: uri || 'http://localhost:3000',
+                expiration: new Date(Date.now() + 1000 * 60 * 60 * 1).toISOString(), // 1 hour
+                resources: resourceAbilityRequests || [],
+                walletAddress,
+                nonce,
+                litNodeClient: client,
+            });
+            return await (0, auth_helpers_1.generateAuthSig)({ signer: platformUserWalletOwner, toSign });
+        },
+    });
+    // Create PKP Ethers Wallet with RPC provider for proper gas estimation
+    const pkpWallet = new pkp_ethers_1.PKPEthersWallet({
+        litNodeClient: client,
+        pkpPubKey: publicKey,
+        controllerSessionSigs: sessionSigs,
+    });
+    await pkpWallet.init();
+    console.log(`PKP Ethers Wallet initialized for Platform User PKP ${await pkpWallet.getAddress()}`);
+    return pkpWallet;
+};
+exports.getPlatformUserPkpWallet = getPlatformUserPkpWallet;
+//# sourceMappingURL=get-platform-user-pkp-wallet.js.map

package/dist/src/lib/delegator/get-platform-user-pkp-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-platform-user-pkp-wallet.js","sourceRoot":"","sources":["../../../../src/lib/delegator/get-platform-user-pkp-wallet.ts"],"names":[],"mappings":";;;AAEA,6DAKoC;AACpC,uDAAmE;AACnE,mEAA8D;AAC9D,yDAA2D;AAI3D,oCAA2C;AAC3C,2FAAsF;AAEtF,MAAM,oBAAoB,GAAG,uBAAW,CAAC,KAA0B,CAAC;AAEpE,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C,MAAM,gBAAgB,GAAG,KAAK,IAA4B,EAAE;IAC1D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,aAAa,GAAG,IAAI,+BAAa,CAAC;QAChC,qBAAqB,EAAE,KAAK;QAC5B,UAAU,EAAE,oBAAoB;QAChC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;IAE9B,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,wBAAwB,GAAG,KAAK,EAC3C,mBAA4B,EACF,EAAE;IAC5B,MAAM,EACJ,OAAO,EAAE,EAAE,uBAAuB,EAAE,GACrC,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,MAAM,iBAAiB,GAAG,MAAM,IAAA,+CAAqB,EAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC3F,MAAM,iBAAiB,CAAC,OAAO,EAAE,CAAC;IAElC,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAExC,2BAA2B;IAC3B,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CACrE,mBAAmB,CAAC,OAAO,CAC5B,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,oDAAoD,mBAAmB,CAAC,UAAU,KAAK,CACxF,CAAC;IAEF,iDAAiD;IACjD,sEAAsE;IACtE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;QAC9C,KAAK,EAAE,UAAU;QACjB,uBAAuB,EAAE;YACvB;gBACE,QAAQ,EAAE,IAAI,6BAAc,CAAC,GAAG,CAAC;gBACjC,OAAO,EAAE,uBAAW,CAAC,UAAU;aAChC;YACD;gBACE,QAAQ,EAAE,IAAI,gCAAiB,CAAC,GAAG,CAAC;gBACpC,OAAO,EAAE,uBAAW,CAAC,kBAAkB;aACxC;SACF;QACD,kBAAkB,EAAE,KAAK,EAAE,EAAE,uBAAuB,EAAE,GAAG,EAAE,EAAE,EAAE;YAC7D,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,uBAAuB,CAAC,UAAU,EAAE;gBACpC,MAAM,CAAC,kBAAkB,EAAE;aAC5B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAA,0CAA2B,EAAC;gBAC/C,GAAG,EAAE,GAAG,IAAI,uBAAuB;gBACnC,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,SAAS;gBAC9E,SAAS,EAAE,uBAAuB,IAAI,EAAE;gBACxC,aAAa;gBACb,KAAK;gBACL,aAAa,EAAE,MAAM;aACtB,CAAC,CAAC;YAEH,OAAO,MAAM,IAAA,8BAAe,EAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC,CAAC;IAEH,uEAAuE;IACvE,MAAM,SAAS,GAAG,IAAI,4BAAe,CAAC;QACpC,aAAa,EAAE,MAAM;QACrB,SAAS,EAAE,SAAS;QACpB,qBAAqB,EAAE,WAAW;KACnC,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;IAEvB,OAAO,CAAC,GAAG,CACT,uDAAuD,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE,CACtF,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AApEW,QAAA,wBAAwB,4BAoEnC"}

package/dist/src/lib/delegator/index.d.ts

@@ -1,5 +1,7 @@
 export { addPermissionForAbilities } from './add-permission-for-abilities';
 export { mintNewPkp } from '../mint-new-pkp';
 export { getFundedAgentPkp, ensureAgentPkpExists, ensureFundedAgentPkpExists } from './agent-pkp';
+export { getPlatformUserPkpWallet } from './get-platform-user-pkp-wallet';
+export { getFundedPlatformUserPkp, ensurePlatformUserPkpExists, ensureFundedPlatformUserPkpExists, } from './platform-user-pkp';
 export { permitAppVersionForAgentWalletPkp } from './permit-vincent-app-version';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC"}