On-chain troubleshooting · Praktikal na guide

Pagkatapos makuha ang transaction hash: ano ang gagawin kapag Not found, Pending, Fail, o hindi dumating mula sa bridge

Transaction hash, block explorer receipt, at failure troubleshooting guide cover
Pinakamahalagang punto: Ang transaction hash ay unique clue para hanapin ang chain request, hindi certificate na successful ito. Sa explorer ng tamang network, pagsamahin ang Status, From, To, Method/Instruction, oras, at asset changes bago sabihing na-broadcast, nagtagumpay ang execution, o dumating ang asset.

Kapag nagbigay ang wallet ng string na nagsisimula sa 0x, o nagbigay ang Solana ng transaction signature, huwag itong ihulog sa kahit anong search box nang hindi alam ang network. Ginagawang repeatable workflow ng guide na ito ang transaction hash lookup: piliin ang tamang chain at explorer, basahin ang transaction, receipt at logs, hanapin ang failure reason, at magdesisyon kung wait, ayusin ang parameter, makipag-ugnayan sa app support, o huminto. Sa dulo, kaya mong mag-verify ng transaction at maghanda ng troubleshooting evidence nang walang secret.

Sa loob ng 30 segundo: saang layer nakatigil ang transaction

Ano ang hawak moAno ang masasabiSusunod
Wallet popup lang, walang hashHindi na-broadcast o walang result mula wallet/RPCWallet Activity at exact error; huwag sabihing on-chain na
May hash, Not foundMaling network, index delay, o hindi tinanggap ng nodeI-match ang Chain ID at mag-refresh minsan mamaya
PendingNakita pero hindi pa finalNonce, fee competition, at naunang tx
SuccessSuccessful ang execution; kailangan pa ring i-verify ang target/assetTo, Method, Logs, transfers, final balance
Failed/RevertedNasa block ngunit nag-rollback ang executionReceipt, revert reason, params, app state

1. Piliin muna ang tamang network at block explorer

Maaaring pareho ang address format sa maraming chain pero magkahiwalay ang balance at history. Kunin ang network name at Chain ID mula sa Wallet Activity o project page at buksan ang public explorer ng network na iyon. Hindi sapat na “nahanap ang hash” para maging lehitimo ang site; kayang kopyahin ng fake explorer ang layout, at Not found naman ang maling network.

  1. Itala ang network at account sa wallet noong submit.
  2. Mula sa network/project documentation buksan ang explorer; huwag ad o DM shortlink.
  3. Pagka-paste, i-match ang hostname, network badge, From at oras.
  4. Kung Not found, kopyahin ulit ang original hash mula sa wallet at alisin ang missing character/space/address mix-up.

Sa testnet, maaaring kapareho ng mainnet ang address format pero hiwalay ang assets at transactions. Network muna ang i-check; huwag magdeposito ng real asset para lang “lumabas” ang record.

2. Pagkaiba ng transaction hash, wallet address, block at contract

IdentifierIbig sabihinKaraniwang mali
Transaction hash/signatureIndex key ng isang transactionGawing receiving address o isiping success agad
Wallet addressAccount/public key na may maraming txUmasa sa isang receipt kapag address ang sinearch
Contract/program addressCode/program na tinawagIsiping final receiver ang router/proxy
Block number/slotPosisyon ng record sa chainIsiping wallet click time ang block time
Token contract/mintIdentity ng asset typeSymbol/icon lang ang tinitingnan

Karaniwang nagsisimula sa 0x ang EVM hash, pero hindi proof ang prefix lang. Sa Solana, signature ang karaniwang tawag sa transaction identifier. Gamitin ang source, format at returned object type ng explorer.

3. Status lifecycle: Not found, Pending, Success at Failed

Ang Not found ay hindi awtomatikong failure: maaaring maling network, index delay, RPC broadcast failure o incomplete wallet request. Ang Pending ay hindi pa final; puwedeng humarang ang mas naunang nonce. Ang Success ay completed execution pero maaaring successful na maling contract call. Ang Failed/Reverted ay nasa block ngunit nag-rollback.

