@coinbarrel/sdk 1.0.0

package/dist/index.js

@@ -0,0 +1,254 @@
+/**
+ * CoinBarrel SDK
+ *
+ * SDK for integrating with CoinBarrel AMM - bonding curves and liquidity pools on Solana.
+ *
+ * @example
+ * ```typescript
+ * import { CoinBarrel } from '@coinbarrel/sdk';
+ *
+ * // Initialize SDK
+ * const sdk = new CoinBarrel({
+ *   connection: new Connection('https://api.mainnet-beta.solana.com'),
+ *   network: 'mainnet'
+ * });
+ *
+ * // Get a buy quote
+ * const quote = await sdk.curve.getBuyQuote(tokenMint, solAmount);
+ *
+ * // Build buy instruction
+ * const instructions = await sdk.curve.buildBuyInstruction({
+ *   tokenMint,
+ *   buyer: userWallet.publicKey,
+ *   lamportsIn: BigInt(0.1 * 1e9) // 0.1 SOL
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { PROGRAM_IDS, ADMIN_FEE_RECIPIENTS, LAMPORTS_PER_SOL } from "./constants.js";
+import * as pda from "./pda.js";
+import * as accounts from "./accounts.js";
+import * as curve from "./curve.js";
+import * as pool from "./pool.js";
+// ============= Re-exports =============
+export * from "./constants.js";
+export * from "./types.js";
+export * from "./pda.js";
+export { getBondingCurveState, getPoolState, getMarketInfo, getUserTokenBalance } from "./accounts.js";
+export { getBuyQuote, getSellQuote } from "./curve.js";
+export { getSwapSolToTokenQuote, getSwapTokenToSolQuote } from "./pool.js";
+// ============= SDK Class =============
+/**
+ * CoinBarrel SDK - Main entry point
+ *
+ * Provides easy access to all CoinBarrel AMM functionality:
+ * - Bonding curve trading (pre-graduation)
+ * - AMM pool trading (post-graduation)
+ * - Market data and quotes
+ *
+ * @remarks
+ * Fee recipients are read from on-chain state and cannot be modified.
+ * The program enforces that all fees go to the correct recipients.
+ */
+export class CoinBarrel {
+    /** Solana RPC connection */
+    connection;
+    /** Network (devnet or mainnet) */
+    network;
+    /** Program ID for the current network */
+    programId;
+    /** Admin fee recipient for the current network */
+    adminFeeRecipient;
+    /** Bonding curve operations */
+    curve;
+    /** AMM pool operations */
+    pool;
+    constructor(config) {
+        this.connection = config.connection;
+        this.network = config.network;
+        this.programId = PROGRAM_IDS[config.network];
+        this.adminFeeRecipient = ADMIN_FEE_RECIPIENTS[config.network];
+        this.curve = new CurveModule(this);
+        this.pool = new PoolModule(this);
+    }
+    // ============= Market Info =============
+    /**
+     * Get comprehensive market info for a token
+     * Automatically detects if on bonding curve or AMM pool
+     */
+    async getMarketInfo(tokenMint) {
+        return accounts.getMarketInfo(this.connection, tokenMint, this.programId);
+    }
+    /**
+     * Get user's token balance
+     */
+    async getUserBalance(tokenMint, user) {
+        return accounts.getUserTokenBalance(this.connection, tokenMint, user);
+    }
+    /**
+     * Check if a token is on bonding curve (not yet graduated)
+     */
+    async isOnCurve(tokenMint) {
+        const curveState = await accounts.getBondingCurveState(this.connection, tokenMint, this.programId);
+        if (!curveState)
+            return false;
+        // If paused or max supply reached, it's graduated
+        return !curveState.paused && curveState.totalSold < curveState.maxSupply;
+    }
+    /**
+     * Check if a token has graduated to AMM pool
+     */
+    async isOnPool(tokenMint) {
+        const poolState = await accounts.getPoolState(this.connection, tokenMint, this.programId);
+        return poolState !== null;
+    }
+    // ============= PDA Helpers =============
+    /** Get bonding curve PDA for a token */
+    getBondingCurvePda(tokenMint) {
+        return pda.getBondingCurvePda(tokenMint, this.programId);
+    }
+    /** Get pool PDA for a token */
+    getPoolPda(tokenMint) {
+        return pda.getPoolPda(tokenMint, this.programId);
+    }
+    /** Get holder reward PDA for a user + token */
+    getHolderRewardPda(tokenMint, holder) {
+        return pda.getHolderRewardPda(tokenMint, holder, this.programId);
+    }
+}
+// ============= Curve Module =============
+/**
+ * Bonding Curve Operations
+ * For trading tokens that haven't graduated yet
+ */
+class CurveModule {
+    sdk;
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Get bonding curve state
+     */
+    async getState(tokenMint) {
+        return accounts.getBondingCurveState(this.sdk.connection, tokenMint, this.sdk.programId);
+    }
+    /**
+     * Get buy quote - how many tokens for X SOL
+     * @param tokenMint Token to buy
+     * @param solAmount SOL amount in lamports
+     */
+    async getBuyQuote(tokenMint, solAmount) {
+        return curve.getBuyQuote(this.sdk.connection, tokenMint, solAmount, this.sdk.programId);
+    }
+    /**
+     * Get sell quote - how much SOL for X tokens
+     * @param tokenMint Token to sell
+     * @param tokenAmount Token amount (raw, with decimals)
+     */
+    async getSellQuote(tokenMint, tokenAmount) {
+        return curve.getSellQuote(this.sdk.connection, tokenMint, tokenAmount, this.sdk.programId);
+    }
+    /**
+     * Build buy instruction
+     *
+     * @remarks Fee recipients are read from on-chain and cannot be modified.
+     * The program enforces fees go to the correct recipients.
+     */
+    async buildBuyInstruction(params) {
+        return curve.buildBuyOnCurveInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+    /**
+     * Build sell instruction
+     */
+    async buildSellInstruction(params) {
+        return curve.buildSellOnCurveInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+    /**
+     * Build sell max instruction (sell entire balance)
+     */
+    async buildSellMaxInstruction(params) {
+        return curve.buildSellMaxOnCurveInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+}
+// ============= Pool Module =============
+/**
+ * AMM Pool Operations
+ * For trading tokens that have graduated to the AMM
+ */
+class PoolModule {
+    sdk;
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Get pool state
+     */
+    async getState(tokenMint) {
+        return accounts.getPoolState(this.sdk.connection, tokenMint, this.sdk.programId);
+    }
+    /**
+     * Get pool balances
+     */
+    async getBalances(tokenMint) {
+        return accounts.getPoolBalances(this.sdk.connection, tokenMint, this.sdk.programId);
+    }
+    /**
+     * Get swap quote for SOL -> Token
+     */
+    async getSwapSolToTokenQuote(tokenMint, solAmount) {
+        return pool.getSwapSolToTokenQuote(this.sdk.connection, tokenMint, solAmount, this.sdk.programId);
+    }
+    /**
+     * Get swap quote for Token -> SOL
+     */
+    async getSwapTokenToSolQuote(tokenMint, tokenAmount) {
+        return pool.getSwapTokenToSolQuote(this.sdk.connection, tokenMint, tokenAmount, this.sdk.programId);
+    }
+    /**
+     * Build swap SOL to token instruction
+     *
+     * @remarks Fee recipients are read from on-chain and cannot be modified.
+     */
+    async buildSwapSolToTokenInstruction(params) {
+        return pool.buildSwapSolToTokenInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+    /**
+     * Build swap token to SOL instruction
+     */
+    async buildSwapTokenToSolInstruction(params) {
+        return pool.buildSwapTokenToSolInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+    /**
+     * Build swap token to SOL max instruction (sell entire balance)
+     */
+    async buildSwapTokenToSolMaxInstruction(params) {
+        return pool.buildSwapTokenToSolMaxInstruction(this.sdk.connection, params, this.sdk.programId);
+    }
+}
+// ============= Utility Functions =============
+/**
+ * Convert SOL to lamports
+ */
+export function solToLamports(sol) {
+    return BigInt(Math.floor(sol * Number(LAMPORTS_PER_SOL)));
+}
+/**
+ * Convert lamports to SOL
+ */
+export function lamportsToSol(lamports) {
+    return Number(lamports) / Number(LAMPORTS_PER_SOL);
+}
+/**
+ * Convert token amount to raw (with decimals)
+ */
+export function toRawAmount(amount, decimals = 6) {
+    return BigInt(Math.floor(amount * 10 ** decimals));
+}
+/**
+ * Convert raw amount to UI (without decimals)
+ */
+export function toUiAmount(rawAmount, decimals = 6) {
+    return Number(rawAmount) / 10 ** decimals;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/pda.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PDA Derivation Helpers
+ * All Program Derived Addresses for CoinBarrel AMM
+ */
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Derive bonding curve PDA for a token mint
+ */
+export declare function getBondingCurvePda(mint: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive bonding authority PDA (signs transfers from curve)
+ */
+export declare function getBondingAuthorityPda(bondingCurve: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive SOL escrow PDA for bonding curve
+ */
+export declare function getSolEscrowPda(bondingCurve: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive pool PDA for a WSOL <-> Token pair
+ */
+export declare function getPoolPda(tokenMint: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive pool authority PDA (signs transfers from pool vaults)
+ */
+export declare function getPoolAuthorityPda(pool: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive vault PDA for a pool + mint
+ */
+export declare function getVaultPda(pool: PublicKey, mint: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive WSOL vault PDA for a pool
+ */
+export declare function getPoolWsolVaultPda(pool: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive token vault PDA for a pool
+ */
+export declare function getPoolTokenVaultPda(pool: PublicKey, tokenMint: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive LP mint PDA for a pool
+ */
+export declare function getLpMintPda(pool: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive LP vault PDA (holds burned/locked LP tokens)
+ */
+export declare function getLpVaultPda(pool: PublicKey, programId: PublicKey): PublicKey;
+/**
+ * Derive holder reward account PDA for a user + token
+ * Used for tracking holder rewards across buys/sells
+ */
+export declare function getHolderRewardPda(tokenMint: PublicKey, holder: PublicKey, programId: PublicKey): PublicKey;
+//# sourceMappingURL=pda.d.ts.map

package/dist/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAGnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAM/F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAMxF;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAMhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAGpF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAM7F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAEpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,GAClB,SAAS,CAEX;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAG7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAG9E;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,SAAS,GAClB,SAAS,CAMX"}

package/dist/pda.js

@@ -0,0 +1,86 @@
+/**
+ * PDA Derivation Helpers
+ * All Program Derived Addresses for CoinBarrel AMM
+ */
+import { PublicKey } from '@solana/web3.js';
+import { SEEDS, NATIVE_MINT } from './constants.js';
+// ============= Bonding Curve PDAs =============
+/**
+ * Derive bonding curve PDA for a token mint
+ */
+export function getBondingCurvePda(mint, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.BONDING, mint.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive bonding authority PDA (signs transfers from curve)
+ */
+export function getBondingAuthorityPda(bondingCurve, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.BONDING_AUTHORITY, bondingCurve.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive SOL escrow PDA for bonding curve
+ */
+export function getSolEscrowPda(bondingCurve, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.BONDING_SOL, bondingCurve.toBuffer()], programId);
+    return pda;
+}
+// ============= AMM Pool PDAs =============
+/**
+ * Derive pool PDA for a WSOL <-> Token pair
+ */
+export function getPoolPda(tokenMint, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.POOL, NATIVE_MINT.toBuffer(), tokenMint.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive pool authority PDA (signs transfers from pool vaults)
+ */
+export function getPoolAuthorityPda(pool, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.AUTHORITY, pool.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive vault PDA for a pool + mint
+ */
+export function getVaultPda(pool, mint, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.VAULT, pool.toBuffer(), mint.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive WSOL vault PDA for a pool
+ */
+export function getPoolWsolVaultPda(pool, programId) {
+    return getVaultPda(pool, NATIVE_MINT, programId);
+}
+/**
+ * Derive token vault PDA for a pool
+ */
+export function getPoolTokenVaultPda(pool, tokenMint, programId) {
+    return getVaultPda(pool, tokenMint, programId);
+}
+/**
+ * Derive LP mint PDA for a pool
+ */
+export function getLpMintPda(pool, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.LP_MINT, pool.toBuffer()], programId);
+    return pda;
+}
+/**
+ * Derive LP vault PDA (holds burned/locked LP tokens)
+ */
+export function getLpVaultPda(pool, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.LP_VAULT, pool.toBuffer()], programId);
+    return pda;
+}
+// ============= Holder Reward PDAs =============
+/**
+ * Derive holder reward account PDA for a user + token
+ * Used for tracking holder rewards across buys/sells
+ */
+export function getHolderRewardPda(tokenMint, holder, programId) {
+    const [pda] = PublicKey.findProgramAddressSync([SEEDS.HOLDER_REWARD, tokenMint.toBuffer(), holder.toBuffer()], programId);
+    return pda;
+}
+//# sourceMappingURL=pda.js.map

package/dist/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpD,iDAAiD;AAEjD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,SAAoB;IACvE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5F,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAuB,EAAE,SAAoB;IACnF,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAClD,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAuB,EAAE,SAAoB;IAC5E,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,KAAK,CAAC,WAAW,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAC5C,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,4CAA4C;AAE5C;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAoB,EAAE,SAAoB;IACpE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EAC1D,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,SAAoB;IACxE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9F,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,IAAe,EAAE,SAAoB;IACjF,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAC/C,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,SAAoB;IACxE,OAAO,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CACnC,IAAe,EACf,SAAoB,EACpB,SAAoB;IAEpB,OAAO,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,SAAoB;IACjE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5F,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,SAAoB;IAClE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7F,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,iDAAiD;AAEjD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CACjC,SAAoB,EACpB,MAAiB,EACjB,SAAoB;IAEpB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,EAC9D,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/pool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AMM Pool Operations
+ * Swap tokens on graduated AMM pools
+ */
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type { SwapSolToTokenParams, SwapTokenToSolParams, SwapTokenToSolMaxParams, SwapQuote } from "./types.js";
+/**
+ * Calculate swap quote for SOL -> Token
+ */
+export declare function getSwapSolToTokenQuote(connection: Connection, tokenMint: PublicKey, solIn: bigint, programId: PublicKey): Promise<SwapQuote | null>;
+/**
+ * Calculate swap quote for Token -> SOL
+ */
+export declare function getSwapTokenToSolQuote(connection: Connection, tokenMint: PublicKey, tokensIn: bigint, programId: PublicKey): Promise<SwapQuote | null>;
+/**
+ * Build swap_sol_to_token instruction
+ *
+ * IMPORTANT: Fee recipients are read from on-chain state and cannot be modified.
+ * The program enforces that fees go to the correct recipients.
+ */
+export declare function buildSwapSolToTokenInstruction(connection: Connection, params: SwapSolToTokenParams, programId: PublicKey): Promise<TransactionInstruction[]>;
+/**
+ * Build swap_token_to_sol instruction
+ *
+ * IMPORTANT: Fee recipients are read from on-chain state and cannot be modified.
+ */
+export declare function buildSwapTokenToSolInstruction(connection: Connection, params: SwapTokenToSolParams, programId: PublicKey): Promise<TransactionInstruction[]>;
+/**
+ * Build swap_token_to_sol_max instruction (sell entire balance)
+ */
+export declare function buildSwapTokenToSolMaxInstruction(connection: Connection, params: SwapTokenToSolMaxParams, programId: PublicKey): Promise<TransactionInstruction[]>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EAET,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,EACV,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA+B3B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAgC3B;AAID;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAsDnC;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA8DnC;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,uBAAuB,EAC/B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA0DnC"}