latest updates

Author: snissn

AGENTS.md

@@ -11,7 +11,8 @@ Spec-aligned (new) pipeline:
 - Contracts generator: `packages/generator` (single-contract, mapping-based CRUD `App.sol`, Solidity 0.8.24).
 - CLI: `packages/cli` (`th init|studio|validate|import-legacy|generate|build|deploy|verify|doctor`).
 - Build output: `th build <schema> --out <dir>` writes `contracts/App.sol`, `compiled/App.json`, `schema.json`, `manifest.json`.
-- Deploy: `th deploy <buildDir> --chain anvil|sepolia` (anvil + sepolia supported).
+- Deploy: `th deploy <buildDir> --chain anvil|sepolia|filecoin_calibration|filecoin_mainnet` (all supported).
+- Runtime tx mode: `manifest.extensions.tx.mode` supports `userPays|sponsored`; `th build/th up` support `--tx-mode auto|userPays|sponsored`.
 
 Legacy (deprecated path; no longer source-of-truth in this repo):
 - Input: legacy `contracts.json` shape (`contracts{}` with `fields`, `initRules`, `readRules`, `writeRules`).
@@ -150,6 +151,7 @@ Goal: replace ad-hoc scripts with a coherent CLI that runs locally and in CI.
 Phase 5 progress (done/partial):
 - Implemented: `th init`, `th studio` (local schema builder), `th validate`, `th import-legacy`, `th generate` (contracts + UI), `th build`, `th deploy`, `th verify` (Sourcify + Etherscan), `th doctor`, `th up|run|dev`.
 - `th generate --with-tests` emits generated app test scaffold and generated app CI workflow.
+- Local preview now supports a sponsored relay endpoint (`/__tokenhost/relay`) for anvil, with faucet gated off when tx mode is `sponsored`.
 
 Remaining:
 - `th publish` (if/when in scope).

README.md

@@ -11,6 +11,13 @@ Execution backlog and current gap-tracking is in `AGENTS.md`.
 - Legacy frontend continuity lives in `tokenhost/app-tokenhost-com-frontend`.
 - Preserved migration/behavior notes: `docs/legacy-tokenhost-web-template-notes.md`.
 
+## First-class chain targets
+
+- `anvil`
+- `sepolia`
+- `filecoin_calibration`
+- `filecoin_mainnet`
+
 ## Current generated-app testing model
 
 - `th generate <schema> --with-tests` emits generated app tests and a generated app CI workflow.
@@ -46,3 +53,25 @@ Use `th verify <buildDir>` after deployment to verify on Sourcify and/or Ethersc
 - Writes verification status back into `manifest.json` under `deployments[*].verified`
   and `manifest.extensions.verification[chainId]`.
 - Re-publishes manifest into `ui-site/` when present.
+
+## Transaction modes (generated UI)
+
+Builder supports transaction mode metadata in `manifest.extensions.tx`:
+
+- `userPays`: browser wallet signs/sends writes directly.
+- `sponsored`: generated UI posts writes to a relay endpoint.
+
+CLI controls:
+
+- `th build <schema> --tx-mode auto|userPays|sponsored`
+- `th up <schema> --tx-mode auto|userPays|sponsored`
+
+Default `auto` behavior:
+
+- anvil/local chain => `sponsored`
+- other chains => `userPays`
+
+Local preview endpoints:
+
+- `GET/POST /__tokenhost/relay` for sponsored local writes (anvil).
+- `GET/POST /__tokenhost/faucet` remains available for non-sponsored local mode.