Swapping sol to 2z
在访问或使用代码或任何相关材料之前，请先阅读免责声明。
免责声明
本文档及相关代码仅供信息和技术参考之用。本文所述的代币转换功能为非托管性质——用户直接与底层智能合约交互，并始终保留对其资产的完全控制。
本系统可能依赖或与第三方代码、数据源或定价和费用机制（例如智能合约、API 或去中心化交易所）进行交互，这些内容并非由开发者或发布者开发、控制或审查。对于任何第三方组件的准确性、功能性或安全性，不作任何陈述或保证。 本代码的开发者和发布者不保证其准确性、完整性或持续可用性。代码及相关材料按"原样"提供，可能包含错误、缺陷或漏洞。使用风险完全由您自行承担。 开发者和发布者不会因使用这些合约而收取任何费用。他们没有义务维护、更新或支持代码或相关文档。
本文档不构成出售要约、购买邀约或参与任何代币转换、交换或其他交易的建议。本文不提供任何法律、财务或投资建议。 用户应自行负责确定其活动的合法性。用户应审查其所在司法管辖区适用的法律法规，并在使用代码或参与任何转换之前咨询独立顾问。在使用可能违法的情况下（包括受制裁人员或实体或受限司法管辖区），禁止使用。
在法律允许的最大范围内，开发者和发布者对因使用代码或参与转换而产生的或与之相关的任何损失、损害或索赔不承担任何责任。
DoubleZero 协议从其验证者用户处收取以 SOL 计价的收入，但向贡献者分配以 2Z 计价的奖励。因此，协议必须将 SOL 转换为 2Z。
为此，符合条件的参与者可以与 DoubleZero 交换合约进行交易，从合约中购买 SOL 并出售 2Z。定价基于 Pyth 价格源，并具有程序化折扣机制。
本简短指南说明了如何使用该程序。
在访问或使用代码或任何相关材料之前，请先阅读本文档末尾的免责声明。
程序设计
交换程序实质上是一个单边流动性池，以每笔交易 1 SOL 的固定批量出售 SOL。任何符合条件的参与者都可以通过存入 2Z 从程序中提取 SOL，价格由 Pyth 的预言机价格和动态折扣决定。随着时间的推移，这将实现程序将原生代币转换为 2Z 的目标。
要使用该功能，交易者必须提供两个最新的 Pyth 价格（SOL/USD 和 2Z/USD）以及一定数量的 2Z。然后，程序根据隐含的 SOL/2Z 价格计算购买 1 SOL 所需的 2Z 数量。随后，程序还会执行以下几个额外步骤：
- 检查 Pyth 价格是否足够新鲜，即价格延迟不超过 5 秒。
- 检查两个价格的置信区间是否足够小。也就是说，两个价格的两个拉普拉斯标准差（即 Pyth 价格中的
conf参数）之和，经各自价格水平归一化后，必须小于或等于 30 个基点。 - 通过动态折扣调整 SOL/2Z 价格，折扣以 Pyth 价格的百分比表示。该折扣是自上次交易以来经过时间的函数。以下公式指定了折扣，假设上次交易在时隙 \(s_{\text{last}}\) 进行，当前时隙为 \(s_{\text{now}}\)。（例如，如果自上次交易以来已过去 200 个时隙，则折扣为 40 个基点。）
此时，如果交易者提供了足够的 2Z 以按此计算价格（含折扣）执行交易，则交易将以此计算价格成交。程序会将购买的 SOL 数量和多余的 2Z 返还给交易者。
随后，合约在该时隙内不允许更多交易。这是为了防止合约在任何给定时间点 Pyth 价格远离真实价格时支付过高的滑点，而现有过滤器未能捕获这些问题。
无 Gas 原子执行
本节将详细说明如何使用 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 告知用户收入分配智能合约中有多少 SOL 流动性。只要 Journal Balance 超过 1 SOL 的固定交易规模，用户就可以进行交易。
第一行显示通过链下预言机获取的"真实" SOL/2Z 转换价格。第二行是链上交换使用的转换价格，它只是根据算法折扣对真实价格进行了调整。
如何通过 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 转换时愿意接受的最差价格。例如，假设折扣后的 2Z 对 SOL 价格为 800，即 800 2Z 代币兑换 1 SOL。如果您指定限价为 790，您将不愿意执行交换，因为您要求最多只用 790 2Z 代币兑换 1 SOL。但如果您指定 810，交易将会成交，因为您愿意最多用 810 2Z 代币兑换（在这种情况下，您在此交易中实际只兑换了 800 2Z 代币）。
源 2Z 代币账户会覆盖默认的 ATA（默认使用签名者作为此 2Z ATA 的所有者）。但如果您有其他代币账户想用于执行交换，请通过此参数提供其公钥。
您还可以选择性地将检查的 SOL 数量指定为标准成交规模（启动时设为 1 SOL）。如果该数量与程序的成交规模不一致，交换将失败。这可以降低程序成交规模发生变化而您未注意到的风险。
购买 SOL 的接口
接口和 doublezero-solana CLI 位于此仓库中。DoubleZero 交换合约接口的源代码可在此处找到。Program 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。但我们建议缓存此公钥，因为它永远不会改变。
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 crate 获取的示例：
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}"))
}
有了 Program ID、账户和指令数据，您就能够构建从 DoubleZero 交换合约购买 SOL 的指令。