Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ MAINNET_ENDPOINT=https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_KEY
# STELLIUM_API_KEY=
# FLASHBLOCK_API_KEY=
# NODE1_API_KEY=
# APEX_API_KEY=
# APEX_REGION=global # global|fra|ams|dub|lon|nyc|slc|sgp|tyo|sqq

# ─── Trading Defaults (optional) ────────────────────────────
# TX_LANDING_MODE=concurrent # concurrent|race|random|sequential
Expand Down
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -664,7 +664,7 @@ await manager.stop();

## TX Landing Providers

12 providers with concurrent, race, random, and sequential submission strategies:
13 providers with concurrent, race, random, and sequential submission strategies:

| Provider | Env Var |
|----------|---------|
Expand All @@ -680,6 +680,7 @@ await manager.stop();
| Stellium | `STELLIUM_API_KEY` |
| Flashblock | `FLASHBLOCK_API_KEY` |
| Node1 | `NODE1_API_KEY` |
| OrbitFlare Apex | `APEX_API_KEY` (optional `APEX_REGION`, default `global`) |

Set any provider's API key and it's automatically enabled. The orchestrator sends your transaction through all enabled providers simultaneously for the fastest possible landing.

Expand Down Expand Up @@ -773,7 +774,7 @@ src/
├── orchestrator.ts # Multi-provider concurrent submission
├── nonce-manager.ts # Durable nonce for dedup
├── tip-accounts.ts # Tip account registry
└── providers/ # 12 provider implementations
└── providers/ # 13 provider implementations
```

## Discord
Expand Down
11 changes: 6 additions & 5 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>outsmart - Solana Trading CLI & SDK</title>
<meta name="description" content="Trade across 18 Solana DEXes with one CLI. Buy, sell, LP, and create pools with 12 TX landing providers.">
<meta name="description" content="Trade across 18 Solana DEXes with one CLI. Buy, sell, LP, and create pools with 13 TX landing providers.">
<meta property="og:title" content="outsmart - Solana Trading CLI & SDK">
<meta property="og:description" content="One CLI for every major Solana DEX. 18 adapters, 12 TX providers, full LP support.">
<meta property="og:description" content="One CLI for every major Solana DEX. 18 adapters, 13 TX providers, full LP support.">
<meta property="og:type" content="website">
<meta property="og:url" content="https://outsmartchad.github.io/outsmart-cli/">
<link rel="preconnect" href="https://fonts.googleapis.com">
Expand Down Expand Up @@ -381,7 +381,7 @@

<!-- Hero -->
<div id="home" class="hero-wrap">
<div class="hero-badge"><span class="dot"></span> v2.0.0-alpha &middot; 18 DEX adapters &middot; Percolator perps &middot; 12 TX providers</div>
<div class="hero-badge"><span class="dot"></span> v2.0.0-alpha &middot; 18 DEX adapters &middot; Percolator perps &middot; 13 TX providers</div>
<h1>Trade every Solana DEX<br>from your <span class="grad">terminal</span></h1>
<p class="desc">One CLI and TypeScript SDK to buy, sell, LP, and create pools across every major Solana protocol. Built for traders, bots, and AI agents.</p>

Expand Down Expand Up @@ -677,7 +677,7 @@ <h2 id="adapters"><span class="grad">DEX Adapters</span></h2>

<!-- TX Landing -->
<h2 id="providers"><span class="grad">TX Landing Providers</span></h2>
<p>12 providers running simultaneously. Set the API key and the provider auto-enables.</p>
<p>13 providers running simultaneously. Set the API key and the provider auto-enables.</p>
<div class="prov-grid">
<div class="prov"><span class="prov-name">Jito</span><span class="prov-env">JITO_API_KEY</span></div>
<div class="prov"><span class="prov-name">bloXroute</span><span class="prov-env">BLOXROUTE_AUTH_HEADER</span></div>
Expand All @@ -691,6 +691,7 @@ <h2 id="providers"><span class="grad">TX Landing Providers</span></h2>
<div class="prov"><span class="prov-name">Stellium</span><span class="prov-env">STELLIUM_API_KEY</span></div>
<div class="prov"><span class="prov-name">Flashblock</span><span class="prov-env">FLASHBLOCK_API_KEY</span></div>
<div class="prov"><span class="prov-name">Node1</span><span class="prov-env">NODE1_API_KEY</span></div>
<div class="prov"><span class="prov-name">OrbitFlare Apex</span><span class="prov-env">APEX_API_KEY</span></div>
</div>
<div class="pills">
<span class="pill">&#9889; Concurrent</span>
Expand Down Expand Up @@ -775,7 +776,7 @@ <h3>Project Structure</h3>
send-rpc.ts <span class="td"># Simulation, backoff, dry-run</span>
<span class="tf">landing/</span>
orchestrator.ts <span class="td"># Multi-provider submission</span>
<span class="tf">providers/</span> <span class="td"># 12 provider implementations</span></pre>
<span class="tf">providers/</span> <span class="td"># 13 provider implementations</span></pre>

<!-- Testing -->
<h2 id="testing"><span class="grad">Testing</span></h2>
Expand Down
6 changes: 6 additions & 0 deletions src/cli.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1483,6 +1483,8 @@ configCmd
"STELLIUM_API_KEY",
"FLASHBLOCK_API_KEY",
"NODE1_API_KEY",
"APEX_API_KEY",
"APEX_REGION",
"TX_LANDING_MODE",
"TX_LANDING_PROVIDERS",
"DEFAULT_TIP_SOL",
Expand Down Expand Up @@ -1535,6 +1537,8 @@ SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
# STELLIUM_API_KEY=
# FLASHBLOCK_API_KEY=
# NODE1_API_KEY=
# APEX_API_KEY=
# APEX_REGION=global # global|fra|ams|dub|lon|nyc|slc|sgp|tyo|sqq

# ─── TX Landing Strategy ───
# TX_LANDING_MODE=race # concurrent|race|random|sequential
Expand Down Expand Up @@ -1641,6 +1645,8 @@ program
"# STELLIUM_API_KEY=",
"# FLASHBLOCK_API_KEY=",
"# NODE1_API_KEY=",
"# APEX_API_KEY=",
"# APEX_REGION=global",
"",
"# ─── Trading Defaults (optional) ───",
"# TX_LANDING_MODE=concurrent",
Expand Down
1 change: 1 addition & 0 deletions src/transactions/landing/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -55,3 +55,4 @@ export { createProvider as createFlashblockProvider } from "./providers/flashblo
export { createProvider as createJitoProvider } from "./providers/jito";
export { createProvider as createNextblockProvider } from "./providers/nextblock";
export { createProvider as createSoyasProvider } from "./providers/soyas";
export { createProvider as createApexProvider } from "./providers/apex";
4 changes: 3 additions & 1 deletion src/transactions/landing/orchestrator.ts
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ import { createProvider as createFlashblock } from "./providers/flashblock";
import { createProvider as createJito } from "./providers/jito";
import { createProvider as createNextblock } from "./providers/nextblock";
import { createProvider as createSoyas } from "./providers/soyas";
import { createProvider as createApex } from "./providers/apex";

// ---------------------------------------------------------------------------
// Provider registry
Expand All @@ -55,12 +56,13 @@ const PROVIDER_FACTORIES: Record<string, () => ILandingProvider> = {
"jito": createJito,
"nextblock": createNextblock,
"soyas": createSoyas,
"apex": createApex,
};

/** Default providers for concurrent snipe submission (matches source orchestrator) */
const DEFAULT_SNIPE_PROVIDERS = [
"zero-slot", "nozomi", "helius-sender", "astralane",
"stellium", "blockrazor", "flashblock", "node1", "soyas",
"stellium", "blockrazor", "flashblock", "node1", "soyas", "apex",
];

/** Default providers for random pick strategy */
Expand Down
158 changes: 158 additions & 0 deletions src/transactions/landing/providers/apex.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
/**
* OrbitFlare Apex TX Landing Provider
*
* Submits transactions via Apex's HTTP JSON-RPC endpoint. Apex sends each
* transaction to the upcoming leaders over staked validator clients, Jito
* bundles and direct TPU at once; one tip covers all three paths.
* Uses sendTransaction with base64 encoding and the x-api-key header.
*
* Env:
* APEX_API_KEY — required; enables the provider
* APEX_REGION — global (default, nearest healthy endpoint) or
* fra|ams|dub|lon|nyc|slc|sgp|tyo|sqq
* APEX_URL — full endpoint URL; overrides APEX_REGION
* APEX_MEV_PROTECT — "true" to skip leaders on Apex's MEV blocklist
*
* Supports ping() to keep the HTTP connection warm.
*/

import axios from "axios";
import {
Keypair,
PublicKey,
SystemProgram,
TransactionInstruction,
TransactionMessage,
VersionedTransaction,
LAMPORTS_PER_SOL,
} from "@solana/web3.js";
import {
ILandingProvider,
LandingResult,
SubmitOptions,
extractBlockhash,
pickRandom,
} from "../types";

// ---------------------------------------------------------------------------
// Config
// ---------------------------------------------------------------------------

/** Vaults of the Apex tip program 9ig7pd4gqe2m16ACGPbPo4HfMGD3ba38poDhXEayx7EF. */
const TIP_ACCOUNTS = [
"APeX2oLtjYehgTMUCA971L8htM7tGNqsXHDz5NrivhhX",
"APeXAKT6spXSmU3uRv2MoEgQ7ckhAS4nexTgaxwLEfJ9",
"APeXB4mu1X7BSjwyPtiNUnKyhvc4wrq5SKEdmnPKWR95",
"APeXJTSGoxLWmwb9o1tiiEL5RXVUakazYgjLmZdDc2Ef",
"APeXUUaKFfPXjPxKHEdwCsJ4BfTuGg4qnVQyJE9K37PU",
"APeXVWXKDRAAujckMjmMsV61a4DQiXa98MPUAkL46sim",
"APeXW6PKFZRDz7WXBBybBMcoJaQo97UtLa5TAQnchNBY",
"APeXZuKaKuqouyfU8fFL1woeWvSEVFkY4EMrmkvbfhhD",
"APeXbYdbmrYWsastf6GurexGe3dwnuWKLD2mcsDoEuBU",
"APeXn29deoxpsZz6r7n63Ymmv2skBr3WhKYLB1mB2fR7",
] as const;

const REGIONS = ["global", "fra", "ams", "dub", "lon", "nyc", "slc", "sgp", "tyo", "sqq"] as const;

/** The standard tier's tip floor. A key's tier can set another; Apex rejects tips below it. */
const DEFAULT_TIP_SOL = 0.001;

function endpoint(): string {
if (process.env.APEX_URL) return process.env.APEX_URL;
const region = (process.env.APEX_REGION || "global").toLowerCase();
if (!(REGIONS as readonly string[]).includes(region)) {
throw new Error(`Unknown APEX_REGION "${region}" (use one of: ${REGIONS.join(", ")})`);
}
return `http://${region}.apex.orbitflare.com`;
}

