@kololabs/router 1.0.0

package/dist/index.cjs

@@ -0,0 +1,135 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  estimateValueInUsd: () => estimateValueInUsd,
+  executeSwap: () => executeSwap,
+  getQuote: () => getQuote,
+  getSwapTransaction: () => getSwapTransaction,
+  getTokenPriceInUsd: () => getTokenPriceInUsd
+});
+module.exports = __toCommonJS(index_exports);
+var import_buffer = require("buffer");
+var import_web3 = require("@solana/web3.js");
+var DEFAULT_JUP_API = "https://quote-api.jup.ag/v6";
+var DEFAULT_USDT_MINT = "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
+async function getQuote(inputMint, amount, options) {
+  const outputMint = options?.outputMint ?? DEFAULT_USDT_MINT;
+  const slippageBps = options?.slippageBps ?? 50;
+  const onlyDirectRoutes = options?.onlyDirectRoutes ?? false;
+  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+  const params = new URLSearchParams({
+    inputMint,
+    outputMint,
+    amount,
+    slippageBps: String(slippageBps),
+    onlyDirectRoutes: String(onlyDirectRoutes)
+  });
+  const url = `${apiBase}/quote?${params}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(
+      `Jupiter quote error (${response.status}): ${response.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  return response.json();
+}
+async function getSwapTransaction(quoteResponse, userPublicKey, options) {
+  const wrapAndUnwrapSol = options?.wrapAndUnwrapSol ?? true;
+  const prioritizationFeeLamports = options?.prioritizationFeeLamports ?? "auto";
+  const dynamicComputeUnitLimit = options?.dynamicComputeUnitLimit ?? true;
+  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+  const response = await fetch(`${apiBase}/swap`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      quoteResponse,
+      userPublicKey,
+      wrapAndUnwrapSol,
+      dynamicComputeUnitLimit,
+      prioritizationFeeLamports
+    })
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(
+      `Jupiter swap error (${response.status}): ${response.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  return response.json();
+}
+async function executeSwap(swapResponse, keypair, connection, options) {
+  const commitment = options?.commitment ?? "confirmed";
+  const txBuffer = import_buffer.Buffer.from(swapResponse.swapTransaction, "base64");
+  const transaction = import_web3.VersionedTransaction.deserialize(txBuffer);
+  transaction.sign([keypair]);
+  const signature = await connection.sendRawTransaction(
+    transaction.serialize(),
+    { skipPreflight: false, maxRetries: 3 }
+  );
+  const confirmation = await connection.confirmTransaction(
+    signature,
+    commitment
+  );
+  if (confirmation.value.err) {
+    throw new Error(`Swap transaction failed: ${confirmation.value.err}`);
+  }
+  return signature;
+}
+async function getTokenPriceInUsd(mint, options) {
+  try {
+    const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+    const quoteAmount = 10 ** 6;
+    const params = new URLSearchParams({
+      inputMint: mint,
+      outputMint: DEFAULT_USDT_MINT,
+      amount: String(quoteAmount),
+      slippageBps: "100",
+      onlyDirectRoutes: "true"
+    });
+    const response = await fetch(`${apiBase}/quote?${params}`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return parseFloat(data.outAmount) / 1e6;
+  } catch {
+    return null;
+  }
+}
+async function estimateValueInUsd(mint, rawAmount, decimals, options) {
+  try {
+    const price = await getTokenPriceInUsd(mint, options);
+    if (price === null) return null;
+    const amount = parseFloat(rawAmount) / 10 ** decimals;
+    return amount * price;
+  } catch {
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  estimateValueInUsd,
+  executeSwap,
+  getQuote,
+  getSwapTransaction,
+  getTokenPriceInUsd
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Buffer } from \"buffer\";\nimport { Connection, Keypair, VersionedTransaction } from \"@solana/web3.js\";\n\n// ── Types ──────────────────────────────────────────────────────────\n\n/** Response shape from the Jupiter /quote endpoint. */\nexport interface JupiterQuoteResponse {\n  inputMint: string;\n  outputMint: string;\n  inAmount: string;\n  outAmount: string;\n  otherAmountThreshold: string;\n  priceImpactPct: string;\n  routePlan: Array<{\n    swapInfo: {\n      label: string;\n      inputMint: string;\n      outputMint: string;\n      inAmount: string;\n      outAmount: string;\n      feeAmount: string;\n      feeMint: string;\n    };\n  }>;\n}\n\n/** Response shape from the Jupiter /swap endpoint. */\nexport interface JupiterSwapResponse {\n  swapTransaction: string;\n  lastValidBlockHeight: number;\n  prioritizationFeeLamports: number;\n  computeUnitLimit: number;\n  prioritizationType: {\n    computeBudget: {\n      microLamports: number;\n      estimatedMicroLamports: number;\n    };\n  };\n  dynamicSlippageReport: {\n    slippageBps: number;\n    otherAmount: number;\n    simulatedIncurredSlippageBps: number;\n  };\n  simulationError: string | null;\n}\n\n/** Optional overrides for Jupiter API calls. */\nexport interface JupiterOptions {\n  /** Output token mint. Defaults to USDT (Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB). */\n  outputMint?: string;\n  /** Slippage tolerance in basis points. Default 50 (0.5 %). */\n  slippageBps?: number;\n  /** Only use direct routes (no multi-hop). Default false. */\n  onlyDirectRoutes?: boolean;\n  /** Wrap/unwrap native SOL automatically. Default true. */\n  wrapAndUnwrapSol?: boolean;\n  /** Priority fee in lamports. Use \"auto\" for automatic. */\n  prioritizationFeeLamports?: string | number;\n  /** Dynamically set compute unit limit. Default true. */\n  dynamicComputeUnitLimit?: boolean;\n  /** Jupiter API base URL override. */\n  apiBase?: string;\n  /** Commitment level for transaction confirmation. Default \"confirmed\". */\n  commitment?: \"processed\" | \"confirmed\" | \"finalized\";\n}\n\n// ── Defaults ───────────────────────────────────────────────────────\n\nconst DEFAULT_JUP_API = \"https://quote-api.jup.ag/v6\";\nconst DEFAULT_USDT_MINT = \"Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB\";\n\n// ── Functions ──────────────────────────────────────────────────────\n\n/**\n * Fetch a swap quote from Jupiter.\n *\n * @param inputMint - The SPL token mint to swap FROM.\n * @param amount - Raw amount in smallest units (e.g. lamports for SOL).\n * @param options - Optional overrides.\n * @returns The Jupiter quote response.\n */\nexport async function getQuote(\n  inputMint: string,\n  amount: string,\n  options?: JupiterOptions\n): Promise<JupiterQuoteResponse> {\n  const outputMint = options?.outputMint ?? DEFAULT_USDT_MINT;\n  const slippageBps = options?.slippageBps ?? 50;\n  const onlyDirectRoutes = options?.onlyDirectRoutes ?? false;\n  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n\n  const params = new URLSearchParams({\n    inputMint,\n    outputMint,\n    amount,\n    slippageBps: String(slippageBps),\n    onlyDirectRoutes: String(onlyDirectRoutes),\n  });\n\n  const url = `${apiBase}/quote?${params}`;\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(\n      `Jupiter quote error (${response.status}): ${response.statusText}${text ? ` \\u2014 ${text}` : \"\"}`\n    );\n  }\n\n  return response.json() as Promise<JupiterQuoteResponse>;\n}\n\n/**\n * Build a swap transaction using a quote obtained from `getQuote`.\n *\n * @param quoteResponse - The quote to execute.\n * @param userPublicKey - The wallet public key that will sign the tx.\n * @param options - Optional overrides.\n * @returns The swap transaction response containing the serialized tx.\n */\nexport async function getSwapTransaction(\n  quoteResponse: JupiterQuoteResponse,\n  userPublicKey: string,\n  options?: JupiterOptions\n): Promise<JupiterSwapResponse> {\n  const wrapAndUnwrapSol = options?.wrapAndUnwrapSol ?? true;\n  const prioritizationFeeLamports = options?.prioritizationFeeLamports ?? \"auto\";\n  const dynamicComputeUnitLimit = options?.dynamicComputeUnitLimit ?? true;\n  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n\n  const response = await fetch(`${apiBase}/swap`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      quoteResponse,\n      userPublicKey,\n      wrapAndUnwrapSol,\n      dynamicComputeUnitLimit,\n      prioritizationFeeLamports,\n    }),\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(\n      `Jupiter swap error (${response.status}): ${response.statusText}${text ? ` \\u2014 ${text}` : \"\"}`\n    );\n  }\n\n  return response.json() as Promise<JupiterSwapResponse>;\n}\n\n/**\n * Sign, send, and confirm a Jupiter swap transaction on-chain.\n *\n * This is a convenience wrapper that deserializes the swap transaction\n * from `getSwapTransaction`, signs it with the provided keypair, sends\n * it via the RPC connection, and waits for confirmation.\n *\n * @param swapResponse - The swap response from `getSwapTransaction`.\n * @param keypair - The Solana keypair that will sign the transaction.\n * @param connection - A Solana RPC connection.\n * @param options - Optional overrides (commitment level).\n * @returns The confirmed transaction signature (base58).\n */\nexport async function executeSwap(\n  swapResponse: JupiterSwapResponse,\n  keypair: Keypair,\n  connection: Connection,\n  options?: Pick<JupiterOptions, \"commitment\">\n): Promise<string> {\n  const commitment = options?.commitment ?? \"confirmed\";\n\n  // Deserialize the versioned transaction from the base64-encoded wire format\n  const txBuffer = Buffer.from(swapResponse.swapTransaction, \"base64\");\n  const transaction = VersionedTransaction.deserialize(txBuffer);\n\n  // Sign with the user's keypair\n  transaction.sign([keypair]);\n\n  // Send the signed transaction\n  const signature = await connection.sendRawTransaction(\n    transaction.serialize(),\n    { skipPreflight: false, maxRetries: 3 }\n  );\n\n  // Wait for confirmation\n  const confirmation = await connection.confirmTransaction(\n    signature,\n    commitment\n  );\n\n  if (confirmation.value.err) {\n    throw new Error(`Swap transaction failed: ${confirmation.value.err}`);\n  }\n\n  return signature;\n}\n\n/**\n * Get the current USD price of a token by requesting a 1-unit quote.\n *\n * @param mint - The SPL token mint.\n * @param options - Optional overrides.\n * @returns The price in USD, or `null` if unavailable.\n */\nexport async function getTokenPriceInUsd(\n  mint: string,\n  options?: JupiterOptions\n): Promise<number | null> {\n  try {\n    const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n    const quoteAmount = 10 ** 6; // 1 USDT unit\n    const params = new URLSearchParams({\n      inputMint: mint,\n      outputMint: DEFAULT_USDT_MINT,\n      amount: String(quoteAmount),\n      slippageBps: \"100\",\n      onlyDirectRoutes: \"true\",\n    });\n\n    const response = await fetch(`${apiBase}/quote?${params}`);\n    if (!response.ok) return null;\n\n    const data = (await response.json()) as JupiterQuoteResponse;\n    // outAmount is in USDT units (6 decimals)\n    return parseFloat(data.outAmount) / 1_000_000;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Estimate the USD value of a token amount using Jupiter pricing.\n *\n * @param mint - The SPL token mint.\n * @param rawAmount - Raw amount string (includes decimals).\n * @param decimals - Number of decimal places for the token.\n * @param options - Optional overrides.\n * @returns The estimated USD value, or `null` if pricing is unavailable.\n */\nexport async function estimateValueInUsd(\n  mint: string,\n  rawAmount: string,\n  decimals: number,\n  options?: JupiterOptions\n): Promise<number | null> {\n  try {\n    const price = await getTokenPriceInUsd(mint, options);\n    if (price === null) return null;\n    const amount = parseFloat(rawAmount) / 10 ** decimals;\n    return amount * price;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+import { Keypair, Connection } from '@solana/web3.js';
+
+/** Response shape from the Jupiter /quote endpoint. */
+interface JupiterQuoteResponse {
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    priceImpactPct: string;
+    routePlan: Array<{
+        swapInfo: {
+            label: string;
+            inputMint: string;
+            outputMint: string;
+            inAmount: string;
+            outAmount: string;
+            feeAmount: string;
+            feeMint: string;
+        };
+    }>;
+}
+/** Response shape from the Jupiter /swap endpoint. */
+interface JupiterSwapResponse {
+    swapTransaction: string;
+    lastValidBlockHeight: number;
+    prioritizationFeeLamports: number;
+    computeUnitLimit: number;
+    prioritizationType: {
+        computeBudget: {
+            microLamports: number;
+            estimatedMicroLamports: number;
+        };
+    };
+    dynamicSlippageReport: {
+        slippageBps: number;
+        otherAmount: number;
+        simulatedIncurredSlippageBps: number;
+    };
+    simulationError: string | null;
+}
+/** Optional overrides for Jupiter API calls. */
+interface JupiterOptions {
+    /** Output token mint. Defaults to USDT (Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB). */
+    outputMint?: string;
+    /** Slippage tolerance in basis points. Default 50 (0.5 %). */
+    slippageBps?: number;
+    /** Only use direct routes (no multi-hop). Default false. */
+    onlyDirectRoutes?: boolean;
+    /** Wrap/unwrap native SOL automatically. Default true. */
+    wrapAndUnwrapSol?: boolean;
+    /** Priority fee in lamports. Use "auto" for automatic. */
+    prioritizationFeeLamports?: string | number;
+    /** Dynamically set compute unit limit. Default true. */
+    dynamicComputeUnitLimit?: boolean;
+    /** Jupiter API base URL override. */
+    apiBase?: string;
+    /** Commitment level for transaction confirmation. Default "confirmed". */
+    commitment?: "processed" | "confirmed" | "finalized";
+}
+/**
+ * Fetch a swap quote from Jupiter.
+ *
+ * @param inputMint - The SPL token mint to swap FROM.
+ * @param amount - Raw amount in smallest units (e.g. lamports for SOL).
+ * @param options - Optional overrides.
+ * @returns The Jupiter quote response.
+ */
+declare function getQuote(inputMint: string, amount: string, options?: JupiterOptions): Promise<JupiterQuoteResponse>;
+/**
+ * Build a swap transaction using a quote obtained from `getQuote`.
+ *
+ * @param quoteResponse - The quote to execute.
+ * @param userPublicKey - The wallet public key that will sign the tx.
+ * @param options - Optional overrides.
+ * @returns The swap transaction response containing the serialized tx.
+ */
+declare function getSwapTransaction(quoteResponse: JupiterQuoteResponse, userPublicKey: string, options?: JupiterOptions): Promise<JupiterSwapResponse>;
+/**
+ * Sign, send, and confirm a Jupiter swap transaction on-chain.
+ *
+ * This is a convenience wrapper that deserializes the swap transaction
+ * from `getSwapTransaction`, signs it with the provided keypair, sends
+ * it via the RPC connection, and waits for confirmation.
+ *
+ * @param swapResponse - The swap response from `getSwapTransaction`.
+ * @param keypair - The Solana keypair that will sign the transaction.
+ * @param connection - A Solana RPC connection.
+ * @param options - Optional overrides (commitment level).
+ * @returns The confirmed transaction signature (base58).
+ */
+declare function executeSwap(swapResponse: JupiterSwapResponse, keypair: Keypair, connection: Connection, options?: Pick<JupiterOptions, "commitment">): Promise<string>;
+/**
+ * Get the current USD price of a token by requesting a 1-unit quote.
+ *
+ * @param mint - The SPL token mint.
+ * @param options - Optional overrides.
+ * @returns The price in USD, or `null` if unavailable.
+ */
+declare function getTokenPriceInUsd(mint: string, options?: JupiterOptions): Promise<number | null>;
+/**
+ * Estimate the USD value of a token amount using Jupiter pricing.
+ *
+ * @param mint - The SPL token mint.
+ * @param rawAmount - Raw amount string (includes decimals).
+ * @param decimals - Number of decimal places for the token.
+ * @param options - Optional overrides.
+ * @returns The estimated USD value, or `null` if pricing is unavailable.
+ */
+declare function estimateValueInUsd(mint: string, rawAmount: string, decimals: number, options?: JupiterOptions): Promise<number | null>;
+
+export { type JupiterOptions, type JupiterQuoteResponse, type JupiterSwapResponse, estimateValueInUsd, executeSwap, getQuote, getSwapTransaction, getTokenPriceInUsd };

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import { Keypair, Connection } from '@solana/web3.js';
+
+/** Response shape from the Jupiter /quote endpoint. */
+interface JupiterQuoteResponse {
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    priceImpactPct: string;
+    routePlan: Array<{
+        swapInfo: {
+            label: string;
+            inputMint: string;
+            outputMint: string;
+            inAmount: string;
+            outAmount: string;
+            feeAmount: string;
+            feeMint: string;
+        };
+    }>;
+}
+/** Response shape from the Jupiter /swap endpoint. */
+interface JupiterSwapResponse {
+    swapTransaction: string;
+    lastValidBlockHeight: number;
+    prioritizationFeeLamports: number;
+    computeUnitLimit: number;
+    prioritizationType: {
+        computeBudget: {
+            microLamports: number;
+            estimatedMicroLamports: number;
+        };
+    };
+    dynamicSlippageReport: {
+        slippageBps: number;
+        otherAmount: number;
+        simulatedIncurredSlippageBps: number;
+    };
+    simulationError: string | null;
+}
+/** Optional overrides for Jupiter API calls. */
+interface JupiterOptions {
+    /** Output token mint. Defaults to USDT (Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB). */
+    outputMint?: string;
+    /** Slippage tolerance in basis points. Default 50 (0.5 %). */
+    slippageBps?: number;
+    /** Only use direct routes (no multi-hop). Default false. */
+    onlyDirectRoutes?: boolean;
+    /** Wrap/unwrap native SOL automatically. Default true. */
+    wrapAndUnwrapSol?: boolean;
+    /** Priority fee in lamports. Use "auto" for automatic. */
+    prioritizationFeeLamports?: string | number;
+    /** Dynamically set compute unit limit. Default true. */
+    dynamicComputeUnitLimit?: boolean;
+    /** Jupiter API base URL override. */
+    apiBase?: string;
+    /** Commitment level for transaction confirmation. Default "confirmed". */
+    commitment?: "processed" | "confirmed" | "finalized";
+}
+/**
+ * Fetch a swap quote from Jupiter.
+ *
+ * @param inputMint - The SPL token mint to swap FROM.
+ * @param amount - Raw amount in smallest units (e.g. lamports for SOL).
+ * @param options - Optional overrides.
+ * @returns The Jupiter quote response.
+ */
+declare function getQuote(inputMint: string, amount: string, options?: JupiterOptions): Promise<JupiterQuoteResponse>;
+/**
+ * Build a swap transaction using a quote obtained from `getQuote`.
+ *
+ * @param quoteResponse - The quote to execute.
+ * @param userPublicKey - The wallet public key that will sign the tx.
+ * @param options - Optional overrides.
+ * @returns The swap transaction response containing the serialized tx.
+ */
+declare function getSwapTransaction(quoteResponse: JupiterQuoteResponse, userPublicKey: string, options?: JupiterOptions): Promise<JupiterSwapResponse>;
+/**
+ * Sign, send, and confirm a Jupiter swap transaction on-chain.
+ *
+ * This is a convenience wrapper that deserializes the swap transaction
+ * from `getSwapTransaction`, signs it with the provided keypair, sends
+ * it via the RPC connection, and waits for confirmation.
+ *
+ * @param swapResponse - The swap response from `getSwapTransaction`.
+ * @param keypair - The Solana keypair that will sign the transaction.
+ * @param connection - A Solana RPC connection.
+ * @param options - Optional overrides (commitment level).
+ * @returns The confirmed transaction signature (base58).
+ */
+declare function executeSwap(swapResponse: JupiterSwapResponse, keypair: Keypair, connection: Connection, options?: Pick<JupiterOptions, "commitment">): Promise<string>;
+/**
+ * Get the current USD price of a token by requesting a 1-unit quote.
+ *
+ * @param mint - The SPL token mint.
+ * @param options - Optional overrides.
+ * @returns The price in USD, or `null` if unavailable.
+ */
+declare function getTokenPriceInUsd(mint: string, options?: JupiterOptions): Promise<number | null>;
+/**
+ * Estimate the USD value of a token amount using Jupiter pricing.
+ *
+ * @param mint - The SPL token mint.
+ * @param rawAmount - Raw amount string (includes decimals).
+ * @param decimals - Number of decimal places for the token.
+ * @param options - Optional overrides.
+ * @returns The estimated USD value, or `null` if pricing is unavailable.
+ */
+declare function estimateValueInUsd(mint: string, rawAmount: string, decimals: number, options?: JupiterOptions): Promise<number | null>;
+
+export { type JupiterOptions, type JupiterQuoteResponse, type JupiterSwapResponse, estimateValueInUsd, executeSwap, getQuote, getSwapTransaction, getTokenPriceInUsd };

package/dist/index.js

@@ -0,0 +1,106 @@
+// src/index.ts
+import { Buffer } from "buffer";
+import { VersionedTransaction } from "@solana/web3.js";
+var DEFAULT_JUP_API = "https://quote-api.jup.ag/v6";
+var DEFAULT_USDT_MINT = "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
+async function getQuote(inputMint, amount, options) {
+  const outputMint = options?.outputMint ?? DEFAULT_USDT_MINT;
+  const slippageBps = options?.slippageBps ?? 50;
+  const onlyDirectRoutes = options?.onlyDirectRoutes ?? false;
+  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+  const params = new URLSearchParams({
+    inputMint,
+    outputMint,
+    amount,
+    slippageBps: String(slippageBps),
+    onlyDirectRoutes: String(onlyDirectRoutes)
+  });
+  const url = `${apiBase}/quote?${params}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(
+      `Jupiter quote error (${response.status}): ${response.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  return response.json();
+}
+async function getSwapTransaction(quoteResponse, userPublicKey, options) {
+  const wrapAndUnwrapSol = options?.wrapAndUnwrapSol ?? true;
+  const prioritizationFeeLamports = options?.prioritizationFeeLamports ?? "auto";
+  const dynamicComputeUnitLimit = options?.dynamicComputeUnitLimit ?? true;
+  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+  const response = await fetch(`${apiBase}/swap`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      quoteResponse,
+      userPublicKey,
+      wrapAndUnwrapSol,
+      dynamicComputeUnitLimit,
+      prioritizationFeeLamports
+    })
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(
+      `Jupiter swap error (${response.status}): ${response.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  return response.json();
+}
+async function executeSwap(swapResponse, keypair, connection, options) {
+  const commitment = options?.commitment ?? "confirmed";
+  const txBuffer = Buffer.from(swapResponse.swapTransaction, "base64");
+  const transaction = VersionedTransaction.deserialize(txBuffer);
+  transaction.sign([keypair]);
+  const signature = await connection.sendRawTransaction(
+    transaction.serialize(),
+    { skipPreflight: false, maxRetries: 3 }
+  );
+  const confirmation = await connection.confirmTransaction(
+    signature,
+    commitment
+  );
+  if (confirmation.value.err) {
+    throw new Error(`Swap transaction failed: ${confirmation.value.err}`);
+  }
+  return signature;
+}
+async function getTokenPriceInUsd(mint, options) {
+  try {
+    const apiBase = options?.apiBase ?? DEFAULT_JUP_API;
+    const quoteAmount = 10 ** 6;
+    const params = new URLSearchParams({
+      inputMint: mint,
+      outputMint: DEFAULT_USDT_MINT,
+      amount: String(quoteAmount),
+      slippageBps: "100",
+      onlyDirectRoutes: "true"
+    });
+    const response = await fetch(`${apiBase}/quote?${params}`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return parseFloat(data.outAmount) / 1e6;
+  } catch {
+    return null;
+  }
+}
+async function estimateValueInUsd(mint, rawAmount, decimals, options) {
+  try {
+    const price = await getTokenPriceInUsd(mint, options);
+    if (price === null) return null;
+    const amount = parseFloat(rawAmount) / 10 ** decimals;
+    return amount * price;
+  } catch {
+    return null;
+  }
+}
+export {
+  estimateValueInUsd,
+  executeSwap,
+  getQuote,
+  getSwapTransaction,
+  getTokenPriceInUsd
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Buffer } from \"buffer\";\nimport { Connection, Keypair, VersionedTransaction } from \"@solana/web3.js\";\n\n// ── Types ──────────────────────────────────────────────────────────\n\n/** Response shape from the Jupiter /quote endpoint. */\nexport interface JupiterQuoteResponse {\n  inputMint: string;\n  outputMint: string;\n  inAmount: string;\n  outAmount: string;\n  otherAmountThreshold: string;\n  priceImpactPct: string;\n  routePlan: Array<{\n    swapInfo: {\n      label: string;\n      inputMint: string;\n      outputMint: string;\n      inAmount: string;\n      outAmount: string;\n      feeAmount: string;\n      feeMint: string;\n    };\n  }>;\n}\n\n/** Response shape from the Jupiter /swap endpoint. */\nexport interface JupiterSwapResponse {\n  swapTransaction: string;\n  lastValidBlockHeight: number;\n  prioritizationFeeLamports: number;\n  computeUnitLimit: number;\n  prioritizationType: {\n    computeBudget: {\n      microLamports: number;\n      estimatedMicroLamports: number;\n    };\n  };\n  dynamicSlippageReport: {\n    slippageBps: number;\n    otherAmount: number;\n    simulatedIncurredSlippageBps: number;\n  };\n  simulationError: string | null;\n}\n\n/** Optional overrides for Jupiter API calls. */\nexport interface JupiterOptions {\n  /** Output token mint. Defaults to USDT (Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB). */\n  outputMint?: string;\n  /** Slippage tolerance in basis points. Default 50 (0.5 %). */\n  slippageBps?: number;\n  /** Only use direct routes (no multi-hop). Default false. */\n  onlyDirectRoutes?: boolean;\n  /** Wrap/unwrap native SOL automatically. Default true. */\n  wrapAndUnwrapSol?: boolean;\n  /** Priority fee in lamports. Use \"auto\" for automatic. */\n  prioritizationFeeLamports?: string | number;\n  /** Dynamically set compute unit limit. Default true. */\n  dynamicComputeUnitLimit?: boolean;\n  /** Jupiter API base URL override. */\n  apiBase?: string;\n  /** Commitment level for transaction confirmation. Default \"confirmed\". */\n  commitment?: \"processed\" | \"confirmed\" | \"finalized\";\n}\n\n// ── Defaults ───────────────────────────────────────────────────────\n\nconst DEFAULT_JUP_API = \"https://quote-api.jup.ag/v6\";\nconst DEFAULT_USDT_MINT = \"Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB\";\n\n// ── Functions ──────────────────────────────────────────────────────\n\n/**\n * Fetch a swap quote from Jupiter.\n *\n * @param inputMint - The SPL token mint to swap FROM.\n * @param amount - Raw amount in smallest units (e.g. lamports for SOL).\n * @param options - Optional overrides.\n * @returns The Jupiter quote response.\n */\nexport async function getQuote(\n  inputMint: string,\n  amount: string,\n  options?: JupiterOptions\n): Promise<JupiterQuoteResponse> {\n  const outputMint = options?.outputMint ?? DEFAULT_USDT_MINT;\n  const slippageBps = options?.slippageBps ?? 50;\n  const onlyDirectRoutes = options?.onlyDirectRoutes ?? false;\n  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n\n  const params = new URLSearchParams({\n    inputMint,\n    outputMint,\n    amount,\n    slippageBps: String(slippageBps),\n    onlyDirectRoutes: String(onlyDirectRoutes),\n  });\n\n  const url = `${apiBase}/quote?${params}`;\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(\n      `Jupiter quote error (${response.status}): ${response.statusText}${text ? ` \\u2014 ${text}` : \"\"}`\n    );\n  }\n\n  return response.json() as Promise<JupiterQuoteResponse>;\n}\n\n/**\n * Build a swap transaction using a quote obtained from `getQuote`.\n *\n * @param quoteResponse - The quote to execute.\n * @param userPublicKey - The wallet public key that will sign the tx.\n * @param options - Optional overrides.\n * @returns The swap transaction response containing the serialized tx.\n */\nexport async function getSwapTransaction(\n  quoteResponse: JupiterQuoteResponse,\n  userPublicKey: string,\n  options?: JupiterOptions\n): Promise<JupiterSwapResponse> {\n  const wrapAndUnwrapSol = options?.wrapAndUnwrapSol ?? true;\n  const prioritizationFeeLamports = options?.prioritizationFeeLamports ?? \"auto\";\n  const dynamicComputeUnitLimit = options?.dynamicComputeUnitLimit ?? true;\n  const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n\n  const response = await fetch(`${apiBase}/swap`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      quoteResponse,\n      userPublicKey,\n      wrapAndUnwrapSol,\n      dynamicComputeUnitLimit,\n      prioritizationFeeLamports,\n    }),\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(\n      `Jupiter swap error (${response.status}): ${response.statusText}${text ? ` \\u2014 ${text}` : \"\"}`\n    );\n  }\n\n  return response.json() as Promise<JupiterSwapResponse>;\n}\n\n/**\n * Sign, send, and confirm a Jupiter swap transaction on-chain.\n *\n * This is a convenience wrapper that deserializes the swap transaction\n * from `getSwapTransaction`, signs it with the provided keypair, sends\n * it via the RPC connection, and waits for confirmation.\n *\n * @param swapResponse - The swap response from `getSwapTransaction`.\n * @param keypair - The Solana keypair that will sign the transaction.\n * @param connection - A Solana RPC connection.\n * @param options - Optional overrides (commitment level).\n * @returns The confirmed transaction signature (base58).\n */\nexport async function executeSwap(\n  swapResponse: JupiterSwapResponse,\n  keypair: Keypair,\n  connection: Connection,\n  options?: Pick<JupiterOptions, \"commitment\">\n): Promise<string> {\n  const commitment = options?.commitment ?? \"confirmed\";\n\n  // Deserialize the versioned transaction from the base64-encoded wire format\n  const txBuffer = Buffer.from(swapResponse.swapTransaction, \"base64\");\n  const transaction = VersionedTransaction.deserialize(txBuffer);\n\n  // Sign with the user's keypair\n  transaction.sign([keypair]);\n\n  // Send the signed transaction\n  const signature = await connection.sendRawTransaction(\n    transaction.serialize(),\n    { skipPreflight: false, maxRetries: 3 }\n  );\n\n  // Wait for confirmation\n  const confirmation = await connection.confirmTransaction(\n    signature,\n    commitment\n  );\n\n  if (confirmation.value.err) {\n    throw new Error(`Swap transaction failed: ${confirmation.value.err}`);\n  }\n\n  return signature;\n}\n\n/**\n * Get the current USD price of a token by requesting a 1-unit quote.\n *\n * @param mint - The SPL token mint.\n * @param options - Optional overrides.\n * @returns The price in USD, or `null` if unavailable.\n */\nexport async function getTokenPriceInUsd(\n  mint: string,\n  options?: JupiterOptions\n): Promise<number | null> {\n  try {\n    const apiBase = options?.apiBase ?? DEFAULT_JUP_API;\n    const quoteAmount = 10 ** 6; // 1 USDT unit\n    const params = new URLSearchParams({\n      inputMint: mint,\n      outputMint: DEFAULT_USDT_MINT,\n      amount: String(quoteAmount),\n      slippageBps: \"100\",\n      onlyDirectRoutes: \"true\",\n    });\n\n    const response = await fetch(`${apiBase}/quote?${params}`);\n    if (!response.ok) return null;\n\n    const data = (await response.json()) as JupiterQuoteResponse;\n    // outAmount is in USDT units (6 decimals)\n    return parseFloat(data.outAmount) / 1_000_000;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Estimate the USD value of a token amount using Jupiter pricing.\n *\n * @param mint - The SPL token mint.\n * @param rawAmount - Raw amount string (includes decimals).\n * @param decimals - Number of decimal places for the token.\n * @param options - Optional overrides.\n * @returns The estimated USD value, or `null` if pricing is unavailable.\n */\nexport async function estimateValueInUsd(\n  mint: string,\n  rawAmount: string,\n  decimals: number,\n  options?: JupiterOptions\n): Promise<number | null> {\n  try {\n    const price = await getTokenPriceInUsd(mint, options);\n    if (price === null) return null;\n    const amount = parseFloat(rawAmount) / 10 ** decimals;\n    return amount * price;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@kololabs/router",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Jupiter swap routing for the Kolo SPL Auto-Convert SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@solana/web3.js": ">=1.98.0"
+  },
+  "devDependencies": {
+    "@solana/web3.js": "^1.98.0",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/poolparty21/SPL-Auto-Convert-SDK.git",
+    "directory": "packages/router"
+  }
+}