Launching a Grid

How to create a tile grid for your Solana token and earn from every buyout — forever.

Launching a Grid

How grids are created on-chain.

Any Solana SPL token can have a GridCore tile grid. You call the launch_coin instruction with the token mint address, metadata, and a starting tile price. The grid is live immediately — tiles are claimable in the same block. GridCore also supports launching a grid without an existing token — a silent 0-supply SPL mint is created as a namespace identifier.

launch_coin Parameters

mintSPL token mint address (one grid per mint)

nameGrid display name (max 32 chars)

symbolToken ticker e.g. PEPE (max 10 chars)

uriMetadata JSON or image URI (max 200 chars)

starting_priceInitial price per tile in lamports

One grid per mint — permanently

Each SPL mint can only have one GridState PDA. Calling launch_coin twice on the same mint will fail at the account init constraint.

Creator is set at launch — cannot change

The creator field in GridState is set once at launch_coin time and is immutable. All future 0.4% creator fees flow to this wallet forever.

No ongoing cost

After paying Solana account rent for GridState at launch, there are zero recurring fees. Revenue is purely passive from that point on.

Image can be updated within 10 minutes

After launching a grid, the creator has a 10-minute window to update the grid image on GridCore's interface if the original upload didn't look right.

Creator Revenue

How and when creators earn.

Every time a tile in your grid is transacted (first claim or buyout), you receive 0.4% of the tile's listed price directly to your wallet — in the same transaction. No claiming required. The more active your grid (more buyouts at higher prices), the more you earn passively.

Creator Fee — Per Transaction

Amount0.4% of the tile's listed price at transaction time

DeliveryDirect wallet transfer in the same tx

Claiming neededNo — arrives automatically

Applies toEvery claim and buyout in your grid, forever

Revenue Projection — 100 tiles, 1.00 SOL average price

1 buyout / day~0.004 SOL/day → ~1.5 SOL/year

5 buyouts / day~0.02 SOL/day → ~7.3 SOL/year

20 buyouts / day~0.08 SOL/day → ~29 SOL/year

⚡ Creator revenue scales with tile price. If tiles in your grid trade at 10 SOL each, every buyout pays 0.04 SOL directly to you. High-value grids with consistent activity generate meaningful passive income with zero maintenance.

Starting Price Strategy

Setting the right initial tile price.

The starting price sets the entry point for first claimers. It also determines the minimum price tiles reset to when abandoned — so it doubles as the floor for tile resets. Choose carefully, as this cannot be changed after launch.

Starting Price Trade-offs

Too low (e.g. 0.005 SOL)High accessibility, very low creator fees per buyout

Too high (e.g. 10+ SOL)Low initial participation, high revenue per buyout

Sweet spotDepends on your token's community size and conviction

0.05–0.20 SOL — community launches

Good for meme coins with a large retail audience. Low barrier fills the grid quickly. Price appreciation comes from organic buyout activity.

0.5–2.00 SOL — established projects

Better for tokens with committed holders willing to stake meaningful SOL. Higher creator fees per buyout from day one.

5.00+ SOL — prestige / high-value

Reserved for premium grids where individual tile ownership has collector or status value. Very high passive revenue per buyout event.

⚠ starting_price is stored in GridState and used as the reset price when tiles are abandoned. It cannot be changed after launch — choose carefully.

Inject Rewards

Boosting holder earnings manually.

Creators (or anyone) can call inject_rewards to manually seed the grid's accumulator with SOL. This instantly boosts rewards for all current tile holders equally (one share per tile). If no tiles have been claimed yet, the SOL parks in a pending_seed balance and flushes to the accumulator when the first tile is claimed.

Reward campaigns

Inject SOL to reward holders during token launches, community milestones, or token buyback events.

Grid bootstrapping

New grids have no buyout history yet. Injecting rewards early makes tiles immediately attractive to claim.

Anyone can inject

Not limited to the creator — partners, whales, or protocols can inject rewards into any grid.

withdraw_seed before first claim

If you inject SOL before any tiles are claimed, you can reclaim it via withdraw_seed. Once the first tile is claimed, the pending_seed is permanently flushed to the accumulator.

See launch_coin in the contract reference