From 5ec12a7f82f83fc362a139332598d739146c008e Mon Sep 17 00:00:00 2001
From: qiang <freedostudio@gmail.com>
Date: Wed, 5 Aug 2026 16:32:15 +0800
Subject: [PATCH 1/2] milestone

---
 .DS_Store                                     | Bin 0 -> 8196 bytes
 ...nator-driven-execution-replay-milestone.md |  45 ++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 .DS_Store
 create mode 100644 L1/coordinator-driven-execution-replay-milestone.md

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..dde3c3549167d76c198d7c87d5679afc215f771c
GIT binary patch
literal 8196
zcmeHMTWl0n7(U;$v@>*|1GKhaM>buEfGuoWvE`O*Z_2&Mwsc!A%kIud2c|P+XSXeu
zn#RNjQ8YejyhWb8MIKbd_@arT=%b<u#`u8Is4tq}i^_xlnKR3!g%@L@;GAU6fBxG!
zbN=)F=j@qfjG?1oG%;4o7?bJYRI8xsI)&@`Gowg>q>L!YpJi+}L+#U<5!;$!9SXt-
zgb@fM5Jn)3Kp27lLImi{=0(22xi7R~9Y!FG!2dD=e1C}0!)ZLAQ-b<i2UY$RfM_X+
z{X%VxH;6_88V~4{proM!;Yw7vBDi8exRX2**u?`nC8%&`2reH8Mn-T$fj>I+AMwo@
z;(~^C7=bVXGb6z7?h@O|nlfYF$kq3EFCUA21*xQTR#~}RE?3BV6GQG;BA?C|ypD8k
zH|Kg?*Ul8%>C7(697}0covxElTaKCY9W28nlRf>GW4L1-Zox4;-!~x?vLY)ft!84P
zscB6^BsSR)nP_T>wKPQ9R^Kx@smRsQRqJ-94%x$w`>1$(1UmqmGi^4<ic=X)<Q&^|
z4iL|6`ShA^o#{2(-e{*-sgeZ$(!y8j>*7i&vn$j&dVg|YaJQP$=8w{n^o-;!*YS3l
zIge;ctMq8;Hf3FBN6zH>{;X>kh8-`Z&C90kY{5?F&34;PSPz;ctMsxt*S2@Kp2fQv
zNaoG)JlD-oB?mn>m+$mDOIp;wu+j>ixznUhtx>a!y7sE3ts9h+b88kaS=QLxx<1~$
zY1{qhDz$m@7pT?hAYsJGTMt-fZXoStO~<gD1ASwbkss<GwLB|ho4rnY*i`1BK{;1h
zyKvF%b-FGLt~eA;lZA|RxM1avXi-`A$B5|l>K=pMX`5^CQ4Co-Mg7p|OZ9qvH`jFL
zOsb8*VYz;n+UwEeWi2fXSE@0!_Yi?w(L5n(QCI7Ib~<C)ie`v$+SIjr|EP$+qHPhv
z4QjQX%(}zFG(}GlvUa^w-^YjDn)dQNBc{V&>8#M*OS(aCD4jEV#wfXhH`+{6e@RKs
zow^Mx@A^uL#`bz$AK=}!8-_oJMYRhn^@QFhYoE(0O|zU)ixQfaRphlCEiO$ozCtvk
z9~_SOEkDrFcua^DI<9rr%(^JI_Ol$DV8_`r>;!w8onardFWI;3Cw7tj4xkL>n2icl
zVG)*~0jtr9HmpGhdawgKk-#1d!NNg!7{?Jz;3yu!F+7Ijcmhx31-yuta00L4O}vFu
zcn9y}EI!3&_yQO39lpm8_yvF9Ph65_Ni|Zfv{0&-8l*;PrPM05No%Eb(srpwN=j+z
zpyW#9Vggce7uhTLVl5q^mcL_Angtu8bn^OXR(IdVO`EseJZW}*uAf*{)wk6|mabTJ
zciV>c%K#LJErRrF==*rTCQE$0`*@g!)pLFZs&_0drrebz6iL}fiDHh+JYTi)z&g4_
zrbN+Z1?;lr#BR~b1Y6g*Ql_NTB%f95np+e~J*^~Q8(WEmVAOT%6-q*_G+^(D6U%(2
zuCA+_x;d-K{}jT{vkUA;_A9$Y2%n1usKuR#5w1J15!-!aC(ws|NMS!RFfa@UE)EmM
zk75!JVG0iu!XGD$KZ&RCES|&jg!7m23SPzQc!N-W8t>vge29;52A>3Y|Ax^1GcHa;
z@U|j$1;uYg1W!8$uQemCL`Z7+{lELh-~VU$g@P~wVFYfS2%xkp(bYloDV~Ybr^fHv
z5qkF1!wa{Y64ZC0>Y5J$#9#iyklGP4<v#I%P6<j9D*w`lfbjee&wn3(>~H<Tz4_1o
FzW}F8*sK5m

literal 0
HcmV?d00001

diff --git a/L1/coordinator-driven-execution-replay-milestone.md b/L1/coordinator-driven-execution-replay-milestone.md
new file mode 100644
index 0000000..49f288f
--- /dev/null
+++ b/L1/coordinator-driven-execution-replay-milestone.md
@@ -0,0 +1,45 @@
+# Coordinator-Driven Historical Execution Replay Milestone
+
+## Goal
+
+Replay every root-confirmed QuarkChain mainnet minor block from genesis through four `goshard` slaves, driven by a dedicated coordinator, with results identical to `pyquarkchain`.
+
+## Scope
+
+The milestone includes:
+
+- QKC data types, including blocks, transactions, receipts, logs, and state encoding.
+- QuarkChain EVM compatibility.
+- Multi-native-token state and execution.
+- Minor-block execution, finalization, result validation, and state persistence.
+- Cross-shard transaction generation, delivery, ordering, and execution.
+- A replay coordinator for canonical input, branch routing, root advancement, barriers, and mismatch reporting.
+
+The milestone excludes:
+
+- Minor-block PoW/PoSW seal and difficulty validation.
+- Root-chain fork choice and root-driven shard reorgs.
+- Mining, txpool, live P2P sync, public RPC, and master compatibility.
+
+## Final Test
+
+1. Start four Go slaves with fresh databases, covering every historical mainnet branch, and establish their xshard connections.
+2. Initialize the exact root and minor genesis state for every shard.
+3. Read canonical root blocks in ascending order. For each committed minor header, load the full minor block and send it to the slave responsible for its branch.
+4. Execute minor blocks serially within each branch. Different branches may run in parallel.
+5. For each source minor block, the source slave must route a list, including an empty list, to every eligible destination shard. Each destination shard must persist the list before replay advances.
+6. After all minor blocks and xshard lists for a root block are complete, broadcast that root block as the next trusted canonical root. Only then may later minor blocks consume its deposits.
+7. For every minor block, compare the computed execution outputs with the values committed in the canonical block:
+   - state root;
+   - receipt root;
+   - bloom;
+   - total gas used;
+   - xshard receive gas used;
+   - xshard cursor;
+   - coinbase amount map.
+8. Repeat selected ranges after restarts to verify persistence, idempotent xshard staging, and resumable replay.
+
+## Acceptance Criteria
+
+- Every root-confirmed canonical mainnet minor block is replayed from genesis, with all computed execution outputs matching the values committed in the canonical block.
+- A mismatch stops replay and reports the root block, minor block, branch, height, and mismatched fields.

From 39202a759a0f9e7d90764f27c15ecc1f5b45c145 Mon Sep 17 00:00:00 2001
From: qiang <freedostudio@gmail.com>
Date: Wed, 5 Aug 2026 16:33:39 +0800
Subject: [PATCH 2/2] rm

---
 .DS_Store | Bin 8196 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 .DS_Store

diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index dde3c3549167d76c198d7c87d5679afc215f771c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMTWl0n7(U;$v@>*|1GKhaM>buEfGuoWvE`O*Z_2&Mwsc!A%kIud2c|P+XSXeu
zn#RNjQ8YejyhWb8MIKbd_@arT=%b<u#`u8Is4tq}i^_xlnKR3!g%@L@;GAU6fBxG!
zbN=)F=j@qfjG?1oG%;4o7?bJYRI8xsI)&@`Gowg>q>L!YpJi+}L+#U<5!;$!9SXt-
zgb@fM5Jn)3Kp27lLImi{=0(22xi7R~9Y!FG!2dD=e1C}0!)ZLAQ-b<i2UY$RfM_X+
z{X%VxH;6_88V~4{proM!;Yw7vBDi8exRX2**u?`nC8%&`2reH8Mn-T$fj>I+AMwo@
z;(~^C7=bVXGb6z7?h@O|nlfYF$kq3EFCUA21*xQTR#~}RE?3BV6GQG;BA?C|ypD8k
zH|Kg?*Ul8%>C7(697}0covxElTaKCY9W28nlRf>GW4L1-Zox4;-!~x?vLY)ft!84P
zscB6^BsSR)nP_T>wKPQ9R^Kx@smRsQRqJ-94%x$w`>1$(1UmqmGi^4<ic=X)<Q&^|
z4iL|6`ShA^o#{2(-e{*-sgeZ$(!y8j>*7i&vn$j&dVg|YaJQP$=8w{n^o-;!*YS3l
zIge;ctMq8;Hf3FBN6zH>{;X>kh8-`Z&C90kY{5?F&34;PSPz;ctMsxt*S2@Kp2fQv
zNaoG)JlD-oB?mn>m+$mDOIp;wu+j>ixznUhtx>a!y7sE3ts9h+b88kaS=QLxx<1~$
zY1{qhDz$m@7pT?hAYsJGTMt-fZXoStO~<gD1ASwbkss<GwLB|ho4rnY*i`1BK{;1h
zyKvF%b-FGLt~eA;lZA|RxM1avXi-`A$B5|l>K=pMX`5^CQ4Co-Mg7p|OZ9qvH`jFL
zOsb8*VYz;n+UwEeWi2fXSE@0!_Yi?w(L5n(QCI7Ib~<C)ie`v$+SIjr|EP$+qHPhv
z4QjQX%(}zFG(}GlvUa^w-^YjDn)dQNBc{V&>8#M*OS(aCD4jEV#wfXhH`+{6e@RKs
zow^Mx@A^uL#`bz$AK=}!8-_oJMYRhn^@QFhYoE(0O|zU)ixQfaRphlCEiO$ozCtvk
z9~_SOEkDrFcua^DI<9rr%(^JI_Ol$DV8_`r>;!w8onardFWI;3Cw7tj4xkL>n2icl
zVG)*~0jtr9HmpGhdawgKk-#1d!NNg!7{?Jz;3yu!F+7Ijcmhx31-yuta00L4O}vFu
zcn9y}EI!3&_yQO39lpm8_yvF9Ph65_Ni|Zfv{0&-8l*;PrPM05No%Eb(srpwN=j+z
zpyW#9Vggce7uhTLVl5q^mcL_Angtu8bn^OXR(IdVO`EseJZW}*uAf*{)wk6|mabTJ
zciV>c%K#LJErRrF==*rTCQE$0`*@g!)pLFZs&_0drrebz6iL}fiDHh+JYTi)z&g4_
zrbN+Z1?;lr#BR~b1Y6g*Ql_NTB%f95np+e~J*^~Q8(WEmVAOT%6-q*_G+^(D6U%(2
zuCA+_x;d-K{}jT{vkUA;_A9$Y2%n1usKuR#5w1J15!-!aC(ws|NMS!RFfa@UE)EmM
zk75!JVG0iu!XGD$KZ&RCES|&jg!7m23SPzQc!N-W8t>vge29;52A>3Y|Ax^1GcHa;
z@U|j$1;uYg1W!8$uQemCL`Z7+{lELh-~VU$g@P~wVFYfS2%xkp(bYloDV~Ybr^fHv
z5qkF1!wa{Y64ZC0>Y5J$#9#iyklGP4<v#I%P6<j9D*w`lfbjee&wn3(>~H<Tz4_1o
FzW}F8*sK5m