BSV blockchainBSV blockchain

Submit a tagged BEEF transaction

POST/submit

Accepts a raw BEEF (BRC-62) binary body. The request must include an x-topics header containing a JSON array of topic name strings. The overlay engine routes the BEEF to the appropriate Topic Managers and returns a STEAK (Structured Transaction Evidence for Admitted Knowledge) object indicating which outputs were admitted to which topics.

If x-includes-off-chain-values is "true", the body is prefixed with a varint-encoded off-chain value block before the raw BEEF bytes.

Header Parameters

x-topicsstringrequired

JSON-encoded array of topic name strings to which this BEEF should be submitted. Example: ["tm_ship", "tm_slap"]

x-includes-off-chain-valuesstring

When "true", the body is prefixed with a varint length followed by the off-chain values block before the BEEF bytes.

Response

STEAK — structured admission results per topic.

Bad request — validation error or missing required field.

statusstring
messagestring
codestring

Stable machine-readable error code (see specs/errors.md).

Unexpected internal error.

statusstring
messagestring
codestring

Stable machine-readable error code (see specs/errors.md).

Request
curl -X POST "https://{fqdn}/submit" \
  -H "Content-Type: application/octet-stream" \
  -H "x-topics: <x-topics>" \
  -H "x-includes-off-chain-values: <x-includes-off-chain-values>" \
  -d '"string"'
Response
{}