Derek Beres
May 23 · 3 min read

Click here to see all of Josh Orndorff’s lessons on Github.

Multiple data sources

Occasionally a computation can only be made once data is retrieved (messages are received) from two or more different data sources. For example, you can’t tell whether you won the lottery until you’ve got your ticket number and the winning number. You can’t make change for a purchase until you know the price and the amount tendered. You can’t tell who wins a pushup contest until you know how many pushups each competitor completed.

Rholang has the join operator for exactly this situation. To perform a join, just use the ; character.

for (p1Pushups <- player1; p2Pushups <- player2) {
stdout!("The winner is...")

When you use the join operator, neither message will be received until both messages are available.

Rocket Launch

A space exploration company wants to make sure their rocket only launches when both of two flight engineers, Alice and Bob, give the launch command. As an example, Bob would give the go ahead by sending bobLaunch!("launch"). When both engineers give the command, the rocket can be launched.


Consider how this code might be written using the join operator that we just discussed.

The wrong way

One may have been tempted to solve the rocket problem by first receiving one launch command then the other.


The problem here is when Alice okay’s the launch, but Bob hasn’t yet. Alice should be able to change her mind, but she cannot. Imagine if she suddenly noticed a problem with the rocket, or received some bad news and wanted to abort the launch.

When using a join, she can still change her mind because the for won't consume her launch message until Bob's message also appears and is ready to be consumed.

Launch Solution


I’ve explored the concept of joins in the context of the famous dining philosophers problem in this blog post.


There is a game where two players will each send a message on separate channels. Whoever sends the first message, loses, and whoever sends the second message wins. Your task here is to write the game code that will tell which player won. To play the game, players should send messages like shown.

P1!("Send any message") P2!("Hope I win")

Solution to the patience game

In this case, we actually don’t want to use join because we care which player went first. Hope I didn’t trick you ;)


Like the comment says, you should send the messages in both orders to make sure of who wins. The easiest way to do that right now is to have one player signal the other for when to go as shown below. We’ll explore this concept further in the next lesson.


RChain Cooperative

Secure. Sustainable. Scalable. Blockchain solution.

Derek Beres

Written by

Director of Content @ RChain Cooperative. GFI @ Equinox. Author. Podcaster. Professional Cat Herder.

RChain Cooperative

Secure. Sustainable. Scalable. Blockchain solution.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade