Nexus Elements Swaps
Apps & Automationnexus-elements-swapsNexus Elements Swaps is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Install and use the Swaps widget (SwapWidget) from Nexus Elements. Use for cross-chain exact-in or exact-out swaps with intent progress UI.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/nexus-elements-swaps/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nexus-elements-swaps, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Nexus Elements - Swaps
Overview
Install the SwapWidget component for cross-chain swaps with exact-in/out modes, progress UI, and optional callbacks.
Prerequisites
- NexusProvider installed and initialized on wallet connect.
- Wallet connection configured.
Install (shadcn registry)
- Ensure shadcn/ui is initialized (
components.jsonexists). - Ensure registry mapping exists:
"registries": {
"@nexus-elements/": "https://elements.nexus.availproject.org/r/{name}.json"
}
- Install:
npx shadcn@latest add @nexus-elements/swaps
Alternative:
npx shadcn@latest add https://elements.nexus.availproject.org/r/swaps.json
Manual install (no shadcn)
- Download
https://elements.nexus.availproject.org/r/swaps.json. - Create each file in
files[].targetwithfiles[].content. - Install dependencies listed in
dependenciesand eachregistryDependenciesitem.
Usage
import SwapWidget from "@/components/swaps/swap-widget";
<SwapWidget
onStart={() => {}}
onComplete={(amount) => console.log(amount)}
onError={() => console.error("Swap failed")}
/>
SDK flow mapping
- Uses
sdk.swapWithExactIn(...)andsdk.swapWithExactOut(...). - Relies on the swap intent hook (
swapIntent) for confirmation UI. - Progress updates come from
NEXUS_EVENTS.SWAP_STEP_COMPLETE.
Props (SwapsProps)
onStart,onComplete,onError
Notes
- The widget handles exact-in and exact-out modes internally.
- If you need an error message, you can widen the
onErrorsignature inswap-widget.tsxto accept(message?: string).