Skip to content

Landing + agent doc pass: clearer copy, live params, key roles#73

Merged
anderdc merged 2 commits into
testfrom
feedback/ui-and-agent-doc-pass
May 4, 2026
Merged

Landing + agent doc pass: clearer copy, live params, key roles#73
anderdc merged 2 commits into
testfrom
feedback/ui-and-agent-doc-pass

Conversation

@LandynDev
Copy link
Copy Markdown
Collaborator

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

  • MetricsStrip — drop Volume (TAO), render volume with τ unit on the value.
  • HowItWorksAllways miners publish live rates; Supporting miner has collateral locked.
  • ValueProps — tighten Best rate; rename Subnet-nativeNative settlement with a no-bridges / no-IOUs body.
  • AgentTeaserany LLMany agent harness.
  • Footer / links — remove the dead Status link (and the unused LINKS.status).
  • SwapPage — link "CLI" to the docs swap-guide alongside the agent bundle.
  • AgentsPage — keep the punchy intro, add one sentence on agent-native swapping.

Agent quickstart (AgentMarkdown.ts + public/llms.txt)

  • Code is law — review everything, not a curated subset.
  • Actors — miners post collateral and rates before any swap exists; users pick a pair/rate which resolves to a miner.
  • Reservation lifecycle now explicit (reserve → confirm → initiate), with alw view reservation and the /reservations/by-source/{address} endpoint called out for live tracking.
  • Replaced hardcoded reservation TTL / fulfillment timeout copy with pointers to alw view contract + GET /protocol/constants (and a field-by-field gloss).
  • New Wallet roles & funding subsection — coldkey vs hotkey, who signs what, per-direction pre-flight funding checklist. Step 3 of the swap flow now says coldkey signs TAO source; user-side swaps don't need a hotkey at all.
  • Added a TAO → BTC flag-driven example (--receive-address is a BTC address); spelled out every flag's meaning inline.
  • alw swap quote example output included so models know which line is the post-fee receive amount.
  • Verify-install renamed Verify the install + scope the system; alw view contract / alw view validators added; empty-miner diagnosis pointer included.
  • Mainnet contract marked TBD (not yet deployed); testnet contract corrected to 5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg, full testnet .env block included.
  • lightweight mode now described as Esplora-compatible (Blockstream primary, Mempool.space fallback).
  • .env file location pinned to CWD where alw is invoked.
  • Misc copy: "safe default" → "intended to be safe"; sender verification reads "the wallet tied to your reservation".

Mirroring

public/llms.txt is regenerated from AGENT_MARKDOWN so /llms.txt matches the page exactly.

Test plan

  • npm run build passes (verified locally)
  • Landing page renders the τ unit and updated cards correctly in dev
  • Agents page intro renders the new line under the existing punchy sentence
  • /agents bundle copy matches /llms.txt (diff in browser)
  • Swap page CTA opens the right docs page

LandynDev added 2 commits May 4, 2026 18:18
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 anderdc merged commit bc13186 into test May 4, 2026
2 checks passed
@anderdc anderdc deleted the feedback/ui-and-agent-doc-pass branch May 4, 2026 23:51
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.

2 participants