From fe72491dea7cc6c00e86e3f8dc9a6dde10658554 Mon Sep 17 00:00:00 2001
From: necrashter
Date: Sun, 24 Apr 2022 21:37:51 +0300
Subject: Clarifications on transactions and blocks

---
 content/transaction_docs.md | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

(limited to 'content/transaction_docs.md')

diff --git a/content/transaction_docs.md b/content/transaction_docs.md
index 72c1ef7..a4617a6 100644
--- a/content/transaction_docs.md
+++ b/content/transaction_docs.md
@@ -24,19 +24,23 @@ timestamp: ISO 8601 <date>T<time>
 # Hash
 `tha` field in [jwt documentation](@/JWT.md) in fact stands for "The Hash".
 In the context of a transaction proposal, you need the [Md5](https://en.wikipedia.org/wiki/MD5) hash of the serialized JSON representation of transaction.
-Serializing in this context is a simple JSON to string conversion with key, value pairs enclosed with quotation marks (").
-The resulting JSON string should look something like;
+Since there are many ways to convert an object to JSON, we enforce the following rules (alongside the regular rules of JSON syntax) for consistency:
+- There shouldn't be any whitespace or newlines in the serialized string.
+- The order of fields should be exactly as shown above.
+- All keys and string values must be enclosed with quotation marks (`"`).
 
+Here's an example demostrating how your JSON string should look like:
 ```
 {"source":"bar","target":"baz","amount":2,"timestamp":"2021-04-18T21:49:00"}
 ```
 
-Or; without any whitespace, separated with `:` and `,`.
-
 # Transaction Rules
 - Transactions should be sent from your account (`source`) to any other account (`target`).
-- No two transaction with the same `source`/`target` pair can appear on the pending transaction list [/transactions](/transaction).
-- Transactions generate traffic which is something we desperately need in Gradecoin, so for every transaction you send, some Gradecoin will be generated out of thin air and will appear on the target.
+- You cannot create multiple transactions with the same `source`/`target` pair.
+- Transactions generate traffic which is something we desperately need in Gradecoin, so for every transaction you send, some Gradecoin will be generated out of thin air and will appear on your account.
+    - The amount of Gradecoin that will be generated is given by `tx_traffic_reward` field of [`/config`](/config).
+    - For example, if `tx_traffic_reward` is 1 and you send 2 coins, only 1 coin will be deduced from your account since you will be given 1 coin for generating traffic. The target will receive 2 coins.
 - Don't worry if your transaction goes unaccepted! Transactions do not disappear until they are committed into the ledger with a block.
 - Every transaction has a unique ID generated using the `source`, `target` and `timestamp` fields.
-- Transactions have an upper amount limit.
+- Transactions have a lower and upper amount limit.
+    - These are given by `tx_lower_limit` and `tx_upper_limit` fields of [`/config`](/config). See [misc page](@/misc_docs.md) for more information about configuration.
-- 
cgit v1.2.3-70-g09d2