تخطي إلى المحتوى الرئيسي

الهندسة العكسية لعقد

evm
رموز التشغيل
متقدم
أوري بوميرانتس
30 ديسمبر 2021
31 دقيقة للقراءة
تعديل الصفحة (opens in a new tab)

المقدمة

لا توجد أسرار على سلسلة الكتل، كل ما يحدث يكون متسقًا، وقابلاً للتحقق، ومتاحًا للجمهور. في الوضع المثالي، يجب أن تكون العقود قد نُشر كود المصدر الخاص بها وتم التحقق منه على Etherscan (opens in a new tab). ومع ذلك، ليس هذا هو الحال دائمًا (opens in a new tab). في هذه المقالة ستتعلم كيفية إجراء الهندسة العكسية للعقود من خلال النظر إلى عقد بدون كود المصدر، 0x2510c039cc3b061d79e564b38836da87e31b342f (opens in a new tab).

توجد مترجمات عكسية، لكنها لا تنتج دائمًا نتائج قابلة للاستخدام (opens in a new tab). في هذه المقالة ستتعلم كيفية إجراء الهندسة العكسية يدويًا وفهم عقد من خلال رموز التشغيل (opens in a new tab)، بالإضافة إلى كيفية تفسير نتائج المترجم العكسي.

لتتمكن من فهم هذه المقالة، يجب أن تكون على دراية بأساسيات EVM، وأن تكون ملمًا إلى حد ما بلغة التجميع الخاصة بـ EVM. يمكنك القراءة عن هذه المواضيع هنا (opens in a new tab).

إعداد الكود القابل للتنفيذ

يمكنك الحصول على رموز التشغيل بالانتقال إلى Etherscan للعقد، والنقر على علامة التبويب Contract ثم Switch to Opcodes View. ستحصل على عرض يحتوي على رمز تشغيل واحد في كل سطر.

Opcode View from Etherscan

ولكن لتتمكن من فهم القفزات، تحتاج إلى معرفة موقع كل رمز تشغيل في الكود. للقيام بذلك، إحدى الطرق هي فتح جدول بيانات Google ولصق رموز التشغيل في العمود C. يمكنك تخطي الخطوات التالية عن طريق إنشاء نسخة من جدول البيانات المُعد مسبقًا هذا (opens in a new tab).

الخطوة التالية هي الحصول على مواقع الكود الصحيحة حتى نتمكن من فهم القفزات. سنضع حجم رمز التشغيل في العمود B، والموقع (بالنظام السداسي عشري) في العمود A. اكتب هذه الدالة في الخلية B1 ثم انسخها والصقها لبقية العمود B، حتى نهاية الكود. بعد القيام بذلك، يمكنك إخفاء العمود B.

=1+IF(REGEXMATCH(C1,"PUSH"),REGEXEXTRACT(C1,"PUSH(\d+)"),0)

أولاً، تضيف هذه الدالة بايتًا واحدًا لرمز التشغيل نفسه، ثم تبحث عن PUSH. تعتبر رموز التشغيل PUSH خاصة لأنها تحتاج إلى بايتات إضافية للقيمة التي يتم دفعها. إذا كان رمز التشغيل هو PUSH، فإننا نستخرج عدد البايتات ونضيفه.

في A1 ضع الإزاحة الأولى، صفر. ثم، في A2، ضع هذه الدالة وانسخها والصقها مرة أخرى لبقية العمود A:

=dec2hex(hex2dec(A1)+B1)

نحتاج إلى هذه الدالة لتعطينا القيمة السداسية العشرية لأن القيم التي يتم دفعها قبل القفزات (JUMP و JUMPI) تُعطى لنا بالنظام السداسي عشري.

نقطة الدخول (0x00)

يتم تنفيذ العقود دائمًا من البايت الأول. هذا هو الجزء الأولي من الكود:

الإزاحةرمز التشغيلالمكدس (بعد رمز التشغيل)
0PUSH1 0x800x80
2PUSH1 0x400x40, 0x80
4MSTOREفارغ
5PUSH1 0x040x04
7CALLDATASIZECALLDATASIZE 0x04
8LTCALLDATASIZE<4
9PUSH2 0x005e0x5E CALLDATASIZE<4
CJUMPIفارغ

يقوم هذا الكود بشيئين:

  1. كتابة 0x80 كقيمة بحجم 32 byte في مواقع الذاكرة 0x40-0x5F (يتم تخزين 0x80 في 0x5F، وتكون المواقع 0x40-0x5E كلها أصفارًا).
  2. قراءة حجم بيانات الاستدعاء. عادةً ما تتبع بيانات الاستدعاء لعقد إيثريوم واجهة التطبيق الثنائية (ABI) (opens in a new tab)، والتي تتطلب كحد أدنى أربعة بايتات لمُحدد الدالة. إذا كان حجم بيانات الاستدعاء أقل من أربعة، انتقل إلى 0x5E.

Flowchart for this portion

المعالج عند 0x5E (لبيانات الاستدعاء غير التابعة لـ ABI)

الإزاحةرمز التشغيل
5EJUMPDEST
5FCALLDATASIZE
60PUSH2 0x007c
63JUMPI

تبدأ هذه المقتطفة بـ JUMPDEST. تُلقي برامج آلة إيثريوم الافتراضية (EVM) استثناءً إذا انتقلت إلى رمز تشغيل ليس JUMPDEST. ثم تنظر إلى CALLDATASIZE، وإذا كانت "صحيحة" (أي ليست صفرًا) تنتقل إلى 0x7C. سنصل إلى ذلك أدناه.

