ওয়ালেটে টেস্টনেট যোগ করার আগে RPC, Chain ID ও ব্লক এক্সপ্লোরার কীভাবে যাচাই করবেন

কোনো প্রজেক্ট ‘testnet যোগ করুন’ বললে শুধু কয়েকটি মান কপি করে ওয়ালেটে Save করলেই কাজ শেষ হয় না। এই নির্দেশিকা কেবল EVM-compatible custom network-এর জন্য: আগে দেখুন MetaMask নেটওয়ার্কটি আগে থেকেই সমর্থন করে কি না বা লুকিয়ে রেখেছে কি না, তারপর network maintainer-এর নথি থেকে RPC, Chain ID ও block explorer যাচাই করুন এবং কোনো অর্থ খরচ না করে কোনো transfer না করে connection পরীক্ষা করুন। Solana, Bitcoin বা অন্য non-EVM নেটওয়ার্কে একই field ও ধাপ প্রয়োগ করবেন না।

আগে existing বা hidden testnet খুঁজুন

ওয়ালেটের নিজস্ব network selector-এ সম্পূর্ণ network name দিয়ে খুঁজুন। MetaMask Extension-এর বর্তমান নির্দেশনায় ডান দিকের ওপরের menu থেকে Networks খুলতে হয়। তালিকায় Additional networks থাকতে পারে এবং নিচে Show test networks toggle থাকতে পারে। Mobile-এ Tokens tab-এর ওপরের network dropdown খুলে existing ও additional network দেখুন। Version, operating system ও staged rollout-এর কারণে button-এর অবস্থান বা অনুবাদ বদলাতে পারে; তাই আপনার বর্তমান তালিকাই অনুসরণ করুন, পুরোনো screenshot-এর সঙ্গে মেলাতে setting reset করবেন না।

Network-টি তালিকায় থাকলে built-in entry-তে Add চাপুন বা testnet display চালু করুন; একই নামে আরেকটি custom network বানাবেন না। আগে manual entry তৈরি করে থাকলে Edit screen খুলে বর্তমান name, RPC ও Chain ID লিখে রাখুন। সেটি পড়তে পারলে working RPC-টি রেখে দিন, নতুন endpoint ব্যর্থ হলে যাতে ফিরে যেতে পারেন। Existing, additional ও hidden list-এ সত্যিই না থাকলেই manual add করুন। Extension ও Mobile-এর custom network স্বয়ংক্রিয়ভাবে এক device থেকে অন্যটিতে sync হবে ধরে নেবেন না; দুই জায়গায় আলাদাভাবে পরীক্ষা করুন।

MetaMask : How to view testnets in MetaMask

MetaMask Help Center-এর View testnets in MetaMask নিবন্ধের শিরোনাম, testnet funds warning এবং network management illustration-এর ওপরের অংশ
MetaMask-এর public help page-এর screenshot, 2026-09-07। ছবির ওপরের লেখায় Networks থেকে Show test networks ব্যবহারের নির্দেশনা আছে; এটি আমাদের কোনো wallet-এর live test নয়। বড় করে দেখতে ছবিতে চাপুন। MetaMask Help Center

Manual add-এর আগে পাঁচটি তথ্য নিন

Network maintainer-এর official documentation খুলুন, অথবা তার official site থেকে network information page-এ যান। Search ad, group-chat image, ব্যক্তিগত message-এর ‘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 nameWallet-এ labelএটি শুধু পড়ার সুবিধা, নিরাপত্তার প্রমাণ নয়
RPC URLWallet কোন node-এ read/write করবেHTTPS, পুরো hostname, authentication দরকার কি না
Chain IDRequest ও signature কোন EVM chain-এরOfficial documentation-এ প্রকাশিত value; Save-এ ID mismatch নেই
Native symbolFee asset কী নামে দেখাবেDocumentation-এর মান, token contract-এর ticker নয়
Explorer URLBlock, address ও transaction কোথায় পড়বেনMaintainer-এর দেওয়া root domain, অচেনা transaction link নয়

Testnet ও public RPC-এর parameter বদলাতে পারে। Date রাখলে আগে কেন কাজ করেছিল আর এখন কেন করছে না বোঝা যায় এবং কোন documentation আবার খুলতে হবে জানা থাকে। দুই official-looking page-এ অমিল হলে থামুন; maintainer-এর বর্তমান documentation ও announcement দেখুন, ভোট গুনে আলাদা মান জোড়া দিয়ে configuration বানাবেন না।

