fix: align OpenAPI spec with the server implementation (#2178)

openapi/Swarm.yaml

@@ -757,83 +757,3 @@ paths:
           $ref: "SwarmCommon.yaml#/components/responses/500"
         default:
           description: Default response
-
-  "/stamps":
-    get:
-      summary: Get all available stamps for this node
-      tags:
-        - Postage Stamps
-      responses:
-        "200":
-          description: Returns an array of all available postage batches.
-          content:
-            application/json:
-              schema:
-                $ref: "SwarmCommon.yaml#/components/schemas/PostageBatchesResponse"
-
-        default:
-          description: Default response
-
-  "/stamps/{id}":
-    parameters:
-      - in: path
-        name: id
-        schema:
-          $ref: "SwarmCommon.yaml#/components/schemas/BatchID"
-        required: true
-        description: Swarm address of the stamp
-    get:
-      summary: Get an individual postage batch status
-      tags:
-        - Postage Stamps
-      responses:
-        "200":
-          description: Returns an individual postage batch state
-          content:
-            application/json:
-              schema:
-                $ref: "SwarmCommon.yaml#/components/schemas/PostageBatch"
-        "400":
-          $ref: "SwarmCommon.yaml#/components/responses/400"
-        default:
-          description: Default response
-
-  "/stamps/{amount}/{depth}":
-    post:
-      summary: Buy a new postage batch. Be aware, this endpoint create an on-chain transactions and transfers BZZ from the node's Ethereum account and hence directly manipulates the wallet balance!
-      tags:
-        - Postage Stamps
-      parameters:
-        - in: path
-          name: amount
-          schema:
-            type: integer
-          required: true
-          description: Amount of BZZ added that the postage batch will have.
-        - in: path
-          name: depth
-          schema:
-            type: integer
-          required: true
-          description: Batch depth which specifies how many chunks can be signed with the batch. It is a logarithm. Must be higher than default bucket depth (16)
-        - in: query
-          name: label
-          schema:
-            type: string
-          required: false
-          description: An optional label for this batch
-        - $ref: "SwarmCommon.yaml#/components/parameters/GasPriceParameter"
-      responses:
-        "201":
-          description: Returns the newly created postage batch ID
-          content:
-            application/json:
-              schema:
-                $ref: "SwarmCommon.yaml#/components/schemas/BatchIDResponse"
-        "400":
-          $ref: "SwarmCommon.yaml#/components/responses/400"
-        "500":
-          $ref: "SwarmCommon.yaml#/components/responses/500"
-        default:
-          description: Default response
-

openapi/SwarmDebug.yaml

@@ -734,5 +734,106 @@ paths:
           $ref: "SwarmCommon.yaml#/components/responses/404"
         "500":
           $ref: "SwarmCommon.yaml#/components/responses/500"
+        default:
+          description: Default response
+
+  "/stamps":
+    get:
+      summary: Get all available stamps for this node
+      tags:
+        - Postage Stamps
+      responses:
+        "200":
+          description: Returns an array of all available postage batches.
+          content:
+            application/json:
+              schema:
+                $ref: "SwarmCommon.yaml#/components/schemas/PostageBatchesResponse"
+
+        default:
+          description: Default response
+
+  "/stamps/{id}":
+    parameters:
+      - in: path
+        name: id
+        schema:
+          $ref: "SwarmCommon.yaml#/components/schemas/BatchID"
+        required: true
+        description: Swarm address of the stamp
+    get:
+      summary: Get an individual postage batch status
+      tags:
+        - Postage Stamps
+      responses:
+        "200":
+          description: Returns an individual postage batch state
+          content:
+            application/json:
+              schema:
+                $ref: "SwarmCommon.yaml#/components/schemas/PostageBatch"
+        "400":
+          $ref: "SwarmCommon.yaml#/components/responses/400"
+        default:
+          description: Default response
+
+  "/stamps/{amount}/{depth}":
+    post:
+      summary: Buy a new postage batch. Be aware, this endpoint create an on-chain transactions and transfers BZZ from the node's Ethereum account and hence directly manipulates the wallet balance!
+      tags:
+        - Postage Stamps
+      parameters:
+        - in: path
+          name: amount
+          schema:
+            type: integer
+          required: true
+          description: Amount of BZZ added that the postage batch will have.
+        - in: path
+          name: depth
+          schema:
+            type: integer
+          required: true
+          description: Batch depth which specifies how many chunks can be signed with the batch. It is a logarithm. Must be higher than default bucket depth (16)
+        - in: query
+          name: label
+          schema:
+            type: string
+          required: false
+          description: An optional label for this batch
+        - $ref: "SwarmCommon.yaml#/components/parameters/GasPriceParameter"
+      responses:
+        "201":
+          description: Returns the newly created postage batch ID
+          content:
+            application/json:
+              schema:
+                $ref: "SwarmCommon.yaml#/components/schemas/BatchIDResponse"
+        "400":
+          $ref: "SwarmCommon.yaml#/components/responses/400"
+        "500":
+          $ref: "SwarmCommon.yaml#/components/responses/500"
+        default:
+          description: Default response
+
+  "/stamps/default/{id}":
+    parameters:
+      - in: path
+        name: id
+        schema:
+          $ref: "SwarmCommon.yaml#/components/schemas/BatchID"
+        required: true
+        description: Swarm address of the stamp
+    put:
+      summary: Set the default postage stamp issuer
+      tags:
+        - Postage Stamps
+      responses:
+        "204":
+          description: The default stamp issuer was updated successfully
+        "400":
+          $ref: "SwarmCommon.yaml#/components/responses/400"
+        "500":
+          $ref: "SwarmCommon.yaml#/components/responses/500"
         default:
           description: Default response
\ No newline at end of file