> ## Documentation Index
> Fetch the complete documentation index at: https://ti-mm-mycompc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ: Solana AI Gateway wallet auth, credits, and MCP

> Quick answers about wallet sign-in, devnet support, credit top-ups, API key sharing, key rotation, private key handling, network defaults, and MCP discovery for Solana AI Gateway.

Get fast answers to the most common questions about Solana AI Gateway authentication, billing, endpoints, and MCP integration. Each answer is self-contained and links to related docs where available.

<AccordionGroup>
  <Accordion title="Do I need Phantom to authenticate?">
    No. Solana AI Gateway uses standard Ed25519 signature verification via tweetnacl, so any wallet that can sign a hex challenge and return a base58 signature works. Phantom, Solflare, Backpack, and CLI tools are all compatible. The only requirement is that you control the private key for the wallet you claim the API key with.
  </Accordion>

  <Accordion title="Can I use devnet?">
    Yes. Every paid endpoint accepts a `network` query parameter. Set it to `devnet` to route requests through the devnet cluster. If you omit the parameter, the gateway defaults to `mainnet-beta`. Public endpoints such as balance and blockhash also support `devnet`.
  </Accordion>

  <Accordion title="What happens when I run out of credits?">
    Paid endpoints return a `402 Payment Required` response when your API key has no remaining free calls and its credit balance is too low to cover the per-call flat rate of 2,200,000 lamports. To continue using the gateway, send SOL to the gateway wallet (`Brpc8HoPo1d3Uiyo7kbERnjMqwLJJmbWxtwxHxzar6DU`) and claim a new key via `POST /api/keys/claim`.
  </Accordion>

  <Accordion title="Can I share my API key?">
    You should not share your API key. The gateway debits credits per call, so anyone with your key can consume your balance. There is no multi-user or team-scoped key model. If you suspect a key has been exposed, rotate it immediately.
  </Accordion>

  <Accordion title="How do I rotate a key?">
    The gateway does not expose an explicit rotation endpoint. To rotate, send a new SOL top-up from the same wallet. The Helius webhook will create a fresh pending claim, and calling `POST /api/keys/claim` again will issue a new API key tied to the same wallet. You can then stop using the old key.
  </Accordion>

  <Accordion title="Does the gateway store my private key?">
    No. The gateway never sees or stores your private key. Authentication is based on a public-key signature: you sign a server-generated challenge locally, and the gateway verifies the signature against your wallet address using tweetnacl. Only the wallet address and a hashed API key are stored in the database.
  </Accordion>

  <Accordion title="Is mainnet-beta the default network?">
    Yes. If you omit the `network` query parameter on any endpoint, the gateway automatically routes the request to `mainnet-beta`. Explicitly pass `?network=devnet` whenever you want to target the devnet cluster.
  </Accordion>

  <Accordion title="How does MCP discovery work?">
    The gateway exposes a Model Context Protocol (MCP) manifest at `GET /.well-known/mcp.json`. The manifest lists the server name, version, capabilities, available tools, and the SSE endpoint (`/mcp/sse`). An MCP client fetches the manifest, opens an SSE connection to receive a `sessionId`, and then posts messages to `POST /mcp/messages?sessionId=<id>`. This lets LLM agents discover and invoke gateway tools without hardcoding endpoint URLs.
  </Accordion>
</AccordionGroup>