Token Creation

Resolve the deployment before building a transaction. New native launches use activeCreationDeployment from /api/capabilities. xStocks launches use the selected asset’s deployment.hookAddress from /api/xstocks/quote-assets.

Native creation

function createLaunch(CreateLaunchParams calldata params)
    external payable returns (uint256 launchId);

msg.value is the optional creator prebuy. Send zero for no prebuy. The call creates the token, records launch state, emits metadata, and performs the prebuy in one transaction when value is nonzero. Use createLaunch as the default partner entry point. The active native Ink and Robinhood hooks also expose:

function createLaunchWithReferral(
    CreateLaunchParams calldata params,
    string calldata referralCode
) external payable returns (uint256 launchId);

The deprecated Ink hook does not support this referral creation selector. Runtime deployment selection is required.

xStocks creation

function createLaunchWithQuotePrebuy(
    CreateLaunchParams calldata params,
    uint256 quotePrebuy
) external returns (uint256 launchId);

Approve the selected wrapper to the exact per-asset hook before the call when quotePrebuy is nonzero. params.targetRaise and quotePrebuy use wrapper units. Send no native value. See xStocks Launches for the complete flow.

Parameters

struct CreateLaunchParams {
    string name;
    string ticker;
    string description;
    string imageUrl;
    string telegram;
    string twitter;
    string website;
    uint16 creatorFeeSplitBps;
    uint32 gainBps;
    uint96 targetRaise;
    uint32 antiSnipeDuration;
    uint64 startTime;
}

Field	Rule
`creatorFeeSplitBps`	`0` to `10,000`
`gainBps`	`0` to current `MAX_GAIN_BPS`; current native max is `200,000`
`targetRaise`	Native: current 1 to 5 ETH; xStocks: per-asset raw limits
`antiSnipeDuration`	Seconds during which curve trades require valid captcha authorization
`startTime`	`0` for immediate, or a future Unix timestamp
`imageUrl`	Durable public HTTPS URL recommended

The total launch token supply is 1,000,000,000 tokens with 18 decimals.

Caller and recipient

The direct caller becomes the creator and fee recipient. Launch tokens from an optional prebuy go to that caller on the ordinary entry points. createLaunchFor exists for controlled sponsor flows, but it changes only the prebuy recipient. The caller still becomes creator. Do not use a backend relayer unless this ownership outcome is intended.

Receipt events

Every successful launch emits:

event LaunchCreated(
    uint256 indexed launchId,
    address indexed creator,
    address token,
    uint96 targetRaise
);

event LaunchMetadata(
    uint256 indexed launchId,
    string name,
    string ticker,
    string description,
    string imageUrl,
    string telegram,
    string twitter,
    string website
);

The hook also emits the resolved sale split and the exact snapshotted pool key. A prebuy emits a Trade event. Only accept a launch after the receipt:

Succeeded.
Contains exactly one LaunchCreated log from the expected hook.
Names the expected creator.
Contains the signed target raise.

Save the emitted token and launch ID with the chain, hook, and transaction hash.

Indexing

The read API updates after chain ingestion. A successful receipt can appear before /api/token returns the new token. Show confirmed, indexing and poll by address. Do not submit another launch.

Common failures

Failure	Check
Invalid raise	Read native constants or the selected xStocks asset limits
Invalid gain or creator split	Validate integer basis points before simulation
Start is in the past	Use `0` or a future Unix timestamp
Prebuy fails	Check native balance, wrapper balance, minimum buy, and allowance
Wrong quote entry point	Use native `createLaunch` or quoted `createLaunchWithQuotePrebuy`, never a mixture
Native value on xStocks call	Send zero value and use wrapper approval
Receipt has unexpected creator	The wrong wallet or wrapper contract called the hook

For a complete viem example, use the Launchpad Quickstart.

InkyPump Contracts

MCP Server

API Documentation

InkyPump API

InkySwap API

Native creation

xStocks creation

Parameters

Caller and recipient

Receipt events

Indexing

Common failures

​Native creation

​xStocks creation

​Parameters

​Caller and recipient

​Receipt events

​Indexing

​Common failures

Native creation

xStocks creation

Parameters

Caller and recipient

Receipt events

Indexing

Common failures