feat: add Celestia warp routes for SOL, ETH, WBTC, eUSD by paulbalaji · Pull Request #965 · hyperlane-xyz/hyperlane-warp-ui-template

paulbalaji · 2026-02-20T19:04:07Z

Summary

Add 6 Celestia warp route configs (3 tokens x 2 routes each)
SOL: Solana <-> Celestia, Celestia <-> Eden
ETH: Ethereum <-> Celestia, Celestia <-> Eden
WBTC (LBTC): Ethereum <-> Celestia, Celestia <-> Eden

Registry PRs:

Test plan

Verify warp routes load correctly in the UI
Test SOL transfer Solana <-> Celestia
Test ETH transfer Ethereum <-> Celestia
Test LBTC/BTC transfer Ethereum <-> Celestia
Test SOL/ETH/BTC transfers Celestia <-> Eden

🤖 Generated with Claude Code

Note

Medium Risk
Upgrades Hyperlane packages (including @hyperlane-xyz/core to v11 and beta sdk/utils/widgets), plus webpack alias stubbing, which can affect build/runtime behavior and token/route resolution. Route config additions are mostly data changes but could surface misconfigured addresses/decimals in transfers.

Overview
Adds new Celestia Warp Route token configs in warpRoutes.yaml (SOL, ETH, BTC/LBTC, TIA, eUSD) and switches warpRouteWhitelist from null (all routes) to an explicit allowlist of Celestia-related routes.

Updates token selection to also include tokens that have explicit connections (not only multi-chain tokens), and bumps @hyperlane-xyz/sdk, @hyperlane-xyz/utils, and @hyperlane-xyz/widgets to a 25.4.0-beta build (bringing in @hyperlane-xyz/core@11).

Adjusts next.config.js webpack aliases to stub @hyperlane-xyz/core typechain/barrel exports (and buildArtifact.js) to avoid ethers v5/v6 import issues during webpackBuildWorker optimization.

^{Written by Cursor Bugbot for commit 897dd97. This will update automatically on new commits. Configure here.}

vercel · 2026-02-20T19:04:12Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hyperlane-warp-template	Ready	Preview, Comment	Feb 27, 2026 5:23pm

5 Skipped Deployments

Project	Deployment	Updated (UTC)
analytics-test	Ignored	Feb 27, 2026 5:23pm
injective-bridge	Ignored	Feb 27, 2026 5:23pm
nexus-bridge	Ignored	Feb 27, 2026 5:23pm
ousdt-bridge	Ignored	Feb 27, 2026 5:23pm
trump-bridge	Ignored	Feb 27, 2026 5:23pm

cursor · 2026-02-25T18:31:28Z

+    decimals: 6
+    name: TIA
+    standard: CosmosNativeHypCollateral
+    symbol: TIA


TIA token missing collateralAddressOrDenom on Celestia

High Severity

The TIA/eden route's Celestia-side token uses CosmosNativeHypCollateral standard but is missing the collateralAddressOrDenom field. Every other CosmosNativeHypCollateral entry in this file (SOL/eden at line 26, ETH/eden at line 63, WBTC/eden at line 100) includes this field. For TIA on Celestia, it likely needs to be utia (the native denomination). Without it, the system won't know which Cosmos denomination to lock as collateral, potentially breaking the TIA transfer route.

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

cursor · 2026-02-27T14:47:42Z

+  'WBTC/celestia-ethereum',
+  'WBTC/celestia-eden',
+  'TIA/celestia-eden',
+];


eUSD routes missing from warp route whitelist

Medium Severity

The PR title states it adds routes for "SOL, ETH, WBTC, eUSD", and 4 eUSD tokens are configured in warpRoutes.yaml, but eUSD/celestia-ethereum and eUSD/celestia-eden are missing from warpRouteWhitelist. Every other YAML route has a corresponding whitelist entry. While YAML tokens bypass the whitelist filter, the registry versions of these routes (from the linked registry PRs) won't be included, meaning eUSD won't appear in the wireDecimalsMap built by buildWireDecimalsMap.

Additional Locations (1)

src/consts/warpRoutes.yaml#L131-L175

Add 6 warp routes (3 tokens x 2 routes each): - SOL/celestia: Solana <-> Celestia - SOL/eden: Celestia <-> Eden - ETH/celestia: Ethereum <-> Celestia - ETH/eden: Celestia <-> Eden - WBTC/celestia: Ethereum (LBTC) <-> Celestia - WBTC/eden: Celestia <-> Eden Configs sourced from: - hyperlane-xyz/hyperlane-registry#1388 - hyperlane-xyz/hyperlane-registry#1389 - hyperlane-xyz/hyperlane-registry#1391 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

