Merge branch 'LIT-4211-auth-refactor' into feature/lit-4238-clean-unnecessary-packages

Author: Ansonhkg

.ctx/generate-local-network-context.md

@@ -0,0 +1,35 @@
+# Generating Local Network Context for Lit Protocol
+
+The Lit network contexts, which include smart contract addresses and ABIs, typically come from the `@lit-protocol/contracts` package (a separate repository at https://github.com/LIT-Protocol/lit-contracts/). However, these contexts are designed for established networks.
+
+## Local Network Setup
+
+For local development (running Lit nodes on your machine), you need to generate a `networkContext.json` file in the `lit-assets` directory. This is typically done by running the deploy script after starting your local Anvil chain.
+
+## Version Compatibility Changes
+
+In version 7 or earlier, you could simply copy and paste the `networkContext.json` file, and it would work when setting the network to `custom` when running with Tinny (E2E test suite).
+
+However, in version 8, we've optimised by removing redundant and unused ABIs from the JSON file and enforced strongly typed ABIs. This optimization introduced an additional conversion layer that extracts only the necessary ABI methods, which must be run manually for local network contexts.
+
+## Generating Custom Context
+
+To generate the proper context:
+
+1. Locate the `getCustomContext` file in the network-specific folder (in this case, `vNaga/naga-develop` folder)
+2. Use the `generateSignaturesFromContext` helper function from the `@lit-protocol/contracts` repository
+
+Here's an example of how to use this function:
+
+```ts
+import { generateSignaturesFromContext } from '@lit-protocol/contracts/custom-network-signatures';
+
+await generateSignaturesFromContext({
+  jsonFilePath:
+    '/Users/anson/Projects/lit-assets/blockchain/contracts/networkContext.json', // in lit assets repo
+  networkName: 'naga-develop',
+  outputDir: './naga-develop-signatures',
+  useScriptDirectory: true,
+  callerPath: import.meta.url,
+});
+```

.ctx/v7-to-v8-migration-notes.md

@@ -77,4 +77,6 @@ local-tests/build
 packages/wrapped-keys-lit-actions/src/generated
 
 digest
-generate-digest.ts
+generate-digest.ts
+
+.cursor/rules

.gitignore

@@ -14,3 +14,11 @@ if (!global.crypto.subtle) {
     },
   };
 }
+
+// If this is not included, you will get the following error when running it in Jest:
+// (Error) Details: Request is not defined
+// The problem is that Jest is running in a Node.js environment where the global Request API (part of the Fetch API) might not be available or properly configured. Bun, on the other hand, has this API built into its runtime by default, which is why it works.
+const { default: fetch, Request, Response } = require('node-fetch');
+global.fetch = fetch;
+global.Request = Request;
+global.Response = Response;