Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
1 change: 1 addition & 0 deletions docs/sdk-and-tools/elastic-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
80 changes: 80 additions & 0 deletions docs/sdk-and-tools/indices/executionresults.md
Original file line number Diff line number Diff line change
@@ -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
}'
```
1 change: 1 addition & 0 deletions static/llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion static/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down