Cơ sở hạ tầng dùng chung

​

”Dùng chung” có nghĩa gì ở đây

• Chia sẻ quy ước. Mọi chương trình đều sử dụng cùng một mẫu dẫn xuất PDA, cùng một hình dạng phân chia phí và cùng một ý tưởng tài khoản quan sát — nhưng mỗi chương trình triển khai chúng trong chương trình riêng của mình với các seed riêng.
• Chia sẻ tài khoản. Một số tài khoản là chính xác cùng một bản ghi trên nhiều pool (PDA quyền toàn cầu trong CPMM, các tài khoản AmmConfig).
• Chia sẻ ngoài chuỗi. Một REST API và một SDK TypeScript phục vụ cả bốn chương trình. Những người tích hợp tương tác với một máy chủ HTTP và một gói NPM bất kể chương trình nào mà họ cuối cùng gọi.

​

1. PDA quyền

• Đối với CPMM và CLMM, PDA quyền là một tài khoản toàn cầu — mọi pool loại đó đều sử dụng nó. Nếu bạn đang CPI vào CPMM, bạn cần nó một lần, không phải cho mỗi pool.
• Đối với các quyền cho mỗi pool / mỗi farm, bạn dẫn xuất PDA từ ID pool/farm. SDK làm điều này trong getPoolKeys / getFarmKeys; nếu bạn đang tích hợp trực tiếp, bạn dẫn xuất với findProgramAddressSync.
• Quyền sở hữu kho không thể thay đổi. Khi một tài khoản token được tạo với PDA quyền làm chủ sở hữu, chỉ PDA đó — được gọi bởi chương trình — mới có thể chuyển ra. Không có ghi đè quản trị viên.

​

2. Tài khoản quản trị viên và cấu hình

// CPMM AmmConfig (rút gọn — phiên bản CLMM có cấu trúc tương tự)
pub struct AmmConfig {
    pub bump: u8,
    pub disable_create_pool: bool,        // gate new pool creation in this tier
    pub index: u16,                       // tier index
    pub trade_fee_rate: u64,              // fraction of trade going to fees
    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,             // one-time per-pool creation fee
    pub protocol_owner: Pubkey,           // signer for CollectProtocolFee
    pub fund_owner: Pubkey,               // signer for CollectFundFee
    pub padding: [u64; 16],
}

• Các tầng phí là toàn cầu. Khi một pool nói “đây là một pool 0,25%”, nó có nghĩa là nó liên kết với AmmConfig có trade_fee_rate là 0,25% tại thời điểm tạo. Không có ghi đè tỷ lệ cho mỗi pool.
• Một cấu hình có thể thay đổi nhưng các pool không theo. Nếu cơ quan cấu hình chỉnh sửa AmmConfig, mọi pool hiện có liên kết với cấu hình đó sẽ nhận tỷ lệ mới ngay lập tức. Đây là một tính năng, không phải một lỗi; đây là cách những thay đổi kinh tế ở cấp độ giao thức lan truyền mà không cần di chuyển cho mỗi pool.
• disable_create_pool là đòn bẩy loại bỏ. Khi một tầng phí bị loại bỏ, multisig giao thức đặt cờ này — các pool hiện có tiếp tục hoạt động nhưng không có pool mới nào có thể chọn tầng đó.
• protocol_owner / fund_owner là những người ký cho các lệnh gọi thu phí. Đặt chúng thành multisig là cách để gating rút phí. Chúng KHÔNG phải là địa chỉ đích cho chính các phí; đó là protocol_fee_destination / fund_fee_destination trên cùng tài khoản.

​

3. Phân chia phí giao thức / quỹ / người tạo

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

1. Phí giao dịch tích lũy vào pool. Phí được loại bỏ khỏi phía đầu vào của swap và số tiền sau phí là những gì toán học sản phẩm hằng số thấy. Đây là ý nghĩa của “LP kiếm phí” — k tăng lên và giá trị token ngụ ý trên mỗi LP cũng vậy.
2. Các phần giao thức/quỹ/người tạo được khấu trừ từ tích lũy phía LP đó vào các tài khoản bộ đếm cho mỗi pool. Chúng nằm trên trạng thái pool (protocol_fees_token{0,1}, fund_fees_token{0,1}, v.v.) cho đến khi ai đó gọi lệnh thu thập tương ứng. Chúng không rời khỏi các kho của pool cho đến lúc đó; từ quan điểm của swap, chúng vẫn “trong pool”.
3. Thu thập di chuyển chúng ra. Các đường dẫn giao thức và quỹ yêu cầu người ký protocol_owner / fund_owner tương ứng từ AmmConfig. CPMM sử dụng các phí người tạo hoặc đường dẫn CollectCreatorFee được ký bởi người tạo hoặc CollectCreatorFeePermissionless, mà bất kỳ người trả tiền nào cũng có thể kích hoạt nhưng cố định các điểm đích thành ATA chính tắc của người tạo.

