AgentSkillsCN

nexus-elements-common

共享Nexus Elements的钩子与工具类（components/common）。当您需要在组件之外使用通用钩子，例如usePolling、useStopwatch，或交易步骤的实用工具时，可选用此方案。

SKILL.md
--- frontmatter
name: nexus-elements-common
description: Shared Nexus Elements hooks and utilities (components/common). Use when you need common hooks like usePolling, useStopwatch, or transaction step utilities outside of the widgets.

Nexus Elements - Common

Overview

Use the shared hooks/utilities under components/common (polling, debouncing, transaction steps, constants) when building custom Nexus UI.

When to use

  • •You want to import usePolling, useStopwatch, useTransactionSteps, or shared constants like SHORT_CHAIN_NAME.
  • •You are building a custom component and need the common ErrorBoundary.

Install

There is no standalone @nexus-elements/common registry item. Common files are bundled into most component registries.

Option A: Install any widget that includes common

Install a widget (fast-bridge, transfer, deposit, bridge-deposit, swaps, unified-balance, view-history). It will lay down components/common/* files.

Option B: Manual copy

Copy the files from:

  • •registry/nexus-elements/common/* in this repo, or
  • •Any https://elements.nexus.availproject.org/r/<component>.json that includes components/common/* in its files list.

Usage

ts
import {
  usePolling,
  useStopwatch,
  useTransactionSteps,
  SHORT_CHAIN_NAME,
} from "@/components/common";

Notes

  • •Keep components/common/index.ts intact to preserve exports.
  • •useTransactionSteps pairs with NEXUS_EVENTS (STEPS_LIST, STEP_COMPLETE, SWAP_STEP_COMPLETE) for progress UIs.
  • •These utilities are internal helpers; prefer using full widgets unless you need custom UI.