CPMM-Konten

​

Die sechs Konten eines CPMM-Pools

​

Ableitung eines Pools aus nichts als zwei Mints

import { PublicKey } from "@solana/web3.js";
import BN from "bn.js";

const CPMM_PROGRAM_ID = new PublicKey(
  "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C"
); // mainnet — see reference/program-addresses

function u16ToBytes(n: number): Buffer {
  const b = Buffer.alloc(2);
  b.writeUInt16BE(n);
  return b;
}

// token0 < token1 by byte order. Getting this wrong yields a valid PDA
// that points at a nonexistent pool.
function sortMints(a: PublicKey, b: PublicKey): [PublicKey, PublicKey] {
  return Buffer.compare(a.toBuffer(), b.toBuffer()) < 0 ? [a, b] : [b, a];
}

export function deriveCpmmAccounts(
  mintA: PublicKey,
  mintB: PublicKey,
  ammConfigIndex = 0,
) {
  const [token0Mint, token1Mint] = sortMints(mintA, mintB);

  const [ammConfig] = PublicKey.findProgramAddressSync(
    [Buffer.from("amm_config"), u16ToBytes(ammConfigIndex)],
    CPMM_PROGRAM_ID,
  );
  const [authority] = PublicKey.findProgramAddressSync(
    [Buffer.from("vault_and_lp_mint_auth_seed")],
    CPMM_PROGRAM_ID,
  );
  const [poolState] = PublicKey.findProgramAddressSync(
    [
      Buffer.from("pool"),
      ammConfig.toBuffer(),
      token0Mint.toBuffer(),
      token1Mint.toBuffer(),
    ],
    CPMM_PROGRAM_ID,
  );
  const [lpMint] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_lp_mint"), poolState.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [vault0] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_vault"), poolState.toBuffer(), token0Mint.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [vault1] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_vault"), poolState.toBuffer(), token1Mint.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [observation] = PublicKey.findProgramAddressSync(
    [Buffer.from("observation"), poolState.toBuffer()],
    CPMM_PROGRAM_ID,
  );

  return {
    ammConfig,
    authority,
    poolState,
    lpMint,
    token0Mint,
    token1Mint,
    vault0,
    vault1,
    observation,
  };
}

​

Kontenlayouts

​

PoolState

// programs/cp-swap/src/states/pool.rs
pub struct PoolState {
    pub amm_config: Pubkey,               // binds this pool to an AmmConfig
    pub pool_creator: Pubkey,             // who ran initialize
    pub token_0_vault: Pubkey,            // == vault0 PDA
    pub token_1_vault: Pubkey,            // == vault1 PDA

    pub lp_mint: Pubkey,
    pub token_0_mint: Pubkey,
    pub token_1_mint: Pubkey,

    pub token_0_program: Pubkey,          // SPL Token or Token-2022 program
    pub token_1_program: Pubkey,

    pub observation_key: Pubkey,          // == observation PDA
    pub auth_bump: u8,
    pub status: u8,                       // bitmask: deposit | withdraw | swap
    pub lp_mint_decimals: u8,
    pub mint_0_decimals: u8,
    pub mint_1_decimals: u8,

    pub lp_supply: u64,                   // mirrors lp_mint supply
    pub protocol_fees_token_0: u64,
    pub protocol_fees_token_1: u64,
    pub fund_fees_token_0: u64,
    pub fund_fees_token_1: u64,

    pub open_time: u64,                   // unix; swaps rejected before this
    pub recent_epoch: u64,

    // Creator-fee state (added after the original layout):
    pub creator_fee_on: u8,               // 0=BothToken, 1=OnlyToken0, 2=OnlyToken1
    pub enable_creator_fee: bool,
    pub padding1: [u8; 6],
    pub creator_fees_token_0: u64,
    pub creator_fees_token_1: u64,

    pub padding: [u64; 28],
}

