Nexus Elements Common

Use core exports

import {
  usePolling,
  useStopwatch,
  useDebouncedValue,
  useDebouncedCallback,
  useTransactionSteps,
  useNexusError,
  SHORT_CHAIN_NAME,
  SWAP_EXPECTED_STEPS,
  WidgetErrorBoundary,
} from "@/components/common";

Build custom flow state machines

• Use useTransactionSteps to seed expected steps and mark completions from SDK events.
• Use usePolling for intent/simulation refresh loops.
• Use useDebouncedValue/useDebouncedCallback before simulation calls.
• Use useNexusError to normalize SDK exceptions into user-facing messages.

SDK events this package is designed around

• Bridge/transfer/bridge-deposit flows:
  • NEXUS_EVENTS.STEPS_LIST
  • NEXUS_EVENTS.STEP_COMPLETE
• Swap/deposit flows:
  • NEXUS_EVENTS.SWAP_STEP_COMPLETE

E2E checklist for custom components

• Ensure wallet connects and SDK initializes.
• Seed steps before starting execution.
• Attach event handlers and map them into step state.
• Clear intent/allowance/swapIntent refs on cancel/error.
• Refresh balances after success.
• Reset timers and step state on completion/cancel.