Bufalo is a DJ performing in the Decentraland metaverse, bringing "Futuristic Western Music" to people.
The DJ / Producer / Visual Artist is launching an NFT collection for its community. The tokens' aims to :
- offer physical goodies
- unlock several airdrops (Decentraland wearables, among other surprises)
- give VIP access into the Bufalo Saloon in Decentraland
- receive a share of the income from deals with music labels
Holding a Skull NFT gives the opportunity to continually claim rewards to get :
- Music NFTs granting commercial rights for music releases produced by Bufalo
- exclusive perks like video tutorials
All rewards can be claimed with gasless transactions.
| Contract name | Contract info | Deployed address |
|---|---|---|
| BOTV1 | ERC721A PFP collection, reveal with Chainlink included. Necessary upgrade to BOTV2 to allow contract owner more possibilities | 0x1D6F8ff4c5A4588DC95C8E1913E53a5007ad5378 |
| BOTV2 | ERC721A PFP collection, migration from BOTV1 | 0x1B9d577486D7AF13570F0d521cDDEc083D9F7e14 |
| BUFA | ERC20 tokens as rewards for BOTV NFT collection holders. ERC2612 (gasless approval) implemented | 0x6a9D0b634AB078E8F26Fb70baE77CBAD9840FfC2 |
| BUFAMUSIC | ERC1155 contract, Music NFTs to mint with $BUFA tokens. Give commercial rights on Bufalo's songs. ERC2771 (gasless / native meta tx) implemented | 0x9be332DAbcC32C78c8DB0bb5E2c519592f2342c1 |
⛓️ Chain : Polygon PoS
🔢 Supply : 1000 tokens
🔖 Sale price : 0.05 WETH per token, 50 % discount on the second mint for wallets on the "Fans" allowlist
📅 Private sale (wallets on "Community" allowlist only) : March 28. Public sale : March 29
🖼️ A unique art skull with seven traits (several rarities) and a 🎵 loop. Reveal date : March 30. Token assignations perfectly random, with no cheating possible from anyone thanks to the use of Chainlink VRF
🎁 Hat, trench coat & skull wearables offered on mint
🔢 10 tokens max per wallet
👑 10 % royalties
💵 Mint treasury : 0x3c0dabc82bf51d1bf994a54e70e7a7d19865f950. Royalties treasury (Oxsplits contract) : 0x0231339790F09B5F3d50a37D0dd82D66e82cA37D
💰 Hold-to-earn : receive a certain amount of $BUFA tokens (depending on the rarity of the NFT's attributes) every day. Spend these against benefits.
🌐 More info on the website bufalomusic.com
All token owners from previous Bufalo collections are admissible on the "Community" allowlist. See the list of eligible collections here.
Those who supported Bufalo up to $50 are on the "Fans" allowlist, and get a 50% discount on the second token. Amounts are computed on USD-basis (rate at the time of sale), from :
- Decentraland purchases
- Bufalo NFT realeases' transactions on Opensea (Ethereum & Polygon). See the list of eligible tokens here.
This Google Spreadsheet indicates which are the addresses on the allowlists.
| File | Description |
|---|---|
| Community allowlist | Array of addresses |
| Fan allowlist | Array of addresses |
| Activity snapshot | On-chain collected data |
| Sales | Paid transactions summary |
| Community merkle | Merkle root & proofs for each address on the Community allowlist |
| Fan merkle | Merkle root & proofs for each address on the Fan allowlist |
You can fetch https://bufalo-api.anthonygourraud.workers.dev/merkleproofs/:addr to get the merkle proofs for an address addr.
// Result from https://bufalo-api.anthonygourraud.workers.dev/merkleproofs/0x64E8f7C2B4fd33f5E8470F3C6Df04974F90fc2cA
{
"addr": "0x64e8f7c2b4fd33f5e8470f3c6df04974f90fc2ca",
// is from Community allowlist
"privateSaleMerkleProof": [
"0x....",
"0x....."
],
// is not from Fans allowlist
"discountMerkleProof": []
}Rarity score is computed following Open Rarity standard. All attributes are defined within the metadata JSON files for each token, available here. The rarer the attributes of the token, the more $BUFA tokens its owner can receive.
| File | Description |
|---|---|
| Rank | Rank, score and number of $BUFA per day for every token. (see Google Spreadsheet version) |
| $BUFA rewards merkle | Merkle root & proofs to claim $BUFA |
You can fetch https://bufalo-api.anthonygourraud.workers.dev/tokensForOwner/polygon/:addr to get all token infos for the wallet with address addr. Use tokenIds, rewardsPerDay and rewardsProofs values from the response to claim $BUFA tokens.
// Result from https://bufalo-api.anthonygourraud.workers.dev/tokensForOwner/polygon/0x64E8f7C2B4fd33f5E8470F3C6Df04974F90fc2cA
{
"tokenIds": [
"0"
],
"metadataIds": [
"977"
],
"rewardsPerDay": [
150
],
"rewardsProofs": [
[
"0x815c37dada917998387f155315f9d0bade8d37c20297f484f017274efe5c4c47",
"0x17b396aa747cdbfa0ae182fc7ca753415a4cf4891b5354baa4d224caa28db07a",
// ...
]
],
"tokenData": [
{
"tokenId": "0",
"metadataId": "977",
"rank": 170,
"title": "Bufalo BOTV Skull #977",
"media": [
{
"gateway": "https://nft-cdn.alchemy.com/matic-mainnet/d3965748aa4e688668e3d77b0978d9b3",
"thumbnail": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/d3965748aa4e688668e3d77b0978d9b3",
"raw": "ipfs://bafybeicgk7uqmmfhcopoyh7rwvqgiva7ebr6u6osqbeviel7o4x3suaiee/977.png",
"format": "png",
"bytes": 1188597
}
],
"metadata": {
"name": "Bufalo BOTV Skull #977",
"description": "",
"image": "ipfs://bafybeicgk7uqmmfhcopoyh7rwvqgiva7ebr6u6osqbeviel7o4x3suaiee/977.png",
"attributes": [
{
"value": "Yellow",
"trait_type": "Background"
},
// ...
],
"animation_url": "ipfs://bafybeibv34mmilskls4nuubcwow4pjeswzsfv5pdkna4b2nu5g7fipay6i/Bufalo - Billy Bob (Song 2).wav"
}
}
]
}You can fetch https://bufalo-api.anthonygourraud.workers.dev/musicnfts to get all available Music NFTs. Any wallet can buy with $BUFA tokens only one NFT for each id.
[
{
id: "103141286",
songTitle: "Bufalo - Saddle Up - BOTV Skull Staking 1",
supply: 50,
bufaPrice: 2000,
audioUrl:
"https://bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4.ipfs.nftstorage.link/ipfs/bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4/bufalo-saddle-up-botv-skull-staking-1.wav",
contractUrl:
"https://bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4.ipfs.nftstorage.link/ipfs/bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4/saddle-up-music-nft-license-agreement.pdf",
coverUrl:
"https://bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4.ipfs.nftstorage.link/ipfs/bafybeie3bcmcjo762enlzdzzrfmwoa3jclartlgt6kbwzc6up7ykf7ynk4/cover-saddle-up.jpeg",
mintActive: true,
tokenActive: true,
iswc: "T-316.218.353.7",
description:
'"Saddle Up" is the first Music NFT redeemable with the $BUFA tokens that are distributed daily from holding [a BOTV Skull](https://opensea.io/fr/collection/bufalo-botv-skulls-official). \n\nThis Music NFT comes with one of the very first Music License Agreement that provide commercial rights to the song. \n\nFull details: [bufalomusic.com](https://bufalomusic.com)',
depositDate: "2023-03-27",
genre: "Futuristic Western Music",
origin: "FRANCE",
visualArt: "Pierre Porcherot",
commercialRights: "YES"
}
];-
Contracts are not audited yet.
-
Note that the contract deployer has privileged access, including:
- the ability to mint Skulls NFT, $BUFA & Music NFTs for free
- minting price modification at any time
- the ability to set any address as unlimited minter for $BUFA tokens, including himself
API Deployment : Cloudflare Workers
Interfaces : Decentraland NFT API (DCL sales), NFTPort API (NFT data), Alchemy (Blockchain data), Coingecko (Prices history)
Snapshot script, tests : Node v18
Smart contract language: Solidity
Smart contract framework: Hardhat
Smart contract libs and tools: Chainlink, OpenZeppelin, Slither, Thirdweb
✅ Generate allowlists (addresses arrays & merkle data)
- Previous collections' token ownerships snapshot
- Decentraland & Opensea sales analysis
✅ NFT metadata (skull images) & uploads on IPFS
- Rarity scores computation
- Higest rewards according ranking
✅ ERC721A contract for skull NFTs
- ERC4907 rentable NFT token standard and ERC2981 royalties implementations
- Minting price configurable for any ERC20 and/or blockchain's native coin
- Discounts & private sale access with Merkle proof verification
- Hat, trench coat & skull wearable transfers on mint
- Reveal with random assignation using Chainlink
✅ $BUFA rewards
- ERC20 contract, with minter role granted to the Skull NFT contract
- Earn $BUFA tokens as long as you hold your Skull NFT
- $BUFA minting with Merkle proof verification
✅ ERC1155 for Music NFTs
- Can be purchased with $BUFA
- NFT holder get commercial rights to the related music