libp2p: add punching stats

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index bc9652e..6de726c 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1149,6 +1149,15 @@ components:
                   type: [string, 'null']
                   enum: [direct, relayed, null]
                   description: The libp2p connection to it; null if none, or on a transport without connections (Mycelium).
+                punching:
+                  type: object
+                  description: 'While it is connected only through a relay and a hole punch failed: how often in a row, and when the next try is (after 1, 5, then every 30 minutes). Absent otherwise.'
+                  required: [failed, nextInSecs]
+                  properties:
+                    failed:
+                      type: integer
+                    nextInSecs:
+                      type: integer
                 paths:
                   type: array
                   description: Every address it proved itself at, best first, as the paths layer measures them.