Skip to content

Commit

Permalink
Meta ESDT operations
Browse files Browse the repository at this point in the history
  • Loading branch information
juliancwirko committed Dec 3, 2022
1 parent 62cfcf1 commit 4eafcb5
Show file tree
Hide file tree
Showing 9 changed files with 820 additions and 1,101 deletions.
28 changes: 16 additions & 12 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,53 @@
### [0.6.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.6.0) (2022-11-01)
### [0.7.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.7.0) (2022-12-02)
- added some of the Meta ESDT operations (issue, roles, create), more soon
- updated dependencies

### [0.6.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.6.0) (2022-11-01)
- added some of the NFT operations (issue, roles, create), more soon
- updated dependencies (erdjs etc.)

### [0.5.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.5.0) (2022-10-02)
### [0.5.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.5.0) (2022-10-02)
- added `buildo-begins claim-developer-rewards` - Claim dev rewards from your smart contract. You have to use the owner's wallet address (PEM) when calling it
- added `buildo-begins change-owner-address` - You can change the owner address of the smart contract you own
- bump versions for erdjs related dependencies and dev dependencies

### [0.4.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.4.0) (2022-08-31)
### [0.4.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.4.0) (2022-08-31)
- added some of the SFT operations (issue, roles, create), more soon
- updated dependencies (erdjs etc.)
- MIT license

### [0.3.2](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.3.2) (2022-08-24)
### [0.3.2](https://github.com/xdevguild/buildo-begins/releases/tag/v0.3.2) (2022-08-24)
- added ESDT `transferOwnership` - thanks to @waqasideofuzion

### [0.3.1](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.3.1) (2022-07-24)
### [0.3.1](https://github.com/xdevguild/buildo-begins/releases/tag/v0.3.1) (2022-07-24)
- fix misleading label for `buildo-begins converters`

### [0.3.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.3.0) (2022-07-23)
### [0.3.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.3.0) (2022-07-23)
- added `buildo-begins converters` - a set of Elrond converters based on http://207.244.241.38/elrond-converters/

### [0.2.2](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.2.2) (2022-07-08)
### [0.2.2](https://github.com/xdevguild/buildo-begins/releases/tag/v0.2.2) (2022-07-08)
- added `buildo-begins wipe-esdt` - a command for 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.)

### [0.2.1](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.2.1) (2022-06-20)
### [0.2.1](https://github.com/xdevguild/buildo-begins/releases/tag/v0.2.1) (2022-06-20)
- added `buildo-begins pause-unpause-esdt` - a command for pause or unpause all transactions of the token (of course you need `canPause` role on such ESDT)
- added `buildo-begins freeze-unfreeze-esdt` - a command to freeze/unfreeze the token balance in a specific account, preventing transfers to and from that account (of course you need `canFreeze` role on such ESDT)

### [0.2.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.2.0) (2022-06-16)
### [0.2.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.2.0) (2022-06-16)
- added `buildo-begins herotag` - a command for creating Elrond herotag (dns) and checking the address of the existing one

### [0.1.0](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.1.0) (2022-06-12)
### [0.1.0](https://github.com/xdevguild/buildo-begins/releases/tag/v0.1.0) (2022-06-12)
- added `buildo-begins issue-esdt` command for issuing new ESDT tokens
- added `buildo-begins set-special-roles-esdt` command for setting and unsetting special ESDT roles - local mint, and local burn
- added `buildo-begins mint-burn-esdt` command for minting or burning ESDT token supply (requires special roles from the command above)
- more operations on ESDT soon. Stay tuned!

### [0.0.3](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.0.3) (2022-06-04)
### [0.0.3](https://github.com/xdevguild/buildo-begins/releases/tag/v0.0.3) (2022-06-04)
- added `buildo-begins send-esdt` command for sending ESDT tokens
- added `buildo-begins send-nft` command for sending NFT tokens
- added `buildo-begins send-sft` command for sending SFT tokens
- added `buildo-begins send-meta-esdt` command for sending Meta ESDT tokens

### [0.0.2](https://github.com/ElrondDevGuild/buildo-begins/releases/tag/v0.0.2) (2022-06-04)
### [0.0.2](https://github.com/xdevguild/buildo-begins/releases/tag/v0.0.2) (2022-06-04)
- initial functionality and configuration
- added `buildo-begins derive-pem` command for deriving the PEM file, it is then used for all transactions, and it is automatically detected when located in the same directory
- added `buildo-begins send-egld` command for sending EGLD tokens
49 changes: 31 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## Buildo Begins 👷

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

