From df3eb4e5e3b068cf90f75d7738b13e5fd822f475 Mon Sep 17 00:00:00 2001 From: Igor Lins e Silva <4753812+igorls@users.noreply.github.com> Date: Wed, 3 Jun 2026 01:09:01 -0300 Subject: [PATCH 1/3] docs(api): document hot_first_actions / hot_first_window and hot_only Documents the opt-in hot-first routing config for get_actions account polls (api config reference + example config) and adds the previously-undocumented hot_only query param to the v2 get_actions endpoint reference. Pairs with hyperion-history-api#176. --- docs/api/v2.md | 1 + docs/providers/setup/chain.md | 4 ++++ 2 files changed, 5 insertions(+) diff --git a/docs/api/v2.md b/docs/api/v2.md index 7c2c933..abc597e 100644 --- a/docs/api/v2.md +++ b/docs/api/v2.md @@ -64,6 +64,7 @@ Get past actions based on notified account. | simple | query | Simplified output mode | No | boolean | | noBinary | query | exclude large binary data | No | boolean | checkLib | query | perform reversibility check | No | boolean +| hot_only | query | Search only the newest action partition(s) instead of the full history. Useful for fetching the latest actions without fanning out across old shards | No | boolean !!! note diff --git a/docs/providers/setup/chain.md b/docs/providers/setup/chain.md index c576ecf..05a7169 100644 --- a/docs/providers/setup/chain.md +++ b/docs/providers/setup/chain.md @@ -21,6 +21,8 @@ with its default value and an example of real usage. - `"get_links": 1000` - `"get_deltas": 1000` - `"access_log": false` ⇒ Enable log API access. +- `"hot_first_actions": false` ⇒ When enabled, an unbounded newest-first `get_actions` account poll (e.g. `?account=eosio.token`, `sort=desc`, no `before`/`after`, no pagination) searches only the most recent action partition(s) first, widening to the full index set **only** if that window returns fewer than `limit` hits. Keeps high-frequency polling for the latest actions off the older/warm shards. Default off; safe to enable without reindexing. *(Note: while a poll is served from the hot window, the response `total` reflects that window only.)* +- `"hot_first_window": 2` ⇒ Number of newest action partitions searched in the hot window when `hot_first_actions` is enabled. Default `2` (covers the live partition plus the previous one across a rollover). - `"explorer"` ⇒ Explorer configuration (see [Explorer Setup](../explorer.md)) - `"upstream": "http://127.0.0.1:4777"` ⇒ URL of the Explorer SSR server - `"theme": "default"` ⇒ Theme name (matches `.theme.mjs` in explorer/themes/) @@ -159,6 +161,8 @@ to `chains/eos.config.json`. The next step is to edit the file as the following: "get_deltas": 1000 }, "access_log": false, + "hot_first_actions": false, + "hot_first_window": 2, "explorer": { "upstream": "http://127.0.0.1:4777", "theme": "default", From a4a78a59f964a2eba3ac6de210e0d801453f576c Mon Sep 17 00:00:00 2001 From: Igor Lins e Silva <4753812+igorls@users.noreply.github.com> Date: Wed, 3 Jun 2026 01:43:20 -0300 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/api/v2.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/api/v2.md b/docs/api/v2.md index abc597e..a1bcdb1 100644 --- a/docs/api/v2.md +++ b/docs/api/v2.md @@ -62,9 +62,9 @@ Get past actions based on notified account. | after | query | Filter actions after specified date (ISO8601) | No | string | | before | query | Filter actions before specified date (ISO8601) | No | string | | simple | query | Simplified output mode | No | boolean | -| noBinary | query | exclude large binary data | No | boolean -| checkLib | query | perform reversibility check | No | boolean -| hot_only | query | Search only the newest action partition(s) instead of the full history. Useful for fetching the latest actions without fanning out across old shards | No | boolean +| noBinary | query | exclude large binary data | No | boolean | +| checkLib | query | perform reversibility check | No | boolean | +| hot_only | query | Search only the newest action partition(s) instead of the full history. Useful for fetching the latest actions without fanning out across old shards | No | boolean | !!! note From 9bdc776f5a70a8953cc5f5a949929621a991a58a Mon Sep 17 00:00:00 2001 From: Igor Lins e Silva <4753812+igorls@users.noreply.github.com> Date: Wed, 3 Jun 2026 01:43:32 -0300 Subject: [PATCH 3/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/providers/setup/chain.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/providers/setup/chain.md b/docs/providers/setup/chain.md index 05a7169..cab935c 100644 --- a/docs/providers/setup/chain.md +++ b/docs/providers/setup/chain.md @@ -21,7 +21,7 @@ with its default value and an example of real usage. - `"get_links": 1000` - `"get_deltas": 1000` - `"access_log": false` ⇒ Enable log API access. -- `"hot_first_actions": false` ⇒ When enabled, an unbounded newest-first `get_actions` account poll (e.g. `?account=eosio.token`, `sort=desc`, no `before`/`after`, no pagination) searches only the most recent action partition(s) first, widening to the full index set **only** if that window returns fewer than `limit` hits. Keeps high-frequency polling for the latest actions off the older/warm shards. Default off; safe to enable without reindexing. *(Note: while a poll is served from the hot window, the response `total` reflects that window only.)* +- `"hot_first_actions": false` ⇒ When enabled, an unbounded newest-first `get_actions` account poll (e.g. `?account=eosio.token&sort=desc`, no `before`/`after`, no pagination) searches only the most recent action partition(s) first, widening to the full index set **only** if that window returns fewer than `limit` hits. Keeps high-frequency polling for the latest actions off the older/warm shards. Default off; safe to enable without reindexing. *(Note: while a poll is served from the hot window, the response `total` reflects that window only.)* - `"hot_first_window": 2` ⇒ Number of newest action partitions searched in the hot window when `hot_first_actions` is enabled. Default `2` (covers the live partition plus the previous one across a rollover). - `"explorer"` ⇒ Explorer configuration (see [Explorer Setup](../explorer.md)) - `"upstream": "http://127.0.0.1:4777"` ⇒ URL of the Explorer SSR server