From 141c06990240a4f3a4b4da850efb6a8195dfb1dd Mon Sep 17 00:00:00 2001 From: forcodedancing Date: Tue, 2 Apr 2024 11:26:04 +0800 Subject: [PATCH] docs: add docs for mev integration (#293) --- docs/assets/mev/mev-overview.png | Bin 0 -> 57247 bytes docs/assets/mev/mev-topology.png | Bin 0 -> 48277 bytes docs/mev/builder-integration.md | 86 ++++++++++++++++++++++ docs/mev/faqs.md | 26 +++++++ docs/mev/overview.md | 92 ++++++++++++++++++++++++ docs/mev/validator-integration.md | 116 ++++++++++++++++++++++++++++++ sidebars.js | 13 +++- 7 files changed, 332 insertions(+), 1 deletion(-) create mode 100644 docs/assets/mev/mev-overview.png create mode 100644 docs/assets/mev/mev-topology.png create mode 100644 docs/mev/builder-integration.md create mode 100644 docs/mev/faqs.md create mode 100644 docs/mev/overview.md create mode 100644 docs/mev/validator-integration.md diff --git a/docs/assets/mev/mev-overview.png b/docs/assets/mev/mev-overview.png new file mode 100644 index 0000000000000000000000000000000000000000..a526bc25232bc23d9b6ac0582fc9540d0a9620f4 GIT binary patch literal 57247 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

&L1{C;B(29`i9* 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 literal 0 HcmV?d00001 diff --git a/docs/assets/mev/mev-topology.png b/docs/assets/mev/mev-topology.png new file mode 100644 index 0000000000000000000000000000000000000000..2bf4bb8e662cb951d5f4a826c00f87eb8c114ed3 GIT binary patch literal 48277 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

Jc{!TEfv|2U`bi6{c;L$1fZz9$}N%E=87*S zwakh9!_(|Mw&%?xZQA5FfJ~zV2jXNyiIry4E)kFE!lGmEQ`{#zouh?}K{bt7yFc`& zN{hj17KadwWY>XgQe=m%ls-d&zJERVEk^Q^*%l9BiZBJ7fv;|0Yn>8Tso9tLbgkn2GBmm#ZK?O=S$C ztciei9bL|^mTxmd(YGpfkPf$A>GLPMw?aP`o8d5h*kC+q9XD>)fk-QcP!zc>n#*=o zG)y<%KF|pba5%;$Vb!&AdIxo~v9CQB1Nl8$Rm*Uw-oJlc0rqn5b>PlVLgjW6+Gq&t zUbK5dxsfuKPobAa!WmCXTJ;p)kMbWeHLEM;;3tYWnNRvV(cO6SY5(WF z56Unu{95xvrcfD|78WDqPAUlgTS-6#0UG_jQ}%f%5p+#v{Zhn)9?OKmQl5iWd7I=!{F-`0fUMf89he zuD(h*Yh5PZOslb@=W5m(1dJo&iP;G1F#jassX6GC=-F~1{J#D@6biZUJLQhn6lCn@r751;eh%mU)=L)mm^@y z<8_{&gRF4#`*&ulI<~5yud7RIxv9`2{}v_aU-Y4e93_Gv%ZsWW6j?p$`XRl;4F5t6 zBf>O%v{*T5a-)|{j@Y+w{hn1w8+&_$MfzV%#-zf>&?KJ=i$u#ATrYP zQBZ~I`@Ue(i+C1gtF`Ur{89|vdonRhi&x{#5v|dns>~@toVQCHid@km zPMRj7^ixB{TyZ}jr}lrR`X927EI6@5p+4xOpGr)AX!A;fjkk zcKtwxWlO3Eal+&SmDSTH@UprgNI>jZ-kK`v1KGIAJK*2|8xSYWL&IGP2(0%e;valj z2Quhf0BH72aXa=rl$i3F&qs0=_#Mx9tErtLvRWGZV-5oMORzV-%Wo!9kPO$^dJhq|NS2!}e^pZ@+Zc(s#KGDTdC-Xrct zXXTy8>m_z^!L6E7t`RaHJt89%yh*LE_oLziTD+>(lofNV8tL?B+$Bk zB6_T0%(tBLZ^y@9OZcM8m+BlDTC`tR)3$9lkKS&YDDJqHbr|Q-Uo*Ql@aSDq*&b<> zTGt2NXlZ81EfH_?lw%}H6w+pUXqnpe(3G?*s%RFgm7cGl>#OyNOYbCHvuF(r474jI z39756mPoWT+ScYaHc*?5jsH{w=DhaFVuoDK620FV{kvW%9T0qnv#$Xu7kzE`MlVbz z;4oI5D*$*Ghu}~;Q(^&|qF9naOx+_iNbOHvv(IB_OQ=$9COm@{u8SsGjWkY8xm(N> zfs^O_x#AtxE#jXhPOEqcr(oUJkxhZXPidtjfFDrt|JArSnO zfqnmo6g&2ZRnLPEAwoV7a6I+UURcDj1|qc zT#bd^pu%v>VK_-_8y*oOXb&JT_~{b34eBW#>n3gq7Idllhc(LX#bifacy;`iLw%C zHI;Q%Q4N`j0%Qbld+1WGI)9+Xx(QAL^P`QFE-akSY^atGZr?%XXmbR;<})LTehglN z+Q`IRUU_*RCQSI)c;{+}{&&5&J!)(Jd)QGdbMAxEqwG;&n6PVzQ}qUKfhO)Rai%{O z*R5usJB(QLpX~5&3sV*JO|n?RpLRL2Me8N zZivR2h65eBUKI_}-^Iev%i+)}>-M{+Hy`_6zFLnWgyq|ORGh~8*HKzP2-CCHyxq3| z=C~FJ)`_!7m}RfT6CFwdKs6TF4N4o9K}$h^N4?Df+kn0YtZi`CY7#oP0Uw3bG&my;aq8VbkIVit{~H5@X6-fZ>U2nFt>T8<$O_xx zpDLt3eJQwcvf8P;7Y%O{6?aaTUK_YGZ?{JUEku1ZB;Io>uwV4*6a_rb>I0e5{=oB=PsVZ^%ILWUX} zR;UpxZyx;Hqc?Do2|#+QvF*VvBAtVC3)h@6PEM~x%@jlj)L0xbf$dPt$a7?_`00`g zzxN-Gj=bL6;@{t0H;~iht5vW`l!{jTCfQ#XoKvnK0L8*xwv^P! z9sDJkHS8NvvI^B#{p3lmN-e*CZGIOYzn~iYHqh|ld`v<8UlxT4OzklpwNXI(?osqW zkQS|~N@pe;XP*+J4*VIlD^-8WSXy3$e=y{|78;710PD4(PebJ&a8hl<@9(e~ZMN9N zo$}~Py^o1j<&@bBFyc%h_ml48Z2yt!meHZ%CAUwQXNi?i5IDAksmWg{Z zN6O~icNhQ3qGn&;;+2}gT#I#2ryH-$3xTO|(W-M@>CwQvPD%NE`RlR>-$04^W@f=Y zDnj=*vXA5+h*!3mpcQzRBjVr|b?BUMztxu9|3;$fDaN@d6lK(Rq1&Z_s+~kc=iZDo z-yxIjv4Zbpwo+%X(SFTkUeCd}v$DEpVbxBw>D2bBvGrEn4K{|1eRr>kUY8s}FD&|a z!sCDX{BqkhwA$iAv1c%qa=e+A%AzAf!I@7sVqzxA;x>Y)a$o z9Hpjf;Pbk!po#UbrB#oDjuV(KY7RekK2M;de6r9`;6^ePC&{AlJuWYhAhC!_*5(hK zb;7M=dL6OcD*7v+D;7Ht(-pWAyRZ;GdBCiyItjYa@^g}&94$Xp@yQ{9=)rCdkVN!{)~`g*?bmu>}O0$i#@*+1Z`9#Sj&E^}dL( z_g3~7gS`$#7f#~7r3WA|a&!fwW)X9_?OMEF!a;rQa{}XMMKmW0vy1W;#{NDA>L6g{ z2nUMVfsfegwbpX_N)Xta*%iM2KWb~=GhHd@2b zPXp)vK2BM?o^n_tIi=01tjgt{GB7asrZ!G75Zwtd{G%%*@)6DwkWK8=+Lbzyj54#4d1Z} zoT{<0qhC|xmv3>dug^Q$t1@i6xZlsdvbzM_cZPrgozdz$WeGrvip6VlNyiB4br9)| zT;n3?1`ZKF5S{%{+6;yzl&aExV1I^gU{| z9q-=i4iRw;#gEi6R4`|ADo0a4y1v=^qoqW`bCxBiMNTA~IC5;O$Y z#$5x!8V}OAyF+k-q=S1xUFtIpL35@ z?W)?FjtsSEFQg?oY&H+C6_gp*le`h9K6mf)By(U<%e1wSpES4p@u2RQo<=|fd*+10 zivF10ftL168hEmN>+!RW@MXR9r#|$x6$1JK1d;yHYZ;#~4poJN-s_W4=qpdpO*oY< zEbm13jv$(41oNc{-uwxXWq-*6Nwa0*jgalw05pcH=)GG|`*e_#l|~nDf}N&QP=b{g`#*uGO!V#_M@^ir+XmiC z*`)hEb7=+PiYc7PZn*InJL-lCWx!ztC`~L!0+iiE0lk2jM~R|)^C2v^upVz_BhzF# z$XelQG1@kHn(`!r0Vh|B8a(#)fY&}KwbxZ4r3&55^0;TSL2&K31|XjN+|_MjoVTRs z$AD@CcAI{yE)?Bv=7oW~;qks(Zawf@C$N*7HBAeTmnkY&e*|$r;pv;)P2&#G6trTdkrEf|#RRsy_69kqUxnm-W zkSUadd0RM^yeN1xzWzyxv?p|ep5L2wQ%kOQ2MZ$xH)iSXfvn6e*8z5{ z6d^BiPfRkuZ9~uX`0b;5Gy4kHb_GL!&!u^htHv6ieV3Al$%9cFdGW)}&wAOi3nRN@ zUX(!*-}}OQ%2(K;HC(sKl1fl;p=%_Gww)8;txkS# z7(h)rvyowv^chiT`bg4p$Z-U>_i?Qe$`BN_6o|y`JG*i0XEJ(+a`hveiyZy8eJg{d zl5TW1uA5owjcc0VM)0BgXYyBHjGHLXd6y-<^~i7dXlXxj<*gPXcHN{?vnS|-60h;9 zZk8p0D)O^()bZQBo0&Ck4m71l8shTyqG3*OjUZw{ZLo86x>84xK9(8us!E#DrGvRiG485>Pw|nxGTUK; znH(1f7aN;6@FF`ID!@q8tAw;_zN(uhgd2c+cqaLWxK%;O_a0-#Eo^#jqvEe0eXTb| z9ovF*^uU$e+^%zdT=~WjNN%p1>s?nXCYo>eZl} z%p@~lt9-QfP-e~|x`T9|g5&($7#6>&N26^23Fb8Vh+!2aWVTRp?{Zd1YhQv|IpZLq z@!87G4I*}J)EKljb&@;Y%Yyo4?~ZZ&Q%YYP_S;axw*Z_k2f&uB!(UW&^=m>Z%vr8A zr>6BZ+LLPc&osNWD!q@Fnh1@3uJGF|pLf1K1xr&`R#qw;W&}GQCaXeKtcu?B;;gNE zd_xV~3b8UZ>n}b^5whVbV|C*S3DamRsy{pmibU7?<5MeI+u*f!KcHLR=73h$f0+q` zd+Vm)I2VThv=GxSDeXM_X~@tCenF|=e7X^*hN4nFQL-URGB=_b9^*7JSUpn)T+><# zoe#y%*ATqnf#8t9_I)Hpe1!wQ?GpvL(L<;xw~4ub{;W(eSP%4XK@6Vf*Af`njL>(= zo2s1-2)zd<9Y3Xd4HNcj&B`W?0&+IQsL=qY->iara|Fy^ZzX8Cul?4-3d&>7_TDt9 z)9O)6A)^_U&)d?GDz+UFk}%48sJ9!+#8qdyKOuZNS4|dAaNHj8Jr!zwhSOF0!w>l> zzJY`Pgr9=_Z{44-2LwV&r|apZmJdNx@1wSR;|c+PN}@v`r7k^QJHXdAWp-CCszD^K zJ>5ObjuG)S|Itz6NK=?SD108r{7;38_)|t0-fbs#?SXN zDIz|Nst;=eF;QPQH*@Yw&O2ae4duN%rg1a;l16%+>P3ac>>n;%hM~utjvX>k!PWj$tQ46q03WkzTETSGlb43GNS9kDQqXDoiB6 zrt0UDod6R3GU(L1Wlw>#y|*&~j6^xa367KOcwfmq&`C!vam8XdbZ8yLl#o3F z6Z-tlWA)D~nzgn4eLb7Cv&x$8pVpnB^29_{r*NOYdeQ%ROT%!yx~Hmvcr5alB0lL@ zVsdM0ET0tp4G;S4g~aHc=_1TWXLUbV;kmy#!z|;$a=9UF`}}m#nM7KGqA-|Bb@0QL zdROurAcz2`9L}9m!AGo=&e$!35>;}0P;VO&;uB!ncvAio72QRtC0Af`D>Cvr@%K%f zy3V(?Cng0uj`oj*NA*EcWt<^0o?-JmNV!1F4w%L<>ZPr?<#tXZ|} z7DsZiQfnOo7A9Sq9sI+(mk8}7|JZ!R{qix=>#ak;LA9dHS?a*wilm0Sj?W8PBK)hx zY+e=DCY5%vEUGM2NYY4HPNEbPqm4+0gvBUJhR-6{VBCukX&%N;lzr)*zkEByH#(sj z&hI-b&32!PRG+>$FZ@!>DqQZp`TO<1zvU(aTgOc#aK=$arWpmm z9kE6#bjm|$epS~vORpFK`|8|aQqqwH%eCx$60J~LdiovD)4XkYdv`a|&B+R1h59+r zv;OZ$r;FsF2-3WiOrCT?T6XQz9!8^V;QRw5c-a5jvEQ?$_yQ)65Cl?GVq0M3DVc z+b)zY*fjNl3Sb(INcx7}Q6KhA7RpDQ&PTurjMTW!X{&;BgrsNpP%2g zLKC1SsKQ^MJL&}_aB=~2@86HFS5w-YF8dmJ1qGyYm%y>E`pfppwS3Z;jw&EkF1 zp0C^QYnAsoxQ?o{G?X})C`{l1F)9mH?fY+#)%y?F?Tqh!jf^G5dwbkp0xOC~_ zYm?jXRp@@|<%5h&>`p`dme*x?U>E+;Yh!bBCGQ(~_v>l}=-A;_E+1`25$Vy}t@686 zKke8b@wPI-IlU*|C%-wze19Ns;ym$Fp`pG#k3<}ED>0kXnFG(K?L@z^T$UVqtUM;T z)LT&vUzz46@42Rey0(Q15|3i=(jE5R*z&oi@!sDoKcR`Zg^PJxX1D+6iDtkgSmPy1 z0aiG`o|e=98UL&H=hnQP?U9f6v=*!Ud?u|BK+`-@{%HJko(vQz{rq|6Q~j$J4f7sX zUN!PAb>nPp)yci>nb@0ya*Vk@e`*#NjQbn2V#b@}^PU#SsChOY=5NVl{M%HJyxZ&J z!}74T5G|a`P{dEAubvnk_4svAhK9qF`hX2Ff=Kxkh{yxJ9@*_T{_RcYgRp{h0Yfpn zd38pl-U%9NG@P7`x{n_?hsSk=%0I=rf55JRFV-mc{MZB&tJUl#j-U&j?yclL*bgwS$1c8ul(%AGut{DaZv({S8aI`K zXJTCGWgJnEBT42P!9a+u+j;*#*W+cl875M9`Gu0f9g~a&sf^c}36(>VIw>@Ypxrhf zbb|s1NfLnnRHW*+`LTfAQWddo#USU56=Ae_VQ;qi#>vRXi+=8_g?K3CixGxxA{Upknl;2AEo&$<%n&}2DQ_dEo`oBGtFw&`Ti9k?kq-*3+aA6C9dWd zrT1-8I&jvR9lhNxBRjADH|xCV2h=!nk@na0h3s9TJRxtW^r_b=cB$Ep-d#8|7jF=? z?U83}%C=LTnSMaSl$AEO#{t1;g#uP@yWjb?GhpTYNS}vA9ExM;;|%{z6anF=P^n2~ zKV^Nu_~DY`RwUr)Ec`lpCGsNU0y=KXzCCi<>weP${xU%ks>*VTph6J&K zpuE+X-y!-%ch*8&L4=AIvZn$Z*9}22f^X}`#{2{zs>aOsuw;@c^}>(Pe+^Pu7U)%O zq-43Q8RDZ169>CS;YKs{>WNsG0(aTowH{+4VwJ<5KcX!!OvTcR(&i5Uc~DY+3KCRG z0Ah z_ulmkuiK~@E|Ha)6at>Uvm{!(*o-!i;-sma@wmFP(`(E{O`RhLli+_Vt)hYjsDJfF z-wd#npLz&YR#oAbZ|h{i&agA;#vQipFK-lzuMX>2Q4P13+ubvDBo{q8!q3^Asv{U-l%vBJ%0+y7Bc)i)7 zwjH>-9*?x!z=8QBt-fXMhr)VUB%e`^A#HZl=jfvbnyYyP(zZ-o%?&Kp~t+sDfR5bd`Wp(@F_Zh0^sU-{WOk6$? zL_vh5#J*rhi!iEoWH?!>xA1a9LbXVLC z_8ma?bFeh+XCDsTk&H*fdygJG=*1y`S>g{WdA=`y?kNBIXe-kD0dlujkm-nAY~1Ec zuQU_h1&HmP-^dyUPd?BdN!tQQiM1@HdUD~|m`eB+`K7)hlNyks)iM9Sa+_?H!&U47TeXO_!S(4(F9X%~Mnd9_?>_<(dNA(-ES>;6u6EzuEiF;ytMUr#7 z7At0Z2!~9*PF^Pc85Ou*Zbkz=R$|Z8H3XvPop%>I;}vGo&CgE{mUq+opVwBNpX#s= zrb>F%B_}bp6=T#IfdsAJfOI!414HW4$-%*((?NV(9L9o;sW9^;AjSD-IF+xVN|pzq zqN2iERCpwX(_b(|KAF8cl9caOi1ZRPpPZ6{LP0_CBJM326Jiz|9Gn^>3a4oDW2Nbyz!x`;PBIG}LCcf2SX@?f`P zkbv{ghcU$qXTBkjn zuL(b4I1@WCy|xw;ARsdX`Yp8}YZBWjKe(>MQvtA*|KsH0nd0DWd{A0wZf;iSVbc|1 zL&dbRvTC&lIExI1j)1~iN)muNvD==ShUU%_(1EM4U*I*UhrR-s+=N$negC;TNH8g` zU(j&M2JQiTT0C|o#j9AOb@X7wfH8)L%%{r&Z}Mp5x8#Mx#efH$5{w0UQ3?bk0{P1g z8eoYm+UG~K0^C354HJ}RL|c;gag;9~V{o5k6VP$U=;m=s(fhvr{euN|Y0j6acrQ_- zUQX|H{wzR+Q}G=s$e9iY1f1trOW9?P?c?sA7!E&)N9jdkKC#Wmtk#=)E;6gWQz=Ap zm?_!a#Sgz^2)s9cxAc#^r{y;-t&ttLauw?2v|&cm8)>}0H}8A z;Wh8WYE>jwjV%Qa0|XptHZ4E~z<@lSpP!$%V7e1LM398nu8)QY-dUlNDqAK+(5-BZ z3pcAxlvd5!%LN7Vm8UTPrLK?CtcmeRIHzm!Wk^HaGuV0#5gHB~-mX?YU?(9Fe4m}f zv!??CYH|h3fk0N#nGYTvzWezmYTMfC$;qhteE^ZHvhq$F%_mjaJ-_Poi7IyE)*+gr zOD|UdDp6`ILva>X$4i=M*qztN$;%5cmgbhaC(8?EL1Ofzk5ZoDA@fHJ0z2sG{aAbW z5Zm75c0!V2`>u~&69@nGBZsXVkIW$3x4~s_vnUgZD2X?j(j(D>)Ok{a5Pn!Z+f5{g z1qInxZdMT2bv{YWkDnXHN&_7f!H_eve-7@51Y`^C)IMpPuv!4+4tmTC5enzvI~y5{#GJaQJ;Um|Nt zf&r4&K^pP|f3^&#{Yj=LkX!{0%pat=^+mS&a(^oP9U$TW7*e~r(HPg8AI6*t@tJ?A z3*i5X&n+ddGViulg0dR7E}qUYiH#)QDj@FirIsPcRncHGQPW%!V@qnt87@$%AX1JT6m&oWTBp?1how`Bd}= zF1-Q=N)%Are)2E6sj(S#4l|Zq9nLUM@u+AD_{?@<8-aF`e@6 z-{4Rn;*e=j&{Lx)$U$($;+BA<@!MKRIKi1qF&A}+09LUyb<8T|N6Lx8Jv}v}I>fN~ zab8bD9Lj2iD`~m0H~8~Pv4m7$YdiRaeaJ!pR`D?jV6M@=yc9lU`_`Ckq2v{!^Cu42 zQ+ETo_NZ8n{}P!r6KcgVSwr#k(J+}+3U*P+QjMH|lvb$+Iu>asn8ae>Pr*jHkfuIr z`~VQIp7wTy`f}667u+1l?->xxT*eRO#jC%k3F?X|*Qn6uf#N>Aj&n*$O$bC<6AAgt z)40&3E}p-u`bh2$%)0*A*W6THy*hC<%OiLaP`k?HL)E$W?&4u&L=3(i&PI9drIcL~&g}6bQP9yh2B|w37}Y8Z=_OGxEzDyA!1nqzpYV;#9RSPR z98x|=i29#2G#MSgT%a$|Jkhw#e}BmYaj-WJ)sJ2u8CO}pSy5&}*`!oy#0W*L%+?4B zL&5wK9JdcSUTiQ^g<>&PQiCu&Gd$bOyKR8#e2G?sC_q)!yq z>Et%Y;dJszL?VQqA}&=q350qDJ7MAr8Nyy9hag!fN{l~KK=1Rz*XL;C&(i_GNsHeS z|4#_!5B3=~b56ncM@=oc_Vyarf^{0a3C5v??s-y=%N40?cBwbndzN8=5buR#%uxz5 zsomgd!3pDNRN#bBLO!uwPf9Vd!Anq>ccE;Xwm3BA15Tk$`&lJW><;7@qOw3W+Qmi) zwwTZvVsCo@bqfc!>dYL#Wcj(MY)VZ@`R#;IiQ$n`n>=~qH?V$S3VIBJ7WxKqx+>AZ zPdecK*b?9&<5b%|GhnoYRgkWd~N5ym^6wVNM9M zy*k?KeIv*MBbr>aa|@b=77)D?*3-&2z?KP7j|D$szVMv@@d|Nq@eVYQCKPM$Ei-?x z>9ox~!mrxw{!$t9F<&_!wUc+z8fmh)kK+_>S0Z#wZmCb!CE;UqEXwj#!MKc9q5Hft z94ctxKl!l=>yy)18-0=b8ggwVza7i{b;+)!(SSfz%u6b3a5a&ZmY#sa;Z27bupJ3G zGGyU_y3TtfVP<*S8279#gSmK#TdVl}yBr6++aUK(>z6aMCGyaaJ7en+!uuAm`za-1 zXLY1xw#*r>3!x-4hjvaS%%3u>hY3x-hSHfUAfUR?rZ{93>m-(5K+{M9r#A4vdlbP3 zB{_i95malvh%KY^>Zg8a17BZ}CQuX`H4PNKW&;)OdESXTiwih%Yhtu(V$}L<-~m!X z)TlM`y0L*RdQWz_LT)eCh+el6wKb3Y*{;2ES&{Nptcx}k^BkcN4}Qd!mKKjoza*w^ z*$;U=Om*11_o`@^*zKp6m)v%^JRoY4>_Y=Onambzjt?EdwGaq|IEo6OllhKQC|tI? zs6}S~#aQblyA3E;d9|4}MnNTQ7kdX=HZ6mOwI7wEZNtDnaqDWaPM^7o4v2~90}2D>8XLN zt}yw-mF)~fIEY{ZHdk0J6T?9+BMOAd?mJAHI=%}V@>~p0@(vaIDi3!3?NE*GKMg_z z0Nw(|p*#)5E0O+URkWyL|M{Q37sGt?rV?Xn!o3&M(AoGwe;yquD}@=KhzX35SR#pG ztqHAiV^iR*b& zUsCocq6-5IuJp@!Lo}G>($%JMTI~KiwZ%J7Hd9pI0EL8caa$KaCe5GjnDG5_)tYQ- z)6TfvJ`dq@A)du(Ch<|MAA|h%IF|b>w5wx%6Gl7sbaAR)ty?8yur6d$jH5D}#$2=z9CUGMr<8mJ02^VUezl4Fytc8#>Qt4T?d zLXY?B6-rQp5`G{v83EO-X4Qw7^1p4s2Ocq#F6VT>Dwa*OW_D$UKVq-U=z{f@CvFSD zN)39`JB1Iu#MscQ`S4XP-;_NkM1+=;?`CCwsS5s5Sa0rpF5~u zXGxo2=i7Y^5eui`7-2zK@mgACQU}V6@*Ff)?($5|=iM`;AWRw?T0L3Ef2wYwGH@gq z!o#|5CU8F@+ag>Tj#EQkU^CGFeg3?RD?SZs)cg6h&Q^Cc($e`AKP z@*u^3mYHXMcevEVr>t2VnUmXy*cSKYwjHQlM`f2{ECjL7~_U?-8ZIh7liZd|9i#QqlwxA2H4K z4PFkt|147`fU3{6opWCB^-5!}S-^@<(`j(c-fk7+YZ?Ob?#3g1&YlhKpep-M*;Mtb z*5t3f7&=@G;l)ie&hPkKk*q4Nz!(?xq2q&}JDonihvhhZ*=a56D?EbHu(D!cV`F>s zv$JEqdi9Dqd>-|G)>OoQXOiqnB7kZXwn^2%PXToUxOc<+w|FbRLVCw6#&16k3$rs% zx>{V*LFcYe9+SF0-rqNYUAM56%fsqZMO?OkhXV(T8-v|IZlw8zz=!o#0 zQR%YgMhp)KhgS>$F_kh!?7RB=9YPmear^lKkH`M7&d>)j?)A%6J&fWB4V8#lamsk`WRu=~Gi$;WAX z7%88_>d<$tpsSo5>Q#m;7>~AV#?R!PQ?B|))#|3GZ8+9L)w>fN@)i^AXC}#+*nW;ED15)O1M&k?l zb#6@PnBUy5bAMh=lco>JTfRA78f+t~F0ZfGdBm&A`X{0GsH&>!ZTM)xh5Rz(>|Uyr z=vaDybtJ{w6j;mUkew-Q`g1lpHULeSonOgLcw#Lw=Kp$cl=29=+`QV6RkM zmAiAY+>&~d`Q8Gpj!ISHAe?}0Jr*zYN3hFVt(*x;)fY(d%Ca+A+1Vf@G<3}kE>qG9jpPoAwt8UNy)6b9XHa_(if=}@U&Pm28@p& zdDuo@ERFYEZ!a*lvSz#iOX04PW(L|^3e?l|a4>*n4CAq~d=h44h2GqtL z019$SJ(s`$-bIHD5)%^-6kNnm17IP1IEAl8y=tCPC`b+%YC;3R7kP;RC6t2qn%-My zu?M%+W*5W!xBFA7=@9%El|DXaN2b(m!+EmGaa5ErX%(zehLC0ka{RI!!Lf0z*-pFU_r6O%eSn zaw7^r&1SRo69aoB*jaeY=c)mHS$dd_RPuwg^eCITD4C(Y!GUijDY3;2e|24i0(FQR z-3RdE0bo6S17Lr$g9qp+8r8=Gm5oW@@m0qKTtcX0OtRjA>{*ndAqmX;taKm9D6CTf z#)Eg@NXU0Jh#3%h5xM>p`i5ONa@dk;9#nG>6>-ERa~G=DUfT0l*9bWpeK17` zA7q-Mh=JmuCY@_^2*eP5u)Bj`Z0$p_)2#TbbtTdI{d1-iF%%+qnpJXO1a&H-tskU> z^2PQlzgfTO=5tm7oA3rof^r9i6X~BFlkoEPi?w_UbqHeR&Zg&`2vwitF zYf}~)wS=_HX9@TmO6J?XKKFS@u7zYGV$`-8pl;#;`U~TVTo$8iE5KJ1 z@;~E8)xISQGQx|pCwNEKgZwm1GhZJ z%r$oSpl)Eid^Fk0=&_>tYO1CJ{RX12cwBRE#I@CuYc)8f`1QG}1rPHZDqw$3WUNhH zLRdj{Ckc+%i#3(!?M3H@q@u~mqOH&q+%Ds1Q%>BS)|*bzfik|Y%*MV>Ws8khqdUgG zADe>_zG0&U%XkqqKm$_0E-{Hdde(rR05!4ohl0Tj|F(pkWy7JahIbSqnj*S}?+ysd zXP%4gXqq%$afq*B*^K58MnNC0(;d&whbvw8o{ujR9rp%?&rgEA zE>cv$a75YAkm?;-M$lMl$E!af_0ahSr-BZuiI|^1e>$Fb_1`a`%!;qUnM4>COU_sJ zEv$FsR(@V-EjZWw5Qt!c_A;z!$Q+>^uQ&pMPZ0znq)4v8rM$F49xtlk$`#v00Jsmf zrnmvb+erbn-PrNN*@{kf%@1hkc~_GFSfBeLTz*Mc}Ig zfPb8EYsBxotMX`%XqOFzq7{T9w2ITIRqs z2gZd-OIy2_y;Ra%2pJRfTOL0~4Gc&BTRu_7%Pt(fs{1CGFA@Qo349-UAcAET8#^3L zPzN?Y5PzCmTx`y~^#t>pTUc0_(^pnkbHB$mp5Z!s*zYa20`x?zDzEmPJ{gw#Vpd*N zI(^c8=Y_fdf8GFp`aTW(*tOiJ0k>xQ+qE2~=}iM8=?T2C{H0A8b=#=)OC)1Bz{9e# z;r_On>tn`uyR!fLf;%tn_V@nn{f&!}|K9Px3+pp@m~c{E#+dQf3M-y=GS`F(g9_I= zHFoq~r5={lHFhlu!hfAw?D8#IUM}hJ#tTmiamDJ@8s%r~H5l=7*|aP*xg`T3%IV-9 zGdcP*^2bZp z<`e*rHnk+$>i_AxO>c%d8ZsQ*SY*d5I5_8AC>$Kz5+eu>?gQWde=dJTh-b-zr;Pku R4zvzV7NR6sCT;@zzW`sXAqxNi literal 0 HcmV?d00001 diff --git a/docs/mev/builder-integration.md b/docs/mev/builder-integration.md new file mode 100644 index 0000000000..16c4513c33 --- /dev/null +++ b/docs/mev/builder-integration.md @@ -0,0 +1,86 @@ +# Integration Guide for Builder + +The [Builder API Specification](https://github.com/bnb-chain/BEPs/blob/master/BEPs/BEP322.md) +defines the standard interface that builders should implement, while the +specific implementation is left open to MEV API providers. The BNB Chain +community offers a simple [implementation example](https://github.com/bnb-chain/bsc-builder) for +reference. + +## Customize Builder + +Although the builder offers great flexibility, there are still some +essential standards that must be followed: + +1. The builder needs to set up a **builder account**, which is used to + sign the block bid and receive fees. The builder can ask for a tip + (builder fee) on the block that it sends to the sentry. If the + block is finally selected, the **builder account** will receive + the tip. + +2. The builder needs to implement the **mev_reportIssue** API to + receive the errors report from validators. + +3. In order to prevent transaction leakage, the builder can only send + block bids to the in-turn validator. + +4. At most 3 block bids are allowed to be sent at the same height from + the same builder. + +Here are some sentry APIs that may interest a builder: + +1. **mev_bestBidGasFee**. It will return the current most profitable + reward that the validator received among all the blocks received + from all builders. The reward is calculated as: **gasFee\*(1 - + commissionRate) - tipToBuilder**. A builder may compare the + **bestBidGasFee** with a local one and then decide to send the + block bid or not. + +2. **mev_params.** It will return the + **BidSimulationLeftOver**,**ValidatorCommission**, **GasCeil** and + **BidFeeCeil** settings on the validator. If the current time is + after **(except block time - BidSimulationLeftOver)**, then there + is no need to send block bids any more; **ValidatorCommission** + and **BidFeeCeil** helps the builder to build its fee charge + strategy. The **GasCeil** helps a builder know when to stop adding + more transactions. + +Builders have the freedom to define various aspects like pricing models +for users, creating intuitive APIs, and define the bundle verification +rules. + +## Setup with Example Builder + +**Step 1: Find Validator Information** + +For validators that open MEV integration, the public information is +shown at [bsc-mev-info](https://github.com/bnb-chain/bsc-mev-info). +Builders can also provide information here to the validator. + +**Step 2: Set up Builder.** + +The builder must sign the bid using an account, such as the etherbase +account specified in the config.toml file. + +```toml +[Eth.Miner.Mev] +BuilderEnabled = true # open bid sending +BuilderAccount = "0x..." # builder address which signs bid, usually it is the same as etherbase address +``` + +Configure the validator node list, including the address of the +validator and the public URL. The public URL refers to the sentry +service. + +```toml +[[Eth.Miner.Mev.Validators]] +Address = "0x23707D3D...6455B52B3" +URL = "https://bsc-fuji.io" + +[[Eth.Miner.Mev.Validators]] +Address = "0x52825922...3A1A7A422" +URL = "http://bsc-mathwallet.io" +``` + +**Step 3: Publish information** + +It is highly recommended to publish information in [bsc-mev-info](https://github.com/bnb-chain/bsc-mev-info). diff --git a/docs/mev/faqs.md b/docs/mev/faqs.md new file mode 100644 index 0000000000..1f9d8928b5 --- /dev/null +++ b/docs/mev/faqs.md @@ -0,0 +1,26 @@ +# FAQs + +1. Do builders fetch the in-turn proposer's GasCeil to build block? + + Yes, you could using RPC mev_params to query validator's MEV information + before building block, it can help to 1) calculate a valid header with gas no + more than GasCeil; 2) calculate the left bidding time by + BidSimulationLeftOver; 3) calculate suitable builderFee by + validatorCommission. + + +2. How does the validator choose the best bid? + + The block reward is calculated as **gasFee**, the validator reward is + calculated as **gasFee*commissionRate - builderFee**. Every + time the validator receives a new bid, it will compare its reward with + the existing best bid. If it has better block reward and validator + reward, the new bid will go into simulation. If simulation succeeds + before block sealing, it will be compared with local mined block reward. + If the bid's block reward and validator reward are both superior to the + local block, it will be sealed by the validator. + + +3. Who can become the builder? + + Anyone is allowed to become a builder. \ No newline at end of file diff --git a/docs/mev/overview.md b/docs/mev/overview.md new file mode 100644 index 0000000000..ea1f3f7c39 --- /dev/null +++ b/docs/mev/overview.md @@ -0,0 +1,92 @@ +# Overview + +The BSC network has introduced the [Builder API +Specification](https://github.com/bnb-chain/BEPs/blob/master/BEPs/BEP322.md) +to establish a fair and unified MEV market. Previously, BSC clients +lacked native support for validators to integrate with multiple MEV +providers at once. The network became unstable because of the many +different versions of the client software being used. The latest BSC +client adopts the [Proposer-Builder Separation](https://ethereum.org/en/roadmap/pbs/) model. +Within this unified framework, several aspects of the BSC network have +been improved: + +- **Stability**: Validators only need to use the official client to seamlessly integrate with various Builders. + +- **Economy**: Builders that can enter without permission promote healthy market competition. Validators can extract + more value by integrating with more builders, which benefits delegators as well. + +- **Transparency**: This specification aims to bring transparency to the BSC MEV market, exposing profit distribution + among stakeholders to the public. + +## What is MEV and PBS + +MEV, also known as Maximum (or Miner) Extractable Value, can be +described as the measure of total value that may be extracted from +transaction ordering. Common examples include arbitraging swaps on +decentralized exchanges or identifying opportunities to liquidate DeFi +positions. Maximizing MEV requires advanced technical expertise and +custom software integrated into regular validators. The returns are +likely higher with centralized operators. + +Proposer-builder separation(PBS) solves this problem by reconfiguring +the economics of MEV. Block builders create blocks and submit them to +the block proposer, and the block proposer simply chooses the most +profitable one, paying a fee to the block builder. This means even if a +small group of specialized block builders dominate MEV extraction, the +reward still goes to any validator on the network. + +## How it Works on BSC + +![MEV on BSC](../assets/mev/mev-overview.png) + +The figure above illustrates the basic workflow of PBS operating on the +BSC network. + +- MEV Searchers are independent network participants who detect + profitable MEV opportunities and submit their transactions to + builders. Transactions from searchers are usually bundled together + and included in a block, or none of them will be included. + +- The builder collects transactions from various sources to create an + unsealed block and offer it to the block proposer. The builder + will specify in the request the amount of fees the proposer needs + to pay to the builder if this block is adopted. The unsealed block + from the builder is also called a **block bid** as it may request + tips. + +- The proposer chooses the most profitable block from multiple + builders, and pays the fee to the builder by appending a payment + transaction at the end of the block. + +A new component called **Sentry** has been introduced to enhance +network security and account isolation. It assists proposers in +communicating with builders and enables payment processing. + +## What is More + +The PBS model on BSC differs in several aspects from its implementation +on Ethereum. This is primarily due to: + +1. **Different Trust Model**. Validators in the BNB Smart Chain are + considered more trustworthy, as it requires substantial BNB + delegation and must maintain a high reputation. This stands in + contrast to Ethereum, where becoming an Ethereum validator is much + easier, the barrier to becoming a validator is very low (i.e., 32 + ETH). + +2. **Different Consensus Algorithms.** In Ethereum, a block header is + transferred from a builder to a validator for signing, allowing + the block to be broadcasted to the network without disclosing the + transactions to the validator. In contrast, in BSC, creating a + valid block header requires executing transactions and system + contract calls (such as transferring reward and depositing to the + validator set contract), making it impossible for builders to + propose the whole block. + +3. **Different Blocking Time.** With a shorter block time of 3 seconds + in BSC compared to Ethereum's 12 seconds, designing for time + efficiency becomes crucial. + +These differences have led to different designs on BSC's PBS regarding +payment, interaction, and APIs. For more design philosophy, please refer +to [BEP322:Builder API Specification for BNB Smart Chain](https://github.com/bnb-chain/BEPs/blob/master/BEPs/BEP322.md). \ No newline at end of file diff --git a/docs/mev/validator-integration.md b/docs/mev/validator-integration.md new file mode 100644 index 0000000000..381ec6b831 --- /dev/null +++ b/docs/mev/validator-integration.md @@ -0,0 +1,116 @@ +# Integration Guide for Validator + +## Decison Make + +When activating MEV functionality, validators encounter a mix of +opportunities and challenges. Before enabling this feature, validators +need to carefully evaluate these risk accordingly: + +1. More maintenance work. Apart from the validator, additional + maintenance of the Sentry service and its related network + components is required. + +2. Network risk. Due to Sentry service being exposed to the public + network, it is inevitably susceptible to possible network attacks. + +3. Financial risk. Validators need to pay fees to builders, securely + managing accounts is a crucial topic. + +After identifying these risks, let's begin the journey. + +## Validator Topology + +![Validator Topology](../assets/mev/mev-topology.png) + +It is suggested that to split the internal network into two part: + +1. Private network. The private network is isolated from the public + network. All access to components within this network is strictly + restricted. The Validator and Payment wallet are expected to be + deployed within a private network environment. + +2. Nat network. The components in this network can communicate with the + public internet under certain constraints, and the communication + can be established through load balancers provided by various + cloud platforms. Sentry service should be deployed within a NAT + network environment. It is essential to configure appropriate + safeguards on the network gateway to prevent DoS attacks and other + potential threats. + +## Preparation + +The BNB Chain community has maintained an open-source version of the +Sentry service. You can clone the code repository from +[here](https://github.com/bnb-chain/bsc-mev-sentry). + +Before actually deploying the Sentry service, it is crucial to carefully +consider and determine several key parameters: + +1. **BidFeeCeil.** This represents the maximum fee that a validator is + willing to pay for a block proposed by a builder. When this value + is 0, it signifies that the validator does not accept any charges + from the builder. + +2. **BidSimulationLeftOver.** This parameter indicates how long before + the block time the validator should cease simulating the blocks + from the builder. It is generally advisable to set it to a few + tens of milliseconds. Setting it too small may result in blocks + being broadcast too late and subsequently discarded during network + congestion. + +It is suggested that to purchase a domain that is related to the moniker +name of the validator. The builders will send requests through this +domain. A BSC account should be created in advance as the payment +account. No BNB is required in that account if **BidFeeCeil** is zero, +otherwise, it needs to be ensured that there is enough balance in the +account. + +Go to the [bsc-mev-info](https://github.com/bnb-chain/bsc-mev-info) +repo to find more information about running builders which will be used +during setup. + +## Quick Setup + +**Step 1**: **Setup Sentry.** + +Deploy the sentry service according to the readme of [sentry repo](https://github.com/bnb-chain/bsc-mev-sentry). + +Here are a few key points to highlight. + +- One sentry service can manage multiple validators. + +- The **PrivateURL** of validator is used by the sentry to access the + validator, it can be IP:Port or internal domain URL. + +- The **PublicHostName** of validator is used by the builder to access + the validator, the sentry will forward to different validators + according to different hostname of the request. + +- For each Builder, define its Address and public URL. The address + will be used to authorize the identity of builders. + +**Step 2: Change the Config of Validator.** + +Upgrade the validators to version v1.4.x or later, add a few new +sections in the config.toml. Example: + +```toml + [Eth.Miner.Mev] + Enabled = true # open bid receiving + ValidatorCommission = 100 # validator claim 1% from block reward + BidSimulationLeftOver = 50000000 # 50ms, the time left for bid simulation + SentryURL = "http://bsc-mev-sentry.io" # it is used for the validator to access the sentry, it should be a private URL or IP:Port. + + [[Eth.Miner.Mev.Builders]] + Address = "0x45EbEBe8...664D59c12" # builder address which validator is willing to receive bid from + + [[Eth.Miner.Mev.Builders]] + Address = "0x980A75eC...fc9b863D5" # builder address which validator is willing to receive bid from +``` + +**Step 3: Publish information** + +It is highly recommended to publish information in [bsc-mev-info](https://github.com/bnb-chain/bsc-mev-info) +so other builders can find it. + + \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 997369c080..372e013854 100644 --- a/sidebars.js +++ b/sidebars.js @@ -152,7 +152,18 @@ const sidebars = { //collapsible: true, collapsed: true, label: 'Validator', - items: ['validator/overview', 'validator/create-val', 'validator/run-val'], + items: ['validator/overview', 'validator/create-val', 'validator/run-val', + { + type: 'category', + label:'MEV', + items:[ + {type:'doc', id:'mev/overview', label:'Overview'}, + {type:'doc', id:'mev/validator-integration', label:'Validator Integration Guide'}, + {type:'doc', id:'mev/builder-integration', label:'Builder Integration Guide'}, + {type:'doc', id:'mev/faqs', label:'FAQs'}, + ] + } + ], }, { type: 'category',