> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt
> Use this file to discover all available pages before exploring further.
# Actions
> Run Meteora Invent CLI workflows for onchain actions across Meteora programs.
Launch anything and do any onchain action on Meteora in just a few configurations and commands. Meteora Invent helps you test fast and launch fast with reusable configs and CLI actions.
Using an AI agent? Install the [Meteora Agent Skill](/agents/skill) — it ships in the same repository (`skills/meteora`) and teaches agents every action on this page with dry-run and confirmation safety gates built in.
# Prerequisites
* Node.js >= 22.12.0
* pnpm >= 10.0.0
*If you don't have pnpm installed, you can install it by running the following command.*
```bash Terminal theme={"system"}
npm install -g pnpm
```
# Steps
Meteora Invent is a toolkit consisting of everything you need to invent innovative token launches on Meteora. Run the following command in your terminal to get started.
```bash Terminal theme={"system"}
git clone https://github.com/MeteoraAg/meteora-invent.git
```
Once you've cloned the repository, you'll have a new project directory with a meteora-invent folder. Run the following to install pnpm and the project dependencies.
```bash Terminal theme={"system"}
cd meteora-invent
pnpm install
```
Copy the `.env.example` file to `.env` and configure the environment variables.
```bash Terminal theme={"system"}
cp studio/.env.example studio/.env
```
Configure the following variables:
* `PRIVATE_KEY` - Your private key for the wallet you will be using to deploy the pool.
You can also run the studio scripts on localnet - [http://localhost:8899](http://localhost:8899) with the following command
```bash Terminal theme={"system"}
pnpm studio start-test-validator
```
This will start a local validator on your machine which will be hosted on `http://localhost:8899`.
Generate a keypair from your private key:
```bash Terminal theme={"system"}
# For devnet (airdrops 5 SOL)
pnpm studio generate-keypair --network devnet --airdrop
# For localnet (airdrops 5 SOL)
# Ensure that you have already started the local validator with pnpm start-test-validator
pnpm studio generate-keypair --network localnet --airdrop
```
This will generate a `keypair.json` file in the `studio` directory which will be used for all actions.
Configure the config files in the `studio/config` directory.
* Configure [DLMM](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/dlmm_config.jsonc)
* Configure [DAMM v2](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/damm_v2_config.jsonc)
* Configure [DAMM v1](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/damm_v1_config.jsonc)
* Configure [DBC](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/dbc_config.jsonc)
* Configure [Alpha Vault](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/alpha_vault_config.jsonc)
* Configure [Presale Vault](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/presale_vault_config.jsonc)
* Configure [Met Lock](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/lock_config.jsonc)
* Configure [Dynamic Vault](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/dynamic_vault_config.jsonc)
* Configure [Dynamic Fee Sharing](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/fee_sharing_config.jsonc)
* Configure [Pool Farms](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/farming_config.jsonc)
* Configure [Zap](https://github.com/MeteoraAg/meteora-invent/blob/main/studio/config/zap_config.jsonc)
After configuring the settings in the JSON files, you can choose the action you want to perform.
Timestamp fields in these templates ship as placeholder dates that have already passed. Replace them with future values before you run an action that uses them, such as a presale end time, an Alpha Vault deposit window, or a vesting cliff.
# Actions
## DLMM
Launch a DLMM customizable launch pool
Seed Liquidity with your preferred curve
Seed Liquidity in a single bin
Set your DLMM Pool Status
Place a bid or ask limit order on your DLMM pool
List your open limit orders with fill status
Cancel limit orders and withdraw proceeds
Swap tokens on a DLMM pool with a quote and slippage protection
Claim swap fees and LM rewards across your DLMM positions
List your DLMM positions with bin ranges, amounts, and unclaimed fees
## DAMM v2
Launch a DAMM v2 balanced pool
Launch a DAMM v2 one-sided pool
Split an existing LP Position on DAMM v2 pool
Claim an existing DAMM v2 pool position fee
Add liquidity to an existing DAMM v2 pool position
Remove liquidity from an existing DAMM v2 pool position (includes refresh vesting and closing position)
Close an existing DAMM v2 pool position
Swap tokens on a DAMM v2 pool (Token-2022 aware)
List your DAMM v2 positions with liquidity and unclaimed fees
## DAMM v1
Launch a DAMM v1 constant product launch pool
Lock liquidity for a DAMM v1 pool
Create a Stake2Earn Farm for a DAMM v1 pool
Lock liquidity for a Stake2Earn Farm pool
Swap tokens on a DAMM v1 pool
## DBC
Launch a Dynamic Bonding Curve token pool
Create a Dynamic Bonding Curve config containing the settings for pre-graduation and post-graduation pools
Claim partner and/or creator trading fees for a DBC pool
Migrate your DBC pool to a DAMM v1 pool
Migrate your DBC pool to a DAMM v2 pool
Swap (Buy/Sell) tokens on a DBC pool
Read graduation progress, migration state, reserves, and unclaimed fees
## Alpha Vault
Create an Alpha Vault with an already existing DAMM v1 or DAMM v2 or DLMM pool
Deposit quote tokens into a vault, with the merkle proof fetched for you on permissioned vaults
Withdraw a deposit during the deposit phase of a prorata vault
Claim your vested tokens once the vault has bought from the pool
Recover the unused portion of a prorata deposit after the vault has filled
Run the permissionless crank that buys from the pool until the vault is filled
Read the vault mode, phase, caps, and totals, plus your own escrow when a keypair is present
## Presale Vault
Create a Fixed Price or FCFS or Prorata Presale Vault
Deposit quote tokens into a presale tier, creating your escrow in the same transaction
Withdraw a deposit while the presale still allows it
Claim your purchased tokens, including the vesting schedule when one is set
Sweep the unused quote left over across every tier you deposited into
Reclaim escrow rent once your escrow is fully settled
Withdraw the raise as the creator, optionally collecting the deposit fee
Refund or burn the base tokens the presale did not sell
Read progress, totals, average price, and per-tier state, or find a presale by its base mint
## Met Lock
Lock any SPL or Token-2022 mint for a recipient on a cliff and vesting schedule
Attach a name and contact details to an escrow so recipients can identify it
Claim whatever has vested so far as the escrow recipient
Read one escrow's schedule, total locked, claimed, and claimable amounts
List every escrow where a wallet is the recipient or the creator
## Stake2Earn
Stake tokens into a DAMM v1 pool's fee farm to earn a share of trading fees
Claim the fees your stake has earned in both pool tokens
Begin the unstake cooldown, saving the unstake address you will need to finish it
Cancel a pending unstake to restake, or withdraw once the cooldown has passed
Read the farm's top-list threshold and your staked amount, pending fees, and open unstakes
## Pool Farms
Stake DAMM v1 LP tokens into a reward farm
Withdraw some or all of your staked LP tokens
Claim accumulated rewards from a single farm
Batch reward claims across a list of farms
Read the farm's staking mint, total staked, reward schedule, and your own position
## Dynamic Vault
Deposit a token into its dynamic vault to earn lending yield on idle balances
Redeem vault LP shares back into the underlying token
Read total supply, withdrawable amount, virtual price, and your redemption value
## Dynamic Fee Sharing
Split a fee stream between up to five recipients on fixed shares
Transfer tokens straight into a fee vault for distribution
Hand a position's NFT to the fee vault so the vault can claim its fees
Claim a vault-owned position's trading fees directly into the fee vault
Claim a vault-owned position's reward emissions into the fee vault
Route DBC creator or partner trading fees, surplus, or migration fees into the fee vault
Claim whatever your share of the vault has accrued
Read the recipient split, funded totals, and each share's claimed and claimable amounts
## Zap
Enter a DAMM v2 position with a single token, sourcing the other side from the pool itself
Enter a DLMM position with a single token, pricing the rebalancing swap against Jupiter
Remove liquidity from a DAMM v2 or DLMM position and exit into a single token