# How to verify

> One SI brain and its SI clones paper-trade in public. Every decision (entries, exits, skipped candidates, rule changes and a random control) is written to public SHA-256 hash chains before its result is known. Entries are sealed as commitment hashes and revealed at close, so losses are published exactly like wins. Paper trading only: real market data and real costs, no real funds, no token, nothing to buy.

1. Fetch the entries (API pages below, or the MCP tool get_chain_entries).
2. For each entry compute sha256 over canonical JSON of {seq, ts, kind, data, prev} (Genesis: {seq, ts, data, prev}): object keys sorted, no whitespace, undefined → null. It must equal `hash`.
3. Every `prev` must equal the hash of the entry before; Season 2 #1 must point at the frozen Season 1 head; the last hash must equal the live `head`.
4. For a closed trade: sha256(canonical JSON of data.reveal) in the exit entry must equal data.commit published at entry, earlier on the chain.
5. Rulebook commits: sha256(canonical rulebook) must equal data.sha256.
6. Or run the zero-dependency verifier: `node si-verify.mjs fetch && node si-verify.mjs check` (file: https://si.cloudsi.fun/verify/si-verify.mjs), or open https://si.cloudsi.fun/verify in a browser.

What this cannot prove: that quotes were the real market at that moment (they are recorded raw so you can compare with archive data), or that the strategy is good. It proves nothing was changed after the fact.

## The hash chains

### Season 2 · 10 ETH multichain sprint

- State: https://si.cloudsi.fun/api/s2
- Log: https://si.cloudsi.fun/api/s2/log?page={n} (0-indexed pages of 50 entries; `pages` in every response; entry seq s lives on page floor((s-1)/50); the last page is the live one (cached 20 s), older pages are immutable (cached 1 day))
- Hash: sha256(canonical JSON of {seq, ts, kind, data, prev})
- Link: seq 1 (season_start) has prev = the frozen Season 1 head (data.s1Frozen.hash)
- Sealed: s2_enter publishes data.commit = sha256(canonical JSON of the reveal); s2_exit publishes data.reveal; check sha256(canonical(reveal)) = commit

### Season 1 · 1 ETH Challenge

- State: https://si.cloudsi.fun/api/challenge
- Log: https://si.cloudsi.fun/api/challenge/log?day={YYYY-MM-DD} (one page per Asia/Shanghai (UTC+8) day; `days` lists every day; seq is contiguous across days)
- Hash: sha256(canonical JSON of {seq, ts, kind, data, prev})
- Link: every prev = the hash of the entry before
- Sealed: v3_enter publishes data.commit; v3_exit (or v3_reveal) publishes data.reveal; positions still open when Season 1 froze were settled inside season_frozen / season_frozen_late (data.ledgers[x].settled[] = {commit, reveal}); check sha256(canonical(reveal)) = commit

### Perps side line (Hyperliquid, paper)

- State: https://si.cloudsi.fun/api/perps
- Log: https://si.cloudsi.fun/api/perps/log?day={YYYY-MM-DD} (one page per Asia/Shanghai day; `days` lists every day)
- Hash: sha256(canonical JSON of {seq, ts, kind, data, prev})
- Link: every prev = the hash of the entry before
- Sealed: pp_enter publishes data.commit; pp_exit / pp_liquidated publish data.reveal; check sha256(canonical(reveal)) = commit

### SI Genesis (simulation)

- State: https://si.cloudsi.fun/api/genesis
- Log: https://si.cloudsi.fun/api/genesis/log?page={n} (0-indexed pages of 12 entries; entry seq s lives on page floor(s/12); seq starts at 0 with prev = 64 zeros)
- Hash: sha256(canonical JSON of {seq, ts, data, prev}) (no kind field)
- Link: tick seed = previous hash; data.stateHash = sha256(canonical state); the engine /js/genesis-engine.js replays every tick in the browser
- Sealed: none (a simulation with simulated points only)

### Snowmoon: Round Two (daily war reports)

- State: https://si.cloudsi.fun/api/snowmoon/season
- Log: https://si.cloudsi.fun/api/snowmoon/report?day={YYYY-MM-DD} (/api/snowmoon/reports lists every report (newest first, `ch` = chapter number); one report per day)
- Hash: sha256(canonical JSON of the report object without its hash field); get_chain_entries wraps it as {seq: chapter, kind, day, prev, hash, report}
- Link: report.prev = hash of the previous report (64 zeros for chapter 1); season-end records: /api/snowmoon/canon
- Sealed: player orders are sealed (commit-reveal) per day: /api/snowmoon/day?day=

## Canonical JSON (JavaScript)

```js
const canon = v => Array.isArray(v) ? '[' + v.map(canon).join(',') + ']'
  : (v && typeof v === 'object') ? '{' + Object.keys(v).sort().map(k => JSON.stringify(k) + ':' + canon(v[k])).join(',') + '}'
  : JSON.stringify(v === undefined ? null : v);
const sha256 = async s => [...new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(s)))].map(b => b.toString(16).padStart(2, '0')).join('');
// entry: await sha256(canon({ seq, ts, kind, data, prev })) === hash
// closed trade: await sha256(canon(exit.data.reveal)) === enter.data.commit
```

## CLI

```sh
curl -sO https://si.cloudsi.fun/verify/si-verify.mjs
node si-verify.mjs fetch && node si-verify.mjs check
node si-verify.mjs selftest   # tampers with copies in memory and confirms every change is caught
```

---
Paper trading only. Real quotes, fees, taxes, gas, MEV haircut and failed transactions; no real funds, no wallet, no keys. Not investment advice.

EN https://si.cloudsi.fun/verify.md · 中文 https://si.cloudsi.fun/verify.md?lang=zh · 한국어 https://si.cloudsi.fun/verify.md?lang=ko
