Skip to main content
This developer reference summarizes the public contract surface. Use the verified explorer ABI for exact transaction encoding.

Launch factories

Base uses B20LaunchpadFactory; Robinhood uses ERC20LaunchpadFactory. Both expose the same launch flow.
SurfaceImportant members
CreatecreateLaunch(LaunchParams) creates the token, distributes allocations, registers vesting, opens the pool, and seeds permanent liquidity
Configuration readsquotes, feeDefaults, launchSupply, tickSpacing, bands, announcementRegistry, and vestingVault
Transaction-safety readsconfigVersion and usedLaunchSalts
Contract limitsMIN_SUPPLY, MAX_SUPPLY, MAX_ALLOCATIONS, MAX_VESTED_ALLOCATIONS, MIN_VESTING_DURATION, MAX_VEST_STEPS, and MAX_TOTAL_VEST_STEPS
Future-launch governanceQuote, opening setting, creation fee, supply, liquidity, fee, treasury, announcement, and ownership updates

Launch events

EventMeaning
LaunchedToken, pool ID, creator, quote, supply, and liquidity spacing
LaunchFeePaidCreation-fee payer, quote, fee receiver, and amount
QuoteRegistered / QuoteUnregisteredSupported quote changes
QuoteCreationFeeUpdatedCreation-fee change for a quote
BandTemplateUpdatedFuture liquidity-range change
FeeDefaultsUpdatedFuture fee split, anti-snipe, or treasury change
LaunchSupplyUpdated / TickSpacingUpdatedFuture supply or range-alignment change
OwnershipTransferStarted / OwnershipTransferredGovernance ownership change

LaunchHook

The hook exposes poolConfig for each launch pool. The factory registers and seeds a pool; ordinary trading then occurs through Uniswap v4.
EventMeaning
PoolRegisteredThe pool’s frozen creator, platform fee receiver, and fee settings
SeededToken amount placed into the permanent position
TradeExecutor, referrer, fee currency, fee amount, and optional comment; swap direction comes from the matching Uniswap event

FeeEscrow

FunctionWho can callResult
owed(recipient, currency)AnyoneReturns the raw claimable fee balance
claim(recipient, currency)AnyonePays the full balance to the recorded recipient
claimTo(currency, to)Balance ownerPays the caller’s balance to a chosen address
Events: Credited and Claimed.

VestingVault

FunctionWho can callResult
claimable(token, beneficiary)AnyoneReturns tokens currently available to claim
getSchedule(token, beneficiary)AnyoneReturns the allocation, claimed amount, and unlock steps
claim(token, beneficiary)AnyoneSends available tokens to the recorded beneficiary
Events: Registered and Claimed.

AnnouncementRegistry

FunctionWho can callResult
creatorOf(token)AnyoneReturns the creator allowed to announce for the token
usedId(token, id)AnyoneChecks whether an announcement ID was used
post(token, id, description, uri)Recorded creatorPublishes a unique announcement
Events: CreatorRegistered and Announcement.

Robinhood launch tokens

Robinhood tokens expose standard ERC-20 reads and transfers. When profile editing was enabled at launch, the metadata authority can call updateName, updateSymbol, updateContractURI, and updateExtraMetadata. No mint, burn, pause, owner, upgrade, or recovery function exists.

Common launch errors

ErrorMeaning
StaleConfigRefresh the current factory settings and rebuild the transaction
LaunchExpiredUse a fresh deadline
QuoteNotRegisteredThe selected quote is unavailable
LaunchSaltUsedUse a new launch identifier
InvalidLaunchFeePaymentThe creation-fee payment was not exact
OutOfBounds / InvalidConfigA hard limit or related-field rule failed
NotImmutableThe created token failed its fixed-authority checks
NotSingleSidedOpening liquidity would require quote currency
LiquidityLockedThe requested liquidity change is not allowed
ExactOutputDisabledDuringAntiSnipeUse an input-amount trade or wait until the normal fee begins
PartialFillUnsupportedThe requested quote-specified amount could not be filled completely