Broadcasting

Transaction Broadcasting from SPV Wallet

This page describes how the SPV Wallet component broadcasts internally. For every way to broadcast a transaction to BSV, including the BSV Association's supported Arcade service, see the Broadcasting section.

The SPV Wallet broadcasts all valid transactions it receives or creates to ARC.

GitHub - bitcoin-sv/go-broadcast-client: Go client for any service with an ARC api - used for tx broadcast.GitHub

ARC Endpoints

We use the first endpoint to determine the correct fee model to use when creating a transaction.

Get the policy settings

get

This endpoint returns the policy settings.

Authorizations

AuthorizationstringRequired

Bearer authentication as defined in RFC 6750

Responses

200

Success

application/json

and

401

Security requirements failed

get/v1/policy

GET /v1/policy HTTP/1.1
Host: arc.taal.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "policy": {
    "maxscriptsizepolicy": 500000,
    "maxtxsigopscountspolicy": 4294967295,
    "maxtxsizepolicy": 10000000,
    "miningFee": {
      "satoshis": 1,
      "bytes": 1000
    },
    "standardFormatSupported": true
  }
}

Thereafter we simply broadcast to ARC and expect a SEEN_ON_NETWORK txStatus response in most cases.

Submit a transaction.

post

This endpoint is used to send a raw transaction to a miner for inclusion in the next block that the miner creates.

Authorizations

AuthorizationstringRequired

Bearer authentication as defined in RFC 6750

Header parameters

X-CallbackUrlstringOptional

Default double spend and merkle proof notification callback endpoint.

X-FullStatusUpdatesbooleanOptional

Whether we should have full status updates in callback or not (including SEEN_IN_ORPHAN_MEMPOOL and SEEN_ON_NETWORK statuses).

X-MaxTimeoutintegerOptional

Timeout in seconds to wait for new transaction status before request expires (max 30 seconds, default 5)

X-SkipFeeValidationbooleanOptional

Whether we should skip fee validation or not.

X-ForceValidationbooleanOptional

Whether we should force submitted tx validation in any case.

X-SkipScriptValidationbooleanOptional

Whether we should skip script validation or not.

X-SkipTxValidationbooleanOptional

Whether we should skip overall tx validation or not.

X-CumulativeFeeValidationbooleanOptional

Whether we should perform cumulative fee validation for fee consolidation txs or not.

X-CallbackTokenstringOptional

Access token for notification callback endpoint. It will be used as a Authorization header for the http callback

X-CallbackBatchbooleanOptional

Callback will be send in a batch

X-WaitForstringOptional

Which status to wait for from the server before returning ('QUEUED', 'RECEIVED', 'STORED', 'ANNOUNCED_TO_NETWORK', 'REQUESTED_BY_NETWORK', 'SENT_TO_NETWORK', 'ACCEPTED_BY_NETWORK', 'SEEN_ON_NETWORK')

Body

stringOptionalExample: <transaction hex string>

Responses

200

Success

application/json

Transaction submit status

timestampstring · date-timeRequired

blockHashstringOptional

Block hash

Example: 00000000000000000854749b3c125d52c6943677544c8a6a885247935ba8d17d

blockHeightinteger · uint64Optional

Block height

Example: 782318

txidstringRequired

Transaction ID in hex

Example: 6bdbcfab0526d30e8d68279f79dff61fb4026ace8b7b32789af016336e54f2f0

merklePathstring · nullableOptional

Transaction Merkle path as a hex string in BUMP format BRC-74

Example: 0000

txStatusstring · enumRequired

Transaction status

Example: ACCEPTED_BY_NETWORKPossible values:

extraInfostring · nullableOptional

Extra information about the transaction

Example: Transaction is not valid

competingTxsstring[] · nullableOptionalExample: ["c0d6fce714e4225614f000c6a5addaaa1341acbb9c87115114dcf84f37b945a6"]

statusinteger · intRequired

Status

Example: 201

titlestringRequired

Title

Example: Added to mempool

400

