pump-trader 1.1.3 → 1.1.5

package/dist/index.d.ts

@@ -33,6 +33,7 @@ interface BondingCurveState {
     realSolReserves: bigint;
     tokenTotalSupply: bigint;
     complete: boolean;
+    quoteMint?: PublicKey;
     isMayhemMode?: boolean;
     isCashbackCoin?: boolean;
 }
@@ -104,6 +105,9 @@ export declare class PumpTrader {
     loadGlobal(): Promise<GlobalState>;
     getBondingPda(mint: PublicKey): PublicKey;
     deriveBondingCurveV2(mint: PublicKey): PublicKey;
+    private pickFeeRecipient;
+    private buildBondingBuyKeys;
+    private buildBondingSellKeys;
     loadBonding(mint: PublicKey): Promise<BondingInfo>;
     calcBuy(solIn: bigint, state: BondingCurveState): bigint;
     calcSell(tokenIn: bigint, state: BondingCurveState): bigint;
@@ -113,7 +117,9 @@ export declare class PumpTrader {
         price: number;
         completed: boolean;
     }>;
-    getAmmPrice(mint: PublicKey): Promise<number>;
+    getAmmPrice(mint: PublicKey, quoteMint?: PublicKey): Promise<number>;
+    private getEffectiveQuoteMint;
+    private getMintDecimals;
     /**
      * 查询代币余额
      * @param tokenAddr - 代币地址（可选），如果不传则返回所有代币

package/dist/index.js

@@ -36,6 +36,16 @@ const DISCRIMINATORS = {
 };
 const AMM_FEE_BPS = 100n;
 const BPS_DENOMINATOR = 10000n;
+const PUMP_NEW_FEE_RECIPIENTS = [
+    "5YxQFdt3Tr9zJLvkFccqXVUwhdTWJQc1fFg2YPbxvxeD",
+    "9M4giFFMxmFGXtc3feFzRai56WbBqehoSeRE5GK7gf7",
+    "GXPFM2caqTtQYC2cJ5yJRi9VDkpsYZXzYdwYpGnLmtDL",
+    "3BpXnfJaUTiwXnJNe7Ej1rcbzqTTQUvLShZaWazebsVR",
+    "5cjcW9wExnJJiqgLjq7DEG75Pm6JBgE1hNv4B2vHXUW6",
+    "EHAAiTxcdDwQ3U4bU6YcMsQGaekdzLS3B5SmYo46kJtL",
+    "5eHhjP8JaYkz83CWwvGU2uMUXefd3AazWGx4gpcuEEYD",
+    "A7hAgCzFw14fejgCp387JUJRMNyz4j89JKnhtKU8piqW"
+].map((value) => new web3_js_1.PublicKey(value));
 /* ================= 工具函数 ================= */
 const u64 = (v) => {
     const bn = typeof v === 'bigint' ? new bn_js_1.default(v.toString()) : new bn_js_1.default(v.toString());
@@ -227,6 +237,56 @@ class PumpTrader {
     deriveBondingCurveV2(mint) {
         return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("bonding-curve-v2"), mint.toBuffer()], PROGRAM_IDS.PUMP)[0];
     }
+    pickFeeRecipient(index = 0) {
+        return PUMP_NEW_FEE_RECIPIENTS[index % PUMP_NEW_FEE_RECIPIENTS.length];
+    }
+    buildBondingBuyKeys(args) {
+        const tokenProgramId = args.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM_ID;
+        return [
+            { pubkey: args.global, isSigner: false, isWritable: false },
+            { pubkey: args.globalFeeRecipient, isSigner: false, isWritable: true },
+            { pubkey: args.mint, isSigner: false, isWritable: false },
+            { pubkey: args.bonding, isSigner: false, isWritable: true },
+            { pubkey: args.associatedBondingCurve, isSigner: false, isWritable: true },
+            { pubkey: args.userAta, isSigner: false, isWritable: true },
+            { pubkey: args.wallet, isSigner: true, isWritable: true },
+            { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
+            { pubkey: tokenProgramId, isSigner: false, isWritable: false },
+            { pubkey: args.creatorVault, isSigner: false, isWritable: true },
+            { pubkey: args.eventAuthority, isSigner: false, isWritable: false },
+            { pubkey: args.pumpProgram, isSigner: false, isWritable: false },
+            { pubkey: args.globalVolumeAccumulator, isSigner: false, isWritable: false },
+            { pubkey: args.userVolumeAccumulator, isSigner: false, isWritable: true },
+            { pubkey: args.feeConfig, isSigner: false, isWritable: false },
+            { pubkey: args.feeProgram, isSigner: false, isWritable: false },
+            { pubkey: args.bondingCurveV2, isSigner: false, isWritable: false },
+            { pubkey: args.feeRecipient, isSigner: false, isWritable: true }
+        ];
+    }
+    buildBondingSellKeys(args) {
+        const tokenProgramId = args.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM_ID;
+        const keys = [
+            { pubkey: args.global, isSigner: false, isWritable: false },
+            { pubkey: args.globalFeeRecipient, isSigner: false, isWritable: true },
+            { pubkey: args.mint, isSigner: false, isWritable: false },
+            { pubkey: args.bonding, isSigner: false, isWritable: true },
+            { pubkey: args.associatedBondingCurve, isSigner: false, isWritable: true },
+            { pubkey: args.userAta, isSigner: false, isWritable: true },
+            { pubkey: args.wallet, isSigner: true, isWritable: true },
+            { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
+            { pubkey: args.creatorVault, isSigner: false, isWritable: true },
+            { pubkey: tokenProgramId, isSigner: false, isWritable: false },
+            { pubkey: args.eventAuthority, isSigner: false, isWritable: false },
+            { pubkey: args.pumpProgram, isSigner: false, isWritable: false },
+            { pubkey: args.feeConfig, isSigner: false, isWritable: false },
+            { pubkey: args.feeProgram, isSigner: false, isWritable: false }
+        ];
+        if (args.isCashbackCoin) {
+            keys.push({ pubkey: args.userVolumeAccumulator, isSigner: false, isWritable: true });
+        }
+        keys.push({ pubkey: args.bondingCurveV2, isSigner: false, isWritable: false }, { pubkey: args.feeRecipient, isSigner: false, isWritable: true });
+        return keys;
+    }
     async loadBonding(mint) {
         const bonding = this.getBondingPda(mint);
         const acc = await this.connection.getAccountInfo(bonding);
@@ -244,6 +304,10 @@ class PumpTrader {
         offset += 1;
         const creator = new web3_js_1.PublicKey(data.slice(offset, offset + 32));
         offset += 32;
+        if (offset + 32 <= data.length - 2) {
+            state.quoteMint = new web3_js_1.PublicKey(data.slice(offset, offset + 32));
+            offset += 32;
+        }
         state.isMayhemMode = offset < data.length ? data[offset] === 1 : false;
         offset += 1;
         state.isCashbackCoin = offset < data.length ? data[offset] === 1 : false;
@@ -276,19 +340,21 @@ class PumpTrader {
     async getPriceAndStatus(tokenAddr) {
         const mint = new web3_js_1.PublicKey(tokenAddr);
         const { state } = await this.loadBonding(mint);
+        const quoteMint = this.getEffectiveQuoteMint(state.quoteMint);
         if (state.complete) {
-            const price = await this.getAmmPrice(mint);
+            const price = await this.getAmmPrice(mint, quoteMint);
             return { price, completed: true };
         }
         const oneToken = BigInt(1_000_000);
-        const solOut = this.calcSell(oneToken, state);
-        const price = Number(solOut) / 1e9;
+        const quoteOut = this.calcSell(oneToken, state);
+        const quoteDecimals = await this.getMintDecimals(quoteMint);
+        const price = Number(quoteOut) / 10 ** quoteDecimals;
         return { price, completed: false };
     }
-    async getAmmPrice(mint) {
+    async getAmmPrice(mint, quoteMint = SOL_MINT) {
         const [poolCreator] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("pool-authority"), mint.toBuffer()], PROGRAM_IDS.PUMP);
         const indexBuffer = new bn_js_1.default(0).toArrayLike(Buffer, "le", 2);
-        const [pool] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("pool"), indexBuffer, poolCreator.toBuffer(), mint.toBuffer(), SOL_MINT.toBuffer()], PROGRAM_IDS.PUMP_AMM);
+        const [pool] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("pool"), indexBuffer, poolCreator.toBuffer(), mint.toBuffer(), quoteMint.toBuffer()], PROGRAM_IDS.PUMP_AMM);
         const acc = await this.connection.getAccountInfo(pool);
         if (!acc)
             throw new Error("Pool not found");
@@ -299,6 +365,23 @@ class PumpTrader {
         ]);
         return quoteInfo.value.uiAmount / baseInfo.value.uiAmount;
     }
