This guide helps you identify and resolve common issues encountered while integrating the Para Swift SDK into your iOS application.

Using an LLM (ChatGPT, Claude) or Coding Assistant (Cursor, Github Copilot)? Here are a few tips:

  1. Include the Para LLM-optimized context file to ensure you’re getting the most up-to-date help!
  2. Check out the Example Hub Wiki for an interactive LLM that leverages the Para Examples Hub!

​
General Troubleshooting Steps

Before diving into specific issues, try these basic troubleshooting steps:

1

Clean Build Folder

In Xcode, go to Product → Clean Build Folder (Option + Shift + Command + K).

2

Update Dependencies

For Swift Package Manager: File → Packages → Update to Latest Package Versions

For CocoaPods: Run pod update in your terminal.

3

Verify SDK Version

Ensure you are using the latest Para SDK compatible with your minimum deployment target (iOS 13.0+).

4

Check Configuration

Confirm your API key, Associated Domains, custom URL scheme, Team ID, and Bundle ID are correctly configured.

​
Common Issues and Solutions

​
Authentication Issues

​
Transaction Signing Issues

​
Network Issues

​
External Wallet Issues

​
Best Practices

Robust Error Handling

Implement comprehensive do-catch blocks to handle Para SDK errors gracefully.

User Feedback

Provide clear, actionable feedback to users when errors occur.

Logging

Implement detailed logging to help troubleshoot issues in production.

Secure Key Management

Follow best practices for managing keys and sessions securely.

Async Operations

Handle asynchronous operations properly with Swift concurrency.

Retry Mechanisms

Implement smart retry logic for network operations and authentication.

​
Development Tools

1

Enable Debug Mode

Enable debug mode in the Para SDK (if available) to get more detailed logging information.

2

Network Debugging

Utilize network debugging tools like Charles Proxy or Xcode’s network debugger to inspect API calls.

3

Xcode Debugging

Leverage Xcode’s built-in debugging features:

  • Set breakpoints at critical points
  • Inspect variables and state
  • Use the console for logging

​
Getting Help

If you’re still experiencing issues after trying the solutions above, you can get additional help:

  • Para Documentation
  • Contact Para Support via email or Discord
  • When reporting issues, include:
    • Detailed error messages
    • Steps to reproduce the issue
    • Device and iOS version details
    • Para SDK version