Exception: Solana::Ruby::Kit::SolanaError

Inherits:

StandardError

Object
StandardError
Solana::Ruby::Kit::SolanaError

show all

Extended by:: T::Sig

Defined in:: lib/solana/ruby/kit/errors.rb

Overview

Maps TypeScript’s SolanaError pattern to Ruby exceptions. Each error code corresponds to a constant and carries structured context. Mirrors @solana/errors codes.ts + messages.ts.

Constant Summary collapse

INVALID_KEYPAIR_SEED_LENGTH = ── General ──────────────────────────────────────────────────────────────

:SOLANA_ERROR__INVALID_KEYPAIR_SEED_LENGTH

INVALID_NONCE =

:SOLANA_ERROR__INVALID_NONCE

ADDRESSES__INVALID_BASE58_ENCODED_ADDRESS = ── Addresses ─────────────────────────────────────────────────────────────

:SOLANA_ERROR__ADDRESSES__INVALID_BASE58_ENCODED_ADDRESS

ADDRESSES__INVALID_BYTE_LENGTH_FOR_ADDRESS =

:SOLANA_ERROR__ADDRESSES__INVALID_BYTE_LENGTH_FOR_ADDRESS

ADDRESSES__STRING_LENGTH_OUT_OF_RANGE =

:SOLANA_ERROR__ADDRESSES__STRING_LENGTH_OUT_OF_RANGE_FOR_ADDRESS

ADDRESSES__INVALID_ED25519_PUBLIC_KEY =

:SOLANA_ERROR__ADDRESSES__INVALID_ED25519_PUBLIC_KEY

ADDRESSES__SEEDS_POINT_ON_CURVE =

:SOLANA_ERROR__ADDRESSES__SEEDS_POINT_ON_CURVE

ADDRESSES__MAX_SEED_LENGTH_EXCEEDED =

:SOLANA_ERROR__ADDRESSES__MAX_SEED_LENGTH_EXCEEDED

ADDRESSES__TOO_MANY_SEEDS =

:SOLANA_ERROR__ADDRESSES__TOO_MANY_SEEDS

ADDRESSES__FAILED_TO_FIND_VIABLE_PDA_BUMP_SEED =

:SOLANA_ERROR__ADDRESSES__FAILED_TO_FIND_VIABLE_PDA_BUMP_SEED

ADDRESSES__INVALID_SEEDS_POINT_ON_CURVE =

:SOLANA_ERROR__ADDRESSES__INVALID_SEEDS_POINT_ON_CURVE

ADDRESSES__PDA_BUMP_SEED_OUT_OF_RANGE =

:SOLANA_ERROR__ADDRESSES__PDA_BUMP_SEED_OUT_OF_RANGE

ACCOUNTS__ACCOUNT_NOT_FOUND = ── Accounts ──────────────────────────────────────────────────────────────

:SOLANA_ERROR__ACCOUNTS__ACCOUNT_NOT_FOUND

ACCOUNTS__ONE_OR_MORE_ACCOUNTS_NOT_FOUND =

:SOLANA_ERROR__ACCOUNTS__ONE_OR_MORE_ACCOUNTS_NOT_FOUND

ACCOUNTS__EXPECTED_DECODED_ACCOUNT =

:SOLANA_ERROR__ACCOUNTS__EXPECTED_DECODED_ACCOUNT

ACCOUNTS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED =

:SOLANA_ERROR__ACCOUNTS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED

ACCOUNTS__FAILED_TO_DECODE_ACCOUNT =

:SOLANA_ERROR__ACCOUNTS__FAILED_TO_DECODE_ACCOUNT

KEYS__INVALID_KEY_PAIR_BYTE_LENGTH = ── Keys ──────────────────────────────────────────────────────────────────

:SOLANA_ERROR__KEYS__INVALID_KEY_PAIR_BYTE_LENGTH

KEYS__PUBLIC_KEY_MUST_MATCH_PRIVATE_KEY =

:SOLANA_ERROR__KEYS__PUBLIC_KEY_MUST_MATCH_PRIVATE_KEY

KEYS__INVALID_SIGNATURE_BYTE_LENGTH =

:SOLANA_ERROR__KEYS__INVALID_SIGNATURE_BYTE_LENGTH

KEYS__SIGNATURE_STRING_LENGTH_OUT_OF_RANGE =

:SOLANA_ERROR__KEYS__SIGNATURE_STRING_LENGTH_OUT_OF_RANGE

