# FAQ

***

## General

<details>

<summary><strong>What is Sova?</strong></summary>

Sova is the liquidity layer for cross-chain cryptocurrency. The protocol enables:

* **Swaps** — Cross-chain token exchange across 50+ networks with native BTC/ZEC
* **Vaults** — Earn yield by depositing cbBTC to fund solver activity
* **Limit Orders** — Conditional swap execution at target prices

All powered by intent-based settlement through a decentralized solver network.

</details>

<details>

<summary><strong>What chains does Sova support?</strong></summary>

50+ networks including:

* **Layer 1:** Ethereum, BNB Chain, Avalanche, Polygon, Bitcoin, Solana
* **Layer 2:** Base, Arbitrum, Optimism, zkSync Era, Linea, Scroll, Blast, Mode, Mantle
* **Additional:** Unichain, Sonic, Sei, Berachain, Apechain, and more

</details>

<details>

<summary><strong>Is Sova audited?</strong></summary>

Sova smart contracts implement battle-tested standards:

* **ERC-4626** for tokenized vaults
* **OpenZeppelin** base contracts
* **Transparent proxy** pattern for upgrades
* **Role-based access control**

All contracts verified on BaseScan.

</details>

<details>

<summary><strong>What wallets work with Sova?</strong></summary>

Any EVM-compatible wallet:

* MetaMask
* Coinbase Wallet
* WalletConnect-compatible wallets
* Rainbow

For BTC/ZEC swaps, you also need a wallet for those networks.

</details>

***

## Swapping

<details>

<summary><strong>How long do swaps take?</strong></summary>

| Direction     | Time          |
| ------------- | ------------- |
| EVM → BTC/ZEC | \~15 minutes  |
| BTC/ZEC → EVM | \~20 minutes  |
| EVM ↔ EVM     | \~2-5 minutes |

Settlement time varies with network conditions.

</details>

<details>

<summary><strong>What are the swap fees?</strong></summary>

| Route                 | Fee    |
| --------------------- | ------ |
| USDC → BTC/ZEC        | 0.5%   |
| Other Token → BTC/ZEC | \~0.8% |
| BTC/ZEC → EVM         | 0.5%   |

No hidden fees. Gas costs (\~$0.10-0.20 on Base) are additional.

</details>

<details>

<summary><strong>Why is my swap taking longer?</strong></summary>

Common causes:

* Network congestion (BTC/ZEC confirmations vary)
* High bridge activity (settlement queue longer)
* Large orders (additional processing)

Check Transactions page for status. Contact support if over 1 hour.

</details>

<details>

<summary><strong>What if my swap fails?</strong></summary>

Refunds are automatic:

* **Outbound:** Tokens returned to EVM wallet
* **Inbound:** BTC/ZEC returned to source address

Refunds complete within minutes. Up to 24 hours in rare cases.

</details>

<details>

<summary><strong>Can I cancel a swap?</strong></summary>

* **Before execution:** Contact support immediately
* **After execution starts:** Cannot be cancelled
* **Limit orders:** Cancel anytime before target reached

</details>

<details>

<summary><strong>Which Bitcoin addresses are supported?</strong></summary>

| Format  | Example   | Notes       |
| ------- | --------- | ----------- |
| SegWit  | `bc1q...` | Recommended |
| Taproot | `bc1p...` | Supported   |
| Legacy  | `1...`    | Supported   |
| P2SH    | `3...`    | Supported   |

</details>

<details>

<summary><strong>Does Sova support shielded Zcash?</strong></summary>

No. Only transparent addresses (`t1...`) are supported. Shielded addresses (`zs...`) are incompatible with cross-chain bridging.

</details>

<details>

<summary><strong>Can I send from an exchange?</strong></summary>

**No.** Use a personal wallet where you control private keys.

Exchanges use pooled withdrawal addresses, causing refund issues if problems occur.

</details>

***

## Vaults

<details>

<summary><strong>What is the minimum deposit?</strong></summary>

$500 USD equivalent in cbBTC.

</details>

<details>

<summary><strong>What are the vault fees?</strong></summary>

| Fee         | Rate                  |
| ----------- | --------------------- |
| Management  | 0%                    |
| Performance | 10% (on profits only) |
| Deposit     | 0%                    |
| Withdrawal  | 0%                    |

