Merge branch 'next-version' into delete-covenant

Author: altafan

api-spec/openapi/swagger/ark/v1/explorer.swagger.json

@@ -105,6 +105,45 @@
           "ExplorerService"
         ]
       }
+    },
+    "/v1/vtxos/{address}/subscribe": {
+      "get": {
+        "operationId": "ExplorerService_SubscribeForAddress",
+        "responses": {
+          "200": {
+            "description": "A successful response.(streaming responses)",
+            "schema": {
+              "type": "object",
+              "properties": {
+                "result": {
+                  "$ref": "#/definitions/v1SubscribeForAddressResponse"
+                },
+                "error": {
+                  "$ref": "#/definitions/rpcStatus"
+                }
+              },
+              "title": "Stream result of v1SubscribeForAddressResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "address",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "ExplorerService"
+        ]
+      }
     }
   },
   "definitions": {
@@ -242,6 +281,25 @@
       ],
       "default": "ROUND_STAGE_UNSPECIFIED"
     },
+    "v1SubscribeForAddressResponse": {
+      "type": "object",
+      "properties": {
+        "newVtxos": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/v1Vtxo"
+          }
+        },
+        "spentVtxos": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/v1Vtxo"
+          }
+        }
+      }
+    },
     "v1Tree": {
       "type": "object",
       "properties": {

api-spec/openapi/swagger/ark/v1/service.swagger.json

@@ -531,8 +531,9 @@
           "type": "string",
           "format": "int64"
         },
-        "boardingDescriptorTemplate": {
-          "type": "string"
+        "boardingExitDelay": {
+          "type": "string",
+          "format": "int64"
         },
         "vtxoDescriptorTemplates": {
           "type": "array",
@@ -545,6 +546,9 @@
         },
         "marketHour": {
           "$ref": "#/definitions/v1MarketHour"
+        },
+        "version": {
+          "type": "string"
         }
       }
     },
@@ -677,7 +681,7 @@
           "type": "array",
           "items": {
             "type": "object",
-            "$ref": "#/definitions/v1Outpoint"
+            "$ref": "#/definitions/v1Vtxo"
           }
         },
         "spendableVtxos": {
@@ -686,6 +690,9 @@
             "type": "object",
             "$ref": "#/definitions/v1Vtxo"
           }
+        },
+        "hex": {
+          "type": "string"
         }
       }
     },
@@ -828,7 +835,7 @@
           "type": "array",
           "items": {
             "type": "object",
-            "$ref": "#/definitions/v1Outpoint"
+            "$ref": "#/definitions/v1Vtxo"
           }
         },
         "spendableVtxos": {
@@ -844,6 +851,9 @@
             "type": "object",
             "$ref": "#/definitions/v1Outpoint"
           }
+        },
+        "hex": {
+          "type": "string"
         }
       }
     },

api-spec/protobuf/ark/v1/explorer.proto

@@ -21,6 +21,11 @@ service ExplorerService {
       get: "/v1/vtxos/{address}"
     };
   };
+  rpc SubscribeForAddress(SubscribeForAddressRequest) returns (stream SubscribeForAddressResponse) {
+    option (google.api.http) = {
+      get: "/v1/vtxos/{address}/subscribe"
+    };
+  };
 }
 
 message GetRoundRequest {
@@ -44,3 +49,11 @@ message ListVtxosResponse {
   repeated Vtxo spendable_vtxos = 1;
   repeated Vtxo spent_vtxos = 2;
 }
+
+message SubscribeForAddressRequest {
+  string address = 1;
+}
+message SubscribeForAddressResponse {
+  repeated Vtxo new_vtxos = 2;
+  repeated Vtxo spent_vtxos = 3;
+}

api-spec/protobuf/ark/v1/service.proto

@@ -99,10 +99,11 @@ message GetInfoResponse {
   int64 round_interval = 4;
   string network = 5;
   int64 dust = 6;
-  string boarding_descriptor_template = 7;
+  int64 boarding_exit_delay = 7;
   repeated string vtxo_descriptor_templates = 8;
   string forfeit_address = 9;
   MarketHour market_hour = 10;
+  string version = 11;
 }
 
 message GetBoardingAddressRequest {

api-spec/protobuf/ark/v1/types.proto

@@ -71,15 +71,17 @@ message Vtxo {
 
 message RoundTransaction {
   string txid = 1;
-  repeated Outpoint spent_vtxos = 2;
+  repeated Vtxo spent_vtxos = 2;
   repeated Vtxo spendable_vtxos = 3;
   repeated Outpoint claimed_boarding_utxos = 4;
+  string hex = 5;
 }
 
 message RedeemTransaction {
   string txid = 1;
-  repeated Outpoint spent_vtxos = 2;
+  repeated Vtxo spent_vtxos = 2;
   repeated Vtxo spendable_vtxos = 3;
+  string hex = 4;
 }
 
 // This message is used to prove to the server that the user controls the vtxo without revealing the whole VTXO taproot tree.