# 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)
