@lit-protocol/vincent-e2e-test-utils 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# 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/README.md

@@ -0,0 +1,17 @@
+# @lit-protocol/vincent-e2e-test-utils
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build e2e-test-utils` to build the library.
+
+## Usage
+
+This package provides E2E test utilities for the Vincent protocol.
+
+## Development
+
+### Documentation
+
+Documentation is generated using TypeDoc. Build the docs with the appropriate Nx command.

package/dist/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+Initial release of @lit-protocol/vincent-e2e-test-utils package.

package/dist/README.md

@@ -0,0 +1,17 @@
+# @lit-protocol/vincent-e2e-test-utils
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build e2e-test-utils` to build the library.
+
+## Usage
+
+This package provides E2E test utilities for the Vincent protocol.
+
+## Development
+
+### Documentation
+
+Documentation is generated using TypeDoc. Build the docs with the appropriate Nx command.

package/dist/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lit-protocol/vincent-e2e-test-utils",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@lit-protocol/constants": "^8.0.4",
+    "@lit-protocol/contracts-sdk": "^7.2.3",
+    "@lit-protocol/vincent-contracts-sdk": "^2.0.0",
+    "@t3-oss/env-core": "^0.13.8",
+    "ethers": "^5.7.2",
+    "tslib": "^2.8.1",
+    "zod": "^3.25.64"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist/**",
+    "*.md"
+  ],
+  "exports": {
+    ".": {
+      "require": "./dist/src/index.js",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/semver": "^7.7.0",
+    "chokidar-cli": "^3.0.0",
+    "ipfs-only-hash": "^4.0.0",
+    "jsonc-eslint-parser": "^2.4.0",
+    "typedoc": "0.27.9",
+    "typedoc-material-theme": "1.3.0",
+    "typedoc-plugin-extras": "^4.0.0",
+    "typedoc-plugin-zod": "^1.4.1"
+  },
+  "type": "commonjs"
+}

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { delegator, delegatee, funder, chain, appManager, mintNewPkp, ensureUnexpiredCapacityToken, getEnv, getChainHelpers, createRandomVincentWallets, } from './lib';
+export type { PkpInfo } from './lib/mint-new-pkp';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,GAC3B,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRandomVincentWallets = exports.getChainHelpers = exports.getEnv = exports.ensureUnexpiredCapacityToken = exports.mintNewPkp = exports.appManager = exports.chain = exports.funder = exports.delegatee = exports.delegator = void 0;
+var lib_1 = require("./lib");
+Object.defineProperty(exports, "delegator", { enumerable: true, get: function () { return lib_1.delegator; } });
+Object.defineProperty(exports, "delegatee", { enumerable: true, get: function () { return lib_1.delegatee; } });
+Object.defineProperty(exports, "funder", { enumerable: true, get: function () { return lib_1.funder; } });
+Object.defineProperty(exports, "chain", { enumerable: true, get: function () { return lib_1.chain; } });
+Object.defineProperty(exports, "appManager", { enumerable: true, get: function () { return lib_1.appManager; } });
+Object.defineProperty(exports, "mintNewPkp", { enumerable: true, get: function () { return lib_1.mintNewPkp; } });
+Object.defineProperty(exports, "ensureUnexpiredCapacityToken", { enumerable: true, get: function () { return lib_1.ensureUnexpiredCapacityToken; } });
+Object.defineProperty(exports, "getEnv", { enumerable: true, get: function () { return lib_1.getEnv; } });
+Object.defineProperty(exports, "getChainHelpers", { enumerable: true, get: function () { return lib_1.getChainHelpers; } });
+Object.defineProperty(exports, "createRandomVincentWallets", { enumerable: true, get: function () { return lib_1.createRandomVincentWallets; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,6BAWe;AAVb,gGAAA,SAAS,OAAA;AACT,gGAAA,SAAS,OAAA;AACT,6FAAA,MAAM,OAAA;AACN,4FAAA,KAAK,OAAA;AACL,iGAAA,UAAU,OAAA;AACV,iGAAA,UAAU,OAAA;AACV,mHAAA,4BAA4B,OAAA;AAC5B,6FAAA,MAAM,OAAA;AACN,sGAAA,eAAe,OAAA;AACf,iHAAA,0BAA0B,OAAA"}

package/dist/src/lib/appManager/ensure-funded.d.ts

@@ -0,0 +1,2 @@
+export declare const ensureAppManagerFunded: () => Promise<void>;
+//# sourceMappingURL=ensure-funded.d.ts.map

package/dist/src/lib/appManager/ensure-funded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-funded.d.ts","sourceRoot":"","sources":["../../../../src/lib/appManager/ensure-funded.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,qBAMlC,CAAC"}

package/dist/src/lib/appManager/ensure-funded.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAppManagerFunded = void 0;
+const chain_1 = require("../chain");
+const funder_1 = require("../funder");
+const ensureAppManagerFunded = async () => {
+    const { wallets: { appManager }, } = await (0, chain_1.getChainHelpers)();
+    return (0, funder_1.ensureWalletHasTestTokens)({ address: await appManager.getAddress() });
+};
+exports.ensureAppManagerFunded = ensureAppManagerFunded;
+//# sourceMappingURL=ensure-funded.js.map

package/dist/src/lib/appManager/ensure-funded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-funded.js","sourceRoot":"","sources":["../../../../src/lib/appManager/ensure-funded.ts"],"names":[],"mappings":";;;AAAA,oCAA2C;AAC3C,sCAAsD;AAE/C,MAAM,sBAAsB,GAAG,KAAK,IAAI,EAAE;IAC/C,MAAM,EACJ,OAAO,EAAE,EAAE,UAAU,EAAE,GACxB,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,OAAO,IAAA,kCAAyB,EAAC,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC"}

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

@@ -0,0 +1,5 @@
+export { registerNewApp } from './register-new-app';
+export { registerNewAppVersion } from './register-new-app-version';
+export { removeDelegateeFromApp } from './remove-delegatee-from-app';
+export { ensureAppManagerFunded } from './ensure-funded';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/appManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAppManagerFunded = exports.removeDelegateeFromApp = exports.registerNewAppVersion = exports.registerNewApp = void 0;
+var register_new_app_1 = require("./register-new-app");
+Object.defineProperty(exports, "registerNewApp", { enumerable: true, get: function () { return register_new_app_1.registerNewApp; } });
+var register_new_app_version_1 = require("./register-new-app-version");
+Object.defineProperty(exports, "registerNewAppVersion", { enumerable: true, get: function () { return register_new_app_version_1.registerNewAppVersion; } });
+var remove_delegatee_from_app_1 = require("./remove-delegatee-from-app");
+Object.defineProperty(exports, "removeDelegateeFromApp", { enumerable: true, get: function () { return remove_delegatee_from_app_1.removeDelegateeFromApp; } });
+var ensure_funded_1 = require("./ensure-funded");
+Object.defineProperty(exports, "ensureAppManagerFunded", { enumerable: true, get: function () { return ensure_funded_1.ensureAppManagerFunded; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/appManager/index.ts"],"names":[],"mappings":";;;AAAA,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,iDAAyD;AAAhD,uHAAA,sBAAsB,OAAA"}

package/dist/src/lib/appManager/register-new-app-version.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Registers a new app version. On-chain app versions are immutable, so any time you modify
+ * abilities or policies, you must register a new version of your app using the new ipfs CIDs
+ *
+ * This function will check if the latest app version already has the same abilities and policies.
+ * If they match, it will return the existing appVersion without registering a new one.
+ *
+ * @param abilityIpfsCids - Array of ability IPFS CIDs to register
+ * @param abilityPolicies - Array of policy IPFS CIDs for each ability (must be parallel to abilityIpfsCids)
+ * @param registerNewVersionOverride - Whether to register a new version even if the latest version already has the same abilities and policies
+ *
+ * @remarks
+ * Assumptions:
+ * - `abilityIpfsCids` and `abilityPolicies` are parallel arrays where `abilityPolicies[i]` contains
+ *   the policy CIDs for the ability at `abilityIpfsCids[i]`
+ * - The comparison is order-independent for both abilities and policies within each ability
+ * - Two app versions are considered equivalent if they have the same set of abilities (regardless of order)
+ *   and each ability has the same set of policies (regardless of order)
+ */
+export declare function registerNewAppVersion({ abilityIpfsCids, abilityPolicies, registerNewVersionOverride, }: {
+    abilityIpfsCids: string[];
+    abilityPolicies: string[][];
+    registerNewVersionOverride?: boolean;
+}): Promise<{
+    appId: number;
+    appVersion: number;
+}>;
+//# sourceMappingURL=register-new-app-version.d.ts.map

