Skip to content

Add cross-chain transaction tracking and visualization#3227

Merged
tom2drum merged 33 commits intomainfrom
tom2drum/cross-chain-txs
Feb 19, 2026
Merged

Add cross-chain transaction tracking and visualization#3227
tom2drum merged 33 commits intomainfrom
tom2drum/cross-chain-txs

Conversation

@tom2drum
Copy link
Copy Markdown
Collaborator

@tom2drum tom2drum commented Jan 14, 2026

Description and Related Issue(s)

This pull request introduces comprehensive cross-chain transaction tracking and visualization functionality. It enables users to view transactions that span multiple blockchains, providing detailed information about cross-chain operations and links to related transactions on different chains.

Proposed Changes

  • New pages and components:

    • Cross-chain transactions list page with filtering and pagination capabilities
    • Cross-chain transaction details page showing lifecycle, token transfers, and messages
    • Cross-chain token transfers component with both table and list views
    • Cross-chain messages component integrated into transaction details
    • Latest cross-chain transactions widget on the home page
  • API integration:

    • Integration with Interchain Indexer API for fetching cross-chain transaction data
    • New API service layer for interchain operations
    • Support for external chain configuration via JSON config file
  • UI enhancements:

    • Adaptive tabs component improvements for better mobile/desktop responsiveness
    • Cross-chain status tags and lifecycle visualization
    • External chain entity components for displaying addresses, transactions, and tokens from other chains
    • Cross-chain bridge links for navigation between related transactions
  • Configuration:

    • Feature flag system for cross-chain transactions
    • Environment variable validation schema
    • Support for configurable chain metadata (logos, explorer URLs, route templates)

Environment Variables

  • Added NEXT_PUBLIC_CROSS_CHAIN_TXS_CONFIG: URL of the configuration file in JSON format that contains information about the chains involved in cross-chain transactions. This config includes chain IDs, names, logos, explorer URLs, and route templates for building links to external chain explorers.

  • Added NEXT_PUBLIC_INTERCHAIN_INDEXER_API_HOST: Interchain indexer API service host used to fetch cross-chain transaction data and metadata, including transaction details, token transfers, messages, and statistics.

Breaking or Incompatible Changes

None.

Additional Information

  • Added new dependency: @blockscout/interchain-indexer-types for TypeScript type definitions
  • Includes comprehensive test coverage with Playwright visual regression tests
  • Mobile-responsive design with adaptive layouts for different screen sizes

Checklist for PR author

  • I have tested these changes locally.
  • I added tests to cover any new functionality, following this guide
  • Whenever I fix a bug, I include a regression test to ensure that the bug does not reappear silently.
  • If I have added a feature or functionality that is not privacy-compliant (e.g., tracking, analytics, third-party services), I have disabled it for private mode.
  • If I have added, changed, renamed, or removed an environment variable
    • I updated the list of environment variables in the documentation
    • I made the necessary changes to the validator script according to the guide
    • I added "ENVs" label to this pull request

Note

Medium Risk
Large, feature-flagged UI/API surface area change that adds a new backend dependency and new routing/tab flows; risk is mostly around correctness of pagination/linking and rollout via env configuration rather than core security/auth.

Overview
Adds a new feature-flagged cross-chain transactions experience powered by a new interchainIndexer API integration. This introduces /cross-chain-tx/[id] details pages plus cross-chain list views for transactions and token transfers, and wires these into existing Transactions, TokenTransfers, and address-level tx/transfer pages via new routed sub-tabs.

Extends configuration and tooling to support the feature: new envs (NEXT_PUBLIC_CROSS_CHAIN_TXS_ENABLED, NEXT_PUBLIC_INTERCHAIN_INDEXER_API_HOST), validator schema/tests/docs updates, API docs entry, and a new numine preset/env. Also adds shared UI building blocks (external-chain entities/links, lifecycle accordion, status tags) and updates some tab/badge behaviors to better handle loading and single-tab layouts.

Written by Cursor Bugbot for commit 58c7119. This will update automatically on new commits. Configure here.

@tom2drum tom2drum added dependencies Pull requests that update a dependency file ENVs labels Jan 14, 2026
@tom2drum tom2drum linked an issue Jan 14, 2026 that may be closed by this pull request
@tom2drum tom2drum added the feature New substantial feature label Jan 14, 2026
@tom2drum
Copy link
Copy Markdown
Collaborator Author

bugbot run

Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

This is the final PR Bugbot will review for you during this billing cycle

Your free Bugbot reviews will reset on March 10

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

@tom2drum tom2drum merged commit 7a18188 into main Feb 19, 2026
12 checks passed
@tom2drum tom2drum deleted the tom2drum/cross-chain-txs branch February 19, 2026 14:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

client feature dependencies Pull requests that update a dependency file ENVs feature New substantial feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Display cross-chain transactions

1 participant