Merge pull request #1189 from multiversx/development

Development to main

Author: popenta

README.md

@@ -23,6 +23,7 @@ In order to ensure that the newly added content is correctly aligned and every M
 
 - clone the repository
 - run `npm install` (only for the first usage)
+- run `npm run build`
 - run `npm start`
 - access `http://localhost:3000` to view your local version of the docs
 

docs/sdk-and-tools/elastic-search.md

@@ -148,6 +148,7 @@ Each entry in an Elasticsearch index will have a format similar to this:
 | [events](/sdk-and-tools/indices/es-index-events)                           | Contains all the events generated by transactions and smart contract results. |
 | [delegators](/sdk-and-tools/indices/es-index-delegators)                   | Contains details about all the delegators.                                    |
 | [operations](/sdk-and-tools/indices/es-index-operations)                   | Contains all transactions and smart contract results.                         |
+| [executionresults](/sdk-and-tools/indices/es-index-executionresults)       | Contains all execution results generated by blocks execution.                 |
 
 [comment]: # (mx-context-auto)
 

docs/sdk-and-tools/indices/executionresults.md

@@ -0,0 +1,80 @@
+---
+id: es-index-executionresults
+title: execution results
+description: "Elasticsearch executionresults index: execution result block hash, header fields and example queries."
+---
+
+[comment]: # (mx-abstract)
+
+This page describes the structure of the `executionresults` index (Elasticsearch), and also depicts a few examples of how to query it.
+
+[comment]: # (mx-context-auto)
+
+## _id
+
+The _id field of this index is the block hash associated with the execution result, in a hexadecimal encoding.
+
+[comment]: # (mx-context-auto)
+
+## Fields
+
+[comment]: # (table:blocks)
+
+| Field                | Description                                                                                                                                                        |
+|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| nonce                | The nonce field represents the sequence number of the block (block height) associated with the execution result.                                                   |
+| round                | The round field represents the round of the block associated with the execution result.                                                                            |
+| epoch                | The epoch field represents the epoch of the block associated with the execution result.                                                                            |
+| miniBlocksHashes     | The miniBlocksHashes field contains an array of the miniblock hashes (hexadecimal encoded) that were included in the block.                                        |
+| miniBlocksDetails    | The miniBlocksDetails field contains an array of structures indicating processing details of the miniblocks, such as the index of the first processed transaction. |
+| timestampMs          | The timestampMs field represents the timestamp of the block associated with the execution result.                                                                  |
+| rootHash             | The rootHash field represents the trie's state root hash when of the block associated with the execution result.                                                   |
+| shardId              | The shardId field represents the shard this block belongs to.                                                                                                      |
+| txCount              | The txCount field represents the number of transactions from the block associated with the execution result.                                                       |
+| gasUsed              | The gasUsed field represents the total gas that was used in the block associated with the execution result.                                                        | 
+| accumulatedFees      | The accumulatedFees field represents the accumulated fees that were paid in the block associated with the execution result.                                        |
+| developerFees        | The developerFees field represents the developer fees that were accumulated in the block.                                                                          |
+| epochStartInfo       | The epochStartInfo field is a structure that contains economic data, such as total supply.                                                                         |
+| notarizedInBlockHash | The notarizedInBlockHash field represents the hash of the block in which the execution result was notarized.                                                       |
+
+[comment]: # (mx-context-auto)
+
+### Fetch blocks for a shard
+In order to fetch the latest execution results from a shard, one has to do a query that matches the field `shardId`.
+```
+curl --request GET \
+  --url ${ES_URL}/executionresults/_search \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "query": {
+        "match": {
+            "shardId": "1"
+        }
+    },
+    "sort": [
+        {
+            "timestamp": {
+                "order": "desc"
+            }
+        }
+    ]
+}'
+```
+
+### Fetch the latest 10 execution results for all shards
+
+```
+curl --request GET \
+  --url ${ES_URL}/executionresults/_search \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "sort": [
+        {
+            "timestamp": {
+                "order": "desc"
+            }
+        }
+    ],
+    "size":10
+}'
+```

docs/tokens/fungible-tokens.mdx

@@ -858,7 +858,7 @@ values={[
 ]}>
 <TabItem value="Request">
 
-Returns an array of ESDT Tokens that the specified address has interacted with (issued, sent or received).
+Returns an array of ESDT Tokens owned by the specified address.
 
 ```bash
 https://gateway.multiversx.com/address/*bech32Address*/esdt

docs/validators/rating.md

@@ -115,7 +115,7 @@ The node chosen to propose the block for a specific round will:
 
 Observe that the loss is 4 times larger than the gain, which means that a proposer must succeed 4 times to gain the points lost for a single missed block.
 
-Rating for proposers is even stricter: there is a compounding penalty rule, which makes the rating of a node drop even faster when it proposes unsuccessfuly.
+Rating for proposers is even stricter: there is a compounding penalty rule, which makes the rating of a node drop even faster when it proposes unsuccessfully.
 
 The amount of `0.92592` points is deducted from the rating of the proposer on the first unsuccessful proposal, but the second unsuccessful proposal will be penalized by `0.92592 × 1.1`. The third, by `0.92592 × 1.1 × 1.1`. The general formula is: