Skip to main content

Overview

When a sale is oversubscribed (more demand than tokens available), the settlement strategy determines how tokens are allocated among participants. Specifically, it determines how much of each participant’s commitment is accepted (used to purchase tokens) and how much is refunded. This decision is independent of your pricing strategy.

Pro-Rata Allocation

Every participant’s commitment is scaled down by the same percentage so that total allocations match the available supply.

How It Works

  • If 2M is committed but only 1M worth of tokens are available, everyone receives 50% of their commitment
  • The remainder is refunded

Example

Value
Tokens available1,000,000 worth
Total commitments2,000,000 (2x oversubscribed)
Alice commits100,000
Alice receives50,000 allocation (50%)
Alice refunded50,000

Pros

  • Simple and easy to understand
  • Everyone gets something
  • Larger participants receive larger allocations (which may attract institutional interest)
  • No FOMO—timing doesn’t matter

Cons

  • Can be gamed by participants who overcommit to secure a larger share
  • Small participants may end up with very small allocations in highly oversubscribed sales

Iterative Fill (Bottom-Up)

This strategy prioritizes filling more participants by ensuring everyone receives at least a minimum allocation before distributing the remainder.

How It Works

  1. Participants are placed in a random order
  2. Each participant is allocated the minimum commitment amount (e.g., 200)
  3. The process repeats, adding another minimum increment to each participant who committed more
  4. This continues until all available tokens are allocated

Example

ParticipantCommittedAllocated
1,000 small participants200 each200 each (full)
1,000 medium participants400 each400 each (full)
1 large participant1,000,000400,000 (partial)
With 1,000,000 available and minimum commitment of 200:
  • Small participants: fully filled at 200
  • Medium participants: fully filled at 400
  • Large participant: receives 400,000 (remaining supply)

Pros

  • More participants end up with meaningful allocations
  • Reduces the advantage of large participants
  • No incentive to overcommit

Cons

  • More complex for participants to understand
  • May be less attractive to large investors seeking significant allocations
  • In highly oversubscribed sales, some participants may receive reduced allocations

Manual Allocation

You provide your own allocation algorithm. Sonar collects the commitment data and you determine the accepted amount for each participant.

When to Use

  • You want to factor in external data (e.g., testnet participation, community contributions, Discord activity)
  • You have specific allocation logic that doesn’t fit the standard options
  • You want full control over who receives what
  • Strategic rounds with negotiated terms
You’ll need to build the allocation algorithm yourself and clearly communicate the rules to participants.

First-Come First-Served

Coming Soon — This settlement strategy is not yet available but will be supported in a future release.
Commitments are accepted in the order they are received until supply is exhausted. Early participants receive guaranteed allocations.

How It Works

  1. Participants submit commitments during the sale
  2. Commitments are queued in the order received
  3. When the sale closes, allocations are assigned in queue order until supply runs out
  4. If a participant cancels during the cancellation phase, their spot is freed and the next commitments in the queue move up

Example

PositionParticipantCommittedAllocated
1Alice200,000200,000 (full)
2Bob300,000300,000 (full)
3Carol400,000400,000 (full)
4Dave500,000100,000 (partial—supply exhausted)
5Eve200,0000 (no supply remaining)
With 1,000,000 available, the first three participants are fully filled, Dave receives a partial allocation, and Eve receives nothing.

Pros

  • Clear, predictable rules—early participants get priority
  • Strong incentive for early commitment
  • Full allocations for successful participants (no scaling down)

Cons

  • Creates urgency/FOMO at sale opening
  • Discriminates against participants in unfavorable timezones
  • Concentrates traffic at sale opening, increasing infrastructure load
  • Late participants may receive nothing
  • Rewards speed over conviction (smaller early commits beat larger late commits)

How Settlement Works

Settlement strategies are computed offchain by Sonar’s backend, not in the smart contract:
StrategyWho Computes Allocations
Pro-RataSonar computes automatically
Iterative FillSonar computes automatically
First-Come First-ServedSonar computes automatically (coming soon)
ManualYour team computes and provides to Sonar
After allocations are computed, they are recorded onchain via the contract’s setAllocations() function. This triggers refunds for any uncommitted amounts and makes proceeds available for withdrawal.

Next Steps