taprpc: add pagination and sorting to AddrReceivesRequest

Author: darioAnongba

taprpc/tapcommon.pb.go

@@ -34,3 +34,9 @@ message AssetOutPoint {
     // asset is locked to.
     bytes script_key = 3;
 }
+
+enum SortDirection {
+    SORT_DIRECTION_ASC = 0;
+
+    SORT_DIRECTION_DESC = 1;
+}

taprpc/tapcommon.proto

@@ -1513,6 +1513,15 @@ message AddrReceivesRequest {
 
     // Filter receives by a specific status. Leave empty to get all receives.
     AddrEventStatus filter_status = 2;
+
+    // The number of events to skip.
+    int32 offset = 3;
+
+    // The max number of events returned.
+    int32 limit = 4;
+
+    // The direction of the page. Sorted by creation time.
+    SortDirection direction = 5;
 }
 
 message AddrReceivesResponse {

taprpc/taprootassets.pb.go

@@ -1288,6 +1288,20 @@
         "filter_status": {
           "$ref": "#/definitions/taprpcAddrEventStatus",
           "description": "Filter receives by a specific status. Leave empty to get all receives."
+        },
+        "offset": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The number of events to skip."
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The max number of events returned."
+        },
+        "direction": {
+          "$ref": "#/definitions/taprpcSortDirection",
+          "description": "The direction of the page. Sorted by creation time."
         }
       }
     },
@@ -2669,6 +2683,14 @@
         }
       }
     },
+    "taprpcSortDirection": {
+      "type": "string",
+      "enum": [
+        "SORT_DIRECTION_ASC",
+        "SORT_DIRECTION_DESC"
+      ],
+      "default": "SORT_DIRECTION_ASC"
+    },
     "taprpcSplitCommitment": {
       "type": "object",
       "properties": {