package/dist/src/lib/appManager/register-new-app-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-new-app-version.d.ts","sourceRoot":"","sources":["../../../../src/lib/appManager/register-new-app-version.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,eAAe,EACf,eAAe,EACf,0BAAkC,GACnC,EAAE;IACD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC;IAC5B,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;;;GA4EA"}

package/dist/src/lib/appManager/register-new-app-version.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNewAppVersion = registerNewAppVersion;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+const chain_1 = require("../chain");
+const get_app_info_1 = require("../delegatee/get-app-info");
+/**
+ * Registers a new app version. On-chain app versions are immutable, so any time you modify
+ * abilities or policies, you must register a new version of your app using the new ipfs CIDs
+ *
+ * This function will check if the latest app version already has the same abilities and policies.
+ * If they match, it will return the existing appVersion without registering a new one.
+ *
+ * @param abilityIpfsCids - Array of ability IPFS CIDs to register
+ * @param abilityPolicies - Array of policy IPFS CIDs for each ability (must be parallel to abilityIpfsCids)
+ * @param registerNewVersionOverride - Whether to register a new version even if the latest version already has the same abilities and policies
+ *
+ * @remarks
+ * Assumptions:
+ * - `abilityIpfsCids` and `abilityPolicies` are parallel arrays where `abilityPolicies[i]` contains
+ *   the policy CIDs for the ability at `abilityIpfsCids[i]`
+ * - The comparison is order-independent for both abilities and policies within each ability
+ * - Two app versions are considered equivalent if they have the same set of abilities (regardless of order)
+ *   and each ability has the same set of policies (regardless of order)
+ */
+async function registerNewAppVersion({ abilityIpfsCids, abilityPolicies, registerNewVersionOverride = false, }) {
+    const app = await (0, get_app_info_1.getAppInfo)();
+    if (!app) {
+        throw new Error('App was expected, but not found. Please register a new app first.');
+    }
+    const { appId, appVersion: latestVersion } = app;
+    const { wallets: { appManager }, } = await (0, chain_1.getChainHelpers)();
+    const client = (0, vincent_contracts_sdk_1.getClient)({ signer: appManager });
+    if (!registerNewVersionOverride) {
+        // Get the existing app version to compare
+        const existingAppVersion = await client.getAppVersion({
+            appId,
+            version: latestVersion,
+        });
+        if (existingAppVersion) {
+            // Create a map from ability CID to its policies for easy lookup
+            const existingAbilityMap = new Map();
+            existingAppVersion.appVersion.abilities.forEach((ability) => {
+                existingAbilityMap.set(ability.abilityIpfsCid, ability.policyIpfsCids);
+            });
+            // Check if we have the same number of abilities and compare them
+            if (existingAbilityMap.size === abilityIpfsCids.length) {
+                // For each ability in the new version, check if it exists with the same policies
+                const allMatch = abilityIpfsCids.every((abilityId, index) => {
+                    const existingPolicies = existingAbilityMap.get(abilityId);
+                    if (existingPolicies === undefined)
+                        return false; // Ability doesn't exist in current version
+                    const newPolicies = abilityPolicies[index];
+                    if (newPolicies === undefined) {
+                        throw new Error(`Parallel arrays are not in sync: abilityPolicies[${index}] is undefined for ability '${abilityId}'.`);
+                    }
+                    // Compare policy arrays (order-independent)
+                    if (existingPolicies.length !== newPolicies.length)
+                        return false;
+                    const sortedExisting = [...existingPolicies].sort();
+                    const sortedNew = [...newPolicies].sort();
+                    return sortedExisting.every((policy, i) => policy === sortedNew[i]);
+                });
+                if (allMatch) {
+                    console.log(`App version ${latestVersion} already has the same abilities and policies. Skipping registration.`);
+                    return { appId, appVersion: latestVersion };
+                }
+            }
+        }
+    }
+    // Register new version if abilities or policies have changed
+    const { txHash, newAppVersion } = await client.registerNextVersion({
+        appId,
+        versionAbilities: {
+            abilityIpfsCids: abilityIpfsCids,
+            abilityPolicies: abilityPolicies,
+        },
+    });
+    console.log(`Registered new App version ${newAppVersion} for existing app: ${appId}\nTx hash: ${txHash}`);
+    return { appId, appVersion: newAppVersion };
+}
+//# sourceMappingURL=register-new-app-version.js.map

