There are a total of eleven layer 2 actions, each corresponding to a familiar layer 1 action: %transfer-point, %spawn, %configure-keys, %escape, %cancel-escape, %adopt, %reject, %detach, %set-management-proxy, %set-spawn-proxy, and %set-transfer-proxy. Descriptions of what these actions do may be found by searching for them at Azimuth.eth.
Once a ship moves to layer 2, the owner will still utilize the same private keys they used before the transfer to perform Azimuth actions. This includes the ownership key as well as proxies. Stars and galaxies may move their spawn proxy to layer 2 while otherwise remaining on layer 1, but it is not possible to transfer only the management proxy to layer 2; it may only happen as a side-effect of transferring ownership to layer 2.
Moving a pre-existing ship to L2
In order to move your ship from layer 1 to layer 2, transfer ownership of your ship to the address 0x1111111111111111111111111111111111111111. The easiest way to accomplish this is using Bridge. The Azimuth smart contracts interpret any ship at this address as being on layer 2.
Dominion
Layer 2 Azimuth data for a given ship includes which layer that ship is on. We call this the ship's dominion. There are three dominions: %l1, l2, and %spawn. Planets may exist in dominion %l1 or %l2, stars may exist in any of the three dominions, and galaxies may exist in dominion %l1 or %spawn. We detail what this means in each case in the following.
Planets
Permitted dominions: %l1, %l2.
%l1 planets
Permitted layer 2 actions:
- owner:
%escape,%cancel-escape - management proxy:
%escape,%cancel-escape - transfer proxy: none
A planet in dominion %l1 is said to exist on layer 1, which is the default state for all planets prior to the introduction of naive rollups. In addition to the ordinary layer 1 Azimuth actions a planet can perform, they may also choose to %escape or %cancel-escape on layer 2 using either their ownership key or management proxy. See the layer 2 sponsorship section for more information on layer 1 ships performing layer 2 sponsorship actions.
Layer 1 planets may also move to dominion %l2 by depositing their ownership to the layer 2 deposit address.
%l2 planets
Permitted layer 2 actions:
- owner:
%transfer-point,%configure-keys,%escape,%cancel-escape,%set-management-proxy,%set-transfer-proxy - management proxy:
%configure-keys,%escape,%cancel-escape,%set-management-proxy - transfer proxy:
%transfer-point,%set-transfer-proxy
A planet in dominion %l2 is said to exist on layer 2. A planet may be on layer 2 either by previously being a layer 1 planet deposited to the layer 2 address, or by being spawned by a star in dominion %spawn or %l2, in which case it will always be on layer 2.
A layer 2 planet is no longer capable of performing any layer 1 actions, and cannot move to layer 1.
Stars
Permitted dominions: %l1, %spawn, %l2.
%l1 stars
Permitted layer 2 actions:
- owner:
%escape,%cancel-escape,%adopt,%reject,%detach - management proxy:
%escape,%cancel-escape,%adopt,%reject,%detach - spawn proxy: none
- transfer proxy: none
A star in dominion %l1 is said to exist on layer 1, which is the default state for all stars prior to the introduction of naive rollups. In addition to the ordinary Azimuth actions a star can perform, they may also perform any sponsorship-related actions on layer 2.
A %l1 dominion star may move to dominion %spawn by depositing its spawn proxy to the layer 2 deposit address, or may move to dominion %l2 by depositing its ownership to the layer 2 deposit address. Both actions are irreversible.
%spawn stars
Permitted layer 2 actions:
- owner:
%escape,%cancel-escape,%adopt,%reject,%detach,%spawn,%set-spawn-proxy - management proxy:
%escape,%cancel-escape,%adopt,%reject,%detach - spawn proxy:
%spawn,%set-spawn-proxy - transfer proxy: none
A star in dominion %spawn is said to exist on layer 1.
A star in dominion %spawn may spawn planets directly on layer 2, but will no longer be able to spawn layer 1 planets and will no longer be able to set its spawn proxy on layer 1. All other layer 1 Azimuth actions may still be performed by the star.
A star moving from %l1 to %spawn has no effect on sponsorship status of any of its sponsored planets. Moving to %spawn from %l1 is currently irreversible - the only further change to dominion permitted is moving to %l2.
%l2 stars
Permitted layer 2 actions:
- owner:
%transfer-point,%spawn,%configure-keys,%escape,%cancel-escape,%adopt,%reject,%detach,%set-management-proxy,%set-spawn-proxy,%set-transfer-proxy - management proxy:
%escape,%cancel-escape,%adopt,%reject,%detach,%configure-keys,%set-management-proxy - spawn proxy:
%spawn,%set-spawn-proxy - transfer proxy:
%transfer-point,%set-transfer-proxy
A star in dominion %l2 is said to exist on layer 2. A star may exist on layer 2 by being deposited to the layer 2 deposit address from layer 1, or by being spawned by a %spawn dominion galaxy.
A star in dominion %l2 cannot perform any layer 1 actions.
Galaxies
Permitted dominions: %l1, %spawn.
%l1 galaxies
Permitted layer 2 actions:
- owner:
%adopt,%reject,%detach - management proxy:
%adopt,%reject,%detach - spawn proxy: none
- transfer proxy: none
- voting proxy: none.
A galaxy in dominion %l1 is said to exist on layer 1, which is the default state for all galaxies prior to the introduction of naive rollups. In addition to the ordinary Azimuth actions a galaxy can perform, they may also perform any sponsorship-related actions on layer 2. %l1 galaxies can perform all the usual layer 1 Azimuth actions, and may also perform layer 2 sponsorship actions.
A %l1 dominion galaxy may move to dominion %spawn by depositing its spawn proxy to the layer 2 deposit address. This action is irreversible. Note, however that the majority of galaxies already have all of their stars spawned in the Linear Star Release Contract↗. Layer 2 has no interactions with this contract - all stars released in this manner are %l1 dominion stars. Moving to the %spawn dominion has no effect on sponsorship status.
%spawn galaxies
Permitted layer 2 actions:
- owner:
%adopt,%reject,%detach,%spawn,%set-spawn-proxy - management proxy:
%adopt,%reject,%detach - spawn proxy:
%spawn,%set-spawn-proxy - transfer proxy: none
- voting proxy: none
Galaxies may either remain on layer 1, or, similar to stars, they may deposit their spawn proxy to layer 2. They cannot move their ownership, management proxy, or voting proxy to layer 2. However, as with stars, sponsorship actions may be performed on layer 2 using the ownership or management proxies regardless of the dominion status of the galaxy.