Skip to content

Update Nexus docs for v2 (Widgets, SDK v0.0.5, concepts)#91

Open
anirudhvenu wants to merge 4 commits into
mainfrom
docs/nexus-v2-updates
Open

Update Nexus docs for v2 (Widgets, SDK v0.0.5, concepts)#91
anirudhvenu wants to merge 4 commits into
mainfrom
docs/nexus-v2-updates

Conversation

@anirudhvenu

@anirudhvenu anirudhvenu commented Jul 2, 2026

Copy link
Copy Markdown

Problem

The Nexus docs described the v1 stack — @avail-project/nexus-core, new NexusSDK(), flat NEXUS_EVENTS, global hook setters, and the pre-rearchitecture Elements widgets. Code samples no longer worked against v2.

Changes

Widgets (section renamed from "Nexus UI Elements")

  • Restructured around the single widget; per-mode pages (swap, send, deposit) document the v2 API: config.deposit + executeDeposit(...), allowedSourcePairs/allowedDestinationPairs, modal and wallet callbacks
  • Renamed to Widgets — new /docs/nexus/widgets slugs with redirects for all previous paths; npm/registry identifiers unchanged (@nexus-elements/nexus-one)
  • Standalone Unified Balance converted to a deprecation stub; agent-skills list aligned to nexus-one-*

SDK reference (target: nexus-sdk-v2 v0.0.5)

  • All pages rewritten: createNexusClient, two-step init, renamed params (toTokenSymbol/toAmountRaw/sources), typed event union, per-operation hooks, typed NexusError hierarchy, TokenBalance
  • New pages: calculate-max-for-bridge, swap-and-execute, calculate-max-for-swap, list-intents

Concepts

  • All 9 pages + intro reframed to the v2 intent model: RFF lifecycle mapped to listIntents() statuses, solver fulfilment and settlement, Nexus/Mayan provider selection, aggregator-routed swaps (LiFi/Bebop/Fibrous/0x), per-operation allowances defaulting to min
  • Reconciled against the Nexus V2 whitepaper (deposit-submitter split: solver via allowances for tokens, user wallet for natives)

Removed

  • create-liquid-apps quickstarts — the templates still ship the v1 SDK; they return once the templates are updated (redirects point to the manual installation guides)

Verification

Notes

  • Widget live-preview embeds render a registry placeholder until the nexus-one showcase components land separately (in progress on feat/nexus-elements-rearchitecture)
  • The v2 SDK has merged into availproject/nexus-sdk and shipped as @avail-project/nexus-core 2.0.0 (npm latest) — docs reference the merged package/repo
  • Hold merge until nexus-elements#feat/upgrade-elements-to-v2 lands and the widgets registry's SDK pin bumps from nexus-core 1.x to 2.x

🤖 Generated with Claude Code

anirudhvenu and others added 3 commits July 2, 2026 15:23
…epts

- Elements: restructure around the single Nexus Elements element; document
  the v2 API (config.deposit/executeDeposit, allowedSource/DestinationPairs,
  modal + wallet callbacks); deprecate the standalone Unified Balance page;
  align agent-skills list; unify naming to "Nexus Elements"
- SDK reference: rewrite all pages to @avail-project/nexus-sdk-v2 v0.0.5
  (createNexusClient, two-step init, typed event union, per-operation
  hooks, NexusError, TokenBalance); add calculate-max-for-bridge,
  swap-and-execute, calculate-max-for-swap, and list-intents pages
- Concepts: reframe to the v2 intent model — solver fulfilment and
  settlement, Nexus/Mayan provider selection, aggregator-routed swaps,
  per-operation allowances with 'min' default
- Remove create-liquid-apps quickstarts (templates still ship the v1 SDK);
  update explorer links to nexus-v2 hosts; use placeholder endpoints in
  custom NetworkConfig examples

Element live-preview embeds render a registry placeholder until the
nexus-one showcase components land separately.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Solver submits token deposits via signed intent + allowances; native-token
deposits come from the user's wallet.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Section slug /docs/nexus/nexus-ui-elements -> /docs/nexus/widgets
  (+ your-first-widget, nexus-sdk/widgets); redirects added for all old
  paths including the removed quickstarts
- Prose and nav renamed to "Widgets"; the single component is "the widget"
- Package, registry, and skill identifiers unchanged
  (@nexus-elements/nexus-one, availproject/nexus-elements)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-fumadocs Ready Ready Preview, Comment Jul 3, 2026 11:24am

Request Review

… chain data to live deployment

- Package renamed: @avail-project/nexus-sdk-v2 -> @avail-project/nexus-core (npm latest = 2.0.0)
- Repo links: availproject/nexus-sdk-v2 -> availproject/nexus-sdk (paths verified on main)
- Skill renamed to nexus-core; skills.sh links updated
- Link MIGRATION.md from reference index and v1 field-rename notes
- Sync chain/token matrix, vault + token addresses to live middleware deployment
  (drop Kaia and Flow Testnet, add MegaETH vault, Citrea USDC.e/USDT.e, current
  vault addresses, Avalanche swaps enabled, per-chain token corrections)
- reference.json: nexus_elements -> nexus_widgets, /docs/nexus/widgets, nexus-one

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant