Swapping sol to 2z
コードまたは関連資料にアクセスまたは使用する前に、免責事項を確認してください。
免責事項
本文書および関連コードは、情報提供および技術的な目的のみで提供されています。本書に記載されているトークン変換機能はノンカストディアルであり、ユーザーは基盤となるスマートコントラクトと直接やり取りし、常に自身の資産を完全に管理します。
本システムは、開発者または公開者が開発、管理、またはレビューしていないサードパーティのコード、データソース、または価格設定および手数料メカニズム（例：スマートコントラクト、API、分散型取引所）に依存する、またはそれらとやり取りする場合があります。サードパーティのコンポーネントの正確性、機能性、またはセキュリティについて、いかなる表明または保証も行いません。 本コードの開発者および公開者は、その正確性、完全性、または継続的な利用可能性を保証しません。コードおよび関連資料は「現状のまま」提供され、バグ、エラー、または脆弱性を含む場合があります。使用は完全に自己責任で行ってください。 開発者および公開者は、これらのコントラクトの使用に関連していかなる手数料も受け取りません。コードまたは関連ドキュメントの保守、更新、またはサポートを行う義務はありません。
本文書は、トークンの変換、スワップ、またはその他の取引への売却の申し出、購入の勧誘、または参加の推奨を構成するものではありません。法的、財務的、または投資に関するアドバイスは提供されません。 ユーザーは、自身の活動の合法性を判断する責任を単独で負います。コードを使用するか、または変換に参加する前に、管轄区域で適用される法律および規制を確認し、独立したアドバイザーに相談する必要があります。制裁対象の個人もしくは団体、または制限された管轄区域を含め、違法となる場合の使用は禁止されています。
法律で許容される最大限の範囲において、開発者および公開者は、コードの使用または変換への参加に起因または関連して生じるいかなる損失、損害、または請求に対する一切の責任を否認します。
本文書および関連コードのレビューおよび使用は、Webサイト利用規約およびプロトコル利用規約に従うものとします。
DoubleZeroプロトコルは、バリデーターユーザーからSOL建ての収益を徴収しますが、コントリビューターには2Z建ての報酬を分配します。そのため、SOLを2Zに変換する必要があります。
これを行うために、適格な参加者はDoubleZeroスワップコントラクトに対してトレードし、コントラクトからSOLを購入して2Zを売却できます。価格設定はPythの価格フィードに基づき、プログラムによる割引メカニズムが適用されます。
この短いガイドでは、プログラムの使用方法を説明します。
コードまたは関連資料にアクセスまたは使用する前に、本文書の末尾にある免責事項を確認してください。
プログラム設計
スワッププログラムは実質的に片側流動性プールであり、1取引あたり1 SOLの固定バッチサイズでSOLを売却します。適格な参加者は誰でも、2Zを預け入れることでプログラムからSOLを引き出すことができ、その価格はPythのオラクル価格と動的割引によって決定されます。時間の経過とともに、これによりネイティブトークンを2Zに変換するというプログラムの目標が達成されます。
利用するには、トレーダーは2つの最新のPyth価格（SOL/USDと2Z/USD）および一定量の2Zを提供する必要があります。プログラムは、暗示されるSOL/2Z価格に基づいて1 SOLの購入に必要な2Z量を計算します。その後、いくつかの追加ステップを実行します：
- Pyth価格が十分に新しいこと、つまり5秒以上古くないことを確認します。
- 2つの価格の信頼区間が十分に小さいことを確認します。具体的には、2つの価格のラプラシアン標準偏差（Pyth価格のパラメータ
conf）の合計を各レベルで正規化した値が30ベーシスポイント以下である必要があります。 - SOL/2Z価格を動的割引で調整します。この割引はPyth価格に対するパーセンテージで表されます。この割引は前回の取引からの経過時間の関数です。以下の式は、前回の取引がスロット\(s_{\text{last}}\)で行われ、現在のスロットが\(s_{\text{now}}\)であると仮定した場合の割引を示しています。（例えば、前回の取引から200スロットが経過した場合、割引は40ベーシスポイントです。）
この時点で、トレーダーが計算された価格（割引込み）で取引を実行するのに十分な2Zを提供している場合、この計算された価格で取引が実行されます。購入したSOL量と余剰の2Zがトレーダーに返されます。
その後、コントラクトはそのスロットでのさらなる取引を許可しません。これは、既存のフィルターが問題を検出できない方法でPyth価格が任意の時点で真の価格から大きく乖離している場合に、コントラクトが過度に高いスリッページを支払うことを防ぐためです。
ガスレスアトミック実行
このセクションでは、harvest-dzコマンドの使用方法を詳しく説明します。このコマンドは2つのアクションをアトミックに実行します。
1. コマンドはJupiterからネイティブSOL <> 2Z変換プログラムと比較した見積もりをリクエストします。
2. Jupiterルートがネイティブ変換プログラムの要求よりもSOLあたりのより多くの2Zを生み出す場合、harvest-2zはスワップを実行し、ウォレットに1 SOLと2Zの差額を返します。
2Zの収穫
実行するには、以下を実行してください：
doublezero-solana revenue-distribution harvest-2z
Harvested 5.98151278 2Z tokens with 1.000000000 SOL
--dry-run引数でシミュレーションすることもできます。ドライランはプログラムログと以下のような出力を生成します：
Simulated harvesting 5.98151278 2Z tokens with 1.000000000 SOL
プロトコル変換
このセクションでは、doublezero-solana CLIを使用した変換レートの確認と変換の実行について説明します。最後に、DoubleZeroスワップコントラクトとのカスタムビルド統合のためのインターフェースについて説明します。
doublezero-solana経由でSOL/2Z変換価格を確認する方法
mainnet-betaでのSOL/2Z変換レートを確認するには、以下のコマンドを実行してください：
doublezero-solana revenue-distribution fetch sol-conversion
表示される出力は以下のようになります：
| field | description | value | note |
|-----------------|------------------------------|---------------|-------------------------------|
| Swap Rate | 2Z amount for 1 SOL | 805.72612992 | |
| Swap Rate | 2Z amount for 1 SOL | 805.38772494 | Includes 0.04200000% discount |
| Journal Balance | SOL available for conversion | 438.670881289 | |
Journal Balanceは、Revenue DistributionスマートコントラクトにどれだけのSOL流動性があるかをユーザーに通知します。Journal Balanceが1 SOLの固定取引サイズを超えている限り、ユーザーは取引できます。
最初の行は、オフチェーンオラクルによる「真の」SOL/2Z変換価格を表示します。2番目の行は、スワップにオンチェーンで使用される変換価格であり、アルゴリズム的割引で真の価格を調整したものです。
doublezero-solana経由で2ZをSOLに変換する方法
2ZトークンをSOLに変換するには、以下のコマンドを実行してください：
doublezero-solana revenue-distribution convert-2z
デフォルトでは、十分なSOL流動性があり、ATAにスワップを実行するのに十分な2Zがある場合、このトランザクションは成功します。以下の引数を指定することで、スワップをより細かく調整できます：
--limit-price <DECIMAL> Limit price defaults to the current SOL/2Z oracle price
--source-2z-account <PUBKEY> Token account must be owned by the signer. Defaults to signer ATA if not specified
--checked-sol-amount <SOL> Explicitly check SOL amount. When specified, this amount will be checked against the fixed fill quantity
指定されたリミット価格は、SOL/2Z変換を実行する際に受け入れるワーストケース価格を決定します。例えば、割引後のSOLに対する2Z価格が800、つまり1 SOLに対して800 2Zトークンだとします。リミット価格を790に指定した場合、1 SOLに対して最大790 2Zトークンのみのスワップを要求しているため、スワップを実行しません。しかし810を指定した場合、最大810 2Zトークンのスワップに同意しているため、取引は成立します（この場合、このトランザクションでは800 2Zトークンのみがスワップされます）。
ソース2Zトークンアカウントは、署名者をこの2Z ATAの所有者として使用するデフォルトのATAを上書きします。ただし、スワップに使用したい別のトークンアカウントがある場合は、この引数でそのpubkeyを指定してください。
オプションとして、チェック済みSOL量を標準フィルサイズ（ローンチ時に1 SOLに設定）に指定できます。プログラムのフィルサイズと一致しない場合、スワップは失敗します。これにより、プログラムのフィルサイズが変更されたのに気づかないリスクを軽減します。
SOL購入インターフェース
インターフェースとdoublezero-solana CLIはこのリポジトリにあります。DoubleZeroスワップコントラクトインターフェースのソースコードはこちらで見つけることができます。プログラムIDは9DRcqsJUCo8CL2xDCXpogwzLEVKRDzSyNtVgXqsXHfDsです。
SOL購入インストラクションに必要なアカウントを生成する便利な方法は、newメソッド（instruction/account.rsにあります）を使用することです。
pub fn new(
fill_registry_key: &Pubkey,
user_token_account_key: &Pubkey,
dz_mint_key: &Pubkey,
user_key: &Pubkey,
) -> Self;
fill_registry_keyはProgramStateから取得できます。
pub struct ProgramState {
pub admin_key: Pubkey,
pub fills_registry_key: Pubkey, // this key
pub is_paused: bool,
pub configuration_registry_bump: u8,
pub program_state_bump: u8,
pub deny_list_registry_bump: u8,
pub withdraw_authority_bump: u8,
pub last_trade_slot: u64,
pub deny_list_authority: Pubkey,
}
あるいは、Solana RPCを通じてディスクリミネーターを指定してgetProgramAccountsを呼び出すこともできます。ただし、このpubkeyは変更されないため、キャッシュすることを推奨します。
user_keyはSOL購入インストラクションの署名者であり、user_token_account_keyの所有者である必要があります。上述のとおり、これはATAである必要はありません。2Zトークンアカウントがuser_keyによって所有されている限り、このインストラクションは成功します。
BuySolAccounts構造体はInto<Vec<AccountMeta>>を実装しているため、インストラクションを構築するために必要なすべてのアカウントメタを生成できます。
インストラクションデータは以下のとおりです。
SolConversionInstructionData::BuySol {
limit_price: u64,
oracle_price_data: OraclePriceData,
},
このインストラクションデータはBorshシリアライズされ、8バイトのAnchorセレクターを持ちます。BorshSerialize::serializeを使用するとすべてシリアライズされます。
オラクル価格データはこのパブリックエンドポイントから取得できます：https://sol-2z-oracle-api-v1.mainnet-beta.doublezero.xyz/swap-rate。データはoracle.rsにあるOraclePriceData構造体を使用してserdeデシリアライズ可能です。
#[derive(Debug, BorshDeserialize, BorshSerialize, Clone, Default, PartialEq, Eq)]
#[cfg_attr(
feature = "serde",
derive(serde::Deserialize),
serde(rename_all = "camelCase")
)]
pub struct OraclePriceData {
pub swap_rate: u64,
pub timestamp: i64,
pub signature: String,
}
reqwestクレートを使用した取得例：
use anyhow::{Context, Result};
pub async fn try_request_oracle_conversion_price(oracle_endpoint: &str) -> Result<OraclePriceData> {
reqwest::Client::new()
.get(oracle_endpoint)
.header("User-Agent", "SOL buyoooooooor")
.send()
.await?
.json()
.await
.with_context(|| format!("Failed to request SOL/2Z price from {oracle_endpoint}"))
}
プログラムID、アカウント、およびインストラクションデータがあれば、DoubleZeroスワップコントラクトからSOLを購入するインストラクションを構築できるはずです。