Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
alanorwick committed Nov 28, 2023
1 parent ab5a1f4 commit 90f4656
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 122 deletions.
46 changes: 8 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,16 @@
People wishing to submit QIPs, first should propose their idea to the [https://forum.qu.ai Quai forum] (do <em>not</em> assign a number - read <a href="qip-0001.mediawiki">QIP 1</a> for the full process). After discussion, please open a PR. After copy-editing and acceptance, it will be published here.
People wishing to submit QIPs, first should propose their idea to the [Quai forum](https://forum.qu.ai) (do *not* assign a number - read [QIP 1](qip-0001.md) for the full process). After discussion, please open a PR. After copy-editing and acceptance, it will be published here.

We are fairly liberal with approving QIPs, and try not to be too involved in decision making on behalf of the community. The exception is in very rare cases of dispute resolution when a decision is contentious and cannot be agreed upon. In those cases, the conservative option will always be preferred.

Having a QIP here does not make it a formally accepted standard until its status becomes Final or Active.

Those proposing changes should consider that ultimately consent may rest with the consensus of the Quai users.

{| class="wikitable sortable" style="width: auto; text-align: center; font-size: smaller; table-layout: fixed;"
!Number
!Layer
!Title
!Owner
!Type
!Status
|- style="background-color: #cfffcf"
| [[qip-0001.mediawiki|1]]
|
| QIP process
| wizeguyy
| Process
| Active
|-
| [[qip-0002.mediawiki|2]]
| Consensus (hard fork)
| Sharded ledger
| wizeguyy
| Standard
| Draft
|-
| [[qip-0003.mediawiki|3]]
| Applications
| Shard Specific Address Discovery
| wizeguyy
| Standard
| Draft
|-
| [[qip-0004.mediawiki|4]]
| Applications
| 9 Shard Address Mapping
| wizeguyy
| Standard
| Draft
|}
| Number | Layer | Title | Owner | Type | Status |
|--------|----------------------|---------------------------------|----------|---------|--------|
| [1](qip-0001.md) | | QIP process | wizeguyy | Process | Active |
| [2](qip-0002.md) | Consensus (hard fork) | Sharded ledger | wizeguyy | Standard| Draft |
| [3](qip-0003.md) | Applications | Shard Specific Address Discovery | wizeguyy | Standard| Draft |
| [4](qip-0004.md) | Applications | 9 Shard Address Mapping | wizeguyy | Standard| Draft |

<!-- IMPORTANT! See the instructions at the top of this page, do NOT JUST add QIPs here! -->
<!-- IMPORTANT! See the instructions at the top of this page, do NOT JUST add QIPs here! -->
118 changes: 34 additions & 84 deletions qip-0004.md
Original file line number Diff line number Diff line change
@@ -1,96 +1,46 @@
<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>
```
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](https://github.com/quainetwork/qips/wiki/Comments:QIP-0004)
Status: Draft
Type: Standards Track
Created: 2023-09-15
License: BSD-2-Clause
```

==Abstract==
## Abstract

This QIP defines a address mapping to be used in an 9 shard hierarchy of the Quai protocol.
This QIP defines an address mapping to be used in a 9 shard hierarchy of the Quai protocol.

==Motivation==
## 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.
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 the 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==
## Specification

===Overview===
### 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===
### 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.
| 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 is licensed under the BSD 2-clause license.

0 comments on commit 90f4656

Please sign in to comment.