isMultiChainToken() excludes EvmNative since it's not in TOKEN_HYP_STANDARDS, hiding Eden TIA from Eden→Celestia direction. Include tokens with configured connections regardless of standard. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update @hyperlane-xyz/sdk, utils, widgets to beta containing getHypAdapter support for EvmNative tokens with warp connections. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

socket-security · 2026-02-27T16:56:27Z

All alerts resolved. Learn more about Socket for GitHub.

This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored.

View full report

@chainlink

core@11.0.0 (transitive via SDK beta) has typechain factories for @Arbitrum and @chainlink that import `utils` from ethers v5 API. Extend the existing tron stub to also alias these barrels to false. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

core@11.0.0 has ethers v5 imports throughout typechain, not just tron. Alias the entire typechain barrel and buildArtifact.js to false. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel Bot deployed to Preview – hyperlane-warp-template February 20, 2026 19:05 View deployment

cursor Bot reviewed Feb 20, 2026

View reviewed changes

Comment thread src/consts/warpRoutes.yaml

cursor Bot reviewed Feb 20, 2026

View reviewed changes

Comment thread src/consts/warpRouteWhitelist.ts

Comment thread src/consts/warpRoutes.yaml

vercel Bot deployed to Preview – hyperlane-warp-template February 20, 2026 19:08 View deployment

vercel Bot deployed to Preview – hyperlane-warp-template February 25, 2026 18:01 View deployment

paulbalaji force-pushed the feat/celestia-warp-routes branch from 6292cc6 to 1e575d5 Compare February 25, 2026 18:03

vercel Bot deployed to Preview – hyperlane-warp-template February 25, 2026 18:05 View deployment

vercel Bot deployed to Preview – hyperlane-warp-template February 25, 2026 18:12 View deployment

cursor Bot reviewed Feb 25, 2026

View reviewed changes

Xaroz changed the title ~~feat: add Celestia warp routes for SOL, ETH, WBTC~~ feat: add Celestia warp routes for SOL, ETH, WBTC, eUSD Feb 25, 2026

vercel Bot deployed to Preview – hyperlane-warp-template February 25, 2026 18:43 View deployment

paulbalaji commented Feb 27, 2026

View reviewed changes

Comment thread src/consts/warpRoutes.yaml Outdated

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 14:44 View deployment

cursor Bot reviewed Feb 27, 2026

View reviewed changes

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 15:01 View deployment

paulbalaji and others added 8 commits February 27, 2026 16:54

feat: restrict warp route whitelist to Celestia routes

0903cd9

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: add TIA warp route config for Celestia <-> Eden

924ca1b

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: use EvmHypNative standard for Eden TIA warp route

3ac3507

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: add eUSD/celestia and eden to preview

bd5bf33

Apply suggestion from @paulbalaji

92628b7

chore: update SDK packages to 25.4.0-beta with EvmNative fix

111cc84

Update @hyperlane-xyz/sdk, utils, widgets to beta containing getHypAdapter support for EvmNative tokens with warp connections. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

paulbalaji force-pushed the feat/celestia-warp-routes branch from 5b269e1 to 111cc84 Compare February 27, 2026 16:55

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 16:56 View deployment

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 17:01 View deployment

fix: broaden core typechain stub for core@11 compat

78f8272

core@11.0.0 has ethers v5 imports throughout typechain, not just tron. Alias the entire typechain barrel and buildArtifact.js to false. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 17:11 View deployment

chore: update SDK beta with gas estimation fix

897dd97

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel Bot deployed to Preview – hyperlane-warp-template February 27, 2026 17:23 View deployment

Navigation Menu

Uh oh!

feat: add Celestia warp routes for SOL, ETH, WBTC, eUSD - #965

feat: add Celestia warp routes for SOL, ETH, WBTC, eUSD#965
paulbalaji wants to merge 11 commits into
mainfrom
feat/celestia-warp-routes

paulbalaji commented Feb 20, 2026 •

edited by cursor Bot

Loading

Uh oh!

vercel Bot commented Feb 20, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot Feb 25, 2026

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Feb 27, 2026

Uh oh!

socket-security Bot commented Feb 27, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

paulbalaji commented Feb 20, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

vercel Bot commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot Feb 25, 2026

Choose a reason for hiding this comment

TIA token missing collateralAddressOrDenom on Celestia

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Feb 27, 2026

Choose a reason for hiding this comment

eUSD routes missing from warp route whitelist

Uh oh!

socket-security Bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

paulbalaji commented Feb 20, 2026 •

edited by cursor Bot

Loading

vercel Bot commented Feb 20, 2026 •

edited

Loading

TIA token missing `collateralAddressOrDenom` on Celestia

socket-security Bot commented Feb 27, 2026 •

edited

Loading