package/dist/src/lib/appManager/register-new-app-version.js.map

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

package/dist/src/lib/appManager/register-new-app.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Registers a new app
+ * @param abilityIpfsCids - Array of ability IPFS CIDs to register
+ * @param abilityPolicies - Array of policy IPFS CIDs for each ability
+ */
+export declare function registerNewApp({ abilityIpfsCids, abilityPolicies, }: {
+    abilityIpfsCids: string[];
+    abilityPolicies: string[][];
+}): Promise<{
+    appId: number;
+    appVersion: number;
+}>;
+//# sourceMappingURL=register-new-app.d.ts.map

package/dist/src/lib/appManager/register-new-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-new-app.d.ts","sourceRoot":"","sources":["../../../../src/lib/appManager/register-new-app.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EACnC,eAAe,EACf,eAAe,GAChB,EAAE;IACD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC;CAC7B;;;GAqBA"}

package/dist/src/lib/appManager/register-new-app.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNewApp = registerNewApp;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+const chain_1 = require("../chain");
+function generateRandomAppId() {
+    return Math.floor(Math.random() * (100_000_000_000 - 10_000_000_000)) + 10_000_000_000;
+}
+/**
+ * Registers a new app
+ * @param abilityIpfsCids - Array of ability IPFS CIDs to register
+ * @param abilityPolicies - Array of policy IPFS CIDs for each ability
+ */
+async function registerNewApp({ abilityIpfsCids, abilityPolicies, }) {
+    const { wallets: { appManager, appDelegatee }, } = await (0, chain_1.getChainHelpers)();
+    const appId = generateRandomAppId();
+    const { txHash } = await (0, vincent_contracts_sdk_1.getClient)({
+        signer: appManager,
+    }).registerApp({
+        appId,
+        delegateeAddresses: [await appDelegatee.getAddress()],
+        versionAbilities: {
+            abilityIpfsCids: abilityIpfsCids,
+            abilityPolicies: abilityPolicies,
+        },
+    });
+    console.log(`Registered new App with ID: ${appId}\nTx hash: ${txHash}`);
+    return { appId, appVersion: 1 };
+}
+//# sourceMappingURL=register-new-app.js.map

