📲 More

Troubleshooting. We are developing all NEC ecosystem, maybe some dApps are not finished at 100% but are totally operatives.

Common Issues

"Wallet won't connect"

• Solution: Refresh the page and try again

• Check browser console for errors

• Ensure you clicked the wallet icon/button

"Transaction pending forever"

• Cause: No miners active

• Solution: Go to Test Panel and mine a block

• Enable auto-mining in Simulation Controls

"Balance not updating"

• Solution: Refresh the dashboard

• Check if transaction was included in a block

• View transaction status in NeiroScan

"Can't see my customizations"

• Ensure you're connected with the same wallet

• Check browser local storage is not cleared

• Verify Supabase connection (no errors in console)

"Blockchain validation failed"

• Cause: Data corruption or intentional tampering demonstration

• Solution: This is educational - shows why blockchain security matters

• Reset blockchain if needed

"Mining takes too long"

• Adjust difficulty in Blockchain Settings (lower = faster)

• Increase simulation speed

• Use Test Panel's instant mine

"Can't deploy smart contract"

• Check syntax in the editor

• Review error messages

• Try a sample contract first

• Ensure wallet has KGAS for deployment fee

"3D Metaverse is laggy"

• Lower graphics settings

• Close other tabs/applications

• Try on a desktop computer (better GPU)

• Disable particle effects

Browser Compatibility

Recommended Browsers:

• Chrome/Edge (latest)

• Firefox (latest)

• Safari (latest)

Mobile Browsers:

• Chrome Mobile

• Safari iOS

Known Issues:

• Internet Explorer: Not supported

• Older browsers: Limited functionality

Performance Tips

For Better Performance:

• Close unused tabs in the navigation

• Lower simulation speed when not needed

• Clear browser cache periodically

• Use desktop for 3D features

For Learning:

• Complete Interactive Guide first

• Try each tool individually before combining

• Use Test Panel for quick experiments

• Don't skip the educational modules

Getting Help

In-App Resources:

• Interactive Guide (refresher anytime)

• Tooltips (hover over icons for hints)

• Error messages (usually explain the issue)

External Resources:

• GitHub repository (check README and issues)

• Community forums (future)

• Documentation site (this manual)

Resetting Your Data

Soft Reset (keeps blockchain):

• Disconnect wallet

• Reconnect to get new address

• Previous data remains on blockchain

Hard Reset (clear everything):

• Clear browser local storage

• Clear Supabase data (if connected)

• Reload page

Blockchain Reset (genesis only):

• Use "Clear Blockchain" in Blockchain Tool

• Keeps wallet but removes all blocks except genesis

---

Glossary of Terms

Block: A container of transactions that is added to the blockchain. Each block contains a cryptographic hash of the previous block, linking them together.

Transaction: A transfer of value (tokens) or data from one address to another. Transactions are broadcast to the network, validated, and included in blocks.

Hash: A fixed-size alphanumeric string generated by a cryptographic hash function. Even a tiny change in input produces a completely different hash.

Nonce: "Number used once" - a number that miners adjust while trying to find a valid block hash.

Mining: The process of creating new blocks by solving a computational puzzle (Proof of Work). Miners compete to find a valid hash.

Difficulty: How hard it is to mine a block. Higher difficulty requires more computational attempts to find a valid hash.

Gas: A unit measuring computational work. Users pay gas fees (in KGAS tokens) to execute transactions. These fees go to miners.

Wallet: A pair of cryptographic keys (public and private) that allows you to send and receive tokens. Your address is derived from your public key.

Smart Contract: Self-executing code deployed on the blockchain. Contracts have their own address and can hold tokens, execute logic, and interact with users.

NFT (Non-Fungible Token): A unique digital asset recorded on the blockchain. In this platform, NFTs represent certificates and achievements.

Consensus: The process by which a distributed network agrees on the state of the blockchain. Different mechanisms (PoW, PoS, etc.) achieve this differently.

Genesis Block: The very first block in a blockchain (Block #0). It has no previous block to link to.

Mempool: The waiting area for unconfirmed transactions. Miners select transactions from the mempool to include in the next block.

KNL (Kennel Token): The primary token of Neiro Mini Blockchain, earned by mining and used for value transfer.

KGAS (Kennel Gas): The token used to pay for transaction fees. Required for all blockchain operations.

---

Appendix: Feature Interactions

Understanding how features work together:

Dashboard ↔ Blockchain Tool

• Dashboard visualizes data from the blockchain

• Changes in Blockchain Tool reflect in Dashboard metrics

• Interactive map customizations stored separately from blockchain data

Wallet ↔ Mining

• Mining rewards appear in your wallet

• Must have KGAS in wallet to send transactions

• NFTs earned appear in wallet's NFT gallery

Test Panel ↔ Simulation

• Test Panel actions are manual and immediate

• Simulation runs automated actions over time

• Both affect the same blockchain state

Educational Modules ↔ Live Blockchain

• Modules use isolated environments for safety

• Can apply lessons to live blockchain in Test Panel

• Achievements earned in modules appear in Ecosystem

Block Explorer ↔ All Features

• Block Explorer views data from any feature

• Search for transactions created anywhere

• Universal reference for blockchain state

Customizations ↔ Persistence

• Interactive map customizations save to database

• Blockchain data exists independently

• Both are tied to your wallet address