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

# One-Click Swaps

> Integrate one-click cross-chain swaps that handle the entire flow in the background

## Overview

This framework eliminates the need for users to stay online until the end of the swap, removing the need for the user side application to manually redeem on the destination chain.

<Tip>
  We recommend using this system in stateless or unstable network environments, if you have access to persistent state and access to a background process consider managing the preimages on the user side.
</Tip>

## How It Works

* This allows a user or an integrator to grant preimage manager access to generate the preimage, hold it until the solver initiate on the Destination chain.
* Revealing the preimage claims funds to user's address, the preimage manager is not allowed to change the addresses of sender or recipient as they are pre set on-chain, and are immutable.
* This is an **optional** convenience feature, allowing the user to interact with the swapping system, and not stay online until confirmation, this could add high UX value for swaps from slow chains like Bitcoin.

### Architecture Overview

```mermaid theme={null}
sequenceDiagram
    participant U as User
    participant API as Garden API
    participant PM as Preimage Manager
    participant SC as Source Chain
    participant DC as Destination Chain
    participant S as Solver

    U->>API: Create an intent without the secret hash
    API->>PM: Request hashlock
    Note over PM: Generate preimage & calculate hashlock
    PM->>API: Return hashlock
    API->>U: Return initiate request prefilled with hashlock
    U->>SC: Initiate swap with hashlock
    Note over SC: Source initiate transaction mined
    S->>DC: Initiate swap with same hashlock
    Note over DC: Destination initiate transaction mined
    PM->>DC: Reveal preimage (claim funds to user)
    Note over DC: User receives funds on destination
    S->>SC: Use revealed preimage to claim funds
    Note over SC: Solver receives funds on source
```

The diagram shows how the preimage manager eliminates the need for users to stay online throughout the entire swap process. Once the user initiates the swap on the source chain, the preimage manager handles the final redemption automatically when the solver completes their part of the atomic swap.