// SPDX-License-Identifier: MIT pragma solidity ^0.8.30; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol"; /// @notice PACT's Base mainnet escrow for Circle-native USDC. No owner, upgrades, fees, or admin withdrawals. /// @dev A paid receipt proves a transfer and the client's approval, not independent work quality. contract PactMainnetEscrow is ReentrancyGuard { using SafeERC20 for IERC20; uint256 public constant CHAIN_ID = 8453; uint256 public constant MAX_TOTAL = 1_000_000 * 1e6; uint256 public constant MAX_DELEGATION = 90 days; uint8 public constant SUBMIT = 1; uint8 public constant REVIEW = 2; IERC20 public constant token = IERC20(0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); uint256 public totalEscrowed; // Agreement statuses: 1 funded/unaccepted, 2 active, 3 completed, 4 refunded. struct Agreement { address client; address provider; bytes32 termsHash; uint64 refundAfter; uint8 milestoneCount; uint8 currentMilestone; uint8 status; uint256 total; uint256 remaining; } // Milestone statuses: 0 pending, 1 submitted, 2 revision requested, 3 paid. struct Milestone { uint256 amount; uint8 status; bytes32 evidenceHash; } struct Delegate { uint8 permissions; uint64 expiresAt; uint256 allowance; } struct Reputation { uint256 completedAgreements; uint256 paidMilestones; uint256 totalReceived; uint256 uniqueClients; } mapping(bytes32 => Agreement) private agreements; mapping(bytes32 => mapping(uint256 => Milestone)) private milestones; mapping(bytes32 => mapping(address => mapping(address => Delegate))) private delegates; mapping(address => Reputation) private reputation; mapping(address => mapping(address => bool)) private paidCounterparties; mapping(bytes32 => address) public cancellationRequestedBy; error WrongNetwork(); error InvalidToken(); error InvalidTerms(); error AgreementExists(); error AgreementMissing(); error Unauthorized(); error InvalidState(); error InvalidDelegate(); error AllowanceExceeded(); error TooEarly(); error AcceptanceExpired(); error UnsupportedTokenTransfer(); event AgreementFunded(bytes32 indexed id, address indexed client, address indexed provider, bytes32 termsHash, uint256 total, uint8 milestoneCount, uint64 refundAfter); event AgreementAccepted(bytes32 indexed id, address indexed provider); event EvidenceSubmitted(bytes32 indexed id, uint8 indexed milestone, bytes32 evidenceHash, address indexed actor); event RevisionRequested(bytes32 indexed id, uint8 indexed milestone, address indexed actor); event MilestonePaid(bytes32 indexed id, uint8 indexed milestone, address indexed provider, address client, uint256 amount, bytes32 evidenceHash, address actor); event AgreementCompleted(bytes32 indexed id, address indexed provider, address indexed client, bytes32 termsHash, uint256 total); event RemainingRefunded(bytes32 indexed id, address indexed client, uint256 amount, address indexed actor); event DelegateSet(bytes32 indexed id, address indexed principal, address indexed operator, uint8 permissions, uint64 expiresAt, uint256 allowance); event CancellationRequested(bytes32 indexed id, address indexed requester); event CancellationWithdrawn(bytes32 indexed id, address indexed requester); constructor() { if (block.chainid != CHAIN_ID) revert WrongNetwork(); if (address(token).code.length == 0 || IERC20Metadata(address(token)).decimals() != 6) revert InvalidToken(); } function createAgreement(bytes32 id, address provider, uint256[] calldata amounts, bytes32 termsHash, uint64 refundAfter) external nonReentrant { if (agreements[id].client != address(0)) revert AgreementExists(); // The payer owns the first 20 bytes of its namespace; outsiders cannot squat a pending id. if (address(uint160(uint256(id) >> 96)) != msg.sender) revert InvalidTerms(); if (id == bytes32(0) || termsHash == bytes32(0) || provider == address(0) || provider == msg.sender || amounts.length == 0 || amounts.length > 10) revert InvalidTerms(); if (refundAfter < block.timestamp + 15 minutes || refundAfter > block.timestamp + 365 days) revert InvalidTerms(); uint256 total; for (uint256 i; i < amounts.length; ++i) { if (amounts[i] == 0 || amounts[i] > MAX_TOTAL) revert InvalidTerms(); total += amounts[i]; milestones[id][i] = Milestone(amounts[i], 0, bytes32(0)); } if (total > MAX_TOTAL) revert InvalidTerms(); agreements[id] = Agreement(msg.sender, provider, termsHash, refundAfter, uint8(amounts.length), 0, 1, total, total); totalEscrowed += total; uint256 beforeBalance = token.balanceOf(address(this)); token.safeTransferFrom(msg.sender, address(this), total); if (token.balanceOf(address(this)) != beforeBalance + total) revert UnsupportedTokenTransfer(); emit AgreementFunded(id, msg.sender, provider, termsHash, total, uint8(amounts.length), refundAfter); } function accept(bytes32 id) external { Agreement storage agreement = _agreement(id); if (msg.sender != agreement.provider) revert Unauthorized(); if (agreement.status != 1) revert InvalidState(); if (block.timestamp >= agreement.refundAfter) revert AcceptanceExpired(); agreement.status = 2; emit AgreementAccepted(id, msg.sender); } function submit(bytes32 id, uint8 index, bytes32 previousEvidence, bytes32 evidenceHash) external { Agreement storage agreement = _reviewed(id, index, previousEvidence); if (agreement.status != 2) revert InvalidState(); if (msg.sender != agreement.provider) _delegate(id, agreement.provider, SUBMIT); if (evidenceHash == bytes32(0)) revert InvalidTerms(); Milestone storage milestone = milestones[id][agreement.currentMilestone]; if (milestone.status != 0 && milestone.status != 2) revert InvalidState(); milestone.evidenceHash = evidenceHash; milestone.status = 1; emit EvidenceSubmitted(id, agreement.currentMilestone, evidenceHash, msg.sender); } function requestRevision(bytes32 id, uint8 index, bytes32 evidenceHash) external { Agreement storage agreement = _reviewed(id, index, evidenceHash); if (agreement.status != 2) revert InvalidState(); if (msg.sender != agreement.client) _delegate(id, agreement.client, REVIEW); Milestone storage milestone = milestones[id][agreement.currentMilestone]; if (milestone.status != 1) revert InvalidState(); milestone.status = 2; emit RevisionRequested(id, agreement.currentMilestone, msg.sender); } function release(bytes32 id, uint8 index, bytes32 evidenceHash) external nonReentrant { Agreement storage agreement = _reviewed(id, index, evidenceHash); if (agreement.status != 2) revert InvalidState(); Milestone storage milestone = milestones[id][index]; if (milestone.status != 1) revert InvalidState(); uint256 amount = milestone.amount; if (msg.sender != agreement.client) { Delegate storage permission = _delegate(id, agreement.client, REVIEW); if (permission.allowance < amount) revert AllowanceExceeded(); permission.allowance -= amount; } milestone.status = 3; agreement.remaining -= amount; agreement.currentMilestone++; totalEscrowed -= amount; Reputation storage record = reputation[agreement.provider]; record.paidMilestones++; record.totalReceived += amount; if (!paidCounterparties[agreement.provider][agreement.client]) { paidCounterparties[agreement.provider][agreement.client] = true; record.uniqueClients++; } if (agreement.currentMilestone == agreement.milestoneCount) { agreement.status = 3; record.completedAgreements++; delete cancellationRequestedBy[id]; } token.safeTransfer(agreement.provider, amount); emit MilestonePaid(id, index, agreement.provider, agreement.client, amount, milestone.evidenceHash, msg.sender); if (agreement.status == 3) emit AgreementCompleted(id, agreement.provider, agreement.client, agreement.termsHash, agreement.total); } /// @notice Provider may return all unpaid funds. Paid milestones cannot be reversed. function refundRemaining(bytes32 id, uint256 expectedRemaining) external nonReentrant { Agreement storage agreement = _agreement(id); if (agreement.remaining != expectedRemaining) revert InvalidState(); if (msg.sender != agreement.provider) revert Unauthorized(); _refund(id, agreement); } /// @notice An unaccepted offer can be reclaimed by its client after the acceptance deadline. function refundUnaccepted(bytes32 id) external nonReentrant { Agreement storage agreement = _agreement(id); if (msg.sender != agreement.client) revert Unauthorized(); if (agreement.status != 1) revert InvalidState(); if (block.timestamp < agreement.refundAfter) revert TooEarly(); _refund(id, agreement); } function requestCancellation(bytes32 id) external { Agreement storage agreement = _agreement(id); _party(agreement); if (agreement.status != 1 && agreement.status != 2) revert InvalidState(); if (cancellationRequestedBy[id] != address(0)) revert InvalidState(); cancellationRequestedBy[id] = msg.sender; emit CancellationRequested(id, msg.sender); } function approveCancellation(bytes32 id, uint256 expectedRemaining) external nonReentrant { Agreement storage agreement = _agreement(id); if (agreement.remaining != expectedRemaining) revert InvalidState(); _party(agreement); address requester = cancellationRequestedBy[id]; if (requester == address(0) || requester == msg.sender) revert Unauthorized(); _refund(id, agreement); } function withdrawCancellation(bytes32 id) external { if (cancellationRequestedBy[id] != msg.sender) revert Unauthorized(); delete cancellationRequestedBy[id]; emit CancellationWithdrawn(id, msg.sender); } /// @notice Each party can delegate only its own role, for one agreement, with an explicit expiry. /// @param allowance Maximum remaining USDC base units a client delegate may release (six decimals). function setDelegate(bytes32 id, address operator, uint8 permissions, uint64 expiresAt, uint256 allowance) external { Agreement storage agreement = _agreement(id); _party(agreement); if (agreement.status != 1 && agreement.status != 2) revert InvalidState(); if (operator == address(0) || operator == agreement.client || operator == agreement.provider) revert InvalidDelegate(); if (permissions == 0) { delete delegates[id][msg.sender][operator]; emit DelegateSet(id, msg.sender, operator, 0, 0, 0); return; } uint8 ownPermission = msg.sender == agreement.client ? REVIEW : SUBMIT; if (permissions != ownPermission || expiresAt <= block.timestamp || expiresAt > block.timestamp + MAX_DELEGATION) revert InvalidDelegate(); if ((ownPermission == SUBMIT && allowance != 0) || allowance > agreement.remaining) revert InvalidDelegate(); delegates[id][msg.sender][operator] = Delegate(permissions, expiresAt, allowance); emit DelegateSet(id, msg.sender, operator, permissions, expiresAt, allowance); } function getAgreement(bytes32 id) external view returns (Agreement memory) { return agreements[id]; } function getMilestone(bytes32 id, uint256 index) external view returns (Milestone memory) { if (agreements[id].client == address(0)) revert AgreementMissing(); if (index >= agreements[id].milestoneCount) revert InvalidTerms(); return milestones[id][index]; } function getDelegate(bytes32 id, address principal, address operator) external view returns (Delegate memory) { return delegates[id][principal][operator]; } function getReputation(address provider) external view returns (Reputation memory) { return reputation[provider]; } function _agreement(bytes32 id) private view returns (Agreement storage agreement) { agreement = agreements[id]; if (agreement.client == address(0)) revert AgreementMissing(); } /// @dev Bind wallet authorizations to the milestone and evidence visible when signing. function _reviewed(bytes32 id, uint8 index, bytes32 evidenceHash) private view returns (Agreement storage agreement) { agreement = _agreement(id); if (agreement.currentMilestone != index || milestones[id][index].evidenceHash != evidenceHash) revert InvalidState(); } function _party(Agreement storage agreement) private view { if (msg.sender != agreement.client && msg.sender != agreement.provider) revert Unauthorized(); } function _delegate(bytes32 id, address principal, uint8 permission) private view returns (Delegate storage result) { result = delegates[id][principal][msg.sender]; if (result.permissions & permission == 0 || result.expiresAt <= block.timestamp) revert Unauthorized(); } function _refund(bytes32 id, Agreement storage agreement) private { if (agreement.status != 1 && agreement.status != 2) revert InvalidState(); uint256 amount = agreement.remaining; agreement.remaining = 0; agreement.status = 4; totalEscrowed -= amount; delete cancellationRequestedBy[id]; token.safeTransfer(agreement.client, amount); emit RemainingRefunded(id, agreement.client, amount, msg.sender); } }