pump-kit 0.2.4 → 0.2.5

package/metadata/actions-registry.json

@@ -0,0 +1,278 @@
+{
+  "schemaVersion": "1.0.0",
+  "package": "pump-kit",
+  "entrypoints": [
+    "pump-kit",
+    "pump-kit/simple"
+  ],
+  "jsonConventions": {
+    "bigintEncoding": "decimal-string",
+    "notes": [
+      "When invoking from JSON tools, encode bigint inputs as strings, then cast to BigInt in runtime code.",
+      "All slippage values are basis points (bps)."
+    ]
+  },
+  "actions": [
+    {
+      "name": "buy",
+      "entrypoint": "pump-kit",
+      "mapsTo": "curveBuy",
+      "description": "Alias for curve buy."
+    },
+    {
+      "name": "sell",
+      "entrypoint": "pump-kit",
+      "mapsTo": "curveSell",
+      "description": "Alias for curve sell."
+    },
+    {
+      "name": "curveBuy",
+      "entrypoint": "pump-kit",
+      "description": "Build bonding-curve buy instruction with slippage guard.",
+      "requiredParams": [
+        "user",
+        "mint",
+        "solAmount",
+        "rpc"
+      ],
+      "optionalParams": [
+        "slippageBps",
+        "feeRecipient",
+        "bondingCurveCreator",
+        "trackVolume",
+        "curveStateOverride",
+        "feeStructureOverride",
+        "allowAtaCreation",
+        "commitment"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "curveSell",
+      "entrypoint": "pump-kit",
+      "description": "Build bonding-curve sell instruction using fixed token amount or wallet percentage.",
+      "requiredParams": [
+        "user",
+        "mint",
+        "rpc"
+      ],
+      "optionalParams": [
+        "tokenAmount",
+        "useWalletPercentage",
+        "walletPercentage",
+        "tokenDecimals",
+        "slippageBps",
+        "feeRecipient",
+        "bondingCurveCreator",
+        "curveStateOverride",
+        "feeStructureOverride",
+        "commitment"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "ammBuy",
+      "entrypoint": "pump-kit",
+      "description": "Build AMM buy instruction from a SOL budget.",
+      "requiredParams": [
+        "user",
+        "mint",
+        "solAmount",
+        "rpc"
+      ],
+      "optionalParams": [
+        "slippageBps",
+        "poolAddress",
+        "poolCreator",
+        "poolIndex",
+        "quoteMint",
+        "allowTrackVolume",
+        "commitment"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "ammSell",
+      "entrypoint": "pump-kit",
+      "description": "Build AMM sell instruction using fixed amount or wallet percentage.",
+      "requiredParams": [
+        "user",
+        "mint",
+        "rpc"
+      ],
+      "optionalParams": [
+        "tokenAmount",
+        "tokenDecimals",
+        "slippageBps",
+        "useWalletPercentage",
+        "walletPercentage",
+        "poolAddress",
+        "poolCreator",
+        "poolIndex",
+        "quoteMint",
+        "allowTrackVolume",
+        "commitment"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "addLiquidity",
+      "entrypoint": "pump-kit",
+      "description": "Build AMM liquidity deposit instruction.",
+      "requiredParams": [
+        "user",
+        "baseMint",
+        "maxBaseAmountIn",
+        "maxQuoteAmountIn"
+      ],
+      "optionalParams": [
+        "quoteMint",
+        "poolIndex",
+        "poolAddress",
+        "poolCreator",
+        "minLpTokensOut",
+        "tokenProgram",
+        "token2022Program"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "removeLiquidity",
+      "entrypoint": "pump-kit",
+      "description": "Build AMM liquidity withdraw instruction.",
+      "requiredParams": [
+        "user",
+        "baseMint",
+        "lpAmountIn"
+      ],
+      "optionalParams": [
+        "quoteMint",
+        "poolIndex",
+        "poolAddress",
+        "poolCreator",
+        "minBaseAmountOut",
+        "minQuoteAmountOut",
+        "tokenProgram",
+        "token2022Program"
+      ],
+      "returns": "Instruction"
+    },
+    {
+      "name": "mintWithFirstBuy",
+      "entrypoint": "pump-kit",
+      "description": "Create token mint + initial curve buy instructions.",
+      "requiredParams": [
+        "user",
+        "mint",
+        "mintAuthority",
+        "name",
+        "symbol",
+        "uri",
+        "firstBuyTokenAmount",
+        "estimatedFirstBuyCost",
+        "rpc"
+      ],
+      "optionalParams": [
+        "slippageBps",
+        "feeRecipient",
+        "bondingCurveCreator",
+        "trackVolume",
+        "commitment"
+      ],
+      "returns": "MintAndBuyInstructions"
+    },
+    {
+      "name": "createAndBuy",
+      "entrypoint": "pump-kit",
+      "description": "Generate mint signer, create mint+buy instructions, then send+confirm transaction.",
+      "requiredParams": [
+        "creator",
+        "metadata",
+        "firstBuyTokenAmount",
+        "estimatedFirstBuyCost",
+        "rpc",
+        "rpcSubscriptions"
+      ],
+      "optionalParams": [
+        "slippageBps",
+        "feeRecipient",
+        "bondingCurveCreator",
+        "mintAuthority",
+        "mint",
+        "priorityFees",
+        "prependInstructions",
+        "appendInstructions",
+        "additionalSigners",
+        "sendOptions",
+        "commitment"
+      ],
+      "returns": "CreateAndBuyResult"
+    },
+    {
+      "name": "buildTransaction",
+      "entrypoint": "pump-kit",
+      "description": "Build transaction message with optional priority fee and prepend/append instruction hooks.",
+      "requiredParams": [
+        "instructions",
+        "payer",
+        "rpc"
+      ],
+      "optionalParams": [
+        "additionalSigners",
+        "latestBlockhash",
+        "lastValidBlockHeight",
+        "prependInstructions",
+        "appendInstructions",
+        "priorityFees",
+        "version",
+        "commitment"
+      ],
+      "returns": "BuiltTransaction"
+    },
+    {
+      "name": "sendAndConfirmTransaction",
+      "entrypoint": "pump-kit",
+      "description": "Build, sign, send, and confirm transaction.",
+      "requiredParams": [
+        "instructions",
+        "payer",
+        "rpc",
+        "rpcSubscriptions"
+      ],
+      "optionalParams": [
+        "additionalSigners",
+        "latestBlockhash",
+        "lastValidBlockHeight",
+        "prependInstructions",
+        "appendInstructions",
+        "priorityFees",
+        "version",
+        "sendOptions",
+        "commitment"
+      ],
+      "returns": "TransactionResult"
+    },
+    {
+      "name": "simulateTransaction",
+      "entrypoint": "pump-kit",
+      "description": "Build and simulate transaction without sending.",
+      "requiredParams": [
+        "instructions",
+        "payer",
+        "rpc"
+      ],
+      "optionalParams": [
+        "additionalSigners",
+        "latestBlockhash",
+        "lastValidBlockHeight",
+        "prependInstructions",
+        "appendInstructions",
+        "priorityFees",
+        "version",
+        "options",
+        "commitment"
+      ],
+      "returns": "SimulationResponse"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pump-kit",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "type": "module",
   "exports": {
     ".": {
@@ -15,7 +15,9 @@
   "files": [
     "dist",
     "README.md",
-    "@pump-kit.png"
+    "@pump-kit.png",
+    "llms.txt",
+    "metadata/actions-registry.json"
   ],
   "license": "MIT",
   "engines": {

package/dist/types/ammsdk/generated/types/globalConfig.d.ts

@@ -1,49 +0,0 @@
-/**
- * This code was AUTOGENERATED using the Codama library.
- * Please DO NOT EDIT THIS FILE, instead use visitors
- * to add features, then rerun Codama to update it.
- *
- * @see https://github.com/codama-idl/codama
- */
-import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
-export type GlobalConfig = {
-    /** The admin pubkey */
-    admin: Address;
-    /** The lp fee in basis points (0.01%) */
-    lpFeeBasisPoints: bigint;
-    /** The protocol fee in basis points (0.01%) */
-    protocolFeeBasisPoints: bigint;
-    /**
-     * Flags to disable certain functionality
-     * bit 0 - Disable create pool
-     * bit 1 - Disable deposit
-     * bit 2 - Disable withdraw
-     * bit 3 - Disable buy
-     * bit 4 - Disable sell
-     */
-    disableFlags: number;
-    /** Addresses of the protocol fee recipients */
-    protocolFeeRecipients: Array<Address>;
-};
-export type GlobalConfigArgs = {
-    /** The admin pubkey */
-    admin: Address;
-    /** The lp fee in basis points (0.01%) */
-    lpFeeBasisPoints: number | bigint;
-    /** The protocol fee in basis points (0.01%) */
-    protocolFeeBasisPoints: number | bigint;
-    /**
-     * Flags to disable certain functionality
-     * bit 0 - Disable create pool
-     * bit 1 - Disable deposit
-     * bit 2 - Disable withdraw
-     * bit 3 - Disable buy
-     * bit 4 - Disable sell
-     */
-    disableFlags: number;
-    /** Addresses of the protocol fee recipients */
-    protocolFeeRecipients: Array<Address>;
-};
-export declare function getGlobalConfigEncoder(): FixedSizeEncoder<GlobalConfigArgs>;
-export declare function getGlobalConfigDecoder(): FixedSizeDecoder<GlobalConfig>;
-export declare function getGlobalConfigCodec(): FixedSizeCodec<GlobalConfigArgs, GlobalConfig>;

package/dist/types/ammsdk/generated/types/pool.d.ts

@@ -1,35 +0,0 @@
-/**
- * This code was AUTOGENERATED using the Codama library.
- * Please DO NOT EDIT THIS FILE, instead use visitors
- * to add features, then rerun Codama to update it.
- *
- * @see https://github.com/codama-idl/codama
- */
-import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
-export type Pool = {
-    poolBump: number;
-    index: number;
-    creator: Address;
-    baseMint: Address;
-    quoteMint: Address;
-    lpMint: Address;
-    poolBaseTokenAccount: Address;
-    poolQuoteTokenAccount: Address;
-    /** True circulating supply without burns and lock-ups */
-    lpSupply: bigint;
-};
-export type PoolArgs = {
-    poolBump: number;
-    index: number;
-    creator: Address;
-    baseMint: Address;
-    quoteMint: Address;
-    lpMint: Address;
-    poolBaseTokenAccount: Address;
-    poolQuoteTokenAccount: Address;
-    /** True circulating supply without burns and lock-ups */
-    lpSupply: number | bigint;
-};
-export declare function getPoolEncoder(): FixedSizeEncoder<PoolArgs>;
-export declare function getPoolDecoder(): FixedSizeDecoder<Pool>;
-export declare function getPoolCodec(): FixedSizeCodec<PoolArgs, Pool>;