Last updated
Rent Payment ($1,500)
↓
[Base Rent + Equity Portion]
↓
┌─────────────────┬────────────────┐
│ Equity Portion │ Base Rent │
│ $150 (10%) │ $1,350 │
└────────┬────────┴───────┬────────┘
↓ ↓
Mint 150 EQTBLT Send to Treasury
↓
Renter's Walletfunction addProperty(
string calldata name,
string calldata location,
uint256 units,
uint256 totalValue,
address propertyManager
) external onlyRole(PROPERTY_MANAGER_ROLE) returns (uint256)function updateProperty(
uint256 propertyId,
string calldata name,
string calldata location,
uint256 units,
uint256 totalValue
) external onlyRole(PROPERTY_MANAGER_ROLE)function createLease(
uint256 propertyId,
address renter,
uint256 monthlyRent,
uint256 equityRate,
uint256 startDate,
uint256 duration,
uint256 securityDeposit,
uint256 unit
) external onlyRole(LEASE_ADMIN_ROLE) returns (uint256)function renewLease(
uint256 leaseId,
uint256 newMonthlyRent,
uint256 newEquityRate,
uint256 newDuration
) external onlyRole(LEASE_ADMIN_ROLE)function terminateLease(
uint256 leaseId,
string calldata reason
) external onlyRole(LEASE_ADMIN_ROLE)function payRent(uint256 leaseId) external nonReentrantfunction payRentFor(
uint256 leaseId,
address payer
) external nonReentrant onlyRole(PAYMENT_PROCESSOR_ROLE)function paySecurityDeposit(uint256 leaseId) external nonReentrantfunction getRentDue(uint256 leaseId) external view returns (
uint256 baseRent,
uint256 lateFee,
uint256 total,
bool isLate
)function getLeaseDetails(uint256 leaseId) external view returns (Lease memory)function getRenterLeases(address renter) external view returns (uint256[] memory)function getPaymentHistory(uint256 leaseId) external view returns (Payment[] memory)function getAccruedEquity(uint256 leaseId) external view returns (uint256)function _calculateEquityRate(
uint256 propertyValue,
uint256 monthlyRent,
uint256 leaseDuration,
bool isRenewal
) internal view returns (uint256) {
uint256 baseRate = defaultEquityRate; // 10%
// Longer leases get better rates
if (leaseDuration >= 24 months) {
baseRate += 100; // +1%
}
// Renewals get loyalty bonus
if (isRenewal) {
baseRate += 50; // +0.5%
}
// Cap at maximum
if (baseRate > maxEquityRate) {
baseRate = maxEquityRate;
}
return baseRate;
}1. Renter calls payRent(leaseId)
↓
2. Contract checks lease is active
↓
3. Contract calculates amount due
↓
4. Payment token transferred from renter
↓
5. Equity portion calculated (e.g., 10% of $1,500 = $150)
↓
6. EQTBLT minted (150 EQTBLT for $150 equity)
↓
7. EQTBLT sent to renter wallet
↓
8. Remaining rent ($1,350) sent to treasury
↓
9. Payment recorded1. Grace period expires (5 days after due date)
↓
2. Late fee applied (5% of rent)
↓
3. Payment processed with fee
↓
4. Equity still calculated on base rent only
↓
5. Late fee goes entirely to treasuryevent PropertyAdded(
uint256 indexed propertyId,
string name,
string location,
uint256 units
);
event LeaseCreated(
uint256 indexed leaseId,
uint256 indexed propertyId,
address indexed renter,
uint256 monthlyRent,
uint256 equityRate
);
event LeaseRenewed(
uint256 indexed leaseId,
uint256 newEndDate,
uint256 newMonthlyRent
);
event LeaseTerminated(
uint256 indexed leaseId,
string reason
);
event RentPaid(
uint256 indexed leaseId,
address indexed renter,
uint256 amount,
uint256 equityPortion,
uint256 eqtbltMinted
);
event SecurityDepositPaid(
uint256 indexed leaseId,
address indexed renter,
uint256 amount
);
event LateFeeApplied(
uint256 indexed leaseId,
uint256 feeAmount
);error LeaseNotFound(uint256 leaseId);
error LeaseNotActive(uint256 leaseId, LeaseStatus status);
error NotLeaseRenter(uint256 leaseId, address caller);
error PaymentAlreadyMade(uint256 leaseId, uint256 period);
error InvalidEquityRate(uint256 rate, uint256 min, uint256 max);
error PropertyNotActive(uint256 propertyId);
error InsufficientPayment(uint256 required, uint256 provided);
error TransferFailed(address token, uint256 amount);function transferEquity(
uint256 fromLeaseId,
uint256 toLeaseId
) external onlyRole(LEASE_ADMIN_ROLE)// Approve payment
await usdc.approve(rentalContract.address, rentAmount);
// Pay rent
await rentalContract.payRent(leaseId);
// Check new EQTBLT balance
const equity = await eqtbltToken.balanceOf(renterAddress);const { baseRent, lateFee, total, isLate } = await rentalContract.getRentDue(leaseId);
console.log(`Rent due: $${total / 1e6}, Late: ${isLate}`);const equity = await rentalContract.getAccruedEquity(leaseId);
console.log(`Total equity accrued: ${equity} EQTBLT`);await rentalContract.createLease(
propertyId,
renterAddress,
parseUnits("1500", 6), // $1,500/month
1000, // 10% equity rate
Math.floor(Date.now() / 1000), // Start now
365 * 24 * 60 * 60, // 1 year
parseUnits("3000", 6), // $3,000 deposit
7 // Unit 7
);