Skip to content

docs: agent flow end to end — answers the six-point audit - #57

Merged
enot3615 merged 1 commit into
mainfrom
docs/agent-flow
Sep 4, 2026
Merged

docs: agent flow end to end — answers the six-point audit#57
enot3615 merged 1 commit into
mainfrom
docs/agent-flow

Conversation

@enot3615

@enot3615 enot3615 commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

One document covering the agent-flow audit's six questions, each against what the code does today:

  1. agent vs mcp — two products, install separately; mcp depends on agent, not the reverse
  2. discovery from a bare domain — the 402 teaches on contact; aifpDiscovery at the root serves /.well-known/x402.json (with the Next.js note)
  3. init — prints addresses, never the key; ephemeral runs say so loudly
  4. at-rest — plaintext by default, AIFINPAY_WALLET_PASSPHRASE encrypts (rc.4); one seed → all chains, no per-chain seed
  5. double-pay — orderIdHash + nonce + consumedNonce, checked before broadcast
  6. what it buysdescribeQuote states amount, fee rate, and scope in words

References #55 (encryption) and #56 (describeQuote).

Covers install (agent vs mcp), merchant discovery from a bare domain, what init
prints and where the key lives, at-rest encryption and derivation, double-pay
protection, and reading what a payment buys. Each section states what the code
does today, not what it should — points 4 and 6 reference the PRs that added
the encryption and describeQuote.
@enot3615
enot3615 merged commit 722da80 into main Sep 4, 2026
16 checks passed
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