Pages: Created Genesis Block and Address pages.

Author: lexzaiello

swift-polaris-playground.playground/Pages/Exploring the Dag.xcplaygroundpage/Contents.swift

@@ -1,7 +1,55 @@
-//: [Previous](@previous)
+/*:
+ # Exploring the Dag
+ 
+ To enable easy and efficient verification, the Polaris ledger is kept public and open. Since transactions on Polaris don't have fees, endless information can be stored on the network. Being able to traverse and analyze this information is key to the effective usage of the network.
+ 
+ ## The Dag API
+ 
+ In addition to several other APIs, Swift-Polaris also provides a useful DAG API, that of which contains several methods for traversing, filtering, and querying through the dag.
+ 
+ To get started, let's initialize an instance of the Swift-Polaris API.
+*/
 
 import Foundation
+import PlaygroundSupport
+import UIKit
 
-var str = "Hello, playground"
+var api: API // Init API instance buffer
+
+API.Offline = API.Offline // Just a reminder to set to true for offline capability (make sure to run run_polaris.sh [node needs to be up!])
+
+if API.Offline { // Check is offline
+    api = API(apiURI: "https://localhost:8000") // Initialize API instance
+} else {
+    api = API(apiURI: "https://108.41.124.60:8000") // Initialize API instance
+}
+
+/*:
+ ## GetBestTransaction
+ 
+ The GetBestTransaction() method is key to the proper function of the Polaris network. Without it, the network would never reach consensus. In our case, GetBestTransaction() should give us the hash of the transaction you published in [Publishing Transactions](Publishing%20Transactions).
+*/
+
+let baseView = DemoView(frame: CGRect(x: 0, y: 0, width: 500, height: 500)) // Bg
+
+let bestTransactionHash = api.Dag.GetBestTransaction().0!["message"] as! String // Get best transaction
+
+print("found best transaction with hash \(bestTransactionHash)") // Log best tx
+
+baseView.Say(s: "🔎 found best transaction \(String(bestTransactionHash.prefix(8)) + "...")") // Display best tx
+
+PlaygroundPage.current.liveView = baseView // Set live view
+PlaygroundPage.current.needsIndefiniteExecution = true // Keep
+
+/*:
+ * Experiment:
+ Try [making another transaction](Publishing%20Transactions)!
+    - Check back with the assistant editor and see if the best transaction hash has changed. 🕵️‍♀️🤫
+ */
+
+/*:
+ ## Genesis Block
+ 
+ Although Polaris doesn't have blocks per say, Polaris still has a genesis. In the [next activity](Genesis%20Block), we'll see what the genesis is and what it does.
+*/
 
-//: [Next](@next)

swift-polaris-playground.playground/Pages/Genesis Address.xcplaygroundpage/Contents.swift

@@ -0,0 +1,34 @@
+/*:
+ # Genesis Address
+ 
+ To find the genesis address, let's initialize a new Swift-Polaris instance.
+ */
+
+import Foundation
+import PlaygroundSupport
+import UIKit
+
+var api: API // Init API instance buffer
+
+API.Offline = API.Offline // Just a reminder to set to true for offline capability (make sure to run run_polaris.sh [node needs to be up!])
+
+if API.Offline { // Check is offline
+    api = API(apiURI: "https://localhost:8000") // Initialize API instance
+} else {
+    api = API(apiURI: "https://108.41.124.60:8000") // Initialize API instance
+}
+
+/*:
+ As we've found earlier, the dag API can help us analyze data on the ledger. As a party of "data analysis", we can calculate the balance of a particular address. Let's do it with the genesis.
+ */
+
+let baseView = DemoView(frame: CGRect(x: 0, y: 0, width: 500, height: 500)) // Bg
+
+let genesisBalance = api.Dag.CalculateAddressBalance(address: "e3891ace0bce06b4acaddcbe47afecdbdcae1fb6").0!["message"] as! String // Get genesis transaction hash
+
+print("found genesis balance \(genesisBalance)") // Log genesis
+
+baseView.Say(s: "💸 found genesis balance: \(genesisBalance)") // Display found balance
+
+PlaygroundPage.current.liveView = baseView // Set live view
+PlaygroundPage.current.needsIndefiniteExecution = true // Keep

