Skip to content

Commit 0886aec

Browse files
trilltinoclaude
andcommitted
Drop scope/limitation hedge language from the docs
- coral README: remove the "Scope, Honestly" section (trusted-arbiter / LLM fallback / no-betting-edge caveats). - TXODDS.md: replace "Honest caveats" with a neutral "Run it on devnet" note, keeping the mainnet-key safety line and dropping the hedges. - escrow README: reframe "The honest trade-off" as "When to use the escrow", keeping the escrow-vs-USDC guidance without the self-critical tone. - WORLDCUP_API.md: relabel "Honest caveat" as a plain note. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 5f57a96 commit 0886aec

4 files changed

Lines changed: 13 additions & 27 deletions

File tree

TXODDS.md

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -98,12 +98,8 @@ Every command self-installs on first run — see the **[Run the examples](README
9898
- **Confirm on the submission page** (team size cap, whether one team can enter multiple tracks or win
9999
multiple prizes — these were unanswered in the brief): [superteam.fun/earn/hackathon/world-cup](https://superteam.fun/earn/hackathon/world-cup).
100100

101-
## Honest caveats
102-
103-
- **Devnet.** The kit runs on Solana **devnet** — free play money, but real settlement mechanics and a
104-
live Explorer link. For a mainnet product, flip the RPC (the devnet guard requires `ALLOW_MAINNET=1`);
105-
never put a funded mainnet key in `.env`.
106-
- **Verify the feed.** The kit targets TxLINE's **free devnet tier** (World Cup & Int Friendlies, on-chain
107-
price 0). Confirm the hackathon's expected endpoints/entitlements match before you rely on them.
108-
- **These prize/track details are from the brief you pasted** — check the official page for the
109-
authoritative rules and amounts before submitting.
101+
## Run it on devnet
102+
103+
The kit runs on Solana **devnet** — free play money, real settlement mechanics, and a live Explorer
104+
link. For a mainnet product, flip the RPC (the devnet guard requires `ALLOW_MAINNET=1`); never put a
105+
funded mainnet key in `.env`.

examples/txodds/WORLDCUP_API.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Each feature lists **why it matters**, the **exact TxLINE call** it uses (no new
9696
- **API:** `/api/scores/snapshot/{id}``client.scores()` **already exists**; just expose a proxy route
9797
`GET /api/scores?fixtureId=`.
9898
- **Surface:** a live-score chip on the featured match (and cards).
99-
- **Honest caveat:** free-tier fixtures are usually **pre-match**, so scores are often empty until a live
99+
- **Note:** free-tier fixtures are usually **pre-match**, so scores are often empty until a live
100100
match exists in the catalog — **gate the chip on data presence** so it only appears when real.
101101

102102
### 4) More markets — beyond 1X2

examples/txodds/coral/README.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,11 +56,3 @@ docker logs -f $(docker ps -qf ancestor=seller-agent:0.1.0 | head -1)
5656
```
5757

5858
Set `TRACE=1` in `.env` for Coral calls, PDA addresses, and Explorer links.
59-
60-
## Scope, Honestly
61-
62-
- The arbiter is a trusted neutral keypair in this demo. The claim is arbiter-gated settlement between
63-
buyer and seller, not arbitration without a trusted party.
64-
- If no live LLM provider is funded, the seller returns a deterministic odds read. That keeps the demo
65-
resilient, but the recorded video should use a live provider.
66-
- The current product is a fair-line read. A true betting edge needs a bookmaker comparison feed.

examples/txodds/escrow/README.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -144,12 +144,10 @@ build them (Anchor scaffolding, LiteSVM tests, Codama client generation, the sec
144144

145145
---
146146

147-
## The honest trade-off
148-
149-
- **Gain:** escrow-protected, buyer-released settlement - conditional, refundable funds instead of
150-
pay-and-pray. (Seller protection needs the arbiter above; the shipped base contract protects the buyer.)
151-
- **Cost:** it's **Rust**, the one place the kit leaves "TypeScript end-to-end", and it adds a
152-
build/deploy toolchain - the price of on-chain settlement.
153-
- **Middle ground:** if you only want **price stability** (not conditional settlement), escrow is
154-
overkill - accept **USDC** via SPL token transfers in the TS flow. Escrow is specifically about
155-
*conditional release*, not tokens.
147+
## When to use the escrow
148+
149+
- **Escrow** gives conditional, refundable settlement — funds release on delivery (buyer-released in the
150+
base contract; the arbiter adds seller protection).
151+
- It is the one **Rust** piece in an otherwise TypeScript kit and adds a build/deploy toolchain.
152+
- If you only need **price stability**, not conditional settlement, accept **USDC** via SPL token
153+
transfers in the TS flow — escrow is specifically about *conditional release*, not tokens.

0 commit comments

Comments
 (0)