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

# Sweepr Docs

> Documentation for the Sweepr public app, partner SDK, API integrations, and V2 on-chain partner fee splitting.

Sweepr is a non-custodial token consolidation app for wallets with fragmented balances across Solana and EVM networks.

These docs cover both the public Sweepr app and the partner integration surface.

## Public App

* [Protocol overview](/app/overview)
* [Sweep lifecycle](/app/sweep-lifecycle)
* [Networks and contracts](/app/networks-contracts)
* [Security model](/app/security)

The current public Sweepr app continues to use the existing production flow. Partner V2 is documented separately while it is tested with selected partners.

## Partner Integration

1. Request partner access from Sweepr.
2. Receive your API key from the Sweepr team.
3. Install the SDK.
4. Build a sweep.
5. Verify the V2 fee authorization.
6. Ask the user to sign Permit2.
7. Send the V5 transaction.
8. Confirm the sweep with Sweepr using the transaction hash.
9. Poll status until the sweep is completed or fails.

```bash theme={"dark"}
npm install @sweepr/sdk
```

```ts theme={"dark"}
import { Sweepr } from '@sweepr/sdk';

const sweepr = new Sweepr({
  apiKey: process.env.SWEEPR_API_KEY!,
  version: 'v2',
});
```

## What Partners Get

* API-key based partner identity
* TypeScript SDK
* V1 Solana and EVM support with off-chain partner accounting
* V2 EVM support with on-chain partner/protocol fee splitting
* V4 fallback path controlled by Sweepr backend config
* Partner-scoped status and confirmation routes

## V2 Trust Model

V2 uses a Sweepr-signed fee authorization and the `SweeprBatchV5PartnerFees` contract. The contract verifies the signed fee parameters and splits output atomically to the user, partner, and protocol recipient.

Partner fee share is configured by Sweepr and signed per sweep. Partners cannot override fee share or payout recipient in request bodies.

Sweepr confirms a sweep only after the submitted transaction emits a matching V5 event for the original fee authorization.

## Launch Checklist

Before production, review [Production Readiness](/partners/production-readiness).
