feat: adopt nano-core defaults and flat nano config

Author: cbrunnkvist

README.md

@@ -11,7 +11,7 @@ RaiFlow is in the middle of a v2 rebuild.
 What is true today:
 
 - The v2 foundation packages exist and build: `config`, `storage`, `events`, `rpc`, `custody`
-- The daemon boots from `raiflow.yaml`
+- The daemon boots from `raiflow.yml`
 - SQLite migrations run on startup
 - The event store and event bus are implemented
 - The RPC package has multi-node client/failover primitives
@@ -128,10 +128,14 @@ pnpm install
 2. Create a config file:
 
 ```bash
-cp raiflow.yaml.example raiflow.yaml
+cp raiflow.yml.example raiflow.yml
 ```
 
-3. Fill in the required environment variables referenced by `raiflow.yaml`
+3. Fill in any environment variables referenced by the features you enable in `raiflow.yml`
+
+   For the default example, none are required just to boot locally. `NANO_RPC_URL`,
+   `NANO_WS_URL`, and `NANO_WORK_URL` are optional endpoint overrides. `RAIFLOW_SEED` and
+   `RAIFLOW_REPRESENTATIVE` are only needed when you enable custody-backed features.
 
 4. Build the workspace:
 

apps/site/docs/runtime/index.md

@@ -6,7 +6,7 @@ This page describes the runtime as it exists today, not only as it is intended t
 
 The runtime currently does these things reliably:
 
-- boots from `raiflow.yaml`
+- boots from `raiflow.yml`
 - opens SQLite storage and runs migrations
 - wires the event store and event bus
 - exposes a small HTTP surface inherited from the earlier invoice prototype
@@ -66,32 +66,39 @@ Do not assume the current codebase has complete production-grade auth behavior w
 
 ## Configuration
 
-Runtime startup uses `raiflow.yaml`.
+Runtime startup uses `raiflow.yml`.
 
 Example shape:
 
 ```yaml
 daemon:
   host: "0.0.0.0"
   port: 3100
-  apiKey: "env:RAIFLOW_API_KEY"
+  # apiKey: "env:RAIFLOW_API_KEY"
 
 nano:
-  nodes:
-    - rpc: "env:NANO_RPC_URL"
-      ws: "env:NANO_WS_URL"
-      priority: 1
+  rpc: []
+  ws: []
+  work: []
+  # rpc: ["env:NANO_RPC_URL"]
+  # ws: ["env:NANO_WS_URL"]
+  # work: ["env:NANO_WORK_URL"]
 
-custody:
-  seed: "env:RAIFLOW_SEED"
-  representative: "env:RAIFLOW_REPRESENTATIVE"
+# custody:
+#   seed: "env:RAIFLOW_SEED"
+#   representative: "env:RAIFLOW_REPRESENTATIVE"
 
 storage:
   driver: "sqlite"
   path: "./raiflow.db"
 ```
 
-See the repository `raiflow.yaml.example` for the full current example.
+With `@openrai/nano-core` v2, `NANO_RPC_URL`, `NANO_WS_URL`, and `NANO_WORK_URL`
+are best treated as optional endpoint overrides rather than mandatory startup
+variables. A custody `representative` is still required if you enable the
+`custody` block.
+
+See the repository `raiflow.yml.example` for the full current example.
 
 ## Read With Care
 

docs/architectural-review.md

@@ -227,20 +227,16 @@ Common error codes:
 ## Configuration Shape
 
 ```yaml
-# raiflow.yaml
+# raiflow.yml
 daemon:
   host: "127.0.0.1"
   port: 7400
   apiKey: "env:RAIFLOW_API_KEY"
 
 nano:
-  nodes:
-    - rpc: "http://localhost:7076"
-      ws: "ws://localhost:7078"
-      priority: 1
-    - rpc: "http://backup:7076"
-      ws: "ws://backup:7078"
-      priority: 2
+  rpc: ["http://localhost:7076", "http://backup:7076"]
+  ws: ["ws://localhost:7078", "ws://backup:7078"]
+  work: []
 
 custody:
   seed: "env:RAIFLOW_SEED"
@@ -272,7 +268,7 @@ logging:
 Each milestone is complete when:
 
 **M1 (Foundation)**
-- `raiflow` starts from `raiflow.yaml`
+- `raiflow` starts from `raiflow.yml`
 - Migrations run automatically
 - Auth rejects unauthenticated requests
 - `GET /health` returns `{"status":"ok"}`

docs/progress.md

@@ -64,7 +64,6 @@ Building in order:
 
 Current frontier:
 - RaiFlow `packages/rpc` now consumes the local `@openrai/nano-core` transport pools instead of maintaining its own HTTP/WebSocket transport primitives.
-- The workspace is temporarily linked to the sibling `../nano-core` checkout so transport/auth work can land and be validated end-to-end before publish.
 - RaiFlow `packages/watcher` RPC polling and WebSocket observation now also consume the local `@openrai/nano-core` transport pools.
 - `nano-core` defaults now reflect the April 2026 endpoint policy: four default RPC endpoints, `wss://rpc.nano.to` for WS, and `https://rpc.nano.to` as the only default public work endpoint.
 - `packages/rpc` now derives `connected` and `failover` state changes from the shared transport foundation rather than maintaining a disconnected placeholder view of active node state.

