@kololabs/router 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @kololabs/router
+
+## 0.1.1
+
+### Patch Changes
+
+- Initial release of @kololabs packages for automatic SOL to USDT conversion.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 poolparty21
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,84 @@
+"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, {
+  createRouter: () => createRouter
+});
+module.exports = __toCommonJS(index_exports);
+var import_web3 = require("@solana/web3.js");
+var import_node_buffer = require("buffer");
+var JUPITER_BASE_URL = "https://api.jup.ag/swap/v2";
+function createRouter(config) {
+  const baseUrl = config?.baseUrl ?? JUPITER_BASE_URL;
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config?.apiKey) {
+    headers["x-api-key"] = config.apiKey;
+  }
+  const getQuote = async (params) => {
+    const url = new URL(baseUrl + "/quote");
+    url.searchParams.set("inputMint", params.inputMint);
+    url.searchParams.set("outputMint", params.outputMint);
+    url.searchParams.set("amount", params.amount);
+    url.searchParams.set("slippageBps", String(params.slippageBps));
+    const response = await globalThis.fetch(url.toString(), { headers });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Jupiter quote failed (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    return {
+      inputMint: data.inputMint,
+      outputMint: data.outputMint,
+      inAmount: data.inAmount,
+      outAmount: data.outAmount,
+      otherAmountThreshold: data.otherAmountThreshold,
+      priceImpactPct: data.priceImpactPct,
+      routePlan: data.routePlan
+    };
+  };
+  const getSwapTransaction = async (params) => {
+    const response = await globalThis.fetch(baseUrl + "/swap", {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        quoteResponse: params.quoteResponse,
+        userPublicKey: params.userPublicKey,
+        wrapAndUnwrapSol: params.wrapAndUnwrapSol ?? true,
+        useSharedAccounts: params.useSharedAccounts ?? true
+      })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Jupiter swap failed (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    const txBuffer = import_node_buffer.Buffer.from(data.swapTransaction, "base64");
+    return import_web3.VersionedTransaction.deserialize(txBuffer);
+  };
+  return { getQuote, getSwapTransaction };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRouter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { VersionedTransaction } from '@solana/web3.js'\nimport { Buffer } from 'node:buffer'\n\nconst JUPITER_BASE_URL = 'https://api.jup.ag/swap/v2'\n\nexport interface QuoteParams {\n  inputMint: string\n  outputMint: string\n  amount: string\n  slippageBps: number\n}\n\nexport interface QuoteResponse {\n  inputMint: string\n  outputMint: string\n  inAmount: string\n  outAmount: string\n  otherAmountThreshold: string\n  priceImpactPct: string\n  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>\n}\n\nexport interface SwapParams {\n  quoteResponse: QuoteResponse\n  userPublicKey: string\n  wrapAndUnwrapSol?: boolean\n  useSharedAccounts?: boolean\n}\n\nexport interface RouterConfig {\n  baseUrl?: string\n  apiKey?: string\n}\n\ninterface JupiterQuoteResponse {\n  inputMint: string\n  outputMint: string\n  inAmount: string\n  outAmount: string\n  otherAmountThreshold: string\n  priceImpactPct: string\n  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>\n}\n\ninterface JupiterSwapResponse {\n  swapTransaction: string\n  lastValidBlockHeight: number\n  prioritizationFeeLamports: number\n}\n\nexport function createRouter(config?: RouterConfig) {\n  const baseUrl = config?.baseUrl ?? JUPITER_BASE_URL\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  }\n  if (config?.apiKey) {\n    headers['x-api-key'] = config.apiKey\n  }\n\n  const getQuote = async (params: QuoteParams): Promise<QuoteResponse> => {\n    const url = new URL(baseUrl + '/quote')\n    url.searchParams.set('inputMint', params.inputMint)\n    url.searchParams.set('outputMint', params.outputMint)\n    url.searchParams.set('amount', params.amount)\n    url.searchParams.set('slippageBps', String(params.slippageBps))\n\n    const response = await globalThis.fetch(url.toString(), { headers })\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`Jupiter quote failed (${response.status}): ${text}`)\n    }\n\n    const data = (await response.json()) as JupiterQuoteResponse\n    return {\n      inputMint: data.inputMint,\n      outputMint: data.outputMint,\n      inAmount: data.inAmount,\n      outAmount: data.outAmount,\n      otherAmountThreshold: data.otherAmountThreshold,\n      priceImpactPct: data.priceImpactPct,\n      routePlan: data.routePlan,\n    }\n  }\n\n  const getSwapTransaction = async (params: SwapParams): Promise<VersionedTransaction> => {\n    const response = await globalThis.fetch(baseUrl + '/swap', {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({\n        quoteResponse: params.quoteResponse,\n        userPublicKey: params.userPublicKey,\n        wrapAndUnwrapSol: params.wrapAndUnwrapSol ?? true,\n        useSharedAccounts: params.useSharedAccounts ?? true,\n      }),\n    })\n\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`Jupiter swap failed (${response.status}): ${text}`)\n    }\n\n    const data = (await response.json()) as JupiterSwapResponse\n    const txBuffer = Buffer.from(data.swapTransaction, 'base64')\n    return VersionedTransaction.deserialize(txBuffer)\n  }\n\n  return { getQuote, getSwapTransaction }\n}\n\nexport type Router = ReturnType<typeof createRouter>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAqC;AACrC,yBAAuB;AAEvB,IAAM,mBAAmB;AA+ClB,SAAS,aAAa,QAAuB;AAClD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAkC;AAAA,IACtC,gBAAgB;AAAA,EAClB;AACA,MAAI,QAAQ,QAAQ;AAClB,YAAQ,WAAW,IAAI,OAAO;AAAA,EAChC;AAEA,QAAM,WAAW,OAAO,WAAgD;AACtE,UAAM,MAAM,IAAI,IAAI,UAAU,QAAQ;AACtC,QAAI,aAAa,IAAI,aAAa,OAAO,SAAS;AAClD,QAAI,aAAa,IAAI,cAAc,OAAO,UAAU;AACpD,QAAI,aAAa,IAAI,UAAU,OAAO,MAAM;AAC5C,QAAI,aAAa,IAAI,eAAe,OAAO,OAAO,WAAW,CAAC;AAE9D,UAAM,WAAW,MAAM,WAAW,MAAM,IAAI,SAAS,GAAG,EAAE,QAAQ,CAAC;AACnE,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAM,IAAI,MAAM,yBAAyB,SAAS,MAAM,MAAM,IAAI,EAAE;AAAA,IACtE;AAEA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,YAAY,KAAK;AAAA,MACjB,UAAU,KAAK;AAAA,MACf,WAAW,KAAK;AAAA,MAChB,sBAAsB,KAAK;AAAA,MAC3B,gBAAgB,KAAK;AAAA,MACrB,WAAW,KAAK;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,qBAAqB,OAAO,WAAsD;AACtF,UAAM,WAAW,MAAM,WAAW,MAAM,UAAU,SAAS;AAAA,MACzD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,eAAe,OAAO;AAAA,QACtB,eAAe,OAAO;AAAA,QACtB,kBAAkB,OAAO,oBAAoB;AAAA,QAC7C,mBAAmB,OAAO,qBAAqB;AAAA,MACjD,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAM,IAAI,MAAM,wBAAwB,SAAS,MAAM,MAAM,IAAI,EAAE;AAAA,IACrE;AAEA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,UAAM,WAAW,0BAAO,KAAK,KAAK,iBAAiB,QAAQ;AAC3D,WAAO,iCAAqB,YAAY,QAAQ;AAAA,EAClD;AAEA,SAAO,EAAE,UAAU,mBAAmB;AACxC;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import { VersionedTransaction } from '@solana/web3.js';
+
+interface QuoteParams {
+    inputMint: string;
+    outputMint: string;
+    amount: string;
+    slippageBps: number;
+}
+interface QuoteResponse {
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    priceImpactPct: string;
+    routePlan: Array<{
+        swapInfo: {
+            ammKey: string;
+            label: string;
+        };
+    }>;
+}
+interface SwapParams {
+    quoteResponse: QuoteResponse;
+    userPublicKey: string;
+    wrapAndUnwrapSol?: boolean;
+    useSharedAccounts?: boolean;
+}
+interface RouterConfig {
+    baseUrl?: string;
+    apiKey?: string;
+}
+declare function createRouter(config?: RouterConfig): {
+    getQuote: (params: QuoteParams) => Promise<QuoteResponse>;
+    getSwapTransaction: (params: SwapParams) => Promise<VersionedTransaction>;
+};
+type Router = ReturnType<typeof createRouter>;
+
+export { type QuoteParams, type QuoteResponse, type Router, type RouterConfig, type SwapParams, createRouter };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { VersionedTransaction } from '@solana/web3.js';
+
+interface QuoteParams {
+    inputMint: string;
+    outputMint: string;
+    amount: string;
+    slippageBps: number;
+}
+interface QuoteResponse {
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    priceImpactPct: string;
+    routePlan: Array<{
+        swapInfo: {
+            ammKey: string;
+            label: string;
+        };
+    }>;
+}
+interface SwapParams {
+    quoteResponse: QuoteResponse;
+    userPublicKey: string;
+    wrapAndUnwrapSol?: boolean;
+    useSharedAccounts?: boolean;
+}
+interface RouterConfig {
+    baseUrl?: string;
+    apiKey?: string;
+}
+declare function createRouter(config?: RouterConfig): {
+    getQuote: (params: QuoteParams) => Promise<QuoteResponse>;
+    getSwapTransaction: (params: SwapParams) => Promise<VersionedTransaction>;
+};
+type Router = ReturnType<typeof createRouter>;
+
+export { type QuoteParams, type QuoteResponse, type Router, type RouterConfig, type SwapParams, createRouter };