INSTRUCTIONS__EXPECTED_TO_HAVE_ACCOUNTS = ── Instructions ──────────────────────────────────────────────────────────

:SOLANA_ERROR__INSTRUCTIONS__EXPECTED_TO_HAVE_ACCOUNTS

INSTRUCTIONS__EXPECTED_TO_HAVE_DATA =

:SOLANA_ERROR__INSTRUCTIONS__EXPECTED_TO_HAVE_DATA

INSTRUCTIONS__PROGRAM_ADDRESS_MISMATCH =

:SOLANA_ERROR__INSTRUCTIONS__PROGRAM_ADDRESS_MISMATCH

INSTRUCTIONS__ACCOUNT_NOT_FOUND =

:SOLANA_ERROR__INSTRUCTIONS__ACCOUNT_NOT_FOUND

INSTRUCTIONS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED =

:SOLANA_ERROR__INSTRUCTIONS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED

TRANSACTIONS__TRANSACTION_NOT_SIGNABLE = ── Transactions ──────────────────────────────────────────────────────────

:SOLANA_ERROR__TRANSACTIONS__TRANSACTION_NOT_SIGNABLE

TRANSACTIONS__MISSING_SIGNER =

:SOLANA_ERROR__TRANSACTIONS__MISSING_SIGNER

TRANSACTIONS__VERSION_NUMBER_OUT_OF_RANGE =

:SOLANA_ERROR__TRANSACTIONS__VERSION_NUMBER_OUT_OF_RANGE

TRANSACTIONS__FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_CONTENTS =

:SOLANA_ERROR__TRANSACTIONS__FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_CONTENTS

TRANSACTIONS__FAILED_TO_DECOMPILE_FEE_PAYER_MISSING =

:SOLANA_ERROR__TRANSACTIONS__FAILED_TO_DECOMPILE_FEE_PAYER_MISSING

TRANSACTIONS__FAILED_TO_DECOMPILE_INSTRUCTION_PROGRAM_ADDRESS_NOT_FOUND =

:SOLANA_ERROR__TRANSACTIONS__FAILED_TO_DECOMPILE_INSTRUCTION_PROGRAM_ADDRESS_NOT_FOUND

TRANSACTIONS__SEND_TRANSACTION_PREFLIGHT_FAILURE =

:SOLANA_ERROR__TRANSACTIONS__SEND_TRANSACTION_PREFLIGHT_FAILURE

TRANSACTIONS__BLOCKHASH_NOT_FOUND =

:SOLANA_ERROR__TRANSACTIONS__BLOCKHASH_NOT_FOUND

TRANSACTIONS__FAILED_TRANSACTION_PLAN =

:SOLANA_ERROR__TRANSACTIONS__FAILED_TRANSACTION_PLAN

TRANSACTIONS__TRANSACTION_EXPIRED_BLOCKHEIGHT_EXCEEDED =

:SOLANA_ERROR__TRANSACTIONS__TRANSACTION_EXPIRED_BLOCKHEIGHT_EXCEEDED

TRANSACTIONS__TRANSACTION_EXPIRED_NONCE_INVALID =

:SOLANA_ERROR__TRANSACTIONS__TRANSACTION_EXPIRED_NONCE_INVALID

TRANSACTIONS__TRANSACTION_CONFIRMATION_TIMEOUT =

:SOLANA_ERROR__TRANSACTIONS__TRANSACTION_CONFIRMATION_TIMEOUT

SIGNERS__ADDRESS_CANNOT_HAVE_MULTIPLE_SIGNERS = ── Signers ───────────────────────────────────────────────────────────────

:SOLANA_ERROR__SIGNERS__ADDRESS_CANNOT_HAVE_MULTIPLE_SIGNERS

SIGNERS__EXPECTED_MESSAGE_MODIFYING_SIGNER =

:SOLANA_ERROR__SIGNERS__EXPECTED_MESSAGE_MODIFYING_SIGNER

SIGNERS__EXPECTED_TRANSACTION_MODIFYING_SIGNER =

:SOLANA_ERROR__SIGNERS__EXPECTED_TRANSACTION_MODIFYING_SIGNER

SIGNERS__EXPECTED_TRANSACTION_SENDING_SIGNER =

:SOLANA_ERROR__SIGNERS__EXPECTED_TRANSACTION_SENDING_SIGNER

SIGNERS__TRANSACTION_CANNOT_HAVE_MULTIPLE_SENDING_SIGNERS =

