# Creator-platform developer practice beta

Studio → select game → **Creator tools**. Six connected surfaces: deterministic
outcome rules; the Signal Rush reference game; integration diagnostics; durable
developer practice markets; simulated creator statements; and promotion readiness.
This is a sandbox, not production trading or a wallet payout service.

## Callable interfaces and authority

The current canonical OpenAPI at `/api/openapi.json` defines exact request schemas.

| Interface | Authority and effect |
| --- | --- |
| GET `/api/studio/outcomes` | Arena session; reviewed templates |
| POST `/api/studio/outcomes` | Current membership + exact-origin CSRF; replay owned accepted facts, no write |
| GET `/api/studio/lab?publisher=…&game=…` | Current workspace member; rules, owned game markets, statements, readiness |
| POST `/api/studio/lab` | Session + CSRF; exact action terms and original 32-hex request ID |
| GET `/api/studio/readiness?publisher=…&game=…&release=…` | Current member or configured reviewer; sanitized readiness, no private source/key access |
| GET `/api/studio/report?publisher=…&game=…` | Current workspace member; bounded downloadable observations, no balances initialized |
| GET `/api/testnet/markets?game=…` | Published community release’s simulation markets |
| GET `/api/testnet/markets?mine=1` | Session; owned positions, including older releases |
| GET `/api/testnet/markets/{id}` | Published release, current member or existing participant; only own account |
| POST `/api/testnet/markets/{id}` | Session + CSRF; join/trade/cancel/reconcile only |

A source SDK key can report facts only; it cannot accept participation terms or
trade for a user. Another application’s cookie/token is not an Arena session.
Browser mutations recheck the session after consuming the bounded body. No CORS
write permission, wallet address, caller-selected owner or financial grant exists.

## Reference game and evidence

Try `/developers/reference-game`. The browser preview sends no source events.
Download the complete authoritative Signal Rush server from the public SDK.
`arena starter NEW_DIRECTORY` produces editable server/client files with an
explicit local package installation path; `arena minigame` runs the server.
Private game facts and original SDK outbox destination survive restart. The
reference binds to loopback and has one local human input seat plus a labeled bot.
Public multiplayer hosting/admission and independent human acceptance remain separate.

Create a Studio release and source key, run the server and wait for accepted match
creation. Before starting play, register a rule and create a simulation market.
Market creation requires the same release, a created match and zero accepted game
events; rules and economics cannot be replaced afterward. Standard outcome
events and exact window semantics are documented in `/integrations/games/outcomes-v1/README.md`.

The v2 SDK public projection adds commitments to original accepted event bodies
and fixed standard metric codes/integers, while keeping arbitrary event names and
native identities private. Historical checkpoints remain unchanged. Source
commitments and Testnet inclusion are distinct from the deterministic decision
receipt; the decision itself is not independently anchored or payout authority.

## Practice accounting contract

- **Units:** integer hundredths of a nonredeemable test unit; 100 units redeem one
  winning contract. No relationship to existing Arena points, account funds or wallets.
- **Explicit join:** one 100,000-unit (1,000 test-unit) grant per account/market,
  only after acceptance of the exact terms digest and a declared player/spectator
  role. Role is self-declared; it is not verified game admission.
- **Liquidity:** identified simulated maker starts with 900,000 free units plus
  100,000 units collateralizing 1,000 complete sets. Two/four outcome markets only.
  Finite depth and inventory skew determine quotes; health/statistics do not become
  purported probabilities. No human traders or external liquidity are fabricated.
- **Orders:** `buy`/`sell`, 1–1,000 integer contracts, integer price limit 1–99,
  `ioc`, `gtc` or `fok`, and exact `expected_revision`. Zero and partial fills are
  explicit. Remaining GTC buys reserve worst-case cost plus fee; sells reserve
  held contracts. No short selling. If fee rounding would exceed remaining funds,
  the remaining order is canceled. Cancel releases only the unfilled reservation.
- **Entry:** prestart matches have a one-hour source-age bound. Live acceptance
  requires observations at most ten seconds old and game time before the pinned
  cutoff. Scoring-window entries close before the window. Terminal accepted events
  settle in the same SQLite transaction as source acceptance; later orders reject.
  This uses Arena’s accepted log, **not native pre-trade admission**. Source latency
  and developer truthfulness prevent interpreting it as funded-market fairness.
- **Settlement:** completed, contiguous evidence resolves deterministically.
  Gaps hold and cancel reservations. Cancellations/draws void. A void redeems each
  contract’s equal share of a complete set (50/25 units), not original purchase
  price; filled trade gains/losses can remain. All fees refund on void. Operator
  cancellation and release withdrawal are audited voids. Terminal decisions never
  silently change. Existing participants retain access to their older positions.
- **Recovery:** every mutating request retains its original 32-hex ID and exact
  terms. Durable receipts precede replies; lost replies and restart recover the
  same result. Changed terms under the same ID conflict. Source keys, browser
  commands and financial engines have separate journals and authority.

## Simulated creator economics

Economics version `2026-10-23.1` pins fee basis points (0–500) and creator/Arena/
operator shares totaling 10,000 at market creation. Default 100/7000/2000/1000
values are illustrative configuration, not an offered commercial agreement.
Fees round up per fill execution. Eligible collected fees accrue only after a
resolved contest. Creator and operator allocations round down; Arena receives
the remainder so allocations exactly reconcile. Voids refund all collected fees.

Statements bind release, rule, terms and decision digests. Owner-only explicit
zero-sum adjustments preserve original statements and cannot make an allocation
negative. These are simulated subledger statements, not a second real financial
authority. Paid amounts remain zero. Customer collateral is not revenue.

## Readiness and rollback

Readiness records HTTPS launch declaration, complete Testnet evidence, versioned
rules, a resolved, chain-evidenced test-unit settlement/statement (manual voids do not qualify), release-specific community
votes or audited override, and separate reviewer approval. A declaration does not
prove external game availability. Existing review approval alone is not complete
deployment acceptance.

`promotion_dry_run` stores an immutable report, current/previous Testnet release
references, blockers and rollback preparation. Its original-ID replay preserves
the original report even when readiness later changes. Mainnet adapter and
independent creator/player acceptance remain explicit blockers. No dry run submits
an application, moves funds or deploys to Mainnet. Testnet rollback remains the
existing explicit owner restore with evidence checks; no automatic rollback runs.

## Limits and operations

100 accounts per market, 30 markets per game, 40 rules per game, 500 orders per
account, 2,000 total orders, 5,000 fill executions and 200 open orders per market, 5,000 accepted source events per simulated match and 60 lab commands per account/minute.
Only the latest 30 matches/rejections/markets and bounded own order/fill/journal
history are displayed. Unauthenticated failures are not included in diagnostics.
Source rejection diagnostics cannot replace acceptance or contain raw payloads.

All state uses the existing owner-only Studio SQLite database and versioned
backup procedures. Back up before migration/rollout; restore only in isolation
for acceptance. Retain keys, source outboxes, statements, audit rows and previous
releases. No production source allocation, liquidity, wallet, funding or Mainnet
flag is activated by this developer beta.

The pinned simulation evidence limit is 5,000 source events per match. Exceeding it voids the simulation and refunds fees while preserving normal source ingestion and proof capture. Live batches do not repeatedly replay the whole outcome log; evaluation waits for a held/terminal source. Larger games can use source delivery without this bounded simulation.
