From fc586f1094abb31232c3a1435e2daae7b7ff5208 Mon Sep 17 00:00:00 2001
From: rdlrt <3169068+rdlrt@users.noreply.github.com>
Date: Wed, 31 Jul 2024 09:30:01 +1000
Subject: [PATCH] Add pool_votes to specs and other Minor corrections

---
 specs/results/koiosapi-guild.yaml   | 25 +++++++++++++++----------
 specs/results/koiosapi-mainnet.yaml | 25 +++++++++++++++----------
 specs/results/koiosapi-preprod.yaml | 25 +++++++++++++++----------
 specs/results/koiosapi-preview.yaml | 25 +++++++++++++++----------
 specs/templates/2-api-params.yaml   |  6 +++---
 specs/templates/4-api-schemas.yaml  | 19 ++++++++++++-------
 6 files changed, 75 insertions(+), 50 deletions(-)

diff --git a/specs/results/koiosapi-guild.yaml b/specs/results/koiosapi-guild.yaml
index 332b6b7f..1eb4da1f 100644
--- a/specs/results/koiosapi-guild.yaml
+++ b/specs/results/koiosapi-guild.yaml
@@ -2007,7 +2007,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1s9qaseg7qyum807fcv0hdky9gv0c89tn98t4urjn5ewz57dml0r"
       in: query
       required: true
       allowEmptyValue: false
@@ -2017,7 +2017,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1s9qaseg7qyum807fcv0hdky9gv0c89tn98t4urjn5ewz57dml0r"
       in: query
       required: false
       allowEmptyValue: true
@@ -2027,7 +2027,7 @@ components:
       description: Committee hash in hexadecimal format (hex)
       schema:
         type: string
-      example: "##_committee_hash_param"
+      example: "65d497b875c56ab213586a4006d4f6658970573ea8e2398893857472"
       in: query
       required: false
       allowEmptyValue: true
@@ -4976,7 +4976,7 @@ components:
           deposit:
             type:
               - string
-              - null
+              - 'null'
             description: DRep's registration deposit  in lovelace
             example: 500000000
           active:
@@ -4986,7 +4986,7 @@ components:
           expires_epoch_no:
             type:
               - number
-              - null
+              - 'null'
             description: After which epoch DRep is considered inactive.
             example: 410
           amount:
@@ -5092,6 +5092,11 @@ components:
             enum: ["Yes","No","Abstain"]
             description: Actual Vote casted
             example: "Yes"
+    pool_votes:
+      description: List of all votes casted by requested pool
+      type: array
+      items:
+        $ref: "#/components/schemas/drep_votes/items"
     committee_votes:
       description: List of all votes casted by requested delegated representative (DRep)
       type: array
@@ -5126,31 +5131,31 @@ components:
           ratified_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been ratified at the specfied epoch.
             example: 670
           enacted_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been enacted at the specfied epoch.
             example: 675
           dropped_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been dropped (expired/enacted) at the specfied epoch.
             example: 680
           expired_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been expired at the specfied epoch.
             example: 680
           expiration:
             type:
               - number
-              - null
+              - 'null'
             description: Shows the epoch at which this governance action is expected to expire.
           meta_url:
             $ref: "#/components/schemas/drep_metadata/items/properties/url"
diff --git a/specs/results/koiosapi-mainnet.yaml b/specs/results/koiosapi-mainnet.yaml
index 4fa07fac..d683a670 100644
--- a/specs/results/koiosapi-mainnet.yaml
+++ b/specs/results/koiosapi-mainnet.yaml
@@ -2007,7 +2007,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep17l6sywnwqu9aedd6aumev42w39ln5zfl9nw7j4ak6u8swyrwvz3"
       in: query
       required: true
       allowEmptyValue: false
@@ -2017,7 +2017,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep17l6sywnwqu9aedd6aumev42w39ln5zfl9nw7j4ak6u8swyrwvz3"
       in: query
       required: false
       allowEmptyValue: true
@@ -2027,7 +2027,7 @@ components:
       description: Committee hash in hexadecimal format (hex)
       schema:
         type: string
-      example: "##_committee_hash_param"
+      example: "49fa008218cd619afe6aa8a1a93303f242440722b314f36bda2c2e23"
       in: query
       required: false
       allowEmptyValue: true
@@ -4976,7 +4976,7 @@ components:
           deposit:
             type:
               - string
