Differences

This shows you the differences between two versions of the page.

--- robinnet:testing [2026/03/11 15:23] – created freedomotter
+++ robinnet:testing [2026/03/11 15:51] (current) – [Next Step] freedomotter
@@ Line 1: / Line 1: @@
-====== RobinNet Testing Workflow ======
+====== RobinNet Testing ======
-Testing RobinNet locally is easiest using two nodes.
+This page explains how to test RobinNet locally.
+The easiest approach is running two nodes on one machine.
 -----
@@ Line 25: / Line 27: @@
 -----
-===== Add Peer =====
+===== Initialize Each Node =====
-From node A:
+Node A:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
+  init-node \
+  --name alpha \
+  --operator "Rich"
+</code>
+Node B:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/bravo.db \
+  init-node \
+  --name bravo \
+  --operator "Rich"
+</code>
+-----
+===== Add Peers =====
+Add Node B as a peer of Node A:
 <code bash>
@@ Line 36: / Line 62: @@
   --url http://127.0.0.1:8082
 </code>
+You can also add Node A to Node B.
 -----
-===== Post Bulletin =====
+===== Test Peer Connectivity =====
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
+  peer-test \
+  --peer-id 1
+</code>
+This command checks:
+  * API connectivity
+  * remote node identity
+  * health endpoint
+-----
+===== Create Test Messages =====
+Generate test bulletins:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
+  generate-test-data \
+  --count 5
+</code>
+List messages:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
+  list-messages
+</code>
+-----
+===== Manual Bulletin Test =====
+Create a message:
 <code bash>
@@ Line 52: / Line 120: @@
 ===== Sync Nodes =====
+Pull and push messages:
 <code bash>
 python -m robinnet.cli \
-  --db ./data/bravo.db \
+  --db ./data/alpha.db \
+  sync-all
+</code>
+You can also sync a single peer:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
   sync-peer \
   --peer-id 1
@@ Line 62: / Line 140: @@
 -----
-===== Verify Replication =====
+===== Verify Message Replication =====
+Check Node B:
 <code bash>
@@ Line 70: / Line 150: @@
 </code>
-You should see the message created on node A.
+You should see the messages created on Node A.
+-----
+===== Inspect Message Trace =====
+Trace the path of a message:
+<code bash>
+python -m robinnet.cli \
+  --db ./data/alpha.db \
+  show-trace \
+  --msg-uuid <uuid>
+</code>
+This displays the message propagation history.
+-----
+===== Next Step =====
+After testing the CLI and API, see:
+[[robin_net:start|RobinNet Start Page]]