First off, thanks a lot for considering contributing to Florestas.Social! We are a passionate team working hard to bridge the gap between Real-World Assets (African Mahogany) and the Stellar network.

We know that building on Web3 (especially with Soroban, which is relatively new) can be challenging. Don't worry if you don't understand everything at first glance. Whether you are fixing a typo in the README, adjusting a Next.js component, or optimizing our Rust smart contracts, your help is incredibly valuable to us.

• Ask before you build: If you have a big feature in mind, open an issue first or ping us directly. We'd love to chat about it before you spend hours coding.
• We make mistakes: You might find messy code or TODOs left behind by our team after long coding sessions. If you see something weird, point it out!

1. Fork & Clone: Fork this repo and clone it locally.
2. Branch out: Create a branch for your work (e.g., git checkout -b fix/soroban-auth-bug).
3. Soroban Security: If you are touching the Rust contracts, please take a look at our CLAUDE.md / Security Roadmap. We are very strict about using require_auth() and managing TTL so our users never lose their ecological assets.
4. Test locally: Run cargo test or our Makefile commands to ensure nothing broke.
5. Open a PR: Tell us what you did, why you did it, and grab a coffee while we review it. ☕

Need help? Shoot an email to gutogn@gmail.com or hit us up on WhatsApp +55 88 99643-7794.

Primeiro de tudo, valeu demais por querer contribuir com o Florestas.Social! Nós somos um time apaixonado e estamos ralando pra conectar Ativos do Mundo Real (nosso querido Mogno Africano) com a rede Stellar.

A gente sabe que mexer com Web3 (ainda mais com Soroban, que é super novo) pode dar um nó na cabeça. Fica de boa se você não entender tudo de primeira. Seja arrumando um errinho de digitação no README, ajeitando um botão no Next.js ou escovando bits nos nossos contratos em Rust, qualquer ajuda é muito bem-vinda!

• Troca uma ideia antes de codar: Teve uma ideia gigante pra uma feature nova? Abre uma Issue ou chama a gente no zap/email primeiro. A gente adora bater papo antes de você gastar horas codando.
• A gente também faz gambiarra (às vezes): Você vai achar uns códigos meio feios ou uns TODOs largados por aí depois de umas noites mal dormidas do nosso time. Se ver algo muito estranho, dá um grito!

1. Fork & Clone: Faz um fork deste repositório e clona pra sua máquina.
2. Cria uma Branch: (ex: git checkout -b feat/nova-tela-dashboard).
3. Segurança no Soroban: Se for mexer nos contratos em Rust, dá uma lida no nosso CLAUDE.md. A gente é meio chato com o uso de require_auth() e do TTL pra garantir que os ativos da galera nunca sumam na rede.
4. Testa aí: Roda um cargo test ou usa nosso Makefile pra ter certeza que não quebrou nada.
5. Abre o PR: Conta pra gente o que você fez, o porquê de ter feito, e vai pegar um café enquanto a gente revisa. ☕

Precisou de ajuda? Manda um email para gutogn@gmail.com ou chama no WhatsApp +55 88 99643-7794.