-              - null
+              - 'null'
             description: DRep's registration deposit  in lovelace
             example: 500000000
           active:
@@ -4986,7 +4986,7 @@ components:
           expires_epoch_no:
             type:
               - number
-              - null
+              - 'null'
             description: After which epoch DRep is considered inactive.
             example: 410
           amount:
@@ -5092,6 +5092,11 @@ components:
             enum: ["Yes","No","Abstain"]
             description: Actual Vote casted
             example: "Yes"
+    pool_votes:
+      description: List of all votes casted by requested pool
+      type: array
+      items:
+        $ref: "#/components/schemas/drep_votes/items"
     committee_votes:
       description: List of all votes casted by requested delegated representative (DRep)
       type: array
@@ -5126,31 +5131,31 @@ components:
           ratified_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been ratified at the specfied epoch.
             example: 670
           enacted_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been enacted at the specfied epoch.
             example: 675
           dropped_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been dropped (expired/enacted) at the specfied epoch.
             example: 680
           expired_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been expired at the specfied epoch.
             example: 680
           expiration:
             type:
               - number
-              - null
+              - 'null'
             description: Shows the epoch at which this governance action is expected to expire.
           meta_url:
             $ref: "#/components/schemas/drep_metadata/items/properties/url"
diff --git a/specs/results/koiosapi-preprod.yaml b/specs/results/koiosapi-preprod.yaml
index 9050a27d..3a8362bb 100644
--- a/specs/results/koiosapi-preprod.yaml
+++ b/specs/results/koiosapi-preprod.yaml
@@ -2007,7 +2007,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1kxtwaqtayj6vklc57u93xayjvkwgvefh8drscqp5a5y6jz7m6rd"
       in: query
       required: true
       allowEmptyValue: false
@@ -2017,7 +2017,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1kxtwaqtayj6vklc57u93xayjvkwgvefh8drscqp5a5y6jz7m6rd"
       in: query
       required: false
       allowEmptyValue: true
@@ -2027,7 +2027,7 @@ components:
       description: Committee hash in hexadecimal format (hex)
       schema:
         type: string
-      example: "##_committee_hash_param"
+      example: "f8f56120e1ec00feb088ece39ef14f07339afeb37b4e949ff12b89ff"
       in: query
       required: false
       allowEmptyValue: true
@@ -4976,7 +4976,7 @@ components:
           deposit:
             type:
               - string
-              - null
+              - 'null'
             description: DRep's registration deposit  in lovelace
             example: 500000000
           active:
@@ -4986,7 +4986,7 @@ components:
           expires_epoch_no:
             type:
               - number
-              - null
+              - 'null'
             description: After which epoch DRep is considered inactive.
             example: 410
           amount:
@@ -5092,6 +5092,11 @@ components:
             enum: ["Yes","No","Abstain"]
             description: Actual Vote casted
             example: "Yes"
+    pool_votes:
+      description: List of all votes casted by requested pool
+      type: array
+      items:
+        $ref: "#/components/schemas/drep_votes/items"
     committee_votes:
       description: List of all votes casted by requested delegated representative (DRep)
       type: array
@@ -5126,31 +5131,31 @@ components:
           ratified_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been ratified at the specfied epoch.
             example: 670
           enacted_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been enacted at the specfied epoch.
             example: 675
           dropped_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been dropped (expired/enacted) at the specfied epoch.
             example: 680
           expired_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been expired at the specfied epoch.
             example: 680
           expiration:
             type:
               - number
-              - null
+              - 'null'
             description: Shows the epoch at which this governance action is expected to expire.
           meta_url:
             $ref: "#/components/schemas/drep_metadata/items/properties/url"
diff --git a/specs/results/koiosapi-preview.yaml b/specs/results/koiosapi-preview.yaml
index d10c0b0a..3bd0d2e9 100644
--- a/specs/results/koiosapi-preview.yaml
+++ b/specs/results/koiosapi-preview.yaml
@@ -2007,7 +2007,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1l9y2naagv0vqvft9szdt5wf94fqnxn5hdsgusdl7rf6vq4djqck"
       in: query
       required: true
       allowEmptyValue: false
@@ -2017,7 +2017,7 @@ components:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "drep1l9y2naagv0vqvft9szdt5wf94fqnxn5hdsgusdl7rf6vq4djqck"
       in: query
       required: false
       allowEmptyValue: true
