This is the
await-tx installment of the Crux tutorial.
We shall assume you have a Crux standalone node set up locally and are now comfortable with
put operations and basic datalog queries.
If this is not the case, you can find all you need to know on Earth, Pluto and Mercury.
Click on a destination above to take you there.
If it’s not fresh in your mind, make sure to follow the gravity option below to get a quick recap.
Last time you opted to leave the solar system on the secret space ship 'Oumuamua on an exciting new adventure. You have been traveling for 25 years at near light speed to reach the star system Gilese 667C. This star system is home to intelligent life far superior to our own. With you on the ship is the captain, Ilex, and your new friend Kaarlang. You were put into cryostasis so you could safely withstand the long journey.
You open your eyes after what feels like only a moment, your 25 year slumber broken by a loud hiss from the opening of the cryogenic pod door.
You take a minute to acknowledge the cold surroundings. You realize the ship engines have fallen still and assume that you are now in geostationary orbit.
Captain Ilex’s voice comes over the intercom.
"" Good morning passengers. And hello new world. We’ve reached the planet Kepra-5 of the Gilese 667C star system.
If you could make your way to the space elevator which is waiting to take you to the planet surface, where you will need to go through customs and get a new passport.
We would like to wish you all the best in your future travels. ""
Finding your way to the space elevator dock, you notice that you feel a lot heavier than usual. You wonder if this is your body being weaker than usual from being in cryostasis for so long, or if this new planet has stronger gravity.
|You want to test this, and are interested to know how the gravity of the planet below compares to planets back in your home solar system.||You think about testing this, but you’re in a rush and want to get your passport as fast as possible.|
You spin up a new Crux node and ingest the known data from the solar system.
The elevator arrives and you drag yourself aboard. As you are carried to the surface, you note the relief as the force of gravity on your body is canceled by the movement of the lift.
As soon as you reach the surface, you waste no time in taking the gravity reading from your iPhone CM. The reading is 1.4g - no wonder you feel sluggish.
You want to check against the data of the other planets on your node, to see how the gravity from this planet compares, so you write a function to add the new planetary data and query it against the other planets:
Nice, you see that Kepler 5 has gravitational forces stronger than Neptune but weaker than Jupiter.
Now you’ve satisfied your curiosity, you head over to passport control.
You find yourself at passport control where you are told your Crux experience is needed.
Kaarlang has arrived there first and has been chatting to the manager here. As an advanced civilization, they are quite happily using Crux with no issues, but still have a problem with human error. Some employees have been handing out passports before putting the travelers information into Crux. When it gets particularly busy, it’s not uncommon for the employees to forget to go back and put the data in, resulting in unregistered travelers.
Kaarlang has told the manager that you have a background in solving problems using Crux, so has offered them your skills.
Your task is to make a function that ensures no passport is given before the travelers data is successfully ingested into Crux.
You test out your function.
This strikes you as peculiar - you received no errors from your Crux node upon submitting, but the ingested traveler doc has not returned a passport number.
You are sure your query and ingest syntax is correct, but to check you try running the query again. This time you get the expected result:
Confused, you open your trusty Crux manual, skimming through until you hit the page on
"" Blocks until the node has indexed a transaction that is at or past the supplied tx. Will throw on timeout. Returns the most recent tx indexed by the node. ""
Submit operations in Crux are asynchronous - your query did not return the new data as it had not yet been indexed into Crux.
You decide to rewrite your function using
You run the function again, Changing the traveler-doc so you can see if it’s worked. This time you receive the following:
You show this to the manager at the passport control office. They are happy that this will work.
"" Thank you, this will save us so much time in dealing with missing traveler information. As a token of our gratitude, we would like to grant you with free entry to the planet. ""
You graciously accept. For the passport you must provide your origin planet, name and also a chosen name. Many people come to Kepra-5 in order to start fresh, so your chosen name can be anything you wish.
Once chosen you can not easily change it, so you think carefully.
New name, new you.
Now that you are in the Gilese 667C you must keep your passport up to date wherever you travel. You take a note of your passport number and put it somewhere safe.
Through customs, you are now free to explore the exciting new planet. Taking in your surroundings, you see a hostel nearby. You head over. Although you’ve been in cryostasis for such a long time, the new gravity has made you very tired.