fix(ponder): require network in strict env

Document the Ponder runtime environment variables and make strict mode require PONDER_NETWORK alongside DATABASE_URL and RPC_URL.

Signed-off-by: Jakub Sztandera <oss@kubuxu.com>

Author: Kubuxu

apps/ponder/README.md

@@ -26,7 +26,18 @@ pnpm --filter @filoz/repair-ponder dev:calibnet
 ```
 
 Set `DATABASE_URL` and `RPC_URL` to override the local defaults.
-Set `PONDER_STRICT_ENV=true` to require both variables, which is recommended for deployments.
+
+Environment variables:
+
+| Variable | Values | Default | Strict mode |
+| --- | --- | --- | --- |
+| `PONDER_NETWORK` | `mainnet`, `calibnet` | `mainnet` | Required |
+| `DATABASE_URL` | PostgreSQL connection string | `postgres://ponder:ponder@localhost:17825/ponder` | Required |
+| `RPC_URL` | Filecoin JSON-RPC URL | `http://localhost:1234/rpc/v1` | Required |
+| `PONDER_STRICT_ENV` | `true`, `1` | unset | Enables strict mode |
+
+Set `PONDER_STRICT_ENV=true` to require `PONDER_NETWORK`, `DATABASE_URL`, and `RPC_URL`, which is recommended for
+deployments.
 
 ## Networks
 

apps/ponder/ponder.config.ts

@@ -6,8 +6,11 @@ import { rpcTransport } from './src/rpc.ts'
 const DEFAULT_DATABASE_URL = 'postgres://ponder:ponder@localhost:17825/ponder'
 const DEFAULT_RPC_URL = 'http://localhost:1234/rpc/v1'
 
-function parseNetwork(value: string | undefined): NetworkName {
-  if (value === undefined || value === '') return 'mainnet'
+function parseNetwork(value: string | undefined, strict: boolean): NetworkName {
+  if (value === undefined || value === '') {
+    if (strict) throw new Error('PONDER_NETWORK is required when PONDER_STRICT_ENV=true')
+    return 'mainnet'
+  }
   if (value === 'mainnet' || value === 'calibnet') return value
   throw new Error(`Unsupported PONDER_NETWORK "${value}". Expected "mainnet" or "calibnet".`)
 }
@@ -23,9 +26,9 @@ function env(name: string, fallback: string, strict: boolean): string {
   return fallback
 }
 
-const networkName = parseNetwork(process.env.PONDER_NETWORK)
-const network = NETWORKS[networkName]
 const strictEnv = parseStrictEnv(process.env.PONDER_STRICT_ENV)
+const networkName = parseNetwork(process.env.PONDER_NETWORK, strictEnv)
+const network = NETWORKS[networkName]
 
 export default createConfig({
   database: {