goat-plugin-orbit

GOAT SDK plugin for Orbit Finance — a standalone DLMM (Discrete Liquidity Market Maker) on Solana with a custom on-chain program.

Exposes 6 tools to any AI agent framework supported by GOAT SDK (Vercel AI, LangChain, Eliza, and more):

Tool	Description
`get_orbit_price`	Current USD price + active bin for a pool
`get_orbit_pool_info`	Full pool metadata: TVL, volume, reserves, fee tier
`get_orbit_quote`	Swap quote (expected output, price impact, min output)
`orbit_swap`	Execute a swap through an Orbit DLMM pool
`orbit_add_liquidity`	Open a liquidity position across a bin range
`orbit_remove_liquidity`	Withdraw liquidity from an existing position

Note: orbit_swap, orbit_add_liquidity, and orbit_remove_liquidity require the orbit-dlmm peer dependency for on-chain transaction building.

Install

npm install goat-plugin-orbit orbit-dlmm
# or
yarn add goat-plugin-orbit orbit-dlmm

Usage — Vercel AI SDK

import { openai } from "@ai-sdk/openai";
import { generateText } from "ai";
import { getOnChainTools } from "@goat-sdk/adapter-vercel-ai";
import { solana } from "@goat-sdk/wallet-solana";
import { orbit } from "goat-plugin-orbit";
import { Connection, Keypair } from "@solana/web3.js";

// Set up Solana wallet
const connection = new Connection("https://rpc.helius.xyz/?api-key=YOUR_KEY");
const wallet = solana({
  connection,
  keypair: Keypair.fromSecretKey(yourPrivateKey),
});

// Wire up Orbit tools
const tools = await getOnChainTools({
  wallet,
  plugins: [
    orbit({
      rpcUrl: "https://rpc.helius.xyz/?api-key=YOUR_KEY",
    }),
  ],
});

// Ask the agent to swap
const result = await generateText({
  model: openai("gpt-4o"),
  tools,
  maxSteps: 5,
  prompt:
    "Check the price of CIPHER/USDC on Orbit Finance (pool EoLGqHKvtK9NcxjjnvSxTYYuFMYDeWTFFyKYj1DcJyPB), " +
    "then swap 10 USDC for CIPHER with 1% max slippage.",
});

console.log(result.text);

Usage — LangChain

import { ChatOpenAI } from "@langchain/openai";
import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
import { getTools } from "@goat-sdk/adapter-langchain";
import { solana } from "@goat-sdk/wallet-solana";
import { orbit } from "goat-plugin-orbit";

const tools = await getTools({
  wallet: solana({ connection, keypair }),
  plugins: [orbit({ rpcUrl: "https://api.mainnet-beta.solana.com" })],
});

const agent = createToolCallingAgent({ llm: new ChatOpenAI({ model: "gpt-4o" }), tools, prompt });
const executor = new AgentExecutor({ agent, tools });
await executor.invoke({ input: "What is the current CIPHER price on Orbit Finance?" });

Configuration

import { orbit } from "goat-plugin-orbit";

const plugin = orbit({
  // Solana RPC endpoint. Default: https://api.mainnet-beta.solana.com
  // Use a private RPC in production for better reliability.
  rpcUrl: "https://rpc.helius.xyz/?api-key=YOUR_HELIUS_KEY",
});

Constants

Item	Value
Program ID	`Fn3fA3fjsmpULNL7E9U79jKTe1KHxPtQeWdURCbJXCnM`
API base	`https://orbit-dex.api.cipherlabsx.com/api/v1`
CIPHER mint	`Ciphern9cCXtms66s8Mm6wCFC27b2JProRQLYmiLMH3N`
CIPHER/USDC pool	`EoLGqHKvtK9NcxjjnvSxTYYuFMYDeWTFFyKYj1DcJyPB`
Max bins per position	64

Architecture

Orbit Finance is a standalone DLMM — not a Meteora fork. It has:

A custom on-chain program (Fn3fA3fjsmpULNL7E9U79jKTe1KHxPtQeWdURCbJXCnM) with its own account layout
BinArray size of 64 (vs Meteora's 70)
Pool account (vs Meteora's LbPair)
Live oracle via Switchboard On-Demand (DoquSdks441bYqvcNTMTqsqZB6LHwUHhrwSzUZjpqYyg)
Jupiter integration PRs: #17, #28 (open)

Read tools call the Orbit REST API. Write tools use the orbit-dlmm TypeScript SDK to build and sign transactions on-chain.

License

MIT — CipherLabs / Orbit Finance