# KiroroLabs SDK - LLM Reference (llms.txt)

> This file is designed for AI assistants and LLM-based tooling.

## Overview
KiroroLabs SDK provides social-native authentication (Threads) and gasless transactions (Base) for dApp developers.
**Note: Currently only supports Base Mainnet.**

## Installation
```bash
npm install @kirorolabs/sdk @privy-io/react-auth viem
```

## Quick Start (Managed Auth)
```tsx
import { KiroroProvider } from "@kiroro/sdk";

function App() {
  return (
    <KiroroProvider config={{ kiroroClientId: "YOUR_KIRORO_ID", gasless: true }}>
      <YourApp />
    </KiroroProvider>
  );
}
```

## Hooks
- `useKiroroAuth()`: Returns `{ user, login, logout, isAuthenticated, isLoading }`

## User Object
```ts
interface KiroroUser {
  id: string;
  username: string;
  picture: string;
  walletAddress?: string;
}
```

## Config Options
| Option | Type | Description |
|--------|------|-------------|
| kiroroClientId | string | Managed auth client ID |
| privyAppId | string | Custom Privy App ID (white-label) |
| threadsClientId | string | Custom Meta Threads API ID |
| gasless | boolean | Enable sponsored gas transactions |

## Security
- Domain Whitelisting: Only approved domains can use your client ID.
- Identity Sovereignty: Users authenticate via Kiroro, developers receive secure sessions.

## Links
- Docs: https://kirorolabs.xyz/docs
- SDK Page: https://kirorolabs.xyz/sdk
- Submit Project: https://kirorolabs.xyz/submit