From b50ca743d32317929c5c6dd8f4d9c897d1211fdb Mon Sep 17 00:00:00 2001 From: miiu Date: Tue, 17 Feb 2026 15:17:54 +0200 Subject: [PATCH 1/5] execution results index --- .../sdk-and-tools/indices/executionresults.md | 80 +++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 docs/sdk-and-tools/indices/executionresults.md diff --git a/docs/sdk-and-tools/indices/executionresults.md b/docs/sdk-and-tools/indices/executionresults.md new file mode 100644 index 00000000..5b4b5404 --- /dev/null +++ b/docs/sdk-and-tools/indices/executionresults.md @@ -0,0 +1,80 @@ +--- +id: es-index-blocks +title: blocks +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 +}' +``` \ No newline at end of file From 8767c524a90a4a06b2323990674f13e06c1b9e4d Mon Sep 17 00:00:00 2001 From: miiu Date: Tue, 17 Feb 2026 15:18:05 +0200 Subject: [PATCH 2/5] empty line --- docs/sdk-and-tools/indices/executionresults.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sdk-and-tools/indices/executionresults.md b/docs/sdk-and-tools/indices/executionresults.md index 5b4b5404..77c57969 100644 --- a/docs/sdk-and-tools/indices/executionresults.md +++ b/docs/sdk-and-tools/indices/executionresults.md @@ -77,4 +77,4 @@ curl --request GET \ ], "size":10 }' -``` \ No newline at end of file +``` From 704cfd557bb94dfccf30e23ccbf2e27bef7c9dc6 Mon Sep 17 00:00:00 2001 From: miiu Date: Tue, 17 Feb 2026 15:23:20 +0200 Subject: [PATCH 3/5] fixes --- docs/sdk-and-tools/elastic-search.md | 1 + docs/sdk-and-tools/indices/executionresults.md | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/sdk-and-tools/elastic-search.md b/docs/sdk-and-tools/elastic-search.md index 1549389c..be111c20 100644 --- a/docs/sdk-and-tools/elastic-search.md +++ b/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) diff --git a/docs/sdk-and-tools/indices/executionresults.md b/docs/sdk-and-tools/indices/executionresults.md index 77c57969..d2aa3f84 100644 --- a/docs/sdk-and-tools/indices/executionresults.md +++ b/docs/sdk-and-tools/indices/executionresults.md @@ -1,6 +1,6 @@ --- -id: es-index-blocks -title: blocks +id: es-index-executionresults +title: execution results description: "Elasticsearch executionresults index: execution result block hash, header fields and example queries." --- From dc90e62271966545e7b9325d1d4b88191ab3ec53 Mon Sep 17 00:00:00 2001 From: miiu Date: Wed, 18 Feb 2026 15:45:41 +0200 Subject: [PATCH 4/5] regenerate files --- README.md | 1 + static/llms-full.txt | 1 + static/llms.txt | 2 +- 3 files changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index fd7b2cb1..1f94d52f 100644 --- a/README.md +++ b/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 build` - run `npm start` - access `http://localhost:3000` to view your local version of the docs diff --git a/static/llms-full.txt b/static/llms-full.txt index a9ab5067..537252bb 100644 --- a/static/llms-full.txt +++ b/static/llms-full.txt @@ -14656,6 +14656,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. | ## Troubleshooting diff --git a/static/llms.txt b/static/llms.txt index 6e166718..9bc16333 100644 --- a/static/llms.txt +++ b/static/llms.txt @@ -238,7 +238,7 @@ This documentation is organized into major sections. Each section includes tutor - [Architecture](https://docs.multiversx.com/bridge/architecture): High-level architecture of the Ad‑Astra Bridge: core contracts on MultiversX and EVM chains, relayer quorum, and how cross‑chain transfers are coordinated. - [Axelar Amplifier Setup](https://docs.multiversx.com/bridge/axelar): Set up an Axelar Amplifier verifier for MultiversX: prerequisites, tofnd and ampd services, configuration, and verification steps. - [Bitcoin L2](https://docs.multiversx.com/sovereign/bitcoin-l2): Concept and architecture for a Bitcoin‑compatible Sovereign L2 and VM integration. -- [Concept](https://docs.multiversx.com/sovereign/concept): Concept and rationale for Sovereign Chains: performance, configurability, VM options and built‑in cross‑chain mechanism. +- [Concept](https://docs.multiversx.com/sovereign/concept): Learn about MultiversX Sovereign Chain architecture, cross-chain mechanisms, and smart contracts. - [Cross Chain Execution](https://docs.multiversx.com/sovereign/cross-chain-execution): Concept and flow of cross‑chain execution between MultiversX and Sovereign Chains: contracts, bridge service and fees. - [Custom Configurations](https://docs.multiversx.com/sovereign/custom-configurations): Configuration options to tailor a Sovereign network: chain ID, economics, ratings and system smart‑contract parameters. - [Disclaimer](https://docs.multiversx.com/sovereign/disclaimer): Disclaimer on scope: MultiversX provides core chain SDK and scripts; full production infrastructure and some components may require separate integration. From c479e02efb93fb6920bfc397af88ea21f850aac1 Mon Sep 17 00:00:00 2001 From: miiu Date: Wed, 18 Feb 2026 15:49:05 +0200 Subject: [PATCH 5/5] regenerate files --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1f94d52f..b667a48e 100644 --- a/README.md +++ b/README.md @@ -23,7 +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 build` +- run `npm run build` - run `npm start` - access `http://localhost:3000` to view your local version of the docs