Solana.Transaction (Solana v0.1.0)

View Source

Functions for building and encoding Solana transactions

Summary

Types

encoding_err()

The possible errors encountered when encoding a transaction.

t()

All the details needed to encode a transaction.

Functions

check(signature)

Checks to see if a transaction's signature is valid.

decode(encoded)

decodes a base58-encoded signature and returns it in a tuple.

decode!(encoded)

decodes a base58-encoded signature and returns it.

encode_message(tx)
parse(encoded)

Parses a Solana.Transaction.t/0 from data encoded in Solana's binary format

to_binary(tx)

Encodes a Solana.Transaction.t/0 into a binary format

Types

encoding_err()

@type encoding_err() ::
  :no_payer
  | :no_blockhash
  | :no_program
  | :no_instructions
  | :mismatched_signers

The possible errors encountered when encoding a transaction.

t()

@type t() :: %Solana.Transaction{
  blockhash: binary() | nil,
  instructions: [Solana.Instruction.t()],
  payer: Solana.key() | nil,
  signers: [Solana.keypair()]
}

All the details needed to encode a transaction.

Functions

check(signature)

@spec check(binary()) :: {:ok, binary()} | {:error, :invalid_signature}

Checks to see if a transaction's signature is valid.

Returns {:ok, signature} if it is, and an error tuple if it isn't.

decode(encoded)

@spec decode(encoded :: binary()) :: {:ok, binary()} | {:error, binary()}

decodes a base58-encoded signature and returns it in a tuple.

If it fails, return an error tuple.

decode!(encoded)

@spec decode!(encoded :: binary()) :: binary()

decodes a base58-encoded signature and returns it.

Throws an ArgumentError if it fails.

encode_message(tx)

@spec encode_message(tx :: t()) :: binary() | {:error, encoding_err()}

parse(encoded)

@spec parse(encoded :: binary()) :: {t(), keyword()} | :error

Parses a Solana.Transaction.t/0 from data encoded in Solana's binary format

Returns {transaction, extras} if the transaction was successfully parsed, or :error if the provided binary could not be parsed. extras is a keyword list containing information about the encoded transaction, namely:

to_binary(tx)

@spec to_binary(tx :: t()) :: {:ok, binary()} | {:error, encoding_err()}

Encodes a Solana.Transaction.t/0 into a binary format

Returns {:ok, encoded_transaction} if the transaction was successfully encoded, or an error tuple if the encoding failed -- plus more error details via Logger.error/1.