Current section
Files
Jump to
Current section
Files
lib/database_api.ex
defmodule Golos.DatabaseApi do
@moduledoc """
Contains all functions to call Golos database_api methods
"""
def call(method, params) do
Golos.call(["database_api", method, params])
end
@doc"""
Returns block data, accepts block height.
Example response:
```
%{"extensions" => [], "previous" => "0004cb2eff2f45b042e85563f76f24123b6dfdd2",
"timestamp" => "2016-10-29T09:23:33",
"transaction_merkle_root" => "8477010d8f8ade6f69744c6c28203f1b4a1690a2",
"transactions" => [%{"expiration" => "2016-10-29T09:23:42",
"extensions" => [],
"operations" => [["comment",
%{"author" => "kriptograf",
"body" => "@@ -187,16 +187,17 @@ %D1%81%D1%82%D0%BE%D1%80%D0%B0%D0%BC%D0%B8 +%0A ( %D1%81%D1%83%D0%BC%D0%BC%D1%8B ",
"json_metadata" => "{"tags":["ru--kriptovalyuty"]}",
"parent_author" => "sept",
"parent_permlink" => "kak-kupit-bitkoin-s-minimalnoi-komissiei",
"permlink" => "re-sept-kak-kupit-bitkoin-s-minimalnoi-komissiei-20161029t091207449z",
"title" => ""}]], "ref_block_num" => 51994,
"ref_block_prefix" => 2572860361,
"signatures" => ["207fe62d3e6582819a24f5c2258a9d74f69ebab6c9a42b4d321fe08e559b4cd13b6486a429cb60176d40a5d46ee8b8e30b5c6c24d8facc2a7a779ade3f9139a470"]}],
"witness" => "misha",
"witness_signature" => "2047ea30c48247a67ff553986f221092d32985eea3e341d684f2d4c0aa09a0ec402582b06619fc5dc40192e2c311eeea3c}
```
"""
@spec get_block(integer) :: map
def get_block(height) do
with {:ok, block} <- call("get_block", [height]) do
block = Map.put(block, :height, height)
|> Golos.Block.parse_raw_data()
|> Golos.Block.new()
{:ok, block}
else
err -> err
end
end
# CONTENT
@doc"""
Returns content data, accepts author and permlink.
Example response:
```
%{"max_accepted_payout" => "1000000.000 GBG",
"title" => "[Š¾Š±ŃŃŠ²Š»ŠµŠ½ŠøŠµ] ŠŃŠ°ŃŠ“ŃŠµŠ¹Š» Šø ŠØŃŃŠ“ŃŠ¾Šæ. ŠŠøŃŃŃŠøŠ±ŃŃŃŠøŃ",
"category" => "ru--kraudseijl", "promoted" => "0.000 GBG",
"last_update" => "2016-12-06T15:36:54", "created" => "2016-12-05T16:43:03",
"parent_permlink" => "ru--kraudseijl", "total_vote_weight" => 0,
"json_metadata" => "{"tags":["ru--kraudseijl","ru--shyerdrop","ru--golos"],"users":["golos","crowdsale","cyberdrop","misha","ether","bender","hipster","litvintech","vitaly-lvov"],"image":["https://dl.dropboxusercontent.com/u/52209381/golos/golos.png","https://dl.dropboxusercontent.com/u/52209381/golos/Screenshot%202016-12-05%2018.30.00.png","https://dl.dropboxusercontent.com/u/52209381/golos/ico_final-min.jpg","https://dl.dropboxusercontent.com/u/52209381/golos/Screenshot%202016-12-06%2002.25.05.png","https://dl.dropboxusercontent.com/u/52209381/golos/card.png"],"links":["https://docs.google.com/spreadsheets/d/1JwCAeRwsu4NzCG20UDM_CnEEsskl0wtvQ7VYjqi233A/edit?usp=sharing","https://golos.io/@litvintech"]}",
"last_payout" => "2017-01-15T11:00:06",
"total_payout_value" => "2412.784 GBG", "allow_replies" => true,
"children_rshares2" => "0", "id" => "2.8.30160",
"pending_payout_value" => "0.000 GBG", "children" => 15, "replies" => [],
"body" => "...",
"active" => "2016-12-06T22:23:06", "net_rshares" => 0,
"author_rewards" => 10011558, "total_pending_payout_value" => "0.000 GBG",
"root_comment" => "2.8.30160", "max_cashout_time" => "1969-12-31T23:59:59",
"root_title" => "[Š¾Š±ŃŃŠ²Š»ŠµŠ½ŠøŠµ] ŠŃŠ°ŃŠ“ŃŠµŠ¹Š» Šø ŠØŃŃŠ“ŃŠ¾Šæ. ŠŠøŃŃŃŠøŠ±ŃŃŃŠøŃ",
"allow_votes" => true, "percent_steem_dollars" => 10000,
"children_abs_rshares" => 0, "net_votes" => 90, "author" => "litvintech",
"curator_payout_value" => "112.100 GBG",
"permlink" => "obyavlenie-kraudseil-i-sherdrop-distribyuciya",
"url" => "/ru--kraudseijl/@litvintech/obyavlenie-kraudseil-i-sherdrop-distribyuciya",
"cashout_time" => "2017-02-14T11:00:06", "parent_author" => "",
"allow_curation_rewards" => true, "vote_rshares" => 0,
"reward_weight" => 10000,
"active_votes" => [%{"percent" => 1000, "reputation" => "15928643268388",
"rshares" => "1974529666496", "time" => "2016-12-05T17:02:39",
"voter" => "val", "weight" => "99631990926249375"}, %{...}, ...], "depth" => 0,
"mode" => "second_payout", "abs_rshares" => 0,
"author_reputation" => "22784203010137"}
```
"""
@spec get_content(String.t, String.t) :: map
def get_content(author, permlink) do
with {:ok, comment} <- call("get_content", [author, permlink]) do
cleaned = comment
|> Golos.Cleaner.strip_token_names_and_convert_to_number()
|> Golos.Cleaner.parse_json_strings(:json_metadata)
|> Golos.Cleaner.extract_fields()
|> Golos.Cleaner.prepare_tags()
|> Golos.Cleaner.parse_timedate_strings()
|> Golos.Cleaner.parse_empty_strings()
{:ok, cleaned}
else
err -> err
end
end
@doc"""
Returns a list of replies to the given content, accepts author and permlink.
Example response:
```
[%{"max_accepted_payout" => "1000000.000 GBG", "title" => "",
"category" => "ru--kraudseijl", "promoted" => "0.000 GBG",
"last_update" => "2016-12-05T16:50:09",
"created" => "2016-12-05T16:50:09",
"parent_permlink" => "obyavlenie-kraudseil-i-sherdrop-distribyuciya",
"total_vote_weight" => 0,
"json_metadata" => "{\"tags\":[\"ru--kraudseijl\"]}",
"last_payout" => "2017-01-15T11:00:06",
"total_payout_value" => "12.892 GBG", "allow_replies" => true,
"children_rshares2" => "0", "id" => "2.8.30165",
"pending_payout_value" => "0.000 GBG", "children" => 1,
"replies" => [],
"body" => "Š Š¾Š½ ŃŠŗŠ°Š·Š°Š» ŠæŠ¾ŠµŃ
Š°Š»Šø...",
"active" => "2016-12-06T01:57:24", "net_rshares" => 0,
"author_rewards" => 53499,
"total_pending_payout_value" => "0.000 GBG",
"root_comment" => "2.8.30160",
"max_cashout_time" => "1969-12-31T23:59:59",
"root_title" => "[Š¾Š±ŃŃŠ²Š»ŠµŠ½ŠøŠµ] ŠŃŠ°ŃŠ“ŃŠµŠ¹Š» Šø ŠØŃŃŠ“ŃŠ¾Šæ. ŠŠøŃŃŃŠøŠ±ŃŃŃŠøŃ",
"allow_votes" => true, "percent_steem_dollars" => 10000,
"children_abs_rshares" => 0, "net_votes" => 6,
"author" => "dmilash", "curator_payout_value" => "4.296 GBG",
"permlink" => "re-litvintech-obyavlenie-kraudseil-i-sherdrop-distribyuciya-20161205t165002890z",
"url" => "/ru--kraudseijl/@litvintech/obyavlenie-kraudseil-i-sherdrop-distribyuciya#@dmilash/re-litvintech-obyavlenie-kraudseil-i-sherdrop-distribyuciya-20161205t165002890z",
"cashout_time" => "1969-12-31T23:59:59",
"parent_author" => "litvintech",
"allow_curation_rewards" => true, "vote_rshares" => 0,
"reward_weight" => 10000, "active_votes" => [], "depth" => 1,
"mode" => "second_payout", "abs_rshares" => 0,
"author_reputation" => "37110534901202"},
%{...},
...]
```
"""
@spec get_content_replies(String.t, String.t) :: map
def get_content_replies(author, permlink) do
call("get_content_replies", [author, permlink])
end
@doc"""
If start_permlink is empty then only before_date will be considered. If both are specified the earlier of the two metrics will be used.
before_date format is: `2017-02-07T14:34:11`
Example response:
```
ContentResult has the same shape as a result returned by get_content.
Example result:
```
[ContentResult, ContentResult, ...]
```
"""
@spec get_discussions_by_author_before_date(String.t, String.t, String.t, integer) :: map
def get_discussions_by_author_before_date(author, start_permlink, before_date, limit) do
call("get_discussions_by_author_before_date", [author, start_permlink, before_date, limit])
end
# UNKNOWN parse error
# @doc"""
# If start_permlink is empty then only before_date will be considered. If both are specified the earlier of the two metrics will be used.
# before_date format is: `2017-02-07T14:34:11`
# Example response:
# ```
# ContentResult has the same shape as a result returned by get_content.
# Example result:
# ```
# [ContentResult, ContentResult, ...]
# ```
# """
# @spec get_replies_by_last_update(String.t, String.t, String.t, integer) :: map
# def get_replies_by_last_update(author, start_permlink, before_date, limit) do
# call("get_replies_by_last_update", [author, start_permlink, before_date, limit])
# end
# ACCOUNTS
@doc"""
Returns account data. Accepts a list of up to 1000 account names
Example response:
```
[%{"recovery_account" => "cyberfounder", "posting_rewards" => 6041772,
"created" => "1970-01-01T00:00:00",
"last_bandwidth_update" => "2017-02-03T07:44:33",
"to_withdraw" => "5358033161499672",
"last_active_proved" => "1970-01-01T00:00:00", "withdraw_routes" => 0,
"last_account_update" => "2016-11-04T21:28:45",
"sbd_last_interest_payment" => "2017-01-15T11:19:27",
"json_metadata" => "{"created_at":"GENESIS","ico_address":"1FNnNWE3m4rsMWTaX76A4bN1uK4biERdVn","user_image":"https://habrastorage.org/files/6b3/db5/587/6b3db55871e04985821e4c453a30c60c.jpg"}",
"active_challenged" => false, "vesting_balance" => "0.000 GOLOS",
"last_vote_time" => "2017-02-03T07:44:33", "post_history" => [],
"blog_category" => %{}, "market_history" => [], "id" => "2.2.1993",
"vesting_shares" => "5405134010.995395 GESTS", "vote_history" => [],
"reset_account" => "null", "sbd_balance" => "12877.442 GBG",
"last_post" => "2017-02-03T07:42:09", "lifetime_vote_count" => 0,
"savings_sbd_last_interest_payment" => "1970-01-01T00:00:00",
"mined" => true, "owner_challenged" => false,
"vesting_withdraw_rate" => "51519549.629804 GESTS",
"active" => %{"account_auths" => [],
"key_auths" => [["GLS5vdTX6auUFyUwWEyzXAXhqo6LkCeCKAG2Tr9QaohRurcBouzHR",
1]], "weight_threshold" => 1}, "proxy" => "",
"posting" => %{"account_auths" => [],
"key_auths" => [["GLS574PtkDcrf5PE8QA8Uq1a4YLqer6vRT8WTgsxdYnx5LJDG7RCD",
1]], "weight_threshold" => 1}, "last_root_post" => "2017-02-02T13:37:45",
"savings_balance" => "0.000 GOLOS", "average_bandwidth" => 313586832,
"last_account_recovery" => "1970-01-01T00:00:00",
"next_vesting_withdrawal" => "2017-02-05T15:01:33", "can_vote" => true,
"owner" => %{"account_auths" => [],
"key_auths" => [["GLS6PturNHrX82R3b6ymKRksNWT9K3hPL377qGmgbwBn2W5zyZVtH",
1]], "weight_threshold" => 1},
"witness_votes" => ["aizensou", "aleksandraz", "arcange", "creator",
"dark.sun", "dervish0", "dr2073", "good-karma", "jesta", "kuna", "lehard",
...], "reputation" => "24178458603348", "post_count" => 615,
"last_owner_proved" => "1970-01-01T00:00:00",
"sbd_seconds_last_update" => "2017-02-03T06:17:15",
"memo_key" => "GLS8dEWEGYtZj8hvcm7NVZjQKy637F2UMUK9RMMJKW4TowPX7FWFS",
"name" => "hipster", "withdrawn" => "103039099259608",
"savings_withdraw_requests" => 0,
"reset_request_time" => "1969-12-31T23:59:59", "savings_sbd_seconds" => "0",
"last_owner_update" => "2016-10-18T11:19:12", ...},
%{...}]
```
"""
@spec get_accounts([String.t]) :: [map]
def get_accounts(accounts) when is_list(accounts) do
call("get_accounts", [accounts])
end
@doc"""
Returns block header data. Accepts block height.
Example response:
```
%{"extensions" => [], "previous" => "0000000000000000000000000000000000000000",
"timestamp" => "2016-10-18T11:01:48",
"transaction_merkle_root" => "0000000000000000000000000000000000000000",
"witness" => "cyberfounder"}
```
"""
@spec get_block_header(pos_integer) :: map
def get_block_header(height) do
call("get_block_header", [height])
end
@doc"""
Unsurprisingly returns a map with dynamic global propeties.
Example response:
```
%{"average_block_size" => 416, "confidential_sbd_supply" => "0.000 GBG",
"confidential_supply" => "0.000 GOLOS", "current_aslot" => 3112003,
"current_reserve_ratio" => 20000, "current_sbd_supply" => "504154.519 GBG",
"current_supply" => "96227889.854 GOLOS", "current_witness" => "on0tole",
"head_block_id" => "002f68ff4d75004b06539669e77ce6f5967c2afa",
"head_block_number" => 3107071, "id" => "2.0.0",
"last_irreversible_block_num" => 3107056,
"max_virtual_bandwidth" => "5986734968066277376",
"maximum_block_size" => 65536, "num_pow_witnesses" => 97,
"participation_count" => 128,
"recent_slots_filled" => "340282366920938463463374607431768211455",
"sbd_interest_rate" => 1000, "sbd_print_rate" => 10000,
"time" => "2017-02-03T12:20:09", "total_pow" => 148587,
"total_reward_fund_steem" => "69239.698 GOLOS",
"total_reward_shares2" => "1030808747260116624181406420498",
"total_vesting_fund_steem" => "95566422.906 GOLOS",
"total_vesting_shares" => "448830750142.483827 GESTS",
"virtual_supply" => "96509712.230 GOLOS", "vote_regeneration_per_day" => 40}
```
"""
@spec get_dynamic_global_properties() :: map
def get_dynamic_global_properties do
call("get_dynamic_global_properties", [])
end
@doc"""
Unsurprisingly returns a map with chain propeties.
Example result:
```
%{"account_creation_fee" => "1.000 GOLOS", "maximum_block_size" => 131072, "sbd_interest_rate" => 1000}
```
"""
@spec get_chain_properties() :: map
def get_chain_properties do
call("get_chain_properties", [])
end
@doc"""
Returns feed history
Example response:
```
%{"current_median_history" => %{"base" => "1.000 GBG",
"quote" => "0.559 GOLOS"}, "id" => "2.14.0",
"price_history" => [%{"base" => "1.379 GBG", "quote" => "1.000 GOLOS"},
%{"base" => "1.379 GBG", "quote" => "1.000 GOLOS"},
%{"base" => "1.379 GBG", "quote" => "1.000 GOLOS"},
%{"base" => "1.000 GBG", ...}, %{...}, ...]}
```
"""
@spec get_feed_history() :: map
def get_feed_history do
call("get_feed_history", [])
end
@doc"""
Returns node client config
Example response:
```
%{"STEEMIT_MINER_ACCOUNT" => "miners",
"STEEMIT_MIN_CONTENT_REWARD" => "1.500 GOLOS",
"STEEMIT_BLOCKCHAIN_HARDFORK_VERSION" => "0.14.0",
"STEEMIT_CURATE_APR_PERCENT" => 1937, "VESTS_SYMBOL" => "91621639407366",
"STEEMIT_MIN_LIQUIDITY_REWARD" => "1200.000 GOLOS",
"STEEMIT_1_PERCENT" => 100, "STEEMIT_PRODUCER_APR_PERCENT" => 750,
"STEEMIT_FEED_INTERVAL_BLOCKS" => 1200, "STEEM_SYMBOL" => "91600047785731",
"STEEMIT_MAX_MEMO_SIZE" => 2048, "STEEMIT_MAX_RATION_DECAY_RATE" => 1000000,
"STEEMIT_INIT_SUPPLY" => "43306176000", "STEEMIT_MAX_RUNNER_WITNESSES" => 1,
"STEEMIT_REVERSE_AUCTION_WINDOW_SECONDS" => 1800, "STEEMIT_MAX_MINERS" => 21,
"STEEMIT_VOTE_REGENERATION_SECONDS" => 432000,
"STEEMIT_MAX_SIG_CHECK_DEPTH" => 2, "STEEMIT_MAX_FEED_AGE" => "604800000000",
"STEEMIT_BLOCKS_PER_HOUR" => 1200,
"STEEMIT_VESTING_WITHDRAW_INTERVALS" => 104,
"STEEMIT_CONVERSION_DELAY" => "604800000000",
"STEEMIT_MAX_MINER_WITNESSES" => 1,
"STEEMIT_BANDWIDTH_AVERAGE_WINDOW_SECONDS" => 604800,
"STEEMIT_LIQUIDITY_REWARD_PERIOD_SEC" => 3600,
"STEEMIT_BLOCKS_PER_DAY" => 28800,
"STEEMIT_MAX_TIME_UNTIL_EXPIRATION" => 3600,
"STEEMIT_LIQUIDITY_TIMEOUT_SEC" => "604800000000",
"STEEMIT_MIN_BLOCK_SIZE_LIMIT" => 65536, "IS_TEST_NET" => false,
"STEEMIT_DEFAULT_SBD_INTEREST_RATE" => 1000,
"STEEMIT_MIN_ACCOUNT_CREATION_FEE" => 1, "STEEMIT_NULL_ACCOUNT" => "null",
"STEEMIT_MAX_ACCOUNT_WITNESS_VOTES" => 30,
"STEEMIT_MAX_VOTED_WITNESSES" => 19, "STEEMIT_MIN_UNDO_HISTORY" => 10,
"STEEMIT_ADDRESS_PREFIX" => "GLS",
"STEEMIT_HARDFORK_REQUIRED_WITNESSES" => 17,
"STEEMIT_CONTENT_APR_PERCENT" => 5813,
"STEEMIT_APR_PERCENT_SHIFT_PER_ROUND" => 83,
"STEEMIT_START_MINER_VOTING_BLOCK" => 200,
"STEEMIT_SECONDS_PER_YEAR" => 31536000,
"STEEMIT_MIN_PRODUCER_REWARD" => "1.000 GOLOS",
"STEEMIT_LIQUIDITY_REWARD_BLOCKS" => 1200,
"STEEMIT_CASHOUT_WINDOW_SECONDS" => 86400,
"GRAPHENE_CURRENT_DB_VERSION" => "GPH2.4", "STEEMIT_MINER_PAY_PERCENT" => 100,
"STEEMIT_MIN_LIQUIDITY_REWARD_PERIOD_SEC" => 60000000,
"STEEMIT_MINING_REWARD" => "1.000 GOLOS",
"STEEMIT_FREE_TRANSACTIONS_WITH_NEW_ACCOUNT" => 100, ...}
```
"""
@spec get_config() :: map
def get_config() do
call("get_config", [])
end
@doc"""
Returns current median history price.
Example response:
```
%{"base" => "1.000 GBG", "quote" => "0.559 GOLOS"}
```
"""
@spec get_current_median_history_price() :: map
def get_current_median_history_price() do
call("get_current_median_history_price", [])
end
# ACCOUNTS
@doc"""
Get account count
Example response: 25290
"""
@spec get_account_count() :: integer
def get_account_count() do
call("get_account_count", [])
end
@doc"""
Lookup accounts
Example response:
```
["razumnica", "razumova-l", "razvanelulmarin", "razved1", "razzewille", "rbaron", "rbc", "rbi", "rbrown", "rbur93"]
```
"""
def lookup_accounts(lower_bound_name, limit) do
call("lookup_accounts", [lower_bound_name, limit])
end
@doc"""
Returns list of maps of account data.
Example response:
```
[%{"recovery_account" => "cyberfounder", "posting_rewards" => 83462628,
"created" => "1970-01-01T00:00:00",
"last_bandwidth_update" => "2017-02-03T11:57:06", "to_withdraw" => 0,
"last_active_proved" => "1970-01-01T00:00:00", "withdraw_routes" => 0,
"last_account_update" => "2017-01-21T11:34:30",
"sbd_last_interest_payment" => "2017-01-15T23:43:00",
"json_metadata" => "{"created_at":"GENESIS","ico_address":"1B9Khkti2bBPccSoNj6aiFCYhq5Rq5GAMb","user_image":"https://avatars2.githubusercontent.com/u/4211840?v=3&u=97aeb67208068d457fad522a500b62f12908270c&s=400"}",
"active_challenged" => false, "last_vote_time" => "2017-02-03T11:57:06",
"id" => "2.2.6836", "vesting_shares" => "386381769.644947 GESTS",
"reset_account" => "null", "sbd_balance" => "917.535 GBG",
"last_post" => "2017-02-02T19:11:57", "lifetime_vote_count" => 0,
"savings_sbd_last_interest_payment" => "1970-01-01T00:00:00",
"mined" => true, "owner_challenged" => false,
"vesting_withdraw_rate" => "0.000001 GESTS",
"active" => %{"account_auths" => [],
"key_auths" => [["GLS8NV2JNwtcTSCDSJDgr69PFueGTvnvGC2F8HPSyUxFWrnp9ATY6",
1]], "weight_threshold" => 1}, "proxy" => "",
"posting" => %{"account_auths" => [],
"key_auths" => [["GLS6qg3gEEkSz4i1T9WpjSxjFrVc6fNEps1QpvxsDCMATiaL5aRzx",
1]], "weight_threshold" => 1}, "last_root_post" => "2017-02-01T18:17:09",
"savings_balance" => "0.000 GOLOS", "average_bandwidth" => 308637164,
"last_account_recovery" => "1970-01-01T00:00:00",
"next_vesting_withdrawal" => "1969-12-31T23:59:59", "can_vote" => true,
"owner" => %{"account_auths" => [],
"key_auths" => [["GLS6Ms4HrGMCPsq3yoytJc8TEKuQb1Bk9HRxjUSa3wtyhnpA4fJZV",
1]], "weight_threshold" => 1}, "post_count" => 421,
"last_owner_proved" => "1970-01-01T00:00:00",
"sbd_seconds_last_update" => "2017-02-03T08:48:15",
"memo_key" => "GLS5frWAw3yukawhSEnQ7zK7N1LWM77JzjJvzAZx5JRMgPkoddXTv",
"name" => "ontofractal", "withdrawn" => 0, "savings_withdraw_requests" => 0,
"reset_request_time" => "1969-12-31T23:59:59", "savings_sbd_seconds" => "0",
"last_owner_update" => "1970-01-01T00:00:00",
"proxied_vsf_votes" => [0, 0, 0, 0], "sbd_seconds" => "4489659344784",
"savings_sbd_balance" => "0.000 GBG", "post_bandwidth" => 10000,
"curation_rewards" => 5484048,
"pending_reset_authority" => %{"account_auths" => [], "key_auths" => [],
...}, "witnesses_voted_for" => 10, "comment_count" => 0, ...}]
```
"""
@spec lookup_account_names([String.t]) :: [map]
def lookup_account_names(account_names) do
call("lookup_account_names", [account_names])
end
@doc"""
Returns account operations history
Example response:
```
[[7817, %{"block" => 3107388, "id" => "2.17.1197661", "op" => ["vote", %{"author" => "vik", "permlink" => "dostupnyi-javascript-na-prikladnom-primere-sozdaniya-stranicy-saita-s-deistviyami-polzovatelei-golosa-v-realnom-vremeni", "voter" => "ontofractal", "weight" => 10000}], "op_in_trx" => 0, "timestamp" => "2017-02-03T12:36:06", "trx_id" => "dc866b17ba80fa0ca0fe283ca19ebea9193987bc", "trx_in_block" => 0, "virtual_op" => 0}], [7816, %{"block" => 3107390, "id" => "2.17.1197663", "op" => ["vote", %{"author" => "pro.bitcoin", "permlink" => "podkast-pro-bitkoin-samye-glavnye-novosti-iz-mira-kriptovalyut-vypusk-27", "voter" => "ontofractal", "weight" => 10000}], "op_in_trx" => 0, "timestamp" => "2017-02-03T12:36:12", "trx_id" => "a7ce75dcd43641edd498d77bb4a938c9cdeb7405", "trx_in_block" => 0, "virtual_op" => 0}]]
```
"""
@spec get_account_history(String.t, integer, integer) :: [map]
def get_account_history(name, from, limit) do
call("get_account_history", [name, from, limit])
end
@doc"""
Returns witness schedule
Example response:
```
%{"current_shuffled_witnesses" => ["litrbooh", "gtx-1080-sc-0015",
"vitaly-lvov", "aleksandraz", "on0tole", "dark.sun", "jesta", "someguy123",
"pmartynov", "primus", "litvintech", "phenom", "hipster", "good-karma",
"arcange", "serejandmyself", "kuna", "dr2073", "lehard", "testz", "xtar"],
"current_virtual_time" => "2359603129137518468300462851", "id" => "2.7.0",
"majority_version" => "0.14.2",
"median_props" => %{"account_creation_fee" => "1.000 GOLOS",
"maximum_block_size" => 131072, "sbd_interest_rate" => 1000},
"next_shuffle_block_num" => 3108273}
```
"""
@spec get_witness_schedule() :: map
def get_witness_schedule() do
call("get_witness_schedule", [])
end
@doc"""
Gets hardfork version
Example response: `"0.14.0"`
"""
@spec get_hardfork_version() :: String.t
def get_hardfork_version() do
call("get_hardfork_version", [])
end
@doc"""
Get next scheduled hardfork time
Example result: `%{"hf_version" => "0.0.0", "live_time" => "2016-10-18T11:00:00"}`
"""
@spec get_next_scheduled_hardfork() :: map
def get_next_scheduled_hardfork() do
call("get_next_scheduled_hardfork", [])
end
@doc"""
Get trending tags
Example result:
```
[
%{"comments" => 386, "id" => "5.4.29", "net_votes" => 16361,
"tag" => "golos", "top_posts" => 448,
"total_children_rshares2" => "263770002351940021381162037540",
"total_payout" => "1210679.260 GBG"},
%{"comments" => 0, "id" => "5.4.6338", "net_votes" => 59,
"tag" => "golos-io", "top_posts" => 1,
"total_children_rshares2" => "7597368466598778563409",
"total_payout" => "1533.724 GBG"},
%{"comments" => 1, "id" => "5.4.741", "net_votes" => 39,
"tag" => "golos-soft", "top_posts" => 2,
"total_children_rshares2" => "87745768291122276983586401",
"total_payout" => "12.812 GBG"},
...]
```
"""
@spec get_trending_tags(String.t, integer) :: [map]
def get_trending_tags(after_tag, limit) do
call("get_trending_tags", [after_tag, limit])
end
@doc"""
Get discussions by the wanted metric. Accepts a metric atom and a map with a following query params: %{tag: `String.t`, limit: `integer`}
ContentResult has the same shape as a result returned by get_content.
Example result:
```
[ContentResult, ContentResult, ...]
```
"""
@spec get_discussions_by(atom, map) :: [map]
def get_discussions_by(metric, query) do
method = "get_discussions_by_" <> Atom.to_string(metric)
call(method, [query])
end
@doc"""
Get state for the provided path.
Example result:
```
%{
"accounts" => ...,
"categories" => ...,
"category_idx" => ...,
"content" => ...,
"current_route" => ...,
"discussion_idx" => ...,
"error" => ...,
"feed_price" => ...,
"pow_queue" => ...,
"props" => ...,
"witness_schedule" => ...,
"witnesses" => ... }
```
"""
@spec get_state(String.t) :: map
def get_state(path) do
call("get_state", [path])
end
@doc"""
Get categories. Accepts wanted metric, after_category, limit.
Example result:
```
%{
"accounts" => ...,
"categories" => ...,
"category_idx" => ...,
"discussion_idx" => ...,
"error" => ...,
"feed_price" => ...,
"pow_queue" => ...,
"props" => ...,
"witness_schedule" => ...,
"current_virtual_time" => ...,
"id" => ...,
"majority_version" => ...,
"median_props" => ...,
"next_shuffle_block_num" => ...,
"witnesses" => ... }
```
"""
@spec get_categories(atom, String.t, integer) :: [map]
def get_categories(metric, after_category, limit) do
method = "get_" <> Atom.to_string(metric) <> "_categories"
call(method, [after_category, limit])
end
@doc"""
Gets current GBG to GOLOS conversion requests for given account.
Example result:
```
[%{"amount" => "100.000 GBG", "conversion_date" => "2017-02-17T18:59:42",
"id" => "2.15.696", "owner" => "ontofractal", "requestid" => 1486753166}]
```
"""
@spec get_conversion_requests() :: [map]
def get_conversion_requests() do
call("get_conversion_requests", ["ontofractal"])
end
@doc"""
Returns past owner authorities that are valid for account recovery.
Doesn't seem to work at this moment.
```
```
"""
@spec get_owner_history(String.t) :: [map]
def get_owner_history(name) do
call("get_owner_history", [name])
end
@doc"""
Returns order book.
## Example response
```
%{"asks" => [%{"created" => "2017-02-10T18:19:24",
"order_price" => %{"base" => "250.000 GOLOS",
"quote" => "555.975 GBG"},
"real_price" => "2.22389999999999999", "sbd" => 549152,
"steem" => 246932},...],
"bids" => [%{...}, ...]
```
"""
@spec get_order_book(integer) :: [map]
def get_order_book(limit) do
call("get_order_book", [limit])
end
@doc"""
Returns open orders for the given account name.
## Example response
```
[
%{ "created" => "2017-02-10T19:49:36",
"expiration" => "1969-12-31T23:59:59", "for_sale" => 6280,
"id" => "2.13.1890", "orderid" => 1486756162,
"real_price" => "2.00000000000000000", "rewarded" => false,
"sell_price" => %{"base" => "6.280 GBG",
"quote" => "3.140 GOLOS"}, "seller" => "ontofractal"},
...]
```
"""
@spec get_open_orders(String.t) :: [map]
def get_open_orders(name) do
call("get_open_orders", [name])
end
@doc"""
Get witnesses by ids
## Example response
```
[%{"created" => "2016-10-18T11:21:18",
"hardfork_time_vote" => "2016-10-18T11:00:00",
"hardfork_version_vote" => "0.0.0", "id" => "2.3.101",
"last_aslot" => 3323895, "last_confirmed_block_num" => 3318746,
"last_sbd_exchange_update" => "2017-02-09T06:10:33",
"last_work" => "0000000000000000000000000000000000000000000000000000000000000000",
"owner" => "hipster", "pow_worker" => 0,
"props" => %{"account_creation_fee" => "1.000 GOLOS",
"maximum_block_size" => 65536, "sbd_interest_rate" => 1000},
"running_version" => "0.14.2",
"sbd_exchange_rate" => %{"base" => "1.742 GBG",
"quote" => "1.000 GOLOS"},
"signing_key" => "GLS6oRsauXhqxhpXbK3dJzFBGEWVoX6BjVT5z8BwNzgV38DzFat9E",
"total_missed" => 10,
"url" => "https://golos.io/ru--delegaty/@hipster/delegat-hipster",
"virtual_last_update" => "2363092957490310521961963807",
"virtual_position" => "186709431624610119071729411416709427966",
"virtual_scheduled_time" => "2363094451567901047152350987",
"votes" => "102787791122912956"},
%{...} ]
```
"""
# FIXME: broken, investigate why
# @spec get_witnesses([String.t]) :: [map]
# def get_witnesses(ids) do
# call("get_witnesses", [ids])
# end
@doc"""
Get witnesses by votes. Example response is the same as get_witnesses.
"""
@spec get_witnesses_by_vote(integer, integer) :: [map]
def get_witnesses_by_vote(from, limit) do
call("get_witnesses_by_vote", [from, limit])
end
@doc"""
Lookup witness accounts
Example response:
```
["creator", "creatorgalaxy", "crypto", "cryptocat", "cyberfounder", "cybertech-01", "d00m", "dacom", "dance", "danet"]
```
"""
@spec lookup_witness_accounts(String.t, integer) :: [String.t]
def lookup_witness_accounts(lower_bound_name, limit) do
call("lookup_witness_accounts", [lower_bound_name, limit])
end
@doc"""
Get witness count
Example response: `997`
"""
@spec get_witness_count() :: [String.t]
def get_witness_count() do
call("get_witness_count", [])
end
@doc"""
Get active witnesses
Example response:
```
["primus", "litvintech", "yaski", "serejandmyself", "dark.sun", "phenom",
"hipster", "gtx-1080-sc-0048", "lehard", "aleksandraz", "dr2073", "smailer",
"on0tole", "roelandp", "arcange", "testz", "vitaly-lvov", "xtar", "anyx",
"kuna", "creator"]
```
"""
@spec get_active_witnesses() :: [String.t]
def get_active_witnesses() do
call("get_active_witnesses", [])
end
@doc"""
Get miner queue
Example response:
```
["gtx-1080-sc-0083", "gtx-1080-sc-0016", "gtx-1080-sc-0084", "gtx-1080-sc-0017",
"gtx-1080-sc-0085", "gtx-1080-sc-0018", "penguin-11", "gtx-1080-sc-0028",
"gtx-1080-sc-0023", "gtx-1080-sc-0080", ...]
```
"""
@spec get_miner_queue() :: [String.t]
def get_miner_queue() do
call("get_miner_queue", [])
end
@doc"""
Get *all* account votes
Example response:
```
[%{"authorperm" => "rusldv/programmiruem-na-php-vvedenie", "percent" => 10000,
"rshares" => 130036223, "time" => "2017-01-26T20:06:03", "weight" => 0},
%{...}, ...] ```
"""
@spec get_account_votes(String.t) :: [map]
def get_account_votes(name) do
call("get_account_votes", [name])
end
@doc"""
Get active votes on the given content. Accepts author and permlink.
Example response:
```
[%{"percent" => 6900, "reputation" => "28759071217014",
"rshares" => "18897453242648", "time" => "2017-01-27T09:20:21",
"voter" => "hipster", "weight" => "51460692508758354"},
%{...}, ...] ```
"""
@spec get_active_votes(String.t, String.t) :: [map]
def get_active_votes(account, permlink) do
call("get_active_votes", [account, permlink])
end
@doc"""
Get followers. Accepts account, starting follower, follow type (blog, ignore), limit of results.
Returns followers in ascending alphabetical order.
Example response:
```
%{"follower" => "aim", "following" => "academy",
"id" => "8.0.21098", "what" => ["blog"]},
%{"follower" => "aleco", "following" => "academy",
"id" => "8.0.20183", "what" => ["blog"]},
%{...}, ...] ```
"""
@spec get_followers(String.t, String.t, String.t, integer) :: [map]
def get_followers(account, start_follower, follow_type, limit) do
Golos.call(["follow_api", "get_followers", [account, start_follower, follow_type, limit]])
end
@doc"""
Get followings. Accepts account, starting following, follow type (blog, ignore), limit of results.
Returns followings in ascending alphabetical order.
Example response is the same as in get_followers.
"""
@spec get_following(String.t, String.t, String.t, integer) :: [map]
def get_following(account, start_follower, follow_type, limit) do
Golos.call(["follow_api", "get_following", [account, start_follower, follow_type, limit]])
end
end