Stellar SDK for Ruby: Horizon Integration and Higher Level Abstractions

stellar-sdk Test Maintainability

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


Add this lines to your application's Gemfile:

gem 'stellar-sdk'

And then execute:

$ bundle

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::Account.master
client    = Stellar::Client.default_testnet()
recipient = Stellar::Account.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


  • Install and activate rvm
  • Ensure your bundler version is up-to-date: gem install bundler
  • Run bundle install
  • Copy spec/config.yml.sample to spec/config.yml
  • Replace anything in spec/config.yml especially if you will re-record specs
  • bundle exec 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