On-chain troubleshooting · Practical guide

Transaction hash পাওয়ার পর কী করবেন: Not found, Pending, Fail ও bridge-এ আটকে গেলে পরের ধাপ

Transaction hash, block explorer receipt ও failure troubleshooting guide cover
মূল কথা: Transaction hash chain request-এর unique clue, success certificate নয়। সঠিক network explorer-এ Status, From, To, Method/Instruction, time ও asset change একসঙ্গে না দেখলে “on-chain হয়েছে কি না, execution সফল কি না, asset কোথায় গেছে”—এই প্রশ্নগুলোর উত্তর পাওয়া যায় না।

Wallet 0x দিয়ে শুরু string বা Solana transaction signature দিলেই সেটি search box-এ ফেলে সিদ্ধান্ত নেবেন না। এই guide transaction hash lookup-কে repeatable workflow বানায়: সঠিক chain ও explorer নির্বাচন, transaction/receipt/logs পড়া, failure reason বের করা, তারপর wait, parameter fix, app support বা stop—কোনটি দরকার তা নির্ধারণ। শেষে আপনি নিজে একটি on-chain transaction verify এবং secret-free troubleshooting evidence তৈরি করতে পারবেন।

৩০ সেকেন্ডে দেখুন transaction কোন layer-এ

আপনার কাছে কী আছেকী বোঝা যায়Next step
শুধু wallet popup, hash নেইRequest broadcast হয়নি বা wallet/RPC result দেয়নিWallet Activity ও exact error দেখুন; “on-chain” বলবেন না
Hash আছে, explorer Not foundWrong network, indexing delay বা node request নেয়নিChain ID মিলিয়ে একবার পরে refresh
PendingTransaction দেখা গেছে, final block-এ যায়নিNonce, fee competition ও earlier tx দেখুন
SuccessExecution সফল; target/asset এখনও verify করতে হবেTo, Method, Logs, transfers ও final balance দেখুন
Failed/RevertedBlock-এ ঢুকেছে কিন্তু execution rollback হয়েছেReceipt, revert reason, params ও app state পড়ুন

1. আগে সঠিক network ও block explorer বাছুন

একই address বহু chain-এ থাকতে পারে; format এক হলেও balance ও history আলাদা। Wallet Activity বা project page থেকে network name ও Chain ID লিখে সেই network-এর public explorer খুলুন। শুধু “hash পাওয়া গেছে” বলে browser বিশ্বাস করবেন না—fake explorer page copy করতে পারে, wrong network Not found দেখাবে।

  1. Submit-এর সময় wallet যে network/account দেখিয়েছে তা লিখুন।
  2. Network/project documentation থেকে explorer খুলুন; ad বা DM shortlink নয়।
  3. Hash paste করে hostname, network badge, From ও time মিলান।
  4. Not found হলে wallet থেকে original hash কপি করে missing character/space/address mix-up বাদ দিন।

Testnet ও mainnet একই address format ব্যবহার করতে পারে, কিন্তু asset ও transaction আলাদা। Record না পেলে প্রথমে network দেখুন; real asset deposit করবেন না।

2. Transaction hash, wallet address, block ও contract address আলাদা করুন

Identifierকী বোঝায়Common mistake
Transaction hash/signatureএকটি নির্দিষ্ট transaction-এর index keyReceiving address ভাবা বা hash মানেই success ধরা
Wallet addressAccount/public key; বহু transaction যুক্তSingle receipt আশা করে tx search-এ paste
Contract/program addressযে code/program call হয়েছেRouter/proxy-কে final receiver ধরা
Block number/slotRecord-এর chain positionBlock time-কে wallet click time ভাবা
Token contract/mintAsset type-এর identityContract না দেখে শুধু symbol/icon বিশ্বাস

EVM hash সাধারণত 0x দিয়ে শুরু, কিন্তু prefix একা proof নয়। Solana transaction identifier-কে সাধারণত signature বলা হয়। Source, format এবং explorer-এর returned object type একসঙ্গে দেখুন।

3. Lifecycle: Not found, Pending, Success ও Failed

Not found failure নয়: network ভুল, index delay, RPC broadcast failure বা wallet request incomplete হতে পারে। Pending মানে final execution হয়নি; earlier nonce transaction পরেরগুলো আটকাতে পারে। Success execution complete, কিন্তু wrong contract-এ successful call-ও হতে পারে। Failed/Reverted মানে transaction block-এ গিয়ে rollback হয়েছে।