Hindi sapat ang green check: Itugma ang From, To/Interacted With, Method, Value at token transfers sa intensyon mo.

Susunod na hakbang ayon sa Status

Ipinapakita ng explorerKadalasang ibig sabihinSusunod na gagawin
Transaction Hash not found (mensahe ng Etherscan)Maling chain ang hinahanapan, kapapadala lang kaya hindi pa na-index, o hindi talaga na-broadcast ang transaksyonAyusin muna ang chain: hindi makikita sa Etherscan ng Ethereum ang transaksyon sa BNB Chain o Polygon, at sa sepolia.etherscan.io ang para sa Sepolia testnet. Kung hindi sigurado kung aling chain, hanapin ang parehong hash sa Blockscan (multichain search ng team ng Etherscan). Kung kapapadala lang, maghintay ng 30 segundo bago mag-refresh; kung wala pa rin pagkalipas ng 1 oras, humingi ng record sa nagpadala, exchange, o wallet. Huwag magpadala ulit ng ibang halaga hangga't hindi malinaw.
PendingNakapila pa, hindi pa pumapasok sa blockTingnan ang nonce at Max fee at sundan ang bahagi 7 ng Gwei guide para magpasya kung maghihintay, magpa-Speed Up, o mag-Cancel; huwag magpadala ng bagong transaksyon na iba ang parameters.
Success, pero wala sa tatanggap o sa walletTagumpay ang execution sa chain; kadalasan nasa address, network, token display, o pag-credit ng receiving platform ang problemaTingnan ang receiver address at token contract sa Token Transfers; kung 0 sa sarili mong wallet, i-import ang token ayon sa balance guide; kung sa exchange ipinadala, dalhin ang hash sa deposit history at support ng exchange; kung bridge, tingnan ang bahagi 9 sa ibaba.
Fail / Failed (madalas may kasamang error text)Pumasok sa block pero nag-revert: hindi umalis ang ipinapadalang asset, pero nabawasan ng GasItugma sa error table ng bahagi 7, ayusin ang kondisyon, saka magpadala ng bagong transaksyon; hindi puwede at hindi kailangang “i-cancel” ang failed transaction.

4. Tunay na standards screenshot: Solana transaction structure

Ang tunay na webpage screenshot sa ibaba ay mula sa opisyal na Solana documentation. Ipinapakita nito ang message, signatures, account keys at instructions sa transaction structure; hindi ito generated explorer imitation at walang pribadong wallet data.

Tunay na screenshot ng opisyal na Solana transaction structure documentation
Magkaiba ang transaction model ng Solana at EVM; basahin ang native fields ng chain.Source: Solana Docs: Transactions; screenshot captured 2026-09-03.

5. Paano basahin ang EVM transaction fields

FieldSagot sa tanongCheck
StatusSuccessful o failed ang executionHuwag ihalo sa Submitted/Seen
Block/TimestampSaan at kailan na-recordHindi laging wallet click time ang block time
From/ToSino ang sender at direct call targetMaaaring router/proxy ang To
ValueNative asset na direktang kasamaToken transfers madalas nasa Logs
NonceOrder ng account transactionsNaunang Pending nonce humaharang sa kasunod
Method/InputFunction at parametersI-verify ang source/ABI sa unknown hex
Gas Used/Effective Gas PriceActual work at unit priceFinal fee mula receipt, hindi max budget

Kapag verified ang ABI, kayang i-decode ng explorer ang Method at parameters. Kung raw input lang, huwag blind retry; i-match sa expected method ng app instruction.

6. Receipt, Logs, Token Transfers at Internal Transactions

Sinasabi ng transaction object kung ano ang hiniling; sinasabi ng receipt ang resulta ng execution. Post-execution evidence ang Status, Gas Used, contractAddress sa deployment at logs.

  • Logs/Events: Structured events ng contract; Transfer, Approval at NFT movement ay karaniwang decoded dito.
  • Token Transfers: Readable view ng explorer mula events; i-match ang token contract.
  • Internal Transactions/Traces: Calls/value flow sa loob ng execution; hindi hiwalay na wallet-signed external tx.
  • Balance change: Useful sa resulta pero iba-iba ang scope; i-cross-check sa raw event at wallet.

