共享基礎設施

​

這裡「共享」的含義

• 約定共享。 每個程式都使用相同的 PDA 推導模式、相同的費用分配形狀和相同的觀察帳戶概念——但每個都在自己的程式中用自己的種子實現它們。
• 帳戶共享。 少數帳戶在許多池中字面上是相同的記錄（CPMM 中的全局權限 PDA、AmmConfig 帳戶）。
• 鏈下共享。 一個 REST API 和一個 TypeScript SDK 為所有四個程式提供服務。集成商與一個 HTTP 主機和一個 NPM 套件互動，無論他們最終調用哪個程式。

​

1. 權限 PDA

• 對於 CPMM 和 CLMM，權限 PDA 是全局帳戶——該類型的每個池都使用它。如果你正在 CPI 進入 CPMM，你只需要一次，而不是每個池。
• 對於每個池/每個農場的權限，你從池/農場 ID 推導 PDA。SDK 在 getPoolKeys / getFarmKeys 中執行此操作；如果你直接集成，你使用 findProgramAddressSync 推導。
• 金庫所有權無法更改。 一旦代幣帳戶以權限 PDA 作為所有者創建，只有該 PDA——由程式調用——可以轉出。沒有管理員覆蓋。

​

2. 管理員和設定帳戶

// CPMM AmmConfig（簡化——CLMM 版本在結構上相似）
pub struct AmmConfig {
    pub bump: u8,
    pub disable_create_pool: bool,        // 在此層級中禁止新池創建
    pub index: u16,                       // 層級索引
    pub trade_fee_rate: u64,              // 交易中進入費用的部分
    pub protocol_fee_rate: u64,           // 交易費用中進入協議的部分
    pub fund_fee_rate: u64,               // 交易費用中進入基金的部分
    pub create_pool_fee: u64,             // 每個池創建的一次性費用
    pub protocol_owner: Pubkey,           // CollectProtocolFee 的簽署者
    pub fund_owner: Pubkey,               // CollectFundFee 的簽署者
    pub padding: [u64; 16],
}

• 費用層級是全局的。 當一個池說「這是一個 0.25% 的池」時，它意味著它綁定到 AmmConfig，其 trade_fee_rate 在創建時為 0.25%。沒有每個池的費率覆蓋。
• 設定可以更改但池不跟隨。 如果設定權限編輯 AmmConfig，綁定到該設定的每個現有池立即獲取新費率。這是一個功能，不是一個錯誤；這是協議級經濟變化如何在沒有每個池遷移的情況下傳播的方式。
• disable_create_pool 是棄用槓桿。 當費用層級被日落時，協議多簽設置此標誌——現有池繼續工作但沒有新池可以選擇該層級。
• protocol_owner / fund_owner 是費用收集調用的簽署者。將它們設置為多簽是什麼限制費用提取。它們不是費用本身的目的地地址；那是同一帳戶上的 protocol_fee_destination / fund_fee_destination。

​

3. 協議/基金/創作者費用分配

                         total swap fee
                              │
              ┌───────────────┼───────────────┬──────────────┐
              ▼               ▼               ▼              ▼
        LP pool side     Protocol         Fund         Creator
        (raises k)       treasury         multisig     (LaunchLab pools)

1. 交易費用累積到池中。 費用從交換的輸入端移除，扣費後的金額是常數乘積數學看到的。這就是「LP 賺取費用」的含義——k 上升，隱含的每個 LP 代幣價值也上升。
2. 協議/基金/創作者部分從該 LP 端累積中扣除到每個池的計數器帳戶中。 它們位於池狀態（protocol_fees_token{0,1}、fund_fees_token{0,1} 等）上，直到有人調用相應的收集指令。它們在那之前不會離開池的金庫；從交換的角度來看，它們仍然「在池中」。
3. 收集將它們移出。 協議和基金路徑需要來自 AmmConfig 的各自 protocol_owner / fund_owner 簽署者。CPMM 創作者費用使用創作者簽署的 CollectCreatorFee 路徑或 CollectCreatorFeePermissionless，任何支付者都可以觸發，但它將目的地固定為創作者的規範 ATA。

• 分割百分比是交易費用的，不是交易的。 一個 0.25% 的交易費用，有 12% 的協議份額意味著協議獲得 0.25% × 12% = 0.03% 的交易——不是交易的 12%。
• 創作者費用只存在於 LaunchLab 畢業的池上。 標準 CPMM/CLMM 池有三向分割（LP/協議/基金）。LaunchLab 添加第四個槽位，路由到啟動代幣的人，在 Initialize 時配置且不可變。
• AMM v4 只分割兩種方式，每個池硬編碼：LP 和協議。沒有基金槽位，沒有創作者槽位。
• 基金 vs 協議——兩者都是協議庫目的地，但它們有不同的簽署者和不同的預期用途。protocol 歷史上資助運營；fund 是長期庫。兩者之間的分割本身是可調的。

​

4. 觀察帳戶（TWAP 環形緩衝區）

// CPMM ObservationState（簡化）
pub struct ObservationState {
    pub initialized: bool,
    pub observation_index: u16,            // 下一個要覆蓋的槽位
    pub pool_id: Pubkey,
    pub observations: [Observation; OBSERVATION_NUM],
    pub padding: [u64; 4],
}

pub struct Observation {
    pub block_timestamp: u64,
    pub cumulative_token_0_price_x32: u128,  // 自初始化以來 (price × dt) 的總和
    pub cumulative_token_1_price_x32: u128,
}

• 每次交換都調用 update_observation。 程式讀取當前價格，乘以自上一次觀察以來經過的秒數，並將其添加到累積計數器中。新條目覆蓋最舊的槽位（環形緩衝區風格）。
• 窗口上的 TWAP = (cumul[end] − cumul[start]) / (timestamp[end] − timestamp[start])。消費者選擇兩個觀察值括住所需的窗口並進行除法。
• Raydium 本身不使用 TWAP 進行定價。 AMM 數學直接讀取現貨儲備。觀察是外部性——Raydium 支付寫入成本，以便其他合約可以讀取。
• AMM v4 沒有觀察帳戶。 它比 ObservationState 設計更舊；想要 v4 TWAP 的集成商必須從日誌歷史中離線計算一個。

​

5. REST API + SDK + IDL

• REST API — https://api-v3.raydium.io。所有鏈上狀態的讀取為主的索引視圖加上報價引擎。一個主機，一個模式。
• TypeScript SDK — NPM 上的 @raydium-io/raydium-sdk-v2。為每個程式構建和簽署交易。與 API 交談以獲取報價/元數據，與 Solana RPC 交談以進行簽前狀態刷新。
• IDL 註冊表 — 每個已發佈程式的 Anchor IDL 位於 raydium-idl 倉庫中（每個程式一個 JSON：CPMM、CLMM、LaunchLab）。TypeScript SDK 在內部使用這些 IDL；下游 Rust/Python 客戶端從相同的檔案重新生成。

​

6. 索引器和價格源

• 索引器是唯一「知道」跨程式狀態的東西。 將 CPMM 池映射到其 CLMM 對應物、計算跨程式版本的 24 小時交易量、拾取與 LP 鑄幣相關的農場——所有這些都是索引器工作。程式本身不執行此操作。
• 索引器停機是 API 停機。 如果 API 返回陳舊或空數據，索引器是嫌疑人。鏈上狀態不受影響；具有自己的 RPC 和 SDK 的集成商可以繼續交易。

​

什麼不共享

• 程式不相互調用。 CPMM 交換永遠不會 CPI 進入 CLMM 或 AMM v4。唯一組合多個 AMM 的程式是 AMM 路由程式——而那個本身很薄，只是按順序向每個 AMM 發出 CPI。
• 跨程式沒有共享升級權限。 每個鏈上程式都有自己的程式升級密鑰（3/4 多簽加 24 小時時間鎖）。它們沒有鏈接。
• 農場和 AMM 之間沒有共享狀態。 農場不知道它質押的 LP 來自 CPMM 池、CLMM 位置 NFT 鑄幣還是無關的 SPL 代幣。農場程式將質押鑄幣視為不透明。
• 沒有預言機依賴。 定價是鏈上儲備。沒有 Pyth/Switchboard 後備；AMM 在清算前不檢查預言機。

​

指針

• protocol-overview/architecture — 顯示這些部分如何組合的規範圖。
• protocol-overview/versions-and-migration — 約定如何在程式版本中演變。
• security/admin-and-multisig — 誰控制 AmmConfigs 後面的密鑰。
• reference/fee-comparison — 每個產品的費率矩陣。
• reference/program-addresses — 規範程式 ID。

• Raydium SDK v2 — PDA 種子、帳戶佈局和 IDL 定義的真實來源。
• Raydium IDL 註冊表 — Anchor IDL。
• 上面內聯引用的每個產品帳戶頁面。