Skip to content

Commit 045e55a

Browse files
Convert ASCII diagrams to Mermaid in core-concepts.md
- Eight algorithms grid: visual flowchart with hardware types - Emission schedule: gradient flowchart showing Q/H progression - Traditional vs Marking: side-by-side comparison with color coding - MRK Protocol: structured data layout with byte sizes - Network Architecture: vertical layer diagram with icons All diagrams use royal purple color scheme for consistency.
1 parent 6d6e170 commit 045e55a

File tree

1 file changed

+124
-46
lines changed

1 file changed

+124
-46
lines changed

docs/getting-started/core-concepts.md

Lines changed: 124 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -51,16 +51,37 @@ Unlike most cryptocurrencies that use a single mining algorithm, Bitmark support
5151

5252
### The Eight Algorithms
5353

54-
```
55-
┌─────────────────────────────────────────────────────────────┐
56-
│ BITMARK ALGORITHMS │
57-
├─────────────┬─────────────┬─────────────┬──────────────────┤
58-
│ SCRYPT │ SHA256D │ YESCRYPT │ ARGON2D │
59-
│ (ASIC/GPU) │ (ASIC) │ (CPU/GPU) │ (CPU) │
60-
├─────────────┼─────────────┼─────────────┼──────────────────┤
61-
│ X17 │ LYRA2REv2 │ EQUIHASH │ CRYPTONIGHT │
62-
│ (GPU) │ (GPU) │ (GPU/ASIC) │ (CPU/GPU) │
63-
└─────────────┴─────────────┴─────────────┴──────────────────┘
54+
```mermaid
55+
flowchart TB
56+
subgraph algos["⛏️ BITMARK MINING ALGORITHMS"]
57+
direction TB
58+
subgraph row1[" "]
59+
direction LR
60+
A1["**SCRYPT**<br/>ASIC/GPU"]
61+
A2["**SHA256D**<br/>ASIC"]
62+
A3["**YESCRYPT**<br/>CPU/GPU"]
63+
A4["**ARGON2D**<br/>CPU"]
64+
end
65+
subgraph row2[" "]
66+
direction LR
67+
B1["**X17**<br/>GPU"]
68+
B2["**LYRA2REv2**<br/>GPU"]
69+
B3["**EQUIHASH**<br/>GPU/ASIC"]
70+
B4["**CRYPTONIGHT**<br/>CPU/GPU"]
71+
end
72+
end
73+
74+
style algos fill:#f3e8ff,stroke:#7c3aed,stroke-width:2px
75+
style row1 fill:transparent,stroke:none
76+
style row2 fill:transparent,stroke:none
77+
style A1 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
78+
style A2 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
79+
style A3 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
80+
style A4 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
81+
style B1 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
82+
style B2 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
83+
style B3 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
84+
style B4 fill:#ede9fe,stroke:#8b5cf6,stroke-width:1px
6485
```
6586

6687
Each algorithm:
@@ -104,10 +125,24 @@ Bitmark uses **Dark Gravity Wave v3 (DGWv3)** for difficulty adjustment, customi
104125

105126
The emission uses a combined **halving + quartering** pattern:
106127

107-
```
108-
Block Rewards Over Time:
109-
20 → 15 → 10 → 7.5 → 5 → 3.75 → 2.5 → ...
110-
Q1 H1 Q2 H2 Q3 H3
128+
```mermaid
129+
flowchart LR
130+
R20["**20**<br/>MARKS"] -->|"Q1<br/>×0.75"| R15["**15**<br/>MARKS"]
131+
R15 -->|"H1<br/>÷2"| R10["**10**<br/>MARKS"]
132+
R10 -->|"Q2<br/>×0.75"| R75["**7.5**<br/>MARKS"]
133+
R75 -->|"H2<br/>÷2"| R5["**5**<br/>MARKS"]
134+
R5 -->|"Q3<br/>×0.75"| R375["**3.75**<br/>MARKS"]
135+
R375 -->|"H3<br/>÷2"| R25["**2.5**<br/>MARKS"]
136+
R25 -->|"..."| Future["..."]
137+
138+
style R20 fill:#7c3aed,stroke:#5b21b6,color:#fff
139+
style R15 fill:#8b5cf6,stroke:#6d28d9,color:#fff
140+
style R10 fill:#a78bfa,stroke:#7c3aed,color:#fff
141+
style R75 fill:#c4b5fd,stroke:#8b5cf6
142+
style R5 fill:#ddd6fe,stroke:#a78bfa
143+
style R375 fill:#ede9fe,stroke:#c4b5fd
144+
style R25 fill:#f5f3ff,stroke:#ddd6fe
145+
style Future fill:#faf5ff,stroke:#ede9fe
111146
```
112147

113148
Where:
@@ -131,12 +166,36 @@ A **Subsidy Scaling Factor (SSF)** adjusts rewards based on network hashrate:
131166

132167
A mark is a "like" that carries real economic value:
133168

