Use Smart Contracts With Basescan

The Megapot protocol operates autonomously, enabling anyone to build on it, or use it, without permission. This article covers usage via the neutral third-party app, Basescan. Use the quick links below to learn how to use the contracts directly for the given actions. If you are new to Basescan, make sure to review the Getting Started section:

• Buy Tickets (10 or less)

• Buy Random Tickets (10 or less)

• Buy Tickets (more than 10)

• Claim Winnings

• Deposit Funds to Prize Pool

• Initiate Withdrawal from Prize Pool

• Finalize Withdrawal from Prize Pool

• Claim Referral Fees

---

Use the Contract Directly on Basescan

Getting Started

1. Navigate to the contract address on Basescan

2. Click the Contract tab, then Write Contract

3. Click Connect to Web3 and connect your wallet

4. Find the function you want to call and enter the required parameters

---

Contract Addresses

All contracts are deployed on Base (Chain ID: 8453).

Contract	Address	Description
Jackpot	0x3bAe643002069dBCbcd62B1A4eb4C4A397d042a2	Main lottery orchestrator
JackpotLPManager	0xE63E54DF82d894396B885CE498F828f2454d9dCf	Backer deposit and share management
JackpotTicketNFT	0x48FfE35AbB9f4780a4f1775C2Ce1c46185b366e4	ERC-721 ticket NFTs
JackpotAutoSubscription	0x02A58B725116BA687D9356Eafe0fA771d58a37ac	Auto-subscription management
BatchPurchaseFacilitator	0x01774B531591b286b9f02C6Bc02ab3fD9526Aa76	Batch ticket purchases
JackpotRandomTicketBuyer	0xb9560b43b91dE2c1DaF5dfbb76b2CFcDaFc13aBd	Random ticket purchases
GuaranteedMinimumPayoutCalculator	0x97a22361b6208aC8cd9afaea09D20feC47046CBD	Prize tier calculations
ScaledEntropyProvider	0x5D030DEC2e0d38935e662C0d2feD44B050c8Ae51	Pyth randomness integration

---

Player Functions

Buy Tickets

Contract: Jackpot (Basescan)

Function: buyTickets

Purchase lottery tickets for the current drawing.

Parameters:

• _tickets: Array of ticket structs, each containing:

  • normals: Array of 5 numbers (1 to ballMax, typically 1-30)

  • bonusball: Single number (1 to current bonusballMax)

• _recipient: Address to receive the ticket NFTs

• _referrers: Array of referrer addresses (can be empty [])

• _referralSplit: Array of split percentages in 1e18 scale (must sum to 1e18 if referrers provided)

• _source: Telemetry identifier (use 0x0000000000000000000000000000000000000000000000000000000000000000)

Before calling:

1. Approve USDC spending for the Jackpot contract (1e6 per ticket)

Example: 1 ticket with numbers 1, 5, 10, 15, 20 and bonusball 3, no referrer:

_tickets: [[[1,5,10,15,20], 3]]
_recipient: 0xYourAddress
_referrers: []
_referralSplit: []
_source: 0x0000000000000000000000000000000000000000000000000000000000000000

---

Buy Random Tickets

Contract: JackpotRandomTicketBuyer (Basescan)

Function: buyTickets

Purchase tickets with randomly generated numbers. The contract handles number selection for you using on-chain randomness.

Parameters:

• _count: Number of random tickets to purchase

• _recipient: Address to receive the ticket NFTs

• _referrers: Array of referrer addresses (can be empty [])

• _referralSplitBps: Array of split percentages in 1e18 scale (must sum to 1e18 if referrers provided)

• _source: Telemetry identifier (use 0x0000000000000000000000000000000000000000000000000000000000000000)

Before calling:

1. Approve USDC spending for the JackpotRandomTicketBuyer contract (1e6 per ticket)

Example: 5 random tickets, no referrer:

_count: 5
_recipient: 0xYourAddress
_referrers: []
_referralSplitBps: []
_source: 0x0000000000000000000000000000000000000000000000000000000000000000

---

Claim Winnings

Contract: Jackpot (Basescan)

Function: claimWinnings

Claim prizes from winning tickets. The ticket NFTs are burned upon claiming.

Parameters:

• _userTicketIds: Array of ticket NFT IDs to claim

Before calling:

1. Find your ticket IDs (see below)

2. Ensure the drawing has completed (tickets must be from a past drawing)

How to find your ticket IDs:

Option 1: Use an NFT marketplace (OpenSea, etc.) to view your Megapot Tickets collection. The ticket ID is shown in each NFT's details.

Option 2: Query the contract directly:

1. Go to the JackpotTicketNFT contract on Basescan

2. Click the Read Contract tab

3. Call getUserTickets with your address and the drawing ID

4. The response includes ticketId for each ticket you own in that drawing

Example calling getUserTickets for drawing 42:

_userAddress: 0xYourAddress
_drawingId: 42

Example claiming 2 tickets:

_userTicketIds: [98765432109876543210987654321098765432109876543210987654321012345, 98765432109876543210987654321098765432109876543210987654321012346]

---

Backer Functions

Deposit to Prize Pool

Contract: Jackpot (Basescan)

Function: lpDeposit

Deposit USDC to back the prize pool and earn returns from ticket sales.

Parameters:

• _amountToDeposit: Amount of USDC in wei (6 decimals, so 1000000 = $1)

Before calling:

1. Approve USDC spending for the Jackpot contract

Example depositing $1,000:

_amountToDeposit: 1000000000

---

Initiate Withdrawal

Contract: Jackpot (Basescan)

Function: initiateWithdraw