// ---------------------------------------------------------------------------
// Provider
// ---------------------------------------------------------------------------

function createProvider(): ILandingProvider {
return {
name: "apex",

isEnabled(): boolean {
return !!process.env.APEX_API_KEY;
},

async ping(): Promise<void> {
await axios.get(`${endpoint().replace(/\/+$/, "")}/ping`, { timeout: 5_000 });
},

async submit(
ixs: TransactionInstruction[],
signer: Keypair,
blockhash: string | { blockhash: string; lastValidBlockHeight: number },
opts: SubmitOptions,
): Promise<LandingResult> {
const provider = this.name;
try {
const key = process.env.APEX_API_KEY || "";
if (!key) {
return { provider, accepted: false, error: "APEX_API_KEY not set" };
}

const tipSol = opts.tipSol && opts.tipSol > 0 ? opts.tipSol : DEFAULT_TIP_SOL;

// Exactly one top-level transfer to an Apex tip account. The tip account is
// not in any lookup table, so it stays in the static keys as Apex requires.
const tipIx = SystemProgram.transfer({
fromPubkey: signer.publicKey,
toPubkey: new PublicKey(pickRandom(TIP_ACCOUNTS)),
lamports: Math.round(tipSol * LAMPORTS_PER_SOL),
});

// Build V0 transaction — never mutate input ixs
const allIxs = [...ixs, tipIx];
const bh = extractBlockhash(blockhash);

const messageV0 = new TransactionMessage({
payerKey: signer.publicKey,
recentBlockhash: bh,
instructions: allIxs,
}).compileToV0Message(opts.addressLookupTables);

const tx = new VersionedTransaction(messageV0);
const signers: Keypair[] = [signer, ...(opts.extraSigners ?? [])];
tx.sign(signers);

const b64 = Buffer.from(tx.serialize()).toString("base64");
const mevProtect = process.env.APEX_MEV_PROTECT === "true";

const t0 = Date.now();
const response = await axios.post(
endpoint(),
{
jsonrpc: "2.0",
id: 1,
method: "sendTransaction",
// The third param is Apex's mevProtect flag.
params: [b64, { encoding: "base64" }, mevProtect],
},
{ timeout: 10_000, headers: { "x-api-key": key } },
);
const latencyMs = Date.now() - t0;

const signature: string | undefined = response.data?.result;
if (signature) {
return { provider, accepted: true, signature, latencyMs };
}

const errMsg =
response.data?.error?.message || JSON.stringify(response.data?.error) || "Unknown apex error";
return { provider, accepted: false, error: errMsg, latencyMs };
} catch (err: any) {
return {
provider,
accepted: false,
error: err?.response?.data?.error?.message || err?.message || "apex request failed",
};
}
},
};
}

