Add new docs

docs/fiatsent.md

@@ -0,0 +1,63 @@
+# Fiat sent
+
+## Overview
+
+All Mostro messages are [Parameterized Replaceable Events](https://github.com/nostr-protocol/nips/blob/master/01.md#kinds) and use `30078` as event `kind`, a list of standard event kinds can be found [here](https://github.com/nostr-protocol/nips#event-kinds)
+
+## Communication between users and Mostro
+
+All messages from/to Mostro should be a Nostr event [kind 4](https://github.com/nostr-protocol/nips/blob/master/04.md), the `content` field of the event should be a base64-encoded, aes-256-cbc encrypted JSON-serialized string (with no white space or line breaks) of the following structure:
+
+- `version`
+- `order_id` (optional)
+- `pubkey` (optional)
+- `action` (https://docs.rs/mostro-core/latest/mostro_core/enum.Action.html)
+- `content` (optional https://docs.rs/mostro-core/latest/mostro_core/enum.Content.html)
+
+## Buyer sends fiat money
+
+After the buyer sends the fiat money to the seller, the buyer should send a message to Mostro indicating that the fiat money was sent, the message will look like this:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": "npub1qqqt938cer4dvlslg04zwwf66ts8r3txp6mv79cx2498pyuqx8uq0c7qkj",
+  "action": "FiatSent",
+  "content": null
+}
+```
+
+## Mostro response
+
+Mostro send a messages to both parties confirming `FiatSent` action and sending again the counterpart pubkey, here an example of the message to the buyer:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": "npub1qqqt938cer4dvlslg04zwwf66ts8r3txp6mv79cx2498pyuqx8uq0c7qkj",
+  "action": "FiatSent",
+  "content": {
+    "Peer": {
+      "pubkey": "npub1qqqxssz4k6swex94zdg5s4pqx3uqlhwsc2vdzvhjvzk33pcypkhqe9aeq2"
+    }
+  }
+}
+```
+
+And here an example of the message to the seller:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": "npub1qqqxssz4k6swex94zdg5s4pqx3uqlhwsc2vdzvhjvzk33pcypkhqe9aeq2",
+  "action": "FiatSent",
+  "content": {
+    "Peer": {
+      "pubkey": "npub1qqqt938cer4dvlslg04zwwf66ts8r3txp6mv79cx2498pyuqx8uq0c7qkj"
+    }
+  }
+}
+```

docs/release.md

@@ -0,0 +1,69 @@
+# Release sats
+
+## Overview
+
+All Mostro messages are [Parameterized Replaceable Events](https://github.com/nostr-protocol/nips/blob/master/01.md#kinds) and use `30078` as event `kind`, a list of standard event kinds can be found [here](https://github.com/nostr-protocol/nips#event-kinds)
+
+## Communication between users and Mostro
+
+All messages from/to Mostro should be a Nostr event [kind 4](https://github.com/nostr-protocol/nips/blob/master/04.md), the `content` field of the event should be a base64-encoded, aes-256-cbc encrypted JSON-serialized string (with no white space or line breaks) of the following structure:
+
+- `version`
+- `order_id` (optional)
+- `pubkey` (optional)
+- `action` (https://docs.rs/mostro-core/latest/mostro_core/enum.Action.html)
+- `content` (optional https://docs.rs/mostro-core/latest/mostro_core/enum.Content.html)
+
+## Seller release sats
+
+After confirming the buyer sent the fiat money, the seller should send a message to Mostro indicating that sats should be delivered to the buyer, the message will look like this:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": "npub1qqqxssz4k6swex94zdg5s4pqx3uqlhwsc2vdzvhjvzk33pcypkhqe9aeq2",
+  "action": "Release",
+  "content": null
+}
+```
+
+## Mostro response
+
+Here an example of the Mostro response to the seller:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": null,
+  "action": "HoldInvoicePaymentSettled",
+  "content": null
+}
+```
+
+And a message to the buyer to let him know that the sats were released:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": null,
+  "action": "Released",
+  "content": null
+}
+```
+
+## Buyer receives sats
+
+Right after seller release sats Mostro will try to pay the buyer's lightning invoice, if the payment is successful Mostro will send a message to the buyer indicating that the purchase was completed:
+
+```json
+{
+  "version": "0",
+  "order_id": "ede61c96-4c13-4519-bf3a-dcf7f1e9d842",
+  "pubkey": null,
+  "action": "PurchaseCompleted",
+  "content": null
+}
+```

docs/take_sell.md

@@ -74,6 +74,8 @@ Here is how the buyer send the LN invoice to Mostro, in case the order has a fix
 
 ## Mostro response
 
+Mostro send the following message to the buyer:
+
 ```json
 {
   "version": "0",