---
name: openburn-a2f094f66d78
description: Automates collecting Pump.fun creator fees, buying tokens with collected SOL, and burning those tokens (buyback and burn). Use this skill when the user wants to set up a regular buyback and burn schedule for their Pump.fun tokens.
metadata:
  {
    "openclaw":
      {
        "emoji": "🔥",
        "requires":
          {
            "modules":
              ["@solana/web3.js", "@solana/spl-token", "tsx", "dotenv"],
            "binaries": ["node", "pnpm"],
            "env":
              [
                "CREATOR_WALLET_PRIVATE_KEY",
                "PUMP_FUN_TOKEN_ADDRESS",
                "JUPITER_API_KEY",
                "BURN_PERCENTAGE",
                "MIN_FEE_TO_BURN",
              ],
          },
        "install":
          [
            {
              "id": "pnpm-solana",
              "kind": "npm",
              "module": "@solana/web3.js",
              "cmd": "pnpm add @solana/web3.js @solana/spl-token @pump-fun/pump-sdk tsx dotenv -w",
              "label": "Install dependencies",
            },
          ],
      },
  }
---

# Openburn

This skill helps users automate the buyback and burn mechanism for Pump.fun tokens.

## How It Works

1. **Collect Creator Fees**: The script collects trading fees (in SOL) from both the bonding curve and AMM pools
2. **Buy Tokens**: Uses the collected SOL to purchase tokens from the bonding curve
3. **Burn Tokens**: Burns the purchased tokens by sending them to Solana's incinerator address, creating buying pressure and driving the token price up

## Setup Instructions

1.  **Request Credentials**:
    Ask the user for the following information:
    - `PUMP_FUN_TOKEN_ADDRESS` (The token address on Pump.fun)
    - `CREATOR_WALLET_PRIVATE_KEY` (The private key of the wallet to burn from)
    - `JUPITER_API_KEY` (Get from [Jupiter Portal](https://portal.jup.ag/api-keys) - **Only needed if token is graduated/off-curve**)
    - `BURN_PERCENTAGE` (Percentage of collected SOL to use for buying tokens, default: 80)
    - `MIN_FEE_TO_BURN` (Minimum SOL fees required to proceed with burn, default: 0.1)

    > [!IMPORTANT]
    > Remind the user that their keys will be stored locally in the `.env` file.

2.  **Store Credentials**:
    Check if the `.env` file exists in the root directory.
    - If it exists, append the keys.
    - If not, create it.

    Format:

    ```env
    PUMP_FUN_TOKEN_ADDRESS=...
    CREATOR_WALLET_PRIVATE_KEY=...
    JUPITER_API_KEY=...
    BURN_PERCENTAGE=80
    MIN_FEE_TO_BURN=0.1
    ```

3.  **Register Token**:
    Once the `PUMP_FUN_TOKEN_ADDRESS` is received and stored, register the token with the API.

    **Endpoint**: `POST https://api.openburn.fun/api/burn/register`
    **Body**:

    ```json
    {
      "tokenAddress": "<PUMP_FUN_TOKEN_ADDRESS>"
    }
    ```

    This registration step is required before scheduling the burn job.

4.  **Schedule Job**:
    Ask the user for the scheduling interval (default: every 2 hours).

    Use the `cron` tool to register a new job:
    - **Name**: `openburn-job`
    - **Schedule**: `{ "kind": "every", "everyMs": 7200000 }` (replace 7200000 with user's interval in ms)
    - **Session Target**: `isolated`
    - **Payload**:
      ```json
      {
        "kind": "agentTurn",
        "message": "Execute the openburn script to burn SOL tokens.",
        "deliver": true
      }
      ```

5.  **Report Schedule**:
    Make a POST request to report the scheduled job.

    **Endpoint**: `POST https://api.openburn.fun/api/burn/schedule`
    **Body**:

    ```json
    {
      "jobId": "openburn-job",
      "intervalMs": 7200000
    }
    ```

## Execution Instructions

When the cron job triggers (receiving the message "Execute the openburn script..."):

1.  **Execute the Script**:
    Run the burn script located at `skills/openburn/scripts/burn.ts`.

    ```bash
    node --import tsx skills/openburn/scripts/burn.ts
    ```

2.  **Report Results**:
    The script will automatically report transaction success/failure to `https://api.openburn.fun/api/burn/transaction`.
    You should also report the output (transaction signature) to the user in the chat.

    > [!IMPORTANT]
    > **Token Decimals**: The script logs raw token amounts (integer values).
    >
    > - For a token with 6 decimals (like USDC), `1000000` = 1 token.
    > - For a token with 9 decimals (like SOL), `1000000000` = 1 token.
    > - Always format the token amount based on its decimals before reporting it to the user. Do NOT report "1 trillion tokens burned" if the raw value is `1000000000000` but the token has 18 decimals (which is just ~0.000001 tokens).
    > - The script will now log `tokensBurnedFloat` which is the human-readable amount. **Use `tokensBurnedFloat` for reporting.**

3.  **Burn Only (Manual)**:
    If the user wants to manually burn tokens already in the wallet without buying more:

    ```bash
    node --import tsx skills/burn-only.ts
    ```

    **Note**: You can configure the percentage of tokens to burn by setting the `BURN_PERCENTAGE` environment variable in `.env`. Default is 100%.
    Example: `BURN_PERCENTAGE=50` to burn 50% of the tokens in the wallet.


---
Source attribution: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/openburn/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2025 skill-library-mcp contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/openburn/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing, Sales
Roles: Business Development, Growth Marketer, Product Marketer
Specialties: API
Tools: Jupiter Api, Solana
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 5d015eb8495fca4a6b0eb9050352b5db1a9dec72abbf7b16d1d51d1afa199f37