create-solana-dapp
Faça scaffold de dApp Solana full-stack com programa on-chain e client Next.js usando o gerador create-solana-dapp.
Receita
Card de receita de referência rápida - pronto para copiar e colar.
pnpm create solana-dapp@latest
cd my-dapp
pnpm install
anchor build
pnpm devQuando usar:
- Produto greenfield precisando UI conectada à wallet mais programa.
- Padronizar layout de repo entre múltiplos apps Solana.
- Ensinar divisão programa + client com defaults funcionais.
- Pular wiring manual Next.js + Anchor.
Exemplo prático
pnpm create solana-dapp@latest my-marketplace \
--template anchor-nextjs \
--wallet adapter
cd my-marketplace
pnpm install
# Alinhe toolchain com pins do guia
avm use 0.32.1
anchor build
anchor test
# Inicie validator local + app (scripts de template variam)
pnpm devO que isso demonstra:
- Layout monorepo ou workspace com pastas
programs/eapp/. - Wallet adapter e hooks de config RPC pré-conectados.
- Stub de programa Anchor 0.32.1 pronto para
anchor build.
Aprofundamento
Como funciona
- Gerador copia template com programa Anchor, testes e frontend Next.js.
- Client usa padrões modernos de wallet (wallet-adapter ou kit específico do template).
- Scripts encapsulam
solana-test-validator, deploy e startup do dev server. - Você substitui instruções stub por lógica de produto incrementalmente.
Layout Típico
| Caminho | Conteúdo |
|---|---|
programs/<name>/ | Código fonte programa Anchor |
app/ ou src/ | Frontend Next.js |
Anchor.toml | Program IDs e URLs de cluster |
tests/ | Testes de integração |
Notas bash
# Re-execute codegen após mudanças IDL (depende do template)
anchor build
pnpm run codegen 2>/dev/null || trueErros comuns
- Versão Anchor obsoleta no template - default do gerador pode atrasar 0.32.1. Correção: atualize
Anchor.toml,anchor-lange executeavm use 0.32.1. - Assumir config devnet - template pode apontar para localnet. Correção: leia README e defina cluster provider em
Anchor.toml. - Pular startup do validator - txs do client falham sem RPC. Correção: execute script validator incluso ou Surfpool.
- Commitar keypairs de programa - templates incluem chaves de deploy por conveniência. Correção: rotacione para produção; gitignore secrets.
- Features pesadas do template - dependências UI não usadas retardam installs. Correção: remova pacotes após scaffold se client API-only mínimo necessário.
Alternativas
| Alternativa | Use quando | Não use quando |
|---|---|---|
Apenas anchor init | Programa primeiro, client depois | Precisa UI imediata |
CLI mucho | Templates opinativos Foundation | Arquitetura Next.js customizada |
| Monorepo manual | Controle total de escolhas de stack | Prazo MVP rápido |
| Flags mínimas create-solana-dapp | Saída mais enxuta | Aprender wiring full-stack |
FAQs
Ele fixa @solana/kit 7.0.0?
Verifique package.json gerado e atualize para 7.0.0 para corresponder à stack fixada deste guia.
Posso usar npm em vez de pnpm?
Templates frequentemente documentam pnpm primeiro; npm/yarn geralmente funcionam com comandos install equivalentes.
Onde program ID é definido?
Anchor.toml e declare_id! em programs/<name>/src/lib.rs - atualize após anchor keys sync.
Como fazer deploy do scaffold?
anchor deploy contra cluster configurado após financiar keypair do deployer.
Posso remover Next.js?
Sim - mantenha programs/ e testes; substitua frontend por qualquer client baseado em kit.
Scaffold inclui testes?
Maioria dos templates inclui testes de integração Anchor - estenda com LiteSVM para velocidade unitária.
Como adicionar Tailwind ou UI kit?
Selecione variantes de template na criação ou adicione dependências pós-geração.
create-solana-dapp é oficial?
Scaffold mantido pela comunidade amplamente usado em tutoriais do ecossistema Solana - verifique repo do template para updates.
Como configurar devnet?
Edite URL provider em Anchor.toml e env frontend NEXT_PUBLIC_RPC_URL.
Quais wallet adapters estão incluídos?
Depende da flag de template - comumente @solana/wallet-adapter-react ou wallets nativas kit.
Relacionados
- Visão Geral da Toolchain - ferramentas necessárias
- Mucho CLI - caminho scaffold alternativo
- solana-test-validator - RPC local
- Noções Básicas do Anchor - estrutura de programa
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.