منصوبے کے بارے میں

# EVM-based Chains یہ ریپوزٹری Ethereum Virtual Machine (EVM) کے مطابق بلاک چینز کے میٹا ڈیٹا کے لیے مرکزی رجسٹری کے طور پر کام کرتی ہے۔ ڈیٹا `_data/chains` ڈائریکٹری میں JSON فارمیٹ میں ترتیب دیا گیا ہے، جہاں ہر فائل ایک مخصوص چین کے لیے اس کے [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md) نمائندگی کو فائل نام کے طور پر استعمال کرتی ہے۔ ## ڈیٹا کا ڈھانچہ ہر چین اندراج میں ضروری کنکشن اور شناخت کی تفصیلات شامل ہوتی ہیں: - **شناخت**: `name`، `shortName`، `chainId`، اور `networkId`۔ - **کنیکٹیویٹی**: بلاک چین کے ساتھ تعامل کے لیے `rpc` URLs کی فہرست۔ - **کرنسی**: `nativeCurrency` کے بارے میں تفصیلات بشمول نام، علامت، اور decimals۔ - **خصوصیات**: معیاری سپورٹ جیسے EIP155 یا EIP1559۔ - **ایکسپلوررز**: EIP3091 معیارات پر عمل کرنے والے بلاک ایکسپلوررز کے لنکس۔ - **آئیکونز**: `_data/icons` ڈائریکٹری کے ذریعے IPFS میں محفوظ آئیکون اثاثوں کے حوالے۔ Layer 2 چینز یا shards کے لیے، ایک `parent` فیلڈ انہیں ان کی بنیادی پرت سے جوڑ سکتا ہے، ممکنہ طور پر bridge URLs شامل کرتے ہوئے۔ ## رکاوٹیں اور گورننس ری پلے حملوں کو روکنے اور ڈیٹا کی سالمیت کو یقینی بنانے کے لیے، سخت قواعد لاگو ہوتے ہیں: - **انفرادیت**: `shortName` اور `name` تمام اندراجات میں منفرد ہونے چاہئیں۔ - **Chain ID تصادم**: صرف ایک چین مخصوص Chain ID رکھ سکتی ہے۔ پہلا درست Pull Request جو ID کا دعویٰ کرتا ہے اسے حاصل ہوتا ہے۔ موجودہ چین کی ID کو تبدیل کرنا ممنوع ہے جب تک کہ اصل کو deprecated نہ کیا جائے۔ - **اسٹیٹس مینجمنٹ**: چینز کو `active`، `incubating`، یا `deprecated` کے طور پر نشان زد کیا جا سکتا ہے۔ تاریخی سالمیت برقرار رکھنے کے لیے 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 (Metadata for Ethereum Supported Chains)۔ - **لسٹنگ سائٹس**: chainid.network، chainlist.org، evmchain.info۔ ## تعاون تعاون کنندگان کو PR جمع کرانے سے پہلے CI چیک پاس کرنا یقینی بنانا چاہیے۔ اس میں توثیقی اسکرپٹس (`./gradlew run`) چلانا اور پروجیکٹ کے اسٹائل گائیڈ کے مطابق Prettier کا استعمال کرتے ہوئے JSON فائلوں کو فارمیٹ کرنا شامل ہے۔ جو PRs CI میں ناکام ہوتے ہیں ان کا جائزہ اس وقت تک نہیں لیا جائے گا جب تک کہ ٹھیک نہ ہو جائیں۔ نئی چین شامل کرنے کے لیے، درست CAIP-2 فائل نام اور درست JSON ڈھانچے کے ساتھ PR جمع کریں۔ اگر آپ کو مخصوص Chain ID کی ضرورت ہو تو اسے اپنے PR کے ذریعے دعویٰ کریں؛ اگر آپ چین کو تبدیل کرنا چاہتے ہیں تو پرانے اندراج کو پہلے deprecated ہونا چاہیے۔ استعمال کی فہرست میں سوالات یا اضافے کے لیے، منتظمین سے رابطہ کریں۔