Ruby Stellar

Build Status Code Climate

STATUS: this library is very early and incomplete. The examples provided do not work, yet

This library helps you to integrate your application into the Stellar network.


Add this line to your application's Gemfile:

gem 'stellar-sdk'

And then execute:

$ bundle

Or install it yourself as:

$ gem install stellar-sdk

Also requires libsodium. Installable via brew install libsodium on OS X.


See examples.

A simple payment from the root account to some random accounts

require 'stellar-sdk'

   = Stellar::.master
client    = Stellar::Client.default_testnet()
recipient = Stellar::.random

  from:   ,
  to:     recipient,

Be sure to set the network when submitting to the public network (more information in stellar-base):

Stellar.default_network = Stellar::Networks::PUBLIC


  • Copy spec/config.yml.sample to spec/config.yml
  • Replace anything in spec/config.yml especially if you will re-record specs
  • rspec spec


  1. Sign the Contributor License Agreement
  2. Fork it ( )
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request