package/dist/index.js

@@ -0,0 +1,59 @@
+// src/index.ts
+import { VersionedTransaction } from "@solana/web3.js";
+import { Buffer } from "buffer";
+var JUPITER_BASE_URL = "https://api.jup.ag/swap/v2";
+function createRouter(config) {
+  const baseUrl = config?.baseUrl ?? JUPITER_BASE_URL;
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config?.apiKey) {
+    headers["x-api-key"] = config.apiKey;
+  }
+  const getQuote = async (params) => {
+    const url = new URL(baseUrl + "/quote");
+    url.searchParams.set("inputMint", params.inputMint);
+    url.searchParams.set("outputMint", params.outputMint);
+    url.searchParams.set("amount", params.amount);
+    url.searchParams.set("slippageBps", String(params.slippageBps));
+    const response = await globalThis.fetch(url.toString(), { headers });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Jupiter quote failed (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    return {
+      inputMint: data.inputMint,
+      outputMint: data.outputMint,
+      inAmount: data.inAmount,
+      outAmount: data.outAmount,
+      otherAmountThreshold: data.otherAmountThreshold,
+      priceImpactPct: data.priceImpactPct,
+      routePlan: data.routePlan
+    };
+  };
+  const getSwapTransaction = async (params) => {
+    const response = await globalThis.fetch(baseUrl + "/swap", {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        quoteResponse: params.quoteResponse,
+        userPublicKey: params.userPublicKey,
+        wrapAndUnwrapSol: params.wrapAndUnwrapSol ?? true,
+        useSharedAccounts: params.useSharedAccounts ?? true
+      })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Jupiter swap failed (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    const txBuffer = Buffer.from(data.swapTransaction, "base64");
+    return VersionedTransaction.deserialize(txBuffer);
+  };
+  return { getQuote, getSwapTransaction };
+}
+export {
+  createRouter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { VersionedTransaction } from '@solana/web3.js'\nimport { Buffer } from 'node:buffer'\n\nconst JUPITER_BASE_URL = 'https://api.jup.ag/swap/v2'\n\nexport interface QuoteParams {\n  inputMint: string\n  outputMint: string\n  amount: string\n  slippageBps: number\n}\n\nexport interface QuoteResponse {\n  inputMint: string\n  outputMint: string\n  inAmount: string\n  outAmount: string\n  otherAmountThreshold: string\n  priceImpactPct: string\n  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>\n}\n\nexport interface SwapParams {\n  quoteResponse: QuoteResponse\n  userPublicKey: string\n  wrapAndUnwrapSol?: boolean\n  useSharedAccounts?: boolean\n}\n\nexport interface RouterConfig {\n  baseUrl?: string\n  apiKey?: string\n}\n\ninterface JupiterQuoteResponse {\n  inputMint: string\n  outputMint: string\n  inAmount: string\n  outAmount: string\n  otherAmountThreshold: string\n  priceImpactPct: string\n  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>\n}\n\ninterface JupiterSwapResponse {\n  swapTransaction: string\n  lastValidBlockHeight: number\n  prioritizationFeeLamports: number\n}\n\nexport function createRouter(config?: RouterConfig) {\n  const baseUrl = config?.baseUrl ?? JUPITER_BASE_URL\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  }\n  if (config?.apiKey) {\n    headers['x-api-key'] = config.apiKey\n  }\n\n  const getQuote = async (params: QuoteParams): Promise<QuoteResponse> => {\n    const url = new URL(baseUrl + '/quote')\n    url.searchParams.set('inputMint', params.inputMint)\n    url.searchParams.set('outputMint', params.outputMint)\n    url.searchParams.set('amount', params.amount)\n    url.searchParams.set('slippageBps', String(params.slippageBps))\n\n    const response = await globalThis.fetch(url.toString(), { headers })\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`Jupiter quote failed (${response.status}): ${text}`)\n    }\n\n    const data = (await response.json()) as JupiterQuoteResponse\n    return {\n      inputMint: data.inputMint,\n      outputMint: data.outputMint,\n      inAmount: data.inAmount,\n      outAmount: data.outAmount,\n      otherAmountThreshold: data.otherAmountThreshold,\n      priceImpactPct: data.priceImpactPct,\n      routePlan: data.routePlan,\n    }\n  }\n\n  const getSwapTransaction = async (params: SwapParams): Promise<VersionedTransaction> => {\n    const response = await globalThis.fetch(baseUrl + '/swap', {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({\n        quoteResponse: params.quoteResponse,\n        userPublicKey: params.userPublicKey,\n        wrapAndUnwrapSol: params.wrapAndUnwrapSol ?? true,\n        useSharedAccounts: params.useSharedAccounts ?? true,\n      }),\n    })\n\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`Jupiter swap failed (${response.status}): ${text}`)\n    }\n\n    const data = (await response.json()) as JupiterSwapResponse\n    const txBuffer = Buffer.from(data.swapTransaction, 'base64')\n    return VersionedTransaction.deserialize(txBuffer)\n  }\n\n  return { getQuote, getSwapTransaction }\n}\n\nexport type Router = ReturnType<typeof createRouter>\n"],"mappings":";AAAA,SAAS,4BAA4B;AACrC,SAAS,cAAc;AAEvB,IAAM,mBAAmB;AA+ClB,SAAS,aAAa,QAAuB;AAClD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAkC;AAAA,IACtC,gBAAgB;AAAA,EAClB;AACA,MAAI,QAAQ,QAAQ;AAClB,YAAQ,WAAW,IAAI,OAAO;AAAA,EAChC;AAEA,QAAM,WAAW,OAAO,WAAgD;AACtE,UAAM,MAAM,IAAI,IAAI,UAAU,QAAQ;AACtC,QAAI,aAAa,IAAI,aAAa,OAAO,SAAS;AAClD,QAAI,aAAa,IAAI,cAAc,OAAO,UAAU;AACpD,QAAI,aAAa,IAAI,UAAU,OAAO,MAAM;AAC5C,QAAI,aAAa,IAAI,eAAe,OAAO,OAAO,WAAW,CAAC;AAE9D,UAAM,WAAW,MAAM,WAAW,MAAM,IAAI,SAAS,GAAG,EAAE,QAAQ,CAAC;AACnE,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAM,IAAI,MAAM,yBAAyB,SAAS,MAAM,MAAM,IAAI,EAAE;AAAA,IACtE;AAEA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,YAAY,KAAK;AAAA,MACjB,UAAU,KAAK;AAAA,MACf,WAAW,KAAK;AAAA,MAChB,sBAAsB,KAAK;AAAA,MAC3B,gBAAgB,KAAK;AAAA,MACrB,WAAW,KAAK;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,qBAAqB,OAAO,WAAsD;AACtF,UAAM,WAAW,MAAM,WAAW,MAAM,UAAU,SAAS;AAAA,MACzD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,eAAe,OAAO;AAAA,QACtB,eAAe,OAAO;AAAA,QACtB,kBAAkB,OAAO,oBAAoB;AAAA,QAC7C,mBAAmB,OAAO,qBAAqB;AAAA,MACjD,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAM,IAAI,MAAM,wBAAwB,SAAS,MAAM,MAAM,IAAI,EAAE;AAAA,IACrE;AAEA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,UAAM,WAAW,OAAO,KAAK,KAAK,iBAAiB,QAAQ;AAC3D,WAAO,qBAAqB,YAAY,QAAQ;AAAA,EAClD;AAEA,SAAO,EAAE,UAAU,mBAAmB;AACxC;","names":[]}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@kololabs/router",
+  "version": "0.1.1",
+  "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"
+    }
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.0",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/router.test.ts

