Blueprint de Integrações DeFi
Integrações DeFi na Solana são padrões para compor liquidez, crédito, recibos de stake, preços e derivativos através de listas explícitas de contas e invocações entre programas (CPIs). Uma vez que você mapeia AMMs, roteamento Jupiter, empréstimos, LSTs, oráculos, perps e Jito/MEV como um único gráfico de composabilidade, o design do produto se torna "quais programas, quais contas, quais modos de falha", e não um monte de SDKs não relacionados.
Noções Básicas de DeFi na Solana é a entrada prática; AMMs (Raydium, Orca, Meteora), Empréstimos e Pedidos, Staking Líquido (LSTs), Oráculos e Jito & MEV cada um se aprofunda em uma superfície. Esta página fica abaixo: como a pilha DeFi se encaixa para os desenvolvedores.
Resumo
- DeFi na Solana é um gráfico de composabilidade: contas de token SPL, programas de pool e mercado, oráculos de preço e caminhos de inclusão (taxas e MEV) que seu cliente ou programa deve nomear, validar e sequenciar em uma transação atômica, quando possível.
- Por que Importa: Quase toda funcionalidade de produto que move valor (swap, depósito, empréstimo, liquidação, rebalanceamento) é um problema de integração: contas erradas, cotações desatualizadas, frescor incorreto do oráculo ou estratégia de dica ausente falham em produção, mesmo quando a matemática está correta.
- Conceitos-Chave: Pools AMM, agregadores (Jupiter), mercados de dinheiro, LSTs, contas de preço de oráculo, perps / CLOBs, cadeias de CPI, slippage e fatores de saúde, taxas de prioridade vs. dicas Jito.
- Quando Usar: Projetando um swap de carteira, cofre, loop de alavancagem, rebalanceamento de tesouraria, bot liquidante ou qualquer programa que faça CPI na liquidez e nos trilhos de risco do ecossistema.
- Limitações / Trade-offs: Rotas e layouts de pool mudam; oráculos e mercados podem pausar; limites de CU e de conta restringem CPIs de múltiplos saltos; MEV pode extrair valor do fluxo desprotegido; cada local adiciona risco de ID de programa e versão de layout.
- Tópicos Relacionados: Noções básicas de DeFi, AMMs, swaps Jupiter, empréstimos, LSTs, oráculos, Jito e MEV, perps e livros de ofertas.
Fundamentos
Solana não envia uma única "VM DeFi". Ela envia um runtime que move lamports e bytes de propriedade do programa sob regras de escrita do proprietário, mais programas que interpretam esses bytes como pools, bancos, recibos de stake e livros de ofertas. Integração significa falar corretamente os layouts de instrução e os gráficos de conta desses programas.
Cada saldo durável ainda é uma conta de token SPL (ou nativa / embrulhada SOL). Posições DeFi adicionam mais contas: cofres de pool, PDAs de obrigação, mints de LST, contas de margem, feeds de oráculo. Clientes e programas devem declarar essas contas para que o Sealevel possa bloqueá-las e as CPIs possam passá-las pela pilha.
Pense no mapa do desenvolvedor como camadas, da intenção do usuário à inclusão:
Intenção do usuário (swap, emprestar, alavancar, proteger)
|
v
+--------------------------------------+
| Agregadores / roteadores (ex: Jupiter) | plano de rota opcional off-chain
+--------------------------------------+
| Programas de venue: AMM / CLOB / perps / |
| lending / stake pools | estado on-chain + CPI
+--------------------------------------+
| Oráculos (Pyth, Switchboard, ...) | entradas de preço e risco
+--------------------------------------+
| Programa de Token + ATAs / cofres | custódia de saldos
+--------------------------------------+
| Inclusão: taxas de prioridade, dicas Jito | aterrissagem sob contenção
+--------------------------------------+AMMs (Raydium, Orca, Meteora e similares) detêm reservas ou liquidez concentrada e precificam swaps por matemática de curva ou tick. Jupiter fica acima de muitos deles: cota off-chain e retorna uma rota para que você não precise manter o gráfico de todos os pools. Empréstimos (Kamino, MarginFi e similares) mapeiam colateral e dívida para saúde e liquidações. LSTs (jitoSOL, mSOL e similares; frequentemente roteamento estilo Sanctum) embrulham SOL staked em reivindicações fungíveis para colateral e loops. Oráculos publicam contas de preço que você trata como entradas com limite de tempo. Perps e livros de ofertas adicionam posições, correspondência e regras de marcação/financiamento. Jito e caminhos MEV decidem se o fluxo de múltiplas pernas aterrissa atomicamente e quem captura valor de sandwich ou arb.
A regra: seu produto é dono da composição. Cada perna é uma CPI validada ou uma lista de instruções construída pelo cliente; a atomicidade significa que uma transação é bem-sucedida ou nenhuma o é, até que você deliberadamente faça transações múltiplas e aceite estado parcial.
Mecânicas e Interações
Tokens e ATAs primeiro
Antes de qualquer swap ou depósito, resolva os mints, decimais e ATAs para o usuário e saltos intermediários. ATAs ausentes são um bug comum "funciona em testes, falha na carteira". O wrap/unwrap de SOL é de primeira classe; trate wSOL como um mint com criação/fechamento, não lamports flutuantes dentro de cada pool.
Carteira (propriedade do sistema)
|
+--> ATA(mint_in) --transferência/CPI--> cofres do pool/usuário
+--> ATA(mint_out) <--recebe---------- programa do venueAMMs: liquidez direta
O trabalho direto com AMM se encaixa em depósito/saque de LP, roteamento personalizado ou swaps CPI on-chain sem um agregador. Valide o ID do programa, os mints do pool e os endereços dos cofres antes da CPI de transferência. Veja AMMs (Raydium, Orca, Meteora).
A intuição do produto constante ajuda, mas a liquidez de produção é frequentemente concentrada ou dinâmica. Atualize o estado do pool no momento da construção e aplique slippage (mínimo a receber / máximo a pagar).
Jupiter: swaps agregados
Swaps com Jupiter é o caminho padrão do produto: cota → tx de swap → assinar com @solana/kit. Os deveres permanecem: fixar bps de slippage, lidar com wrap SOL, simular, re-cotar em caso de falha. Não codifique rotas fixas para sempre; a liquidez migra.
Use Jupiter para o melhor preço e baixa manutenção. Use CPIs AMM diretas quando seu programa deve controlar o caminho, a custódia ou o skim de taxas dentro de uma única pilha.
Empréstimos: colateral, dívida, saúde
Mercados de dinheiro transformam depósitos em oferta e permitem empréstimos sob um fator de saúde: deposite colateral, opcionalmente pegue emprestado, monitore a saúde e projete para liquidantes. Loops de alavancagem são empréstimos + AMM/Jupiter, não um recurso de cadeia separado. Planeje a dependência de oráculos e picos de utilização. Detalhes: Empréstimos e Pedidos.
LSTs: SOL gerador de rendimento como um token
Um LST é geralmente um mint SPL cuja taxa rastreia SOL staked (menos taxas do provedor). Isso desbloqueia colateral e saída mais rápida do mercado, além de risco de contrato, liquidez e desvalorização. Superfícies: mint/resgate, swaps LST, colateral com cortes de oráculo. Veja Staking Líquido (LSTs).
Oráculos: a espinha dorsal do risco
Qualquer empréstimo, liquidação ou financiamento que dependa do valor em USD deve ler um feed de preço, impor idade máxima, confiança e ID de feed correto. Pyth e Switchboard ainda exigem verificações de falha fechada para contas desatualizadas ou incorretas.
ação de risco --> carregar feed --> idade/conf OK? --> converter unidades --> LTV ou min-out
|
falha fechada se desatualizado ou feed incorretoNão use o preço spot do último swap do pool como o oráculo de risco para crédito subcolateralizado. Veja Oráculos.
Perps e livros de ofertas
CLOBs e perps otimizam para prioridade de preço-tempo, limites e alavancagem. Os gráficos de conta crescem (mercado, ordens, posições, cofres). Preenchimentos parciais diferem dos swaps de preço único AMM. Prefira-os quando a experiência do limite ou os modelos de derivativos superam os swaps de curva. Veja Perps & Livros de Ofertas.
Jito, MEV e aterrissagem
DeFi de múltiplas pernas compete em inclusão e ordenação. Taxas de prioridade licitam via preço de unidade de computação. Pacotes e dicas Jito são um caminho paralelo através dos motores de bloco.
Caminho A: tx única + preço de CU --> agenda pública do líder
Caminho B: pacote + dica --> motor de bloco --> líderLimite o slippage, considere pacotes para fluxo tóxico e não confunda dicas com taxas de prioridade do Orçamento de Computação. Veja Jito & MEV.
Como as peças interagem em um fluxo de produto único
Exemplo: exposição alavancada a LST.
- Verifique os saldos; crie ATAs ausentes.
- Jupiter ou CPI AMM: SOL → LST, se necessário.
- CPI de empréstimo: deposite LST (precificado por oráculo).
- Pegue emprestado stablecoin sob regras de saúde.
- Swap opcional secundário implanta ativos emprestados.
- Aterrissagem com limite de CU, taxa de prioridade, dica Jito opcional.
- Monitore a saúde para liquidações.
O blueprint está completo quando você pode nomear o programa por perna, as contas graváveis, os portões de oráculo e como a inclusão é comprada.
Considerações Avançadas e Aplicações
Falhas de DeFi em produção ocorrem menos por álgebra e mais por gráficos de conta, versionamento e contenção. Combine a profundidade com a superfície.
| Caminho | O que você integra | Pontos Fortes | Pontos Fracos | Melhor ajuste |
|---|---|---|---|---|
| Swaps apenas com Jupiter | API de cota/swap + kit | Lançamento rápido; multi-venue | Dependência off-chain | Carteiras, rebalanceamento |
| CPI AMM Direta | Contas de pool + ix | Controle on-chain; LP | Mudança de layout | Cofres, roteadores personalizados |
| Empréstimos + oráculo | Bancos, obrigações, feeds | Crédito e alavancagem | Risco de liquidação / pausa | Mercados de dinheiro, loops |
| Pilha de colateral LST | Pools + empréstimos + oráculos | Colateral gerador de rendimento | Risco de desvalorização, provedor | Tesouraria e loops |
| Perps / CLOB | Mercado + posições | Limites; derivativos | Latência e custo operacional | Locais de negociação, hedges |
| Aterrissagem ciente de MEV | Dicas, pacotes, taxas | Melhores taxas de aterrissagem atômica | Infraestrutura extra | Liquidantes, arbs, tamanho |
Limites de CU e de conta limitam os saltos por transação. Divida apenas com recuperação: se a perna 1 aterrissa e a perna 2 falha, a UX deve lidar com estado parcial.
Upgrades de programa alteram discriminadores e contas restantes. Fixe versões de IDL/SDK e teste transações reais em produção em atualizações.
Contas quentes serializam gravadores sob carga. Taxas, dicas, simulação e hashes de bloco recentes fazem parte da integração DeFi, não apenas da "infraestrutura".
Segurança para integradores: verifique IDs de programas externos, restrinja contas de oráculo/pool fornecidas pelo cliente, aplique slippage e saúde on-chain ao fazer CPI, e documente autoridades de pausa/atualização do venue.
Para revisões de design: intenção → gráfico de instruções, custódia por mint, política de oráculo, limites de slippage/saúde, estratégia de aterrissagem e qual artigo irmão detém o mergulho profundo.
Equívocos Comuns
- "DeFi é um protocolo que integro uma vez." É um gráfico de programas e contas de token independentes; cada aresta é uma superfície de validação e falha separada.
- "Jupiter substitui o entendimento de AMMs." Agregadores ocultam a seleção de pool para swaps; LP, CPI personalizado e depuração de incidentes ainda exigem conhecimento do venue.
- "Se a cotação parecer boa, o swap on-chain é seguro." Cotações envelhecem; sem limites de slippage e simulação, os preenchimentos podem falhar ou piorar entre a construção e a aterrissagem.
- "O preço spot do pool é suficiente para risco de empréstimo." Crédito subcolateralizado precisa de oráculos robustos com verificações de frescor e confiança, não apenas o preço do último swap.
- "LSTs são rendimento gratuito sem custo de integração." Eles adicionam fluxos de mint/resgate, cortes de oráculo e cenários de desvalorização além da economia de staking.
- "Taxa de prioridade e dica Jito são o mesmo campo." O preço da CU é Orçamento de Computação; dicas e pacotes usam mecanismos de inclusão separados.
- "Estratégia atômica multi-venue sempre cabe em uma transação." Limites de conta e CU forçam designs multi-tx que precisam de tratamento explícito de falha parcial.
- "SDKs de cliente removem a necessidade de verificar proprietários de conta." Programas on-chain ainda devem restringir IDs de programa e relacionamentos de chave; clientes podem estar errados ou hostis.
FAQs
Qual é a ideia mais importante na integração DeFi da Solana?
Componha programas externos através de contas explícitas e CPIs (ou listas de instruções construídas pelo cliente), e trate oráculos, slippage, saúde e inclusão como requisitos de produto de primeira classe, não como reflexões tardias.
Quando devo usar Jupiter em vez de integração AMM direta?
Use Jupiter para swaps de usuário com melhor preço e rebalanceamentos simples sem manter gráficos de pool. Use caminhos AMM diretos para gerenciamento de LP, CPI on-chain estritamente controlada ou recursos específicos do venue que os agregadores não expõem.
Quais contas um swap típico toca?
Contas de token do usuário (entrada/saída), ATAs intermediários se multi-salto, contas de pool ou de rota, Programa de Token, às vezes Programa do Sistema para criação/wrap de ATA ou SOL, e contas de orçamento de computação para taxas.
Como os protocolos de empréstimo se relacionam com os AMMs?
Eles são programas separados. Estratégias de alavancagem e cofres frequentemente fazem CPI ou sequenciam ambos: pegue emprestado de um mercado de dinheiro, troque em um AMM ou via Jupiter, e então deposite novamente.
Por que LSTs aparecem com tanta frequência em DeFi na Solana?
Eles transformam SOL staked em um saldo SPL transferível que os mercados aceitam como colateral ou liquidez, permitindo loops geradores de rendimento sem a experiência de conta de stake nativa em cada salto.
O que toda integração de oráculo deve impor?
Conta de feed correta, limite de idade do preço, verificações de confiança ou status, e conversão de unidade (expo, decimais) antes de qualquer matemática sensível ao risco.
Como uma integração CLOB difere de um swap AMM?
CLOBs usam contas de ordem e posição com semântica de colocar/cancelar/combinar e frequentemente requisitos de latência mais apertados; AMMs geralmente precificam a partir do estado do pool em uma única instrução de estilo de swap.
Quando preciso de pacotes Jito?
Quando estratégias atômicas de múltiplas transações, liquidações ou fluxos sensíveis a ordens de alto valor precisam de melhor inclusão e ordenação do que apenas as taxas de prioridade do mempool público fornecem.
Meu programa Anchor pode fazer CPI no Jupiter?
Muitos produtos constroem transações Jupiter off-chain com kit. CPI de agregador puramente on-chain é especializada e sensível à versão; prefira interfaces de venue conhecidas quando você precisar fazer CPI de um programa.
O que falha primeiro sob carga na rede principal?
Cotações desatualizadas, CU insuficiente, contas graváveis ausentes, contenção de conta quente e taxas ou dicas subprecificadas - mais frequentemente do que bugs de matemática pura.
Como devo lidar com SOL vs wSOL?
Decida a política de wrap com antecedência. Muitos venues querem ATAs wSOL: crie, financie, use e feche contas temporárias para que os usuários não fiquem com poeira ou transferências falhadas.
O que é um fator de saúde em uma frase?
A proporção do protocolo de colateral com corte de preço de oráculo para dívida; abaixo do limite, a posição é liquidável.
Preciso de um indexador para produtos DeFi?
RPC e kit são suficientes para saldos atuais e transações únicas. Histórico, PnL, scanners de liquidantes e métricas operacionais precisam de eventos indexados analisados.
Como versionar integrações entre atualizações de venue?
Fixe SDKs/IDLs, teste transações reais em produção, restrinja alterações de contas restantes atrás de versões de cliente e monitore as autoridades de atualização das quais você depende.
Qual é uma lista de verificação de integração prática antes do lançamento?
Mapeie mints e ATAs, nomeie IDs de programas externos, defina a política de oráculo e slippage/saúde, simule transações completas, defina a estratégia de CU e taxa/dica, documente a recuperação de falha parcial e assuma a responsabilidade pela resposta de atualização do venue.
Relacionados
- Noções Básicas de DeFi na Solana - exemplos práticos de entrada em toda a superfície DeFi
- AMMs (Raydium, Orca, Meteora) - layouts de pool, LP e swaps CPI diretos
- Empréstimos e Pedidos - mercados de dinheiro, colateral e saúde
- Staking Líquido (LSTs) - jitoSOL, mSOL, fluxos LST estilo Sanctum
- Oráculos - Pyth, Switchboard, frescor e leituras de risco
- Jito & MEV - pacotes, dicas e aterrissagem ciente de MEV
Versões da pilha: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, Rust 1.91.1 e @solana/kit 7.0.0.