בקשת תשלום EIP-681

ידוע גם בשם: ethereum: URI, כתובת תשלום Ethereum, ERC-681, EIP-681 payment request

הגדרה

EIP-681 הוא הצעה של Ethereum שמגדירה כתובות ethereum: לבקשות תשלום, שנושאות כתובת מקבל, מזהה שרשרת אופציונלי, ערך או העברת טוקן, ולעיתים קרובות מוצגות כקוד QR.

מה EIP-681 מגדיר

EIP-681 הוא Ethereum Improvement Proposal שמפורסם במאגר ה-EIPs ומתאר פורמט כתובת לבקשה ממישהו לשלוח ether או לקרוא לפונקציה בחוזה. הכתובת מתחילה ב-ethereum:, ואחריה כתובת היעד, @ אופציונלי ומזהה שרשרת, שם פונקציה אופציונלי ופרמטרי שאילתה. ארנק שסורק קוד כזה יכול לבנות את העסקה כדי שהמשתמש יבדוק אותה.

בקשת ether פשוטה נראית כמו ethereum:0x...@1?value=1e18. הערך ניתן ב-wei, היחידה הקטנה ביותר של ether, ומותר סימון מדעי, כך ש-1e18 פירושו ether אחד. מזהה השרשרת אומר לארנק לאיזו רשת הכוונה, למשל 1 עבור Ethereum mainnet.

העברות טוקנים

EIP-681 יכול לתאר גם קריאה לחוזה של טוקן. בהעברת טוקן, כתובת היעד היא חוזה הטוקן, הפונקציה היא transfer, והפרמטרים נותנים את המקבל ואת הסכום, כמו ב-ethereum:0xTokenContract@1/transfer?address=0xRecipient&uint256=1e6. הסכום הוא ביחידה הקטנה ביותר של הטוקן, שתלויה בספרות העשרוניות של הטוקן.

התמיכה בפורמט המלא משתנה בין ארנקים. חלק מהארנקים קוראים רק את הכתובת, וחלק מתעלמים ממזהה השרשרת או מקריאת הפונקציה, ולכן כדאי לבדוק קוד עם הארנקים שהמשלמים שלכם משתמשים בהם. המשלם צריך תמיד לבדוק את הרשת, את הטוקן ואת המקבל לפני האישור.

שאלות נפוצות

באיזו יחידה value בקישור תשלום ethereum:?

הפרמטר value הוא ב-wei, היחידה הקטנה ביותר של ether. ether אחד הוא 1e18 wei.

קוד QR של EIP-681 יכול לבקש טוקן במקום ether?

כן. הוא יכול להצביע על חוזה הטוקן עם הפונקציה transfer ולתת את המקבל ואת הסכום כפרמטרים.

למה מזהה השרשרת חשוב בקוד QR של קריפטו?

אותה כתובת יכולה להתקיים בכמה רשתות, ולכן מזהה השרשרת אומר לארנק לאיזו רשת התשלום מיועד.

מקורות ותקנים

כל המונחים