fix(adapter-polkadot): align hub explorer labels with routescan (#364)

Update the remaining Polkadot Hub explorer labels, guidance, and placeholders
so the UI matches the Routescan-backed mainnet configuration.

Author: pasevin

.changeset/polkadot-routescan-wording.md

@@ -0,0 +1,5 @@
+---
+'@openzeppelin/ui-builder-adapter-polkadot': patch
+---
+
+Rename remaining Polkadot Hub explorer UI labels and guidance from Blockscout to Routescan.

packages/adapter-polkadot/src/__tests__/adapter.test.ts

@@ -130,10 +130,10 @@ describe('PolkadotAdapter', () => {
   });
 
   describe('getSupportedContractDefinitionProviders', () => {
-    it('should return Blockscout for Hub networks', () => {
+    it('should return Routescan for Hub networks', () => {
       const adapter = new PolkadotAdapter(mockPolkadotHubConfig as unknown as NetworkConfig);
       const providers = adapter.getSupportedContractDefinitionProviders();
-      expect(providers).toContainEqual({ key: 'etherscan', label: 'Blockscout' });
+      expect(providers).toContainEqual({ key: 'etherscan', label: 'Routescan' });
       expect(providers).toContainEqual({ key: 'sourcify', label: 'Sourcify' });
       expect(providers).toContainEqual({ key: 'manual', label: 'Manual' });
     });

packages/adapter-polkadot/src/__tests__/networks.test.ts

@@ -60,7 +60,7 @@ describe('Polkadot Hub Network Configurations', () => {
   //     expect(kusamaHubMainnet.nativeCurrency.decimals).toBe(18);
   //   });
   //
-  //   it('should use Blockscout (Etherscan V1 API)', () => {
+  //   it('should use Routescan (Etherscan-compatible V1 API)', () => {
   //     expect(kusamaHubMainnet.supportsEtherscanV2).toBe(false);
   //   });
   // });

packages/adapter-polkadot/src/adapter.ts

@@ -199,7 +199,8 @@ export class PolkadotAdapter implements ContractAdapter {
 
   /**
    * Load a contract schema from an address or artifacts.
-   * Uses Blockscout (V1 API) for Hub networks, Moonscan (V2 API) for parachains.
+   * Uses Routescan (Etherscan-compatible V1 API) for Hub networks and Moonscan (V2 API)
+   * for parachains.
    * Falls back to Sourcify if primary provider fails.
    *
    * [SUBSTRATE TODO]: ink! contracts would need different loading:
@@ -282,13 +283,13 @@ export class PolkadotAdapter implements ContractAdapter {
 
   /**
    * Get supported contract definition providers.
-   * Returns Etherscan (for Blockscout/Moonscan) and Sourcify.
+   * Returns Etherscan-compatible providers (Routescan/Moonscan) and Sourcify.
    */
   getSupportedContractDefinitionProviders(): Array<{ key: string; label: string }> {
     return [
       {
         key: 'etherscan',
-        label: this._typedNetworkConfig.networkCategory === 'hub' ? 'Blockscout' : 'Moonscan',
+        label: this._typedNetworkConfig.networkCategory === 'hub' ? 'Routescan' : 'Moonscan',
       },
       { key: 'sourcify', label: 'Sourcify' },
       { key: 'manual', label: 'Manual' },

packages/adapter-polkadot/src/evm/abi/index.ts

@@ -18,7 +18,8 @@ import type { TypedPolkadotNetworkConfig } from '../../types';
 
 /**
  * Load a contract using EVM core module.
- * Uses Blockscout (V1 API) for Hub networks, Moonscan (V2 API) for parachains.
+ * Uses Routescan (Etherscan-compatible V1 API) for Hub networks and Moonscan (V2 API)
+ * for parachains.
  *
  * @remarks
  * This is a thin wrapper that handles the Polkadot-specific option format

packages/adapter-polkadot/src/evm/configuration/network-services.ts

@@ -67,7 +67,7 @@ export function getPolkadotDefaultServiceConfig(
  * Get explorer label based on network category.
  */
 function getExplorerLabel(networkConfig: TypedPolkadotNetworkConfig): string {
-  return networkConfig.networkCategory === 'hub' ? 'Blockscout' : 'Moonscan';
+  return networkConfig.networkCategory === 'hub' ? 'Routescan' : 'Moonscan';
 }
 
 /**
@@ -130,7 +130,7 @@ export function getNetworkServiceForms(
               lines: [
                 `<strong>${explorerLabel}:</strong> The primary block explorer for this network.`,
                 networkConfig.networkCategory === 'hub'
-                  ? '<strong>Note:</strong> Hub networks use Blockscout API (V1 compatible).'
+                  ? '<strong>Note:</strong> Hub networks use Routescan (Etherscan-compatible V1 API).'
                   : '<strong>Note:</strong> Parachain networks use Moonscan (Etherscan V2 compatible).',
               ],
             },
@@ -150,10 +150,10 @@ export function getNetworkServiceForms(
           id: 'polkadot-explorer-use-v2',
           name: 'useV2Api',
           type: 'checkbox',
-          label: `Use ${networkConfig.networkCategory === 'hub' ? 'Blockscout' : 'Etherscan V2'} API`,
+          label: `Use ${networkConfig.networkCategory === 'hub' ? 'Routescan' : 'Etherscan V2'} API`,
           helperText:
             networkConfig.networkCategory === 'hub'
-              ? 'Hub networks use Blockscout API which is V1 compatible.'
+              ? 'Hub networks use Routescan, which exposes an Etherscan-compatible V1 API.'
               : 'Enable the V2 API for Moonscan networks.',
           validation: {},
           defaultValue: v2DefaultEnabled && networkConfig.networkCategory !== 'hub',
@@ -184,7 +184,7 @@ export function getNetworkServiceForms(
           label: 'Explorer Base URL (optional)',
           placeholder:
             networkConfig.networkCategory === 'hub'
-              ? 'https://assethub-polkadot.blockscout.com'
+              ? 'https://polkadot.routescan.io'
               : 'https://moonbeam.moonscan.io',
           validation: {},
           helperText:
@@ -203,7 +203,7 @@ export function getNetworkServiceForms(
           label: 'Explorer API URL',
           placeholder:
             networkConfig.networkCategory === 'hub'
-              ? 'https://assethub-polkadot.blockscout.com/api'
+              ? 'https://api.routescan.io/v2/network/mainnet/evm/420420419/etherscan/api'
               : 'https://api.moonscan.io/api',
           validation: {},
           helperText:
@@ -268,7 +268,7 @@ export function getNetworkServiceForms(
           validation: {},
           options: [
             {
-              label: networkConfig.networkCategory === 'hub' ? 'Blockscout' : 'Moonscan',
+              label: networkConfig.networkCategory === 'hub' ? 'Routescan' : 'Moonscan',
               value: EvmProviderKeys.Etherscan,
             },
             { label: 'Sourcify', value: EvmProviderKeys.Sourcify },

packages/adapter-polkadot/src/metadata.ts

@@ -7,7 +7,7 @@ export const ecosystemMetadata: EcosystemMetadata = {
   name: 'Polkadot',
   description:
     'Polkadot is a heterogeneous multi-chain protocol enabling cross-chain communication and shared security. It supports EVM-compatible smart contracts through Hub networks and parachains like Moonbeam.',
-  explorerGuidance: 'Blockscout or Moonscan verified contracts',
+  explorerGuidance: 'Routescan or Moonscan verified contracts',
   addressExample: '0x...',
   iconComponent: NetworkPolkadot,
   bgColorClass: 'bg-pink-100',