• lp_supply — das interne LP-Gesamtvolumen des Pools. Es ist nicht gleich dem Angebot des LP-Mints: es ist genau 100 Basiseinheiten höher, da die 100 gesperrten Einheiten hier gezählt werden, aber nie geprägt werden. Die gesamte LP-Share-Mathematik (Einzahlung, Auszahlung) dividiert durch lp_supply, daher verwenden Sie dieses Feld und ersetzen Sie nicht das On-Chain-Angebot des Mints.
• protocol_fees_token{0,1}, fund_fees_token{0,1} — akkumulierte Gebühren, die noch nicht eingezogen wurden. Diese beeinflussen nicht die Swap-Preisgestaltung; sie sitzen in den Vaults, bis CollectProtocolFee / CollectFundFee aufgerufen wird. protocol_fees_token{0,1} erhält auch den Protokoll-Anteil der Creator-Gebühr, wenn eine Creator-Gebühr eingezogen wird, daher wächst sie außerhalb von Swaps — siehe products/cpmm/fees.
• status — eine Bitmaske, die steuert, ob Swap, Deposit, Withdraw zulässig sind. Wird vom Admin über UpdatePoolStatus aktualisiert. Das SDK prüft dies vor dem Erstellen einer Transaktion; wenn Sie direkt CPI verwenden, prüfen Sie es selbst.
• token0_program / token1_program — das Token-Programm, in das für jeden Vault CPI durchgeführt werden soll. Eines kann klassisches SPL Token und das andere Token-2022 sein; sie sind unabhängig.
• open_time — ein Unix-Zeitstempel. Swaps vor dieser Zeit schlagen fehl. Einzahlungen sind vor open_time zulässig, damit der Pool gesät werden kann.
• creator_fee_on / enable_creator_fee — zusammen steuern, ob die optionale Creator-Gebühr für diesen Pool aktiv ist und von welcher Seite des Swaps sie eingezogen wird. enable_creator_fee == false setzt den Creator-Fee-Pfad vollständig auf Null. Wenn aktiviert, wählt creator_fee_on: 0 = Gebühr von welchem Token auch immer der Swap-Input ist (BothToken); 1 = Gebühr nur von token_0 (überspringen bei token_1 → token_0 Swaps); 2 = Gebühr nur von token_1. Wird bei der Pool-Erstellung über InitializeWithPermission gesetzt; kann sich später nicht ändern.
• creator_fees_token_{0,1} — akkumulierte Creator-Gebühren, eingezogen durch CollectCreatorFee oder CollectCreatorFeePermissionless. Beide Pfade setzen die vollständigen Zähler auf Null, aber seit dem Upgrade vom 2026-09-19 verlässt nur ein Teil des Saldos den Pool: Der Protokoll-Anteil wird zu protocol_fees_token_{0,1} hinzugefügt und der Rest wird an den Creator übertragen. Der erlaubnislose Pfad behebt die Empfänger auf die kanonischen ATAs von pool_creator. PoolState selbst hat sich nicht geändert — es gibt keinen separaten Zähler für den gemeinsamen Betrag.

​

AmmConfig

pub struct AmmConfig {
    pub bump: u8,
    pub disable_create_pool: bool,
    pub index: u16,                       // matches the seed
    pub trade_fee_rate: u64,              // e.g., 2500 = 0.25%
    pub protocol_fee_rate: u64,           // fraction of trade fee to protocol
    pub fund_fee_rate: u64,               // fraction of trade fee to fund
    pub create_pool_fee: u64,             // paid once at init (in SOL or token)
    pub protocol_owner: Pubkey,           // can call CollectProtocolFee
    pub fund_owner: Pubkey,               // can call CollectFundFee
    pub creator_fee_rate: u64,            // optional pool-creator fee rate (1/1_000_000 of volume)
    pub creator_fee_share_rate: u64,      // protocol's default share OF the creator fee
    pub padding: [u64; 14],
}
// AmmConfig::LEN == 236 bytes — unchanged.

1. trade_fee_rate und creator_fee_rate sind Bruchteile des Volumens, beide in Einheiten von 1/1_000_000 bezeichnet. 2500 bedeutet 0,25% des Handelsvolumens. protocol_fee_rate und fund_fee_rate sind Bruchteile der Handelsgebühr (nicht des Volumens), mit demselben 1/1_000_000-Nenner. Die Creator-Gebühr ist nicht ein Bruchteil der Handelsgebühr — sie ist ihre eigene unabhängige Rate. Die vollständige Arithmetik ist in products/cpmm/fees.
2. index ist ein u16, daher verwendet der Seed-Hash 2 Bytes Big-Endian. Ein Off-by-One bei der Byte-Reihenfolge ist ein häufiger Integrationsfehler.
3. AmmConfig ist auf Pool-Ebene unveränderlich. Ein Pool verweist bei der Erstellung auf eine AmmConfig und wechselt nie. Gebührenänderungen werden verbreitet, da der Pool die Konfiguration bei jedem Swap liest — aber der Pool kann nicht zwischen Gebühren-Tiers verschoben werden.

​

Permission

pub struct Permission {
    pub authority: Pubkey,    // who is allowed to call InitializeWithPermission
    pub padding: [u64; 30],
}
// Permission::LEN == 8 + 32 + 8 * 30 == 280 bytes

​

CreatorFeeShare

// programs/cp-swap/src/states/creator_fee_share.rs
pub const CREATOR_FEE_SHARE_SEED: &str = "creator_fee_share";

