@openpump/sdk 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/resources/wallets.ts","../src/resources/tokens.ts","../src/resources/trading.ts","../src/resources/jobs.ts","../src/resources/creator-fees.ts","../src/resources/bundles.ts","../src/client.ts"],"sourcesContent":["// Client\nexport { OpenPump } from './client.js';\nexport type { OpenPumpConfig } from './client.js';\n\n// Errors\nexport {\n  OpenPumpError,\n  AuthenticationError,\n  RateLimitError,\n  ValidationError,\n  NotFoundError,\n  InsufficientFundsError,\n  TransactionError,\n} from './errors.js';\n\n// Resource types (re-export for consumer convenience)\nexport type {\n  Wallets,\n  CreateWalletOptions,\n  WalletInfo,\n  WalletBalance,\n  DepositInstructions,\n  TransferOptions,\n  TransferResult,\n  TransactionListOptions,\n  TransactionListResult,\n} from './resources/wallets.js';\nexport type {\n  Tokens,\n  CreateTokenOptions,\n  CreateTokenResult,\n  TokenListItem,\n  CurveState,\n} from './resources/tokens.js';\nexport type {\n  Trading,\n  BuyOptions,\n  BuyResult,\n  SellOptions,\n  SellResult,\n  QuoteOptions,\n  QuoteResult,\n  QuoteBuyCostOptions,\n  QuoteBuyCostResult,\n  BundleSellOptions,\n  BundleSellResult,\n  BundleSellEntry,\n  PriorityLevel,\n} from './resources/trading.js';\nexport type { Jobs, JobStatus, PollOptions } from './resources/jobs.js';\nexport type {\n  CreatorFees,\n  AccumulatedFees,\n  ClaimFeesResult,\n} from './resources/creator-fees.js';\nexport type {\n  Bundles,\n  BundleLaunchOptions,\n  BundleLaunchResult,\n} from './resources/bundles.js';\n","/**\n * Base error class for all OpenPump SDK errors.\n * All API errors are converted to typed exceptions.\n */\nexport class OpenPumpError extends Error {\n  override readonly name: string = 'OpenPumpError';\n\n  constructor(\n    public readonly code: string,\n    message: string,\n    public readonly status: number,\n    public readonly details?: unknown,\n  ) {\n    super(message);\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when the API key is invalid or missing (HTTP 401). */\nexport class AuthenticationError extends OpenPumpError {\n  override readonly name = 'AuthenticationError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when the rate limit is exceeded (HTTP 429). */\nexport class RateLimitError extends OpenPumpError {\n  override readonly name = 'RateLimitError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when request validation fails (HTTP 422). */\nexport class ValidationError extends OpenPumpError {\n  override readonly name = 'ValidationError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when the requested resource is not found (HTTP 404). */\nexport class NotFoundError extends OpenPumpError {\n  override readonly name = 'NotFoundError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when the wallet has insufficient SOL or tokens for an operation. */\nexport class InsufficientFundsError extends OpenPumpError {\n  override readonly name = 'InsufficientFundsError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when an on-chain transaction fails (signature error, simulation failure, etc.). */\nexport class TransactionError extends OpenPumpError {\n  override readonly name = 'TransactionError';\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(code, message, status, details);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import {\n  OpenPumpError,\n  AuthenticationError,\n  RateLimitError,\n  ValidationError,\n  NotFoundError,\n} from './errors.js';\n\nexport interface HttpClientConfig {\n  apiKey: string;\n  baseUrl: string;\n  timeout: number;\n}\n\nexport class HttpClient {\n  private readonly _apiKey: string;\n  private readonly _baseUrl: string;\n  private readonly _timeout: number;\n\n  constructor(config: HttpClientConfig) {\n    this._apiKey = config.apiKey;\n    // Strip trailing slash to normalise base URL\n    this._baseUrl = config.baseUrl.replace(/\\/+$/, '');\n    this._timeout = config.timeout;\n  }\n\n  async get<T>(path: string, query?: Record<string, string>): Promise<T> {\n    let url = `${this._baseUrl}${path}`;\n    if (query && Object.keys(query).length > 0) {\n      const params = new URLSearchParams(query);\n      url += `?${params.toString()}`;\n    }\n    const response = await fetch(url, {\n      headers: this._headers(),\n      signal: AbortSignal.timeout(this._timeout),\n    });\n    return this._handleResponse<T>(response);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    const init: RequestInit = {\n      method: 'POST',\n      headers: {\n        ...this._headers(),\n        'Content-Type': 'application/json',\n      },\n      signal: AbortSignal.timeout(this._timeout),\n    };\n    if (body !== undefined) {\n      init.body = JSON.stringify(body);\n    }\n    const response = await fetch(`${this._baseUrl}${path}`, init);\n    return this._handleResponse<T>(response);\n  }\n\n  async patch<T>(path: string, body: unknown): Promise<T> {\n    const response = await fetch(`${this._baseUrl}${path}`, {\n      method: 'PATCH',\n      headers: {\n        ...this._headers(),\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(this._timeout),\n    });\n    return this._handleResponse<T>(response);\n  }\n\n  async delete<T>(path: string): Promise<T> {\n    const response = await fetch(`${this._baseUrl}${path}`, {\n      method: 'DELETE',\n      headers: this._headers(),\n      signal: AbortSignal.timeout(this._timeout),\n    });\n    return this._handleResponse<T>(response);\n  }\n\n  private _headers(): Record<string, string> {\n    return { Authorization: `Bearer ${this._apiKey}` };\n  }\n\n  private async _handleResponse<T>(response: Response): Promise<T> {\n    if (!response.ok) {\n      await this._throwApiError(response);\n    }\n    const json = (await response.json()) as Record<string, unknown>;\n    // API wraps responses in { data: T } -- unwrap if present\n    if (json !== null && typeof json === 'object' && 'data' in json) {\n      return json['data'] as T;\n    }\n    return json as T;\n  }\n\n  private async _throwApiError(response: Response): Promise<never> {\n    let body: { error?: string; code?: string; message?: string; details?: unknown } = {};\n    try {\n      body = (await response.json()) as typeof body;\n    } catch {\n      // Non-JSON error body -- use status text\n    }\n\n    const code = body.code ?? body.error ?? 'UNKNOWN_ERROR';\n    const message = body.message ?? response.statusText;\n    const details = body.details;\n\n    switch (response.status) {\n    case 401: {\n      throw new AuthenticationError(code, message, 401, details);\n    }\n    case 404: {\n      throw new NotFoundError(code, message, 404, details);\n    }\n    case 422: {\n      throw new ValidationError(code, message, 422, details);\n    }\n    case 429: {\n      throw new RateLimitError(code, message, 429, details);\n    }\n    default: {\n      throw new OpenPumpError(code, message, response.status, details);\n    }\n    }\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport interface CreateWalletOptions {\n  label?: string;\n}\n\nexport interface WalletInfo {\n  id: string;\n  publicKey: string;\n  walletIndex: number;\n  label: string;\n  createdAt: string;\n}\n\nexport interface WalletBalance {\n  nativeSol: { lamports: string; sol: string };\n  tokens: Array<{\n    mint: string;\n    symbol: string | null;\n    amount: string;\n    decimals: number;\n    uiAmount: number;\n  }>;\n}\n\nexport interface DepositInstructions {\n  depositAddress: string;\n  minimums: { tokenCreation: string; bundleBuy: string; standardBuy: string };\n  instructions: string[];\n  disclaimer: string;\n  network: string;\n}\n\nexport interface TransferOptions {\n  toAddress: string;\n  amountLamports: string;\n  mint?: string | null;\n  memo?: string;\n  priorityFeeMicroLamports?: number;\n}\n\nexport interface TransferResult {\n  signature: string;\n  amountLamports: string;\n  fee: string;\n}\n\nexport interface TransactionListOptions {\n  type?: 'buy' | 'sell' | 'transfer';\n  limit?: number;\n  offset?: number;\n}\n\nexport interface TransactionListResult {\n  transactions: Array<Record<string, unknown>>;\n  total: number;\n  limit: number;\n  offset: number;\n}\n\nexport class Wallets {\n  constructor(private readonly _http: HttpClient) {}\n\n  /** List all active wallets for the authenticated user. */\n  async list(): Promise<WalletInfo[]> {\n    return this._http.get<WalletInfo[]>('/api/wallets');\n  }\n\n  /** Create a new wallet with an optional label. */\n  async create(options?: CreateWalletOptions): Promise<WalletInfo> {\n    return this._http.post<WalletInfo>('/api/wallets', options ?? {});\n  }\n\n  /** Get a single wallet by ID. */\n  async get(walletId: string): Promise<WalletInfo> {\n    return this._http.get<WalletInfo>(`/api/wallets/${walletId}`);\n  }\n\n  /** Get SOL + token balances for a wallet. */\n  async getBalance(walletId: string): Promise<WalletBalance> {\n    return this._http.get<WalletBalance>(`/api/wallets/${walletId}/balance`);\n  }\n\n  /** Get deposit address and SOL minimums for a wallet. */\n  async getDepositInstructions(walletId: string): Promise<DepositInstructions> {\n    return this._http.get<DepositInstructions>(`/api/wallets/${walletId}/deposit-instructions`);\n  }\n\n  /** Force a live RPC balance refresh, bypassing the 30s cache. */\n  async refreshBalance(walletId: string): Promise<WalletBalance> {\n    return this._http.post<WalletBalance>(`/api/wallets/${walletId}/refresh-balance`);\n  }\n\n  /**\n   * Execute an on-chain SOL or SPL token transfer.\n   *\n   * @example\n   * ```ts\n   * const result = await op.wallets.transfer('wallet-id', {\n   *   toAddress: 'recipient-public-key',\n   *   amountLamports: '100000000',\n   * });\n   * console.log(result.signature);\n   * ```\n   */\n  async transfer(walletId: string, options: TransferOptions): Promise<TransferResult> {\n    return this._http.post<TransferResult>(`/api/wallets/${walletId}/transfer`, options);\n  }\n\n  /** Get paginated transfer history for a wallet. */\n  async getTransactions(\n    walletId: string,\n    options?: TransactionListOptions,\n  ): Promise<TransactionListResult> {\n    const query: Record<string, string> = {};\n    if (options?.type !== undefined) query['type'] = options.type;\n    if (options?.limit !== undefined) query['limit'] = String(options.limit);\n    if (options?.offset !== undefined) query['offset'] = String(options.offset);\n    return this._http.get<TransactionListResult>(`/api/wallets/${walletId}/transactions`, query);\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport interface CreateTokenOptions {\n  walletIndex?: number;\n  name: string;\n  symbol: string;\n  description: string;\n  imageBase64: string;\n  imageType: 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/gif' | 'image/webp';\n  initialBuyAmountSol?: number;\n  twitter?: string;\n  telegram?: string;\n  website?: string;\n}\n\nexport interface CreateTokenResult {\n  tokenId: string;\n  mint: string;\n  signature: string;\n  metadataUri: string;\n  bondingCurveAccount: string;\n}\n\nexport interface TokenListItem {\n  id: string;\n  mintAddress: string;\n  name: string;\n  symbol: string;\n  graduationStatus: string;\n  metadataUri: string;\n  creatorAddress: string;\n  createdAt: string;\n}\n\nexport interface CurveState {\n  mint: string;\n  virtualTokenReserves: string;\n  virtualSolReserves: string;\n  realTokenReserves: string;\n  realSolReserves: string;\n  tokenTotalSupply: string;\n  complete: boolean;\n  isMayhemMode: boolean;\n  currentPriceSOL: number;\n  marketCapSOL: number;\n  graduationPercent: number;\n}\n\nexport class Tokens {\n  constructor(private readonly _http: HttpClient) {}\n\n  /** List tokens created by the authenticated user. */\n  async list(): Promise<TokenListItem[]> {\n    return this._http.get<TokenListItem[]>('/api/tokens');\n  }\n\n  /**\n   * Create a new PumpFun token with IPFS metadata upload.\n   *\n   * @example\n   * ```ts\n   * const token = await op.tokens.create({\n   *   name: 'My Token',\n   *   symbol: 'MTK',\n   *   description: 'A cool token',\n   *   imageBase64: 'base64-encoded-image...',\n   *   imageType: 'image/png',\n   * });\n   * console.log(token.mint);\n   * ```\n   */\n  async create(options: CreateTokenOptions): Promise<CreateTokenResult> {\n    return this._http.post<CreateTokenResult>('/api/tokens/create', options);\n  }\n\n  /** Get market info for a token (mainnet only, returns null on devnet). */\n  async getMarketInfo(mint: string): Promise<Record<string, unknown> | null> {\n    return this._http.get<Record<string, unknown> | null>(`/api/tokens/${mint}/market-info`);\n  }\n\n  /** Get bonding curve state including price, market cap, and graduation progress. */\n  async getCurveState(mint: string): Promise<CurveState> {\n    return this._http.get<CurveState>(`/api/tokens/${mint}/curve-state`);\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport type PriorityLevel = 'economy' | 'normal' | 'fast' | 'turbo';\n\nexport interface QuoteOptions {\n  action: 'buy' | 'sell';\n  solAmount?: string;\n  tokenAmount?: string;\n}\n\nexport interface QuoteResult {\n  route: 'bonding_curve' | 'pumpswap';\n  expectedTokens?: string;\n  expectedSol?: string;\n  priceImpact: number;\n  fee: number;\n  disclaimer: string;\n}\n\nexport interface QuoteBuyCostOptions {\n  tokenAmount: string;\n}\n\nexport interface QuoteBuyCostResult {\n  solCostLamports: string;\n  route: 'bonding_curve' | 'pumpswap';\n  disclaimer: string;\n}\n\nexport interface BuyOptions {\n  walletId: string;\n  amountLamports: string;\n  slippageBps?: number;\n  priorityLevel?: PriorityLevel;\n}\n\nexport interface BuyResult {\n  signature: string;\n  estimatedTokenAmount: string;\n  solSpent: string;\n  route: 'bonding_curve' | 'pumpswap';\n  disclaimer: string;\n}\n\nexport interface SellOptions {\n  walletId: string;\n  tokenAmount: string;\n  slippageBps?: number;\n  priorityLevel?: PriorityLevel;\n}\n\nexport interface SellResult {\n  signature: string;\n  estimatedSolReceived: string;\n  tokensSold: string;\n  route: 'bonding_curve' | 'pumpswap';\n  disclaimer: string;\n}\n\nexport interface BundleSellEntry {\n  walletId: string;\n  tokenAmount: string;\n}\n\nexport interface BundleSellOptions {\n  walletSells: BundleSellEntry[];\n  tipWalletId?: string;\n  tipLamports?: number;\n  slippageBps?: number;\n  priorityLevel?: PriorityLevel;\n}\n\nexport interface BundleSellResult {\n  bundleResults: Array<{\n    bundleId: string;\n    status: 'Landed' | 'Failed' | 'Timeout';\n    signatures?: string[];\n    walletsIncluded: string[];\n  }>;\n  warnings: Array<{ walletId: string; reason: string }>;\n}\n\nexport class Trading {\n  constructor(private readonly _http: HttpClient) {}\n\n  /**\n   * Get a price quote for buying or selling a token.\n   *\n   * @example\n   * ```ts\n   * const quote = await op.trading.getQuote('So11...', {\n   *   action: 'buy',\n   *   solAmount: '1000000000',\n   * });\n   * console.log(quote.expectedTokens);\n   * ```\n   */\n  async getQuote(mint: string, options: QuoteOptions): Promise<QuoteResult> {\n    const query: Record<string, string> = { action: options.action };\n    if (options.solAmount !== undefined) query['solAmount'] = options.solAmount;\n    if (options.tokenAmount !== undefined) query['tokenAmount'] = options.tokenAmount;\n    return this._http.get<QuoteResult>(`/api/tokens/${mint}/quote`, query);\n  }\n\n  /** Get the SOL cost to buy a specific number of tokens (inverse quote). */\n  async getQuoteBuyCost(\n    mint: string,\n    options: QuoteBuyCostOptions,\n  ): Promise<QuoteBuyCostResult> {\n    return this._http.get<QuoteBuyCostResult>(`/api/tokens/${mint}/quote-buy-cost`, {\n      tokenAmount: options.tokenAmount,\n    });\n  }\n\n  /** Execute a buy transaction for a token. */\n  async buy(mint: string, options: BuyOptions): Promise<BuyResult> {\n    return this._http.post<BuyResult>(`/api/tokens/${mint}/buy`, options);\n  }\n\n  /** Execute a sell transaction for a token. */\n  async sell(mint: string, options: SellOptions): Promise<SellResult> {\n    return this._http.post<SellResult>(`/api/tokens/${mint}/sell`, options);\n  }\n\n  /** Multi-wallet sell packed into Jito bundles. */\n  async bundleSell(mint: string, options: BundleSellOptions): Promise<BundleSellResult> {\n    return this._http.post<BundleSellResult>(`/api/tokens/${mint}/bundle-sell`, options);\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport interface JobStatus {\n  jobId: string;\n  status: 'waiting' | 'active' | 'completed' | 'failed';\n  progress: number;\n  result?: {\n    bundleStatuses: Array<{\n      bundleId: string;\n      status: 'Pending' | 'Landed' | 'Failed' | 'Timeout';\n      signatures?: string[];\n    }>;\n  };\n  warnings?: Array<{ walletId: string; reason: string }>;\n  error?: string;\n}\n\nexport interface PollOptions {\n  /** Polling interval in milliseconds. Default: 1000 */\n  intervalMs?: number;\n  /** Maximum time to wait in milliseconds. Default: 30000 */\n  timeoutMs?: number;\n  /** AbortSignal for cancellation. */\n  signal?: AbortSignal;\n  /** Callback invoked on each poll with current status. */\n  onProgress?: (status: JobStatus) => void;\n}\n\nexport class Jobs {\n  constructor(private readonly _http: HttpClient) {}\n\n  /** Get the current status of a job. */\n  async get(jobId: string): Promise<JobStatus> {\n    return this._http.get<JobStatus>(`/api/jobs/${jobId}`);\n  }\n\n  /**\n   * Poll a job until it completes or the timeout is reached.\n   *\n   * @param jobId - The job ID to poll.\n   * @param options - Polling configuration.\n   * @returns The final job status (completed).\n   * @throws {Error} If the job fails or the timeout is reached.\n   *\n   * @example\n   * ```ts\n   * const launch = await op.bundles.launch({ ... });\n   * const result = await op.jobs.poll(launch.jobId, {\n   *   intervalMs: 2000,\n   *   timeoutMs: 60000,\n   *   onProgress: (s) => console.log(`Progress: ${s.progress}%`),\n   * });\n   * ```\n   */\n  async poll(jobId: string, options?: PollOptions): Promise<JobStatus> {\n    const intervalMs = options?.intervalMs ?? 1000;\n    const timeoutMs = options?.timeoutMs ?? 30_000;\n    const signal = options?.signal;\n    const onProgress = options?.onProgress;\n\n    const deadline = Date.now() + timeoutMs;\n\n    while (Date.now() < deadline) {\n      if (signal?.aborted) {\n        throw new Error('Job polling aborted');\n      }\n\n      const status = await this.get(jobId);\n      onProgress?.(status);\n\n      if (status.status === 'completed') {\n        return status;\n      }\n\n      if (status.status === 'failed') {\n        throw new Error(status.error ?? `Job ${jobId} failed`);\n      }\n\n      // Wait before next poll\n      await new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(resolve, intervalMs);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(new Error('Job polling aborted'));\n          },\n          { once: true },\n        );\n      });\n    }\n\n    throw new Error(`Job ${jobId} polling timed out after ${timeoutMs}ms`);\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport interface AccumulatedFees {\n  creatorAddress: string;\n  accumulatedLamports: string;\n  accumulatedSOL: number;\n  creatorVaultAddress: string;\n}\n\nexport interface ClaimFeesResult {\n  signature: string;\n  amountClaimed: string;\n  amountClaimedSOL: number;\n}\n\nexport class CreatorFees {\n  constructor(private readonly _http: HttpClient) {}\n\n  /** Get accumulated creator fees for a given creator address. */\n  async getAccumulatedFees(address: string): Promise<AccumulatedFees> {\n    return this._http.get<AccumulatedFees>('/api/creator-fees', { address });\n  }\n\n  /** Claim accumulated creator fees for a wallet you own. */\n  async claim(creatorAddress: string): Promise<ClaimFeesResult> {\n    return this._http.post<ClaimFeesResult>('/api/creator-fees/claim', { creatorAddress });\n  }\n}\n","import type { HttpClient } from '../http.js';\n\nexport interface BundleLaunchOptions {\n  devWalletId: string;\n  buyWalletIds: string[];\n  name: string;\n  symbol: string;\n  description?: string;\n  imageBase64: string;\n  imageType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';\n  devBuyAmountLamports?: string;\n  walletBuyAmounts: string[];\n  tipLamports?: number;\n  twitter?: string;\n  telegram?: string;\n  website?: string;\n}\n\nexport interface BundleLaunchResult {\n  jobId: string;\n}\n\nexport class Bundles {\n  constructor(private readonly _http: HttpClient) {}\n\n  /**\n   * Launch a coordinated token creation + multi-wallet bundle buy.\n   * Returns a job ID for polling.\n   *\n   * @example\n   * ```ts\n   * const { jobId } = await op.bundles.launch({\n   *   devWalletId: 'wallet-1',\n   *   buyWalletIds: ['wallet-2', 'wallet-3'],\n   *   name: 'My Token',\n   *   symbol: 'MTK',\n   *   imageBase64: '...',\n   *   imageType: 'image/png',\n   *   walletBuyAmounts: ['500000000', '500000000'],\n   * });\n   * const result = await op.jobs.poll(jobId);\n   * ```\n   */\n  async launch(options: BundleLaunchOptions): Promise<BundleLaunchResult> {\n    return this._http.post<BundleLaunchResult>('/api/tokens/bundle-launch', options);\n  }\n}\n","import { HttpClient } from './http.js';\nimport { Wallets } from './resources/wallets.js';\nimport { Tokens } from './resources/tokens.js';\nimport { Trading } from './resources/trading.js';\nimport { Jobs } from './resources/jobs.js';\nimport { CreatorFees } from './resources/creator-fees.js';\nimport { Bundles } from './resources/bundles.js';\n\nexport interface OpenPumpConfig {\n  /** API key (op_sk_live_...) */\n  apiKey: string;\n  /** Base URL of the OpenPump API. Defaults to https://api.openpump.io */\n  baseUrl?: string;\n  /** Request timeout in milliseconds. Defaults to 30_000 */\n  timeout?: number;\n}\n\n/**\n * OpenPump SDK client with resource-namespaced API methods.\n *\n * @example\n * ```ts\n * import { OpenPump } from '@openpump/sdk';\n *\n * const op = new OpenPump({ apiKey: 'op_sk_live_...' });\n *\n * // List wallets\n * const wallets = await op.wallets.list();\n *\n * // Create a token\n * const token = await op.tokens.create({ ... });\n *\n * // Buy tokens\n * const trade = await op.trading.buy('mint-address', { ... });\n *\n * // Poll a bundle launch job\n * const job = await op.jobs.poll('job-id', { timeoutMs: 60_000 });\n * ```\n */\nexport class OpenPump {\n  readonly wallets: Wallets;\n  readonly tokens: Tokens;\n  readonly trading: Trading;\n  readonly jobs: Jobs;\n  readonly creatorFees: CreatorFees;\n  readonly bundles: Bundles;\n\n  private readonly _http: HttpClient;\n\n  constructor(config: OpenPumpConfig) {\n    if (!config.apiKey) {\n      throw new Error('apiKey is required');\n    }\n\n    this._http = new HttpClient({\n      apiKey: config.apiKey,\n      baseUrl: config.baseUrl ?? 'https://api.openpump.io',\n      timeout: config.timeout ?? 30_000,\n    });\n\n    this.wallets = new Wallets(this._http);\n    this.tokens = new Tokens(this._http);\n    this.trading = new Trading(this._http);\n    this.jobs = new Jobs(this._http);\n    this.creatorFees = new CreatorFees(this._http);\n    this.bundles = new Bundles(this._http);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,473 @@
+interface HttpClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+}
+declare class HttpClient {
+    private readonly _apiKey;
+    private readonly _baseUrl;
+    private readonly _timeout;
+    constructor(config: HttpClientConfig);
+    get<T>(path: string, query?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+    private _headers;
+    private _handleResponse;
+    private _throwApiError;
+}
+
+interface CreateWalletOptions {
+    label?: string;
+}
+interface WalletInfo {
+    id: string;
+    publicKey: string;
+    walletIndex: number;
+    label: string;
+    createdAt: string;
+}
+interface WalletBalance {
+    nativeSol: {
+        lamports: string;
+        sol: string;
+    };
+    tokens: Array<{
+        mint: string;
+        symbol: string | null;
+        amount: string;
+        decimals: number;
+        uiAmount: number;
+    }>;
+}
+interface DepositInstructions {
+    depositAddress: string;
+    minimums: {
+        tokenCreation: string;
+        bundleBuy: string;
+        standardBuy: string;
+    };
+    instructions: string[];
+    disclaimer: string;
+    network: string;
+}
+interface TransferOptions {
+    toAddress: string;
+    amountLamports: string;
+    mint?: string | null;
+    memo?: string;
+    priorityFeeMicroLamports?: number;
+}
+interface TransferResult {
+    signature: string;
+    amountLamports: string;
+    fee: string;
+}
+interface TransactionListOptions {
+    type?: 'buy' | 'sell' | 'transfer';
+    limit?: number;
+    offset?: number;
+}
+interface TransactionListResult {
+    transactions: Array<Record<string, unknown>>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+declare class Wallets {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /** List all active wallets for the authenticated user. */
+    list(): Promise<WalletInfo[]>;
+    /** Create a new wallet with an optional label. */
+    create(options?: CreateWalletOptions): Promise<WalletInfo>;
+    /** Get a single wallet by ID. */
+    get(walletId: string): Promise<WalletInfo>;
+    /** Get SOL + token balances for a wallet. */
+    getBalance(walletId: string): Promise<WalletBalance>;
+    /** Get deposit address and SOL minimums for a wallet. */
+    getDepositInstructions(walletId: string): Promise<DepositInstructions>;
+    /** Force a live RPC balance refresh, bypassing the 30s cache. */
+    refreshBalance(walletId: string): Promise<WalletBalance>;
+    /**
+     * Execute an on-chain SOL or SPL token transfer.
+     *
+     * @example
+     * ```ts
+     * const result = await op.wallets.transfer('wallet-id', {
+     *   toAddress: 'recipient-public-key',
+     *   amountLamports: '100000000',
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    transfer(walletId: string, options: TransferOptions): Promise<TransferResult>;
+    /** Get paginated transfer history for a wallet. */
+    getTransactions(walletId: string, options?: TransactionListOptions): Promise<TransactionListResult>;
+}
+
+interface CreateTokenOptions {
+    walletIndex?: number;
+    name: string;
+    symbol: string;
+    description: string;
+    imageBase64: string;
+    imageType: 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/gif' | 'image/webp';
+    initialBuyAmountSol?: number;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+}
+interface CreateTokenResult {
+    tokenId: string;
+    mint: string;
+    signature: string;
+    metadataUri: string;
+    bondingCurveAccount: string;
+}
+interface TokenListItem {
+    id: string;
+    mintAddress: string;
+    name: string;
+    symbol: string;
+    graduationStatus: string;
+    metadataUri: string;
+    creatorAddress: string;
+    createdAt: string;
+}
+interface CurveState {
+    mint: string;
+    virtualTokenReserves: string;
+    virtualSolReserves: string;
+    realTokenReserves: string;
+    realSolReserves: string;
+    tokenTotalSupply: string;
+    complete: boolean;
+    isMayhemMode: boolean;
+    currentPriceSOL: number;
+    marketCapSOL: number;
+    graduationPercent: number;
+}
+declare class Tokens {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /** List tokens created by the authenticated user. */
+    list(): Promise<TokenListItem[]>;
+    /**
+     * Create a new PumpFun token with IPFS metadata upload.
+     *
+     * @example
+     * ```ts
+     * const token = await op.tokens.create({
+     *   name: 'My Token',
+     *   symbol: 'MTK',
+     *   description: 'A cool token',
+     *   imageBase64: 'base64-encoded-image...',
+     *   imageType: 'image/png',
+     * });
+     * console.log(token.mint);
+     * ```
+     */
+    create(options: CreateTokenOptions): Promise<CreateTokenResult>;
+    /** Get market info for a token (mainnet only, returns null on devnet). */
+    getMarketInfo(mint: string): Promise<Record<string, unknown> | null>;
+    /** Get bonding curve state including price, market cap, and graduation progress. */
+    getCurveState(mint: string): Promise<CurveState>;
+}
+
+type PriorityLevel = 'economy' | 'normal' | 'fast' | 'turbo';
+interface QuoteOptions {
+    action: 'buy' | 'sell';
+    solAmount?: string;
+    tokenAmount?: string;
+}
+interface QuoteResult {
+    route: 'bonding_curve' | 'pumpswap';
+    expectedTokens?: string;
+    expectedSol?: string;
+    priceImpact: number;
+    fee: number;
+    disclaimer: string;
+}
+interface QuoteBuyCostOptions {
+    tokenAmount: string;
+}
+interface QuoteBuyCostResult {
+    solCostLamports: string;
+    route: 'bonding_curve' | 'pumpswap';
+    disclaimer: string;
+}
+interface BuyOptions {
+    walletId: string;
+    amountLamports: string;
+    slippageBps?: number;
+    priorityLevel?: PriorityLevel;
+}
+interface BuyResult {
+    signature: string;
+    estimatedTokenAmount: string;
+    solSpent: string;
+    route: 'bonding_curve' | 'pumpswap';
+    disclaimer: string;
+}
+interface SellOptions {
+    walletId: string;
+    tokenAmount: string;
+    slippageBps?: number;
+    priorityLevel?: PriorityLevel;
+}
+interface SellResult {
+    signature: string;
+    estimatedSolReceived: string;
+    tokensSold: string;
+    route: 'bonding_curve' | 'pumpswap';
+    disclaimer: string;
+}
+interface BundleSellEntry {
+    walletId: string;
+    tokenAmount: string;
+}
+interface BundleSellOptions {
+    walletSells: BundleSellEntry[];
+    tipWalletId?: string;
+    tipLamports?: number;
+    slippageBps?: number;
+    priorityLevel?: PriorityLevel;
+}
+interface BundleSellResult {
+    bundleResults: Array<{
+        bundleId: string;
+        status: 'Landed' | 'Failed' | 'Timeout';
+        signatures?: string[];
+        walletsIncluded: string[];
+    }>;
+    warnings: Array<{
+        walletId: string;
+        reason: string;
+    }>;
+}
+declare class Trading {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /**
+     * Get a price quote for buying or selling a token.
+     *
+     * @example
+     * ```ts
+     * const quote = await op.trading.getQuote('So11...', {
+     *   action: 'buy',
+     *   solAmount: '1000000000',
+     * });
+     * console.log(quote.expectedTokens);
+     * ```
+     */
+    getQuote(mint: string, options: QuoteOptions): Promise<QuoteResult>;
+    /** Get the SOL cost to buy a specific number of tokens (inverse quote). */
+    getQuoteBuyCost(mint: string, options: QuoteBuyCostOptions): Promise<QuoteBuyCostResult>;
+    /** Execute a buy transaction for a token. */
+    buy(mint: string, options: BuyOptions): Promise<BuyResult>;
+    /** Execute a sell transaction for a token. */
+    sell(mint: string, options: SellOptions): Promise<SellResult>;
+    /** Multi-wallet sell packed into Jito bundles. */
+    bundleSell(mint: string, options: BundleSellOptions): Promise<BundleSellResult>;
+}
+
+interface JobStatus {
+    jobId: string;
+    status: 'waiting' | 'active' | 'completed' | 'failed';
+    progress: number;
+    result?: {
+        bundleStatuses: Array<{
+            bundleId: string;
+            status: 'Pending' | 'Landed' | 'Failed' | 'Timeout';
+            signatures?: string[];
+        }>;
+    };
+    warnings?: Array<{
+        walletId: string;
+        reason: string;
+    }>;
+    error?: string;
+}
+interface PollOptions {
+    /** Polling interval in milliseconds. Default: 1000 */
+    intervalMs?: number;
+    /** Maximum time to wait in milliseconds. Default: 30000 */
+    timeoutMs?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+    /** Callback invoked on each poll with current status. */
+    onProgress?: (status: JobStatus) => void;
+}
+declare class Jobs {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /** Get the current status of a job. */
+    get(jobId: string): Promise<JobStatus>;
+    /**
+     * Poll a job until it completes or the timeout is reached.
+     *
+     * @param jobId - The job ID to poll.
+     * @param options - Polling configuration.
+     * @returns The final job status (completed).
+     * @throws {Error} If the job fails or the timeout is reached.
+     *
+     * @example
+     * ```ts
+     * const launch = await op.bundles.launch({ ... });
+     * const result = await op.jobs.poll(launch.jobId, {
+     *   intervalMs: 2000,
+     *   timeoutMs: 60000,
+     *   onProgress: (s) => console.log(`Progress: ${s.progress}%`),
+     * });
+     * ```
+     */
+    poll(jobId: string, options?: PollOptions): Promise<JobStatus>;
+}
+
+interface AccumulatedFees {
+    creatorAddress: string;
+    accumulatedLamports: string;
+    accumulatedSOL: number;
+    creatorVaultAddress: string;
+}
+interface ClaimFeesResult {
+    signature: string;
+    amountClaimed: string;
+    amountClaimedSOL: number;
+}
+declare class CreatorFees {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /** Get accumulated creator fees for a given creator address. */
+    getAccumulatedFees(address: string): Promise<AccumulatedFees>;
+    /** Claim accumulated creator fees for a wallet you own. */
+    claim(creatorAddress: string): Promise<ClaimFeesResult>;
+}
+
+interface BundleLaunchOptions {
+    devWalletId: string;
+    buyWalletIds: string[];
+    name: string;
+    symbol: string;
+    description?: string;
+    imageBase64: string;
+    imageType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+    devBuyAmountLamports?: string;
+    walletBuyAmounts: string[];
+    tipLamports?: number;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+}
+interface BundleLaunchResult {
+    jobId: string;
+}
+declare class Bundles {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /**
+     * Launch a coordinated token creation + multi-wallet bundle buy.
+     * Returns a job ID for polling.
+     *
+     * @example
+     * ```ts
+     * const { jobId } = await op.bundles.launch({
+     *   devWalletId: 'wallet-1',
+     *   buyWalletIds: ['wallet-2', 'wallet-3'],
+     *   name: 'My Token',
+     *   symbol: 'MTK',
+     *   imageBase64: '...',
+     *   imageType: 'image/png',
+     *   walletBuyAmounts: ['500000000', '500000000'],
+     * });
+     * const result = await op.jobs.poll(jobId);
+     * ```
+     */
+    launch(options: BundleLaunchOptions): Promise<BundleLaunchResult>;
+}
+
+interface OpenPumpConfig {
+    /** API key (op_sk_live_...) */
+    apiKey: string;
+    /** Base URL of the OpenPump API. Defaults to https://api.openpump.io */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 30_000 */
+    timeout?: number;
+}
+/**
+ * OpenPump SDK client with resource-namespaced API methods.
+ *
+ * @example
+ * ```ts
+ * import { OpenPump } from '@openpump/sdk';
+ *
+ * const op = new OpenPump({ apiKey: 'op_sk_live_...' });
+ *
+ * // List wallets
+ * const wallets = await op.wallets.list();
+ *
+ * // Create a token
+ * const token = await op.tokens.create({ ... });
+ *
+ * // Buy tokens
+ * const trade = await op.trading.buy('mint-address', { ... });
+ *
+ * // Poll a bundle launch job
+ * const job = await op.jobs.poll('job-id', { timeoutMs: 60_000 });
+ * ```
+ */
+declare class OpenPump {
+    readonly wallets: Wallets;
+    readonly tokens: Tokens;
+    readonly trading: Trading;
+    readonly jobs: Jobs;
+    readonly creatorFees: CreatorFees;
+    readonly bundles: Bundles;
+    private readonly _http;
+    constructor(config: OpenPumpConfig);
+}
+
+/**
+ * Base error class for all OpenPump SDK errors.
+ * All API errors are converted to typed exceptions.
+ */
+declare class OpenPumpError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: unknown | undefined;
+    readonly name: string;
+    constructor(code: string, message: string, status: number, details?: unknown | undefined);
+}
+/** Thrown when the API key is invalid or missing (HTTP 401). */
+declare class AuthenticationError extends OpenPumpError {
+    readonly name = "AuthenticationError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+/** Thrown when the rate limit is exceeded (HTTP 429). */
+declare class RateLimitError extends OpenPumpError {
+    readonly name = "RateLimitError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+/** Thrown when request validation fails (HTTP 422). */
+declare class ValidationError extends OpenPumpError {
+    readonly name = "ValidationError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+/** Thrown when the requested resource is not found (HTTP 404). */
+declare class NotFoundError extends OpenPumpError {
+    readonly name = "NotFoundError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+/** Thrown when the wallet has insufficient SOL or tokens for an operation. */
+declare class InsufficientFundsError extends OpenPumpError {
+    readonly name = "InsufficientFundsError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+/** Thrown when an on-chain transaction fails (signature error, simulation failure, etc.). */
+declare class TransactionError extends OpenPumpError {
+    readonly name = "TransactionError";
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+
+export { type AccumulatedFees, AuthenticationError, type BundleLaunchOptions, type BundleLaunchResult, type BundleSellEntry, type BundleSellOptions, type BundleSellResult, Bundles, type BuyOptions, type BuyResult, type ClaimFeesResult, type CreateTokenOptions, type CreateTokenResult, type CreateWalletOptions, CreatorFees, type CurveState, type DepositInstructions, InsufficientFundsError, type JobStatus, Jobs, NotFoundError, OpenPump, type OpenPumpConfig, OpenPumpError, type PollOptions, type PriorityLevel, type QuoteBuyCostOptions, type QuoteBuyCostResult, type QuoteOptions, type QuoteResult, RateLimitError, type SellOptions, type SellResult, type TokenListItem, Tokens, Trading, TransactionError, type TransactionListOptions, type TransactionListResult, type TransferOptions, type TransferResult, ValidationError, type WalletBalance, type WalletInfo, Wallets };