examples/htmx-wallet/package.json

@@ -10,6 +10,6 @@
   "dependencies": {
     "express": "^4.19.0",
     "@openrai/raiflow-sdk": "workspace:*",
-    "@openrai/nano-core": "link:../../../nano-core"
+    "@openrai/nano-core": "2.1.0"
   }
 }

examples/next-checkout/package.json

@@ -13,6 +13,6 @@
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
     "@openrai/raiflow-sdk": "workspace:*",
-    "@openrai/nano-core": "link:../../../nano-core"
+    "@openrai/nano-core": "2.1.0"
   }
 }

packages/config/package.json

@@ -14,14 +14,15 @@
   },
   "scripts": {
     "build": "tsc",
-    "test": "echo \"No tests yet\"",
+    "test": "vitest run",
     "lint": "tsc --noEmit"
   },
   "dependencies": {
     "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "vitest": "^2.1.9"
   }
 }

packages/config/src/__tests__/index.test.ts

@@ -0,0 +1,46 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { loadConfig } from '../index.js';
+
+function writeConfig(contents: string): string {
+  const dir = mkdtempSync(join(tmpdir(), 'raiflow-config-'));
+  const path = join(dir, 'raiflow.yml');
+  writeFileSync(path, contents, 'utf8');
+  return path;
+}
+
+const tempPaths: string[] = [];
+
+afterEach(() => {
+  for (const path of tempPaths.splice(0)) {
+    rmSync(path, { recursive: true, force: true });
+  }
+});
+
+describe('loadConfig nano transport arrays', () => {
+  it('accepts an empty nano block', () => {
+    const path = writeConfig('nano: {}\n');
+    tempPaths.push(path.replace(/\/raiflow\.yml$/, ''));
+
+    const config = loadConfig(path);
+    expect(config.nano).toEqual({ rpc: [], ws: [], work: [] });
+  });
+
+  it('accepts flat rpc override list', () => {
+    const path = writeConfig('nano:\n  rpc: ["https://rpc.example.com"]\n');
+    tempPaths.push(path.replace(/\/raiflow\.yml$/, ''));
+
+    const config = loadConfig(path);
+    expect(config.nano).toEqual({ rpc: ['https://rpc.example.com'], ws: [], work: [] });
+  });
+
+  it('accepts flat rpc, ws, and work override lists', () => {
+    const path = writeConfig('nano:\n  rpc: ["https://rpc.example.com"]\n  ws: ["wss://ws.example.com"]\n  work: ["https://work.example.com"]\n');
+    tempPaths.push(path.replace(/\/raiflow\.yml$/, ''));
+
+    const config = loadConfig(path);
+    expect(config.nano).toEqual({ rpc: ['https://rpc.example.com'], ws: ['wss://ws.example.com'], work: ['https://work.example.com'] });
+  });
+});

packages/config/src/index.ts

@@ -9,14 +9,10 @@ export interface DaemonConfig {
   apiKey?: string;
 }
 
-export interface NanoNodeConfig {
-  rpc: string;
-  ws: string;
-  priority: number;
-}
-
 export interface NanoConfig {
-  nodes: NanoNodeConfig[];
+  rpc: string[];
+  ws: string[];
+  work: string[];
 }
 
 export interface CustodyConfig {
@@ -168,16 +164,19 @@ function parseDaemon(obj: Record<string, unknown>): DaemonConfig {
 
 function parseNano(obj: Record<string, unknown>): NanoConfig {
   const nano = isObject(obj.nano) ? obj.nano : {};
-  const nodes = Array.isArray(nano.nodes) ? nano.nodes : [];
+  const rpc = Array.isArray(nano.rpc)
+    ? (resolveEnvValue(nano.rpc) as unknown[]).filter(isString)
+    : [];
+  const ws = Array.isArray(nano.ws)
+    ? (resolveEnvValue(nano.ws) as unknown[]).filter(isString)
+    : [];
+  const work = Array.isArray(nano.work)
+    ? (resolveEnvValue(nano.work) as unknown[]).filter(isString)
+    : [];
   return {
-    nodes: nodes.map((n, i) => {
-      if (!isObject(n)) throw new Error(`config.nano.nodes[${i}] must be an object`);
-      return {
-        rpc: resolveEnv(requireString(n as Record<string, unknown>, 'rpc')),
-        ws: resolveEnv(requireString(n as Record<string, unknown>, 'ws')),
-        priority: requireNumber(n as Record<string, unknown>, 'priority'),
-      };
-    }),
+    rpc,
+    ws,
+    work,
   };
 }
 

packages/custody/package.json

@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "@openrai/model": "workspace:*",
-    "@openrai/nano-core": "link:../../../nano-core",
+    "@openrai/nano-core": "2.1.0",
     "nanocurrency": "^2.5.0"
   },
   "devDependencies": {