qip-0004: 9 Shard Address Mapping

README.mediawiki

@@ -34,6 +34,13 @@ Those proposing changes should consider that ultimately consent may rest with th
 | wizeguyy
 | Standard
 | Draft
+|-
+| [[qip-0004.mediawiki|4]]
+| Applications
+| 9 Shard Address Mapping
+| wizeguyy
+| Standard
+| Draft
 |}
 
 <!-- IMPORTANT!  See the instructions at the top of this page, do NOT JUST add QIPs here! -->

qip-0004.mediawiki

@@ -0,0 +1,96 @@
+<pre>
+  QIP: 4
+  Layer: Applications
+  Title: 9 Shard Address Mapping
+  Author: wizeguyy <[email protected]>
+  Comments-Summary: No comments yet.
+  Comments-URI: https://github.com/quainetwork/qips/wiki/Comments:QIP-0004
+  Status: Draft
+  Type: Standards Track
+  Created: 2023-09-15
+  License: BSD-2-Clause
+</pre>
+
+==Abstract==
+
+This QIP defines a address mapping to be used in an 9 shard hierarchy of the Quai protocol.
+
+==Motivation==
+
+This defines the address mapping used in early testnets of the Quai protocol. Early testnets use a lighter 9-shard hierarchy. It has already been concluded that mainnet should accommodate more than 9-shards,so this mapping is no longer recommended. We documented it here for wallet compatibility with early testnets.
+
+==Specification==
+
+===Overview===
+
+The address space is divided into subsets according to address prefix. The account state for each subset of addresses will be maintained wholly by one and only one shard. Intra-shard transactions may only be processed by the blockchain which maintains that shard. Inter-shard transactions are possible, but the specification for those will be left to another QIP.
+
+===Address Mapping===
+
+All addresses are mapped to exist in one of nine shards according to the MSB of the address. The Address groupings are given below:
+
+{|
+!Name
+!Region
+!Zone
+!Min Address
+!Max Address
+|-
+| cyprus1
+| region-0
+| zone-0-0
+| 0x0000000000000000000000000000000000000000
+| 0x1DFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| cyprus2
+| region-0
+| zone-0-1
+| 0x1E00000000000000000000000000000000000000
+| 0x3AFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| cyprus3
+| region-0
+| zone-0-2
+| 0x3B00000000000000000000000000000000000000
+| 0x57FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| paxos1
+| region-1
+| zone-1-0
+| 0x5800000000000000000000000000000000000000
+| 0x73FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| paxos2
+| region-1
+| zone-1-1
+| 0x7400000000000000000000000000000000000000
+| 0x8FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| paxos3
+| region-1
+| zone-1-2
+| 0x9000000000000000000000000000000000000000
+| 0xABFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| hydra1
+| region-2
+| zone-2-0
+| 0xAC00000000000000000000000000000000000000
+| 0xC7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| hydra2
+| region-2
+| zone-2-1
+| 0xC800000000000000000000000000000000000000
+| 0xE3FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|-
+| hydra3
+| region-2
+| zone-2-2
+| 0xE400000000000000000000000000000000000000
+| 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+|}
+
+==Copyright==
+
+This QIP licensed under the BSD 2-clause license.