Developers FAQs and Error Handling
Developers’ frequently asked questions and common error resolutions.
Error Message: "Error creating transaction (wallet may be locked or fees may not be sufficient)."
This typically occurs when the wallet is locked, the passphrase is incorrect, or the fee is too low.
- Unlock the wallet and confirm the exact passphrase.
- Retry with a higher fee or enable automatic fee estimation.
- Ensure balance covers amount + fee (including UTXO/change overhead).
Error Message: "Object reference not set to an instance of an object."
One or more required parameters/objects are missing or invalid.
- Validate all request fields and types before calling the API.
- Initialize optional objects you rely on (e.g., inputs/outputs arrays).
- Check server response for the exact field causing the issue.
Error Message: "Error with selected inputs for the send transaction."
The chosen address/UTXOs do not cover the amount and fee.
- Confirm the source address balance is sufficient.
- Consolidate small UTXOs or reduce the number of outputs.
- Adjust the fee or use dynamic fee estimation.
Error Message: "Wallet file verification failed: Error loading wallet <your wallet name>. Duplicate -wallet filename specified."
The wallet you’re trying to load is already loaded.
- Check active wallets; avoid loading the same wallet twice.
- Restart the node/wallet service if a stale process is holding it.
Error Message: "No full public key for address <one of your address>"
One of the provided addresses isn’t part of the specified wallet (or lacks the pubkey needed for the operation).
- Ensure all multisig/inputs addresses belong to the same wallet.
- Re-derive addresses from the wallet seed and retry.
What is the difference between wallet balance and address balance?
Wallet balance is the total across all generated addresses in the wallet. Address balance is the amount held by a single specific address.
Can wallet balance differ from the sum of individual address balances?
Yes. After importing a wallet, funds from default addresses are recovered and consolidated into your default ltc1 address via UTXOs.
Because the default address isn’t counted as “generated” initially, its balance may be excluded from the wallet balance. After your first transaction, the default ltc1 address is generated for change and will then be included in wallet balance calculations.
Last updated
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article