Green check যথেষ্ট নয়: From, To/Interacted With, Method, Value এবং token transfers আপনার intended action-এর সঙ্গে মেলে কি না দেখুন।

Status অনুযায়ী পরের ধাপ

Explorer যা দেখায়সাধারণত মানেএরপর কী করবেন
Transaction Hash not found (Etherscan-এর বার্তা)ভুল chain-এ খুঁজছেন, সবে পাঠানো হয়েছে বলে index হয়নি, অথবা transaction broadcast-ই হয়নিআগে chain ঠিক করুন: BNB Chain বা Polygon-এর transaction Ethereum-এর Etherscan-এ পাওয়া যাবে না, Sepolia testnet-এর জন্য sepolia.etherscan.io। কোন chain নিশ্চিত না হলে Blockscan-এ (Etherscan টিমের multichain search) একই hash খুঁজুন। সবে পাঠালে 30 সেকেন্ড অপেক্ষা করে refresh করুন; 1 ঘণ্টা পরেও না পেলে sender, exchange বা wallet-এর কাছে record চান। নিশ্চিত হওয়ার আগে অন্য amount দিয়ে আবার পাঠাবেন না।
PendingTransaction queue-তে আছে, এখনও block-এ ঢোকেনিNonce ও Max fee দেখে Gwei guide-এর ৭ নম্বর অংশ অনুযায়ী অপেক্ষা, Speed up বা Cancel ঠিক করুন; ভিন্ন parameter দিয়ে নতুন transaction পাঠাবেন না।
Success, কিন্তু প্রাপক বা wallet-এ দেখাচ্ছে নাChain-এ execution সফল; সমস্যা সাধারণত address, network, token display বা receiving platform-এর credit-এToken Transfers-এ receiver address ও token contract দেখুন; নিজের wallet-এ 0 দেখালে balance guide অনুযায়ী token import করুন; exchange-এ পাঠালে hash নিয়ে exchange-এর deposit history ও support-এ যান; bridge হলে নিচের ৯ নম্বর অংশ দেখুন।
Fail / Failed (সঙ্গে প্রায়ই একটি error text)Transaction block-এ ঢুকে revert হয়েছে: পাঠানোর asset যায়নি, কিন্তু Gas কেটেছে৭ নম্বর অংশের error table মিলিয়ে শর্ত ঠিক করুন, তারপর নতুন transaction পাঠান; failed transaction “cancel” করা যায় না, দরকারও নেই।

4. Real standards screenshot: receipt status

নিচের real webpage screenshot EIP-658-এর। এটি transaction receipt-এ status code কীভাবে execution success/failure আলাদা করে তা বোঝায়; এটি কোনো explorer-এর generated imitation নয়।

EIP-658 transaction receipt status code-এর বাস্তব webpage screenshot
EIP-658 receipt status field-এর standard semantics দেখায়।Source: EIP-658; screenshot captured 2026-09-03.

5. EVM transaction detail field কীভাবে পড়বেন

Fieldকোন প্রশ্নের উত্তরCheck
StatusExecution success/failureSubmitted/seen state-এর সঙ্গে মেশাবেন না
Block/Timestampকোথায় ও কখন recordBlock time wallet click time নাও হতে পারে
From/Toকে পাঠিয়েছে, সরাসরি কাকে callTo router/proxy হতে পারে
ValueNative asset direct amountToken transfer Logs-এ থাকতে পারে
NonceAccount transaction orderEarlier Pending nonce later tx আটকায়
Method/InputFunction ও paramsUnknown hex হলে source/ABI verify
Gas Used/Effective Gas PriceActual work ও unit priceFinal fee receipt থেকে, max budget থেকে নয়

Verified ABI থাকলে explorer Method ও parameters decode করতে পারে। Raw input বুঝতে না পারলে blind retry নয়; app instruction-এর expected method-এর সঙ্গে মিলান।

6. Receipt, Logs, Token Transfers ও Internal Transactions

Transaction object বলে কী request করা হয়েছিল; receipt বলে execution-এর ফল। Status, Gas Used, contractAddress (deployment), logs ও অন্য result fields post-execution evidence দেয়।

  • Logs/Events: Contract-written structured events; Transfer, Approval ও NFT movement সাধারণত এখান থেকে decode।
  • Token Transfers: Explorer-এর event-derived readable view; token contract অবশ্যই মিলান।
  • Internal Transactions/Traces: Contract execution-এর ভেতরের call/value flow; wallet-signed আলাদা external tx নয়।
  • Balance change: User result বুঝতে ভালো, তবে explorer scope ভিন্ন হতে পারে—raw event/wallet-এর সঙ্গে cross-check।

