والٹ میں ٹیسٹ نیٹ شامل کرنے سے پہلے RPC، Chain ID اور بلاک ایکسپلورر کیسے جانچیں
جب کوئی پراجیکٹ کہے کہ “ٹیسٹ نیٹ شامل کریں” تو چند values نقل کرکے Save کر دینا پورا کام نہیں۔ یہ رہنمائی صرف EVM-compatible custom networks کے لیے ہے: پہلے دیکھیں کہ MetaMask میں نیٹ ورک پہلے سے supported یا hidden تو نہیں، پھر network maintainer کی دستاویز سے RPC، Chain ID اور block explorer لیں اور بغیر کوئی رقم منتقل کیے نتیجہ چیک کریں۔ Solana، Bitcoin اور دوسرے non-EVM نیٹ ورکس کا account اور connection model مختلف ہے، اس لیے یہ fields وہاں استعمال نہ کریں۔
پہلے موجود یا چھپا ٹیسٹ نیٹ تلاش کریں
والٹ کے اپنے network selector میں پورا network name تلاش کریں۔ MetaMask Extension کی موجودہ ہدایات میں اوپر دائیں menu سے Networks کھولا جاتا ہے۔ نیٹ ورک Additional networks میں ہو سکتا ہے اور فہرست کے نیچے Show test networks اختیار مل سکتا ہے۔ Mobile میں Tokens tab کے اوپر network dropdown سے موجود اور additional networks دیکھیں۔ Version، operating system اور staged rollout کے ساتھ button کی جگہ یا ترجمہ بدل سکتا ہے؛ اپنے موجودہ app کی فہرست کو اصل سمجھیں اور کسی پرانے screenshot سے ملانے کے لیے settings reset نہ کریں۔
اگر نیٹ ورک پہلے ہی فہرست میں ہے تو built-in Add استعمال کریں یا testnet display آن کریں؛ اسی نام کی دوسری custom entry نہ بنائیں۔ اگر پہلے دستی طور پر شامل کیا تھا تو Edit کھول کر موجودہ name، RPC اور Chain ID لکھ لیں۔ کام کرنے والا RPC محفوظ رکھیں تاکہ نیا endpoint ناکام ہو تو واپس جا سکیں۔ دستی اضافہ صرف اس وقت کریں جب نیٹ ورک existing، additional اور hidden تینوں فہرستوں میں نہ ہو۔ یہ بھی فرض نہ کریں کہ Extension اور Mobile کے custom networks خودکار طور پر devices میں sync ہوتے ہیں؛ ہر استعمال ہونے والا device الگ دیکھیں۔
دستی اضافہ کرنے سے پہلے پانچ معلومات لیں
Network maintainer کی official documentation کھولیں یا اس کی official site سے network information page تک جائیں۔ Search ad، group chat کی تصویر، نجی پیغام کے “support” یا task page کے اکیلے Copy button کو source نہ بنائیں۔ Page URL اور جانچ کی تاریخ کے ساتھ پانچ چیزیں local note میں لکھیں: network name، https:// سے شروع RPC URL، Chain ID، native currency symbol اور block explorer URL۔ اگر کئی RPC ہوں تو درج کریں کہ کون سا public ہے اور کس کے لیے provider account یا API Key چاہیے۔
| Field | یہ کیا بتاتا ہے | Save سے پہلے کیا دیکھیں |
|---|---|---|
| Network name | والٹ میں label | پڑھنے کے لیے ہے، حفاظت کا ثبوت نہیں |
| RPC URL | والٹ کس node سے read/write کرے گا | HTTPS، پورا hostname، authentication کی ضرورت |
| Chain ID | Request اور signature کس EVM chain کے ہیں | Official document کی شائع کردہ value |
| Native symbol | Fee asset کس نام سے دکھے گا | Docs کے مطابق، token contract کا ticker نہیں |
| Explorer URL | Blocks، addresses اور transactions کہاں پڑھیں | Maintainer کا root domain، نامعلوم transaction link نہیں |
Testnet parameters اور public RPC بدل سکتے ہیں۔ تاریخ سے معلوم ہوتا ہے کہ پہلے کام کرنے والی چیز اب کیوں ناکام ہے اور کون سا document دوبارہ دیکھنا ہے۔ Sources میں اختلاف ہو تو رکیں اور maintainer کی موجودہ documentation اور announcements کو ترجیح دیں؛ مختلف جگہوں کی مقبول values ملا کر configuration نہ بنائیں۔
Chain ID کہاں سے ملائیں: پہلا ذریعہ ہمیشہ network maintainer کی documentation ہے۔ دوسرے ذریعے کے طور پر public chain directories دیکھیں: chainlist.org (DefiLlama چلاتا ہے؛ testnets دیکھنے کے لیے Include Testnets پر tick لگانا پڑتا ہے؛ ہر chain کا Chain ID، native symbol اور کئی RPC دکھاتا ہے) اور chainid.network (community کے ethereum-lists/chains ڈیٹا پر مبنی؛ MetaMask network save کرتے وقت Network details check میں یہی استعمال کرتا ہے)۔ دونوں جگہ Chain ID ایک ہو تب لکھیں۔ Directory کے کئی RPC تیسرے فریق کے nodes ہیں، official سفارش نہیں؛ directory site کے button سے ایک click میں شامل کریں تب بھی wallet کے popup کا ہر field maintainer کی معلومات سے ملائیں۔
RPC، Chain ID اور explorer الگ الگ جانچیں
RPC hostname کو ایک ایک character پڑھیں۔ اضافی لفظ، ملتے جلتے حروف، غلط top-level domain، اور https:// کی جگہ http:// پر خاص توجہ دیں۔ جائز third-party node provider اپنا domain استعمال کر سکتا ہے، مگر maintainer کی documentation میں اس provider یا setup کا طریقہ واضح ہونا چاہیے۔ API Key placeholder والا template جوں کا توں استعمال نہ کریں اور اپنی Key اس site کے converter، search، chat یا screenshot میں paste نہ کریں۔
Chain ID ایک integer ہے۔ Wallet کا manual form عموماً decimal مانگتا ہے، جبکہ JSON-RPC کا eth_chainId عموماً 0x hexadecimal value واپس کرتا ہے۔ دونوں ایک ہی عدد کی شکلیں ہو سکتی ہیں۔ Command چلانے کی ضرورت نہیں؛ ہمارے decimal/hex Chain ID converter میں local conversion اور comparison کریں۔ ہر field کو اسی کا مطلوبہ format دیں: MetaMask manual form میں official decimal، اور EIP-3085 request میں 0x hexadecimal string۔ یہ site RPC کو request نہیں کرتا اور node کو معتبر قرار نہیں دیتا۔ MetaMask Save کے وقت ID mismatch یا connection error دکھا سکتا ہے، مگر error نہ ہونا node کی دیانت کا ثبوت نہیں۔
Block explorer ایک الگ read path ہے، RPC form کی سجاوٹ نہیں۔ Maintainer کے page سے explorer home کھولیں اور دیکھیں کہ اسی testnet کا نام ہے۔ gwei ETH کی پیمائش کی اکائی ہے جسے wallet عموماً فی unit gas قیمت دکھانے کے لیے استعمال کرتا ہے؛ یہ network ID نہیں۔ Gas value، Network ID، token ID یا explorer URL کا کوئی عدد Chain ID نہ سمجھیں۔
MetaMask میں شامل کریں، transaction sign نہ کریں
Extension: اوپر دائیں menu سے Networks کھولیں، پہلے search اور Additional networks دیکھیں۔ نہ ملے تو Add a custom network منتخب کرکے verified fields بھریں اور Save کریں۔ Mobile: Tokens tab کے اوپر network dropdown کھولیں، Custom پر جائیں، پھر Add a custom network دبائیں۔ MetaMask Help Center فی الحال یہی راستے بتاتا ہے۔ Interface مختلف ہو تو current help اور app version دیکھیں، ملتا جلتا button اندازے سے نہ دبائیں۔
کچھ project sites Add network prompt دکھاتی ہیں۔ EIP-3085 کا wallet_addEthereumChain website کی طرف سے wallet کو EVM chain شامل کرنے کی تجویز دینے والا proposal ہے، ہر wallet میں support کی ضمانت نہیں۔ Wallet اضافی fields مانگ سکتا، کسی field کو نظر انداز کر سکتا یا request رد کر سکتا ہے۔ Success کا مطلب یہ بھی نہیں کہ current network لازماً switch ہوا۔ Network selector میں واپس جاکر selection دیکھیں اور prompt کا name، RPC، Chain ID اور explorer maintainer record سے ملائیں۔
Network شامل کرنے سے صرف connection configuration save ہوتا ہے۔ معمول کے setup میں approve، Permit، message signature، transfer یا “verification fee” نہیں چاہیے۔ فوراً بعد ایسی request آئے تو Reject کریں اور اسے الگ high-risk action سمجھ کر جانچیں۔ Add یا switch bridge نہیں اور ETH، test token یا کسی asset کو دوسری chain پر منتقل نہیں کرتا۔
MetaMask: How to add a network · EIP-3085: wallet_addEthereumChain
Base Sepolia کی محفوظ مثال
فرض کریں آپ Base mainnet نہیں بلکہ Base کا testnet شامل کرنا چاہتے ہیں۔ کو جانچی گئی Base connection documentation سے یہ record بنتا ہے:
| Wallet field | اس مثال کی value | جانچ |
|---|---|---|
| Network name | Base Sepolia | واضح طور پر testnet |
| RPC URL | https://sepolia.base.org | HTTPS اور پورا hostname |
| Chain ID | 84532 | Manual form میں یہی decimal؛ وضاحتی hex برابر 0x14a34 |
| Native symbol | ETH | کسی test token کا ticker نہیں |
| Block explorer | https://sepolia.basescan.org | Domain اور page دونوں Sepolia |
Documentation اور wallet form ساتھ رکھیں، ہر row بھریں اور دوبارہ پڑھیں۔ دوسری جگہ Chain ID 8453 ملے تو وہ Base mainnet ہے؛ اسے Base Sepolia entry میں نہ ملائیں۔ Existing network بدلنے سے پہلے کام کرنے والا پرانا RPC لکھ یا screenshot لے لیں اور کسی بھی Key کو چھپا دیں۔ یہ مثال جانچنے کا طریقہ سکھاتی ہے، public endpoint کے ہمیشہ دستیاب رہنے کا وعدہ نہیں۔ تبدیلی پر Base کی current connection documentation دیکھیں۔
Save کے بعد بغیر transfer کنکشن چیک کریں
Save کے بعد target network خود select کریں۔ Faucet، transfer یا signature سے پہلے دیکھیں کہ wallet asset page refresh کرتا اور connection error نہیں دکھاتا۔ Current account کا public address copy کرکے پہلے جانچے گئے same-chain explorer میں کھولیں۔ Explorer اور wallet کا network name ایک اور address کا ہر character برابر ہونا چاہیے۔ کبھی استعمال نہ کیے گئے test address کا balance 0 ہونا معمول ہے؛ اس سے asset گم ہونے کا ثبوت نہیں ملتا اور نہ اکیلے اس سے configuration غلط ثابت ہوتی ہے۔
اگر اس testnet پر کوئی معلوم transaction یا address ہے تو explorer میں اس کا block height اور status پڑھ کر wallet activity سے اضافی موازنہ کر سکتے ہیں۔ صرف “verification transaction” بنانے کے لیے پہلے funds نہ لائیں۔ Ethereum.org سمجھاتا ہے کہ networks الگ ہیں: ایک EVM account address کئی networks میں استعمال ہو سکتا ہے، مگر mainnet balance اور transaction history testnet میں نہیں آتی۔ Testing کے لیے mainnet اور testnet accounts الگ رکھنے پر بھی غور کریں۔
مناسب نتیجہ یہ ہے: target network منتخب ہے، Save کرتے وقت Chain ID یا connection error نہیں آیا، same-chain explorer درست address یا معلوم public record کھولتا ہے، اور اس check میں کوئی signature یا fund movement نہیں ہوا۔ یہ node کی دیانت کا ثبوت نہیں۔ اگر صرف balance چاہیے تو balance یا faucet مسئلہ حل کریں؛ duplicate network نہ بنائیں۔
Network شامل کرتے وقت error: Could not fetch chain ID سمیت ہر پیغام کا حل
نیچے bold انگریزی پیغامات MetaMask extension کی موجودہ interface کا ہوبہو متن ہیں (ستمبر 2026 میں MetaMask کے open-source code کے انگریزی متن سے ملائے گئے)؛ mobile یا دوسرے wallets میں الفاظ کچھ مختلف ہو سکتے ہیں، وجہ وہی رہتی ہے۔
Could not fetch chain ID. Is your RPC URL correct?: Wallet اس RPC تک نہیں پہنچ پا رہا۔ پورا URL، HTTPS، internet connection اور یہ دیکھیں کہ endpoint کو API Key تو نہیں چاہیے؛ public RPC down یا rate-limited بھی ہو سکتا ہے، کچھ دیر بعد maintainer کا دوسرا listed endpoint آزمائیں۔ نامعلوم site کا “unlock” نہ خریدیں اور private message کا node استعمال نہ کریں۔
The RPC URL you have entered returned a different chain ID (…).: Bracket میں لکھا عدد اس node کی اصل chain کا Chain ID ہے۔ یہ عدد chainlist.org پر تلاش کریں تو پتا چل جائے گا کہ node کس chain کا ہے؛ عموماً mainnet یا کسی دوسرے testnet کا RPC مل گیا ہوتا ہے۔ Maintainer docs والا RPC واپس لگائیں؛ node سے ملانے کے لیے Chain ID نہ بدلیں۔
This Chain ID is currently used by the … network.: Wallet میں اس Chain ID والا network پہلے سے موجود ہے (built-in یا آپ کا پہلے شامل کیا ہوا)۔ Network list میں اسے ڈھونڈ کر براہ راست استعمال کریں، یا تین نقطوں والے مینو سے اس کا RPC edit کریں؛ “2” والی duplicate entry نہ بنائیں۔ Edit سے پہلے پرانا working RPC لکھ لیں۔
According to our records the network name may not correctly match this chain ID. / The submitted currency symbol does not match what we expect for this chain ID.: یہ MetaMask کی وہ تنبیہ ہے جو chainid.network کے ڈیٹا سے ملا کر دی جاتی ہے؛ اس سے save نہیں رکتا۔ Maintainer docs دوبارہ ملائیں: صرف نام یا symbol کی لکھائی مختلف ہو (مثلاً project نے حال ہی میں نام بدلا) تو docs کے مطابق لکھ کر آگے بڑھ سکتے ہیں؛ Chain ID یا RPC بھی نہ ملیں تو رک جائیں۔
Invalid RPC URL: Address کا format غلط ہے۔ عام وجوہات: https:// رہ جانا، شروع یا آخر میں اضافی space، یا block explorer کا URL بطور RPC لکھ دینا۔
This RPC provider is limiting requests. Try again later or use a different RPC URL.: یہ پیغام بار بار آئے، یا 429، 401/403، timeout یا blank balance ہو تو public congestion اور غلط Key configuration الگ کریں۔ Key صرف provider کے اپنے dashboard میں بنائیں اور docs کے مطابق permissions محدود کریں۔ Maintainer alternative نہ دے تو رکیں؛ random “fastest RPC” تلاش نہ کریں۔
Website اب بھی wrong network: صرف added ہونا نہیں، target network کا current selection ہونا دیکھیں۔ Site disconnect کرکے دوبارہ connect کریں، page refresh کریں اور دیکھیں site testnet مانگتی ہے یا mainnet۔ مسئلہ رہے تو interaction روکیں، site کا expected Chain ID اور wallet کا current Chain ID لکھ کر support لیں؛ bypass prompt sign نہ کریں۔
غلط network یا RPC شامل ہو گیا: کیسے بدلیں، کیسے ہٹائیں
پورا network ہٹانا (extension): اوپر دائیں مینو، پھر Networks، فہرست میں network کے ساتھ تین نقطے، پھر Delete، اور “Delete … network?” کی تصدیق کریں۔ Mobile: اوپر دائیں مینو، پھر Networks، network کے ساتھ تین نقطے، پھر Delete۔ Ethereum Mainnet جیسے پہلے سے موجود networks نہیں ہٹتے؛ صرف خود شامل کیے گئے networks ہٹائے جا سکتے ہیں۔
صرف غلط RPC بدلنا ہو تو network ہٹانے کی ضرورت نہیں۔ Extension میں network کے ساتھ تین نقطوں سے edit صفحہ کھولیں، Default RPC URL dropdown میں Add RPC URL چن کر درست address ڈالیں اور اسی کو منتخب کریں؛ غلط والے کے ساتھ trash icon دبا کر اسے ہٹا دیں۔ Mobile میں تین نقطے، پھر Edit، پھر Add RPC URL۔ Chain ID غلط ہو تو پورا network ہٹا کر دوبارہ شامل کریں۔
Network ہٹانے سے chain پر موجود assets نہیں مٹتے۔ MetaMask خود بتاتا ہے “If you delete this network, you will need to add it again to view your assets in this network”؛ وہی chain دوبارہ شامل کریں تو assets پھر نظر آئیں گے۔ ہٹانے سے پہلے نام، RPC اور Chain ID لکھ لیں۔
API Key، address اور wallet control محفوظ رکھیں
RPC provider آپ کا IP، query time اور queried public addresses دیکھ سکتا ہے، اس لیے activity کے تعلق کا اندازہ لگا سکتا ہے۔ Privacy اہم ہو تو provider policy پڑھیں، غیر ضروری third-party endpoints کم کریں، اور کئی غیر متعلق addresses ایک نامعلوم RPC سے query نہ کریں۔ Public address password نہیں، مگر address، screenshot اور timeline اکٹھے دینے سے قابل ربط معلومات بڑھتی ہیں۔
API Key seed phrase نہیں، مگر quota استعمال یا provider account ظاہر کر سکتی ہے؛ اسے public guide، support screenshot یا chat میں نہ دیں۔ Recovery phrase، private key یا wallet password کسی website، RPC provider یا support person کو نہ دیں۔ Wallet app خود local unlock کے لیے password مانگ سکتی ہے؛ یہ password تیسرے فریق کو دینا نہیں۔ “RPC activate” کرنے کے لیے approve، Permit یا transfer sign کرانے والا page فوراً بند کریں۔
Connection error کا معمول کا حل wallet reinstall، data delete یا restore نہیں۔ اس سے chain RPC درست نہیں ہوتا اور بغیر backup local accounts، networks اور notes ضائع ہو سکتے ہیں۔ پرانا working RPC، exact error، wallet version اور check date رکھیں۔ Reset واقعی لازم ہو تو backup درست ہونے کی تصدیق کے بعد صرف wallet کی official recovery instructions پر عمل کریں۔
کون سا نتیجہ مکمل سمجھا جائے
آخر میں آپ بتا سکیں: target ایک EVM testnet ہے؛ wallet میں duplicate entry نہیں؛ پانچ parameters کس page سے کس تاریخ کو لیے؛ Save پر Chain ID یا connection error نہیں آیا؛ درست network منتخب ہے؛ same-network explorer public address یا معلوم record کھولتا ہے؛ اور network setting کے لیے نہ کچھ sign کیا نہ funds منتقل کیے۔ Balance 0 ہو سکتا اور project site ابھی disconnected ہو سکتی ہے؛ یہ دونوں درست network addition کو رد نہیں کرتے۔
اب اصل ضرورت کے مطابق آگے بڑھیں: test tokens کے لیے testnet faucet troubleshooting؛ on-chain record کے باوجود wallet 0 ہو تو missing wallet balance guide؛ بھیجنے سے پہلے gas fee اور native balance؛ signature prompt پر wallet signature کی اقسام اور خطرات؛ decimal اور hexadecimal کے لیے Chain ID converter۔