# Project Blackcoin — Gold Rush Observatory

> Verified public data for the Blackcoin Protocol V4 chain: a fail-closed
> explorer and telemetry API that discloses per-index coverage on every
> response, a live quorum-verified snapshot stream, and a versioned
> chain-identity manifest.
> Read-only. No key required. CORS open. 240 requests/minute per client.

Important context: synthetic Gold Rush credits are PHASE-LOCKED accounting on
a separate shadow ledger — never spendable balances, deposits, or yield.
Heights control all lifecycle boundaries; dates are projections. Amounts are
exact integer-sats strings (1 BLK = 100,000,000 sats).

## Agent interface
- [MCP endpoint](https://projectblackcoin.org/mcp): remote MCP server (Streamable HTTP, stateless). Add the URL to any MCP-capable agent.
- [Agent guide](https://projectblackcoin.org/agents): connection snippets and tool reference.

## Machine-readable contracts
- [OpenAPI](https://projectblackcoin.org/openapi.json): every endpoint, envelope, and error model.
- [Chain identity + parameters](https://projectblackcoin.org/api/chain-params): genesis hash, network magic, prefixes, lifecycle heights, source commit.
- [Live snapshot](https://projectblackcoin.org/api/v3/quantum): quorum-verified state (SSE at /api/v3/quantum/stream).
- [Supply taxonomy](https://projectblackcoin.org/api/supply): reconciled base/shadow/protocol supply with machine-tested equations.

## Documentation
- [Public API reference](https://projectblackcoin.org/developers)
- [Integration guide](https://projectblackcoin.org/integrate): staged, deposits-disabled custody reference.
- [Chain identity explained](https://projectblackcoin.org/identity)
- [Whitepaper](https://projectblackcoin.org/whitepaper): Protocol V4 specification with the v30.1.1→v30.1.3 delta matrix.
- [Verify it yourself](https://projectblackcoin.org/verify): reproduce every number on your own node.

## Optional
- [Full reference for agents](https://projectblackcoin.org/llms-full.txt)
- [Release records](https://projectblackcoin.org/releases/v30.1.3): immutable per-tag pages with pinned downloads.