Chain ID কোথায় মিলিয়ে দেখবেন: প্রথম উৎস সবসময় network maintainer-এর documentation। দ্বিতীয় উৎস হিসেবে public chain directory ব্যবহার করুন: chainlist.org (DefiLlama চালায়; testnet দেখতে Include Testnets টিক দিতে হয়; প্রতিটি chain-এর Chain ID, native symbol ও কয়েকটি RPC দেখায়) এবং chainid.network (community-চালিত ethereum-lists/chains তথ্য থেকে; MetaMask network save করার সময় Network details check-এ এটিই ব্যবহার করে)। দুই জায়গায় Chain ID মিললে তবেই বসান। Directory-র অনেক RPC তৃতীয় পক্ষের node, official সুপারিশ নয়; directory site-এর button দিয়ে এক ক্লিকে যোগ করলেও wallet-এর popup-এর প্রতিটি field maintainer-এর তথ্যের সঙ্গে মিলিয়ে নিন।

RPC, Chain ID ও explorer আলাদাভাবে মিলান

RPC hostname অক্ষর ধরে দেখুন: বাড়তি শব্দ, দেখতে একই রকম letter, ভুল top-level domain এবং https://-এর বদলে http:// বিশেষভাবে খেয়াল করুন। বৈধ third-party node provider-এর নিজস্ব domain থাকতে পারে, তবে maintainer-এর documentation-এ সেটি বা সেটআপ পদ্ধতি স্পষ্ট থাকা উচিত। API Key-এর placeholder-সহ URL হুবহু ব্যবহার করবেন না এবং নিজের Key এই site-এর converter, search, chat বা screenshot-এ paste করবেন না।

Chain ID একটি integer। Wallet form সাধারণত decimal চায়, আর JSON-RPC-এর eth_chainId সাধারণত 0x-যুক্ত hexadecimal দেয়। দুই representation একই সংখ্যাকে বোঝাতে পারে। Command চালানোর দরকার নেই; আমাদের decimal/hex Chain ID converter-এ local conversion ও comparison করুন। তবে যে field যে format চায় সেটিই দিন: MetaMask manual form-এ official decimal value, EIP-3085 request-এ 0x hexadecimal string। এই site-এর tool শুধু আপনার input বদলে ও তুলনা করে; এটি RPC-তে request পাঠায় না বা node authenticate করে না। MetaMask Save-এর সময় node response অনুযায়ী ID mismatch বা connection error দেখাতে পারে, কিন্তু error না থাকা node সৎ, domain official বা data সম্পূর্ণ হওয়ার প্রমাণ নয়।

Block explorer আলাদা read path, RPC form-এর সাজসজ্জা নয়। Maintainer-এর page থেকে explorer home খুলে দেখুন সেটি একই testnet চিহ্নিত করছে কি না। gwei ETH মাপার একটি unit; wallet সাধারণত প্রতি unit Gas-এর দাম এতে দেখায়, কিন্তু এটি network ID নয়; gas number, Network ID, token ID বা explorer URL-এর কোনো সংখ্যা Chain ID হিসেবে নেবেন না।

EIP-695 : eth_chainId

MetaMask-এ যোগ করুন, transaction sign নয়

Extension: ওপরের ডান menu থেকে Networks খুলে search ও Additional networks দেখুন। না থাকলে Add a custom network বেছে নিয়ে verified field-গুলো পূরণ করে Save করুন। Mobile: Tokens tab-এর ওপরের network dropdown থেকে Custom tab-এ যান, তারপর Add a custom network চাপুন। MetaMask Help Center বর্তমানে এই পথগুলোই বলে; আপনার interface আলাদা হলে current help ও app version পরীক্ষা করুন, শুধু দেখতে কাছাকাছি button অনুমান করে চাপবেন না।

