Smart Contract Addresses
All vibe.market contracts are deployed on Base. Each booster pack collection has its own contract addresses for the NFT (BoosterDropV2) and token (BoosterTokenV2). Source availability: To protect our intellectual property, we’ve opted not to share source code to discourage untested clones or counterfeit versions of vibe.market. This policy may change in the future. In the meantime our interfaces are public for developers, and we’ve performed security scanning via Almanax.Contract Interfaces
View the complete smart contract interfaces
Common Use Cases
1. Buying Booster Packs
Purchase digital collectible booster packs programmatically and earn referral fees.2. Selling Tickets (Tokens)
Trade collectible tokens through the bonding curve or Uniswap pool.3. Opening Packs and Getting Randomness
Open packs to reveal rarity using Pyth Network entropy.4. Selling NFTs for Token Offers
Sell both opened and unopened packs back to the contract.5. Reading Onchain Data
Access all card data directly from the blockchain.6. Building Games with vibe.market Cards
7. Onchain Wear & Foil
We deployed the following source-available contract at 0x002aaaa42354bf8f09f9924977bf0c531933f999 that allows you to query wear and foil onchain fromgetTokenRarity
using tokenSpecificRandomness
. 0.5%
of cards are standard foil, and 0.05%
of cards are prize foil. Wear is distributed between 0
and 1
.
8. Card Rarity Distribution
Cards in a pack are mapped to specific random value ranges based on theirrandomValue
. When a pack is opened, the on-chain randomness generates a value between 0-999,999 returned in randomValue
from getTokenRarity()
.
Example Random Value Mapping:
Important Considerations
Note: All numerical values in code examples are for illustration purposes only. Actual values, fees, and percentages are determined by a collection’s smart contracts and may vary significantly. These digital collectibles are intended solely for personal enjoyment and entertainment.- Gas Optimization: Batch operations when possible (e.g., opening multiple packs at once)
- Slippage Protection: Always use
minPayoutSize
when selling tokens - Referral System: Include referral addresses to earn trading fees (example: 1% of trades, which might be 20% of a 7.5% total fee)
- Market State: Check if market is on bonding curve or Uniswap before trading
- Entropy Fees: Opening packs requires a small ETH fee for Pyth Network randomness (example: ~$0.01)
- Token Offers: The optional NFT exchange feature mints new tokens when available - this feature is not guaranteed and varies by collection
Next Steps
- Review the contract interfaces for complete method signatures
- Join our Discord for developer support