apex-fusion-site/README.md

AP3X Fusion — ecosystem hub

The public ecosystem site for Apex Fusion, served at https://apex-fusion.odyssey-works.io.

What this is

A single self-unpacking index.html (~2.1 MB) — React and all assets are bundled inside it. Sections: ecosystem overview, the Vector edge, tri-chain architecture, AP3X across ecosystems, markets, stack map, HAL 8, news, wallets, bridges, dapps, explorers, staking, developers, exchanges.

Standalone pages

agent-economy-stack.html — "The AI Agent Economy Stack" (HAL 8's capability, economic and trust planes, architecture stack, standards and ecosystem) set in the hub's design language, served at /agent-economy-stack.html. Plain HTML with the hub's :root tokens and every logo embedded inline as SVG, so it can later be folded into the bundled page as a section. Fonts come from Google Fonts like the hub. Third-party marks are the owners' official files.

How it is served

Caddy on the HAL 8 host serves this directory as a static site. The box pulls this repository; there is no build step and nothing to compile — committing to main is the deploy.

Because the site is public and carries no secrets, this repository is public too, so the host clones it without credentials.

External dependencies

Two things are fetched at runtime rather than bundled:

• three.js 0.160.0 from cdn.jsdelivr.net — powers the Fusion Chamber 3D visual (§12). If the CDN is unreachable that section degrades; the rest of the page is unaffected.
• The AI assistant widget posts to window.FUSION_AI_ENDPOINT, falling back to text.pollinations.ai. See the note below.

Note on the AI assistant

The chat widget in the bottom-right sends visitor messages to a third-party inference endpoint by default. window.FUSION_AI_ENDPOINT can be repointed at HAL 8's own OpenAI-compatible API (https://hal8.odyssey-works.io/v1) so conversations stay on Odyssey Works infrastructure.

Markets section — live feeds

Every number on the Markets page is fetched by the visitor's browser, so only CORS-open sources can be called directly. Two are not, and the site origin proxies them (Caddy, deploy/Caddyfile in the HAL 8 repo):

Path on this origin	Upstream	Used for
/api/koios/*	api.koios.rest	VyFi pool reserves, cstAP3X vault + supply, Minswap V2 pool datum
/api/lbank/*	api.lbkex.com	AP3X/USDT ticker, depth, last trade

Direct (CORS-open): CoinGecko, DexScreener, the Minswap aggregator (agg-api.minswap.org, rate-limited to roughly five calls a minute per IP, so the page makes one), Base JSON-RPC (base-rpc.publicnode.com; the two Uniswap V3 pools and the Aerodrome cbADA pool are read from the chain because DexScreener does not index them), ApexScan v1 on Nexus (USDC.e), the Vector Koios instance, the Prime explorer, OSAM. DexHunter is the fallback for Cardano reserves when Koios is down.

Fast feeds refresh every 90 s; the quota'd ones (Koios, LBank, Base RPC, ApexScan) every third tick. Polling pauses in hidden tabs.

The page's own Cardano truth is a staking receipt, not a fourth asset: cstAP3X is worth vault cAP3X / cstAP3X issued cAP3X each (about 1.07), so it trades above cAP3X by design.

Updating

Edit index.html, commit to main, and the host picks it up on its next deploy tick (every five minutes). No build, no bundler, no CI.

The page is stored inside index.html as a JSON-encoded template that the bundler unpacks at load time, so do not edit the escaped text by hand. tools/bundle.py decodes it to a plain HTML file and re-encodes it byte-exactly:

python3 tools/bundle.py decode index.html page.html   # edit page.html
python3 tools/bundle.py encode index.html page.html index.html

The Markets code lives in page.html between const MK_CG and const SECTION_COMPONENTS.