Repositories
SteemRubyTutorial
All examples from this tutorial can be found as fully functional scripts on GitHub:
- SteemRubyTutorial
- steem-api sample code: Steem-Dump-Vesting.rb
- radiator sample code: Steem-Print-Vesting.rb.
steem-ruby
- Project Name: Steem Ruby (with Hive patches)
- Repository: https://github.com/krischik/steem-ruby
- Official Documentation: https://www.rubydoc.info/gems/steem-ruby
- Official Tutorial: N/A
steem-mechanize
- Project Name: Steem Mechanize (with Hive patches)
- Repository: https://github.com/krischik/steem-mechanize
- Official Documentation: https://www.rubydoc.info/gems/steem-mechanize
- Official Tutorial: N/A
radiator
- Project Name: Radiator (with Hive patches)
- Repository: https://github.com/krischik/radiator
- Official Documentation: https://www.rubydoc.info/gems/radiator
- Official Tutorial: https://developers.steem.io/tutorials-ruby/getting_started
What Will I Learn?
This tutorial shows how to interact with the Steem and Hive blockchain as well as the Steem and Hive database using Ruby. When using Ruby you have three APIs available to chose: steem-api, steem-mechaniz and radiator which differentiates in how return values and errors are handled:
- steem-api uses closures and exceptions and provides low level computer readable data.
- steem-mechanize drop in replacement for steem-api with more performance network I/O
- radiator uses classic function return values and provides high level human readable data.
Since all APIs have advantages and disadvantages sample code for both APIs will be provided so the reader ca decide which is more suitable.
In this chapter of the tutorial you learn how to write scripts which will run both on the Steem and Hive blockchain using the printing the chain configuration as example.
Requirements
Basic knowledge of Ruby programming is needed. It is necessary to install at least Ruby 2.5 as well as the following standard ruby gems:
gem install bundler
gem install colorize
gem install contracts
For Hive compatibility you need the hive patched versions of the steem-ruby and radiator ruby gems. These are not yet available in the standard ruby gem repository and you need to install them from source. For this you change into the directory you keep Git clones and use the following commands:
git clone "https://github.com/krischik/steem-ruby"
pushd "steem-ruby"
git checkout feature/Enhancement22
gem build "steem-ruby.gemspec"
gem install "steem-ruby"
popd
git clone "https://github.com/krischik/steem-mechanize"
pushd "steem-mechanize"
git checkout feature/Enhancement22
gem build "steem-mechanize.gemspec"
gem install "steem-mechanize"
popd
git clone "https://github.com/krischik/radiator"
pushd "radiator"
git checkout feature/Enhancement22
gem build "radiator.gemspec"
gem install "radiator"
popd
If you already checked out the steem-ruby and radiator you will need to update them to the newest version.
Note: All APIs steem-ruby, steem-mechanize and radiator provide a file called steem.rb. This means that:
- When more then one APIs is installed ruby must be told which one to use.
- The tree APIs can't be used in the same script.
If there is anything not clear you can ask in the comments.
Difficulty
For reader with programming experience this tutorial is basic level.
Tutorial Contents
In Part 19 we took a first look at accessing the hive blockchain but we have not yet used coins and we skipped the steem-mechanize API. In this tutorial we will look at both at the example of the Steem-Dump-Vesting and Steem-Print-Vesting. scripts.
When handling amounts it is necessary to know from which chain the amount originates and since the NAI hasn't change and VESTS have the same name all all chain it's necessary to specify the chain from as a separate parameter.
Instead of:
_value = Steem::Type::Amount.new("1000.000000 VEST")
you now call:
_value = Steem::Type::Amount.new("1000.000000 VEST", :hive)
And that is all there is. The rest happens in the api.
Implementation using steem-mechanise
The (https://github.com/krischik/SteemRubyTutorial/blob/master/Scripts/Steem-Dump-Vesting.rb)[Steem-Dump-Vesting.rb] script is the only script in the tutorial with enough network I/O to warrant using steem-mechanise. The script has previously been explained in (https://peakd.com/@krischik/using-steem-api-with-ruby-part-11)[Part 11] so I'm only going to explain the differences needed to make the script Hive compatible.
Initialize access to the steem or hive blockchain. The script will initialize the constant Chain_Options with suitable parameter for the chain selected with the CHAIN_ID environment variable.
require_relative 'Steem/Chain'
require 'steem-mechanize'
Store the chain name for convenience.
Chain = Chain_Options[:chain]
Maximum retries to be done when an error happens.
Max_Retry_Count = if Chain == :hive then
5
else
3
end
Maximum requests made per second.
Both Steem and Hive will fail if to many requests will be done in a very short time. Hive hasn't got the CPU power yet to accept as many requests per second as Steem does.
Request_Per_Second = if Chain == :hive then
5.0
else
20.0
end
Maximum retries per second made when and error happens.
Hive hasn't got the CPU power yet to accept as many retries per second as Steem does.
Retries_Per_Second = if Chain == :hive then
0.5
else
1
end
After this all Steem::Type::Amount.new calls need to be changed to pass the Chain constant:
@delegatee = value.delegatee
@vesting_shares = Steem::Type::Amount.new(value.vesting_shares, Chain)
@min_delegation_time = Time.strptime(value.min_delegation_time + ":Z", "%Y-%m-%dT%H:%M:%S:%Z")
…
_median_history_price = Condenser_Api.get_current_median_history_price.result
_base = Steem::Type::Amount.new(_median_history_price.base, Chain)
_quote = Steem::Type::Amount.new(_median_history_price.quote, Chain)
SBD_Median_Price = _base.to_f / _quote.to_f
_global_properties = Condenser_Api.get_dynamic_global_properties.result
_total_vesting_fund_steem = Steem::Type::Amount.new(_global_properties.total_vesting_fund_steem, Chain)
_total_vesting_shares = Steem::Type::Amount.new(_global_properties.total_vesting_shares, Chain)
Conversion_Rate_Vests = _total_vesting_fund_steem.to_f / _total_vesting_shares.to_f
Hint: Follow this link to Github for the complete script with comments and syntax highlighting: Steem-Dump-Vesting.rb.
The output of the command (for the steem and hive blockchain) looks like this:
>CHAIN_ID=steem Scripts/Steem-Dump-Vesting.rb krischik
id | delegator | delegatee | vesting shares | min delegation time |
-----------|------------------+------------------+--------------------------------------------------------------------+----------------------+
496173 | anthonyadavisii ⇒ krischik | 0.804 SBD 5.287 STEEM 10340.898045 VESTS | 2018-01-14 15:52:45 |
1331721 | krischik ⇒ digital.mine | 15.209 SBD 100.058 STEEM 195706.450950 VESTS | 2020-04-03 13:37:15 |
1331725 | krischik ⇒ dlike | 15.209 SBD 100.058 STEEM 195706.373080 VESTS | 2020-04-03 13:47:30 |
1331723 | krischik ⇒ project.hope | 152.088 SBD 1000.577 STEEM 1957063.858825 VESTS | 2020-04-03 13:45:42 |
Finished!
>CHAIN_ID=hive Scripts/Steem-Dump-Vesting.rb krischik
id | delegator | delegatee | vesting shares | min delegation time |
-----------|------------------+------------------+--------------------------------------------------------------------+----------------------+
496173 | anthonyadavisii ⇒ krischik | 0.869 HBD 5.290 HIVE 10340.898045 VESTS | 2018-01-14 15:52:45 |
1330473 | krischik ⇒ digital.mine | 16.461 HBD 100.159 HIVE 195791.393468 VESTS | 2020-03-24 08:37:24 |
Finished!
As is shown the same script work on both chains identical. Only the output is different as I have different delegations on both chains.
Implementation using radiator
The radiator script is a lot simpler as it only searches for the delegator and not the delegatee. The radiator script has previously been explained in (https://peakd.com/@krischik/using-steem-api-with-ruby-part-10)[Part 10] so I'm only going to explain the differences needed to make the script Hive compatible.
Initialize access to the steem or hive blockchain. The script will initialize the constant Chain_Options with suitable parameter for the chain selected with the CHAIN_ID environment variable.
require_relative 'Radiator/Chain'
require_relative 'Radiator/Amount'
require_relative 'Radiator/Price'
``
Store the chain name for convenience.
```ruby
Chain = Chain_Options[:chain]
Without the need of slowdowns and retries this change is a lot simpler and only the Radiator::Type::Amount.new calls need to be changed to pass the Chain constant:
@id = value.id
@delegator = value.delegator
@delegatee = value.delegatee
@vesting_shares = Radiator::Type::Amount.new(value.vesting_shares, Chain)
@min_delegation_time = Time.strptime(value.min_delegation_time + ":Z", "%Y-%m-%dT%H:%M:%S:%Z")
…
_global_properties = Condenser_Api.get_dynamic_global_properties.result
_total_vesting_fund_steem = Radiator::Type::Amount.new(_global_properties.total_vesting_fund_steem, Chain)
_total_vesting_shares = Radiator::Type::Amount.new(_global_properties.total_vesting_shares, Chain)
Conversion_Rate_Vests = _total_vesting_fund_steem.to_f / _total_vesting_shares.to_f
Hint: Follow this link to Github for the complete script with comments and syntax highlighting : Steem-Print-Vesting.rb.
The output of the command (for the steem blockchain) looks missing the anthonyadavisii delegations:
>CHAIN_ID=steem Scripts/Steem-Print-Vesting.rb krischik
id | delegator | delegatee | vesting shares | min delegation time |
-----------|------------------+------------------+--------------------------------------------------------------------+----------------------+
1331721 | krischik ⇒ digital.mine | 15.209 SBD 100.058 STEEM 195706.450950 VESTS | 2020-04-03 13:37:15 |
1331725 | krischik ⇒ dlike | 15.209 SBD 100.058 STEEM 195706.373080 VESTS | 2020-04-03 13:47:30 |
1331723 | krischik ⇒ project.hope | 152.088 SBD 1000.579 STEEM 1957063.858825 VESTS | 2020-04-03 13:45:42 |
>CHAIN_ID=hive Scripts/Steem-Print-Vesting.rb krischik
id | delegator | delegatee | vesting shares | min delegation time |
-----------|------------------+------------------+--------------------------------------------------------------------+----------------------+
1330473 | krischik ⇒ digital.mine | 16.460 HBD 100.159 HIVE 195791.393468 VESTS | 2020-03-24 08:37:24 |
Curriculum
First tutorial
Previous tutorial
Next tutorial
Proof of Work
- GitHub: SteemRubyTutorial Issue #22
Image Source
- Ruby symbol: Wikimedia, CC BY-SA 2.5.
- Steemit logo: Wikimedia, CC BY-SA 4.0.
- Hive logo: Hive Band Assets, CC BY-SA 4.0.
- Steem Engine logo: Steem Engine
- Screenshots: @krischik, CC BY-NC-SA 4.0