swift-polaris-playground.playground/Pages/Genesis Block.xcplaygroundpage/Contents.swift

@@ -0,0 +1,42 @@
+/*:
+ # Genesis Block
+ 
+ Unlike many other cryptocurrencies, Polaris does not have a genesis block, as it does not have blocks. Polaris does, however, have a genesis transaction set.
+ 
+ ## Finding the Genesis
+ 
+ Let's try using the skills we learned in the last excercise to find the genesis transaction set, and see what it did to our dag. In this case, we'll make use of the Dag API by initializing a Swift-Polaris instance.
+*/
+
+import Foundation
+import PlaygroundSupport
+import UIKit
+
+var api: API // Init API instance buffer
+
+API.Offline = API.Offline // Just a reminder to set to true for offline capability (make sure to run run_polaris.sh [node needs to be up!])
+
+if API.Offline { // Check is offline
+    api = API(apiURI: "https://localhost:8000") // Initialize API instance
+} else {
+    api = API(apiURI: "https://108.41.124.60:8000") // Initialize API instance
+}
+
+/*:
+ In order to find the genesis transaction, we'll have to make use of something called the `alloc`. You might have noticed that the resources folder now contains a data/config folder (if you're running a private network). This folder contains a JSON file specifying an `alloc` telling go-polaris where to put the genesis supply. From this alloc, we can find the genesis transaction by querying dag transactions by recipient. To do so, we'll use api.Dag.GetTransactionsByAddress().
+*/
+
+let baseView = DemoView(frame: CGRect(x: 0, y: 0, width: 500, height: 500)) // Bg
+
+let genesisTransactionHash = api.Dag.GetTransactionsByAddress(address: "e3891ace0bce06b4acaddcbe47afecdbdcae1fb6").0!["message"] as! String // Get genesis transaction hash
+
+print("found genesis \(genesisTransactionHash)") // Log genesis
+
+baseView.Say(s: "😆🙌 found genesis \(String(genesisTransactionHash.prefix(12)) + "...")") // Display found genesis
+
+PlaygroundPage.current.liveView = baseView // Set live view
+PlaygroundPage.current.needsIndefiniteExecution = true // Keep
+
+/*:
+ Now, we've found the genesis transaction, but what does it do? Simply put, the genesis transaction forces coins into a particular address without checking for validity. To find the balance of an address pertaining to the genesis, try the following activity: [Genesis Address](Genesis%20Address).
+*/

swift-polaris-playground.playground/Resources/run_polaris.sh

@@ -1,4 +1,4 @@
 mkdir data && mkdir data/config # Make data dir, config dir
-echo '{"alloc":{"e3891ace0bce06b4acaddcbe47afecdbdcae1fb6": 10}, "identifier": "main_net", "network": 0}' > data/config/config_main_net.json # Create Polaris monetary supply config
+echo '{"alloc":{"e3891ace0bce06b4acaddcbe47afecdbdcae1fb6": 100000}, "identifier": "main_net", "network": 0}' > data/config/config_main_net.json # Create Polaris monetary supply config
 chmod +x ./go-polaris # Allow run
 ./go-polaris --network main_net --bootstrap-address localhost # Run polaris without an internet connection!

swift-polaris-playground.playground/contents.xcplayground

@@ -5,5 +5,7 @@
         <page name='Hello, World'/>
         <page name='Publishing Transactions'/>
         <page name='Exploring the Dag'/>
+        <page name='Genesis Block'/>
+        <page name='Genesis Address'/>
     </pages>
 </playground>