इस प्रोजेक्ट के बारे में

# EVM-आधारित चेन यह रिपॉजिटरी Ethereum वर्चुअल मशीन (EVM)-संगत ब्लॉकचेन के मेटाडेटा के लिए केंद्रीय रजिस्ट्री के रूप में कार्य करती है। डेटा `_data/chains` निर्देशिका के भीतर JSON प्रारूप में संरचित है, जहां प्रत्येक फ़ाइल एक विशिष्ट चेन से मेल खाती है, जिसमें फ़ाइलनाम के रूप में इसका [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md) प्रतिनिधित्व उपयोग होता है। ## डेटा संरचना प्रत्येक चेन प्रविष्टि में आवश्यक कनेक्शन और पहचान विवरण शामिल होते हैं: - **पहचान**: `name`, `shortName`, `chainId`, और `networkId`। - **कनेक्टिविटी**: ब्लॉकचेन के साथ इंटरैक्ट करने के लिए `rpc` URL की सूची। - **मुद्रा**: `nativeCurrency` के बारे में विवरण जिसमें नाम, प्रतीक और दशमलव शामिल हैं। - **विशेषताएं**: EIP155 या EIP1559 जैसे समर्थित मानक। - **एक्सप्लोरर**: EIP3091 मानकों का पालन करने वाले ब्लॉक एक्सप्लोरर के लिंक। - **आइकन**: `_data/icons` निर्देशिका के माध्यम से IPFS में संग्रहीत आइकन संपत्तियों के संदर्भ। लेयर 2 चेन या शार्ड्स के लिए, एक `parent` फ़ील्ड उन्हें उनकी आधार परत से जोड़ सकता है, वैकल्पिक रूप से ब्रिज URL शामिल करते हुए। ## बाधाएं और शासन रीप्ले हमलों को रोकने और डेटा अखंडता सुनिश्चित करने के लिए, सख्त नियम लागू होते हैं: - **विशिष्टता**: `shortName` और `name` सभी प्रविष्टियों में अद्वितीय होना चाहिए। - **चेन ID टकराव**: केवल एक चेन एक विशिष्ट चेन ID धारण कर सकती है। ID का दावा करने वाला पहला वैध पुल रिक्वेस्ट इसे प्राप्त करता है। मौजूदा चेन की ID को बदलना निषिद्ध है जब तक कि मूल को हटाया न जाए। - **स्थिति प्रबंधन**: चेन को `active`, `incubating`, या `deprecated` के रूप में चिह्नित किया जा सकता है। ऐतिहासिक अखंडता बनाए रखने के लिए हटाई गई चेन कभी नहीं हटाई जाती हैं। - **आइकन आवश्यकताएं**: आइकन IPFS (`ipfs get`) के माध्यम से सार्वजनिक रूप से समाधान योग्य होने चाहिए, 250kb से कम, और सकारात्मक पूर्णांक आयाम हों। ## एकत्रीकरण स्वचालित एकत्रीकरण स्क्रिप्ट समेकित JSON फ़ाइलें उत्पन्न करती हैं जो उपलब्ध हैं: - पूर्ण डेटासेट: `https://chainid.network/chains.json` - लघु संस्करण: `https://chainid.network/chains_mini.json` ## उपयोग यह रजिस्ट्री Web3 पारिस्थितिकी तंत्र में विभिन्न उपकरणों द्वारा व्यापक रूप से अपनाई जाती है: - **वॉलेट**: TREZOR, WallETH, Minerva Wallet। - **एक्सप्लोरर**: Otterscan। - **डेवलपर टूल**: Wagmi संगत कॉन्फ़िगरेशन, MESC (Ethereum समर्थित चेन के लिए मेटाडेटा)। - **लिस्टिंग साइटें**: chainid.network, chainlist.org, evmchain.info। ## योगदान योगदानकर्ताओं को PR सबमिट करने से पहले CI जांच पास करना सुनिश्चित करना चाहिए। इसमें सत्यापन स्क्रिप्ट (`./gradlew run`) चलाना और प्रोजेक्ट की शैली मार्गदर्शिका के अनुसार Prettier का उपयोग करके JSON फ़ाइलों को प्रारूपित करना शामिल है। CI विफल करने वाले PR की समीक्षा तब तक नहीं की जाएगी जब तक उन्हें ठीक नहीं किया जाता। नई चेन जोड़ने के लिए, सही CAIP-2 फ़ाइलनाम और मान्य JSON संरचना के साथ PR सबमिट करें। यदि आपको एक विशिष्ट चेन ID की आवश्यकता है, तो इसे अपने PR के माध्यम से दावा करें; यदि आप किसी चेन को बदलना चाहते हैं, तो पुरानी प्रविष्टि को पहले हटाया जाना चाहिए। प्रश्नों या उपयोग सूची में जोड़ने के लिए, अनुरक्षकों से संपर्क करें।