Merge branch 'naga' of github.com:LIT-Protocol/js-sdk into feature/jss-110-security-pin-all-versions-v8

Author: Ansonhkg

.changeset/fruity-lands-help.md

@@ -0,0 +1,6 @@
+---
+'@lit-protocol/contracts': minor
+'@lit-protocol/networks': minor
+---
+
+Add `naga` and `naga-proto` networks. Create per-network entrypoints and subpath exports (naga, naga-production, naga-proto, naga-staging, naga-test, naga-dev, naga-local) for better tree-shaking

.changeset/gold-ducks-repeat.md

@@ -0,0 +1,6 @@
+---
+'@lit-protocol/networks': patch
+'@lit-protocol/e2e': patch
+---
+
+PKP signing now auto-hashes Cosmos payloads, exposes a documented bypassAutoHashing option, and ships with a new e2e suite plus docs so builders can rely on every listed curve working out of the box.

.changeset/warm-lizards-fry.md

@@ -0,0 +1,7 @@
+---
+'@lit-protocol/lit-client': patch
+'@lit-protocol/networks': patch
+'@lit-protocol/e2e': patch
+---
+
+SDK exposes typed Shiva env helpers (`createShivaEnvVars`, `waitForTestnetInfo`, `SUPPORTED_NETWORKS`) so QA suites can spin up testnets without bespoke env plumbing, and the new `executeWithHandshake` runner automatically retry failures for more stable Lit action execution.

.dockerignore

@@ -26,4 +26,8 @@ out
 
 # allow lit-login-server build output for docker image
 !dist/apps/lit-login-server/**
-!dist/apps/lit-login-server
+!dist/apps/lit-login-server
+
+# allow explorer build output for docker image
+!apps/explorer/dist/**
+!apps/explorer/dist

.eslintrc.json

@@ -1,12 +1,12 @@
 {
   "root": true,
   "ignorePatterns": ["**/*"],
