Skip to content

Commit 2fa1f65

Browse files
committed
doc(appearances): Fix spelling
1 parent cb62356 commit 2fa1f65

File tree

2 files changed

+40
-18
lines changed

2 files changed

+40
-18
lines changed

specs/appearances.md

+39-18
Original file line numberDiff line numberDiff line change
@@ -63,58 +63,79 @@ An address has the following formal definition:
6363
- MUST begin or end with `MIN_NONZERO_BYTES` non-zero bytes.
6464
This allows for vanity address inclusion of up to `MAX_VANITY_ZERO_CHARS`.
6565
- MUST NOT be a known precompile
66-
- When detected within > 20 bytes, 32 bytes MUST appear with left padding (12 leading zero-bytes).
66+
- When detected within byte sequence of greater than 20 bytes, the bytes MUST appear with left padding (12 leading zero-bytes for the case of a 32 byte sequence).
6767
The address that meets the criteria is extracted from the source bytes.
68-
- When inspecting >32 bytes, the bytes MUST first trimmed to a multiple of 32 bytes and divided
68+
- When inspecting more than 32 bytes, the bytes MUST first trimmed to a multiple of 32 bytes and divided
6969
into 32 byte sections (length modulo 32) to be examined separately.
7070

7171
The following examples show the detection and extraction of an address/addresses
7272
from a sequence of bytes.
7373
### Example "address"
7474
Deposit contract address in a 32 byte hex string with left padding:
75+
```command
76+
"0x00000000000000000000000000000000219ab540356cbb839cbe05303d7705fa"
7577
```
76-
"0x00000000000000000000000000000000219ab540356cBB839Cbe05303d7705Fa"
77-
> ["0x00000000219ab540356cBB839Cbe05303d7705Fa"]
78+
Result:
79+
```console
80+
["0x00000000219ab540356cbb839cbe05303d7705fa"]
7881
```
7982

8083
Deposit contract address bytes, but shifted left. A valid address is detected,
8184
but is not the deposit contract address:
85+
```command
86+
"0x00000000000000000000219ab540356cbb839cbe05303d7705fa000000000000"
8287
```
83-
"0x00000000000000000000219ab540356cBB839Cbe05303d7705Fa000000000000"
84-
> ["0x219ab540356cBB839Cbe05303d7705Fa00000000"]
88+
Result:
89+
```console
90+
["0x219ab540356cbb839cbe05303d7705fa00000000"]
8591
```
8692

8793
Data from the two examples above, concatenated:
94+
```command
95+
"0x00000000000000000000000000000000219ab540356cbb839cbe05303d7705fa00000000000000000000219ab540356cbb839cbe05303d7705fa000000000000"
8896
```
89-
0x00000000000000000000000000000000219ab540356cBB839Cbe05303d7705Fa00000000000000000000219ab540356cBB839Cbe05303d7705Fa000000000000
90-
> ["0x219ab540356cBB839Cbe05303d7705Fa00000000", "0x00000000219ab540356cBB839Cbe05303d7705Fa]
97+
Result:
98+
```console
99+
["0x219ab540356cbb839cbe05303d7705fa00000000", "0x00000000219ab540356cbb839cbe05303d7705fa]
91100
```
92101

93102
Data from the example above, with additional bytes that are truncated as modulo 32 bytes:
94103
```
95-
0x00000000000000000000000000000000219ab540356cBB839Cbe05303d7705Fa00000000000000000000219ab540356cBB839Cbe05303d7705Fa000000000000
96-
> ["0x219ab540356cBB839Cbe05303d7705Fa00000000", "0x00000000219ab540356cBB839Cbe05303d7705Fa]
104+
"0x00000000000000000000000000000000219ab540356cbb839cbe05303d7705fa00000000000000000000219ab540356cbb839cbe05303d7705fa000000000000"
105+
```
106+
Result:
107+
```console
108+
["0x219ab540356cbb839cbe05303d7705fa00000000", "0x00000000219ab540356cbb839cbe05303d7705fa]
97109
```
98110

99111
### Example "not address"
100112

101113
Deposit contract address in a 32 byte hex string with right padding. No address is detected because the leftmost 24 characters (12 bytes) must all be zeros:
114+
```command
115+
"0x00000000219ab540356cbb839cbe05303d7705fa000000000000000000000000"
102116
```
103-
"0x00000000219ab540356cBB839Cbe05303d7705Fa000000000000000000000000"
104-
> []
117+
Result:
118+
```console
119+
[]
105120
```
106121

107122
No address is detected because the leftmost 24 characters (12 bytes) are ignored and the
108-
remaining string has too many trailing 0's (`0x9Cbe05303d7705Fa000000000000000000000000`):
123+
remaining string has too many trailing 0's (`0x9cbe05303d7705fa000000000000000000000000`):
124+
```command
125+
"0x0000000000000000000000009cbe05303d7705fa000000000000000000000000"
109126
```
110-
"0x0000000000000000000000009Cbe05303d7705Fa000000000000000000000000"
111-
> []
127+
Result:
128+
```console
129+
[]
112130
```
113131
Nonzero characters long enough for an address, but rejected for spanning a 32 byte boundary
114-
(read as `0x...000219ab540356cBB83` and `0x9Cbe05303d7705Fa000...`):
132+
(read as `0x...000219ab540356cbb83` and `0x9cbe05303d7705fa000...`):
133+
```command
134+
"0x000000000000000000000000000000000000000000000000219ab540356cbb839cbe05303d7705fa000000000000000000000000000000000000000000000000"
115135
```
116-
"0x000000000000000000000000000000000000000000000000219ab540356cBB839Cbe05303d7705Fa000000000000000000000000000000000000000000000000"
117-
> []
136+
Result:
137+
```console
138+
[]
118139
```
119140
## Appearance definition
120141

wordlist.txt

+1
Original file line numberDiff line numberDiff line change
@@ -57,3 +57,4 @@ randao
5757
src
5858
https
5959
forkchoiceupdatedresponsev
60+
retSize

0 commit comments

Comments
 (0)