Urbit Developers
  • Hoon

    • Overview
    • Cheat Sheet
    • Irregular forms
    • Hoon Errors
    • Hoon Style Guide
    • Basic Types
    • Advanced Types
    • Auras
    • Runes

      • Atoms and strings
      • Nock . ('dot')
      • Wild ! ('zap')
      • Change Subject = ('tis')
      • Conditionals ? ('wut')
      • Cores | ('bar')
      • Arms + ('lus')
      • Cells : ('col')
      • Calls % ('cen')
      • Casts ^ ('ket')
      • Structures $ ('buc')
      • Make ; ('mic')
      • Hints ~ ('sig')
      • Imports / ('fas')
      • Terminators -- and ==
      • Limbs and wings

        • Limbs
        • Wings
        • Standard library

          • Table of Contents
          • 1a: Basic Arithmetic
          • 1b: Tree Addressing
          • 1c: Molds and Mold-Builders
          • 2a: Unit Logic
          • 2b: List Logic
          • 2c: Bit Arithmetic
          • 2d: Bit Logic
          • 2e: Insecure Hashing
          • 2f: Noun Ordering
          • 2g: Unsigned Powers
          • 2h: Set Logic
          • 2i: Map Logic
          • 2j: Jar and Jug Logic
          • 2k: Queue Logic
          • 2l: Container from Container
          • 2m: Container from Noun
          • 2n: Functional Hacks
          • 2o: Normalizing Containers
          • 2p: Serialization
          • 2q: Molds and Mold-Builders
          • 3a: Modular and Signed Ints
          • 3b: Floating Point
          • 3c: Urbit Time
          • 3d: SHA Hash Family
          • 3e: AES encryption (Removed)
          • 3f: Scrambling
          • 3g: Molds and Mold-Builders
          • 4a: Exotic Bases
          • 4b: Text Processing
          • 4c: Tank Printer
          • 4d: Parsing (Tracing)
          • 4e: Parsing (Combinators)
          • 4f: Parsing (Rule-Builders)
          • 4g: Parsing (Outside Caller)
          • 4h: Parsing (ASCII Glyphs)
          • 4i: Parsing (Useful Idioms)
          • 4j: Parsing (Bases and Base Digits)
          • 4k: Atom Printing
          • 4l: Atom Parsing
          • 4m: Formatting Functions
          • 4n: Virtualization
          • 4o: Molds
          • 5a: Compiler Utilities
          • 5b: Macro Expansion
          • 5c: Compiler Backend & Prettyprinter
          • 5d: Parser
          • 5e: Molds and mold builders
          • 5f: Profiling support
          • Zuse

            • Table of Contents
            • 2d(1-5): To JSON, Wains
            • 2d(6): From JSON
            • 2d(7): From JSON (unit)
            • 2e(2-3): Print & Parse JSON
          • Arvo

            • Overview
            • Ames

              • Overview
              • Cryptography
              • API Reference
              • Scry Reference
              • Data Types
              • Behn

                • Overview
                • API Reference
                • Scry Reference
                • Examples
                • Clay

                  • Overview
                  • Architecture
                  • Using Clay
                  • Data Types
                  • Scry Reference
                  • API Reference
                  • Examples
                  • Marks

                    • Overview
                    • Writing Marks
                    • Using Marks
                    • Examples
                  • Dill

                    • Overview
                    • API Reference
                    • Scry Reference
                    • Data Types
                    • Eyre

                      • Overview
                      • External API Reference
                      • Internal API Reference
                      • Scry Reference
                      • Data Types
                      • Guide
                      • Gall

                        • Overview
                        • API Reference
                        • Data Types
                        • Threads Reference
                        • Iris

                          • Overview
                          • API Reference
                          • Data Types
                          • Example
                          • Jael

                            • Overview
                            • API Reference
                            • Scry Reference
                            • Data Types
                            • Examples
                            • Threads

                              • Overview
                              • HTTP API
                              • Basics

                                • Fundamentals
                                • Bind
                                • Input
                                • Output
                                • Summary
                                • Gall

                                  • Start Thread
                                  • Take Result
                                  • Take Facts
                                  • Stop Thread
                                  • Poke Thread
                                  • Examples

                                    • Fetch JSON
                                    • Child Thread
                                    • Main-loop
                                    • Poke Agent
                                    • Scry
                                    • Take Fact
                                  • Concepts

                                    • Scries
                                    • Subscriptions
                                    • Tutorials

                                      • Move Trace
                                      • Reference

                                        • Cryptography
                                        • Filesystem Hierarchy
                                      • Nock

                                        • Nock Definition
                                        • Explanation
                                        • Example
                                        • Implementations
                                        • Vere

                                          • C Runtime System
                                          • Land of Nouns
                                          • API overview by prefix
                                          • C in Urbit
                                          • Writing Jets
                                          • Cryptography
                                          • Azimuth

                                            • Overview
                                            • Urbit HD Wallet
                                            • Azimuth Data Flow
                                            • Azimuth.eth
                                            • Ecliptic.eth
                                            • Advanced Azimuth Tools
                                            • Life and Rift
                                            • Layer 2

                                              • Layer 2 Overview
                                              • Layer 2 Actions
                                              • Transaction Format
                                              • Rollers
                                              • Roller HTTP RPC-API
                                              • Custom Roller Tutorial
                                            • Glossary

                                              • Ames
                                              • Aqua
                                              • Arm
                                              • Arvo
                                              • Atom
                                              • Azimuth
                                              • Battery
                                              • Behn
                                              • Bridge
                                              • Censures
                                              • chat
                                              • Claims
                                              • Clay
                                              • Comet
                                              • Core
                                              • Delegated Sending
                                              • Desk
                                              • Dill
                                              • Document Proposal
                                              • Dojo
                                              • Door
                                              • Ecliptic
                                              • Event Log
                                              • Eyre
                                              • Galaxy
                                              • Gall
                                              • Gate
                                              • HD Wallet
                                              • Hoon
                                              • Invite Tree
                                              • Iris
                                              • Jael
                                              • Keyfile
                                              • Khan
                                              • Landscape
                                              • Mark
                                              • Moon
                                              • Nock
                                              • Noun
                                              • OTA Updates
                                              • Payload
                                              • pH
                                              • Pier
                                              • Pill
                                              • Planet
                                              • Proxies
                                              • Replay
                                              • Factory Reset
                                              • Naive rollups
                                              • Sail/Udon
                                              • Senate
                                              • Ship
                                              • ship.arvo.network
                                              • Star
                                              • |sync
                                              • Trap
                                              • Upgrade Proposal
                                              • Vane
                                              • Vere
                                              • Voting
                                              • Wallet-Generator
                                              • Additional

                                                • Cryptography
                                                • Software Distribution

                                                  • Overview
                                                  • Docket File
                                                  • Glob
                                                Urbit
                                                • Hoon

                                                  • Overview
                                                  • Cheat Sheet
                                                  • Irregular forms
                                                  • Hoon Errors
                                                  • Hoon Style Guide
                                                  • Basic Types
                                                  • Advanced Types
                                                  • Auras
                                                  • Runes

                                                    • Atoms and strings
                                                    • Nock . ('dot')
                                                    • Wild ! ('zap')
                                                    • Change Subject = ('tis')
                                                    • Conditionals ? ('wut')
                                                    • Cores | ('bar')
                                                    • Arms + ('lus')
                                                    • Cells : ('col')
                                                    • Calls % ('cen')
                                                    • Casts ^ ('ket')
                                                    • Structures $ ('buc')
                                                    • Make ; ('mic')
                                                    • Hints ~ ('sig')
                                                    • Imports / ('fas')
                                                    • Terminators -- and ==
                                                    • Limbs and wings

                                                      • Limbs
                                                      • Wings
                                                      • Standard library

                                                        • Table of Contents
                                                        • 1a: Basic Arithmetic
                                                        • 1b: Tree Addressing
                                                        • 1c: Molds and Mold-Builders
                                                        • 2a: Unit Logic
                                                        • 2b: List Logic
                                                        • 2c: Bit Arithmetic
                                                        • 2d: Bit Logic
                                                        • 2e: Insecure Hashing
                                                        • 2f: Noun Ordering
                                                        • 2g: Unsigned Powers
                                                        • 2h: Set Logic
                                                        • 2i: Map Logic
                                                        • 2j: Jar and Jug Logic
                                                        • 2k: Queue Logic
                                                        • 2l: Container from Container
                                                        • 2m: Container from Noun
                                                        • 2n: Functional Hacks
                                                        • 2o: Normalizing Containers
                                                        • 2p: Serialization
                                                        • 2q: Molds and Mold-Builders
                                                        • 3a: Modular and Signed Ints
                                                        • 3b: Floating Point
                                                        • 3c: Urbit Time
                                                        • 3d: SHA Hash Family
                                                        • 3e: AES encryption (Removed)
                                                        • 3f: Scrambling
                                                        • 3g: Molds and Mold-Builders
                                                        • 4a: Exotic Bases
                                                        • 4b: Text Processing
                                                        • 4c: Tank Printer
                                                        • 4d: Parsing (Tracing)
                                                        • 4e: Parsing (Combinators)
                                                        • 4f: Parsing (Rule-Builders)
                                                        • 4g: Parsing (Outside Caller)
                                                        • 4h: Parsing (ASCII Glyphs)
                                                        • 4i: Parsing (Useful Idioms)
                                                        • 4j: Parsing (Bases and Base Digits)
                                                        • 4k: Atom Printing
                                                        • 4l: Atom Parsing
                                                        • 4m: Formatting Functions
                                                        • 4n: Virtualization
                                                        • 4o: Molds
                                                        • 5a: Compiler Utilities
                                                        • 5b: Macro Expansion
                                                        • 5c: Compiler Backend & Prettyprinter
                                                        • 5d: Parser
                                                        • 5e: Molds and mold builders
                                                        • 5f: Profiling support
                                                        • Zuse

                                                          • Table of Contents
                                                          • 2d(1-5): To JSON, Wains
                                                          • 2d(6): From JSON
                                                          • 2d(7): From JSON (unit)
                                                          • 2e(2-3): Print & Parse JSON
                                                        • Arvo

                                                          • Overview
                                                          • Ames

                                                            • Overview
                                                            • Cryptography
                                                            • API Reference
                                                            • Scry Reference
                                                            • Data Types
                                                            • Behn

                                                              • Overview
                                                              • API Reference
                                                              • Scry Reference
                                                              • Examples
                                                              • Clay

                                                                • Overview
                                                                • Architecture
                                                                • Using Clay
                                                                • Data Types
                                                                • Scry Reference
                                                                • API Reference
                                                                • Examples
                                                                • Marks

                                                                  • Overview
                                                                  • Writing Marks
                                                                  • Using Marks
                                                                  • Examples
                                                                • Dill

                                                                  • Overview
                                                                  • API Reference
                                                                  • Scry Reference
                                                                  • Data Types
                                                                  • Eyre

                                                                    • Overview
                                                                    • External API Reference
                                                                    • Internal API Reference
                                                                    • Scry Reference
                                                                    • Data Types
                                                                    • Guide
                                                                    • Gall

                                                                      • Overview
                                                                      • API Reference
                                                                      • Data Types
                                                                      • Threads Reference
                                                                      • Iris

                                                                        • Overview
                                                                        • API Reference
                                                                        • Data Types
                                                                        • Example
                                                                        • Jael

                                                                          • Overview
                                                                          • API Reference
                                                                          • Scry Reference
                                                                          • Data Types
                                                                          • Examples
                                                                          • Threads

                                                                            • Overview
                                                                            • HTTP API
                                                                            • Basics

                                                                              • Fundamentals
                                                                              • Bind
                                                                              • Input
                                                                              • Output
                                                                              • Summary
                                                                              • Gall

                                                                                • Start Thread
                                                                                • Take Result
                                                                                • Take Facts
                                                                                • Stop Thread
                                                                                • Poke Thread
                                                                                • Examples

                                                                                  • Fetch JSON
                                                                                  • Child Thread
                                                                                  • Main-loop
                                                                                  • Poke Agent
                                                                                  • Scry
                                                                                  • Take Fact
                                                                                • Concepts

                                                                                  • Scries
                                                                                  • Subscriptions
                                                                                  • Tutorials

                                                                                    • Move Trace
                                                                                    • Reference

                                                                                      • Cryptography
                                                                                      • Filesystem Hierarchy
                                                                                    • Nock

                                                                                      • Nock Definition
                                                                                      • Explanation
                                                                                      • Example
                                                                                      • Implementations
                                                                                      • Vere

                                                                                        • C Runtime System
                                                                                        • Land of Nouns
                                                                                        • API overview by prefix
                                                                                        • C in Urbit
                                                                                        • Writing Jets
                                                                                        • Cryptography
                                                                                        • Azimuth

                                                                                          • Overview
                                                                                          • Urbit HD Wallet
                                                                                          • Azimuth Data Flow
                                                                                          • Azimuth.eth
                                                                                          • Ecliptic.eth
                                                                                          • Advanced Azimuth Tools
                                                                                          • Life and Rift
                                                                                          • Layer 2

                                                                                            • Layer 2 Overview
                                                                                            • Layer 2 Actions
                                                                                            • Transaction Format
                                                                                            • Rollers
                                                                                            • Roller HTTP RPC-API
                                                                                            • Custom Roller Tutorial
                                                                                          • Glossary

                                                                                            • Ames
                                                                                            • Aqua
                                                                                            • Arm
                                                                                            • Arvo
                                                                                            • Atom
                                                                                            • Azimuth
                                                                                            • Battery
                                                                                            • Behn
                                                                                            • Bridge
                                                                                            • Censures
                                                                                            • chat
                                                                                            • Claims
                                                                                            • Clay
                                                                                            • Comet
                                                                                            • Core
                                                                                            • Delegated Sending
                                                                                            • Desk
                                                                                            • Dill
                                                                                            • Document Proposal
                                                                                            • Dojo
                                                                                            • Door
                                                                                            • Ecliptic
                                                                                            • Event Log
                                                                                            • Eyre
                                                                                            • Galaxy
                                                                                            • Gall
                                                                                            • Gate
                                                                                            • HD Wallet
                                                                                            • Hoon
                                                                                            • Invite Tree
                                                                                            • Iris
                                                                                            • Jael
                                                                                            • Keyfile
                                                                                            • Khan
                                                                                            • Landscape
                                                                                            • Mark
                                                                                            • Moon
                                                                                            • Nock
                                                                                            • Noun
                                                                                            • OTA Updates
                                                                                            • Payload
                                                                                            • pH
                                                                                            • Pier
                                                                                            • Pill
                                                                                            • Planet
                                                                                            • Proxies
                                                                                            • Replay
                                                                                            • Factory Reset
                                                                                            • Naive rollups
                                                                                            • Sail/Udon
                                                                                            • Senate
                                                                                            • Ship
                                                                                            • ship.arvo.network
                                                                                            • Star
                                                                                            • |sync
                                                                                            • Trap
                                                                                            • Upgrade Proposal
                                                                                            • Vane
                                                                                            • Vere
                                                                                            • Voting
                                                                                            • Wallet-Generator
                                                                                            • Additional

                                                                                              • Cryptography
                                                                                              • Software Distribution

                                                                                                • Overview
                                                                                                • Docket File
                                                                                                • Glob
                                                                                              Reference/Glossary

                                                                                              Arvo

                                                                                              Arvo is the Urbit operating system and kernel. Arvo's state is a pure function of its event log, and it serves as the Urbit event manager. It contains vanes, which are kernel modules that perform essential system operations.

                                                                                              Arvo being purely functional means that the state of the operating system at a given moment is completely determined by the sequence of events in the event log. In other words, the state of an Arvo instance is given by a lifecycle function

                                                                                              L: History ➜ State

                                                                                              where History consists of the set of all possible sequences of events in an Arvo event log.

                                                                                              Arvo coordinates and reloads vanes. It can be thought of as a traffic-director. Any vane needs to go through Arvo before reaching another vane. Events and their effects happen like so:

                                                                                              Unix event -> Vere -> Arvo -> vane -> Arvo

                                                                                              Here, Vere is the virtual machine running Urbit.

                                                                                              Arvo is located in /base/sys/arvo.hoon within your urbit.

                                                                                              Arvo vanes include Ames for networking, Behn for timing, Clay for filesystem and typed revision control, Dill for terminal driving, Eyre for web services, Ford for building, and Gall for application management.

                                                                                              Vanes and other programs for Arvo are written in Hoon.

                                                                                              A ship creates its own copy of Arvo via a bootstrap sequence known as a Pill.

                                                                                              Further Reading

                                                                                              • The Arvo tutorial: An in-depth technical guide to Arvo and its vanes.
                                                                                              • The Technical Overview: An overview of all of Urbit.

                                                                                              <-

                                                                                              Atom

                                                                                              Arm

                                                                                              ->

                                                                                              Edit this page on GitHub