Skip to content
LogoLogo

Error codes

Errors from the node REST API are RFC 9457 application/problem+json objects whose type is https://docs.arrekta.com/errors/<code>, which resolves to the pages below. Codes are stable: clients should branch on code, never on title or detail.

CodeCategoryHTTP status (when fixed)
admin-disabledNode REST API403
asset-frozenConsensus rule
asset-frozen-recipientConsensus rule
asset-not-foundNode REST API404
auxpow-chain-branchConsensus rule
auxpow-coinbase-sizeConsensus rule
auxpow-header-positionConsensus rule
auxpow-merkle-rootConsensus rule
auxpow-missing-headerConsensus rule
auxpow-missing-rootConsensus rule
auxpow-missing-sizeConsensus rule
auxpow-multiple-headersConsensus rule
auxpow-not-coinbaseConsensus rule
auxpow-sizeConsensus rule
auxpow-wrong-indexConsensus rule
bad-addressNode REST API400
bad-cb-filterConsensus rule
bad-cb-filter-missingConsensus rule
bad-cb-utxoConsensus rule
bad-cb-utxo-missingConsensus rule
bad-cursorNode REST API400
bad-hashNode REST API400
bad-hexNode REST API400
bad-preimageConsensus rule
bad-signatureConsensus rule
block-not-foundNode REST API404
block-prunedNode REST API410
checkpoint-bad-signatureP2P / finality
checkpoint-bad-signerP2P / finality
checkpoint-conflictConsensus rule
checkpoints-disabledNode REST API409
connect-failedNode REST API502
decode-errorNode REST API400
filter-not-foundNode REST API404
high-hashConsensus rule
insufficient-feeMempool policy
insufficient-feerateMempool policy
internalNode REST API500
issuance-ticker-takenConsensus rule
mainnet-mining-disabledNode REST API403
missing-inputsConsensus rule
no-miner-addressNode REST API400
package-fee-too-lowMempool policy
proof-bad-handoverConsensus rule
proof-bad-merkleConsensus rule
proof-broken-headersConsensus rule
proof-checkpoint-mismatchConsensus rule
proof-invalidNode REST API500
proof-not-finalConsensus rule
proof-too-deepNode REST API409
pst-burnPST decoding
pst-clawbackPST decoding
pst-coinbasePST decoding
pst-decodePST decoding
pst-flagsPST decoding
pst-foreign-keyPST decoding
pst-magicPST decoding
pst-orderPST decoding
pst-redeemPST decoding
pst-redeem-mismatchPST decoding
pst-redeem-missingPST decoding
pst-reservedPST decoding
pst-versionPST decoding
pst-witnessPST decoding
rate-limitedNode REST API429
replacement-adds-unconfirmedMempool policy
replacement-spends-conflictMempool policy
scheme-output-disallowedConsensus rule
scheme-retiredConsensus rule
time-too-newConsensus rule
too-many-replacementsMempool policy
truc-child-too-bigMempool policy
truc-mixedMempool policy
truc-too-many-ancestorsMempool policy
truc-tx-sizeMempool policy
tx-expiredConsensus rule
tx-not-finalNode REST API409
tx-not-foundNode REST API404
tx-premature-relativeConsensus rule
unauthorizedNode REST API401
validation-errorNode REST API422