From ab4c12c8ca38f3a6c1160ff33035f5b7cd56e033 Mon Sep 17 00:00:00 2001
From: Joshua <vsg@Joshuas-Mac-Studio.local>
Date: Thu, 19 Feb 2026 12:15:42 -0800
Subject: [PATCH] docs: capture sepolia contract addresses and live api status

---
 .../contract-addresses.base-sepolia.json      | 16 +++++++++++++++
 docs/deployment/secretapi-deploy.md           | 20 +++++++++++++++++++
 docs/roadmap-status.md                        |  8 ++++----
 3 files changed, 40 insertions(+), 4 deletions(-)
 create mode 100644 docs/deployment/contract-addresses.base-sepolia.json

diff --git a/docs/deployment/contract-addresses.base-sepolia.json b/docs/deployment/contract-addresses.base-sepolia.json
new file mode 100644
index 0000000..b36a635
--- /dev/null
+++ b/docs/deployment/contract-addresses.base-sepolia.json
@@ -0,0 +1,16 @@
+{
+  "network": "base-sepolia",
+  "chain_id": 84532,
+  "membership_contract": "0x3EEb3342751D1Cfc0F90C9393e0B1cd5AcE6FfD8",
+  "entitlement_contract": "0xA1c06066206d0ea63a77A093FD38327Fd5663a43",
+  "offer_registry_contract": "0xA1c06066206d0ea63a77A093FD38327Fd5663a43",
+  "treasury_wallet": "0xD148d4dFA882007e5226C90287622b3Af6eB56D7",
+  "mint_currency_mode": "ETH_TEST",
+  "mint_amount_atomic": "1",
+  "usdc_contract": "0x0000000000000000000000000000000000000000",
+  "version": "v1",
+  "notes": [
+    "Entitlement contract deploy tx succeeded on Base Sepolia.",
+    "Offer seeding call reverted during first pass; retry required before checkout e2e."
+  ]
+}
diff --git a/docs/deployment/secretapi-deploy.md b/docs/deployment/secretapi-deploy.md
index 795f498..d9a38f7 100644
--- a/docs/deployment/secretapi-deploy.md
+++ b/docs/deployment/secretapi-deploy.md
@@ -2,6 +2,26 @@
 
 This runbook deploys `web/backend/secretapi` for wallet-first membership and governance install authorization.
 
+## Current edut.dev Runtime
+
+`api.edut.dev` is currently served by the `edut-api` Docker service inside `/opt/edut/gitea/docker-compose.yml` on `edut-prod`.
+
+Routing policy:
+
+1. `api.edut.dev` -> `edut-api:8080`
+2. `git.edut.dev` -> Gitea
+3. `edut.dev` and `www.edut.dev` -> placeholder response only
+
+Active environment file on host:
+
+1. `/opt/edut/api/.env`
+
+Current test-mode settings:
+
+1. Base Sepolia (`SECRET_API_CHAIN_ID=84532`)
+2. ETH quote mode (`SECRET_API_MINT_CURRENCY=ETH`) for low-friction Sepolia smoke validation
+3. Membership contract wired to `0x3EEb3342751D1Cfc0F90C9393e0B1cd5AcE6FfD8`
+
 ## Build Targets
 
 1. Native binary:
diff --git a/docs/roadmap-status.md b/docs/roadmap-status.md
index ac56a10..c73ffbb 100644
--- a/docs/roadmap-status.md
+++ b/docs/roadmap-status.md
@@ -12,7 +12,7 @@ Status key:
 2. Freeze token taxonomy: `DONE`
 3. Finalize membership contract interface targets: `DONE`
 4. Lock signature + intent protocol: `DONE`
-5. Add membership mint transaction stage in web flow: `DONE` (frontend + backend deployed; full e2e confirm blocked only by test wallet balance below mint value)
+5. Add membership mint transaction stage in web flow: `DONE` (frontend + backend deployed; on-chain Base Sepolia quote/confirm flow validated end-to-end against `api.edut.dev`)
 6. Implement membership gate in marketplace checkout: `IN_PROGRESS` (store scaffold + gate logic implemented; live API pending)
 7. Ship offer registry schema: `DONE`
 8. Ship entitlement purchase schema/pipeline contracts: `IN_PROGRESS`
@@ -65,13 +65,13 @@ Implemented now:
 Remaining in this repo:
 
 1. Wire live store checkout flow to production marketplace APIs when available.
-2. Replace deployment templates with real contract addresses after chain deployment.
+2. Replace deployment templates with real contract addresses after chain deployment: `IN_PROGRESS` (Base Sepolia addresses captured in `docs/deployment/contract-addresses.base-sepolia.json`; mainnet pending).
 3. Add launcher/governance install UI that consumes governance installer APIs.
 
 Cross-repo dependencies (kernel/backend/contracts):
 
-1. Implement `/secret/membership/quote` and `/secret/membership/confirm`: `IN_PROGRESS` (live deployment active; strict chain verification enabled; full confirm proof pending seeded Sepolia USDC test balance).
-2. Implement membership contract and membership status reads: `IN_PROGRESS` (contract deployed on Base Sepolia; mainnet deployment pending).
+1. Implement `/secret/membership/quote` and `/secret/membership/confirm`: `DONE` (`api.edut.dev` live; typed-signature intent, quote, tx submit, confirm, and membership status read validated on Base Sepolia).
+2. Implement membership contract and membership status reads: `IN_PROGRESS` (membership contract deployed on Base Sepolia in ETH test mode; mainnet USDC deployment pending).
 3. Implement checkout APIs and entitlement mint pipeline.
 4. Implement runtime entitlement gate and evidence receipts.
 5. Implement member app channel APIs and deterministic event stream storage: `IN_PROGRESS` (live deployment active with sqlite-backed deterministic event store).