====== RobinNet Testing ======

This page explains how to test RobinNet locally.

The easiest approach is running two nodes on one machine.

-----

===== Start Node A =====

<code bash>
ROBINNET_DB=./data/alpha.db \
ROBINNET_PORT=8081 \
python -m robinnet.main
</code>

-----

===== Start Node B =====

<code bash>
ROBINNET_DB=./data/bravo.db \
ROBINNET_PORT=8082 \
python -m robinnet.main
</code>

-----

===== Initialize Each Node =====

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>
python -m robinnet.cli \
  --db ./data/alpha.db \
  add-peer \
  --name bravo \
  --url http://127.0.0.1:8082
</code>

You can also add Node A to Node B.

-----

===== 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>
python -m robinnet.cli \
  --db ./data/alpha.db \
  post-bulletin \
  --title "Test Message" \
  --body "Hello RobinNet"
</code>

-----

===== Sync Nodes =====

Pull and push messages:

<code bash>
python -m robinnet.cli \
  --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
</code>

-----

===== Verify Message Replication =====

Check Node B:

<code bash>
python -m robinnet.cli \
  --db ./data/bravo.db \
  list-messages
</code>

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]]