E2E test utilities for the Vincent protocol, providing helper functions for setting up test environments, managing wallets, minting PKPs, and handling permissions.

Installation

npm install @lit-protocol/vincent-e2e-test-utils

yarn add @lit-protocol/vincent-e2e-test-utils

pnpm add @lit-protocol/vincent-e2e-test-utils

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():

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