Skip to main content

​
Overview

Some endpoints support adding an optional tip to a wallet of your choice. This lets you direct a portion of lamports to any provider (e.g., Jito, Astral) or a wallet you control when constructing transactions. By default, all transactions generated by these endpoints already include appropriate Compute Budget instructions:
  • setComputeUnitLimit and setComputeUnitPrice are set to optimize for reliable inclusion and cost-efficiency.
  • No tip is included by default. Tips are only added when you provide tipWallet and tipLamports.

​
Supported endpoints

  • POST /token-launch/create-config
  • POST /token-launch/create-launch-transaction
  • POST /token-launch/fee-share/create-config
These endpoints accept two optional fields in the request body:
  • tipWallet (string): Base58 encoded Solana public key of the tip recipient wallet.
  • tipLamports (number): Tip amount in lamports.
If omitted, no tip is included.

​
How it works

When you include tipWallet and tipLamports, the API appends a tip transfer as the final instruction in the generated transaction(s). Priority fee settings (setComputeUnitLimit and setComputeUnitPrice) are always included regardless of tipping. You are responsible for:
  • Submitting and confirming the returned transaction(s)
  • Ensuring the provided tipWallet is valid and owned by the intended provider
  • Choosing an appropriate tipLamports value
Notes:
  • Tipping is purely optional and does not affect endpoint functionality when omitted.
  • There is no provider/key allowlist. You can use any valid Base58 encoded Solana public key for tipWallet.
  • The transaction fee payer funds both the network fees and the tipLamports transfer. Ensure the payer has sufficient SOL for all costs.

​
Example payloads

Add a tip when creating a token launch transaction: 
{
  "ipfs": "ipfs://...",
  "tokenMint": "...",
  "wallet": "...",
  "initialBuyLamports": 25000000,
  "configKey": "...",
  "tipWallet": "JitoOrAstralWalletBase58...",
  "tipLamports": 100000
}
Add a tip when creating a fee-share config: 
{
  "walletA": "...",
  "walletB": "...",
  "walletABps": 5000,
  "walletBBps": 5000,
  "payer": "...",
  "baseMint": "...",
  "quoteMint": "...",
  "tipWallet": "TipRecipientBase58...",
  "tipLamports": 100000
}
You can use any valid Base58 Solana address for tipWallet. For compact transactions, we recommend using a recipient that is already included in our public Address Lookup Table (LUT): Eq1EVs15EAWww1YtPTtWPzJRLPJoS6VYP9oW9SbNr3yp. See Address Lookup Tables for details. Current provider recipients included in the LUT:
  • Jito:
    • 96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5
    • HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe
    • Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY
    • ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49
    • DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh
    • ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt
    • DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL
    • 3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT
  • bloXroute:
    • HWEoBxYs7ssKuudEjzjmpfJVX7Dvi7wescFsVx2L5yoY
    • 95cfoy472fcQHaw4tPGBTKpn6ZQnfEPfBgDQx6gcRmRg
    • 3UQUKjhMKaY2S6bjcQD6yHB7utcZt5bfarRCmctpRtUd
    • FogxVNs6Mm2w9rnGL1vkARSwJxvLE8mujTv3LK8RnUhF
  • Astral:
    • astrazznxsGUhWShqgNtAdfrzP2G83DzcWVJDxwV9bF
    • astra4uejePWneqNaJKuFFA8oonqCE1sqF6b45kDMZm
    • astra9xWY93QyfG6yM8zwsKsRodscjQ2uU2HKNL5prk
    • astraRVUuTHjpwEVvNBeQEgwYx9w9CFyfxjYoobCZhL
    • astraEJ2fEj8Xmy6KLG7B3VfbKfsHXhHrNdCQx7iGJK
    • astraubkDw81n4LuutzSQ8uzHCv4BhPVhfvTcYv8SKC
    • astraZW5GLFefxNPAatceHhYjfA1ciq9gvfEg2S47xk
    • astrawVNP4xDBKT7rAdxrLYiTSTdqtUr63fSMduivXK
If you have additional providers to recommend for inclusion in the LUT, reach out to us.

​
Validation and limits

  • tipWallet must be a valid Base58 encoded Solana public key (any key is allowed; no allowlist)
  • tipLamports must be a positive integer within your balance constraints
  • The API does not currently enforce provider allowlists; use caution and verify recipients

​
Troubleshooting

  • If a transaction fails to simulate or send, verify your tipWallet, tipLamports, and that your payer has sufficient SOL.
  • If you do not see the tip reflected on-chain, confirm the final submitted transaction includes the tip instruction and was confirmed.