@@ -0,0 +1,70 @@
+import { describe, it, expect, vi, beforeEach, afterAll } from 'vitest'
+
+const mockFetch = vi.fn()
+const origFetch = globalThis.fetch
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  globalThis.fetch = mockFetch
+})
+
+afterAll(() => {
+  globalThis.fetch = origFetch
+})
+
+describe('@kololabs/router', () => {
+  it('createRouter returns object with getQuote and getSwapTransaction', async () => {
+    const { createRouter } = await import('../index.js')
+    const router = createRouter()
+    expect(router).toHaveProperty('getQuote')
+    expect(router).toHaveProperty('getSwapTransaction')
+  })
+
+  it('getQuote constructs correct URL and returns quote', async () => {
+    const { createRouter } = await import('../index.js')
+    const mockQuoteResponse = {
+      inputMint: 'So11111111111111111111111111111111111111112',
+      outputMint: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+      inAmount: '1000000000',
+      outAmount: '95000000',
+      otherAmountThreshold: '94000000',
+      priceImpactPct: '0.05',
+      routePlan: [{ swapInfo: { ammKey: 'amm1', label: 'Orca' } }],
+    }
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      json: async () => mockQuoteResponse,
+    })
+
+    const router = createRouter({ baseUrl: 'https://api.jup.ag/swap/v2' })
+    const quote = await router.getQuote({
+      inputMint: 'So11111111111111111111111111111111111111112',
+      outputMint: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+      amount: '1000000000',
+      slippageBps: 50,
+    })
+
+    expect(mockFetch).toHaveBeenCalledTimes(1)
+    expect(quote.inAmount).toBe('1000000000')
+    expect(quote.outAmount).toBe('95000000')
+    expect(quote.priceImpactPct).toBe('0.05')
+  })
+
+  it('getQuote throws on non-ok response', async () => {
+    const { createRouter } = await import('../index.js')
+    mockFetch.mockResolvedValueOnce({
+      ok: false,
+      status: 400,
+      text: async () => 'Bad request',
+    })
+
+    const router = createRouter()
+    await expect(router.getQuote({
+      inputMint: 'So11111111111111111111111111111111111111112',
+      outputMint: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+      amount: '1000000000',
+      slippageBps: 50,
+    })).rejects.toThrow('Jupiter quote failed (400): Bad request')
+  })
+})