Transfer event না থাকলেও contract internal accounting, position বা approval বদলাতে পারে। আবার token transfer দেখা গেলেই asset-এর market value প্রমাণ হয় না।

7. Failed transaction: পূর্ণ troubleshooting order

  1. Failed না Pending? Pending হলে nonce/broadcast আগে; problem class আলাদা।
  2. Receipt ও exact error রাখুন: Block, To, Method, Gas Used, revert reason লিখুন।
  3. Business precondition: Balance, approval, deadline, slippage, whitelist, claim limit ও contract state check।
  4. Gas limit বনাম business revert: Out of gas-এর estimate ঠিক হতে পারে; explicit condition fail শুধু fee বাড়ালে ঠিক হয় না।
  5. Retry-এর আগে re-simulate: State/params অপরিবর্তিত হলে duplicate failure ও Gas cost হতে পারে।

Error text না থাকলে explorer Debug/Trace (যদি থাকে) বা app read-only simulation দেখুন। “On-chain support”-কে private key দেবেন না, unknown fix script চালাবেন না।

Fail-এর পাশে লেখা error: সাধারণ কারণ ও সমাধান

Error textকারণকী করবেন
Out of gasExecution-এর জন্য Gas Limit কম ছিল; সাধারণত হাতে Gas Limit কমালে হয়Wallet-এর suggested value ফিরিয়ে আবার পাঠান; একই contract-এর সাম্প্রতিক successful transaction-এর Gas Used দেখে আন্দাজ নিন।
ERC20: transfer amount exceeds balance / ERC20InsufficientBalanceToken amount balance-এর চেয়ে বেশি (decimals খেয়াল করুন)Balance ও লেখা amount মিলান; Gas-এর native coin আর token আলাদা হিসাব করুন।
ERC20: insufficient allowance / ERC20InsufficientAllowanceApprove করা limit কম, contract আপনার token নিতে পারছে নাProject page-এ আগে approve করুন (শুধু এবারের দরকারি amount), সফল হলে মূল কাজটি করুন।
UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT / Too little receivedSwap-এর সময় দাম আপনার slippage-এর বাইরে চলে গেছেQuote refresh করে আবার চেষ্টা করুন বা slippage সামান্য বাড়ান; লেনদেন করাতে slippage অনেক বাড়াবেন না, তাতে front-running-এর ঝুঁকি বাড়ে।
UniswapV2Router: EXPIRED / Transaction too oldTransaction বেশিক্ষণ Pending ছিল, deadline পেরিয়ে গেছেনতুন করে পাঠান এবং বর্তমান Gas fee যথেষ্ট দিন, যাতে দীর্ঘ সময় queue-তে না থাকে।
Project-এর নিজস্ব বার্তা (যেমন already claimed, not whitelisted) বা Bad instructionProject-এর শর্ত পূরণ হয়নি, বা token এখনও transfer করা যায় নাProject announcement দেখুন বা project-এর official site-এ দেওয়া channel-এ জিজ্ঞেস করুন; Gas বাড়িয়ে লাভ নেই।

এই error নামগুলো Etherscan-এর failed transaction ব্যাখ্যা এবং OpenZeppelin ERC-20 ও Uniswap router contract-এর source code থেকে নেওয়া (2026 সালের সেপ্টেম্বরে যাচাই)। অন্য project নিজের শব্দ ব্যবহার করতে পারে, তবে কারণ চেনার পদ্ধতি একই।

8. Confirmations ও finality: কখন next step নেবেন

Confirmations হলো transaction-এর block-এর পরে তৈরি block-এর সংখ্যা। Network, bridge, exchange ও app-এর requirement আলাদা, তাই সব chain-এর জন্য একটি fixed number নিরাপদ নয়। Receiver-এর public policy ও live chain state অনুসরণ করুন।

প্রথম Success দেখেই evidence বন্ধ করবেন না। Receiving app index করতে সময় নিতে পারে; testnet-এ chain Success ও task Completed দুইটি আলাদা state।

9. L2 ও bridge-এ একটি hash পুরো journey নয়