package/dist/src/lib/appManager/register-new-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-new-app.js","sourceRoot":"","sources":["../../../../src/lib/appManager/register-new-app.ts"],"names":[],"mappings":";;AAaA,wCA2BC;AAxCD,+EAAgE;AAEhE,oCAA2C;AAE3C,SAAS,mBAAmB;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,GAAG,cAAc,CAAC,CAAC,GAAG,cAAc,CAAC;AACzF,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,eAAe,EACf,eAAe,GAIhB;IACC,MAAM,EACJ,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,GACtC,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,iCAAS,EAAC;QACjC,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC,WAAW,CAAC;QACb,KAAK;QACL,kBAAkB,EAAE,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QACrD,gBAAgB,EAAE;YAChB,eAAe,EAAE,eAAe;YAChC,eAAe,EAAE,eAAe;SACjC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,cAAc,MAAM,EAAE,CAAC,CAAC;IAExE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/lib/appManager/remove-delegatee-from-app.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Removes a delegatee from an app
+ */
+export declare function removeDelegateeFromApp(): Promise<{
+    txHash: string;
+}>;
+//# sourceMappingURL=remove-delegatee-from-app.d.ts.map

package/dist/src/lib/appManager/remove-delegatee-from-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-delegatee-from-app.d.ts","sourceRoot":"","sources":["../../../../src/lib/appManager/remove-delegatee-from-app.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,sBAAsB;;GAyB3C"}

