Skip to content

getting_started.md

Latest commit

 

History

History
88 lines (60 loc) · 2.44 KB

getting_started.md

File metadata and controls

88 lines (60 loc) · 2.44 KB
Raw
title RB: Getting Started
position 0
description To access the dPay blockchain using Ruby, install the Radiator gem: [https://github.com/inertia186/radiator](https://github.com/inertia186/radiator). Full documentation on Radiator api methods are hosted on [rubydoc.info](http://www.rubydoc.info/gems/radiator).
layout full

Full, runnable src of Getting Started can be downloaded as part of the RB tutorials repository.

Setup

The following is a minimal Gemfile for running .rb files in these examples.

Add gem 'radiator' to your Gemfile. Then install the gem:

bundle install

It is also possible to install radiator directly with gem:

gem install radiator

Then, to execute a script without a Gemfile, add to the top of your .rb files:

require 'radiator'

Then, use the ruby command with radiator specified:

ruby -r radiator myscript.rb

Examples

The tutorials on this site are available within this site's repository. To get a copy, clone this repository, change directory to devportal/_includes/tutorials-ruby and do a bundle install to install the required local gems.

From there, you can see all of the .rb files referenced on this site.

git clone https://github.com/dpays/developer-docs.git
cd devportal/_includes/tutorials-ruby/
bundle install

Typical-Usage

Most methods can be accessed by creating an instance of Radiator::Api. It is also possible to specify a different node by passing a url option.

Radiator also internally supports failover by specifying the failover_urls option.

To use the defaults:

api = Radiator::Api.new

To override the url option:

api = Radiator::Api.new(url: 'https://d.dpays.io')

To override both url and failover_urls options:

options = {
  url: 'https://d.dpays.io',
  failover_urls: [
    'https://greatchain.dpays.io',
    'https://dpaystan.link',
    'https://dpay.indominon.com',
  ]
}
api = Radiator::Api.new(options)

Next Step

If you'd like to dive right into the first tutorial, have a look at: Blog Feed