Nexus Elements - Fast Bridge

Nexus Elements - Fast Bridge

Overview

Install the FastBridge component and wire it to NexusProvider for intent-based bridging with allowance handling and progress steps.

Prerequisites

• NexusProvider installed and initialized on wallet connect.
• Wallet connection configured; you have the connected wallet address.

Install (shadcn registry)

1. Ensure shadcn/​ui is initialized (components.json exists).
2. Ensure registry mapping exists:

"registries": {
  "@nexus-elements/": "https://elements.nexus.availproject.org/r/{name}.json"
}

1. Install:

npx shadcn@latest add @nexus-elements/​fast-bridge

Alternative:

npx shadcn@latest add https://elements.nexus.availproject.org/r/fast-bridge.json

Manual install (no shadcn)

1. Download https://elements.nexus.availproject.org/r/fast-bridge.json.
2. Create each file in files[].target with files[].content.
3. Install dependencies listed in dependencies and each registryDependencies item.

Usage

import FastBridge from "@/​components/​fast-bridge/​fast-bridge";
import { SUPPORTED_CHAINS } from "@avail-project/​nexus-core";

<FastBridge
  connectedAddress={address}
  prefill={{
    token: "USDC",
    chainId: SUPPORTED_CHAINS.BASE,
  }}
  onStart={() => {}}
  onComplete={() => {}}
  onError={(message) => console.error(message)}
/>

SDK flow mapping

• Uses sdk.bridge(...) under the hood (intent-based bridge).
• Relies on intent + allowance hooks (intent, allowance) for confirmation UI.
• Progress updates come from NEXUS_EVENTS.STEPS_LIST and NEXUS_EVENTS.STEP_COMPLETE.

Props (FastBridgeProps)

• connectedAddress: connected wallet address (required)
• prefill: { token, chainId, amount?, recipient? }
• onStart, onComplete, onError

Notes

• FastBridge renders ViewHistory if installed; keep it if you want intent history.
• If the wallet disconnects, ensure you re-run handleInit on reconnect.