API Reference

function createEscrow(
    bytes32 userSalt,          // User-provided entropy for address
    address seller,            // Seller address
    address agent,             // Agent (or address(0) for locked)
    address token,             // ERC20 token address
    uint256 amount,            // Escrow amount (in token decimals)
    uint256 buyerProtectionTime, // Time buyer has to review (seconds)
    bytes32 termsHash,         // Hash of PDF terms
    uint256 version,           // Contract version
    address expectedEscrow     // Expected address (safety check)
) external returns (address escrow);

function quoteCreateEscrow(
    bytes32 userSalt,
    address seller,
    address agent,
    address token,
    uint256 amount,
    uint256 buyerProtectionTime
) external view returns (
    address predictedAddress,
    uint256 creationFee,
    uint256 assignmentFee
);

function isEscrow(address addr) external view returns (bool);

function buyer() external view returns (address);
function seller() external view returns (address);
function agent() external view returns (address);
function token() external view returns (address);
function amount() external view returns (uint256);
function state() external view returns (EscrowState);
function termsHash() external view returns (bytes32);
function buyerProtectionTime() external view returns (uint256);
function sellerAcceptDeadline() external view returns (uint256);
function fulfilledAt() external view returns (uint256);
function agentInvitedAt() external view returns (uint256);

function accept() external;

function decline() external;

function cancelExpired() external;

function markFulfilled() external;

function release() external;

function sellerRefund() external;

function claimExpired() external;

function openDispute() external;

function inviteAgent() external;

function claimAgentTimeout() external;

function agentResolve(
    uint256 buyerBps,   // 0-10000
    uint256 sellerBps   // 0-10000, must sum with buyerBps to 10000
) external;

function proposeSplit(
    uint256 buyerBps,
    uint256 sellerBps
) external;

function approveSplit() external;

function executeSplit() external;

function register(
    uint256 stablecoinAmount,
    uint256 tokenAmount,
    uint256 assignmentFeeBps,
    uint256 disputeFeeBps
) external;

function addStake(
    uint256 stablecoinAmount,
    uint256 tokenAmount
) external;

function withdrawStake(
    uint256 stablecoinAmount,
    uint256 tokenAmount
) external;

function setFees(
    uint256 assignmentFeeBps,
    uint256 disputeFeeBps
) external;

function setAvailable() external;
function setUnavailable() external;

function getAgent(address agent) external view returns (
    bool registered,
    bool available,
    uint256 stablecoinStake,
    uint256 tokenStake,
    uint256 assignmentFeeBps,
    uint256 disputeFeeBps,
    uint256 activeCases,
    uint256 lastCaseTimestamp
);

function validateAgentForContract(
    address agent,
    uint256 contractValueWad  // 18-decimal normalized
) external view returns (bool valid);

function getMaxArbitratableValue(
    address agent
) external view returns (uint256 mavWad);

function quoteCreationFee(
    address token,
    uint256 amount
) external view returns (uint256 fee);

function isWhitelisted(address token) external view returns (bool);