Referência: Um Programa DeFi + dApp

Esta referência de build percorre um pool de empréstimos mínimo: depositar SOL, emitir tokens de participação, sacar com contabilidade pro-rata. Ele une Anchor 0.32.1, testes LiteSVM 0.6.x e um dApp Next.js usando @solana/kit 7.0.0 - a forma como a maioria das equipes de DeFi envia.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

programs/lending/     Programa Anchor (depósito, saque, pausa)
tests/litesvm/        Reprodução de exploração + caminho feliz
app/                  Carteira Next.js + simular + enviar
packages/idl/         IDL publicado + tipos de codegen

Quando usar isso:

• Arquitetura de protocolo DeFi Greenfield
• Integração de engenheiro Solana full-stack
• Linha de base do documento de escopo de auditoria
• Comparando seu layout com uma estrutura conhecida e boa

Exemplo de Trabalho

Programa (Trecho do Anchor 0.32.1)

use anchor_lang::prelude::*;
 
declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
#[program]
pub mod lending {
    use super::*;
 
    pub fn deposit(ctx: Context<Deposit>, amount: u64) -> Result<()> {
        require!(!ctx.accounts.config.paused, LendingError::Paused);
        // transferir SOL para vault; emitir shares para user_position
        Ok(())
    }
}
 
#[account]
pub struct PoolConfig {
    pub admin: Pubkey,
    pub paused: bool,
    pub total_shares: u64,
}

Cliente (Trecho do TypeScript)

import { createSolanaRpc } from "@solana/kit";
import { buildDepositIx } from "@lending/idl-client";
 
const rpc = createSolanaRpc(process.env.NEXT_PUBLIC_RPC_URL!);
 
export async function deposit(amount: bigint, wallet: Wallet) {
  const ix = await buildDepositIx({ amount, user: wallet.publicKey });
  const sim = await rpc.simulateTransaction(await wallet.sign(ix), { sigVerify: true }).send();
  if (sim.value.err) throw new Error(JSON.stringify(sim.value.err));
  return wallet.send(ix);
}

Layout do Repositório

lending-reference/
  programs/lending/src/lib.rs
  tests/litesvm/deposit_withdraw.rs
  app/src/app/pool/page.tsx
  packages/idl/lending.json
  docs/adr/0001-upgradeable-pool.md

O que isso demonstra:

• Guarda de pausa em todas as instruções mutáveis
• Pacote IDL consumido pelo aplicativo Next.js
• Simulação antes do envio voltado para o usuário
• Slot ADR para política de atualização

Mergulho Profundo

Modelo de Conta

Trem de Lançamento

1. anchor test + LiteSVM no PR
2. Implantação em Devnet ao mesclar em main
3. Proposta Squads para mainnet com hash verificável
4. Promoção do frontend quando a versão do IDL corresponder

Armadilhas

• Matemática do cliente duplica on-chain - Explorações de derivação de preço de participação. Correção: Leia os totais da cadeia; exiba apenas.
• Pausa ausente no saque - Atacante drena durante o incidente. Correção: require!(!paused) central.
• IDL não versionado - O cliente chama instruções removidas. Correção: Semver em packages/idl.
• RPC público no lançamento - Limite de taxa de interrupção. Correção: RPC de escrita dedicado no ambiente de produção.

Alternativas

FAQs

Relacionado

• Referência: Um Lançamento de Token SPL - mint do token de participação
• Antes/Depois: Otimizando CU e Aluguel - caminho de escala
• Noções básicas do Anchor - fundamentos do framework

Versões da Stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.