Sobre o projeto

O Fuel Core é a implementação oficial do cliente Fuel, escrita em Rust como um nó completo para o protocolo Fuel v2. O repositório inclui o binário do nó, crates de suporte e ferramentas para compilar, testar e executar um nó Fuel. ## Versões de rede O README lista as versões atualmente usadas em diferentes redes Fuel: - Fuel Ignition: 0.48.1 - Testnet: 0.48.1 - Devnet: 0.48.1 O repositório também faz referência a uma tag de checkout v0.45.1 para executar um nó Ignition a partir do código-fonte, que pode diferir da versão mais recente da tabela. ## Compilação Os requisitos de sistema incluem ferramentas de compilação comuns, como cmake, pkg-config, clang e Rust com o alvo `wasm32-unknown-unknown`. Comandos de configuração específicos de plataforma são fornecidos para macOS (Homebrew), Debian (apt) e Arch (pacman). Comandos de compilação: - `make build` para uma compilação do binário do nó em estilo release - `cargo xtask build` para compilações de desenvolvimento, que também regeneram o esquema GraphQL ## Executando um nó Os links de documentação apontam para os documentos do Fuel para operadores de nós executarem nós da mainnet (Ignition) ou de rede local. Um nó também pode ser iniciado diretamente com `fuel-core run`; os exemplos mostram o uso de `--db-type in-memory` para estado não persistente e `--poa-instant=false` para desativar a produção automática de blocos. O banco de dados padrão é o RocksDB, e o estado é persistido, a menos que o modo em memória seja usado. ## Testes e contribuição O projeto incentiva os contribuidores a executar `source ci_checks.sh` antes de enviar alterações ou abrir pull requests. Esse script executa todas as verificações de CI, incluindo testes. Também há notas de solução de problemas para publicação de crates, erros de banco de dados desatualizado (`rm -rf ~/.fuel/db`), limites de descritores de arquivo no macOS e configuração de nível de log via `RUST_LOG` ou `HUMAN_LOGGING`. ## Serviço GraphQL A funcionalidade do cliente é exposta por meio de um endpoint de serviço GraphQL em `/v1/graphql`. O esquema fica disponível em `crates/client/assets/schema.sdl` após a compilação. O serviço espera uma mutação `submit` que aceita uma Transaction em formato binário codificado em hexadecimal, conforme as especificações do Fuel. ## Docker e Kubernetes Os ativos de implantação estão incluídos em `deployment/`, com um Dockerfile e um manifesto Kubernetes. Os comandos mostram como compilar a imagem Docker e criar/excluir recursos de volume, deployment e service do Kubernetes.