> ## 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.

# ファーム・スタッキング概要

> Raydium のファーム プログラムがステーカーにリワード トークンを配布する方法 — 1 シェアあたりの会計処理、ファーム バージョン (v3, v5, v6)、および、ファームが隣接する AMM / CLMM プールとどのように関連しているか、そして異なるかについて説明します。

<Info>
  **このページは AI による自動翻訳です。すべての内容は英語版を正とします。**

  [英語版を表示 →](/products/farm-staking/overview)
</Info>

## ファームとは何か

**ファーム** は、スタッキング用トークンをステークするアカウントに 1 つ以上の **リワード ミント** を配布するスタンドアロンのオンチェーン プログラムです。スタッキング用ミントはほぼ常に CPMM、AMM v4、またはレガシー ペア プールで発行された LP トークンですが、単一資産ファーム (SOL、RAY、またはプロジェクト トークンを直接ステーク) もサポートされており、長期実行されている小数のプログラムで使用されています。

主な特性：

* **排出ベース、手数料ベースではない。** CLMM の組み込みリワード ストリームとは異なり、ファーム リワードはスワップ取引量またはプール活動に結びついていません。ファームの予算は作成者によって事前に預託され、なくなるまで一定の秒当たりレートで排出されます。
* **プールとは独立している。** プールはファームが存在することを認識しません。ウォレット間で LP を移動してもファームに通知されません。ユーザーは最初に ファームから明示的に `Withdraw` を実行する必要があります。同様に、プールから `Withdraw` することはファームから引き出すことはありません。
* **ユーザーあたり、リワードあたりの台帳。** 各ステーカーはファーム 1 つあたりの `UserStake`（または「台帳」）アカウントを保有し、ステーク額とファームの各リワード ストリームのシェアあたりリワード カウンターのスナップショットを追跡します。
* **複数リワード対応。** ファーム v5 は最大 2 つのリワードをサポート。v6 は最大 5 つをサポートします。各リワードには独自のボルト、秒当たりレート、開始時刻、終了時刻があります。

## 3 つの運用中バージョン

Raydium は 3 つのファーム プログラム バージョンをリリースしています。すべて運用中であり、各々が独自の PDA スキームと命令セットを持ちます。インテグレーター は、これらを概念モデルを共有する 3 つの異なるプログラムとして扱う必要があります。

| バージョン  | プログラム ID の場所                                                         | 最大リワード数 | 注目すべき相違点                                                                      |
| ------ | -------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------- |
| **v3** | [`reference/program-addresses`](/ja/reference/program-addresses) を参照 | 1       | 最初のスキーマ。最も古いファーム (RAY-USDC、SOL-USDC) は現在でもこれを経由しています。                         |
| **v5** | [`reference/program-addresses`](/ja/reference/program-addresses) を参照 | 2       | 2 番目のリワード スロットと `AddReward` スタイルのトップアップを追加しました。                               |
| **v6** | [`reference/program-addresses`](/ja/reference/program-addresses) を参照 | 5       | 現在のバージョン。スロットを拡張し、管理がシンプルになり、v6 専用アダプターを介した CLMM ポジション ファーミングをサポートします（実際には稀）。 |

SDK は `raydium.farm` を単一のファサードとして公開します — バージョンはファーム アカウントのオーナーから推論されます。オンチェーン インテグレーションを構築する場合は、手動でディスパッチする必要があります。

## シェアあたりのリワード会計処理

ファーム プログラムは DeFi 利回り契約全体で見られる標準的な「マスターシェフ」パターンを使用しています：

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

* **`reward_per_share`** はファーム アカウントに固定小数点カウンター (v5 以降では Q64.64、v3 では Q56.8) として保存されます。これは常に増加します。
* **`user.reward_debt`** はユーザーの最後のインタラクション時の `reward_per_share` のスナップショットです。これはユーザーが負う債務ではなく、将来の見積もりを計算するために使用されるオフセットです。
* `Deposit` および `Withdraw` では、ファームは最初に保留中のリワードを決済し（`user.pending_reward` にクレジットするか、バージョンに応じてユーザーの ATA に直接送信）、その後 `user.reward_debt` を現在のカウンターに更新します。
* `Harvest` では、ファームは `pending_reward` を支払い、`reward_debt` を再度スナップショットします。

秒当たりの排出レートは遅延更新を介した会計に入ります：

```
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
```

遅延：「秒ごと」に命令は発行されません。カウンターはファームに触れるたびに更新されます（`Deposit`、`Withdraw`、`Harvest`、管理者更新）。アクティビティがないファームは次のインタラクションで閉じられる増加するギャップを蓄積します。

