OVERVIEW

What is Quantora?

Quantora is a fee-aware routing framework for swaps on Solana and other ecosystems. It compares multiple venues, simulates net outputs after all costs and returns the route where the user keeps the most of what they swap.

Instead of wiring each venue manually, you integrate a single SDK and gain a unified interface to Jupiter, Orca, Raydium, Meteora-style venues and your own connectors.

Core mission

Why Quantora exists

Without a routing layer you typically:

• hardcode one venue per pair or per region;
• ignore trading fees, gas fees and price impact in comparisons;
• cannot explain to users why a specific venue was chosen.

Quantora solves this by providing a normalized quote model and a routing engine which always chooses the maximum net output.

Getting started: installation

npm install quantora

# or

yarn add quantora

import Quantora from 'quantora';

const best = await Quantora.getBestRoute({
  inputMint: 'So11111111111111111111111111111111111111112',     // SOL
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  amountUi: 1,
  slippageBps: 50
});

console.log(best);

Core concepts

type QuoteParams = {
  inputMint: string;
  outputMint: string;
  amountUi: number;
  slippageBps?: number;
  connectors?: Array<{
    id: string;
    fn: (params: QuoteParams) => Promise<QuoteResult | null>;
  }>;
};

type QuoteResult = {
  venue: string;
  inMint: string;
  outMint: string;
  inAmountUi: number;
  outAmountUi: number;
  priceImpactPct: number | null;
  raw: any;
  connectorId?: string;
};

Routing logic

On each request Quantora:

1. Calls all configured connectors in parallel.
2. Normalizes their responses into QuoteResult.
3. Filters out failed / null quotes.
4. Sorts by outAmountUi in descending order.

The first route in this sorted list is the best route for the user from a net output perspective.

User guide: using Quantora-powered apps

Many apps will show Quantora just as a small label like “Powered by Quantora” near the swap button. You don’t have to configure anything — you use the app as usual, but every swap is checked against multiple venues in the background.

As an everyday user you mainly interact with:

• the routing screen,
• the fee breakdown,
• and optional “Best route” toggle.

Using the routing screen

Understanding fees as a user

When a route is selected, the app can show a small panel with a breakdown similar to:

• Service fee — fee taken by the venue or your app.
• Network fee — blockchain transaction cost (gas).
• Price impact / slippage — how much the price moves because of your trade size.

Quantora compares venues by the final amount you receive after all of these are applied. So “best route” always means “highest amount in your wallet”, not just “prettiest rate”.

Security & privacy for users

Quantora itself does not hold custody of funds. You still connect your wallet to the app you trust, sign transactions as usual, and your private keys never leave your wallet.

A Quantora-powered app may log anonymous routing statistics such as:

• which venues were selected,
• average fee savings,
• which tokens are most popular.

These stats help teams improve routes over time, but they do not require any personal identity or seed phrase information.

SDK reference: public API

import Quantora, {
  scanVenues,
  sortRoutes,
  getBestFromList,
  getBestRoute
} from 'quantora';

Examples

import Quantora from 'quantora';

const params = {
  inputMint: 'So11111111111111111111111111111111111111112',
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  amountUi: 1,
  slippageBps: 50
};

const routes = await Quantora.scanVenues(params);
const best   = Quantora.getBestFromList(routes);

console.log(routes);
console.log(best);

async function handleSwapCommand({ fromMint, toMint, amount }) {
  const best = await Quantora.getBestRoute({
    inputMint: fromMint,
    outputMint: toMint,
    amountUi: amount,
    slippageBps: 75
  });

  if (!best) {
    return 'No route found right now, try again.';
  }

  return \`Best venue: \${best.venue}, you receive ~\${best.outAmountUi}\`;
}

Connectors

Connectors live under src/connectors/ and implement the same shape:

export async function getQuote(params: QuoteParams): Promise<QuoteResult | null> { ... }

Deployment & infrastructure

Tokenomics (draft design)

Quantora can work without a token at all. This section describes a possible token design if the project evolves into a public network.

• Utility: pay for analytics / premium routing profiles.
• Staking: align connectors and operators by staking to venues.
• Rewards: share part of fee savings with integrators.

Exact parameters (supply, emissions, schedules) are intentionally not fixed yet and can be adjusted based on real usage.

Governance & decision making

If a token and DAO are introduced, governance could decide on:

• which venues are allowed or blocked by default;
• how fee savings are split between users, apps and protocol;
• roadmap priorities (new chains, new connectors, new analytics).

Until then, Quantora stays a focused product with decisions made by the core contributors, keeping upgrades fast and opinionated.

Roadmap