diff --git a/docs/powfi/choosing-a-wallet.md b/docs/powfi/choosing-a-wallet.md deleted file mode 100644 index 7b7c7575..00000000 --- a/docs/powfi/choosing-a-wallet.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -sidebar_position: 30 -title: Choosing a Wallet -sidebar_label: Choosing a Wallet ---- - -Alephium offers several **non-custodial wallet options** for managing ALPH and using DeFi. This includes Alephium's own Mobile, Desktop and Extension wallets, as well as third-party software and hardware wallets. - -## **Alephium Wallets** - -Alephium provides its own **Mobile, Desktop and Browser Extension wallets**. - -### Mobile Wallet - -The **Alephium Mobile Wallet** is available on iOS and Android and is designed for everyday use. - -![wallet-mobile-app](https://github.com/user-attachments/assets/c5d43636-67f5-455e-b1bc-0d30395abe77) - -- Manage ALPH on the go - -- Swap tokens - -- Stake ALPH and receive xALPH - -- Connect to dApps such as Powfi with WalletConnect - -- Buy ALPH with Visa/Mastercard, bank transfers, or Apple/Google Pay depending on your location. - -- QR code and biometric security support - -Download from: - -- [Android Google Play Store](https://play.google.com/store/apps/details?id=org.alephium.wallet) - -- [iOS App Store](https://apps.apple.com/us/app/alephium-wallet/id6469043072) - -### Desktop Wallet - -![wallet-desktop-app](https://github.com/user-attachments/assets/045c50b4-4823-4cee-96d5-12af22d8f545) - -The **Alephium Desktop Wallet** is available for Windows, macOS and Linux. It provides a more comprehensive interface for managing ALPH and accessing advanced functionality. - -- Full control of your private keys - -- Multiple addresses - -- Hardware wallet support - -- Connect to dApps such as Powfi with WalletConnect - -- Buy ALPH with Visa/Mastercard, bank transfers, or Apple/Google Pay depending on your location. - -- Advanced transaction options - -Access the latest version from the official GitHub releases: [download.](https://github.com/alephium/alephium-frontend/releases/latest) - -### Browser Extension Wallet - -![wallet-browser-extension](https://github.com/user-attachments/assets/06c57120-bd12-42a7-bc18-4bd1fb1f15b6) - -The **Alephium Extension Wallet** is available for Chrome, Brave and Firefox and is designed for connecting to web-based dApps such as Powfi. - -- Easy dApp connectivity - -- Secure transaction approvals - -- Simple browser-based interface - -Available for: - -- [Chrome/Brave](https://chrome.google.com/webstore/detail/alephium-extension-wallet/gdokollfhmnbfckbobkdbakhilldkhcj) - -- [Firefox](https://addons.mozilla.org/en-US/firefox/addon/alephiumextensionwallet) - -## **Third-Party Software Wallets** - -Several third-party non-custodial wallets also support Alephium. They provide alternative ways to manage ALPH and connect to DeFi applications. - -**[Linx](https://linxlabs.org/)** -Available on **iOS and Android**. - -**[OneKey](https://onekey.so/download/)** -Available on **iOS, Android, desktop and browser extension**. - -**[SafePal](https://www.safepal.com/en/download)** -Available on **iOS, Android and browser extension**. - -The following are well-known wallet projects with active Alephium support. They are listed for informational purposes, not as an endorsement, and the list is not exhaustive. Always verify the official website or app before installing, as phishing copies of legitimate wallets can look very similar to the real thing. - -## **Hardware Wallets** - -Alephium supports several hardware wallets, allowing you to keep your private keys offline while using compatible Alephium wallets. - -**Supported hardware wallets include:** - -**DeFi compatible:** - -- [**Ledger**](https://support.ledger.com/article/Alephium-ALPH) - -- [**OneKey**](https://onekey.so/) - -- [**SafePal**](https://www.safepal.com/en/) - -**Non DeFi compatible:** - -- [**Tangem**](https://tangem.com/en/) - -- [**Goldshell**](https://www.goldshell.com/) - -## **Hot / Cold Wallet Pattern** - -A common security practice is to use different wallets for different purposes: - -- A **hot wallet** is a software wallet connected to the internet, including **mobile, desktop and browser extension wallets**. It is useful for everyday activities like swapping, staking and interacting with DeFi applications. Keep only the amount you need for these activities. - -- A **cold wallet** uses a hardware device to keep your private keys offline. It is suited to holding larger amounts that you do not need to access regularly. - -Keeping your everyday DeFi funds in a hot wallet and your longer-term holdings in a cold wallet can help limit your exposure when interacting with DeFi applications. - -## **Stay Safe** - -**Never share your seed phrase or private keys.** Be cautious of phishing attempts and always make sure you are using the official wallet or dApp before connecting your wallet or signing a transaction. - -*Wallet options are not exhaustive. Always do your own research before choosing a wallet.* diff --git a/docs/powfi/faq.md b/docs/powfi/faq.md deleted file mode 100644 index 5ebf2684..00000000 --- a/docs/powfi/faq.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -sidebar_position: 80 -title: FAQ -sidebar_label: FAQ ---- - -## **DEX** - -## **ALPH Staking** - -### What is xALPH? - -xALPH is a liquid representation of staked ALPH. - -Mainnet xALPH token ID: [6dc961b59aae53c768fe6f608e6bea30f6747041af3fd800c8c6533766e54f00](https://explorer.alephium.org/tokens/6dc961b59aae53c768fe6f608e6bea30f6747041af3fd800c8c6533766e54f00) - -Mainnet xALPH staking contract: [225WevmFp5ZgzPsyVJTvyp2v2uyKrvp329HfrVmzffnWj](https://explorer.alephium.org/addresses/225WevmFp5ZgzPsyVJTvyp2v2uyKrvp329HfrVmzffnWj) - -When you stake ALPH: - -**ALPH → locked ALPH → xALPH** - -Each xALPH is backed by locked ALPH and represents your staked position. - -xALPH does not replace ALPH. It lets you use your staked position in supported pools and applications while the underlying ALPH stays locked. - -### How do staking rewards work? - -Rewards deposited into the xALPH contract increase the ALPH backing each xALPH. - -The Staking APR is the estimated annual percentage rate of rewards you can earn by staking ALPH. - -xALPH holders do not receive a separate ALPH payment. Instead, each xALPH represents more ALPH as rewards are deposited. - -Rewards come from: - -- Powfi’s share of the DEX fees. - -- Funded staking campaign rewards while a campaign is active. - -The exact APR will change over time depending on network activity, protocol fees and on-going campaigns. - -### Why does xALPH increase in value? - -As staking rewards accumulate, the amount of ALPH backing xALPH increases. - -This changes the conversion rate between xALPH and ALPH. - -In simple terms: - -**More rewards → more ALPH backing → each xALPH represents more ALPH** - -The conversion rate changes whenever ALPH rewards are deposited into the xALPH contract. No separate ALPH payment is sent to holders; each xALPH becomes backed by more ALPH. - -### How can I use xALPH? - -xALPH keeps your staked position liquid where xALPH is explicitly supported. - -You can use xALPH for activities such as: - -- Swapping xALPH and ALPH on Powfi. - -- Providing liquidity in Powfi’s ALPH/xALPH pool. - -- Using xALPH in another application only when that application explicitly supports it. - -- Confirming token support before depositing xALPH into any application. - -xALPH does not automatically work in every DeFi application. - -### Can I convert xALPH back to ALPH? - -Yes. There are two ways to convert xALPH back to ALPH. - -#### **Official unstaking** - -You can use the official **Unstaking** process. - -- The conversion uses the rate in effect when you press **Unstake**. - -- There is a **30-day unlock period**. - -- Your ALPH becomes claimable linearly during the unlock period. - -#### **DEX** - -You can also swap xALPH for ALPH through a DEX such as Powfi. - -- The swap is based on the live market price. - -- The conversion is immediate. - -- The amount you receive depends on available liquidity and slippage. - -### xALPH and ALPH conversion rate - -At launch, the conversion rate starts at: - -**1 xALPH = 1 ALPH** - -The conversion rate changes whenever ALPH rewards are deposited into the xALPH contract. xALPH holders do not receive a separate ALPH payment; each xALPH becomes backed by more ALPH. - -### What happens to my ALPH when I stake? - -Your ALPH is locked in the Powfi staking system. - -You receive xALPH in return, which represents your staked position. - -The underlying ALPH remains locked while xALPH gives you a liquid representation that can be used in supported pools and applications. diff --git a/docs/powfi/funding-a-wallet.md b/docs/powfi/funding-a-wallet.md deleted file mode 100644 index 583546a2..00000000 --- a/docs/powfi/funding-a-wallet.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -sidebar_position: 40 -title: Funding a Wallet -sidebar_label: Funding a Wallet ---- - -There are several simple ways to get **ALPH** into your Alephium wallet: buy it directly through a supported wallet, withdraw it from a centralized exchange, bridge ALPH from another network, or receive it from another wallet. - -**TL;DR.** If you are new to crypto, the easiest option is usually to **buy ALPH directly in the Alephium Mobile or Desktop Wallet**. If you already have ALPH on an exchange, you can withdraw it directly to your Alephium wallet. If you hold ALPH on **Ethereum or BSC**, you can use the [**Alephium Bridge**](https://powfi.alephium.org/bridge/) to move it to the native Alephium network. - -## **The main funding paths** - -| **Path** | **Best for** | -|---|---| -| **Buy ALPH in your wallet** | Getting ALPH with fiat | -| **Centralized exchange withdrawal** | If you already use an exchange | -| **Bridge ALPH** | If you already hold ALPH on Ethereum or BSC | -| **Receive ALPH** | If someone is sending you ALPH | - -## **Path 1: Buy ALPH in your wallet** - -The **Alephium Mobile and Desktop Wallets** support buying ALPH directly with fiat through an integrated [on-ramp](https://alephium.org/news/post/making-alph-more-accessible-than-ever/). Depending on your location and provider availability, you can use options such as a debit or credit card, bank transfer, or Apple Pay. - -1. Open your Alephium Mobile or Desktop Wallet. - -2. Select the option to **buy ALPH**. - -3. Choose your payment method and amount. - -4. Complete the payment and any required verification. - -5. ALPH is sent directly to your wallet. - -**Note:** Availability and payment methods vary by country. - -## **Path 2: Centralized exchange withdrawal** - -If you already have ALPH on a [centralized exchange](https://www.coingecko.com/en/coins/alephium#markets), you can withdraw it directly to your Alephium wallet. - -1. Copy your **Alephium wallet address**. - -2. Open the withdrawal section of your exchange. - -3. Select **ALPH**. - -4. Paste your Alephium address. - -5. Make sure you select the **Alephium network**. - -6. Confirm the withdrawal. - -Always double-check the address and network before confirming a withdrawal. For a large transfer, consider sending a small test amount first. - -## **Path 3: Bridge ALPH from another network** - -ALPH is also available on Ethereum and BSC as bridged versions. Powfi links to the Alephium Bridge, a separate application that moves supported assets between those networks and native Alephium. The bridge is not operated by Powfi's smart contracts. - -The basic flow is: - -**Connect wallets → Select networks → Select ALPH → Review → Confirm → Redeem** - -Bridge transfers generally take several minutes. Around **5-10 minutes from Ethereum to Alephium** and around **2-5 minutes from BSC to Alephium**. - -**Important: Use the official Alephium Bridge at [bridge.alephium.org](https://bridge.alephium.org/) and check that you are moving the correct ALPH asset.** - -## **Path 4: Receive ALPH from another wallet** - -You can also receive ALPH directly from another person or wallet. - -Simply: - -1. Copy your **Alephium wallet address**. - -2. Share it with the sender. - -3. The sender sends ALPH to your address. - -4. Wait for the transaction to confirm. - -Only share your **wallet address**. Never share your seed phrase or private keys. - -## **After funding** - -Once your ALPH arrives, check that: - -- Your wallet shows the expected **ALPH balance**. - -- The transaction appears in your wallet history. - -- You have enough ALPH available for transaction fees. - -You can then use your ALPH to **swap, stake, or provide liquidity through Powfi**. diff --git a/docs/powfi/index.md b/docs/powfi/index.md index 367fc0eb..2be1af2b 100644 --- a/docs/powfi/index.md +++ b/docs/powfi/index.md @@ -4,6 +4,13 @@ title: Overview sidebar_label: Overview --- +:::info +The full Powfi documentation has moved to [docs.powfi.alephium.org](https://docs.powfi.alephium.org/). + +- [**User Guide**](https://docs.powfi.alephium.org/user-guide) — wallets, swapping, providing liquidity, staking, and FAQ. +- [**Developer Guide**](https://docs.powfi.alephium.org/developer-guide) — integrating Powfi into your app. +::: + ## **Powfi — Core product surfaces** Launched on September 22, 2026, [Powfi](https://powfi.alephium.org/) introduces two complementary foundations for **ALPH DeFi: CLMM and xALPH**. @@ -53,3 +60,8 @@ Round 0 started on September 22nd 2026, and will be re-evaluated on a monthly ba ![overview-4-staking-round-0](https://github.com/user-attachments/assets/5ae92853-80ba-4643-b789-a68fa4dbd6f2) *The images above show planning targets, not guaranteed returns. Powfi displays estimated APR; APY assumes compounding and is not interchangeable with APR.* + +## **Learn more** + +- [User Guide](https://docs.powfi.alephium.org/user-guide) +- [Developer Guide](https://docs.powfi.alephium.org/developer-guide) diff --git a/docs/powfi/provide-liquidity.md b/docs/powfi/provide-liquidity.md deleted file mode 100644 index 0be52b5a..00000000 --- a/docs/powfi/provide-liquidity.md +++ /dev/null @@ -1,320 +0,0 @@ ---- -sidebar_position: 60 -title: Provide Liquidity -sidebar_label: Provide Liquidity ---- - -Provide liquidity to Powfi pools and earn a share of the trading fees generated by swaps. - -Powfi supports two liquidity models: - -- **CPMM**: simple, full-range liquidity that is suitable for users who want to provide liquidity without actively managing a price range. - -- **CLMM**: concentrated liquidity that lets you choose the price range where your liquidity is active. - -The right pool type depends on how actively you want to manage your liquidity and how you expect the pair's price to behave. - -## **Before you start** - -Make sure you have: - -- A wallet connected to Powfi. - -- The tokens you want to provide as liquidity. - -- Enough **ALPH** to cover Alephium network fees. - -- The token pair you want to provide liquidity for. - -- An understanding of whether you want to use CPMM or CLMM liquidity. - -If a pool already exists for the token pair, make sure you select the specific pool you want to provide liquidity to. A token pair can have one Standard (CPMM) pool and multiple Concentrated (CLMM) configurations. - -## **Choosing a pool type** - -Before creating or adding liquidity, decide which pool model fits your use case. - -### **CPMM** - -CPMM provides liquidity across the full price curve. - -Choose CPMM if you: - -- Want a simpler liquidity position. - -- Do not want to actively manage a price range. - -- Want your liquidity to remain available across all prices. - -- Prefer a straightforward deposit and withdrawal experience. - -### **CLMM** - -CLMM lets you concentrate liquidity within a selected price range. - -Choose CLMM if you: - -- Want to actively manage your liquidity. - -- Have a view on where the pair's price is likely to trade. - -- Want to concentrate capital around a specific price range. - -- Are comfortable adjusting your position when the market moves outside your range. - -### **CPMM vs CLMM** - -| | **CPMM** | **CLMM** | -|---|---|---| -| Price range | Full range | User-selected range | -| Management | Passive | Active | -| Liquidity position | Pool liquidity | Individual position | -| Capital concentration | Distributed across the curve | Concentrated within selected range | -| Position management | Simple | Requires range management | -| Best suited for | Passive liquidity | Active liquidity management | - -**There is no universally correct pool type.** Your choice should depend on the pair, your liquidity strategy, and how actively you want to manage the position. - -## **Creating a pool** - -You can create a new Powfi pool while adding liquidity. A Standard (CPMM) pool can be created only when no Standard pool exists for that token pair. Concentrated (CLMM) pools can have multiple configurations for the same pair. - -To create a pool: - -1. Go to the Pools tab on Powfi. - -2. Select **Add Liquidity**. - -3. Select the **two tokens** you want to provide as liquidity. - -4. Select the pool type: - - - **Standard** (CPMM liquidity). - - - **Concentrated** (CLMM liquidity). - -5. Powfi checks whether an existing pool is available for the selected token pair and pool type. - -6. For the selected pool type: - - - **Use an existing pool when one is available.** - - - **Create a new Standard pool only if none exists, or create a new Concentrated configuration.** - -7. For a new Concentrated pool, choose its supported configuration and fee. - -8. Standard pools use a fixed 0.3% fee; only Concentrated pools offer supported fee configurations. - -9. Set the **initial pool price**, where applicable. - -10. Review the pool configuration and initial liquidity. - -11. Confirm the pool creation. - -12. Approve the transaction in your wallet. - -### **Creating a Standard pool** - -A Standard pool uses the CPMM model and provides liquidity across the full price curve. Powfi supports one Standard pool per token pair. - -If no Standard pool exists, review: - -- The selected token pair. - -- The fixed 0.3% swap fee. - -- The initial pool price. - -- The initial liquidity amounts. - -The initial token amounts establish the starting price of the pool. - -### **Creating a Concentrated pool** - -A **Concentrated** pool uses the CLMM model and allows liquidity to be provided within selected price ranges. - -When creating a Concentrated pool, review: - -- The selected token pair. - -- The selected supported swap fee. - -- The initial pool price. - -- The initial liquidity configuration. - -- The price range for the liquidity position, if required during pool creation. - -The initial price is particularly important for a Concentrated pool because liquidity positions are created relative to the pool's price. - -### **Existing pool or new pool** - -A token pair can have one Standard pool and multiple Concentrated configurations. When adding liquidity, make sure you select the specific pool you intend to use. - -Using an existing pool allows you to provide liquidity to that pool's existing liquidity and configuration. - -Creating a new Concentrated pool creates a separate configuration for the selected token pair. Different Concentrated pools can use different supported fees and other settings. - -### **Swap fee** - -The **swap fee** is the fee charged on swaps through the pool. - -Standard pools use a fixed 0.3% swap fee. Concentrated pools may offer multiple supported fee configurations. - -When creating or selecting a Concentrated pool, verify its fee before confirming. - -## **Adding liquidity to a pool** - -Liquidity is provided according to the pool's current token ratio. - -1. Open the desired pool. - -2. Click **Add Liquidity**. - -3. Enter the amount of one token. - -4. Powfi calculates the corresponding amount of the other token. - -5. Review the deposit amounts. - -6. Review your estimated share of the pool. - -7. Confirm the transaction. - -8. Approve it in your wallet. - -Once the transaction succeeds, your liquidity is added to the pool. - -As swaps occur, the pool's token balances and ratio change. Your position represents your share of the pool's available liquidity. - -## **Removing liquidity from a pool** - -You can remove part or all of your liquidity. - -1. Open your liquidity position. - -2. Click **Remove Liquidity**. - -3. Select the amount or percentage to remove. - -4. Review the estimated token amounts. - -5. Confirm the transaction. - -6. Approve it in your wallet. - -The amounts you receive may differ from the amounts you originally deposited because the pool's composition changes as trading occurs. - -## **Liquidity fees** - -Liquidity providers can earn a share of eligible trading fees generated by swaps through their pool or position. - -For **CPMM**, fees are associated with the pool and reflected through the pool's liquidity mechanics. - -For **CLMM**, fee earnings depend on factors such as: - -- Your liquidity amount. - -- Your selected price range. - -- Trading volume. - -- How long the market remains within your active range. - -A CLMM position that is outside its active range does not participate in swaps during that period. - -Fee mechanics and rates are determined by the specific Powfi pool configuration. - -## **Verification** - -After creating a pool: - -- Confirm the transaction succeeded. - -- Verify the token pair. - -- Verify the selected swap fee. - -- Verify the initial price. - -- Confirm the pool appears in Powfi. - -After adding liquidity: - -- Confirm the transaction succeeded. - -- Check that your liquidity position appears in Powfi. - -- Verify the deposited token amounts. - -- For CLMM, verify the lower and upper price range. - -- Check whether the position is currently in range. - -After removing liquidity: - -- Confirm the transaction succeeded. - -- Verify the returned tokens in your wallet. - -- Confirm the liquidity position has decreased or closed as expected. - -## **Troubleshooting** - -### **The pool price is not what I expected** - -For a newly created pool, the initial deposit establishes the starting price. Check the token amounts and intended ratio before confirming pool creation. - -### **I selected the wrong pool** - -A token pair can have one Standard pool and multiple Concentrated configurations. Always verify the pool type and, for Concentrated pools, the fee and other settings. - -### **Deposit amounts changed** - -For CPMM, required amounts are based on the pool's current ratio. - -For CLMM, required amounts depend on the current price and your selected range. - -Refresh the quote and review the updated amounts before signing. - -### **My CLMM position is out of range** - -The current price has moved outside your selected range. Your position remains open, but the liquidity is not currently active. - -You can wait for the price to return to the range or manage the position according to your strategy. - -### **My CLMM position contains mostly one token** - -This can be expected when the current price is close to one of your range boundaries or outside the range. - -### **I received different amounts when removing liquidity** - -For CPMM positions, the pool composition changes as traders swap between the two assets. - -For CLMM positions, the token composition also changes depending on the current price relative to your range. - -### **My transaction failed** - -Make sure you have enough **ALPH** to cover Alephium network fees. Refresh the transaction and liquidity quote before trying again. - -### **My liquidity position is not showing** - -Wait for the transaction to confirm, then refresh Powfi. If the position still does not appear, verify the transaction status and the connected wallet. - -## **Important considerations** - -Providing liquidity involves market and smart-contract risks. - -The value and composition of your position can change as the price of the deposited assets changes. CLMM positions also require you to consider the selected price range and the possibility of becoming inactive when the market moves outside it. - -Before depositing significant amounts, make sure you understand: - -- The pool's token pair. - -- The pool's swap fee. - -- CPMM vs CLMM mechanics. - -- The risks associated with providing liquidity. - -- Your selected CLMM range, if applicable. diff --git a/docs/powfi/stake.md b/docs/powfi/stake.md deleted file mode 100644 index 8ad7afe2..00000000 --- a/docs/powfi/stake.md +++ /dev/null @@ -1,97 +0,0 @@ ---- -sidebar_position: 70 -title: Stake ALPH -sidebar_label: Stake ALPH ---- - -A simple guide to staking ALPH on Powfi. Learn how staking works, what xALPH represents, how rewards accrue, and how you can use xALPH in supported pools and applications. - -**Prerequisite:** a [funded](/powfi/funding-a-wallet) Alephium wallet with ALPH available to stake. You also need enough ALPH to cover the network fee. - -## **Goal** - -Stake ALPH and receive xALPH. - -When you stake ALPH, it becomes locked in the Powfi staking system and xALPH is minted to represent your staked position. - -**What you’ll have after staking:** - -- Your ALPH is locked in the staking system. - -- You receive xALPH representing your staked ALPH. - -- Your position can earn staking rewards. - -- Your xALPH can be used in supported pools and applications. - -## **Step-by-step** - -### **1. Open Powfi** - -Open [powfi.alephium.org](https://powfi.alephium.org/) and connect your Alephium wallet. - -Verify that the URL is [powfi.alephium.org](https://powfi.alephium.org/) before connecting your wallet. - -### **2. Open Staking** - -Go to the [**Staking**](https://powfi.alephium.org/staking/) section on Powfi. - -You will see the option to stake ALPH and receive xALPH. - -### **3. Enter the amount** - -Enter the amount of ALPH you want to stake. - -Before continuing, check: - -- **Amount of ALPH** you are staking. - -- **Staking APR**, which is the estimated annual rate of rewards. - -- **Available to stake, which is the amount of ALPH available for staking in your wallet.** - -Keep some ALPH in your wallet for network fees. - -![Powfi staking interface](https://github.com/user-attachments/assets/fcfa50ca-381f-4fbf-b403-e662c300dfb3) - -### **4. Review and stake** - -Review the staking details. - -When everything looks correct, click **Stake**. - -Powfi will prepare the staking transaction and your wallet will ask you to confirm it. - -### **5. Approve in your wallet** - -Review the transaction in your Alephium wallet before signing. - -Make sure the amount being staked matches what you entered. - -If everything looks correct, approve the transaction. - -### **6. Receive xALPH** - -Once the transaction is confirmed, your ALPH is locked in the staking system and xALPH is minted to represent your staked position. - -At mainnet launch: - -**1 xALPH = 1 ALPH** - -Over time, staking rewards accumulate to the underlying staked ALPH, increasing the amount of ALPH represented by each xALPH. - -## **Important things to remember** - -- Staking locks your underlying ALPH. - -- xALPH represents your staked ALPH. - -- The Staking APR is an estimate and can change over time. - -- The value represented by each xALPH can increase as rewards accumulate. - -- Official unstaking has a 30-day unlock period. - -- Swapping xALPH for ALPH on a DEX such as Powfi is subject to market price, liquidity, and slippage. - -- Keep some ALPH available in your wallet for transaction fees. diff --git a/docs/powfi/swap.md b/docs/powfi/swap.md deleted file mode 100644 index 70058d53..00000000 --- a/docs/powfi/swap.md +++ /dev/null @@ -1,215 +0,0 @@ ---- -sidebar_position: 50 -title: Swap -sidebar_label: Swap ---- - -A simple walkthrough of your first token swap on [Powfi.](https://powfi.alephium.org/) Learn how to connect your Alephium wallet, choose tokens, review the swap, confirm the transaction, and check that it worked. - -**Prerequisite:** a [funded](/powfi/funding-a-wallet) Alephium wallet with enough ALPH to make a swap and cover the network fee. If you do not have ALPH yet, see **Funding a Wallet**. - -## **Goal** - -Swap a small amount of ALPH for another token. This covers the basic flow: - -Connect your wallet → Choose tokens → Enter an amount → Review the quote → Confirm → Verify - -**What you'll pay:** - -- A trading fee shown before you confirm the swap. - -- An Alephium network fee. - -- The exact amount you receive depends on the current pool price and the amount you swap. - -**What you'll have after:** - -- Less of the token you swapped from. - -- More of the token you swapped to. - -- A confirmed transaction you can check on the Alephium network. - -## **Step-by-step** - -### **1. Open Powfi** - -Open the official Powfi application at [powfi.alephium.org](https://powfi.alephium.org/). - -**Verify the URL** before connecting your wallet. Phishing websites can look very similar to the real application. - -The swap interface includes: - -- A **From** section for the token you are spending. - -- A **To** section for the token you are receiving. - -- An amount field. - -- A **Swap** button. - -- Swap settings, where available. - -### **2. Connect your wallet** - -Click **Connect Wallet** and choose your Alephium wallet. - -Your wallet will ask you to approve the connection. - -Connecting your wallet allows Powfi to interact with your wallet address and prepare transactions. **Connecting does not by itself transfer your funds.** - -After connecting, your wallet address and available balances should appear in the interface. - -### **3. Pick your tokens** - -Choose the token you want to spend in **From**. - -Then choose the token you want to receive in **To**. - -Before continuing, check the token name and details carefully. Avoid tokens with similar names or unknown contracts. - -### **4. Enter an amount** - -Enter the amount you want to swap in the **From** field. - -Powfi will show the estimated amount you will receive in the **To** field. - -Review the information shown before continuing, including: - -- **Estimated output** - -- **Price** - -- **Trading fee** - -- **Price impact** - -- **Slippage** - -The quoted amount can change before the transaction is confirmed because token prices and pool conditions can change. - -### **5. Review and swap** - -When everything looks correct, click **Swap**. - -Review the swap details carefully, including the amount you are spending, the estimated amount you will receive, and the applicable fees. - -Then confirm the swap in Powfi. - -### **6. Approve in your wallet** - -Your Alephium wallet will open a transaction confirmation. - -Review the transaction before signing. - -Check that: - -- The transaction is for the swap you intended to make. - -- The amount being spent is correct. - -- The destination and transaction details look correct. - -- You have enough ALPH remaining for network fees. - -If something looks different from what you expected, reject the transaction and review it before trying again. - -If everything looks correct, approve the transaction in your wallet. - -### **7. Confirmation** - -Once the transaction is confirmed, Powfi will show the result of the swap. - -Your wallet balance should update to reflect the transaction. - -If the transaction does not complete, check the transaction status before trying again. - -## **Verifying it worked** - -### **In your wallet** - -Open your wallet and check your token balances. - -You should see: - -- The token you swapped from has decreased. - -- The token you swapped to has increased. - -- The transaction appears in your recent activity. - -The exact amounts depend on the quote and the final execution. - -### **On the [Alephium explorer](https://explorer.alephium.org/)** - -You can also check the transaction on an Alephium blockchain explorer. - -Look for: - -- **Transaction status** - -- **Your wallet address** - -- **Asset balance changes** - -- **Transaction details** - -This lets you verify what happened on-chain. - -## **What just happened?** - -At a simple level: - -1. You selected the token you wanted to spend. - -2. You selected the token you wanted to receive. - -3. Powfi provided a swap quote based on available liquidity. - -4. You reviewed the quote and confirmed the swap. - -5. Your wallet signed the transaction. - -6. The Alephium network processed the transaction. - -7. The tokens were exchanged through the liquidity pool. - -## **Common mistakes** - -### **Not leaving enough ALPH for fees** - -Do not use your entire ALPH balance for a swap if you need ALPH to pay network fees. - -Keep some ALPH available in your wallet. - -### **Not checking the token** - -Make sure you are swapping the token you intended to use. - -Tokens with similar names can be different assets. - -### **Ignoring the quote** - -Always check the estimated amount you will receive, fees, price impact, and slippage before confirming. - -### **Signing a transaction you do not understand** - -Your wallet is the final step before the transaction is submitted. - -Read the transaction details and reject anything that does not match what you intended to do. - -### **Using an unofficial website** - -Always verify that you are using [powfi.alephium.org](https://powfi.alephium.org/) before connecting your wallet. - -## **After your first swap** - -Once you are comfortable with swapping, you can explore other Powfi features: - -### **Provide liquidity** through CLMM or CPMM pools. - -### **Farm** eligible liquidity positions. - -### **Stake ALPH** and receive xALPH. - -### Use xALPH in supported pools and applications. diff --git a/docs/powfi/user-guide.md b/docs/powfi/user-guide.md deleted file mode 100644 index 595e701f..00000000 --- a/docs/powfi/user-guide.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -sidebar_position: 20 -title: User Guide -sidebar_label: User Guide ---- - -## **Getting Started** - -A simple guide to using Powfi: connect your Alephium wallet, get some ALPH, make your first swap, provide liquidity, or stake ALPH. Official application: [powfi.alephium.org](https://powfi.alephium.org/). - -## **What you need** - -To use Powfi, you need: - -1. An [**Alephium wallet**](https://alephium.org/wallets/) to hold your assets and interact with DeFi. - -2. Some **ALPH** for transactions and for swapping, providing liquidity, or staking. - -3. **Powfi** for accessing its DEX and liquidity features. - -## **What you can do on Powfi** - -- **Swap tokens** through Powfi or directly through supported wallets, including the Alephium Mobile Wallet. - -- **Stake ALPH** and receive **xALPH**. Staking is available through Powfi and supported wallets, including the Alephium Mobile Wallet. - -- **Provide liquidity** through CLMM or CPMM pools on Powfi. - -- **Farm** eligible liquidity positions. - -- Use xALPH in supported pools and applications, including Powfi's ALPH/xALPH pool. - -- Access liquidity connected to other ecosystems through **ETH and BSC**. - -## **Your first steps** - -**New to Powfi?** Start by getting some ALPH and connecting your Alephium wallet. - -From there, you can: - -**Swap →** trade tokens through Powfi or a supported wallet -**Stake →** stake ALPH and receive xALPH through Powfi or a supported wallet -**Provide liquidity →** choose a CLMM or CPMM pool on Powfi - -## **Stay safe** - -- **Never share your seed phrase or private key.** - -- Make sure you are using [powfi.alephium.org](https://powfi.alephium.org/) or an official supported wallet. - -- Check token and pool details before confirming a transaction. - -- Only sign transactions you understand. diff --git a/docusaurus.config.js b/docusaurus.config.js index 8ec753cd..4348472e 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -165,6 +165,13 @@ const config = { "@docusaurus/plugin-client-redirects", { redirects: [ + { from: "/powfi/user-guide", to: "/powfi" }, + { from: "/powfi/faq", to: "/powfi" }, + { from: "/powfi/stake", to: "/powfi" }, + { from: "/powfi/funding-a-wallet", to: "/powfi" }, + { from: "/powfi/choosing-a-wallet", to: "/powfi" }, + { from: "/powfi/provide-liquidity", to: "/powfi" }, + { from: "/powfi/swap", to: "/powfi" }, { from: "/Introduction.html", to: "/" }, { from: "/Frequently-Asked-Questions.html",