Troubleshooting
This page provides solutions to common problems you might encounter when using the Neo N3 Service Layer. If you can't find a solution to your issue here, please contact our support team or join our community channels.
Function Service Issues
Function Execution Timeouts
If your function is timing out before completion:
- Ensure your function completes within the allowed execution time (default: 30 seconds)
- Optimize any API calls or blockchain interactions
- Consider breaking complex operations into smaller functions that can be chained
- Check for infinite loops or recursive calls without proper exit conditions
- If you need longer execution times, contact us to discuss higher tier options
Memory Limit Exceeded
If your function exceeds the memory limit:
- Limit the size of data structures you create
- Avoid storing large datasets in memory
- Process data in smaller chunks
- Optimize object creation and cleanup unused references
- Consider using pagination when fetching large datasets from APIs
Function Execution Errors
If your function fails with an error:
- Check the execution logs for specific error messages
- Ensure all API endpoints you're accessing are correctly configured and accessible
- Verify that your secret values are correctly set up and accessible
- Add proper error handling in your function code with try/catch blocks
- Test your function with smaller inputs first to identify potential issues
Secret Management Issues
Secret Access Issues
If your function can't access secrets:
- Verify the secret name matches exactly (secrets are case-sensitive)
- Check if the function has the necessary permissions to access the secret
- Ensure the secret has been properly created and saved
- Confirm your account has the necessary role-based permissions
Secret Creation Failures
If you're unable to create or update secrets:
- Ensure you have the proper account permissions
- Secret names must be alphanumeric with underscores only
- Secret values have size limitations (max 4KB)
- Check if you've reached the secret quota for your account tier
Automation Service Issues
Triggers Not Firing
If your automation triggers aren't activating:
- Verify the trigger conditions are correctly configured
- For time-based triggers, check timezone settings
- For blockchain event triggers, ensure the contract address and event signature are correct
- Check if the automation has been paused or disabled
- Verify that your account has sufficient gas balance for executing the automation
Automation Execution Failures
If your automation executes but fails:
- Check the execution logs for specific error messages
- Verify that any functions called by the automation are working correctly
- Ensure all required parameters are provided and correctly formatted
- Check if the operation needs more gas than allocated
Gas Bank Issues
Insufficient Gas
If operations fail due to insufficient gas:
- Check your current gas balance in the dashboard
- Deposit additional GAS if needed
- Verify that your spending policies aren't too restrictive
- For high-gas operations, consider increasing the gas limit in your policy
Gas Deposit Issues
If your gas deposits aren't showing up:
- Confirm that the transaction has been confirmed on the Neo N3 blockchain
- Verify you sent the GAS to the correct deposit address
- Check if the minimum deposit amount was met
- Allow some time for the system to process the deposit (usually within minutes)
- Contact support if the deposit doesn't appear after 30 minutes
API Issues
Authentication Failures
If you're having trouble authenticating with the API:
- Ensure your API key is valid and has not expired
- Check if your API key has the necessary permissions
- Verify you're using the correct authentication header format
- Make sure your account is in good standing
Rate Limiting
If you're encountering rate limit errors:
- Check your current API usage in the dashboard
- Implement exponential backoff for retries
- Consider upgrading your plan for higher rate limits
- Optimize your code to reduce the number of API calls
- Cache results where appropriate to reduce duplicate calls
Still Need Help?
If you're still experiencing issues, please contact our support team through the Contact page or join our Discord community for assistance from our team and community members.