@coinbarrel/sdk 1.0.0

package/dist/curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curve.d.ts","sourceRoot":"","sources":["../src/curve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAiB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAe/F,OAAO,KAAK,EACX,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,wBAAsB,WAAW,CAChC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,GAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsC1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CACjC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,GAClB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAsC3B;AAID;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC/C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,SAAS,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmDnC;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,SAAS,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqCnC;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CACnD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,SAAS,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqCnC"}

package/dist/curve.js

@@ -0,0 +1,218 @@
+/**
+ * Bonding Curve Operations
+ * Buy and sell tokens on the bonding curve
+ */
+import { SystemProgram, TransactionInstruction } from '@solana/web3.js';
+import { TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, createAssociatedTokenAccountInstruction, getAccount, } from '@solana/spl-token';
+import { DISCRIMINATORS, LAMPORTS_PER_SOL, TOKEN_DECIMALS_MULTIPLIER } from './constants.js';
+import { getBondingCurvePda, getBondingAuthorityPda, getSolEscrowPda, getHolderRewardPda, } from './pda.js';
+import { getBondingCurveState } from './accounts.js';
+// ============= Buffer Helpers =============
+function writeU64LE(n) {
+    const b = Buffer.alloc(8);
+    b.writeBigUInt64LE(n);
+    return b;
+}
+// ============= Quote Calculations =============
+/**
+ * Calculate buy quote for bonding curve
+ * Uses constant product formula: (vSol + solIn) * (vToken - tokensOut) = k
+ */
+export async function getBuyQuote(connection, tokenMint, solIn, programId) {
+    const state = await getBondingCurveState(connection, tokenMint, programId);
+    if (!state || state.paused)
+        return null;
+    const feeBps = BigInt(state.feeBps);
+    const totalFee = (solIn * feeBps) / 10000n;
+    // Fee breakdown: 40% admin, 30% creator, 30% holder rewards (default split)
+    const adminFee = (totalFee * 40n) / 100n;
+    const creatorFee = (totalFee * 30n) / 100n;
+    const holderRewards = totalFee - adminFee - creatorFee;
+    const solAfterFee = solIn - totalFee;
+    // Constant product: k = vSol * vToken
+    const k = state.vSol * state.vToken;
+    const newVSol = state.vSol + solAfterFee;
+    const newVToken = k / newVSol;
+    const tokensOut = state.vToken - newVToken;
+    // Price impact
+    const priceBeforeLamports = state.vToken > 0n ? (state.vSol * LAMPORTS_PER_SOL) / state.vToken : 0n;
+    const priceAfterLamports = newVToken > 0n ? (newVSol * LAMPORTS_PER_SOL) / newVToken : 0n;
+    const priceImpactBps = priceBeforeLamports > 0n
+        ? Number(((priceAfterLamports - priceBeforeLamports) * 10000n) / priceBeforeLamports)
+        : 0;
+    return {
+        solIn,
+        tokensOut,
+        adminFee,
+        creatorFee,
+        holderRewards,
+        pricePerToken: tokensOut > 0n ? (solIn * TOKEN_DECIMALS_MULTIPLIER) / tokensOut : 0n,
+        priceImpactBps,
+    };
+}
+/**
+ * Calculate sell quote for bonding curve
+ */
+export async function getSellQuote(connection, tokenMint, tokensIn, programId) {
+    const state = await getBondingCurveState(connection, tokenMint, programId);
+    if (!state || state.paused)
+        return null;
+    // Constant product: k = vSol * vToken
+    const k = state.vSol * state.vToken;
+    const newVToken = state.vToken + tokensIn;
+    const newVSol = k / newVToken;
+    const solOutBeforeFee = state.vSol - newVSol;
+    const feeBps = BigInt(state.feeBps);
+    const totalFee = (solOutBeforeFee * feeBps) / 10000n;
+    // Fee breakdown
+    const adminFee = (totalFee * 40n) / 100n;
+    const creatorFee = (totalFee * 30n) / 100n;
+    const holderRewards = totalFee - adminFee - creatorFee;
+    const solOut = solOutBeforeFee - totalFee;
+    // Price impact
+    const priceBeforeLamports = state.vToken > 0n ? (state.vSol * LAMPORTS_PER_SOL) / state.vToken : 0n;
+    const priceAfterLamports = newVToken > 0n ? (newVSol * LAMPORTS_PER_SOL) / newVToken : 0n;
+    const priceImpactBps = priceBeforeLamports > 0n
+        ? Number(((priceBeforeLamports - priceAfterLamports) * 10000n) / priceBeforeLamports)
+        : 0;
+    return {
+        tokensIn,
+        solOut,
+        adminFee,
+        creatorFee,
+        holderRewards,
+        pricePerToken: tokensIn > 0n ? (solOut * TOKEN_DECIMALS_MULTIPLIER) / tokensIn : 0n,
+        priceImpactBps,
+    };
+}
+// ============= Instruction Builders =============
+/**
+ * Build buy_on_curve 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 async function buildBuyOnCurveInstruction(connection, params, programId) {
+    const { tokenMint, buyer, lamportsIn } = params;
+    // Fetch curve state to get fee recipients (enforced on-chain)
+    const state = await getBondingCurveState(connection, tokenMint, programId);
+    if (!state) {
+        throw new Error('Bonding curve not found for this token');
+    }
+    if (state.paused) {
+        throw new Error('Bonding curve is paused');
+    }
+    const bondingCurve = getBondingCurvePda(tokenMint, programId);
+    const bondingAuthority = getBondingAuthorityPda(bondingCurve, programId);
+    const solEscrow = getSolEscrowPda(bondingCurve, programId);
+    const buyerAta = getAssociatedTokenAddressSync(tokenMint, buyer);
+    const holderRewardAccount = getHolderRewardPda(tokenMint, buyer, programId);
+    const instructions = [];
+    // Check if buyer's ATA exists, create if needed
+    try {
+        await getAccount(connection, buyerAta);
+    }
+    catch {
+        instructions.push(createAssociatedTokenAccountInstruction(buyer, buyerAta, buyer, tokenMint));
+    }
+    // Build buy instruction with fee recipients from on-chain state
+    const buyIx = new TransactionInstruction({
+        programId,
+        keys: [
+            { pubkey: bondingCurve, isWritable: true, isSigner: false },
+            { pubkey: state.tokenVault, isWritable: true, isSigner: false },
+            { pubkey: tokenMint, isWritable: false, isSigner: false },
+            { pubkey: solEscrow, isWritable: true, isSigner: false },
+            { pubkey: bondingAuthority, isWritable: false, isSigner: false },
+            { pubkey: buyerAta, isWritable: true, isSigner: false },
+            { pubkey: buyer, isWritable: true, isSigner: true },
+            // Fee recipients - read from on-chain state, cannot be modified
+            { pubkey: state.adminFeeRecipient, isWritable: true, isSigner: false },
+            { pubkey: state.creatorFeeRecipient, isWritable: true, isSigner: false },
+            // Holder reward account - auto-initialized by program
+            { pubkey: holderRewardAccount, isWritable: true, isSigner: false },
+            { pubkey: TOKEN_PROGRAM_ID, isWritable: false, isSigner: false },
+            { pubkey: SystemProgram.programId, isWritable: false, isSigner: false },
+        ],
+        data: Buffer.concat([DISCRIMINATORS.buy_on_curve, writeU64LE(lamportsIn)]),
+    });
+    instructions.push(buyIx);
+    return instructions;
+}
+/**
+ * Build sell_on_curve instruction
+ *
+ * IMPORTANT: Fee recipients are read from on-chain state and cannot be modified.
+ */
+export async function buildSellOnCurveInstruction(connection, params, programId) {
+    const { tokenMint, seller, tokenAmount } = params;
+    // Fetch curve state to get fee recipients (enforced on-chain)
+    const state = await getBondingCurveState(connection, tokenMint, programId);
+    if (!state) {
+        throw new Error('Bonding curve not found for this token');
+    }
+    if (state.paused) {
+        throw new Error('Bonding curve is paused');
+    }
+    const bondingCurve = getBondingCurvePda(tokenMint, programId);
+    const bondingAuthority = getBondingAuthorityPda(bondingCurve, programId);
+    const solEscrow = getSolEscrowPda(bondingCurve, programId);
+    const sellerAta = getAssociatedTokenAddressSync(tokenMint, seller);
+    const sellIx = new TransactionInstruction({
+        programId,
+        keys: [
+            { pubkey: bondingCurve, isWritable: true, isSigner: false },
+            { pubkey: state.tokenVault, isWritable: true, isSigner: false },
+            { pubkey: tokenMint, isWritable: false, isSigner: false },
+            { pubkey: solEscrow, isWritable: true, isSigner: false },
+            { pubkey: bondingAuthority, isWritable: false, isSigner: false },
+            { pubkey: sellerAta, isWritable: true, isSigner: false },
+            { pubkey: seller, isWritable: true, isSigner: true },
+            // Fee recipients - read from on-chain state, cannot be modified
+            { pubkey: state.adminFeeRecipient, isWritable: true, isSigner: false },
+            { pubkey: state.creatorFeeRecipient, isWritable: true, isSigner: false },
+            { pubkey: TOKEN_PROGRAM_ID, isWritable: false, isSigner: false },
+            { pubkey: SystemProgram.programId, isWritable: false, isSigner: false },
+        ],
+        data: Buffer.concat([DISCRIMINATORS.sell_on_curve, writeU64LE(tokenAmount)]),
+    });
+    return [sellIx];
+}
+/**
+ * Build sell_max_on_curve instruction (sell entire balance)
+ */
+export async function buildSellMaxOnCurveInstruction(connection, params, programId) {
+    const { tokenMint, seller } = params;
+    // Fetch curve state to get fee recipients (enforced on-chain)
+    const state = await getBondingCurveState(connection, tokenMint, programId);
+    if (!state) {
+        throw new Error('Bonding curve not found for this token');
+    }
+    if (state.paused) {
+        throw new Error('Bonding curve is paused');
+    }
+    const bondingCurve = getBondingCurvePda(tokenMint, programId);
+    const bondingAuthority = getBondingAuthorityPda(bondingCurve, programId);
+    const solEscrow = getSolEscrowPda(bondingCurve, programId);
+    const sellerAta = getAssociatedTokenAddressSync(tokenMint, seller);
+    const sellMaxIx = new TransactionInstruction({
+        programId,
+        keys: [
+            { pubkey: bondingCurve, isWritable: true, isSigner: false },
+            { pubkey: state.tokenVault, isWritable: true, isSigner: false },
+            { pubkey: tokenMint, isWritable: false, isSigner: false },
+            { pubkey: solEscrow, isWritable: true, isSigner: false },
+            { pubkey: bondingAuthority, isWritable: false, isSigner: false },
+            { pubkey: sellerAta, isWritable: true, isSigner: false },
+            { pubkey: seller, isWritable: true, isSigner: true },
+            // Fee recipients - read from on-chain state, cannot be modified
+            { pubkey: state.adminFeeRecipient, isWritable: true, isSigner: false },
+            { pubkey: state.creatorFeeRecipient, isWritable: true, isSigner: false },
+            { pubkey: TOKEN_PROGRAM_ID, isWritable: false, isSigner: false },
+            { pubkey: SystemProgram.programId, isWritable: false, isSigner: false },
+        ],
+        data: DISCRIMINATORS.sell_max_on_curve,
+    });
+    return [sellMaxIx];
+}
+//# sourceMappingURL=curve.js.map

