Send BOC (return hash)

Broadcasts a signed message to the TON network and returns the message hash. The boc parameter must contain a complete, signed external message in base64 format. The API validates the message and forwards it to validators. The returned hash can be used to track the message’s processing status.

POST /api/v2/sendBocReturnHash

Send BOC (return hash)

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/sendBocReturnHash \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "boc": "<string>"
}
'

200

{
  "ok": true,
  "result": {
    "@type": "raw.extMessageInfo",
    "hash": "<string>",
    "hash_norm": "<string>"
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is your API key. Requests without a key are limited to 1 RPS. More info here.

Body

application/json

Request to broadcast a signed message. The boc field contains the base64-encoded external message.

boc · string · required

Serialized external message in BOC format, base64 encoded. Contains the signed transaction to broadcast.

Response

200

application/json

Returns the message hash after broadcasting the serialized message to the network.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Show child attributes

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.