fmt

Author: Ansonhkg

packages/e2e/src/health/NagaHealthManager.ts

@@ -1,17 +1,17 @@
 /**
  * Naga Health Manager
- * 
+ *
  * This module implements health checks for Naga network endpoints.
  * It tests the core functionality of the Lit Protocol network by executing
  * a series of endpoint tests using a single test account.
- * 
+ *
  * Tested Endpoints:
  * 1. Handshake - Verifies basic node connectivity
  * 2. PKP Sign - Tests PKP signing functionality
  * 3. Sign Session Key - Tests session key signing (via PKP auth context creation)
  * 4. Execute JS - Tests Lit Actions execution
  * 5. Decrypt - Tests encryption and decryption flow
- * 
+ *
  * Usage:
  *   const manager = new NagaHealthManager(ctx);
  *   await manager.handshakeTest();
@@ -33,10 +33,10 @@ export class NagaHealthManager {
 
   /**
    * Test 1: Handshake Test
-   * 
+   *
    * Verifies basic connectivity to Lit nodes by checking if the client
    * is properly initialized and connected.
-   * 
+   *
    * This is the most basic health check - if this fails, the network is down.
    */
   handshakeTest = async (): Promise<void> => {
@@ -72,7 +72,7 @@ export class NagaHealthManager {
 
   /**
    * Test 2: PKP Sign Test
-   * 
+   *
    * Tests the PKP signing endpoint by signing a simple message.
    * This verifies that:
    * - The PKP is accessible
@@ -82,7 +82,7 @@ export class NagaHealthManager {
   pkpSignTest = async (): Promise<void> => {
     try {
       const testMessage = 'Hello from Naga health check!';
-      
+
       const result = await this.ctx.litClient.chain.ethereum.pkpSign({
         authContext: this.ctx.aliceEoaAuthContext,
         pubKey: this.ctx.aliceViemAccountPkp.pubkey,
@@ -102,7 +102,7 @@ export class NagaHealthManager {
 
   /**
    * Test 3: Sign Session Key Test
-   * 
+   *
    * Tests the session key signing endpoint by creating a PKP auth context.
    * This involves the signSessionKey endpoint which is critical for
    * establishing authenticated sessions with PKPs.
@@ -136,10 +136,10 @@ export class NagaHealthManager {
 
   /**
    * Test 4: Execute JS Test
-   * 
+   *
    * Tests Lit Actions execution by running a simple JavaScript code
    * that performs an ECDSA signature.
-   * 
+   *
    * This verifies:
    * - Lit Actions runtime is operational
    * - Code execution environment is working
@@ -186,11 +186,11 @@ export class NagaHealthManager {
 
   /**
    * Test 5: Decrypt Test
-   * 
+   *
    * Tests the encryption and decryption flow:
    * 1. Encrypts data with access control conditions
    * 2. Decrypts the data using the same account
-   * 
+   *
    * This verifies:
    * - Encryption endpoint works
    * - Access control condition evaluation works
@@ -200,7 +200,7 @@ export class NagaHealthManager {
   decryptTest = async (): Promise<void> => {
     try {
       const testData = 'Secret health check data';
-      
+
       // Create access control conditions for Alice's wallet
       const builder = createAccBuilder();
       const accs = builder
@@ -245,4 +245,3 @@ export class NagaHealthManager {
     }
   };
 }
-

packages/e2e/src/health/README.md

@@ -38,13 +38,15 @@ The health check system is designed to be:
 ### How It Works
 
 1. **Initialization** (`health-init.ts`):
+
    - Creates a single test account (Alice)
    - Funds it with minimal amount
    - Creates one PKP
    - Sets up EOA auth context
    - No Bob, Eve, or complex multi-account setup
 
 2. **Test Execution** (`NagaHealthManager.ts`):
+
    - Reuses the same Alice account and auth context
    - Tests each endpoint sequentially
    - Throws errors on failures for proper error tracking
@@ -111,11 +113,13 @@ You can manually trigger health checks from GitHub:
 Configure these in your repository settings under `Settings → Secrets and variables → Actions`:
 
 **Secrets:**
+
 - `LIT_STATUS_WRITE_KEY` - API key for status backend
 - `LIVE_MASTER_ACCOUNT_NAGA_DEV` - Funding account for naga-dev
 - `LIVE_MASTER_ACCOUNT_NAGA_TEST` - Funding account for naga-test
 
 **Variables:**
+
 - `LIT_STATUS_BACKEND_URL` - Status backend URL
 - `LIT_YELLOWSTONE_PRIVATE_RPC_URL` - (Optional) Custom RPC URL
 
@@ -126,6 +130,7 @@ Environment: `Health Check` (create this environment in repository settings)
 ### Status Dashboard
 
 View health check results at the Lit Status dashboard:
+
 - URL: Configured via `LIT_STATUS_BACKEND_URL`
 - Shows success/failure rates
 - Tracks response times
@@ -134,6 +139,7 @@ View health check results at the Lit Status dashboard:
 ### GitHub Actions
 
 Monitor workflow runs:
+
 - Go to `Actions → Naga Health Checks`
 - View recent runs and their status
 - Check logs for detailed error messages
@@ -152,15 +158,19 @@ If health checks fail:
 ### Common Issues
 
 **Error: "NETWORK environment variable is not set"**
+
 - Solution: Ensure `NETWORK` is set in the workflow or .env file
 
 **Error: "LIVE_MASTER_ACCOUNT is not set"**
+
 - Solution: Check that the appropriate secret is configured in GitHub
 
 **Error: "Failed to get network information"**
+
 - Solution: Network may be down or unreachable. Check node status.
 
 **Error: "Insufficient funds"**
+
 - Solution: Fund the master account with more tokens
 
 ## 🧪 Testing Locally
@@ -191,6 +201,7 @@ pnpm run test:health
 To add a new health check test:
 
 1. **Add test method to `NagaHealthManager.ts`**:
+
 ```typescript
 myNewTest = async (): Promise<void> => {
   try {
@@ -204,6 +215,7 @@ myNewTest = async (): Promise<void> => {
 ```
 
 2. **Register function in `index.ts`**:
+
 ```typescript
 const txs = await statusClient.getOrRegisterFunctions({
   network: NETWORK!,
@@ -220,12 +232,10 @@ const txs = await statusClient.getOrRegisterFunctions({
 ```
 
 3. **Execute test in `index.ts`**:
+
 ```typescript
 console.log('6️⃣  Testing: My New Test');
-await statusClient.executeAndLog(
-  txs.myNewTest.id,
-  healthManager.myNewTest
-);
+await statusClient.executeAndLog(txs.myNewTest.id, healthManager.myNewTest);
 ```
 
 ## 🔐 Security Considerations
@@ -254,7 +264,7 @@ When modifying health checks:
 ## 📧 Support
 
 For issues or questions:
+
 - Create an issue in the repository
 - Contact the Lit Protocol team
 - Check the status dashboard for network-wide issues
-

packages/e2e/src/health/health-init.ts

@@ -1,10 +1,10 @@
 /**
  * Health Check Initialization Module
- * 
+ *
  * This module provides a lightweight initialization for health checks that minimizes
  * chain interactions. Unlike the full e2e init, this only creates a single test person
  * using EOA authentication and reuses it across all endpoint tests.
- * 
+ *
  * Design Philosophy:
  * - Minimal chain interactions (only what's necessary for testing endpoints)
  * - Single person setup to reduce overhead
@@ -30,10 +30,7 @@ import {
   ViemAccount,
 } from '../types';
 
-const SupportedNetworkSchema = z.enum([
-  'naga-dev',
-  'naga-test',
-]);
+const SupportedNetworkSchema = z.enum(['naga-dev', 'naga-test']);
 
 type SupportedNetwork = z.infer<typeof SupportedNetworkSchema>;
 
@@ -46,13 +43,13 @@ const LIVE_NETWORK_LEDGER_DEPOSIT_AMOUNT = '2';
 
 /**
  * Initialize the health check environment with minimal setup
- * 
+ *
  * This function:
  * 1. Creates a single test account (Alice)
  * 2. Funds it minimally
  * 3. Creates one PKP for testing
  * 4. Sets up auth context for endpoint testing
- * 
+ *
  * @param network - The network to run health checks on (naga-dev or naga-test)
  * @param logLevel - Logging level for the health check run
  * @returns Initialized components needed for health checks
@@ -90,7 +87,9 @@ export const initHealthCheck = async (
   const parsedNetwork = SupportedNetworkSchema.safeParse(_network);
   if (!parsedNetwork.success) {
     throw new Error(
-      `❌ Invalid network: ${_network}. Must be one of: ${SupportedNetworkSchema.options.join(', ')}`
+      `❌ Invalid network: ${_network}. Must be one of: ${SupportedNetworkSchema.options.join(
+        ', '
+      )}`
     );
   }
 
@@ -249,4 +248,3 @@ export const initHealthCheck = async (
     networkName: _network,
   };
 };
-

packages/e2e/src/health/index.ts

@@ -1,20 +1,20 @@
 /**
  * Naga Health Check Runner
- * 
+ *
  * This is the main entry point for running health checks on Naga networks.
  * It initializes the environment, runs all endpoint tests, and logs results
  * to the Lit Status backend for monitoring.
- * 
+ *
  * Environment Variables Required:
  * - NETWORK: The network to test (naga-dev or naga-test)
  * - LIVE_MASTER_ACCOUNT: Private key of the master funding account
  * - LIT_STATUS_BACKEND_URL: URL of the status backend
  * - LIT_STATUS_WRITE_KEY: API key for writing to status backend
- * 
+ *
  * Optional:
  * - LOG_LEVEL: Logging verbosity (silent, info, debug)
  * - LIT_YELLOWSTONE_PRIVATE_RPC_URL: Override RPC URL
- * 
+ *
  * Usage:
  *   NETWORK=naga-dev pnpm run ci:health
  *   NETWORK=naga-test pnpm run test:health
@@ -33,7 +33,10 @@ const PRODUCT = 'js-sdk/naga';
 function validateEnvironment(): void {
   console.log('🔍 Environment Variables:');
   console.log('  NETWORK:', process.env['NETWORK']);
-  console.log('  LIT_STATUS_BACKEND_URL:', process.env['LIT_STATUS_BACKEND_URL']);
+  console.log(
+    '  LIT_STATUS_BACKEND_URL:',
+    process.env['LIT_STATUS_BACKEND_URL']
+  );
   console.log(
     '  LIT_STATUS_WRITE_KEY:',
     process.env['LIT_STATUS_WRITE_KEY'] ? '[SET]' : '[NOT SET]'
@@ -48,7 +51,9 @@ function validateEnvironment(): void {
   }
 
   if (!process.env['LIT_STATUS_BACKEND_URL']) {
-    throw new Error('❌ LIT_STATUS_BACKEND_URL environment variable is not set');
+    throw new Error(
+      '❌ LIT_STATUS_BACKEND_URL environment variable is not set'
+    );
   }
 
   if (!process.env['LIT_STATUS_WRITE_KEY']) {
@@ -77,7 +82,9 @@ async function runHealthCheck(): Promise<void> {
   console.log(`Time: ${new Date().toISOString()}\n`);
 
   // Initialize Lit Status Client (dynamic import for ESM compatibility)
-  const { createLitStatusClient } = await import('@lit-protocol/lit-status-sdk');
+  const { createLitStatusClient } = await import(
+    '@lit-protocol/lit-status-sdk'
+  );
   const statusClient = createLitStatusClient({
     url: process.env['LIT_STATUS_BACKEND_URL']!,
     apiKey: process.env['LIT_STATUS_WRITE_KEY']!,
@@ -124,10 +131,7 @@ async function runHealthCheck(): Promise<void> {
 
   // Test 2: PKP Sign
   console.log('2️⃣  Testing: PKP Sign');
-  await statusClient.executeAndLog(
-    txs.pkpSign.id,
-    healthManager.pkpSignTest
-  );
+  await statusClient.executeAndLog(txs.pkpSign.id, healthManager.pkpSignTest);
   console.log('');
 
   // Test 3: Sign Session Key
@@ -148,10 +152,7 @@ async function runHealthCheck(): Promise<void> {
 
   // Test 5: Decrypt
   console.log('5️⃣  Testing: Encrypt/Decrypt');
-  await statusClient.executeAndLog(
-    txs.decrypt.id,
-    healthManager.decryptTest
-  );
+  await statusClient.executeAndLog(txs.decrypt.id, healthManager.decryptTest);
   console.log('');
 
   console.log('═══════════════════════════════════════');
@@ -180,4 +181,3 @@ async function runHealthCheck(): Promise<void> {
     process.exit(1);
   }
 })();
-