Steemex

Elixir websockets client for steemd. Provides an interface to Steem JSONRPC protocol. Steemex is a supervised application with two workers and a configurable handler for handling responses to JSONRPC calls response.

Steemex is under active development.

Installation

1. Add steemex to your list of dependencies in mix.exs:

```elixir
def deps do
  [{:steemex, "~> 0.5.0"}]
end
```

1. Add 'steemex' to applications in mix.exs: elixir def application do [applications: [:logger, :steemex]] end

Example

First, configure a websockets url for the steemd instance, for example, http://127.0.0.1:8090 to the config. Then, provide a handler module in the config file.

config :steemex,
  url: "STEEM_URL",
  handler: SteemexHandlerModule

You can also use Steemex.call_sync that will block the calling process. Call_sync returns a success tuple with a JSONRPC endpoint response data.

Example of SteemexHandlerModule. You need a handler module with a handle_jsonrpc_call callback. GenServer handler implementation is recommended as any advanced aggregation or analysis of blockchain data requires some state management.

defmodule Steemex.Handler do
  use GenServer
  require Logger

  # API
  def start_link(_params \\ []) do
    GenServer.start_link(__MODULE__, [], name: __MODULE__)
  end

  def handle_jsonrpc_call(id, call_params, data) do
    Logger.debug "Received jsonrpc call response"
    GenServer.cast(__MODULE__, {id, call_params, data} )
  end

  # SERVER
  def handle_cast({id, ["database_api", "get_dynamic_global_properties", []], data}, _) do
    Logger.debug inspect(data)
    {:noreply, []}
  end

  def handle_cast({id, ["database_api", "get_state", params], data}, _) do
    Logger.debug inspect(data)
    {:noreply, []}
  end

  def handle_cast({id, msg, data}, _) do
    Logger.debug("No known handler function for this message")
    Logger.debug inspect(msg)
    {:noreply, []}
  end

end

Roadmap

• Major refactoring
• Investigate making blocking behaviour as a default
• Investigate using GenStage
• Add more utility functions
• Add more types and structs
• More tests and docs