الإزاحةرمز التشغيلالمكدس (بعد رمز التشغيل)
64CALLVALUE المقدمة بواسطة الاستدعاء. تُسمى msg.value في Solidity
65PUSH1 0x066 CALLVALUE
67PUSH1 0x000 6 CALLVALUE
69DUP3CALLVALUE 0 6 CALLVALUE
6ADUP36 CALLVALUE 0 6 CALLVALUE
6BSLOADStorage[6] CALLVALUE 0 6 CALLVALUE

لذا عندما لا توجد بيانات استدعاء، نقرأ قيمة Storage[6]. لا نعرف ما هي هذه القيمة بعد، ولكن يمكننا البحث عن المعاملات التي تلقاها العقد بدون بيانات استدعاء. المعاملات التي تقوم فقط بتحويل ETH بدون أي بيانات استدعاء (وبالتالي بدون طريقة) تظهر في Etherscan بالطريقة Transfer. في الواقع، أول معاملة تلقاها العقد على الإطلاق (opens in a new tab) هي تحويل.

إذا نظرنا في تلك المعاملة ونقرنا على Click to see More (انقر لرؤية المزيد)، نرى أن بيانات الاستدعاء، والتي تسمى بيانات الإدخال، فارغة بالفعل (0x). لاحظ أيضًا أن القيمة هي 1.559 ETH، وسيكون ذلك ذا صلة لاحقًا.

The call data is empty

بعد ذلك، انقر فوق علامة التبويب State (الحالة) وقم بتوسيع العقد الذي نقوم بهندسته العكسية (0x2510...). يمكنك أن ترى أن Storage[6] قد تغيرت بالفعل أثناء المعاملة، وإذا قمت بتغيير Hex (النظام السداسي عشري) إلى Number (رقم)، فسترى أنها أصبحت 1,559,000,000,000,000,000، وهي القيمة المحولة بوحدة wei (أضفت الفواصل للتوضيح)، والتي تتوافق مع قيمة العقد التالية.

التغيير في Storage[6]

إذا نظرنا في تغييرات الحالة الناتجة عن معاملات Transfer أخرى من نفس الفترة (opens in a new tab)، نرى أن Storage[6] تتبعت قيمة العقد لفترة من الوقت. في الوقت الحالي سنسميها Value*. تذكرنا العلامة النجمية (*) بأننا لا نعرف ما يفعله هذا المتغير بعد، ولكن لا يمكن أن يكون مجرد تتبع لقيمة العقد لأنه لا توجد حاجة لاستخدام التخزين، وهو مكلف للغاية، عندما يمكنك الحصول على رصيد حساباتك باستخدام ADDRESS BALANCE. يدفع رمز التشغيل الأول عنوان العقد نفسه. ويقرأ الثاني العنوان الموجود في أعلى المكدس ويستبدله برصيد ذلك العنوان.

الإزاحةرمز التشغيلالمكدس
6CPUSH2 0x00750x75 Value* CALLVALUE 0 6 CALLVALUE
6FSWAP2CALLVALUE Value* 0x75 0 6 CALLVALUE
70SWAP1Value* CALLVALUE 0x75 0 6 CALLVALUE
71PUSH2 0x01a70x01A7 Value* CALLVALUE 0x75 0 6 CALLVALUE
74JUMP

سنستمر في تتبع هذا الكود عند وجهة الانتقال.

الإزاحةرمز التشغيلالمكدس
1A7JUMPDESTValue* CALLVALUE 0x75 0 6 CALLVALUE
1A8PUSH1 0x000x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1AADUP3CALLVALUE 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1ABNOT2^256-CALLVALUE-1 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE

العملية NOT هي عملية على مستوى البت (bitwise)، لذا فهي تعكس قيمة كل بت في قيمة الاستدعاء.

الإزاحةرمز التشغيلالمكدس
1ACDUP3Value* 2^256-CALLVALUE-1 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1ADGTValue*>2^256-CALLVALUE-1 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1AEISZEROValue*<=2^256-CALLVALUE-1 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1AFPUSH2 0x01df0x01DF Value*<=2^256-CALLVALUE-1 0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1B2JUMPI

ننتقل إذا كانت Value* أصغر من 2^256-CALLVALUE-1 أو تساويها. يبدو هذا كمنطق لمنع تجاوز السعة (overflow). وبالفعل، نرى أنه بعد بضع عمليات غير منطقية (الكتابة في الذاكرة على وشك أن تُحذف، على سبيل المثال) عند الإزاحة 0x01DE، يتراجع العقد إذا تم اكتشاف تجاوز السعة، وهو سلوك طبيعي.

لاحظ أن حدوث مثل هذا التجاوز في السعة مستبعد للغاية، لأنه سيتطلب أن تكون قيمة الاستدعاء بالإضافة إلى Value* قابلة للمقارنة بـ 2^256 wei، أي حوالي 10^59 ETH. إجمالي المعروض من ETH، وقت الكتابة، أقل من مائتي مليون (opens in a new tab).