## スタッキング用ミント対リワード ミント

**スタッキング用ミントはエスクローで保有され、焼却されません。** ユーザーが 100 LP をステークすると、ファームはユーザーの ATA から 100 LP をファームのステーキング ボルトに移動します。`Withdraw` では、ファームは 100 LP を戻します。ファームはプールを呼び出すことはありません。

**リワード ミントは、作成者によって事前に資金提供されたボルトから支払われます。** 作成者がファームをセットアップするとき、完全なリワード予算（たとえば、1,000,000 RAY + 500,000 USDC）を 2 つのリワード ボルトに預託します。ファーム プログラムは新しいトークンをミントしません。ストリームの期間にわたってボルト内にあるものを配布するだけです。ボルトが `end_time` の前に枯渇した場合、排出は停止します。

## 排出スケジュール

各リワード ストリームには 3 つの時間パラメーターがあります：

* **`start_time`** — 排出が始まる UNIX タイムスタンプ。これ以前は、見積もりはありません。
* **`end_time`** — 排出が停止するタイムスタンプ。その後、このストリームから `reward_per_share` は増加しません。
* **`per_second`** — `start_time ≤ now < end_time` の間の排出レート。

リワードは v5 / v6 で `AddReward` / `SetRewards` を介して拡張できます（`end_time` を前に移動、ボルトをトップアップ）。`RestartRewards` を介して `end_time` の後に再開できます。管理者の協力なしに短縮することはできません。

## ファームではないもの

* **手数料ディストリビューターではない。** CPMM と CLMM はプール状態に直接トレード手数料を収集します。ファームはプール手数料に触れません。プール手数料からトークン ホルダーへの唯一の経路は LP 償還または CLMM の `CollectFee` です。
* **自動ではない。** ファーム リワードを獲得するには、LP を明示的にステークする必要があります。トークンをウォレットに保有している LP ホルダーはファームから何も獲得しません。
* **交換可能ではない。** 各 `UserStake` アカウントは 1 つの `(farm, user)` ペアに結びついています。最初にアンステークしないで別のウォレットにステークを転送することはできません。
* **CLMM ポジションと直接互換性がない。** ファーム v6 は CLMM アダプターを導入しましたが、実際には CLMM プールは独自の組み込みリワード ストリーム（[`products/clmm/fees`](/ja/products/clmm/fees) を参照）を使用し、ファーム排出は使用しません。

## ファームが正しいツールである場合

以下を実行する場合にファームを使用してください：

* プロジェクトの CPMM または AMM v4 プールの 1 つに対して外部トークン（プロジェクト トークン、パートナーのトークンなど）で LP にインセンティブを与える。
* 独自のコントラクトをデプロイすることなく、単一資産ミント上でステーキング プログラム（クラシック「RAY をステーク、RAY を獲得」）を実行する。
* そのプールへの管理者アクセスを必要とせずに、既存のプール上に追加のリワードをレイアウトする。

プールが CLMM である場合は、代わりに CLMM の組み込みリワード ストリームを使用してください。経済的には同等ですが、ポジションのフィー成長内会計に参加し（インレンジ ポジションは必然的に獲得、アウト オブ レンジ ポジションは獲得しない）、ユーザーがポジション NFT を移動する必要はありません。

## チャプターの内容

* [`accounts`](/ja/products/farm-staking/accounts) — バージョンごとの完全なオンチェーン状態レイアウト。
* [`instructions`](/ja/products/farm-staking/instructions) — 各ファーム命令とそのアカウント リスト および前提条件・事後条件。
* [`code-demos`](/ja/products/farm-staking/code-demos) — ステーキング、ハーベスト、および新しいファームの作成に関する TypeScript の例。

## 次のステップ

* [`products/clmm/fees`](/ja/products/clmm/fees) — ファーム排出を CLMM の組み込みリワード モデルと比較します。
* [`reference/program-addresses`](/ja/reference/program-addresses) — 3 つのファーム プログラム ID。
* [`protocol-overview/versions-and-migration`](/ja/protocol-overview/versions-and-migration) — 各ファーム バージョンを使用する時期。

出典：

* ファーム v6 IDL は SDK にバンドルされています：[`raydium-io/raydium-sdk-V2`](https://github.com/raydium-io/raydium-sdk-V2) の `src/raydium/farm/` 下。
* [Raydium SDK v2 `Farm` モジュール](https://github.com/raydium-io/raydium-sdk-V2)