Launch a token

A launch creates a pump.fun token with its fee route locked in the same transaction. The token's creator is the wallet that signs it and pays for it: your user, or you. relayfor.si builds the transaction, checks it by simulation and signs it with the new mint, but never holds the creator's keys or money.

What a launch costsCopy Anchor Link

The creator's wallet pays, all inside the launch transaction:

Each route wallet that holds nothing yet is opened the same way, for about 0.0009 SOL: pump.fun can't pay an empty wallet less than that.

Step by stepCopy Anchor Link

const launch = await fetch("https://relayfor.si/api/project/v1/launches/prepare", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RELAYFOR_SECRET_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    creator: userWallet,
    name: "Nova",
    symbol: "NOVA",
    description: "The agent that reads Solana for you.",
    image: imageDataUri,
  }),
}).then((response) => response.json());

npm i @wallet-standard/app @wallet-standard/features @solana/wallet-standard-features

import { SolanaSignTransaction, type SolanaSignTransactionFeature } from "@solana/wallet-standard-features";
import { getWallets } from "@wallet-standard/app";
import { StandardConnect, type StandardConnectFeature } from "@wallet-standard/features";

// The Solana wallets in this browser that can connect and sign.
const wallets = getWallets()
  .get()
  .filter((wallet) => SolanaSignTransaction in wallet.features && StandardConnect in wallet.features);

// Connect the one your user picks, and read its address.
const wallet = wallets[0]!;
const connect = (wallet.features as StandardConnectFeature)[StandardConnect];
const { accounts } = await connect.connect();
const account = accounts[0]!;
const signing = (wallet.features as SolanaSignTransactionFeature)[SolanaSignTransaction];

// A wallet that can't sign version 1 transactions yet gets a version 0 launch.
const transactionVersion = signing.supportedTransactionVersions.includes(1) ? 1 : 0;

// Your server prepares the launch for this wallet (step 1)...
const launch = await prepareOnYourServer({ creator: account.address, transactionVersion });

// ...the wallet signs it...
const [signed] = await signing.signTransaction({
  account,
  transaction: Uint8Array.from(atob(launch.transaction.base64), (char) => char.charCodeAt(0)),
  chain: "solana:mainnet",
});

// ...and your server sends it (step 3).
await submitOnYourServer(launch.id, btoa(String.fromCharCode(...signed!.signedTransaction)));

await fetch(`https://relayfor.si/api/project/v1/launches/${launchId}/submit`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RELAYFOR_SECRET_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ transaction: signedBase64 }),
});

The token's routeCopy Anchor Link

The route comes from your fee strategy. Three fields shape it:

• preset: the strategy to use (fps_...). Your default when left out.
• split: the creator's pick of the AI's and the creator's shares, in basis points of your part, within the strategy's creator_choice. The strategy's own split when left out.
• creator_fees_to: where the creator's share goes. The creator's own wallet when left out.

{ "split": { "ai_share": 7000, "creator_share": 1000 } }

Here the AI takes 70% of your part and the creator 10%, and Standard's wallet keeps its 20%. A launch is refused before anything is signed when a route wallet can't be paid, such as a program's address or relayfor.si's own. The answer's route lists every shareholder with its roles, in basis points of the whole fee, relayfor.si's 20% among them.

Quote tokensCopy Anchor Link

A token trades against SOL unless you name a quote_mint: USDC, or a token on pump.fun's quote-control list. It then trades, pays its creator fees and pays its route in that token. relayfor.si credits USDC at $1, and sells any other quote token for USDC before crediting it.

Its opening buy is opening_buy_amount, in the quote token's base units: 5000000 is 5 USDC, paid from the creator's own account for it. Every amount in the API is base units, as on chain. A Token-2022 quote with a scaled UI amount (an xStock) or interest reads differently in wallets: turn a typed amount into base units with Token-2022's UiAmountToAmount.

Older walletsCopy Anchor Link

Launches are version 1 transactions, Solana's newer format. A wallet that can't sign version 1 yet says so in supportedTransactionVersions; ask for "transaction_version": 0 for it: a version 0 transaction that loads shared accounts from relayfor.si's lookup table. A version 0 launch carries no opening buy.

Without a serverCopy Anchor Link

A project with no developer launches from the dashboard's Launch page. It builds the same launch with your strategy and route preview, and signs with the Solana wallet connected in your browser.