:SOLANA_ERROR__SIGNERS__TRANSACTION_CANNOT_HAVE_MULTIPLE_SENDING_SIGNERS

SIGNERS__WALLET_MULTISIGN_UNIMPLEMENTED =

:SOLANA_ERROR__SIGNERS__WALLET_MULTISIGN_UNIMPLEMENTED

CODECS__CANNOT_DECODE_EMPTY_BYTE_ARRAY = ── Codecs ────────────────────────────────────────────────────────────────

:SOLANA_ERROR__CODECS__CANNOT_DECODE_EMPTY_BYTE_ARRAY

CODECS__EXPECTED_POSITIVE_BYTE_LENGTH =

:SOLANA_ERROR__CODECS__EXPECTED_POSITIVE_BYTE_LENGTH

CODECS__ENCODER_DECODER_FIXED_SIZE_MISMATCH =

:SOLANA_ERROR__CODECS__ENCODER_DECODER_FIXED_SIZE_MISMATCH

CODECS__ENCODER_DECODER_MAX_SIZE_MISMATCH =

:SOLANA_ERROR__CODECS__ENCODER_DECODER_MAX_SIZE_MISMATCH

CODECS__INVALID_NUMBER_OF_ITEMS =

:SOLANA_ERROR__CODECS__INVALID_NUMBER_OF_ITEMS

CODECS__ENUM_DISCRIMINATOR_OUT_OF_RANGE =

:SOLANA_ERROR__CODECS__ENUM_DISCRIMINATOR_OUT_OF_RANGE

CODECS__UNION_VARIANT_OUT_OF_RANGE =

:SOLANA_ERROR__CODECS__UNION_VARIANT_OUT_OF_RANGE

CODECS__OFFSET_OUT_OF_RANGE =

:SOLANA_ERROR__CODECS__OFFSET_OUT_OF_RANGE

CODECS__SENTINEL_MISSING_IN_DECODED_BYTES =

:SOLANA_ERROR__CODECS__SENTINEL_MISSING_IN_DECODED_BYTES

CODECS__INVALID_STRING_FOR_BASE58_CODEC =

:SOLANA_ERROR__CODECS__INVALID_STRING_FOR_BASE58_CODEC

CODECS__INVALID_STRING_FOR_BASE64_CODEC =

:SOLANA_ERROR__CODECS__INVALID_STRING_FOR_BASE64_CODEC

CODECS__INVALID_STRING_FOR_HEX_CODEC =

:SOLANA_ERROR__CODECS__INVALID_STRING_FOR_HEX_CODEC

CODECS__INVALID_BYTE_LENGTH =

:SOLANA_ERROR__CODECS__INVALID_BYTE_LENGTH

CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR =

:SOLANA_ERROR__CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR

CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC =

:SOLANA_ERROR__CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC

RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER = ── RPC / JSON-RPC ────────────────────────────────────────────────────────

:SOLANA_ERROR__RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER

RPC__INTEGER_OVERFLOW_WHILE_DESERIALIZING_LARGE_INTEGER =

:SOLANA_ERROR__RPC__INTEGER_OVERFLOW_WHILE_DESERIALIZING_LARGE_INTEGER

RPC__TRANSPORT_HTTP_ERROR =

:SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR

RPC_SUBSCRIPTIONS__CANNOT_CREATE_SUBSCRIPTION_REQUEST =

:SOLANA_ERROR__RPC_SUBSCRIPTIONS__CANNOT_CREATE_SUBSCRIPTION_REQUEST

RPC_SUBSCRIPTIONS__EXPECTED_SERVER_SUBSCRIPTION_ID =

:SOLANA_ERROR__RPC_SUBSCRIPTIONS__EXPECTED_SERVER_SUBSCRIPTION_ID

RPC_SUBSCRIPTIONS__CHANNEL_CLOSED_BEFORE_MESSAGE_BUFFERED =

:SOLANA_ERROR__RPC_SUBSCRIPTIONS__CHANNEL_CLOSED_BEFORE_MESSAGE_BUFFERED

RPC_SUBSCRIPTIONS__CHANNEL_CONNECTION_CLOSED =

:SOLANA_ERROR__RPC_SUBSCRIPTIONS__CHANNEL_CONNECTION_CLOSED

RPC_SUBSCRIPTIONS__WEBSOCKET_CONNECTION_FAILED =

:SOLANA_ERROR__RPC_SUBSCRIPTIONS__WEBSOCKET_CONNECTION_FAILED

