https://www.npmjs.com/package/steem-js-patched
So first I want to say that this post is to clarify the steemjs Lack of information documentation, it's not understandable to know what I need to do, let's take an example:
there is literally no explanation... I can't understand from here what to do...
A quick notifier, I will go on the most useful functions and not all over the documentation [but I will go on most of the documentation functions]
so let's get started with the tutorial!
we will use the CDN, go to your HTML file and add this script -
<script src="//cdn.steemjs.com/lib/latest/steem.min.js>
if you want go to CDN and right click "Save Page As" steem.min.js
and move it to your js folder and use the script like that
<script src="javascript/steem.min.js"></script>
first, go to your nodejs project folder,
open the console and install steem
npm install steem --save
now open your javascript file and add steem API,
var steem = require('steem');
steem.api.setOptions({ url: 'https://api.hive.blog' });
you can use any RPC node, if you're using sites like golos, weku, whaleshares etc.
you can set the API RPC node to this sites as well.
steem.config.set('address_prefix','STM');
for example on other sites like weku it will be WKU or on WhaleShares WLS etc.
steem.config.set('chain_id','782a3039b478c839e4cb0c941ff4eaeb7df40bdd68bd441afd444b9da763de12');
this is the chain id of golos, this is to use other steem clones like golos, weku, whaleshares and more...
it's not really used on steem, so know that.
get trending tags
steem.api.getTrendingTags(afterTag, limit, function(err, result) {
console.log(err, result);
});
so let's find what does it do,
afterTag - is the tag it's starting from, for example, if I start from steemit which is the popular one it will give from there and lower,
or for example, I will start with photography it will give from there and lower, the popularity made by the total payouts, comments, and top posts.
example for usage:
steem.api.getTrendingTags('hive', 5, function(err, result) {
console.log(err, result);
});
the tag I'm using - hive, limit - 5
results -
as you can see it sorting it by the trending,
hive trending - 1146.021 HBD
hive-132971 trending - 1123.536 HBD
etc.
from what it looks the trending is calculating from the top posts, net votes and total payouts with an exclusive calculation of steem and we get from that the popular tags.
steem.api.getDiscussionsByTrending({tag: 'photography', limit: 1}, function(err, result) {
console.log(err, result);
});
steem.api.getDiscussionsByCreated({tag: 'photography', limit: 1}, function(err, result) {
console.log(err, result);
});
steem.api.getDiscussionsByHot({tag: 'photography', limit: 1}, function(err, result) {
console.log(err, result);
});
all is the same just getting the post from trending or created or hot feed.
that's all the change, the query stays the same
so first, results
so you need to choose a tag to get the posts from, I used photography and a limit for the number of posts,
I chose 1 because I don't need anymore.
and from there you can do what you want to do!
steem.api.getState('/@lonelywolf', function(err, result) {
console.log(err, result);
});
so from here, you can get literally any information,
from the post feed to the main witness and more...
just get the link you want to check, for example - /@lonelywolf/transfers and check it.
get the full config of the hive blockchain
steem.api.getConfig(function(err, result) {
console.log(err, result);
});
result -
steem.api.getDynamicGlobalProperties(function(err, result) {
console.log(err, result);
});
this function gives you the global properties of the blockchain, for example -
the supply, the latest block number, the current witness working on the block, the total vests and more...
result -
steem.api.getChainProperties(function(err, result) {
console.log(err, result);
});
this function gives the creation fee per account,
the maximum block size,
the sbd interest rate,
the budget & decay.
result -
steem.api.getCurrentMedianHistoryPrice(function(err, result) {
console.log(err, result);
});
this function gives the average/value of the hbd/hive rate.
I didn't use this function so much so I can't tell 100% surly what it gives at the result.
result -
steem.api.getHardforkVersion(function(err, result) {
console.log(err, result);
});
gives the version of hive
result - 0.23.0
steem.api.getRewardFund('post', function(err, result) {
console.log(err, result);
});
this function gives the reward fund of the post, I didn't found anything else, it's giving the reward fund of posts
it's useful for calculation of steem power (vesting to SP) for example and much more
result -
steem.api.getVestingDelegations(`ocdb`, ``, 50, function(err, result) {
console.log(err, result);
});
result -
steem.api.getAccounts(['lonelywolf'], function(err, result) {
console.log(err, result);
});
so because this function get multiple accounts we need to give it a json object, so put ['account'] and not 'account'
you can add as many accounts as you want.
it gives all of the information about the account, from name to last votes, mana reputation and more...
this is the most useful function on hive API.
steem.api.getAccountCount(function(err, result) {
console.log(err, result);
});
this function gives the count of all of the accounts on steem
result - 1,376,722 [raw result - 1376722]
//steemjs documentation
steem.api.getAccountHistory(account, from, limit, function(err, result) {
console.log(err, result);
});
//usage version
steem.api.getAccountHistory('lonelywolf', -1, 100, function(err, result) {
console.log(err, result);
});
account - your account name (or the one you want to see in), from (the first transaction), limit (the limit of the transactions)
the data of the transaction stored in the op object.
steem.api.getOrderBook(1, function(err, result) {
console.log(err, result);
});
this function gives the latest orders on the market by limit 1 - limit change 1 to any limit you want.
steem.api.getOpenOrders('lonelywolf', function(err, result) {
console.log(err, result);
});
this function gives the open orders on the market by account name,
//doc version
steem.api.getActiveVotes(account ,permlink, function(err, result) {
console.log(err, result);
});
//usage version
steem.api.getActiveVotes('lonelywolf' , 'my-only-problem-with-hive-and-how-it-compares-to-steem', function(err, result) {
console.log(err, result);
});
account - account name
permlink - the permlink of the post, comes after your account name (
@account_name_here/bla-bla-blaaa
this function gives the active votes of the post you entered.
result -
// doc version
steem.api.getAccountVotes(voter, function(err, result) {
console.log(err, result);
});
//usage verison
steem.api.getAccountVotes('lonelywolf', function(err, result) {
console.log(err, result);
});
this function gets the votes of a specific account
//doc version
steem.api.getContent(author, permlink, function(err, result) {
console.log(err, result);
});
//usage version
steem.api.getContent('lonelywolf', 'my-only-problem-with-hive-and-how-it-compares-to-steem', function(err, result) {
console.log(err, result);
});
author - the account author, the creator of the post/comment
permlink - the permlink of the post / comment [ example in the code / above ]
this function gives the post details, from the author to the title, body and much more...
result -
//doc version
steem.api.getContentReplies(author, permlink, function(err, result) {
console.log(err, result);
});
//usage version
steem.api.getContentReplies('lonelywolf', 'my-only-problem-with-hive-and-how-it-compares-to-steem', function(err, result) {
console.log(err, result);
});
this function gives all of the replies(comments) of the post with all of the details (voters, payout, etc.).
steem.api.getWitnessByAccount('someguy123', function(err, result) {
console.log(err, result);
});
use by account name, this function gives the witness information.
steem.api.getWitnessCount(function(err, result) {
console.log(err, result);
});
get the amount of witnesess on steemit
result - 14,890 [Raw result - 14890]
steem.broadcast.delegateVestingShares(wif, delegator, delegatee, vesting_shares, function(err, result) {
console.log(err, result);
});
wif - the active wif key, used to send a delegation, use the market, send transfers and more...
delegator - the account that sent the delegation
delegatee - the account that gets the delegation
vesting_shares - the number of vests you send
steem.broadcast.accountWitnessVote(wif, account, witness, approve, function(err, result) {
console.log(err, result);
});
wif - the active wif key
account - the account that is voting (your account)
witness - the witness account (the one that gets the vote)
approve - the state of the approve (1 to approve, 0 to not approve) [1 = vote, 0 = unvote]
steem.broadcast.comment(wif, parentAuthor, parentPermlink, author, permlink, title, body, jsonMetadata, function(err, result) {
console.log(err, result);
});
wif - your posting wif key
parentAuthor - the "parent" author, if it's a comment the parentAuthor will be the author of the post, if it's a post leave blank
parentPermlink - same as parentAuthor just with permlink.
author - the author (the account creating the post / comment)
permlink - the permlink of the comment / post (create new permlink, you can use a random function that will make a custom number or something like that for the permlink)
title - the title of the comment / post
jsonMetadata - the json metdata, most of the times is the same :
JSON.stringify({
tags: "hive",
app: 'hive/0.1',
users: ["lonelywolf"],
format: "markdown"
}),
tags - the tags of the post / comment
app - the application used, leave steemit/0.1 if you're not a "company" or something like that
'users' - the user made the post/comment, just leave your own name, you can remove this line if you don't want it (it's not necessary)
format - the format of the post/comment (leave markdown)
steem.broadcast.customJson(wif, requiredAuths, requiredPostingAuths, id, json, function(err, result) {
console.log(err, result);
});
this function used most for following and stuff like that
wif - the posting wif key
requiredAuths - which auths needed, for following, for example, nothing is required (use for the active key, if needed to transfer or something like that)
requiredPostingAuths - the posting auths needed, for following is follower
id - the identifier of the customJson, for follow we use follow
json - the json object for the function
follow example using customJson -
/** Follow an user */
var follower = 'lonelywolf'; // Your username
var following = 'someguy123'; // User to follow
var json = JSON.stringify(
['follow', {
follower: follower,
following: following,
what: ['blog']
}]
);
steem.broadcast.customJson(
postingWif,
[], // Required_auths
[follower], // Required Posting Auths
'follow', // Id
json, //
function(err, result) {
console.log(err, result);
}
);
follower - the follower account (your account)
following - the follow after account (the other account)
what - the identifier of the follower (which is a blog)
then we're using the customjson function to follow the account.
steem.broadcast.deleteComment(wif, author, permlink, function(err, result) {
console.log(err, result);
});
wif - the account posting wif key
author - the author of the post/comment, the creator
permlink - the permlink of the post / comment
steem.broadcast.vote(wif, voter, author, permlink, weight, function(err, result) {
console.log(err, result);
});
wif - the posting wif key
voter - the voter account, the account that is voting
author - the author of the post (the post creator)
permlink - the permlink of the post
weight - the weight of the vote, max is 10000(10k), so to make it easier just do that: 10*100 (10 = percentage), max = 100%
//doc usage
var steemPower = steem.formatter.vestToSteem(vestingShares, totalVestingShares, totalVestingFundSteem);
//real usage
steem.api.getDynamicGlobalProperties((err, result) => {
var steemPower = steem.formatter.vestToSteem(500000, result.total_vesting_shares, result.total_vesting_fund_steem);
console.log(steemPower);
});
this function gets the vests and the global properties and converts it to Steem power.
Guys, it was really painful to get all of the non-clarified functions to be clarified to use if you struggling with anything let me know in the comments and I will help you and update the post.
if you have any suggestions to add to this post comment down, I will add it to the post!
hope I helped you!