Transaction Hash:
Block:
21953991 at Mar-01-2025 07:04:35 PM +UTC
Transaction Fee:
0.000840451004035081 ETH
$1.59
Gas Used:
1,003,411 Gas / 0.837593971 Gwei
Emitted Events:
3795 |
TransparentUpgradeableProxy.0x2c32d4ae151744d0bf0b9464a3e897a1d17ed2f1af71f7c9a75f12ce0d28238f( 0x2c32d4ae151744d0bf0b9464a3e897a1d17ed2f1af71f7c9a75f12ce0d28238f, 0x00000000000000000000000000000000000000000000000000000000000032b0, 0x2e226619fc8bd2a493ae20e7053f6fd7925ec9325e85934141426a659496cdec )
|
Account State Difference:
Address | Before | After | State Difference | ||
---|---|---|---|---|---|
0x61F2945d...438f613e2 |
4.968359998612832374 Eth
Nonce: 5995
|
4.967519547606831213 Eth
Nonce: 5996
| 0.000840451006001161 | ||
0x759894Ce...02E3CeF60 | |||||
0x95222290...5CC4BAfe5
Miner
| (beaverbuild) | 14.429469541282287434 Eth | 14.429470931926650321 Eth | 0.000001390644362887 |
Execution Trace
TransparentUpgradeableProxy.4a8d544f( )
Rollup.commitBatch( batchDataInput=[{name:version, type:uint8, order:1, indexed:false, value:0, valueString:0}, {name:parentBatchHeader, type:bytes, order:2, indexed:false, value:0x0000000000000032AF00000000000000000000000000001CA114EB2562647119AFED35ACA7768D6F05973A3784462C48C4D01134249746AF1D017393BDED8D42095A7EBB1CD96E1AECD853AC1348A1F5798DB989948C017794118D1EF4A313B42F1B2333E7D634F04B1C430589D2AC418E449197680D7F69AB0BDB8DCB39413FC021E3155E8156D0F058B965004D417310C271173B98849A6897A8A04544EF85166B037C5B8603F6FC56F780D13676D1A7728111BC3ACCB73FA4D7461C3B8D74650EFDCA322D5FE15E699D534EE47EC9321BCB82BC7A9EC6E9D2FB65365A6C02A86679D28045A0A28724293CB2F61E096E9D3D56EAD4E71108, valueString:0x0000000000000032AF00000000000000000000000000001CA114EB2562647119AFED35ACA7768D6F05973A3784462C48C4D01134249746AF1D017393BDED8D42095A7EBB1CD96E1AECD853AC1348A1F5798DB989948C017794118D1EF4A313B42F1B2333E7D634F04B1C430589D2AC418E449197680D7F69AB0BDB8DCB39413FC021E3155E8156D0F058B965004D417310C271173B98849A6897A8A04544EF85166B037C5B8603F6FC56F780D13676D1A7728111BC3ACCB73FA4D7461C3B8D74650EFDCA322D5FE15E699D534EE47EC9321BCB82BC7A9EC6E9D2FB65365A6C02A86679D28045A0A28724293CB2F61E096E9D3D56EAD4E71108}, {name:blockContexts, type:bytes, order:3, indexed:false, value:0x025800000000005F90E30000000067C356F200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E40000000067C356F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E50000000067C356F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E60000000067C356F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E70000000067C356F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E80000000067C356F900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E90000000067C356FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EA0000000067C356FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EB0000000067C356FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EC0000000067C356FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90ED0000000067C3570000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EE0000000067C3570200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EF0000000067C3570300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F00000000067C3570400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F10000000067C3570500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F90F20000000067C3570600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F30000000067C3570700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F40000000067C3570900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F50000000067C3570A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F60000000067C3570C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F70000000067C3570D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F80000000067C3570E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F90000000067C3570F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FA0000000067C3571000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F90FB0000000067C3571200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FC0000000067C3571300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FD0000000067C3571400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FE0000000067C3571600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FF0000000067C3571700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91000000000067C3571900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91010000000067C3571A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91020000000067C3571B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91030000000067C3571D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91040000000067C3571F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91050000000067C3572000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91060000000067C3572200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91070000000067C3572400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91080000000067C3572600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91090000000067C3572700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910A0000000067C3572800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910B0000000067C3572A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910C0000000067C3572C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910D0000000067C3572E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F910E0000000067C3572F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910F0000000067C3573000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91100000000067C3573100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91110000000067C3573400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91120000000067C3573500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91130000000067C3573600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91140000000067C3573700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91150000000067C3573800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91160000000067C3573A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91170000000067C3573B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91180000000067C3573C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91190000000067C3573D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F911A0000000067C3573E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911B0000000067C3573F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911C0000000067C3574000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911D0000000067C3574100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911E0000000067C3574200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911F0000000067C3574300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91200000000067C3574600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91210000000067C3574700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91220000000067C3574800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91230000000067C3574900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91240000000067C3574A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91250000000067C3574B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91260000000067C3574D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91270000000067C3574E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91280000000067C3575100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91290000000067C3575200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912A0000000067C3575400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912B0000000067C3575500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912C0000000067C3575600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912D0000000067C3575700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912E0000000067C3575800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912F0000000067C3575900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91300000000067C3575B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91310000000067C3575C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91320000000067C3575D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91330000000067C3575F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91340000000067C3576000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91350000000067C3576100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91360000000067C3576300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91370000000067C3576400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91380000000067C3576500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91390000000067C3576600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913A0000000067C3576900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913B0000000067C3576A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913C0000000067C3576B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913D0000000067C3576C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913E0000000067C3576E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913F0000000067C3577000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91400000000067C3577100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91410000000067C3577200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91420000000067C3577400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91430000000067C3577500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91440000000067C3577600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91450000000067C3577700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91460000000067C3577900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91470000000067C3577B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91480000000067C3577C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91490000000067C3577D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914A0000000067C3577F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914B0000000067C3578000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914C0000000067C3578100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914D0000000067C3578200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914E0000000067C3578400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F914F0000000067C3578600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91500000000067C3578800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91510000000067C3578900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91520000000067C3578A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91530000000067C3578B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91540000000067C3578D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91550000000067C3578F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91560000000067C3579100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91570000000067C3579300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91580000000067C3579400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91590000000067C3579500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915A0000000067C3579600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915B0000000067C3579800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F915C0000000067C3579A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915D0000000067C3579C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915E0000000067C3579E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915F0000000067C3579F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91600000000067C357A000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91610000000067C357A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91620000000067C357A400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91630000000067C357A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91640000000067C357A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91650000000067C357A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91660000000067C357A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91670000000067C357AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91680000000067C357AC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91690000000067C357AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916A0000000067C357AE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F916B0000000067C357B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916C0000000067C357B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916D0000000067C357B300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916E0000000067C357B400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916F0000000067C357B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91700000000067C357B800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91710000000067C357BA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91720000000067C357BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91730000000067C357BC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91740000000067C357BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91750000000067C357BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91760000000067C357C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91770000000067C357C100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91780000000067C357C300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91790000000067C357C400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917A0000000067C357C500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917B0000000067C357C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F917C0000000067C357C800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917D0000000067C357CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917E0000000067C357CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917F0000000067C357CD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91800000000067C357CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91810000000067C357CF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91820000000067C357D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91830000000067C357D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91840000000067C357D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91850000000067C357D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91860000000067C357D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91870000000067C357D800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91880000000067C357DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91890000000067C357DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918A0000000067C357DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918B0000000067C357DE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918C0000000067C357E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918D0000000067C357E100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918E0000000067C357E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918F0000000067C357E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91900000000067C357E600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91910000000067C357E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91920000000067C357E800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91930000000067C357E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91940000000067C357EA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91950000000067C357EB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91960000000067C357ED00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91970000000067C357EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91980000000067C357F000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91990000000067C357F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919A0000000067C357F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F919B0000000067C357F500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919C0000000067C357F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919D0000000067C357F700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919E0000000067C357F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919F0000000067C357FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A00000000067C357FB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A10000000067C357FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A20000000067C357FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A30000000067C357FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91A40000000067C3580100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A50000000067C3580200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A60000000067C3580300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A70000000067C3580500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A80000000067C3580700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A90000000067C3580800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AA0000000067C3580900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AB0000000067C3580A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AC0000000067C3580B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AD0000000067C3580C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AE0000000067C3580E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AF0000000067C3580F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B00000000067C3581000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B10000000067C3581100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B20000000067C3581200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B30000000067C3581400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B40000000067C3581600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B50000000067C3581700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B60000000067C3581800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B70000000067C3581900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B80000000067C3581B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B90000000067C3581C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BA0000000067C3581D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91BB0000000067C3581E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BC0000000067C3582100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BD0000000067C3582200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BE0000000067C3582300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BF0000000067C3582400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91C00000000067C3582500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C10000000067C3582600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C20000000067C3582800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C30000000067C3582A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91C40000000067C3582C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C50000000067C3582D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C60000000067C3582E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C70000000067C3582F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C80000000067C3583000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C90000000067C3583100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CA0000000067C3583200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CB0000000067C3583300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CC0000000067C3583500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CD0000000067C3583600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CE0000000067C3583700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CF0000000067C3583800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91D00000000067C3583A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D10000000067C3583C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D20000000067C3583E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D30000000067C3583F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D40000000067C3584000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D50000000067C3584100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D60000000067C3584200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D70000000067C3584300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D80000000067C3584500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91D90000000067C3584700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DA0000000067C3584900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DB0000000067C3584B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DC0000000067C3584C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DD0000000067C3584D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DE0000000067C3584E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DF0000000067C3585000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E00000000067C3585200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E10000000067C3585300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91E20000000067C3585400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E30000000067C3585500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E40000000067C3585600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E50000000067C3585800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E60000000067C3585900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E70000000067C3585A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E80000000067C3585B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E90000000067C3585C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EA0000000067C3585D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91EB0000000067C3585F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EC0000000067C3586000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91ED0000000067C3586100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EE0000000067C3586300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EF0000000067C3586400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F00000000067C3586600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91F10000000067C3586800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F20000000067C3586900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F30000000067C3586A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F40000000067C3586C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F50000000067C3586D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F60000000067C3586E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F70000000067C3586F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F80000000067C3587200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F90000000067C3587300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91FA0000000067C3587500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FB0000000067C3587700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FC0000000067C3587900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FD0000000067C3587A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FE0000000067C3587B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FF0000000067C3587C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92000000000067C3587D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92010000000067C3587E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92020000000067C3588000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92030000000067C3588200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92040000000067C3588400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92050000000067C3588600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92060000000067C3588700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92070000000067C3588800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92080000000067C3588900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92090000000067C3588B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920A0000000067C3588D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920B0000000067C3588E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F920C0000000067C3588F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920D0000000067C3589100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920E0000000067C3589200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920F0000000067C3589400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92100000000067C3589600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92110000000067C3589700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92120000000067C3589800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92130000000067C3589A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92140000000067C3589B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92150000000067C3589C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92160000000067C3589E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92170000000067C3589F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92180000000067C358A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92190000000067C358A200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921A0000000067C358A300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F921B0000000067C358A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921C0000000067C358A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921D0000000067C358A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921E0000000067C358A800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921F0000000067C358A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92200000000067C358AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92210000000067C358AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92220000000067C358AE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92230000000067C358AF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92240000000067C358B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92250000000067C358B100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92260000000067C358B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92270000000067C358B400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92280000000067C358B500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92290000000067C358B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922A0000000067C358B700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922B0000000067C358B900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922C0000000067C358BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922D0000000067C358BC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922E0000000067C358BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922F0000000067C358BE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92300000000067C358BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92310000000067C358C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92320000000067C358C200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92330000000067C358C400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92340000000067C358C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92350000000067C358C800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92360000000067C358C900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92370000000067C358CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92380000000067C358CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92390000000067C358CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923A0000000067C358D000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923B0000000067C358D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923C0000000067C358D200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923D0000000067C358D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923E0000000067C358D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923F0000000067C358D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92400000000067C358D600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92410000000067C358D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92420000000067C358D800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92430000000067C358D900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92440000000067C358DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92450000000067C358DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92460000000067C358DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92470000000067C358DD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92480000000067C358DE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92490000000067C358DF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924A0000000067C358E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F924B0000000067C358E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924C0000000067C358E300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924D0000000067C358E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924E0000000067C358E500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924F0000000067C358E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92500000000067C358E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92510000000067C358EB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92520000000067C358EC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92530000000067C358ED00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92540000000067C358EE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92550000000067C358EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92560000000067C358F100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92570000000067C358F200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92580000000067C358F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92590000000067C358F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925A0000000067C358F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925B0000000067C358F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F925C0000000067C358FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925D0000000067C358FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925E0000000067C358FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925F0000000067C358FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92600000000067C358FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92610000000067C3590000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92620000000067C3590100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92630000000067C3590200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92640000000067C3590300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92650000000067C3590400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92660000000067C3590500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92670000000067C3590600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92680000000067C3590700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92690000000067C3590900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926A0000000067C3590B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F926B0000000067C3590C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926C0000000067C3590D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926D0000000067C3590E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926E0000000067C3591000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926F0000000067C3591100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92700000000067C3591200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92710000000067C3591300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92720000000067C3591400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92730000000067C3591500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92740000000067C3591600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92750000000067C3591700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92760000000067C3591A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92770000000067C3591B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92780000000067C3591C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92790000000067C3591D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927A0000000067C3591E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927B0000000067C3591F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927C0000000067C3592000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927D0000000067C3592100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927E0000000067C3592300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927F0000000067C3592400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92800000000067C3592600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92810000000067C3592700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92820000000067C3592800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92830000000067C3592A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92840000000067C3592C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92850000000067C3592D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92860000000067C3592F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92870000000067C3593100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92880000000067C3593200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92890000000067C3593300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928A0000000067C3593400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928B0000000067C3593500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928C0000000067C3593700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928D0000000067C3593900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F928E0000000067C3593A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F928F0000000067C3593D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92900000000067C3593E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92910000000067C3594000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92920000000067C3594100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92930000000067C3594200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92940000000067C3594400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92950000000067C3594500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92960000000067C3594700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92970000000067C3594800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92980000000067C3594A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92990000000067C3594B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929A0000000067C3594C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929B0000000067C3594D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929C0000000067C3594E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929D0000000067C3594F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929E0000000067C3595000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929F0000000067C3595100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A00000000067C3595200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A10000000067C3595400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A20000000067C3595500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A30000000067C3595600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A40000000067C3595800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A50000000067C3595900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A60000000067C3595A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A70000000067C3595B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A80000000067C3595C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A90000000067C3595D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AA0000000067C3595F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AB0000000067C3596100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AC0000000067C3596200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92AD0000000067C3596300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AE0000000067C3596400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AF0000000067C3596500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B00000000067C3596700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B10000000067C3596900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92B20000000067C3596A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B30000000067C3596D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B40000000067C3596E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B50000000067C3596F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B60000000067C3597000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B70000000067C3597100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B80000000067C3597200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B90000000067C3597300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BA0000000067C3597500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BB0000000067C3597700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92BC0000000067C3597800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BD0000000067C3597900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BE0000000067C3597B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BF0000000067C3597C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C00000000067C3597D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C10000000067C3597E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92C20000000067C3597F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C30000000067C3598100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C40000000067C3598200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C50000000067C3598300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92C60000000067C3598400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C70000000067C3598600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C80000000067C3598800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C90000000067C3598900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CA0000000067C3598A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CB0000000067C3598B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CC0000000067C3598C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CD0000000067C3598D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CE0000000067C3598E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CF0000000067C3598F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D00000000067C3599000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D10000000067C3599100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D20000000067C3599200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92D30000000067C3599300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D40000000067C3599400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D50000000067C3599500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D60000000067C3599700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D70000000067C3599800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D80000000067C3599900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D90000000067C3599A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DA0000000067C3599D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DB0000000067C3599E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92DC0000000067C359A000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DD0000000067C359A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DE0000000067C359A200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DF0000000067C359A400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E00000000067C359A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E10000000067C359A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E20000000067C359A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E30000000067C359A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E40000000067C359AA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E50000000067C359AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92E60000000067C359AC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E70000000067C359AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E80000000067C359AF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E90000000067C359B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EA0000000067C359B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EB0000000067C359B300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EC0000000067C359B500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92ED0000000067C359B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EE0000000067C359B700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EF0000000067C359B800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F00000000067C359B900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F10000000067C359BA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F20000000067C359BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F30000000067C359BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F40000000067C359BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F50000000067C359C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F60000000067C359C100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F70000000067C359C200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F80000000067C359C300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F90000000067C359C500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FA0000000067C359C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FB0000000067C359C700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FC0000000067C359C900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FD0000000067C359CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FE0000000067C359CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FF0000000067C359CD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93000000000067C359CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93010000000067C359D000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93020000000067C359D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93030000000067C359D200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93040000000067C359D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93050000000067C359D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93060000000067C359D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93070000000067C359D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93080000000067C359D900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93090000000067C359DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930A0000000067C359DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930B0000000067C359DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930C0000000067C359DD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930D0000000067C359DF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930E0000000067C359E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930F0000000067C359E100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93100000000067C359E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93110000000067C359E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93120000000067C359E600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93130000000067C359E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93140000000067C359E800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93150000000067C359E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93160000000067C359EA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93170000000067C359EC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93180000000067C359EE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93190000000067C359EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931A0000000067C359F000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931B0000000067C359F100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931C0000000067C359F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931D0000000067C359F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931E0000000067C359F500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F931F0000000067C359F700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93200000000067C359F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93210000000067C359FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93220000000067C359FB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93230000000067C359FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93240000000067C359FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93250000000067C359FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93260000000067C359FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93270000000067C35A0000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93280000000067C35A0200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93290000000067C35A0300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932A0000000067C35A0500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932B0000000067C35A0800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932C0000000067C35A0900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932D0000000067C35A0A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932E0000000067C35A0B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F932F0000000067C35A0D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93300000000067C35A0F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93310000000067C35A1000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93320000000067C35A1200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93330000000067C35A1400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93340000000067C35A1500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93350000000067C35A1600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93360000000067C35A1800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93370000000067C35A1A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93380000000067C35A1B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93390000000067C35A1C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F933A0000000067C35A1D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C38000010000, valueString:0x025800000000005F90E30000000067C356F200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E40000000067C356F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E50000000067C356F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E60000000067C356F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E70000000067C356F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E80000000067C356F900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90E90000000067C356FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EA0000000067C356FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EB0000000067C356FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EC0000000067C356FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90ED0000000067C3570000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EE0000000067C3570200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90EF0000000067C3570300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F00000000067C3570400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F10000000067C3570500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F90F20000000067C3570600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F30000000067C3570700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F40000000067C3570900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F50000000067C3570A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F60000000067C3570C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F70000000067C3570D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F80000000067C3570E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90F90000000067C3570F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FA0000000067C3571000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F90FB0000000067C3571200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FC0000000067C3571300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FD0000000067C3571400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FE0000000067C3571600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F90FF0000000067C3571700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91000000000067C3571900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91010000000067C3571A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91020000000067C3571B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91030000000067C3571D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91040000000067C3571F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91050000000067C3572000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91060000000067C3572200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91070000000067C3572400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91080000000067C3572600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91090000000067C3572700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910A0000000067C3572800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910B0000000067C3572A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910C0000000067C3572C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910D0000000067C3572E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F910E0000000067C3572F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F910F0000000067C3573000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91100000000067C3573100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91110000000067C3573400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91120000000067C3573500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91130000000067C3573600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91140000000067C3573700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91150000000067C3573800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91160000000067C3573A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91170000000067C3573B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91180000000067C3573C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91190000000067C3573D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F911A0000000067C3573E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911B0000000067C3573F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911C0000000067C3574000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911D0000000067C3574100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911E0000000067C3574200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F911F0000000067C3574300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91200000000067C3574600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91210000000067C3574700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91220000000067C3574800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91230000000067C3574900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91240000000067C3574A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91250000000067C3574B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91260000000067C3574D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91270000000067C3574E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91280000000067C3575100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91290000000067C3575200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912A0000000067C3575400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912B0000000067C3575500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912C0000000067C3575600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912D0000000067C3575700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912E0000000067C3575800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F912F0000000067C3575900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91300000000067C3575B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91310000000067C3575C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91320000000067C3575D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91330000000067C3575F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91340000000067C3576000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91350000000067C3576100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91360000000067C3576300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91370000000067C3576400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91380000000067C3576500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91390000000067C3576600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913A0000000067C3576900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913B0000000067C3576A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913C0000000067C3576B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913D0000000067C3576C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913E0000000067C3576E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F913F0000000067C3577000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91400000000067C3577100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91410000000067C3577200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91420000000067C3577400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91430000000067C3577500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91440000000067C3577600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91450000000067C3577700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91460000000067C3577900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91470000000067C3577B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91480000000067C3577C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91490000000067C3577D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914A0000000067C3577F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914B0000000067C3578000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914C0000000067C3578100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914D0000000067C3578200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F914E0000000067C3578400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F914F0000000067C3578600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91500000000067C3578800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91510000000067C3578900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91520000000067C3578A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91530000000067C3578B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91540000000067C3578D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91550000000067C3578F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91560000000067C3579100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91570000000067C3579300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91580000000067C3579400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91590000000067C3579500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915A0000000067C3579600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915B0000000067C3579800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F915C0000000067C3579A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915D0000000067C3579C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915E0000000067C3579E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F915F0000000067C3579F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91600000000067C357A000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91610000000067C357A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91620000000067C357A400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91630000000067C357A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91640000000067C357A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91650000000067C357A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91660000000067C357A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91670000000067C357AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91680000000067C357AC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91690000000067C357AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916A0000000067C357AE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F916B0000000067C357B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916C0000000067C357B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916D0000000067C357B300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916E0000000067C357B400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F916F0000000067C357B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91700000000067C357B800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91710000000067C357BA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91720000000067C357BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91730000000067C357BC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91740000000067C357BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91750000000067C357BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91760000000067C357C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91770000000067C357C100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91780000000067C357C300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91790000000067C357C400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917A0000000067C357C500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917B0000000067C357C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F917C0000000067C357C800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917D0000000067C357CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917E0000000067C357CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F917F0000000067C357CD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91800000000067C357CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91810000000067C357CF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91820000000067C357D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91830000000067C357D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91840000000067C357D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91850000000067C357D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91860000000067C357D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91870000000067C357D800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91880000000067C357DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91890000000067C357DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918A0000000067C357DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918B0000000067C357DE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918C0000000067C357E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918D0000000067C357E100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918E0000000067C357E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F918F0000000067C357E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91900000000067C357E600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91910000000067C357E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91920000000067C357E800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91930000000067C357E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91940000000067C357EA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91950000000067C357EB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91960000000067C357ED00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91970000000067C357EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91980000000067C357F000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91990000000067C357F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919A0000000067C357F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F919B0000000067C357F500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919C0000000067C357F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919D0000000067C357F700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919E0000000067C357F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F919F0000000067C357FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A00000000067C357FB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A10000000067C357FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A20000000067C357FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A30000000067C357FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91A40000000067C3580100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A50000000067C3580200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A60000000067C3580300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A70000000067C3580500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A80000000067C3580700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91A90000000067C3580800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AA0000000067C3580900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AB0000000067C3580A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AC0000000067C3580B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AD0000000067C3580C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AE0000000067C3580E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91AF0000000067C3580F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B00000000067C3581000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B10000000067C3581100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B20000000067C3581200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B30000000067C3581400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B40000000067C3581600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B50000000067C3581700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B60000000067C3581800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B70000000067C3581900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B80000000067C3581B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91B90000000067C3581C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BA0000000067C3581D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91BB0000000067C3581E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BC0000000067C3582100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BD0000000067C3582200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BE0000000067C3582300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91BF0000000067C3582400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91C00000000067C3582500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C10000000067C3582600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C20000000067C3582800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C30000000067C3582A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91C40000000067C3582C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C50000000067C3582D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C60000000067C3582E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C70000000067C3582F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C80000000067C3583000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91C90000000067C3583100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CA0000000067C3583200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CB0000000067C3583300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CC0000000067C3583500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CD0000000067C3583600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CE0000000067C3583700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91CF0000000067C3583800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91D00000000067C3583A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D10000000067C3583C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D20000000067C3583E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D30000000067C3583F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D40000000067C3584000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D50000000067C3584100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D60000000067C3584200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D70000000067C3584300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91D80000000067C3584500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91D90000000067C3584700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DA0000000067C3584900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DB0000000067C3584B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DC0000000067C3584C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DD0000000067C3584D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DE0000000067C3584E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91DF0000000067C3585000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E00000000067C3585200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E10000000067C3585300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91E20000000067C3585400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E30000000067C3585500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E40000000067C3585600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E50000000067C3585800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E60000000067C3585900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E70000000067C3585A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E80000000067C3585B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91E90000000067C3585C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EA0000000067C3585D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91EB0000000067C3585F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EC0000000067C3586000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91ED0000000067C3586100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EE0000000067C3586300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91EF0000000067C3586400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F00000000067C3586600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91F10000000067C3586800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F20000000067C3586900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F30000000067C3586A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F40000000067C3586C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F50000000067C3586D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F60000000067C3586E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F70000000067C3586F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F80000000067C3587200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91F90000000067C3587300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F91FA0000000067C3587500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FB0000000067C3587700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FC0000000067C3587900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FD0000000067C3587A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FE0000000067C3587B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F91FF0000000067C3587C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92000000000067C3587D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92010000000067C3587E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92020000000067C3588000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92030000000067C3588200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92040000000067C3588400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92050000000067C3588600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92060000000067C3588700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92070000000067C3588800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92080000000067C3588900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92090000000067C3588B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920A0000000067C3588D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920B0000000067C3588E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F920C0000000067C3588F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920D0000000067C3589100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920E0000000067C3589200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F920F0000000067C3589400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92100000000067C3589600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92110000000067C3589700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92120000000067C3589800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92130000000067C3589A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92140000000067C3589B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92150000000067C3589C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92160000000067C3589E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92170000000067C3589F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92180000000067C358A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92190000000067C358A200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921A0000000067C358A300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F921B0000000067C358A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921C0000000067C358A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921D0000000067C358A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921E0000000067C358A800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F921F0000000067C358A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92200000000067C358AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92210000000067C358AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92220000000067C358AE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92230000000067C358AF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92240000000067C358B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92250000000067C358B100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92260000000067C358B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92270000000067C358B400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92280000000067C358B500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92290000000067C358B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922A0000000067C358B700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922B0000000067C358B900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922C0000000067C358BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922D0000000067C358BC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922E0000000067C358BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F922F0000000067C358BE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92300000000067C358BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92310000000067C358C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92320000000067C358C200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92330000000067C358C400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92340000000067C358C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92350000000067C358C800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92360000000067C358C900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92370000000067C358CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92380000000067C358CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92390000000067C358CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923A0000000067C358D000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923B0000000067C358D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923C0000000067C358D200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923D0000000067C358D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923E0000000067C358D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F923F0000000067C358D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92400000000067C358D600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92410000000067C358D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92420000000067C358D800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92430000000067C358D900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92440000000067C358DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92450000000067C358DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92460000000067C358DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92470000000067C358DD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92480000000067C358DE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92490000000067C358DF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924A0000000067C358E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F924B0000000067C358E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924C0000000067C358E300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924D0000000067C358E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924E0000000067C358E500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F924F0000000067C358E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92500000000067C358E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92510000000067C358EB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92520000000067C358EC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92530000000067C358ED00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92540000000067C358EE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92550000000067C358EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92560000000067C358F100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92570000000067C358F200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92580000000067C358F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92590000000067C358F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925A0000000067C358F600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925B0000000067C358F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F925C0000000067C358FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925D0000000067C358FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925E0000000067C358FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F925F0000000067C358FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92600000000067C358FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92610000000067C3590000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92620000000067C3590100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92630000000067C3590200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92640000000067C3590300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92650000000067C3590400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92660000000067C3590500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92670000000067C3590600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92680000000067C3590700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92690000000067C3590900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926A0000000067C3590B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F926B0000000067C3590C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926C0000000067C3590D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926D0000000067C3590E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926E0000000067C3591000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F926F0000000067C3591100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92700000000067C3591200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92710000000067C3591300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92720000000067C3591400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92730000000067C3591500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92740000000067C3591600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92750000000067C3591700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92760000000067C3591A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92770000000067C3591B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92780000000067C3591C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92790000000067C3591D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927A0000000067C3591E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927B0000000067C3591F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927C0000000067C3592000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927D0000000067C3592100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927E0000000067C3592300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F927F0000000067C3592400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92800000000067C3592600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92810000000067C3592700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92820000000067C3592800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92830000000067C3592A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92840000000067C3592C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92850000000067C3592D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92860000000067C3592F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92870000000067C3593100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92880000000067C3593200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92890000000067C3593300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928A0000000067C3593400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928B0000000067C3593500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928C0000000067C3593700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F928D0000000067C3593900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F928E0000000067C3593A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F928F0000000067C3593D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92900000000067C3593E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92910000000067C3594000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92920000000067C3594100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92930000000067C3594200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92940000000067C3594400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92950000000067C3594500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92960000000067C3594700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92970000000067C3594800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92980000000067C3594A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92990000000067C3594B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929A0000000067C3594C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929B0000000067C3594D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929C0000000067C3594E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929D0000000067C3594F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929E0000000067C3595000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F929F0000000067C3595100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A00000000067C3595200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A10000000067C3595400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A20000000067C3595500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A30000000067C3595600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A40000000067C3595800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A50000000067C3595900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A60000000067C3595A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A70000000067C3595B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A80000000067C3595C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92A90000000067C3595D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AA0000000067C3595F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AB0000000067C3596100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AC0000000067C3596200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92AD0000000067C3596300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AE0000000067C3596400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92AF0000000067C3596500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B00000000067C3596700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B10000000067C3596900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92B20000000067C3596A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B30000000067C3596D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B40000000067C3596E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B50000000067C3596F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B60000000067C3597000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B70000000067C3597100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B80000000067C3597200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92B90000000067C3597300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BA0000000067C3597500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BB0000000067C3597700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92BC0000000067C3597800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BD0000000067C3597900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BE0000000067C3597B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92BF0000000067C3597C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C00000000067C3597D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C10000000067C3597E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92C20000000067C3597F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C30000000067C3598100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C40000000067C3598200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C50000000067C3598300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92C60000000067C3598400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C70000000067C3598600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C80000000067C3598800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92C90000000067C3598900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CA0000000067C3598A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CB0000000067C3598B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CC0000000067C3598C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CD0000000067C3598D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CE0000000067C3598E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92CF0000000067C3598F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D00000000067C3599000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D10000000067C3599100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D20000000067C3599200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92D30000000067C3599300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D40000000067C3599400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D50000000067C3599500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D60000000067C3599700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D70000000067C3599800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D80000000067C3599900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92D90000000067C3599A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DA0000000067C3599D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DB0000000067C3599E00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92DC0000000067C359A000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DD0000000067C359A100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DE0000000067C359A200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92DF0000000067C359A400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E00000000067C359A500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E10000000067C359A600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E20000000067C359A700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E30000000067C359A900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E40000000067C359AA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E50000000067C359AB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F92E60000000067C359AC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E70000000067C359AD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E80000000067C359AF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92E90000000067C359B000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EA0000000067C359B200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EB0000000067C359B300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EC0000000067C359B500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92ED0000000067C359B600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EE0000000067C359B700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92EF0000000067C359B800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F00000000067C359B900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F10000000067C359BA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F20000000067C359BB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F30000000067C359BD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F40000000067C359BF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F50000000067C359C000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F60000000067C359C100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F70000000067C359C200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F80000000067C359C300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92F90000000067C359C500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FA0000000067C359C600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FB0000000067C359C700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FC0000000067C359C900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FD0000000067C359CA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FE0000000067C359CC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F92FF0000000067C359CD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93000000000067C359CE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93010000000067C359D000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93020000000067C359D100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93030000000067C359D200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93040000000067C359D300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93050000000067C359D400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93060000000067C359D500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93070000000067C359D700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93080000000067C359D900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93090000000067C359DA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930A0000000067C359DB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930B0000000067C359DC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930C0000000067C359DD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930D0000000067C359DF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930E0000000067C359E000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F930F0000000067C359E100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93100000000067C359E200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93110000000067C359E400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93120000000067C359E600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93130000000067C359E700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93140000000067C359E800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93150000000067C359E900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93160000000067C359EA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93170000000067C359EC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93180000000067C359EE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93190000000067C359EF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931A0000000067C359F000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931B0000000067C359F100000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931C0000000067C359F300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931D0000000067C359F400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F931E0000000067C359F500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F931F0000000067C359F700000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93200000000067C359F800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93210000000067C359FA00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93220000000067C359FB00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93230000000067C359FC00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93240000000067C359FD00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93250000000067C359FE00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93260000000067C359FF00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93270000000067C35A0000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93280000000067C35A0200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93290000000067C35A0300000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932A0000000067C35A0500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932B0000000067C35A0800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932C0000000067C35A0900000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932D0000000067C35A0A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F932E0000000067C35A0B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F932F0000000067C35A0D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93300000000067C35A0F00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800002000000000000005F93310000000067C35A1000000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93320000000067C35A1200000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93330000000067C35A1400000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93340000000067C35A1500000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93350000000067C35A1600000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93360000000067C35A1800000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93370000000067C35A1A00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93380000000067C35A1B00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F93390000000067C35A1C00000000000000000000000000000000000000000000000000000000000F42400000000001C9C3800001000000000000005F933A0000000067C35A1D00000000000000000000000000000000000000000000000000000000000F42400000000001C9C38000010000}, {name:prevStateRoot, type:bytes32, order:4, indexed:false, value:0BDB8DCB39413FC021E3155E8156D0F058B965004D417310C271173B98849A68, valueString:0BDB8DCB39413FC021E3155E8156D0F058B965004D417310C271173B98849A68}, {name:postStateRoot, type:bytes32, order:5, indexed:false, value:287C731D1150E65A64BA5DEE79F824FAD10CA88272F825F52759ADE76D926D67, valueString:287C731D1150E65A64BA5DEE79F824FAD10CA88272F825F52759ADE76D926D67}, {name:withdrawalRoot, type:bytes32, order:6, indexed:false, value:97A8A04544EF85166B037C5B8603F6FC56F780D13676D1A7728111BC3ACCB73F, valueString:97A8A04544EF85166B037C5B8603F6FC56F780D13676D1A7728111BC3ACCB73F}], batchSignatureInput=[{name:signedSequencersBitmap, type:uint256, order:1, indexed:false, value:254, valueString:254}, {name:sequencerSets, type:bytes, order:2, indexed:false, value:0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000C0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001C0000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000002C000000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC700000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC700000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC7, valueString:0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000C0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001C0000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000002C000000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC700000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC700000000000000000000000000000000000000000000000000000000000000070000000000000000000000006AB0E960911B50F6D14F249782AC12EC3E7584A0000000000000000000000000BBA36CDF020788F0D08D5688C0BEE3FB30CE1C8000000000000000000000000034E387B37D3ADEAA6D5B92CE30DE3AF3DCA39796000000000000000000000000A59B26DB10C5CA26A97AA2FD2E74CB8DA9D1EB65000000000000000000000000F834FFBEB6BB3F4841AFC6B5FB40B94CD580FA2300000000000000000000000061F2945D4BC9E40B66A6376D1094A50438F613E2000000000000000000000000B6CF39EE72E0127E6EA6059E38B8C197227A6AC7}, {name:signature, type:bytes, order:3, indexed:false, value:0x000000000000000000000000000000000A5AC07D47E64A1A2CBDDA40F65014AE85479F32D7D5831D45569F788702F5671819BF2FCA8B4B809A81045CD7B999C40000000000000000000000000000000002D46D989159695CC335D4CA17EFB7DE0EDA5400F8E14E11E2AD5C1C47D84A219D15F02583D37FE37DFC15A478F03190, valueString:0x000000000000000000000000000000000A5AC07D47E64A1A2CBDDA40F65014AE85479F32D7D5831D45569F788702F5671819BF2FCA8B4B809A81045CD7B999C40000000000000000000000000000000002D46D989159695CC335D4CA17EFB7DE0EDA5400F8E14E11E2AD5C1C47D84A219D15F02583D37FE37DFC15A478F03190}] )
TransparentUpgradeableProxy.68015791( )
-
L1Staking.isActiveStaker( addr=0x61F2945d4bc9E40B66a6376d1094a50438f613e2 ) => ( True )
-
TransparentUpgradeableProxy.d096c3c6( )
-
L1Staking.getStakerBitmap( _staker=0x61F2945d4bc9E40B66a6376d1094a50438f613e2 ) => ( bitmap=64 )
-
TransparentUpgradeableProxy.74fe27b7( )
-
L1Staking.verifySignature( 254, [0x6aB0E960911b50f6d14f249782ac12EC3E7584A0, 0xBBA36CdF020788f0D08D5688c0Bee3fb30ce1C80, 0x34E387B37d3ADEAa6D5B92cE30dE3af3DCa39796, 0xa59B26DB10C5Ca26a97AA2Fd2E74CB8DA9D1EB65, 0xf834ffbeb6bB3F4841afc6b5FB40B94cd580fa23, 0x61F2945d4bc9E40B66a6376d1094a50438f613e2, 0xb6cF39ee72e0127E6Ea6059e38B8C197227a6ac7], 0000000000000000000000000000000000000000000000000000000000000000, 0x000000000000000000000000000000000A5AC07D47E64A1A2CBDDA40F65014AE85479F32D7D5831D45569F788702F5671819BF2FCA8B4B809A81045CD7B999C40000000000000000000000000000000002D46D989159695CC335D4CA17EFB7DE0EDA5400F8E14E11E2AD5C1C47D84A219D15F02583D37FE37DFC15A478F03190 ) => ( True )
-
File 1 of 4: TransparentUpgradeableProxy
File 2 of 4: Rollup
File 3 of 4: TransparentUpgradeableProxy
File 4 of 4: L1Staking
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol) pragma solidity ^0.8.0; /** * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified * proxy whose upgrades are fully controlled by the current implementation. */ interface IERC1822Proxiable { /** * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation * address. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. */ function proxiableUUID() external view returns (bytes32); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol) pragma solidity ^0.8.0; /** * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC. * * _Available since v4.8.3._ */ interface IERC1967 { /** * @dev Emitted when the implementation is upgraded. */ event Upgraded(address indexed implementation); /** * @dev Emitted when the admin account has changed. */ event AdminChanged(address previousAdmin, address newAdmin); /** * @dev Emitted when the beacon is changed. */ event BeaconUpgraded(address indexed beacon); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol) pragma solidity ^0.8.0; /** * @dev This is the interface that {BeaconProxy} expects of its beacon. */ interface IBeacon { /** * @dev Must return an address that can be used as a delegate call target. * * {BeaconProxy} will check that this address is a contract. */ function implementation() external view returns (address); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol) pragma solidity ^0.8.0; import "../Proxy.sol"; import "./ERC1967Upgrade.sol"; /** * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an * implementation address that can be changed. This address is stored in storage in the location specified by * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the * implementation behind the proxy. */ contract ERC1967Proxy is Proxy, ERC1967Upgrade { /** * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`. * * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded * function call, and allows initializing the storage of the proxy like a Solidity constructor. */ constructor(address _logic, bytes memory _data) payable { _upgradeToAndCall(_logic, _data, false); } /** * @dev Returns the current implementation address. */ function _implementation() internal view virtual override returns (address impl) { return ERC1967Upgrade._getImplementation(); } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol) pragma solidity ^0.8.2; import "../beacon/IBeacon.sol"; import "../../interfaces/IERC1967.sol"; import "../../interfaces/draft-IERC1822.sol"; import "../../utils/Address.sol"; import "../../utils/StorageSlot.sol"; /** * @dev This abstract contract provides getters and event emitting update functions for * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots. * * _Available since v4.1._ */ abstract contract ERC1967Upgrade is IERC1967 { // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1 bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143; /** * @dev Storage slot with the address of the current implementation. * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; /** * @dev Returns the current implementation address. */ function _getImplementation() internal view returns (address) { return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; } /** * @dev Stores a new address in the EIP1967 implementation slot. */ function _setImplementation(address newImplementation) private { require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; } /** * @dev Perform implementation upgrade * * Emits an {Upgraded} event. */ function _upgradeTo(address newImplementation) internal { _setImplementation(newImplementation); emit Upgraded(newImplementation); } /** * @dev Perform implementation upgrade with additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal { _upgradeTo(newImplementation); if (data.length > 0 || forceCall) { Address.functionDelegateCall(newImplementation, data); } } /** * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal { // Upgrades from old implementations will perform a rollback test. This test requires the new // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing // this special case will break upgrade paths from old UUPS implementation to new ones. if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) { _setImplementation(newImplementation); } else { try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) { require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID"); } catch { revert("ERC1967Upgrade: new implementation is not UUPS"); } _upgradeToAndCall(newImplementation, data, forceCall); } } /** * @dev Storage slot with the admin of the contract. * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103; /** * @dev Returns the current admin. */ function _getAdmin() internal view returns (address) { return StorageSlot.getAddressSlot(_ADMIN_SLOT).value; } /** * @dev Stores a new address in the EIP1967 admin slot. */ function _setAdmin(address newAdmin) private { require(newAdmin != address(0), "ERC1967: new admin is the zero address"); StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin; } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _changeAdmin(address newAdmin) internal { emit AdminChanged(_getAdmin(), newAdmin); _setAdmin(newAdmin); } /** * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy. * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor. */ bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50; /** * @dev Returns the current beacon. */ function _getBeacon() internal view returns (address) { return StorageSlot.getAddressSlot(_BEACON_SLOT).value; } /** * @dev Stores a new beacon in the EIP1967 beacon slot. */ function _setBeacon(address newBeacon) private { require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract"); require( Address.isContract(IBeacon(newBeacon).implementation()), "ERC1967: beacon implementation is not a contract" ); StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon; } /** * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that). * * Emits a {BeaconUpgraded} event. */ function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal { _setBeacon(newBeacon); emit BeaconUpgraded(newBeacon); if (data.length > 0 || forceCall) { Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol) pragma solidity ^0.8.0; /** * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to * be specified by overriding the virtual {_implementation} function. * * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a * different contract through the {_delegate} function. * * The success and return data of the delegated call will be returned back to the caller of the proxy. */ abstract contract Proxy { /** * @dev Delegates the current call to `implementation`. * * This function does not return to its internal call site, it will return directly to the external caller. */ function _delegate(address implementation) internal virtual { assembly { // Copy msg.data. We take full control of memory in this inline assembly // block because it will not return to Solidity code. We overwrite the // Solidity scratch pad at memory position 0. calldatacopy(0, 0, calldatasize()) // Call the implementation. // out and outsize are 0 because we don't know the size yet. let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0) // Copy the returned data. returndatacopy(0, 0, returndatasize()) switch result // delegatecall returns 0 on error. case 0 { revert(0, returndatasize()) } default { return(0, returndatasize()) } } } /** * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function * and {_fallback} should delegate. */ function _implementation() internal view virtual returns (address); /** * @dev Delegates the current call to the address returned by `_implementation()`. * * This function does not return to its internal call site, it will return directly to the external caller. */ function _fallback() internal virtual { _beforeFallback(); _delegate(_implementation()); } /** * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other * function in the contract matches the call data. */ fallback() external payable virtual { _fallback(); } /** * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data * is empty. */ receive() external payable virtual { _fallback(); } /** * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback` * call, or as part of the Solidity `fallback` or `receive` functions. * * If overridden should call `super._beforeFallback()`. */ function _beforeFallback() internal virtual {} } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/transparent/TransparentUpgradeableProxy.sol) pragma solidity ^0.8.0; import "../ERC1967/ERC1967Proxy.sol"; /** * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy} * does not implement this interface directly, and some of its functions are implemented by an internal dispatch * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not * include them in the ABI so this interface must be used to interact with it. */ interface ITransparentUpgradeableProxy is IERC1967 { function admin() external view returns (address); function implementation() external view returns (address); function changeAdmin(address) external; function upgradeTo(address) external; function upgradeToAndCall(address, bytes memory) external payable; } /** * @dev This contract implements a proxy that is upgradeable by an admin. * * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector * clashing], which can potentially be used in an attack, this contract uses the * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two * things that go hand in hand: * * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if * that call matches one of the admin functions exposed by the proxy itself. * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the * implementation. If the admin tries to call a function on the implementation it will fail with an error that says * "admin cannot fallback to proxy target". * * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due * to sudden errors when trying to call a function from the proxy implementation. * * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy. * * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the * implementation. * * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised. */ contract TransparentUpgradeableProxy is ERC1967Proxy { /** * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}. */ constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) { _changeAdmin(admin_); } /** * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin. * * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the * implementation provides a function with the same selector. */ modifier ifAdmin() { if (msg.sender == _getAdmin()) { _; } else { _fallback(); } } /** * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior */ function _fallback() internal virtual override { if (msg.sender == _getAdmin()) { bytes memory ret; bytes4 selector = msg.sig; if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) { ret = _dispatchUpgradeTo(); } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) { ret = _dispatchUpgradeToAndCall(); } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) { ret = _dispatchChangeAdmin(); } else if (selector == ITransparentUpgradeableProxy.admin.selector) { ret = _dispatchAdmin(); } else if (selector == ITransparentUpgradeableProxy.implementation.selector) { ret = _dispatchImplementation(); } else { revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target"); } assembly { return(add(ret, 0x20), mload(ret)) } } else { super._fallback(); } } /** * @dev Returns the current admin. * * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103` */ function _dispatchAdmin() private returns (bytes memory) { _requireZeroValue(); address admin = _getAdmin(); return abi.encode(admin); } /** * @dev Returns the current implementation. * * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc` */ function _dispatchImplementation() private returns (bytes memory) { _requireZeroValue(); address implementation = _implementation(); return abi.encode(implementation); } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _dispatchChangeAdmin() private returns (bytes memory) { _requireZeroValue(); address newAdmin = abi.decode(msg.data[4:], (address)); _changeAdmin(newAdmin); return ""; } /** * @dev Upgrade the implementation of the proxy. */ function _dispatchUpgradeTo() private returns (bytes memory) { _requireZeroValue(); address newImplementation = abi.decode(msg.data[4:], (address)); _upgradeToAndCall(newImplementation, bytes(""), false); return ""; } /** * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the * proxied contract. */ function _dispatchUpgradeToAndCall() private returns (bytes memory) { (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes)); _upgradeToAndCall(newImplementation, data, true); return ""; } /** * @dev Returns the current admin. * * CAUTION: This function is deprecated. Use {ERC1967Upgrade-_getAdmin} instead. */ function _admin() internal view virtual returns (address) { return _getAdmin(); } /** * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to * emulate some proxy functions being non-payable while still allowing value to pass through. */ function _requireZeroValue() private { require(msg.value == 0); } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol) // This file was procedurally generated from scripts/generate/templates/StorageSlot.js. pragma solidity ^0.8.0; /** * @dev Library for reading and writing primitive types to specific storage slots. * * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts. * This library helps with reading and writing to such slots without the need for inline assembly. * * The functions in this library return Slot structs that contain a `value` member that can be used to read or write. * * Example usage to set ERC1967 implementation slot: * ```solidity * contract ERC1967 { * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; * * function _getImplementation() internal view returns (address) { * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; * } * * function _setImplementation(address newImplementation) internal { * require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` * * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._ * _Available since v4.9 for `string`, `bytes`._ */ library StorageSlot { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } struct StringSlot { string value; } struct BytesSlot { bytes value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` with member `value` located at `slot`. */ function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` representation of the string storage pointer `store`. */ function getStringSlot(string storage store) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } /** * @dev Returns an `BytesSlot` with member `value` located at `slot`. */ function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`. */ function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } }
File 2 of 4: Rollup
// SPDX-License-Identifier: MIT pragma solidity ^0.8.16; interface IL1MessageQueue { /********** * Errors * **********/ /// @dev Thrown when the given address is `address(0)`. error ErrZeroAddress(); /********** * Events * **********/ /// @notice Emitted when a new L1 => L2 transaction is appended to the queue. /// @param sender The address of account who initiates the transaction. /// @param target The address of account who will receive the transaction. /// @param value The value passed with the transaction. /// @param queueIndex The index of this transaction in the queue. /// @param gasLimit Gas limit required to complete the message relay on L2. /// @param data The calldata of the transaction. event QueueTransaction( address indexed sender, address indexed target, uint256 value, uint64 queueIndex, uint256 gasLimit, bytes data ); /// @notice Emitted when some L1 => L2 transactions are included in L1. /// @param startIndex The start index of messages popped. /// @param count The number of messages popped. event DequeueTransaction(uint256 startIndex, uint256 count); /// @notice Emitted when owner updates gas oracle contract. /// @param _oldGasOracle The address of old gas oracle contract. /// @param _newGasOracle The address of new gas oracle contract. event UpdateGasOracle(address indexed _oldGasOracle, address indexed _newGasOracle); /// @notice Emitted when owner updates EnforcedTxGateway contract. /// @param _oldGateway The address of old EnforcedTxGateway contract. /// @param _newGateway The address of new EnforcedTxGateway contract. event UpdateEnforcedTxGateway(address indexed _oldGateway, address indexed _newGateway); /// @notice Emitted when owner updates max gas limit. /// @param _oldMaxGasLimit The old max gas limit. /// @param _newMaxGasLimit The new max gas limit. event UpdateMaxGasLimit(uint256 _oldMaxGasLimit, uint256 _newMaxGasLimit); /************************* * Public View Functions * *************************/ /// @notice The start index of all pending inclusion messages. function pendingQueueIndex() external view returns (uint256); /// @notice Return the index of next appended message. /// @dev Also the total number of appended messages. function nextCrossDomainMessageIndex() external view returns (uint256); /// @notice Return the message of in `queueIndex`. /// @param queueIndex The index to query. function getCrossDomainMessage(uint256 queueIndex) external view returns (bytes32); /// @notice Return the amount of ETH should pay for cross domain message. /// @param sender The address of the message sender. /// @param gasLimit Gas limit required to complete the message relay on L2. /// @dev Estimates the fee for a cross-domain message. function estimateCrossDomainMessageFee(address sender, uint256 gasLimit) external view returns (uint256); /// @notice Return the amount of intrinsic gas fee should pay for cross domain message. /// @param _calldata The calldata of L1-initiated transaction. function calculateIntrinsicGasFee(bytes memory _calldata) external view returns (uint256); /// @notice Return the hash of a L1 message. /// @param sender The address of sender. /// @param queueIndex The queue index of this message. /// @param value The amount of Ether transfer to target. /// @param target The address of target. /// @param gasLimit The gas limit provided. /// @param data The calldata passed to target address. function computeTransactionHash( address sender, uint256 queueIndex, uint256 value, address target, uint256 gasLimit, bytes calldata data ) external view returns (bytes32); /***************************** * Public Mutating Functions * *****************************/ /// @notice Append a L1 to L2 message into this contract. /// @param target The address of target contract to call in L2. /// @param gasLimit The maximum gas should be used for relay this message in L2. /// @param data The calldata passed to target contract. function appendCrossDomainMessage(address target, uint256 gasLimit, bytes calldata data) external; /// @notice Append an enforced transaction to this contract. /// @dev The address of sender should be an EOA. /// @param sender The address of sender who will initiate this transaction in L2. /// @param target The address of target contract to call in L2. /// @param value The value passed /// @param gasLimit The maximum gas should be used for this transaction in L2. /// @param data The calldata passed to target contract. function appendEnforcedTransaction( address sender, address target, uint256 value, uint256 gasLimit, bytes calldata data ) external; /// @notice Pop finalized messages from queue. /// /// @dev We can pop at most 256 messages each time. And if the message is not skipped, /// the corresponding entry will be cleared. /// /// @param startIndex The start index to pop. /// @param count The number of messages to pop. function popCrossDomainMessage(uint256 startIndex, uint256 count) external; } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; interface IRollup { /*********** * Structs * ***********/ /// @param version The version of current batch. /// @param parentBatchHeader The header of parent batch, see the comments of `BatchHeaderV0Codec`. /// @param blockContexts The block contexts of current batch. /// @param prevStateRoot The state root of parent batch. /// @param postStateRoot The state root of current batch. /// @param withdrawalRoot The withdraw trie root of current batch. struct BatchDataInput { uint8 version; bytes parentBatchHeader; bytes blockContexts; bytes32 prevStateRoot; bytes32 postStateRoot; bytes32 withdrawalRoot; } /// @param signedSequencers The bitmap of signed sequencers /// @param sequencerSets The latest 3 sequencer sets /// @param signature The BLS signature struct BatchSignatureInput { uint256 signedSequencersBitmap; bytes sequencerSets; bytes signature; } /// @param originTimestamp /// @param finalizeTimestamp /// @param blockNumber struct BatchData { uint256 originTimestamp; uint256 finalizeTimestamp; uint256 blockNumber; uint256 signedSequencersBitmap; } /// @dev Structure to store information about a batch challenge. /// @param batchIndex The index of the challenged batch. /// @param challenger The address of the challenger. /// @param challengeDeposit The amount of deposit put up by the challenger. /// @param startTime The timestamp when the challenge started. /// @param challengeSuccess Flag indicating whether the challenge was successful. /// @param finished Flag indicating whether the challenge has been resolved. struct BatchChallenge { uint64 batchIndex; address challenger; uint256 challengeDeposit; uint256 startTime; bool challengeSuccess; bool finished; } /// @param receiver /// @param amount struct BatchChallengeReward { address receiver; uint256 amount; } /*********** * Errors * ***********/ /// @notice error zero address error ErrZeroAddress(); /********** * Events * **********/ /// @notice Emitted when a new batch is committed. /// @param batchIndex The index of the batch. /// @param batchHash The hash of the batch. event CommitBatch(uint256 indexed batchIndex, bytes32 indexed batchHash); /// @notice revert a pending batch. /// @param batchIndex The index of the batch. /// @param batchHash The hash of the batch event RevertBatch(uint256 indexed batchIndex, bytes32 indexed batchHash); /// @notice Emitted when a batch is finalized. /// @param batchIndex The index of the batch. /// @param batchHash The hash of the batch /// @param stateRoot The state root on layer 2 after this batch. /// @param withdrawRoot The merkle root on layer2 after this batch. event FinalizeBatch(uint256 indexed batchIndex, bytes32 indexed batchHash, bytes32 stateRoot, bytes32 withdrawRoot); /// @notice Emitted when owner updates the proofWindow parameter. /// @param oldWindow The old proofWindow. /// @param newWindow The new proofWindow. event UpdateProofWindow(uint256 oldWindow, uint256 newWindow); /// @notice Emitted when owner updates the finalizationPeriodSeconds parameter. /// @param oldPeriod The old finalizationPeriodSeconds. /// @param newPeriod The new finalizationPeriodSeconds. event UpdateFinalizationPeriodSeconds(uint256 oldPeriod, uint256 newPeriod); /// @notice Emitted when owner updates the status of challenger. /// @param account The address of account updated. /// @param status The status of the account updated. event UpdateChallenger(address indexed account, bool status); /// @notice Emitted when the address of rollup verifier is updated. /// @param oldVerifier The address of old rollup verifier. /// @param newVerifier The address of new rollup verifier. event UpdateVerifier(address indexed oldVerifier, address indexed newVerifier); /// @notice Emitted when the proof reward percent is updated. /// @param oldPercent The old proofRewardPercent. /// @param newPercent The new proofRewardPercent. event UpdateProofRewardPercent(uint256 oldPercent, uint256 newPercent); /// @notice Emit when prove remaining claimed. /// @param receiver receiver address. /// @param amount claimed amount. event ProveRemainingClaimed(address receiver, uint256 amount); /// @notice Emitted when the state of Challenge is updated. /// @param batchIndex The index of the batch. /// @param challenger The address of challenger. /// @param challengeDeposit The deposit of challenger. event ChallengeState(uint64 indexed batchIndex, address indexed challenger, uint256 challengeDeposit); /// @notice Emitted when the result of Challenge is updated. /// @param batchIndex The index of the batch. /// @param winner The address of winner. /// @param res The result of challenge. event ChallengeRes(uint256 indexed batchIndex, address indexed winner, string indexed res); /// @notice Emitted when the challenger claim the challenge reward. /// @param receiver receiver address /// @param amount claimed amount event ChallengeRewardClaim(address indexed receiver, uint256 amount); /************************* * Public View Functions * *************************/ /// @notice The latest finalized batch index. function lastFinalizedBatchIndex() external view returns (uint256); /// @notice The latest finalized batch index. function lastCommittedBatchIndex() external view returns (uint256); /// @notice Return the batch hash of a committed batch. /// @param batchIndex The index of the batch. function committedBatches(uint256 batchIndex) external view returns (bytes32); /// @notice Return the state root of a committed batch. /// @param batchIndex The index of the batch. function finalizedStateRoots(uint256 batchIndex) external view returns (bytes32); /// @notice Return the the committed batch of withdrawalRoot. /// @param withdrawalRoot The withdrawal root. function withdrawalRoots(bytes32 withdrawalRoot) external view returns (bool); /// @notice Return whether the batch is finalized by batch index. /// @param batchIndex The index of the batch. function isBatchFinalized(uint256 batchIndex) external view returns (bool); /// @notice Return the rollup config of finalizationPeriodSeconds. function finalizationPeriodSeconds() external view returns (uint256); /***************************** * Public Mutating Functions * *****************************/ /// @notice Commit a batch of transactions on layer 1. /// /// @param batchDataInput The BatchDataInput struct /// @param batchSignatureInput The BatchSignatureInput struct function commitBatch( BatchDataInput calldata batchDataInput, BatchSignatureInput calldata batchSignatureInput ) external payable; /// @notice Revert a pending batch. /// @dev one can only revert unfinalized batches. /// @param batchHeader The header of current batch, see the encoding in comments of `commitBatch`. /// @param count The number of subsequent batches to revert, including current batch. function revertBatch(bytes calldata batchHeader, uint256 count) external; /// @notice Claim challenge reward /// @param receiver The receiver address function claimReward(address receiver) external; } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; import {OwnableUpgradeable} from "node_modules/@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import {PausableUpgradeable} from "node_modules/@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol"; import {BatchHeaderCodecV0} from "../../libraries/codec/BatchHeaderCodecV0.sol"; import {BatchCodecV0} from "../../libraries/codec/BatchCodecV0.sol"; import {IRollupVerifier} from "../../libraries/verifier/IRollupVerifier.sol"; import {IL1MessageQueue} from "./IL1MessageQueue.sol"; import {IRollup} from "./IRollup.sol"; import {IL1Staking} from "../staking/IL1Staking.sol"; // solhint-disable no-inline-assembly // solhint-disable reason-string /// @title Rollup /// @notice This contract maintains data for the Morph rollup. contract Rollup is IRollup, OwnableUpgradeable, PausableUpgradeable { /************* * Constants * *************/ /// @notice The zero versioned hash. bytes32 internal constant ZERO_VERSIONED_HASH = 0x010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c444014; /// @notice The BLS MODULUS. Deprecated. uint256 internal constant __BLS_MODULUS = 52435875175126190479447740508185965837690552500527637822603658699938581184513; /// @dev Address of the point evaluation precompile used for EIP-4844 blob verification. address internal constant POINT_EVALUATION_PRECOMPILE_ADDR = address(0x0A); /// @notice The chain id of the corresponding layer 2 chain. uint64 public immutable LAYER_2_CHAIN_ID; /************* * Variables * *************/ /// @notice L1 staking contract address public l1StakingContract; /// @notice Batch challenge time. uint256 public finalizationPeriodSeconds; /// @notice The time when zkProof was generated and executed. uint256 public proofWindow; /// @notice The maximum number of transactions allowed in each chunk. Deprecated. uint256 public __maxNumTxInChunk; /// @notice The address of L1MessageQueue. address public messageQueue; /// @notice The address of RollupVerifier. address public verifier; /// @inheritdoc IRollup uint256 public override lastFinalizedBatchIndex; /// @inheritdoc IRollup uint256 public override lastCommittedBatchIndex; /// @notice Whether an account is a challenger. mapping(address challengerAddress => bool isChallenger) public isChallenger; /// @inheritdoc IRollup mapping(uint256 batchIndex => bytes32 stateRoot) public override finalizedStateRoots; /// @notice Store committed batch hash. mapping(uint256 batchIndex => bytes32 batchHash) public override committedBatches; /// @notice Store committed batch base. mapping(uint256 batchIndex => BatchData) public batchDataStore; /// @notice Store the withdrawalRoot. mapping(bytes32 withdrawalRoot => bool exist) public withdrawalRoots; /// @notice Store Challenge Information. mapping(uint256 batchIndex => BatchChallenge) public challenges; /// @notice Store Challenge reward information. mapping(address owner => uint256 amount) public batchChallengeReward; /// @notice Whether in challenge bool public inChallenge; /// @notice The batch being challenged uint256 public batchChallenged; /// @notice The index of the revert request. uint256 public revertReqIndex; /// @notice percentage awarded to prover uint256 public proofRewardPercent; /// @notice prove remaining uint256 public proveRemaining; /// @notice committedStateRoots mapping(uint256 batchIndex => bytes32 stateRoot) public committedStateRoots; /********************** * Function Modifiers * **********************/ /// @notice Only active staker allowed. modifier onlyActiveStaker() { require(IL1Staking(l1StakingContract).isActiveStaker(_msgSender()), "only active staker allowed"); _; } /// @notice Only challenger allowed. modifier onlyChallenger() { require(isChallenger[_msgSender()], "caller challenger allowed"); _; } /// @notice Modifier to ensure that there is no pending revert request. modifier nonReqRevert() { require(revertReqIndex == 0, "need revert"); _; } /*************** * Constructor * ***************/ /// @notice constructor /// @param _chainID The chain ID constructor(uint64 _chainID) { LAYER_2_CHAIN_ID = _chainID; _disableInitializers(); } /// @notice Allow the contract to receive ETH. receive() external payable {} /*************** * Initializer * ***************/ /// @notice initializer /// @param _l1StakingContract l1 staking contract /// @param _messageQueue message queue /// @param _verifier verifier /// @param _finalizationPeriodSeconds finalization period seconds /// @param _proofWindow proof window function initialize( address _l1StakingContract, address _messageQueue, address _verifier, uint256 _finalizationPeriodSeconds, uint256 _proofWindow, uint256 _proofRewardPercent ) public initializer { if (_messageQueue == address(0) || _verifier == address(0)) { revert ErrZeroAddress(); } require(_l1StakingContract != address(0), "invalid l1 staking contract"); __Pausable_init(); __Ownable_init(); l1StakingContract = _l1StakingContract; messageQueue = _messageQueue; verifier = _verifier; finalizationPeriodSeconds = _finalizationPeriodSeconds; proofWindow = _proofWindow; proofRewardPercent = _proofRewardPercent; emit UpdateVerifier(address(0), _verifier); emit UpdateFinalizationPeriodSeconds(0, _finalizationPeriodSeconds); emit UpdateProofWindow(0, _proofWindow); emit UpdateProofRewardPercent(0, _proofRewardPercent); } function initialize2(bytes32 _prevStateRoot) external reinitializer(2) { require(_getInitializedVersion() == 2, "must have initialized!"); require(_prevStateRoot != bytes32(0), "can not set state root with bytes32(0)!"); if (committedStateRoots[lastCommittedBatchIndex] == bytes32(0)) { committedStateRoots[lastCommittedBatchIndex] = _prevStateRoot; } } /************************ * Restricted Functions * ************************/ /// @notice Import layer 2 genesis block function importGenesisBatch(bytes calldata _batchHeader) external onlyOwner { // check whether the genesis batch is imported require(finalizedStateRoots[0] == bytes32(0), "genesis batch imported"); (uint256 memPtr, bytes32 _batchHash) = _loadBatchHeader(_batchHeader); uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(memPtr); // check batch index is 0 require(_batchIndex == 0, "invalid batch index"); bytes32 _postStateRoot = BatchHeaderCodecV0.getPostStateHash(memPtr); require(_postStateRoot != bytes32(0), "zero state root"); // check all fields except `dataHash` and `lastBlockHash` are zero require(BatchHeaderCodecV0.getL1MessagePopped(memPtr) == 0, "l1 message popped should be 0"); require(BatchHeaderCodecV0.getDataHash(memPtr) != bytes32(0), "zero data hash"); require(BatchHeaderCodecV0.getBlobVersionedHash(memPtr) == ZERO_VERSIONED_HASH, "invalid versioned hash"); committedBatches[_batchIndex] = _batchHash; batchDataStore[_batchIndex] = BatchData(block.timestamp, block.timestamp, 0, 0); committedStateRoots[_batchIndex] = _postStateRoot; finalizedStateRoots[_batchIndex] = _postStateRoot; lastCommittedBatchIndex = _batchIndex; lastFinalizedBatchIndex = _batchIndex; emit CommitBatch(_batchIndex, _batchHash); emit FinalizeBatch(_batchIndex, _batchHash, _postStateRoot, bytes32(0)); } /// @inheritdoc IRollup function commitBatch( BatchDataInput calldata batchDataInput, BatchSignatureInput calldata batchSignatureInput ) external payable override onlyActiveStaker nonReqRevert whenNotPaused { require(batchDataInput.version == 0, "invalid version"); // check whether the batch is empty uint256 _blockContextsLength = batchDataInput.blockContexts.length; require(_blockContextsLength > 0, "batch is empty"); require(batchDataInput.prevStateRoot != bytes32(0), "previous state root is zero"); require(batchDataInput.postStateRoot != bytes32(0), "new state root is zero"); // The overall memory layout in this function is organized as follows // +---------------------+-------------------+------------------+ // | parent batch header | batch data hashes | new batch header | // +---------------------+-------------------+------------------+ // ^ ^ ^ // batchPtr dataPtr newBatchPtr (re-use var batchPtr) // // 1. We copy the parent batch header from calldata to memory starting at batchPtr // 2. we store the batch data hash // 3. The memory starting at `newBatchPtr` is used to store the new batch header and compute // the batch hash. // the variable `batchPtr` will be reused later for the current batch (uint256 _batchPtr, bytes32 _parentBatchHash) = _loadBatchHeader(batchDataInput.parentBatchHeader); uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(_batchPtr); require(committedBatches[_batchIndex + 1] == bytes32(0), "batch already committed"); require(_batchIndex == lastCommittedBatchIndex, "incorrect batch index"); require(committedBatches[_batchIndex] == _parentBatchHash, "incorrect parent batch hash"); require(committedStateRoots[_batchIndex] == batchDataInput.prevStateRoot, "incorrect previous state root"); uint256 _totalL1MessagesPoppedOverall = BatchHeaderCodecV0.getTotalL1MessagePopped(_batchPtr); // compute the data hash for batch uint256 _totalL1MessagesPoppedInBatch; uint256 _totalNumL1Messages; bytes32 dataHash; (dataHash, _totalNumL1Messages) = _commitBatch( batchDataInput.blockContexts, _totalL1MessagesPoppedInBatch, _totalL1MessagesPoppedOverall ); unchecked { _totalL1MessagesPoppedInBatch += _totalNumL1Messages; _totalL1MessagesPoppedOverall += _totalNumL1Messages; } assembly { _batchIndex := add(_batchIndex, 1) // increase batch index } bytes32 _blobVersionedHash = (blobhash(0) == bytes32(0)) ? ZERO_VERSIONED_HASH : blobhash(0); { uint256 _headerLength = BatchHeaderCodecV0.BATCH_HEADER_LENGTH; assembly { _batchPtr := mload(0x40) mstore(0x40, add(_batchPtr, mul(_headerLength, 32))) } // store entries, the order matters BatchHeaderCodecV0.storeVersion(_batchPtr, batchDataInput.version); BatchHeaderCodecV0.storeBatchIndex(_batchPtr, _batchIndex); BatchHeaderCodecV0.storeL1MessagePopped(_batchPtr, _totalL1MessagesPoppedInBatch); BatchHeaderCodecV0.storeTotalL1MessagePopped(_batchPtr, _totalL1MessagesPoppedOverall); BatchHeaderCodecV0.storeDataHash(_batchPtr, dataHash); BatchHeaderCodecV0.storePrevStateHash(_batchPtr, batchDataInput.prevStateRoot); BatchHeaderCodecV0.storePostStateHash(_batchPtr, batchDataInput.postStateRoot); BatchHeaderCodecV0.storeWithdrawRootHash(_batchPtr, batchDataInput.withdrawalRoot); BatchHeaderCodecV0.storeSequencerSetVerifyHash(_batchPtr, keccak256(batchSignatureInput.sequencerSets)); BatchHeaderCodecV0.storeParentBatchHash(_batchPtr, _parentBatchHash); BatchHeaderCodecV0.storeBlobVersionedHash(_batchPtr, _blobVersionedHash); committedBatches[_batchIndex] = BatchHeaderCodecV0.computeBatchHash(_batchPtr, _headerLength); committedStateRoots[_batchIndex] = batchDataInput.postStateRoot; uint256 proveRemainingTime = 0; if (inChallenge) { // Make the batch finalize time longer than the time required for the current challenge proveRemainingTime = proofWindow + challenges[batchChallenged].startTime - block.timestamp; } // storage batch data for challenge status check batchDataStore[_batchIndex] = BatchData( block.timestamp, block.timestamp + finalizationPeriodSeconds + proveRemainingTime, _loadL2BlockNumber(batchDataInput.blockContexts), // Before BLS is implemented, the accuracy of the sequencer set uploaded by rollup cannot be guaranteed. // Therefore, if the batch is successfully challenged, only the submitter will be punished. IL1Staking(l1StakingContract).getStakerBitmap(_msgSender()) // => batchSignature.signedSequencersBitmap ); lastCommittedBatchIndex = _batchIndex; } // verify bls signature require( IL1Staking(l1StakingContract).verifySignature( batchSignatureInput.signedSequencersBitmap, _getValidSequencerSet(batchSignatureInput.sequencerSets, 0), _getBLSMsgHash(batchDataInput), batchSignatureInput.signature ), "the signature verification failed" ); emit CommitBatch(_batchIndex, committedBatches[_batchIndex]); } /// @inheritdoc IRollup /// @dev If the owner wants to revert a sequence of batches by sending multiple transactions, /// make sure to revert recent batches first. function revertBatch(bytes calldata _batchHeader, uint256 _count) external onlyOwner { require(_count > 0, "count must be nonzero"); (uint256 memPtr, bytes32 _batchHash) = _loadBatchHeader(_batchHeader); // check batch hash uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(memPtr); require(committedBatches[_batchIndex] == _batchHash, "incorrect batch hash"); // make sure no gap is left when reverting from the ending to the beginning. require(committedBatches[_batchIndex + _count] == bytes32(0), "reverting must start from the ending"); // check finalization require(_batchIndex > lastFinalizedBatchIndex, "can only revert unFinalized batch"); lastCommittedBatchIndex = _batchIndex - 1; while (_count > 0) { emit RevertBatch(_batchIndex, _batchHash); committedBatches[_batchIndex] = bytes32(0); // if challenge exist and not finished yet, return challenge deposit to challenger if (batchInChallenge(_batchIndex)) { batchChallengeReward[challenges[_batchIndex].challenger] += challenges[_batchIndex].challengeDeposit; inChallenge = false; } delete challenges[_batchIndex]; if (revertReqIndex > 0 && _batchIndex == revertReqIndex) { revertReqIndex = 0; } unchecked { _batchIndex += 1; _count -= 1; } _batchHash = committedBatches[_batchIndex]; if (_batchHash == bytes32(0)) { break; } } } /// @dev challengeState challenges a batch by submitting a deposit. function challengeState( uint64 batchIndex, bytes32 _batchHash ) external payable onlyChallenger nonReqRevert whenNotPaused { require(!inChallenge, "already in challenge"); require(lastFinalizedBatchIndex < batchIndex, "batch already finalized"); require(committedBatches[batchIndex] == _batchHash, "incorrect batch hash"); require(batchExist(batchIndex), "batch not exist"); require(challenges[batchIndex].challenger == address(0), "batch already challenged"); // check challenge window require(batchInsideChallengeWindow(batchIndex), "cannot challenge batch outside the challenge window"); // check challenge amount require(msg.value >= IL1Staking(l1StakingContract).challengeDeposit(), "insufficient value"); batchChallenged = batchIndex; challenges[batchIndex] = BatchChallenge(batchIndex, _msgSender(), msg.value, block.timestamp, false, false); emit ChallengeState(batchIndex, _msgSender(), msg.value); for (uint256 i = lastFinalizedBatchIndex + 1; i <= lastCommittedBatchIndex; i++) { if (i != batchIndex) { batchDataStore[i].finalizeTimestamp += proofWindow; } } inChallenge = true; } /// @notice Update proofWindow. /// @param _newWindow New proof window. function updateProofWindow(uint256 _newWindow) external onlyOwner { require(_newWindow > 0 && _newWindow != proofWindow, "invalid new proof window"); uint256 _oldProofWindow = proofWindow; proofWindow = _newWindow; emit UpdateProofWindow(_oldProofWindow, proofWindow); } /// @notice Update finalizationPeriodSeconds. /// @param _newPeriod New finalize period seconds. function updateFinalizePeriodSeconds(uint256 _newPeriod) external onlyOwner { require(_newPeriod > 0 && _newPeriod != finalizationPeriodSeconds, "invalid new finalize period"); uint256 _oldFinalizationPeriodSeconds = finalizationPeriodSeconds; finalizationPeriodSeconds = _newPeriod; emit UpdateFinalizationPeriodSeconds(_oldFinalizationPeriodSeconds, finalizationPeriodSeconds); } /// @notice Add an account to the challenger list. /// @param _account The address of account to add. function addChallenger(address _account) external onlyOwner { require(!isChallenger[_account], "account is already a challenger"); isChallenger[_account] = true; emit UpdateChallenger(_account, true); } /// @notice Remove an account from the challenger list. /// @param _account The address of account to remove. function removeChallenger(address _account) external onlyOwner { require(isChallenger[_account], "account is not a challenger"); isChallenger[_account] = false; emit UpdateChallenger(_account, false); } /// @notice Update the address verifier contract. /// @param _newVerifier The address of new verifier contract. function updateVerifier(address _newVerifier) external onlyOwner { require(_newVerifier != address(0) && _newVerifier != verifier, "invalid new verifier"); address _oldVerifier = verifier; verifier = _newVerifier; emit UpdateVerifier(_oldVerifier, _newVerifier); } /// @notice Update proof reward percentage /// @param _newProofRewardPercent Percentage awarded to prover function updateRewardPercentage(uint256 _newProofRewardPercent) external onlyOwner { require( _newProofRewardPercent > 0 && _newProofRewardPercent <= 100 && _newProofRewardPercent != proofRewardPercent, "invalid proof reward percentage" ); uint256 _oldRewardPercentage = proofRewardPercent; proofRewardPercent = _newProofRewardPercent; emit UpdateProofRewardPercent(_oldRewardPercentage, _newProofRewardPercent); } /// @notice claim prove remaining /// @param receiver receiver address function claimProveRemaining(address receiver) external onlyOwner { uint256 _proveRemaining = proveRemaining; proveRemaining = 0; _transfer(receiver, _proveRemaining); emit ProveRemainingClaimed(receiver, _proveRemaining); } /// @notice Pause the contract /// @param _status The pause status to update. function setPause(bool _status) external onlyOwner { if (_status) { _pause(); // if challenge exist and not finished yet, return challenge deposit to challenger if (inChallenge) { batchChallengeReward[challenges[batchChallenged].challenger] += challenges[batchChallenged] .challengeDeposit; delete challenges[batchChallenged]; inChallenge = false; } emit Paused(_msgSender()); } else { _unpause(); emit Unpaused(_msgSender()); } } /***************************** * Public Mutating Functions * *****************************/ /// @dev proveState proves a batch by submitting a proof. function proveState(bytes calldata _batchHeader, bytes calldata _batchProof) external nonReqRevert whenNotPaused { // get batch data from batch header (uint256 memPtr, bytes32 _batchHash) = _loadBatchHeader(_batchHeader); // check batch hash uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(memPtr); require(committedBatches[_batchIndex] == _batchHash, "incorrect batch hash"); // Ensure challenge exists and is not finished require(batchInChallenge(_batchIndex), "batch in challenge"); // Mark challenge as finished challenges[_batchIndex].finished = true; inChallenge = false; // Check for timeout if (challenges[_batchIndex].startTime + proofWindow <= block.timestamp) { // set status challenges[_batchIndex].challengeSuccess = true; _challengerWin(_batchIndex, batchDataStore[_batchIndex].signedSequencersBitmap, "Timeout"); } else { _verifyProof(memPtr, _batchProof); // Record defender win _defenderWin(_batchIndex, _msgSender(), "Proof success"); } } /// @dev finalize batch function finalizeBatch(bytes calldata _batchHeader) public nonReqRevert whenNotPaused { // get batch data from batch header (uint256 memPtr, bytes32 _batchHash) = _loadBatchHeader(_batchHeader); uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(memPtr); require(committedBatches[_batchIndex] == _batchHash, "incorrect batch hash"); require(batchExist(_batchIndex), "batch not exist"); require(!batchInChallenge(_batchIndex), "batch in challenge"); require(!batchChallengedSuccess(_batchIndex), "batch should be revert"); require(!batchInsideChallengeWindow(_batchIndex), "batch in challenge window"); // verify previous state root. require( finalizedStateRoots[_batchIndex - 1] == BatchHeaderCodecV0.getPrevStateHash(memPtr), "incorrect previous state root" ); // avoid duplicated verification require(finalizedStateRoots[_batchIndex] == bytes32(0), "batch already verified"); // check and update lastFinalizedBatchIndex unchecked { require(lastFinalizedBatchIndex + 1 == _batchIndex, "incorrect batch index"); lastFinalizedBatchIndex = _batchIndex; } // record state root and withdraw root withdrawalRoots[BatchHeaderCodecV0.getWithdrawRootHash(memPtr)] = true; finalizedStateRoots[_batchIndex] = BatchHeaderCodecV0.getPostStateHash(memPtr); // Pop finalized and non-skipped message from L1MessageQueue. _popL1Messages( BatchHeaderCodecV0.getTotalL1MessagePopped(memPtr), BatchHeaderCodecV0.getL1MessagePopped(memPtr) ); delete batchDataStore[_batchIndex - 1]; delete committedStateRoots[_batchIndex - 1]; delete challenges[_batchIndex - 1]; emit FinalizeBatch( _batchIndex, committedBatches[_batchIndex], BatchHeaderCodecV0.getPostStateHash(memPtr), BatchHeaderCodecV0.getWithdrawRootHash(memPtr) ); } /// @notice Claim challenge reward /// @param receiver The receiver address function claimReward(address receiver) external { uint256 amount = batchChallengeReward[_msgSender()]; require(amount != 0, "invalid batchChallengeReward"); delete batchChallengeReward[_msgSender()]; _transfer(receiver, amount); emit ChallengeRewardClaim(receiver, amount); } /************************* * Public View Functions * *************************/ /// @inheritdoc IRollup function isBatchFinalized(uint256 _batchIndex) external view override returns (bool) { return _batchIndex <= lastFinalizedBatchIndex; } /// @dev Public function to checks whether the batch is in challenge. /// @param batchIndex The index of the batch to be checked. function batchInChallenge(uint256 batchIndex) public view returns (bool) { return challenges[batchIndex].challenger != address(0) && !challenges[batchIndex].finished; } /// @dev Retrieves the success status of a batch challenge. /// @param batchIndex The index of the batch to check. function batchChallengedSuccess(uint256 batchIndex) public view returns (bool) { return challenges[batchIndex].challengeSuccess; } /// @dev Public function to checks whether batch exists. /// @param batchIndex The index of the batch to be checked. function batchExist(uint256 batchIndex) public view returns (bool) { return batchDataStore[batchIndex].originTimestamp > 0 && committedBatches[batchIndex] != bytes32(0); } /// @dev Public function to checks whether the batch is in challengeWindow. /// @param batchIndex The index of the batch to be checked. function batchInsideChallengeWindow(uint256 batchIndex) public view returns (bool) { return batchDataStore[batchIndex].finalizeTimestamp > block.timestamp; } /********************** * Internal Functions * **********************/ /// @dev Internal function to pop finalized l1 messages. /// @param totalL1MessagePopped The total number of L1 messages popped in all batches including current batch. /// @param l1MessagePopped The number of L1 messages popped in current batch. function _popL1Messages(uint256 totalL1MessagePopped, uint256 l1MessagePopped) internal { if (l1MessagePopped == 0) return; unchecked { uint256 startIndex = totalL1MessagePopped - l1MessagePopped; for (uint256 i = 0; i < l1MessagePopped; i += 256) { uint256 _count = 256; if (l1MessagePopped - i < _count) { _count = l1MessagePopped - i; } IL1MessageQueue(messageQueue).popCrossDomainMessage(startIndex, _count); startIndex += 256; } } } /// @dev Internal function to verify the zk proof. function _verifyProof(uint256 memPtr, bytes calldata _batchProof) private view { // Check validity of proof require(_batchProof.length > 0, "Invalid batch proof"); uint256 _batchIndex = BatchHeaderCodecV0.getBatchIndex(memPtr); bytes32 _blobVersionedHash = BatchHeaderCodecV0.getBlobVersionedHash(memPtr); bytes32 _publicInputHash = keccak256( abi.encodePacked( LAYER_2_CHAIN_ID, BatchHeaderCodecV0.getPrevStateHash(memPtr), BatchHeaderCodecV0.getPostStateHash(memPtr), BatchHeaderCodecV0.getWithdrawRootHash(memPtr), BatchHeaderCodecV0.getSequencerSetVerifyHash(memPtr), BatchHeaderCodecV0.getDataHash(memPtr), _blobVersionedHash ) ); IRollupVerifier(verifier).verifyAggregateProof( BatchHeaderCodecV0.getVersion(memPtr), _batchIndex, _batchProof, _publicInputHash ); } /// @dev Internal function to compute BLS msg hash function _getBLSMsgHash( BatchDataInput calldata // batchDataInput ) internal pure returns (bytes32) { // TODO compute bls message hash return bytes32(0); } /// @dev todo function _getValidSequencerSet( bytes calldata sequencerSets, uint256 blockHeight ) internal pure returns (address[] memory) { // TODO require submitter was in valid sequencer set after BLS was implemented ( , address[] memory sequencerSet0, uint256 blockHeight1, address[] memory sequencerSet1, uint256 blockHeight2, address[] memory sequencerSet2 ) = abi.decode(sequencerSets, (uint256, address[], uint256, address[], uint256, address[])); if (blockHeight >= blockHeight2) { return sequencerSet2; } if (blockHeight >= blockHeight1) { return sequencerSet1; } return sequencerSet0; } /// @dev Internal function executed when the defender wins. /// @param batchIndex The index of the batch indicating where the challenge occurred. /// @param prover The zkProof prover address. /// @param _type Description of the challenge type. function _defenderWin(uint256 batchIndex, address prover, string memory _type) internal { uint256 challengeDeposit = challenges[batchIndex].challengeDeposit; uint256 reward = (challengeDeposit * proofRewardPercent) / 100; proveRemaining += challengeDeposit - reward; batchChallengeReward[prover] += reward; emit ChallengeRes(batchIndex, prover, _type); } /// @dev Internal function executed when the challenger wins. /// @param batchIndex The index of the batch indicating where the challenge occurred. /// @param sequencersBitmap An array containing the sequencers to be slashed. /// @param _type Description of the challenge type. function _challengerWin(uint256 batchIndex, uint256 sequencersBitmap, string memory _type) internal { revertReqIndex = batchIndex; address challenger = challenges[batchIndex].challenger; uint256 reward = IL1Staking(l1StakingContract).slash(sequencersBitmap); batchChallengeReward[challenges[batchIndex].challenger] += (challenges[batchIndex].challengeDeposit + reward); emit ChallengeRes(batchIndex, challenger, _type); } /// @dev Internal function to transfer ETH to a specified address. /// @param _to The address to transfer ETH to. /// @param _amount The amount of ETH to transfer. function _transfer(address _to, uint256 _amount) internal { if (_amount > 0) { (bool success, ) = _to.call{value: _amount}(""); require(success, "Rollup: ETH transfer failed"); } } /// @dev Internal function to load batch header from calldata to memory. /// @param _batchHeader The batch header in calldata. /// @return _memPtr The start memory offset of loaded batch header. /// @return _batchHash The hash of the loaded batch header. function _loadBatchHeader(bytes calldata _batchHeader) internal pure returns (uint256 _memPtr, bytes32 _batchHash) { // load to memory uint256 _length; (_memPtr, _length) = BatchHeaderCodecV0.loadAndValidate(_batchHeader); // compute batch hash _batchHash = BatchHeaderCodecV0.computeBatchHash(_memPtr, _length); } /// @dev Internal function to load the latestL2BlockNumber. /// @param _blockContexts The batch block contexts in memory. function _loadL2BlockNumber(bytes memory _blockContexts) internal pure returns (uint256) { uint256 blockPtr; uint256 batchPtr; assembly { batchPtr := add(_blockContexts, 0x20) blockPtr := add(batchPtr, 2) } uint256 _numBlocks = BatchCodecV0.validateBatchLength(batchPtr, _blockContexts.length); for (uint256 i = 0; i < _numBlocks - 1; i++) { unchecked { blockPtr += BatchCodecV0.BLOCK_CONTEXT_LENGTH; } } uint256 l2BlockNumber = BatchCodecV0.getBlockNumber(blockPtr); return l2BlockNumber; } /// @dev Internal function to commit a batch with version 0. /// @param _blockContexts The encoded block contexts to commit. /// @param _totalL1MessagesPoppedInBatch The total number of L1 messages popped in current batch. /// @param _totalL1MessagesPoppedOverall The total number of L1 messages popped in all batches including current batch. /// @return _dataHash The computed data hash for this batch. /// @return _totalNumL1MessagesInBatch The total number of L1 message popped in current batch function _commitBatch( bytes memory _blockContexts, uint256 _totalL1MessagesPoppedInBatch, uint256 _totalL1MessagesPoppedOverall ) internal view returns (bytes32 _dataHash, uint256 _totalNumL1MessagesInBatch) { uint256 batchPtr; uint256 startDataPtr; uint256 dataPtr; assembly { dataPtr := mload(0x40) startDataPtr := dataPtr batchPtr := add(_blockContexts, 0x20) // skip batchContexts.length } uint256 _numBlocks = BatchCodecV0.validateBatchLength(batchPtr, _blockContexts.length); assembly { batchPtr := add(batchPtr, 2) // skip numBlocks } // concatenate block contexts, use scope to avoid stack too deep for (uint256 i = 0; i < _numBlocks; i++) { dataPtr = BatchCodecV0.copyBlockContext(batchPtr, dataPtr, i); uint256 blockPtr = batchPtr + i * BatchCodecV0.BLOCK_CONTEXT_LENGTH; uint256 _numL1MessagesInBlock = BatchCodecV0.getNumL1Messages(blockPtr); unchecked { _totalNumL1MessagesInBatch += _numL1MessagesInBlock; } } assembly { mstore(0x40, add(dataPtr, mul(_totalNumL1MessagesInBatch, 0x20))) // reserve memory for l1 message hashes } // concatenate tx hashes while (_numBlocks > 0) { // concatenate l1 message hashes uint256 _numL1MessagesInBlock = BatchCodecV0.getNumL1Messages(batchPtr); dataPtr = _loadL1MessageHashes( dataPtr, _numL1MessagesInBlock, _totalL1MessagesPoppedInBatch, _totalL1MessagesPoppedOverall ); uint256 _numTransactionsInBlock = BatchCodecV0.getNumTransactions(batchPtr); require(_numTransactionsInBlock >= _numL1MessagesInBlock, "num txs less than num L1 msgs"); unchecked { _totalL1MessagesPoppedInBatch += _numL1MessagesInBlock; _totalL1MessagesPoppedOverall += _numL1MessagesInBlock; _numBlocks -= 1; batchPtr += BatchCodecV0.BLOCK_CONTEXT_LENGTH; } } // compute data hash and store to memory assembly { _dataHash := keccak256(startDataPtr, sub(dataPtr, startDataPtr)) } } /// @dev Internal function to load L1 message hashes from the message queue. /// @param _ptr The memory offset to store the transaction hash. /// @param _numL1Messages The number of L1 messages to load. /// @param _totalL1MessagesPoppedInBatch The total number of L1 messages popped in current batch. /// @param _totalL1MessagesPoppedOverall The total number of L1 messages popped in all batches including current batch. /// @return uint256 The new memory offset after loading. function _loadL1MessageHashes( uint256 _ptr, uint256 _numL1Messages, uint256 _totalL1MessagesPoppedInBatch, uint256 _totalL1MessagesPoppedOverall ) internal view returns (uint256) { if (_numL1Messages == 0) { return _ptr; } IL1MessageQueue _messageQueue = IL1MessageQueue(messageQueue); unchecked { for (uint256 i = 0; i < _numL1Messages; i++) { bytes32 _hash = _messageQueue.getCrossDomainMessage(_totalL1MessagesPoppedOverall); assembly { mstore(_ptr, _hash) _ptr := add(_ptr, 0x20) } _totalL1MessagesPoppedInBatch += 1; _totalL1MessagesPoppedOverall += 1; } } return _ptr; } } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; interface IL1Staking { /********** * Events * **********/ /// @notice staker registered /// @param addr staker address /// @param tmKey tendermint pubkey /// @param blsKey BLS pubkey event Registered(address addr, bytes32 tmKey, bytes blsKey); /// @notice stakers removed /// @param stakers stakers removed event StakersRemoved(address[] stakers); /// @notice Withdrawn /// @param addr staker address /// @param unlockHeight unlock block height event Withdrawn(address indexed addr, uint256 unlockHeight); /// @notice staker claimed /// @param staker staker claimed /// @param receiver receiver address event Claimed(address indexed staker, address receiver); /// @notice stakers were slashed /// @param stakers slashed stakers event Slashed(address[] stakers); /// @notice slash remaining claimed /// @param receiver receiver address /// @param amount claimed amount event SlashRemainingClaimed(address receiver, uint256 amount); /// @notice whitelist updated /// @param add addresses added /// @param remove addresses removed event WhitelistUpdated(address[] add, address[] remove); /// @notice staking value updated /// @param oldStakingValue old staking value /// @param newStakingValue new staking value event StakingValueUpdated(uint256 oldStakingValue, uint256 newStakingValue); /// @notice gas limit add staker updated /// @param oldGasLimit old gas limit /// @param newGasLimit new gas limit event GasLimitAddStakerUpdated(uint256 oldGasLimit, uint256 newGasLimit); /// @notice gas limit remove stakers updated /// @param oldGasLimit old gas limit /// @param newGasLimit new gas limit event GasLimitRemoveStakersUpdated(uint256 oldGasLimit, uint256 newGasLimit); /// @notice reward percentage updated /// @param oldPercentage old percentage /// @param newPercentage new percentage event RewardPercentageUpdated(uint256 oldPercentage, uint256 newPercentage); /// @notice challenge deposit value updated /// @param oldChallengeDeposit old challengeDeposit /// @param newChallengeDeposit new challengeDeposit event ChallengeDepositUpdated(uint256 oldChallengeDeposit, uint256 newChallengeDeposit); /************************* * Public View Functions * *************************/ /// @notice return all stakers function getStakers() external view returns (address[255] memory); /// @notice return active stakers function getActiveStakers() external view returns (address[] memory); /// @notice return staking value function stakingValue() external view returns (uint256); /// @notice return challenge deposit value function challengeDeposit() external view returns (uint256); /// @notice whether address is staker /// @param addr the address to check function isStaker(address addr) external view returns (bool); /// @notice whether address is active staker /// @param addr the address to check function isActiveStaker(address addr) external view returns (bool); /// @notice get staker bitmap /// @param staker the staker address function getStakerBitmap(address staker) external view returns (uint256); /// @notice get stakers bitmap /// @param stakers the staker address array function getStakersBitmap(address[] calldata stakers) external view returns (uint256); /// @notice verify BLS signature /// @param signedSequencersBitmap bitmap of signed sequencers /// @param sequencerSet sequencer set /// @param msgHash bls message hash /// @param signature batch signature function verifySignature( uint256 signedSequencersBitmap, address[] calldata sequencerSet, bytes32 msgHash, bytes calldata signature ) external view returns (bool); /***************************** * Public Mutating Functions * *****************************/ /// @notice challenger win, slash sequencers /// @param sequencersBitmap the sequencers to slash function slash(uint256 sequencersBitmap) external returns (uint256); } // SPDX-License-Identifier: MIT pragma solidity ^0.8.16; /* solhint-disable */ /// @dev Below is the encoding for `Batch`, total 60*n+1 bytes. /// ```text /// * Field Bytes Type Index Comments /// * numBlocks 2 uint16 0 The number of blocks in this batch /// * block[0] 60 BlockContext 1 The first block in this batch /// * ...... /// * block[i] 60 BlockContext 60*i+1 The (i+1)'th block in this batch /// * ...... /// * block[n-1] 60 BlockContext 60*n-59 The last block in this batch /// ``` /// /// @dev Below is the encoding for `BlockContext`, total 60 bytes. /// ```text /// * Field Bytes Type Index Comments /// * blockNumber 8 uint64 0 The height of this block. /// * timestamp 8 uint64 8 The timestamp of this block. /// * baseFee 32 uint256 16 The base fee of this block. /// * gasLimit 8 uint64 48 The gas limit of this block. /// * numTransactions 2 uint16 56 The number of transactions in this block, both L1 & L2 txs. /// * numL1Messages 2 uint16 58 The number of l1 messages in this block. /// ``` library BatchCodecV0 { /// @dev Thrown when no blocks in batch. error ErrorNoBlockInBatch(); /// @dev Thrown when the length of batch is incorrect. error ErrorIncorrectBatchLength(); /// @dev The length of one block context. uint256 internal constant BLOCK_CONTEXT_LENGTH = 60; /// @notice Validate the length of batch. /// @param batchPtr The start memory offset of the batch in memory. /// @param _length The length of the batch. /// @return _numBlocks The number of blocks in current batch. function validateBatchLength(uint256 batchPtr, uint256 _length) internal pure returns (uint256 _numBlocks) { _numBlocks = getNumBlocks(batchPtr); // should contain at least one block if (_numBlocks == 0) revert ErrorNoBlockInBatch(); // should contain the number of the blocks and block contexts if (_length != 2 + _numBlocks * BLOCK_CONTEXT_LENGTH) revert ErrorIncorrectBatchLength(); } /// @notice Return the number of blocks in current batch. /// @param batchPtr The start memory offset of the batch in memory. /// @return _numBlocks The number of blocks in current batch. function getNumBlocks(uint256 batchPtr) internal pure returns (uint256 _numBlocks) { assembly { _numBlocks := shr(240, mload(batchPtr)) } } /// @notice Copy the block context to another memory. /// @param blockPtr The start memory offset of the first block context in memory. /// @param dstPtr The destination memory offset to store the block context. /// @param index The index of block context to copy. /// @return uint256 The new destination memory offset after copy. function copyBlockContext(uint256 blockPtr, uint256 dstPtr, uint256 index) internal pure returns (uint256) { // only first 58 bytes is needed. assembly { blockPtr := add(blockPtr, mul(BLOCK_CONTEXT_LENGTH, index)) mstore(dstPtr, mload(blockPtr)) // first 32 bytes mstore( add(dstPtr, 0x20), and(mload(add(blockPtr, 0x20)), 0xffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000) ) // next 26 bytes dstPtr := add(dstPtr, 58) } return dstPtr; } /// @notice Return the number of transactions in current block. /// @param blockPtr The start memory offset of the block context in memory. /// @return _numTransactions The number of transactions in current block. function getNumTransactions(uint256 blockPtr) internal pure returns (uint256 _numTransactions) { assembly { _numTransactions := shr(240, mload(add(blockPtr, 56))) } } /// @notice Return the number of L1 messages in current block. /// @param blockPtr The start memory offset of the block context in memory. /// @return _numL1Messages The number of L1 messages in current block. function getNumL1Messages(uint256 blockPtr) internal pure returns (uint256 _numL1Messages) { assembly { _numL1Messages := shr(240, mload(add(blockPtr, 58))) } } /// @notice Return the number of the block. /// @param blockPtr The start memory offset of the block context in memory. /// @return _blockNumber The block number of blockPtr in current block. function getBlockNumber(uint256 blockPtr) internal pure returns (uint256 _blockNumber) { assembly { _blockNumber := shr(192, mload(blockPtr)) } } } // SPDX-License-Identifier: MIT pragma solidity ^0.8.24; // solhint-disable no-inline-assembly /// @dev Below is the encoding for `BatchHeader` V0, total 249 + ceil(l1MessagePopped / 256) * 32 bytes. /// ```text /// * Field Bytes Type Index Comments /// * version 1 uint8 0 The batch version /// * batchIndex 8 uint64 1 The index of the batch /// * l1MessagePopped 8 uint64 9 Number of L1 messages popped in the batch /// * totalL1MessagePopped 8 uint64 17 Number of total L1 messages popped after the batch /// * dataHash 32 bytes32 25 The data hash of the batch /// * blobVersionedHash 32 bytes32 57 The versioned hash of the blob with this batch’s data /// * prevStateHash 32 bytes32 89 Preview state root /// * postStateHash 32 bytes32 121 Post state root /// * withdrawRootHash 32 bytes32 153 L2 withdrawal tree root hash /// * sequencerSetVerifyHash 32 bytes32 185 L2 sequencers set verify hash /// * parentBatchHash 32 bytes32 217 The parent batch hash /// ``` library BatchHeaderCodecV0 { /// @dev The length of fixed parts of the batch header. uint256 internal constant BATCH_HEADER_LENGTH = 249; /// @notice Load batch header in calldata to memory. /// @param _batchHeader The encoded batch header bytes in calldata. /// @return batchPtr The start memory offset of the batch header in memory. /// @return length The length in bytes of the batch header. function loadAndValidate(bytes calldata _batchHeader) internal pure returns (uint256 batchPtr, uint256 length) { length = _batchHeader.length; require(length >= BATCH_HEADER_LENGTH, "batch header length too small"); // copy batch header to memory. assembly { batchPtr := mload(0x40) calldatacopy(batchPtr, _batchHeader.offset, length) mstore(0x40, add(batchPtr, length)) } } /// @notice Get the version of the batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _version The version of the batch header. function getVersion(uint256 batchPtr) internal pure returns (uint256 _version) { assembly { _version := shr(248, mload(batchPtr)) } } /// @notice Get the batch index of the batch. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _batchIndex The batch index of the batch. function getBatchIndex(uint256 batchPtr) internal pure returns (uint256 _batchIndex) { assembly { _batchIndex := shr(192, mload(add(batchPtr, 1))) } } /// @notice Get the number of L1 messages of the batch. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _l1MessagePopped The number of L1 messages of the batch. function getL1MessagePopped(uint256 batchPtr) internal pure returns (uint256 _l1MessagePopped) { assembly { _l1MessagePopped := shr(192, mload(add(batchPtr, 9))) } } /// @notice Get the number of L1 messages popped before this batch. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _totalL1MessagePopped The the number of L1 messages popped before this batch. function getTotalL1MessagePopped(uint256 batchPtr) internal pure returns (uint256 _totalL1MessagePopped) { assembly { _totalL1MessagePopped := shr(192, mload(add(batchPtr, 17))) } } /// @notice Get the data hash of the batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _dataHash The data hash of the batch header. function getDataHash(uint256 batchPtr) internal pure returns (bytes32 _dataHash) { assembly { _dataHash := mload(add(batchPtr, 25)) } } /// @notice Get the blob versioned hash of the batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _blobVersionedHash The blob versioned hash of the batch header. function getBlobVersionedHash(uint256 batchPtr) internal pure returns (bytes32 _blobVersionedHash) { assembly { _blobVersionedHash := mload(add(batchPtr, 57)) } } function getPrevStateHash(uint256 batchPtr) internal pure returns (bytes32 _prevStateHash) { assembly { _prevStateHash := mload(add(batchPtr, 89)) } } function getPostStateHash(uint256 batchPtr) internal pure returns (bytes32 _postStateHash) { assembly { _postStateHash := mload(add(batchPtr, 121)) } } function getWithdrawRootHash(uint256 batchPtr) internal pure returns (bytes32 _withdrawRootHash) { assembly { _withdrawRootHash := mload(add(batchPtr, 153)) } } function getSequencerSetVerifyHash(uint256 batchPtr) internal pure returns (bytes32 _sequencerSetVerifyHash) { assembly { _sequencerSetVerifyHash := mload(add(batchPtr, 185)) } } /// @notice Get the parent batch hash of the batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @return _parentBatchHash The parent batch hash of the batch header. function getParentBatchHash(uint256 batchPtr) internal pure returns (bytes32 _parentBatchHash) { assembly { _parentBatchHash := mload(add(batchPtr, 217)) } } /// @notice Store the version of batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _version The version of batch header. function storeVersion(uint256 batchPtr, uint256 _version) internal pure { assembly { mstore8(batchPtr, _version) } } /// @notice Store the batch index of batch header. /// @dev Because this function can overwrite the subsequent fields, it must be called before /// `storeL1MessagePopped`, `storeTotalL1MessagePopped`, and `storeDataHash`. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _batchIndex The batch index. function storeBatchIndex(uint256 batchPtr, uint256 _batchIndex) internal pure { assembly { mstore(add(batchPtr, 1), shl(192, _batchIndex)) } } /// @notice Store the number of L1 messages popped in current batch to batch header. /// @dev Because this function can overwrite the subsequent fields, it must be called before /// `storeTotalL1MessagePopped` and `storeDataHash`. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _l1MessagePopped The number of L1 messages popped in current batch. function storeL1MessagePopped(uint256 batchPtr, uint256 _l1MessagePopped) internal pure { assembly { mstore(add(batchPtr, 9), shl(192, _l1MessagePopped)) } } /// @notice Store the total number of L1 messages popped after current batch to batch header. /// @dev Because this function can overwrite the subsequent fields, it must be called before /// `storeDataHash`. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _totalL1MessagePopped The total number of L1 messages popped after current batch. function storeTotalL1MessagePopped(uint256 batchPtr, uint256 _totalL1MessagePopped) internal pure { assembly { mstore(add(batchPtr, 17), shl(192, _totalL1MessagePopped)) } } /// @notice Store the data hash of batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _dataHash The data hash. function storeDataHash(uint256 batchPtr, bytes32 _dataHash) internal pure { assembly { mstore(add(batchPtr, 25), _dataHash) } } /// @notice Store the parent batch hash of batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _blobVersionedHash The versioned hash of the blob with this batch’s data. function storeBlobVersionedHash(uint256 batchPtr, bytes32 _blobVersionedHash) internal pure { assembly { mstore(add(batchPtr, 57), _blobVersionedHash) } } /// @dev Stores the previous state hash. /// @param batchPtr The memory pointer to the location where the previous state hash will be stored. /// @param _prevStateHash The hash of the previous state to be stored. function storePrevStateHash(uint256 batchPtr, bytes32 _prevStateHash) internal pure { assembly { mstore(add(batchPtr, 89), _prevStateHash) } } /// @dev Stores the post-state hash. /// @param batchPtr The memory pointer to the location where the post-state hash will be stored. /// @param _postStateHash The hash of the post-state to be stored. function storePostStateHash(uint256 batchPtr, bytes32 _postStateHash) internal pure { assembly { mstore(add(batchPtr, 121), _postStateHash) } } /// @dev Stores the withdrawal root hash. /// @param batchPtr The memory pointer to the location where the hash will be stored. /// @param _withdrawRootHash The hash of the withdrawal root to be stored. function storeWithdrawRootHash(uint256 batchPtr, bytes32 _withdrawRootHash) internal pure { assembly { mstore(add(batchPtr, 153), _withdrawRootHash) } } /// @dev Stores the hash for verifying the sequencer set. /// @param batchPtr The memory pointer to the batch data. /// @param _sequencerSetVerifyHash The hash of the sequencer set to be stored. function storeSequencerSetVerifyHash(uint256 batchPtr, bytes32 _sequencerSetVerifyHash) internal pure { assembly { mstore(add(batchPtr, 185), _sequencerSetVerifyHash) } } /// @notice Store the parent batch hash of batch header. /// @param batchPtr The start memory offset of the batch header in memory. /// @param _parentBatchHash The parent batch hash. function storeParentBatchHash(uint256 batchPtr, bytes32 _parentBatchHash) internal pure { assembly { mstore(add(batchPtr, 217), _parentBatchHash) } } /// @notice Compute the batch hash. /// @dev Caller should make sure that the encoded batch header is correct. /// /// @param batchPtr The start memory offset of the batch header in memory. /// @param length The length of the batch. /// @return _batchHash The hash of the corresponding batch. function computeBatchHash(uint256 batchPtr, uint256 length) internal pure returns (bytes32 _batchHash) { // in the current version, the hash is: keccak(BatchHeader without timestamp) assembly { _batchHash := keccak256(batchPtr, length) } } } // SPDX-License-Identifier: MIT pragma solidity ^0.8.16; interface IRollupVerifier { /// @notice Verify aggregate zk proof. /// @param _version The version of the verifier. /// @param _batchIndex The batch index to verify. /// @param _aggrProof The aggregated proof. /// @param _publicInputHash The public input hash. function verifyAggregateProof( uint256 _version, uint256 _batchIndex, bytes calldata _aggrProof, bytes32 _publicInputHash ) external view; } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ function __Ownable_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializing { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/AddressUpgradeable.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a * constructor. * * Emits an {Initialized} event. */ modifier initializer() { bool isTopLevelCall = !_initializing; require( (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1), "Initializable: contract is already initialized" ); _initialized = 1; if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: setting the version to 255 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint8 version) { require(!_initializing && _initialized < version, "Initializable: contract is already initialized"); _initialized = version; _initializing = true; _; _initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { require(!_initializing, "Initializable: contract is initializing"); if (_initialized != type(uint8).max) { _initialized = type(uint8).max; emit Initialized(type(uint8).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint8) { return _initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _initializing; } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module which allows children to implement an emergency stop * mechanism that can be triggered by an authorized account. * * This module is used through inheritance. It will make available the * modifiers `whenNotPaused` and `whenPaused`, which can be applied to * the functions of your contract. Note that they will not be pausable by * simply including this module, only once the modifiers are put in place. */ abstract contract PausableUpgradeable is Initializable, ContextUpgradeable { /** * @dev Emitted when the pause is triggered by `account`. */ event Paused(address account); /** * @dev Emitted when the pause is lifted by `account`. */ event Unpaused(address account); bool private _paused; /** * @dev Initializes the contract in unpaused state. */ function __Pausable_init() internal onlyInitializing { __Pausable_init_unchained(); } function __Pausable_init_unchained() internal onlyInitializing { _paused = false; } /** * @dev Modifier to make a function callable only when the contract is not paused. * * Requirements: * * - The contract must not be paused. */ modifier whenNotPaused() { _requireNotPaused(); _; } /** * @dev Modifier to make a function callable only when the contract is paused. * * Requirements: * * - The contract must be paused. */ modifier whenPaused() { _requirePaused(); _; } /** * @dev Returns true if the contract is paused, and false otherwise. */ function paused() public view virtual returns (bool) { return _paused; } /** * @dev Throws if the contract is paused. */ function _requireNotPaused() internal view virtual { require(!paused(), "Pausable: paused"); } /** * @dev Throws if the contract is not paused. */ function _requirePaused() internal view virtual { require(paused(), "Pausable: not paused"); } /** * @dev Triggers stopped state. * * Requirements: * * - The contract must not be paused. */ function _pause() internal virtual whenNotPaused { _paused = true; emit Paused(_msgSender()); } /** * @dev Returns to normal state. * * Requirements: * * - The contract must be paused. */ function _unpause() internal virtual whenPaused { _paused = false; emit Unpaused(_msgSender()); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library AddressUpgradeable { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol) pragma solidity ^0.8.0; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
File 3 of 4: TransparentUpgradeableProxy
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol) pragma solidity ^0.8.0; /** * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified * proxy whose upgrades are fully controlled by the current implementation. */ interface IERC1822Proxiable { /** * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation * address. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. */ function proxiableUUID() external view returns (bytes32); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol) pragma solidity ^0.8.0; /** * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC. * * _Available since v4.8.3._ */ interface IERC1967 { /** * @dev Emitted when the implementation is upgraded. */ event Upgraded(address indexed implementation); /** * @dev Emitted when the admin account has changed. */ event AdminChanged(address previousAdmin, address newAdmin); /** * @dev Emitted when the beacon is changed. */ event BeaconUpgraded(address indexed beacon); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol) pragma solidity ^0.8.0; /** * @dev This is the interface that {BeaconProxy} expects of its beacon. */ interface IBeacon { /** * @dev Must return an address that can be used as a delegate call target. * * {BeaconProxy} will check that this address is a contract. */ function implementation() external view returns (address); } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol) pragma solidity ^0.8.0; import "../Proxy.sol"; import "./ERC1967Upgrade.sol"; /** * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an * implementation address that can be changed. This address is stored in storage in the location specified by * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the * implementation behind the proxy. */ contract ERC1967Proxy is Proxy, ERC1967Upgrade { /** * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`. * * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded * function call, and allows initializing the storage of the proxy like a Solidity constructor. */ constructor(address _logic, bytes memory _data) payable { _upgradeToAndCall(_logic, _data, false); } /** * @dev Returns the current implementation address. */ function _implementation() internal view virtual override returns (address impl) { return ERC1967Upgrade._getImplementation(); } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol) pragma solidity ^0.8.2; import "../beacon/IBeacon.sol"; import "../../interfaces/IERC1967.sol"; import "../../interfaces/draft-IERC1822.sol"; import "../../utils/Address.sol"; import "../../utils/StorageSlot.sol"; /** * @dev This abstract contract provides getters and event emitting update functions for * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots. * * _Available since v4.1._ */ abstract contract ERC1967Upgrade is IERC1967 { // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1 bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143; /** * @dev Storage slot with the address of the current implementation. * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; /** * @dev Returns the current implementation address. */ function _getImplementation() internal view returns (address) { return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; } /** * @dev Stores a new address in the EIP1967 implementation slot. */ function _setImplementation(address newImplementation) private { require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; } /** * @dev Perform implementation upgrade * * Emits an {Upgraded} event. */ function _upgradeTo(address newImplementation) internal { _setImplementation(newImplementation); emit Upgraded(newImplementation); } /** * @dev Perform implementation upgrade with additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal { _upgradeTo(newImplementation); if (data.length > 0 || forceCall) { Address.functionDelegateCall(newImplementation, data); } } /** * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal { // Upgrades from old implementations will perform a rollback test. This test requires the new // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing // this special case will break upgrade paths from old UUPS implementation to new ones. if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) { _setImplementation(newImplementation); } else { try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) { require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID"); } catch { revert("ERC1967Upgrade: new implementation is not UUPS"); } _upgradeToAndCall(newImplementation, data, forceCall); } } /** * @dev Storage slot with the admin of the contract. * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103; /** * @dev Returns the current admin. */ function _getAdmin() internal view returns (address) { return StorageSlot.getAddressSlot(_ADMIN_SLOT).value; } /** * @dev Stores a new address in the EIP1967 admin slot. */ function _setAdmin(address newAdmin) private { require(newAdmin != address(0), "ERC1967: new admin is the zero address"); StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin; } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _changeAdmin(address newAdmin) internal { emit AdminChanged(_getAdmin(), newAdmin); _setAdmin(newAdmin); } /** * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy. * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor. */ bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50; /** * @dev Returns the current beacon. */ function _getBeacon() internal view returns (address) { return StorageSlot.getAddressSlot(_BEACON_SLOT).value; } /** * @dev Stores a new beacon in the EIP1967 beacon slot. */ function _setBeacon(address newBeacon) private { require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract"); require( Address.isContract(IBeacon(newBeacon).implementation()), "ERC1967: beacon implementation is not a contract" ); StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon; } /** * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that). * * Emits a {BeaconUpgraded} event. */ function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal { _setBeacon(newBeacon); emit BeaconUpgraded(newBeacon); if (data.length > 0 || forceCall) { Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol) pragma solidity ^0.8.0; /** * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to * be specified by overriding the virtual {_implementation} function. * * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a * different contract through the {_delegate} function. * * The success and return data of the delegated call will be returned back to the caller of the proxy. */ abstract contract Proxy { /** * @dev Delegates the current call to `implementation`. * * This function does not return to its internal call site, it will return directly to the external caller. */ function _delegate(address implementation) internal virtual { assembly { // Copy msg.data. We take full control of memory in this inline assembly // block because it will not return to Solidity code. We overwrite the // Solidity scratch pad at memory position 0. calldatacopy(0, 0, calldatasize()) // Call the implementation. // out and outsize are 0 because we don't know the size yet. let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0) // Copy the returned data. returndatacopy(0, 0, returndatasize()) switch result // delegatecall returns 0 on error. case 0 { revert(0, returndatasize()) } default { return(0, returndatasize()) } } } /** * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function * and {_fallback} should delegate. */ function _implementation() internal view virtual returns (address); /** * @dev Delegates the current call to the address returned by `_implementation()`. * * This function does not return to its internal call site, it will return directly to the external caller. */ function _fallback() internal virtual { _beforeFallback(); _delegate(_implementation()); } /** * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other * function in the contract matches the call data. */ fallback() external payable virtual { _fallback(); } /** * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data * is empty. */ receive() external payable virtual { _fallback(); } /** * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback` * call, or as part of the Solidity `fallback` or `receive` functions. * * If overridden should call `super._beforeFallback()`. */ function _beforeFallback() internal virtual {} } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/transparent/TransparentUpgradeableProxy.sol) pragma solidity ^0.8.0; import "../ERC1967/ERC1967Proxy.sol"; /** * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy} * does not implement this interface directly, and some of its functions are implemented by an internal dispatch * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not * include them in the ABI so this interface must be used to interact with it. */ interface ITransparentUpgradeableProxy is IERC1967 { function admin() external view returns (address); function implementation() external view returns (address); function changeAdmin(address) external; function upgradeTo(address) external; function upgradeToAndCall(address, bytes memory) external payable; } /** * @dev This contract implements a proxy that is upgradeable by an admin. * * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector * clashing], which can potentially be used in an attack, this contract uses the * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two * things that go hand in hand: * * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if * that call matches one of the admin functions exposed by the proxy itself. * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the * implementation. If the admin tries to call a function on the implementation it will fail with an error that says * "admin cannot fallback to proxy target". * * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due * to sudden errors when trying to call a function from the proxy implementation. * * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy. * * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the * implementation. * * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised. */ contract TransparentUpgradeableProxy is ERC1967Proxy { /** * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}. */ constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) { _changeAdmin(admin_); } /** * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin. * * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the * implementation provides a function with the same selector. */ modifier ifAdmin() { if (msg.sender == _getAdmin()) { _; } else { _fallback(); } } /** * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior */ function _fallback() internal virtual override { if (msg.sender == _getAdmin()) { bytes memory ret; bytes4 selector = msg.sig; if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) { ret = _dispatchUpgradeTo(); } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) { ret = _dispatchUpgradeToAndCall(); } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) { ret = _dispatchChangeAdmin(); } else if (selector == ITransparentUpgradeableProxy.admin.selector) { ret = _dispatchAdmin(); } else if (selector == ITransparentUpgradeableProxy.implementation.selector) { ret = _dispatchImplementation(); } else { revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target"); } assembly { return(add(ret, 0x20), mload(ret)) } } else { super._fallback(); } } /** * @dev Returns the current admin. * * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103` */ function _dispatchAdmin() private returns (bytes memory) { _requireZeroValue(); address admin = _getAdmin(); return abi.encode(admin); } /** * @dev Returns the current implementation. * * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc` */ function _dispatchImplementation() private returns (bytes memory) { _requireZeroValue(); address implementation = _implementation(); return abi.encode(implementation); } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _dispatchChangeAdmin() private returns (bytes memory) { _requireZeroValue(); address newAdmin = abi.decode(msg.data[4:], (address)); _changeAdmin(newAdmin); return ""; } /** * @dev Upgrade the implementation of the proxy. */ function _dispatchUpgradeTo() private returns (bytes memory) { _requireZeroValue(); address newImplementation = abi.decode(msg.data[4:], (address)); _upgradeToAndCall(newImplementation, bytes(""), false); return ""; } /** * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the * proxied contract. */ function _dispatchUpgradeToAndCall() private returns (bytes memory) { (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes)); _upgradeToAndCall(newImplementation, data, true); return ""; } /** * @dev Returns the current admin. * * CAUTION: This function is deprecated. Use {ERC1967Upgrade-_getAdmin} instead. */ function _admin() internal view virtual returns (address) { return _getAdmin(); } /** * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to * emulate some proxy functions being non-payable while still allowing value to pass through. */ function _requireZeroValue() private { require(msg.value == 0); } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol) // This file was procedurally generated from scripts/generate/templates/StorageSlot.js. pragma solidity ^0.8.0; /** * @dev Library for reading and writing primitive types to specific storage slots. * * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts. * This library helps with reading and writing to such slots without the need for inline assembly. * * The functions in this library return Slot structs that contain a `value` member that can be used to read or write. * * Example usage to set ERC1967 implementation slot: * ```solidity * contract ERC1967 { * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; * * function _getImplementation() internal view returns (address) { * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; * } * * function _setImplementation(address newImplementation) internal { * require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` * * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._ * _Available since v4.9 for `string`, `bytes`._ */ library StorageSlot { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } struct StringSlot { string value; } struct BytesSlot { bytes value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` with member `value` located at `slot`. */ function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` representation of the string storage pointer `store`. */ function getStringSlot(string storage store) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } /** * @dev Returns an `BytesSlot` with member `value` located at `slot`. */ function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`. */ function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } }
File 4 of 4: L1Staking
// SPDX-License-Identifier: MIT pragma solidity =0.8.24; interface IL1Staking { /********** * Events * **********/ /// @notice staker registered /// @param addr staker address /// @param tmKey tendermint pubkey /// @param blsKey BLS pubkey event Registered(address addr, bytes32 tmKey, bytes blsKey); /// @notice stakers removed /// @param stakers stakers removed event StakersRemoved(address[] stakers); /// @notice Withdrawn /// @param addr staker address /// @param unlockHeight unlock block height event Withdrawn(address indexed addr, uint256 unlockHeight); /// @notice staker claimed /// @param staker staker claimed /// @param receiver receiver address event Claimed(address indexed staker, address receiver); /// @notice stakers were slashed /// @param stakers slashed stakers event Slashed(address[] stakers); /// @notice slash remaining claimed /// @param receiver receiver address /// @param amount claimed amount event SlashRemainingClaimed(address receiver, uint256 amount); /// @notice whitelist updated /// @param add addresses added /// @param remove addresses removed event WhitelistUpdated(address[] add, address[] remove); /// @notice staking value updated /// @param oldStakingValue old staking value /// @param newStakingValue new staking value event StakingValueUpdated(uint256 oldStakingValue, uint256 newStakingValue); /// @notice gas limit add staker updated /// @param oldGasLimit old gas limit /// @param newGasLimit new gas limit event GasLimitAddStakerUpdated(uint256 oldGasLimit, uint256 newGasLimit); /// @notice gas limit remove stakers updated /// @param oldGasLimit old gas limit /// @param newGasLimit new gas limit event GasLimitRemoveStakersUpdated(uint256 oldGasLimit, uint256 newGasLimit); /// @notice reward percentage updated /// @param oldPercentage old percentage /// @param newPercentage new percentage event RewardPercentageUpdated(uint256 oldPercentage, uint256 newPercentage); /// @notice challenge deposit value updated /// @param oldChallengeDeposit old challengeDeposit /// @param newChallengeDeposit new challengeDeposit event ChallengeDepositUpdated(uint256 oldChallengeDeposit, uint256 newChallengeDeposit); /************************* * Public View Functions * *************************/ /// @notice return all stakers function getStakers() external view returns (address[255] memory); /// @notice return active stakers function getActiveStakers() external view returns (address[] memory); /// @notice return staking value function stakingValue() external view returns (uint256); /// @notice return challenge deposit value function challengeDeposit() external view returns (uint256); /// @notice whether address is staker /// @param addr the address to check function isStaker(address addr) external view returns (bool); /// @notice whether address is active staker /// @param addr the address to check function isActiveStaker(address addr) external view returns (bool); /// @notice get staker bitmap /// @param staker the staker address function getStakerBitmap(address staker) external view returns (uint256); /// @notice get stakers bitmap /// @param stakers the staker address array function getStakersBitmap(address[] calldata stakers) external view returns (uint256); /// @notice verify BLS signature /// @param signedSequencersBitmap bitmap of signed sequencers /// @param sequencerSet sequencer set /// @param msgHash bls message hash /// @param signature batch signature function verifySignature( uint256 signedSequencersBitmap, address[] calldata sequencerSet, bytes32 msgHash, bytes calldata signature ) external view returns (bool); /***************************** * Public Mutating Functions * *****************************/ /// @notice challenger win, slash sequencers /// @param sequencersBitmap the sequencers to slash function slash(uint256 sequencersBitmap) external returns (uint256); } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; import {OwnableUpgradeable} from "node_modules/@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import {ReentrancyGuardUpgradeable} from "node_modules/@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol"; import {Predeploys} from "../../libraries/constants/Predeploys.sol"; import {Types} from "../../libraries/common/Types.sol"; import {Staking} from "../../libraries/staking/Staking.sol"; import {IL1Staking} from "./IL1Staking.sol"; import {IL2Staking} from "../../l2/staking/IL2Staking.sol"; contract L1Staking is IL1Staking, Staking, OwnableUpgradeable, ReentrancyGuardUpgradeable { /************* * Variables * *************/ /// @notice rollup Contract address public rollupContract; /// @notice staking value uint256 public stakingValue; /// @notice exit lock blocks uint256 public withdrawalLockBlocks; /// @notice percentage awarded to challenger uint256 public rewardPercentage; /// @notice cross-chain gas limit add staker uint256 public gasLimitAddStaker; /// @notice cross-chain gas limit remove stakers uint256 public gasLimitRemoveStakers; /// @notice slash remaining uint256 public slashRemaining; /// @notice staker whitelist mapping(address stakerAddr => bool inWhitelist) public whitelist; /// @notice staker removed list mapping(address stakerAddr => bool removed) public removedList; /// @notice all stakers (0-254) address[255] public stakerSet; /// @notice all stakers indexes (1-255). '0' means not exist. stakerIndexes[1] releated to stakerSet[0] mapping(address stakerAddr => uint8 index) public stakerIndexes; /// @notice stakers to delete address[] public deleteList; /// @notice staker deleteable height mapping(address stakerAddr => uint256 height) public deleteableHeight; /// @notice all stakers info mapping(address stakerAddr => Types.StakerInfo) public stakers; /// @notice bls key map mapping(bytes blsPubkey => bool exist) public blsKeys; /// @notice tendermint key map mapping(bytes32 tmPubkey => bool exist) public tmKeys; /// @notice withdraw unlock block height mapping(address staker => uint256 amount) public withdrawals; /// @notice challenge deposit value uint256 public challengeDeposit; /********************** * Function Modifiers * **********************/ /// @notice whether in whitelist modifier inWhitelist(address addr) { require(whitelist[addr], "not in whitelist"); _; } /// @notice only rollup contract modifier onlyRollupContract() { require(_msgSender() == rollupContract, "only rollup contract"); _; } /*************** * Constructor * ***************/ /// @param _messenger Address of CrossDomainMessenger on this network. constructor(address payable _messenger) Staking(_messenger, payable(Predeploys.L2_STAKING)) { _disableInitializers(); } /*************** * Initializer * ***************/ /// @notice initializer /// @param _rollupContract rollup contract address /// @param _stakingValue staking value /// @param _challengeDeposit challenge deposit value /// @param _lockBlocks withdraw lock blocks /// @param _rewardPercentage percentage awarded to challenger /// @param _gasLimitAdd cross-chain gas limit add staker /// @param _gasLimitRemove cross-chain gas limit remove stakers function initialize( address _rollupContract, uint256 _stakingValue, uint256 _challengeDeposit, uint256 _lockBlocks, uint256 _rewardPercentage, uint256 _gasLimitAdd, uint256 _gasLimitRemove ) public initializer { require(_rollupContract != address(0), "invalid rollup contract"); require(_stakingValue > 0, "invalid staking value"); require(_challengeDeposit > 0, "invalid challenge deposit value"); require(_lockBlocks > 0, "invalid withdrawal lock blocks"); require(_gasLimitAdd > 0, "invalid gas limit add staker"); require(_gasLimitRemove > 0, "invalid gas limit remove stakers"); require(_rewardPercentage > 0 && _rewardPercentage <= 100, "invalid challenger reward percentage"); __Ownable_init(); __ReentrancyGuard_init(); rollupContract = _rollupContract; rewardPercentage = _rewardPercentage; stakingValue = _stakingValue; challengeDeposit = _challengeDeposit; withdrawalLockBlocks = _lockBlocks; gasLimitAddStaker = _gasLimitAdd; gasLimitRemoveStakers = _gasLimitRemove; emit GasLimitAddStakerUpdated(0, _gasLimitAdd); emit GasLimitRemoveStakersUpdated(0, _gasLimitRemove); emit RewardPercentageUpdated(0, _rewardPercentage); } /************************ * Restricted Functions * ************************/ /// @notice update whitelist function updateWhitelist(address[] calldata add, address[] calldata remove) external onlyOwner { for (uint256 i = 0; i < add.length; i++) { require(!removedList[add[i]], "in removed list"); whitelist[add[i]] = true; } for (uint256 i = 0; i < remove.length; i++) { delete whitelist[remove[i]]; } emit WhitelistUpdated(add, remove); } /// @notice register staker /// @param tmKey tendermint pubkey /// @param blsKey bls pubkey function register(bytes32 tmKey, bytes memory blsKey) external payable inWhitelist(_msgSender()) { require(stakers[_msgSender()].addr == address(0), "already registered"); require(tmKey != 0 && !tmKeys[tmKey], "invalid tendermint pubkey"); require(blsKey.length == 256 && !blsKeys[blsKey], "invalid bls pubkey"); require(msg.value == stakingValue, "invalid staking value"); stakers[_msgSender()] = Types.StakerInfo(_msgSender(), tmKey, blsKey); _addStaker(_msgSender()); blsKeys[blsKey] = true; tmKeys[tmKey] = true; emit Registered(_msgSender(), tmKey, blsKey); // send message to add staker on l2 _msgAddStaker(stakers[_msgSender()]); } /// @notice remove staker function removeStaker(address[] memory _stakers) external onlyOwner { for (uint256 i = 0; i < _stakers.length; i++) { require(isActiveStaker(_stakers[i]), "only active staker can be removed"); require(withdrawals[_stakers[i]] == 0, "withdrawing"); withdrawals[_stakers[i]] = block.number + withdrawalLockBlocks; _removeStaker(_stakers[i]); emit Withdrawn(_stakers[i], withdrawals[_stakers[i]]); delete whitelist[_stakers[i]]; removedList[_stakers[i]] = true; } emit StakersRemoved(_stakers); // send message to remove stakers on l2 _msgRemoveStakers(_stakers); } /// @notice withdraw staking function withdraw() external { require(isActiveStaker(_msgSender()), "only active staker"); require(withdrawals[_msgSender()] == 0, "withdrawing"); withdrawals[_msgSender()] = block.number + withdrawalLockBlocks; _removeStaker(_msgSender()); emit Withdrawn(_msgSender(), withdrawals[_msgSender()]); delete whitelist[_msgSender()]; removedList[_msgSender()] = true; address[] memory remove = new address[](1); remove[0] = _msgSender(); emit StakersRemoved(remove); // send message to remove staker on l2 _msgRemoveStakers(remove); } /// @notice challenger win, slash sequencers function slash(uint256 sequencersBitmap) external onlyRollupContract nonReentrant returns (uint256) { address[] memory sequencers = getStakersFromBitmap(sequencersBitmap); uint256 valueSum; for (uint256 i = 0; i < sequencers.length; i++) { if (withdrawals[sequencers[i]] > 0) { delete withdrawals[sequencers[i]]; valueSum += stakingValue; } else if (!isStakerInDeleteList(sequencers[i])) { // If it is the first time to be slashed valueSum += stakingValue; _removeStaker(sequencers[i]); // remove from whitelist delete whitelist[sequencers[i]]; removedList[sequencers[i]] = true; } } uint256 reward = (valueSum * rewardPercentage) / 100; slashRemaining += valueSum - reward; _transfer(rollupContract, reward); emit Slashed(sequencers); emit StakersRemoved(sequencers); // send message to remove stakers on l2 _msgRemoveStakers(sequencers); return reward; } /// @notice claim slash remaining /// @param receiver receiver address function claimSlashRemaining(address receiver) external onlyOwner nonReentrant { uint256 _slashRemaining = slashRemaining; _transfer(receiver, slashRemaining); slashRemaining = 0; emit SlashRemainingClaimed(receiver, _slashRemaining); } /// @notice update staking value /// @param _stakingValue staking value function updateStakingValue(uint256 _stakingValue) external onlyOwner { require(_stakingValue > 0 && _stakingValue != stakingValue, "invalid staking value"); uint256 _oldStakingValue = stakingValue; stakingValue = _stakingValue; emit StakingValueUpdated(_oldStakingValue, stakingValue); } /// @notice update gas limit of add staker /// @param _gasLimitAdd cross-chain gas limit add staker function updateGasLimitAddStaker(uint256 _gasLimitAdd) external onlyOwner { require(_gasLimitAdd > 0 && _gasLimitAdd != gasLimitAddStaker, "invalid new gas limit"); uint256 _oldGasLimitAddStaker = gasLimitAddStaker; gasLimitAddStaker = _gasLimitAdd; emit GasLimitAddStakerUpdated(_oldGasLimitAddStaker, _gasLimitAdd); } /// @notice update gas limit of remove stakers /// @param _gasLimitRemove cross-chain gas limit remove stakers function updateGasLimitRemoveStakers(uint256 _gasLimitRemove) external onlyOwner { require(_gasLimitRemove > 0 && _gasLimitRemove != gasLimitRemoveStakers, "invalid new gas limit"); uint256 _oldGasLimitRemove = gasLimitRemoveStakers; gasLimitRemoveStakers = _gasLimitRemove; emit GasLimitRemoveStakersUpdated(_oldGasLimitRemove, _gasLimitRemove); } /// @notice update challenge deposit /// @param _challengeDeposit challenge deposit value function updateChallengeDeposit(uint256 _challengeDeposit) external onlyOwner { require(_challengeDeposit > 0 && _challengeDeposit != challengeDeposit, "invalid challenge deposit value"); uint256 _oldChallengeDeposit = challengeDeposit; challengeDeposit = _challengeDeposit; emit ChallengeDepositUpdated(_oldChallengeDeposit, _challengeDeposit); } /// @notice update reward percentage /// @param _rewardPercentage percentage awarded to challenger function updateRewardPercentage(uint256 _rewardPercentage) external onlyOwner { require( _rewardPercentage > 0 && _rewardPercentage <= 100 && _rewardPercentage != rewardPercentage, "invalid reward percentage" ); uint256 _oldRewardPercentage = rewardPercentage; rewardPercentage = _rewardPercentage; emit RewardPercentageUpdated(_oldRewardPercentage, _rewardPercentage); } /// @notice clean staker store function cleanStakerStore() external onlyOwner { _cleanStakerStore(); } /***************************** * Public Mutating Functions * *****************************/ /// @notice claim withdrawal /// @param receiver receiver address function claimWithdrawal(address receiver) external nonReentrant { require(withdrawals[_msgSender()] > 0, "withdrawal not exist"); require(withdrawals[_msgSender()] <= block.number, "withdrawal locked"); delete withdrawals[_msgSender()]; _cleanStakerStore(); emit Claimed(_msgSender(), receiver); _transfer(receiver, stakingValue); } /************************* * Public View Functions * *************************/ /// @notice verify BLS signature function verifySignature( uint256, // signedSequencersBitmap address[] calldata, // sequencerSet bytes32, // msgHash bytes calldata // signature ) external pure returns (bool) { // TODO verify BLS signature return true; } /// @notice return all stakers function getStakers() external view returns (address[255] memory) { return stakerSet; } /// @notice return active stakers function getActiveStakers() external view returns (address[] memory) { uint256 activeStakersNumber; bool[] memory tags = new bool[](255); for (uint256 i = 0; i < 255; i++) { // valid address and not in delete list if (stakerSet[i] != address(0) && deleteableHeight[stakerSet[i]] == 0) { activeStakersNumber++; tags[i] = true; } } address[] memory activeStakers = new address[](activeStakersNumber); uint256 index; for (uint256 i = 0; i < 255; i++) { if (tags[i]) { activeStakers[index] = stakerSet[i]; index++; } } return activeStakers; } /// @notice whether address is staker /// @param addr address to check function isStaker(address addr) public view returns (bool) { if (stakerIndexes[addr] == 0) { return false; } return stakerSet[stakerIndexes[addr] - 1] == addr; } /// @notice whether address is active staker /// @param addr address to check function isActiveStaker(address addr) public view returns (bool) { if (stakerIndexes[addr] == 0) { return false; } return (stakerSet[stakerIndexes[addr] - 1] == addr) && (deleteableHeight[addr] == 0); } /// @notice whether address in delete list /// @param addr address to check function isStakerInDeleteList(address addr) public view returns (bool) { return deleteableHeight[addr] > 0; } /// @notice get staker bitmap /// @param _staker the staker address function getStakerBitmap(address _staker) external view returns (uint256 bitmap) { require(isStaker(_staker), "invalid staker"); bitmap = 1 << stakerIndexes[_staker]; return bitmap; } /// @notice get stakers bitmap /// @param _stakers the staker address array function getStakersBitmap(address[] calldata _stakers) external view returns (uint256 bitmap) { require(_stakers.length <= 255, "stakers length out of bounds"); for (uint256 i = 0; i < _stakers.length; i++) { require(isStaker(_stakers[i]), "invalid staker"); bitmap = bitmap | (1 << stakerIndexes[_stakers[i]]); } return bitmap; } /// @notice get stakers from bitmap /// @param bitmap the stakers bitmap function getStakersFromBitmap(uint256 bitmap) public view returns (address[] memory stakerAddrs) { // skip first bit uint256 _bitmap = bitmap >> 1; uint256 stakersLength = 0; while (_bitmap > 0) { stakersLength = stakersLength + 1; _bitmap = _bitmap & (_bitmap - 1); } stakerAddrs = new address[](stakersLength); uint256 index = 0; for (uint8 i = 1; i <= 255; i++) { if ((bitmap & (1 << i)) > 0) { stakerAddrs[index] = stakerSet[i - 1]; index = index + 1; if (index >= stakersLength) { break; } } } } /********************** * Internal Functions * **********************/ /// @notice add stater /// @param addr staker address function _addStaker(address addr) internal { for (uint8 i = 0; i < 255; i++) { if (stakerSet[i] == address(0)) { stakerSet[i] = addr; stakerIndexes[addr] = i + 1; return; } } require(false, "slot full"); } /// @notice Add staker to deleteList, it will not be actually deleted until cleanStakerStore is executed /// @param addr staker address function _removeStaker(address addr) internal { require(deleteableHeight[addr] == 0, "already in deleteList"); deleteList.push(addr); deleteableHeight[addr] = block.number + withdrawalLockBlocks; } /// @notice transfer ETH /// @param _to The address to transfer ETH to. /// @param _amount The amount of ETH to transfer. function _transfer(address _to, uint256 _amount) internal { if (_amount > 0) { (bool success, ) = _to.call{value: _amount}(""); require(success, "Rollup: ETH transfer failed"); } } /// @notice add staker /// @param add staker to add function _msgAddStaker(Types.StakerInfo memory add) internal { MESSENGER.sendMessage( address(OTHER_STAKING), 0, abi.encodeCall(IL2Staking.addStaker, (add)), gasLimitAddStaker ); } /// @notice remove stakers /// @param remove stakers to remove function _msgRemoveStakers(address[] memory remove) internal { MESSENGER.sendMessage( address(OTHER_STAKING), 0, abi.encodeCall(IL2Staking.removeStakers, (remove)), gasLimitRemoveStakers ); } /// @notice clean staker store function _cleanStakerStore() internal { uint256 i = 0; while (i < deleteList.length) { if (deleteableHeight[deleteList[i]] <= block.number) { // clean stakerSet delete stakerSet[stakerIndexes[deleteList[i]] - 1]; delete stakerIndexes[deleteList[i]]; // clean staker info delete stakers[deleteList[i]]; // clean deleteList delete deleteableHeight[deleteList[i]]; deleteList[i] = deleteList[deleteList.length - 1]; deleteList.pop(); } else { i++; } } } } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; import {Types} from "../../libraries/common/Types.sol"; interface IL2Staking { /*********** * Structs * ***********/ /// @notice Undelegation representing a undelegation info. /// /// @custom:field delegatee delegatee /// @custom:field amount staking amount /// @custom:field unlock unlock epoch index struct Undelegation { address delegatee; uint256 amount; uint256 unlockEpoch; } /********** * Events * **********/ /// @notice Emitted delegated stake /// @param delegatee delegatee /// @param delegator delegator /// @param amount new delegation amount, not increment /// @param stakeAmount stake amount /// @param effectiveEpoch effective epoch event Delegated( address indexed delegatee, address indexed delegator, uint256 amount, uint256 stakeAmount, uint256 effectiveEpoch ); /// @notice Emitted undelegated stake /// @param delegatee delegatee /// @param delegator delegator /// @param amount undelegation amount /// @param effectiveEpoch effective epoch /// @param unlockEpoch unlock epoch index event Undelegated( address indexed delegatee, address indexed delegator, uint256 amount, uint256 effectiveEpoch, uint256 unlockEpoch ); /// @notice Emitted claim info /// @param delegator delegator /// @param unlockEpoch unlock epoch index /// @param amount staking amount event UndelegationClaimed( address indexed delegatee, address indexed delegator, uint256 unlockEpoch, uint256 amount ); /// @notice Emitted commission updated /// @param staker staker address /// @param percentage commission percentage /// @param epochEffective epoch effective event CommissionUpdated(address indexed staker, uint256 percentage, uint256 epochEffective); /// @notice Emitted staker added /// @param addr staker address /// @param tmKey staker tendermint pubkey /// @param blsKey staker BLS pubkey event StakerAdded(address indexed addr, bytes32 tmKey, bytes blsKey); /// @notice Emitted stakers removed /// @param stakerAddresses stakers removed event StakerRemoved(address[] stakerAddresses); /// @notice Emitted reward start time updated /// @param oldTime The old reward start time /// @param newTime The new reward start time event RewardStartTimeUpdated(uint256 oldTime, uint256 newTime); /// @notice Emitted sequencer set max size updated /// @param oldSize The old sequencer set max size /// @param newSize The new sequencer set max size event SequencerSetMaxSizeUpdated(uint256 oldSize, uint256 newSize); /************************* * Public View Functions * *************************/ /// @notice reward epoch function rewardStartTime() external view returns (uint256); /// @notice max size of sequencer set function sequencerSetMaxSize() external view returns (uint256); /// @notice undelegate lock epochs function undelegateLockEpochs() external view returns (uint256); /// @notice start reward function startReward() external; /// @notice return current reward epoch index. Revert if not start reward function currentEpoch() external view returns (uint256); /// @notice check if the user has staked to staker /// @param staker staker address function isStakingTo(address staker) external view returns (bool); /// @notice Get the delegators length which staked to staker /// @param staker staker address function getDelegatorsLength(address staker) external view returns (uint256); /// @notice Get the delegators which staked to staker in pagination /// @param staker staker address /// @param pageSize page size /// @param pageIndex page index function getAllDelegatorsInPagination( address staker, uint256 pageSize, uint256 pageIndex ) external view returns (uint256 delegatorsTotalNumber, address[] memory delegatorsInPage); /// @notice get stakers info /// @param _stakerAddresses staker's addresses function getStakesInfo(address[] calldata _stakerAddresses) external view returns (Types.StakerInfo[] memory); /// @notice get stakers function getStakers() external view returns (Types.StakerInfo[] memory); /// @notice get staker addresses length function getStakerAddressesLength() external view returns (uint256); /***************************** * Public Mutating Functions * *****************************/ /// @notice add staker, sync from L1 /// @param add staker to add. {addr, tmKey, blsKey} function addStaker(Types.StakerInfo calldata add) external; /// @notice remove stakers, sync from L1 /// @param remove staker to remove function removeStakers(address[] calldata remove) external; /// @notice setCommissionRate set delegate commission percentage /// @param commission commission percentage, denominator is 100 function setCommissionRate(uint256 commission) external; /// @notice delegator stake morph to delegatee /// @param delegatee stake to whom /// @param amount stake amount function delegateStake(address delegatee, uint256 amount) external; /// @notice delegator unstake morph /// @param delegatee delegatee address function undelegateStake(address delegatee) external; /// @notice delegator cliam delegate staking value function claimUndelegation() external; /// @notice delegator claim reward /// @param delegatee delegatee address, claim all if address(0) /// @param targetEpochIndex up to the epoch index that the delegator wants to claim function claimReward(address delegatee, uint256 targetEpochIndex) external; /// @notice claimCommission claim unclaimed commission reward of a staker function claimCommission() external; } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; /// @title Types /// @notice Contains various types used throughout the Morph contract system. library Types { /// @notice Struct representing a staker information. /// /// @custom:field addr Address of the sequencer. /// @custom:field tmKey Tendermint key(ED25519) of the seuqencer. /// @custom:field blsKey BLS key of the seuqencer. struct StakerInfo { address addr; bytes32 tmKey; bytes blsKey; } } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; /** * @title Predeploys * @notice Contains constant addresses for contracts that are pre-deployed to the L2 system. */ library Predeploys { /** * @notice Address of the L2_TO_L1_MESSAGE_PASSER predeploy. */ address internal constant L2_TO_L1_MESSAGE_PASSER = 0x5300000000000000000000000000000000000001; /** * @notice Address of the L2_GATEWAY_ROUTER predeploy. */ address internal constant L2_GATEWAY_ROUTER = 0x5300000000000000000000000000000000000002; /** * @notice Address of the Gov predeploy. */ address internal constant GOV = 0x5300000000000000000000000000000000000004; /** * @notice Address of the L2_ETH_GATEWAY predeploy. */ address internal constant L2_ETH_GATEWAY = 0x5300000000000000000000000000000000000006; /** * @notice Address of the L2_CROSS_DOMAIN_MESSENGER predeploy. */ address internal constant L2_CROSS_DOMAIN_MESSENGER = 0x5300000000000000000000000000000000000007; /** * @notice Address of the L2_STANDARD_ERC20_GATEWAY predeploy. */ address internal constant L2_STANDARD_ERC20_GATEWAY = 0x5300000000000000000000000000000000000008; /** * @notice Address of the L2_ERC721_GATEWAY predeploy. */ address internal constant L2_ERC721_GATEWAY = 0x5300000000000000000000000000000000000009; /** * @notice Address of the L2_TX_FEE_VAULT predeploy. */ address internal constant L2_TX_FEE_VAULT = 0x530000000000000000000000000000000000000a; /** * @notice Address of the PROXY_ADMIN predeploy. */ address internal constant PROXY_ADMIN = 0x530000000000000000000000000000000000000b; /** * @notice Address of the L2_ERC1155_GATEWAY predeploy. */ address internal constant L2_ERC1155_GATEWAY = 0x530000000000000000000000000000000000000c; /** * @notice Address of the MORPH_STANDARD_ERC20 predeploy. */ address internal constant MORPH_STANDARD_ERC20 = 0x530000000000000000000000000000000000000D; /** * @notice Address of the MORPH_STANDARD_ERC20_FACTORY predeploy. */ address internal constant MORPH_STANDARD_ERC20_FACTORY = 0x530000000000000000000000000000000000000e; /** * @notice Address of the GAS_PRICE_ORACLE predeploy. Includes fee information * and helpers for computing the L1 portion of the transaction fee. */ address internal constant GAS_PRICE_ORACLE = 0x530000000000000000000000000000000000000f; /** * @notice Address of the L2_WETH_GATEWAY predeploy. */ address internal constant L2_WETH_GATEWAY = 0x5300000000000000000000000000000000000010; /** * @notice Address of the L2_WETH predeploy. */ address internal constant L2_WETH = 0x5300000000000000000000000000000000000011; /** * @notice Address of the RECORD predeploy. */ address internal constant RECORD = 0x5300000000000000000000000000000000000012; /** * @notice Address of the MORPH_TOKEN predeploy. */ address internal constant MORPH_TOKEN = 0x5300000000000000000000000000000000000013; /** * @notice Address of the DISTRIBUTE predeploy. */ address internal constant DISTRIBUTE = 0x5300000000000000000000000000000000000014; /** * @notice Address of the L2_STAKING predeploy. */ address internal constant L2_STAKING = 0x5300000000000000000000000000000000000015; /** * @notice Address of the L2_CUSTOM_ERC20_GATEWAY predeploy. */ address internal constant L2_CUSTOM_ERC20_GATEWAY = 0x5300000000000000000000000000000000000016; /** * @notice Address of the SEQUENCER predeploy. */ address internal constant SEQUENCER = 0x5300000000000000000000000000000000000017; /** * @notice Address of the L2_REVERSE_ERC20_GATEWAY predeploy. */ address internal constant L2_REVERSE_ERC20_GATEWAY = 0x5300000000000000000000000000000000000018; } // SPDX-License-Identifier: MIT pragma solidity ^0.8.9; interface ICrossDomainMessenger { /*********** * Errors * ***********/ error ErrZeroAddress(); /********** * Events * **********/ /// @notice Emitted when a cross domain message is sent. /// @param sender The address of the sender who initiates the message. /// @param target The address of target contract to call. /// @param value The amount of value passed to the target contract. /// @param messageNonce The nonce of the message. /// @param gasLimit The optional gas limit passed to L1 or L2. /// @param message The calldata passed to the target contract. event SentMessage( address indexed sender, address indexed target, uint256 value, uint256 messageNonce, uint256 gasLimit, bytes message ); /// @notice Emitted when a cross domain message is relayed successfully. /// @param messageHash The hash of the message. event RelayedMessage(bytes32 indexed messageHash); /// @notice Emitted when a cross domain message is failed to relay. /// @param messageHash The hash of the message. event FailedRelayedMessage(bytes32 indexed messageHash); /************************* * Public View Functions * *************************/ /// @notice Return the sender of a cross domain message. function xDomainMessageSender() external view returns (address); /// @notice Return the nonce of a cross domain message. function messageNonce() external view returns (uint256); /***************************** * Public Mutating Functions * *****************************/ /// @notice Send cross chain message from L1 to L2 or L2 to L1. /// @dev EOA addresses and contracts that have not implemented `onDropMessage` /// cannot execute the `dropMessage` operation. /// Please proceed with caution to control risk. /// @param target The address of account who receive the message. /// @param value The amount of ether passed when call target contract. /// @param message The content of the message. /// @param gasLimit Gas limit required to complete the message relay on corresponding chain. function sendMessage(address target, uint256 value, bytes calldata message, uint256 gasLimit) external payable; /// @notice Send cross chain message from L1 to L2 or L2 to L1. /// @dev EOA addresses and contracts that have not implemented `onDropMessage` /// cannot execute the `dropMessage` operation. /// Please proceed with caution to control risk. /// @param target The address of account who receive the message. /// @param value The amount of ether passed when call target contract. /// @param message The content of the message. /// @param gasLimit Gas limit required to complete the message relay on corresponding chain. /// @param refundAddress The address of account who will receive the refunded fee. function sendMessage( address target, uint256 value, bytes calldata message, uint256 gasLimit, address refundAddress ) external payable; } // SPDX-License-Identifier: MIT pragma solidity =0.8.24; import {ICrossDomainMessenger} from "../ICrossDomainMessenger.sol"; abstract contract Staking { /** * @notice Messenger contract on this domain. */ ICrossDomainMessenger public immutable MESSENGER; /** * @notice Corresponding staking on the other domain. */ Staking public immutable OTHER_STAKING; /** * @notice Ensures that the caller is a cross-chain message from the other staking. */ modifier onlyOtherStaking() { require( msg.sender == address(MESSENGER) && MESSENGER.xDomainMessageSender() == address(OTHER_STAKING), "staking: only other staking contract allowed" ); _; } /** * @param _messenger Address of CrossDomainMessenger on this network. * @param _otherStaking Address of the other Staking contract. */ constructor(address payable _messenger, address payable _otherStaking) { MESSENGER = ICrossDomainMessenger(_messenger); OTHER_STAKING = Staking(_otherStaking); } /** * @notice Getter for messenger contract. * * @return Messenger contract on this domain. */ function messenger() external view returns (address) { return address(MESSENGER); } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ function __Ownable_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializing { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/AddressUpgradeable.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a * constructor. * * Emits an {Initialized} event. */ modifier initializer() { bool isTopLevelCall = !_initializing; require( (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1), "Initializable: contract is already initialized" ); _initialized = 1; if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: setting the version to 255 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint8 version) { require(!_initializing && _initialized < version, "Initializable: contract is already initialized"); _initialized = version; _initializing = true; _; _initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { require(!_initializing, "Initializable: contract is initializing"); if (_initialized != type(uint8).max) { _initialized = type(uint8).max; emit Initialized(type(uint8).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint8) { return _initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _initializing; } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuardUpgradeable is Initializable { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; function __ReentrancyGuard_init() internal onlyInitializing { __ReentrancyGuard_init_unchained(); } function __ReentrancyGuard_init_unchained() internal onlyInitializing { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _status will be _NOT_ENTERED require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } /** * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a * `nonReentrant` function in the call stack. */ function _reentrancyGuardEntered() internal view returns (bool) { return _status == _ENTERED; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library AddressUpgradeable { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } // SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol) pragma solidity ^0.8.0; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }