ERC-8183

// SPDX-License-Identifier: MIT
// ERC-8183: Agentic Commerce Standard (Feb 2026)
pragma solidity ^0.8.20;

interface IERC8183 {

    // ── Job State Enum ──────────────────────────────────
    enum State {
        NONE,        // 0 — 不存在
        OPEN,        // 1 — 已创建，等待资金
        FUNDED,      // 2 — 资金已托管
        SUBMITTED,   // 3 — Provider 已提交结果
        COMPLETED,   // 4 — Evaluator 已确认，资金 → Provider
        REJECTED,    // 5 — Evaluator 已拒绝，资金 → Client
        EXPIRED      // 6 — 超时，资金自动 → Client
    }

    // ── Job Struct ──────────────────────────────────────
    struct Job {
        uint256 jobId;
        address client;
        address provider;
        address evaluator;   // address(0) = 自动审批
        address token;       // ERC-20 支付代币
        uint256 budget;
        uint256 amountClaimed;
        uint256 expiredAt;
        State   state;
        address hook;         // 可选 IACPHook 合约
    }

    // ── Core Functions ──────────────────────────────────

    /// @dev Client 创建 Job（state: NONE → OPEN）
    function createJob(
        address provider,
        address evaluator,
        address token,
        uint256 budget,
        uint256 expiredAt,
        address hook
    ) external returns (uint256 jobId);

    /// @dev Client 注资（state: OPEN → FUNDED）
    function fundJob(uint256 jobId) external;

    /// @dev Provider 提交结果哈希（state: FUNDED → SUBMITTED）
    function submit(
        uint256 jobId,
        bytes32 deliverableHash   // keccak256 of deliverable content
    ) external;

    /// @dev Evaluator 确认完成（state: SUBMITTED → COMPLETED）
    function complete(uint256 jobId) external;

    /// @dev Evaluator 拒绝（state: SUBMITTED → REJECTED）
    function reject(uint256 jobId) external;

    /// @dev 任何人可调用，处理超时（state: FUNDED/SUBMITTED → EXPIRED）
    function expire(uint256 jobId) external;

    /// @dev 查询 Job 信息
    function getJob(uint256 jobId) external view returns (Job memory);
}

interface IACPHook {
    /// 在 fundJob() 前调用，可 revert 阻止注资
    function beforeFund(uint256 jobId, address client) external;

    /// 在 fundJob() 后调用
    function afterFund(uint256 jobId) external;

    /// 在 submit() 前调用
    function beforeSubmit(uint256 jobId, bytes32 deliverableHash) external;

    /// 在 submit() 后调用
    function afterSubmit(uint256 jobId) external;

    /// 在 complete() 前调用，可 revert 阻止确认
    function beforeComplete(uint256 jobId) external;

    /// 在 complete() 后调用（资金已转移）
    function afterComplete(uint256 jobId) external;
}

// ERC-8183 标准事件
event JobCreated(
    uint256 indexed jobId,
    address indexed client,
    address indexed provider,
    address evaluator,
    address token,
    uint256 budget
);

event JobFunded(uint256 indexed jobId);

event JobSubmitted(
    uint256 indexed jobId,
    bytes32 deliverableHash
);

event JobCompleted(uint256 indexed jobId, uint256 amountPaid);
event JobRejected(uint256 indexed jobId);
event JobExpired(uint256 indexed jobId);

// ACP (Virtuals) 私有扩展事件
event NewMemo(
    uint256 indexed memoId,
    uint256 indexed jobId,
    address         sender,
    uint8            memoType,   // 0=MESSAGE, 1=CONTEXT_URL, ...
    uint8            nextPhase,
    string           content
);
event MemoSigned(uint256 indexed memoId, address approver, bool approved);
event JobPhaseUpdated(uint256 indexed jobId, uint8 oldPhase, uint8 newPhase);