e1d8649 · urbit.org · git.iko.soy

git.iko.soy/urbit.org

remove .md from links

commite1d864909029fcc16c74672d0e13e9d8c6487b02 authordrbeefsupreme <drbeefsupreme@discordja.net> dateWed 4 Aug 2021, 11:55 (5 years ago) parent4b05d3d

23 files changed+71−71

compare with master

unifiedsplit

content/Bitcoin-wallet.md+1−1

@@ -18,7 +18,7 @@ If you are interested in [being a provider](https://subject.network/posts/btc-wa

1818

1919### Verify

2020

21−You should verify your version of this Bitcoin wallet. To do so, follow the instructions in the README in our [Github](https://github.com/urbit/urbit/blob/master/pkg/btc-wallet/README.md) repo.

21+You should verify your version of this Bitcoin wallet. To do so, follow the instructions in the README in our [Github](https://github.com/urbit/urbit/blob/master/pkg/btc-wallet/README) repo.

2222

2323Instructions reproduced here:

2424

content/blog/first-contract.md+23−23

@@ -15,9 +15,9 @@ image = "https://media.urbit.org/site/posts/essays/land3.jpg"

1515<br>

1616

1717Recently, the [first upgrade](https://github.com/urbit/azimuth/pull/35) to the

18−[Azimuth](/docs/glossary/azimuth.md) smart contracts which make up Urbit ID was

19−put up to an [upgrade proposal vote](/docs/glossary/upgrade.md) by the

20−[Galactic Senate](/docs/glossary/senate.md). This vote is still open and will

18+[Azimuth](/docs/glossary/azimuth) smart contracts which make up Urbit ID was

19+put up to an [upgrade proposal vote](/docs/glossary/upgrade) by the

20+[Galactic Senate](/docs/glossary/senate). This vote is still open and will

2121last for 30 days (June 20th) or until an absolute majority is reached. We’d like

2222to take this opportunity to discuss two things. [First](#changelist), what the

2323proposed changes are, and [second](#senate), a review of how Urbit governance

@@ -25,16 +25,16 @@ works and where we’re at in the decentralization process.

2525

2626Before we dive into what the proposed changes are, let’s review what the Senate

2727is actually capable of changing. Urbit ID is really two sets of smart contracts:

28−Azimuth and [Ecliptic](/docs/glossary/ecliptic.md). Azimuth is the data of the

28+Azimuth and [Ecliptic](/docs/glossary/ecliptic). Azimuth is the data of the

2929public key infrastructure - roughly, this is the list of

30−[ships](/docs/glossary/ship.md) and which Ethereum addresses own them, along

30+[ships](/docs/glossary/ship) and which Ethereum addresses own them, along

3131with other data such as networking keys and sponsorship status. The Senate has

3232no ability to touch this data directly. This is in direct contrast to all

3333existing centralized services, where your account is always at risk of being

3434taken away from you. What the Senate can change is Ecliptic, which is the

3535“business logic” that decides how you can interact with the data in Azimuth.

3636These are mechanisms such as what powers various

37−[proxies](/docs/glossary/proxies.md) have, how stars/planets are released over

37+[proxies](/docs/glossary/proxies) have, how stars/planets are released over

3838time, and how sponsorship works. Put another way, the data and database format

3939must remain the same, but the rules by which we interact with it may change

4040according to the governance rules we [detail below](#senate).

@@ -119,27 +119,27 @@ current position, but still serve as useful historical markers. We hope to

119119revisit and refresh these documents soon.

120120

121121- [2016.5.16 - Interim

122− Constitution](/blog/interim-constitution.md)

122+ Constitution](/blog/interim-constitution)

123123- [2016.5.16 - The

124− Urbit Address Space](/blog/the-urbit-address-space.md)

124+ Urbit Address Space](/blog/the-urbit-address-space)

125125- [2016.6.24 - The DAO as a Lesson in Decentralized

126− Governance](/blog/the-dao-as-a-lesson-in-decentralized-governance.md)

126+ Governance](/blog/the-dao-as-a-lesson-in-decentralized-governance)

127127- [2019.1.11 - Governance of

128− urbit.org](/blog/governance-of-urbit.md)

128+ urbit.org](/blog/governance-of-urbit)

129129

130130### Galactic Senate

131131

132−The Galactic Senate is composed of all [galaxy](/docs/glossary/galaxy.md)

132+The Galactic Senate is composed of all [galaxy](/docs/glossary/galaxy)

133133holders, which at present consists of more than 100 individuals and a few

134134organizations, including Tlon and the Urbit Foundation. Using the Azimuth

135135voting contract, the Senate can present and vote on two kinds of proposals:

136−[document proposals](/docs/glossary/docvote.md) and [upgrade

137−proposals](/docs/glossary/upgrade.md). Thus far, all matters which the Senate

136+[document proposals](/docs/glossary/docvote) and [upgrade

137+proposals](/docs/glossary/upgrade). Thus far, all matters which the Senate

138138has voted on have been document proposals. The [most recent

139139vote](https://github.com/urbit/azimuth/pull/34) declared the Urbit network as

140140(i) being secure (as confirmed by a [third party

141−audit](/blog/security-audit.md)) and (ii) having reached continuity (as in, no

142−further [network breaches](/docs/glossary/breach.md) are expected). Previous votes

141+audit](/blog/security-audit)) and (ii) having reached continuity (as in, no

142+further [network breaches](/docs/glossary/breach) are expected). Previous votes

143143were to declare that [Azimuth is live](https://github.com/urbit/azimuth/pull/25)

144144and that [Arvo is stable](https://github.com/urbit/azimuth/pull/24).

145145

@@ -155,7 +155,7 @@ In the beginning, Urbit’s creator Curtis Yarvin was in possession of the entir

155155address space - all 256 galaxies, and everything underneath it. A network of one

156156is no network at all, and so over the last decade Urbit’s development has been

157157primarily driven by selling or giving away these galaxies. On [June 1,

158−2016](/blog/the-urbit-address-space.md), the allocation was:

158+2016](/blog/the-urbit-address-space), the allocation was:

159159

160160> 95, to the Tlon Corporation. 50, to urbit.org, the future community

161161> foundation. 40, to Tlon employees and their family members (24 to Curtis, who

@@ -167,9 +167,9 @@ primarily driven by selling or giving away these galaxies. On [June 1,

167167Since then, Tlon has sold a number of

168168its galaxies to fund development and others have changed hands to the point

169169that Tlon and urbit.org no longer possess a majority share of galaxies. In

170−January 2019, [Curtis gave all of his galaxies](/blog/a-founders-farewell.md) to

170+January 2019, [Curtis gave all of his galaxies](/blog/a-founders-farewell) to

171171Tlon when he left the project. In August 2020 we shared an update on the [known

172−distribution of address space](/blog/value-of-address-space-pt3.md), where

172+distribution of address space](/blog/value-of-address-space-pt3), where

173173Curtis’ galaxies are marked as Tlon’s “naked galaxies”. Shortly thereafter, Tlon

174174disbursed its naked galaxies among the employees that wanted one who did not

175175already possess one, thus removing Tlon and urbit.org’s controlling share of the

@@ -198,13 +198,13 @@ controlled by the users is now well underway.

198198

199199In the past, nearly all Urbit software was written by Tlon. While Tlon is still

200200the only corporation actively updating Urbit’s MIT-licensed open source

201−software, namely [Vere](/docs/glossary/vere.md) (the runtime),

202−[Arvo](/docs/glossary/arvo.md) (the kernel),

203−[Landscape](/docs/glossary/landscape.md) (the client), and

204−[Bridge](/docs/glossary/bridge.md) (the ID manager), unaffiliated individuals have been making enormous contributions to Urbit over the past couple of years via the [grants program](https://grants.urbit.org/history). Recent examples include the [Bitcoin node and wallet integration](https://github.com/urbit/urbit/pull/4940), [WebRTC integration](https://grants.urbit.org/proposals/21131866-webrtc-gall-agent-and-external-app), [Port, an Urbit installer and ship manager](https://github.com/arthyn/port), and [`|fuse`, an important primitive for 3rd party software distribution](https://github.com/urbit/urbit/pull/4820).

201+software, namely [Vere](/docs/glossary/vere) (the runtime),

202+[Arvo](/docs/glossary/arvo) (the kernel),

203+[Landscape](/docs/glossary/landscape) (the client), and

204+[Bridge](/docs/glossary/bridge) (the ID manager), unaffiliated individuals have been making enormous contributions to Urbit over the past couple of years via the [grants program](https://grants.urbit.org/history). Recent examples include the [Bitcoin node and wallet integration](https://github.com/urbit/urbit/pull/4940), [WebRTC integration](https://grants.urbit.org/proposals/21131866-webrtc-gall-agent-and-external-app), [Port, an Urbit installer and ship manager](https://github.com/arthyn/port), and [`|fuse`, an important primitive for 3rd party software distribution](https://github.com/urbit/urbit/pull/4820).

205205

206206The only real power Tlon holds over Urbit is the ability to push [OTA

207−updates](/docs/glossary/ota-updates.md) via `~zod`, and suggest that people

207+updates](/docs/glossary/ota-updates) via `~zod`, and suggest that people

208208download our binaries. To the best of our knowledge, all extant galaxies

209209retrieve their OTA updates from `~zod`, who forward it to their stars, who

210210forward it to their planets. This software distribution route is merely a

content/blog/first-steps-towards-urbit-org.md+1−1

@@ -56,4 +56,4 @@ I look forward to working with you.

5656

5757[^2]: We’re also really into the idea of being the first builder of housing on Mars. Just saying...

5858

59−[^3]: We call this project Airlock. You’ll hear more about it soon.

59+[^3]: We call this project Airlock. You’ll hear more about it soon.

content/community/governance.md+1−1

@@ -16,7 +16,7 @@ An owner of a galaxy (or a delegate) can propose a new iteration of the contract

1616

1717In a similar process, document hashes can be proposed. While their off-chain documents can't be "technically enforced", this mechanism is useful for the Senate to record more abstract decisions.

1818

19−For off-chain process around proposals, as suggested by core developers, please see [senate.md](https://github.com/urbit/azimuth/blob/master/senate.md).

19+For off-chain process around proposals, as suggested by core developers, please see [senate.md](https://github.com/urbit/azimuth/blob/master/senate).

2020

2121The group of core developers manages Urbit’s [GitHub repository](https://github.com/urbit/), which controls Arvo, Urbit’s operating system. Changes and upgrades are decided upon by consensus.

2222

content/docs/arvo/ames/ames.md+6−6

@@ -11,7 +11,7 @@ over it. When Unix receives a packet over the correct UDP port, it pipes

1111it straight into Ames for handling. Also, all packets sent over the

1212Ames network are sent by the Ames vane. Apps and vanes may use

1313Ames to directly send messages to other ships. In general, apps use

14−[Gall](/docs/userspace/gall/gall.md) and [Clay](/docs/arvo/clay/clay.md)

14+[Gall](/docs/userspace/gall/gall) and [Clay](/docs/arvo/clay/clay)

1515to communicate with other ships rather than using Ames

1616directly, but this isn't a requirement. Of course, Gall and Clay use

1717Ames behind the scenes to communicate across the network. Jael is the only other

@@ -28,7 +28,7 @@ vane or app, is defined in Ames.

2828This section summarizes the design of Ames. Beyond this section are deeper

2929elaborations on the concepts presented here.

3030

31−Ames extends [Arvo's](/docs/arvo/overview.md) `%pass`/`%give` `move` semantics across the network.

31+Ames extends [Arvo's](/docs/arvo/overview) `%pass`/`%give` `move` semantics across the network.

3232

3333Ames receives packets as Arvo events and emits packets as Arvo

3434effects. The runtime is responsible for transferring the bytes in

@@ -159,9 +159,9 @@ order:

159159

160160 `SIV` is a "synthetic initialization vector" as defined in AES-256 SIV, the encryption

161161 algorithm utilized to encrypt Ames packets (see the page on [Ames

162− cryptography](/docs/arvo/ames/cryptography.md)). It is formed from the

162+ cryptography](/docs/arvo/ames/cryptography)). It is formed from the

163163 following noun: `~[sender=@p receiver=@p sender-life=@ receiver-life=@]` (see

164− [Life and Rift](/docs/azimuth/life-and-rift.md) for information on what `life`

164+ [Life and Rift](/docs/azimuth/life-and-rift) for information on what `life`

165165 is). As this data is in Azimuth, it is not explicitly sent over the wire. Thus

166166 the mod 16 sender and receiver life in the first 8 bits are only for quick

167167 filtering of honest packets sent to or from a stale life.

@@ -256,7 +256,7 @@ This means all re-sends of an ack packet will be bitwise identical to each other

256256Each datum in this noun is an atom with the aura `@ud` or an aura that nests

257257under `@ud`.

258258

259−Here, `our-life` refers to the [`life`](/docs/glossary/breach.md), or revision

259+Here, `our-life` refers to the [`life`](/docs/glossary/breach), or revision

260260number, of the acking ship's networking keys, and `her-life` is the `life` of

261261the ack-receiving ship's networking keys. `bone` is an opaque number identifying

262262the flow. `message-num` denotes the number of the

@@ -428,7 +428,7 @@ message.

428428

429429Urbit's functionality is split between the two binaries `urbit-worker` (sometimes

430430called the Serf) and `urbit-king` (sometimes called the King). This division of

431−labor is currently not well-documented outside of the [Vere documents](/docs/vere/_index.md), but we summarize it here.

431+labor is currently not well-documented outside of the [Vere documents](/docs/vere/_index), but we summarize it here.

432432

433433In short, the Serf is the Nock runtime and so keeps track of the current state

434434of Arvo as a Nock noun and updates the state by `%poke`ing it with nouns, and

content/docs/arvo/ames/cryptography.md+1−1

@@ -35,7 +35,7 @@ is used for authentication

3535

3636The encrypted payload of each packet is a `$shut-packet`, which is the `+jam` of

3737a cell with the `bone`, message number, and message fragment or ack (see

38−[Ames](/docs/arvo/ames/ames.md) for more information on packet structure). The

38+[Ames](/docs/arvo/ames/ames) for more information on packet structure). The

3939message fragment is signed using the authentication key. It is encrypted using

4040[`+en:crub:crypto`](/docs/arvo/reference/cryptography.md#en) found in

4141`sys/zuse.hoon`, which utilizes the 256-bit AES-SIV algorithm.

content/docs/arvo/reference/_index.md+1−1

@@ -5,7 +5,7 @@ sort_by = "weight"

55template = "sections/docs/chapters.html"

66+++

8−[Cryptography](/docs/arvo/reference/cryptography.md)

8+[Cryptography](/docs/arvo/reference/cryptography)

1010An overview of where Arvo uses cryptography, what algorithms are used, and how

1111they are implemented.

content/docs/arvo/reference/cryptography.md+5−5

@@ -6,12 +6,12 @@ template = "doc.html"

77This is a summary of the cryptography functions found in `sys/zuse.hoon`, Arvo's

88standard library. This page currently only documents cryptographic functions

9−directly utilized by [Ames](/docs/arvo/ames/ames.md). `zuse` also contains

9+directly utilized by [Ames](/docs/arvo/ames/ames). `zuse` also contains

1010cryptographic functions relevant to Ethereum such as the `+keccak:crypto` core,

1111but they are currently undocumented.

1212

13−Documentation for [Insecure Hashing](/docs/hoon/reference/stdlib/2e.md) and the

14−[SHA Hash Family](/docs/hoon/reference/stdlib/3d.md) is found in the Hoon standard

13+Documentation for [Insecure Hashing](/docs/hoon/reference/stdlib/2e) and the

14+[SHA Hash Family](/docs/hoon/reference/stdlib/3d) is found in the Hoon standard

1515library reference.

1616

1717## Summary

@@ -198,9 +198,9 @@ Diffie-Hellman](https://en.wikipedia.org/wiki/Elliptic-curve_Diffie%E2%80%93Hell

198198key agreements as well as [Elliptic Curve Digital Signature

199199Algorithm](https://en.wikipedia.org/wiki/Elliptic_Curve_Digital_Signature_Algorithm).

200200These functionalities are ultimately utilized by [`+crub:crypto`](#crub), the

201−only cryptosuite which [Ames](/docs/arvo/ames/ames.md) makes use of.

201+only cryptosuite which [Ames](/docs/arvo/ames/ames) makes use of.

202202

203−Most gates in `+ed:crypto` are [jetted](/docs/vere/jetting.md), meaning that an

203+Most gates in `+ed:crypto` are [jetted](/docs/vere/jetting), meaning that an

204204external reference library is utilized whenever these functions are called,

205205rather than running in Nock natively. See the [Vere

206206documentation](/docs/vere/cryptography.md#ed) for more information about the

content/docs/arvo/reference/filesystem.md+8−8

@@ -7,13 +7,13 @@ template = "doc.html"

77Here we describe what each of the primary folders present in the `%home` `desk`

88are used for. This organization is merely a convention, and the exact location

99of any file does not affect its operation. That being said, some [Ford

10−runes](/docs/arvo/ford/ford.md) are designed with this structure in mind, and

10+runes](/docs/arvo/ford/ford) are designed with this structure in mind, and

1111applications such as dojo look in specific folders for code to run. Furthermore,

1212this organization is not perfectly adhered to - sometimes you may find structure

1313definitions in `/lib`, for example.

1414

1515- `/app` contains userspace applications, i.e. [Gall

16− agents](/docs/userspace/gall/gall.md).

16+ agents](/docs/userspace/gall/gall).

1717- `/gen` contains generators. Many applications make use of generators, but

1818 also each generator in this folder may be run from dojo using `+`. For

1919 example, `/gen/foo/hoon` is run with `+foo`.

@@ -21,7 +21,7 @@ definitions in `/lib`, for example.

2121 generators, etc. However, this is not the location of the standard libraries

2222 (see `/sys`). Libraries are imported from `/lib` with `/+`.

2323- `/mar` contains [mark](/docs/arvo/clay/architecture.md#marks) definitions.

24−- `/sur` contains shared [structure](/docs/hoon/reference/rune/_index.md) definitions.

24+- `/sur` contains shared [structure](/docs/hoon/reference/rune/_index) definitions.

2525 Whenever you expect structures to be used by code across multiple files, it

2626 is recommended to place their shared structures in `/sur`. Structures are

2727 imported from `/sur` with `/-`.

@@ -30,7 +30,7 @@ definitions in `/lib`, for example.

3030 the exception to the rule - structures and functions that are central to

3131 Hoon, Arvo, and its vanes, are all located within this folder rather than in

3232 `/lib` and `/sur`. See [below](#sys) for more information on `/sys`.

33−- `/ted` contains [threads](/docs/userspace/threads/overview.md). These may be

33+- `/ted` contains [threads](/docs/userspace/threads/overview). These may be

3434 run from dojo using `-`. For example, `/ted/foo/hoon` is run with `-foo`.

3535- `/tests` contains unit tests intended to be run using the `test` thread. To

3636 run a particular test `+test-bar` in `/tests/foo.hoon` in dojo, enter `-test %/tests/foo/test-bar ~`. If a file is specified, every test in that file will

@@ -44,13 +44,13 @@ dependencies is `hoon.hoon` -> `arvo.hoon` -> `lull.hoon` -> `zuse.hoon`. We

4444give a brief description of each of them.

4545

4646- `hoon.hoon` contains the Hoon compiler and the [Hoon standard

47− library](/docs/hoon/reference/stdlib/table-of-contents.md). The Hoon

47+ library](/docs/hoon/reference/stdlib/table-of-contents). The Hoon

4848 compiler is self-hosted. This is the first file loaded by the Nock virtual

49− machine, [Vere](/docs/vere/runtime.md), in order for it to learn how to

49+ machine, [Vere](/docs/vere/runtime), in order for it to learn how to

5050 interpret Hoon. The kelvin version number is the subject of `hoon.hoon`,

5151 currently at 140. One may see this from dojo by inspecting the subject with

5252 `.` and noting that `%140` is the final entry of the subject.

53−- `arvo.hoon` contains the [Arvo kernel](/docs/arvo/overview.md) and

53+- `arvo.hoon` contains the [Arvo kernel](/docs/arvo/overview) and

5454 additional structures and functions directly relevant to the kernel. This is

5555 Urbit's "traffic cop", and as such contains the structure definitions for

5656 call stacks such as `duct`s and `bone`s. Once Vere understands Hoon, it loads

@@ -64,6 +64,6 @@ give a brief description of each of them.

6464 in order to prepare to create the vanes. `arvo.hoon` is the subject of `lull.hoon`.

6565- `zuse.hoon` is the Arvo standard library. It consists primarily of functions

6666 shared by the kernel and vanes, such as the ones related to

67− [cryptography](/docs/arvo/reference/cryptography.md). `zuse.hoon` is loaded

67+ [cryptography](/docs/arvo/reference/cryptography). `zuse.hoon` is loaded

6868 by the larval kernel following `lull.hoon`. `lull.hoon` is the subject of

6969 `zuse.hoon`. Then `zuse` is the subject of the vanes.

content/docs/azimuth/azimuth.md+2−2

@@ -43,7 +43,7 @@ Think of your master ticket like a very high-value password. The master ticket i

4343

4444### Ownership Address

4545

46−An ownership address has all rights over the assets deeded to it. These rights are on-chain actions described and implemented in [Ecliptic](/docs/glossary/ecliptic.md), Azimuth's suite of governing smart-contracts.

46+An ownership address has all rights over the assets deeded to it. These rights are on-chain actions described and implemented in [Ecliptic](/docs/glossary/ecliptic), Azimuth's suite of governing smart-contracts.

4747

4848### Proxies

4949

@@ -56,7 +56,7 @@ Proxy addresses allow you to execute non-ownership related actions like spawning

5656

5757- **Voting Proxy**

5858

59− Galaxies only. Galaxies are the part of the [Galactic Senate](/docs/glossary/senate.md), and this means

59+ Galaxies only. Galaxies are the part of the [Galactic Senate](/docs/glossary/senate), and this means

6060 they can cast votes on new proposals including changes to Ecliptic.

6161

6262- **Spawn Proxy**

content/docs/development/develop.md+1−1

@@ -35,7 +35,7 @@ an [interface](https://github.com/urbit/urbit/tree/master/pkg/interface) built

3535with [React](https://reactjs.org).

3636

3737Additionally, you can [contribute to

38−Landscape](https://github.com/urbit/urbit/blob/master/pkg/interface/CONTRIBUTING.md)

38+Landscape](https://github.com/urbit/urbit/blob/master/pkg/interface/CONTRIBUTING)

3939by tackling issues in its [issue

4040tracker](https://github.com/urbit/landscape/issues) and/or running the

4141[development stream](https://groups.google.com/a/urbit.org/g/dev/c/r2hv4ajCLwk).

content/docs/hoon/hoon-school/doors.md+1−1

@@ -408,7 +408,7 @@ In the above example we created a door `c` with sample `b=@` and found that the

408408 ++ greater |=(a=@ (gth a b))

409409 --

410410```

411−Here the type of `b` is inferred to be `@` based on the example value `7`, similar to how we've seen casting done by example. You will learn more about how types are inferred in [Lesson 2.2](@docs/hoon/hoon-school/type-checking-and-type-inference.md).

411+Here the type of `b` is inferred to be `@` based on the example value `7`, similar to how we've seen casting done by example. You will learn more about how types are inferred in [Lesson 2.2](@docs/hoon/hoon-school/type-checking-and-type-inference).

412412

413413### Doors in the Hoon Standard Library

414414

content/docs/hoon/reference/irregular.md+1−1

@@ -294,7 +294,7 @@ See [%sand](/docs/hoon/reference/rune/constants#warm) for other irregular defini

294294

295295### Wings

296296

297−[docs](content/docs/hoon/reference/limbs/wing.md)

297+[docs](content/docs/hoon/reference/limbs/wing)

298298`[%wing p=(list limb)]`; a limb search path.

299299`a.b` finds limb `a` within limb `b` ("var" `a` within "var" `b`).

300300

content/docs/system-overview/cryptography.md+3−3

@@ -119,6 +119,6 @@ Jael and utilized by Ames for end-to-end encrypted communication.

119119The following pages contained more detailed information about the cryptography

120120utilized by each of the system components.

121121

122−- [Ames](/docs/arvo/ames/cryptography.md)

123−- [Zuse](/docs/arvo/reference/cryptography.md)

124−- [Vere](/docs/vere/cryptography.md)

122+- [Ames](/docs/arvo/ames/cryptography)

123+- [Zuse](/docs/arvo/reference/cryptography)

124+- [Vere](/docs/vere/cryptography)

content/docs/userspace/threads/basics/summary.md+1−1

@@ -11,7 +11,7 @@ Now here's a quick recap of the main points covered:

1111## Spider

1212

1313- is the gall agent that manages threads.

14−- Details of interacting with threads via spider can be seen [here](../reference.md).

14+- Details of interacting with threads via spider can be seen [here](../reference).

1515

1616## Threads

1717- are like transient gall agents

content/docs/vere/_index.md+1−1

@@ -37,6 +37,6 @@ A walkthrough of each of the `u3` modules.

3737

3838A jetting guide by for new Urbit developers.

3939

40−## [Cryptography](/docs/vere/cryptography.md)

40+## [Cryptography](/docs/vere/cryptography)

4141

4242References on the cryptography libraries utilized by jets.

content/docs/vere/cryptography.md+2−2

@@ -5,7 +5,7 @@ template = "doc.html"

55+++

77All cryptographic primitives utilized by Arvo are

8−[jetted](/docs/vere/jetting.md). This is done for performance-related reasons

8+[jetted](/docs/vere/jetting). This is done for performance-related reasons

99in other parts of the system, but for cryptography this is also extremely

1010important because it allows us to utilize standard reference implementations for

1111the primitives written in C.

@@ -15,7 +15,7 @@ All jets related to encryption may be found in `pkg/urbit/jets/e/`.

1515In this section we review what specific implementations are utilized. At the

1616moment, only libraries directly related to Ames are documented here, though we

1717note that there are jets for other cryptographic functions such as the [SHA

18−Hash Family](/docs/hoon/reference/stdlib/3d.md) as well.

18+Hash Family](/docs/hoon/reference/stdlib/3d) as well.

1919

2020### Ed25519 {#ed}

2121

content/faq.md+6−6

@@ -124,15 +124,15 @@ It’s also worth noting that, while there are almost 8B people on Earth, there

124124

125125### How secure is Urbit right now? {#how-secure-is-urbit}

126126

127−We consider some parts of Urbit to be secure, while other parts still need some work and external auditing. For technical details on Urbit's cryptosystems, see the [documentation](/docs/system-overview/cryptography.md).

127+We consider some parts of Urbit to be secure, while other parts still need some work and external auditing. For technical details on Urbit's cryptosystems, see the [documentation](/docs/system-overview/cryptography).

128128

129129[Urbit ID](#what-is-urbit-id) / [Azimuth](#what-is-azimuth), Urbit's identity layer, is live on the Ethereum blockchain and has been audited by Open Zeppelin, Blockchain at Berkeley, and Bloctrax.

130130

131−In late 2020, Urbit's [Ames](/docs/glossary/ames.md) networking protocol was audited by [Leviathan Security](https://www.leviathansecurity.com/). You can read about this milestone [here](/blog/security-and-continuity.md).

131+In late 2020, Urbit's [Ames](/docs/glossary/ames) networking protocol was audited by [Leviathan Security](https://www.leviathansecurity.com/). You can read about this milestone [here](/blog/security-and-continuity).

132132

133−The security of the runtime, [Vere](/docs/vere/_index.md), has not yet been adequately assessed or systematically hardened.

133+The security of the runtime, [Vere](/docs/vere/_index), has not yet been adequately assessed or systematically hardened.

134134

135−All communication on Urbit is end-to-end encrypted. However, the [event log](/docs/glossary/eventlog.md) is not encrypted at rest but we plan to give users that option in the future.

135+All communication on Urbit is end-to-end encrypted. However, the [event log](/docs/glossary/eventlog) is not encrypted at rest but we plan to give users that option in the future.

136136

137137Tlon keeps a quantum computing expert on staff and understands that post-quantum cryptographic methods must be implemented sooner than later, since any data not already encrypted using these methods is at risk of being collected and decrypted once sufficiently powerful quantum computers exist. [NIST](https://www.nist.gov/) anticipates the release of their preliminary findings on [post-quantum cryptography standards](https://csrc.nist.gov/projects/post-quantum-cryptography) around the end of 2021, with full guidelines following in 2024. Tlon will develop a strategy for post-quantum encryption for Urbit following their recommendations.

138138

@@ -142,7 +142,7 @@ Thus, while Urbit is probably more secure and private than most digital communic

142142

143143The [Urbit Hierarchical Deterministic (HD) Wallet](/docs/glossary/hdwallet) is a custom Ethereum wallet based on BIP39 and BIP44 – the same underlying technology used by wallet providers like Ledger, Trezor, Metamask, and MyEtherWallet. You can think of the Urbit HD wallet as a wallet of wallets, which lets you keep a single passphrase for all of your Urbit ID keys. Urbit ID uses multiple keys with different capabilities – a bit like permissions – so that you can keep the more valuable keys in cold storage while keeping less valuable keys, used in day-to-day operation, more easily accessible. If you're only operating a planet, you shouldn't have to worry about this: you can simply think of your "master ticket" as the password to your Urbit ID. If you're operating a star or galaxy, the Urbit HD Wallet allows you to implement a multi-tier key custody scheme.

144144

145−If you're interested, you can read the spec here: [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet.md).

145+If you're interested, you can read the spec here: [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet).

146146

147147### What is a master ticket? {#master-ticket}

148148

@@ -167,7 +167,7 @@ An ownership address is an Ethereum address that owns one or more of your Urbit

167167

168168All Ethereum key-pairs in the Urbit wallet system, including [proxies](/docs/glossary/proxies), are produced by 128-bit cryptographically random values called seeds. These seeds are the equivalent of the BIP39 mnemonic of an Ethereum wallet and are yours alone. An ownership key pair is derived from an ownership seed and, likewise, the various proxy key pairs are generated from their respective proxy seeds.

169169

170−For detailed information see the [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet.md).

170+For detailed information see the [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet).

171171

172172### What does it mean to “set public keys”? {#set-public-keys}

173173

content/grants/bitcoin-key-derivation.md+1−1

@@ -52,7 +52,7 @@ The worker should have a background that demonstrates proficiency with building

5252

5353### Resources

5454

55−- [Urbit HD Wallet design](https://github.com/urbit/fora-posts/blob/master/proposals/posts/~2018.11.8..19.31.59..ba77~.md)

55+- [Urbit HD Wallet design](https://github.com/urbit/fora-posts/blob/master/proposals/posts/~2018.11.8..19.31.59..ba77~)

5656- [BIP-32 re: extended public keys](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki#Extended_keys)

5757

5858## Milestones

content/grants/bitcoin-wallet-on-bridge.md+1−1

@@ -39,7 +39,7 @@ A completed wallet should:

3939- [Bitcoin Core SPV wallet reference](https://bitcoin.org/en/operating-modes-guide#simplified-payment-verification-spv)

4040- [JS Library to interact with SPV wallet](https://github.com/bitcoinjs/bitcoinjs-lib)

4141- [The Bridge repository](https://github.com/urbit/bridge)

42−- [Urbit Wallet Reference](https://github.com/urbit/fora-posts/blob/master/proposals/posts/~2018.11.8..19.31.59..ba77~.md)

42+- [Urbit Wallet Reference](https://github.com/urbit/fora-posts/blob/master/proposals/posts/~2018.11.8..19.31.59..ba77~)

4343- [Urbit Wallet Key Generation](https://github.com/urbit/urbit-key-generation]

4444- [BIP 32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)

4545- [BIP 39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki)

content/grants/the-complete-guide-to-gall-and-landscape.md+1−1

@@ -18,7 +18,7 @@ link = ""

1818

1919## PoC and Prior Work

2020

21−The first 5 chapters of the course are complete in late draft form and can be found [here](https://github.com/timlucmiptev/gall-guide/blob/master/guide-docs/overview.md)

21+The first 5 chapters of the course are complete in late draft form and can be found [here](https://github.com/timlucmiptev/gall-guide/blob/master/guide-docs/overview)

2222

2323My ["Nock for Everyday Coders" Guide](https://blog.timlucmiptev.space/part1.html) was the result of my exploring Nock on my own, and is probably the most detailed Nock reference available currently.

2424

content/grants/unit-tests-for-zuse-cryptographic-functions.md+1−1

@@ -32,7 +32,7 @@ Save the test files in the `tests/sys/zuse/crypto` directory in Arvo. Use the sa

3232#### Resources

3333

3434- Read the [guide](https://github.com/urbit/urbit/blob/master/pkg/arvo/TESTING.udon) to writing unit tests in Hoon.

35−- Read the guide to [contributing](https://github.com/urbit/urbit/blob/master/CONTRIBUTING.md).

35+- Read the guide to [contributing](https://github.com/urbit/urbit/blob/master/CONTRIBUTING).

3636- [Here](https://github.com/urbit/urbit/blob/alef2/pkg/arvo/tests/sys/zuse/ordered-map.hoon) is an example test file for the new Ames. Your tests should be similar to it.

3737

3838#### Contribution Guidelines

content/grants/volt-lightning-on-urbit.md+2−2

@@ -110,7 +110,7 @@ Private key/hot wallet management inside Urbit. This is needed to sign commitmen

110110### RFCs implemented

111111

112112We implement everything related to channels, HTLCs, and invoices. We leave out all the Lightning networking and routing elements.

113−[RFCs located here](https://github.com/lightningnetwork/lightning-rfc/blob/master/00-introduction.md)

113+[RFCs located here](https://github.com/lightningnetwork/lightning-rfc/blob/master/00-introduction)

114114

115115- RFC 02: channel opening, closing, HTLCs

116116- RFC 03: commitment transactions

@@ -231,7 +231,7 @@ It is possible to re-balance channel liquidity (shifting more of the balance to

231231

232232- The libraries and full node interface provided by the `btc-wallet` project will be useful for parsing formats like `bech32` and for querying the state of the blockchain to monitor for cheating.

233233- [Urbit Bitcoin Wallet](https://github.com/timlucmiptev/btc-agents)

234−- [Lightning RFC](https://github.com/lightningnetwork/lightning-rfc/blob/master/00-introduction.md)

234+- [Lightning RFC](https://github.com/lightningnetwork/lightning-rfc/blob/master/00-introduction)

235235- [lnd RPC API](https://api.lightning.community/)

236236

237237## contributor requirements