שילוב Covalent API: יתרות, עסקאות, NFT לריבוי שרשראות

אתם בונים ארנק וצריכים להציג יתרות משתמשים ב-Ethereum, Polygon, Arbitrum ו-Base בזמן אמת. ללא ממשק אחיד, הייתם צריכים להקים ארבעה צמתי ארכיון, לכתוב מפענחי ABI לכל פרוטוקול, ולאגד תשובות באופן ידני — שבועות של עבודה ועלויות תשתית שוטפות. אנחנו פותרים זאת עם בקשה אחת דרך Covalent API: יותר מ-200 רשתות, נתונים מנורמלים עם מחירים ולוגים מפוענחים. הניסיון שלנו עם GoldRush SDK מקצר את זמן הפיתוח ב-40%.

למה Covalent API עדיף על RPC ישיר

חיבור ישיר לצמתי RPC של כל רשת דורש תשתית ותחזוקה נפרדות. Covalent API מאיץ את האינטגרציה פי 10: ארנק טיפוסי על חמש רשתות לוקח 2–3 ימים לשילוב במקום 2–3 שבועות. עלויות התשתית יורדות לאפס — אין צורך בצמתי ארכיון, הכל עובד דרך מפתח API אחד. החיסכון בפיתוח מגיע ל-40%, והחיסכון בתשתית עד 100%.

איך אנחנו משלבים Covalent API ב-3 ימים

תרחיש טיפוסי: הצגת תיקי אסימונים, היסטוריית עסקאות ו-NFT. עם Covalent, SDK אחד וכמה בקשות עושים את העבודה:

# Балансы всех ERC-20 токенов на адресе GET /v1/{chainId}/address/{walletAddress}/balances_v2/ # История транзакций GET /v1/{chainId}/address/{walletAddress}/transactions_v3/ # NFT на адресе GET /v1/{chainId}/address/{walletAddress}/balances_nft/ 

