From b4d81ebfa662f258880ada40efc8e7f7129582d1 Mon Sep 17 00:00:00 2001 From: Fedor Ivanov Date: Thu, 26 Feb 2026 21:30:19 +0700 Subject: [PATCH 1/3] Deprecate envs related to migration to `language` field in `smart_contracts` table --- setup/env-variables/backend-env-variables.mdx | 5 +---- .../deprecated-env-variables/env-variables.mdx | 6 ++++-- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/setup/env-variables/backend-env-variables.mdx b/setup/env-variables/backend-env-variables.mdx index 733af435..b52b791a 100644 --- a/setup/env-variables/backend-env-variables.mdx +++ b/setup/env-variables/backend-env-variables.mdx @@ -349,9 +349,6 @@ Can be set in format `1d` for 1 day, `1h` for 1 hour, `1m` for 1 minute, `1s` or | `MIGRATION_TOKEN_INSTANCE_ERC_1155_SANITIZE_BATCH_SIZE` | Batch size for `erc-1155-sanitize` token instance fetcher. Implemented in [#9226](https://github.com/blockscout/blockscout/pull/9226). Default value and name changed in [#11543](https://github.com/blockscout/blockscout/pull/11543) | Version: v7.0.0\+
Default: `500`
Applications: Indexer | | `MIGRATION_TOKEN_INSTANCE_ERC_721_SANITIZE_BATCH_SIZE` | Batch size for `erc-721-sanitize` token instance fetcher. Implemented in [#9226](https://github.com/blockscout/blockscout/pull/9226). Default value and name changed in [#11543](https://github.com/blockscout/blockscout/pull/11543) | Version: v7.0.0\+
Default: `50`
Applications: Indexer | | `MIGRATION_TOKEN_INSTANCE_ERC_721_SANITIZE_TOKENS_BATCH_SIZE` | Tokens batch size for `erc-721-sanitize` token instance fetcher. Implemented in [#9226](https://github.com/blockscout/blockscout/pull/9226). Name changed in [#11543](https://github.com/blockscout/blockscout/pull/11543) | Version: v7.0.0\+
Default: `100`
Applications: Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | Version: v8.0.0\+
Default: `false`
Applications: Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | Version: v8.0.0\+
Default: `100`
Applications: Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | Version: v8.0.0\+
Default: `1`
Applications: Indexer | | `MIGRATION_BACKFILL_METADATA_URL_DISABLED` | If set to `true`, the backfiller of `metadata_url` field in the `token_instances` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#12102](https://github.com/blockscout/blockscout/pull/12102). | Version: v8.0.0\+
Default: `false`
Applications: Indexer | | `MIGRATION_BACKFILL_METADATA_URL_BATCH_SIZE` | Defines the number of records to be processed in each batch when backfilling the `metadata_url` field in the `token_instances` table. Implemented in [#12102](https://github.com/blockscout/blockscout/pull/12102). | Version: v8.0.0\+
Default: `100`
Applications: Indexer | | `MIGRATION_BACKFILL_METADATA_URL_CONCURRENCY` | Specifies how many concurrent processes can handle the `metadata_url` field backfilling. Implemented in [#12102](https://github.com/blockscout/blockscout/pull/12102). | Version: v8.0.0\+
Default: `5`
Applications: Indexer | @@ -722,4 +719,4 @@ Section created as a result of [#11417](https://github.com/blockscout/blockscout | `FOOTER_TELEGRAM_LINK` | Link in Telegram menu item in the footer. Implemented in [#7345](https://github.com/blockscout/blockscout/pull/7345). | Version: v5.1.4\+
Default: (empty)
Applications: API | | `FOOTER_GITHUB_LINK` | Github repository. Implemented in [#5719](https://github.com/blockscout/blockscout/pull/5719). | Version: v4.1.6\+
Default: `https://github.com/blockscout/blockscout`
Applications: API | | `FOOTER_LINK_TO_OTHER_EXPLORERS` | true/false. If true, links to other explorers are added in the footer. | Version: v5.1.3\+
Default: (empty)
Applications: API | -| `FOOTER_OTHER_EXPLORERS` | The list of alternative explorers. \ No newline at end of file +| `FOOTER_OTHER_EXPLORERS` | The list of alternative explorers. diff --git a/setup/env-variables/deprecated-env-variables/env-variables.mdx b/setup/env-variables/deprecated-env-variables/env-variables.mdx index 3bd0065f..b06982e3 100644 --- a/setup/env-variables/deprecated-env-variables/env-variables.mdx +++ b/setup/env-variables/deprecated-env-variables/env-variables.mdx @@ -186,7 +186,10 @@ This table is horizontally scrollable, version information is located in the las | `TOKEN_ID_MIGRATION_FIRST_BLOCK` | | Bottom block for token id migration. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 0 | v5.0.0+ | | API, Indexer | | `TOKEN_ID_MIGRATION_CONCURRENCY` | | Number of workers performing the token id migration. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 1 | v5.0.0+ | | API, Indexer | | `TOKEN_ID_MIGRATION_BATCH_SIZE` | | Interval of token transfer block numbers processed by a token id migration worker at a time. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 500 | v5.0.0+ | | API, Indexer | -| `ADDRESSES_TABS_COUNTERS_TTL` | | TTL for cached tabs counters (works only for counters which are \< 51, if counter >= 51, then ttl == :infinity). Implemented in [#8512](https://github.com/blockscout/blockscout/pull/8512) | `10m` | v5.3.0+ | | API | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | `false` | v8.0.0+ | | Indexer | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 100 | v8.0.0+ | | Indexer | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 1 | v8.0.0+ | | Indexer | +| `ADDRESSES_TABS_COUNTERS_TTL` | | TTL for cached tabs counters (works only for counters which are \< 51, if counter \>= 51, then ttl == :infinity). Implemented in [#8512](https://github.com/blockscout/blockscout/pull/8512) | `10m` | v5.3.0+ | | API | | `API_INTERNAL_TRANSACTIONS_INDEXING_FINISHED_THRESHOLD` | | In the case when the 1st tx in the chain already has internal transactions, If the number of blocks in pending\_block\_operations is less than the value in this env var, Blockscout will consider, that indexing of internal transactions finished, otherwise, it will consider, that indexing is still taking place and the indexing banner will appear at the top. Implemented in [#7576](https://github.com/blockscout/blockscout/pull/7576). | 1000 | v5.2.0+ | | API | | `DATABASE_EVENT_URL` | | Variable to define the Postgres Database endpoint that will be used by event listener process. Applicable for separate indexer and API setup. More info in related PR. Implemented in [#10164](https://github.com/blockscout/blockscout/pull/10164). | (empty) | v6.7.0+ | | API | @@ -791,4 +794,3 @@ reCAPTCHA v2 and v3 keys for CSV export page. Do not use both v2/v3 keys. Only o | `MUD_DATABASE_URL` | | MUD indexer DB connection URL. | value from `DATABASE_URL` | v6.6.0+ | API | | `MUD_POOL_SIZE` | | MUD indexer DB `pool_size` | 50 | v6.6.0+ | API | - From 9a998cfd37754ee8c416fa485fc32d1eebc34011 Mon Sep 17 00:00:00 2001 From: Fedor Ivanov Date: Fri, 6 Mar 2026 19:23:46 +0700 Subject: [PATCH 2/3] Move envs to the proper deprecated envs file --- setup/env-variables/deprecated-env-variables.mdx | 3 +++ .../env-variables/deprecated-env-variables/env-variables.mdx | 5 +---- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/setup/env-variables/deprecated-env-variables.mdx b/setup/env-variables/deprecated-env-variables.mdx index 25d3f07b..b423b066 100644 --- a/setup/env-variables/deprecated-env-variables.mdx +++ b/setup/env-variables/deprecated-env-variables.mdx @@ -176,6 +176,9 @@ sidebarTitle: "Overview" | `API_RATE_LIMIT` | A global API rate limit: number or requests per second for all users. Implemented in [#5030](https://github.com/blockscout/blockscout/pull/5030) | | v4.1.1+ | | v9.0.0 | | `CACHE_PBO_COUNT_PERIOD` | Time interval to restart the task which calculates the total pending_block_operations count. | `20m` | v5.2.0+ | | v10.0.0 | | `MIGRATION_DELETE_ZERO_VALUE_INTERNAL_TRANSACTIONS_STORAGE_PERIOD_DAYS` | Specifies the period for which recent zero-value calls won't be deleted in delete zero-value calls migration. | 30 | v9.3.0+ | | v9.3.3 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | `false` | v8.0.0+ | | v10.0.0 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 100 | v8.0.0+ | | v10.0.0 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 1 | v8.0.0+ | | v10.0.0 | | `INDEXER_TOKEN_BALANCES_BATCH_SIZE` | Batch size for archival token balances fetcher. Implemented in [#7439](https://github.com/blockscout/blockscout/pull/7439). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_BATCH_SIZE` | `100` | v5.1.5+ | | v10.0.0 | | `INDEXER_TOKEN_BALANCES_CONCURRENCY` | Concurrency for archival token balances fetcher. Implemented in [#8167](https://github.com/blockscout/blockscout/pull/8167). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_CONCURRENCY` | `10` | v5.2.2+ | | v10.0.0 | | `INDEXER_TOKEN_BALANCES_EXPONENTIAL_TIMEOUT_COEFF` | Coefficient to calculate exponential timeout. Implemented in [#10694](https://github.com/blockscout/blockscout/pull/10694). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_EXPONENTIAL_TIMEOUT_COEFF` | `100` | v6.9.0+ | | v10.0.0 | diff --git a/setup/env-variables/deprecated-env-variables/env-variables.mdx b/setup/env-variables/deprecated-env-variables/env-variables.mdx index b06982e3..260c5316 100644 --- a/setup/env-variables/deprecated-env-variables/env-variables.mdx +++ b/setup/env-variables/deprecated-env-variables/env-variables.mdx @@ -186,10 +186,7 @@ This table is horizontally scrollable, version information is located in the las | `TOKEN_ID_MIGRATION_FIRST_BLOCK` | | Bottom block for token id migration. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 0 | v5.0.0+ | | API, Indexer | | `TOKEN_ID_MIGRATION_CONCURRENCY` | | Number of workers performing the token id migration. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 1 | v5.0.0+ | | API, Indexer | | `TOKEN_ID_MIGRATION_BATCH_SIZE` | | Interval of token transfer block numbers processed by a token id migration worker at a time. Implemented in [#6391](https://github.com/blockscout/blockscout/pull/6391) | 500 | v5.0.0+ | | API, Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | `false` | v8.0.0+ | | Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 100 | v8.0.0+ | | Indexer | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 1 | v8.0.0+ | | Indexer | -| `ADDRESSES_TABS_COUNTERS_TTL` | | TTL for cached tabs counters (works only for counters which are \< 51, if counter \>= 51, then ttl == :infinity). Implemented in [#8512](https://github.com/blockscout/blockscout/pull/8512) | `10m` | v5.3.0+ | | API | +| `ADDRESSES_TABS_COUNTERS_TTL` | | TTL for cached tabs counters (works only for counters which are \< 51, if counter >= 51, then ttl == :infinity). Implemented in [#8512](https://github.com/blockscout/blockscout/pull/8512) | `10m` | v5.3.0+ | | API | | `API_INTERNAL_TRANSACTIONS_INDEXING_FINISHED_THRESHOLD` | | In the case when the 1st tx in the chain already has internal transactions, If the number of blocks in pending\_block\_operations is less than the value in this env var, Blockscout will consider, that indexing of internal transactions finished, otherwise, it will consider, that indexing is still taking place and the indexing banner will appear at the top. Implemented in [#7576](https://github.com/blockscout/blockscout/pull/7576). | 1000 | v5.2.0+ | | API | | `DATABASE_EVENT_URL` | | Variable to define the Postgres Database endpoint that will be used by event listener process. Applicable for separate indexer and API setup. More info in related PR. Implemented in [#10164](https://github.com/blockscout/blockscout/pull/10164). | (empty) | v6.7.0+ | | API | From 86d3064b55a036d185214799bae4f6e4fa29f16f Mon Sep 17 00:00:00 2001 From: Victor Baranov Date: Fri, 6 Mar 2026 16:23:10 +0300 Subject: [PATCH 3/3] Update setup/env-variables/deprecated-env-variables.mdx --- setup/env-variables/deprecated-env-variables.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/setup/env-variables/deprecated-env-variables.mdx b/setup/env-variables/deprecated-env-variables.mdx index b423b066..f3ded9cb 100644 --- a/setup/env-variables/deprecated-env-variables.mdx +++ b/setup/env-variables/deprecated-env-variables.mdx @@ -176,9 +176,9 @@ sidebarTitle: "Overview" | `API_RATE_LIMIT` | A global API rate limit: number or requests per second for all users. Implemented in [#5030](https://github.com/blockscout/blockscout/pull/5030) | | v4.1.1+ | | v9.0.0 | | `CACHE_PBO_COUNT_PERIOD` | Time interval to restart the task which calculates the total pending_block_operations count. | `20m` | v5.2.0+ | | v10.0.0 | | `MIGRATION_DELETE_ZERO_VALUE_INTERNAL_TRANSACTIONS_STORAGE_PERIOD_DAYS` | Specifies the period for which recent zero-value calls won't be deleted in delete zero-value calls migration. | 30 | v9.3.0+ | | v9.3.3 | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | `false` | v8.0.0+ | | v10.0.0 | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 100 | v8.0.0+ | | v10.0.0 | -| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 1 | v8.0.0+ | | v10.0.0 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED` | If set to `true`, the migration to the `language` field in the `smart_contracts` table will not start. If set to `false`, the migration proceeds as normal. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | `false` | v8.0.0+ | | v11.0.0 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE` | Defines the number of records to be processed in each batch when migrating the `language` field in the `smart_contracts` table. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 100 | v8.0.0+ | | v11.0.0 | +| `MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY` | Specifies how many concurrent processes can handle the `language` field migration. Implemented in [#11813](https://github.com/blockscout/blockscout/pull/11813). | 1 | v8.0.0+ | | v11.0.0 | | `INDEXER_TOKEN_BALANCES_BATCH_SIZE` | Batch size for archival token balances fetcher. Implemented in [#7439](https://github.com/blockscout/blockscout/pull/7439). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_BATCH_SIZE` | `100` | v5.1.5+ | | v10.0.0 | | `INDEXER_TOKEN_BALANCES_CONCURRENCY` | Concurrency for archival token balances fetcher. Implemented in [#8167](https://github.com/blockscout/blockscout/pull/8167). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_CONCURRENCY` | `10` | v5.2.2+ | | v10.0.0 | | `INDEXER_TOKEN_BALANCES_EXPONENTIAL_TIMEOUT_COEFF` | Coefficient to calculate exponential timeout. Implemented in [#10694](https://github.com/blockscout/blockscout/pull/10694). Replaced with `INDEXER_ARCHIVAL_TOKEN_BALANCES_EXPONENTIAL_TIMEOUT_COEFF` | `100` | v6.9.0+ | | v10.0.0 |