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

# Quickstart

> Start using Neyrs in under 5 minutes

Connect your Solana wallet and execute your first operation using natural language commands.

## Prerequisites

* A Solana wallet (Phantom, Solflare, or Backpack)
* SOL for transaction fees (minimum 0.01 SOL recommended)
* Basic understanding of Solana operations

## Connect Your Wallet

<Steps>
  <Step title="Visit Neyrs">
    Navigate to [docs.neyrs.cloud](https://docs.neyrs.cloud) in your browser
  </Step>

  <Step title="Click Connect Wallet">
    Select your preferred Solana wallet from the connection modal
  </Step>

  <Step title="Approve Connection">
    Authorize Neyrs to view your wallet address (read-only access)
  </Step>
</Steps>

## Execute Your First Command

Type a natural language command in the chat interface:

```text theme={null}
Swap 1 SOL for USDC
```

Neyrs will:

1. Parse your intent and identify tokens
2. Query Jupiter for the optimal route
3. Calculate expected output and price impact
4. Present a transaction for your approval

<Note>
  All transactions require manual approval in your wallet. Neyrs never has access to your private keys.
</Note>

## Example Commands

```text theme={null}
Send 10 USDC to 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
```

```text theme={null}
Show my portfolio balance
```

```text theme={null}
Swap 50 USDC for BONK with 1% slippage
```

```text theme={null}
What's the price of JUP?
```

```text theme={null}
Stake 5 SOL
```

```text theme={null}
Buy a $20 Amazon gift card with USDC
```

## Understanding Transaction Flow

| Step                  | Description                        | Time     |
| --------------------- | ---------------------------------- | -------- |
| **Intent Parsing**    | NLP extracts tokens and amounts    | \~35ms   |
| **Route Calculation** | Jupiter finds optimal swap path    | \~95ms   |
| **Simulation**        | Pre-flight check prevents failures | \~12ms   |
| **User Approval**     | Manual confirmation in wallet      | Variable |
| **Execution**         | Transaction broadcast to Solana    | \~4ms    |

## Security Best Practices

<Warning>
  Use burner wallets with limited funds when interacting with any DeFi agent. Keep your main holdings in cold storage or hardware wallets.
</Warning>

<CardGroup cols={2}>
  <Card title="Non-Custodial" icon="shield">
    Neyrs never accesses your private keys
  </Card>

  <Card title="Pre-Flight Simulation" icon="vial">
    All transactions are simulated before execution
  </Card>

  <Card title="Manual Approval" icon="hand">
    Every transaction requires your explicit confirmation
  </Card>

  <Card title="Transparent Routing" icon="route">
    See exactly which pools your swap routes through
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Natural Language Commands" icon="message" href="/core-features/natural-language">
    Learn advanced command syntax
  </Card>

  <Card title="Wallet Operations" icon="wallet" href="/core-features/wallet-operations">
    Explore send, swap, and stake features
  </Card>

  <Card title="Commerce Payments" icon="cart-shopping" href="/core-features/commerce-payments">
    Purchase goods with USDC
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/introduction/architecture">
    Explore system design
  </Card>
</CardGroup>