# Whitelisted Swap Contracts

Whitelisted Swap Contracts are contract structures within the SolvBTC on-chain liquidity system that support instant redemption for specific addresses. This structure defines a restricted redemption path that allows qualified callers to directly swap SolvBTC for Reserve Assets held in the Safe Vault via on-chain transactions.

Whitelisted Swap Contracts are primarily used to meet the instant redemption needs of liquidity partners. Typical scenarios include asset swap flows triggered by liquidation mechanisms in on-chain lending protocols. In this path, redemption operations are usually initiated by protocols or liquidation-related addresses rather than ordinary users.

The callable scope of Whitelisted Swap Contracts is restricted by a whitelist mechanism and is directly linked to the asset outflow process of the Safe Vault. Redemption operations are allowed only when the caller’s address satisfies the whitelist conditions.

#### Key Components

**Whitelisted Swap Contract**

The Whitelisted Swap Contract is the core contract responsible for executing instant redemption logic. It receives call requests from authorized addresses and, when conditions are met, completes the burning of SolvBTC and coordinates with the Safe Vault to deliver assets.

This contract defines the specific execution logic for the instant redemption path, including handling redemption amounts, the burning order of SolvBTC, and triggering Safe Vault asset transfers. It does not include pricing or market-making logic; redemption results are determined by predefined asset redemption relationships.

The contract itself does not hold Reserve Assets, and acts solely as an execution node in the redemption process, working directly with the Safe Vault’s asset outflow mechanism to complete delivery.

**Whitelist**

The Whitelist is an access control structure used in conjunction with the Whitelisted Swap Contract to restrict the set of addresses allowed to call it.

Addresses recorded in the whitelist typically include liquidity partners, liquidation protocols, or liquidation-related addresses. When calling the Whitelisted Swap Contract, the system performs a whitelist check on the caller’s address, and the redemption process proceeds only if the check passes.

#### Flow

**Instant Redemption Flow**

A whitelisted address calls the Whitelisted Swap Contract and submits a SolvBTC redemption request.\
After the whitelist check passes, the Whitelisted Swap Contract performs the following actions:

* Burns the corresponding amount of SolvBTC
* Triggers the asset transfer process within the Safe Vault
* Transfers the corresponding amount of Reserve Assets from the Safe Vault and delivers them to the caller

All of the above actions are completed within a single on-chain transaction.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solv.finance/solvbtc-technical-architecture/onchain-liquidity-architecture/whitelisted-swap-contracts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
