רישום ב-DefiLlama: מדוע TVL של הפרויקט מחושב לא נכון
אגרגטורים ציבוריים מחשבים את השווי הנעול לא לפי החשבונאות שלכם, אלא לפי אירועים ברשת: האדפטר עובר על כתובות החוזים, מנתח קריאות ומסכם יתרות של מאגרים.
אם האדפטר לא מכיר חלק מהמאגרים, לא מבין מכשירים נגזרים או מצרף אותם לפי ערך נקוב יחד עם הנכס הבסיסי, המספר סוטה מהמצב בפועל של החוזים. מבחוץ זה נראה כמו TVL שגוי, אף שהחוזים פועלים כשורה.
סיבות אופייניות לפער במדדים — קוד לא מאומת, היעדר תיאור ציבורי של הממשק והכתובות במאגר הקוד, תצורת מולטי-צ'יין שבה חלק מהנזילות נמצאת ברשת אחרת ולא נכנסת לסכום.
סיפור נפרד — ספירה כפולה: טוקני LP וקבלות סטייקינג נספרים גם כנכס עצמאי וגם כבטוחה, ולכן המדד מתנפח, ואחרי תיקון האדפטר צונח בחדות.
המחיר של טעות כזו — לא קוסמטיקה. הפרויקט לא עובר אימות פרוטוקול, נופל מהשוואות ודירוגים, ואינטגרטורים ואנליסטים בונים פתרונות על תמונה מעוותת. ירידת TVL בגרף נקראת כיציאת כספים, גם כשהנזילות במקומה.
בהמשך נפרק איך בנוי הרישום ב-DefiLlama: מה האגרגטור דורש מהחוזים, איך עובר האימות ובאילו הצלבות סוגרים את הפער במדדים.
מה נותנת הגדרת אנליטיקה: TVL שניתן להצלבה וזרימות
TVL תקין — זה לא מספר אחד מהדשבורד, אלא חישוב משוחזר. הוא כולל את שווי הנכסים הנעולים בכל הרשתות, מקור מחירים אחיד בעת תמונת המצב, התחשבות בספרות עשרוניות והחרגת ספירה כפולה — כשאותם כספים נכנסים גם למאגר וגם למכשיר נגזר שמבוסס עליו.
אנחנו מתארים את הנוסחה ומקבעים אותה בתצורת האדפטר: DefiLlama מחשב את מדדי הפרוטוקול לפיה, ולא לפי היוריסטיקה פנימית משלו.
הלאה — אינדוקסציה. תת-הגרף אוסף אירועי חוזים, החישוב נבנה מחדש לפי לוח זמנים, וייצוא ל-Dune מדביק את אותה תמונת נתונים. טבלאות ידניות נעלמות: הערך מתעדכן מעצמו, ולא בסוף החודש על ידי אנליסט, ונראה אותו דבר אצלנו בדשבורד, ב-Dune ובאגרגטורים.
זרימות הון נראות כמדד נפרד: זרימה יומית פנימה והחוצה, נטו לפי מאגרים ולפי רשתות, פילוח לפי קבוצות כתובות. לפיהן מבדילים בין צמיחה אורגנית לבין הזרמות חד-פעמיות לקראת תוכנית תגמולים — ורואים מראש יציאה, לפני שהיא הופכת לקריסה.
הצלבת נתונים סוגרת את הפינה האחרונה: אם הפער בין המקורות עולה על סף, מופעלת בדיקה ורואים היכן אבדה הספירה. סוג השגיאות של ספירה ידנית — מאגרים כפולים, מחירים מיושנים, אירועים שהוחמצו — פשוט מפסיק להיווצר.
דרכי מסירת נתונים: תת-גרף, דשבורד, דוח ידני
דרך מסירת הנתונים נבחרת לפי צרכן המדד ותדירות העדכון: מכך תלויים גם הדיוק וגם נפח התחזוקה. להלן שלוש אפשרויות עבודה עם גבולותיהן.
| אפשרות | מתי מתאימה | מגבלות |
|---|---|---|
| תת-גרף | נדרשת פלט תוכנתי: לוגיקת אגירה משלכם, שאילתות מהממשק, מבוט, סקריפט חישוב | האינדקס מפגר אחרי השרשרת, אחרי ארגון מחדש דורש בדיקה מחדש; סכימה ומיפויים מלווים בכל שינוי בחוזים |
| דשבורד ציבורי | נדרשת חשיפה חיצונית והתחלה מהירה: אגרגטים לפי פרוטוקול בלי תשתית משלכם | מתודולוגיית החישוב נקבעת על ידי הפלטפורמה, מדדים לא סטנדרטיים באים לידי ביטוי גרוע, עומק ההיסטוריה מוגבל על ידי המקור |
| דיווח ידני | המדד ייחודי או מחושב חד-פעמית לפי נתונים סגורים | השחזוריות יורדת, העדכון תלוי באדם, את המתודולוגיה צריך לקבע בנוהל |
בפועל משלפים שיטות: תת-גרף סוגר מדדים שוטפים, דשבורד עובד כוויטרינה חיצונית, דוח ידני — לחתכים נדירים. לרישום ב-DefiLlama דרוש מקור ניתן לאימות עם מתודולוגיה פתוחה — לרוב זה תת-גרף, שמחזיר את היקף הנכסים הנעולים לפי כתובות הפרוטוקול.
שלבי העבודה: מאודיט חוזים ועד מסירת סכמות
דשבורד ציבורי — זו ויטרינה, שמאחוריה עומדת סכמת ספירה מדויקת. טעות בסימון אירועים נותנת מספר יפה, שמתפורר בבדיקה חיצונית ראשונה. לכן הולכים בסדר: מפירוק החוזים ועד תיעוד שלפיו הצוות מתחזק את האנליטיקה בלעדינו.
- אודיט נתונים. מפרקים חוזים, מאגרים ואירועים, מקבעים אילו גדלים נשלפים מהשרשרת ישירות ואילו מחושבים כנגזרים ממספר מקורות.
- סכמת ספירה. מתארים ישויות, שדות וקשרים: איך מחשבים TVL, היכן מחריגים ספירה כפולה, לפי אילו מפתחות מאגרים כתובות וטוקנים.
- הגדרת איסוף. מרימים אינדוקסציה של אירועים וחישוב מחדש לפי לוח זמנים, בנפרד מניחים פערי בלוקים ונסיגות מצב.
- בדיקת מדדים. מצליבים את החישוב על נתונים היסטוריים ועם מקורות בלתי תלויים; פערים מסבירים עד אפס, ולא תולים בעיכוב אינדוקסציה.
- פרסום. מעצבים את הרישום ב-DefiLlama ועמודי הדשבורד כך שהמתודולוגיה גלויה למשתמש.
- נוהל עדכון. מקבעים את תדירות החישוב מחדש, ספי התראות וסדר הפעולות בעת חוסר סנכרון בנתונים.
- מסירת תיעוד. מוסרים סכמות, הרשאות, שאילתות והוראות — התחזוקה לא תלויה בנו.
מה מקבלים לידיים: סכמות, כללים, נהלים
אנליטיקה מסתיימת לא בדשבורד יפה, אלא בסט ארטפקטים שלפיהם הצוות ממשיך לעבוד בלעדינו. הכול מוסרים למאגר הקוד של הפרויקט: לכל מסמך יש בעלים, גרסה וקישור למקור נתונים מסוים.
- סכמת מקורות וישויות — אילו חוזים, מאגרים וטוקנים נכנסים לחישוב, איך קשורים זה לזה ומאיפה מגיע כל מספר.
- תצורות איסוף — פרמטרי אינדוקסציה, רשימות כתובות, מסנני אירועים; הקונפיגים נמצאים במאגר ופרוסים בפקודה אחת.
- כללי הפרדת הרשאות — מי רואה נתונים גולמיים, מי משנה תצורות, מי מאשר פרסום מדדים החוצה.
- תיאור מדדים — נוסחה של כל מדד, כולל TVL: מה נספר (נכסים נעולים, סטייקינג, פוזיציות הלוואה) ואיך מתחשבים במחירים.
- הוראה לצוות — איך מחברים מאגר או רשת חדשים, איפה רואים לוגים של בנייה מחדש, מה עושים בפער מול דשבורד חיצוני.
- נוהל עדכון — תדירות בנייה מחדש, חלון בדיקה, סדר נסיגה לחתך קודם בעת תקלה.
- צ'ק-ליסט פרסום — סט בדיקות לפני שליחת נתונים ל-DefiLlama: טריות, שלמות, התאמה לנתונים מהרשת.
חודש אחרי המסירה הצוות סוגר משימות שגרתיות בעצמו: להוסיף רשת, לחשב מחדש מדד, להרחיב הרשאה — בלי לפנות אלינו.
מקרה בוחן: איך הביאו את מדדי הפרויקט לערך אחיד
מה היה לפני
הפרויקט הציג שלושה ערכים שונים של נכסים נעולים: דשבורד פנימי חישב לפי תמונות המצב שלו, שאילתות ב-Dune — לפי בחירות משלו, וברישום ב-DefiLlama הנתון פיגר ביממה.
אנליסט איחד פערים ידנית פעם בשבוע, חלק מהפעולות בכלל לא נכנסו לבחירה — הפקדות ומשיכות גדולות דרך מולטיסיג אבדו בשלב ביניים. דינמיקת TVL נראתה קרועה, ולא ניתן היה להבדיל לפיה בין יציאה אמיתית לעיכוב אינדוקסציה.
מה שינו
תת-הגרף הפך למקור אחיד: אירועי חוזים מאונדקסים עם קישור למספר הבלוק, וחישוב מחדש של היתרות נעשה לפי נוסחה אחת לדשבורד, ל-Dune ולרישום החיצוני. הוספנו הצלבת סכומים בכל עדכון ובדיקה נפרדת לפעולות שפעם הוחמצו — העברות מעבר והעברות עם כמה טוקנים בעסקה אחת. ההטמעה ארכה שישה שבועות מרגע הגישה לחוזים.
תוצאה של הפרויקט
הפער בין דשבורדים פנימיים לרישום נעלם: הערכים תואמים עד הספרה האחרונה, העדכון אוטומטי. דינמיקת TVL לראשונה נתנה תמונה שבה רואים את סיבת היציאה — לא "המספר ירד", אלא איזה מאגר ובאיזו תקופה הוציא כספים. הצלבה ידנית נעלמה ממשימות האנליסט: הזמן שהושקע באיחוד דוחות עבר לניתוח מדדים.
האם נדרש רישום ב-DefiLlama אם לפרויקט יש דשבורד משלו?
דשבורד משלו עונה על שאלות פנימיות: איפה נפל ההיקף, איזה מאגר מושך נזילות, מה עם הנפקה ובטוחה. הוא לא נותן השוואה חיצונית — למספרים מדשבורד סגור אין עם מה להצליב, ובסקירות ענפיות הפרויקט פשוט לא מופיע.
רישום ב-DefiLlama — זו נקודת הצלבה בלתי תלויה, לא דשבורד שני. הפלטפורמה מחשבת TVL לפי מתודולוגיה אחידה, מפצלת אותו לפי רשתות ומאגרים, ושומרת היסטוריה של חתכי מצב שאי אפשר לכתוב מחדש בדיעבד. אנליסטים, אינטגרטורים ואגרגטורים לוקחים את המספרים משם — מבחינתם הדשבורד שלכם הוא מקור בלי אישור.
פערים בדרך כלל לא לטובת הפרויקט: דשבורד משלו לא פעם סופר פוזיציות בסטייקינג וטוקני LP פעמיים או לא רואה חלק מהחוזים. המדד הציבורי נקרא אז כהפרכה של הדוחות שלכם, אף שהטעות במתודולוגיית הספירה.
לכן האדפטר ותת-הגרף מתארים את החוזים במפורש: איזו קריאה קוראים, איך מחשבים את חלק המאגר, מה עושים בעת עדכון חוזה.
לא הכול צריך להוציא החוצה. שימור, משפך, פיזור פוזיציות אין להם משמעות ציבורית. סדרי העדיפויות של ההטמעה כאלה: קודם ספירה נכונה של TVL והיסטוריה, אחר כך דשבורדים ב-Dune לשאלות מסוימות, ורק אחר כך מדדים ציבוריים סביבם.
אם אתם מתלבטים אם נדרש רישום כשיש דשבורד חי — תארו את המשימה: נראה היכן המתודולוגיה שלכם סוטה מהציבורית, ונחזור עם הערכה ותוכנית.
שאלות טכניות נפוצות על ספירת מדדים
מדדים על נתוני בלוקצ'יין כמעט תמיד שונים בין פלטפורמות: רגע תמונת מצב שונה, פרשנות נכסים שונה, רשימת כתובות שונה בבחירה. להלן שאלות נפוצות שנשאלות בקבלת מערך האנליטיקה, ותשובות ענייניות.
למה ה-TVL שלנו לא תואם לנתונים של DefiLlama?
בדרך כלל העניין במתודולוגיה: רגע תמונת המצב, הפרשנות של נכסים נעולים ובסטייקינג, רשימת החוזים. אנחנו מקבעים את המתודולוגיה במסמך ומתכנסים בכל פער.
אצלנו כבר פרוס מערך משלנו — הוא תואם?
מתחברים לאחסון ולאינדקסר הקיימים, בלי לשבור אותם: נתונים שכבר נאספו משתמשים בהם מחדש, משלימים מדדים חסרים והצלבת נתונים.
מה עושים אחרי עדכון חוזים?
בנייה מחדש של נתונים — פעולה שגרתית: משתנה כתובת או חתימת אירוע, אינדוקסציה של טווח הבלוקים שנפגע מתבצעת מחדש. היסטוריה נשמרת, הערכים לפני ואחרי העדכון ניתנים להשוואה.
אפשר לחשב מדדים לפי נתונים סגורים?
כן: המערך נפרס בהיקף שלכם, החוצה יוצאים רק האגרגטים שאתם בעצמכם תחליטו להציג.
מה כוללת התמיכה אחרי המסירה?
עוקבים אחרי תקינות האינדוקסציה, מעדכנים מתודולוגיות כשהפרוטוקול משתנה, מוסיפים מדדים חדשים. בנייה מחדש וניתוח פערים — חלק מהעבודה השוטפת.
נדון במשימה: נצליב מדדים ונציע תוכנית עבודה
כדי שההערכה תהיה עניינית ולא "לפי תחושות", בקלט צריכים להיות נתוני מקור: כתובות חוזים ורשת, תיאור של איך נספר כיום שווי הנכסים הנעולים, וקישורים לדשבורדים או לתת-גרף קיימים, אם כבר יש כאלה.
זה מספיק כדי להבין את היקף האינדוקסציה ולראות מראש היכן המספרים בדיווח שלכם סוטים ממה שנקרא מהבלוקצ'יין.
בניתוח מחדדים את מה שאי אפשר לקרוא מהקוד: אילו נכסים לכלול ב-TVL, איך לעקוף ספירה כפולה של פוזיציות LP, האם נדרש פילוח לפי רשתות ומאגרים, איך להתחשב בסטייקינג ובטוקנים נעולים.
בנפרד מדברים על דרישות לפרסום ב-DeFiLlama ועל מי אחראי לתיקונים תומכים אחרי הרישום — את האדפטר יהיה צריך לעדכן בשדרוג חוזים.
לפי תוצאות הניתוח חוזרים עם קונקרטיקה:
- הערכה — הרכב העבודה ומאמץ העבודה, מפורטים לפי שלבים;
- תוכנית עבודה — מאודיט חוזים ומודל ספירה ועד הגשת בקשה ואימות מדדים;
- לוחות זמנים עם נקודות ביקורת ורשימת תלויות מצדכם;
- רשימת הרשאות ונתונים שבלעדיהם אי אפשר להתחיל;
- סכמת חישוב TVL: אילו קריאות קוראים, מה מאגרים, מה מחריגים;
- תצורת אינדקסר ואדפטר, פרוסה בנפרד מסביבת הפרודקשן שלכם;
- נוהל תחזוקה: איך בודקים פערים אחרי ריליס ושדרוגים.
תארו את המשימה בשתיים-שלוש פסקאות וצרפו את מה שכבר נאסף — נחזור עם הערכה, תוכנית עבודה והרכב שלבים.