Landing + agent doc pass: clearer copy, live params, key roles#73
Merged
Conversation
Landing/UI: - MetricsStrip: replace "Volume (TAO)" label with "Volume" + τ unit on the value - HowItWorks: clarify miners publish rates and have collateral locked - ValueProps: tighten "Best rate" body; rename "Subnet-native" to "Native settlement" and rewrite to focus on no-bridge / no-IOU - AgentTeaser: "any LLM" -> "any agent harness" - Footer + links: drop Status link (no live page) - SwapPage: link "CLI" to docs/swap-guide alongside the agent bundle - AgentsPage: append a one-liner on agent-native swapping Agent quickstart (AgentMarkdown / public/llms.txt): - Code is law: review everything, not a curated subset - Actors: miners post collateral + rates first; users pick a pair/rate - Reservation lifecycle covered explicitly (reserve / confirm / initiate) with view commands and reservation endpoints called out - Replace hardcoded reservation TTL / fulfillment timeout text with pointers to alw view contract + GET /protocol/constants - Surface coldkey vs hotkey signing front-and-center: new "Wallet roles & funding" subsection + per-direction pre-flight checklist - Step 3 of swap flow now says coldkey signs TAO source (hotkey not involved); user-side swaps don't need a hotkey at all - TAO -> BTC example added; --receive-address note clarified - alw swap quote example output included (post-fee receive amount) - Verify-install renamed "scope the system"; alw view contract / validators added; empty-miner diagnosis pointer included - Mainnet contract marked TBD; testnet contract corrected to 5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg, full testnet .env block included - "lightweight" wording: Esplora-compatible (Blockstream + Mempool fallback) instead of just Blockstream - .env file location pinned to CWD where alw is invoked - Sender verification copy: "the wallet tied to your reservation" - "safe default" reworded to "intended to be safe"
anderdc
approved these changes
May 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sweeps the landing page, swap CTA, agents page, and the agent quickstart bundle (AgentMarkdown.ts + mirrored public/llms.txt) based on a feedback pass — partly direct copy edits, partly fixes surfaced by an agent that ran the quickstart and tripped on the gaps.
Landing / UI
Volume (TAO), render volume withτunit on the value.LINKS.status).Agent quickstart (
AgentMarkdown.ts+public/llms.txt)reserve → confirm → initiate), withalw view reservationand the/reservations/by-source/{address}endpoint called out for live tracking.alw view contract+GET /protocol/constants(and a field-by-field gloss).--receive-addressis a BTC address); spelled out every flag's meaning inline.alw swap quoteexample output included so models know which line is the post-fee receive amount.alw view contract/alw view validatorsadded; empty-miner diagnosis pointer included.5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg, full testnet.envblock included.lightweightmode now described as Esplora-compatible (Blockstream primary, Mempool.space fallback)..envfile location pinned to CWD wherealwis invoked.Mirroring
public/llms.txtis regenerated fromAGENT_MARKDOWNso/llms.txtmatches the page exactly.Test plan
npm run buildpasses (verified locally)