feat(grc20-launchpad): realms & pkg

[MikaelVallenet]

Launchpad GRC20 Token Smart Contracts

This PR introduces the following GRC20 token smart contracts for the development of a launchpad on the Gno blockchain. The contracts provide functionalities for token creation, minting, burning, airdrops, and token sales.

Demonstration

https://www.youtube.com/watch?v=76clMWwk_zY

Features

Token Contract

• Token Creation: Supports token creation with specific parameters like name, symbol, decimals, initial supply, and total supply cap.
• Minting and Burning: Option to allow or restrict minting and burning of tokens based on the configuration.
• Transfer Functions: Implements standard GRC20 transfer functions like Transfer, Approve, and TransferFrom.
• Admin Role: Enforces admin control over certain actions (minting, burning) using the Ownable pattern for access control.

Airdrop Contract

• Merkle Tree-Based Airdrop: Uses a Merkle root to allow airdrop claimants to prove eligibility and claim tokens.
• Time-Limited Airdrops: Configurable start and end timestamps for the airdrop duration.
• Claim Function: Allows eligible addresses to claim tokens via Merkle proofs.

Sale Contract

• Token Sale: Facilitates time-limited token sales with configurable parameters like price per token, limit per address, minimum and maximum goals.
• Owner Control: The token owner can set the parameters and finalize the sale when it ends.
• Refund Mechanism: Automatically refunds buyers if the minimum sale goal is not reached.
• Merkle Tree Integration: Option to use a Merkle root to limit sale participation to specific addresses.

Key Functions

Token

• NewToken(name, symbol, image, decimals, initialSupply, totalSupplyCap, allowMint, allowBurn)
• Mint(name, to, amount)
• Burn(name, from, amount)
• Transfer(name, to, amount)
• Approve(name, spender, amount)
• TransferFrom(name, from, to, amount)

Airdrop

• NewAirdrop(tokenName, merkleRoot, amountPerAddr, startTimestamp, endTimestamp)
• Claim(airdropID, proofs)

Sale

• NewSale(tokenName, merkleRoot, startTimestamp, endTimestamp, pricePerToken, limitPerAddr, minGoal, maxGoal, mintToken)
• Buy(saleID, amount, proofs)
• Finalize(saleID)

⚠️ PR description generated by AI from code files 🤖

[netlify]

✅ Deploy Preview for testitori ready!

Name	Link
🔨 Latest commit	1cfce78
🔍 Latest deploy log	https://app.netlify.com/sites/testitori/deploys/66e2f7d12f37a60008e530d5
😎 Deploy Preview	https://deploy-preview-1263--testitori.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[netlify]

✅ Deploy Preview for teritori-dapp ready!

Name	Link
🔨 Latest commit	1cfce78
🔍 Latest deploy log	https://app.netlify.com/sites/teritori-dapp/deploys/66e2f7d14d8dee0008733dc4
😎 Deploy Preview	https://deploy-preview-1263--teritori-dapp.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[n0izn0iz]

Please add unit tests

[n0izn0iz]

How do you list all airdrops and sales for a particular token?

I think airdrops and sales should be stored in the Token struct or at least be indexed by token

[leohhhn]

Sorry for being late to the party; I left some comments. Just a few considerations. Happy to see more complex code being built!