134-
```
135-
Traditional Social Media Marking System
136-
───────────────────────── ──────────────
137-
Like → Number on screen Mark → Real value transferred
138-
Creator → Gets nothing Creator → Gets paid
139-
Platform → Sells attention Protocol → Value flows directly
169+
```mermaid
170+
flowchart TB
171+
subgraph traditional["❌ TRADITIONAL SOCIAL MEDIA"]
172+
direction TB
173+
T1["👍 Like"] --> T2["Number on screen"]
174+
T3["🎨 Creator"] --> T4["Gets nothing"]
175+
T5["🏢 Platform"] --> T6["Sells attention"]
176+
end
177+
178+
subgraph marking["✅ MARKING SYSTEM"]
179+
direction TB
180+
M1["✨ Mark"] --> M2["Real value transferred"]
181+
M3["🎨 Creator"] --> M4["Gets paid"]
182+
M5["🔗 Protocol"] --> M6["Value flows directly"]
183+
end
184+
185+
style traditional fill:#fef2f2,stroke:#dc2626,stroke-width:2px
186+
style marking fill:#f0fdf4,stroke:#16a34a,stroke-width:2px
187+
style T1 fill:#fee2e2,stroke:#ef4444
188+
style T2 fill:#fee2e2,stroke:#ef4444
189+
style T3 fill:#fee2e2,stroke:#ef4444
190+
style T4 fill:#fee2e2,stroke:#ef4444
191+
style T5 fill:#fee2e2,stroke:#ef4444
192+
style T6 fill:#fee2e2,stroke:#ef4444
193+
style M1 fill:#dcfce7,stroke:#22c55e
194+
style M2 fill:#dcfce7,stroke:#22c55e
195+
style M3 fill:#dcfce7,stroke:#22c55e
196+
style M4 fill:#dcfce7,stroke:#22c55e
197+
style M5 fill:#dcfce7,stroke:#22c55e
198+
style M6 fill:#dcfce7,stroke:#22c55e
140199
```
141200

142201
### How Marks Work
@@ -151,12 +210,23 @@ Platform → Sells attention Protocol → Value flows directly
151210

152211
Marks are recorded on-chain using **OP_RETURN** transactions:
153212

154-
```
155-
Mark Data (37 bytes):
156-
┌─────────┬─────────┬─────────┬───────────────────────────────┐
157-
│ MRK │ VERSION │ TYPE │ SHA256(reference) │
158-
│ 3 bytes │ 1 byte │ 1 byte │ 32 bytes │
159-
└─────────┴─────────┴─────────┴───────────────────────────────┘
213+
```mermaid
214+
flowchart LR
215+
subgraph mrk["📦 MARK DATA (37 bytes)"]
216+
direction LR
217+
F1["**MRK**<br/>3 bytes"]
218+
F2["**VERSION**<br/>1 byte"]
219+
F3["**TYPE**<br/>1 byte"]
220+
F4["**SHA256(reference)**<br/>32 bytes"]
221+
end
222+
223+
F1 --- F2 --- F3 --- F4
224+
225+
style mrk fill:#f3e8ff,stroke:#7c3aed,stroke-width:2px
226+
style F1 fill:#7c3aed,stroke:#5b21b6,color:#fff
227+
style F2 fill:#8b5cf6,stroke:#6d28d9,color:#fff
228+
style F3 fill:#a78bfa,stroke:#7c3aed,color:#fff
229+
style F4 fill:#c4b5fd,stroke:#8b5cf6
160230
```
161231

162232
Mark types include:
@@ -180,26 +250,34 @@ The smallest divisible unit is **1 satoshi** = 0.00000001 BTM = 1 Markbit.
180250

181251
## Network Architecture
182252

183-
```
184-
┌─────────────────────────────────────────────────────────────┐
185-
│ USER LAYER │
186-
│ (Wallets, Applications, Marking Interface) │
187-
└───────────────────────────┬─────────────────────────────────┘
188-
189-
┌───────────────────────────▼─────────────────────────────────┐
190-
│ API LAYER │
191-
│ (REST API, RPC, ElectrumX) │
192-
└───────────────────────────┬─────────────────────────────────┘
193-
194-
┌───────────────────────────▼─────────────────────────────────┐
195-
│ NODE LAYER │
196-
│ (Full Nodes, Miners, Indexers) │
197-
└───────────────────────────┬─────────────────────────────────┘
198-
199-
┌───────────────────────────▼─────────────────────────────────┐
200-
│ BLOCKCHAIN LAYER │
201-
│ (Consensus, Transactions, Blocks) │
202-
└─────────────────────────────────────────────────────────────┘
253+
```mermaid
254+
flowchart TB
255+
subgraph user["👤 USER LAYER"]
256+
U["Wallets, Applications, Marking Interface"]
257+
end
258+
259+
subgraph api["🔌 API LAYER"]
260+
A["REST API, RPC, ElectrumX"]
261+
end
262+
263+
subgraph node["🖥️ NODE LAYER"]
264+
N["Full Nodes, Miners, Indexers"]
265+
end
266+
267+
subgraph chain["⛓️ BLOCKCHAIN LAYER"]
268+
B["Consensus, Transactions, Blocks"]
269+
end
270+
271+
user --> api --> node --> chain
272+
273+
style user fill:#f3e8ff,stroke:#7c3aed,stroke-width:2px
274+
style api fill:#ede9fe,stroke:#8b5cf6,stroke-width:2px
275+
style node fill:#ddd6fe,stroke:#a78bfa,stroke-width:2px
276+
style chain fill:#c4b5fd,stroke:#8b5cf6,stroke-width:2px
277+
style U fill:#faf5ff,stroke:#7c3aed
278+
style A fill:#f5f3ff,stroke:#8b5cf6
279+
style N fill:#ede9fe,stroke:#a78bfa
280+
style B fill:#ddd6fe,stroke:#8b5cf6
203281
```
204282

205283
## Key Terminology

0 commit comments

Comments
 (0)