feat: Base Bridge executor route (#3998)

kev1n-peters · web-flow · commit add7b26f61c9 · 2026-01-14T08:53:20.000-06:00
* feat: Base Bridge executor route

* fix: no explorer link yet
diff --git a/bun.lock b/bun.lock
diff --git a/bunfig.toml b/bunfig.toml
@@ -50,6 +50,7 @@ minimumReleaseAgeExcludes = [
   "@wormhole-foundation/wormhole-connect",
   # @wormhole-labs packages
   "@wormhole-labs/cctp-executor-route",
+  "@wormhole-labs/base-bridge-executor-route",
   "@wormhole-labs/wallet-aggregator-aptos",
   "@wormhole-labs/wallet-aggregator-core",
   "@wormhole-labs/wallet-aggregator-evm",
diff --git a/package.json b/package.json
@@ -40,6 +40,11 @@
       "types": "./lib/executor.d.ts",
       "require": "./lib/executor.js",
       "import": "./lib/executor.mjs"
+    },
+    "./base": {
+      "types": "./lib/base.d.ts",
+      "require": "./lib/base.js",
+      "import": "./lib/base.mjs"
     }
   },
   "files": [
@@ -88,6 +93,7 @@
     "@wormhole-foundation/sdk-sui-core": "4.7.3",
     "@wormhole-foundation/sdk-sui-ntt": "4.0.10",
     "@wormhole-labs/cctp-executor-route": "0.25.0",
+    "@wormhole-labs/base-bridge-executor-route": "1.0.3",
     "@wormhole-labs/wallet-aggregator-aptos": "1.3.3",
     "@wormhole-labs/wallet-aggregator-core": "1.3.3",
     "@wormhole-labs/wallet-aggregator-evm": "1.3.3",
diff --git a/src/components/SampleApp/index.tsx b/src/components/SampleApp/index.tsx
@@ -52,6 +52,7 @@ import {
   monadBridgeExecutorRoute,
   monadBridgeManualRoute,
 } from 'exports/monad';
+import { createBaseBridgeRoute } from 'exports/base';
 import type { WormholeConnectTheme } from 'theme';
 
 const MAX_URL_SIZE = 30_000; // 30kb (HTTP header limit is set to 32kb)
@@ -105,6 +106,8 @@ const parseConfig = (config: string): WormholeConnectConfig => {
       window.monadBridgeExecutorRoute = monadBridgeExecutorRoute;
       /* @ts-ignore */
       window.monadBridgeManualRoute = monadBridgeManualRoute;
+      /* @ts-ignore */
+      window.createBaseBridgeRoute = createBaseBridgeRoute;
 
       return eval(
         `(function() { return ${config} })()`,
@@ -352,6 +355,10 @@ function SampleApp() {
                     <pre>monadBridgeManualRoute</pre>
                     <i>{'(MultiTokenNttRoute.Config) -> RouteConstructor'}</i>
                   </li>
+                  <li>
+                    <pre>createBaseBridgeRoute</pre>
+                    <i>{'(TokenConfiguration[])) -> RouteConstructor'}</i>
+                  </li>
                   <li></li>
                 </ul>
               </div>
diff --git a/src/config/testnet/chains.ts b/src/config/testnet/chains.ts
@@ -91,7 +91,7 @@ export const TESTNET_CHAINS: ChainsConfig = {
   },
   BaseSepolia: {
     displayName: 'Base Sepolia',
-    explorerUrl: 'https://base-sepolia.blockscout.com/',
+    explorerUrl: 'https://sepolia.basescan.org/',
     explorerName: 'Etherscan',
     icon: 'Base',
     symbol: 'BASE',
diff --git a/src/exports/base.ts b/src/exports/base.ts
@@ -0,0 +1,3 @@
+import '@wormhole-labs/base-bridge-executor-route';
+
+export { createBaseBridgeRoute, type TokenConfiguration } from '../routes/base';
diff --git a/src/hooks/useFetchQuotes.ts b/src/hooks/useFetchQuotes.ts
@@ -247,6 +247,11 @@ export default (routes: string[], params: Params): HookReturn => {
         continue;
       }
 
+      // Skip value loss filtering for BaseBridgeRoute (value should be preserved 1:1)
+      if (name === 'BaseBridgeRoute') {
+        continue;
+      }
+
       const quote = filtered[name];
 
       if (quote !== undefined && quote.success) {
diff --git a/src/hooks/useGasSlider.ts b/src/hooks/useGasSlider.ts
@@ -1,7 +1,9 @@
+import type { Chain } from '@wormhole-foundation/sdk';
 import config from 'config';
 import type { Token } from 'config/tokens';
 
 type Props = {
+  destChain?: Chain;
   destToken?: Token;
   route?: string;
   isTransactionInProgress: boolean;
@@ -13,9 +15,13 @@ export const useGasSlider = (
   disabled: boolean;
   showGasSlider: boolean | undefined;
 } => {
-  const { destToken, route, isTransactionInProgress } = props;
+  const { destChain, destToken, route, isTransactionInProgress } = props;
 
-  const disabled = isTransactionInProgress;
+  // Disable gas toggle for BaseBridgeRoute when destination is Base
+  const isBaseBridgeToBase =
+    route === 'BaseBridgeRoute' && destChain === 'Base';
+
+  const disabled = isTransactionInProgress || isBaseBridgeToBase;
   const showGasSlider =
     !!route &&
     config.routes.get(route).NATIVE_GAS_DROPOFF_SUPPORTED &&
diff --git a/src/routes/base/bridge.ts b/src/routes/base/bridge.ts
@@ -0,0 +1,16 @@
+import type { BaseBridgeExecutorRoute } from '@wormhole-labs/base-bridge-executor-route';
+import {
+  baseBridgeRoute,
+  type TokenConfiguration,
+} from '@wormhole-labs/base-bridge-executor-route';
+import type { routes } from '@wormhole-foundation/sdk-connect';
+
+export type { BaseBridgeExecutorRoute, TokenConfiguration };
+
+export function createBaseBridgeRoute(
+  tokens: TokenConfiguration[],
+  config?: BaseBridgeExecutorRoute.Config,
+): routes.RouteConstructor {
+  config = config || { referrerFeeDbps: 0n };
+  return baseBridgeRoute(config, tokens);
+}
diff --git a/src/routes/base/index.ts b/src/routes/base/index.ts
@@ -0,0 +1,2 @@
+export { createBaseBridgeRoute } from './bridge';
+export type { TokenConfiguration } from './bridge';
diff --git a/src/utils/index.ts b/src/utils/index.ts
@@ -375,6 +375,11 @@ export const isFrankensteinToken = (token: Token, chain: Chain) => {
     return true;
   }
 
+  // All WTT transfers to Base are frankenstein since the Base bridge exists
+  if (chain === 'Base' || chain === 'BaseSepolia') {
+    return true;
+  }
+
   const { tokenBridgeOriginalTokenId: originalToken } = token;
 
   // Prevent Monad<->Ethereum transfers of gas token via token bridge
@@ -463,7 +468,7 @@ export const isExecutorRoute = (route: string | undefined) => {
   if (!route) {
     return false;
   }
-  return route.endsWith('ExecutorRoute');
+  return route.endsWith('ExecutorRoute') || route === 'BaseBridgeRoute';
 };
 
 export const stringifyWithBigInt = (json: any) => {
diff --git a/src/utils/isFrankensteinToken.test.ts b/src/utils/isFrankensteinToken.test.ts
@@ -170,4 +170,46 @@ describe('isFrankensteinToken', () => {
       expect(isFrankensteinToken(WMONSolana, 'Solana')).toBe(true);
     });
   });
+
+  describe('WTT transfers to Base', () => {
+    it('should return true for any WTT token on Base (Base bridge should be used instead)', () => {
+      const ethereumWETH = new Token({
+        chain: 'Ethereum',
+        address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+        decimals: 18,
+        symbol: 'WETH',
+      });
+
+      const wrappedOnBase = new Token({
+        chain: 'Base',
+        address: '0x1234567890123456789012345678901234567890',
+        decimals: 18,
+        symbol: 'WETH',
+        tokenBridgeOriginalTokenId: ethereumWETH.tokenId,
+      });
+
+      expect(isFrankensteinToken(wrappedOnBase, 'Base')).toBe(true);
+    });
+
+    it('should return true for any WTT token on BaseSepolia', () => {
+      const sepoliaWETH = new Token({
+        chain: 'Sepolia',
+        address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+        decimals: 18,
+        symbol: 'WETH',
+      });
+
+      const wrappedOnBaseSepolia = new Token({
+        chain: 'BaseSepolia',
+        address: '0x1234567890123456789012345678901234567890',
+        decimals: 18,
+        symbol: 'WETH',
+        tokenBridgeOriginalTokenId: sepoliaWETH.tokenId,
+      });
+
+      expect(isFrankensteinToken(wrappedOnBaseSepolia, 'BaseSepolia')).toBe(
+        true,
+      );
+    });
+  });
 });
diff --git a/src/utils/sdkv2.ts b/src/utils/sdkv2.ts
@@ -24,6 +24,7 @@ import {
 import type { NttRoute } from '@wormhole-foundation/sdk-route-ntt';
 import type { MultiTokenNttRoute } from '@wormhole-foundation/sdk-route-ntt';
 import type { CCTPv2ExecutorRoute } from '@wormhole-labs/cctp-executor-route';
+import type { BaseBridgeExecutorRoute } from '@wormhole-labs/base-bridge-executor-route';
 import { Connection } from '@solana/web3.js';
 import { PublicKey } from '@solana/web3.js';
 import * as splToken from '@solana/spl-token';
@@ -137,6 +138,9 @@ export function getExplorerInfos(
         name: 'USDC.range Explorer',
       },
     ];
+  } else if (routeName === 'BaseBridgeRoute') {
+    // Base Bridge transactions are not indexed on Wormholescan yet
+    return [];
   } else {
     return [getWormholescanExplorerInfo(txHash)];
   }
@@ -205,6 +209,10 @@ export async function parseReceipt(
         },
         getOrFetchToken,
       );
+    case 'BaseBridgeRoute':
+      return parseBaseBridgeReceipt(
+        receipt as ReceiptWithAttestation<BaseBridgeExecutorRoute.Attestation>,
+      );
     default:
       throw new Error(`Unknown route type ${route}`);
   }
@@ -589,6 +597,79 @@ const parseCCTPv2Receipt = async (
   return txData as TransferInfo;
 };
 
+const parseBaseBridgeReceipt = async (
+  receipt: ReceiptWithAttestation<BaseBridgeExecutorRoute.Attestation>,
+): Promise<TransferInfo> => {
+  let sendTx = '';
+  if ('originTxs' in receipt && receipt.originTxs.length > 0) {
+    sendTx = receipt.originTxs[receipt.originTxs.length - 1].txid;
+  } else {
+    throw new Error("Can't find txid in receipt");
+  }
+
+  const { transferInfo } = receipt.attestation;
+  if (!transferInfo) {
+    throw new Error('BaseBridgeRoute attestation missing metadata');
+  }
+
+  const sourceToken = config.tokens.get(receipt.from, transferInfo.localToken);
+  if (!sourceToken) {
+    throw new Error(
+      `Unknown source token: ${transferInfo.localChain} on ${receipt.from}`,
+    );
+  }
+
+  const destToken = config.tokens.get(receipt.to, transferInfo.remoteToken);
+  if (!destToken) {
+    throw new Error(
+      `Unknown destination token: ${transferInfo.remoteToken} on ${receipt.to}`,
+    );
+  }
+
+  const amt = amount.fromBaseUnits(transferInfo.amount, sourceToken.decimals);
+
+  let recipient = transferInfo.to;
+  if (isSvmChain(receipt.to)) {
+    const rpcUrl = config.rpcs[receipt.to];
+    if (!rpcUrl) {
+      throw new Error(`Missing ${receipt.to} RPC`);
+    }
+    // The recipient is the ATA, get the owner
+    const connection = new Connection(rpcUrl);
+    try {
+      const mint = new PublicKey(transferInfo.remoteToken);
+      const ata = new PublicKey(transferInfo.to);
+      const tokenAccount = await connection.getAccountInfo(mint);
+      if (tokenAccount) {
+        recipient = (
+          await splToken.getAccount(
+            connection,
+            ata,
+            'confirmed',
+            tokenAccount.owner,
+          )
+        ).owner.toBase58();
+      }
+    } catch (e) {
+      console.error(e);
+    }
+  }
+
+  return {
+    toChain: receipt.to,
+    fromChain: receipt.from,
+    sendTx,
+    sender: undefined,
+    recipient,
+    amount: amt,
+    tokenAddress: sourceToken.address.toString(),
+    token: sourceToken.tuple,
+    tokenDecimals: sourceToken.decimals,
+    receivedToken: destToken.tuple,
+    receiveAmount: amt,
+  };
+};
+
 const parseMultiTokenNttReceipt = async (
   receipt: ReceiptWithAttestation<MultiTokenNttRoute.AttestationReceipt> & {
     params: MultiTokenNttRoute.ValidatedParams;
diff --git a/src/views/v3/Bridge/Routes/SingleRoute.tsx b/src/views/v3/Bridge/Routes/SingleRoute.tsx
@@ -118,6 +118,7 @@ const SingleRoute = (props: Props) => {
   const { sourceToken, destToken } = useGetTokens();
 
   const { disabled: isGasSliderDisabled, showGasSlider } = useGasSlider({
+    destChain,
     destToken,
     route: props.route,
     isTransactionInProgress,
diff --git a/src/views/v3/Redeem/index.tsx b/src/views/v3/Redeem/index.tsx
diff --git a/vite.config.mts b/vite.config.mts

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import '@wormhole-labs/base-bridge-executor-route';`
	`2`	`+`
	`3`	`+export { createBaseBridgeRoute, type TokenConfiguration } from '../routes/base';`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+export { createBaseBridgeRoute } from './bridge';`
	`2`	`+export type { TokenConfiguration } from './bridge';`