Update C++, Objective-C and Swift examples

1 files changed, 53 insertions, 29 deletions

diff --git a/examples/cpp/earthtest.cpp b/examples/cpp/earthtest.cpp
index a6dff6a..89ee426 100644
--- a/examples/cpp/earthtest.cpp
+++ b/examples/cpp/earthtest.cpp
@@ -12,7 +12,7 @@
  *   the location given in the first argument to zts_start(path, ...). If you accidentally
  *   duplicate the identity files and use them simultaneously in a different node instance
  *   you will experience undefined behavior and it is likely nothing will work.
- * 
+ *
  * - You must authorize the node ID provided by the ZTS_EVENT_NODE_ONLINE callback to join
  *   your network, otherwise nothing will happen. This can be done manually or via
  *   our web API: https://my.zerotier.com/help/api
@@ -51,12 +51,12 @@
  *   Category 1: Control functions (zts_start, zts_join, zts_get_peer_status, etc). Errors
  *                returned by these functions can be any of the following:
  *
- *      ZTS_ERR_OK            0 // No error
- *      ZTS_ERR_SOCKET       -1 // Socket error, see zts_errno
- *      ZTS_ERR_SERVICE      -2 // You probably did something at the wrong time
- *      ZTS_ERR_ARG          -3 // Invalid argument
- *      ZTS_ERR_NO_RESULT    -4 // No result (not necessarily an error)
- *      ZTS_ERR_GENERAL      -5 // Consider filing a bug report
+ *      ZTS_ERR_OK            // No error
+ *      ZTS_ERR_SOCKET        // Socket error, see zts_errno
+ *      ZTS_ERR_SERVICE       // You probably did something at the wrong time
+ *      ZTS_ERR_ARG           // Invalid argument
+ *      ZTS_ERR_NO_RESULT     // No result (not necessarily an error)
+ *      ZTS_ERR_GENERAL       // Consider filing a bug report
  *
  *   Category 2: Sockets (zts_socket, zts_bind, zts_connect, zts_listen, etc).
  *               Errors returned by these functions can be the same as the above. With
@@ -74,7 +74,7 @@
  *   are a few guidelines:
  *
  *   If you are calling a zts_* function, use the appropriate ZTS_* constants:
- *             
+ *
  *          zts_socket(ZTS_AF_INET6, ZTS_SOCK_DGRAM, 0); (CORRECT)
  *          zts_socket(AF_INET6, SOCK_DGRAM, 0);         (INCORRECT)
  *
@@ -91,25 +91,35 @@
 
 #include "ZeroTierSockets.h"
 
-bool nodeReady = false;
-bool networkReady = false;
+struct Node
+{
+	Node() : online(false), joinedAtLeastOneNetwork(false), id(0) {}
+	bool online;
+	bool joinedAtLeastOneNetwork;
+	uint64_t id;
+	// etc
+} myNode;
 
