on master help sign in
Merge pull request #614 from urbit/new-bridge
d54d916rmariani
getting-started/using-bridge.md+16−8
@@ -4,13 +4,21 @@ weight = 1
4template = "doc.html"
4template = "doc.html"
5+++
5+++
6
6
7−[Bridge](https://github.com/urbit/bridge) is the client we built for interacting with [Azimuth](@/docs/concepts/azimuth.md), the Urbit PKI, and managing your Azimuth identities, called _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.
7+[Bridge](https://github.com/urbit/bridge) is the application we built for interacting with [Azimuth](@/docs/concepts/azimuth.md), the Urbit PKI, and managing your Azimuth identities, also known as _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.
8
8
9−This guide assumes that you own an Azimuth point, or that you have found someone to send an Azimuth point to your Ethereum address and are looking to claim it.
9+This guide assumes that you own an Azimuth identity, or that you have found someone to send an Azimuth identity to your Ethereum address and are looking to claim it.
10
10
11−To install Bridge, navigate to the [release page](https://github.com/urbit/bridge/releases/) on GitHub. Download the `.zip` file of the latest version. After you download it, follow the instructions below.
11+## Online Bridge
12
12
13+To connect to Bridge, type `<identity-name>.azimuth.network` into your browser, where `<identity-name>` is the name of your Azimuth identity, minus the `~`. If you were invited to claim an Azimuth identity, it's very likely that you received an email that would direct you to Bridge, and you can simply follow the hyperlink in that email.
14+
15+Once you arrive Proceed through the steps presented to you. You'll eventually arrive at a page with a few choices: `Invite`, `Admin`, and `Boot Arvo`. `Admin` is the only option that you're interested in right now; click on it. On the "Admin" page, click the `Download Arvo Keyfile` button. Once you have downloaded the keyfile, you can exit Bridge ands proceed to the guide to [installing Arvo](@/docs/getting-started/installing-urbit.md).
16+
17+## Offline Bridge
18+
19+Alternatively, Bridge can be run locally. It's more complicated, but we recommend this option for managing sufficiently valuable assets, such as several stars or more. To install local Bridge, navigate to the [release page](https://github.com/urbit/bridge/releases/) on GitHub. Download the `.zip` file of the latest version. After you download it, follow the instructions below.
20+
13−## Installation
21+### Installation
14
22
15To use Bridge:
23To use Bridge:
16
24
@@ -24,9 +32,9 @@ To use Bridge:
24
32
25Once the program is running in your browser, go through each step presented according to what kind of wallet you have. There are a few login options you'll be presented with. A notable option is **Urbit Master Ticket**. This is for those who used our Wallet Generator software. If you bought points from an Urbit sale and then used the Wallet Generator, your networking keys will be set for you. All other login options will result in you needing to set your own networking keys.
33Once the program is running in your browser, go through each step presented according to what kind of wallet you have. There are a few login options you'll be presented with. A notable option is **Urbit Master Ticket**. This is for those who used our Wallet Generator software. If you bought points from an Urbit sale and then used the Wallet Generator, your networking keys will be set for you. All other login options will result in you needing to set your own networking keys.
26
34
27−## Accept Your Transfer
35+### Accept Your Transfer
28
36
29−If you were given points by Tlon, you likely already fully own them. But if someone sent you a point, then you will first need to accept that transfer.
37+If you were given points by Tlon, you likely already fully own them. But if someone sent you a point, then you will first need to use Bridge to accept that transfer.
30
38
31After you access your Ethereum address, if a point was sent to that address,
39After you access your Ethereum address, if a point was sent to that address,
32you'll come to a page that has an `Incoming Transfers` header, under which is
40you'll come to a page that has an `Incoming Transfers` header, under which is
@@ -39,7 +47,7 @@ their associated `Sign Transaction` and `Send Transaction` buttons.
39If you already own a point, then click on the `Details ->` under your sigil in the
47If you already own a point, then click on the `Details ->` under your sigil in the
40`Your Points` section.
48`Your Points` section.
41
49
42−## Set Your Networking Keys
50+### Set Your Networking Keys
43
51
44If you just accepted a point, you'll be returned to your point screen. Notice that that links and buttons are now clickable. You now own this point!
52If you just accepted a point, you'll be returned to your point screen. Notice that that links and buttons are now clickable. You now own this point!
45
53
@@ -53,7 +61,7 @@ and use the result.
53
61
54It should be noted that setting your network keys is an event on the Ethereum network, and will therefore cost a trivial, but non-zero, amount of [gas](https://github.com/ethereum/wiki/wiki/Design-Rationale#gas-and-fees) to complete.
62It should be noted that setting your network keys is an event on the Ethereum network, and will therefore cost a trivial, but non-zero, amount of [gas](https://github.com/ethereum/wiki/wiki/Design-Rationale#gas-and-fees) to complete.
55
63
56−## Generate Your Keyfile
64+### Generate Your Keyfile
57
65
58From the detail page associated with your point, click the `Generate Arvo Keyfile` link and you'll be taken to a page with a field titled `Network seed`. This field should already be filled in, and should match the hexadecimal string that you entered in the previous step. If its not filled in or does not match, fill it in with the correct string.
66From the detail page associated with your point, click the `Generate Arvo Keyfile` link and you'll be taken to a page with a field titled `Network seed`. This field should already be filled in, and should match the hexadecimal string that you entered in the previous step. If its not filled in or does not match, fill it in with the correct string.
59
67