git.iko.soy/urbit.org
on master help sign in
separate page on proxies
473f005drbeefsupreme
content/docs/azimuth/hd-wallet.md+5−19
compare with master
unifiedsplit
@@ -41,25 +41,11 @@ smart-contracts.
41
41
42### Proxies
42### Proxies
43
43
44−Proxy addresses allow you to execute non-ownership related actions like spawning
44+Each permanent Urbit ID can designate one or more
45−child identities, voting, and setting networking keys without jeopardizing the
45+[proxies](/docs/using/id/proxies), which are Ethereum addresses capable of a
46−keys you've designated with ownership rights. Setting proxy rights is optional,
46+limited subset of Urbit ID transactions, such as spawning planets or rotating
47−but it is recommended for on-chain actions you will execute more frequently.
47+keys. The HD wallet automatically generates additional addresses utilized as
48−
48+proxies according to what is appropriate for your Urbit ID.
49−- **Management Proxy**
50−
51− Can configure or set Arvo networking keys and conduct sponsorship related
52− operations.
53−
54−- **Voting Proxy**
55−
56− Galaxies only. Galaxies are the part of the [Galactic
57− Senate](/docs/glossary/senate), and this means they can cast votes on new
58− proposals including changes to Ecliptic.
59−
60−- **Spawn Proxy**
61−
62− For stars and galaxies only. Can create new child identities.
63
49
64### HD wallet generation
50### HD wallet generation
65
51
content/using/id/_index.md+6−1
@@ -14,6 +14,11 @@ what allows you to truly own your identity.
14This document discusses what Urbit ID is, how it's built, and why it's been
14This document discusses what Urbit ID is, how it's built, and why it's been
15built that way at a high level.
15built that way at a high level.
16
16
17+### [Proxies](/using/id/proxies)
18+
19+You may designate other Ethereum addresses as [proxies](/docs/glossary/proxies)
20+for your Urbit ID, which are capable of a reduced subset of Urbit ID actions.
21+
17### [Using Bridge](/using/id/using-bridge)
22### [Using Bridge](/using/id/using-bridge)
18
23
19A guide to using [Bridge](https://bridge.urbit.org), our tool for managing your
24A guide to using [Bridge](https://bridge.urbit.org), our tool for managing your
@@ -44,6 +49,6 @@ aimed at developers, see the [Azimuth documentation](/docs/azimuth).
44
49
45A guide to how to utilize Bridge to interact with Layer 2.
50A guide to how to utilize Bridge to interact with Layer 2.
46
51
47−### [Layer 2 Star Proxies](/using/id/l2-star)
52+### [Layer 2 Stars](/using/id/l2-star)
48
53
49A summary of the different options available to stars and their proxies on layer 2.
54A summary of the different options available to stars and their proxies on layer 2.
content/using/id/l2-star.md+3−2
@@ -1,10 +1,11 @@
1+++
1+++
2−title = "Layer 2 Star Proxies"
2+title = "Layer 2 Stars"
3weight = 60
3weight = 60
4template = "doc.html"
4template = "doc.html"
5+++
5+++
6
6
7−This is a brief summary of proxy options for stars on layer 2.
7+This is a brief summary of the three possible options for star owners with
8+respect to use of [layer 2](/docs/glossary/rollups).
8
9
9## One-way trip
10## One-way trip
10
11
content/using/id/proxies.mdnew file+48
@@ -0,0 +1,48 @@
1++++
2+title = "Proxies"
3+weight = 3
4+template = "doc.html"
5++++
6+
7+Proxy addresses allow you to execute non-ownership related actions like spawning
8+child identities, voting, and setting networking keys without jeopardizing the
9+keys you've designated with ownership rights. Setting proxy rights is optional,
10+but it is recommended for on-chain actions you will execute more frequently.
11+
12+Setting proxies is a good security practice. For instance, you might keep your
13+ownership address in cold storage, while your management proxy is kept in Metamask.
14+
15+### Types of proxies
16+
17+There are four types of proxy: management, spawn, transfer, and voting. Their
18+capabilities are detailed in the following. In addition, each proxy is able to
19+transfer itself to another address - e.g. the management proxy can set a new
20+address to be the management proxy.
21+
22+- **Management proxy**
23+
24+ Can configure or set Arvo networking keys,
25+ [breach](/docs/using/id/guide-to-breaches), and conduct sponsorship related
26+ operations. Planets, stars, and galaxies may all set a management proxy.
27+
28+- **Spawn proxy**
29+
30+ For stars and galaxies only. Can create new child identities.
31+
32+- **Transfer proxy**
33+
34+ The address holding the transfer proxy may transfer ownership of the ID to the
35+ address of the transfer proxy. This is used to make transferring a two-step
36+ process: using the ownership address to set the transfer proxy, and then using
37+ the transfer proxy to complete the transaction. It is possible to transfer
38+ ownership as a one-step process, but this is risky and not recommended. Bridge
39+ does not natively support one-step transfers, you must use an advanced tool
40+ like [`%claz`](/docs/azimuth/advanced-azimuth-tools) to manually generate such
41+ a transaction.
42+
43+- **Voting proxy**
44+
45+ Galaxies only. Galaxies are the part of the [Galactic
46+ Senate](/docs/glossary/senate), and this means they can cast votes on new
47+ proposals including changes to Ecliptic.
48+