Troubleshooting
Common issues and solutions for the Noderr Protocol.
Wallet Connection Issues
MetaMask Not Connecting
Problem: MetaMask popup doesn't appear or connection fails.
Solutions:
- Ensure MetaMask is unlocked
- Check you're on the correct network (Base Sepolia for testnet)
- Clear browser cache and refresh
- Try disconnecting and reconnecting
Wrong Network
Problem: "Wrong network" error when interacting with dApp.
Solution: Switch to Base Sepolia:
- Network Name: Base Sepolia
- RPC URL: https://sepolia.base.org
- Chain ID: 84532
- Currency: ETH
- Explorer: https://sepolia.basescan.org
Vault Operations
Deposit Not Working
Problem: Deposit transaction fails or doesn't appear.
Solutions:
- Ensure you have enough NODR tokens
- Check token approval (approve vault to spend NODR)
- Verify minimum deposit amount (100 NODR)
- Check gas balance for transaction fees
ERC-7540 Deposit Pending
Problem: Deposit shows as "pending" for a long time.
Explanation: ERC-7540 vaults use async deposits:
- Request deposit → Assets transferred
- Wait for fulfillment (1-2 hours)
- Claim shares → Receive vault shares
Solution: Wait for the fulfillment delay to pass, then claim your shares.
Cannot Claim Shares
Problem: "Claim" button is disabled or transaction fails.
Solutions:
- Verify fulfillment delay has passed
- Check if deposit has been fulfilled (view pending requests)
- Ensure you're connected with the correct wallet
Node Operations
Node Not Starting
Problem: Validator/Guardian/Oracle node fails to start.
Solutions:
- Check environment variables are set correctly
- Verify RPC URL is accessible
- Ensure private key has sufficient ETH for gas
- Check logs for specific error messages
Node Not Selected for Tasks
Problem: Node is running but never selected for fulfillment/validation.
Possible Causes:
- Low TrustFingerprint score
- Insufficient stake
- Network connectivity issues
- Node not properly registered
Solutions:
- Check TrustFingerprint score
- Increase stake amount
- Verify node is registered onchain
- Check uptime and response times
Transaction Errors
"Insufficient Funds"
Problem: Transaction fails with insufficient funds error.
Solutions:
- Check ETH balance for gas
- Check NODR balance for deposit/stake
- Account for gas estimation buffer
"Transaction Reverted"
Problem: Transaction reverts without clear error.
Solutions:
- Check contract state (paused, etc.)
- Verify input parameters
- Check for role/permission issues
- Review transaction on BaseScan for details
Stuck Transaction
Problem: Transaction pending for a long time.
Solutions:
- Check gas price (may be too low)
- Speed up transaction in MetaMask
- Cancel and resubmit with higher gas
API Issues
Rate Limited
Problem: API returns 429 Too Many Requests.
Solution:
- Reduce request frequency
- Implement exponential backoff
- Consider authenticated tier for higher limits
WebSocket Disconnecting
Problem: WebSocket connection drops frequently.
Solutions:
- Implement reconnection logic
- Respond to heartbeat messages
- Check network stability
Getting Help
Discord
Join our Discord for community support:
support channel for general questions
node-operators for node-specific issues
developers for API/SDK questions
GitHub Issues
Report bugs: https://github.com/Noderrxyz/noderr-protocol/issues
Email Support
For urgent issues: support@noderr.xyz
Last Updated: December 2025