Walang Transfer event ay hindi nangangahulugang walang nagbago; maaaring internal accounting, position o approval. Ang transfer naman ay hindi proof ng market value.

7. Kumpletong order sa Failed transaction

  1. Failed o Pending? Para sa Pending, nonce at broadcast muna.
  2. Itabi ang receipt at exact error: Block, To, Method, Gas Used, revert reason.
  3. Business precondition: Balance, approval, deadline, slippage, whitelist, claim limit, contract state.
  4. Gas limit o business revert: Out of gas maaaring estimate issue; explicit condition failure hindi naaayos sa blind fee increase.
  5. Re-simulate bago retry: Same state/params maaaring duplicate failure at Gas cost.

Kung blank ang reason, tingnan ang Debug/Trace ng explorer kung mayroon o read-only app simulation. Huwag ibigay ang private key sa “on-chain support” at huwag patakbuhin ang unknown fix script.

Ang error sa tabi ng Fail: karaniwang sanhi at ayos

Error textSanhiAno ang gagawin
Out of gasKulang ang Gas Limit para sa execution; kadalasan dahil manu-manong ibinaba ang Gas LimitIbalik ang suggested value ng wallet at ipadala ulit; gawing batayan ang Gas Used ng kamakailang successful transaction sa parehong contract.
ERC20: transfer amount exceeds balance / ERC20InsufficientBalanceMas malaki ang token amount kaysa sa balance (bantayan ang decimals)Itugma ang balance at ang inilagay na amount; ihiwalay ang native coin na pang-Gas sa token.
ERC20: insufficient allowance / ERC20InsufficientAllowanceKulang ang na-approve na limit, kaya hindi makuha ng contract ang token moMag-approve muna sa project page (sapat lang sa kailangan ngayon), at kapag successful na, saka gawin ang orihinal na aksyon.
UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT / Too little receivedLumampas sa slippage mo ang galaw ng presyo habang nagsa-swapI-refresh ang quote at subukan ulit, o bahagyang taasan ang slippage; huwag itong itaas nang malaki para lang pumasok, dahil tumataas ang panganib ng front-running.
UniswapV2Router: EXPIRED / Transaction too oldMasyadong matagal na Pending kaya lumampas sa deadlineUlitin ang transaksyon at magbigay ng sapat na Gas fee ngayon para hindi ito matagal na nakapila.
Sariling mensahe ng proyekto (hal. already claimed, not whitelisted) o Bad instructionHindi natupad ang kondisyon ng proyekto, o hindi pa puwedeng ilipat ang tokenTingnan ang anunsyo ng proyekto o magtanong sa channel na nakalista sa opisyal na site nito; hindi ito maaayos ng mas mataas na Gas.

Galing ang mga pangalan ng error na ito sa paliwanag ng Etherscan tungkol sa failed transactions at sa source code ng OpenZeppelin ERC-20 at ng Uniswap router contracts (sinuri noong Setyembre 2026). Maaaring iba ang salita ng ibang proyekto, pero pareho ang paraan ng pagkilala sa sanhi.

8. Confirmations at finality: kailan tutuloy

Ang confirmations ay bilang ng blocks pagkatapos ng block ng transaction. Magkakaiba ang requirement ng network, bridge, exchange at app; walang isang fixed number para sa lahat. Sundin ang public policy ng receiver at live chain state.

Huwag alisin agad ang evidence sa unang Success. Maaaring delayed ang app index; sa testnet, magkaiba ang chain Success at task Completed.

9. Sa L2 at bridge, hindi buong journey ang isang hash

