Web3 Playground & Sandbox - Learn, Develop, Test MCP Servers + Toolkit SDK

Compilador Solidity gratuito e IDE Web3 com tutoriais interativos. Aprenda desenvolvimento blockchain, implante contratos inteligentes em 8+ chains (Ethereum, Polygon, Base, Arbitrum, Solana). Modelos para tokens, NFTs, DeFi, DAOs. Editor Monaco, assistência de IA, acessível WCAG. Alternativa ao Remix. Otimização de gas, integração com MetaMask, código aberto. Amigável para iniciantes. Kit de ferramentas MCP.

Documentação

Lyra Web3 Playground

✨ Construído por nich | GitHub | X/Twitter

[![Repository](https://img.shields.io/badge/source-github-blue)](https://github.com/nirholas/lyra-web3-playground) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/) [![React](https://img.shields.io/badge/React-18-61dafb)](https://react.dev/) [![Accessibility](https://img.shields.io/badge/a11y-WCAG%202.1%20AAA-purple)](docs/ACCESSIBILITY.md) [![i18n](https://img.shields.io/badge/i18n-10%20languages-orange)](docs/ARCHITECTURE.md) [![Author](https://img.shields.io/badge/Author-nich-ff69b4)](https://x.com/nichxbt)

Uma plataforma abrangente de aprendizado Web3 de código aberto. Ambientes de desenvolvimento profissionais, ferramentas assistidas por IA, testes de segurança e recursos colaborativos — tudo no seu navegador.

Obtenha o código-fonte no GitHub

Nota de hospedagem: a demonstração hospedada em lyra.works está atualmente offline enquanto a hospedagem está sendo migrada. Clone o repositório e execute npm install && npm run dev para usar todos os ambientes abaixo em http://localhost:3000.


🛠️ Ambientes de Desenvolvimento

IDEs Profissionais

FerramentaDescriçãoLink
Web SandboxIDE web completo com React, Vue, Python, pré-visualização ao vivo, modo Vim/ide?type=web
Solidity IDEIDE de contratos inteligentes com compilador multi-versão (0.6.x - 0.8.24)/ide?type=solidity
Full-Stack PlaygroundConstrua dApps completos com contrato + frontend + pré-visualização ao vivo/fullstack-demo
Interactive SandboxIDE com assistente de IA, modelos e implantação em testnet/sandbox

Laboratório de Inovação (Experimental)

Abra http://localhost:3000/innovation ou ative o "Modo Inovação" no sandbox:

RecursoCapacidade
AI Code WhispererDetecção de vulnerabilidades em tempo real, controle por voz, sugestões de correção automática
Contract Time MachineHistórico de versões, ramificações, simulação de estado
Security Testing LabTeste contratos contra reentrância, empréstimos instantâneos, ataques de estouro
Collaborative ArenaCodifique com colegas de IA, participe de desafios
Neural Gas OraclePrevisão e otimização de gás com ML
Cross-Chain DeployerImplante em 8+ cadeias com configuração automatizada de ponte

♿ Acessibilidade (WCAG 2.1 AAA)

Suporte abrangente de acessibilidade:

RecursoDescrição
Dwell ClickClique ao passar o mouse — nenhum botão do mouse necessário
Reading GuideLinha horizontal segue a posição do cursor
Color Blind FiltersSuporte a Protanopia, Deuteranopia, Tritanopia
Text-to-SpeechLeia o conteúdo em voz alta com velocidade/tom ajustáveis
Cognitive SupportModo simplificado, modo foco, tempos limite estendidos
Code-to-EnglishTraduz Solidity para explicações em inglês simples

Veja ACCESSIBILITY.md para documentação completa.


Acesso Rápido a Todas as Ferramentas

FerramentaURLDescrição
IDE Hub/ideEscolha Web Sandbox ou Solidity IDE
Web Sandbox/ide?type=webIDE HTML/CSS/JS/React/Vue/Python
Solidity IDE/ide?type=solidityDesenvolvimento de contratos inteligentes
Interactive Sandbox/sandboxSandbox com assistente de IA
Contract Playground/playgroundEditor de contratos baseado em modelos
Learning Playground/learnTutoriais interativos
Full-Stack Demo/fullstack-demoConstrutor de Contrato + Frontend
Innovation Lab/innovationRecursos experimentais de IA
Markets/marketsPreços de cripto ao vivo e dados DeFi
Explore/exploreGaleria de projetos da comunidade

🎯 Para quem é isso?

Você é...Lyra ajuda você a...
🌱 Iniciante completoAprenda Solidity com tutoriais passo a passo
💻 Desenvolvedor webTransicione para Web3 com ferramentas familiares
🎓 EstudantePratique contratos inteligentes sem gastar gás
🔧 ConstrutorPrototipe dApps rapidamente com modelos
👩‍🏫 EducadorEnsine blockchain com exemplos interativos

⚡ Comece em 30 Segundos

Execute npm install && npm run dev, depois escolha uma opção abaixo.

Opção 1: Navegue pelos tutoriais

  1. Abra http://localhost:3000
  2. Clique em qualquer tutorial ou exemplo
  3. Comece a codificar imediatamente

Opção 2: Experimente o Solidity IDE

  1. Abra http://localhost:3000/ide
  2. Escreva ou cole um contrato inteligente
  3. Clique em "Compile" e depois em "Deploy" (usa JavaScript VM - nenhuma carteira necessária)

Opção 3: Siga um tutorial

  1. Abra http://localhost:3000
  2. Role até "Aprenda Desenvolvimento Web3"
  3. Escolha um tutorial com base no seu nível

🎮 O que você pode fazer aqui?

Para Aprender

  • 📖 50+ tutoriais de "O que é blockchain?" até DeFi avançado
  • 🎯 Exemplos interativos - o código é executado enquanto você lê
  • 💡 Feedback instantâneo - veja erros e resultados imediatamente
  • 🏆 Acompanhamento de progresso - continue de onde parou

Para Construir

  • Solidity IDE - compile e implante em segundos
  • 📝 40+ modelos - tokens, NFTs, DAOs, DeFi
  • 🤖 AI dApp Builder - descreva o que você quer, obtenha código
  • 🔗 Multi-cadeia - Ethereum, Polygon, Base, Arbitrum e mais

Para Todos

  • 🌍 10 idiomas - Inglês, Espanhol, Chinês, Árabe e mais
  • Totalmente acessível - leitores de tela, navegação por teclado, suporte a daltonismo
  • 🌙 Modo escuro - fácil para os olhos
  • 📱 Compatível com dispositivos móveis - aprenda em qualquer dispositivo

📚 Caminhos de Aprendizado

🌱 Sou novo em blockchain

  1. Comece com o tutorial "O que é Ethereum?" na página inicial (/)
  2. Continue com "Seu Primeiro Contrato Inteligente" (/)
  3. Experimente o exemplo Hello World (/example/hello-world)

💻 Conheço JavaScript, ensine-me Solidity

  1. Leia "Solidity para Desenvolvedores JS" na página inicial (/)
  2. Compare JavaScript e Solidity lado a lado (/)
  3. Construa um Token Simples (/example/erc20-token)

🚀 Quero construir um dApp

  1. Use o AI dApp Builder na página inicial (/) e descreva sua ideia
  2. Ou comece a partir de um modelo no IDE (/ide)
  3. Implante em testnet e compartilhe com a comunidade

✨ Recursos

🎮 Sandbox de Código Premium (NOVO!)

  • IDE de classe mundial comparável a CodePen, JSFiddle e Remix
  • Web Sandbox: Projetos com múltiplos arquivos com HTML, CSS, JS, React, Vue, Python
  • Solidity IDE: Ambiente de desenvolvimento de contratos inteligentes completo
  • Layouts de painel dividido com redimensionamento arrastável
  • Predefinições de dispositivo para testes responsivos (Desktop/Tablet/Mobile)
  • Execução automática ao alterar com pré-visualização ao vivo
  • Painel de console com captura de log/aviso/erro
  • Painel de configurações: Tema, tamanho da fonte, modo Vim, salvamento automático e mais

🎮 Playground de Código Interativo (/playground)

  • Editor de múltiplos arquivos com abas de arquivo (HTML, CSS, JS, Solidity, JSON e mais)
  • Layout de painel duplo com pré-visualização de recarga ao vivo
  • Captura de console — veja console.log/warn/error do seu código em tempo real
  • Gerenciamento de arquivos — crie, exclua e alterne entre arquivos
  • Geração de contratos com IA a partir de prompts em linguagem natural
  • 40+ modelos de contratos inteligentes prontos para implantar
  • Implantação com um clique em qualquer blockchain suportada

🔧 Desenvolvimento Solidity (NOVO!)

  • Múltiplas versões de Solidity (0.6.x até 0.8.24)
  • Compilação em tempo real com destaque de erros/avisos
  • Implantação em qualquer rede (JS VM, Sepolia, Goerli, Mumbai, Mainnet)
  • UI de contrato interativa - chame funções diretamente
  • Histórico de transações com rastreamento de gás
  • Copie ABI/Bytecode com um clique
  • Atalhos de teclado (Ctrl+S para compilar)

###️ Full-Stack Sandbox (/sandbox)

  • Navegação em árvore de arquivos com gerenciamento de espaço de trabalho
  • Painel de pré-visualização web com recarga ao vivo para projetos HTML/CSS/JS
  • Captura de log do console do iframe de pré-visualização
  • Painel de interação com contratos para contratos inteligentes implantados
  • Integração com assistente de IA para sugestões de código
  • Modo Inovação — recursos experimentais como AI Whisperer, Time Machine, Exploit Lab
  • Exportar/compartilhar espaços de trabalho com um clique

📚 Modelos de Contratos Inteligentes

  • 40+ modelos prontos para uso em categorias:
    • ERC-20, ERC-721, ERC-1155 tokens
    • DeFi (staking, vaults, DEX)
    • Mercados de NFT e cunhagem
    • Governança e DAOs
    • Pontes entre cadeias

📖 Tutoriais Abrangentes

  • 50+ tutoriais do iniciante ao avançado [em andamento]
  • Guias passo a passo com exemplos interativos
  • Tópicos: fundamentos de Solidity, mecânicas de DeFi, padrões de segurança, otimização de gás

🔗 Suporte Multi-Cadeia

  • Ethereum, Base, Polygon, Avalanche, BSC, Arbitrum
  • Integração com Solana
  • Suporte à testnet Monad

🧹 Ferramenta de Consolidação de Tokens

  • Varra tokens residuais entre carteiras
  • Gerenciamento de tokens multi-cadeia
  • Operações em lote eficientes em gás

🎨 UI/UX Moderna

  • Modo escuro/claro
  • Design totalmente responsivo
  • Atalhos de teclado para usuários avançados
  • Otimizado para dispositivos móveis com navegação inferior

♿ Acessibilidade - Além do WCAG 2.1 AAA (NOVO!)

Vamos muito além da acessibilidade padrão. Nosso sistema inclui recursos futuristas que tornam o Web3 verdadeiramente acessível a todos:

Perfis rápidos (predefinições com um clique):

  • 👓 Baixa Visão • 🦯 Cego • 🦻 Surdo • 🖐️ Deficiência Motora • 🧠 Cognitivo

Recursos de Visão:

  • Modo de alto contraste, texto grande (até 200%), cores personalizadas
  • Filtros para daltonismo: Protanopia, Deuteranopia, Tritanopia e mais
  • Guia de leitura: Linha horizontal segue seu cursor para leitura mais fácil
  • Fonte OpenDyslexic: Especialmente projetada para leitores disléxicos

Acessibilidade Motora:

  • Dwell Click: Clique ao passar o mouse - nenhum botão do mouse necessário
  • Alvos de clique grandes (até 64px), simulação de teclas aderentes
  • Navegação completa por teclado com acesso rápido Alt+A

Suporte Cognitivo:

  • Modo de interface simplificada, modo foco, animações reduzidas
  • Tempos limite estendidos, ajuste de velocidade de leitura
  • Layouts claros e consistentes

Leitor de Tela e Áudio:

  • Regiões ativas ARIA anunciam todas as ações
  • Texto para Fala: Leia o conteúdo em voz alta com velocidade/tom ajustáveis
  • Código para Linguagem Natural: Traduz código para inglês simples

Amigável para Desenvolvedores:

  • Botão de acessibilidade flutuante arrastável
  • Exportar/importar configurações personalizadas
  • Suporte completo a atalhos de teclado

Veja ACCESSIBILITY.md para documentação completa

🤖 Construtor de dApp com IA (NOVO!)

  • Linguagem natural → Geração de dApp full-stack
  • Gera Solidity + HTML + CSS + JavaScript a partir de prompts
  • Modelos de contratos inteligentes: Token, NFT, DAO
  • Editor interativo estilo tutorial com orientação passo a passo
  • Implante diretamente em testnets

🌐 Recursos da Comunidade (NOVO!)

  • Compartilhar Projetos: Publique seu trabalho com links exclusivos para compartilhamento
  • Explorar Galeria: Descubra projetos, modelos e tutoriais da comunidade
  • Curtir e Comentar: Interaja com o trabalho de outros desenvolvedores
  • Bifurcar Projetos: Construa sobre o código de outros
  • Autenticação por Carteira: Conecte a carteira para acessar recursos da comunidade
  • Incorporar Código: Incorpore projetos compartilhados em seus próprios sites

🌍 Internacionalização (NOVO!)

  • 10 idiomas suportados de fábrica
  • Inglês, Espanhol, Chinês, Francês, Alemão, Japonês, Coreano, Português, Russo, Árabe
  • Suporte RTL para árabe
  • Seletor de idioma na navegação
  • Preferência de idioma persistida

📊 Integração de Dados de Mercado (NOVO!)

  • Preços de Cripto ao Vivo: Dados em tempo real da CoinGecko
  • Análises DeFi: TVL de protocolos, rendimentos da DeFiLlama
  • Estatísticas de Cadeia: TVL por cadeia, moedas em alta
  • Página de Mercados: Visão geral abrangente do mercado em /markets

🚀 Início Rápido

Pré-requisitos

  • Node.js 18+
  • npm ou yarn

Instalação

# Clone the repository
git clone https://github.com/nirholas/lyra-web3-playground.git
cd lyra-web3-playground

# Install dependencies
npm install

# Start development server
npm run dev

Abra http://localhost:3000 no seu navegador.

Variáveis de Ambiente

O aplicativo é executado sem configuração, mas o login com carteira, a API de backend, o acesso RPC e os recursos baseados em Supabase precisam de credenciais. Copie o arquivo de exemplo e preencha-o:

cp .env.example .env
VariávelPropósito
VITE_PRIVY_APP_IDID do aplicativo Privy usado para login com carteira / e-mail
VITE_API_URLURL base da API de backend (padrão: http://localhost:3001)
VITE_INFURA_API_KEYID do projeto Infura para chamadas RPC somente leitura
VITE_SUPABASE_URLURL do projeto Supabase
VITE_SUPABASE_ANON_KEYChave anônima (pública) do Supabase

Todo valor com prefixo VITE_ é incorporado ao bundle do cliente e, portanto, é público — nunca coloque uma chave privada ou segredo de servidor em .env. Segredos do lado do servidor pertencem a server/.env (veja server/.env.example).

Build para Produção

npm run build
npm run preview

🏗️ Estrutura do Projeto

├── src/
│   ├── components/     # React components
│   │   ├── Accessibility/    # Comprehensive a11y system
│   │   │   ├── AccessibilityButton.tsx  # Floating button
│   │   │   ├── AccessibilityPanel.tsx   # Settings panel
│   │   │   ├── DwellClick.tsx           # Click-by-hovering
│   │   │   ├── ReadingGuide.tsx         # Line highlighter
│   │   │   └── ColorBlindFilters.tsx    # Color blind support
│   │   ├── CodePlayground/   # Monaco editor & compiler
│   │   ├── Tutorial/         # Tutorial system
│   │   ├── Sandbox/          # Premium sandbox IDEs
│   │   │   ├── WebSandbox.tsx       # Web dev sandbox
│   │   │   ├── SoliditySandbox.tsx  # Solidity IDE
│   │   │   ├── UnifiedSandbox.tsx   # Generic sandbox wrapper
│   │   │   └── ShareModal.tsx       # Project sharing modal
│   │   ├── Playground/       # Full-stack dApp playground
│   │   ├── FullStackPlayground/  # AI dApp builder
│   │   └── Consolidation/    # Token consolidation
│   ├── pages/          # Route pages
│   │   ├── SandboxPage.tsx   # Premium IDE selection
│   │   ├── ExplorePage.tsx   # Community project gallery
│   │   ├── SharedProjectPage.tsx  # View shared projects
│   │   ├── MarketsPage.tsx   # Market data dashboard
│   │   └── ExamplePage.tsx   # Example with sandbox toggle
│   ├── services/       # API services
│   │   ├── community.ts      # Sharing, likes, comments, forks
│   │   └── marketData.ts     # CoinGecko & DeFiLlama integration
│   ├── hooks/          # Custom React hooks
│   │   └── useMarketData.ts  # Market data hooks
│   ├── stores/         # Zustand state management
│   │   ├── accessibilityStore.ts  # 40+ a11y settings
│   │   ├── i18nStore.ts           # 10 languages + RTL
│   │   ├── themeStore.ts          # Dark/light mode
│   │   └── walletStore.ts         # Wallet connection
│   ├── styles/
│   │   ├── index.css             # Main styles
│   │   └── accessibility.css     # 580+ lines a11y CSS
│   ├── examples/       # Code examples (web3, ai)
│   └── utils/          # Helper functions
│       └── contractTemplates.ts  # 40+ contract templates
├── server/             # Backend API (optional)
├── docs/               # Documentation
└── public/             # Static assets

🛠️ Pilha Tecnológica

CategoriaTecnologia
FrontendReact 18, TypeScript, Vite
EstilizaçãoTailwindCSS
EditorMonaco Editor
Web3ethers.js v6, viem
EstadoZustand (com persist)
i18nStore personalizada (10 idiomas + RTL)
AcessibilidadeSistema a11y personalizado (WCAG 2.1 AAA+)
Banco de dadosSupabase
TestesVitest
ImplantaçãoVercel, Netlify, Docker

📖 Documentação

DocumentoDescrição
ComeçandoNovo no blockchain? Comece aqui!
Guia de Início RápidoConfigure e execute localmente
Guia do IDETodos os ambientes de desenvolvimento e URLs
Guia do SandboxRecursos premium do sandbox
Laboratório de InovaçãoRecursos de IA e experimentais
PlaygroundsTodos os componentes do playground
Visão Geral da ArquiteturaDesign do sistema
API de BackendReferência da API
Guia de ImplantaçãoImplante sua própria instância
SegurançaPráticas de segurança
AcessibilidadeRecursos de acessibilidade e uso

❓ Perguntas Frequentes

Preciso instalar alguma coisa?

Não! Execute npm run dev e abra http://localhost:3000 no seu navegador. Tudo roda no seu navegador.

Preciso de criptomoeda ou carteira?

Não! Você pode aprender e praticar sem cripto. O IDE tem um modo "JavaScript VM" que simula um blockchain localmente. Quando estiver pronto para implantar de verdade, você precisará do MetaMask e de ETH de testnet (que é gratuito).

Isso é gratuito?

Sim, é gratuito para executar. Sem taxas ocultas, sem nível premium. Veja o arquivo LICENSE para os termos de uso.

Estou recebendo erros. O que eu faço?
  1. Verifique a mensagem de erro - geralmente ela indica o que está errado
  2. Certifique-se de que sua versão do Solidity corresponde ao seu código
  3. Verifique o /faq para problemas comuns
  4. Abra uma issue se estiver travado
Posso usar isso para minha aula/oficina?

Absolutamente! Esse é um dos principais casos de uso. Você pode compartilhar links para exemplos específicos, e os alunos podem codificar junto em seus navegadores. Nenhuma configuração necessária.

Como faço para implantar em uma rede real?
  1. Instale o MetaMask
  2. Obtenha ETH de testnet de um faucet (gratuito)
  3. Conecte sua carteira no Lyra
  4. Selecione sua rede (ex.: Sepolia, Mumbai)
  5. Clique em "Deploy" - seu contrato agora está no blockchain!
Encontrei um bug / tenho uma sugestão

Por favor, abra uma issue! Agradecemos todo feedback.


🤝 Contribuindo

Contribuições são bem-vindas! Leia nosso Guia de Contribuição para detalhes sobre:

  • Código de conduta
  • Fluxo de trabalho de desenvolvimento
  • Processo de pull request
  • Padrões de codificação
  • Mensagens de commit acessíveis - Usamos um formato projetado para leitores de tela e acessibilidade cognitiva

Formato da Mensagem de Commit

[type] Clear description in plain English (emoji at end) 🎉

Exemplo: [add] Keyboard navigation for dropdown menus ♿

Por que esse formato?

  • Texto primeiro - Leitores de tela leem nomes de emojis, então o significado vem primeiro
  • Palavras simples - Claro para desenvolvedores com deficiências cognitivas
  • Consistente - Fácil de escanear para usuários com baixa visão

Veja CONTRIBUTING.md para diretrizes completas.

Boas Primeiras Issues

Confira issues rotuladas como good first issue para começar.


📄 Licença

Todos os direitos reservados. Veja o arquivo LICENSE para detalhes.


🙏 Agradecimentos

  • Remix IDE pela inspiração
  • OpenZeppelin pelos padrões de contratos
  • A comunidade de desenvolvedores Web3

Se você achar este projeto útil, considere dar uma ⭐

Feito com ❤️ por nich

Documentação

Site de documentação completo: https://nirholas.github.io/lyra-web3-playground/

  • Começando cobre instalação e primeira execução.
  • Exemplos tem trechos de copiar e colar.