+    getEffectiveQuoteMint(quoteMint) {
+        if (!quoteMint || quoteMint.equals(web3_js_1.PublicKey.default)) {
+            return SOL_MINT;
+        }
+        return quoteMint;
+    }
+    async getMintDecimals(mint) {
+        if (mint.equals(SOL_MINT)) {
+            return 9;
+        }
+        const mintInfo = await this.connection.getParsedAccountInfo(mint);
+        const parsedData = mintInfo.value?.data;
+        if (parsedData && "parsed" in parsedData) {
+            return parsedData.parsed.info.decimals;
+        }
+        throw new Error(`Unable to determine mint decimals for ${mint.toBase58()}`);
+    }
     /* ---------- 余额查询 ---------- */
     /**
      * 查询代币余额
@@ -488,6 +571,7 @@ class PumpTrader {
         const [globalVolumeAccumulator] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("global_volume_accumulator")], PROGRAM_IDS.PUMP);
         const [userVolumeAccumulator] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("user_volume_accumulator"), this.wallet.publicKey.toBuffer()], PROGRAM_IDS.PUMP);
         const [feeConfig] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fee_config"), SEEDS.FEE_CONFIG], PROGRAM_IDS.FEE);
+        const feeRecipient = this.pickFeeRecipient();
         for (let i = 0; i < solChunks.length; i++) {
             try {
                 const solIn = solChunks[i];
@@ -503,25 +587,25 @@ class PumpTrader {
                 const userAta = await this.ensureAta(tx, mint, tokenProgram.programId);
                 tx.add(new web3_js_1.TransactionInstruction({
                     programId: PROGRAM_IDS.PUMP,
-                    keys: [
-                        { pubkey: this.global, isSigner: false, isWritable: false },
-                        { pubkey: this.globalState.feeRecipient, isSigner: false, isWritable: true },
-                        { pubkey: mint, isSigner: false, isWritable: false },
-                        { pubkey: bonding, isSigner: false, isWritable: true },
-                        { pubkey: associatedBondingCurve, isSigner: false, isWritable: true },
-                        { pubkey: userAta, isSigner: false, isWritable: true },
-                        { pubkey: this.wallet.publicKey, isSigner: true, isWritable: true },
-                        { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
-                        { pubkey: tokenProgram.programId, isSigner: false, isWritable: false },
-                        { pubkey: creatorVault, isSigner: false, isWritable: true },
-                        { pubkey: PROGRAM_IDS.EVENT_AUTHORITY, isSigner: false, isWritable: false },
-                        { pubkey: PROGRAM_IDS.PUMP, isSigner: false, isWritable: false },
-                        { pubkey: globalVolumeAccumulator, isSigner: false, isWritable: false },
-                        { pubkey: userVolumeAccumulator, isSigner: false, isWritable: true },
-                        { pubkey: feeConfig, isSigner: false, isWritable: false },
-                        { pubkey: PROGRAM_IDS.FEE, isSigner: false, isWritable: false },
-                        { pubkey: bondingCurveV2, isSigner: false, isWritable: false }
-                    ],
+                    keys: this.buildBondingBuyKeys({
+                        global: this.global,
+                        globalFeeRecipient: this.globalState.feeRecipient,
+                        mint,
+                        bonding,
+                        associatedBondingCurve,
+                        userAta,
+                        wallet: this.wallet.publicKey,
+                        creatorVault,
+                        eventAuthority: PROGRAM_IDS.EVENT_AUTHORITY,
+                        pumpProgram: PROGRAM_IDS.PUMP,
+                        globalVolumeAccumulator,
+                        userVolumeAccumulator,
+                        feeConfig,
+                        feeProgram: PROGRAM_IDS.FEE,
+                        bondingCurveV2,
+                        feeRecipient,
+                        tokenProgramId: tokenProgram.programId
+                    }),
                     data: Buffer.concat([DISCRIMINATORS.BUY, u64(tokenOut), u64(maxSol)])
                 }));
                 const { blockhash, lastValidBlockHeight } = await this.connection.getLatestBlockhash('finalized');
@@ -567,11 +651,7 @@ class PumpTrader {
         const [creatorVault] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("creator-vault"), creator.toBuffer()], PROGRAM_IDS.PUMP);
         const [feeConfig] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fee_config"), SEEDS.FEE_CONFIG], PROGRAM_IDS.FEE);
         const [userVolumeAccumulator] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("user_volume_accumulator"), this.wallet.publicKey.toBuffer()], PROGRAM_IDS.PUMP);
-        const sellRemainingKeys = [];
-        if (state.isCashbackCoin) {
-            sellRemainingKeys.push({ pubkey: userVolumeAccumulator, isSigner: false, isWritable: true });
-        }
-        sellRemainingKeys.push({ pubkey: bondingCurveV2, isSigner: false, isWritable: false });
+        const feeRecipient = this.pickFeeRecipient();
         for (let i = 0; i < tokenChunks.length; i++) {
             try {
                 const tokenIn = tokenChunks[i];
@@ -586,23 +666,25 @@ class PumpTrader {
                 const tx = new web3_js_1.Transaction().add(web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 200_000 }), web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: priority }));
                 tx.add(new web3_js_1.TransactionInstruction({
                     programId: PROGRAM_IDS.PUMP,
-                    keys: [
-                        { pubkey: this.global, isSigner: false, isWritable: false },
-                        { pubkey: this.globalState.feeRecipient, isSigner: false, isWritable: true },
-                        { pubkey: mint, isSigner: false, isWritable: false },
-                        { pubkey: bonding, isSigner: false, isWritable: true },
-                        { pubkey: associatedBondingCurve, isSigner: false, isWritable: true },
-                        { pubkey: userAta, isSigner: false, isWritable: true },
-                        { pubkey: this.wallet.publicKey, isSigner: true, isWritable: true },
-                        { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
-                        { pubkey: creatorVault, isSigner: false, isWritable: true },
-                        { pubkey: tokenProgram.programId, isSigner: false, isWritable: false },
-                        { pubkey: PROGRAM_IDS.EVENT_AUTHORITY, isSigner: false, isWritable: false },
-                        { pubkey: PROGRAM_IDS.PUMP, isSigner: false, isWritable: false },
-                        { pubkey: feeConfig, isSigner: false, isWritable: false },
-                        { pubkey: PROGRAM_IDS.FEE, isSigner: false, isWritable: false },
-                        ...sellRemainingKeys
-                    ],
+                    keys: this.buildBondingSellKeys({
+                        global: this.global,
+                        globalFeeRecipient: this.globalState.feeRecipient,
+                        mint,
+                        bonding,
+                        associatedBondingCurve,
+                        userAta,
+                        wallet: this.wallet.publicKey,
+                        creatorVault,
+                        eventAuthority: PROGRAM_IDS.EVENT_AUTHORITY,
+                        pumpProgram: PROGRAM_IDS.PUMP,
+                        feeConfig,
+                        feeProgram: PROGRAM_IDS.FEE,
+                        bondingCurveV2,
+                        feeRecipient,
+                        isCashbackCoin: !!state.isCashbackCoin,
+                        userVolumeAccumulator,
+                        tokenProgramId: tokenProgram.programId
+                    }),
                     data: Buffer.concat([
                         DISCRIMINATORS.SELL,
                         u64(tokenIn),
@@ -791,12 +873,15 @@ class PumpTrader {
         const [feeConfig] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fee_config"), SEEDS.AMM_FEE_CONFIG], PROGRAM_IDS.FEE);
         const protocolFeeRecipient = globalConfig.protocolFeeRecipients[0];
         const protocolFeeRecipientTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(SOL_MINT, protocolFeeRecipient, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const newFeeRecipient = this.pickFeeRecipient();
+        const newFeeRecipientTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(poolKeys.quoteMint, newFeeRecipient, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         const remainingKeys = [];
         if (poolKeys.isCashbackCoin) {
             const userVolumeAccumulatorWsolAta = (0, spl_token_1.getAssociatedTokenAddressSync)(SOL_MINT, userVolumeAccumulator, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
             remainingKeys.push({ pubkey: userVolumeAccumulatorWsolAta, isSigner: false, isWritable: true });
         }
         remainingKeys.push({ pubkey: poolV2, isSigner: false, isWritable: false });
+        remainingKeys.push({ pubkey: newFeeRecipient, isSigner: false, isWritable: false }, { pubkey: newFeeRecipientTokenAccount, isSigner: false, isWritable: true });
         return new web3_js_1.TransactionInstruction({
             programId: PROGRAM_IDS.PUMP_AMM,
             keys: [
@@ -842,6 +927,8 @@ class PumpTrader {
         const [feeConfig] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fee_config"), SEEDS.AMM_FEE_CONFIG], PROGRAM_IDS.FEE);
         const protocolFeeRecipient = globalConfig.protocolFeeRecipients[0];
         const protocolFeeRecipientTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(SOL_MINT, protocolFeeRecipient, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const newFeeRecipient = this.pickFeeRecipient();
+        const newFeeRecipientTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(poolKeys.quoteMint, newFeeRecipient, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         const [userVolumeAccumulator] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("user_volume_accumulator"), this.wallet.publicKey.toBuffer()], PROGRAM_IDS.PUMP_AMM);
         const userVolumeAccumulatorWsolAta = (0, spl_token_1.getAssociatedTokenAddressSync)(SOL_MINT, userVolumeAccumulator, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         const remainingKeys = [];
@@ -849,6 +936,7 @@ class PumpTrader {
             remainingKeys.push({ pubkey: userVolumeAccumulatorWsolAta, isSigner: false, isWritable: true }, { pubkey: userVolumeAccumulator, isSigner: false, isWritable: true });
         }
         remainingKeys.push({ pubkey: poolV2, isSigner: false, isWritable: false });
+        remainingKeys.push({ pubkey: newFeeRecipient, isSigner: false, isWritable: false }, { pubkey: newFeeRecipientTokenAccount, isSigner: false, isWritable: true });
         return new web3_js_1.TransactionInstruction({
             programId: PROGRAM_IDS.PUMP_AMM,
             keys: [

package/docs/plans/2026-04-29-pump-fee-recipient-design.md

@@ -0,0 +1,34 @@
+# Pump Fee Recipient Upgrade Design
+
+**Context**
+
+`pump-trader@1.1.3` currently hardcodes Pump bonding and AMM instruction account layouts that matched the pre-upgrade programs. Pump announced a breaking account layout change effective on April 28, 2026 at 16:00 UTC. After that upgrade, the existing instruction builders send the wrong account count and wrong trailing account order.
+
+**Design**
+
+Use a compatibility patch inside the existing handwritten instruction builders instead of migrating the project to the official SDKs. The patch adds the 8 published fee recipient addresses as constants, centralizes fee recipient selection behind a small helper, and updates the trailing account order for both bonding and AMM flows.
+
+For bonding:
+- append one mutable fee recipient after `bonding-curve-v2`
+- keep all existing accounts before `bonding-curve-v2` unchanged
+
+For AMM:
+- keep existing accounts through `pool-v2`
+- move the fee recipient pair to the end
+- pass fee recipient as readonly
+- pass quote mint ATA for that recipient as mutable
+
+**Why This Approach**
+
+This is the smallest change that restores runtime compatibility while preserving the library's current API and handwritten transaction flow. It also gives one future extension point for recipient selection without forcing an SDK dependency or wider refactor.
+
+**Validation**
+
+Add regression tests that assert instruction key count and tail ordering for:
+- bonding buy
+- bonding sell without cashback
+- bonding sell with cashback
+- AMM buy without cashback
+- AMM buy with cashback
+- AMM sell without cashback
+- AMM sell with cashback

package/docs/plans/2026-04-29-pump-fee-recipient.md

@@ -0,0 +1,143 @@
+# Pump Fee Recipient Upgrade Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Update `pump-trader@1.1.3` so Pump bonding and AMM instructions remain compatible with the April 28, 2026 fee recipient account layout upgrade.
+
+**Architecture:** Keep the existing handwritten instruction builders, add a centralized fee recipient selector, and rebuild the bonding and AMM account arrays so their tail order matches the upgraded programs. Use narrow regression tests that assert exact key ordering and account counts rather than broad network integration tests.
+
+**Tech Stack:** TypeScript, Node.js built-in test runner, `tsx`, `@solana/web3.js`, `@solana/spl-token`
+
+---
+
+### Task 1: Add regression tests for upgraded account layouts
+
+**Files:**
+- Modify: `package.json`
+- Create: `tests/instruction-accounts.test.ts`
+
+**Step 1: Write the failing test**
+
+Create tests that expect:
+- bonding buy has 18 keys and the final two are `bondingCurveV2`, fee recipient
+- bonding sell has 16 keys without cashback and 17 with cashback, with fee recipient last
+- AMM buy has 26 keys without cashback and 27 with cashback, with `poolV2`, fee recipient, fee recipient quote ATA at the tail
+- AMM sell has 24 keys without cashback and 26 with cashback, with the same tail order
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test`
+Expected: FAIL because the new helper methods or expected key layout do not yet exist.
+
+**Step 3: Write minimal implementation**
+
+Add helper methods in `index.ts` that build the account arrays and are reused by the existing transaction builders.
+
+**Step 4: Run test to verify it passes**
+
+Run: `npm test`
+Expected: PASS
+
+**Step 5: Commit**
+
+```bash
+git add package.json tests/instruction-accounts.test.ts index.ts index.js dist docs/plans
+git commit -m "fix: support upgraded pump fee recipient accounts"
+```
+
+### Task 2: Update bonding instruction account assembly
+
+**Files:**
+- Modify: `index.ts`
+- Modify: `index.js`
+- Modify: `dist/index.js`
+- Modify: `dist/index.d.ts`
+
+**Step 1: Write the failing test**
+
+Use the bonding tests from Task 1 as the failing coverage.
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test -- --test-name-pattern bonding`
+Expected: FAIL because bonding key count and fee recipient tail order are still old.
+
+**Step 3: Write minimal implementation**
+
+Add the 8 fee recipient constants, selector helper, bonding key builders, and switch `buy()` / `sell()` to use them.
+
+**Step 4: Run test to verify it passes**
+
+Run: `npm test -- --test-name-pattern bonding`
+Expected: PASS
+
+**Step 5: Commit**
+
+```bash
+git add index.ts index.js dist
+git commit -m "fix: update bonding fee recipient accounts"
+```
+
+### Task 3: Update AMM instruction account assembly
+
+**Files:**
+- Modify: `index.ts`
+- Modify: `index.js`
+- Modify: `dist/index.js`
+- Modify: `dist/index.d.ts`
+
+**Step 1: Write the failing test**
+
+Use the AMM tests from Task 1 as the failing coverage.
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test -- --test-name-pattern amm`
+Expected: FAIL because the fee recipient pair is still placed before `pool-v2`.
+
+**Step 3: Write minimal implementation**
+
+Make AMM key assembly place `pool-v2` before the new trailing fee recipient pair for both buy and sell, preserving cashback-only extras.
+
+**Step 4: Run test to verify it passes**
+
+Run: `npm test -- --test-name-pattern amm`
+Expected: PASS
+
+**Step 5: Commit**
+
+```bash
+git add index.ts index.js dist
+git commit -m "fix: update amm fee recipient accounts"
+```
+
+### Task 4: Build and verify distributable output
+
+**Files:**
+- Modify: `dist/index.js`
+- Modify: `dist/index.d.ts`
+
+**Step 1: Write the failing test**
+
+Use the build command as the verification target for generated output drift.
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm run build`
+Expected: PASS after source changes, with generated `dist` updated.
+
+**Step 3: Write minimal implementation**
+
+No extra implementation beyond generating `dist`.
+
+**Step 4: Run test to verify it passes**
+
+Run: `npm test && npm run build`
+Expected: PASS
+
+**Step 5: Commit**
+
+```bash
+git add dist
+git commit -m "build: refresh distribution output"
+```