Troubleshooting

The wallet will not start

For Coinbase on a headless Linux machine, use the Linux appendix. Identify the error before installing packages or changing the sandbox. Keep the wallet's first terminal running while issuing commands in the second.

For MetaMask, check that the CLI is on PATH and that authentication and initialization completed. Reopening a terminal does not preserve the PATH or helper-directory settings from an earlier shell.

Coinbase reports NOT DEPLOYED

Stop before purchase. The documented path requires an already-deployed smart account; use the deployment check. There is no supported first-deployment procedure in this guide yet. An address receiving test tokens does not establish that the account is deployed.

Test tokens appear to have no value

In MetaMask, inspect token amounts under Base Sepolia. An unpriced token or a total dollar value of zero can reflect missing testnet pricing. Check the token's amount and network before funding again.

Payment failed or the response is missing

Keep the private response and error files. Do not repeat the pay command automatically: another invocation can create another purchase. A wallet balance change, receipt or transaction reference does not reveal a lost bearer key.

The stock-client examples do not retain an optional recovery capability, so self-service lost-key recovery is unavailable for this flow. Do not pay again as a recovery attempt.

The first inference did not return a useful answer

A successful HTTP status alone does not prove a useful response. Follow the documented model, output bound and non-streaming request in the OpenAI-compatible or Anthropic-compatible guide. Preserve the request identity and body when the outcome is uncertain; do not generate a new identity to bypass an uncertain charge.

You opened another terminal

Your wallet settings and bearer-key environment variable may no longer be present. Restore the wallet settings using its guide: MetaMask sessions or Coinbase. Keep the original purchase response private and available; do not make another purchase just to restore a session.

Sharing a problem

Share the failing step, operating system, tool version and sanitized error. Never include a login code, QR URL, session credential, wallet private key, bearer key or unredacted purchase response.