پیش از افزودن تست‌نت به کیف پول، RPC، Chain ID و مرورگر بلاک را چگونه بررسی کنیم
وقتی یک پروژه می‌گوید «تست‌نت را اضافه کنید»، کار با کپی‌کردن چند مقدار و زدن Save تمام نمی‌شود. این راهنما فقط برای شبکه‌های سفارشی سازگار با EVM است: ابتدا ببینید شبکه از قبل در MetaMask پشتیبانی یا پنهان شده است، سپس RPC، Chain ID و مرورگر بلاک را از مدارک نگهدارنده شبکه بگیرید و بدون انتقال پول اتصال را بررسی کنید. مدل حساب و اتصال Solana، Bitcoin و شبکه‌های غیر EVM متفاوت است؛ این فیلدها را برای آن‌ها به کار نبرید.
ابتدا تست‌نت موجود یا پنهان را پیدا کنید
نام کامل شبکه را در انتخاب‌گر شبکه خود کیف پول جست‌وجو کنید. طبق راهنمای فعلی MetaMask Extension، از منوی بالا سمت راست وارد Networks شوید. ممکن است شبکه زیر Additional networks باشد و گزینه Show test networks نیز پایین فهرست قرار دارد. در Mobile، منوی شبکه بالای زبانه Tokens را باز کنید تا شبکه‌های موجود و اضافی را ببینید. جای دکمه یا ترجمه آن ممکن است با نسخه، سیستم‌عامل یا انتشار مرحله‌ای فرق کند؛ فهرست نسخه فعلی خودتان را مبنا بگیرید و برای شبیه‌شدن به یک تصویر قدیمی تنظیمات را reset نکنید.
اگر شبکه در فهرست است، همان گزینه داخلی را Add کنید یا نمایش تست‌نت‌ها را روشن کنید؛ شبکه سفارشی هم‌نام نسازید. اگر قبلاً آن را دستی افزوده‌اید، صفحه Edit را باز و نام، RPC و Chain ID فعلی را ثبت کنید. RPC سالم قبلی را نگه دارید تا اگر endpoint جدید از کار افتاد بتوانید برگردید. فقط وقتی شبکه واقعاً در فهرست موجود، اضافی یا پنهان نیست، افزودن دستی را شروع کنید. همچنین فرض نکنید شبکه‌های سفارشی Extension و Mobile خودکار میان دستگاه‌ها همگام می‌شوند؛ هر دستگاه مورد استفاده را جداگانه بررسی کنید.
پیش از افزودن دستی پنج مورد را ثبت کنید
مدارک رسمی نگهدارنده شبکه را باز کنید یا از وب‌سایت رسمی او به صفحه اطلاعات شبکه بروید. مقدارها را فقط از تبلیغ جست‌وجو، تصویر گروه، پیام خصوصی «پشتیبانی» یا دکمه Copy یک صفحه وظیفه نگیرید. پنج فیلد را همراه URL منبع و تاریخ بررسی در یادداشت محلی بنویسید: نام شبکه، RPC URL با آغاز https://، Chain ID، نماد ارز بومی و URL مرورگر بلاک. اگر چند RPC ارائه شده، مشخص کنید کدام عمومی است و کدام حساب ارائه‌دهنده یا API Key می‌خواهد.
| فیلد | به چه پرسشی پاسخ می‌دهد | پیش از Save چه چیزی را ببینید |
|---|---|---|
| نام شبکه | برچسب داخل کیف پول | خوانا باشد؛ نام دلیل امنیت نیست |
| RPC URL | کیف پول از کدام node می‌خواند و می‌نویسد | HTTPS، hostname کامل و نیاز به احراز هویت |
| Chain ID | درخواست و امضا مربوط به کدام زنجیره EVM است | مقدار منتشرشده در منبع رسمی |
| نماد بومی | دارایی کارمزد با چه نامی نمایش داده می‌شود | طبق مدارک، نه ticker یک قرارداد توکن |
| URL مرورگر | بلاک، آدرس و تراکنش را کجا می‌خوانید | دامنه پایه از نگهدارنده، نه لینک تراکنش ناشناس |
پارامترهای تست‌نت و RPC عمومی ممکن است تغییر کنند. تاریخ توضیح می‌دهد چرا چیزی قبلاً کار می‌کرده و اکنون نه، و نشان می‌دهد کدام صفحه باید دوباره بررسی شود. اگر منابع ظاهراً رسمی اختلاف دارند، توقف کنید و مدارک و اعلان فعلی نگهدارنده را مبنا قرار دهید؛ از ترکیب مقدارهای پرتکرار یک configuration نسازید.
Chain ID را کجا تطبیق دهیم: منبع اول همیشه مستندات نگهدارندهٔ شبکه است. برای منبع دوم از فهرست‌های عمومی زنجیره‌ها استفاده کنید: chainlist.org (زیر نظر DefiLlama؛ برای دیدن تست‌نت‌ها باید Include Testnets را تیک بزنید؛ برای هر زنجیره Chain ID، نماد بومی و چند RPC نشان می‌دهد) و chainid.network (بر پایهٔ دادهٔ جامعه‌محور ethereum-lists/chains؛ MetaMask هنگام ذخیرهٔ شبکه در Network details check از همین استفاده می‌کند). فقط وقتی Chain ID در هر دو یکی بود آن را وارد کنید. بسیاری از RPCهای این فهرست‌ها node شخص ثالث‌اند و توصیهٔ رسمی نیستند؛ حتی اگر با دکمهٔ سایت فهرست یک‌کلیکی اضافه می‌کنید، هر فیلد پنجرهٔ کیف پول را با اطلاعات نگهدارنده تطبیق دهید.
RPC، Chain ID و مرورگر را جداگانه بسنجید
hostname مربوط به RPC را نویسه‌به‌نویسه بخوانید. به واژه اضافه، حروف شبیه، دامنه سطح‌بالای اشتباه و جایگزینی http:// به جای https:// توجه کنید. ارائه‌دهنده معتبر node ممکن است دامنه خودش را داشته باشد، اما مدارک نگهدارنده باید او یا روش پیکربندی را روشن معرفی کند. قالب دارای جای خالی API Key را همان‌طور استفاده نکنید و Key خود را در مبدل این سایت، جست‌وجو، گفتگو یا تصویر paste نکنید.
Chain ID عدد صحیح است. فرم دستی کیف پول معمولاً مقدار decimal می‌خواهد، در حالی که eth_chainId در JSON-RPC معمولاً مقدار hexadecimal با 0x برمی‌گرداند. این دو نمایش می‌توانند یک عدد باشند. نیازی به اجرای دستور نیست؛ با مبدل decimal/hex Chain ID سایت به‌صورت محلی تبدیل و مقایسه کنید. قالب مورد نیاز هر فیلد را رعایت کنید: مقدار decimal رسمی برای فرم دستی MetaMask و رشته hexadecimal با 0x برای درخواست EIP-3085. ابزار سایت RPC را فراخوانی نمی‌کند و معتبر بودن node را تأیید نمی‌کند. MetaMask هنگام Save ممکن است ناسازگاری ID یا مشکل اتصال را گزارش کند، اما نبود خطا به‌تنهایی صداقت node را ثابت نمی‌کند.
مرورگر بلاک یک مسیر خواندن دوم است، نه فیلد تزئینی RPC. صفحه اصلی مرورگر را از مدرک نگهدارنده باز و بررسی کنید همان تست‌نت را نشان می‌دهد. gwei واحد اندازه‌گیری ETH است و کیف پول معمولاً قیمت هر واحد Gas را با آن نشان می‌دهد؛ شناسه شبکه نیست؛ مقدار gas، Network ID، شناسه توکن یا عدد داخل URL مرورگر را جای Chain ID نگذارید.
شبکه را در MetaMask بدون امضای تراکنش اضافه کنید
Extension: منوی بالا سمت راست را باز کنید، به Networks بروید و ابتدا جست‌وجو و Additional networks را ببینید. اگر شبکه نیست، Add a custom network را بزنید، فیلدهای بررسی‌شده را وارد و Save کنید. Mobile: منوی شبکه بالای زبانه Tokens را بزنید، به Custom بروید و Add a custom network را انتخاب کنید. این مسیرهای فعلی MetaMask Help Center هستند. اگر رابط شما فرق دارد، راهنمای جاری و نسخه برنامه را بررسی کنید و دکمه‌ای را صرفاً به دلیل شباهت حدس نزنید.
برخی سایت‌ها درخواست Add network نشان می‌دهند. wallet_addEthereumChain در EIP-3085 یک proposal برای پیشنهاد افزودن زنجیره EVM به کیف پول است، نه تضمین پشتیبانی همه کیف پول‌ها. کیف پول می‌تواند فیلد بیشتری بخواهد، فیلدی را نادیده بگیرد یا درخواست را رد کند. پاسخ موفق نیز تضمین نمی‌کند شبکه جاری عوض شده باشد؛ به انتخاب‌گر شبکه برگردید و آن را تأیید کنید. name، RPC، Chain ID و explorer داخل درخواست سایت را همچنان با یادداشت نگهدارنده بسنجید.
افزودن شبکه فقط configuration اتصال را ذخیره می‌کند. روند عادی به approve، Permit، امضای پیام، انتقال یا «هزینه تأیید» نیاز ندارد. اگر بلافاصله چنین درخواستی آمد، Reject کنید و آن را عملیات پرریسک جداگانه بدانید. Add یا switch کردن bridge نیست و ETH، تست‌توکن یا دارایی دیگری را میان زنجیره‌ها جابه‌جا نمی‌کند.
MetaMask: How to add a network · EIP-3085: wallet_addEthereumChain
نمونه امن با Base Sepolia
فرض کنید می‌خواهید تست‌نت Base را اضافه کنید، نه Base mainnet. طبق صفحه اتصال Base که در بررسی شد، این یادداشت را بسازید:
| فیلد کیف پول | مقدار این نمونه | نکته بررسی |
|---|---|---|
| نام شبکه | Base Sepolia | به‌روشنی testnet است |
| RPC URL | https://sepolia.base.org | HTTPS و hostname کامل |
| Chain ID | 84532 | همین decimal را در فرم دستی وارد کنید؛ معادل توضیحی آن 0x14a34 است |
| نماد بومی | ETH | ticker یک تست‌توکن نیست |
| مرورگر بلاک | https://sepolia.basescan.org | دامنه و صفحه هر دو Sepolia را نشان می‌دهند |
صفحه مدارک و فرم را کنار هم بگذارید، هر ردیف را وارد کنید و دوباره بخوانید. اگر جایی Chain ID برابر 8453 دیدید، آن Base mainnet است؛ مقدارهای mainnet و Base Sepolia را در یک entry مخلوط نکنید. پیش از ویرایش شبکه موجود، RPC سالم قبلی را یادداشت یا از آن تصویر بگیرید و هر Key را بپوشانید. این نمونه روش بررسی را نشان می‌دهد و ماندگاری endpoint عمومی را تضمین نمی‌کند؛ در صورت تغییر، صفحه اتصال فعلی Base را دنبال کنید.
پس از ذخیره، اتصال را بدون انتقال بررسی کنید
پس از Save، خودتان شبکه هدف را انتخاب کنید. پیش از faucet، انتقال یا امضا، ببینید کیف پول می‌تواند صفحه دارایی را تازه کند و خطای اتصال نشان نمی‌دهد. آدرس عمومی حساب جاری را کپی و در مرورگر همان زنجیره که قبلاً بررسی کرده‌اید باز کنید. نام شبکه در مرورگر و کیف پول باید یکسان و همه نویسه‌های آدرس برابر باشد. موجودی 0 برای آدرس تستی استفاده‌نشده طبیعی است؛ نه گم‌شدن دارایی را ثابت می‌کند و نه به‌تنهایی configuration را رد می‌کند.
اگر تراکنش یا آدرس شناخته‌شده‌ای در آن تست‌نت دارید، block height و status آن را در مرورگر بخوانید و برای مقایسه کمکی با فعالیت اخیر کیف پول به کار ببرید. فقط برای ساختن «تراکنش آزمایشی» ابتدا پول واریز نکنید. Ethereum.org توضیح می‌دهد شبکه‌ها مستقل‌اند: یک آدرس حساب EVM می‌تواند در چند شبکه به کار رود، اما موجودی و تاریخچه تراکنش از mainnet به testnet منتقل نمی‌شود. برای آزمایش بهتر است جداسازی حساب mainnet و testnet را هم در نظر بگیرید.
نتیجه قابل قبول چنین است: شبکه هدف در کیف پول انتخاب شده، Save بدون خطای Chain ID یا اتصال انجام شده، مرورگر همان زنجیره آدرس درست یا یک رکورد عمومی شناخته‌شده را باز می‌کند و در این بررسی امضا یا انتقال دارایی رخ نداده است. این بررسی صداقت RPC را اثبات نمی‌کند. اگر فقط موجودی کم است، به مشکل موجودی یا faucet بروید و شبکه تکراری نسازید.
خطا هنگام افزودن شبکه: راه‌حل Could not fetch chain ID و پیام‌های دیگر
پیام‌های انگلیسی پررنگ زیر متن دقیق رابط فعلی افزونهٔ MetaMask است (در سپتامبر 2026 با متن انگلیسی کد متن‌باز MetaMask تطبیق داده شد)؛ در موبایل یا کیف پول‌های دیگر ممکن است عبارت کمی فرق کند، اما علت همان است.
Could not fetch chain ID. Is your RPC URL correct?: کیف پول به این RPC دسترسی ندارد. URL کامل، HTTPS، اتصال اینترنت و نیاز endpoint به API Key را بررسی کنید؛ RPC عمومی ممکن است down یا rate-limited هم باشد، پس کمی بعد endpoint دیگری را که خود نگهدارنده فهرست کرده امتحان کنید. برای «unlock» در سایت ناشناس پول ندهید و node پیام خصوصی را به کار نبرید.
The RPC URL you have entered returned a different chain ID (…).: عدد داخل پرانتز Chain ID زنجیره‌ای است که node واقعاً به آن تعلق دارد. آن را در chainlist.org جست‌وجو کنید تا معلوم شود node مال کدام زنجیره است؛ معمولاً RPC مین‌نت یا تست‌نت دیگری قاطی شده است. RPC مستندات نگهدارنده را برگردانید؛ برای جورشدن با node، Chain ID را تغییر ندهید.
This Chain ID is currently used by the … network.: در کیف پول از قبل شبکه‌ای با همین Chain ID هست (پیش‌فرض یا شبکه‌ای که قبلاً اضافه کرده‌اید). آن را در فهرست شبکه‌ها پیدا کنید و مستقیم استفاده کنید، یا از منوی سه‌نقطه RPC آن را ویرایش کنید؛ نسخهٔ تکراری با پسوند «2» نسازید. پیش از ویرایش، 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 می‌دهد و جلوی ذخیره را نمی‌گیرد. دوباره با مستندات نگهدارنده تطبیق دهید: اگر فقط نوشتار نام یا نماد فرق دارد (مثلاً پروژه تازه نامش را عوض کرده) می‌توانید طبق مستندات بنویسید و ادامه دهید؛ اگر Chain ID یا RPC هم نمی‌خواند، توقف کنید.
Invalid RPC URL: قالب آدرس نادرست است. علت‌های رایج: جاافتادن https://، فاصلهٔ اضافه در ابتدا یا انتها، یا واردکردن نشانی کاوشگر بلاک به جای RPC.
This RPC provider is limiting requests. Try again later or use a different RPC URL.: اگر این پیام یا 429، 401/403، timeout یا موجودی خالی تکرار می‌شود، شلوغی RPC عمومی را از Key نادرست جدا کنید. Key را فقط در dashboard خود ارائه‌دهنده بسازید و مجوزش را طبق مدارک محدود کنید. اگر نگهدارنده جایگزین ندارد، توقف کنید و «سریع‌ترین RPC» تصادفی را جست‌وجو نکنید.
سایت هنوز wrong network می‌گوید: مطمئن شوید شبکه واقعاً انتخاب شده، نه اینکه فقط اضافه شده باشد. اتصال سایت را قطع و دوباره وصل، صفحه را refresh و نیاز سایت به testnet یا mainnet را بررسی کنید. اگر مشکل ماند، interaction را متوقف و Chain ID مورد انتظار سایت و Chain ID فعلی کیف پول را برای پشتیبانی ثبت کنید؛ prompt دورزدن را امضا نکنید.
شبکه یا RPC اشتباه اضافه شد: چطور اصلاح یا حذف کنیم
حذف کامل شبکه (افزونه): منوی بالا سمت راست، سپس Networks، کنار شبکه روی سه‌نقطه و بعد Delete بزنید و پیام «Delete … network?» را تأیید کنید. موبایل: منوی بالا سمت راست، Networks، سه‌نقطهٔ کنار شبکه و سپس Delete. شبکه‌های از پیش نصب‌شده مثل Ethereum Mainnet حذف نمی‌شوند؛ فقط شبکه‌هایی که خودتان اضافه کرده‌اید قابل حذف‌اند.
اگر فقط RPC اشتباه است، لازم نیست شبکه را حذف کنید. در افزونه از سه‌نقطهٔ کنار شبکه صفحهٔ ویرایش را باز کنید، در فهرست کشویی Default RPC URL گزینهٔ Add RPC URL را بزنید، آدرس درست را وارد و انتخاب کنید و RPC اشتباه را با آیکن سطل زبالهٔ کنارش حذف کنید. در موبایل: سه‌نقطه، Edit و سپس Add RPC URL. اگر Chain ID اشتباه است، کل شبکه را حذف و دوباره اضافه کنید.
حذف شبکه دارایی روی زنجیره را پاک نمی‌کند. خود MetaMask می‌گوید «If you delete this network, you will need to add it again to view your assets in this network»؛ همان زنجیره را دوباره اضافه کنید تا دارایی دوباره دیده شود. پیش از حذف، نام، RPC و Chain ID را یادداشت کنید.
از API Key، آدرس و کنترل کیف پول محافظت کنید
ارائه‌دهنده RPC می‌تواند IP، زمان پرس‌وجو و آدرس‌های عمومی مورد جست‌وجو را ببیند و رابطه فعالیت‌ها را حدس بزند. اگر حریم خصوصی مهم است، سیاست او را بخوانید، endpointهای ثالث غیرضروری را کم کنید و چند آدرس نامرتبط را هم‌زمان به RPC ناشناس نسپارید. آدرس عمومی رمز نیست، اما ترکیب آدرس، تصویر و خط زمانی اطلاعات قابل‌ارتباط را بیشتر می‌کند.
API Key عبارت بازیابی نیست، اما ممکن است سهمیه را مصرف یا حساب ارائه‌دهنده را افشا کند؛ آن را در راهنمای عمومی، تصویر تیکت یا گفتگو ننویسید. عبارت بازیابی، private key یا رمز کیف پول را به وب‌سایت، RPC provider یا فرد پشتیبانی ندهید. ممکن است خود برنامه کیف پول برای بازشدن محلی رمز بخواهد؛ این با تحویل رمز به شخص ثالث فرق دارد. صفحه‌ای را که برای «فعال‌سازی RPC» approve، Permit یا transfer می‌خواهد فوراً ببندید.
نصب دوباره، حذف داده کیف پول یا restore را راه‌حل معمول خطای اتصال ندانید. این کار RPC زنجیره را تعمیر نمی‌کند و ممکن است حساب، شبکه و یادداشت محلی بدون backup را از بین ببرد. RPC سالم قبلی، متن دقیق خطا، نسخه کیف پول و تاریخ بررسی را نگه دارید. اگر reset واقعاً لازم شد، فقط پس از اطمینان از backup و مطابق راهنمای رسمی بازیابی کیف پول اقدام کنید.
نتیجه‌ای که به معنی تکمیل کار است
در پایان باید بتوانید بگویید: هدف یک EVM testnet است؛ entry تکراری در کیف پول ندارید؛ می‌دانید پنج پارامتر از کدام صفحه و در چه تاریخی آمده‌اند؛ Save بدون خطای Chain ID یا اتصال انجام شده؛ شبکه درست انتخاب شده؛ مرورگر همان شبکه آدرس عمومی یا رکورد شناخته‌شده را پیدا می‌کند؛ و برای تنظیم شبکه چیزی امضا یا منتقل نکرده‌اید. موجودی می‌تواند 0 باشد و سایت پروژه هنوز وصل نباشد؛ هیچ‌کدام درست‌بودن افزودن شبکه را باطل نمی‌کند.
اکنون بر اساس نیاز واقعی ادامه دهید: برای تست‌توکن رفع مشکل faucet تست‌نت؛ برای رکورد روی زنجیره و نمایش 0 در کیف پول راهنمای موجودی گمشده؛ پیش از ارسال کارمزد gas و موجودی بومی؛ برای prompt امضا انواع و خطر امضای کیف پول؛ و برای decimal و hexadecimal مبدل Chain ID.