@solana/kit · Codecs

Solana error #8078027

CODECS__INVALID_UTF8_STRING

Appears as Solana error #8078027; Decode this error by running `npx @solana/errors decode -- 8078027 '…'`

Message

Invalid UTF-8 string. Found a lone surrogate at index $index.

Placeholders (index) are filled from the error’s context. Paste the base64 argument below to see the real values.

What it means

Encoding and decoding bytes: wrong sizes, out-of-range numbers, enum discriminators, sentinels, invalid strings.

What to do

  • Match the codec exactly to the on-chain layout: integer width, endianness, prefix sizes and option encoding.
  • EXPECTED_DECODER_TO_CONSUME_ENTIRE_BYTE_ARRAY usually means the decoder is for a different account version.

Decode it locally instead

npx @solana/errors decode -- 8078027 '<base64 context>'

In development, import from @solana/kit as usual and the full message is thrown. In production the message is stripped to keep bundles small; the error object still carries error.context with the same values this page decodes, and isSolanaError(err, SOLANA_ERROR__CODECS__INVALID_UTF8_STRING) lets you branch on it.

Decode another error

Try: