on 2fc5ec6 help sign in
urbit.org/getting-started/using-bridge.md
60 lines 3.9 kB history raw
1+++
2title = "Using Bridge"
3weight = 1
4template = "doc.html"
5+++
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.
9This 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.
11To 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.
13## Installation
15To use Bridge:
17+ Unzip the `.zip` file that you downloaded (`bridge-$version.zip`).
18+ Open up your command line interface (Terminal on OSX, Command Prompt on Windows).
19+ Navigate to the `bridge-$version` directory, where `$version` is the appropriate version number.
20+ Run this command: `python3 -m http.server 5000 --bind 127.0.0.1`
21+ You can then use the Bridge app by navigating to `http://localhost:5000` in your internet browser.
23**Note:** Bridge allows you both make reads and writes to the Ethereum blockchain. Writing to the blockchain, such as changing your networking keys, will incur a transaction cost that will require you to have some ETH in your address.
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.
27## Accept Your Transfer
29After you access your Ethereum address, if a point was sent to that address,
30you'll come to a page that has an `Incoming Transfers` header, under which is
31a graphic. Click the `Details ->` link under that graphic.
33Now you'll be on the management page of your point. The transfer isn't completed
34yet, so click `Accept incoming transfer`. Then check both boxes and and click
35their associated `Sign Transaction` and `Send Transaction` buttons.
37If you already own a point, then click on the `Details ->` under your sigil in the
38`Your Points` section.
40## Set Your Networking Keys
42If 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!
44Click the link that says `Set network keys`. The field that is presented in the resulting page expects a 32-byte hexadecimal string. If it's filled already, no action is required. If this is empty, you will need to generate such a string. You can generate this data any way you please, but in the terminal on MacOS or Linux, you can write
46```
47hexdump -n 32 -e '4/4 "%08X"' /dev/random
48```
50and use the result.
52It 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.
54## Generate Your Keyfile
56From 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.
58Click `Generate ->`, which will download a keyfile onto your machine.
60With that keyfile in hand, you can now exit Bridge, and continue to the guide to [installing Arvo](./docs/getting-started/installing-urbit.md).