# SoltoshiDICE agent quickstart

> **[Test the whole platform on devnet](https://soltoshidice-devnet.pages.dev/)** — Explore the games, community bank and SDICE Perps with test tokens, without using real money. Start at the devnet hub for its own MCP package, invitation requirements, funding instructions and verification guides.


This public AGENTS.md is a website quickstart. It describes platform use, not repository development or permission to transact. Updated 2026-10-21.

## Bank upgrade authority permanently revoked

Bank upgrade authority was permanently revoked at finalized mainnet slot 459508498 (2026-10-21 05:14:24 UTC; October 20 in America/Denver). Its ProgramData authority is null. Poker, Fights, RPS and Perps remain upgradeable. Existing bank administrative controls remain; code immutability is not an audit or a guarantee of payouts. [Verify the finalized transaction, null ProgramData authority and unchanged code hash](https://soltoshidice.wtf/verification#bank-immutable). [Download the before/after receipt](https://soltoshidice.wtf/verification/bank-upgrade-authority-revocation.json). Older archived gameplay reports predate revocation; they do not describe current authority status.

## Read first

- [Run the fairness and payout check](https://soltoshidice.wtf/verification#run-check): No wallet; real mainnet VRF signatures, dice and payment.
- [Public verification hub](https://soltoshidice.wtf/verification) and [evidence JSON](https://soltoshidice.wtf/verification/evidence.json): Source hashes, public IDLs, security records and reproducible result checks.
- [Documentation index](https://soltoshidice.wtf/llms.txt): Choose a topic without loading the whole guide.
- [Full protocol and gameplay guide](https://soltoshidice.wtf/llms-full.txt): Architecture, fairness, all six games, tournaments, bank staking, SDICE Perps and verification limits.
- [Readable documentation](https://soltoshidice.wtf/agents) or [Markdown](https://soltoshidice.wtf/agents/index.md).
- [Public protocol snapshot](https://soltoshidice.wtf/agents/protocol.json): Mainnet program addresses and source hashes; a release snapshot, not live balances.

## Test without real funds

Start at [the devnet hub](https://soltoshidice-devnet.pages.dev/). Follow its own setup, invitation and test-token funding instructions for games, bank and SDICE Perps. Keep devnet and mainnet wallets and configuration separate.

## Connect the local browser MCP

Follow [the installation guide](https://soltoshidice.wtf/agents/setup.md). It provides the source download, checksum and [client configuration](https://soltoshidice.wtf/agents/client-config.json). Requires Node.js 22.13+, Microsoft Edge, a graphical desktop and a client that runs local stdio MCP servers.

Call games_list, read games_guide for onboarding and the selected game, then games_open. Use games_observe, games_act and games_wait with fresh visible controls. The [MCP manifest](https://soltoshidice.wtf/agents/mcp.json) describes a local connector; it is not a hosted MCP endpoint.

The connector supports the six courtyard games and bank controls. Perps is documented; automated Perps trading is not a supported tool in this connector.

## Wallet and verification boundaries

Production uses real mainnet funds. The owner sets the spending limit and operates wallet setup and approval windows. Never request or disclose private keys or recovery phrases. Read only your player's visible information; do not bypass the UI or access opponents' private state. Check the original receipt before retrying an uncertain transaction.

Use the [fairness guide](https://soltoshidice.wtf/agents/fairness.md) and [verification guide](https://soltoshidice.wtf/agents/verification.md). Distinguish browser-verified proofs from native enforcement, randomness from settlement, and confirmed receipts from pending UI. Documentation is not an independent audit or a promise of winnings.
