Swapping sol to 2z
Revise o Aviso Legal antes de acessar ou usar o código ou quaisquer materiais relacionados.
Aviso Legal
Este documento e o código associado são fornecidos apenas para fins informativos e técnicos. A funcionalidade de conversão de tokens descrita neste documento é não-custodial—os utilizadores interagem diretamente com os contratos inteligentes subjacentes e mantêm controlo total dos seus ativos em todos os momentos.
O sistema pode depender de ou interagir com código de terceiros, fontes de dados ou mecanismos de preços e taxas (por exemplo, contratos inteligentes, APIs ou exchanges descentralizadas) que não são desenvolvidos, controlados ou revisados pelo(s) desenvolvedor(es) ou editor(es). Nenhuma representação ou garantia é feita quanto à precisão, funcionalidade ou segurança de qualquer componente de terceiros. O(s) desenvolvedor(es) e editor(es) deste código não garantem a sua precisão, completude ou disponibilidade contínua. O código e os materiais relacionados são fornecidos "como estão" e podem conter bugs, erros ou vulnerabilidades. A utilização é inteiramente por sua conta e risco. O(s) desenvolvedor(es) e editor(es) não recebem quaisquer taxas em conexão com o uso destes contratos. Não têm qualquer obrigação de manter, atualizar ou dar suporte ao código ou à documentação relacionada.
Este documento não constitui uma oferta de venda, uma solicitação de compra, ou uma recomendação para participar em qualquer conversão de tokens, swap ou outra transação. Nenhum aconselhamento jurídico, financeiro ou de investimento é fornecido. Os utilizadores são os únicos responsáveis por determinar a legalidade das suas atividades. Devem rever as leis e regulamentos aplicáveis na sua jurisdição e consultar assessores independentes antes de utilizar o código ou participar em qualquer conversão. A utilização é proibida onde seria ilegal, incluindo por pessoas ou entidades sujeitas a sanções ou em jurisdições restritas.
Na medida máxima permitida por lei, o(s) desenvolvedor(es) e editor(es) rejeitam toda a responsabilidade por qualquer perda, dano ou reclamação decorrente de ou em conexão com o uso do código ou participação na conversão.
A revisão e utilização deste documento e do código associado estão sujeitas aos Termos e Condições do Website e Termos e Condições do Protocolo.
O protocolo DoubleZero cobra receita denominada em SOL dos seus utilizadores validadores, mas distribui recompensas denominadas em 2Z aos contribuidores. Assim, deve converter SOL em 2Z.
Para tal, participantes elegíveis podem negociar contra um contrato de swap do DoubleZero, comprando SOL do contrato e vendendo-lhe 2Z. A precificação é baseada em feeds de preço da Pyth com um mecanismo de desconto programático.
Este breve guia explica como utilizar o programa.
Revise o Aviso Legal no final deste documento antes de acessar ou usar o código ou quaisquer materiais relacionados.
Design do Programa
O programa de swap é efetivamente um pool de liquidez unilateral que vende SOL num tamanho de lote fixo de 1 SOL por negociação. Qualquer participante elegível pode retirar SOL do programa depositando 2Z, a um preço que é determinado por um preço oracle da Pyth e um desconto dinâmico. Ao longo do tempo, isto executa o objetivo do programa de converter tokens nativos em 2Z.
Para utilizar, um trader deve fornecer dois preços recentes da Pyth (SOL/USD e 2Z/USD) e uma quantidade de 2Z. O programa então calcula o 2Z necessário para comprar aquele 1 SOL com base no preço implícito SOL/2Z. Em seguida, executa alguns passos adicionais:
- Verifica que os preços da Pyth são suficientemente recentes, ou seja, não estão desatualizados por mais de 5 segundos.
- Verifica que os intervalos de confiança dos dois preços são suficientemente pequenos. Isto é, a soma de dois desvios padrão de Laplace (ou seja, o parâmetro
confno preço da Pyth) para os dois preços, normalizados pelos seus níveis, deve ser menor ou igual a 30 pontos base. - Ajusta o preço SOL/2Z por um desconto dinâmico, expresso como uma percentagem do preço da Pyth. Este desconto é uma função do tempo desde a última negociação. A fórmula abaixo especifica o desconto, assumindo que a última negociação foi feita no slot \(s_{\text{last}}\) e o slot atual é \(s_{\text{now}}\). (Por exemplo, se 200 slots se passaram desde a última negociação, o desconto é de 40 pontos base.)
Neste ponto, se o trader forneceu 2Z suficiente para executar a transação a este preço calculado (incluindo o desconto), ela é executada a este preço calculado. Devolve ao trader a quantidade comprada de SOL e qualquer excesso de 2Z.
O contrato então não permite mais negociações para aquele slot. Isto serve para evitar que o contrato pague slippage excessivamente alto caso o preço da Pyth esteja longe do preço verdadeiro em qualquer dado momento de formas que os filtros existentes não detetem problemas.
Execução Atómica sem Gas
Esta secção detalha como usar o comando harvest-dz. Este comando executará atomicamente 2 ações.
1. O comando solicita uma cotação da Jupiter vs o programa nativo de conversão SOL <> 2Z.
2. Quando a rota da Jupiter produz mais 2Z por SOL do que o programa de conversão nativo requer, harvest-2z executa um swap, devolvendo à sua carteira 1 SOL mais a diferença em 2Z.
Harvest 2Z
Para executar, execute o seguinte:
doublezero-solana revenue-distribution harvest-2z
Harvested 5.98151278 2Z tokens with 1.000000000 SOL
--dry-run. O dry-run produzirá logs do programa e uma saída semelhante a:
Simulated harvesting 5.98151278 2Z tokens with 1.000000000 SOL
Conversão do Protocolo
Esta secção discute a verificação das taxas de conversão e a execução da conversão usando a CLI doublezero-solana. E no final, discutimos a interface para integrações personalizadas com o contrato de swap do DoubleZero.
Como verificar o preço de conversão SOL/2Z via doublezero-solana
Para encontrar as taxas de conversão SOL/2Z na mainnet-beta, execute o seguinte comando:
doublezero-solana revenue-distribution fetch sol-conversion
E a saída que verá será semelhante a:
| 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 | |
O Journal Balance informa ao utilizador quanta liquidez em SOL existe no contrato inteligente de Distribuição de Receita. Um utilizador pode negociar desde que o Journal Balance exceda o tamanho fixo de negociação de 1 SOL.
A primeira linha exibe o preço de conversão SOL/2Z "verdadeiro" via um oracle offchain. A segunda linha é o preço de conversão usado on-chain para o swap, que simplesmente ajusta o preço verdadeiro pelo desconto algorítmico.
Como converter o seu 2Z para SOL via doublezero-solana
Para converter os seus tokens 2Z para SOL, execute o seguinte comando:
doublezero-solana revenue-distribution convert-2z
Por padrão, se houver liquidez suficiente em SOL e a sua ATA tiver 2Z suficiente para realizar o swap, esta transação terá sucesso. Pode afinar o swap com mais precisão especificando os seguintes argumentos:
--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
O preço limite especificado determina o pior preço que está disposto a aceitar ao realizar a conversão SOL/2Z. Por exemplo, digamos que o preço com desconto de 2Z para SOL é 800, o que significa 800 tokens 2Z por 1 SOL. Se especificar um preço limite de 790, não está disposto a realizar o swap porque está a exigir trocar no máximo 790 tokens 2Z por 1 SOL. Mas se especificar 810, a negociação será executada porque estava disposto a trocar no máximo 810 tokens 2Z (e neste caso, terá trocado apenas 800 tokens 2Z nesta transação).
A conta de tokens 2Z de origem substitui a ATA padrão que usa o signatário como proprietário desta ATA de 2Z. Mas se tiver outra conta de tokens que deseja usar para realizar o swap, forneça a pubkey correspondente com este argumento.
Opcionalmente, pode especificar o montante verificado de SOL para o tamanho de preenchimento padrão (definido como 1 SOL no lançamento). Se não estiver alinhado com o tamanho de preenchimento do programa, o swap falha. Isto mitiga o risco de o tamanho de preenchimento do programa mudar sem que o note.
Interface para Comprar SOL
A interface e a CLI doublezero-solana encontram-se neste repositório. O código-fonte da interface do contrato de swap do DoubleZero pode ser encontrado aqui. O program ID é 9DRcqsJUCo8CL2xDCXpogwzLEVKRDzSyNtVgXqsXHfDs.
Uma forma conveniente de gerar as contas necessárias para a instrução de compra de SOL é usar o método new (encontrado em instruction/account.rs).
pub fn new(
fill_registry_key: &Pubkey,
user_token_account_key: &Pubkey,
dz_mint_key: &Pubkey,
user_key: &Pubkey,
) -> Self;
A fill_registry_key pode ser obtida a partir do 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,
}
Alternativamente, pode chamar getProgramAccounts via Solana RPC com o seu discriminador. Mas recomendamos armazenar em cache esta pubkey, pois nunca mudará.
A user_key é um signatário para a instrução de compra de SOL e deve ser o proprietário da user_token_account_key. Como descrito acima, isto NÃO precisa de ser uma ATA. Desde que a sua conta de tokens 2Z seja propriedade da user_key, esta instrução terá sucesso.
A struct BuySolAccounts implementa Into<Vec<AccountMeta>> para que possa gerar todos os account metas necessários para construir a instrução.
Os dados da instrução são
SolConversionInstructionData::BuySol {
limit_price: u64,
oracle_price_data: OraclePriceData,
},
Estes dados de instrução são serializados com Borsh e têm um seletor Anchor de 8 bytes, que serão todos serializados ao usar BorshSerialize::serialize.
Os dados do preço oracle podem ser obtidos neste endpoint público: https://sol-2z-oracle-api-v1.mainnet-beta.doublezero.xyz/swap-rate. Os dados são desserializáveis com serde usando a struct OraclePriceData encontrada em oracle.rs.
#[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,
}
Exemplo de como obter usando a crate 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}"))
}
Com o program ID, as contas e os dados da instrução, deverá conseguir construir a instrução para comprar SOL do contrato de swap do DoubleZero.