on master help sign in
pulled in docs changes
802dd1afriederjanmoerman
content/docs+1−1

Submodule changed.

content/posts/2019-5-roadmap.mdnew file+104
@@ -0,0 +1,104 @@
1++++
2+title = "~2019.5 Roadmap"
3+date = 2019-05-16
4+author = "Galen Wolfe-Pauly"
5+description = "Where we are and where we're going as of mid-2019."
6+aliases = ["/posts/essays/2019-5-roadmap"]
7+[taxonomies]
8+posts = ["Essays"]
9++++
10+
11+![](https://media.urbit.org/site/posts/essays/2019-5-roadmap-1.png)
12+
13+We often get so busy that we forget to tell you what we’ve been up to. Here’s an update on what we’re doing and where we’re headed with each layer of the stack.
14+
15+At a very high level we have two goals for 2019: make Azimuth easier to use, and get Arvo to a 1.0.
16+
17+Next year we’ll begin to move away from some of the MEGACORP software we use in the office and replace it with our own tooling. There’s some exciting work happening in that department, but we’ll cover that in a future post.
18+
19+For some related recent thinking on all of this, see [The 100 Year Computer](/posts/essays/the-100-year-computer/), [The State of Landscape](/posts/essays/the-state-of-landscape/) and [Azimuth as MultiPass](/posts/essays/azimuth-as-multipass/).
20+
21+For now, let’s just look at what’s on the immediate horizon:
22+
23+## Azimuth
24+
25+At lunch the other day someone on our team said something like, ‘We built a complete and working public key infrastructure, but we haven’t told anyone.’
26+
27+It’s true. Azimuth is operational, secure, and well tested. It’s a pretty cool piece of technology, and it’s out there in the world for anyone to use. It also doesn’t require that you use Arvo — Arvo happens to make use of Azimuth, but it’s a completely separate system.
28+
29+So, the question is, why haven’t we told the world about it?
30+
31+I tend to think that in order for a technology to succeed, it has to not only be an important technical innovation, but also easy to understand as a product. And that’s our answer: we’ve undersold Azimuth because we want it to be easier to understand by *using*, not just by reading the code. Azimuth is quite elegant as a piece of technology, but that doesn’t matter until it has a great user experience to match.
32+
33+That’s why, in the near term, we’re focused on building on top of Azimuth ourselves. We can’t ask others to go down roads if we haven’t already been down ourselves.
34+
35+So, here’s what we’re building first:
36+
37+### Q2 2019
38+
39+- A simplified onboarding flow for getting an Azimuth point that’s simple to share with friends over email, text or as a URL.
40+- A redesigned and improved Bridge for managing your points.
41+- An interface that allows you to easily send money between Azimuth points without running Arvo.
42+
43+### Q3 2019
44+
45+- Expanded Azimuth-centric example modules, documentation and developer tooling.
46+
47+Still under consideration:
48+
49+- An OAuth server for Azimuth, allowing any service to log users in with Azimuth.
50+- A mobile app for point to point payments using Azimuth.
51+
52+### 2020
53+
54+Azimuth is beginning to feel like [multipass](/posts/essays/azimuth-as-multipass/), with a variety of ways to use Azimuth points without ever booting Arvo
55+
56+## Arvo
57+
58+The Arvo interface has always been held back by Arvo’s technical immaturity. This is still true to some degree. The system has not stabilized completely.
59+
60+But! We’ve been using Landscape quite a lot lately. I use it daily, in fact — even [on my phone](https://itunes.apple.com/us/app/landscape-urbit/id1393148862). An encrypted (although not audited — so let’s not call it ‘secure’) authenticated chat where I own the keys and can read the source code is pretty cool, really. The interface isn’t perfect, but it’s nice. Landscape is a great preview of where we’re going: a simple, permanent, self-sovereign computer.
61+
62+There are still rough edges, and Landscape is not nearly general purpose enough, but we have plans:
63+
64+### Q2 2019
65+
66+- A new update to the Arvo interface that we’re calling Modulo. Modulo expands beyond chat and longform discussion to make your Arvo interface feel much more like the computer it actually is.
67+- Upgrades to our event persistence, networking, and DNS integration aimed at much better stability. Arvo instances don’t crash that often, but with these changes it should be very rare.
68+- Significant improvements to testing with a new simulation testing framework and integration testing pipelines.
69+
70+### Q3 2019
71+
72+- A significant overhaul to Gall, our application model, making it much simpler for users to write apps or ‘agents’ in Arvo.
73+- A new version of the compiler that makes us less reliant on jets. This will eliminate a major obstacle to achieving network continuity, or the ability for ships to upgrade themselves totally over-the-air, forever.
74+- A significant overhaul and stability update to Clay, our filesystem, making it possible for us to trust it for self-hosting, search it easily, and depend on it for long-term data storage.
75+- Tooling for hosting and hopefully a beta program for hosted Arvo instances run by Tlon.
76+
77+### 2020
78+
79+- A completely overhauled Arvo interface, Daigo, with a complete but simple set of messaging and collaboration tools.
80+- We come to work every day, use Arvo, go home.
81+
82+## Community
83+
84+Historically, we’ve been shy about even acknowledging we have a community at all. We’ve often felt like it was far too early to invite others in to the system.
85+
86+As long as we’re up front about the state of this 100 year computer – that it’s live, but incomplete – I think it’s a good thing to welcome people on board. There are many opportunities for contribution and there’s plenty to play with.
87+
88+Hoon school was the first effort in this direction. We intend to do a lot more:
89+
90+### Q2 2019
91+
92+Scaling Hoon school up to include both a track for experts and for beginners, and allowing many more participants.
93+
94+- Holding more meetings and events on Landscape, experimenting with Arvo-native discussion.
95+- A clear program for address space grants for developers + contributors.
96+- New documentation site with searchable library docs.
97+
98+### Q3 2019
99+
100+- Hoon School participants understand clearly how to build a Modulo agent, and invite others into it.
101+- The road toward building an Azimuth module is well understood, paved, and clear.
102+- We have clear instructions and tutorials for building Azimuth modules and using Azimuth as a login or reputation primitive.
103+
104+**Galen Wolfe-Pauly** ~ravmel-ropdyl
content/posts/azimuth-as-multipass.mdnew file+31
@@ -0,0 +1,31 @@
1++++
2+title = "Azimuth as Multipass"
3+date = 2019-05-16
4+author = "Galen Wolfe-Pauly"
5+description = "An update on the state of Landscape and the Urbit network."
6+aliases = ["/posts/essays/azimuth-as-multipass/"]
7+[taxonomies]
8+posts = ["Essays"]
9++++
10+
11+![](https://media.urbit.org/site/posts/essays/azimuth-as-multipass-1.png)
12+
13+Why can’t I just walk up to a door and have it open for me? Why can’t I simply arrive at a restaurant and have them know I’m there? Shouldn’t I be able to buy a ticket to a show with my Multipass then scan it at the entrance and use it to buy drinks?
14+
15+Why should I have to log in with MEGACORP? Today, in most cases, it’s a different MEGACORP for every single context. It’s a MEGAMESS.
16+
17+Why not just use one? Forget about how we get there for a moment: just imagine how simple it could be.
18+
19+An Azimuth point is an identity and a wallet. Both a driver’s license and a credit card. Identity and money. Think about it as a ‘civilizational key’ for a new society. Concretely, it’s nice to imagine it as a physical object. A slick, card sized object with an e-ink screen. You can tap it to pay, tap it to enter, and plug it into a computer to boot your Arvo OS.
20+
21+Worried about losing it? Just remember your ticket. If you use our wallet system, all you need to remember is something like `~ravmel-ropdyl` and `~habpem-sondem-pidbyt-solbyn`. A point and a ticket. That’s it.
22+
23+Woke up in the desert, no idea how you got there, but can still remember your point and ticket? Great! Just get to an internet connection and re-ticket – you’ll be fine. Although probably dehydrated.
24+
25+If you’re someone who’s worried about getting kidnapped, just use a child identity. Your Azimuth planet has ~4B of them, so you can always invalidate one if you lose it.
26+
27+Perhaps part of how we ended up in the world we’re in is that we didn’t have something like Azimuth to begin with. Today, it’s backwards: everyone has an address on the network, but no one has an identity.
28+
29+We think everyone needs an identity that can hold money and have packets routed to it. Start there, and it’s quite fun to imagine where you end up. A civilized digital society might even be possible after all.
30+
31+**Galen Wolfe-Pauly** ~ravmel-ropdyl
content/posts/the-100-year-computer.mdnew file+27
@@ -0,0 +1,27 @@
1++++
2+title = "The 100-Year Computer"
3+date = 2019-05-14
4+author = "Galen Wolfe-Pauly"
5+description = "One way to think about Urbit: as a \"100-year computer.\""
6+aliases = ["/posts/essays/the-100-year-computer/"]
7+[taxonomies]
8+posts = ["Essays"]
9++++
10+
11+![](https://media.urbit.org/site/posts/essays/100-year-computer-1.png)
12+
13+Around the Tlon office, we’re always looking for more concise ways to describe what we do. We kicked around ‘personal server’ for a long time. It’s pretty close. ‘Personal cloud computer’ did okay for a while, but it’s a little confusing.
14+
15+One way to think about Urbit is as a 100-year computer.
16+
17+A 100-year computer has to be durable, reliable and permanent. It has to never lose data or fail in unpredictable ways. It has to be continuous, meaning it should never need to be updated by the user. If I put it in a closet for 10 years and take it out, it should work again without any intervention.
18+
19+And, perhaps most importantly, it should be easy and enjoyable to use. Both for a casual user and for a technical person. If it’s not enjoyable to use, and doesn’t actually *get used*, it’s never going to survive for 100 years.
20+
21+In theory we could all be using Apple I’s today, but they’re a bit cumbersome. In large part that’s because they don’t update themselves. Those magnetic tapes don’t strike me as particularly durable either.
22+
23+Imagine that a computer was something you kept forever. It would comfortably store your entire life: your writing, photos, blood tests, even your genome. Your computer would never show you ads, interrupt you against your wishes, or send your data to someone else without your permission.
24+
25+Imagine a computer that was extremely valuable to you, that you’d pay thousands of dollars to recover, but you used *less* than the one you do today.
26+
27+**Galen Wolfe-Pauly** ~ravmel-ropdyl
content/posts/the-state-of-landscape.mdnew file+75
@@ -0,0 +1,75 @@
1++++
2+title = "The State of Landscape"
3+date = 2019-05-16
4+author = "Galen Wolfe-Pauly"
5+description = "An update on the state of Landscape and the Urbit network."
6+aliases = ["/posts/essays/the-state-of-landscape"]
7+[taxonomies]
8+posts = ["Essays"]
9++++
10+
11+![](https://media.urbit.org/site/posts/essays/the-state-of-landscape-1.png)
12+
13+The TL;DR is: if you’re really excited about living on Mars, Landscape is fun to try out. Come join `~dopzod/urbit-help`, experiment with creating your own chats and collections (did anyone find that easter egg, yet?), and see what you can do with the thing.
14+
15+Landscape today is for the intrepid adventurer. So is much of the system. If you want to read about what we’re doing to make it more welcoming, [check out the 2019 roadmap](/posts/essays/2019-5-roadmap/).
16+
17+## The Broad View
18+
19+We thought a lot last year about how to avoid the pitfalls of modern social networks. The services we all use today each feel like *one place*. It’s as if everyone on MEGANET is living together in the same city.
20+
21+In the real world, cities have their own cultures. So we thought: there must be some way to build more granular communities online. Living in a single world-city is kind of a bummer, honestly.
22+
23+Landscape was our first experiment in this direction. It’s a ruthlessly simple interface for chat and discussion that runs on top of Arvo. You can connect to Landscape in a browser or in an app on your iOS device. All communication is pseudonymous and authenticated (as with everything in Arvo) with your Azimuth point.
24+
25+Over the past few months, we’ve been running small experiments, experimenting with ways to support our own work and finding the limits of what we can do on the network. Originally, we built Landscape out of our desire to get away from using MEGACORP communication tools in our daily work. We thought: if we’re trying to build a whole new network and society, we had better go live there first.
26+
27+Landscape is an experiment — it’s supposed to be fun, above all, and a good way to help focus our efforts on maturing the platform.
28+
29+Anyway, let’s show off some of the specifics, and give an update on this experiment so far.
30+
31+## A Quick Tour
32+
33+Landscape is pretty simple. It lets you subscribe to chats, in the spirit of IRC, and ‘collections’, which are effectively forums or blogs with comments. You can also direct message with other running ‘ships’ or Arvo nodes.
34+
35+For the most part, this happens through a web interface that you can access at `https://ship.arvo.network` or via `localhost:80`.
36+
37+There’s also an iOS app, [available in the app store](https://itunes.apple.com/us/app/landscape-urbit/id1393148862), that you link to your ship the same way you log in through a browser.
38+
39+## Landscape: The Bad Parts
40+
41+What’s keeping us from asking others to use this thing more aggressively? Let’s walk through the reasons (while keeping in mind, they’re all [things we’re working on](/posts/essays/2019-5-roadmap/)):
42+
43+### 1 - Arvo has rough spots
44+
45+They have gotten a lot better, but there are still a few things that can crash your Arvo ship. This, of course, has nothing to do with your Azimuth point, which is completely separate and, as far as we know, secure.
46+
47+The first (and most severe) is a bug in our event persistence that occurs very rarely. Basically, there are conditions under which you can cause events not to be properly written to disk and corrupt your event log. It’s pretty unlikely, but it’s unacceptable for a real product since it basically causes you to have to wait out the current network era.
48+
49+The second is that Ames (our network protocol) has occasional connectivity problems. Originally, we thought we had found this issue as being related to [a timer bug](https://github.com/urbit/arvo/pull/1072). It may be, but the networking is in the process of a major overhaul — so we’ve implemented a few bandaids to make the situation workable. `|bonk` sometimes needs to be used to reset connections between peers, and `:ethmanage` sometimes need to be used to re-synchronize with the blockchain. It’s an ugly fix, but it usually works.
50+
51+Relatedly, we have occasionally been seeing errors caused by the Arvo network being slow to register keys from the blockchain. If you’re a newly registered Azimuth point, and your keys were just put on-chain, it can take some time for that change to propagate. This can result in a confusing situation for new ships.
52+
53+### 2 - There’s no ‘individual continuity breach’
54+
55+One great thing about the Arvo network is that it’s more like a giant single computer than a network. When you talk to another ship, use remote files or sync data it’s almost the same as working with local data.
56+
57+The main thing underlying this is *sequence numbers*. Your Arvo ship keeps track of every message it has exchanged with every other ship, and it never breaks that sequence. If our ships are talking, and we’re on packet `83910` but you reset and try to start again at `0` my ship just thinks you’ve lost your mind and won’t talk to you anymore.
58+
59+We’d like individual resets to work, and we’re [working on it](https://github.com/urbit/arvo/pull/1169). But, for the time being, if you have any fatal error on your ship, it means you’ve got to sit this era out.
60+
61+This is another unacceptable bug for anything we truly rely on.
62+
63+### 3 - There are no push notifications, yet
64+
65+What’s one thing that a chat application needs to do? Notify you of new messages. What does Landscape notify you about? Well, at the moment, basically nothing.
66+
67+We implemented and tested a push notifications server for iOS, which is slated for release in the next few months (it depends on things in our `cc-release` branch). We’d also love to work on having your ship connect to your email provider and send you alerts over email. We’re thinking about how to do that.
68+
69+## What We’ve Learned and What We’re Doing
70+
71+Many of us spend all day on Landscape, use it from our phones, and find it really fun. The bugs above bite less than you might think and, in many cases, the experience is quite nice. It’s a passive, distraction-free way to interact with others around the office.
72+
73+We operate one public channel, `~dopzod/urbit-help` for answering any of your questions about the system. And, from time to time, we have been creating topic-centric channels and announcing them publicly. This has been a lot of fun. Come join us if you’re feeling brave.
74+
75+**Galen Wolfe-Pauly** ~ravmel-ropdyl
content/posts/the-urbit-address-space.md+1−1
@@ -1,7 +1,7 @@
1+++
1+++
2title = "The Urbit Address Space"
2title = "The Urbit Address Space"
3date = 2016-05-16
3date = 2016-05-16
4−author = "Galen Wolfe-Pauly + Curtis Yarvin"
4+author = "Galen Wolfe-Pauly, Curtis Yarvin"
5description = "An overview of Urbit's cryptographic address space."
5description = "An overview of Urbit's cryptographic address space."
6[taxonomies]
6[taxonomies]
7posts = ["Essays"]
7posts = ["Essays"]
content/posts/what-is-urbit-for.md+1
@@ -3,6 +3,7 @@ title = "What is Urbit For?"
3date = 2016-05-11
3date = 2016-05-11
4author = "Galen Wolfe-Pauly"
4author = "Galen Wolfe-Pauly"
5description = "A vision of the Urbit-powered future."
5description = "A vision of the Urbit-powered future."
6+aliases = ["/posts/essays/what-urbit-is-for"]
6[taxonomies]
7[taxonomies]
7posts = ["Essays"]
8posts = ["Essays"]
8+++
9+++
content/posts/why-urbit-probably-does-not-need-a-blockchain.md+1
@@ -3,6 +3,7 @@ title = "Why Urbit Probably Doesn't Need a Blockchain"
3date = 2016-07-14
3date = 2016-07-14
4author = "Curtis Yarvin"
4author = "Curtis Yarvin"
5description = "Urbit (probably) doesn't need a blockchain, because the Urbit address-space PKI is a special case of a consensus ledger."
5description = "Urbit (probably) doesn't need a blockchain, because the Urbit address-space PKI is a special case of a consensus ledger."
6+aliases = ["/posts/essays/why-urbit-probably-does-not-need-a-blockchain/"]
6[taxonomies]
7[taxonomies]
7posts = ["Essays"]
8posts = ["Essays"]
8+++
9+++
static/_redirects+1
@@ -6,3 +6,4 @@
6/docs/bridge /docs/getting-started/azimuth/
6/docs/bridge /docs/getting-started/azimuth/
7/docs/pki /docs/concepts/arvo-vs-azimuth/
7/docs/pki /docs/concepts/arvo-vs-azimuth/
8/fora /docs/using/messaging/
8/fora /docs/using/messaging/
9+/docs/arvo/internals/ /docs/learn/arvo/