• Các phần trăm phân chia là ngoài phí giao dịch, không phải ngoài giao dịch. Phí giao dịch 0,25% với cổ phần giao thức 12% có nghĩa là giao thức nhận 0,25% × 12% = 0,03% của giao dịch — không phải 12% của giao dịch.
• Phí người tạo chỉ tồn tại trên các pool đã tốt nghiệp LaunchLab. Các pool CPMM/CLMM tiêu chuẩn có phân chia ba chiều (LP / giao thức / quỹ). LaunchLab thêm một khe thứ tư được định tuyến cho bất kỳ ai đã phát hành token, được cấu hình tại Initialize và bất biến.
• AMM v4 chỉ chia hai chiều, được mã hóa cứng cho mỗi pool: LP và giao thức. Không có khe quỹ, không có khe người tạo.
• Quỹ so với giao thức — cả hai đều là điểm đích kho giao thức, nhưng chúng có những người ký khác nhau và những mục đích sử dụng khác nhau. protocol về mặt lịch sử tài trợ hoạt động; fund là kho dài hạn hơn. Phân chia giữa hai cái này chính nó là có thể điều chỉnh được.

​

4. Tài khoản quan sát (vòng đệm TWAP)

// CPMM ObservationState (rút gọn)
pub struct ObservationState {
    pub initialized: bool,
    pub observation_index: u16,            // next slot to overwrite
    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,  // sum of (price × dt) since init
    pub cumulative_token_1_price_x32: u128,
}

• Mỗi swap gọi update_observation. Chương trình đọc giá hiện tại, nhân với số giây trôi qua kể từ quan sát trước đó, và thêm nó vào bộ đếm tích lũy. Mục nhập mới ghi đè khe cũ nhất (kiểu vòng đệm).
• TWAP trên một cửa sổ = (cumul[end] − cumul[start]) / (timestamp[end] − timestamp[start]). Người tiêu dùng chọn hai quan sát ngoặc cửa sổ mong muốn và chia.
• Raydium chính nó không sử dụng TWAP để định giá. Toán học AMM đọc các dự trữ spot trực tiếp. Quan sát là một tính ngoại tại — Raydium trả chi phí viết chúng để các hợp đồng khác có thể đọc.
• AMM v4 không có tài khoản quan sát. Nó cũ hơn thiết kế ObservationState; những người tích hợp muốn TWAP v4 phải tính toán một cái ngoài chuỗi từ lịch sử nhật ký.

​

5. REST API + SDK + IDL

• REST API — https://api-v3.raydium.io. Một chế độ xem được lập chỉ mục chủ yếu đọc của tất cả trạng thái trên chuỗi cộng với một công cụ báo giá. Một máy chủ, một lược đồ.
• TypeScript SDK — @raydium-io/raydium-sdk-v2 trên NPM. Xây dựng và ký giao dịch cho mọi chương trình. Nói chuyện với API để lấy báo giá/siêu dữ liệu, nói chuyện với Solana RPC để làm mới trạng thái trước ký.
• Đăng ký IDL — Anchor IDL cho mọi chương trình được xuất bản nằm trong kho raydium-idl (một JSON cho mỗi chương trình: CPMM, CLMM, LaunchLab). SDK TypeScript tiêu thụ các IDL này nội bộ; các khách hàng Rust / Python hạ lưu tái tạo từ các tệp tương tự.

​

6. Indexer và nguồn cấp giá

• Indexer là thứ duy nhất “biết về” trạng thái liên chương trình. Ánh xạ một pool CPMM tới đối tác CLMM của nó, tính toán một số khối lượng 24h trên các phiên bản chương trình, nhận một farm liên kết với một mint LP — tất cả đều là công việc indexer. Các chương trình chính nó không làm điều đó.
• Thời gian chết của indexer là thời gian chết của API. Nếu API trả về dữ liệu cũ hoặc trống, indexer là nghi phạm. Trạng thái trên chuỗi không bị ảnh hưởng; những người tích hợp có RPC và SDK riêng của họ có thể tiếp tục giao dịch.

​

Cái gì không được chia sẻ

• Các chương trình không gọi nhau. Một swap CPMM không bao giờ CPI vào CLMM hoặc AMM v4. Chương trình duy nhất soạn nhiều AMM là chương trình AMM Routing — và chương trình đó chính nó là mỏng, chỉ phát ra CPI vào mỗi AMM theo thứ tự.
• Không có cơ quan nâng cấp dùng chung trên các chương trình. Mỗi chương trình trên chuỗi có khóa nâng cấp chương trình riêng của nó (multisig 3/4 cộng với timelock 24h). Chúng không được liên kết.
• Không có trạng thái dùng chung giữa farm và AMM. Một farm không biết LP nào mà nó stake là từ một pool CPMM, một CLMM-position-NFT-mint, hay một token SPL không liên quan. Chương trình farm coi mint staking là mờ.
• Không có phụ thuộc oracle. Định giá là dự trữ trên chuỗi. Không có dự phòng Pyth/Switchboard; AMM không kiểm tra oracle trước khi xóa.

​

Con trỏ

• protocol-overview/architecture — sơ đồ chính tắc cho thấy cách các phần này soạn.
• protocol-overview/versions-and-migration — cách các quy ước phát triển trên các phiên bản chương trình.
• security/admin-and-multisig — ai kiểm soát các khóa đằng sau AmmConfigs.
• reference/fee-comparison — ma trận tỷ lệ phí cho mỗi sản phẩm.
• reference/program-addresses — ID chương trình chính tắc.

• Raydium SDK v2 — nguồn sự thật cho các seed PDA, bố cục tài khoản và định nghĩa IDL.
• Đăng ký Raydium IDL — Anchor IDL.
• Các trang tài khoản theo từng sản phẩm được trích dẫn nội tuyến ở trên.