Maaaring magpakita ang L2 explorer ng L1 data fee, batch o message status. Maaaring may source lock/burn, relay at destination mint/release ang bridge. Hindi awtomatikong arrived ang destination asset kapag Success ang source chain.

  • Itala ang source at destination chain.
  • Itabi ang source hash, message ID at destination hash.
  • Basahin kung waiting/challenge/claimable/completed ang bridge status.
  • Huwag ikonekta ang wallet sa unknown “manual sync” page dahil delayed.

Success sa source chain pero hindi dumating sa destination: saan titingin at kanino lalapit

  1. Bumalik sa opisyal na site ng bridge na ginamit mo at buksan ang transaction history page nito (kadalasang History, Transactions, o Activity); i-connect ang parehong wallet o i-paste ang source hash para makita ang status.
  2. Kung may message explorer ang bridge, doon din puwedeng tumingin: para sa LayerZero messages, LayerZero Scan (testnet.layerzeroscan.com para sa testnet), kung saan Confirming, Inflight, Delivered, Failed, Blocked, o Payload Stored ang status; para sa Wormhole, Wormholescan. Kapag Delivered, dalhin ang destination hash sa explorer ng destination chain; ang Confirming o Inflight ay naghihintay pa ng confirmation o execution; ang Payload Stored ay kadalasang kailangang i-retry mula sa bridge o app page.
  3. Kadalasang ilang hakbang ang withdrawal sa opisyal na native bridge: ayon sa documentation ng Optimism, may 7 araw na challenge period ang pag-withdraw mula OP Mainnet pabalik sa Ethereum mainnet, at kailangan mo pang magpadala ng karagdagang transaksyon. Kapag hiningan ka ng bridge page na mag-prove o mag-claim, i-click mo ito; kung hindi, hindi darating ang asset.
  4. Kapag Failed o Blocked, o lumampas na sa tinantiyang oras sa bridge page: pumunta sa Help Center o Discord ticket mula sa opisyal na site ng bridge (hindi mula sa search ad o link sa DM), at ilakip ang pangalan ng source at destination chain, source hash, message ID (kung mayroon), wallet address, oras, at screenshot.
  5. Scam ang “bridge support” na kusang nag-DM, nagpapakonekta ng wallet sa “sync/repair” site, o humihingi ng seed phrase; hindi kailangan ng tunay na support ang private key mo. Kung nabiktima ka na, itabi ang TxID, address, at screenshot ng usapan at tumawag sa hotline 1326 ng CICC (Inter-Agency Response Center).

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

Karaniwang ipinapakita ng Solana explorer ang signature, slot, block time, fee payer, account keys, instructions, program logs, compute units at token balance changes. Huwag ipilit ang EVM nonce/gas price/event model.

  1. Kumpirmahin ang cluster: mainnet, devnet o project environment.
  2. Tingnan ang signature status at slot, pagkatapos fee payer.
  3. I-expand ang instructions at i-match ang program at accounts.
  4. Sa failure, hanapin ang unang relevant error sa Program Logs.
  5. Ihambing ang pre/post token balances sa expected result.

11. Puwedeng i-share ang hash, pero tandaan ang linkability

Hindi password ang hash at queryable ang public chain, pero inuugnay nito ang address, oras, balance changes, contracts at history. Minimum hash, network at error lang sa support; i-mask ang screenshot.

  • Huwag seed phrase, private key, OTP, session cookie o wallet export.
  • I-mask ang email, social account, extensions, notifications at ibang tabs.
  • Huwag ipakita lahat ng wallet sa isang image/record kung ayaw i-link.
  • Sa DM “support,” magsimula ulit sa public support route ng website.

12. Mula Wallet hanggang conclusion: kumpletong workflow

  1. Kunin ang original hash, network at oras sa Wallet Activity.
  2. Buksan ang correct explorer mula network/project docs.
  3. Basahin ang Status at piliin ang Not found/Pending/Success/Failed branch.
  4. I-match ang From, To, Method/Instruction at Value.
  5. Tingnan ang Receipt, Logs, Transfers, Internal calls o Program Logs.
  6. Ihambing ang wallet balance at app page para ihiwalay ang chain/app sync.
  7. Itala ang minimum evidence at conclusion; huwag re-sign nang walang malinaw na sanhi.

