From 6d7cc534c4498c1eb8707a1a80ae9bca9a0baf18 Mon Sep 17 00:00:00 2001 From: Nathan Slaven Date: Fri, 22 May 2026 05:02:12 +0000 Subject: [PATCH] Add AGR market trade flow roadmap --- AGRARIAN_DEVELOPMENT_ROADMAP.md | 20 ++++++++++++++++++++ Docs/Ops/HANDOFF.md | 21 +++++++++++++++++++++ 2 files changed, 41 insertions(+) diff --git a/AGRARIAN_DEVELOPMENT_ROADMAP.md b/AGRARIAN_DEVELOPMENT_ROADMAP.md index c285691..cdfc0e8 100644 --- a/AGRARIAN_DEVELOPMENT_ROADMAP.md +++ b/AGRARIAN_DEVELOPMENT_ROADMAP.md @@ -1095,6 +1095,12 @@ Required order: - [ ] Add barter container. - [ ] Add simple trade UI. +- [ ] Add local market listing model for player-produced crops, meat, wood, + stone, fiber, tools, animals, fuel, and other transferable resources. +- [ ] Track market-facing item attributes: quantity, quality, freshness, + location, seller, ownership, storage condition, and pickup/delivery terms. +- [ ] Add item reservation/lock rules so listed goods cannot be double-sold, + consumed, moved, spoiled invisibly, or transferred while a sale is pending. - [ ] Add ownership transfer. - [ ] Add local price notes if needed. - [x] Add AGR placeholder integration planning. @@ -1167,6 +1173,10 @@ Goal: Let player communities form organically through trade, trust, conflict, la - [ ] Add secure trade window. - [ ] Add barter offer records. - [ ] Add basic contract data model. +- [ ] Add market stall and settlement market board flows where sellers can list + produced goods and buyers can browse, reserve, and purchase them naturally. +- [ ] Add direct player trade flow for face-to-face exchange of resources, + animals, crafted goods, tools, labor promises, or delivery contracts. - [ ] Add delivery contract. - [ ] Add labor contract. - [ ] Add rental contract placeholder. @@ -1175,8 +1185,16 @@ Goal: Let player communities form organically through trade, trust, conflict, la - [ ] 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 `Buy with AGR` market flow: reserve item, create payment request, + wait for confirmation, transfer ownership, release pickup/delivery rights, and + record seller/buyer receipts. - [ ] Add AGR transaction receipt records linked to game accounts, trades, contracts, timestamps, confirmations, and settlement/dispute state. +- [ ] Add timeout and cancellation rules so unpaid or failed AGR purchases + unlock the item and return the listing to the market. +- [ ] Add low-value fast-confirmation policy research for future UX, with fraud + limits and rollback/dispute handling before any pending-payment delivery is + allowed. - [ ] Decide whether player-to-player AGR trades use direct payment only, server-observed escrow, or a separate escrow service after legal and security review. @@ -1363,6 +1381,8 @@ Goal: Enable cities, citizenship, taxation, diplomacy, organized law, warfare, a - [ ] Add treasury model. - [ ] Add tax rules. +- [ ] Add settlement market fee rules for market stalls, board listings, + storage usage, delivery contracts, and public trade infrastructure. - [ ] Add public storage. - [ ] Add road funding. - [ ] Add public building funding. diff --git a/Docs/Ops/HANDOFF.md b/Docs/Ops/HANDOFF.md index a25a196..05567ec 100644 --- a/Docs/Ops/HANDOFF.md +++ b/Docs/Ops/HANDOFF.md @@ -40,6 +40,27 @@ wallet signing/payment UX through Qt wallet, website wallet, or companion wallet, plus legal/compliance review for real-value marketplace use. +## AGR Natural Market Flow Roadmap Update - 2026-05-21 + +- Nathan clarified the intended economy feel: players should be able to grow + crops, raise animals for meat, harvest wood, gather resources, craft goods, + and sell those goods naturally at markets or directly to other players. +- Roadmap updates added: + - `0.2.F Simple Economy`: local market listing model, item quality/freshness, + quantity, location, seller identity, pickup/delivery terms, and item + reservation locks so goods cannot be double-sold during a pending sale. + - `0.3.B Trade And Contracts`: market stall, settlement board, direct trade, + `Buy with AGR`, payment request, confirmation wait, ownership transfer, + receipts, timeout/cancellation, and future low-value fast-confirmation + policy research. + - `0.5.C Taxation And Public Works`: settlement market fees for stalls, + board listings, storage, delivery contracts, and public trade + infrastructure. +- Design guardrail: + game items remain server-authoritative, AGR funds remain wallet-authoritative, + and the trade layer bridges them with reservations, payment requests, + confirmation checks, receipts, and dispute records. + ## Gitea Container Repair - 2026-05-20 - Gitea is hosted on Unraid as Docker container `Gitea`.