FxAeon

Explore FxAeon

Product	What it does
Trade	Open and manage supported ETH and BTC leveraged positions.
Earn	Deposit into fxSAVE and choose an available redemption or withdrawal path.
Borrow	Supply supported collateral, borrow fxUSD, repay, or withdraw collateral.
Move	Bridge fxUSD and fxSAVE between Ethereum and Base, with source and destination status shown separately.
Portfolio · History	Review balances, positions, activity, and receipt-backed recovery information.

Positions, borrowing, and fxSAVE accounting use Ethereum. Base is supported for selected Move routes; it is not a second positions ledger. See product behavior for supported routes and limitations.

Run the app

Use Node.js 22 and pnpm 11.19.0, pinned in the root package.json.

corepack enable
corepack prepare [email protected] --activate
pnpm install --frozen-lockfile
pnpm dev

Open localhost:3000. Public pages and unavailable-data states work without credentials. For protocol reads and wallet-provider setup, follow local setup.

The independent landing site runs with pnpm build:landing followed by pnpm preview:landing; it serves at localhost:4173. See the landing package guide.

Work on the code

Start with the focused check for your change, then run the release verification before a release candidate:

pnpm test
pnpm typecheck
pnpm lint
pnpm verify

pnpm verify runs the repository's configured source, dependency, build, bundle, secret, browser, and landing checks. Browser gates use deterministic or credential-free fixtures; protected Anvil tests run separately against disposable local forks. Choose the relevant suite in the testing guide and browser gate map.

Architecture and safety

The financial app is a static Next.js export. The selected user wallet signs transactions; FxAeon has no transaction backend, delegated signer, private-key input, or background executor. The reviewed, pinned f(x) SDK surface plans supported actions; reviews bind terms to the current wallet and inputs, and dependent steps require verified receipts.

Prices, charts, and portfolio estimates are display context. They do not set signing amounts or protocol limits. Missing or stale data stays unavailable. Two separate read-only Pages Functions serve optional gas quotes and landing market data.

This is unaudited application software for financial transactions. Inspect each wallet request and read the security model and vulnerability reporting policy.

Developer handbook

If you are...	Start here
Setting up a checkout	Local setup
Finding the owner of a feature	Architecture and repository map
Changing a protocol or signing path	SDK scope, security model, and contributing
Choosing tests or documenting evidence	Testing and browser gates
Preparing or diagnosing a release	Deployment and release checklist
Updating shared visual patterns	Design system

The developer handbook links the implementation guides, package references, and operational boundaries.

Repository map

Path	Contents
apps/mini-app	Financial app, wallet adapters, SDK integration, and browser harnesses
apps/landing	Independent marketing site and display-only market data
functions	Optional app gas Pages Function
docs	Maintained developer handbook and implementation references
scripts	Verification, build, deployment, and capture tools
patches	Version-bound dependency patches

Contributing · MIT License