@@ -2027,7 +2027,7 @@ components:
       description: Committee hash in hexadecimal format (hex)
       schema:
         type: string
-      example: "##_committee_hash_param"
+      example: "7ceede7d6a89e006408e6b7c6acb3dd094b3f6817e43b4a36d01535b"
       in: query
       required: false
       allowEmptyValue: true
@@ -4976,7 +4976,7 @@ components:
           deposit:
             type:
               - string
-              - null
+              - 'null'
             description: DRep's registration deposit  in lovelace
             example: 500000000
           active:
@@ -4986,7 +4986,7 @@ components:
           expires_epoch_no:
             type:
               - number
-              - null
+              - 'null'
             description: After which epoch DRep is considered inactive.
             example: 410
           amount:
@@ -5092,6 +5092,11 @@ components:
             enum: ["Yes","No","Abstain"]
             description: Actual Vote casted
             example: "Yes"
+    pool_votes:
+      description: List of all votes casted by requested pool
+      type: array
+      items:
+        $ref: "#/components/schemas/drep_votes/items"
     committee_votes:
       description: List of all votes casted by requested delegated representative (DRep)
       type: array
@@ -5126,31 +5131,31 @@ components:
           ratified_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been ratified at the specfied epoch.
             example: 670
           enacted_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been enacted at the specfied epoch.
             example: 675
           dropped_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been dropped (expired/enacted) at the specfied epoch.
             example: 680
           expired_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been expired at the specfied epoch.
             example: 680
           expiration:
             type:
               - number
-              - null
+              - 'null'
             description: Shows the epoch at which this governance action is expected to expire.
           meta_url:
             $ref: "#/components/schemas/drep_metadata/items/properties/url"
diff --git a/specs/templates/2-api-params.yaml b/specs/templates/2-api-params.yaml
index d0794b0c..0a4ae6bb 100644
--- a/specs/templates/2-api-params.yaml
+++ b/specs/templates/2-api-params.yaml
@@ -85,7 +85,7 @@ parameters:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "##_drep_id_param##"
       in: query
       required: true
       allowEmptyValue: false
@@ -95,7 +95,7 @@ parameters:
       description: DRep ID in bech32 format
       schema:
         type: string
-      example: "##_drep_id_param"
+      example: "##_drep_id_param##"
       in: query
       required: false
       allowEmptyValue: true
@@ -105,7 +105,7 @@ parameters:
       description: Committee hash in hexadecimal format (hex)
       schema:
         type: string
-      example: "##_committee_hash_param"
+      example: "##_committee_hash_param##"
       in: query
       required: false
       allowEmptyValue: true
diff --git a/specs/templates/4-api-schemas.yaml b/specs/templates/4-api-schemas.yaml
index 97da16fa..2c6e7536 100644
--- a/specs/templates/4-api-schemas.yaml
+++ b/specs/templates/4-api-schemas.yaml
@@ -2275,7 +2275,7 @@ schemas:
           deposit:
             type:
               - string
-              - null
+              - 'null'
             description: DRep's registration deposit  in lovelace
             example: 500000000
           active:
@@ -2285,7 +2285,7 @@ schemas:
           expires_epoch_no:
             type:
               - number
-              - null
+              - 'null'
             description: After which epoch DRep is considered inactive.
             example: 410
           amount:
@@ -2391,6 +2391,11 @@ schemas:
             enum: ["Yes","No","Abstain"]
             description: Actual Vote casted
             example: "Yes"
+    pool_votes:
+      description: List of all votes casted by requested pool
+      type: array
+      items:
+        $ref: "#/components/schemas/drep_votes/items"
     committee_votes:
       description: List of all votes casted by requested delegated representative (DRep)
       type: array
@@ -2425,31 +2430,31 @@ schemas:
           ratified_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been ratified at the specfied epoch.
             example: 670
           enacted_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been enacted at the specfied epoch.
             example: 675
           dropped_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been dropped (expired/enacted) at the specfied epoch.
             example: 680
           expired_epoch:
             type:
               - number
-              - null
+              - 'null'
             description: If not null, then this proposal has been expired at the specfied epoch.
             example: 680
           expiration:
             type:
               - number
-              - null
+              - 'null'
             description: Shows the epoch at which this governance action is expected to expire.
           meta_url:
             $ref: "#/components/schemas/drep_metadata/items/properties/url"