I was studying about EOS RAM Allocation, CPU and NET bandwith and I was wondering about how much it costs to organize a real airdrop. So I just came up with this small experiment in Jungle testnet which can be totally adapted to Mainnet, because the storage and bandwith are the same you can just adjust the current EOS and RAM prices.
It's actually super simple to Airdrop a token in EOS <3
- Create an account for your smart contract
- Download the official
eosio.tokenfrom eos repository - Compile and deploy it to your contract
- Create your token symbol and supply
- Start issuing tokens
I'm going to cover all the above steps below, let's go!
Getty Images
Default Account creation on Junglenet
Created account eosairdroper from http://dev.cryptolions.io/#account
Here's the initial account balance and stake stats:
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 3.365 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 0 bytes
available: 19.29 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 0 us
available: 3.862 sec
limit: 3.862 sec
Deploying the eosio.token contract
Simple deploy from original EOS Repo without any changes:
$ cleos set contract eosairdroper ~/eos/build/contracts/eosio.token ~/eos/build/contracts/eosio.token/eosio.token.wast ~/eos/build/contracts/eosio.token/eosio.token.abi
Reading WAST/WASM...
Assembling WASM...
Publishing contract...
executed transaction: d4025c7627d3a8334451ca382be86867eed55f2a442205ac269db8d4228554ca 8496 bytes 3203 us
# eosio <= eosio::setcode {"account":"eosairdroper","vmtype":0,"vmversion":0,"code":"0061736d01000000017e1560037f7e7f0060057f7...
# eosio <= eosio::setabi {"account":"eosairdroper","abi":"0e656f73696f3a3a6162692f312e30010c6163636f756e745f6e616d65046e616d6...
# >>>> checking account stats <<<<
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 189.7 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 8.298 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 1.817 ms
available: 3.86 sec
limit: 3.862 sec
Balance stats:
- Used RAM: 186.335 Kb (From 3.365 Kb, To 189.7 Kb)
- Used NET: 8.298 Kb (From 0 Kb, To 8.298 Kb)
- Used CPU: 1.817 ms (From 0 ms, To 1.817 ms)
Yeah, the cost to deploy eosio.token is 186.335 Kb with today's version! Ok, the fun begins... Let's create a token!
Creating a token
Default token, 1 billion supply and four decimals exactly like EOS.
$ cleos push action eosairdroper create '[ "eosairdroper", "1000000000.0000 TOKEN", 0, 0, 0]' -p eosairdroper
executed transaction: 7123c8e34853205b9176a8d02526a570f32e908212f0a3eff7e9dd9544803101 120 bytes 738 us
# eosairdroper <= eosairdroper::create {"issuer":"eosairdroper","maximum_supply":"1000000000.0000 TOKEN"}
# >>>> checking account stats <<<<
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 190 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 8.314 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 2.656 ms
available: 3.859 sec
limit: 3.862 sec
Balance stats:
- Used RAM: 0.3 Kb (From 189.7 Kb, To 190 Kb)
- Used NET: 0.016 Kb (From 8.298 Kb, To 8.314 Kb)
- Used CPU: 0.839 ms (From 1.817 ms, To 2.656 ms)
Neat! To create a token we spent very little resources, almost nothing...
Issuing some Tokens
Now let's airdrop some tokens!
I'm using some random accounts from the official snapshot (sorry if you are one of them):
| account | snapshot balance |
|---|---|
| gm4domrtgqge | 12.6521 EOS |
| gu2dkmztgage | 606.0000 EOS |
| gu2dgmrrguge | 6233.0000 EOS |
| gu2dgmrshege | 15000.9383 EOS |
| ge3tgmzxhege | 172150.0000 EOS |
cleos push action eosairdroper issue '["gu2dgmrshege", "15000.9383 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: f81bf85f5fe51e2bb78e8f3398e384b17587d1abb21255ca4e5dc64874fac263 128 bytes 2467 us
# eosairdroper <= eosairdroper::issue {"to":"gu2dgmrshege","quantity":"15000.9383 TOKEN","memo":"airdrop"}
# eosairdroper <= eosairdroper::transfer {"from":"eosairdroper","to":"gu2dgmrshege","quantity":"15000.9383 TOKEN","memo":"airdrop"}
# gu2dgmrshege <= eosairdroper::transfer {"from":"eosairdroper","to":"gu2dgmrshege","quantity":"15000.9383 TOKEN","memo":"airdrop"}
cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 190.2 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 8.346 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 3.787 ms
available: 3.858 sec
limit: 3.862 sec
Balance stats:
- Used RAM: 0.2 Kb (From 190 Kb, To 190.2 Kb)
- Used NET: 0.032 Kb (From 8.314 Kb, To 8.346 Kb)
- Used CPU: 1.131 ms (From 2.656 ms, To 3.787 ms)
More Tokens Issuing
cleos push action eosairdroper issue '["gu2dgmrrguge", "6233.0000 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: 26a0477eaa5147e454a0a2c4c436ae5d4b356deddc303d4a0ad43108c3480307 128 bytes 2122 us
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 190.4 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 7.506 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 5.567 ms
available: 3.856 sec
limit: 3.862 sec
$ cleosjn push action eosairdroper issue '["gu2dkmztgage", "606.0000 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: a642adfaf2a715e7bf9a8ecb2d9f8cd1cbc4925ffb7edbbbe1c78b77383de487 128 bytes 2291 us
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 190.7 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 7.443 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 7.719 ms
available: 3.854 sec
limit: 3.862 sec
cleos push action eosairdroper issue '["gm4domrtgqge", "12.6521 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: 6a9695ba0508bb967b08341794ba49a597276971d2c34f7178a06db089b39943 128 bytes 2326 us
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 190.9 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 7.561 Kb
available: 19.28 Mb
limit: 19.29 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 9.026 ms
available: 3.853 sec
limit: 3.862 sec
After 6 Hours sleep ZzZzz
It looked like my net and cpu bandwith has reduced a little bit, perfect!
$ cleos push action eosairdroper issue '["ge3tgmzxhege", "172150.0000 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: 704ba42b779cbb7a77ca0160511c7178117c65700ec2da40f0579e3ecdaa6594 128 bytes 2375 us
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 191.2 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 6.129 Kb
available: 19.2 Mb
limit: 19.2 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 9.543 ms
available: 3.835 sec
limit: 3.845 sec
Big airdrop to B1
Testing a big amount Airdrop to b1 (not that they need it lol - usually this would go to the Airdrop team):
$ cleos push action eosairdroper issue '["b1", "100000000.0100 TOKEN", "airdrop"]' -p eosairdroper
executed transaction: 8458b5f23d6764333db5ba2d8133cabe65265abf6ecf674810a8eb1de05e25f7 128 bytes 2540 us
# eosairdroper <= eosairdroper::issue {"to":"b1","quantity":"100000000.0100 TOKEN","memo":"airdrop"}
# eosairdroper <= eosairdroper::transfer {"from":"eosairdroper","to":"b1","quantity":"100000000.0100 TOKEN","memo":"airdrop"}
# b1 <= eosairdroper::transfer {"from":"eosairdroper","to":"b1","quantity":"100000000.0100 TOKEN","memo":"airdrop"}
$ cleos get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 191.4 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 6.22 Kb
available: 19.2 Mb
limit: 19.2 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 11.66 ms
available: 3.833 sec
limit: 3.845 sec
No Memo
Testing an airdrop with no memo to another random account ge3dmgenesis: 1000.5425 EOS - it reduced from 128 bytes to 120 bytes of net bandwith usage, no significative changes in cpu and didn't affect anything on RAM, AT ALL - Remember, from the eosio.token contract we don't store the memo anywhere.
cleos push action eosairdroper issue '["ge3dmgenesis", "1000.5425 TOKEN", ""]' -p eosairdroper
executed transaction: 34d05c59c10049ae946ad4e66703bb42987d1a1ce248115f3bea4bb6b1120e7f 120 bytes 2387 us
$ cleosjn get account eosairdroper
permissions:
owner 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
active 1: 1 EOS84uT4DBAJQpagWDfZPbk2hd9aaH8ZGZUxHTrpdjCqCzMEVP8cB
memory:
quota: 623.2 Kb used: 191.6 Kb
net bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 6.275 Kb
available: 19.2 Mb
limit: 19.2 Mb
cpu bandwidth:
staked: 100.0000 EOS (total stake delegated from account to self)
delegated: 0.0000 EOS (total staked delegated to account from others)
used: 13.22 ms
available: 3.831 sec
limit: 3.845 sec
Results
If we assume the above values as an approximated average (I would need to load a batch of a couple thousands accounts to make sure), these are the stats that we will need for a full airdrop based on the official mainnet launch snapshot:
| Stat | Avg / tx | Total 163,930 Accounts |
|---|---|---|
| Net Bandwith | 128 bytes | 20.98 Mb |
| Cpu Bandwith | ~2.36 ms | 386.87 sec |
| RAM | 0.229 kb | 37,540 kb |
You will eventually want to remove some accounts like B1, exchanges and so on from the airdrop.
Also these are other interesting stats from the genesis snapshot:
| Minimum EOS Balance | Number of Accounts |
|---|---|
| 0.0000 EOS | 163,930 |
| 1.0000 EOS | 162,106 |
| 5.0000 EOS | 148,624 |
| 10.0000 EOS | 137,950 |
| 100.0000 EOS | 84,979 |
Mainnet
As of today's date, a couple hours ago we had an account creation with a RAM price of 0.015 EOS/Kb.
So if you are planning an Airdrop now, with the official genesis snapshot it would cost
around ~563 EOS, which right now translates to $6025.17 (USD). I'm not considering the net and cpu because it fully restores in 3 days, you could separate your airdrop in blocks.
My next step is to run a big batch of thousands of tokens issuing transactions so I can prove all of these stats are correct.
Also a BIG THANK YOU to @nsjames, @syedjafri and @blockliberty for the nice insights, discussions and prices! And of course to this amazing Jungle Testnet @cryptolions
**EDIT: Follow up article released: https://steemit.com/eos/@leordev/eos-ram-and-bandwith-analysis-2-tokens-claiming-and-achieving-zero-cost-airdrop **
Once people claim their tokens you get the ram back
Dan, thanks a lot for your input, it means A LOT to me!
So, that's something that I'm discussing with other fellas... What means "people claim"? I'm already engaged to create a
claimaction and setup a claim table (intermediary), so when people claim their airdrop I would just transfer from my contract account to the claimer account setting the claimer as the payer.Am I missing something? It's already
out-of-the-boxon theissueaction? Because it does not look like as the issuer is thepayer.The existing code,
auto to = to_acnts.find( value.symbol.name() ); if( to == to_acnts.end() ) { to_acnts.emplace( ram_payer, [&]( auto& a ){ a.balance = value; }); } else { to_acnts.modify( to, 0, [&]( auto& a ) { a.balance += value; }); }This means that should the receiver not be pre-existing in the table with the corresponding symbol then the sender pays the RAM cost to create a record to do so.
What if we created a preexisting record where there was a 'register' method which allowed anyone to call it and create an empty record in the to_acnts table, with a balance of 0.0000.
Then, your own computer can listen for such action, check if they're on the airdrop list, and then trigger a transfer action, transferring the tokens to the receiver without such RAM cost.
This wouldn't cast the net as wide as one would like as not every planned recipient would hit this 'register' action, however, you could have an 'Airdrop period' where if you do his this action, you're guaranteed to get the token early/day 1, if you don't, then you'll have to wait a little longer.
hey @johnwilliamson nice idea buddy! with that we don't even need an intermediary table! it looks perfect! I'm still waiting for @dan answer because I don't want to redo any job if he tell us that they are planning or working in something of
eosio.tokento claim tokens already!That would mean the tokens are effectively moved from the smart contract account to the users account? or the user just pay the RAM used for his row in the smart contract?
Yes. This would have happened anyway once a user moves the tokens, however, if the airdropper doesn't want to pay that upfront cost initially or doesn't have enough confidence that those who receive the tokens will move them quick enough they can look into using this solution.
I am confused about this as well, because in the
eosio.tokencontract, theissuerpays for the new tokens storage. Even if you issued to a middleman account, the sender (from) always pays for storage, correct? @leordev I would love to be apart of this discussion with you and your team. I am also thinking about how theeosio.tokencontract is implemented on the mainnet and how we can create our own tokens using this contract.sure man, just hit me up at telegram @leordev - I will be glad to help!
is there any guides to be a block producer?
I just saw your post on stack exchange as well. Thanks for this super useful information.
Eos updates are still being posted on Steem Blockchain........ When will you update us on 2.0? @dan
nice! but if people never claim, can sender rescind tokens sent to restore ram?
probably burn it after some period? so only active users get it
Good work. The number of Airdrops on this chain will be astonishing .
Jungle is the best!!!
Thank you! This has been a hot question for a while.
I was able to update my response here: https://eosio.stackexchange.com/questions/679/what-are-the-staking-requirements-to-launch-an-airdrop
If anyone's interested in the awesome EOS Jobs that are out there, I compiled some of the best telegram posts:
https://steemit.com/eos/@natp/amazing-jobs-available-on-eos-right-now
I've also got an Ultimate Dev Link Guide for everything that's out there:
https://steemit.com/eos/@natp/ultimate-eos-developer-link-guide
Thanks very much for your effort in putting it together my friend! I appreciate your feedback!
No problem! You may want to add this amazing tool: https://acoutts.com/eos/ by EOS New York
SC: https://github.com/eosnewyork/erp
Great write up. Now I need to get up and running so I drop a token while RAM is cheap :p
I was going to ask you a question here but it is probably better for the SE, https://eosio.stackexchange.com/questions/898/get-cleos-without-building-eos
Know of any good instructions for installing
cleoson Ubuntu without building a node?How I vote and use
cleoson Docker: https://steemit.com/eos/@tiktuk/fast-and-secure-eos-block-producer-voting-with-cleos-in-docker No compilation or node needed.I think they already answered you, you have an option to go with docker... I didn't have time to see it yet because I compile the whole eos build in my machine... Thanks my friend!
Would like to know this also.
Although i will probably just upgrade my RAM to 8Gb and compile and run a node...
Thank you @leordev, for putting this together! Awesome job! Many thanks also to @nsjames, @syedjafri and @blockliberty ... re-steemed!
Nice work Leo ! Very interesting statistics!
Nice work @leordev. I am building a service that provides useful stats on resource prices here (EOS Resource Planner): https://acoutts.com/eos
Eventually it will be moved to a dedicated domain, but feel free to help contribute as it's open source: https://github.com/acoutts/erp
GOSH! This is amazing my friend!!! Congratulations for that, nice tool over there! I love the UI!
Hi @ff810000, I'm searching for a chart of the RAM price. Are you looking forward to implement that? If not do you know where else I can find this info?
btw Great Job on the design :)
cheers
Smart....... Do you have video tutorials on this and are you working on any project currently?
He's working on KARMA :)
Cool
and he is also working with us as at BeSpiral <3
Wow
Thank you @leordev, as well as @nsjames and @syedjafri.
This really helps.
Fantastic post. We are prepping for a summer launch + airdrop. Posts like these make me so excited for 2018 and EOS. Nice work!
Thank you loved your work ....
"Download the official eosio.token from eos repository
Compile and deploy it to your contract"
I don't think you need to setup a new eosio.token contract account.
eosio.token contract supports multiple tokens. You can issue your token using same account as was used to issue EOS tokens.
They are still building a bidding system, if I'm not wrong for now only
eosio.tokenaccount can create tokens there.Thanks! Do you know a way to list all tokens an account have?
no easy way to do it afaik... You would need a script to run
cleos get currency balancefor all the contracts and tokens symbols that you are watching for that specific account.As I imagined, thanks for the reply. I tried to deploy
eosio.tokenin mainnet but I geterror 3080001: account using more than allotted RAM usage(it worked on testnet) do you know the exact amount of cpu, ram, net to buy or stake to run it?Congratulations @leordev!
Your post was mentioned in the Steemit Hit Parade for newcomers in the following category:
I also upvoted your post to increase its reward
If you like my work to promote newcomers and give them more visibility on Steemit, consider to vote for my witness!
Congratulations @leordev! You have completed some achievement on Steemit and have been rewarded with new badge(s) :
Click on the badge to view your Board of Honor.
If you no longer want to receive notifications, reply to this comment with the word
STOPDo not miss the last post from @steemitboard!
Participate in the SteemitBoard World Cup Contest!
Collect World Cup badges and win free SBD
Support the Gold Sponsors of the contest: @good-karma and @lukestokes
Great work. So you said that:
how do you know this? any documents or codes in eos?
Guys,I just stumbled upon an absolute gem of a bounty by rawg.
the pay is upto $200 for just a retweet and share!(it's a special bounty which is only for the first 200)
Heres the link
https://bitcointalk.org/index.php?topic=4147507.msg40536596#msg40536596
KYC required!
Thanks Leo! I had assumed that the token owner always owned the RAM so this caused me to go back and look at eosio.token.cpp. So it looks like in the standard eosio.token, when you get an airdrop, the token contract (party 1) owns the RAM. But if the holder (party 2) then does any other transfer, say to party 3, party 2 is now owns the row of RAM in party 1's multi-index. This is really interesting becuase I did not realize that multi-index had row-level ram ownership. However this party 2 ownership appears to take place only if party 3 did not previously have an entry for that token. If party 3 did own some of ABC token already, then to_acnts.modify is called, in which case the existing RAM owner is maintained. Does this all sound correct?