الإزاحةرمز التشغيلالمكدس
1DFJUMPDEST0x00 Value* CALLVALUE 0x75 0 6 CALLVALUE
1E0POPValue* CALLVALUE 0x75 0 6 CALLVALUE
1E1ADDValue*+CALLVALUE 0x75 0 6 CALLVALUE
1E2SWAP10x75 Value*+CALLVALUE 0 6 CALLVALUE
1E3JUMP

إذا وصلنا إلى هنا، احصل على Value* + CALLVALUE وانتقل إلى الإزاحة 0x75.

الإزاحةرمز التشغيلالمكدس
75JUMPDESTValue*+CALLVALUE 0 6 CALLVALUE
76SWAP10 Value*+CALLVALUE 6 CALLVALUE
77SWAP26 Value*+CALLVALUE 0 CALLVALUE
78SSTORE0 CALLVALUE

إذا وصلنا إلى هنا (وهو ما يتطلب أن تكون بيانات الاستدعاء فارغة) فإننا نضيف إلى Value* قيمة الاستدعاء. هذا يتوافق مع ما نقوله عن ما تفعله معاملات Transfer.

الإزاحةرمز التشغيل
79POP
7APOP
7BSTOP

أخيرًا، قم بمسح المكدس (وهو أمر غير ضروري) وأشر إلى النهاية الناجحة للمعاملة.

لتلخيص كل ذلك، إليك مخطط انسيابي للكود الأولي.

Entry point flowchart

المعالج عند 0x7C

لم أضع عمدًا في العنوان ما يفعله هذا المعالج. الهدف ليس تعليمك كيف يعمل هذا العقد المحدد، بل كيفية الهندسة العكسية للعقود. ستتعلم ما يفعله بنفس الطريقة التي تعلمت بها، من خلال تتبع الكود.

نصل إلى هنا من عدة أماكن:

  • إذا كانت هناك بيانات استدعاء بحجم 1 أو 2 أو 3 بايت (من الإزاحة 0x63)
  • إذا كان توقيع الطريقة غير معروف (من الإزاحات 0x42 و 0x5D)
الإزاحةرمز التشغيلالمكدس
7CJUMPDEST
7DPUSH1 0x000x00
7FPUSH2 0x009d0x9D 0x00
82PUSH1 0x030x03 0x9D 0x00
84SLOADStorage[3] 0x9D 0x00

هذه خلية تخزين أخرى، لم أتمكن من العثور عليها في أي معاملات، لذا من الصعب معرفة ما تعنيه. الكود أدناه سيوضح ذلك.

الإزاحةرمز التشغيلالمكدس
85PUSH20 0xffffffffffffffffffffffffffffffffffffffff0xff....ff Storage[3] 0x9D 0x00
9AANDStorage[3]-as-address 0x9D 0x00

تقوم رموز التشغيل هذه باقتطاع القيمة التي قرأناها من Storage[3] إلى 160 بت، وهو طول عنوان إيثريوم.

الإزاحةرمز التشغيلالمكدس
9BSWAP10x9D Storage[3]-as-address 0x00
9CJUMPStorage[3]-as-address 0x00

هذه القفزة زائدة عن الحاجة، لأننا سننتقل إلى رمز التشغيل التالي. هذا الكود ليس فعالاً من حيث استهلاك الغاز كما ينبغي أن يكون.

الإزاحةرمز التشغيلالمكدس
9DJUMPDESTStorage[3]-as-address 0x00
9ESWAP10x00 Storage[3]-as-address
9FPOPStorage[3]-as-address
A0PUSH1 0x400x40 Storage[3]-as-address
A2MLOADMem[0x40] Storage[3]-as-address

في بداية الكود تمامًا، قمنا بتعيين Mem[0x40] إلى 0x80. إذا بحثنا عن 0x40 لاحقًا، فسنرى أننا لم نقم بتغييره - لذا يمكننا افتراض أنه 0x80.

الإزاحةرمز التشغيلالمكدس
A3CALLDATASIZECALLDATASIZE 0x80 Storage[3]-as-address
A4PUSH1 0x000x00 CALLDATASIZE 0x80 Storage[3]-as-address
A6DUP30x80 0x00 CALLDATASIZE 0x80 Storage[3]-as-address
A7CALLDATACOPY0x80 Storage[3]-as-address

انسخ جميع بيانات الاستدعاء إلى الذاكرة، بدءًا من 0x80.

الإزاحةرمز التشغيلالمكدس
A8PUSH1 0x000x00 0x80 Storage[3]-as-address
AADUP10x00 0x00 0x80 Storage[3]-as-address
ABCALLDATASIZECALLDATASIZE 0x00 0x00 0x80 Storage[3]-as-address
ACDUP40x80 CALLDATASIZE 0x00 0x00 0x80 Storage[3]-as-address
ADDUP6Storage[3]-as-address 0x80 CALLDATASIZE 0x00 0x00 0x80 Storage[3]-as-address
AEGASGAS Storage[3]-as-address 0x80 CALLDATASIZE 0x00 0x00 0x80 Storage[3]-as-address
AFDELEGATE_CALL

