Status Codes

BlockLink uses a unified status code scheme for request and operation outcomes. Codes are grouped by category, and the tens digit identifies the category.

2X - Success

CodeDescription
21Successfully processed

3X - Block Retrieval Errors

CodeDescription
31BID does not exist
32Request error, not processed (typically malformed incoming data)
33Request error, not processed (typically server-side issues)

4X - Request Errors

CodeDescription
41Route not found
42Invalid request body
CodeDescription
51Not connected / not registered
52Registration rejected
53Already connected and currently connecting with a new node
CodeDescription
61Command cannot be forwarded to target BID; no available path (e.g. A -> B -> C is broken)
62Command cannot be sent by this node; possibly no direct peers, or peers cannot forward
63This node is not responsible for forwarding this command
CodeDescription
71Permission denied (route/node/block permission), absolute denial
72Permission denied but conditional; may pass under specific conditions (time, request content, etc.)
73Authorization required; except for super permissions, access must be authorized