Mucho CLI
mucho é a CLI de desenvolvedor da Solana Foundation que encapsula fluxos comuns de setup, scaffold, build e deploy além de comandos brutos solana e anchor.
Receita
Card de receita de referência rápida - pronto para copiar e colar.
cargo install mucho-cli
mucho --version
mucho init my-project
mucho build
mucho testQuando usar:
- Onboarding mais rápido com templates de projeto opinativos.
- Ponto de entrada único para scripts build/test/deploy em exemplos Foundation.
- Padronizar comandos entre workshops e repos internos.
- Reduzir copy-paste de múltiplos READMEs de ferramentas.
Exemplo prático
# Install (toolchain Rust necessária)
cargo install mucho-cli --locked
mucho --help
mucho init hello-solana
cd hello-solana
# Garanta que pins Anchor/Agave ainda se aplicam por baixo
avm use 0.32.1
solana --version
mucho build
mucho testO que isso demonstra:
mucho initcria workspace estruturado similar a scaffolds da comunidade.mucho builddelega para Anchor/cargo build-sbf com defaults sensatos.- Binários subjacentes permanecem Agave CLI e Anchor - mucho orquestra.
Aprofundamento
Como funciona
- Mucho compõe ferramentas existentes em vez de substituir runtime.
- Templates alinham com documentação e conteúdo educacional Foundation.
- Comandos mapeiam para fluxos Anchor familiares para devs de programa.
- Scaffold de client pode integrar padrões modernos de wallet e RPC.
Áreas de Comando
| Área | Comando mucho típico |
|---|---|
| Scaffold | init, new |
| Build | build |
| Test | test, localnet |
| Deploy | deploy (cluster-aware) |
| Config | doctor / checagens env |
Notas bash
# Valide ambiente antes de workshop
mucho doctor 2>/dev/null || mucho --help
solana --version && anchor --versionErros comuns
- Assumir que mucho fixa versões - orquestra; você ainda executa
agave-installeavm. Correção: verifique versões após init. - mucho desatualizado vs Anchor 0.32.1 - atualize mucho quando macros falharem. Correção:
cargo install mucho-cli --forceem tag locked. - Layout diferente de create-solana-dapp - migração é manual. Correção: escolha um scaffold por produto.
- CI sem mucho instalado - pipelines falham em
mucho build. Correção: instale no CI ou chameanchor builddiretamente. - Problemas de path Windows - prefira WSL para paridade toolchain Solana. Correção: siga notas de plataforma Foundation.
Alternativas
| Alternativa | Use quando | Não use quando |
|---|---|---|
CLI anchor bruta | Transparência máxima | Velocidade de workshop |
create-solana-dapp | Produtos centrados Next.js | Alinhamento template Foundation |
mucho | Trilha de aprendizado Foundation | Políticas monorepo altamente customizadas |
| Scripts manuais | Controle total CI | Experimentos solo rápidos |
FAQs
mucho substitui solana CLI?
Não - encapsula e orquestra binários Agave/Solana e Anchor.
Como instalar mucho?
Tipicamente cargo install mucho-cli --locked com Rust 1.91.1 disponível.
mucho pode fazer deploy na mainnet?
Comandos deploy visam clusters configurados - aplique mesmas salvaguardas mainnet que anchor deploy.
mucho é obrigatório para produção?
Não - CI de produção frequentemente chama anchor build e solana program deploy diretamente.
Como mucho se relaciona com Surfpool?
Ferramentas separadas - Surfpool lida com simulação fork mainnet; mucho foca ciclo de vida de projeto.
Quais templates mucho envia?
Execute mucho init --help para lista atual - evolui com releases Foundation.
Posso usar mucho em repos existentes?
Melhor para projetos novos; repos Anchor existentes podem adotar scripts individuais em vez de migração completa.
mucho configura IDE?
Não - combine com Configuração de Editor e rust-analyzer.
Como atualizar mucho?
cargo install mucho-cli --locked --force puxa release mais recente do crates.io.
E se mucho e avm conflitarem?
Mucho deve invocar binário anchor ativo no PATH após avm use 0.32.1.
Relacionados
- create-solana-dapp - scaffold full-stack da comunidade
- Visão Geral da Toolchain - ferramentas subjacentes
- Gerenciamento de Versão (agave-install / avm) - pins de versão
- Noções Básicas de Dev Local - loop de dev
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.