@0block.io/sdk 0.5.1 → 0.6.0

package/dist/fetch.d.ts

@@ -19,19 +19,32 @@ export declare function resolveTokenProgram(fetcher: AccountFetcher, mint: Addre
 export declare function fetchPumpfunGlobalFeeRecipient(fetcher: AccountFetcher, globalAccount: web3.PublicKey): Promise<web3.PublicKey>;
 /** Non-zero entries of Global.buyback_fee_recipients ([Pubkey; 8]). */
 export declare function fetchPumpfunBuybackFeeRecipients(fetcher: AccountFetcher, globalAccount: web3.PublicKey): Promise<web3.PublicKey[]>;
+export interface PumpfunBondingCurveInfo {
+    /**
+     * BondingCurve.creator. For a legacy (never-extended) curve this is
+     * `PublicKey.default` — exactly what `extend_account` zero-fills, and the
+     * program derives `creator_vault` from `bonding_curve.creator` at execution
+     * time, so the default-creator vault is the correct one to pass.
+     */
+    creator: web3.PublicKey;
+    /**
+     * True when the curve is the 49-byte pre-creator legacy layout: pump.fun's
+     * `extend_account` (its own migration path; permissionless, no rent payer —
+     * curves fund their own rent from the SOL reserves they hold) must run
+     * before a modern swap can deserialize the account. The transaction builder
+     * prepends it when `PumpfunMarketContext.curveNeedsExtension` is set.
+     */
+    needsExtension: boolean;
+}
 /**
- * BondingCurve.creator (offset: discriminator + 5×u64 + bool), with tradeability
- * preflight. Throws a PRECISE error instead of letting an untradeable market
- * fail on-chain (where the user would still pay the tx fee + tip):
- *
- * - `complete == true` → the token GRADUATED off the bonding curve (liquidity
- *   moved to an AMM — PumpSwap/Raydium); the pump.fun program rejects both
- *   buys and sells on a complete curve.
- * - 49-byte legacy layout (pre-creator-fee, curve untouched since the mid-2025
- *   pump.fun upgrade) → needs the program's extend_account before any modern
- *   swap can even deserialize it. In practice these are dead tokens: anything
- *   actively traded has long been extended.
+ * Tradeability preflight + creator, from ONE bonding-curve read. Throws a
+ * PRECISE error instead of letting an untradeable market fail on-chain (where
+ * the user would still pay the tx fee + tip): `complete == true` means the
+ * token GRADUATED off the bonding curve (liquidity moved to an AMM —
+ * PumpSwap/Raydium) and the pump.fun program rejects both buys and sells.
  */
+export declare function fetchPumpfunBondingCurveInfo(fetcher: AccountFetcher, bondingCurve: web3.PublicKey): Promise<PumpfunBondingCurveInfo>;
+/** BondingCurve.creator (see fetchPumpfunBondingCurveInfo for the preflight). */
 export declare function fetchPumpfunBondingCurveCreator(fetcher: AccountFetcher, bondingCurve: web3.PublicKey): Promise<web3.PublicKey>;
 /**
  * Resolve everything a pump.fun swap needs for one mint. Run this server-side

package/dist/fetch.js

@@ -56,19 +56,13 @@ export async function fetchPumpfunBuybackFeeRecipients(fetcher, globalAccount) {
     return recipients;
 }
 /**
- * BondingCurve.creator (offset: discriminator + 5×u64 + bool), with tradeability
- * preflight. Throws a PRECISE error instead of letting an untradeable market
- * fail on-chain (where the user would still pay the tx fee + tip):
- *
- * - `complete == true` → the token GRADUATED off the bonding curve (liquidity
- *   moved to an AMM — PumpSwap/Raydium); the pump.fun program rejects both
- *   buys and sells on a complete curve.
- * - 49-byte legacy layout (pre-creator-fee, curve untouched since the mid-2025
- *   pump.fun upgrade) → needs the program's extend_account before any modern
- *   swap can even deserialize it. In practice these are dead tokens: anything
- *   actively traded has long been extended.
+ * Tradeability preflight + creator, from ONE bonding-curve read. Throws a
+ * PRECISE error instead of letting an untradeable market fail on-chain (where
+ * the user would still pay the tx fee + tip): `complete == true` means the
+ * token GRADUATED off the bonding curve (liquidity moved to an AMM —
+ * PumpSwap/Raydium) and the pump.fun program rejects both buys and sells.
  */
-export async function fetchPumpfunBondingCurveCreator(fetcher, bondingCurve) {
+export async function fetchPumpfunBondingCurveInfo(fetcher, bondingCurve) {
     const info = await fetcher.getAccountInfo(bondingCurve);
     if (!info) {
         throw new Error(`pump.fun bonding curve not found: ${bondingCurve.toBase58()}`);
@@ -83,10 +77,16 @@ export async function fetchPumpfunBondingCurveCreator(fetcher, bondingCurve) {
             "(PumpSwap/Raydium); it cannot be traded on the bonding curve");
     }
     if (info.data.length < legacyLen + 32) {
-        throw new Error("legacy pump.fun bonding curve (pre-creator layout, never extended) — " +
-            "the account needs pump.fun extend_account before modern swaps can run");
+        return { creator: web3.PublicKey.default, needsExtension: true };
     }
-    return new web3.PublicKey(info.data.slice(legacyLen, legacyLen + 32));
+    return {
+        creator: new web3.PublicKey(info.data.slice(legacyLen, legacyLen + 32)),
+        needsExtension: false,
+    };
+}
+/** BondingCurve.creator (see fetchPumpfunBondingCurveInfo for the preflight). */
+export async function fetchPumpfunBondingCurveCreator(fetcher, bondingCurve) {
+    return (await fetchPumpfunBondingCurveInfo(fetcher, bondingCurve)).creator;
 }
 /**
  * Resolve everything a pump.fun swap needs for one mint. Run this server-side
@@ -100,11 +100,11 @@ export async function resolvePumpfunMarketContext(fetcher, params) {
     const feeProgram = toPk(params.pumpfunFeeProgram ?? PUMPFUN_FEE_PROGRAM_ID);
     const global = derivePumpfunGlobal(pumpProgram);
     const bondingCurve = derivePumpfunBondingCurve(pumpProgram, mint);
-    const [mintTokenProgram, feeRecipient, buybackRecipients, creator] = await Promise.all([
+    const [mintTokenProgram, feeRecipient, buybackRecipients, curveInfo] = await Promise.all([
         resolveTokenProgram(fetcher, mint),
         fetchPumpfunGlobalFeeRecipient(fetcher, global),
         fetchPumpfunBuybackFeeRecipients(fetcher, global),
-        fetchPumpfunBondingCurveCreator(fetcher, bondingCurve),
+        fetchPumpfunBondingCurveInfo(fetcher, bondingCurve),
     ]);
     return {
         mint: mint.toBase58(),
@@ -115,11 +115,12 @@ export async function resolvePumpfunMarketContext(fetcher, params) {
         bondingCurve: bondingCurve.toBase58(),
         associatedBondingCurve: deriveAta(bondingCurve, mint, mintTokenProgram).toBase58(),
         bondingCurveV2: derivePumpfunBondingCurveV2(pumpProgram, mint).toBase58(),
-        creatorVault: derivePumpfunCreatorVault(pumpProgram, creator).toBase58(),
+        creatorVault: derivePumpfunCreatorVault(pumpProgram, curveInfo.creator).toBase58(),
         feeRecipient: feeRecipient.toBase58(),
         buybackFeeRecipients: buybackRecipients.map((r) => r.toBase58()),
         eventAuthority: derivePumpfunEventAuthority(pumpProgram).toBase58(),
         globalVolumeAccumulator: derivePumpfunGlobalVolumeAccumulator(pumpProgram).toBase58(),
         feeConfig: derivePumpfunFeeConfig(feeProgram, pumpProgram).toBase58(),
+        curveNeedsExtension: curveInfo.needsExtension,
     };
 }

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { buildSendTransactionRequest, createLandingClient, withLandingTip, type
 export { fetchRecentBlockhash, type FetchBlockhashOptions, type RecentBlockhash, } from "./blockhash.js";
 export { zeroblockFetcher, fetchTokenBalanceViaZeroblock, fetchLookupTableViaZeroblock, type ZeroblockReadOptions, type ZeroblockTokenBalance, } from "./zeroblock.js";
 export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
-export { type AccountFetcher, connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
-export { buildPumpfunRemainingAccounts, type PumpfunRemainingAccountsParams, } from "./venues/pumpfun.js";
+export { type AccountFetcher, connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBondingCurveInfo, type PumpfunBondingCurveInfo, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
+export { buildPumpfunRemainingAccounts, buildPumpfunExtendAccountInstruction, type PumpfunRemainingAccountsParams, } from "./venues/pumpfun.js";
 export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeMint, type SwapInstructionResult, } from "./swap.js";
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";

package/dist/index.js

@@ -18,8 +18,8 @@ export { buildSendTransactionRequest, createLandingClient, withLandingTip, } fro
 export { fetchRecentBlockhash, } from "./blockhash.js";
 export { zeroblockFetcher, fetchTokenBalanceViaZeroblock, fetchLookupTableViaZeroblock, } from "./zeroblock.js";
 export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
-export { connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
-export { buildPumpfunRemainingAccounts, } from "./venues/pumpfun.js";
+export { connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBondingCurveInfo, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
+export { buildPumpfunRemainingAccounts, buildPumpfunExtendAccountInstruction, } from "./venues/pumpfun.js";
 export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeMint, } from "./swap.js";
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";

package/dist/transaction.js

@@ -4,6 +4,7 @@ import { toPk } from "./pda.js";
 import { buildComputeBudgetInstructions } from "./computeBudget.js";
 import { buildPumpfunSwapInstruction } from "./swap.js";
 import { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
+import { buildPumpfunExtendAccountInstruction } from "./venues/pumpfun.js";
 import { closeAccountInstruction, createAtaIdempotentInstruction, unwrapWsolInstruction, wrapSolInstructions, } from "./wsol.js";
 /** Rehydrate a streamed lookup table into web3.js form (compile-time only fields defaulted). */
 export function toLookupTableAccount(data) {
@@ -45,6 +46,18 @@ export function buildPumpfunSwapTransaction(params) {
     if (params.computeBudget) {
         instructions.push(...buildComputeBudgetInstructions(params.computeBudget));
     }
+    // LEGACY CURVE (49-byte pre-creator layout): run pump.fun's own migration —
+    // extend_account — before the swap so the program can deserialize the curve.
+    // Zero-fills the new fields, so the resolver's default-creator vault in
+    // market.creatorVault matches what the program derives at execution time.
+    if (params.market.curveNeedsExtension) {
+        instructions.push(buildPumpfunExtendAccountInstruction({
+            pumpfunProgram: toPk(params.market.pumpfunProgram),
+            account: toPk(params.market.bondingCurve),
+            user,
+            eventAuthority: toPk(params.market.eventAuthority),
+        }));
+    }
     // TENANT MODE: the wrapper program manages the entire native-SOL lifecycle
     // on-chain (ATA creation, wrap sized with exact on-chain fee headroom,
     // post-swap sweep, proceeds unwrap, emptied-ATA cleanup) — the client adds

package/dist/types.d.ts

@@ -27,6 +27,15 @@ export interface PumpfunMarketContext {
     eventAuthority: string;
     globalVolumeAccumulator: string;
     feeConfig: string;
+    /**
+     * True when the bonding curve is the 49-byte pre-creator legacy layout
+     * (untouched since pump.fun's creator upgrade). The transaction builder then
+     * prepends pump.fun's `extend_account` instruction — the program's own
+     * migration path — so the swap can deserialize the account. The zero-filled
+     * creator makes `creatorVault` the default-creator vault (already baked in
+     * by the resolver).
+     */
+    curveNeedsExtension?: boolean;
 }
 /** Serializable address-lookup-table contents, streamable over a WS. */
 export interface LookupTableData {

package/dist/venues/pumpfun.d.ts

@@ -30,3 +30,23 @@ export interface PumpfunRemainingAccountsParams {
  * program id is always index 0 and is hard-checked on-chain.
  */
 export declare function buildPumpfunRemainingAccounts(side: SwapSide, p: PumpfunRemainingAccountsParams): web3.AccountMeta[];
+/**
+ * pump.fun `extend_account` — the program's own migration path for accounts
+ * predating a layout upgrade (e.g. 49-byte pre-creator bonding curves, which
+ * modern swaps cannot even deserialize). Permissionless; `user` only signs
+ * (no rent payer — a bonding curve funds its own rent from the SOL reserves
+ * it holds as lamports). Realloc zero-fills the new fields, so post-extension
+ * `creator == PublicKey.default` and the swap's creator_vault must be the
+ * default-creator vault (the market resolver bakes that in).
+ *
+ * Discriminator and account list verified against the on-chain anchor IDL of
+ * 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P.
+ */
+export declare function buildPumpfunExtendAccountInstruction(params: {
+    pumpfunProgram: web3.PublicKey;
+    /** The program-owned account to extend (the bonding curve). */
+    account: web3.PublicKey;
+    /** The transaction's user/payer (signer). */
+    user: web3.PublicKey;
+    eventAuthority: web3.PublicKey;
+}): web3.TransactionInstruction;

package/dist/venues/pumpfun.js

@@ -1,3 +1,4 @@
+import * as web3 from "@solana/web3.js";
 /**
  * Remaining accounts for one pump.fun leg, in the exact order the router's
  * adapter parses them (PumpfunBuyAccounts / PumpfunSellAccounts). The dex
@@ -54,3 +55,29 @@ export function buildPumpfunRemainingAccounts(side, p) {
     }
     throw new Error(`Unsupported pump.fun side: ${side}`);
 }
+/**
+ * pump.fun `extend_account` — the program's own migration path for accounts
+ * predating a layout upgrade (e.g. 49-byte pre-creator bonding curves, which
+ * modern swaps cannot even deserialize). Permissionless; `user` only signs
+ * (no rent payer — a bonding curve funds its own rent from the SOL reserves
+ * it holds as lamports). Realloc zero-fills the new fields, so post-extension
+ * `creator == PublicKey.default` and the swap's creator_vault must be the
+ * default-creator vault (the market resolver bakes that in).
+ *
+ * Discriminator and account list verified against the on-chain anchor IDL of
+ * 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P.
+ */
+export function buildPumpfunExtendAccountInstruction(params) {
+    return new web3.TransactionInstruction({
+        programId: params.pumpfunProgram,
+        keys: [
+            { pubkey: params.account, isSigner: false, isWritable: true },
+            { pubkey: params.user, isSigner: true, isWritable: false },
+            { pubkey: web3.SystemProgram.programId, isSigner: false, isWritable: false },
+            { pubkey: params.eventAuthority, isSigner: false, isWritable: false },
+            { pubkey: params.pumpfunProgram, isSigner: false, isWritable: false },
+        ],
+        // sha256("global:extend_account")[0..8] — from the on-chain IDL.
+        data: Buffer.from([234, 102, 194, 203, 150, 72, 62, 229]),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0block.io/sdk",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Client-side transaction builder for the 0Block DEX router. Builds unsigned v0 swap transactions entirely offline \u2014 tenant-wrapped or direct \u2014 with shared address lookup tables, gateway tips, and on-chain fee-event decoding for accounting.",
   "keywords": [
     "solana",