Feat/naga test upgrade 30 10 2025

.changeset/salty-hands-laugh.md

@@ -0,0 +1,10 @@
+---
+'@lit-protocol/contracts': patch
+'@lit-protocol/e2e': patch
+'@lit-protocol/auth': patch
+'@lit-protocol/auth-services': patch
+'@lit-protocol/lit-client': patch
+'@lit-protocol/networks': patch
+---
+
+update naga-test contract addresses. Users are expected to update and reinstall the SDK to continue using naga-test.

.github/workflows/e2e-naga.yml

@@ -56,9 +56,9 @@ jobs:
           # - environment: naga-staging
           #   network: naga-staging
           #   privateKey: LIVE_MASTER_ACCOUNT_NAGA_STAGING
-          # - environment: naga-test
-          #   network: naga-test
-          #   privateKey: LIVE_MASTER_ACCOUNT_NAGA_TEST
+          - environment: naga-test
+            network: naga-test
+            privateKey: LIVE_MASTER_ACCOUNT_NAGA_TEST
     env:
       LOG_LEVEL: debug2
       LIVE_MASTER_ACCOUNT: ${{ secrets[matrix.privateKey] }}

README.md

@@ -55,8 +55,31 @@ LOCAL_MASTER_ACCOUNT=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf
 NETWORK=<network-name> pnpm run test:e2e all
 ```
 
+### Target a specific spec
+
+Use `test:target` when you only need to exercise one file:
+
+```bash
+pnpm run test:target packages/e2e/src/tickets/delegation.spec.ts
+```
+
+Append additional Jest flags after the path if you need finer filtering.
+
+## QA Starter Kit workflow
+
+When you need to validate SDK integrations against backend or node features, lean on the [QA Starter Kit](https://github.com/LIT-Protocol/QA-kit). That repo installs published packages, so it mirrors how downstream teams will consume the SDK.
+
+1. The node team opens a feature branch for their service.
+2. Create a matching SDK branch and build the integration for that node change.
+3. Publish a snapshot (prerelease) of the SDK packages so the QA Starter Kit can install them from npm.
+4. Point the QA Starter Kit to that snapshot to perform the e2e flow before promoting the release.
+
+This keeps QA aligned with the packages that will actually ship and avoids the drift that comes with local linking.
+
 # Running it against a local network
 
+Generate a fresh `networkContext.json` for local nodes with `pnpm run gen:local-network-context` before running the e2e tests against the `naga-local` local network.
+
 ## Required Environment Variables
 
 ```bash
@@ -132,6 +155,18 @@ This command must be run manually and is NOT part of the build process, as it re
 DEV_BRANCH=develop GH_API_KEY=github_pat_xxx pnpm run sync:contracts
 ```
 
+## Keeping the docs changelog in sync with the public site
+
+Use the `sync:docs-changelog` script to refresh the changelog that powers [naga.developer.litprotocol.com/changelog](https://naga.developer.litprotocol.com/changelog).
+
+```shell
+pnpm run sync:docs-changelog
+```
+
+> Note: we currently run this manually after the Changeset PR lands in the `naga` main branch, though we expect to automate it in CI in the future.
+
+The script collates the latest entries from `packages/*/CHANGELOG.md` and rewrites the target `changelog.mdx`. Commit and publish the regenerated file in the docs repo so the public changelog stays current.
+
 ---
 
 # Legacy Documentation for V7 and Earlier

package.json

@@ -12,8 +12,8 @@
     "lint": "npx nx run-many --target=lint --all",
     "lint:fix": "npx nx run-many --target=lint --all -- --fix",
     "format:check": "npx nx format:check --all",
-    "test:e2e": "npx jest --clearCache --config ./jest.e2e.config.ts && LOG_LEVEL=${LOG_LEVEL:-silent} dotenvx run --env-file=.env -- jest --runInBand --detectOpenHandles --forceExit --config ./jest.e2e.config.ts --testTimeout=50000000 -t",
-    "test:custom": "npx jest --clearCache --config ./jest.e2e.config.ts && LOG_LEVEL=${LOG_LEVEL:-silent} dotenvx run --env-file=.env -- jest --runInBand --detectOpenHandles --forceExit --config ./jest.e2e.config.ts --testTimeout=50000000",
+    "test:e2e": "npx jest --clearCache --config ./jest.e2e.config.ts && LOG_LEVEL=${LOG_LEVEL:-silent} dotenvx run --env-file=.env -- jest --runInBand --detectOpenHandles --forceExit --config ./jest.e2e.config.ts --testTimeout=50000000 --runTestsByPath packages/e2e/src/e2e.spec.ts",
+    "test:target": "npx jest --clearCache --config ./jest.e2e.config.ts && LOG_LEVEL=${LOG_LEVEL:-silent} dotenvx run --env-file=.env -- jest --runInBand --detectOpenHandles --forceExit --config ./jest.e2e.config.ts --testTimeout=50000000",
     "test:e2e:ci": "npx jest --clearCache --config ./jest.e2e.config.ts && LOG_LEVEL=${LOG_LEVEL:-silent} npx jest --runInBand --detectOpenHandles --forceExit --config ./jest.e2e.config.ts --testTimeout=50000000 --runTestsByPath",
     "test:health": "LOG_LEVEL=${LOG_LEVEL:-silent} dotenvx run --env-file=.env -- tsx packages/e2e/src/health/index.ts",
     "ci:health": "LOG_LEVEL=${LOG_LEVEL:-silent} tsx packages/e2e/src/health/index.ts"