pump-kit 0.0.1

package/dist/types/utils/transaction.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Transaction building, sending, confirmation, and simulation utilities.
+ */
+import type { Commitment } from "@solana/rpc-types";
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+import type { RpcClient, RpcSubscriptionsClient } from "../config/connection";
+import { type TransactionMessageWithBlockhashLifetime } from "@solana/transaction-messages";
+export interface TransactionResult {
+    signature: string;
+    slot?: number | bigint | null;
+}
+export interface BuildTransactionParams {
+    instructions: readonly Instruction[];
+    payer: Address | TransactionSigner;
+    /** Optional additional signers that should be associated with the transaction message. */
+    additionalSigners?: readonly TransactionSigner[];
+    /** Optional override for the blockhash lifetime. */
+    latestBlockhash?: string;
+    /** Optional override for the last valid block height associated with the blockhash. */
+    lastValidBlockHeight?: bigint | number;
+    /** Instructions to insert ahead of the provided instruction list (e.g. priority fee config). */
+    prependInstructions?: readonly Instruction[];
+    /** Instructions to append after the provided instruction list. */
+    appendInstructions?: readonly Instruction[];
+    /** Optional priority fee instructions to prepend automatically. */
+    priorityFees?: PriorityFeeOptions;
+    /** Transaction message version. Defaults to legacy. */
+    version?: "legacy" | 0;
+    /** Custom RPC client (useful for testing). */
+    rpc: RpcClient;
+    /** Commitment to use when fetching the latest blockhash. */
+    commitment?: Commitment;
+}
+export interface BuiltTransaction {
+    transactionMessage: TransactionMessageWithSignersLifetime;
+    latestBlockhash: string;
+    lastValidBlockHeight: bigint;
+}
+type TransactionMessageWithSignersLifetime = TransactionMessageWithBlockhashLifetime;
+export interface SendOptions {
+    abortSignal?: AbortSignal;
+    skipPreflight?: boolean;
+    maxRetries?: number;
+    minContextSlot?: number;
+    preflightCommitment?: Commitment;
+}
+export interface SendAndConfirmTransactionParams extends Omit<BuildTransactionParams, "payer"> {
+    payer: TransactionSigner;
+    sendOptions?: SendOptions;
+    rpc: RpcClient;
+    rpcSubscriptions: RpcSubscriptionsClient;
+    commitment?: Commitment;
+}
+export interface SimulateTransactionOptions {
+    commitment?: Commitment;
+    sigVerify?: boolean;
+    replaceRecentBlockhash?: boolean;
+    minContextSlot?: number;
+    accounts?: {
+        encoding?: "base64" | "base64+zstd" | "jsonParsed";
+        addresses: readonly string[];
+    };
+}
+export interface SimulateTransactionParams extends Omit<BuildTransactionParams, "payer"> {
+    payer: TransactionSigner;
+    additionalSigners?: readonly TransactionSigner[];
+    options?: SimulateTransactionOptions;
+    rpc: RpcClient;
+    commitment?: Commitment;
+}
+export interface SimulationResponse {
+    context: {
+        slot: number;
+    };
+    value: {
+        err: unknown;
+        logs: readonly string[] | null;
+        unitsConsumed?: number;
+        accounts?: unknown;
+        returnData?: unknown;
+    };
+}
+/**
+ * Builds a transaction message from the provided instructions and payer, attaching
+ * a recent blockhash lifetime and any supplied signers.
+ */
+export declare function buildTransaction({ instructions, payer, additionalSigners, latestBlockhash, lastValidBlockHeight, version, rpc: rpcClient, commitment, prependInstructions, appendInstructions, priorityFees, }: BuildTransactionParams): Promise<BuiltTransaction>;
+/**
+ * Signs, sends, and waits for confirmation of the supplied instructions using the provided signer.
+ */
+export declare function sendAndConfirmTransaction({ instructions, payer, additionalSigners, latestBlockhash, lastValidBlockHeight, version, prependInstructions, appendInstructions, priorityFees, rpc: rpcClient, rpcSubscriptions: rpcSubscriptionsClient, commitment, sendOptions, }: SendAndConfirmTransactionParams): Promise<TransactionResult>;
+/**
+ * Simulates the provided set of instructions without broadcasting the transaction.
+ */
+export declare function simulateTransaction({ instructions, payer, additionalSigners, latestBlockhash, lastValidBlockHeight, version, prependInstructions, appendInstructions, priorityFees, rpc: rpcClient, commitment, options, }: SimulateTransactionParams): Promise<SimulationResponse>;
+export interface PriorityFeeOptions {
+    computeUnitLimit?: number;
+    computeUnitPriceMicroLamports?: number | bigint;
+}
+export declare function buildPriorityFeeInstructions(priorityFees?: PriorityFeeOptions): Instruction[];
+export {};

package/dist/types/utils/wsol.d.ts

@@ -0,0 +1,18 @@
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+export interface WrapSolParams {
+    owner: TransactionSigner | Address | string;
+    amount: bigint;
+    payer?: TransactionSigner | Address | string;
+    associatedTokenAddress?: Address | string;
+    createAta?: boolean;
+    autoClose?: boolean;
+}
+export interface WrapSolInstructions {
+    prepend: Instruction[];
+    append: Instruction[];
+    associatedTokenAddress: Address;
+}
+export declare function buildWrapSolInstructions(params: WrapSolParams): WrapSolInstructions;
+export declare function buildUnwrapSolInstructions(owner: TransactionSigner | Address | string, associatedTokenAddress?: Address | string): Instruction<string, readonly (import("@solana/instructions").AccountMeta<string> | import("@solana/instructions").AccountLookupMeta<string, string>)[]>[];
+export declare const WSOL_ADDRESS = "So11111111111111111111111111111111111111112";
+export declare const WSOL = "So11111111111111111111111111111111111111112";

package/metadata/social.json

@@ -0,0 +1,8 @@
+{
+  "preview": "@pump-kit.png",
+  "ogImage": "@pump-kit.png",
+  "twitterImage": "@pump-kit.png",
+  "twitterCard": "summary_large_image",
+  "alt": "Pump Kit preview"
+}
+

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "pump-kit",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./simple": {
+      "types": "./dist/types/simple.d.ts",
+      "import": "./dist/simple.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "MIGRATION.md",
+    "LICENSE",
+    "@pump-kit.png",
+    "metadata"
+  ],
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.1.0"
+  },
+  "scripts": {
+    "dev:typecheck": "tsc -p tsconfig.json --noEmit",
+    "build:js": "bun build ./src/index.ts --outdir dist --format esm --minify --sourcemap=external",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && bun run build:js && bun run build:types",
+    "release:prepare": "bun run build && bun run test",
+    "release:publish": "npm publish --access public",
+    "release:dry-run": "npm publish --access public --dry-run",
+    "codegen": "bun run scripts/codama-generate.ts",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@codama/nodes-from-anchor": "^1.2.9",
+    "@codama/renderers-js": "^1.4.3",
+    "@types/bun": "^1.3.1",
+    "@types/node": "^24.9.2",
+    "codama": "^1.3.7",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@solana/kit": "^5.0.0",
+    "@solana/spl-token": "^0.4.14",
+    "buffer": "^6.0.3"
+  }
+}