nyq秃aȓ _RNc&?G #9$q{~oz'΅'ۿpd}1n{>7
c7ִ J* Yrmŋ vYC-~"ۆ:chޗjhTɛ tB3:P 賺3G;4
+# &u!1kq ai9]}@|>ڎU']yV cw B˄@K'x(z9uۇkQ$G6:U}hG=H|C
+Dؾm5v\4:IDl >Oz|/hq-(ڱ ߎ.U'l& n0둹~Fn1` _|>Y0f|N; TBma) ; ;VƦc|es=fv^>z7[]ci|)dtSٷj-
+\P[puwqc<+Qe*hj׳ݎۯz4}I3FǦSt~SZSkK6]fᦔIa9hfmxԬXذ?ڀd{B ׀
+jncX;;= #u;5s\/84uwEQZ@7jf0iǬ6Bfz]f0j LoF95 [i
+'O>vM~w md9IRlo71E ޝ ږ[FEܘ"ږI0IHa5ɬ{QjN/D w;Q{\5A)X8]? r.C%8f 磖 hFw$9횵FC('vcClfEaP=:=[6peA= agnR3B~G 0lXAl1\ZNxhЫa t^❣rؑɗ' q"7d]p8:XP(a=W9Qj'
+cAO^c>^uʩ;hw o[32<ϊ.2/v(dc߰A^|9,|#+j ª.$Rݫ7__S&/r( g IH 3\T4!;.qp~ 1,scxI _#TT75C\qIC!ær˚K;+^m$+o~y+OOn v.=\tcJ>?5{`-|sս>^65J]Nɯ>_[}7X < SӋ6/m6oJÑ6_O՛K'Sӫýgo-̿8{а/ ̟\_1}>s`j9_GÕەՆxԏ`ᇮՍKsŧ_v.whS姙덵~6r>4^oW>__i^[F~j]_;5vW?]_=Xxy^r . 5K[6 /ReW;u("ñh
{]=YG|n^vz^(XV /G/]q}[~2^xw'Xjj;3m<7?s7. px:Nx `}o-Ut]6gfW7k{k~FܺsMᐱyCv{u8W7>u:GKO?,?^_9xX$kdcr;
7Y~{NeSfͧfgä͗V5O7{[I#6݃֠{%g/o<ռyĜY <|zuz .̬SW dK/v7kųWSӷ'k :zk7O+Z; vW7
{suiݻ{V`Uo ]_zz35 p+wE$2]Y=X! g/ 2 4͑{ߏ#I|}ݵ;^wd)uibgzKMvW =z0~{M_a-:|ra2{֟ϼ_4\_m\KG/=g|iϪflyg;O &[]X:V
vZ[o
I}^!};l i
+MMƐPXYد~zq)[up2}hkoy߅y؝{ߕdɲȮ9ù{4oFQ{zu땅;7ybygOv^?xb^Iӽd^U|sleݥRy _7ց?7aX vbT<lc[ RǶG7v|֣Rӥ̾J܁;3 $w0|7|fCt;X{_dRupiiyf;Y; o-|؉
+
>w[ n-Z|^m. 5? a1/O5R,R<姧kA <)e^\,|uWaWıv/Qb߾:{}[&3N 6=Du".L>} >5ޯk ՃՃǧKzqZc=[Q3y8}ljK>Xxbiwsa97:3tik{ևkf_ѝC1[G A'f/-~h?^.{y
-6glObosC.|)?[n$^dwo>}xWѥq;2/u{{{@ݷb͛fV^ug+;f}߭}4lrk{fo>]ݽr)"{MR1Yl;@ \^_YzoTōWgH-vrT-E.'g6APSivscשgwRc%;^}v'2eSW/RV^f(O
]i|f:lL7(.=Y}5\zZyduY._bߎtpR1OVʇսkrvtV>\|nѣ g;sk`f/vC_οY_MF==[7ﷁί>ep ݾqz}1~4{[t0&s䤿cxM̒q t|H>qT {ry}utOy.Q,d~
+-;W ,ھs=y]i8qzoB@BB?I6nƔkٌh4ͭyu8-Y, -ns6 H1 l-R|5$I n͢bf*OQY{"Sz5d~ /c)3 #SQB;++Oj#^&cؽ rV"Cg9]Q2k
+c.fAFZx}wWXi_ Xy3! oTcYI'=g ظ>Mq彆=HOymbe3賌[^D7.z
+ĜuLyEFwod<>%Ny{rԙKVcvL <F
+F1k.5~i,XƌfPuVWDž(pzʌ
+ E).opZ15m lr8pdbyCxE0A,1g F?=m۩oGXuY*M)fHh,4t\^wx5
5{39Y?O+?i=^_i;Z "8V59W&uc8LTf /aI,C@Q
+~j̸
Z2Dkڄǒq=6 yڒy1\fxoJcodgY̐ k)m $~K8,bX{?cv`Erh;F:>2gwdt}-O.t5ӫYLm3 ͵w{} /o okGKBPEٗe f`C#I5~ ndO0^ч! I;WrT#@
+i7e[Hg^dL/h2K`7 FwTRZ)`a*slk-gLYC&bE`;SïON3E&LJk?ګ=BC)HF`9;lcq4 Bf·7{@~/::tX`3li˅#91c~
GLckM 5/TJ gfܥpcw`Os9Bϩ/BHxK!c/)d`/w|QBB\䥙 yA__ħp&EPm'3
+,M*g; g\~|q Yl}˂'˧o lhaX#P)W%e&}8Q*JT
m 3s` ;~2J@be0IaVc{Jʿky|W |gyǸ=`g L&5=(Z_n||O5Q[_d ï`ʚq;l/i߁Q
:
쭆 ~E
8=~6WGz ٙ $t@˼ ,`.
+k3`=sRJ xcw0d + xm `jS5D,C̷̤uL2Eq.*b; !bϺ yO{6Bנ i*A6G2O\k}HZzOߜD6xϢDڥs-YMǚM28vݟO8 g.3OL?aTi.hKKlRKOZ`>}gEW2@߳[#Nk%@&esV=)jM9?*`}% Z T顭@ͥ
0SH_8wSD )="Ys}0,a>aSˌ:bV$h\̌57bno?|䀲1qt'mSSx웂x3Gz%]`bȉـ[1a\?a _Ukq1Jwcԩ<놘1La; }~ƶD
+,
+c5aAk
+Kt#,mLurm W:VU41͂U6nxش^f EJb39bK#VTYlaG;bI&ZcBgԚ֖Z0IHKƠ Zɬ
}m4yݝ6xk3â[ ~n_mm [
mt?vTF
+ʓڟ& mm՟ MMN[uFwtL:GݛTׯ)ο tЗ.K*\ JeXWܺoء,& &^7tdWcЭߓ k+/ɞۆم >Rbd0sTܡ/ ַjU*ǬӀNa`;o%ddm 61bH_uCvQ[ŰP9c1 ;k ʈ&ni9iC`c?q`z[Ec\F{QNm{zu4 xh;LcrNSō۔gj?5[(]iUʏLe,
+)ί@
xhNgB shEsc]7ɧyVؖ k>&Z)1W*E,iRKչY:d2`EOj !Yƞ vhν(Z3n&f>N&}gг 7b Hfd S[j?[&ڃ[;mGOcG쯎MϞ>d~σ T)JWeۡ]7!bs#k;_Gӧ ~X:%ze8s[P2ҫ9)6sοϥ-P.<)7tUG, ]@=]u8+N5uKQ |
% y3تěEeĔHnu"
8IM62IKv,9}䮤3QT}Myݖ1T(P>Fnmk n1is_}FwkӺ;V=?xlKhl2i4]{vvk&^?1y3 Wx?w}־ XfeŎ!~c fpm)W\n/&nG$)~J b50Zz`_AO fYl;_mD#B&Nf3Tt5RRh.B ~:k,Z]|_'u1;d8bYogxۂس}$"oEk>2(яlƨÑ\F#oA-U=o'u>
XlZnpSO<=~i {o"P;-O Y]b-J%d) 4J;YWy;
+35h/\Oto},S |L+C ZY?-oYl}TuuHneH>n曽d7,'lzc1(,ZH\ a>9} T7ŭE[X I$ˍYM7{{ommOULd=+T%]5 ퟪX_?*Ac}ټwG_{ޚknlֳi}XlokF5h4_Ӧk&z` 5вVy)߶%Qwk W7hH
~;9^?M
G?GpQ~4*m)Wp[X?i 8 ziiW7` _ 9r6QLFmlqOXD'X=USZޫik֪N>)'3wVUg g^
$}~Uڝ+F}S$ԍa-:Vrq-Z3Y~}w/ƿٲ5]uO|"k}di_s 7 ,-Wtj}4nlXAcϮhcAk?+ ppwx=7"nVKeir8w[[ 2Y0JgCB%?kXA9%[3٢ w[tq'Z R =Q1
+d9{x»)i {ʅ1Lq[d
+- ̾_`[q
+1{ x]U@ ʠq;ZGP,ύIa֛iܾ}+ĊCğ{m;3w+L ß5[3P-鰾J^ g_* С*qNwk9l6fF\l,fD GZ:]߅~ u7% 5J' :%+ ߀$S+}aKWZ%n-r3` 2z扩m^o鞂MX\t_Ix&QT{KX|չJ6¨!Yi6G6dK~DcT)iZ8m S\K Խ`*LJ=hUI2]h?X2&^_FOHV:*i z K tt%ӯJRBW)(Y tn7Jo}EV*`WgXIJ'x>nIW㦹Ej b u(Sia183MA x `VQAo m[}Ld*|Yf(Wi
+/[T):5 ~oC&JNRB9ȢA[z d-[6J,*n_+-Qf&t[JU
+t25j2 Uv I@AeG岯],#SiߏJ~JO*jGyZ{C݆TmUARC@xҜFS锲&4JISĜ8U
+jŕ 60S1jOzD }hF0P yWPix
+sZ/]i(:Dоu+
&RX S~LװR\T~ o[D M,.IǧӒm %N+_!c^]E9ڟ3^ii9_6xP_K=\ʶ>m.Li? 9&|lOmNE&j PנIGitG: 3|ܯ1߷>Mӹ cy9$zjkQi*8ks]K3S/蟱>2CF1;$(`ۀ,SIoL}Y)\u0 sXDG +47N7#\ePZ#땭O O-@;i۽VcE; J:IW~V
+_Bdv:%SRw yu^3QURJ^h= *t_aRRdT
+ r:0Zj _Hs*UZ2Vl
+R8B!y\= %1[yoxZs_Mn7Lw*W,cE g W;<M$s3XfGs"[l֡NuR4#@NZ d{)&iX3ũ&H7L>Wږ=s-^µ w*)XKq!@UP`zm3׃Q@<-%I5jȋod[(܁@[N5?LͼDLl4ǯ>~:VFƤzצԏ'P,b5%Q#gf 7I'Wlw;%F <gPX.U0-T=\t?3mFZHn6 `v;b-ͻUr$5*:GE[5VgF4A!)WUyidFBA-M 0@vv-;
r>A:)aoޔCmw2_[,9LOF/rE jȶ'W=! &D}wÞ>=0u S |
+dlI!3AfpKtw* Snp4(/j@S j3`F uؒ|}yx~PDzprA 'ٓ_Pj9Rb).A$YGK8 /).]RU!Q%.Yqk\"ɪ e6]kČnK(uo$qS
+'|{D B*~DkGcPҭ
+p庯O
+d5;^UӛOV`JNbSȁ3*iؔw=cPnZmL"nZ"KYv]Ǯ/wxE'!AAҁ{@ih:ƌ85NΖ-t!-K*?~
+YǓ$h6e;uNx*Jy[靅aI >@iTn$ok
s&NytT$G嬓os% No[D&d]B3TrDibHg|2F崪b% X vXTh4II0&{T59vb]h'H
Fy:k Mq<~(fǥ1HYEQAm]o <qXy}2ՐJ, y(5imjka7)YAV -1P4u:L{Y*< lE'U%Ng jJ Xd*9U5JD\L.fE.E<;|cumtLc85q DЉCwctH'?C'[)Bɢo)#hG0t: NA'@ >SF)o)#Z :l+@б;1t:d] fUSFږG]T4Iӛ mUʈwæ֯s@
/%ظO!@\XQv7kN18,uCk9y.zno JIR9ؗ@stMZ
+:
+BǏI6s Wu :iT݄:$1cLmk`7O[A[kې @
+#& ".OlQΚdnY)R!7ALux}o%uckå+r6%f8ʚ](0$Ɓ]5TNboM_t<4M lJ_ \bRM:`z0%O-ϿQat:$4;CBī ǮDwhwqL%CK ٲ>m;ߥx9 KpE 1&3V9=vweSٓ# QĵQ8j5B#r6i]w2h]&{%
+Yő''핂 <\SG,睌Io6V .<"(axnc;0;q|Z\4hD[ y##h EPhp2__V$8&p4$ <,a
+ sw:xdx @q Zq <2rkn\LE6
+aP$nωd] __ Lt|"tA-x
Wwse*թS
+HNТ%U˳-Cw2 . < 1ux ']]= ZG[/+^
+* vhTez>1r T^H=ګ x/T0DλH'^P|*BnmMEpFT5n *کh\LQׂSyлgfJ;"q
+R&p+hHt'
q}ג)+Id'Zk@5ӯݥ@8%;OD$6 4}~[tRs.T N'(/餰t" tRxHGt0sVtRrF49
V>
M'ҩM'k?g` Njth:) ; 4NtMZ-{tRƩl4IDC=S.4m\4z=? MwnF)bV?M'E d4i( h:) ܽ>MwdIh3tRg!{|6b7]$2I87Jd0߽es& )ϳ[tn%A$$d^5,T zkIjUr9uSe&IRj>)]QpD QJbse -K)ix\4Is']
+2͝ K NUr|2vj(zTQy8 c('{8 }NѶ{hP D8BEOS j50:yVҩh\GqZo"ܑu %Y]-P$KSe,u7yO%Bu% \u4 u5~Lu4 .[9龧 ?
+gF_% U]"Ϙ])| ˎkK`m}[!$2F2ZF.YV6Xy5߫R H".#wr1)-KRӳ2U#bsySj7xasy'@y4[5M< n8-Vp &1
[* <g;+r1
%+[}[;%,hLdʻ'R)Q<)iNKR'ÝRW wjo5ǁ g^UkfFC离X+F>z A|aY}=W zH)x2n/v<Vb\f˻.b⟊BaAP:}S cRb2(oScv#Ŏ,)hVPWܶ2hV3+ՀLw_ٹ $As'* "PN k)ܿܚtXyWSuۓ0]٫na=^ɔʛl
+u+hjԳƕ (;~ 7RK"p)ݼPRQ[ތm^)[EL6E/<ȵ 3 ;R Nc8Z*U%L2x8<o Np ϫ-9^_RmfK>S\ 6 W)\JдgR" IU1@s `x1kUR~K9 7R4W>*Ey9R\R bKtDvjĀ0OְK82QI\=> [qm1-]dkopL*مNe$`ǂNY̮NXtC"I mdF%@̂ W2$Cd"3 ~KNt+44ItukX5ݜeQIQZ7Eii J$-㴘\ƊU
+ӗ9SJ yW__Ϻp^V{3L?r-I2.MZwzhBࣗJ'k+Na$ H N27;0'ԛctbu=}eb?u 'Uq.L'S#8x"iٔL7a7sk2*Z&Bjެ
+ԫrR^Ki|eY:PG0Kfص,:&1VhUycW<;)<|cWı/C.,e 2 9* Bt
+Z ?Z Qj1k}7
+P *
+;Lq m(@@ȱQ ?cu+
+P-#߅i^IW'S푤|]x'Ied{NR>3l ||j@Lnoո-X^?c" z< R+p^?e3GFn맜[~TS{}B^?~7 +Җyjy(ߥ+O[)wV):|Jw^V?{o)'}y8%AQ^?Ee y,aH^ eV ;)waJOm+7Yʆy8 $/pе2S:⠈| ^]ÇViJG|Z7*JP*Ut1&qo,X!12|DK}# ,+{GT ;qs}nj(d"@i5;VSbsoqbɌ1 ˕ݻg43 gѹ<{x_6z^4o]<ҷwWx/.zII7fIZ8C}~j5$bLaW7B}+>k$4[y]jM!yR y%L [r0 ee5ݎQCu$9/6tZ3Y:}-} B%lz_m$NjȖnurp Avz[ th焻f0:ҚqΟ3 ϊP@k؎4V $ f\4Y9ܖNs.'*pWgA
$JL\x Lɰp~tpG3z~g+s3c,@elDe6e#NvaPAw~I;]F<
+doO9GswjVdO?SUZ#>3Sк uZlEL6nDe0q 1ӴFw?τF%B~gSpD 'r$0g=@Sh,>h}P-LdgeʖZS+37ݵ%Ύ xttyYyYSsY_
j\ uWoq`W6nlspsg٪̱8hf=#vd$5̂e Yvq,`{ R CeBτS²@t]PLb5a$Z LL`*CYX OX,rBx0/OgW,v_:- 1lιΛ첫o w9xzÍ
}a
+f z0b ^ 1_fhy ג! 5=s E<7w3Fy0hރ&zN@c` }ggW mm cAd l6e1:$Aѽp=(-]0
++$!m05' CWΰw7'+3Ւ.2V}ǡ";T;4Y4XrvT nʼnj~ -_Ʌ7SIu~V493\r>]I_x8G 14N.|m_#WLCag
sk Mp=vð, im9'r%< C{ gktBC- 7ӟ+irS|}
+@<~8Rɫ1653i%۩1q5 &huռes;z.Ov )TԚ--jcK}k;:4=HfffH ON` yF$];h3OCg$QC'َ^a?b+q'#,!Nd|O3ΔdV5c+cDBC[Ό qtᅬ
KPnq`Կufo
@);S
+U*YY
Z \SSNXK:³r-d8Gz\aBGP[mY5ڒ936@eiGSd~:G'}c9 c oEM\:VZ
) ҫ@T2[ƈ}c8w)hq5{"4CM4 {s2>FDhE+O6ZcƭrA@s/#2QU:-=~5?;熟|`IT/ Y;_77\MRGwBjt) Wԙk#@d:Y 2 ̴N\?fP"HeݹwT6.980/L ~cuOtynw!/?Ob2agr21, F_7 ?Ywɟs2 CC#f8GLL18$~ @ *⦮
t,% nF3(rV A 1NDǵnL^8TQ1}%pGO m6;4koOxof; f旰Id`|22=(c@1?&c%# +c$1Q3-̏Șj% Nels>2ȵ$E ȘZْt&ĭBOn)JYru4yu+F-ojYn E%*kn6#."GgGb:4<Lm66P
+mB%j3ŭ Iħ#XӖWV"> oRr˶R[~FQ\%ZkƙbASpP[ӝFi-%W= DV8vyh
+`{y?BE `bO?IYCvl]Zo(&[g@goRسR[*ǀC6F0n6&#&l٧2[{yC@ !rWs1h'@Y̍(1Dc!!sER%vOZrכ.)Jahs;^? *:o0v> R-[>VXUQKB5v
hOp&ή6:RGm C+/vId|' Z._{cXNRh@nیdl@en LM-3nu)ߒɤ-iЋ=Yu
zAm; M; j" )GD1@I}~Pހ!qA TC:^KWCx}8%
N
+O 8N9)
+6Ƈ;Al% zJv7ѐ, µ祜' kfJAR/Art)J?
+!|$;>/]
+>{I,9 w xyN p(*>7>Ḣ6q $`p/jx CadZDYF5 5ދ.q5I?/陉f LII(n->4$&>x' 5!# M N@jq l)K^o=ye@Ddđ+&M,@wӇS$K3 ^ad#\).7m#NV2BBঘ_<> Cd'f7/ $ d=g܀
+
endstream
endobj
50 0 obj
<>stream
+ā. 8AB&H%XJ
7` XW@s%x 8hFc@A8h//T s NISXkN pe@hA!ʅ_L|S b-4"⨘]0& !酑_B+ >]/}:ZbTy$Ey|
+Z{8~ _ Cډ8 m^>7/T#7VR 0T'~}3כ8߂'/_` u1d4
endstream
endobj
5 0 obj
<>
endobj
6 0 obj
<>
endobj
18 0 obj
[/View/Design]
endobj
19 0 obj
<>>>
endobj
16 0 obj
[/View/Design]
endobj
17 0 obj
<>>>
endobj
31 0 obj
[30 0 R 29 0 R]
endobj
51 0 obj
<>
endobj
xref
0 52
0000000004 65535 f
+0000000016 00000 n
+0000000185 00000 n
+0000047379 00000 n
+0000000000 00000 f
+0000266555 00000 n
+0000266625 00000 n
+0000000000 00000 f
+0000047430 00000 n
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000266816 00000 n
+0000266847 00000 n
+0000266700 00000 n
+0000266731 00000 n
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000050006 00000 n
+0000050077 00000 n
+0000266932 00000 n
+0000047801 00000 n
+0000053181 00000 n
+0000050498 00000 n
+0000050385 00000 n
+0000048830 00000 n
+0000049445 00000 n
+0000049493 00000 n
+0000050269 00000 n
+0000050300 00000 n
+0000050153 00000 n
+0000050184 00000 n
+0000050533 00000 n
+0000053249 00000 n
+0000053489 00000 n
+0000054522 00000 n
+0000069362 00000 n
+0000134950 00000 n
+0000200538 00000 n
+0000266126 00000 n
+0000266964 00000 n
+trailer
<<64A8AB8E858948269A0BCA92EF85B468>]>>
startxref
267136
%%EOF
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/assets/logo/web3js.jpg b/packages/web3-account-abstraction/assets/logo/web3js.jpg
new file mode 100644
index 00000000000..3b4cf23de26
Binary files /dev/null and b/packages/web3-account-abstraction/assets/logo/web3js.jpg differ
diff --git a/packages/web3-account-abstraction/assets/logo/web3js.svg b/packages/web3-account-abstraction/assets/logo/web3js.svg
new file mode 100644
index 00000000000..df8a2fcb868
--- /dev/null
+++ b/packages/web3-account-abstraction/assets/logo/web3js.svg
@@ -0,0 +1,33 @@
+
+
+
diff --git a/packages/web3-account-abstraction/package.json b/packages/web3-account-abstraction/package.json
new file mode 100644
index 00000000000..efbaa27231c
--- /dev/null
+++ b/packages/web3-account-abstraction/package.json
@@ -0,0 +1,65 @@
+{
+ "name": "web3-account-abstraction",
+ "version": "0.1.0-rc.0",
+ "description": "Web3 account abstraction package",
+ "main": "./lib/commonjs/index.js",
+ "module": "./lib/esm/index.js",
+ "exports": {
+ ".": {
+ "types": "./lib/types/index.d.ts",
+ "import": "./lib/esm/index.js",
+ "require": "./lib/commonjs/index.js"
+ }
+ },
+ "repository": "https://github.com/web3/web3.js",
+ "author": "ChainSafe Systems",
+ "license": "LGPL-3.0",
+ "engines": {
+ "node": ">=14",
+ "npm": ">=6.12.0"
+ },
+ "files": [
+ "lib/**/*",
+ "src/**/*"
+ ],
+ "scripts": {
+ "clean": "rimraf dist && rimraf lib",
+ "prebuild": "yarn clean",
+ "build": "concurrently --kill-others-on-fail \"yarn:build:*(!check)\"",
+ "build:cjs": "tsc --build tsconfig.cjs.json && echo '{\"type\": \"commonjs\"}' > ./lib/commonjs/package.json",
+ "build:esm": "tsc --build tsconfig.esm.json && echo '{\"type\": \"module\"}' > ./lib/esm/package.json",
+ "build:types": "tsc --build tsconfig.types.json",
+ "build:check": "node -e \"require('./lib')\"",
+ "lint": "eslint --cache --cache-strategy content --ext .ts .",
+ "lint:fix": "eslint --fix --ext .js,.ts .",
+ "format": "prettier --write '**/*'",
+ "test": "jest --config=./test/unit/jest.config.js",
+ "test:coverage:unit": "jest --config=./test/unit/jest.config.js --coverage=true --coverage-reporters=text",
+ "test:coverage:integration": "jest --config=./test/integration/jest.config.js --passWithNoTests --coverage=true --coverage-reporters=text",
+ "test:ci": "jest --coverage=true --coverage-reporters=json --verbose",
+ "test:watch": "npm test -- --watch",
+ "test:unit": "jest --config=./test/unit/jest.config.js",
+ "test:integration": "jest --config=./test/integration/jest.config.js --passWithNoTests"
+ },
+ "devDependencies": {
+ "@types/jest": "^28.1.6",
+ "@typescript-eslint/eslint-plugin": "^5.30.7",
+ "@typescript-eslint/parser": "^5.30.7",
+ "eslint": "^8.20.0",
+ "eslint-config-base-web3": "0.1.0",
+ "eslint-config-prettier": "^8.5.0",
+ "eslint-plugin-import": "^2.26.0",
+ "jest": "^29.7.0",
+ "jest-extended": "^3.0.1",
+ "prettier": "^2.7.1",
+ "ts-jest": "^29.1.1",
+ "typescript": "^4.7.4"
+ },
+ "dependencies": {
+ "web3-core": "^4.6.0",
+ "web3-types": "^1.8.0",
+ "web3-eth-abi": "^4.1.3",
+ "web3-utils": "^4.0.7",
+ "web3-validator": "^2.0.3"
+ }
+}
diff --git a/packages/web3-account-abstraction/src/index.ts b/packages/web3-account-abstraction/src/index.ts
new file mode 100644
index 00000000000..c28fd333cc8
--- /dev/null
+++ b/packages/web3-account-abstraction/src/index.ts
@@ -0,0 +1,24 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+import { AccountAbstraction } from './web3_aa.js';
+
+export * from './types.js';
+export * from './utils.js';
+export * from './web3_aa.js';
+
+export default AccountAbstraction;
diff --git a/packages/web3-account-abstraction/src/types.ts b/packages/web3-account-abstraction/src/types.ts
new file mode 100644
index 00000000000..b6a4c408877
--- /dev/null
+++ b/packages/web3-account-abstraction/src/types.ts
@@ -0,0 +1,107 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+import {
+ Address,
+ Uint256,
+ HexStringBytes,
+ Uint,
+ HexString32Bytes,
+ TransactionHash,
+ LogAPI,
+ TransactionReceiptAPI,
+} from 'web3-types';
+
+export type ValidInputTypes = Uint8Array | bigint | string | number | boolean;
+
+export interface UserOperation {
+ sender: Address;
+ nonce: Uint256;
+ initCode: HexStringBytes;
+ callData: HexStringBytes;
+ callGasLimit?: Uint256;
+ verificationGasLimit: Uint256;
+ preVerificationGas: Uint256;
+ maxFeePerGas?: Uint256;
+ maxPriorityFeePerGas?: Uint256;
+ paymasterAndData: HexStringBytes;
+ signature: HexStringBytes;
+}
+export interface UserOperationRequire
+ extends Omit {
+ callGasLimit: Uint256;
+ maxFeePerGas: Uint256;
+ maxPriorityFeePerGas: Uint256;
+}
+
+export interface IUserOperation {
+ readonly callData: HexStringBytes;
+ readonly callGasLimit: Uint;
+ readonly initCode: HexStringBytes;
+ readonly maxFeePerGas: Uint;
+ readonly maxPriorityFeePerGas: Uint;
+ readonly nonce: Uint;
+ readonly paymasterAndData: HexStringBytes;
+ readonly preVerificationGas: Uint;
+ readonly sender: Address;
+ readonly signature: HexStringBytes;
+ readonly verificationGasLimit: Uint;
+}
+
+export interface GetUserOperationByHashAPI {
+ readonly blockHash: HexString32Bytes;
+ readonly blockNumber: Uint;
+ readonly entryPoint: Address;
+ readonly transactionHash: TransactionHash;
+ readonly userOperation: IUserOperation;
+}
+
+export interface EstimateUserOperationGasAPI {
+ readonly preVerificationGas: Uint;
+ readonly verificationGasLimit: Uint;
+ readonly callGasLimit: Uint;
+}
+
+export interface GetUserOperationReceiptAPI {
+ readonly userOpHash: HexString32Bytes;
+ readonly entryPoint: Address;
+ readonly sender: Address;
+ readonly nonce: Uint;
+ readonly paymaster: Address;
+ readonly actualGasCost: Uint;
+ readonly actualGasUsed: Uint;
+ readonly success: boolean;
+ readonly reason: HexStringBytes;
+ readonly logs: LogAPI[];
+ readonly receipt: TransactionReceiptAPI;
+}
+
+export type AARpcApi = {
+ eth_sendUserOperation: (userOperation: UserOperation, entryPoint: Address) => HexString32Bytes;
+ eth_estimateUserOperationGas: (
+ userOperation: UserOperation,
+ entryPoint: Address,
+ ) => EstimateUserOperationGasAPI;
+ eth_getUserOperationByHash: (hash: HexStringBytes) => GetUserOperationByHashAPI;
+ eth_getUserOperationReceipt: (hash: HexStringBytes) => GetUserOperationReceiptAPI;
+ eth_supportedEntryPoints: () => Address[];
+ generateUserOpHash: (
+ userOp: UserOperationRequire,
+ entryPoint: string,
+ chainId: string,
+ ) => string;
+};
diff --git a/packages/web3-account-abstraction/src/utils.ts b/packages/web3-account-abstraction/src/utils.ts
new file mode 100644
index 00000000000..f92afee649a
--- /dev/null
+++ b/packages/web3-account-abstraction/src/utils.ts
@@ -0,0 +1,97 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+import { Address, AbiInput, Uint256, HexStringBytes } from 'web3-types';
+import { encodeParameters } from 'web3-eth-abi';
+import { sha3 } from 'web3-utils';
+import { isHexStrict } from 'web3-validator';
+import { UserOperation, UserOperationRequire } from './types.js';
+
+export const convertValuesToHex = (obj: Record): Record => {
+ const hexObj: Record = {};
+
+ Object.entries(obj).forEach(([key, value]) => {
+ if (typeof value === 'string') {
+ hexObj[key] = value.startsWith('0x') ? value : `0x${value}`;
+ } else if (typeof value === 'number' || typeof value === 'bigint') {
+ hexObj[key] = `0x${value.toString(16)}`;
+ } else if (typeof value === 'boolean') {
+ hexObj[key] = value ? '0x1' : '0x0';
+ } else {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+ hexObj[key] = value;
+ }
+ });
+
+ return hexObj;
+};
+
+const sha3Checked = (data: string): string => {
+ const result = sha3(data);
+ if (result === undefined) {
+ throw new Error('sha3 returned undefined');
+ }
+ return result;
+};
+
+export const generateUserOpHash = (
+ userOp: UserOperationRequire,
+ entryPoint: string,
+ chainId: string,
+): string => {
+ const types: AbiInput[] = [
+ 'address',
+ 'uint256',
+ 'bytes32',
+ 'bytes32',
+ 'uint256',
+ 'uint256',
+ 'uint256',
+ 'uint256',
+ 'uint256',
+ 'bytes32',
+ ];
+
+ const values: (Address | Uint256 | HexStringBytes)[] = [
+ userOp.sender,
+ userOp.nonce,
+ sha3Checked(userOp.initCode),
+ sha3Checked(userOp.callData),
+ userOp.callGasLimit,
+ userOp.verificationGasLimit,
+ userOp.preVerificationGas,
+ userOp.maxFeePerGas,
+ userOp.maxPriorityFeePerGas,
+ sha3Checked(userOp.paymasterAndData),
+ ];
+
+ const packed: string = encodeParameters(types, values);
+
+ const enctype: AbiInput[] = ['bytes32', 'address', 'uint256'];
+ const encValues: string[] = [sha3Checked(packed), entryPoint, chainId];
+ const enc: string = encodeParameters(enctype, encValues);
+
+ return sha3Checked(enc);
+};
+
+/**
+ * UserOperation a full user-operation struct. All fields MUST be set as hex values. empty bytes block (e.g. empty initCode) MUST be set to "0x"
+ * @param userOperation - represents the structure of a transaction initiated by the user. It contains the sender, receiver, call data, maximum fee per unit of Gas, maximum priority fee, signature, nonce, and other specific elements.
+ * @returns boolean
+ */
+export const isUserOperationAllHex = (userOperation: UserOperation): boolean =>
+ Object.values(userOperation).every(isHexStrict);
diff --git a/packages/web3-account-abstraction/src/web3_aa.ts b/packages/web3-account-abstraction/src/web3_aa.ts
new file mode 100644
index 00000000000..fb81e6a8570
--- /dev/null
+++ b/packages/web3-account-abstraction/src/web3_aa.ts
@@ -0,0 +1,340 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+import { Web3Context, Web3RequestManager, isSupportedProvider } from 'web3-core';
+import { Address, HexStringBytes, SupportedProviders } from 'web3-types';
+
+import { AARpcApi, UserOperation, UserOperationRequire } from './types.js';
+import { convertValuesToHex, generateUserOpHash, isUserOperationAllHex } from './utils.js';
+
+/**
+ * Account Abstraction feature allows enhancing user experience and security by allowing smart contracts to manage user accounts and transactions more flexibly.
+ *
+ * For using account abstraction functions, install `web3-account-abstraction` packages using: `npm i web3-account-abstraction` or `yarn add web3-account-abstraction`.
+ *
+ * ```ts
+ * import {AccountAbstraction} from 'web3-account-abstraction';
+ *
+ * const aa = new AccountAbstraction('https://bundler-provider');
+ * aa.supportedEntryPoints().then(console.log);
+ * ```
+ */
+export class AccountAbstraction extends Web3Context {
+ // local package level request manager
+ private readonly bundlerRequestManager!: Web3RequestManager;
+
+ public constructor(provider?: SupportedProviders | string) {
+ super();
+
+ // If "provider" is provided as "string" or an objects matching "SupportedProviders" interface
+ if (
+ (typeof provider === 'string' && provider.trim() !== '') ||
+ isSupportedProvider(provider as SupportedProviders)
+ ) {
+ this.bundlerRequestManager = new Web3RequestManager(provider);
+ }
+ }
+ /**
+ * Sends a UserOperation to the bundler. If accepted, the bundler will add it to the UserOperation mempool and return a userOpHash.
+ *
+ * @param UserOperation - represents the structure of a transaction initiated by the user. It contains the sender, receiver, call data, maximum fee per unit of Gas, maximum priority fee, signature, nonce, and other specific elements.
+ * @param entryPoint - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.
+ * @returns userOperation hash or throws error instead of balance.
+ * @example
+ * ```ts
+ * sendUserOperation({
+ * sender: "0x9fd042a18e90ce326073fa70f111dc9d798d9a52",
+ * nonce: "123",
+ * initCode: "0x68656c6c6f",
+ * callData: "0x776F726C64",
+ * callGasLimit: "1000",
+ * verificationGasLimit: "2300",
+ * preVerificationGas: "3100",
+ * maxFeePerGas: "8500",
+ * maxPriorityFeePerGas: "1",
+ * paymasterAndData: "0x626c6f63746f",
+ * signature: "0x636c656d656e74"
+ * },"0x636c656d656e74").then(console.log);
+ * > 0xe554d0701f7fdc734f84927d109537f1ac4ee4ebfa3670c71d224a4fa15dbcd1
+ * ```
+ */
+ public async sendUserOperation(userOperation: UserOperation, entryPoint: Address) {
+ let userOp = { ...userOperation };
+ const validator = isUserOperationAllHex(userOp);
+ if (!validator) {
+ userOp = convertValuesToHex(userOperation) as UserOperation;
+ }
+ return (this.bundlerRequestManager ?? this.requestManager).send({
+ method: 'eth_sendUserOperation',
+ params: [userOp, entryPoint],
+ });
+ }
+ /**
+ * Estimate the gas values for a UserOperation. Given UserOperation optionally without gas limits and gas prices, return the needed gas limits. The signature field is ignored by the wallet, so that the operation will not require user's approval. Still, it might require putting a "semi-valid" signature (e.g. a signature in the right length)
+ *
+ * @param UserOperation - represents the structure of a transaction initiated by the user. It contains the sender, receiver, call data, maximum fee per unit of Gas, maximum priority fee, signature, nonce, and other specific elements.
+ * @param entryPoint - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.
+ * @returns - `preVerificationGas` gas overhead of this UserOperation
+ * - `verificationGasLimit` actual gas used by the validation of this UserOperation
+ * - `callGasLimit` value used by inner account execution
+ * @example
+ * ```ts
+ * estimateUserOperationGas({
+ * sender: "0x9fd042a18e90ce326073fa70f111dc9d798d9a52",
+ * nonce: "123",
+ * initCode: "0x68656c6c6f",
+ * callData: "0x776F726C64",
+ * callGasLimit: "1000",
+ * verificationGasLimit: "2300",
+ * preVerificationGas: "3100",
+ * maxFeePerGas: "0",
+ * maxPriorityFeePerGas: "0",
+ * paymasterAndData: "0x626c6f63746f",
+ * signature: "0x636c656d656e74"
+ * },"0x636c656d656e74").then(console.log);
+ * > {
+ * callGasLimit : "0x18b33",
+ * preVerificationGas: "0xdf17",
+ * verificationGasLimit:"0x128c4"
+ * }
+ * ```
+ */
+ public async estimateUserOperationGas(userOperation: UserOperation, entryPoint: Address) {
+ const userOp = { ...userOperation };
+ if (userOperation?.maxFeePerGas === undefined) {
+ userOp.maxFeePerGas = '0';
+ }
+ if (userOperation?.maxPriorityFeePerGas === undefined) {
+ userOp.maxPriorityFeePerGas = '0';
+ }
+ return (this.bundlerRequestManager ?? this.requestManager).send({
+ method: 'eth_estimateUserOperationGas',
+ params: [userOp, entryPoint],
+ });
+ }
+ /**
+ * Return a UserOperation based on a hash (userOpHash) returned by eth_sendUserOperation
+ *
+ * @param hash - a userOpHash value returned by `eth_sendUserOperation`
+ * @returns null in case the UserOperation is not yet included in a block, or a full UserOperation, with the addition of entryPoint, blockNumber, blockHash and transactionHash
+ * @example
+ * ```ts
+ * getUserOperationByHash("0xxxxx").then(console.log);
+ * > {
+ * userOperation: {
+ * sender: "xxxx",
+ * nonce: "xxxx",
+ * initCode: "0xxxxxxxxxxxxxxx",
+ * callData: "0xxxxxxxxxxxxxxx",
+ * callGasLimit: "xxxx",
+ * verificationGasLimit: "xxxx",
+ * preVerificationGas: "xxxx",
+ * maxFeePerGas: "0",
+ * maxPriorityFeePerGas: "0",
+ * paymasterAndData: "0xxxxxxxxxxxxxxx",
+ * signature: "0xxxxxxxxxxxxxxx"
+ * },
+ * entryPoint: '0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789',
+ * blockNumber: 39642225,
+ * blockHash: '0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f',
+ * transactionHash: '0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4',
+ * }
+ * ```
+ */
+
+ public async getUserOperationByHash(hash: HexStringBytes) {
+ return (this.bundlerRequestManager ?? this.requestManager).send({
+ method: 'eth_getUserOperationByHash',
+ params: [hash],
+ });
+ }
+ /**
+ * Return null in case the UserOperation is not yet included in a block, or
+ * - userOpHash the request hash
+ * - entryPoint
+ * - sender
+ * - nonce
+ * - paymaster the paymaster used for this userOp (or empty)
+ * - actualGasCost - actual amount paid (by account or paymaster) for this UserOperation
+ * - actualGasUsed - total gas used by this UserOperation (including preVerification, creation, validation and execution)
+ * - success boolean - did this execution completed without revert
+ * - reason in case of revert, this is the revert reason
+ * - logs the logs generated by this UserOperation (not including logs of other UserOperations in the same bundle)
+ * - receipt the TransactionReceipt object. Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation.
+ *
+ * @param hash - hash a userOpHash value returned by `eth_sendUserOperation`
+ * @returns null in case the UserOperation is not yet included in a block, or UserOperation
+ * @example
+ * ```ts
+ * getUserOperationReceipt("0xa890d7c0dccfd6cebc025919f4857ab97953ae218e82f5e24c297f02ceea5b21").then(console.log);
+ * >"userOpHash": "0xa890d7c0dccfd6cebc025919f4857ab97953ae218e82f5e24c297f02ceea5b21",
+ "entryPoint": "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
+ "sender": "0x026B37A09aF3ceB346c39999c5738F86A1a48f4d",
+ "nonce": "0x7",
+ "paymaster": "0xa312d8D37Be746BD09cBD9e9ba2ef16bc7Da48FF",
+ "actualGasCost": "0x1a036c1638be0",
+ "actualGasUsed": "0x2e8d8",
+ "success": true,
+ "reason": "",
+ "logs": [
+ {
+ "address": "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789",
+ "topics": [
+ "0xbb47ee3e183a558b1a2ff0874b079f3fc5478b7454eacf2bfc5af2ff5878f972"
+ ],
+ "data": "0x",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "logIndex": "0x12d",
+ "removed": false
+ },
+ {
+ "address": "0xfd8ec18d48ac1f46b600e231da07d1da8209ceef",
+ "topics": [
+ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
+ "0x0000000000000000000000000000000000000000000000000000000000000000",
+ "0x000000000000000000000000026b37a09af3ceb346c39999c5738f86a1a48f4d",
+ "0x000000000000000000000000000000000000000000000000000000000000007f"
+ ],
+ "data": "0x",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "logIndex": "0x12e",
+ "removed": false
+ },
+ {
+ "address": "0x00005ea00ac477b1030ce78506496e8c2de24bf5",
+ "topics": [
+ "0xe90cf9cc0a552cf52ea6ff74ece0f1c8ae8cc9ad630d3181f55ac43ca076b7d6",
+ "0x000000000000000000000000fd8ec18d48ac1f46b600e231da07d1da8209ceef",
+ "0x000000000000000000000000026b37a09af3ceb346c39999c5738f86a1a48f4d",
+ "0x0000000000000000000000000000a26b00c1f0df003000390027140000faa719"
+ ],
+ "data": "0x000000000000000000000000026b37a09af3ceb346c39999c5738f86a1a48f4d0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003e80000000000000000000000000000000000000000000000000000000000000000",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "logIndex": "0x12f",
+ "removed": false
+ },
+ {
+ "address": "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789",
+ "topics": [
+ "0x49628fd1471006c1482da88028e9ce4dbb080b815c9b0344d39e5a8e6ec1419f",
+ "0xa890d7c0dccfd6cebc025919f4857ab97953ae218e82f5e24c297f02ceea5b21",
+ "0x000000000000000000000000026b37a09af3ceb346c39999c5738f86a1a48f4d",
+ "0x000000000000000000000000a312d8d37be746bd09cbd9e9ba2ef16bc7da48ff"
+ ],
+ "data": "0x000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000001a036c1638be0000000000000000000000000000000000000000000000000000000000002e8d8",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "logIndex": "0x130",
+ "removed": false
+ }
+ ],
+ "receipt": {
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "from": "0x1e6754b227c6ae4b0ca61d82f79d60660737554a",
+ "to": "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789",
+ "cumulativeGasUsed": "0x1716d3b",
+ "gasUsed": "0x2b6c6",
+ "contractAddress": null,
+ "logs": [
+ {
+ "address": "0xfd8ec18d48ac1f46b600e231da07d1da8209ceef",
+ "topics": [
+ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
+ "0x0000000000000000000000000000000000000000000000000000000000000000",
+ "0x000000000000000000000000026b37a09af3ceb346c39999c5738f86a1a48f4d",
+ "0x000000000000000000000000000000000000000000000000000000000000007f"
+ ],
+ "data": "0x",
+ "blockHash": "0x638a175940cacb33f35e265961b164b14aa77477438340e635b227752f31981f",
+ "blockNumber": "0x25ce471",
+ "transactionHash": "0xc3e64ac247ae2343335596e106d1b97e35637656e1b99b37977a4165b34aeeb4",
+ "transactionIndex": "0x44",
+ "logIndex": "0x12e",
+ "removed": false
+ },
+ ],
+ "status": "0x1",
+ "logsBloom": "0x000000000000000000000000000000000008000000000000000000000000000000080000000000000002001108040020001080000000000000000200004000000000000000000000000800080000008000000000000000000001000208400040000000000a0008000000000000000800000000000000004080800010020100040000000000000000100000000000010000000000200080000000000000000000210000000000000000400080000000000000000000000000108002000004004008000002000000000001001000800000000001000000800000148040020020000000000000000000000001000000000100000000000000000000002000100000",
+ "type": "0x2",
+ "effectiveGasPrice": "0x59682f2e"
+ }
+ * ```
+ */
+ public async getUserOperationReceipt(hash: HexStringBytes) {
+ return (this.bundlerRequestManager ?? this.requestManager).send({
+ method: 'eth_getUserOperationReceipt',
+ params: [hash],
+ });
+ }
+ /**
+ * Returns an array of the entryPoint addresses supported by the client. The first element of the array SHOULD be the entryPoint addressed preferred by the client.
+ * @returns an array of the entryPoint addresses supported by the client. The first element of the array SHOULD be the entryPoint addressed preferred by the client.
+ * @example
+ * ```ts
+ * supportedEntryPoints().then(console.log);
+ * > ["0xcd01C8aa8995A59eB7B2627E69b40e0524B5ecf8", "0x7A0A0d159218E6a2f407B99173A2b12A6DDfC2a6"]
+ * ```
+ */
+ public async supportedEntryPoints() {
+ return (this.bundlerRequestManager ?? this.requestManager).send({
+ method: 'eth_supportedEntryPoints',
+ params: [],
+ });
+ }
+
+ /**
+ * calculate UserOperationHash
+ * @param userOp - a structure that describes a transaction to be sent on behalf of a user.
+ * @param entryPoint - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.
+ * @returns an array of the entryPoint addresses supported by the client. The first element of the array SHOULD be the entryPoint addressed preferred by the client.
+ * @example
+ * ```ts
+ * generateUserOpHash({
+ * sender: "0x9fd042a18e90ce326073fa70f111dc9d798d9a52",
+ * nonce: "123",
+ * initCode: "0x68656c6c6f",
+ * callData: "0x776F726C64",
+ * callGasLimit: "1000",
+ * verificationGasLimit: "2300",
+ * preVerificationGas: "3100",
+ * maxFeePerGas: "0",
+ * maxPriorityFeePerGas: "0",
+ * paymasterAndData: "0x626c6f63746f",
+ * signature: "0x636c656d656e74"
+ * },"0x636c656d656e74", '0x1').then(console.log);
+ * > 0xxxx
+ * ```
+ */
+ // eslint-disable-next-line class-methods-use-this
+ public generateUserOpHash(userOp: UserOperationRequire, entryPoint: string, chainId: string) {
+ return generateUserOpHash(userOp, entryPoint, chainId);
+ }
+}
diff --git a/packages/web3-account-abstraction/test/.eslintrc.js b/packages/web3-account-abstraction/test/.eslintrc.js
new file mode 100644
index 00000000000..a98dfb6d823
--- /dev/null
+++ b/packages/web3-account-abstraction/test/.eslintrc.js
@@ -0,0 +1,7 @@
+module.exports = {
+ extends: '../../../.eslintrc.test.js',
+ parserOptions: {
+ project: './tsconfig.json',
+ tsconfigRootDir: __dirname,
+ },
+};
diff --git a/packages/web3-account-abstraction/test/config/jest.config.js b/packages/web3-account-abstraction/test/config/jest.config.js
new file mode 120000
index 00000000000..b875b48129d
--- /dev/null
+++ b/packages/web3-account-abstraction/test/config/jest.config.js
@@ -0,0 +1 @@
+../../../../templates/jest.config.js.tmpl
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/test/config/setup.js b/packages/web3-account-abstraction/test/config/setup.js
new file mode 100644
index 00000000000..0b6b9109ce0
--- /dev/null
+++ b/packages/web3-account-abstraction/test/config/setup.js
@@ -0,0 +1,24 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+// Have to use `require` because of Jest issue https://jestjs.io/docs/ecmascript-modules
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+require('jest-extended');
+
+// @todo extend jest to have "toHaveBeenCalledOnceWith" matcher.
+
+process.env.NODE_ENV = 'test';
diff --git a/packages/web3-account-abstraction/test/integration/jest.config.js b/packages/web3-account-abstraction/test/integration/jest.config.js
new file mode 100644
index 00000000000..1d95890206a
--- /dev/null
+++ b/packages/web3-account-abstraction/test/integration/jest.config.js
@@ -0,0 +1,33 @@
+'use strict';
+
+const base = require('../config/jest.config');
+
+module.exports = {
+ ...base,
+ setupFilesAfterEnv: ['/test/integration/setup.js'],
+ testMatch: ['/test/integration/**/*.(spec|test).(js|ts)'],
+ /**
+ * restoreMocks [boolean]
+ *
+ * Default: false
+ *
+ * Automatically restore mock state between every test.
+ * Equivalent to calling jest.restoreAllMocks() between each test.
+ * This will lead to any mocks having their fake implementations removed
+ * and restores their initial implementation.
+ */
+ restoreMocks: true,
+
+ /**
+ * resetModules [boolean]
+ *
+ * Default: false
+ *
+ * By default, each test file gets its own independent module registry.
+ * Enabling resetModules goes a step further and resets the module registry before running each individual test.
+ * This is useful to isolate modules for every test so that local module state doesn't conflict between tests.
+ * This can be done programmatically using jest.resetModules().
+ */
+ resetModules: true,
+ coverageDirectory: '.coverage/integration',
+};
diff --git a/packages/web3-account-abstraction/test/integration/setup.js b/packages/web3-account-abstraction/test/integration/setup.js
new file mode 100644
index 00000000000..5be1bccf7cc
--- /dev/null
+++ b/packages/web3-account-abstraction/test/integration/setup.js
@@ -0,0 +1,24 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+// Have to use `require` because of Jest issue https://jestjs.io/docs/ecmascript-modules
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+require('../config/setup');
+
+const jestTimeout = 15000;
+
+jest.setTimeout(jestTimeout);
diff --git a/packages/web3-account-abstraction/test/tsconfig.json b/packages/web3-account-abstraction/test/tsconfig.json
new file mode 120000
index 00000000000..c73c54e77b4
--- /dev/null
+++ b/packages/web3-account-abstraction/test/tsconfig.json
@@ -0,0 +1 @@
+../../../templates/test/tsconfig.json.tmpl
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/test/unit/account_abstraction.test.ts b/packages/web3-account-abstraction/test/unit/account_abstraction.test.ts
new file mode 100644
index 00000000000..7afb15fbb4e
--- /dev/null
+++ b/packages/web3-account-abstraction/test/unit/account_abstraction.test.ts
@@ -0,0 +1,184 @@
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js. If not, see .
+*/
+
+import { AccountAbstraction, UserOperation, UserOperationRequire } from '../../src/index.js';
+
+describe('AccountAbstraction tests', () => {
+ const web3aa = new AccountAbstraction('http://127.0.0.1:8555/');
+ let sendSpy: jest.SpyInstance;
+ const requestManagerSendSpy = jest.fn();
+
+ beforeAll(() => {
+ // spy on private member so using any in tests only
+ (web3aa as any).bundlerRequestManager.send = requestManagerSendSpy;
+ });
+
+ it('should have requestManager defined with context', () => {
+ expect(web3aa.requestManager).toBeDefined();
+ });
+
+ describe('AccountAbstraction method tests', () => {
+ let userOperation: UserOperation | UserOperationRequire;
+
+ beforeEach(() => {
+ userOperation = {
+ sender: '0x9fd042a18e90ce326073fa70f111dc9d798d9a52',
+ nonce: '123',
+ initCode: '0x68656c6c6f',
+ callData: '0x776F726C64',
+ callGasLimit: '1000',
+ verificationGasLimit: '2300',
+ preVerificationGas: '3100',
+ maxFeePerGas: '8500',
+ maxPriorityFeePerGas: '1',
+ paymasterAndData: '0x626c6f63746f',
+ signature: '0x636c656d656e74',
+ };
+ sendSpy = jest.spyOn(web3aa, 'sendUserOperation').mockImplementation();
+ });
+
+ afterEach(() => {
+ sendSpy.mockRestore();
+ });
+
+ it('should call rpcMethods.sendUserOperation with expected parameters', async () => {
+ const entryPoint = '0x636c656d656e74';
+ await web3aa.sendUserOperation(userOperation, entryPoint);
+ expect(sendSpy).toHaveBeenCalledWith(userOperation, entryPoint);
+ });
+
+ it('should call rpcMethods.estimateUserOperationGas with expected parameters', async () => {
+ const entryPoint = '0x636c656d656e74';
+ const estimateSpy = jest.spyOn(web3aa, 'estimateUserOperationGas').mockImplementation();
+ await web3aa.estimateUserOperationGas(userOperation, entryPoint);
+ expect(estimateSpy).toHaveBeenCalledWith(userOperation, entryPoint);
+ estimateSpy.mockRestore();
+ });
+
+ it('should call rpcMethods.estimateUserOperationGas should set maxFeePerGas to "0" if not provided', async () => {
+ const entryPoint = '0x636c656d656e74';
+ const userOperationWithoutMaxFee = {
+ ...userOperation,
+ maxFeePerGas: undefined,
+ };
+ await web3aa.estimateUserOperationGas(userOperationWithoutMaxFee, entryPoint);
+
+ expect(requestManagerSendSpy).toHaveBeenCalledWith({
+ method: 'eth_estimateUserOperationGas',
+ params: [
+ {
+ ...userOperationWithoutMaxFee,
+ maxFeePerGas: '0', // Ensure it's set to "0"
+ },
+ entryPoint,
+ ],
+ });
+ });
+
+ it('should call rpcMethods.estimateUserOperationGas should set maxPriorityFeePerGas to "0" if not provided', async () => {
+ const entryPoint = '0x636c656d656e74';
+ const userOperationWithoutMaxFee = {
+ ...userOperation,
+ maxPriorityFeePerGas: undefined,
+ };
+ await web3aa.estimateUserOperationGas(userOperationWithoutMaxFee, entryPoint);
+
+ expect(requestManagerSendSpy).toHaveBeenCalledWith({
+ method: 'eth_estimateUserOperationGas',
+ params: [
+ {
+ ...userOperationWithoutMaxFee,
+ maxPriorityFeePerGas: '0', // Ensure it's set to "0"
+ },
+ entryPoint,
+ ],
+ });
+ });
+
+ it('should call rpcMethods.getUserOperationByHash with expected parameters', async () => {
+ const hash = '0xa890d7c0dccfd6cebc025919f4857ab97953ae218e82f5e24c297f02ceea5b21';
+ const estimateSpy = jest.spyOn(web3aa, 'getUserOperationByHash').mockImplementation();
+ await web3aa.getUserOperationByHash(hash);
+ expect(estimateSpy).toHaveBeenCalledWith(hash);
+ estimateSpy.mockRestore();
+ });
+
+ it('should call rpcMethods.getUserOperationReceipt with expected parameters', async () => {
+ const hash = '0x123456789abcdef0123456789abcdef012345678';
+ const estimateSpy = jest.spyOn(web3aa, 'getUserOperationReceipt').mockImplementation();
+ await web3aa.getUserOperationReceipt(hash);
+ expect(estimateSpy).toHaveBeenCalledWith(hash);
+ estimateSpy.mockRestore();
+ });
+
+ it('should call rpcMethods.supportedEntryPoints with expected parameters', async () => {
+ const supportedEntryPointsSendSpy = jest
+ .spyOn((web3aa as any).bundlerRequestManager, 'send')
+ .mockResolvedValue([
+ '0xcd01C8aa8995A59eB7B2627E69b40e0524B5ecf8',
+ '0x7A0A0d159218E6a2f407B99173A2b12A6DDfC2a6',
+ ]);
+
+ const result = await web3aa.supportedEntryPoints();
+
+ expect(supportedEntryPointsSendSpy).toHaveBeenCalledWith({
+ method: 'eth_supportedEntryPoints',
+ params: [],
+ });
+ expect(result).toEqual([
+ '0xcd01C8aa8995A59eB7B2627E69b40e0524B5ecf8',
+ '0x7A0A0d159218E6a2f407B99173A2b12A6DDfC2a6',
+ ]);
+ });
+
+ it('should call rpcMethods.generateUserOpHash with expected parameters', () => {
+ const entryPoint = '0xaE036c65C649172b43ef7156b009c6221B596B8b';
+ const chainId = '0x1';
+ const expectedResult =
+ '0xe554d0701f7fdc734f84927d109537f1ac4ee4ebfa3670c71d224a4fa15dbcd1';
+ const result = web3aa.generateUserOpHash(
+ userOperation as UserOperationRequire,
+ entryPoint,
+ chainId,
+ );
+
+ expect(result).toEqual(expectedResult);
+ });
+ it('should call rpcMethods.generateUserOpHash with throws an error when sha3 returns undefined', () => {
+ const userOp = {
+ sender: '0x9fd042a18e90ce326073fa70f111dc9d798d9a52',
+ nonce: '123',
+ initCode: '',
+ callData: '0x776F726C64',
+ callGasLimit: '1000',
+ verificationGasLimit: '2300',
+ preVerificationGas: '3100',
+ maxFeePerGas: '8500',
+ maxPriorityFeePerGas: '1',
+ paymasterAndData: '0x626c6f63746f',
+ signature: '0x636c656d656e74',
+ };
+ const entryPoint = '0xaE036c65C649172b43ef7156b009c6221B596B8b';
+ const chainId = '0x1';
+
+ // Expect an error to be thrown
+ expect(() => web3aa.generateUserOpHash(userOp, entryPoint, chainId)).toThrow(
+ 'sha3 returned undefined',
+ );
+ });
+ });
+});
diff --git a/packages/web3-account-abstraction/test/unit/jest.config.js b/packages/web3-account-abstraction/test/unit/jest.config.js
new file mode 100644
index 00000000000..ceac341e332
--- /dev/null
+++ b/packages/web3-account-abstraction/test/unit/jest.config.js
@@ -0,0 +1,9 @@
+const base = require('../config/jest.config');
+
+module.exports = {
+ ...base,
+ testMatch: ['/test/unit/**/*.(spec|test).(js|ts)'],
+
+ coverageDirectory: '.coverage/unit',
+ collectCoverageFrom: ['src/**'],
+};
diff --git a/packages/web3-account-abstraction/tsconfig.cjs.json b/packages/web3-account-abstraction/tsconfig.cjs.json
new file mode 120000
index 00000000000..f8b17044cd5
--- /dev/null
+++ b/packages/web3-account-abstraction/tsconfig.cjs.json
@@ -0,0 +1 @@
+../../config/tsconfig.cjs.json
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/tsconfig.esm.json b/packages/web3-account-abstraction/tsconfig.esm.json
new file mode 120000
index 00000000000..f5fab722b38
--- /dev/null
+++ b/packages/web3-account-abstraction/tsconfig.esm.json
@@ -0,0 +1 @@
+../../config/tsconfig.esm.json
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/tsconfig.types.json b/packages/web3-account-abstraction/tsconfig.types.json
new file mode 120000
index 00000000000..c67a7816f18
--- /dev/null
+++ b/packages/web3-account-abstraction/tsconfig.types.json
@@ -0,0 +1 @@
+../../config/tsconfig.types.json
\ No newline at end of file
diff --git a/packages/web3-account-abstraction/tsdoc.json b/packages/web3-account-abstraction/tsdoc.json
new file mode 100644
index 00000000000..776fc76a3d3
--- /dev/null
+++ b/packages/web3-account-abstraction/tsdoc.json
@@ -0,0 +1,4 @@
+{
+ "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+ "extends": ["../../tsdoc.json"]
+}
diff --git a/scripts/docshelper/classesdoc.config.js b/scripts/docshelper/classesdoc.config.js
index 1c8a9d45cb2..b630f580cf9 100644
--- a/scripts/docshelper/classesdoc.config.js
+++ b/scripts/docshelper/classesdoc.config.js
@@ -1,20 +1,20 @@
const baseDocConfig = require('./base.config.js');
module.exports = {
- ... baseDocConfig,
+ ...baseDocConfig,
- entryPoints: [
- "./packages/web3-eth/src/web3_eth.ts",
- "./packages/web3-eth-accounts/src/wallet.ts",
- "./packages/web3-eth-accounts/src/account.ts",
- "./packages/web3-eth-contract/src/contract.ts",
- "./packages/web3-eth-ens/src/ens.ts",
- "./packages/web3-eth-iban/src/iban.ts",
- "./packages/web3-eth-personal/src/personal.ts",
- "./packages/web3-net/src/net.ts",
- ],
-
- excludeCategories: "ContractEvent", // for exluding being in module.md file and invalid link in contract.md
- mergeModulesMergeMode: "project", // NEW option of TypeDoc added by typedoc-plugin-merge-modules plugin
+ entryPoints: [
+ './packages/web3-eth/src/web3_eth.ts',
+ './packages/web3-eth-accounts/src/wallet.ts',
+ './packages/web3-eth-accounts/src/account.ts',
+ './packages/web3-eth-contract/src/contract.ts',
+ './packages/web3-eth-ens/src/ens.ts',
+ './packages/web3-eth-iban/src/iban.ts',
+ './packages/web3-eth-personal/src/personal.ts',
+ './packages/web3-net/src/net.ts',
+ './packages/web3-account-abstraction/src/web3_aa.ts',
+ ],
+ excludeCategories: 'ContractEvent', // for exluding being in module.md file and invalid link in contract.md
+ mergeModulesMergeMode: 'project', // NEW option of TypeDoc added by typedoc-plugin-merge-modules plugin
};
+