# Pump.Fun Launch Coin Tool

#### Pump.fun Launch Coin Tool (`pumpfun_launch_coin_tool`)

Launches a **brand new SPL token directly onto the Pump.fun platform**. This involves creating the token, setting its metadata (name, symbol, image, socials), and optionally making an initial SOL purchase. **This is an on-chain action with real costs and creates a publicly tradable token.**

{% hint style="info" %}
**Inputs:** Requires creator's wallet, new token details, and image URL. Social links and initial SOL buy-in are optional.
{% endhint %}

```python
class PumpFunLaunchCoinInput(BaseModel):
    agent_public: str     # Creator's public key
    agent_private: str    # Creator's ENCRYPTED private key
    token_name: str       # Name for the new token (e.g., "Lumo Test Coin")
    token_symbol: str     # Symbol for the new token (e.g., "LTC01")
    description: str      # Description of the new token
    image_url: str        # URL to the token's image (must be valid)
    twitter_url: Optional[str]  # Optional Twitter link
    telegram_url: Optional[str] # Optional Telegram link
    website: Optional[str]      # Optional website link
    amount: float = 0.0   # Optional SOL amount to buy into the new token
```

***

**Key Functionality:**

* Securely decrypts the creator's private key.
* Validates all provided token metadata and URLs.
* Uploads token metadata (name, symbol, description, image, socials) to IPFS via Pump.fun's API.
* Constructs and executes the on-chain transaction to create the new token and its bonding curve on Pump.fun, including any initial SOL investment specified.

***

**Sample Usage Queries (How an AI might use it):** *(These imply the agent has access to or will securely prompt for necessary wallet details)*

* "Launch a new token on Pump.fun named 'Awesome Token' with symbol 'AWSM', description 'An awesome new token!', and image `image_url_here`."
* "I want to create a coin called 'FARTCOIN' (FRT) on Pump.fun. Description: 'The next big thing'. Image: `url_to_fart_image`. Also add Twitter `twitter_link` and buy 0.1 SOL worth."
* "Help me launch 'GOAT Token' (GOAT) on Pump.fun with description 'Greatest Of All Tokens', image `goat_pic_url`, and Telegram `tg_link`."
* "Create a Pump.fun coin: Name 'Lumo Launcher', Symbol 'LLAUNCH', Desc 'Test launch by LumoKit', Image `lumo_logo_url`, Website `lumolabs.ai`."
* "Launch a token with these details: Name: ..., Symbol: ..., Description: ..., Image: ..., and invest 0.05 SOL."

***

**Quick Code Glance:**

```python
class PumpFunLaunchCoinTool(BaseTool):
    name: ClassVar[str] = "pumpfun_launch_coin_tool"
    description: ClassVar[str] = "Launch a new token on Pump.fun platform. Requires token details and agent wallet information."
    args_schema: ClassVar[Type[BaseModel]] = PumpFunLaunchCoinInput
```

***

**⚠️ CRITICAL INFORMATION / WARNINGS:**

* **Real Token Creation & Costs:** This tool launches a live SPL token on Pump.fun. This is an **irreversible on-chain action** and will incur Solana network fees and any fees associated with Pump.fun's service. The optional `amount` is real SOL spent.
* **Encrypted Private Key:** Requires the creator's **encrypted** private key. Secure handling is essential.
* **Metadata & Image:** All required metadata (name, symbol, description, image URL) must be valid and appropriate. The image URL must be publicly accessible.
* **Pump.fun Platform:** Relies on Pump.fun's APIs and platform rules.
* **Network Dependent:** Interacts with Solana RPC and Pump.fun's infrastructure.
* **Asynchronous:** Primarily designed for asynchronous execution (`_arun`).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.lumolabs.ai/tools/pump.fun-launch-coin-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.