> I'm going on an adventure!
> The road goes ever on and on. \
Expand All @@ -13,9 +13,11 @@ Meet Buildo. He is here to help you start creating in the Elrond blockchain ecos

- sending tokens: https://youtu.be/NijTSZhswns
- issuing, minting and burning ESDT supply: https://youtu.be/_Jj0zCaATVU
- issuing and creating an SFT collection: https://youtu.be/ozOYli4qQx4
- issuing and creating an SFTs: https://youtu.be/ozOYli4qQx4
- issuing and creating an NFTs: https://youtu.be/B4vahursgkQ
- issuing and creating Meta ESDTs: https://youtu.be/dsRswHhIteU
- 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
- data converters: https://youtu.be/soUq9eX9-0s

### Related articles

Expand All @@ -25,22 +27,13 @@ Meet Buildo. He is here to help you start creating in the Elrond blockchain ecos
### With what he will help you (not all is available yet!):

1. Deriving PEM files
2. All tokens-related operations (ESDT, SFT, NFT, Meta ESDT, issuing, sending, management)
2. Making transactions
3. Deploying smart contracts
4. Smart contracts interactions
5. Common API interactions and filtering
4. 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`
Expand All @@ -50,7 +43,7 @@ For now, the first version gives you basic stuff. But there will be much more:
5. Use one of available commands, check them below.
5. You will get some prompts, fill up the required data

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

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

Expand All @@ -75,30 +68,40 @@ Each command will display a set of self-explanatory prompts.

#### SFT operations (will be more...)

To create SFTs keep the order of operations: `issue-sft` -> `set-special-roles-sft` -> `create-sft`

- `buildo-begins issue-sft` - issue a new SFT collection
- `buildo-begins set-sepacial-roles-sft` - set special roles for SFT
- `buildo-begins create-sft` - create a new SFT with initial quantity, assets, attributes, etc.
- `buildo-begins send-sft` - send SFT tokens

#### NFT operations (will be more...)

To create NFTs keep the order of operations: `issue-nft` -> `set-special-roles-nft` -> `create-nft`

- `buildo-begins issue-nft` - issue a new NFT collection
- `buildo-begins set-sepacial-roles-nft` - set special roles for NFT
- `buildo-begins create-nft` - create a new NFT, assets, attributes, etc.
- `buildo-begins send-nft` - send NFT token

#### Meta ESDT operations (will be more...)

To create Meta ESDTs keep the order of operations: `issue-meta-esdt` -> `set-special-roles-meta-esdt` -> `create-meta-esdt`

- `buildo-begins issue-meta-esdt` - issue a new NFT collection
- `buildo-begins set-sepacial-roles-meta-esdt` - set special roles for NFT
- `buildo-begins create-meta-esdt` - create a new NFT, assets, attributes, etc.
- `buildo-begins send-meta-esdt` - send Meta ESDT tokens

Meta ESDTs are usually managed and used through smart contracts, but here you can issue, create and also set optional attributes as strings.

#### EGLD operations (will be more...)

- `buildo-begins send-egld` - send EGLD tokens

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.

### 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):
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 are default values):

```json
{
Expand All @@ -107,6 +110,16 @@ Internally Buildo uses the config.ts file, but when you use it as a globally ins
}
```

### 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!

### Development:

1. Clone the repo
Expand All @@ -123,4 +136,4 @@ Internally Buildo uses the config.ts file, but when you use it as a globally ins

- [elven.js](https://www.elvenjs.com) - Authenticate, sign, and send transactions on the Elrond blockchain in the browser. No need for bundlers, frameworks, etc. Just import from the static script source, and you are ready to go. One static file to rule it all on the Elrond blockchain!
- [Elven Tools](https://www.elven.tools) - The PFP NFT toolset: NFT minter smart contract (decentralized way of minting), minter Nextjs dapp (interaction on the frontend side), CLI tool (deploy, configuration, interaction).
- [Next.js Dapp Template](https://github.com/ElrondDevGuild/nextjs-dapp-template) - general purpose Next.js dapp template
- [Next.js Dapp Template](https://github.com/xdevguild/nextjs-dapp-template) - general purpose Next.js dapp template
Loading

0 comments on commit 4eafcb5

Please sign in to comment.