improve swagger

specifications/api/swagger.yaml

@@ -399,28 +399,25 @@ x-stakePoolId: &stakePoolId
   example: pool1wqaz0q0zhtxlgn0ewssevn2mrtm30fgh2g7hr7z9rj5856457mm
   description: A unique identifier for the pool.
 
-x-drepCred: &drepCred
-  type: string
-  format: bech32
-  example: drep1y2jmg4g450lced7q9n34rq6d5vjwkm0ugx6h0894u6ur92s9txn3a
-  description: |
-    DRep credential which is special byte prepended to script/key hash payload.
-    Introduced by CIP-0129 and the byte prepended is 0x22 and 0x23 for
-    key and script hash, respectively.
-  pattern: "^(drep)1[0-9a-z]*$"
-
 x-drepKeyHashNew: &drepKeyHashNew
   type: string
   format: bech32
   example: drep_vkh15k6929drl7xt0spvudgcxndryn4kmlzpk4meed0xhqe254czjh2
-  description: DRep's verification key hash according to CIP-0105.
+  description: |
+    DRep's verification key hash according to CIP-0105.
+    Replacing now deprecated 'drep' which is now used for drep credential.
   pattern: "^(drep_vkh)1[0-9a-z]*$"
 
 x-drepKeyHash: &drepKeyHash
   type: string
   format: bech32
   example: drep1wqaz0q0zhtxlgn0ewssevn2mrtm30fgh2g7hr7z9rj5856457mm
-  description: DRep's key hash according to CIP-0105 (deprecated).
+  description: |
+    DRep's key hash according to CIP-0105 (deprecated).
+
+    DRep credential which is special byte prepended to script/key hash payload.
+    Introduced by CIP-0129 and the byte prepended is 0x22 and 0x23 for
+    key and script hash, respectively.
   pattern: "^(drep)1[0-9a-z]*$"
 
 x-drepScriptHash: &drepScriptHash
@@ -3001,8 +2998,6 @@ components:
           title: vote to a drep represented by script hash
         - <<: *drepKeyHashNew
           title: vote to a drep represented by key hash
-        - <<: *drepCred
-          title: vote to a drep represented by credential as defined in CIP-0129
 
     ApiWalletDelegationNext: &ApiWalletDelegationNext
       type: object