Ilagay ang resulta sa testnet task record. Para sa fee, basahin ang Gwei/Gas guide; para sa approval, gamitin ang revoke guide.

13. Tatlong common scenario

A: Sent sa wallet, Not found sa explorer

I-match ang network at hash source. Sa tamang network, maghintay nang kaunti at i-refresh ang Wallet Activity; kung walang chain hash, tingnan ang RPC/error evidence at huwag agad magpadala ng ibang amount.

B: Success pero walang token sa receiver

I-check ang token contract, target address at network. Posibleng hindi added ang token sa wallet, display delay, next bridge step o same-symbol fake token.

C: Failed at nabawasan ang Gas

Nasa block at nag-rollback ang tx; ginawa pa rin ang computation kaya maaaring may fee. Ayusin ang revert reason/precondition at re-simulate. Hindi binabalik ng cancel ang spent Gas.

14. Verification checklist

  • Confirmed ang network/Chain ID o Solana cluster.
  • Hash mula sa sariling Wallet Activity.
  • Nabasa ang Status at confirmations.
  • Na-match ang From, To, Method/Instruction, Value.
  • Nakita ang Receipt, Logs/Transfers o Program Logs.
  • Verified ang token contract/mint at destination.
  • Hiwalay ang chain state at app state record.
  • Masked ang screenshot at walang secret.
  • Walang retry nang walang malinaw na cause.

Mga madalas itanong

Successful ba kapag may hash?

Hindi. Palatandaan lang ang hash para mahanap ang transaksyon; tingnan ang Status, From, To at asset change sa tamang network.

Ano ang gagawin kapag “Transaction Hash not found” sa explorer?

Tingnan muna kung aling chain ang hinahanapan mo: hindi makikita sa Etherscan ng Ethereum mainnet ang transaksyon sa BNB Chain, Polygon, o testnet; hanapin ang parehong hash sa Blockscan. Kung kapapadala lang, mag-refresh pagkalipas ng 30 segundo; kung wala pa rin pagkalipas ng 1 oras, humingi ng record sa nagpadala, exchange, o wallet, at huwag magpadala ulit ng ibang halaga hangga't hindi malinaw.

Success pero walang asset?

Itugma ang destination address, network, at token contract, saka tingnan kung may kasunod pang hakbang ang bridge o kung naghihintay pa ng dagdag na confirmation ang receiving platform. Hindi ibig sabihin ng display delay na wala ang asset sa chain; kung sa exchange ipinadala, tingnan ang deposit history nito gamit ang hash.

Puwede bang i-cancel ang Failed? Nasaan ang pera?

Hindi puwede at hindi kailangan: ang Failed ay pumasok sa block at nag-revert, kaya hindi umalis ang ipinapadalang asset at Gas lang ang nabawas. Tingnan ang error sa tabi ng Status (hal. Out of gas, insufficient allowance, Too little received), ayusin ang kondisyon, saka magpadala ng bagong transaksyon.

Success sa source chain ng bridge pero hindi dumating—kanino lalapit?

Tingnan muna ang status gamit ang source hash sa history page ng opisyal na site ng bridge o sa message explorer gaya ng LayerZero Scan at Wormholescan; kung processing pa, maghintay, at kung kailangang i-claim, i-claim mo. Kapag Failed, Blocked, o lumampas sa oras, mag-ticket sa Help Center mula sa opisyal na site at ilakip ang source hash, pangalan ng dalawang chain, wallet address, at oras. Scammer ang “support” na kusang nag-DM.

Safe bang ibigay ang hash sa support?

Hindi secret pero nagli-link ng address/activity. Minimum data lang sa official support; huwag seed/private key/OTP.

Mga sanggunian

Huling check: 2026-09-28. Idinagdag ang susunod na hakbang ayon sa status, ang table ng karaniwang failure, at kung saan titingin at kanino lalapit kapag na-stuck sa bridge; sinuri noong Setyembre 2026 ang mga mensahe ng explorer at pangalan ng bridge status.