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

# FAQ

> Frequently asked questions about Agent Wallet, Prism, and the Finance District ecosystem.

## Getting Started

<AccordionGroup>
  <Accordion title="How do I start using the ecosystem?">
    **Get started at:** [https://apps.fd.xyz/](https://apps.fd.xyz/)

    1. Sign up → get your District Pass
    2. Choose your integration method
    3. Connect your agent or start using the CLI
    4. Get your agent wallet address and transfer funds from your regular crypto wallet (MetaMask, Coinbase, etc.)

    💡 **Start small with Agent Wallet** — \$10–50 for testing. Your agent can only spend funds you deposit. Scale as trust grows.
  </Accordion>

  <Accordion title="What is District Pass?">
    **District Pass** is the Web3 identity layer for Finance District. Verify once — move securely across wallets, payments, and apps.

    **What it does:**

    * 🔑 **Universal access** — One login for all Finance District products
    * 🔗 **Persistent wallet** — Your identity linked to your wallet(s)
    * 🤖 **Agent identity** — Links your agents to you

    **Do I need separate accounts for each product?**
    No. One District Pass = access to all Finance District solutions.

    **Is it secure?**
    Yes. Built on OAuth 2.0 + OpenID Connect. Short-lived tokens, not passwords.

    **Get yours:** [https://apps.fd.xyz/](https://apps.fd.xyz/)
  </Accordion>

  <Accordion title="What are the different ways to set up?">
    | Product          | What It Does                  | Get Started                                                |
    | ---------------- | ----------------------------- | ---------------------------------------------------------- |
    | **Agent Wallet** | Wallet for your AI agents     | [apps.fd.xyz](https://apps.fd.xyz/)                        |
    | **CLI**          | Terminal-based wallet access  | [CLI Docs](/agent-wallet/ai-integration/cli)               |
    | **MCP Server**   | Connect MCP-compatible agents | [MCP Server Docs](/agent-wallet/ai-integration/mcp-server) |
    | **Prism**        | Accept payments from agents   | [Prism Overview](/prism/overview)                          |

    **Estimated setup times:**

    * CLI: 5 min
    * MCP Server: 5 min
    * Agent Wallet (Web): Instant
    * Prism: 15–30 min
  </Accordion>
</AccordionGroup>

## Agent Wallet

<AccordionGroup>
  <Accordion title="What is Agent Wallet?">
    Agent Wallet is AI-native wallet infrastructure that gives your AI agents **their own wallets** — not borrowed access to yours.

    **Key features:**

    * AI-Autonomous Transactions
    * MCP-Native (works with Claude, GPT-4, etc.)
    * CLI with 15+ MCP tools
    * TEE-Secured keys
    * x402 Payments
    * EVM + Solana wallets auto-provisioned

    **Four interfaces, one wallet:**

    | Interface    | Best For                |
    | ------------ | ----------------------- |
    | MCP Server   | AI agents               |
    | CLI          | Developers & automation |
    | AI Assistant | Non-technical users     |
    | Web App      | Operators               |
  </Accordion>

  <Accordion title="How is Agent Wallet different from regular crypto wallets or DIY?">
    | Feature            | Regular Crypto Wallet | DIY         | Agent Wallet   |
    | ------------------ | --------------------- | ----------- | -------------- |
    | Autonomy           | Borrowed              | Basic       | Genuine        |
    | 24/7 Operation     | ❌ Human needed        | ⚠️ Insecure | ✅ Secure       |
    | MCP                | Build adapter         | Manual      | Built-in       |
    | Key security       | Human keys            | Env vars    | TEE enclave    |
    | Commerce protocols | ❌                     | Build it    | x402, ACP, UCP |
    | Setup              | Complex               | Days/weeks  | 5 minutes      |

    * **Regular crypto wallets** — great for humans, but require approval popups for every transaction
    * **DIY** — insecure; one leaked env var and funds are gone
    * **Agent Wallet** — genuine autonomy, production-ready from day one
  </Accordion>

  <Accordion title="What are the different wallet types?">
    Agent Wallet supports **3 wallet types** — choose based on your needs:

    | Type                 | Description                            | Best For                                     |
    | -------------------- | -------------------------------------- | -------------------------------------------- |
    | **EOA Wallet**       | Standard externally-owned account      | Most use cases, simple setup, low cost       |
    | **Smart Account**    | Contract-based with programmable logic | Batch transactions, custom rules, automation |
    | **Delegated Wallet** | Fine-grained access control            | Enterprise, multi-sig, team permissions      |

    **Recommendation:** Start with an EOA Wallet — it covers most use cases. Move to Smart Account or Delegated Wallet when you need advanced features.
  </Accordion>

  <Accordion title="What can my AI agent do with Agent Wallet?">
    **Core operations:**

    * 💰 **Hold & Manage** — Multi-chain assets, portfolio view
    * 📤 **Transfer** — Send/receive tokens
    * 🔄 **Swap** — Exchange token pairs
    * 📈 **Earn Yield** — Discover & deploy strategies
    * 🛒 **Pay Merchants** — x402, ACP, UCP protocols

    **Available MCP tools:**
    `getWalletOverview` · `transferTokens` · `swapTokens` · `discoverYieldStrategies` · `depositForYield` · `withdrawFromYield` · `authorizePayment` · `getX402Content` · `getTokenPrice` · `getAccountActivity` · `resolveNameService` · `signMessage` · `getMyInfo` · `reportIssue`
  </Accordion>

  <Accordion title="Can my agent operate 24/7 without human approval?">
    **Yes.** That's the core difference.

    **Regular crypto wallet at 3 AM:**
    Agent finds opportunity → popup appears → you're asleep → opportunity expires ❌

    **Agent Wallet at 3 AM:**
    Agent finds opportunity → checks parameters → executes → you wake up to a summary ✅

    Your agent has its own wallet and operates within boundaries you set — no per-transaction approval needed.
  </Accordion>

  <Accordion title="What tokens are supported?">
    **Supported assets:**

    * ✅ EVM tokens (FDUSD, USDC, DAI, ERC-20s)
    * ✅ Solana tokens (SPL)
    * ✅ Bitcoin (BTC)
    * ✅ Sui tokens (SUI, Move)

    All wallets are auto-provisioned at signup across EVM, Solana, Bitcoin, and Sui networks.
  </Accordion>

  <Accordion title="What is the Agent Wallet CLI?">
    The CLI provides command-line access to all wallet capabilities.

    **What you can do:**

    * Execute payments & transfers
    * Manage wallets programmatically
    * Script automated workflows
    * Server-side automation

    The CLI provides access to **15+ MCP tools** across wallet and Prism services. Use `fdx wallet <method>` for wallet operations and `fdx prism <method>` for payment operations.

    **Get started:** [CLI Docs](/agent-wallet/ai-integration/cli)
  </Accordion>
</AccordionGroup>

## AI & MCP

<AccordionGroup>
  <Accordion title="What is MCP and why does it matter?">
    **MCP (Model Context Protocol)** is a standardized way for AI models to communicate with external tools.

    **Why it matters:**

    * Zero integration code needed
    * LLMs understand MCP natively
    * Agents auto-discover wallet capabilities
    * Works with Claude, GPT-4, LangChain, CrewAI, and more
    * One setup works for all your agents

    **Without MCP:** Hundreds of lines of middleware code
    **With MCP:** Point your agent at a URL. Done.

    Learn more: [MCP Server](/agent-wallet/ai-integration/mcp-server)
  </Accordion>

  <Accordion title="Why can't I access the AI Assistant in my region?">
    The AI Assistant uses models that have regional restrictions in some areas.

    **If you're blocked, use these globally available alternatives:**

    | Interface    | Availability             |
    | ------------ | ------------------------ |
    | CLI          | ✅ Global                 |
    | MCP Server   | ✅ Global                 |
    | Web App      | ✅ Global                 |
    | AI Assistant | ⚠️ Regional restrictions |

    **Recommended:** Use the CLI for full functionality worldwide.
    [CLI Docs](/agent-wallet/ai-integration/cli)
  </Accordion>
</AccordionGroup>

## Payments & Protocols

<AccordionGroup>
  <Accordion title="What is Prism?">
    **Agent Wallet** is the buyer-side product (your agent's wallet). **Prism** is the seller-side payment gateway for merchants.

    | Product      | Role                   |
    | ------------ | ---------------------- |
    | Agent Wallet | Agents that spend      |
    | Prism        | Merchants that receive |

    **Together:** Agent Wallet shops → Prism accepts payment.
    **Independently:** Each works with other wallets and merchants.

    Learn more: [Prism Overview](/prism/overview)
  </Accordion>

  <Accordion title="What is x402 and how do agentic payments work?">
    **x402** is an HTTP-native payment protocol for machine-to-machine commerce.

    **Use cases:**

    * Pay-per-use API access
    * Agent-to-agent service payments
    * Micropayments for data, compute, or content
    * Automated subscription & recurring payments
    * Real-time settlement between services

    **How it works:**

    1. Agent requests a paid resource or service
    2. Server returns HTTP 402 + payment requirements
    3. Agent wallet pays instantly (on-chain)
    4. Server delivers the resource
    5. Settlement confirmed ✅

    **Why x402 matters:**

    * Micropayments down to fractions of a cent
    * No subscriptions required — pay exactly what you use
    * Instant, verifiable settlement
    * Zero chargebacks or disputes
    * Fully autonomous — no human approval needed

    Learn more: [x402 Protocol](/agent-wallet/concepts/x402-payments)
  </Accordion>
</AccordionGroup>

## Setup & Integration

<AccordionGroup>
  <Accordion title="How do I set up Agent Wallet & MCP CLI as a developer?">
    **Agent Wallet** gives your AI agents their own wallets.

    1. Register with **District Pass** at [apps.fd.xyz](https://apps.fd.xyz/)
    2. Choose your integration:
       * **MCP Server** → For Claude Code, Cursor, and MCP-compatible agents
       * **CLI** → For terminal, scripting, and automation
    3. Connect to **Agent Skills** for expanded capabilities

    **Resources:**

    * [MCP Server Docs](/agent-wallet/ai-integration/mcp-server)
    * [CLI Docs](/agent-wallet/ai-integration/cli)
  </Accordion>

  <Accordion title="How do I set up Prism as a developer?">
    **Prism** lets you accept payments from AI agents (merchant/seller side).

    1. Register with **District Pass** at [apps.fd.xyz](https://apps.fd.xyz/)
    2. Go to the **Prism Console**
    3. Get your **Project Identify Tokens**
    4. Integrate using the **Prism SDK or API**

    **Resources:**

    * [Prism Overview](/prism/overview)
    * [API Reference](/prism/api-reference/introduction)

    Accept payments from AI agents with instant settlement and zero chargebacks.
  </Accordion>

  <Accordion title="What integration methods are available?">
    | Method     | Setup Time | Best For                        |
    | ---------- | ---------- | ------------------------------- |
    | MCP Server | 5 min      | Claude Code, Cursor, MCP agents |
    | CLI        | 5 min      | Terminal, scripting, automation |
    | REST API   | 30 min     | Custom apps, non-MCP            |
    | Python SDK | 15 min     | Python projects                 |
    | JS/TS SDK  | 15 min     | Node.js/TypeScript              |

    **Recommendation:**

    * MCP-compatible agent? → MCP Server
    * Terminal workflows? → CLI
    * Custom agent? → SDK
    * Full control? → REST API
  </Accordion>

  <Accordion title="How do I test my integration?">
    Use the production environment with small amounts. The API, MCP, and SDK work identically regardless of transaction size. This lets you validate the full end-to-end flow — including real on-chain settlement.
  </Accordion>
</AccordionGroup>

## Security & Safety

<AccordionGroup>
  <Accordion title="Is Agent Wallet secure?">
    **Yes — keys are protected by a TEE (Trusted Execution Environment):**

    * Keys are generated **inside** a hardware enclave
    * Keys **never leave** the TEE — not to memory, disk, or logs
    * Signing happens **inside** the TEE
    * Even Finance District cannot access your keys

    Agent Wallet is **non-custodial** — you control access, and hardware protects the keys.

    | Scenario     | DIY (env vars)  | Agent Wallet   |
    | ------------ | --------------- | -------------- |
    | Log leak     | Keys exposed 💀 | Keys safe ✅    |
    | Key recovery | Funds gone      | Rotate API key |
  </Accordion>

  <Accordion title="Can my AI agent drain all my funds?">
    **No.** Agent Wallet follows a "pocket money" philosophy.

    Your agent only has access to funds you explicitly transfer to its wallet — not your main holdings.

    | Use Case       | Suggested Budget |
    | -------------- | ---------------- |
    | Testing        | \$10–50          |
    | Personal agent | \$100–500/mo     |
    | Business agent | \$1K–10K/mo      |
    | Enterprise     | Custom           |

    You control what you transfer. The agent can only spend those funds. Scale as trust grows.
  </Accordion>
</AccordionGroup>

## 🔗 Resources

* **Get Started:** [https://apps.fd.xyz/](https://apps.fd.xyz/)
* **Finance District Website:** [https://fd.xyz](https://fd.xyz)
* **Agent Wallet:** [https://fd.xyz/fd-agentwallet](https://fd.xyz/fd-agentwallet)
* **CLI Docs:** [https://developers.fd.xyz/agent-wallet/ai-integration/cli](https://developers.fd.xyz/agent-wallet/ai-integration/cli)
* **Discord:** [https://discord.gg/fdxyz](https://discord.gg/fdxyz)
* **X/Twitter:** [https://x.com/FD\_XYZ](https://x.com/FD_XYZ)