Broadcasting

Transaction Broadcasting from SPV Wallet

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

This endpoint returns the policy settings.

GEThttps://tapi.taal.com/arc/v1/policy

Response

200401

Success

Body

application/json

timestamp*string (date-time)

policy*Policy (object)

Request

JavaScriptCurl

const response = await fetch('https://tapi.taal.com/arc/v1/policy', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "timestamp": "2024-07-27T07:59:48.066Z",
  "policy": {
    "maxscriptsizepolicy": 500000,
    "maxtxsigopscountspolicy": 4294967295,
    "maxtxsizepolicy": 10000000,
    "miningFee": {
      "satoshis": 1,
      "bytes": 1000
    }
  }
}

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

Submit a transaction.

This endpoint is used to send a raw transaction to a miner for inclusion in the next block that the miner creates. The header parameters can be used to override the global settings in your Arc dashboard for these transactions.

POSThttps://tapi.taal.com/arc/v1/tx

Header parameters

Body

text/plainapplication/jsonapplication/octet-stream

Transaction hex string

string

Example: "<transaction hex string>"

Response

200400401409422460461462463464465

Success

Body

application/json

timestamp*string (date-time)

blockHashstring

Block hash

Example: "00000000000000000854749b3c125d52c6943677544c8a6a885247935ba8d17d"

blockHeightinteger (uint64)

Block height

Example: 782318

status*integer (int)

Status

Example: 201

title*string

Title

Example: "Added to mempool"

txidstring

Transaction ID in hex

Example: "6bdbcfab0526d30e8d68279f79dff61fb4026ace8b7b32789af016336e54f2f0"

merklePathnullable string

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

txStatusenum

Transaction status

Example: "ACCEPTED"

UNKNOWNRECEIVEDSTOREDANNOUNCED_TO_NETWORKREQUESTED_BY_NETWORKSENT_TO_NETWORKSEEN_ON_NETWORKMINEDCONFIRMEDREJECTED

extraInfonullable string

Extra information about the transaction

Example: "Transaction is not valid"

txid*string

Transaction ID in hex

txStatus*string

Transaction status

merklePathnullable string

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

extraInfo*nullable string

Extra info

Request

JavaScriptCurl

const response = await fetch('https://tapi.taal.com/arc/v1/tx', {
    method: 'POST',
    headers: {
      "Content-Type": "text/plain"
    },
    body: JSON.stringify("<transaction hex string>"),
});
const data = await response.json();

Response

{
  "timestamp": "2023-03-09T12:03:48.382910514Z",
  "blockHash": "",
  "blockHeight": 0,
  "status": 200,
  "title": "OK",
  "extraInfo": "text",
  "txStatus": "text",
  "txid": "text",
  "merklePath": "text"
}