calculate peer clock drift

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index b7c632d..d1f5935 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1366,6 +1366,10 @@ components:
           oneOf:
             - $ref: '#/components/schemas/Throughput'
             - type: 'null'
+        clock:
+          oneOf:
+            - $ref: '#/components/schemas/ClockOffset'
+            - type: 'null'
 
     Counter:
       type: object
@@ -1433,6 +1437,18 @@ components:
           type: integer
           description: Time spent dormant up to the last return (the current dormancy isn't included).
 
+    ClockOffset:
+      type: object
+      description: How far a peer's clock is ahead of ours, from its PONGs (`measurements.md`, Per peer).
+      required: [offsetMs, withinMs]
+      properties:
+        offsetMs:
+          type: integer
+          description: Ahead of ours; behind if negative.
+        withinMs:
+          type: integer
+          description: Give or take this much (half the round trip).
+
     Throughput:
       type: object
       required: [bytesPerSec, samples, secsAgo]