# BSV Broadcaster

> A high-throughput, callback-driven gateway for submitting BSV transactions, tracking their lifecycle, and streaming status updates to subscribers in real time.

BSV Broadcaster is a Teranode-native replacement for ARC, formerly called Arcade, published by the BSV Association. The public API server is http://arcade-v2-testnet-us-1.bsvblockchain.tech. Submit with `POST /tx` or `POST /txs`, track with `GET /tx/:txid`, stream updates over Server-Sent Events on `GET /events`, or receive webhooks via `X-CallbackUrl`. A `MINED` update carries the merkle proof.

## Docs

- [API reference](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs): every route with its request and response contract, headers and examples
- [Health and policy](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs#health): `GET /health`, `GET /ready`, `GET /policy`
- [Submit](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs#submit): `POST /tx`, `POST /txs`
- [Track](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs#track): `GET /tx/:txid`, `GET /events`
- [Merkle and blocks](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs#merkle-and-blocks): `POST /api/v1/merkle-service/callback`, `GET /api/v1/blocks/processing-status`, `GET /api/v1/blocks/processing-status/:blockHash`, `POST /api/v1/blocks/:blockHash/reprocess`
- [Chaintracks API](http://arcade-v2-testnet-us-1.bsvblockchain.tech/docs#chaintracks-api): block-header tracking, v2 and legacy v1
- [Full reference as Markdown](http://arcade-v2-testnet-us-1.bsvblockchain.tech/llms-full.txt): this site's API reference in one file

## API

- [OpenAPI 3 spec (JSON)](http://arcade-v2-testnet-us-1.bsvblockchain.tech/openapi.json)
- [OpenAPI 3 spec (YAML)](http://arcade-v2-testnet-us-1.bsvblockchain.tech/openapi.yaml)
- [API server](http://arcade-v2-testnet-us-1.bsvblockchain.tech/health): live health check

## FAQ

- [What is BSV Broadcaster?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#what-is-bsv-broadcaster): A **Teranode-native** transaction broadcast and status-tracking service. It accepts BSV transactions, **validates** them against policy, **broadcasts** them to Teranode, **tracks** their lifecycle and emits status updates over **webhooks** and **Server-Sent Events**. It was built as a Teranode-native replacement for **ARC**.
- [How do I submit a transaction?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#submit-a-transaction): Send it to `POST /tx`, or a **batch** to `POST /txs`, on the API server serving this page (http://arcade-v2-testnet-us-1.bsvblockchain.tech). The body can be **raw bytes** (`application/octet-stream`, the most efficient), **hex** (`text/plain`) or a **JSON envelope**. Policy validation runs before the `202` response, which carries the txid and the status `RECEIVED`.
- [How do I track a transaction's status?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#track-status): Three ways. **Look it up** any time with `GET /tx/:txid`. **Stream** updates over Server-Sent Events on `GET /events`, scoped by the `X-CallbackToken` you submitted with. Or **register a webhook** with the `X-CallbackUrl` header when you submit.
- [Which statuses are sent to a webhook?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#webhook-statuses): **By default** only `MINED` and `REJECTED`. With `X-FullStatusUpdates: true` **every transition** is posted except `RECEIVED`, which is **never** sent to a webhook. The **SSE stream** carries every status, including `RECEIVED`.
- [Do I get a merkle proof?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#merkle-proofs): Yes. The `MINED` update carries `blockHash`, `blockHeight` and `merklePath` (a **BUMP**), so there is **no need to poll** for the proof.
- [Is BSV Broadcaster the same as Arcade?](http://arcade-v2-testnet-us-1.bsvblockchain.tech/#arcade): Yes. The project formerly called **Arcade** was **renamed** BSV Broadcaster. Legacy `ARCADE_*` environment variables are **still read** and mapped to their `BSV_BROADCASTER_*` names, with a deprecation warning at startup.

## Optional

- [Source code](https://github.com/bsv-blockchain/broadcaster)
- [Soak test results](https://bsvblockchain.org/network/teranode#soak-test): recorded load run, with its scope and limits
- [BSV Association](https://bsvblockchain.org)
