Implement Fund Request Contract for Project Milestones

[anonfedora]

📚 Overview

Develop a standalone FundRequest smart contract in budgetchain-app/onchain directory in Cairo to manage fund requests tied to project milestones. The contract will support request creation, approval, rejection, status tracking, and update project budgets accordingly. It is crucial that only completed milestones can have fund requests and that proper validations and access controls are in place.

🛠️ Requirements & Tasks

1. Data Structures & Storage

   • Define a FundRequest struct with the following fields:
     • project_id: u64
     • milestone_id: u64
     • amount: u128
     • requester: ContractAddress
     • status: FundRequestStatus (enum with values Pending, Approved, Rejected)
   • Define events:
     • FundsRequested with fields project_id, request_id, milestone_id
     • FundsReleased with fields project_id, request_id, milestone_id, amount
     • FundsReturned with fields project_id, amount, project_owner
   • Set up storage for fund requests and counters.

2. Function Implementation

   • create_fund_request: Allow project owners to create a fund request only for completedd milestones.
   • approve_fund_request: Allow authorized organizations/admins to approve a fund request and release funds.
   • reject_fund_request: Allow authorized organizations/admins to reject a fund request.
   • Ensure that upon fund approval, the project budgets are updated accordingly.

3. Validation & Access Control

   • Verify that only completed milestones can have fund requests.
   • Implement proper validations for request statuses and access control for request lifecycle functions.

4. Event Emission

   • Emit FundsRequested when a fund request is created.
   • Emit FundsReleased when funds are successfully released.
   • Emit FundsReturned if funds need to be returned.

❗ Technical Considerations

• Ensure the functions are secure and only callable by authorized roles.
• The implementation should handle edge cases such as invalid amounts or unauthorized accesses.
• Follow best practices regarding state management and event handling in smart contracts.

Let's ensure this contract adds robust and secure fund request handling to the project!

[davedumto]

Hi, my name is David, and I am a frontend developer skilled in React, Next.js, JavaScript, TypeScript, and Tailwind CSS. For this task, I will:

• Implement a standalone FundRequest smart contract in Cairo to manage fund requests tied to project milestones.
• Define the FundRequest struct with fields such as project_id, milestone_id, amount, requester, and status.
• Implement functions for creating, approving, and rejecting fund requests with proper access control.
• Ensure that only completed milestones can have fund requests and ensure that budget updates occur upon fund approval.
• Implement event emissions for FundsRequested, FundsReleased, and FundsReturned.
• Handle edge cases, such as invalid amounts or unauthorized access, while ensuring security and proper state management.

ETA: 2 days.

[anonfedora]

Hi, any update?

[davedumto]

hey @anonfedora can you close as completed? my PR has been merged

[davedumto]

???

[davedumto]

hi @anonfedora