الآن أصبحت الأمور أكثر وضوحًا. يمكن أن يعمل هذا العقد كـ وكيل (opens in a new tab)، حيث يستدعي العنوان الموجود في Storage[3] للقيام بالعمل الحقيقي. يستدعي DELEGATE_CALL عقدًا منفصلاً، ولكنه يبقى في نفس مساحة التخزين. هذا يعني أن العقد المفوض، الذي نعمل كوكيل له، يصل إلى نفس مساحة التخزين. معلمات الاستدعاء هي:

  • الغاز: كل الغاز المتبقي
  • العنوان المستدعى: Storage[3]-as-address
  • بيانات الاستدعاء: بايتات CALLDATASIZE بدءًا من 0x80، وهو المكان الذي وضعنا فيه بيانات الاستدعاء الأصلية
  • بيانات الإرجاع: لا شيء (0x00 - 0x00) سنحصل على بيانات الإرجاع بوسائل أخرى (انظر أدناه)
الإزاحةرمز التشغيلالمكدس
B0RETURNDATASIZERETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B1DUP1RETURNDATASIZE RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B2PUSH1 0x000x00 RETURNDATASIZE RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B4DUP50x80 0x00 RETURNDATASIZE RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B5RETURNDATACOPYRETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address

هنا نقوم بنسخ جميع بيانات الإرجاع إلى المخزن المؤقت للذاكرة بدءًا من 0x80.