pub struct CreatorFeeShare {
    pub bump: u8,
    pub creator: Pubkey,       // the pool creator this rate applies to
    pub amm_config: Pubkey,    // the fee tier this rate applies to
    pub share_rate: u64,       // protocol's share OF the creator fee, 1/1_000_000
    pub padding: [u64; 8],
}
// CreatorFeeShare::LEN == 8 + 1 + 32 * 2 + 8 + 8 * 8 == 145 bytes

const [creatorFeeShare] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_share"), creator.toBuffer(), ammConfig.toBuffer()],
  CPMM_PROGRAM_ID, // see reference/program-addresses
);

• Es ist optional, aber das Konto ist niemals optional in der Anweisung. CollectCreatorFee und CollectCreatorFeePermissionless deklarieren beide creator_fee_share mit der obigen Seed-Einschränkung und nehmen es bei jedem Aufruf. Das Programm prüft dann, ob das Konto leer oder fremd ist; wenn ja, fällt es auf AmmConfig.creator_fee_share_rate zurück. Ein Client muss also immer die Adresse ableiten und übergeben, unabhängig davon, ob das Konto existiert oder nicht.
• share_rate ist auf FEE_RATE_DENOMINATOR_VALUE (1_000_000) bei der Erstellung begrenzt, und erneut, wenn die Aufteilung läuft. 1_000_000 leitet die gesamte Creator-Gebühr an das Protokoll; 0 leitet keine davon.
• Erstellt und geschlossen vom Admin oder einer dedizierten Autorität durch CreateCreatorFeeShare / CloseCreatorFeeShare. Das Schließen gibt die Miete an den Unterzeichner zurück und fällt das Paar auf den Config-Standard zurück; der Pool-Creator ist kein Unterzeichner auf beiden Pfaden.
• Es wird auf dem Creator, nicht dem Pool, verschlüsselt. Ein Konto regelt jeden Pool, den dieser Creator auf dieser AmmConfig hat. Ein Creator mit Pools auf zwei Gebühren-Tiers benötigt zwei Konten, um auf beiden abgedeckt zu sein.

​

Vaults und Token-2022

• TransferFeeConfig. Angewendet vom Mint bei jedem Transfer. Der Pool ist auf der Empfängerseite für SwapBaseInput-Einzahlungen und auf der Senderseite für Auszahlungen. Das Programm berechnet den Netto-Betrag, der im Vault landet, und setzt die Kurve entsprechend. Siehe algorithms/token-2022-transfer-fees.
• MetadataPointer und TokenMetadata. Standard-On-Mint-Metadaten. Keine Auswirkung auf die Swap-Mathematik.
• InterestBearingConfig. Der UI-Betrag des Mints sammelt Zinsen. Der Vault speichert Rohbeträge; die Kurve arbeitet nur mit Rohbeträgen. UIs, die APR anzeigen, sollten die Token-2022-Helfer aufrufen, um den UI-Betrag zu rendern.
• ScaledUiAmount. UI-Display-Skalierungserweiterung. Gleiche Behandlung wie InterestBearingConfig — die Kurve verwendet Rohbeträge.

​

Observation

// OBSERVATION_NUM is hardcoded in the program to 100.
pub const OBSERVATION_NUM: usize = 100;

pub struct Observation {
    pub block_timestamp:              u64,
    pub cumulative_token_0_price_x32: u128,   // Q32.32, top 64 bits left for overflow
    pub cumulative_token_1_price_x32: u128,
}

pub struct ObservationState {
    pub initialized:           bool,
    pub observation_index:     u16,                            // circular index
    pub pool_id:               Pubkey,
    pub observations:          [Observation; OBSERVATION_NUM], // 100 entries
    pub last_update_timestamp: u64,                            // timestamp of the most recent append
    pub padding:               [u64; 3],
}

• Verwenden Sie nicht eine einzelne Observation als Preis. Es ist ein kumulativ, kein Spot-Preis. Verwenden Sie zwei davon, um einen TWAP zu berechnen.
• Wählen Sie Observations mindestens einen Block auseinander. Swaps innerhalb desselben Blocks können keine neue Observation erzeugen; das Zurücklesen kann denselben Datensatz zurückgeben.

​

Kontenlebenszyklus

​

Was wo zu lesen ist

• Anweisungs-Kontenlisten (welche der obigen sind beschreibbar/Unterzeichner für jede Anweisung): products/cpmm/instructions.
• Gebühren-Akkumulationssemantik: products/cpmm/fees.
• Swap-Mathematik / Observation-Update-Regel: products/cpmm/math.
• Kanonische Seeds / Program IDs: reference/program-addresses.

• raydium-io/raydium-cp-swap — PoolState, AmmConfig, ObservationState