Submit a single transaction
/v1/txSubmits a single raw transaction to the ARC network. The body must be a
JSON object with a rawTx field containing the hex-encoded transaction.
The SDK tries Extended Format (EF) first (tx.toHexEF()). If EF is not
available (source transactions missing), it falls back to raw hex (tx.toHex()).
ARC may return HTTP 200 with txStatus values that indicate failure
(e.g. DOUBLE_SPEND_ATTEMPTED, REJECTED, INVALID, MALFORMED,
MINED_IN_STALE_BLOCK, or any status containing ORPHAN). These are
treated as broadcast failures by the SDK.
Header Parameters
Bearer token: Bearer <apiKey>
Deployment identifier for correlating requests. Auto-generated if not set.
HTTPS URL to which ARC will POST a Merkle proof callback once the transaction has been mined.
Bearer token that ARC will include in the Authorization header when
calling the callback URL. Used to verify the callback origin.
Body application/json
Hex-encoded raw transaction. The ts-sdk attempts Extended Format (EF) first; falls back to standard raw hex when source transactions are missing.
Response
Transaction accepted (or accepted with a warning status). Note: ARC
may return HTTP 200 with a txStatus that indicates rejection. Callers
must inspect txStatus to determine success vs. failure.
Transaction ID.
Network status of the transaction as reported by ARC. Success statuses (HTTP 200, not treated as failure):
- STORED — received but not yet broadcast
- ANNOUNCED_TO_NETWORK — gossiped to peers
- REQUESTED_BY_NETWORK — requested by a peer
- SENT_TO_NETWORK — submitted to the network
- ACCEPTED_BY_NETWORK — accepted by at least one miner
- SEEN_ON_NETWORK — seen propagating on the network
- MINED — included in a block (Merkle proof available)
- SEEN_IN_ORPHAN_MEMPOOL — in an orphan block mempool (not a stable success) Failure statuses (HTTP 200 body, treated as BroadcastFailure by ts-sdk):
- DOUBLE_SPEND_ATTEMPTED
- REJECTED
- INVALID
- MALFORMED
- MINED_IN_STALE_BLOCK
- (any value containing “ORPHAN” in extraInfo or txStatus) Unknown:
- UNKNOWN
Additional human-readable context about the status.
Present when txStatus is DOUBLE_SPEND_ATTEMPTED. Lists competing
transaction IDs.
Bad request — malformed payload.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
Missing or invalid Authorization header.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
Conflict — e.g. transaction already known.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
Unprocessable entity — invalid transaction.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
Rate limit exceeded.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
ARC internal error.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.