OFFCHAIN_MESSAGES__FAILED_TO_DECODE_MESSAGE = ── Offchain messages ─────────────────────────────────────────────────────

:SOLANA_ERROR__OFFCHAIN_MESSAGES__FAILED_TO_DECODE_MESSAGE

OFFCHAIN_MESSAGES__INVALID_MESSAGE_FORMAT =

:SOLANA_ERROR__OFFCHAIN_MESSAGES__INVALID_MESSAGE_FORMAT

OFFCHAIN_MESSAGES__INVALID_MESSAGE_VERSION =

:SOLANA_ERROR__OFFCHAIN_MESSAGES__INVALID_MESSAGE_VERSION

OFFCHAIN_MESSAGES__NON_PRINTABLE_ASCII_CHARACTER =

:SOLANA_ERROR__OFFCHAIN_MESSAGES__NON_PRINTABLE_ASCII_CHARACTER

OFFCHAIN_MESSAGES__MESSAGE_TOO_LONG =

:SOLANA_ERROR__OFFCHAIN_MESSAGES__MESSAGE_TOO_LONG

OFFCHAIN_MESSAGES__LEADING_ZERO_IN_SIGNING_DOMAIN =

:SOLANA_ERROR__OFFCHAIN_MESSAGES__LEADING_ZERO_IN_SIGNING_DOMAIN

INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_STATE_MISSING = ── Invariant violations (internal) ──────────────────────────────────────

:SOLANA_ERROR__INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_STATE_MISSING

INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_MUST_NOT_POLL_BEFORE_RESOLVING_EXISTING_MESSAGE_PROMISE =

:SOLANA_ERROR__INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_MUST_NOT_POLL_BEFORE_RESOLVING_EXISTING_MESSAGE_PROMISE

ERROR_MESSAGES =