কিছু project site Add network prompt দেখায়। EIP-3085-এর wallet_addEthereumChain একটি proposal, যার মাধ্যমে site wallet-কে EVM chain যোগ করার পরামর্শ দেয়। সব wallet এটি সমর্থন করবে এমন নিশ্চয়তা নেই; wallet অতিরিক্ত field চাইতে, কোনো field উপেক্ষা করতে বা request প্রত্যাখ্যান করতে পারে। Success মানেও current network স্বয়ংক্রিয়ভাবে বদলেছে এমন নয়। 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 থেকে আরেক 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 nameBase Sepoliaস্পষ্টভাবে testnet
RPC URLhttps://sepolia.base.orgHTTPS ও সম্পূর্ণ hostname
Chain ID84532, অর্থাৎ 0x14a34Manual form-এ decimal; hex হলো একই সংখ্যা
Native symbolETHকোনো test token-এর ticker নয়
Block explorerhttps://sepolia.basescan.orgDomain ও page দুটোই Sepolia

Documentation ও wallet form পাশাপাশি রেখে প্রতিটি row পূরণ করে আবার পড়ুন। অন্য source-এ Chain ID 8453 দেখলে সেটি Base mainnet; Base Sepolia configuration-এ দুই network-এর field মেশাবেন না। Save-এর আগে পুরোনো working RPC লিখে বা screenshot নিয়ে রাখুন এবং Key ঢেকে দিন। উদাহরণটি যাচাই পদ্ধতি শেখায়, public endpoint সব সময় চলবে এমন প্রতিশ্রুতি দেয় না; পরিবর্তন হলে Base-এর current connection page অনুসরণ করুন।

Base Docs : Connecting to Base

Save করার পর transfer ছাড়া connection দেখুন

Save করে target network নিজে select করুন। Faucet, transfer বা signature-এর আগে wallet latest block বা asset page load করতে পারে কি না দেখুন। Current account-এর public address copy করে verified same-chain explorer-এ খুলুন। Explorer-এর network name wallet-এর network-এর সঙ্গে এবং address-এর প্রতিটি character wallet-এর সঙ্গে মিলতে হবে। কখনো ব্যবহার না-করা test address-এ balance 0 স্বাভাবিক; এতে asset হারিয়েছে প্রমাণ হয় না এবং network read test-ও ব্যর্থ হয় না।

এই testnet-এ জানা transaction বা address থাকলে explorer-এ তার block height ও status পড়ে wallet activity-এর সঙ্গে সহায়ক তুলনা করতে পারেন। শুধু ‘verification transaction’ তৈরির জন্য আগে fund আনবেন না। Ethereum.org ব্যাখ্যা করে যে network-গুলো আলাদা: একই EVM account address একাধিক network-এ ব্যবহার হতে পারে, কিন্তু mainnet-এর balance ও transaction history testnet-এ আসে না। Testing-এর জন্য mainnet ও testnet account আলাদা রাখার কথাও ভাবুন।

বাস্তব ফল হবে: wallet-এ target network selected, Save-এ Chain ID বা connection error নেই, same-chain explorer সঠিক address বা পরিচিত public record খুলতে পারে এবং পুরো check-এ signature বা fund movement হয়নি। এতে RPC সৎ প্রমাণ হয় না। শুধু balance না থাকলে balance বা faucet সমস্যা হিসেবে পরের ধাপে যান; network আবার বানাবেন না।

Ethereum.org : Networks

Network যোগ করতে error এলে: Could not fetch chain ID-সহ প্রতিটি বার্তার সমাধান

নিচের bold ইংরেজি বার্তাগুলো MetaMask extension-এর বর্তমান interface-এর হুবহু লেখা (2026 সালের সেপ্টেম্বরে MetaMask-এর open-source code-এর ইংরেজি text থেকে মিলিয়ে দেখা); mobile বা অন্য wallet-এ ভাষা একটু আলাদা হতে পারে, কারণ একই।

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-এর তালিকাভুক্ত অন্য endpoint চেষ্টা করুন। অচেনা site-এর ‘unlock’ কিনবেন না, private message-এর node ব্যবহার করবেন না।

