Architecture

function signalIntent(SignalIntentParams calldata _params)
    external
    whenNotPaused
{
    // Validates intent parameters
    _validateSignalIntent(_params);
    
    // Calculates unique intent hash
    bytes32 intentHash = _calculateIntentHash();
    
    // Stores intent with all parameters
    intents[intentHash] = Intent({
        owner: msg.sender,
        to: _params.to,
        escrow: _params.escrow,
        depositId: _params.depositId,
        amount: _params.amount,
        paymentMethod: _params.paymentMethod,
        fiatCurrency: _params.fiatCurrency,
        conversionRate: _params.conversionRate,
        payeeId: depData.payeeDetails,
        timestamp: block.timestamp,
        referrer: _params.referrer,
        referrerFee: _params.referrerFee,
        postIntentHook: _params.postIntentHook
    });
    
    // Locks funds on escrow
    IEscrow(_params.escrow).lockFunds(_params.depositId, intentHash, _params.amount);
}

function fulfillIntent(FulfillIntentParams calldata _params) 
    external 
    nonReentrant 
    whenNotPaused 
{
    Intent memory intent = intents[_params.intentHash];
    
    // Gets verifier from registry
    address verifier = paymentVerifierRegistry.getVerifier(intent.paymentMethod);
    
    // Verifies payment proof
    IPaymentVerifier.PaymentVerificationResult memory result = 
        IPaymentVerifier(verifier).verifyPayment(
            IPaymentVerifier.VerifyPaymentData({
                intentHash: _params.intentHash,
                paymentProof: _params.paymentProof,
                data: _params.verificationData
            })
        );
    
    if (!result.success) revert PaymentVerificationFailed();
    
    // Unlocks and transfers funds
    IEscrow(intent.escrow).unlockAndTransferFunds(
        intent.depositId, 
        _params.intentHash, 
        result.releaseAmount, 
        address(this)
    );
    
    // Distributes fees and transfers to recipient
    _collectFeesTransferFundsAndExecuteAction(
        deposit.token,
        _params.intentHash,
        intent,
        result.releaseAmount,
        _params.postIntentHookData
    );
}

function _calculateAndTransferFees(
    IERC20 _token,
    Intent memory _intent, 
    uint256 _releaseAmount
) internal returns (uint256 netFees) {
    // Protocol fee (1% default)
    if (protocolFeeRecipient != address(0) && protocolFee > 0) {
        protocolFeeAmount = (_releaseAmount * protocolFee) / PRECISE_UNIT;
        _token.safeTransfer(protocolFeeRecipient, protocolFeeAmount);
    }
    
    // Referrer fee (up to 50%)
    if (_intent.referrer != address(0) && _intent.referrerFee > 0) {
        referrerFeeAmount = (_releaseAmount * _intent.referrerFee) / PRECISE_UNIT;
        _token.safeTransfer(_intent.referrer, referrerFeeAmount);
    }
    
    netFees = protocolFeeAmount + referrerFeeAmount;
}