DVN Contract Reference

interface ILayerZeroDVN {
    struct AssignJobParam {
        uint32 dstEid;          // Destination endpoint ID
        bytes packetHeader;     // Packet header containing routing info
        bytes32 payloadHash;    // Hash of the message payload
        uint64 confirmations;   // Required block confirmations
        address sender;         // OApp sender address
    }

    /// @notice Assigns a verification job to the DVN
    /// @param _param Job parameters including destination and payload hash
    /// @param _options DVN-specific options
    /// @return fee The fee charged for this verification job
    function assignJob(AssignJobParam calldata _param, bytes calldata _options)
        external payable returns (uint256 fee);

    /// @notice Returns the fee for verifying a message
    /// @param _dstEid Destination endpoint ID
    /// @param _confirmations Required block confirmations
    /// @param _sender OApp sender address
    /// @param _options DVN-specific options
    /// @return fee The fee in native tokens
    function getFee(
        uint32 _dstEid,
        uint64 _confirmations,
        address _sender,
        bytes calldata _options
    ) external view returns (uint256 fee);
}

function getFee(
    uint32 _dstEid,
    uint64 _confirmations,
    address _sender,
    bytes calldata _options
) external view returns (uint256 fee)

function hashCallData(
    uint32 _vid,
    address _target,
    bytes calldata _callData,
    uint256 _expiration
) public pure returns (bytes32)

function assignJob(
    AssignJobParam calldata _param,
    bytes calldata _options
) external payable onlyRole(MESSAGE_LIB_ROLE) returns (uint256 totalFee)

function assignJob(
    uint16 _dstEid,
    uint16 _outboundProofType,
    uint64 _confirmations,
    address _sender
) external onlyRole(MESSAGE_LIB_ROLE) returns (uint256 totalFee)

function assignJob(
    address _sender,
    bytes calldata _packetHeader,
    bytes calldata _cmd,
    bytes calldata _options
) external payable onlyRole(MESSAGE_LIB_ROLE) returns (uint256 fee)

function setDstConfig(DstConfigParam[] calldata _params) external onlyRole(ADMIN_ROLE)

function execute(ExecuteParam[] calldata _params) external onlyRole(ADMIN_ROLE)

function withdrawFeeFromUlnV2(
    address _lib,
    address payable _to,
    uint256 _amount
) external onlyRole(ADMIN_ROLE)

function setSigner(address _signer, bool _active) external onlySelf

function setQuorum(uint64 _quorum) external onlySelf

function quorumChangeAdmin(ExecuteParam calldata _param) external

struct DstConfig {
    uint64 gas;              // Base gas cost for verification
    uint16 multiplierBps;    // Fee multiplier in basis points (10000 = 100%)
    uint128 floorMarginUSD;  // Minimum margin in USD (scaled)
}

struct DstConfigParam {
    uint32 dstEid;           // Destination endpoint ID
    uint64 gas;              // Base gas cost
    uint16 multiplierBps;    // Fee multiplier
    uint128 floorMarginUSD;  // Minimum margin
}

struct ExecuteParam {
    uint32 vid;              // DVN instance identifier
    address target;          // Target contract address
    bytes callData;          // Encoded function call
    uint256 expiration;      // Expiration timestamp
    bytes signatures;        // Concatenated signatures
}

struct AssignJobParam {
    uint32 dstEid;           // Destination endpoint ID
    bytes packetHeader;      // Full packet header
    bytes32 payloadHash;     // Hash of message payload
    uint64 confirmations;    // Required block confirmations
    address sender;          // OApp that sent the message
}

struct FeeParams {
    address priceFeed;           // Price feed contract address
    uint32 dstEid;               // Destination endpoint ID
    uint64 confirmations;        // Required confirmations
    address sender;              // OApp sender
    uint64 quorum;               // Current quorum setting
    uint16 defaultMultiplierBps; // Default fee multiplier
}

constructor(
    uint32 _localEidV2,      // Local endpoint V2 ID
    uint32 _vid,             // Unique DVN instance identifier
    address[] memory _messageLibs,  // Initial Message Libraries
    address _priceFeed,      // Price feed contract
    address[] memory _signers,      // Initial multisig signers
    uint64 _quorum,          // Initial quorum requirement
    address[] memory _admins        // Initial admin addresses
)