export { createProvider };
12 changes: 12 additions & 0 deletions src/transactions/landing/tip-accounts.ts
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,18 @@ export const TIP_ACCOUNTS: readonly TipAccount[] = [
{ provider: "soyas", address: "soyascXFW5wEEYiwfEmHy2pNwomqzvggJosGVD6TJdY" },
{ provider: "soyas", address: "soyasDBdKjADwPz3xk82U3TNPRDKEWJj7wWLajNHZ1L" },
{ provider: "soyas", address: "soyasE2abjBAynmHbGWgEwk4ctBy7JMTUCNrMbjcnyH" },

// apex
{ provider: "apex", address: "APeX2oLtjYehgTMUCA971L8htM7tGNqsXHDz5NrivhhX" },
{ provider: "apex", address: "APeXAKT6spXSmU3uRv2MoEgQ7ckhAS4nexTgaxwLEfJ9" },
{ provider: "apex", address: "APeXB4mu1X7BSjwyPtiNUnKyhvc4wrq5SKEdmnPKWR95" },
{ provider: "apex", address: "APeXJTSGoxLWmwb9o1tiiEL5RXVUakazYgjLmZdDc2Ef" },
{ provider: "apex", address: "APeXUUaKFfPXjPxKHEdwCsJ4BfTuGg4qnVQyJE9K37PU" },
{ provider: "apex", address: "APeXVWXKDRAAujckMjmMsV61a4DQiXa98MPUAkL46sim" },
{ provider: "apex", address: "APeXW6PKFZRDz7WXBBybBMcoJaQo97UtLa5TAQnchNBY" },
{ provider: "apex", address: "APeXZuKaKuqouyfU8fFL1woeWvSEVFkY4EMrmkvbfhhD" },
{ provider: "apex", address: "APeXbYdbmrYWsastf6GurexGe3dwnuWKLD2mcsDoEuBU" },
{ provider: "apex", address: "APeXn29deoxpsZz6r7n63Ymmv2skBr3WhKYLB1mB2fR7" },
] as const;

/**
Expand Down
4 changes: 2 additions & 2 deletions src/transactions/landing/types.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
* TX Landing Layer — Shared Types & Interfaces
*
* This module defines the provider interface and shared types used by
* all 12+ TX landing providers (0slot, nozomi, helius-sender, blockrazor,
* node1.me, bloXroute, astralane, stellium, flashblock, jito, nextblock, soyas).
* all 13 TX landing providers (0slot, nozomi, helius-sender, blockrazor,
* node1.me, bloXroute, astralane, stellium, flashblock, jito, nextblock, soyas, apex).
*
* Each provider implements ILandingProvider. The orchestrator calls them
* using a uniform interface — no provider-specific logic leaks out.
Expand Down
Loading