> ## Documentation Index
> Fetch the complete documentation index at: https://aomi.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Resolve widget authentication, wallet, and action issues with focused checks and fixes.

| You see                   | Check                                                                                                       |
| ------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Widget does not render    | Package styles, `apiUrl`, and Application ID                                                                |
| Origin rejected           | The origin is HTTPS (or loopback over HTTP) and matches the scheme, host, and port that created the session |
| Sign-in does not complete | Provider environment and the active browser session                                                         |
| Wallet cannot sign        | The active wallet supports the requested message, typed-data, EVM, or Solana method                         |
| Owner or network mismatch | Switch back to the owner and network shown in the request                                                   |
| Action cannot execute     | The configured wallet exposes the capability required by `action.request.type`                              |
| Pipeline returns `403`    | Guest access can browse the staging catalog but cannot execute Pipeline mutations                           |
| Operation expired         | Start the action again and sign the new request                                                             |

Do not include session tokens, provider credentials, full signatures, or secret configuration in support messages.
