[Full Stack] Implement Token Retirement with Impact Certificate

[Utilitycoder]

Description

Allow users to "retire" (burn) their Carbon Credit Tokens to permanently claim the carbon offset. Upon retirement, generate a shareable impact certificate.

Acceptance Criteria

Smart Contract (Farm-credit/soroban-contracts)

• `retire(amount)` function burns tokens
• Emits `Retirement` event with: user, amount, timestamp
• Updates `total_retired` counter
• User cannot retire more than balance

Frontend

• "Retire Tokens" button on dashboard
• Retirement modal:
  • Input amount to retire
  • Shows: "You are permanently claiming X kg of CO₂ offset"
  • Confirm button
• Execute retirement transaction
• Success screen with:
  • Retirement confirmation
  • Downloadable/Shareable Impact Certificate (PDF or image)
  • Certificate includes: User address, Amount, CO₂ offset, Date, Tx hash
• Social share buttons (Twitter, LinkedIn)

Certificate Design

• Clean, professional design
• FarmCredit branding
• QR code linking to transaction on Stellar explorer
• Consider using `html2canvas` or similar for generation

Definition of Done

• Contract retirement function working
• Frontend retirement flow complete
• Certificate generation working
• Social sharing functional
• Mobile responsive

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[CMI-James]

@CMI-James has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I have experience in this and I will like to take this on.
ETA: 12 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @CMI-James to this issue.

[drips-wave]

Congratulations, @CMI-James! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @CMI-James: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

⚠️ Important: When opening a PR, please link it to this issue to ensure it gets tracked accurately.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[icedoutskay]

@icedoutskay has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello maintainer, I would love to be assigned this task. I have read the requirements and I will deliver a good pr within 6hrs of assignment

ℹ️ Repo Maintainers: To accept this application, review their application or assign @icedoutskay to this issue.

[Georgechisom]

@Georgechisom has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi @Utilitycoder I am a full stack blockchain developer with experience building Soroban smart contracts alongside user facing Web3 applications that emphasize usability, transparency, and verifiable impact. I have worked on token lifecycle features such as minting, burning, and event-driven accounting, as well as frontend flows that guide users through irreversible on-chain actions with clarity and confidence. I am particularly interested in products where on-chain actions translate into real-world outcomes and auditable proof.

For this issue, I will implement the token retirement flow end to end. On the smart contract side, I will add a retire(amount) function that safely burns carbon credit tokens, enforces balance checks, updates the total_retired counter, and emits a Retirement event containing the user address, amount, and timestamp. On the frontend, I will build a clear and mobile responsive retirement experience on the dashboard, including a modal for entering the retirement amount, executing the transaction, and confirming success. Upon completion, I will generate a clean, branded impact certificate that includes the user address, retired amount, CO₂ offset, date, and transaction hash, with a QR code linking to the Stellar explorer. The certificate will be downloadable and shareable, with social sharing support for platforms such as Twitter and LinkedIn.

I'm confident about contributing to Farm-credit’s mission and would be glad to work on this feature. Please assigned this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Georgechisom to this issue.

[ETIM-PAUL]

@ETIM-PAUL has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I have the required experience to work on this task. 3+ years working as a web2 developer and 2 years working as a web3 developer.

I have built multiple projects that has earned me grant, 4x Hackathon wins and worked with clients all over the world building projects across fintech, edtech, healthtech, etc.

I would love to work on this task, as it cuts across both Backend and Frontend (web3) - and I have good experience working on Dapps.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @ETIM-PAUL to this issue.

[0xsupremedev]

@0xsupremedev has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’d like to work on this issue because it directly supports real-world impact through transparent token retirement and impact certificates. I have full-stack Web3 experience building token flows and user-facing dashboards using React/Next.js, TypeScript, and smart-contract integrations. I can deliver clean, secure, and production-ready code while following the project’s existing patterns.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @0xsupremedev to this issue.