T.let(
  {
    # General
    INVALID_KEYPAIR_SEED_LENGTH                      => 'Keypair seed must be 32 bytes, got %{actual_length}',
    INVALID_NONCE                                    => 'The supplied nonce is not a valid nonce',

    # Addresses
    ADDRESSES__INVALID_BASE58_ENCODED_ADDRESS        => 'Not a valid base58-encoded address',
    ADDRESSES__INVALID_BYTE_LENGTH_FOR_ADDRESS       => 'Expected 32 bytes for an address, got %{byte_length}',
    ADDRESSES__STRING_LENGTH_OUT_OF_RANGE            => 'Address string length out of range (32–44 chars), got %{actual_length}',
    ADDRESSES__INVALID_ED25519_PUBLIC_KEY            => 'The public key is not a valid Ed25519 public key',
    ADDRESSES__SEEDS_POINT_ON_CURVE                  => 'The seeds resolve to a point on the Ed25519 curve; it cannot be used as a PDA',
    ADDRESSES__MAX_SEED_LENGTH_EXCEEDED              => 'A seed exceeds the maximum allowed length of 32 bytes, got %{actual_length}',
    ADDRESSES__TOO_MANY_SEEDS                        => 'Too many seeds provided (max 16)',
    ADDRESSES__FAILED_TO_FIND_VIABLE_PDA_BUMP_SEED   => 'Could not find a viable bump seed for the given program and seeds',
    ADDRESSES__INVALID_SEEDS_POINT_ON_CURVE          => 'The seeds result in a public key that lies on the Ed25519 curve',
    ADDRESSES__PDA_BUMP_SEED_OUT_OF_RANGE            => 'Bump seed must be in range [0, 255]',

    # Accounts
    ACCOUNTS__ACCOUNT_NOT_FOUND                      => 'Account not found at address %{address}',
    ACCOUNTS__ONE_OR_MORE_ACCOUNTS_NOT_FOUND         => 'One or more accounts were not found',
    ACCOUNTS__EXPECTED_DECODED_ACCOUNT               => 'Expected account at address %{address} to be decoded',
    ACCOUNTS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED    => 'Expected all %{count} account(s) to be decoded',
    ACCOUNTS__FAILED_TO_DECODE_ACCOUNT               => 'Failed to decode account data at address %{address}',

    # Keys
    KEYS__INVALID_KEY_PAIR_BYTE_LENGTH               => 'Key pair byte array must be 64 bytes, got %{byte_length}',
    KEYS__PUBLIC_KEY_MUST_MATCH_PRIVATE_KEY          => 'The public key does not match the private key',
    KEYS__INVALID_SIGNATURE_BYTE_LENGTH              => 'Signature must be 64 bytes, got %{actual_length}',
    KEYS__SIGNATURE_STRING_LENGTH_OUT_OF_RANGE       => 'Signature string length out of range (64–88 chars), got %{actual_length}',

    # Instructions
    INSTRUCTIONS__EXPECTED_TO_HAVE_ACCOUNTS          => 'Expected instruction to have accounts',
    INSTRUCTIONS__EXPECTED_TO_HAVE_DATA              => 'Expected instruction to have data',
    INSTRUCTIONS__PROGRAM_ADDRESS_MISMATCH           => 'Instruction program address mismatch: expected %{expected}, got %{actual}',
    INSTRUCTIONS__ACCOUNT_NOT_FOUND                  => 'Account at index %{index} not found in instruction',
    INSTRUCTIONS__EXPECTED_ALL_ACCOUNTS_TO_BE_DECODED => 'Expected all instruction accounts to be decoded',

    # Transactions
    TRANSACTIONS__TRANSACTION_NOT_SIGNABLE           => 'Transaction is not signable (missing fee payer or lifetime constraint)',
    TRANSACTIONS__MISSING_SIGNER                     => 'Transaction is missing a required signer: %{address}',
    TRANSACTIONS__VERSION_NUMBER_OUT_OF_RANGE        => 'Transaction version %{version} is out of range',
    TRANSACTIONS__FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_CONTENTS => 'Failed to decompile address lookup table contents',
    TRANSACTIONS__FAILED_TO_DECOMPILE_FEE_PAYER_MISSING => 'Failed to decompile transaction: fee payer is missing',
    TRANSACTIONS__FAILED_TO_DECOMPILE_INSTRUCTION_PROGRAM_ADDRESS_NOT_FOUND => 'Failed to decompile instruction: program address not found',
    TRANSACTIONS__SEND_TRANSACTION_PREFLIGHT_FAILURE => 'Transaction simulation failed: %{message}',
    TRANSACTIONS__BLOCKHASH_NOT_FOUND                => 'Blockhash not found',
    TRANSACTIONS__FAILED_TRANSACTION_PLAN            => 'Failed to execute transaction plan',
    TRANSACTIONS__TRANSACTION_EXPIRED_BLOCKHEIGHT_EXCEEDED => 'Transaction expired: block height exceeded',
    TRANSACTIONS__TRANSACTION_EXPIRED_NONCE_INVALID  => 'Transaction expired: nonce is no longer valid',
    TRANSACTIONS__TRANSACTION_CONFIRMATION_TIMEOUT   => 'Timed out waiting for transaction %{signature} to confirm',

    # Signers
    SIGNERS__ADDRESS_CANNOT_HAVE_MULTIPLE_SIGNERS    => 'Address %{address} cannot be assigned multiple signers',
    SIGNERS__EXPECTED_MESSAGE_MODIFYING_SIGNER       => 'Expected signer to be a message modifying signer',
    SIGNERS__EXPECTED_TRANSACTION_MODIFYING_SIGNER   => 'Expected signer to be a transaction modifying signer',
    SIGNERS__EXPECTED_TRANSACTION_SENDING_SIGNER     => 'Expected signer to be a transaction sending signer',
    SIGNERS__TRANSACTION_CANNOT_HAVE_MULTIPLE_SENDING_SIGNERS => 'Transaction cannot have multiple sending signers',
    SIGNERS__WALLET_MULTISIGN_UNIMPLEMENTED          => 'Wallet multisign is not yet implemented',

    # Codecs
    CODECS__CANNOT_DECODE_EMPTY_BYTE_ARRAY           => 'Cannot decode an empty byte array',
    CODECS__EXPECTED_POSITIVE_BYTE_LENGTH            => 'Expected a positive byte length, got %{byte_length}',
    CODECS__ENCODER_DECODER_FIXED_SIZE_MISMATCH      => 'Encoder fixed size (%{encoder_size}) does not match decoder fixed size (%{decoder_size})',
    CODECS__ENCODER_DECODER_MAX_SIZE_MISMATCH        => 'Encoder max size (%{encoder_max}) does not match decoder max size (%{decoder_max})',
    CODECS__INVALID_NUMBER_OF_ITEMS                  => 'Expected %{expected} items but got %{actual}',
    CODECS__ENUM_DISCRIMINATOR_OUT_OF_RANGE          => 'Enum discriminator %{discriminator} is out of range [0, %{max}]',
    CODECS__UNION_VARIANT_OUT_OF_RANGE               => 'Union variant index %{index} is out of range',
    CODECS__OFFSET_OUT_OF_RANGE                      => 'Codec offset %{offset} is out of range for byte array of length %{byte_length}',
    CODECS__SENTINEL_MISSING_IN_DECODED_BYTES        => 'Sentinel bytes not found in decoded data',
    CODECS__INVALID_STRING_FOR_BASE58_CODEC          => 'Invalid base58 string: %{value}',
    CODECS__INVALID_STRING_FOR_BASE64_CODEC          => 'Invalid base64 string: %{value}',
    CODECS__INVALID_STRING_FOR_HEX_CODEC             => 'Invalid hex string: %{value}',
    CODECS__INVALID_BYTE_LENGTH                      => 'Expected %{expected} bytes but got %{actual}',
    CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR => 'Expected zero value to match fixed discriminator',
    CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC => 'A fixed-size nullable codec cannot wrap a variable-size codec',

    # RPC
    RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER   => 'Integer overflow while serializing large integer %{value}',
    RPC__INTEGER_OVERFLOW_WHILE_DESERIALIZING_LARGE_INTEGER => 'Integer overflow while deserializing large integer %{value}',
    RPC__TRANSPORT_HTTP_ERROR                               => 'HTTP transport error: %{status} %{message}',
    RPC_SUBSCRIPTIONS__CANNOT_CREATE_SUBSCRIPTION_REQUEST  => 'Cannot create subscription request',
    RPC_SUBSCRIPTIONS__EXPECTED_SERVER_SUBSCRIPTION_ID     => 'Expected server to return a subscription ID',
    RPC_SUBSCRIPTIONS__CHANNEL_CLOSED_BEFORE_MESSAGE_BUFFERED => 'WebSocket channel closed before message could be buffered',
    RPC_SUBSCRIPTIONS__CHANNEL_CONNECTION_CLOSED           => 'WebSocket connection closed: %{reason}',
    RPC_SUBSCRIPTIONS__WEBSOCKET_CONNECTION_FAILED         => 'Failed to establish WebSocket connection to %{url}',

    # Offchain messages
    OFFCHAIN_MESSAGES__FAILED_TO_DECODE_MESSAGE      => 'Failed to decode offchain message',
    OFFCHAIN_MESSAGES__INVALID_MESSAGE_FORMAT        => 'Invalid offchain message format',
    OFFCHAIN_MESSAGES__INVALID_MESSAGE_VERSION       => 'Invalid offchain message version %{version}',
    OFFCHAIN_MESSAGES__NON_PRINTABLE_ASCII_CHARACTER => 'Offchain message v0 contains non-printable ASCII character at index %{index}',
    OFFCHAIN_MESSAGES__MESSAGE_TOO_LONG              => 'Offchain message is too long (%{length} bytes, max %{max})',
    OFFCHAIN_MESSAGES__LEADING_ZERO_IN_SIGNING_DOMAIN => 'Offchain message signing domain must not start with a null byte',

    # Invariant violations
    INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_STATE_MISSING => 'Subscription iterator state is missing (internal error)',
    INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_MUST_NOT_POLL_BEFORE_RESOLVING_EXISTING_MESSAGE_PROMISE => 'Subscription iterator must not poll before resolving existing message (internal error)',
  }.freeze,
  T::Hash[Symbol, String]
)

Instance Attribute Summary collapse

#code ⇒ Object readonly

Returns the value of attribute code.
#context ⇒ Object readonly

Returns the value of attribute context.

Instance Method Summary collapse

#initialize(code, context = {}) ⇒ SolanaError constructor

A new instance of SolanaError.

Constructor Details

#initialize(code, context = {}) ⇒ `SolanaError`

Returns a new instance of SolanaError.

# File 'lib/solana/ruby/kit/errors.rb', line 217

def initialize(code, context = {})
  @code    = T.let(code, Symbol)
  @context = T.let(context, T::Hash[Symbol, T.untyped])

  template = ERROR_MESSAGES[code] || code.to_s
  message  = context.empty? ? template : (template % context rescue "#{template} #{context}")
  super(message)
end

Instance Attribute Details

#code ⇒ `Object` (readonly)

Returns the value of attribute code.



211
212
213

# File 'lib/solana/ruby/kit/errors.rb', line 211

def code
  @code
end

#context ⇒ `Object` (readonly)

Returns the value of attribute context.



214
215
216

# File 'lib/solana/ruby/kit/errors.rb', line 214

def context
  @context
end