Bad request

application/json

401

Security requirements failed

409

Generic error

application/json

422

Unprocessable entity - with IETF RFC 7807 Error object

application/json

460

Not extended format

application/json

461

Malformed transaction

application/json

462

Invalid inputs

application/json

463

Malformed transaction

application/json

464

Invalid outputs

application/json

465

Fee too low

application/json

467

Mined ancestors not found in BEEF

application/json

468

Invalid BUMPs in BEEF

application/json

469

Invalid Merkle Roots

application/json

473

Cumulative Fee validation failed

application/json

post/v1/tx

POST /v1/tx HTTP/1.1
Host: arc.taal.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: text/plain
Accept: */*
Content-Length: 26

"<transaction hex string>"

{
  "blockHash": "0000000000000aac89fbed163ed60061ba33bc0ab9de8e7fd8b34ad94c2414cd",
  "blockHeight": 736228,
  "extraInfo": "",
  "merklePath": "fe54251800020400028d97f9ebeddd9f9aa8e0e953b3a76f316298ab05e9834aa811716e9d397564e501025f64aa8e012e26a5c5803c9f94d1c2c8ea68ecef1415011e1c2e26b9c966b6ad02021f5fa39607ca3b48d53c902bd5bb4bbf6a7ac99cf9fda45cc21b71e6e2f7889603024a2bb116e86325c9b8512f10b22c228ab3272fe3f373b1bd4a9a6b334b068bb602000061793b278303101a1390ceae5a713de0eabd9cda63702fe84c928970acf7c45e0100a567e3d066e38638b27897559302eabc85eb69b202c2e86d4338bab73008f460",
  "status": 200,
  "timestamp": "2023-03-09T12:03:48.382910514Z",
  "title": "OK",
  "txStatus": "MINED",
  "txid": "b68b064b336b9a4abdb173f3e32f27b38a222cb2102f51b8c92563e816b12b4a"
}

Usually a callbackUrl would be set for async status updates - but if you'd like to manually check the most recent state of a given transaction, you can use this:

Get transaction status.

get

This endpoint is used to get the current status of a previously submitted transaction.

Authorizations

AuthorizationstringRequired

Bearer authentication as defined in RFC 6750

Path parameters

txidstringRequired

The transaction ID (32 byte hash) hex string

Responses

200

Success

application/json

Transaction details

timestampstring · date-timeRequired

blockHashstringOptional

Block hash

Example: 00000000000000000854749b3c125d52c6943677544c8a6a885247935ba8d17d

blockHeightinteger · uint64Optional

Block height

Example: 782318

txidstringRequired

Transaction ID in hex

Example: 6bdbcfab0526d30e8d68279f79dff61fb4026ace8b7b32789af016336e54f2f0

merklePathstring · nullableOptional

Transaction Merkle path as a hex string in BUMP format BRC-74

Example: 0000

txStatusstring · enumRequired

Transaction status

Example: ACCEPTED_BY_NETWORKPossible values:

extraInfostring · nullableOptional

Extra information about the transaction

Example: Transaction is not valid

competingTxsstring[] · nullableOptionalExample: ["c0d6fce714e4225614f000c6a5addaaa1341acbb9c87115114dcf84f37b945a6"]

401

Security requirements failed

404

Not found

application/json

409

Generic error

application/json

get/v1/tx/{txid}

GET /v1/tx/{txid} HTTP/1.1
Host: arc.taal.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "blockHash": "00000000000000000854749b3c125d52c6943677544c8a6a885247935ba8d17d",
  "blockHeight": 782318,
  "txid": "6bdbcfab0526d30e8d68279f79dff61fb4026ace8b7b32789af016336e54f2f0",
  "merklePath": "0000",
  "txStatus": "ACCEPTED_BY_NETWORK",
  "extraInfo": "Transaction is not valid",
  "competingTxs": [
    [
      "c0d6fce714e4225614f000c6a5addaaa1341acbb9c87115114dcf84f37b945a6"
    ]
  ]
}