Begin the withdrawal process. Shares are moved to pending status.

Parameters:

• _amountToWithdrawInShares: Amount of shares to withdraw (6 decimals, like USDC)

Note: You can view your share balance by calling getLPShares on JackpotLPManager with your address.

Example withdrawing 100 shares:

_amountToWithdrawInShares: 100000000

---

Finalize Withdrawal

Contract: Jackpot (Basescan)

Function: finalizeWithdraw

Complete a pending withdrawal and receive USDC. Call this after the drawing completes.

Parameters: None (uses your connected wallet address)

---

Emergency Withdrawal

Contract: Jackpot (Basescan)

Function: emergencyWithdrawLP

Only available when emergency mode is enabled. Withdraws all LP positions immediately.

Parameters: None

---

Referrer Functions

Claim Referral Fees

Contract: Jackpot (Basescan)

Function: claimReferralFees

Claim accumulated referral fees from ticket sales and winner payouts.

Parameters: None (uses your connected wallet address)

Check your balance first: Call referralFees on the Jackpot contract with your address to see your claimable amount.

---

Auto-Subscription Functions

Create Subscription

Contract: JackpotAutoSubscription (Basescan)

Function: createSubscription

Set up automatic daily ticket purchases.

Parameters:

• _recipient: Address to receive the tickets

• _totalDays: Number of days to subscribe

• _dynamicTicketCount: Number of random tickets per day

• _userStaticTickets: Array of static tickets (same numbers each day)

• _referrers: Referrer addresses

• _referralSplit: Referral split percentages (1e18 scale)

Before calling:

1. Calculate total cost: totalDays × (dynamicTickets + staticTickets) × ticketPrice

2. Approve USDC spending for the JackpotAutoSubscription contract

Example: 30-day subscription with 2 random tickets + 1 static ticket (1, 5, 10, 15, 20 with bonusball 3) per day, no referrer:

_recipient: 0xYourAddress
_totalDays: 30
_dynamicTicketCount: 2
_userStaticTickets: [[[1,5,10,15,20], 3]]
_referrers: []
_referralSplit: []

---

Cancel Subscription

Contract: JackpotAutoSubscription (Basescan)

Function: cancelSubscription

Cancel your subscription and receive a refund for unused days.

Parameters: None (uses your connected wallet address)

---

Batch Purchase Functions

Create Batch Order

Contract: BatchPurchaseFacilitator (Basescan)

Function: createBatchOrder

Create a batch order for purchasing many tickets at once.

Parameters:

• _recipient: Address to receive the tickets

• _dynamicTicketCount: Number of randomly generated tickets

• _userStaticTickets: Array of user-defined tickets

• _referrers: Referrer addresses

• _referralSplit: Referral split percentages

Before calling:

1. Calculate total cost: totalTickets × ticketPrice

2. Approve USDC spending for the BatchPurchaseFacilitator contract

Example: 50 random tickets + 2 static tickets (7, 14, 21, 28, 30 with bonusball 5) and (2, 4, 6, 8, 10 with bonusball 1), no referrer:

_recipient: 0xYourAddress
_dynamicTicketCount: 50
_userStaticTickets: [[[7,14,21,28,30], 5], [[2,4,6,8,10], 1]]
_referrers: []
_referralSplit: []

---

Cancel Batch Order

Contract: BatchPurchaseFacilitator (Basescan)

Function: cancelBatchOrder

Cancel a pending batch order and receive a full refund.

Parameters: None (uses your connected wallet address)

---

Read Functions

These view functions help you check state before making transactions:

Function	Contract	Description
currentDrawingId	Jackpot	Current drawing number
getDrawingState(drawingId)	Jackpot	Drawing details (prizePool, ticketPrice, bonusballMax, etc.)
ticketPrice	Jackpot	Current ticket price in USDC wei
referralFees(address)	Jackpot	Claimable referral fees for an address
getLpInfo(address)	JackpotLPManager	LP position details (shares, deposits, withdrawals)
getLPValueBreakdown(address)	JackpotLPManager	USDC-denominated breakdown of LP position
getSubscriptionInfo(address)	JackpotAutoSubscription	Subscription details
getBatchOrderInfo(address)	BatchPurchaseFacilitator	Batch order details

---

Approving USDC

Many Megapot functions require you to approve USDC spending before calling them. This is a standard ERC-20 pattern that allows the contract to transfer USDC on your behalf.

USDC on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

How to Approve

1. Go to the USDC contract on Basescan

2. Click the Write as Proxy tab

3. Connect your wallet

4. Find the approve function

5. Enter the parameters:

   • spender: The Megapot contract address you want to interact with (see table below)

   • value: The amount in USDC wei (6 decimals)

6. Click Write and confirm the transaction

Amount Examples

USDC Amount	Value (wei)
$1	1000000
$10	10000000
$100	100000000
$1,000	1000000000

Which Contract to Approve

Action	Contract	Address
Buy tickets	Jackpot	0x3bAe643002069dBCbcd62B1A4eb4C4A397d042a2
Buy random tickets	JackpotRandomTicketBuyer	0xb9560b43b91dE2c1DaF5dfbb76b2CFcDaFc13aBd
Deposit to pool	Jackpot	0x3bAe643002069dBCbcd62B1A4eb4C4A397d042a2
Create subscription	JackpotAutoSubscription	0x02A58B725116BA687D9356Eafe0fA771d58a37ac
Create batch order	BatchPurchaseFacilitator	0x01774B531591b286b9f02C6Bc02ab3fD9526Aa76

---

Need Help?

Ask our Support Chat if you have any questions about direct contract interactions.