-  "plugins": ["@nrwl/nx", "import"],
+  "plugins": ["@nx", "import"],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
       "rules": {
-        "@nrwl/nx/enforce-module-boundaries": [
+        "@nx/enforce-module-boundaries": [
           "error",
           {
             "enforceBuildableLibDependency": true,
@@ -23,14 +23,14 @@
     },
     {
       "files": ["*.ts", "*.tsx"],
-      "extends": ["plugin:@nrwl/nx/typescript"],
+      "extends": ["plugin:@nx/typescript"],
       "rules": {
         "@typescript-eslint/no-inferrable-types": "off"
       }
     },
     {
       "files": ["*.js", "*.jsx"],
-      "extends": ["plugin:@nrwl/nx/javascript"],
+      "extends": ["plugin:@nx/javascript"],
       "rules": {}
     }
   ],

README.md

@@ -40,6 +40,8 @@ pnpm install && pnpm build
 # (Optional) Request a private rpc url from
 # https://hub.conduit.xyz/chronicle-yellowstone-testnet-9qgmzfcohk
 LIT_YELLOWSTONE_PRIVATE_RPC_URL=<private-rpc-url>
+# (Optional) Mainnet RPC override for naga-proto / naga
+LIT_MAINNET_RPC_URL=<mainnet-rpc-url>
 
 # For live networks (naga-dev, naga-staging)
 LIVE_MASTER_ACCOUNT=<master-account-private-key>
@@ -48,6 +50,8 @@ LIVE_MASTER_ACCOUNT=<master-account-private-key>
 LOCAL_MASTER_ACCOUNT=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
 ```
 
+When `NETWORK` is set to `naga-proto` or `naga`, the test helpers only top up generated accounts with `0.01` LIT and deposit `0.01` LIT into the Lit Ledger to avoid locking up excess mainnet funds.
+
 ## Command
 
 ```bash
@@ -99,6 +103,68 @@ DIRECTORY_NAME=naga-local
 NETWORK=naga-local pnpm run test:e2e all
 ```
 
+# Artillery Load Testing
+
+Use the standalone Artillery project under `packages/artillery`
+
+## Preparation
+
+```bash
+# from the repo root
+pnpm install
+
+# pick your target network: naga-dev | naga-staging | naga-test | naga-local
+export NETWORK=naga-staging
+export LOG_LEVEL=info           # optional: debug | debug2 | silent
+```
+
+For live networks that read ABI data from the `networks` repo (for example `naga-staging`), run the sync script before firing Artillery so the contracts and addresses are up to date:
+
+```bash
+pnpm run sync:contracts  # requires GH_API_KEY in your environment
+```
+
+Testing a custom local network? Point the runner at your generated `networkContext.json` and RPC URL. (/lit-assets/blockchain/contracts/networkContext.json)
+
+```ts
+const networkModule = nagaLocal
+  .withLocalContext({
+    networkContextPath:
+      '/Users/<username>/Projects/lit-assets/blockchain/contracts/networkContext.json',
+    networkName: 'naga-local',
+  })
+  .withOverrides({ rpcUrl: process.env.LOCAL_RPC_URL });
+```
+
+If you want Artillery Cloud reports, set `ARTILLERY_KEY=<your-key>` in `.env` before running a scenario.
+
+## One-time initialisation
+
+Master account, auth data and PKP info are written to this file:
+`packages/artillery/artillery-state.json`.
+
+```bash
+pnpm nx run artillery:init
+```
+
+(optional) Check master balances before blasting a load test:
+
+```bash
+pnpm nx run artillery:balance-status
+```
+
+## Run a workload
+
+Each scenario is exposed as an Nx target. Use the `run:` prefixed name:
+
+```bash
+pnpm nx run artillery:run:pkp-sign          # PKP signing focus
+pnpm nx run artillery:run:encrypt-decrypt   # Encryption/decryption focus
+pnpm nx run artillery:run:execute           # Lit Action execution
+pnpm nx run artillery:run:mix               # Mixed workload
+pnpm nx run artillery:run:sign-session-key  # Session key signing
+```
+
 # Manual Publishing
 
 ```bash

apps/explorer/.eslintrc.json

@@ -0,0 +1,10 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

apps/explorer/.gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.vercel
+.cursor
+.env
+.plan

apps/explorer/Dockerfile

@@ -0,0 +1,21 @@
+# This file is generated by Nx.
+#
+# Build the docker image with `pnpm nx run explorer:docker-build`.
+# Tip: Modify "docker-build" options in project.json to change docker build args.
+#
+# Run the container with `docker run -p 4173:80 -t explorer`.
+FROM --platform=linux/amd64 docker.io/nginx:alpine
+
+ENV NODE_ENV=production
+
+# Remove default nginx site content
+RUN rm -rf /usr/share/nginx/html/*
+
+# Copy SPA routing config
+COPY apps/explorer/nginx.conf /etc/nginx/conf.d/default.conf
+
+# Copy the static assets produced by `nx run explorer:build`
+COPY apps/explorer/dist /usr/share/nginx/html
+
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

apps/explorer/README.md

@@ -0,0 +1,72 @@
+# Lit Explorer Naga
+
+Lit Explorer Naga is an application that allows you to authenticate with Lit Protocol using the native Lit auth methods.
+
+# Env vars
+
+```bash
+# Global Settings
+VITE_LOGIN_SERVICE_URL=https://login.litgateway.com
+VITE_LOGIN_DISCORD_CLIENT_ID=1052874239658692668
+
+# Network-Specific Auth Service URLs
+VITE_AUTH_SERVICE_URL_NAGA_DEV=https://naga-dev-auth-service.getlit.dev
+VITE_AUTH_SERVICE_URL_NAGA_TEST=https://naga-test-auth-service.getlit.dev
+VITE_AUTH_SERVICE_URL_NAGA=https://naga-auth-service.getlit.dev
+```
+
+## Getting started
+
+```
+pnpm install
+pnpm nx run explorer:dev
+```
+
+## Docker
+
+To produce a deployable container:
+
+```
+pnpm nx run explorer:build
+pnpm nx run explorer:docker-build
+docker run -p 4173:80 explorer
+```
+
+The image serves the built assets via Nginx and includes SPA routing so client-side navigation works.
+
+## Adding Lit Action examples
+
+- Add a new file in `src/lit-action-examples/entries/` that default-exports a `LitActionExample`. The `id` must be unique.
+- Use `String.raw` to define multiline snippets, e.g. ``const code = String.raw\`...\`;`` and fill in `title`, optional `description`, `order`, and any default `jsParams`.
+- The registry auto-loads every file in that directory, so your example will appear in the Lit Action editor once you save and refresh the app.
+- Prefer small, focused samples that demonstrate a single concept; link to docs inside the description if extra context is needed.
+
+## FAQs
+
+### What "logged-in" means here
+
+- You are considered "logged-in" when both a PKP and an auth context exist in state.
+
+### How you become "logged-in"
+
+After authenticating with a method (Google, Discord, WebAuthn, EOA, Stytch, Custom), either:
+
+- You select an existing PKP in the PKP selection section
+- You mint a new PKP and immediately create `authContext`, then set `user`
+
+### What redirect happens and when
+
+The `<LitAuthProvider />` does not redirect on successful login. It simply closes the modal once user is set and isAuthenticated becomes true.
+
+The dashboard is always the index route for `/`, and it conditionally renders based on auth state from context. When the user logs in, React re-renders the same component with different UI.
+
+Inside `LoggedInDashboard`, it reads user from `useLitAuth()`. If there’s no user, it shows a sign-in experience and, in popup mode, auto-opens the modal.
+
+# Screenshots
+
+## Login Modal
+
+![Login Modal](./public/screenshot-1.png)
+
+## Logged in Dashboard
+![Logged in Dashboard](./public/screenshot-2.png)