FromToSwap

Plataforma de conversão inteligente entre moedas fiduciárias e criptomoedas

---

Sobre o Projeto

O FromToSwap é uma aplicação web moderna que simplifica a conversão entre moedas tradicionais (Real e Dólar) e criptomoedas (Bitcoin, Ethereum, USDT e Nano). A plataforma oferece uma interface intuitiva para calcular valores, gerar QR codes de pagamento e monitorar transações em tempo real.

Objetivo Principal

Democratizar o acesso às criptomoedas através de uma interface simples e segura, eliminando barreiras técnicas para comerciantes, investidores e usuários iniciantes.

---

Funcionalidades Principais

Conversão em Tempo Real

• Conversão instantânea de BRL/USD para BTC, ETH, USDT e XNO
• Preços atualizados automaticamente via API CoinGecko
• Cálculos precisos com até 8 casas decimais
• Timer visual para próximas atualizações de preço

Sistema de Carteiras

• Suporte para MetaMask, Trust Wallet, TronLink e Exodus
• Reconexão automática de carteiras
• Visualização de saldos em tempo real
• Modo independente sem carteira conectada

QR Codes Inteligentes

• Geração automática de códigos QR personalizados
• Modalidades com valor específico ou flexível
• Sistema de expiração de 5 minutos
• Endereços criptografados com segurança

Monitoramento de Transações

• Acompanhamento automático na blockchain
• Notificações em tempo real
• Estados visuais: aguardando, processando, confirmado
• Atualização automática de saldos

Interface Multilíngue

• Suporte completo para Português e Inglês
• Adaptação cultural de formatos
• Persistência de preferências do usuário

---

Tecnologias Utilizadas

Frontend

• React 18 - Framework principal
• Tailwind CSS - Estilização responsiva
• React i18next - Internacionalização

Integrações

• Ethers.js - Integração Ethereum
• TronWeb - Integração Tron
• CoinGecko API - Cotações em tempo real
• QRCode.react - Geração de QR codes

Segurança

• Criptografia AES para dados sensíveis
• Validação rigorosa de entrada
• Proteção contra ataques de injeção

---

Instalação e Execução

Pré-requisitos

• Node.js 16+ instalado
• npm ou yarn

Passos para execução

# 1. Clonar o repositório
git clone https://github.com/Marcos934/fromtoswap.git
cd fromtoswap

# 2. Instalar dependências
npm install

# 3. Executar em modo desenvolvimento
npm start

# 4. (Opcional) Habilitar menu de desenvolvimento
REACT_APP_SHOW_DEV_MENU=true npm start

A aplicação estará disponível em http://localhost:3000

---

Casos de Uso

• E-commerce: Aceitar pagamentos em criptomoedas
• Remessas: Transferências internacionais
• Trading: Cálculos rápidos de conversão
• Educação: Ferramenta de aprendizado sobre crypto
• Freelancers: Recebimento de pagamentos globais

---

Estrutura do Projeto

src/
├── components/          # Componentes React
├── services/           # Serviços de API e blockchain
├── wallets/            # Integrações de carteiras
├── utils/              # Utilitários e helpers
├── locales/            # Arquivos de tradução
└── config/             # Configurações da aplicação

---

Contribuição

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

---

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

Contato

Desenvolvedor: Marcos Vinicius Mulinari
Email: marcos.mulinari97@gmail.com
GitHub: @Marcos934

---

FromToSwap - Conectando o mundo tradicional ao universo das criptomoedas