L2 explorer L1 data fee, batch বা message status দেখাতে পারে। Bridge action source lock/burn, relay এবং destination mint/release-এর একাধিক step তৈরি করতে পারে। Source-chain Success মানেই destination asset পৌঁছেছে নয়।

  • Source ও destination chain লিখুন।
  • Source hash, message ID এবং destination hash রাখুন।
  • Bridge status waiting/challenge/claimable/completed কোনটি দেখুন।
  • Delay হলে unknown “manual sync” page-এ wallet connect করবেন না।

Source chain-এ Success, destination-এ আসেনি: কোথায় দেখবেন, কার কাছে যাবেন

  1. যে bridge ব্যবহার করেছেন তার official site-এ ফিরে transaction history page খুলুন (সাধারণত History, Transactions বা Activity নামে); একই wallet connect করুন বা source hash দিয়ে status দেখুন।
  2. Bridge-এর message explorer থাকলে সেখানেও দেখা যায়: LayerZero message-এর জন্য LayerZero Scan (testnet-এর জন্য testnet.layerzeroscan.com), যেখানে status হয় Confirming, Inflight, Delivered, Failed, Blocked বা Payload Stored; Wormhole-এর জন্য Wormholescan। Delivered হলে destination hash নিয়ে destination chain-এর explorer-এ দেখুন; Confirming বা Inflight মানে এখনও confirmation বা execution বাকি; Payload Stored হলে সাধারণত bridge বা app page থেকে retry করতে হয়।
  3. Official native bridge-এর withdrawal প্রায়ই কয়েক ধাপে হয়: Optimism documentation অনুযায়ী OP Mainnet থেকে Ethereum mainnet-এ ফেরাতে 7 দিনের challenge period লাগে এবং মাঝে আপনাকে নিজে আরও transaction পাঠাতে হয়। Bridge page prove বা claim করতে বললে নিজে click করুন, না করলে asset আসবে না।
  4. Failed বা Blocked দেখালে, অথবা bridge page-এর estimated time পেরিয়ে গেলে: bridge-এর official site থেকে (search ad বা inbox link নয়) Help Center বা Discord ticket-এ যান; source ও destination chain-এর নাম, source hash, message ID (থাকলে), wallet address, সময় ও screenshot দিন।
  5. নিজে থেকে inbox-এ আসা “bridge support”, “sync/repair” site-এ wallet connect করতে বলা বা seed phrase চাওয়া—সবই প্রতারণা; আসল support-এর আপনার private key লাগে না। প্রতারিত হলে TxID, address ও chat-এর screenshot নিয়ে নিকটস্থ থানায় অভিযোগ করুন।

10. Solana: Signature, Slot, Instruction ও Program Logs

Solana explorer সাধারণত signature, slot, block time, fee payer, account keys, instructions, program logs, compute units ও token balance changes দেখায়। EVM nonce/gas price/event model হুবহু প্রয়োগ করবেন না।

  1. Cluster—mainnet, devnet বা project environment—নিশ্চিত করুন।
  2. Signature status ও slot, তারপর fee payer দেখুন।
  3. Instructions expand করে called program ও accounts যাচাই করুন।
  4. Failure-এ Program Logs-এর প্রথম relevant error খুঁজুন।
  5. Pre/post token balances intended result-এর সঙ্গে মিলান।

11. Transaction hash share করা যায়, কিন্তু linkability বুঝুন

Hash password নয় এবং public chain-এ query করা যায়। তবু এটি wallet address, time, balance change, contracts ও অন্য history link করে। Support-এ শুধু minimum hash, network ও exact error দিন; screenshot mask করুন।

  • Seed phrase, private key, OTP, session cookie বা wallet export কখনও নয়।
  • Email, social account, extensions, notifications ও অন্য tabs mask করুন।
  • Multiple wallet link না চাইলে একই screenshot/record-এ সব address দেখাবেন না।
  • DM “support” এলে official website support route থেকে নতুন করে যোগাযোগ করুন।

12. Wallet থেকে conclusion: complete workflow

  1. Wallet Activity থেকে original hash, network ও time নিন।
  2. Network/project docs থেকে correct explorer খুলুন।
  3. Status পড়ে Not found/Pending/Success/Failed branch নিন।
  4. From, To, Method/Instruction ও Value যাচাই করুন।
  5. Receipt, Logs, Token Transfers, Internal calls বা Program Logs দেখুন।
  6. Wallet balance ও app page compare করে chain/app sync আলাদা করুন।
  7. Minimum evidence রেখে conclusion লিখুন; কারণ না জানা পর্যন্ত re-sign নয়।

