User Guide
Everything you need to register, create markets, place bets, resolve contracts, and verify the audit trail.
Welcome
betonanything — self-service prize prediction platform. Dynamic pool mode DPM (share-based pool, odds auto-priced).
Getting Started — Register, Verify, Login
Account creation is email + password + OTP verification. New accounts receive 1,000,000 TCN and initial trust score after email verification.
Steps
- Open /register, enter your email and a password (≥12 chars).
- Submit — system sends a 6-digit OTP to your inbox (valid 10 minutes, single use).
- Enter the code on /verify. After success, your wallet is credited.
- Login via /login with the same email + password.
- Sign out from Account → Sign out at the bottom of /me. Sessions are revoked server-side so a stolen cookie cannot be replayed.
/register — a new OTP is sent (no error). Limit: 3 OTPs per email per hour.Assets — TCN, Wallet, Trust
Your account holds three things: TCN balance (wallet), trust score, and contract history. None of these are convertible to real money.
- TCN = platform credit. Initial gift = 1,000,000 TCN after email verification. Used to back bets and pay DPM share costs.
- Wallet has two parts: available (freely usable) and locked (held in open contracts). Locked → available on contract resolution.
- Trust score starts at a default value. It DECREASES on BREACH (you fail to honor a contract). It bounds your future bet/banker capacity.
DPM Markets — Dynamic Pool
DPM = Dynamic Parimutuel. Instead of fixed odds, you buy shares of an outcome. Cost rises as more shares are bought. Winners split the pool proportionally.
Create a DPM market
- Go to /markets/new/dpm (or pick DPM from the new-market page).
- Set title, category, lock-time, outcomes (N ≥ 2).
- Set seed per outcome (initial shares = liquidity floor). Higher seed = lower initial cost-per-share but you pay more upfront.
- κ (kappa) is admin-set and shown in the form. Tick risk-confirm and submit. Total seed cost is moved to locked.
Buy shares
Open a DPM market → outcome card shows current q (total shares). Drag slider for shares to buy → preview shows cost (rises with more shares). On settle, winning side gets: (total pool − κ fee) × your_shares / winning_total_shares.
Void & Refund
If oracle returns no clear winner or Σ outcome results ≠ 1 (programmable settlement rule), all bets are refunded at their original cost. No κ fee.
Settlement
Admin triggers settlement once the outcome is confirmed; all holders of the winning option are paid out proportionally (1 share = 1 TCN); the remainder is platform rake.
Account Page — Your Hub
- /me/bets — current open DPM positions, with per-position max win/max loss.
- /me/history — resolved contracts (with role, amount, status) and trust-score change events.
- Scroll to the bottom of /me to find the red Sign out button. Logout revokes the session token server-side (cookie copy elsewhere cannot be replayed).
Transparency — Audit the Platform Yourself
Visit /transparency for the combined Merkle root computed over ledger / trust / contract / oracle_payload sources. The platform cannot retroactively alter history without invalidating the root.
Verify offline
- Download fingerprint listings per source (BLAKE3, 32 bytes per row) — the page links to the verify script.
- Run the verifier locally: it computes RFC 6962 Merkle root per source (leaf prefix 0x00, node prefix 0x01).
- Combined root = BLAKE3(domain_tag ‖ ledger_root ‖ trust_root ‖ contract_root ‖ oracle_root). Compare to the value shown on /transparency. Match = platform consistent.
Entity signatures (Ed25519)
Every core entity (users / wallets / contracts / ledger entries) is signed by the platform Ed25519 private key over a BLAKE3 fingerprint of canonical fields. Browsers can verify each row independently with Web Crypto.
| Entity | Fingerprint fields | Re-sign policy |
|---|---|---|
users |
id, email, role, status, trust_score, … | Yes (every save) |
wallets |
user_id, balance_available, balance_locked, version | Yes (every save) |
ledger_entries |
user_id, amount_delta, reason, ref_*, prev_hash | Append-only — never updated |
How to verify in your browser
- Fetch the row and the platform public key from
/api/platform-pubkey. - Recompute the BLAKE3 fingerprint over canonical JSON of the listed fields.
- Call
Ed25519.verify(signature, fingerprint, publicKey)via Web Crypto. Mismatch = tamper.
Ledger: closed-loop accounting
Every wallet move is mirrored by an append-only ledger row signed in the same transaction (ADR-0030/0031). The sum of amount_delta for a user equals their net wallet.balance_available change.
| reason | amount_delta | When written |
|---|---|---|
REGISTER_GIFT | +1,000,000 | sign-up gift on first email verification |
BET | −stake / −cost | DPM shares purchased |
WIN | +payout | Winning side at DPM oracle settle |
LOSS | −liability | Losing side at DPM oracle settle |
REFUND | +stake | Void & Refund: market VOIDED or dispute breach refunded |
ADMIN_ADJ | ±X | Admin credits TCN (2FA-gated) |
ADMIN_ROLLBACK | ±X | Admin reverses an erroneous entry (mirror amount) |
Σ amount_delta(user) = Δ wallet.balance_available(user) across the wallet's lifetime. Any mismatch indicates DB tampering — independently checkable from the row signatures.Platform Rules
For complete platform rules including TCN credits, DPM betting mechanism, referral commission, credit lending, transparency verification, and disclaimer, see the official rules page:
View full platform rules →Glossary
- TCN
- token. Not redeemable for any currency.
- DPM
- Dynamic Parimutuel — share-based pool with auto-priced odds.
- overround δ
- DPM house margin (Σ implied probabilities − 1). Locked admin-side per market.
- κ (kappa)
- DPM settlement fee (1 − δ). Auto-derived; cannot be set independently.
- BLAKE3 / Ed25519
- BLAKE3 = fast cryptographic hash (32-byte digest). Ed25519 = elliptic-curve digital signature.
- Merkle root
- Binary tree of hashes; root commits to the entire dataset. Used for tamper-evident audit trails.
- Void & Refund
- Settlement outcome where all positions are refunded at original cost (oracle ambiguous or rule says no winner).
- BET / WIN / LOSS / REFUND
- Ledger entry reasons reflecting wallet net flow (see Ledger section).
- fingerprint / signature
- BLAKE3 fingerprint of canonical fields + Ed25519 signature by platform key. Browser-verifiable.
project · TCN is not redeemable for any currency · See /rules for full math.