-// Example callbacks
+/* Callback handler, you should return control from this function as quickly as you can
+to ensure timely receipt of future events. You should not call libzt API functions from
+this function unless it's something trivial like zts_inet_ntop() or similar that has
+no state-change implications. */
 void myZeroTierEventCallback(void *msgPtr)
 {
 	struct zts_callback_msg *msg = (struct zts_callback_msg *)msgPtr;
 
 	if (msg->eventCode == ZTS_EVENT_NODE_ONLINE) {
 		printf("ZTS_EVENT_NODE_ONLINE --- This node's ID is %llx\n", msg->node->address);
-		nodeReady = true;
+		myNode.id = msg->node->address;
+		myNode.online = true;
 	}
 	if (msg->eventCode == ZTS_EVENT_NODE_OFFLINE) {
 		printf("ZTS_EVENT_NODE_OFFLINE --- Check your physical Internet connection, router, firewall, etc. What ports are you blocking?\n");
-		nodeReady = false;
+		myNode.online = false;
 	}
 	if (msg->eventCode == ZTS_EVENT_NETWORK_REQ_CONFIG) {
 		printf("ZTS_EVENT_NETWORK_REQ_CONFIG --- Requesting config for network %llx, please wait a few seconds...\n", msg->network->nwid);
-	} 
+	}
 	if (msg->eventCode == ZTS_EVENT_NETWORK_ACCESS_DENIED) {
 		printf("ZTS_EVENT_NETWORK_ACCESS_DENIED --- Access to virtual network %llx has been denied. Did you authorize the node yet?\n",
 			msg->network->nwid);
@@ -117,7 +127,7 @@ void myZeroTierEventCallback(void *msgPtr)
 	if (msg->eventCode == ZTS_EVENT_NETWORK_READY_IP6) {
 		printf("ZTS_EVENT_NETWORK_READY_IP6 --- Network config received. IPv6 traffic can now be sent over network %llx\n",
 			msg->network->nwid);
-		networkReady = true;
+		myNode.joinedAtLeastOneNetwork = true;
 	}
 	if (msg->eventCode == ZTS_EVENT_NETWORK_DOWN) {
 		printf("ZTS_EVENT_NETWORK_DOWN --- %llx\n", msg->network->nwid);
@@ -126,28 +136,42 @@ void myZeroTierEventCallback(void *msgPtr)
 		char ipstr[ZTS_INET_ADDRSTRLEN];
 		struct zts_sockaddr_in *in4 = (struct zts_sockaddr_in*)&(msg->addr->addr);
 		zts_inet_ntop(ZTS_AF_INET, &(in4->sin_addr), ipstr, ZTS_INET_ADDRSTRLEN);
-		printf("ZTS_EVENT_ADDR_NEW_IP4 --- Join %llx and ping me at %s\n", 
+		printf("ZTS_EVENT_ADDR_NEW_IP4 --- Join %llx and ping me at %s\n",
 			msg->addr->nwid, ipstr);
 	}
 	if (msg->eventCode == ZTS_EVENT_ADDR_ADDED_IP6) {
 		char ipstr[ZTS_INET6_ADDRSTRLEN];
 		struct zts_sockaddr_in6 *in6 = (struct zts_sockaddr_in6*)&(msg->addr->addr);
 		zts_inet_ntop(ZTS_AF_INET6, &(in6->sin6_addr), ipstr, ZTS_INET6_ADDRSTRLEN);
-		printf("ZTS_EVENT_ADDR_NEW_IP6 --- Join %llx and ping me at %s\n", 
+		printf("ZTS_EVENT_ADDR_NEW_IP6 --- Join %llx and ping me at %s\n",
 			msg->addr->nwid, ipstr);
 	}
-	// Don't worry if you don't recognize a peer ID, it's most likely our infrastructure
-	if (msg->eventCode == ZTS_EVENT_PEER_DIRECT) {
-		printf("ZTS_EVENT_PEER_DIRECT --- There is now a direct path to peer %llx\n",
-			msg->peer->address);
-	}
-	if (msg->eventCode == ZTS_EVENT_PEER_RELAY) {
-		printf("ZTS_EVENT_PEER_RELAY --- No direct path to peer %llx\n",
-			msg->peer->address);
+	// Peer events
+	if (msg->peer) {
+		if (msg->peer->role == ZTS_PEER_ROLE_PLANET) {
+			/* Safe to ignore, these are our roots. They orchestrate the P2P connection.
+			You might also see other unknown peers, these are our network controllers. */
+			return;
+		}
+		if (msg->eventCode == ZTS_EVENT_PEER_DIRECT) {
+			printf("ZTS_EVENT_PEER_DIRECT --- A direct path is known for node=%llx\n",
+				msg->peer->address);
+		}
+		if (msg->eventCode == ZTS_EVENT_PEER_RELAY) {
+			printf("ZTS_EVENT_PEER_RELAY --- No direct path to node=%llx\n", msg->peer->address);
+		}
+		if (msg->eventCode == ZTS_EVENT_PEER_PATH_DISCOVERED) {
+			printf("ZTS_EVENT_PEER_PATH_DISCOVERED --- A new direct path was discovered for node=%llx\n",
+				msg->peer->address);
+		}
+		if (msg->eventCode == ZTS_EVENT_PEER_PATH_DEAD) {
+			printf("ZTS_EVENT_PEER_PATH_DEAD --- A direct path has died for node=%llx\n",
+				msg->peer->address);
+		}
 	}
 }
 
-int main(int argc, char **argv) 
+int main(int argc, char **argv)
 {
 	if (argc != 3) {
 		printf("\nlibzt example\n");
@@ -155,7 +179,7 @@ int main(int argc, char **argv)
 		exit(0);
 	}
 	int ztServicePort = atoi(argv[2]); // Port ZT uses to send encrypted UDP packets to peers (try something like 9994)
-	
+
 	int err = ZTS_ERR_OK;
 	zts_allow_network_caching(false);
 
@@ -164,7 +188,7 @@ int main(int argc, char **argv)
 		exit(1);
 	}
 	printf("Waiting for node to come online...\n");
-	while (!nodeReady) { zts_delay_ms(50); }
+	while (!myNode.online) { zts_delay_ms(50); }
 	printf("This node's identity is stored in %s\n", argv[1]);
 
 	uint64_t nwid = 0x8056c2e21c000001;
@@ -174,7 +198,7 @@ int main(int argc, char **argv)
 		exit(1);
 	}
 	printf("Joining network %llx\n", nwid);
-	while (!networkReady) { zts_delay_ms(50); }
+	while (!myNode.joinedAtLeastOneNetwork) { zts_delay_ms(50); }
 
 	// Idle and just show callback events, stack statistics, etc