From b2309cdf48fc8036e2af5e396319969e0bd1fa9c Mon Sep 17 00:00:00 2001
From: Niels Andriesse <andriesseniels@gmail.com>
Date: Wed, 8 May 2019 10:04:19 +1000
Subject: [PATCH] Add LokiAPI.ping(_:)

---
 SignalServiceKit/src/Loki/LokiAPI.swift     | 4 ++++
 SignalServiceKit/src/Loki/LokiMessage.swift | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/SignalServiceKit/src/Loki/LokiAPI.swift b/SignalServiceKit/src/Loki/LokiAPI.swift
index 25a96b6b4..5d261bc90 100644
--- a/SignalServiceKit/src/Loki/LokiAPI.swift
+++ b/SignalServiceKit/src/Loki/LokiAPI.swift
@@ -57,6 +57,10 @@ import PromiseKit
         return getRandomSnode().then { invoke(.sendMessage, on: $0, with: lokiMessage.toJSON()) } // TODO: Use getSwarm()
     }
     
+    public static func ping(_ hexEncodedPublicKey: String) -> Promise<RawResponse> {
+        return getRandomSnode().then { invoke(.sendMessage, on: $0, with: [ "destination" : hexEncodedPublicKey ]) } // TODO: Use getSwarm() and figure out correct parameters
+    }
+    
     public static func getSwarm(for hexEncodedPublicKey: String) -> Promise<Set<Target>> {
         return getRandomSnode().then { invoke(.getSwarm, on: $0, with: [ "pubKey" : hexEncodedPublicKey ]) }.map { rawResponse in return [] } // TODO: Parse targets from raw response
     }
diff --git a/SignalServiceKit/src/Loki/LokiMessage.swift b/SignalServiceKit/src/Loki/LokiMessage.swift
index 8eccefe7f..8b70936e4 100644
--- a/SignalServiceKit/src/Loki/LokiMessage.swift
+++ b/SignalServiceKit/src/Loki/LokiMessage.swift
@@ -8,6 +8,8 @@ public struct LokiMessage {
     /// The time to live for the message.
     let ttl: UInt64
     /// When the proof of work was calculated, if applicable.
+    ///
+    /// - Note: Expressed as seconds since 00:00:00 UTC on 1 January 1970.
     let timestamp: UInt64?
     /// The base 64 encoded proof of work, if applicable.
     let nonce: String?