package/dist/src/lib/appManager/remove-delegatee-from-app.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeDelegateeFromApp = removeDelegateeFromApp;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+const chain_1 = require("../chain");
+const get_app_info_1 = require("../delegatee/get-app-info");
+/**
+ * Removes a delegatee from an app
+ */
+async function removeDelegateeFromApp() {
+    const app = await (0, get_app_info_1.getAppInfo)();
+    if (!app) {
+        throw new Error('App was expected, but not found. Please register a new app first.');
+    }
+    const { appId } = app;
+    const { wallets: { appManager, appDelegatee }, } = await (0, chain_1.getChainHelpers)();
+    const { txHash } = await (0, vincent_contracts_sdk_1.getClient)({
+        signer: appManager,
+    }).removeDelegatee({
+        appId,
+        delegateeAddress: appDelegatee.address,
+    });
+    console.log(`Removed delegatee ${appDelegatee.address} from App with ID: ${appId}\nTx hash: ${txHash}`);
+    return { txHash };
+}
+//# sourceMappingURL=remove-delegatee-from-app.js.map

package/dist/src/lib/appManager/remove-delegatee-from-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-delegatee-from-app.js","sourceRoot":"","sources":["../../../../src/lib/appManager/remove-delegatee-from-app.ts"],"names":[],"mappings":";;AAQA,wDAyBC;AAjCD,+EAAgE;AAEhE,oCAA2C;AAC3C,4DAAuD;AAEvD;;GAEG;AACI,KAAK,UAAU,sBAAsB;IAC1C,MAAM,GAAG,GAAG,MAAM,IAAA,yBAAU,GAAE,CAAC;IAE/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAEtB,MAAM,EACJ,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,GACtC,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,iCAAS,EAAC;QACjC,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC,eAAe,CAAC;QACjB,KAAK;QACL,gBAAgB,EAAE,YAAY,CAAC,OAAO;KACvC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACT,qBAAqB,YAAY,CAAC,OAAO,sBAAsB,KAAK,cAAc,MAAM,EAAE,CAC3F,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,14 @@
+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;
+    };
+}>;
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/lib/chain.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChainHelpers = void 0;
+const ethers_1 = require("ethers");
+const env_1 = require("./env");
+let ethersHelpers;
+// Vincent delegation uses a set of wallets that interact with LIT's test network: Yellowstone RPC
+// This function constructs Ethers Wallet objects configured using the appropriate environment variables
+// It also provides the low-level providers for `yellowstone` and `base` networks for doing things like checking account balances
+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 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),
+        },
+    };
+    return ethersHelpers;
+};
+exports.getChainHelpers = getChainHelpers;
+//# sourceMappingURL=chain.js.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-random-vincent-wallets.d.ts","sourceRoot":"","sources":["../../../src/lib/create-random-vincent-wallets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,wBAAgB,0BAA0B;;;;EAMzC"}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRandomVincentWallets = createRandomVincentWallets;
+const ethers_1 = require("ethers");
+function createRandomVincentWallets() {
+    return {
+        appDelegatee: ethers_1.Wallet.createRandom(),
+        appManager: ethers_1.Wallet.createRandom(),
+        agentWalletOwner: ethers_1.Wallet.createRandom(),
+    };
+}
+//# sourceMappingURL=create-random-vincent-wallets.js.map

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

@@ -0,0 +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"}

package/dist/src/lib/delegatee/ensure-funded.d.ts

@@ -0,0 +1,2 @@
+export declare const ensureAppDelegateeFunded: () => Promise<void>;
+//# sourceMappingURL=ensure-funded.d.ts.map

package/dist/src/lib/delegatee/ensure-funded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-funded.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegatee/ensure-funded.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,qBAMpC,CAAC"}

package/dist/src/lib/delegatee/ensure-funded.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAppDelegateeFunded = void 0;
+const chain_1 = require("../chain");
+const funder_1 = require("../funder");
+const ensureAppDelegateeFunded = async () => {
+    const { wallets: { appDelegatee }, } = await (0, chain_1.getChainHelpers)();
+    return (0, funder_1.ensureWalletHasTestTokens)({ address: await appDelegatee.getAddress() });
+};
+exports.ensureAppDelegateeFunded = ensureAppDelegateeFunded;
+//# sourceMappingURL=ensure-funded.js.map

