Developer Documentation

// Using ethers.js v6
import { ethers } from "ethers";

// Connect to provider
const provider = new ethers.JsonRpcProvider("https://base.llamarpc.com");
const signer = new ethers.Wallet(PRIVATE_KEY, provider);

// BoosterDropV2 contract
const boosterDrop = new ethers.Contract(
  BOOSTER_DROP_ADDRESS,
  IBoosterDropV2_ABI,
  signer
);

// Get mint price for 5 packs
const mintPrice = await boosterDrop.getMintPrice(5);

// Mint packs with referral (you earn fees!)
await boosterDrop.mint(
  5, // amount of packs
  signer.address, // recipient
  YOUR_ADDRESS, // referrer (earn 1% of fees)
  YOUR_ADDRESS, // originReferrer (earn additional 1% of fees)
  { value: mintPrice } // ETH payment
);

// BoosterTokenV2 contract
const boosterToken = new ethers.Contract(
  BOOSTER_TOKEN_ADDRESS,
  IBoosterTokenV2_ABI,
  signer
);

// Check current market type
const marketType = await boosterToken.marketType();
// 0 = BONDING_CURVE, 1 = UNISWAP_POOL

// Get sell quote for 100,000 tokens
const tokenAmount = ethers.parseUnits("100000", 18);
const ethReceived = await boosterToken.getTokenSellQuote(tokenAmount);

// Sell tokens with slippage protection
const minPayout = (ethReceived * 98n) / 100n; // 2% slippage
await boosterToken.sell(
  tokenAmount,
  signer.address, // recipient of ETH
  minPayout, // minimum ETH to accept
  YOUR_ADDRESS, // referrer
  YOUR_ADDRESS // originReferrer
);

// First, open the pack to reveal rarity
const tokenIds = [1, 2, 3]; // Your unopened pack token IDs
await boosterDrop.openPacks(tokenIds);

// Then sell the opened pack for its token offer
await boosterDrop.sellAndClaimOffer(tokenIds[0]);

// Or batch sell multiple opened packs
await boosterDrop.sellAndClaimOfferBatch(tokenIds);

// Listen for user's pack transfers to track ownership
const filter = boosterDrop.filters.BoosterDropTransfer(null, userAddress);
const events = await boosterDrop.queryFilter(filter);

// Build collection from transfer events
const ownedTokens = new Set();
for (const event of events) {
  ownedTokens.add(event.args.tokenId);
}

// Check ownership and rarity for specific tokens
const tokenId = 123;
const owner = await boosterDrop.ownerOf(tokenId);
if (owner === userAddress) {
  const rarity = await boosterDrop.getRarity(tokenId);
  const rarityNames = ["", "Common", "Rare", "Epic", "Legendary"];
  console.log(`User owns ${rarityNames[rarity]} card #${tokenId}`);

  // Grant in-game benefits based on rarity
  if (rarity === 4) {
    // Legendary
    // Grant special abilities or bonuses
  }
}