package/src/index.ts

@@ -0,0 +1,110 @@
+import { VersionedTransaction } from '@solana/web3.js'
+import { Buffer } from 'node:buffer'
+
+const JUPITER_BASE_URL = 'https://api.jup.ag/swap/v2'
+
+export interface QuoteParams {
+  inputMint: string
+  outputMint: string
+  amount: string
+  slippageBps: number
+}
+
+export interface QuoteResponse {
+  inputMint: string
+  outputMint: string
+  inAmount: string
+  outAmount: string
+  otherAmountThreshold: string
+  priceImpactPct: string
+  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>
+}
+
+export interface SwapParams {
+  quoteResponse: QuoteResponse
+  userPublicKey: string
+  wrapAndUnwrapSol?: boolean
+  useSharedAccounts?: boolean
+}
+
+export interface RouterConfig {
+  baseUrl?: string
+  apiKey?: string
+}
+
+interface JupiterQuoteResponse {
+  inputMint: string
+  outputMint: string
+  inAmount: string
+  outAmount: string
+  otherAmountThreshold: string
+  priceImpactPct: string
+  routePlan: Array<{ swapInfo: { ammKey: string; label: string } }>
+}
+
+interface JupiterSwapResponse {
+  swapTransaction: string
+  lastValidBlockHeight: number
+  prioritizationFeeLamports: number
+}
+
+export function createRouter(config?: RouterConfig) {
+  const baseUrl = config?.baseUrl ?? JUPITER_BASE_URL
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  }
+  if (config?.apiKey) {
+    headers['x-api-key'] = config.apiKey
+  }
+
+  const getQuote = async (params: QuoteParams): Promise<QuoteResponse> => {
+    const url = new URL(baseUrl + '/quote')
+    url.searchParams.set('inputMint', params.inputMint)
+    url.searchParams.set('outputMint', params.outputMint)
+    url.searchParams.set('amount', params.amount)
+    url.searchParams.set('slippageBps', String(params.slippageBps))
+
+    const response = await globalThis.fetch(url.toString(), { headers })
+    if (!response.ok) {
+      const text = await response.text()
+      throw new Error(`Jupiter quote failed (${response.status}): ${text}`)
+    }
+
+    const data = (await response.json()) as JupiterQuoteResponse
+    return {
+      inputMint: data.inputMint,
+      outputMint: data.outputMint,
+      inAmount: data.inAmount,
+      outAmount: data.outAmount,
+      otherAmountThreshold: data.otherAmountThreshold,
+      priceImpactPct: data.priceImpactPct,
+      routePlan: data.routePlan,
+    }
+  }
+
+  const getSwapTransaction = async (params: SwapParams): Promise<VersionedTransaction> => {
+    const response = await globalThis.fetch(baseUrl + '/swap', {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({
+        quoteResponse: params.quoteResponse,
+        userPublicKey: params.userPublicKey,
+        wrapAndUnwrapSol: params.wrapAndUnwrapSol ?? true,
+        useSharedAccounts: params.useSharedAccounts ?? true,
+      }),
+    })
+
+    if (!response.ok) {
+      const text = await response.text()
+      throw new Error(`Jupiter swap failed (${response.status}): ${text}`)
+    }
+
+    const data = (await response.json()) as JupiterSwapResponse
+    const txBuffer = Buffer.from(data.swapTransaction, 'base64')
+    return VersionedTransaction.deserialize(txBuffer)
+  }
+
+  return { getQuote, getSwapTransaction }
+}
+
+export type Router = ReturnType<typeof createRouter>

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+})