package/dist/src/lib/delegatee/ensure-funded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-funded.js","sourceRoot":"","sources":["../../../../src/lib/delegatee/ensure-funded.ts"],"names":[],"mappings":";;;AAAA,oCAA2C;AAC3C,sCAAsD;AAE/C,MAAM,wBAAwB,GAAG,KAAK,IAAI,EAAE;IACjD,MAAM,EACJ,OAAO,EAAE,EAAE,YAAY,EAAE,GAC1B,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,OAAO,IAAA,kCAAyB,EAAC,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC,CAAC;AANW,QAAA,wBAAwB,4BAMnC"}

package/dist/src/lib/delegatee/get-app-info.d.ts

@@ -0,0 +1,5 @@
+export declare function getAppInfo(): Promise<{
+    appId: number;
+    appVersion: number;
+} | null>;
+//# sourceMappingURL=get-app-info.d.ts.map

package/dist/src/lib/delegatee/get-app-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-app-info.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegatee/get-app-info.ts"],"names":[],"mappings":"AAIA,wBAAsB,UAAU;;;UAiB/B"}

package/dist/src/lib/delegatee/get-app-info.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppInfo = getAppInfo;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+const chain_1 = require("../chain");
+async function getAppInfo() {
+    const { wallets: { appDelegatee }, } = await (0, chain_1.getChainHelpers)();
+    const app = await (0, vincent_contracts_sdk_1.getClient)({
+        signer: appDelegatee,
+    }).getAppByDelegateeAddress({
+        delegateeAddress: appDelegatee.address,
+    });
+    if (!app) {
+        return null;
+    }
+    const { id: appId, latestVersion: appVersion } = app;
+    return { appId, appVersion };
+}
+//# sourceMappingURL=get-app-info.js.map

package/dist/src/lib/delegatee/get-app-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-app-info.js","sourceRoot":"","sources":["../../../../src/lib/delegatee/get-app-info.ts"],"names":[],"mappings":";;AAIA,gCAiBC;AArBD,+EAAgE;AAEhE,oCAA2C;AAEpC,KAAK,UAAU,UAAU;IAC9B,MAAM,EACJ,OAAO,EAAE,EAAE,YAAY,EAAE,GAC1B,GAAG,MAAM,IAAA,uBAAe,GAAE,CAAC;IAE5B,MAAM,GAAG,GAAG,MAAM,IAAA,iCAAS,EAAC;QAC1B,MAAM,EAAE,YAAY;KACrB,CAAC,CAAC,wBAAwB,CAAC;QAC1B,gBAAgB,EAAE,YAAY,CAAC,OAAO;KACvC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;IACrD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,3 @@
+export { ensureAppDelegateeFunded } from './ensure-funded';
+export { getAppInfo } from './get-app-info';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/delegatee/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppInfo = exports.ensureAppDelegateeFunded = void 0;
+var ensure_funded_1 = require("./ensure-funded");
+Object.defineProperty(exports, "ensureAppDelegateeFunded", { enumerable: true, get: function () { return ensure_funded_1.ensureAppDelegateeFunded; } });
+var get_app_info_1 = require("./get-app-info");
+Object.defineProperty(exports, "getAppInfo", { enumerable: true, get: function () { return get_app_info_1.getAppInfo; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/delegatee/index.ts"],"names":[],"mappings":";;;AAAA,iDAA2D;AAAlD,yHAAA,wBAAwB,OAAA;AACjC,+CAA4C;AAAnC,0GAAA,UAAU,OAAA"}

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

@@ -0,0 +1,3 @@
+import type { Wallet } from 'ethers';
+export declare const addPermissionForAbilities: (wallet: Wallet, 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

@@ -0,0 +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"}

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

@@ -0,0 +1,20 @@
+"use strict";
+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
+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}`);
+        await litContractClient.addPermittedAction({
+            pkpTokenId,
+            ipfsId: ipfsCid,
+            authMethodScopes: [constants_1.AUTH_METHOD_SCOPE.SignAnything],
+        });
+    }
+};
+exports.addPermissionForAbilities = addPermissionForAbilities;
+//# sourceMappingURL=add-permission-for-abilities.js.map