View Source Stellar.Horizon.Transactions (Elixir Stellar SDK v0.17.1)

Exposes functions to interact with Transactions in Horizon.

You can:

  • Create a transaction.
  • Retrieve a transaction.
  • List all transactions.
  • List a transaction's effects.
  • List a transaction's operations.

Horizon API reference: https://developers.stellar.org/api/resources/transactions/

Summary

Functions

Lists all successful transactions.

Creates a transaction to the Stellar network.

Lists the effects of a specific transaction.

Lists successful operations for a specific transaction.

Retrieves information of a specific transaction.

Types

Functions

@spec all(options :: options()) :: response()

Lists all successful transactions.

Options

  • cursor: A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.
  • order: A designation of the order in which records should appear. Options include asc (ascending) or desc (descending).
  • limit: The maximum number of records returned. The limit can range from 1 to 200. Defaults to 10.
  • include_failed: Set to true to include failed operations in results.

Examples

iex> Transactions.all(limit: 10, order: :asc)
{:ok, %Collection{records: [%Transaction{}, ...]}}

# include failed
iex> Transactions.all(limit: 10, include_failed: true)
{:ok, %Collection{records: [%Transaction{}, ...]}}
@spec create(base64_envelope :: String.t()) :: response()

Creates a transaction to the Stellar network.

Parameters:

  • tx: The base64-encoded XDR of the transaction.

Examples

iex> Transactions.create("AAAAAgAAAACQcEK2yfQA9CHrX+2UMkRIb/1wzltKqHpbdIcJbp+b/QAAAGQAAiEYAAAAAQAAAAEAAAAAAAAAAAAAAABgXP3QAAAAAQAAABBUZXN0IFRyYW5zYWN0aW9uAAAAAQAAAAAAAAABAAAAAJBwQrbJ9AD0Ietf7ZQyREhv/XDOW0qoelt0hwlun5v9AAAAAAAAAAAF9eEAAAAAAAAAAAFun5v9AAAAQKdJnG8QRiv9xGp1Oq7ACv/xR2BnNqjfUHrGNua7m4tWbrun3+GmAj6ca3xz+4ZppWRTbvTUcCxvpbHERZ85QgY=")
{:ok, %Transaction{}}
Link to this function

list_effects(hash, options \\ [])

View Source
@spec list_effects(hash :: hash(), options :: options()) :: response()

Lists the effects of a specific transaction.

Parameters

  • hash: A hex-encoded SHA-256 hash of this transaction’s XDR-encoded form.

Options

  • cursor: A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.
  • order: A designation of the order in which records should appear. Options include asc (ascending) or desc (descending).
  • limit: The maximum number of records returned. The limit can range from 1 to 200. Defaults to 10.

Examples

iex> Transactions.list_effects("6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a", limit: 20)
{:ok, %Collection{records: [%Effect{}, ...]}}
Link to this function

list_operations(hash, options \\ [])

View Source
@spec list_operations(hash :: hash(), options :: options()) :: response()

Lists successful operations for a specific transaction.

Parameters

  • hash: A hex-encoded SHA-256 hash of this transaction’s XDR-encoded form.

Options

  • cursor: A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.
  • order: A designation of the order in which records should appear. Options include asc (ascending) or desc (descending).
  • limit: The maximum number of records returned. The limit can range from 1 to 200. Defaults to 10.
  • include_failed: Set to true to include failed operations in results.
  • join: Set to transactions to include the transactions which created each of the operations in the response.

Examples

iex> Transactions.list_operations("6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a", limit: 20)
{:ok, %Collection{records: [%Operation{}, ...]}}

# join transactions
iex> Transactions.list_operations("6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a", join: "transactions")
{:ok, %Collection{records: [%Operation{transaction: %Transaction{}}, ...]}}
@spec retrieve(hash :: hash()) :: response()

Retrieves information of a specific transaction.

Parameters:

  • hash: A hex-encoded SHA-256 hash of this transaction’s XDR-encoded form.

Examples

iex> Transactions.retrieve("5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc")
{:ok, %Transaction{}}