document trade protocol messaging

README.md

@@ -32,7 +32,7 @@ Currently, efforts are focused in developing the core repository ('haveno'). If
 
 ## Trade protocol
 
-See [docs/trade-protocol.md](docs/trade-protocol.md)
+See [trade-protocol.md](docs/trade_protocol/trade-protocol.md)
 
 ## Keep in touch and help out!
 

docs/README.md

@@ -7,7 +7,7 @@ Here are stored most of the docs of the Haveno project:
 - [idea-import.md](idea-import.md) - Instructions for importing Haveno as an IntelliJ IDEA project (from Bisq))
 - [README.md](README.md) - This file
 - [tor-upgrade.md](tor-upgrade.md) - Instructions for upgrading the Tor dependencies used by Haveno (from Bisq)
-- [trade-protocol.md](trade-protocol.md) - The description of Haveno's trade protocol
+- [trade-protocol.md](trade_protocol/trade-protocol.md) - The description of Haveno's trade protocol
 
 Documents outside of this folder:
 

docs/trade_protocol/trade-protocol.md

@@ -8,7 +8,7 @@ Described here is the desired protocol for Haveno. Note that the discussion is s
 - **Seller** - person selling XMR
 - **Maker** - person making offer
 - **Taker** - person taking offer
-- **Arbitrator** - person resolving potential disputes
+- **Arbitrator** - entity resolving possible disputes
 
 For each trade, a trader is a buyer or seller and a maker or taker.
 
@@ -30,4 +30,10 @@ For each trade, a trader is a buyer or seller and a maker or taker.
 14. Arbitrator verifies contract and deposit transactions then relays deposit transactions to commit funds to multisig.
 15. Buyer pays seller (e.g. sends ETH) outside of Haveno after at least a few confirmations.
 16. When the multisig deposits are available (after ~20 minutes) and payment is acknowledged, maker and taker sign to release funds from multisig to payout addresses, or one trader opens a dispute with the arbitrator.
-17. Arbitrator resolves dispute if applicable.
+17. Arbitrator resolves dispute if applicable.
+
+Note: all steps involving the arbitrator are automatic except resolving disputes.
+
+## Protocol Messaging
+
+See [trade-protocol.pdf](trade-protocol.pdf) for documentation of network messages used by the trade protocol.