Add Local network (#5)

* add local network option

* improve README

Author: ftheirs

README.md

@@ -16,7 +16,7 @@ pnpm install
 ## Environment variables
 
 Required:
-- `NETWORK` (`testnet` or `stagenet`)
+- `NETWORK` (`testnet`, `stagenet` or `local`)
 
 Optional:
 - none (health checks are unauthenticated)
@@ -26,6 +26,17 @@ Optional:
 Network URLs/IDs are intentionally **hardcoded** in `src/networks.ts` and are copied from `datahaven-monitor`:
 - **Testnet**: MSP `https://deo-dh-backend.testnet.datahaven-infra.network`
 - **Stagenet**: MSP `https://deo-dh-backend.stagenet.datahaven-infra.network`
+- **Local**: MSP `http://127.0.0.1:8080`, RPC `http://127.0.0.1:9888`
+
+Local notes:
+- `NETWORK=local` matches the “normal” local StorageHub defaults when you boot a local network from the StorageHub repo with:
+  - `pnpm docker:start:solochain-evm:initialised`
+  - See StorageHub docs: [Spawning solochain-evm-initialised fullnet](https://github.com/Moonsong-Labs/storage-hub/tree/main/test#spawning-solochain-evm-initialised-fullnet)
+- It assumes:
+  - MSP at `http://127.0.0.1:8080`
+  - EVM/Substrate RPC at `http://127.0.0.1:9888` / `ws://127.0.0.1:9888`
+- **SIWE domain/uri**: these should be provided by the dApp doing SIWE (they are not “network” properties). For local testing, a dApp often runs on `localhost:3000` or `localhost:3001`.
+  - `localhost:3001` / `http://localhost:3001` is what the StorageHub repo’s `demo-app` (SDK examples) commonly uses.
 
 ## Commands
 
@@ -37,6 +48,16 @@ Network URLs/IDs are intentionally **hardcoded** in `src/networks.ts` and are co
 - `pnpm test:msp-unauth` — standalone unauth MSP load test (no SIWE, no keys)
 - `pnpm test:download` — file download load test (requires SIWE auth + FILE_KEY)
 
+Examples (local):
+
+```bash
+NETWORK=local pnpm test:msp-unauth
+```
+
+```bash
+NETWORK=local STORAGEHUB_PRIVATE_KEY=0x... pnpm test
+```
+
 ## Logging
 
 Logging is handled by **Pino**.

src/config.ts

@@ -1,5 +1,5 @@
 export type Env = Readonly<{
-  network: "testnet" | "stagenet";
+  network: "testnet" | "stagenet" | "local";
 }>;
 
 function getRequiredEnv(key: string): string {
@@ -12,9 +12,13 @@ function getRequiredEnv(key: string): string {
 
 export function readEnv(): Env {
   const networkRaw = getRequiredEnv("NETWORK");
-  if (networkRaw !== "testnet" && networkRaw !== "stagenet") {
+  if (
+    networkRaw !== "testnet" &&
+    networkRaw !== "stagenet" &&
+    networkRaw !== "local"
+  ) {
     throw new Error(
-      `Invalid NETWORK: ${networkRaw} (expected 'testnet' or 'stagenet')`
+      `Invalid NETWORK: ${networkRaw} (expected 'testnet', 'stagenet' or 'local')`
     );
   }
   const network = networkRaw;

src/networks.ts

@@ -1,12 +1,12 @@
-export type NetworkName = "testnet" | "stagenet";
+export type NetworkName = "testnet" | "stagenet" | "local";
 
 export type NetworkConfig = Readonly<{
   name: NetworkName;
   chain: Readonly<{
     id: number;
     name: string;
     evmRpcUrl: string;
-    substrateWsUrl: `wss://${string}`;
+    substrateWsUrl: `${"ws" | "wss"}://${string}`;
     filesystemPrecompileAddress: `0x${string}`;
   }>;
   msp: Readonly<{
@@ -53,11 +53,29 @@ export const NETWORKS: Readonly<Record<NetworkName, NetworkConfig>> = {
       siweUri: "https://deo-dh-backend.stagenet.datahaven-infra.network",
     },
   },
+  local: {
+    name: "local",
+    chain: {
+      id: 181222,
+      name: "StorageHub Solochain EVM",
+      evmRpcUrl: "http://127.0.0.1:9888",
+      substrateWsUrl: "ws://127.0.0.1:9888",
+      filesystemPrecompileAddress: "0x0000000000000000000000000000000000000064",
+    },
+    msp: {
+      baseUrl: "http://127.0.0.1:8080",
+      timeoutMs: 60_000,
+      siweDomain: "localhost:3001",
+      siweUri: "http://localhost:3001",
+    },
+  },
 } as const;
 
 export function parseNetworkName(raw: string): NetworkName {
-  if (raw === "testnet" || raw === "stagenet") {
+  if (raw === "testnet" || raw === "stagenet" || raw === "local") {
     return raw;
   }
-  throw new Error(`Invalid NETWORK: ${raw} (expected 'testnet' or 'stagenet')`);
+  throw new Error(
+    `Invalid NETWORK: ${raw} (expected 'testnet', 'stagenet' or 'local')`
+  );
 }