כל תשובה כבר כוללת ערך בדולרים, יתרות מותאמות לעשרונים, מטא-דאטה של אסימונים, ונתונים מפוענחים קריאים לאדם עבור יותר מ-50 פרוטוקולים פופולריים (Uniswap, OpenSea, Aave וכו').

אימות ומגבלות קצב

מפתח ה-API מועבר דרך כותרת Basic Auth. תוכנית חינמית: 4 בקשות בשנייה, 100,000 בקשות בחודש. לייצור, השתמשו בתוכניות בתשלום עם מגבלות גבוהות יותר.

const client = new CovalentClient(process.env.COVALENT_API_KEY); const response = await client.BalanceService.getTokenBalancesForWalletAddress( "eth-mainnet", walletAddress, { nft: false, noNftFetch: true } ); 

GoldRush SDK הוא טיפוסי, מטפל בעמודות ולוגיקת ניסיונות חוזרים אוטומטית. אנחנו משתמשים בו ב-90% מהפרויקטים שלנו ומבטיחים פעולה יציבה גם תחת עומס גבוה. המהנדסים שלנו הכינו יישומי ייחוס לתרחישים טיפוסיים — חיסכון של עד 30 שעות לפרויקט.

קבוצות נקודות קצה עיקריות

Balances API — יתרות נוכחיות והיסטוריות של ERC-20, ERC-721, ERC-1155. כולל ערך בדולרים במחיר נוכחי או היסטורי. הפרמטר # Балансы всех ERC-20 токенов на адресе GET /v1/{chainId}/address/{walletAddress}/balances_v2/ # История транзакций GET /v1/{chainId}/address/{walletAddress}/transactions_v3/ # NFT на адресе GET /v1/{chainId}/address/{walletAddress}/balances_nft/ מאפשר לקבל סדרת זמן של יתרות מבלי לשאול אלפי בלוקים בעצמכם.

Transactions API — היסטוריית עסקאות מלאה עם לוגי אירועים מפוענחים. הפרמטר const client = new CovalentClient(process.env.COVALENT_API_KEY); const response = await client.BalanceService.getTokenBalancesForWalletAddress( "eth-mainnet", walletAddress, { nft: false, noNftFetch: true } ); מאפשר פענוח קריא לאדם עבור Uniswap, Aave, OpenSea ו-50+ פרוטוקולים אחרים. העמודות מבוססות על סמן (cursor), לא על היסט — חשוב לארנקים עם אלפי עסקאות.

NFT API — מטא-דאטה, היסטוריית בעלות, מחיר רצפה מ-Opensea/Blur. נקודת הקצה historic_balance_interval מחזירה כתובות IPFS מתוקנות עם גיבוי שער HTTP.

Cross-Chain Activity API — סיכום פעילות לכתובת בכל הרשתות בבקשה אחת. שימושי לתרחישי סורק ארנק רב-רשתי.

ניואנסים מעשיים באינטגרציה

שמירה במטמון היא חובה: נתוני יתרות משתנים לכל היותר פעם אחת לכל בלוק (~12 שניות עבור Ethereum). שמרו תשובות ב-Redis עם TTL של 15–30 שניות. ללא שמירה במטמון, 100 משתמשים במקביל יפגעו במגבלת הקצב במהירות.

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

async function* getAllTransactions(chain: string, address: string) { let pageNumber = 0; while (true) { const resp = await client.TransactionService .getTransactionsForAddressV3(chain, address, pageNumber); yield resp.data.items; if (!resp.data.links?.next) break; pageNumber++; } } 

טיפול בשגיאות: Covalent מחזיר HTTP 200 גם בשגיאות — בדקו את השדה decode בגוף התשובה. השדה getNftsForAddress לפעמים אינפורמטיבי ולפעמים לא; רשמו את התשובה המלאה ביומן על תוצאות לא צפויות.

מזהי רשת: Covalent משתמש גם במזהי רשת מספריים (1 עבור Ethereum) וגם במזהים מחרוזתיים ("eth-mainnet"). ב-SDK, השתמשו בפורמט המחרוזתי — פחות בלבול בעבודה עם רשתות בדיקה.

RPC ישיר מול Covalent API

מגבלות שכדאי להכיר

Covalent מתעד נתונים היסטוריים עם עיכוב עבור רשתות חדשות — אל תצפו לזמן אמת עם השהיה תת-בלוקית. לנתונים בזמן אמת (עסקאות ממתינות, מחיר DEX נוכחי), אתם צריכים RPC ישיר.

נתונים מפוענחים עובדים רק עבור פרוטוקולים ברשימה לבנה. חוזים מותאמים אישית או לא מוכרים מחזירים לוגים גולמיים — תצטרכו לבצע פענוח ABI בעצמכם עם async function* getAllTransactions(chain: string, address: string) { let pageNumber = 0; while (true) { const resp = await client.TransactionService .getTransactionsForAddressV3(chain, address, pageNumber); yield resp.data.items; if (!resp.data.links?.next) break; pageNumber++; } } .

למה להשתמש ב-GoldRush SDK?

GoldRush SDK הוא לקוח TypeScript הרשמי של Covalent שמטפל בטיפוסים, עמודות וניסיונות חוזרים. אנחנו משתמשים בו ב-90% מהפרויקטים שלנו ומבטיחים פעולה יציבה גם תחת עומס גבוה. המהנדסים שלנו הכינו יישומי ייחוס לתרחישים טיפוסיים — חיסכון של עד 30 שעות לפרויקט.

מה כלול בעבודה שלנו

• תיעוד אינטגרציה עם תיאורי נקודות קצה ודוגמאות קוד.
• התקנת GoldRush SDK ושכבת שירות עם שמירה במטמון וטיפול בשגיאות.
• בדיקות על רשתות בדיקה והכנה לייצור.
• תמיכה לאחר השקה: אופטימיזציית שאילתות ופתרון מקרי קצה.

התהליך שלנו

1. ניתוח דרישות: קביעת הנתונים שאתם צריכים (יתרות, עסקאות, NFT), בחירת נקודות קצה.
2. עיצוב ארכיטקטורה: סכמת אינטגרציה, שמירה במטמון, עמודות וטיפול בשגיאות.
3. יישום: הגדרת GoldRush SDK, כתיבת שכבת שירות, בדיקות על רשת בדיקה.
4. השקה וניטור: פריסה, הגדרת התראות, אופטימיזציית שאילתות.

לוחות זמנים: 1 עד 3 שבועות תלוי במורכבות. המחיר מחושב באופן אישי לפרויקט שלכם.

צרו קשר לייעוץ על האינטגרציה שלכם. הזמינו פתרון מוכן לאנליטיקה רב-רשתית וקבלו תמיכה לאחר ההשקה.

מקור: תיעוד Covalent