Merge pull request #3 from flare-foundation/v0.1.22

Version 0.1.22

Author: fassko

coston/IAgentPing.sol

@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.7.6 <0.9;
+
+interface IAgentPing {
+    /**
+     * Agent bot liveness check.
+     * @param agentVault the agent vault whose owner bot to ping
+     * @param sender the account that triggered ping; helps bot decide whether it is important to answer
+     * @param query off-chain defined id of the query
+     */
+    event AgentPing(
+        address indexed agentVault,
+        address indexed sender,
+        uint256 query);
+
+    /**
+     * Response to agent bot liveness check.
+     * @param agentVault the pinged agent vault
+     * @param owner owner of the agent vault (management address)
+     * @param query repeated `query` from the AgentPing event
+     * @param response response data to the query
+     */
+    event AgentPingResponse(
+        address indexed agentVault,
+        address indexed owner,
+        uint256 query,
+        string response);
+
+    /**
+     * Used for liveness checks, simply emits AgentPing event.
+     * @param _agentVault the agent vault whose owner bot to ping
+     * @param _query off-chain defined id of the query
+     */
+    function agentPing(
+        address _agentVault,
+        uint256 _query
+    ) external;
+
+    /**
+     * Used for liveness checks, the bot's response to AgentPing event.
+     * Simply emits AgentPingResponse event identifying the owner.
+     * NOTE: may only be called by the agent vault owner
+     * @param _agentVault the pinged agent vault
+     * @param _query repeated `_query` from the agentPing
+     * @param _response response data to the query
+     */
+    function agentPingResponse(
+        address _agentVault,
+        uint256 _query,
+        string memory _response
+    ) external;
+}