Result testnet task record-এ লিখুন। Fee বুঝতে Gwei/Gas guide, approval issue-তে revoke guide ব্যবহার করুন।

13. তিনটি common case

A: Wallet sent, explorer Not found

Network ও hash source মিলান। Correct network হলে অল্প অপেক্ষা করে Wallet Activity refresh; chain hash না থাকলে RPC/error evidence দেখুন, সঙ্গে সঙ্গে ভিন্ন amount পাঠাবেন না।

B: Success, কিন্তু receiver token দেখায় না

Token contract, target address ও network যাচাই করুন। Wallet token add না করা, RPC display delay, bridge-এর next step বা same-symbol fake token হতে পারে।

C: Failed, Gas কাটা

Transaction block-এ execute হয়ে rollback করেছে; computation-এর fee থাকতে পারে। Revert reason ও precondition ঠিক করে re-simulate করুন। Failed tx cancel করে spent Gas ফেরত আসে না।

14. Verification checklist

  • Network/Chain ID বা Solana cluster নিশ্চিত।
  • Hash নিজের Wallet Activity থেকে।
  • Status ও confirmations পড়া হয়েছে।
  • From, To, Method/Instruction, Value মিলেছে।
  • Receipt, Logs/Transfers বা Program Logs দেখা হয়েছে।
  • Token contract/mint ও destination যাচাই।
  • Chain state ও app state আলাদা record।
  • Screenshot masked, secret নেই।
  • Clear cause ছাড়া retry নয়।

সাধারণ প্রশ্ন

Hash থাকলেই transfer সফল?

না। Hash শুধু transaction খুঁজে পাওয়ার চিহ্ন; সঠিক network-এ Status, From, To ও asset change দেখতে হবে।

Explorer-এ “Transaction Hash not found” দেখালে কী করব?

আগে দেখুন কোন chain-এ খুঁজছেন: BNB Chain, Polygon বা testnet-এর transaction Ethereum mainnet-এর Etherscan-এ পাওয়া যায় না; Blockscan-এ একই hash দিয়ে multichain search করুন। সবে পাঠালে 30 সেকেন্ড পরে refresh করুন; 1 ঘণ্টা পরেও না পেলে sender, exchange বা wallet-এর কাছে record চান, আর নিশ্চিত হওয়ার আগে অন্য amount দিয়ে আবার পাঠাবেন না।

Success কিন্তু asset নেই কেন?

Destination address, network ও token contract মিলান, তারপর দেখুন bridge-এর পরের ধাপ বাকি কি না বা receiving platform আরও confirmation চাইছে কি না। Wallet display delay মানে chain-এ asset নেই এমন নয়; exchange-এ পাঠালে hash নিয়ে exchange-এর deposit history দেখুন।

Failed transaction cancel করা যায়? টাকা কোথায় গেল?

Cancel করা যায় না, দরকারও নেই: Failed মানে transaction block-এ ঢুকে revert হয়েছে, পাঠানোর asset বের হয়নি, শুধু Gas কেটেছে। Status-এর পাশের error (যেমন Out of gas, insufficient allowance, Too little received) দেখে শর্ত ঠিক করে নতুন transaction পাঠান।

Bridge-এর source chain-এ Success, destination-এ আসেনি—কার কাছে যাব?

আগে bridge-এর official site-এর history page বা LayerZero Scan, Wormholescan-এর মতো message explorer-এ source hash দিয়ে status দেখুন; processing চললে অপেক্ষা করুন, claim লাগলে নিজে claim করুন। Failed, Blocked বা সময় পেরিয়ে গেলে official site থেকে Help Center-এ ticket খুলুন, সঙ্গে source hash, দুই chain-এর নাম, wallet address ও সময় দিন। নিজে থেকে inbox-এ আসা “support” প্রতারক।

Support-কে hash দেওয়া safe?

Hash secret নয়, কিন্তু address/activity link করে। Official support-এ minimum data দিন; seed phrase/private key/OTP কখনও নয়।

Sources

শেষ check: 2026-09-28। এবার যোগ হয়েছে status অনুযায়ী পরের ধাপ, common failure-এর table এবং bridge-এ আটকে গেলে কোথায় দেখবেন ও কার কাছে যাবেন; explorer-এর বার্তা ও bridge status-এর নাম 2026 সালের সেপ্টেম্বরে মিলিয়ে দেখা।