@@ -4,69 +4,121 @@ title = "FAQ"
7−<details><summary class="fs5 medium pb3 pt4">The Urbit Project</summary>
7+<details><summary>The Urbit Project</summary>
8−[Why Urbit?](#why-urbit)
9+[Why Urbit?](#urbit-project-1)
9−[How secure is Urbit right now?](#how-secure-is-urbit-right-now)
11+[How secure is Urbit right now?](#urbit-project-2)
10−[How can I contribute to Urbit?](#how-can-i-contribute-to-urbit)
13+[How can I contribute to Urbit?](#urbit-project-3)
11−[What is Tlon?](#what-is-tlon)
15+[What is Tlon?](#urbit-project-4)
12−[Who Works at Tlon?](#who-works-at-tlon)
17+[Who Works at Tlon?](#urbit-project-5)
15−<details><summary class="fs5 medium pb3 pt4">Grants</summary>
21+<details><summary>Grants</summary>
16−[What are the different types of grants](#what-are-the-different-types-of-grants)
23+[What are the different types of grants](#grants-1)
17−[How do I get a gift?](#how-do-i-get-a-gift)
25+[How do I get a gift?](#grants-2)
18−[How often are gifts awarded?](#how-often-are-gifts-awarded)
27+[How often are gifts awarded?](#grants-3)
19−[What happens if a user does not complete a proposal but meets some milestones?](#what-happens-if-a-user-does-not-complete-a-proposal-but-meets-some-milestones)
29+[What happens if a user does not complete a proposal but meets some milestones?](#grants-4)
20−[Can I create a bounty?](#can-i-create-a-bounty)
30+
21−[How are proposals approved?](#how-are-proposals-approved)
31+[Do I have to pay taxes on stars?](#grants-5)
22−[If I win a proposal, do I have an exclusive claim on the project?](#if-i-win-a-proposal-do-i-have-an-exclusive-claim-on-the-project)
32+
23−[Will milestones be embedded in a smart contract?](#will-milestones-be-embedded-in-a-smart-contract)
33+[Can I create a bounty?](#grants-6)
35+[How are proposals approved?](#grants-7)
37+[If I win a proposal, do I have an exclusive claim on the project?](#grants-8)
39+[Will milestones be embedded in a smart contract?](#grants-9)
24−[Do I have to pay taxes on stars?](#does-reputation-play-a-role-in-the-assessment-of-grants)
41+[Does reputation play a role in the assessment of grants?](#grants-10)
25−[I completed a proposal. When will I receive payment?](#i-completed-a-proposal-when-will-i-receive-payment)
43+[I completed a proposal. When will I receive payment?](#grants-11)
26−[Can I see the proposals of others that have been accepted?](#can-i-see-the-proposals-of-others-that-have-been-accepted)
45+[Can I see the proposals of others that have been accepted?](#grants-12)
27−[How do I safely store my stars?](#how-do-i-safely-store-my-stars)
47+[How do I safely store my stars?](#grants-13)
28−[Can I delegate a bounty or proposal to someone else?](#can-i-delegate-a-bounty-or-proposal-to-someone-else)
49+[Can I delegate a bounty or proposal to someone else?](#grants-14)
31−<details class="pt4"><summary class="fs5 medium pb3">Azimuth</summary>
53+<details><summary>Azimuth</summary>
32−[What is Azimuth?](#what-is-azimuth)
55+[What is Azimuth?](#azimuth-1)
33−[What are stars, galaxies, and planets?](#what-are-star-galaxies-and-planets)
57+[What are stars, galaxies, and planets?](#azimuth-2)
34−[How many planets, stars, and galaxies are active?](#how-many-planets-stars-and-galaxies-are-active)
59+[How many planets, stars, and galaxies are active?](#azimuth-3)
35−[What are comets and moons?](#what-are-comets-and-moons)
61+[What are comets and moons?](#azimuth-4)
36−[What is a `@p`? Why is my username generated for me?](#what-is-a-p-why-is-my-username-generated-for-me)
63+[What is a `@p`? Why is my username generated for me?](#azimuth-5)
37−[Can I change my `@p`?](#can-i-change-my-p)
65+[Can I change my `@p`?](#azimuth-6)
38−[How do I get an identity?](#how-do-i-get-an-identity)
67+[How do I get an identity?](#azimuth-7)
39−[How do I send an identity to someone else?](#how-do-i-send-an-identity-to-someone-else)
69+[How do I send an identity to someone else?](#azimuth-8)
40−[What is the best way to access Azimuth?](#what-is-the-best-way-to-access-azimuth)
71+[What is the best way to access Azimuth?](#azimuth-9)
43−<details class="pt4"><summary class="fs5 medium pb3">Urbit HD Wallet</summary>
75+<details><summary>Urbit HD Wallet</summary>
44−[What is the Urbit HD Wallet?](#what-is-the-urbit-hd-wallet)
77+[What is the Urbit HD Wallet?](#wallet-1)
45−[What is a master ticket?](#what-is-a-master-ticket)
79+[What is a master ticket?](#wallet-2)
46−[What is an ownership address?](#what-is-an-ownership-address)
81+[What is an ownership address?](#wallet-3)
47−[What are proxies?](#what-are-proxies)
83+[What are proxies?](#wallet-4)
48−[What are seeds?](#what-are-seeds)
85+[What are seeds?](#wallet-5)
49−[What does it mean to “set public keys”?](#what-does-it-mean-to-set-public-keys)
87+[What does it mean to “set public keys”?](#wallet-6)
50−[What do I do if I want to own multiple points?](#what-do-i-do-if-i-want-to-own-multiple-points)
89+[What do I do if I want to own multiple points?](#wallet-7)
51−[How should I take care of my Urbit HD Wallet?](#how-should-i-take-care-of-my-urbit-hd-wallet)
91+[How should I take care of my Urbit HD Wallet?](#wallet-8)
52−[I have a galaxy or star with lockup conditions. How does this work?](#i-have-a-galaxy-or-star-with-lockup-conditions-how-does-this-work)
93+[I have a galaxy or star with lockup conditions. How does this work?](#wallet-9)
55−<details class="pt4"><summary class="fs5 medium pb2">Arvo</summary>
97+<details><summary>Arvo</summary>
56−[What is Arvo?](#what=is-arvo)
99+[What is Arvo?](#arvo-1)
57−[What is unique about Arvo?](#what-is-unique-about-arvo)
101+[What is unique about Arvo?](#arvo-2)
58−[How is Arvo connected to Ethereum?](#how-is-arvo-connected-to-ethereum)
103+[How is Arvo connected to Ethereum?](#arvo-3)
59−[Will the Arvo network survive if Ethereum dies?](#will-the-arvo-network-survive-if-ethereum-dies)
105+[Will the Arvo network survive if Ethereum dies?](#arvo-4)
60−[How do I install Arvo?](#how-do-i-install-arvo)
107+[How do I install Arvo?](#arvo-5)
61−[How do I use Arvo?](#how-do-i-use-arvo)
109+[How do I use Arvo?](#arvo-6)
62−[How do over-the-air updates work?](#how-do-over-the-air-updates-work)
111+[How do over-the-air updates work?](#arvo-7)
63−[What is Landscape?](#what-is-landscape)
113+[What is Landscape?](#arvo-8)
64−[I have a point, now what?](#i-have-a-point-now-what)
115+[I have a point, now what?](#arvo-9)
65</details>
117</details>
67## The Urbit project
119## The Urbit project
69−### Why Urbit?
121+### Why Urbit? {#urbit-project-1}
71The internet began as a friendly, peer-to-peer network: friendly because the people with the ability to use such a thing were the same sort of nerds, and peer-to-peer because those nerds knew how to run their own servers. But, as the internet’s appeal spread to everyday people in the 90s, it was unrealistic for everyone to be the administrators of their own complex machines. So this peer-to-peer network was divided into clients (people) and servers (large corporations), a relationship that’s been solidifying ever since.
123The internet began as a friendly, peer-to-peer network: friendly because the people with the ability to use such a thing were the same sort of nerds, and peer-to-peer because those nerds knew how to run their own servers. But, as the internet’s appeal spread to everyday people in the 90s, it was unrealistic for everyone to be the administrators of their own complex machines. So this peer-to-peer network was divided into clients (people) and servers (large corporations), a relationship that’s been solidifying ever since.
@@ -78,106 +130,106 @@ In combining the determinism of Arvo, our OS, and the security of identity of Az
79The internet anticipated by Urbit is a much friendlier one. You’re always “logged in” to your online services, without the need to remember usernames or passwords. Problems that are unsolvable in our current internet -- spam, fake reviews, malware-spreading, harassment -- are made uneconomical, since there’s a limited number of Urbit identities that function as reputation primitives.
131The internet anticipated by Urbit is a much friendlier one. You’re always “logged in” to your online services, without the need to remember usernames or passwords. Problems that are unsolvable in our current internet -- spam, fake reviews, malware-spreading, harassment -- are made uneconomical, since there’s a limited number of Urbit identities that function as reputation primitives.
81−### How secure is Urbit right now?
133+### How secure is Urbit right now? {#urbit-project-2}
83Azimuth, the Urbit identity layer, is ready for serious use. Its contracts have been audited by trustworthy third parties. We encourage everyone to use Azimuth as an identity solution, and to build software projects on top of it.
135Azimuth, the Urbit identity layer, is ready for serious use. Its contracts have been audited by trustworthy third parties. We encourage everyone to use Azimuth as an identity solution, and to build software projects on top of it.
85The rest of the Urbit project is still in research-mode. Arvo is a fun operating system to play with, but it’s not yet a safe place to store sensitive data.
137The rest of the Urbit project is still in research-mode. Arvo is a fun operating system to play with, but it’s not yet a safe place to store sensitive data.
87−### How can I contribute to Urbit?
139+### How can I contribute to Urbit? {#urbit-project-3}
89We encourage outside contributors to become a part of the project. The best way to do this is to check out [the Urbit GitHub](https://github.com/urbit) and look at the pinned repositories. Feel free to open issues and make pull requests.
141We encourage outside contributors to become a part of the project. The best way to do this is to check out [the Urbit GitHub](https://github.com/urbit) and look at the pinned repositories. Feel free to open issues and make pull requests.
91You’re also invited to join the [urbit-dev](https://groups.google.com/a/urbit.org/forum/#!forum/dev) Google group and public mailing list.
143You’re also invited to join the [urbit-dev](https://groups.google.com/a/urbit.org/forum/#!forum/dev) Google group and public mailing list.
93−### What is Tlon?
145+### What is Tlon? {#urbit-project-4}
95Tlon is the San Francisco-based company that develops Urbit. Tlon doesn’t own Urbit, since Urbit is an open-source project with decentralized ownership.
147Tlon is the San Francisco-based company that develops Urbit. Tlon doesn’t own Urbit, since Urbit is an open-source project with decentralized ownership.
97−### Who works at Tlon?
149+### Who works at Tlon? {#urbit-project-5}
99You can see who we are at [tlon.io](https://tlon.io/).
151You can see who we are at [tlon.io](https://tlon.io/).
103−### What are the different types of grants?
155+### What are the different types of grants? {#grants-1}
105There are three ways to receive a grant of stars for your contribution to the Urbit ecosystem.
157There are three ways to receive a grant of stars for your contribution to the Urbit ecosystem.
106- You can submit a **Proposal** if you’re interested in working on a project of your own creation for a number of stars that you pitch.
158- You can submit a **Proposal** if you’re interested in working on a project of your own creation for a number of stars that you pitch.
107- You can apply to claim a **Bounty.** Bounties are requests for work created by Tlon that are claimable by the public, with a predetermined number of stars as the reward.
159- You can apply to claim a **Bounty.** Bounties are requests for work created by Tlon that are claimable by the public, with a predetermined number of stars as the reward.
108- The **Gifts** program, which is Tlon’s informal way of rewarding contributions that don’t fall into the above categories. There is no way to apply for a gift.
160- The **Gifts** program, which is Tlon’s informal way of rewarding contributions that don’t fall into the above categories. There is no way to apply for a gift.
110−### How do I get a gift?
162+### How do I get a gift? {#grants-2}
112Make useful and substantial contributions to Urbit. These can be contributions to the project itself, or they can be outside tools that aren’t part of the Urbit codebase. There’s no formal system for determining who gets a gift; it’s at the discretion of employees at Tlon. Nothing is guaranteed, but you can get an idea for what kinds of contributions results in gifts by looking at the [gifts history.](grant.urbit.org/history)
164Make useful and substantial contributions to Urbit. These can be contributions to the project itself, or they can be outside tools that aren’t part of the Urbit codebase. There’s no formal system for determining who gets a gift; it’s at the discretion of employees at Tlon. Nothing is guaranteed, but you can get an idea for what kinds of contributions results in gifts by looking at the [gifts history.](grant.urbit.org/history)
114−### How often are gifts awarded?
166+### How often are gifts awarded? {#grants-3}
116Gifts are awarded semiannually.
168Gifts are awarded semiannually.
118−### What happens if a user does not complete a proposal but meets some milestones?
170+### What happens if a user does not complete a proposal but meets some milestones? {#grants-4}
120You must complete the proposal to be guaranteed to receive the star grant. Partial star payouts can be negotiated for incomplete work, but such payouts are at the discretion of Tlon.
172You must complete the proposal to be guaranteed to receive the star grant. Partial star payouts can be negotiated for incomplete work, but such payouts are at the discretion of Tlon.
122However, either party may terminate a proposal on seven days’ written notice. In such a scenario, you may be paid pro rata for any portion of the proposal that has been completed.
174However, either party may terminate a proposal on seven days’ written notice. In such a scenario, you may be paid pro rata for any portion of the proposal that has been completed.
124−### Do I have to pay taxes on stars?
176+### Do I have to pay taxes on stars? {#grant-5}
126Yes. If you are American, we need your W-9 before we can pay you your stars. If you’re not an American, you don’t need to get us any forms, but you do need to personally follow the relevant tax laws in your jurisdiction.
178Yes. If you are American, we need your W-9 before we can pay you your stars. If you’re not an American, you don’t need to get us any forms, but you do need to personally follow the relevant tax laws in your jurisdiction.
128−### Can I create a bounty?
180+### Can I create a bounty? {#grants-6}
130No. Bounties are only created by Tlon, but we draw inspiration for bounties from various sources, including the community. If you want to pitch a project, use the Proposals system.
182No. Bounties are only created by Tlon, but we draw inspiration for bounties from various sources, including the community. If you want to pitch a project, use the Proposals system.
132−### How are proposals approved?
184+### How are proposals approved? {#grants-7}
134The manager of the Grants program approves them after consulting with the relevant members of the engineering team. This proposal can be accepted, rejected, or accepted with changes by Tlon. The proposal’s star payout can also be adjusted.
186The manager of the Grants program approves them after consulting with the relevant members of the engineering team. This proposal can be accepted, rejected, or accepted with changes by Tlon. The proposal’s star payout can also be adjusted.
136−### If I win a proposal, do I have an exclusive claim on the project?
188+### If I win a proposal, do I have an exclusive claim on the project? {#grants-8}
138You have a claim to the reward of the project as long as milestones are met to the satisfaction of Tlon. However, Tlon may allow another developer to work on the same project in parallel, for a separate reward.
190You have a claim to the reward of the project as long as milestones are met to the satisfaction of Tlon. However, Tlon may allow another developer to work on the same project in parallel, for a separate reward.
140−### Will milestones be embedded in a smart contract?
192+### Will milestones be embedded in a smart contract? {#grants-9}
144−### Does reputation play a role in the assessment of grants?
196+### Does reputation play a role in the assessment of grants? {#grants-10}
146Yes. We consider this to be a feature.
198Yes. We consider this to be a feature.
148−### I completed a proposal. When will I receive payment?
200+### I completed a proposal. When will I receive payment? {#grants-11}
150We will pay you within a 30-day window.
202We will pay you within a 30-day window.
152−### Can I see the proposals of others that have been accepted?
204+### Can I see the proposals of others that have been accepted? {#grants-12}
154−Yes. Check out our (proposals page.)[grant.urbit.org/proposals]
206+Yes. Check out our [proposals page.](grant.urbit.org/proposals)
156−### How do I safely store my stars?
208+### How do I safely store my stars? {#grants-13}
158We recommend storing each star in its own in its own Ethereum wallet. The private keys to these wallets should be stored on physical media that is not connected to a networked computer. Redundancies don’t hurt!
210We recommend storing each star in its own in its own Ethereum wallet. The private keys to these wallets should be stored on physical media that is not connected to a networked computer. Redundancies don’t hurt!
160−### Can I delegate a bounty or proposal to someone else?
212+### Can I delegate a bounty or proposal to someone else? {#grants-14}
162No. Not unless explicitly authorized by Tlon.
214No. Not unless explicitly authorized by Tlon.
164## Azimuth
216## Azimuth
166−### What is Azimuth?
218+### What is Azimuth? {#azimuth-1}
168Azimuth is a general-purpose identity system. It is the Urbit identity base-layer. This system is implemented as a suite of smart contracts on the Ethereum blockchain, and it determines which Ethereum addresses own which Urbit identities, called points. There is a fixed number of possible points, and they exist in three classes. Urbit uses it in Arvo, the Urbit OS.
220Azimuth is a general-purpose identity system. It is the Urbit identity base-layer. This system is implemented as a suite of smart contracts on the Ethereum blockchain, and it determines which Ethereum addresses own which Urbit identities, called points. There is a fixed number of possible points, and they exist in three classes. Urbit uses it in Arvo, the Urbit OS.
170−### What are stars, galaxies, and planets?
222+### What are stars, galaxies, and planets? {#azimuth-2}
172Points come in three classes: galaxies, stars, and planets. The length of a point’s name will tell you its class. Galaxies are 8-bit and have names like `~mul`. Galaxies issue 16-bit stars (`~dacmul`), which can themselves issue 32-bit planets (`~laptel-holfur`).
224Points come in three classes: galaxies, stars, and planets. The length of a point’s name will tell you its class. Galaxies are 8-bit and have names like `~mul`. Galaxies issue 16-bit stars (`~dacmul`), which can themselves issue 32-bit planets (`~laptel-holfur`).
174Planets are intended for everyday use by an adult human, and there are 4.3 billion of them (2 to the 32nd power). Stars and galaxies, on the other hand, are meant to act as network infrastructure: on the Arvo network they provide routing and are responsible for distributing software updates.
226Planets are intended for everyday use by an adult human, and there are 4.3 billion of them (2 to the 32nd power). Stars and galaxies, on the other hand, are meant to act as network infrastructure: on the Arvo network they provide routing and are responsible for distributing software updates.
176−### How many planets, stars, and galaxies are active?
228+### How many planets, stars, and galaxies are active? {#azimuth-3}
178The raw data on most Azimuth events that have occurred can be found [here](https://azimuth.network/stats/events.txt). We’re currently working on generalized tooling for viewing these events.
230The raw data on most Azimuth events that have occurred can be found [here](https://azimuth.network/stats/events.txt). We’re currently working on generalized tooling for viewing these events.
180−### What are comets and moons?
232+### What are comets and moons? {#azimuth-4}
182In addition to the three classes of Azimuth points mentioned above, there are two other kinds of Urbit identities that are not registered on Azimuth.
234In addition to the three classes of Azimuth points mentioned above, there are two other kinds of Urbit identities that are not registered on Azimuth.
@@ -185,66 +237,66 @@ Moons are 64 bits, are issued by planets, and have names like `~doznec-salfun-na
186Comets are 128 bits and have no parents. They can be launched by anyone. They are temporary, disposable identities. Being disposable and essentially unlimited, they will likely not be trusted by default by others on the Arvo network. They have long, hard-to-memorize names, like `~racmus-mollen-fallyt-linpex--watres-sibbur-modlux-rinmex`.
238Comets are 128 bits and have no parents. They can be launched by anyone. They are temporary, disposable identities. Being disposable and essentially unlimited, they will likely not be trusted by default by others on the Arvo network. They have long, hard-to-memorize names, like `~racmus-mollen-fallyt-linpex--watres-sibbur-modlux-rinmex`.
188−### What is a `@p`? Why is my username generated for me?
240+### What is a `@p`? Why is my username generated for me? {#azimuth-5}
190−A `@p` (pronounced *pat-pee*) is a name like `~zod` or `~lodleb-ritrul` composed of pronounceable, three-letter phonemic elements like `zod`, `lod`, `leb`, `rit` and `rul`. Shorter names, such as `~zod` and `~marzod` are assigned to ships with special duties on the Arvo network ([stars and galaxies](/./docs/concepts/galaxies-stars-and-planets/), respectively. Longer names like `~palfun-foslup` are identities for typical users.
242+A `@p` (pronounced *pat-pee*) is a name like `~zod` or `~lodleb-ritrul` composed of pronounceable, three-letter phonemic elements like `zod`, `lod`, `leb`, `rit` and `rul`. Shorter names, such as `~zod` and `~marzod` are assigned to ships with special duties on the Arvo network ([stars and galaxies](@/docs/concepts/galaxies-stars-and-planets.md), respectively. Longer names like `~palfun-foslup` are identities for typical users.
192These names are pre-generated because they map directly to a number in the urbit address space. Galaxies occupy the 8-bit address space, so any galaxy is actually a number between zero to 255. Stars occupy the 16-bit address space, and planets occupy the 32-bit address space.
244These names are pre-generated because they map directly to a number in the urbit address space. Galaxies occupy the 8-bit address space, so any galaxy is actually a number between zero to 255. Stars occupy the 16-bit address space, and planets occupy the 32-bit address space.
194−### Can I change my `@p`?
246+### Can I change my `@p`? {#azimuth-6}
196Unfortunately not, there is a 1:1 mapping between name and point.
248Unfortunately not, there is a 1:1 mapping between name and point.
198−### How do I get an identity?
250+### How do I get an identity? {#azimuth-7}
200Find someone to give you one. This will probably involve purchasing one and having it transferred to an Ethereum address that you own. We recommend using our [Bridge](https://github.com/urbit/bridge/releases) software to access the address that the point is transferred to.
252Find someone to give you one. This will probably involve purchasing one and having it transferred to an Ethereum address that you own. We recommend using our [Bridge](https://github.com/urbit/bridge/releases) software to access the address that the point is transferred to.
202−### How do I send an identity to someone else?
254+### How do I send an identity to someone else? {#azimuth-8}
204Access the Ethereum address that holds the point you wish to transfer via [Bridge](https://github.com/urbit/bridge/releases).
256Access the Ethereum address that holds the point you wish to transfer via [Bridge](https://github.com/urbit/bridge/releases).
206−### What is the best way to access Azimuth?
258+### What is the best way to access Azimuth? {#azimuth-9}
208We recommended using [Bridge](https://github.com/urbit/bridge/releases) for all Azimuth-related operations. It’s great for managing your points, as well as for viewing information about points you don’t own. We have seen publicly hosted versions of Bridge online and we do not recommend using these websites for security and privacy reasons.
260We recommended using [Bridge](https://github.com/urbit/bridge/releases) for all Azimuth-related operations. It’s great for managing your points, as well as for viewing information about points you don’t own. We have seen publicly hosted versions of Bridge online and we do not recommend using these websites for security and privacy reasons.
210## Urbit HD Wallet
262## Urbit HD Wallet
212−### What is the Urbit HD Wallet?
264+### What is the Urbit HD Wallet? {#wallet-1}
214The Urbit Hierarchical Deterministic (HD) Wallet is a system that uses public-key cryptography to secure the ownership of Urbit assets. This means that the wallet system uses public/private key-pairs to make sure that only you have access to it. Such a key-pair has two components: a public key that may be disseminated widely, and a private key that only the owner should know. The former should be treated like a login, and the latter should be treated like a password.
266The Urbit Hierarchical Deterministic (HD) Wallet is a system that uses public-key cryptography to secure the ownership of Urbit assets. This means that the wallet system uses public/private key-pairs to make sure that only you have access to it. Such a key-pair has two components: a public key that may be disseminated widely, and a private key that only the owner should know. The former should be treated like a login, and the latter should be treated like a password.
216−The Urbit HD Wallet is different from cryptocurrency wallets that you may be familiar with. The Urbit HD Wallet is not a single Ethereum key-pair that holds full power over its assets, but a system of many related Ethereum key-pairs that have distinct powers. To learn about the specifics, check out our [HD Wallet documentation](/./docs/concepts/azimuth#the-urbit-hd-wallet).
268+The Urbit HD Wallet is different from cryptocurrency wallets that you may be familiar with. The Urbit HD Wallet is not a single Ethereum key-pair that holds full power over its assets, but a system of many related Ethereum key-pairs that have distinct powers. To learn about the specifics, check out our [HD Wallet documentation](@/docs/concepts/azimuth.md#the-urbit-hd-wallet).
218−### What is a master ticket?
270+### What is a master ticket? {#wallet-2}
220In the context of the Urbit HD Wallet, master ticket is the entropy seed from which all of your other keys are derived. It should be treated like a master password: **you should never share it with anyone, and you must store it very securely (see our practices below).** This ticket can derive your ownership address and all of your proxy keys. You’ll have a ticket if you used the Urbit Wallet Generator or claimed a ship on our hosted version of Bridge.
272In the context of the Urbit HD Wallet, master ticket is the entropy seed from which all of your other keys are derived. It should be treated like a master password: **you should never share it with anyone, and you must store it very securely (see our practices below).** This ticket can derive your ownership address and all of your proxy keys. You’ll have a ticket if you used the Urbit Wallet Generator or claimed a ship on our hosted version of Bridge.
222−### What is an ownership address?
274+### What is an ownership address? {#wallet-3}
224An ownership address is an Ethereum address that has full rights over points assigned to it. It can transfer points to other people, meaning that it’s very important to secure its associated private key.
276An ownership address is an Ethereum address that has full rights over points assigned to it. It can transfer points to other people, meaning that it’s very important to secure its associated private key.
226−### What are proxies?
278+### What are proxies? {#wallet-4}
228Proxies are Ethereum addresses that can be thought of as sibling sub-wallets of your ownership address. They are meant to be used much more often than the ownership address, and have more restrictive, less valuable rights than the ownership address. These rights include spawning child points, voting, and setting networking keys.
280Proxies are Ethereum addresses that can be thought of as sibling sub-wallets of your ownership address. They are meant to be used much more often than the ownership address, and have more restrictive, less valuable rights than the ownership address. These rights include spawning child points, voting, and setting networking keys.
229- Management Proxy: Can configure or set Arvo networking keys and conduct sponsorship related operations.
281- Management Proxy: Can configure or set Arvo networking keys and conduct sponsorship related operations.
230- Voting Proxy: Galaxies only. Galaxies are the part of the galactic senate, and this means they can cast votes on new proposals including changes to the Ecliptic.
282- Voting Proxy: Galaxies only. Galaxies are the part of the galactic senate, and this means they can cast votes on new proposals including changes to the Ecliptic.
231- Spawn Proxy: For stars and galaxies only. Can create new child points.
283- Spawn Proxy: For stars and galaxies only. Can create new child points.
233−### What are seeds?
285+### What are seeds? {#wallet-5}
235All Ethereum key-pairs in the Urbit wallet system, including proxies, are produced by 128-bit values called seeds. These seeds are yours alone. An ownership key key-pair is derived from an ownership seed. Also derived from the ownership seed are various proxy seeds, which proxy key-pairs are themselves derived from.
287All Ethereum key-pairs in the Urbit wallet system, including proxies, are produced by 128-bit values called seeds. These seeds are yours alone. An ownership key key-pair is derived from an ownership seed. Also derived from the ownership seed are various proxy seeds, which proxy key-pairs are themselves derived from.
237−### What does it mean to “set public keys”?
289+### What does it mean to “set public keys”? {#wallet-6}
239This means registering the public keys of your point's encryption and authentication keys (together known as "networking keys") with Azimuth, so that others can discover them. The corresponding private keys can then be used to, for example, run a ship on the Arvo network.
291This means registering the public keys of your point's encryption and authentication keys (together known as "networking keys") with Azimuth, so that others can discover them. The corresponding private keys can then be used to, for example, run a ship on the Arvo network.
241You want to reset these keys if they are compromised, and periodically for maximum security.
293You want to reset these keys if they are compromised, and periodically for maximum security.
243−### What do I do if I want to own multiple points?
295+### What do I do if I want to own multiple points? {#wallet-7}
245We recommend using different HD Wallets for each point. You are able to assign any number of points to a single Ethereum address, however.
297We recommend using different HD Wallets for each point. You are able to assign any number of points to a single Ethereum address, however.
247−### How should I take care of my Urbit HD Wallet?
299+### How should I take care of my Urbit HD Wallet? {#wallet-8}
249Urbit points have accompanying security realities that must be taken seriously. Cryptographic assets are unique among things of value, because all of the responsibility for keeping those assets safe rests with the party that owns them.
301Urbit points have accompanying security realities that must be taken seriously. Cryptographic assets are unique among things of value, because all of the responsibility for keeping those assets safe rests with the party that owns them.
@@ -284,7 +336,7 @@ This method is risky for a number of reasons. Networked computers can contain ma
285For all of these reasons, make sure that you only use Tier 3 methods for the storage of low-value secrets.
337For all of these reasons, make sure that you only use Tier 3 methods for the storage of low-value secrets.
287−### I have a galaxy or star with lockup conditions. How does this work?
339+### I have a galaxy or star with lockup conditions. How does this work? {#wallet-9}
289There are two kinds of release schemes for locked up assets: linear and conditional.
341There are two kinds of release schemes for locked up assets: linear and conditional.
@@ -300,13 +352,13 @@ Conditional release is a bit more complicated. If your stars are in conditional
303−### What is Arvo?
355+### What is Arvo? {#arvo-1}
305Arvo is the Urbit operating system. Unlike conventional operating systems, it’s functional and deterministic. Arvo is written in Hoon, our purely functional programming language.
357Arvo is the Urbit operating system. Unlike conventional operating systems, it’s functional and deterministic. Arvo is written in Hoon, our purely functional programming language.
307Instances of the Arvo operating system, called ships, communicate as peers on what we refer to as “the Arvo network.” The Arvo network succeeds where other peer-to-peer networks have failed. Using Azimuth, Arvo ships can prove their identities to one another.
359Instances of the Arvo operating system, called ships, communicate as peers on what we refer to as “the Arvo network.” The Arvo network succeeds where other peer-to-peer networks have failed. Using Azimuth, Arvo ships can prove their identities to one another.
309−### What is unique about Arvo?
361+### What is unique about Arvo? {#arvo-2}
311Arvo is much different from other operating systems because of its determinism. Processing in the system happens in a unique way: when an event happens, a transition function takes that event and the old state of Arvo, and then produces an effect and a new state of Arvo. To visualize:
363Arvo is much different from other operating systems because of its determinism. Processing in the system happens in a unique way: when an event happens, a transition function takes that event and the old state of Arvo, and then produces an effect and a new state of Arvo. To visualize:
@@ -314,34 +366,34 @@ Arvo is much different from other operating systems because of its determinism.
315Thus, all events are permanently logged in the system, and you can always go back and see the state of the system at any point in time.
367Thus, all events are permanently logged in the system, and you can always go back and see the state of the system at any point in time.
317−### How is Arvo connected to Ethereum?
369+### How is Arvo connected to Ethereum? {#arvo-3}
319When an Arvo ship (instance) is started for the first time, you must use a key-file containing the private keys for your Azimuth point's networking keys. Azimuth uses the Ethereum blockchain as its decentralized ledger.
371When an Arvo ship (instance) is started for the first time, you must use a key-file containing the private keys for your Azimuth point's networking keys. Azimuth uses the Ethereum blockchain as its decentralized ledger.
321−See our [Getting Started](/./docs/getting-started/) guide to learnhow to get your ship onto the Arvo network.
373+See our [Getting Started](@/docs/getting-started/_index.md) guide to learn how to get your ship onto the Arvo network.
323−### Will the Arvo network survive if Ethereum dies?
375+### Will the Arvo network survive if Ethereum dies? {#arvo-4}
325Yes. It would be annoying, but Azimuth would be ported to another kind of decentralized ledger.
377Yes. It would be annoying, but Azimuth would be ported to another kind of decentralized ledger.
327−### How do I install Arvo?
379+### How do I install Arvo? {#arvo-5}
329−Check out our guides [here](/./docs/getting-started/)
381+Check out our guides [here](@/docs/getting-started/_index.md)
331−### How do I use Arvo?
383+### How do I use Arvo? {#arvo-6}
333−The [Using](/./docs/using/) section of the documentation will help you out.
385+The [Using](@/docs/using/_index.md) section of the documentation will help you out.
335−### How do over-the-air updates work?
387+### How do over-the-air updates work? {#arvo-7}
337Your sponsor, a star or galaxy that your ship “lives” under, may send you new source code for your system. When you receive new source code from your sponsor, your system recompiles itself using that code, performs any necessary data migrations, and keeps running. Ideally this happens seamlessly without the user even noticing, although there is sometimes a slowdown while rebuilding the system from source.
389Your sponsor, a star or galaxy that your ship “lives” under, may send you new source code for your system. When you receive new source code from your sponsor, your system recompiles itself using that code, performs any necessary data migrations, and keeps running. Ideally this happens seamlessly without the user even noticing, although there is sometimes a slowdown while rebuilding the system from source.
339−### What is Landscape?
391+### What is Landscape? {#arvo-8}
341Landscape is the Arvo web interface that includes social functions such as chat and message boards. You can access Landscape by navigating to <your-planet>.arvo.network, where <your-planet> is your running ship that’s connected to the Arvo network.
393Landscape is the Arvo web interface that includes social functions such as chat and message boards. You can access Landscape by navigating to <your-planet>.arvo.network, where <your-planet> is your running ship that’s connected to the Arvo network.
343−### I have a point, now what?
395+### I have a point, now what? {#arvo-9}
345−Follow our guide on how to boot a ship [here](/./docs/getting-started/booting-a-ship).
397+Follow our guide on how to boot a ship [here](@/docs/getting-started/booting-a-ship.md).
347−Get on the [mailing list](/./#mc_embed_signup). Learn [Hoon](/./docs/learn/hoon). [Make stuff](@/docs/getting-started/contributing.md).
399+Get on the [mailing list](/../#mc_embed_signup). Learn [Hoon](@/docs/learn/hoon/_index.md). [Make stuff](@/docs/getting-started/contributing.md).