From c2b78dba1a8a6c57d016d83158f4d5a1eb9679a8 Mon Sep 17 00:00:00 2001
From: Kacper Sawicki <kacper@ksawicki.pl>
Date: Tue, 9 Jul 2024 14:28:25 +0200
Subject: [PATCH] Add comments

---
 release/go/spacemesh/v2alpha1/tx.pb.go       | 6 +++---
 release/openapi/swagger/src/api.swagger.json | 9 ++++++---
 spacemesh/v2alpha1/tx.proto                  | 6 +++---
 3 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/release/go/spacemesh/v2alpha1/tx.pb.go b/release/go/spacemesh/v2alpha1/tx.pb.go
index 94540c43..7e98a117 100644
--- a/release/go/spacemesh/v2alpha1/tx.pb.go
+++ b/release/go/spacemesh/v2alpha1/tx.pb.go
@@ -501,11 +501,11 @@ type ContentsVaultSpawn struct {
 	sizeCache     protoimpl.SizeCache
 	unknownFields protoimpl.UnknownFields
 
-	Owner               string `protobuf:"bytes,1,opt,name=owner,proto3" json:"owner,omitempty"`
+	Owner               string `protobuf:"bytes,1,opt,name=owner,proto3" json:"owner,omitempty"` // owner account
 	TotalAmount         uint64 `protobuf:"varint,2,opt,name=total_amount,json=totalAmount,proto3" json:"total_amount,omitempty"`
 	InitialUnlockAmount uint64 `protobuf:"varint,3,opt,name=initial_unlock_amount,json=initialUnlockAmount,proto3" json:"initial_unlock_amount,omitempty"`
-	VestingStart        uint32 `protobuf:"varint,4,opt,name=vesting_start,json=vestingStart,proto3" json:"vesting_start,omitempty"`
-	VestingEnd          uint32 `protobuf:"varint,5,opt,name=vesting_end,json=vestingEnd,proto3" json:"vesting_end,omitempty"`
+	VestingStart        uint32 `protobuf:"varint,4,opt,name=vesting_start,json=vestingStart,proto3" json:"vesting_start,omitempty"` // as layer number
+	VestingEnd          uint32 `protobuf:"varint,5,opt,name=vesting_end,json=vestingEnd,proto3" json:"vesting_end,omitempty"`       // as layer number
 }
 
 func (x *ContentsVaultSpawn) Reset() {
diff --git a/release/openapi/swagger/src/api.swagger.json b/release/openapi/swagger/src/api.swagger.json
index a6abdcf6..4c224177 100644
--- a/release/openapi/swagger/src/api.swagger.json
+++ b/release/openapi/swagger/src/api.swagger.json
@@ -947,7 +947,8 @@
           "format": "uint64"
         },
         "owner": {
-          "type": "string"
+          "type": "string",
+          "title": "owner account"
         },
         "totalAmount": {
           "type": "string",
@@ -955,11 +956,13 @@
         },
         "vestingEnd": {
           "type": "integer",
-          "format": "int64"
+          "format": "int64",
+          "title": "as layer number"
         },
         "vestingStart": {
           "type": "integer",
-          "format": "int64"
+          "format": "int64",
+          "title": "as layer number"
         }
       }
     },
diff --git a/spacemesh/v2alpha1/tx.proto b/spacemesh/v2alpha1/tx.proto
index a7c083d1..3b753afd 100644
--- a/spacemesh/v2alpha1/tx.proto
+++ b/spacemesh/v2alpha1/tx.proto
@@ -49,11 +49,11 @@ message ContentsMultiSigSpawn {
 }
 
 message ContentsVaultSpawn {
-  string owner = 1;
+  string owner = 1; // owner account
   uint64 total_amount = 2;
   uint64 initial_unlock_amount = 3;
-  uint32 vesting_start = 4;
-  uint32 vesting_end = 5;
+  uint32 vesting_start = 4; // as layer number
+  uint32 vesting_end = 5; // as layer number
 }
 
 message ContentsDrainVault {