Tổng quan về Farm / Staking

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Farm là gì

• Dựa trên phát hành, không dựa trên phí. Khác với các luồng reward tích hợp trong CLMM, phần thưởng farm không liên kết với khối lượng swap hoặc hoạt động pool. Ngân sách của farm được ký gửi trước bởi người tạo và phát hành với tốc độ không đổi mỗi giây cho đến khi hết.
• Độc lập với pool. Pool không biết farm tồn tại. Di chuyển LP giữa các ví không thông báo cho farm; người dùng phải chủ động Withdraw từ farm trước. Tương tự, Withdraw từ pool không withdraw từ farm.
• Sổ cái per-user, per-reward. Mỗi người staking có một tài khoản UserStake (hoặc “Ledger”) per farm theo dõi số lượng staked của họ và snapshot của bộ đếm reward-per-share cho mỗi luồng reward của farm.
• Hỗ trợ nhiều reward. Farm v5 hỗ trợ tối đa 2 reward; v6 hỗ trợ tối đa 5. Mỗi reward có vault, tốc độ per-second, thời gian bắt đầu và thời gian kết thúc riêng.

​

Ba phiên bản đang hoạt động

​

Accounting reward-per-share

reward_per_share := total_rewards_distributed_by_stream / total_staked
pending(user)    := user.staked × (reward_per_share − user.reward_debt)

• reward_per_share được lưu trữ trên tài khoản farm như một bộ đếm fixed-point (Q64.64 trong v5+, Q56.8 trong v3). Nó chỉ phát triển.
• user.reward_debt là snapshot của reward_per_share tại lần tương tác cuối cùng của người dùng. Nó không phải là khoản nợ mà người dùng phải trả; nó là một offset dùng để tính toán các accrual trong tương lai.
• Khi Deposit và Withdraw, farm trước tiên giải quyết pending rewards (ghi có user.pending_reward hoặc gửi trực tiếp đến ATA của người dùng, tùy phiên bản), sau đó cập nhật user.reward_debt lên bộ đếm hiện tại.
• Khi Harvest, farm thanh toán pending_reward và snapshot reward_debt lại.

elapsed        := min(now, reward.end_time) − reward.last_update_time
new_emissions  := reward.per_second × elapsed
if total_staked > 0:
    reward_per_share += new_emissions / total_staked
reward.last_update_time := now

​

Staking mint vs reward mint

​

Lịch phát hành

• start_time — UNIX timestamp khi phát hành bắt đầu. Trước đó, không có accrual.
• end_time — timestamp khi phát hành dừng. Sau đó, reward_per_share không còn phát triển từ luồng này.
• per_second — tốc độ phát hành khi start_time ≤ now < end_time.

​

Farm không phải là gì

• Không phải là bộ phân phối phí. CPMM và CLMM thu phí giao dịch trực tiếp vào pool state. Farm không chạm vào pool fees. Đường duy nhất từ pool fees đến token holder là LP-redemption hoặc CLMM’s CollectFee.
• Không phải là tự động. LP phải được stake rõ ràng để kiếm farm rewards. Những người nắm giữ LP để token ở ví của họ không kiếm được gì từ farm.
• Không có thể trao đổi được. Mỗi tài khoản UserStake được liên kết với một cặp (farm, user). Bạn không thể chuyển stake của mình sang ví khác mà không unstake trước.
• Không tương thích trực tiếp với vị trí CLMM. Farm v6 giới thiệu một CLMM adapter, nhưng trong thực tế các pool CLMM sử dụng các luồng reward tích hợp của riêng chúng (xem products/clmm/fees) thay vì phát hành farm.

​

Khi nào farm là công cụ phù hợp

• Khuyến khích LP cho một trong các pool CPMM hoặc AMM v4 của dự án của bạn bằng một token bên ngoài (token dự án của bạn, token của đối tác, v.v.).
• Chạy một chương trình staking trên một mint single-asset (staking RAY kinh điển, kiếm RAY) mà không triển khai hợp đồng của riêng bạn.
• Thêm các reward bổ sung lên trên một pool hiện có mà không cần quyền admin cho pool đó.

​

Nội dung chương

• accounts — layout on-chain state đầy đủ per phiên bản.
• instructions — mọi lệnh farm với danh sách tài khoản và điều kiện pre/postcondition.
• code-demos — ví dụ TypeScript cho staking, harvesting, và tạo một farm mới.

​

Tiếp theo là gì

• products/clmm/fees — so sánh phát hành farm với mô hình reward tích hợp của CLMM.
• reference/program-addresses — ba farm program IDs.
• protocol-overview/versions-and-migration — khi nào sử dụng từng phiên bản farm.

• Farm v6 IDL được đóng gói trong SDK: raydium-io/raydium-sdk-V2 dưới src/raydium/farm/.
• Raydium SDK v2 Farm module