Add AGR wallet integration roadmap

AGRARIAN_DEVELOPMENT_ROADMAP.md

@@ -1098,6 +1098,13 @@ Required order:
 - [ ] Add ownership transfer.
 - [ ] Add local price notes if needed.
 - [x] Add AGR placeholder integration planning.
+- [ ] Add AGR wallet visibility MVP: let a player link a public AGR wallet
+  address, query a trusted AGR node/API, and show the read-only AGR balance in
+  the HUD without storing private keys or enabling spending.
+- [ ] Add linked-wallet profile storage with address format validation,
+  refresh/error states, and clear non-custodial language.
+- [ ] Add server-side AGR balance lookup service contract so the Unreal client
+  does not talk directly to private node credentials.
 - [ ] Add transaction logging.
 - [ ] Add early business knowledge for bookkeeping, inventory, profit/loss, fair trade, basic credit, risk, and customer trust.
 - [ ] Add simple workshop/business ownership rules for homestead-scale production.
@@ -1148,6 +1155,11 @@ Goal: Let player communities form organically through trade, trust, conflict, la
 - [ ] Add positive reputation events.
 - [ ] Add negative reputation events.
 - [ ] Add reputation decay or locality rules.
+- [ ] Add AGR wallet ownership verification by signed message or equivalent
+  non-custodial proof so a player can prove they control a linked address
+  without sharing a private key.
+- [ ] Add privacy-safe wallet display rules so players can choose whether their
+  public AGR address or balance is visible to others.
 
 ## 0.3.B Trade And Contracts
 
@@ -1160,6 +1172,14 @@ Goal: Let player communities form organically through trade, trust, conflict, la
 - [ ] Add rental contract placeholder.
 - [ ] Add contract completion rules.
 - [ ] Add dispute placeholder.
+- [ ] Add AGR payment request flow for player-to-player trade: seller creates a
+  payment request, buyer pays through their own wallet, and the server verifies
+  chain confirmation before marking the contract paid.
+- [ ] Add AGR transaction receipt records linked to game accounts, trades,
+  contracts, timestamps, confirmations, and settlement/dispute state.
+- [ ] Decide whether player-to-player AGR trades use direct payment only,
+  server-observed escrow, or a separate escrow service after legal and security
+  review.
 
 ## 0.3.C Crime And Consequences
 
@@ -1347,6 +1367,8 @@ Goal: Enable cities, citizenship, taxation, diplomacy, organized law, warfare, a
 - [ ] Add road funding.
 - [ ] Add public building funding.
 - [ ] Add treasury audit logs.
+- [ ] Add optional AGR-backed settlement treasury design only after wallet
+  linking, payment verification, audit logs, and legal review are mature.
 
 ## 0.5.D Diplomacy
 
@@ -1781,6 +1803,25 @@ These tracks run across all phases and must not be left as afterthoughts.
 - [x] Define market transaction logs.
 - [x] Define bridge between web wallet and game account.
 - [x] Define legal/compliance review points.
+- [ ] Phase 1 / `0.2.F`: non-custodial wallet link and read-only AGR balance
+  display in the HUD.
+- [ ] Phase 2 / `0.3.A`: prove wallet ownership with signed messages or an
+  equivalent non-custodial verification flow.
+- [ ] Phase 3 / `0.3.B`: verify player-to-player AGR payment requests from
+  external wallets before in-game trade completion.
+- [ ] Phase 4 / `0.3.B` to `0.5.C`: add transaction receipts, dispute records,
+  settlement treasury concepts, and audit logs.
+- [ ] Phase 5 / post-security review: decide whether Agrarian ever offers a
+  website wallet or custodial wallet; do not store player private keys in the
+  game client or dedicated server before that review.
+- [ ] Outside-game dependency: operate a trusted AGR full node, indexer or
+  explorer API, and backend balance/transaction verification service reachable
+  by the game server.
+- [ ] Outside-game dependency: provide Qt wallet, website wallet, or companion
+  wallet signing/payment UX for players before spending is enabled.
+- [ ] Outside-game dependency: complete legal/compliance review for real-value
+  currency use, marketplace payments, fees, custody, refunds, taxes, and
+  regional availability before enabling player-to-player AGR spending.
 
 ## E. Admin And Moderation
 

Docs/Ops/HANDOFF.md

@@ -14,6 +14,32 @@
 - The old `/home/nathan/agrarian/dev/ROADMAP.md` is coin/wallet-specific and
   should not be treated as the game roadmap.
 
+## AGR Wallet Integration Roadmap Update - 2026-05-21
+
+- Nathan clarified that AGR coin is a major investor hook for Agrarian:
+  eventually players should be able to use AGR both in game and in real life
+  wherever AGR is accepted.
+- Roadmap direction added:
+  - `0.2.F Simple Economy`: start with non-custodial wallet linking and
+    read-only AGR balance display in the HUD.
+  - `0.3.A Identity And Reputation`: prove wallet ownership with signed
+    messages or equivalent non-custodial proof.
+  - `0.3.B Trade And Contracts`: add player-to-player AGR payment requests,
+    external-wallet payment, server confirmation verification, and transaction
+    receipt records.
+  - `0.5.C Taxation And Public Works`: consider AGR-backed settlement treasury
+    only after earlier verification, audit, and legal steps are mature.
+  - Appendix `D. AGR Integration`: expanded into phases plus outside-game
+    dependencies.
+- Important guardrail:
+  do not store player private keys in the Unreal client, dedicated server, or
+  ordinary player profile during MVP. Start by linking public addresses and
+  querying balances from a trusted backend.
+- Outside-game dependencies required before full spending:
+  trusted AGR node/indexer/API, backend balance and transaction verifier,
+  wallet signing/payment UX through Qt wallet, website wallet, or companion
+  wallet, plus legal/compliance review for real-value marketplace use.
+
 ## Gitea Container Repair - 2026-05-20
 
 - Gitea is hosted on Unraid as Docker container `Gitea`.