معيار الرمز المميز ⁦ERC-20⁩

مقدمة

ما هو الرمز المميز؟

يمكن أن تمثل الرموز المميزة أي شيء تقريبًا في إيثيريوم:

نقاط السمعة في منصة عبر الإنترنت
مهارات شخصية في لعبة
الأصول المالية مثل حصة في شركة
عملة ورقية مثل الدولار الأمريكي (USD)
أوقية من الذهب
والمزيد...

يجب التعامل مع هذه الميزة القوية في إيثيريوم بواسطة معيار قوي، أليس كذلك؟ هذا بالضبط هو الدور الذي يلعبه ERC-20! يسمح هذا المعيار للمطورين ببناء تطبيقات رموز مميزة قابلة للتشغيل البيني مع المنتجات والخدمات الأخرى. يُستخدم معيار ERC-20 أيضًا لتوفير وظائف إضافية لـ .

ما هو ERC-20؟

يقدم ERC-20 معيارًا للرموز القابلة للاستبدال، وبعبارة أخرى، تمتلك خاصية تجعل كل رمز مميز مطابقًا تمامًا (في النوع والقيمة) لرمز مميز آخر. على سبيل المثال، يعمل الرمز المميز ERC-20 تمامًا مثل ETH، مما يعني أن رمزًا مميزًا واحدًا يساوي وسيظل دائمًا مساويًا لجميع الرموز المميزة الأخرى.

المتطلبات الأساسية

المحتوى

معيار ERC-20 (طلب تعليقات إيثيريوم 20)، الذي اقترحه فابيان فوغلستيلر في نوفمبر 2015، هو معيار رمز مميز ينفذ واجهة برمجة تطبيقات (API) للرموز المميزة داخل العقود الذكية.

أمثلة على الوظائف التي يوفرها ERC-20:

تحويل الرموز المميزة من حساب إلى آخر
الحصول على رصيد الرمز المميز الحالي لحساب ما
الحصول على إجمالي المعروض من الرمز المميز المتاح على الشبكة
الموافقة على ما إذا كان يمكن إنفاق كمية من الرمز المميز من حساب بواسطة حساب طرف ثالث

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

من EIP-20 (opens in a new tab):

الطرق

function name() public view returns (string)
function symbol() public view returns (string)
function decimals() public view returns (uint8)
function totalSupply() public view returns (uint256)
function balanceOf(address _owner) public view returns (uint256 balance)
function transfer(address _to, uint256 _value) public returns (bool success)
function transferFrom(address _from, address _to, uint256 _value) public returns (bool success)
function approve(address _spender, uint256 _value) public returns (bool success)
function allowance(address _owner, address _spender) public view returns (uint256 remaining)

الأحداث

event Transfer(address indexed _from, address indexed _to, uint256 _value)
event Approval(address indexed _owner, address indexed _spender, uint256 _value)

أمثلة

دعونا نرى كيف أن المعيار مهم جدًا لجعل الأمور بسيطة بالنسبة لنا لفحص أي عقد رمز مميز ERC-20 على إيثيريوم. نحن نحتاج فقط إلى واجهة التطبيق الثنائية للعقد (ABI) لإنشاء واجهة لأي رمز مميز ERC-20. كما ترى أدناه، سنستخدم ABI مبسطًا، لجعله مثالًا سهل الفهم.

مثال Web3.py

أولاً، تأكد من تثبيت مكتبة Python Web3.py (opens in a new tab):

pip install web3

from web3 import Web3


w3 = Web3(Web3.HTTPProvider("https://cloudflare-eth.com"))

dai_token_addr = "0x6B175474E89094C44Da98b954EedeAC495271d0F"     # DAI
weth_token_addr = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"    # إيثر مغلف (WETH)

acc_address = "0xA478c2975Ab1Ea89e8196811F51A7B7Ade33eB11"        # يونيسواب V2: DAI 2