Protocol only earns when depositors earn.

</details>

<details>

<summary><strong>How does svBTC work?</strong></summary>

svBTC is an ERC-4626 tokenized vault share:

* Represents proportional vault ownership
* Auto-compounds yield via exchange rate appreciation
* Fully transferable and composable
* Redeemable for cbBTC plus earnings

</details>

<details>

<summary><strong>Where does yield come from?</strong></summary>

Real economic activity:

* **Settlement fees** — From cross-chain swap execution
* **Bridge fees** — 0.5% on swap volume
* **Future:** $SOVA staking rewards

No inflationary token emissions.

</details>

<details>

<summary><strong>Can I withdraw anytime?</strong></summary>

Yes. Most withdrawals process immediately.

Large withdrawals or high-activity periods may enter a queue. Check status on Redemptions page.

</details>

<details>

<summary><strong>How do I add svBTC to my wallet?</strong></summary>

Import token manually:

| Parameter | Value                                        |
| --------- | -------------------------------------------- |
| Contract  | `0xdFc4047620bd71F3dd781f1048f6890b76281D36` |
| Symbol    | svBTC                                        |
| Decimals  | 8                                            |

</details>

***

## Limit Orders

<details>

<summary><strong>How do limit orders work?</strong></summary>

1. Set target price
2. Deposit tokens to limit order contract
3. System monitors price 24/7
4. When price hits target → automatic execution
5. Native BTC/ZEC sent to wallet

Cancel anytime before execution for full refund.

</details>

<details>

<summary><strong>Are there extra fees?</strong></summary>

No. Same fees as market swaps (0.5-0.8%).

Fees charged only on execution. No fee for cancelled or expired orders.

</details>

<details>

<summary><strong>What expiry options exist?</strong></summary>

* 1 Day
* 1 Week
* 1 Month
* 1 Year
* Never (no expiry)

Expired orders return tokens automatically.

</details>

<details>

<summary><strong>Can I modify an order?</strong></summary>

No. Cancel existing order and create new one with updated parameters.

</details>

***

## Security

<details>

<summary><strong>Are my funds safe?</strong></summary>

Security measures:

* **ERC-4626 standard** for vaults
* **Upgradeable proxies** for security patches
* **Role-based access control**
* **Multi-sig admin** for critical functions
* **Verified contracts** on BaseScan

</details>

<details>

<summary><strong>What if there's a bug?</strong></summary>

Report to: **<security@sova.io>**

Protocol has:

* Upgradeable contracts for patches
* Multi-sig controlled pause functionality
* Incident response procedures

</details>

<details>

<summary><strong>Is personal data collected?</strong></summary>

Sova is non-custodial. No collection of:

* Personal information
* KYC data
* Wallet balances beyond on-chain data

Wallet connections handled by Privy (no private key storage).

</details>

***

## Troubleshooting

<details>

<summary><strong>Transaction stuck on "Pending"</strong></summary>

1. Check if confirmed on [BaseScan](https://basescan.org)
2. If confirmed, wait for cross-chain processing (\~10-15 min)
3. If not confirmed after 30 min, increase gas or resubmit

</details>

<details>

<summary><strong>"Insufficient Balance" error</strong></summary>

* Verify token balance for swap
* Ensure ETH for gas (\~$0.20)
* For vaults, minimum is $500 equivalent

</details>

<details>

<summary><strong>Quote keeps changing</strong></summary>

Normal behavior. Quotes update based on:

* Market price movements
* Liquidity availability
* Network conditions

Quote locked once transaction confirmed.

</details>

<details>

<summary><strong>Can't connect wallet</strong></summary>

Try:

1. Refresh page
2. Clear browser cache
3. Disable conflicting extensions
4. Use different wallet
5. Switch browsers

</details>

***

## Support

| Channel      | Contact                                    |
| ------------ | ------------------------------------------ |
| **Discord**  | [discord.gg/sova](https://discord.gg/sova) |
| **Twitter**  | [@sovabtc](https://twitter.com/sovabtc)    |
| **Email**    | <support@sova.io>                          |
| **Security** | <security@sova.io>                         |

When contacting support, include:

* Order ID (if applicable)
* Transaction hash
* Screenshot of issue
* Wallet address (public only)


---

# 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.sova.io/using-sova/faq.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.