package/dist/curve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curve.js","sourceRoot":"","sources":["../src/curve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAyB,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EACN,gBAAgB,EAChB,6BAA6B,EAC7B,uCAAuC,EACvC,UAAU,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AASrD,6CAA6C;AAE7C,SAAS,UAAU,CAAC,CAAS;IAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC;AACV,CAAC;AAED,iDAAiD;AAEjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,UAAsB,EACtB,SAAoB,EACpB,KAAa,EACb,SAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;IAE3C,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,UAAU,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvD,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;IAErC,sCAAsC;IACtC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;IACzC,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAE3C,eAAe;IACf,MAAM,mBAAmB,GACxB,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,kBAAkB,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,gBAAgB,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,cAAc,GACnB,mBAAmB,GAAG,EAAE;QACvB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,GAAG,MAAM,CAAC,GAAG,mBAAmB,CAAC;QACrF,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO;QACN,KAAK;QACL,SAAS;QACT,QAAQ;QACR,UAAU;QACV,aAAa;QACb,aAAa,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,yBAAyB,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE;QACpF,cAAc;KACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,UAAsB,EACtB,SAAoB,EACpB,QAAgB,EAChB,SAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAExC,sCAAsC;IACtC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC1C,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;IAErD,gBAAgB;IAChB,MAAM,QAAQ,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,UAAU,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvD,MAAM,MAAM,GAAG,eAAe,GAAG,QAAQ,CAAC;IAE1C,eAAe;IACf,MAAM,mBAAmB,GACxB,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,kBAAkB,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,gBAAgB,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,cAAc,GACnB,mBAAmB,GAAG,EAAE;QACvB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,GAAG,MAAM,CAAC,GAAG,mBAAmB,CAAC;QACrF,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO;QACN,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,UAAU;QACV,aAAa;QACb,aAAa,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,yBAAyB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE;QACnF,cAAc;KACd,CAAC;AACH,CAAC;AAED,mDAAmD;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC/C,UAAsB,EACtB,MAAwB,EACxB,SAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAEhD,8DAA8D;IAC9D,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,6BAA6B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAE5E,MAAM,YAAY,GAA6B,EAAE,CAAC;IAElD,gDAAgD;IAChD,IAAI,CAAC;QACJ,MAAM,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACR,YAAY,CAAC,IAAI,CAAC,uCAAuC,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,gEAAgE;IAChE,MAAM,KAAK,GAAG,IAAI,sBAAsB,CAAC;QACxC,SAAS;QACT,IAAI,EAAE;YACL,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC3D,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC/D,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACzD,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxD,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACvD,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACnD,gEAAgE;YAChE,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACtE,EAAE,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxE,sDAAsD;YACtD,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAClE,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;SACvE;QACD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1E,CAAC,CAAC;IAEH,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,YAAY,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAChD,UAAsB,EACtB,MAAyB,EACzB,SAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAElD,8DAA8D;IAC9D,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,6BAA6B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC;QACzC,SAAS;QACT,IAAI,EAAE;YACL,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC3D,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC/D,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACzD,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxD,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxD,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACpD,gEAAgE;YAChE,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACtE,EAAE,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;SACvE;QACD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;KAC5E,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CACnD,UAAsB,EACtB,MAA4B,EAC5B,SAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAErC,8DAA8D;IAC9D,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,6BAA6B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEnE,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC;QAC5C,SAAS;QACT,IAAI,EAAE;YACL,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC3D,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC/D,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACzD,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxD,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxD,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACpD,gEAAgE;YAChE,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACtE,EAAE,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAChE,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;SACvE;QACD,IAAI,EAAE,cAAc,CAAC,iBAAiB;KACtC,CAAC,CAAC;IAEH,OAAO,CAAC,SAAS,CAAC,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 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 { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { type Network } from "./constants.js";
+import type { CoinBarrelConfig, BondingCurveState, PoolState, MarketInfo, BuyOnCurveParams, SellOnCurveParams, SellMaxOnCurveParams, SwapSolToTokenParams, SwapTokenToSolParams, SwapTokenToSolMaxParams, BuyQuote, SellQuote, SwapQuote } from "./types.js";
+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";
+/**
+ * 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 declare class CoinBarrel {
+    /** Solana RPC connection */
+    readonly connection: Connection;
+    /** Network (devnet or mainnet) */
+    readonly network: Network;
+    /** Program ID for the current network */
+    readonly programId: PublicKey;
+    /** Admin fee recipient for the current network */
+    readonly adminFeeRecipient: PublicKey;
+    /** Bonding curve operations */
+    readonly curve: CurveModule;
+    /** AMM pool operations */
+    readonly pool: PoolModule;
+    constructor(config: CoinBarrelConfig);
+    /**
+     * Get comprehensive market info for a token
+     * Automatically detects if on bonding curve or AMM pool
+     */
+    getMarketInfo(tokenMint: PublicKey): Promise<MarketInfo | null>;
+    /**
+     * Get user's token balance
+     */
+    getUserBalance(tokenMint: PublicKey, user: PublicKey): Promise<bigint>;
+    /**
+     * Check if a token is on bonding curve (not yet graduated)
+     */
+    isOnCurve(tokenMint: PublicKey): Promise<boolean>;
+    /**
+     * Check if a token has graduated to AMM pool
+     */
+    isOnPool(tokenMint: PublicKey): Promise<boolean>;
+    /** Get bonding curve PDA for a token */
+    getBondingCurvePda(tokenMint: PublicKey): PublicKey;
+    /** Get pool PDA for a token */
+    getPoolPda(tokenMint: PublicKey): PublicKey;
+    /** Get holder reward PDA for a user + token */
+    getHolderRewardPda(tokenMint: PublicKey, holder: PublicKey): PublicKey;
+}
+/**
+ * Bonding Curve Operations
+ * For trading tokens that haven't graduated yet
+ */
+declare class CurveModule {
+    private sdk;
+    constructor(sdk: CoinBarrel);
+    /**
+     * Get bonding curve state
+     */
+    getState(tokenMint: PublicKey): Promise<BondingCurveState | null>;
+    /**
+     * Get buy quote - how many tokens for X SOL
+     * @param tokenMint Token to buy
+     * @param solAmount SOL amount in lamports
+     */
+    getBuyQuote(tokenMint: PublicKey, solAmount: bigint): Promise<BuyQuote | null>;
+    /**
+     * Get sell quote - how much SOL for X tokens
+     * @param tokenMint Token to sell
+     * @param tokenAmount Token amount (raw, with decimals)
+     */
+    getSellQuote(tokenMint: PublicKey, tokenAmount: bigint): Promise<SellQuote | null>;
+    /**
+     * Build buy instruction
+     *
+     * @remarks Fee recipients are read from on-chain and cannot be modified.
+     * The program enforces fees go to the correct recipients.
+     */
+    buildBuyInstruction(params: BuyOnCurveParams): Promise<TransactionInstruction[]>;
+    /**
+     * Build sell instruction
+     */
+    buildSellInstruction(params: SellOnCurveParams): Promise<TransactionInstruction[]>;
+    /**
+     * Build sell max instruction (sell entire balance)
+     */
+    buildSellMaxInstruction(params: SellMaxOnCurveParams): Promise<TransactionInstruction[]>;
+}
+/**
+ * AMM Pool Operations
+ * For trading tokens that have graduated to the AMM
+ */
+declare class PoolModule {
+    private sdk;
+    constructor(sdk: CoinBarrel);
+    /**
+     * Get pool state
+     */
+    getState(tokenMint: PublicKey): Promise<PoolState | null>;
+    /**
+     * Get pool balances
+     */
+    getBalances(tokenMint: PublicKey): Promise<{
+        solBalance: bigint;
+        tokenBalance: bigint;
+    } | null>;
+    /**
+     * Get swap quote for SOL -> Token
+     */
+    getSwapSolToTokenQuote(tokenMint: PublicKey, solAmount: bigint): Promise<SwapQuote | null>;
+    /**
+     * Get swap quote for Token -> SOL
+     */
+    getSwapTokenToSolQuote(tokenMint: PublicKey, tokenAmount: bigint): Promise<SwapQuote | null>;
+    /**
+     * Build swap SOL to token instruction
+     *
+     * @remarks Fee recipients are read from on-chain and cannot be modified.
+     */
+    buildSwapSolToTokenInstruction(params: SwapSolToTokenParams): Promise<TransactionInstruction[]>;
+    /**
+     * Build swap token to SOL instruction
+     */
+    buildSwapTokenToSolInstruction(params: SwapTokenToSolParams): Promise<TransactionInstruction[]>;
+    /**
+     * Build swap token to SOL max instruction (sell entire balance)
+     */
+    buildSwapTokenToSolMaxInstruction(params: SwapTokenToSolMaxParams): Promise<TransactionInstruction[]>;
+}
+/**
+ * Convert SOL to lamports
+ */
+export declare function solToLamports(sol: number): bigint;
+/**
+ * Convert lamports to SOL
+ */
+export declare function lamportsToSol(lamports: bigint): number;
+/**
+ * Convert token amount to raw (with decimals)
+ */
+export declare function toRawAmount(amount: number, decimals?: number): bigint;
+/**
+ * Convert raw amount to UI (without decimals)
+ */
+export declare function toUiAmount(rawAmount: bigint, decimals?: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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