# هذه واجهة تطبيق ثنائية (ABI) مبسطة لعقد رمز مميز ERC-20.
# ستعرض فقط الطرق: balanceOf(address) و decimals() و symbol() و totalSupply()
simplified_abi = [
    {
        'inputs': [{'internalType': 'address', 'name': 'account', 'type': 'address'}],
        'name': 'balanceOf',
        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'decimals',
        'outputs': [{'internalType': 'uint8', 'name': '', 'type': 'uint8'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'symbol',
        'outputs': [{'internalType': 'string', 'name': '', 'type': 'string'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'totalSupply',
        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    }
]

dai_contract = w3.eth.contract(address=w3.to_checksum_address(dai_token_addr), abi=simplified_abi)
symbol = dai_contract.functions.symbol().call()
decimals = dai_contract.functions.decimals().call()
totalSupply = dai_contract.functions.totalSupply().call() / 10**decimals
addr_balance = dai_contract.functions.balanceOf(acc_address).call() / 10**decimals

#  DAI
print("===== %s =====" % symbol)
print("Total Supply:", totalSupply)
print("Addr Balance:", addr_balance)

weth_contract = w3.eth.contract(address=w3.to_checksum_address(weth_token_addr), abi=simplified_abi)
symbol = weth_contract.functions.symbol().call()
decimals = weth_contract.functions.decimals().call()
totalSupply = weth_contract.functions.totalSupply().call() / 10**decimals
addr_balance = weth_contract.functions.balanceOf(acc_address).call() / 10**decimals

#  WETH
print("===== %s =====" % symbol)
print("Total Supply:", totalSupply)
print("Addr Balance:", addr_balance)

المشكلات المعروفة

مشكلة استقبال الرمز المميز ERC-20

اعتبارًا من 06/20/2024، فُقد ما لا يقل عن $83,656,418 من الرموز المميزة ERC-20 بسبب هذه المشكلة. لاحظ أن تنفيذ ERC-20 النقي عُرضة لهذه المشكلة ما لم تقم بتنفيذ مجموعة من القيود الإضافية فوق المعيار كما هو موضح أدناه.

عندما يتم إرسال الرموز المميزة ERC-20 إلى عقد ذكي غير مصمم للتعامل مع الرموز المميزة ERC-20، يمكن أن تُفقد هذه الرموز المميزة بشكل دائم. يحدث هذا لأن العقد المستلم لا يمتلك الوظيفة للتعرف على الرموز المميزة الواردة أو الاستجابة لها، ولا توجد آلية في معيار ERC-20 لإخطار العقد المستلم بالرموز المميزة الواردة. الطرق الرئيسية التي تتخذها هذه المشكلة هي من خلال:

آلية تحويل الرمز المميز

يتم تحويل الرموز المميزة ERC-20 باستخدام دوال التحويل أو التحويل من (transfer أو transferFrom)
- عندما يرسل المستخدم رموزًا مميزة إلى عنوان عقد باستخدام هذه الدوال، يتم تحويل الرموز المميزة بغض النظر عما إذا كان العقد المستلم مصممًا للتعامل معها

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

الحلول الممكنة

على الرغم من أنه ليس من الممكن منع هذه المشكلة مع ERC-20 تمامًا، إلا أن هناك طرقًا تسمح بتقليل احتمالية فقدان الرموز المميزة للمستخدم النهائي بشكل كبير:

المشكلة الأكثر شيوعًا هي عندما يرسل المستخدم رموزًا مميزة إلى عنوان عقد الرمز المميز نفسه (على سبيل المثال، إيداع USDT في عنوان عقد الرمز المميز USDT). يوصى بتقييد دالة transfer(..) للتراجع عن محاولات التحويل هذه. فكر في إضافة فحص require(_to != address(this)); ضمن تنفيذ دالة transfer(..).
دالة transfer(..) بشكل عام ليست مصممة لإيداع الرموز المميزة في العقود. يُستخدم نمط approve(..) & transferFrom(..) لإيداع الرموز المميزة ERC-20 في العقود بدلاً من ذلك. من الممكن تقييد دالة التحويل لعدم السماح بإيداع الرموز المميزة في أي عقود بها، ومع ذلك قد يؤدي ذلك إلى كسر التوافق مع العقود التي تفترض أنه يمكن إيداع الرموز المميزة في العقود باستخدام دالة transfer(..) (على سبيل المثال، مجمعات سيولة يونيسواب).
افترض دائمًا أن الرموز المميزة ERC-20 يمكن أن ينتهي بها المطاف في عقدك حتى لو لم يكن من المفترض أن يتلقى عقدك أيًا منها. لا توجد طريقة لمنع أو رفض الإيداعات العرضية من جانب المستلم. يوصى بتنفيذ دالة تسمح باستخراج الرموز المميزة ERC-20 المودعة عن طريق الخطأ.
فكر في استخدام معايير رموز مميزة بديلة.

ظهرت بعض المعايير البديلة من هذه المشكلة مثل ERC-223 أو ERC-1363.

قراءة إضافية

معايير الرموز القابلة للاستبدال الأخرى

برامج تعليمية: البناء باستخدام ERC-20 على إيثيريوم

جولة في عقد ERC-20 – جولة مشروحة سطرًا بسطر لتنفيذ عقد أوبن زبلن ERC-20.
ERC-20 مع حواجز الأمان – كيفية إضافة ضمانات إلى الرموز المميزة ERC-20 لمساعدة المستخدمين على تجنب الأخطاء الشائعة.
إرسال الرموز المميزة باستخدام Ethers.js – دليل مناسب للمبتدئين لتحويل الرموز المميزة ERC-20 باستخدام Ethers.js.
بعض الحيل التي تستخدمها الرموز المميزة الاحتيالية وكيفية اكتشافها – استكشاف مفصل لأنماط الرموز المميزة ERC-20 الاحتيالية وكيفية التعرف عليها.