Skip to content

CLAIM_CASHBACK.md

Latest commit

 

History

History
103 lines (75 loc) · 5.32 KB

CLAIM_CASHBACK.md

File metadata and controls

103 lines (75 loc) · 5.32 KB
Raw

Claim Cashback

The claim_cashback_v2 instruction claims cashback accrued in a user's volume accumulator. It supports both legacy SOL cashback and non-SOL quote mint cashback through the same interface. The instruction is permissionless: user is the cashback recipient, but does not need to sign the transaction.

Accounts

# Account Seeds / derivation init_if_needed / SOL cost
1 user Cashback recipient. For legacy SOL cashback, receives all lamports held above rent-exempt balance in user_volume_accumulator. -
2 user_volume_accumulator Pump PDA: seeds [b"user_volume_accumulator", user]. -
3 quote_mint Quote mint for the cashback being claimed. Pass wrapped SOL, So11111111111111111111111111111111111111112, for legacy SOL cashback. -
4 quote_token_program Token program for quote_mint. Pass the legacy SPL Token Program, TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA, for legacy SOL cashback. -
5 associated_token_program Associated Token Program: ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL. -
6 associated_user_volume_accumulator Associated token account for quote_mint, owned by user_volume_accumulator, using quote_token_program. For legacy SOL cashback, this account may not exist. -
7 associated_quote_user Associated token account for quote_mint, owned by user, using quote_token_program. For legacy SOL cashback, this account may not exist. -
8 system_program System Program: 11111111111111111111111111111111. -
9 event_authority Pump PDA: seeds [b"__event_authority"]. -
10 program Pump program account. -

Instruction Data

The claim_cashback_v2 instruction takes no instruction data arguments.

TS SDK

Claim Legacy SOL-Paired Mint Cashback

Pass wrapped SOL as quoteMint. This claims lamports directly from the user's volume accumulator to user.

import { getPumpProgram } from "@pump-fun/pump-sdk";

const pumpProgram = getPumpProgram(connection);
const quoteMint = NATIVE_MINT;
const quoteTokenProgram = TOKEN_PROGRAM_ID;

const claimCashbackInstruction = await pumpProgram.methods
  .claimCashbackV2()
  .accountsPartial({
    user,
    quoteMint,
    quoteTokenProgram,
  })
  .instruction();

Claim USDC-Paired Mint Cashback

For non-SOL quote mints, pass the quote mint and its token program. This claims tokens from the user's volume accumulator quote ATA to the user's quote ATA.

import { getPumpProgram } from "@pump-fun/pump-sdk";

const pumpProgram = getPumpProgram(connection);
const quoteMint = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const quoteTokenProgram = TOKEN_PROGRAM_ID;

const claimCashbackInstruction = await pumpProgram.methods
  .claimCashbackV2()
  .accountsPartial({
    user,
    quoteMint,
    quoteTokenProgram,
  })
  .instruction();

Rust SDK

The Rust client exposes claim_cashback_v2_instruction. Pass Pubkey::default() (or wSOL) as quote_mint for legacy SOL cashback, or the desired quote mint (e.g. USDC) for non-SOL cashback. quote_token_program must match the quote mint's token program.

Claim Legacy SOL-Paired Mint Cashback

use pump_rust_client::{constants, PumpSdk};
use solana_sdk::pubkey::Pubkey;

let sdk = PumpSdk::new();

let ix = sdk.claim_cashback_v2_instruction(
    user.pubkey(),
    Pubkey::default(),               // quote_mint — default → wSOL
    constants::SPL_TOKEN_PROGRAM_ID, // quote_token_program
);

Claim USDC-Paired Mint Cashback

let usdc = pubkey!("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");

let ix = sdk.claim_cashback_v2_instruction(
    user.pubkey(),
    usdc,                            // quote_mint
    constants::SPL_TOKEN_PROGRAM_ID, // quote_token_program
);