feat: add custom block explorer URL param

leonimella · leonimella · commit 60e7a0bc13d8 · 2025-09-01T13:13:23.000-03:00
diff --git a/configs/app/app.ts b/configs/app/app.ts
@@ -12,6 +12,7 @@ const baseUrl = [
 const isDev = getEnvValue('NEXT_PUBLIC_APP_ENV') === 'development';
 const isPw = getEnvValue('NEXT_PUBLIC_APP_INSTANCE') === 'pw';
 const spriteHash = getEnvValue('NEXT_PUBLIC_ICON_SPRITE_HASH');
+const blockExplorerUrl = getEnvValue('NEXT_PUBLIC_BLOCK_EXPLORER_URL') || getEnvValue('NEXT_PUBLIC_APP_HOST');
 
 const app = Object.freeze({
   isDev,
@@ -22,6 +23,7 @@ const app = Object.freeze({
   baseUrl,
   useProxy: getEnvValue('NEXT_PUBLIC_USE_NEXT_JS_PROXY') === 'true',
   spriteHash,
+  blockExplorerUrl: blockExplorerUrl as string,
 });
 
 export default app;
diff --git a/deploy/tools/envs-validator/schema.ts b/deploy/tools/envs-validator/schema.ts
@@ -71,12 +71,12 @@ const urlTest: yup.TestConfig = {
   exclusive: true,
 };
 
-const getYupValidationErrorMessage = (error: unknown) => 
-  typeof error === 'object' && 
-  error !== null && 
-  'errors' in error && 
-  Array.isArray(error.errors) ? 
-    error.errors.join(', ') : 
+const getYupValidationErrorMessage = (error: unknown) =>
+  typeof error === 'object' &&
+  error !== null &&
+  'errors' in error &&
+  Array.isArray(error.errors) ?
+    error.errors.join(', ') :
     '';
 
 const marketplaceAppSchema: yup.ObjectSchema<MarketplaceAppOverview> = yup
@@ -709,6 +709,7 @@ const schema = yup
     NEXT_PUBLIC_APP_PORT: yup.number().positive().integer(),
     NEXT_PUBLIC_APP_ENV: yup.string(),
     NEXT_PUBLIC_APP_INSTANCE: yup.string(),
+    NEXT_PUBLIC_BLOCK_EXPLORER_URL: yup.string(),
 
     // 2. Blockchain parameters
     NEXT_PUBLIC_NETWORK_NAME: yup.string().required(),
diff --git a/docs/ENVS.md b/docs/ENVS.md
@@ -16,67 +16,95 @@ All json-like values should be single-quoted. If it contains a hash (`#`) or a d
 &nbsp;
 
 ## Table of contents
-- [App configuration](#app-configuration)
-- [Blockchain parameters](#blockchain-parameters)
-- [API configuration](#api-configuration)
-- [UI configuration](#ui-configuration)
-  - [Homepage](#homepage)
-  - [Navigation](#navigation)
-  - [Footer](#footer)
-  - [Favicon](#favicon)
-  - [Meta](#meta)
-  - [Views](#views)
-    - [Block](#block-views)
-    - [Address](#address-views)
-    - [Transaction](#transaction-views)
-    - [NFT](#nft-views)
-  - [Misc](#misc)
-- [App features](#app-features)
-  - [My account](#my-account)
-  - [Gas tracker](#gas-tracker)
-  - [Advanced filter](#advanced-filter)
-  - [Address verification](#address-verification-in-my-account) in "My account"
-  - [Blockchain interaction](#blockchain-interaction-writing-to-contract-etc) (writing to contract, etc.)
-  - [Banner ads](#banner-ads)
-  - [Text ads](#text-ads)
-  - [Beacon chain](#beacon-chain)
-  - [User operations](#user-operations-erc-4337)
-  - [Rollup chain](#rollup-chain)
-  - [Export data to CSV file](#export-data-to-csv-file)
-  - [Google analytics](#google-analytics)
-  - [Mixpanel analytics](#mixpanel-analytics)
-  - [GrowthBook feature flagging and A/B testing](#growthbook-feature-flagging-and-ab-testing)
-  - [GraphQL API documentation](#graphql-api-documentation)
-  - [REST API documentation](#rest-api-documentation)
-  - [Marketplace](#marketplace)
-  - [Solidity to UML diagrams](#solidity-to-uml-diagrams)
-  - [Blockchain statistics](#blockchain-statistics)
-  - [Web3 wallet integration](#web3-wallet-integration-add-token-or-network-to-the-wallet) (add token or network to the wallet)
-  - [Transaction interpretation](#transaction-interpretation)
-  - [Verified tokens info](#verified-tokens-info)
-  - [Name service integration](#name-service-integration)
-  - [Metadata service integration](#metadata-service-integration)
-  - [Public tag submission](#public-tag-submission)
-  - [Data availability](#data-availability)
-  - [Bridged tokens](#bridged-tokens)
-  - [Safe{Core} address tags](#safecore-address-tags)
-  - [Address profile API](#address-profile-api)
-  - [Address XStar XHS score](#address-xstar-xhs-score)
-  - [SUAVE chain](#suave-chain)
-  - [Celo chain](#celo-chain)
-  - [Ton Application Chain (TAC)](#ton-application-chain-tac)
-  - [MetaSuites extension](#metasuites-extension)
-  - [Validators list](#validators-list)
-  - [Sentry error monitoring](#sentry-error-monitoring)
-  - [Rollbar error monitoring](#rollbar-error-monitoring)
-  - [OpenTelemetry](#opentelemetry)
-  - [DeFi dropdown](#defi-dropdown)
-  - [Multichain balance button](#multichain-balance-button)
-  - [Get gas button](#get-gas-button)
-  - [Save on gas with GasHawk](#save-on-gas-with-gashawk)
-  - [Rewards service API](#rewards-service-api)
-  - [DEX pools](#dex-pools)
-- [3rd party services configuration](#external-services-configuration)
+- [Run-time environment variables](#run-time-environment-variables)
+  - [Read before you run the app](#read-before-you-run-the-app)
+    - [Variables compulsoriness](#variables-compulsoriness)
+    - [Disclaimer about using variables](#disclaimer-about-using-variables)
+    - [Note about escaping variables values](#note-about-escaping-variables-values)
+  - [Table of contents](#table-of-contents)
+  - [App configuration](#app-configuration)
+  - [Blockchain parameters](#blockchain-parameters)
+  - [API configuration](#api-configuration)
+  - [UI configuration](#ui-configuration)
+    - [Homepage](#homepage)
+      - [Hero banner configuration properties](#hero-banner-configuration-properties)
+    - [Navigation](#navigation)
+      - [Featured network configuration properties](#featured-network-configuration-properties)
+    - [Footer](#footer)
+      - [Footer links configuration properties](#footer-links-configuration-properties)
+    - [Favicon](#favicon)
+    - [Meta](#meta)
+    - [Views](#views)
+      - [Block views](#block-views)
+        - [Block fields list](#block-fields-list)
+      - [Address views](#address-views)
+        - [Address views list](#address-views-list)
+      - [Transaction views](#transaction-views)
+        - [Transaction fields list](#transaction-fields-list)
+        - [Transaction additional fields list](#transaction-additional-fields-list)
+      - [Token views](#token-views)
+      - [NFT views](#nft-views)
+        - [NFT marketplace properties](#nft-marketplace-properties)
+    - [Misc](#misc)
+      - [Network explorer configuration properties](#network-explorer-configuration-properties)
+      - [Contract code IDE configuration properties](#contract-code-ide-configuration-properties)
+      - [Font family configuration properties](#font-family-configuration-properties)
+  - [App features](#app-features)
+    - [My account](#my-account)
+    - [Gas tracker](#gas-tracker)
+    - [Advanced filter](#advanced-filter)
+    - [Address verification in "My account"](#address-verification-in-my-account)
+    - [Blockchain interaction (writing to contract, etc.)](#blockchain-interaction-writing-to-contract-etc)
+    - [Banner ads](#banner-ads)
+    - [Text ads](#text-ads)
+    - [Beacon chain](#beacon-chain)
+    - [User operations (ERC-4337)](#user-operations-erc-4337)
+    - [Rollup chain](#rollup-chain)
+      - [Parent chain configuration properties](#parent-chain-configuration-properties)
+    - [Export data to CSV file](#export-data-to-csv-file)
+    - [Google analytics](#google-analytics)
+    - [Mixpanel analytics](#mixpanel-analytics)
+    - [GrowthBook feature flagging and A/B testing](#growthbook-feature-flagging-and-ab-testing)
+    - [GraphQL API documentation](#graphql-api-documentation)
+    - [REST API documentation](#rest-api-documentation)
+    - [Marketplace](#marketplace)
+      - [Marketplace app configuration properties](#marketplace-app-configuration-properties)
+    - [Solidity to UML diagrams](#solidity-to-uml-diagrams)
+    - [Blockchain statistics](#blockchain-statistics)
+    - [Web3 wallet integration (add token or network to the wallet)](#web3-wallet-integration-add-token-or-network-to-the-wallet)
+    - [Transaction interpretation](#transaction-interpretation)
+    - [External transactions](#external-transactions)
+    - [Verified tokens info](#verified-tokens-info)
+    - [Name service integration](#name-service-integration)
+    - [Metadata service integration](#metadata-service-integration)
+    - [Public tag submission](#public-tag-submission)
+    - [Data Availability](#data-availability)
+    - [Bridged tokens](#bridged-tokens)
+      - [Bridged token chain configuration properties](#bridged-token-chain-configuration-properties)
+      - [Token bridge configuration properties](#token-bridge-configuration-properties)
+    - [Safe{Core} address tags](#safecore-address-tags)
+    - [Address profile API](#address-profile-api)
+      - [Address profile API configuration properties](#address-profile-api-configuration-properties)
+    - [Address XStar XHS score](#address-xstar-xhs-score)
+    - [SUAVE chain](#suave-chain)
+    - [Celo chain](#celo-chain)
+    - [Ton Application Chain (TAC)](#ton-application-chain-tac)
+    - [MetaSuites extension](#metasuites-extension)
+    - [Validators list](#validators-list)
+    - [Sentry error monitoring](#sentry-error-monitoring)
+    - [Rollbar error monitoring](#rollbar-error-monitoring)
+    - [OpenTelemetry](#opentelemetry)
+    - [DeFi dropdown](#defi-dropdown)
+    - [Multichain balance button](#multichain-balance-button)
+      - [Multichain button configuration properties](#multichain-button-configuration-properties)
+    - [Get gas button](#get-gas-button)
+      - [Get gas button configuration properties](#get-gas-button-configuration-properties)
+    - [Save on gas with GasHawk](#save-on-gas-with-gashawk)
+    - [Rewards service API](#rewards-service-api)
+    - [DEX pools](#dex-pools)
+    - [Badge claim link](#badge-claim-link)
+  - [External services configuration](#external-services-configuration)
+    - [Google ReCaptcha](#google-recaptcha)
 
 &nbsp;
 
@@ -419,6 +447,7 @@ This feature is **enabled by default**. To switch it off pass `NEXT_PUBLIC_ADVAN
 | NEXT_PUBLIC_NETWORK_CURRENCY_NAME | `string` | See in [Blockchain parameters](#blockchain-parameters) section | Required | - | `Ether` | v1.0.x+ |
 | NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL | `string` | See in [Blockchain parameters](#blockchain-parameters) section | Required | - | `ETH` | v1.0.x+ |
 | NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS | `string` | See in [Blockchain parameters](#blockchain-parameters) section | - | `18` | `6` | v1.0.x+ |
+| NEXT_PUBLIC_BLOCK_EXPLORER_URL | `string` | Custom block explorer URL | - | `NEXT_PUBLIC_APP_HOST` | - |
 
 &nbsp;
 
diff --git a/lib/web3/useAddChain.tsx b/lib/web3/useAddChain.tsx
@@ -22,7 +22,7 @@ function getParams(): AddEthereumChainParameter {
       decimals: config.chain.currency.decimals ?? 18,
     },
     rpcUrls: config.chain.rpcUrls,
-    blockExplorerUrls: [ config.app.baseUrl ],
+    blockExplorerUrls: [ config.app.blockExplorerUrl ],
   };
 }
 

Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@ function getParams(): AddEthereumChainParameter {`
`22`	`22`	`decimals: config.chain.currency.decimals ?? 18,`
`23`	`23`	`},`
`24`	`24`	`rpcUrls: config.chain.rpcUrls,`
`25`		`- blockExplorerUrls: [ config.app.baseUrl ],`
	`25`	`+ blockExplorerUrls: [ config.app.blockExplorerUrl ],`
`26`	`26`	`};`
`27`	`27`	`}`
`28`	`28`