The RPC URL you have entered returned a different chain ID (…).: বন্ধনীর সংখ্যাটি হলো ওই node আসলে যে chain-এর, তার Chain ID। সংখ্যাটি chainlist.org-এ খুঁজলেই বোঝা যায় node কোন chain-এর—সাধারণত mainnet বা অন্য testnet-এর RPC মিশে গেছে। Maintainer-এর documentation-এর 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 বানাবেন না। 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-এর documentation আবার মিলান: শুধু নাম বা symbol-এর লেখা আলাদা হলে (যেমন project সম্প্রতি নাম বদলেছে) documentation অনুযায়ী লিখে এগোতে পারেন; 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 আলাদা করে দেখুন। কেবল provider-এর নিজস্ব dashboard-এ Key বানান এবং documentation অনুযায়ী permission সীমিত করুন। Maintainer alternative না দিলে থামুন; random ‘fastest RPC’ খুঁজে বসাবেন না।

Site এখনও wrong network: শুধু network যোগ হয়েছে নয়, বর্তমানে সেটিই selected কি না দেখুন। 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-এর মতো আগে থেকে থাকা network মোছা যায় না; শুধু নিজে যোগ করা network মোছা যায়।

শুধু RPC ভুল হলে network মুছতে হবে না। Extension-এ network-এর পাশের তিন-বিন্দু থেকে edit page খুলুন, Default RPC URL dropdown-এ Add RPC URL বেছে সঠিক address দিন এবং সেটি নির্বাচন করুন; ভুলটির পাশে trash icon চেপে মুছুন। Mobile-এ তিন-বিন্দু → Edit → Add RPC URL। Chain ID ভুল হলে পুরো network মুছে আবার যোগ করুন।

Network মুছলে chain-এর asset মুছে যায় না। MetaMask নিজেই জানায় “If you delete this network, you will need to add it again to view your assets in this network”—একই chain আবার যোগ করলেই asset আবার দেখা যাবে। মোছার আগে নাম, RPC ও Chain ID লিখে রাখুন।

API Key, address ও wallet control রক্ষা করুন

RPC provider আপনার IP, query time ও queried public address দেখতে পারে এবং address-এর সম্পর্ক অনুমান করতে পারে। Privacy গুরুত্বপূর্ণ হলে provider policy পড়ুন, অপ্রয়োজনীয় third-party endpoint কমান এবং বহু unrelated address একই অপরিচিত RPC-তে query করবেন না। Public address password নয়, কিন্তু address, screenshot ও timeline একসঙ্গে দিলে linkable তথ্য বাড়ে।

API Key seed phrase নয়, তবু quota খরচ ও account exposure ঘটাতে পারে। Public guide, support screenshot বা chat-এ দেবেন না। Recovery phrase, private key বা wallet password কোনো website, RPC provider বা support person-কে দেবেন না এবং remote control দেবেন না। Wallet app নিজে local unlock-এর জন্য password চাইতে পারে; এটি third party-কে password দেওয়া নয়। এগুলো upload করতে বললে বা RPC ‘activate’ করতে approve, Permit কিংবা transfer sign চাইলে সঙ্গে সঙ্গে বেরিয়ে যান।

Connection error-এর প্রথম সমাধান হিসেবে wallet reinstall, data delete বা restore করবেন না। এতে chain-এর RPC ঠিক হয় না, বরং backup না-থাকা local account, network ও note হারাতে পারেন। পুরোনো working RPC, exact error, wallet version ও check date রাখুন। Reset সত্যিই দরকার হলে wallet-এর official recovery instruction মেনে backup কার্যকর নিশ্চিত করার পর করুন।

কোন ফলকে কাজ সম্পন্ন বলা যায়

শেষে আপনি বলতে পারবেন: target একটি EVM testnet; wallet-এ duplicate entry নেই; পাঁচটি parameter কোন page থেকে কোন তারিখে এসেছে; Save-এ Chain ID বা connection error আসেনি; সঠিক network selected; same-network explorer public address বা পরিচিত record খুলেছে, কিন্তু network setting-এর জন্য আপনি sign বা fund transfer করেননি। Balance 0 হতে পারে এবং project site তখনও disconnected থাকতে পারে; তাতে সঠিক network add হওয়া বাতিল হয় না।

এবার সমস্যার ধরন অনুযায়ী এগোন: test token দরকার হলে testnet faucet troubleshooting; chain-এ record আছে কিন্তু wallet 0 দেখালে missing balance guide; পাঠানোর আগে gas fee ও native balance; signature prompt এলে wallet signature risk; decimal ও hexadecimal-এর জন্য Chain ID converter।

যাচাইকৃত উৎস