waqasideofuzion / buildo-begins

Elrond blockchain CLI helper tools - interaction with APIs, smart contracts and protocol

Buildo Begins 👷

Meet Buildo. He is here to help you start creating in the Elrond blockchain ecosystem. Here is where everything begins.

I'm going on an adventure! The road goes ever on and on.
— Buildo

Buildo is a cool guy 👊

— Beniamin Mincu 🔥🌓 (@beniaminmincu) June 4, 2022

Walkthrough videos

• sending tokens: https://youtu.be/NijTSZhswns
• issuing, mintin and burning ESDT supply: https://youtu.be/_Jj0zCaATVU
• creating and checking the herotag for wallet address without the Maiar App: https://youtu.be/nvda-zCffck
• Elrond data converters: https://youtu.be/soUq9eX9-0s

Related articles

• Setup erdjs and issue ESDT

With what he will help you (not all is available yet!):

1. Deriving PEM files
2. Making transactions
3. Deploying smart contracts
4. Smart contracts interactions
5. Common API interactions and filtering
6. Sky is the limit...

TODO

For now, the first version gives you basic stuff. But there will be much more:

• examples for interaction with smart contracts,
• proper erdjs interactions,
• ABI usage,
• custom operations on API
• Gandalf's wizarding shit and stuff, you will be amazed for sure!

How to work with Buildo:

1. Install globally npm install buildo-begins -g
2. Derive the pem from seed phrase: buildo-begins derive-pem
3. The walletKey.pem file will be created
4. Check the commands with buildo-begins --help
5. Use one of available commands, check them below.
6. You will get some prompts, fill up the required data

Available commands for Buildo (for now, there will be more):

Each command will display a set of self-explanatory prompts.

1. buildo-begins derive-pem - derive PEM file from seed phrase
2. buildo-begins send-egld - send EGLD tokens
3. buildo-begins send-esdt - send ESDT tokens
4. buildo-begins send-sft - send SFT tokens
5. buildo-begins send-nft - send NFT token
6. buildo-begins send-meta-esdt - send Meta ESDT tokens
7. buildo-begins issue-esdt - issue new ESDT token
8. buildo-begins set-special-roles-esdt - set/unset special ESDT roles
9. buildo-begins mint-burn-esdt - mint/burn the ESDT token supply (requires ESDTRoleLocalBurn, ESDTRoleLocalMint roles)
10. buildo-begins pause-unpause-esdt - pause/unpause all transactions of the token (requires canPause role)
11. buildo-begins freeze-unfreeze-esdt - freeze/unfreeze the token balance in a specific account, preventing transfers to and from that account (requires canFreeze role)
12. buildo-begins wipe-esdt - wipe out the tokens held by a previously frozen account, reducing the supply (Wiping the tokens of an Account is an operation designed to help token managers to comply with regulations.)
13. buildo-begins herotag - create a herotag and assign it to addres and check addresses of existing ones
14. buildo-begins converters - a set of converters based on excelent Elrond Converters but in the CLI, always at hand!

What is awesome here is that you don't have to worry about proper nonce, decimal places, or differentiation between the NFT token id and collection ticker. The maximum amount of arguments will always be the address, token id, and amount. It will differ for each type, but these are maximum.

How to use the config file?

Internally Buildo uses the config.ts file, but when you use it as a globally installed npm CLI tool, you don't have to touch that file. What you need to do is to create the .buildobeginsrc file, where you can change values (here default values):

{
  "chain": "devnet",
  "customApi": "https://devnet-api.elrond.com"
}

Development:

1. Clone the repo
2. Each change needs npm run build
3. You can link the lib locally by npm link
4. If you want to build your version, find all the buildo-begins names and replace them with yours.

Real live examples that use a similar approach:

• elven-tools
• nft-art-maker