الإزاحةرمز التشغيلالمكدس
B6DUP2(((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B7DUP1(((call success/failure))) (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B8ISZERO(((did the call fail))) (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
B9PUSH2 0x00c00xC0 (((did the call fail))) (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
BCJUMPI(((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
BDDUP2RETURNDATASIZE (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
BEDUP50x80 RETURNDATASIZE (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
BFRETURN

لذا بعد الاستدعاء، نقوم بنسخ بيانات الإرجاع إلى المخزن المؤقت 0x80 - 0x80+RETURNDATASIZE، وإذا كان الاستدعاء ناجحًا، فإننا نقوم بـ RETURN باستخدام هذا المخزن المؤقت بالضبط.

فشل DELEGATECALL

إذا وصلنا إلى هنا، إلى 0xC0، فهذا يعني أن العقد الذي استدعيناه قد تراجع. وبما أننا مجرد وكيل لهذا العقد، فإننا نريد إرجاع نفس البيانات والتراجع أيضًا.

الإزاحةرمز التشغيلالمكدس
C0JUMPDEST(((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
C1DUP2RETURNDATASIZE (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
C2DUP50x80 RETURNDATASIZE (((call success/failure))) RETURNDATASIZE (((call success/failure))) 0x80 Storage[3]-as-address
C3REVERT

لذا نقوم بـ REVERT بنفس المخزن المؤقت الذي استخدمناه لـ RETURN سابقًا: 0x80 - 0x80+RETURNDATASIZE

Call to proxy flowchart

استدعاءات ABI

إذا كان حجم بيانات الاستدعاء أربعة بايتات أو أكثر، فقد يكون هذا استدعاء ABI صالحًا.

الإزاحةرمز التشغيلالمكدس
DPUSH1 0x000x00
FCALLDATALOAD(((الكلمة الأولى (256 بت) من بيانات الاستدعاء)))
10PUSH1 0xe00xE0 (((الكلمة الأولى (256 بت) من بيانات الاستدعاء)))
12SHR(((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))

يخبرنا Etherscan أن 1C هو رمز تشغيل غير معروف، لأنه تمت إضافته بعد أن برمج Etherscan هذه الميزة (opens in a new tab) ولم يقوموا بتحديثها. يوضح لنا جدول رموز التشغيل المُحدَّث (opens in a new tab) أن هذا يعني إزاحة لليمين.

الإزاحةرمز التشغيلالمكدس
13DUP1(((أول 32 بت (4 بايتات) من بيانات الاستدعاء))) (((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))
14PUSH4 0x3cd8045e0x3CD8045E (((أول 32 بت (4 بايتات) من بيانات الاستدعاء))) (((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))
19GT0x3CD8045E>first-32-bits-of-the-call-data (((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))
1APUSH2 0x00430x43 0x3CD8045E>first-32-bits-of-the-call-data (((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))
1DJUMPI(((أول 32 بت (4 بايتات) من بيانات الاستدعاء)))

من خلال تقسيم اختبارات مطابقة توقيع الطريقة إلى قسمين بهذا الشكل، يتم توفير نصف الاختبارات في المتوسط. يتبع الكود الذي يلي هذا مباشرة والكود الموجود في 0x43 نفس النمط: DUP1 أول 32 بت من بيانات الاستدعاء، PUSH4 (((method signature>، ثم تشغيل EQ للتحقق من التطابق، وبعد ذلك JUMPI إذا كان توقيع الطريقة متطابقًا. إليك تواقيع الطرق، وعناوينها، وتعريف الطريقة المقابل (opens in a new tab) إذا كان معروفًا:

الطريقةتوقيع الطريقةالإزاحة للانتقال إليها
splitter() (opens in a new tab)0x3cd8045e0x0103
???0x81e580d30x0138
currentWindow() (opens in a new tab)0xba0bafb40x0158
???0x1f1358230x00C4
merkleRoot() (opens in a new tab)0x2eb4a7ab0x00ED

إذا لم يتم العثور على تطابق، ينتقل الكود إلى معالج الوكيل عند 0x7C، على أمل أن يكون لدى العقد الذي نعمل كوكيل له تطابق.

ABI calls flowchart

splitter()

الإزاحةرمز التشغيلالمكدس
103JUMPDEST
104CALLVALUECALLVALUE
105DUP1CALLVALUE CALLVALUE
106ISZEROCALLVALUE==0 CALLVALUE
107PUSH2 0x010f0x010F CALLVALUE==0 CALLVALUE
10AJUMPICALLVALUE
10BPUSH1 0x000x00 CALLVALUE
10DDUP10x00 0x00 CALLVALUE
10EREVERT

أول شيء تفعله هذه الدالة هو التحقق من أن الاستدعاء لم يرسل أي ETH. هذه الدالة ليست payable (opens in a new tab). إذا أرسل لنا شخص ما ETH، فلا بد أن يكون ذلك خطأ ونريد التراجع (REVERT) لتجنب بقاء ETH في مكان لا يمكنهم استرداده منه.

الإزاحةرمز التشغيلالمكدس
10FJUMPDEST
110POP
111PUSH1 0x030x03
113SLOAD(((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له)))
114PUSH1 0x400x40 (((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له)))
116MLOAD0x80 (((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له)))
117PUSH20 0xffffffffffffffffffffffffffffffffffffffff0xFF...FF 0x80 (((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له)))
12CSWAP10x80 0xFF...FF (((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له)))
12DSWAP2(((Storage[3] المعروف أيضًا باسم العقد الذي نعتبر عقد وكيل له))) 0xFF...FF 0x80
12EANDProxyAddr 0x80
12FDUP20x80 ProxyAddr 0x80
130MSTORE0x80

ويحتوي 0x80 الآن على عنوان الوكيل

الإزاحةرمز التشغيلالمكدس
131PUSH1 0x200x20 0x80
133ADD0xA0
134PUSH2 0x00e40xE4 0xA0
137JUMP0xA0

كود E4

هذه هي المرة الأولى التي نرى فيها هذه الأسطر، لكنها مشتركة مع طرق أخرى (انظر أدناه). لذلك سنطلق على القيمة في المكدس اسم X، وتذكر فقط أنه في splitter() تكون قيمة X هذه هي 0xA0.

الإزاحةرمز التشغيلالمكدس
E4JUMPDESTX
E5PUSH1 0x400x40 X
E7MLOAD0x80 X
E8DUP10x80 0x80 X
E9SWAP2X 0x80 0x80
EASUBX-0x80 0x80
EBSWAP10x80 X-0x80
ECRETURN

إذن، يتلقى هذا الكود مؤشر ذاكرة في المكدس (X)، ويجعل العقد ينفذ RETURN مع مخزن مؤقت بحجم 0x80 - X.

في حالة splitter()، يُرجع هذا العنوان الذي نعتبر عقد وكيل له. يُرجع RETURN المخزن المؤقت في النطاق 0x80-0x9F، وهو المكان الذي كتبنا فيه هذه البيانات (الإزاحة 0x130 أعلاه).

currentWindow()

الكود في الإزاحات 0x158-0x163 مطابق لما رأيناه في 0x103-0x10E في splitter() (باستثناء وجهة JUMPI)، لذلك نعلم أن currentWindow() ليس أيضًا payable.

الإزاحةرمز التشغيلالمكدس
164JUMPDEST
165POP
166PUSH2 0x00da0xDA
169PUSH1 0x010x01 0xDA
16BSLOADStorage[1] 0xDA
16CDUP20xDA Storage[1] 0xDA
16DJUMPStorage[1] 0xDA

كود DA

هذا الكود مشترك أيضًا مع دوال أخرى. لذلك سنسمي القيمة في المكدس Y، ونتذكر فقط أنه في currentWindow() قيمة Y هذه هي Storage[1].

الإزاحةرمز التشغيلالمكدس
DAJUMPDESTY 0xDA
DBPUSH1 0x400x40 Y 0xDA
DDMLOAD0x80 Y 0xDA
DESWAP1Y 0x80 0xDA
DFDUP20x80 Y 0x80 0xDA
E0MSTORE0x80 0xDA

اكتب Y في 0x80-0x9F.

الإزاحةرمز التشغيلالمكدس
E1PUSH1 0x200x20 0x80 0xDA
E3ADD0xA0 0xDA

والباقي مشروح بالفعل أعلاه. لذا فإن القفزات إلى 0xDA تكتب أعلى المكدس (Y) في 0x80-0x9F، وتُرجع تلك القيمة. في حالة currentWindow()، فإنها تُرجع Storage[1].

merkleRoot()

الكود في الإزاحات 0xED-0xF8 مطابق لما رأيناه في 0x103-0x10E في splitter() (باستثناء وجهة JUMPI)، لذا نعلم أن merkleRoot() ليس أيضًا payable.

الإزاحةرمز التشغيلالمكدس
F9JUMPDEST
FAPOP
FBPUSH2 0x00da0xDA
FEPUSH1 0x000x00 0xDA
100SLOADStorage[0] 0xDA
101DUP20xDA Storage[0] 0xDA
102JUMPStorage[0] 0xDA

ما يحدث بعد القفزة اكتشفناه بالفعل. لذا يُرجع merkleRoot() القيمة Storage[0].

0x81e580d3

الرمز في الإزاحات 0x138-0x143 مطابق لما رأيناه في 0x103-0x10E في splitter() (باستثناء الوجهة JUMPI)، لذلك نعلم أن هذه الدالة ليست payable أيضًا.

الإزاحةرمز التشغيلالمكدس
144JUMPDEST
145POP
146PUSH2 0x00da0xDA
149PUSH2 0x01530x0153 0xDA
14CCALLDATASIZECALLDATASIZE 0x0153 0xDA
14DPUSH1 0x040x04 CALLDATASIZE 0x0153 0xDA
14FPUSH2 0x018f0x018F 0x04 CALLDATASIZE 0x0153 0xDA
152JUMP0x04 CALLDATASIZE 0x0153 0xDA
18FJUMPDEST0x04 CALLDATASIZE 0x0153 0xDA
190PUSH1 0x000x00 0x04 CALLDATASIZE 0x0153 0xDA
192PUSH1 0x200x20 0x00 0x04 CALLDATASIZE 0x0153 0xDA
194DUP30x04 0x20 0x00 0x04 CALLDATASIZE 0x0153 0xDA
195DUP5CALLDATASIZE 0x04 0x20 0x00 0x04 CALLDATASIZE 0x0153 0xDA
196SUBCALLDATASIZE-4 0x20 0x00 0x04 CALLDATASIZE 0x0153 0xDA
197SLTCALLDATASIZE-4<32 0x00 0x04 CALLDATASIZE 0x0153 0xDA
198ISZEROCALLDATASIZE-4>=32 0x00 0x04 CALLDATASIZE 0x0153 0xDA
199PUSH2 0x01a00x01A0 CALLDATASIZE-4>=32 0x00 0x04 CALLDATASIZE 0x0153 0xDA
19CJUMPI0x00 0x04 CALLDATASIZE 0x0153 0xDA

يبدو أن هذه الدالة تأخذ 32 بايت (كلمة واحدة) على الأقل من بيانات الاستدعاء.

الإزاحةرمز التشغيلالمكدس
19DDUP10x00 0x00 0x04 CALLDATASIZE 0x0153 0xDA
19EDUP20x00 0x00 0x00 0x04 CALLDATASIZE 0x0153 0xDA
19FREVERT

إذا لم تحصل على بيانات الاستدعاء، تتراجع المعاملة دون أي بيانات إرجاع.

دعونا نرى ما يحدث إذا حصلت الدالة بالفعل على بيانات الاستدعاء التي تحتاجها.

الإزاحةرمز التشغيلالمكدس
1A0JUMPDEST0x00 0x04 CALLDATASIZE 0x0153 0xDA
1A1POP0x04 CALLDATASIZE 0x0153 0xDA
1A2CALLDATALOADcalldataload(4) CALLDATASIZE 0x0153 0xDA

calldataload(4) هي الكلمة الأولى من بيانات الاستدعاء بعد توقيع الطريقة

الإزاحةرمز التشغيلالمكدس
1A3SWAP20x0153 CALLDATASIZE calldataload(4) 0xDA
1A4SWAP1CALLDATASIZE 0x0153 calldataload(4) 0xDA
1A5POP0x0153 calldataload(4) 0xDA
1A6JUMPcalldataload(4) 0xDA
153JUMPDESTcalldataload(4) 0xDA
154PUSH2 0x016e0x016E calldataload(4) 0xDA
157JUMPcalldataload(4) 0xDA
16EJUMPDESTcalldataload(4) 0xDA
16FPUSH1 0x040x04 calldataload(4) 0xDA
171DUP2calldataload(4) 0x04 calldataload(4) 0xDA
172DUP20x04 calldataload(4) 0x04 calldataload(4) 0xDA
173SLOADStorage[4] calldataload(4) 0x04 calldataload(4) 0xDA
174DUP2calldataload(4) Storage[4] calldataload(4) 0x04 calldataload(4) 0xDA
175LTcalldataload(4)<Storage[4] calldataload(4) 0x04 calldataload(4) 0xDA
176PUSH2 0x017e0x017EC calldataload(4)<Storage[4] calldataload(4) 0x04 calldataload(4) 0xDA
179JUMPIcalldataload(4) 0x04 calldataload(4) 0xDA

إذا لم تكن الكلمة الأولى أقل من Storage[4]، تفشل الدالة. وتتراجع دون أي قيمة مُرجعة:

الإزاحةرمز التشغيلالمكدس
17APUSH1 0x000x00 ...
17CDUP10x00 0x00 ...
17DREVERT

إذا كانت calldataload(4) أقل من Storage[4]، نحصل على هذا الرمز:

الإزاحةرمز التشغيلالمكدس
17EJUMPDESTcalldataload(4) 0x04 calldataload(4) 0xDA
17FPUSH1 0x000x00 calldataload(4) 0x04 calldataload(4) 0xDA
181SWAP20x04 calldataload(4) 0x00 calldataload(4) 0xDA
182DUP30x00 0x04 calldataload(4) 0x00 calldataload(4) 0xDA
183MSTOREcalldataload(4) 0x00 calldataload(4) 0xDA

وتحتوي مواقع الذاكرة 0x00-0x1F الآن على البيانات 0x04 (جميع 0x00-0x1E أصفار، و 0x1F هي أربعة)

الإزاحةرمز التشغيلالمكدس
184PUSH1 0x200x20 calldataload(4) 0x00 calldataload(4) 0xDA
186SWAP1calldataload(4) 0x20 0x00 calldataload(4) 0xDA
187SWAP20x00 0x20 calldataload(4) calldataload(4) 0xDA
188SHA3(((SHA3 of 0x00-0x1F))) calldataload(4) calldataload(4) 0xDA
189ADD(((SHA3 of 0x00-0x1F)))+calldataload(4) calldataload(4) 0xDA
18ASLOADStorage[(((SHA3 of 0x00-0x1F))) + calldataload(4)] calldataload(4) 0xDA

لذا يوجد جدول بحث في التخزين، والذي يبدأ عند SHA3 لـ 0x000...0004 ويحتوي على إدخال لكل قيمة بيانات استدعاء مشروعة (القيمة أقل من Storage[4]).

الإزاحةرمز التشغيلالمكدس
18BSWAP1calldataload(4) Storage[(((SHA3 of 0x00-0x1F))) + calldataload(4)] 0xDA
18CPOPStorage[(((SHA3 of 0x00-0x1F))) + calldataload(4)] 0xDA
18DDUP20xDA Storage[(((SHA3 of 0x00-0x1F))) + calldataload(4)] 0xDA
18EJUMPStorage[(((SHA3 of 0x00-0x1F))) + calldataload(4)] 0xDA

نحن نعلم بالفعل ما يفعله الرمز عند الإزاحة 0xDA، فهو يُرجع القيمة العليا للمكدس إلى المستدعي. لذا تُرجع هذه الدالة القيمة من جدول البحث إلى المستدعي.

0x1f135823

الكود في الإزاحات 0xC4-0xCF مطابق لما رأيناه في 0x103-0x10E في splitter() (باستثناء الوجهة JUMPI)، لذلك نعلم أن هذه الدالة ليست payable أيضًا.

الإزاحةرمز التشغيلالمكدس
D0JUMPDEST
D1POP
D2PUSH2 0x00da0xDA
D5PUSH1 0x060x06 0xDA
D7SLOADValue* 0xDA
D8DUP20xDA Value* 0xDA
D9JUMPValue* 0xDA

نحن نعلم بالفعل ما يفعله الكود عند الإزاحة 0xDA، فهو يُرجع القيمة العليا في المكدس إلى المستدعي. لذلك تُرجع هذه الدالة Value*.

ملخص الطرق

هل تشعر أنك تفهم العقد في هذه المرحلة؟ أنا لا أشعر بذلك. حتى الآن لدينا هذه الطرق:

الطريقةالمعنى
تحويلقبول القيمة المقدمة بواسطة الاستدعاء وزيادة Value* بهذا المقدار
splitter()إرجاع Storage[3]، عنوان العقد الوكيل
currentWindow()إرجاع Storage[1]
merkleRoot()إرجاع Storage[0]
0x81e580d3إرجاع القيمة من جدول بحث، بشرط أن تكون المعلمة أقل من Storage[4]
0x1f135823إرجاع Storage[6]، والمعروف أيضًا باسم Value*

لكننا نعلم أن أي وظيفة أخرى يتم توفيرها بواسطة العقد في Storage[3]. ربما إذا عرفنا ما هو هذا العقد، فسيعطينا ذلك دليلًا. لحسن الحظ، هذه هي سلسلة الكتل وكل شيء معروف، على الأقل نظريًا. لم نر أي طرق تقوم بتعيين Storage[3]، لذلك لابد أنه تم تعيينه بواسطة المُنشئ.

المُنشئ

عندما ننظر إلى عقد (opens in a new tab)، يمكننا أيضًا رؤية المعاملة التي أنشأته.

Click the create transaction

إذا نقرنا على تلك المعاملة، ثم على علامة التبويب الحالة، يمكننا رؤية القيم الأولية للمعلمات. على وجه التحديد، يمكننا أن نرى أن Storage[3] يحتوي على 0x2f81e57ff4f4d83b40a9f719fd892d8e806e0761 (opens in a new tab). يجب أن يحتوي ذلك العقد على الوظيفة المفقودة. يمكننا فهمه باستخدام نفس الأدوات التي استخدمناها للعقد الذي نحقق فيه.

العقد الوكيل

باستخدام نفس التقنيات التي استخدمناها للعقد الأصلي أعلاه، يمكننا أن نرى أن العقد يتراجع في الحالات التالية:

  • إذا كان هناك أي ETH مرفق بالاستدعاء (0x05-0x0F)
  • إذا كان حجم بيانات الاستدعاء أقل من أربعة (0x10-0x19 و 0xBE-0xC2)

وأن الطرق التي يدعمها هي:

يمكننا تجاهل الطرق الأربع السفلية لأننا لن نصل إليها أبدًا. تواقيعها تجعل العقد الأصلي الخاص بنا يتولى أمرها بنفسه (يمكنك النقر على التواقيع لرؤية التفاصيل أعلاه)، لذا يجب أن تكون طرقًا تم تجاوزها (opens in a new tab).

إحدى الطرق المتبقية هي claim(<params>)، وأخرى هي isClaimed(<params>)، لذا يبدو أنه عقد إسقاط جوي. بدلاً من المرور عبر الباقي رمز تشغيل برمز تشغيل، يمكننا تجربة أداة فك التجميع (opens in a new tab)، والتي تنتج نتائج قابلة للاستخدام لثلاث دوال من هذا العقد. تُترك الهندسة العكسية للدوال الأخرى كتمرين للقارئ.

scaleAmountByPercentage

هذا ما تقدمه لنا أداة فك التجميع لهذه الدالة:

def unknown8ffb5c97(uint256 _param1, uint256 _param2) payable:
  require calldata.size - 4 >=64
  if _param1 and _param2 > -1 / _param1:
      revert with 0, 17
  return (_param1 * _param2 / 100 * 10^6)

يختبر require الأول أن بيانات الاستدعاء تحتوي، بالإضافة إلى البايتات الأربعة لتوقيع الدالة، على 64 بايت على الأقل، وهو ما يكفي للمعلمتين. إذا لم يكن الأمر كذلك، فمن الواضح أن هناك خطأ ما.

يبدو أن عبارة if تتحقق من أن _param1 ليس صفرًا، وأن _param1 * _param2 ليس سالبًا. من المحتمل أن يكون هذا لمنع حالات الالتفاف (wrap around).

أخيرًا، تُرجع الدالة قيمة متناسبة.

claim

الكود الذي تنشئه أداة فك التجميع معقد، وليس كله ذا صلة بنا. سأتخطى بعضًا منه للتركيز على الأسطر التي أعتقد أنها توفر معلومات مفيدة

def unknown2e7ba6ef(uint256 _param1, uint256 _param2, uint256 _param3, array _param4) payable:
  ...
  require _param2 == addr(_param2)
  ...
  if currentWindow <= _param1:
      revert with 0, 'cannot claim for a future window'

نرى هنا شيئين مهمين:

  • _param2، على الرغم من الإعلان عنه كـ uint256، هو في الواقع عنوان
  • _param1 هي النافذة التي تتم المطالبة بها، والتي يجب أن تكون currentWindow أو أقدم.
  ...
  if stor5[_claimWindow][addr(_claimFor)]:
      revert with 0, 'Account already claimed the given window'

لذا نعلم الآن أن Storage[5] عبارة عن مصفوفة من النوافذ والعناوين، وما إذا كان العنوان قد طالب بالمكافأة لتلك النافذة.

نعلم أن unknown2eb4a7ab هي في الواقع الدالة merkleRoot()، لذا يبدو أن هذا الكود يتحقق من إثبات ميركل (opens in a new tab). هذا يعني أن _param4 هو إثبات ميركل.

  call addr(_param2) with:
     value unknown81e580d3[_param1] * _param3 / 100 * 10^6 wei
       gas 30000 wei

هذه هي الطريقة التي يقوم بها العقد بتحويل ETH الخاص به إلى عنوان آخر (عقد أو مملوك خارجيًا). يقوم باستدعائه بقيمة تمثل المبلغ المراد تحويله. لذا يبدو أن هذا إسقاط جوي لـ ETH.

  if not return_data.size:
      if not ext_call.success:
          require ext_code.size(stor2)
          call stor2.deposit() with:
             value unknown81e580d3[_param1] * _param3 / 100 * 10^6 wei

يخبرنا السطران السفليان أن Storage[2] هو أيضًا عقد نقوم باستدعائه. إذا نظرنا إلى معاملة المُنشئ (opens in a new tab) نرى أن هذا العقد هو 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 (opens in a new tab)، وهو عقد إيثر مغلف (WETH) تم رفع كود المصدر الخاص به إلى Etherscan (opens in a new tab).

لذا يبدو أن العقد يحاول إرسال ETH إلى _param2. إذا تمكن من ذلك، فهذا رائع. وإذا لم يتمكن، فإنه يحاول إرسال WETH (opens in a new tab). إذا كان _param2 حسابًا مملوكًا خارجيًا (EOA) فيمكنه دائمًا تلقي ETH، لكن العقود يمكنها رفض تلقي ETH. ومع ذلك، فإن WETH هو ERC-20 ولا يمكن للعقود رفض قبوله.

  ...
  log 0xdbd5389f: addr(_param2), unknown81e580d3[_param1] * _param3 / 100 * 10^6, bool(ext_call.success)

في نهاية الدالة نرى أنه يتم إنشاء إدخال سجل. انظر إلى إدخالات السجل التي تم إنشاؤها (opens in a new tab) وقم بالتصفية حسب الموضوع الذي يبدأ بـ 0xdbd5.... إذا نقرنا على إحدى المعاملات التي أنشأت مثل هذا الإدخال (opens in a new tab) نرى أنه يبدو بالفعل كمطالبة - أرسل الحساب رسالة إلى العقد الذي نقوم بهندسته عكسيًا، وفي المقابل حصل على ETH.

A claim transaction

1e7df9d3

هذه الدالة مشابهة جدًا لـ claim أعلاه. كما أنها تتحقق من إثبات ميركل، وتحاول تحويل ETH إلى الأول، وتنتج نفس النوع من إدخال السجل.

الفرق الرئيسي هو أن المعلمة الأولى، وهي النافذة المراد سحبها، غير موجودة. بدلاً من ذلك، هناك حلقة تكرار عبر جميع النوافذ التي يمكن المطالبة بها.

لذا يبدو أنه متغير من claim يطالب بجميع النوافذ.

الخاتمة

بحلول الآن، يجب أن تكون قد عرفت كيفية فهم العقود التي لا يتوفر كودها المصدري، باستخدام إما رموز التشغيل أو (عندما تنجح) أداة فك التجميع. وكما هو واضح من طول هذا المقال، فإن الهندسة العكسية لعقد ليست أمراً بسيطاً، ولكن في نظام يكون فيه الأمان أمراً بالغ الأهمية، فإن القدرة على التحقق من أن العقود تعمل كما هو موعود تعد مهارة مهمة.

انظر هنا للمزيد من أعمالي (opens in a new tab).

آخر تحديث للصفحة: 3 أبريل 2026