From 507f7ad2f12fd2fe1c14ab1aa1c96d60b7eef54e Mon Sep 17 00:00:00 2001 From: Nathan Slaven Date: Fri, 22 May 2026 04:38:22 +0000 Subject: [PATCH] Add AGR wallet integration roadmap --- AGRARIAN_DEVELOPMENT_ROADMAP.md | 41 +++++++++++++++++++++++++++++++++ Docs/Ops/HANDOFF.md | 26 +++++++++++++++++++++ 2 files changed, 67 insertions(+) diff --git a/AGRARIAN_DEVELOPMENT_ROADMAP.md b/AGRARIAN_DEVELOPMENT_ROADMAP.md index 254038e..c285691 100644 --- a/AGRARIAN_DEVELOPMENT_ROADMAP.md +++ b/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 diff --git a/Docs/Ops/HANDOFF.md b/Docs/Ops/HANDOFF.md index 1073684..a25a196 100644 --- a/Docs/Ops/HANDOFF.md +++ b/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`.