diff --git a/.gitbook/assets/1500x500.jpeg b/.gitbook/assets/1500x500.jpeg new file mode 100644 index 0000000..1c0bfb8 Binary files /dev/null and b/.gitbook/assets/1500x500.jpeg differ diff --git a/.gitbook/assets/GaaWI1xXAAAihoN.jpeg b/.gitbook/assets/GaaWI1xXAAAihoN.jpeg new file mode 100644 index 0000000..5ee8bd1 Binary files /dev/null and b/.gitbook/assets/GaaWI1xXAAAihoN.jpeg differ diff --git a/.gitbook/assets/LISA_Earn_with_LiaBTC.png b/.gitbook/assets/LISA_Earn_with_LiaBTC.png new file mode 100644 index 0000000..1792e3b Binary files /dev/null and b/.gitbook/assets/LISA_Earn_with_LiaBTC.png differ diff --git a/.gitbook/assets/LISA_Liabtc_Issuer.png b/.gitbook/assets/LISA_Liabtc_Issuer.png new file mode 100644 index 0000000..cf4deef Binary files /dev/null and b/.gitbook/assets/LISA_Liabtc_Issuer.png differ diff --git a/.gitbook/assets/LISA_Vault_a.png b/.gitbook/assets/LISA_Vault_a.png new file mode 100644 index 0000000..29ee34c Binary files /dev/null and b/.gitbook/assets/LISA_Vault_a.png differ diff --git "a/.gitbook/assets/Screenshot 2024-10-18 at 3.51.49\342\200\257PM.png" "b/.gitbook/assets/Screenshot 2024-10-18 at 3.51.49\342\200\257PM.png" new file mode 100644 index 0000000..a6ea154 Binary files /dev/null and "b/.gitbook/assets/Screenshot 2024-10-18 at 3.51.49\342\200\257PM.png" differ diff --git "a/.gitbook/assets/Screenshot 2024-10-18 at 3.57.46\342\200\257PM.png" "b/.gitbook/assets/Screenshot 2024-10-18 at 3.57.46\342\200\257PM.png" new file mode 100644 index 0000000..a901cac Binary files /dev/null and "b/.gitbook/assets/Screenshot 2024-10-18 at 3.57.46\342\200\257PM.png" differ diff --git "a/.gitbook/assets/Screenshot 2024-10-18 at 4.53.33\342\200\257PM.png" "b/.gitbook/assets/Screenshot 2024-10-18 at 4.53.33\342\200\257PM.png" new file mode 100644 index 0000000..678f540 Binary files /dev/null and "b/.gitbook/assets/Screenshot 2024-10-18 at 4.53.33\342\200\257PM.png" differ diff --git "a/.gitbook/assets/Screenshot 2024-10-22 at 10.24.56\342\200\257PM.png" "b/.gitbook/assets/Screenshot 2024-10-22 at 10.24.56\342\200\257PM.png" new file mode 100644 index 0000000..248376e Binary files /dev/null and "b/.gitbook/assets/Screenshot 2024-10-22 at 10.24.56\342\200\257PM.png" differ diff --git a/.gitbook/assets/Screenshot 2024-10-25 at 14.00.56.png b/.gitbook/assets/Screenshot 2024-10-25 at 14.00.56.png new file mode 100644 index 0000000..52da344 Binary files /dev/null and b/.gitbook/assets/Screenshot 2024-10-25 at 14.00.56.png differ diff --git a/.gitbook/assets/Screenshot 2024-10-25 at 14.08.07.png b/.gitbook/assets/Screenshot 2024-10-25 at 14.08.07.png new file mode 100644 index 0000000..c2751c9 Binary files /dev/null and b/.gitbook/assets/Screenshot 2024-10-25 at 14.08.07.png differ diff --git a/.gitbook/assets/image (1).png b/.gitbook/assets/image (1).png new file mode 100644 index 0000000..a06540f Binary files /dev/null and b/.gitbook/assets/image (1).png differ diff --git a/.gitbook/assets/image (2).png b/.gitbook/assets/image (2).png new file mode 100644 index 0000000..1e5989c Binary files /dev/null and b/.gitbook/assets/image (2).png differ diff --git a/.gitbook/assets/image.png b/.gitbook/assets/image.png new file mode 100644 index 0000000..bffb3f2 Binary files /dev/null and b/.gitbook/assets/image.png differ diff --git a/README.md b/README.md new file mode 100644 index 0000000..5f34ce4 --- /dev/null +++ b/README.md @@ -0,0 +1,78 @@ +--- +description: >- + LISA is an acronym for Liquid Staking for All; Or, the Goddess of Liquid + Staking. +--- + +# LISA + +Currently, LISA offers liquid staking for users looking to earn yield on: + +For starters, we labeled LISA as Liquid Staking for All because our mission is to enable anyone from anywhere to easily convert their assets into safe and secure reward-generating assets. + +If you have assets like Bitcoin, Stacks, or even USDT, LISA allows you to earn safe and secure yields by converting them into liquid staking tokens that you can further use on external DeFi platforms; in other words, tapping into more opportunities beyond the LISA yields! + +We collaborate with highly trusted partners like ALEX, Ryder, Xverse, XLink, and COBO to make this possible! + +### What Tokens does LISA Offers? + +LISA is deployed on and functioning within the Stacks blockchain network. + +Allowing users to free up their staked tokens by minting transferable utility tokens (known as Liquid Staking Tokens) that can be utilized in other on-chain activities. + +Currently, LISA offers liquid staking for users looking to earn yield on: + +* STX as LiSTX +* ALEX as LiALEX +* BTC as LiaBTC ([Coming soon](https://x.com/LisaLab_BTC/status/1846880393598747115)!) +* USDT (Coming soon!) + +### Why LISA? + +* **Flexibility Unlocked:** LISA revolutionizes staking by offering the flexibility to earn yields without immobilized assets, keeping your capital fluid. +* **Dual-Token Advantage:** Users can choose between two token mechanisms: + * **Rebasing:** Li-yield tokens offer a 1:1 conversion rate with your staked assets, ensuring your token count grows over time. + * **Yield-Bearing Tokens:** vLi-yield tokens increase in intrinsic value as rewards accrue with each cycle, boosting your investment's growth potential—this is via the [Wrap Feature](features-how-tos/wrapping-unwrapping.md). +* **Maximized Efficiency:** LISA utilizes multiple staking pools, which allows for dynamic position adjustments, thereby optimizing investment efficiency. +* **Collaborative Strength:** By harnessing the collective expertise of leading Stacks developers, LISA provides access to varied staking strategies and enhances collateral use cases. +* **DeFi Expansion:** Through its integration with ALEX, LISA expands accessibility to DeFi services, solidifying its integral role within Bitcoin's decentralized finance ecosystem. + +### Enter LISA + +**Imagine this:** You've entered the realm of liquid staking, where you're not just earning rewards but also seeing your assets appreciate with a competitive annual percentage yield (APY). + +Staking has become one of the foundational yield sources across various blockchain ecosystems, not just Bitcoin, offering a smart approach to growing your portfolio. However, there's a traditional trade-off — your assets are typically locked up, inaccessible for other financial maneuvers for a set period. + +As you survey the Bitcoin DeFi landscapes, rich with potential, you can't help but imagine what could be done with assets that are currently sidelined by staking commitments. + +**Enter LISA —** a beacon in the liquid stacking space, designed to weave flexibility and dynamism into your investment tapestry. LISA elevates stacking & staking by freeing your assets by enabling participation in lucrative farming pools or using them as collateral for stablecoin loans, all while your assets continue to earn. + +### LISA’s Distinct Advantage for LiSTX + +LISA, a collaboration between [ALEX](https://alexlab.co/), [Ryder’s Fast Pool](https://www.ryder.id/), [XLink](https://app.xlink.network/) and [Xverse Pool](https://www.xverse.app/), leverages unparalleled engineering and operational excellence, setting a new standard within the Stacks ecosystem. Its key advantages include: + +* **Enhanced Pool Integration and Flexibility**: LISA integrates multiple stacking pools like Fast Pool and Xverse Pool, boosting efficiency and diversification. This setup provides stackers with flexibility, allowing direct stacking above certain minimums or delegation below them. Unlike protocols that restrict users to a single pool, LISA offers a broad network of operators, enhancing effectiveness and using STX as collateral for other protocols. +* **Broadened DeFi Opportunities**: Through seamless integration with ALEX, Bitcoin’s premier finance layer, LISA significantly expands the range of DeFi services available to users, reinforcing its foundational role in Bitcoin’s DeFi landscape. +* **Innovative “Rebase” Tokens**: LISA introduces “rebase” tokens to Stacks, inspired by Lido’s success. These tokens dynamically adjust their supply to mirror their underlying assets’ value, facilitating efficient yield capitalization and flexible position management with minimal slippage. This breakthrough enhances LISA’s token liquidity and market stability, proving indispensable for DeFi users at every experience level. + +
+ + + +## Maximize Your Stacking Efficiency with LISA + +**Example with LiSTX;** The traditional stacking model often forces stackers to miss an entire cycle if they decide to adjust their locked STX, resulting in significant opportunity costs due to the two-week cycle. + +LISA solves this by pooling STX from users and collaborating with various stacking pools, enabling a more efficient and flexible management system than individual stacking allows. + +For stackers, this means greater freedom in managing your investments. With LISA, adjust your stacking positions without major opportunity costs, ensuring your STX is always working efficiently for you. + +## Summary: A New Era of Stacking & Staking + +LISA redefines liquid staking beyond the Stacks ecosystem by merging the expertise of our ecosystem partners to unlock unparalleled stacking and staking flexibility and liquidity. + +By introducing dual tokens—both rebasing and yield-bearing—LISA enables participation in a broader DeFi landscape without sacrificing yield. + +LISA not only enhances efficiency and diversification but also integrates seamlessly with ALEX, thereby expanding the DeFi opportunities available to users. + +With LISA, stacking and staking are no longer rigid commitments but dynamic strategies, empowering stackers with the freedom to optimize their investments and navigate the evolving world of Bitcoin DeFi with confidence. diff --git a/SUMMARY.md b/SUMMARY.md new file mode 100644 index 0000000..95f8081 --- /dev/null +++ b/SUMMARY.md @@ -0,0 +1,78 @@ +# Table of contents + +## What is LISA? + +* [LISA](README.md) + +## Supported Tokens + +* [Stacks ($STX)](supported-tokens/stx/README.md) + * [How LiSTX Architecture Works?](supported-tokens/stx/how-listx-architecture-works/README.md) + * [Mint Factory](supported-tokens/stx/how-listx-architecture-works/mint-factory.md) + * [LISA Vault](supported-tokens/stx/how-listx-architecture-works/lisa-vault.md) + * [Strategies](supported-tokens/stx/how-listx-architecture-works/strategies.md) +* [Bitcoin ($BTC)](supported-tokens/bitcoin-usdbtc/README.md) + * [How LiaBTC Earns Bitcoin Yield?](supported-tokens/bitcoin-usdbtc/how-liabtc-earns-bitcoin-yield.md) + * [What is LiaBTC backed by?](supported-tokens/bitcoin-usdbtc/what-is-liabtc-backed-by.md) + * [How LiaBTC utilizes COBO?](supported-tokens/bitcoin-usdbtc/how-liabtc-utilizes-cobo.md) + * [How would ALEX V2 Upgrade Affects LiaBTC?](supported-tokens/bitcoin-usdbtc/how-would-alex-v2-upgrade-affects-liabtc.md) +* [ALEX ($ALEX)](supported-tokens/alex.md) + +## Features (How To's) + +* [Staking / Stacking](features-how-tos/staking-stacking.md) +* [Unstaking / Unstacking](features-how-tos/unstaking-unstacking.md) +* [LISA Point System](features-how-tos/lisa-point-system.md) +* [Wrapping / Unwrapping](features-how-tos/wrapping-unwrapping.md) +* [My Rewards / Overviews](features-how-tos/my-rewards-overviews.md) +* [Review to Earn](features-how-tos/review-to-earn.md) +* [Send LISA Tokens](features-how-tos/send-lisa-tokens.md) +* [Checking your Balance](features-how-tos/checking-your-balance.md) + +## Rebasing Mechanism 101 + +* [Rebasing vs Reward-Bearing Mechanism](rebasing-mechanism-101/rebasing-vs-reward-bearing-mechanism.md) +* [Depositing / Withdrawing from LISA](rebasing-mechanism-101/depositing-withdrawing-from-lisa.md) + +## LISA FAQs + +* [How are Rewards Paid Out?](lisa-faqs/how-are-rewards-paid-out.md) +* [How do I calculate my earnings?](lisa-faqs/how-do-i-calculate-my-earnings.md) +* [Do I Earn Rewards if I withdraw before a Cycle Ends?](lisa-faqs/do-i-earn-rewards-if-i-withdraw-before-a-cycle-ends.md) +* [How is APR determined?](lisa-faqs/how-is-apr-determined.md) +* [How can I check my past transactions on LISA?](lisa-faqs/how-can-i-check-my-past-transactions-on-lisa.md) +* [How can I check the accurate LiSTX amount I’ve swapped via AMM?](lisa-faqs/how-can-i-check-the-accurate-listx-amount-ive-swapped-via-amm.md) +* [Can I bridge out my LISA Tokens to other networks?](lisa-faqs/can-i-bridge-out-my-lisa-tokens-to-other-networks.md) +* [How to Participate in LISA Merkl Campaign?](lisa-faqs/how-to-participate-in-lisa-merkl-campaign.md) + +## LISA Point System + +* [Point Reward Scores](lisa-point-system/point-reward-scores.md) +* [Points to Loot Box Conversion](lisa-point-system/points-to-loot-box-conversion.md) +* [Entry / Exit Cycle Cooldown FAQs](lisa-point-system/entry-exit-cycle-cooldown-faqs.md) + +## Governance + +* [LISA DAO](governance/lisa-dao/README.md) + * [LISA DAO Improvements](governance/lisa-dao/lisa-dao-improvements.md) +* [Stacking Strategies](governance/stacking-strategies.md) + +## Is LISA Safe? + +* [Security Audits](is-lisa-safe/security-audits.md) +* [External Analytics](is-lisa-safe/external-analytics.md) +* [Deployed Contracts](is-lisa-safe/deployed-contracts.md) + +## Ecosystem Partners + +* [ALEX](ecosystem-partners/alex.md) +* [Ryder](ecosystem-partners/ryder.md) +* [Fast Pool by Ryder](ecosystem-partners/fast-pool-by-ryder.md) +* [Xverse](ecosystem-partners/xverse.md) +* [XLink](ecosystem-partners/xlink.md) +* [Cobo](ecosystem-partners/cobo.md) + +## Developers + +* [LISA Supported Network](developers/lisa-supported-network.md) +* [LISA Media Kits](developers/lisa-media-kits.md) diff --git a/developers/lisa-media-kits.md b/developers/lisa-media-kits.md new file mode 100644 index 0000000..4dd09b7 --- /dev/null +++ b/developers/lisa-media-kits.md @@ -0,0 +1,5 @@ +# LISA Media Kits + +Here are the official LISA media kits: + +[https://cdn.lisalab.io/mediakit/LISA\_Mediakit.zip](https://cdn.lisalab.io/mediakit/LISA_Mediakit.zip) diff --git a/developers/lisa-supported-network.md b/developers/lisa-supported-network.md new file mode 100644 index 0000000..d8f8d85 --- /dev/null +++ b/developers/lisa-supported-network.md @@ -0,0 +1,21 @@ +# LISA Supported Network + +The current supported network for LISA tokens are: + +* Core +* B2 +* BOB +* Bitlayer +* Lorenzo +* Merlin +* AILayer +* MODE +* X Layer +* Arbitrum +* Aurora +* Manta +* Stacks + +To see full list of supported networks enabled via the XLink bridge, please head here: [https://app.xlink.network/](https://app.xlink.network/) + +Please make sure you chosen only the wrapped version of LISA tokens (**vLiALEX, vLiSTX**) diff --git a/ecosystem-partners/alex.md b/ecosystem-partners/alex.md new file mode 100644 index 0000000..0c13c95 --- /dev/null +++ b/ecosystem-partners/alex.md @@ -0,0 +1,17 @@ +# ALEX + +
+ +Launched in early 2022, [ALEX](https://www.alexlab.co) builds the future of decentralized trading, driving the evolution of Bitcoin DeFi. + +The ALEX DEX stands as the leading decentralized exchange on Bitcoin layers, specifically on the Stacks Chain. + +### Public Information Available about ALEX + +**Coingecko:** [https://www.coingecko.com/en/coins/alex-lab](https://www.coingecko.com/en/coins/alex-lab) + +**Defillama:** [https://defillama.com/protocol/alex#information](https://defillama.com/protocol/alex#information) + +**𝕏 :** [https://x.com/ALEXLabBTC](https://x.com/ALEXLabBTC) + +**Stacks:** [https://stacks.org/alex-the-bitcoin-finance-layer](https://stacks.org/alex-the-bitcoin-finance-layer) diff --git a/ecosystem-partners/cobo.md b/ecosystem-partners/cobo.md new file mode 100644 index 0000000..8f107eb --- /dev/null +++ b/ecosystem-partners/cobo.md @@ -0,0 +1,9 @@ +# Cobo + +
+ +Founded in 2017 by blockchain pioneers, Cobo aims to simplify digital asset security. It has positioned itself as a trusted leader in digital asset custody, providing wallet infrastructure that integrates various wallet technologies like Custodial Wallets, MPC Wallets, Smart Contract Wallets, and Exchange Wallets into one unified platform. + +Cobo boasts a zero-incident security track record, safeguarding billions of dollars in assets for over 500 organizations worldwide. This emphasizes their commitment to security and trust in the management of digital assets. + +We work with Cobo with the implementation of [LiaBTC](../supported-tokens/bitcoin-usdbtc/). diff --git a/ecosystem-partners/fast-pool-by-ryder.md b/ecosystem-partners/fast-pool-by-ryder.md new file mode 100644 index 0000000..aa8ea5b --- /dev/null +++ b/ecosystem-partners/fast-pool-by-ryder.md @@ -0,0 +1,9 @@ +# Fast Pool by Ryder + + + +
+ +Fast Pool is managed by Friedger. He has been a contributor to Stacks since 2018, and is based out of Europe. + +\ diff --git a/ecosystem-partners/ryder.md b/ecosystem-partners/ryder.md new file mode 100644 index 0000000..9f7e4ca --- /dev/null +++ b/ecosystem-partners/ryder.md @@ -0,0 +1,5 @@ +# Ryder + +
+ +Ryder is a next-generation hardware wallet, known as Ryder One, designed for securely managing cryptocurrencies. diff --git a/ecosystem-partners/xlink.md b/ecosystem-partners/xlink.md new file mode 100644 index 0000000..bd38ce8 --- /dev/null +++ b/ecosystem-partners/xlink.md @@ -0,0 +1,7 @@ +# XLink + +
+ +[XLink](https://www.xlink.network) is a Liquidity Layer on Bitcoin, integrating Bitcoin into the decentralized finance (DeFi) ecosystem. + +With XLink, vLiSTX and vLiALEX is supported on more than 13 different networks as listed in [Supported Networks](../developers/lisa-supported-network.md). diff --git a/ecosystem-partners/xverse.md b/ecosystem-partners/xverse.md new file mode 100644 index 0000000..46c34f6 --- /dev/null +++ b/ecosystem-partners/xverse.md @@ -0,0 +1,10 @@ +# Xverse + +
+ +\ + + +Xverse is the leading Bitcoin wallet for everyone, providing a user-friendly gateway to the growing Bitcoin Web3 ecosystem. + +\ diff --git a/features-how-tos/checking-your-balance.md b/features-how-tos/checking-your-balance.md new file mode 100644 index 0000000..52895b8 --- /dev/null +++ b/features-how-tos/checking-your-balance.md @@ -0,0 +1,7 @@ +# Checking your Balance + +
+ +To check your balance, simply open any LISA page, and the balance will be displayed alongside the header section. + +This feature has been introduced because most explorers or even wallets lack rebasing support; hence, to accurately check your balance, you would need to do so via the LISA website." diff --git a/features-how-tos/lisa-point-system.md b/features-how-tos/lisa-point-system.md new file mode 100644 index 0000000..f954902 --- /dev/null +++ b/features-how-tos/lisa-point-system.md @@ -0,0 +1,11 @@ +# LISA Point System + +
+ +LISA points are points earned via holding eligible LISA tokens, different tokens represent different point earning ratio. + +For example, 1,000 LiSTX earns you 1,000 points per day and each time you earn 2,000 points, you are rewarded with a LISA loot box. + +You can also earn points by sharing your referral links to others; given if the referrer uses LISA via depositing STX or ALEX into LISA. + +The point leaderboard shows you both Points and also Volume; Points are the combination of both Volume (Deposited tokens) and also referral points. diff --git a/features-how-tos/my-rewards-overviews.md b/features-how-tos/my-rewards-overviews.md new file mode 100644 index 0000000..b2e33c8 --- /dev/null +++ b/features-how-tos/my-rewards-overviews.md @@ -0,0 +1,16 @@ +# My Rewards / Overviews + +
+ +You can use the Rewards page to check how much you have earned every cycle; both for LiSTX and LiALEX. + +They must be opened separately: + + + +**LiSTX:** [https://app.lisalab.io/li/stx/rewards](https://app.lisalab.io/li/stx/rewards) + +**LiALEX:** [https://app.lisalab.io/li/alex/rewards](https://app.lisalab.io/li/alex/rewards) + +\ +Important to note that, if you are holding the wrapped version, the reward will not reflect on this page. You would need to manually input the amount in the Unwrap page to check the latest balance of STX or ALEX. diff --git a/features-how-tos/review-to-earn.md b/features-how-tos/review-to-earn.md new file mode 100644 index 0000000..addc158 --- /dev/null +++ b/features-how-tos/review-to-earn.md @@ -0,0 +1,12 @@ +# Review to Earn + +Review to Earn is an easy way to Win Rewards for using LISA by providing public feedback, thoughts, or even just by saying something nice about LISA on X—it must be unbiased and honest. + +The review can be positive, neutral, or even negative. + +**Requirements:** + +* You must be a LISA user. +* Actively holding any of these tokens ( $LiSTX / $LiALEX / $vLiSTX / $vLiALEX ) + +Click Review to Earn via LISA page here (Upper Right as shown below): https://app.lisalab.io/lisa diff --git a/features-how-tos/send-lisa-tokens.md b/features-how-tos/send-lisa-tokens.md new file mode 100644 index 0000000..e66259f --- /dev/null +++ b/features-how-tos/send-lisa-tokens.md @@ -0,0 +1,20 @@ +# Send LISA Tokens + + + +
+ +Due to the absence of a LISA rebasing mechanism, similar to Lido's, not all wallets or explorers may accurately display the correct amount of rebasing tokens in your holdings. This also results in issues that prevent you from sending LISA tokens to another Stacks address. + +By using the LISA Send feature, you will be able to send the correct amount of LISA tokens to another address. + +**To Send:** + +1. Navigate to LISA Send: [https://app.lisalab.io/lisa/send](https://app.lisalab.io/lisa/send) +2. Select the asset you wish to send. +3. Enter the amount and paste the recipient's address. +4. Click Send. + +Please note, the amount sent might not reflect correctly in the Explorer. Therefore, you may need to advise your recipient to wait for confirmation. + +Then, they can use the LISA UI to check their balance. diff --git a/features-how-tos/staking-stacking.md b/features-how-tos/staking-stacking.md new file mode 100644 index 0000000..93adda9 --- /dev/null +++ b/features-how-tos/staking-stacking.md @@ -0,0 +1,27 @@ +# Staking / Stacking + + + +
+ +\ +To start earning $STX or $ALEX reward, you need to either stack/stake or buy the liquid stacking/staking tokens via the ALEX AMM. + +To stack, follow these instructions: + +1. Enter the [LISA Stacking/Staking](https://app.lisalab.io/lisa) Page and pick the tokens you want to begin earning rewards. +2. Connect your preferred wallet. +3. To earn rewards for STX, click ‘Stack Now’ on the STX selection. +4. Enter the amount of STX you would like to stack and click ‘Stack’ +5. Approve the ‘Request-Mint’ transaction. +6. Once the transaction has completed, you will receive a Request Mint NFT, which represents the cooldown period for your Stack In process. + +To understand the mechanism of how the stacking works, please read '[Depositing into LISA](broken-reference)'. + +### Buying via AMM: + +You can skip both the In and Out cooldown cycle by buying or selling your LISA tokens via AMM: [ALEX](https://app.alexlab.co/swap) or [Bitflow](https://app.bitflow.finance/trade). + +Buying via the AMM is subject to slippages and swapping fees in exchange for the convenience of time. + +\ diff --git a/features-how-tos/unstaking-unstacking.md b/features-how-tos/unstaking-unstacking.md new file mode 100644 index 0000000..09c84ba --- /dev/null +++ b/features-how-tos/unstaking-unstacking.md @@ -0,0 +1,33 @@ +# Unstaking / Unstacking + +
+ +To unstake your LISA tokens, you would need to individually select which LISA tokens specifically you would like to unstake: + +**LiSTX:** [**https://app.lisalab.io/li/stx/redeem**](https://app.lisalab.io/li/stx/redeem) + +**LiALEX:** [**https://app.lisalab.io/li/alex/redeem**](https://app.lisalab.io/li/alex/redeem) + + + +**To stack, follow these instructions:** + +1. Enter the LISA Unstacking Page listed above. +2. Connect your preferred wallet. +3. Type in the amount you'd like to Unstack. +4. Click ‘Request Unstack’ after confirming the amount you will receive. (It will always be 1:1) +5. Approve the ‘Request-Burn’ transaction. +6. Once the transaction has completed, you will receive a Receive Mint NFT, which represents the cooldown period for your Stack Out process.\ + + +To understand how the Request / Redemption process works in depth, please read the Stacking/Staking on LISA section. + +To understand the mechanism of how the unstacking works, please read [Withdrawing from LISA](broken-reference). + +### **Selling via AMM:** + +You can skip both the In and Out cooldown cycle by buying or selling your LISA tokens via AMM: [ALEX](https://app.alexlab.co/swap) or [Bitflow](https://app.bitflow.finance/trade). + +Selling via the AMM is subject to slippages and swapping fees in exchange for the convenience of time. + +\ diff --git a/features-how-tos/wrapping-unwrapping.md b/features-how-tos/wrapping-unwrapping.md new file mode 100644 index 0000000..c45a106 --- /dev/null +++ b/features-how-tos/wrapping-unwrapping.md @@ -0,0 +1,39 @@ +# Wrapping / Unwrapping + +
+ +#### To convert your rebasing token into a reward-bearing token, you can do this via the Wrap feature. + +Wrapped LISA tokens will maintain the same amount but its intrinsic value changes each passing cycle. + +For example, your 1,000 vLiSTX will become 1,100 LiSTX after a year assuming the reward’s APY is 10% consistently while your rebasing version would just become 1,100 LiSTX reflected in your wallet. + +To wrap: + +1. To wrap, you would need to have LiSTX balances within your wallet. +2. To begin wrapping, click on the [Wrap section](https://app.lisalab.io/li/stx/wrapUnwrap) of LISA. +3. Type in the amount you would like to wrap. +4. Check the rate of LiSTX -> vLiSTX; this only increases through time. +5. Click ‘Wrap’ and approve the ‘Mint’ transaction. + + + +
+ + + +To convert your wrapped token back to a rebasing token, you can do this via the Unwrap feature. + +Unwrapped LISA token balance changes each passing cycle. + +For example, your 1,000 LiSTX will become 1,100 LiSTX after a year assuming the reward’s APY s 10% consistently; you won’t need to click Unstack or check AMM rate to see your balance change as the LISA UI would reflect your balance change directly on the UI. + + + +**To wrap:** + +1. To unwrap, you would need to have vLiSTX balances within your wallet. +2. To begin unwrapping, click on the [Wrap section](https://app.lisalab.io/li/stx/wrapUnwrap) of LISA and choose ‘Unwrap’. +3. Type in the amount you would like to unwrap. +4. Check the rate of vLiSTX -> LiSTX; you can also use this to determine how much reward you have earned thus far. +5. Click ‘Unwrap’ and approve the ‘Burn’ transaction. diff --git a/governance/lisa-dao/README.md b/governance/lisa-dao/README.md new file mode 100644 index 0000000..17071de --- /dev/null +++ b/governance/lisa-dao/README.md @@ -0,0 +1,152 @@ +--- +description: Rule based governance for LISA +--- + +# LISA DAO + +## What is a DAO? + +A DAO, or Decentralized Autonomous Organization, is a type of organization represented by rules encoded as a computer program that is transparent, and controlled by organization members. DAOs operate on blockchain technology, to automate and enforce rules and decisions without the need for a central authority. + +## What is LISA DAO? + +LISA DAO manages proposals to the LISA platform which enables changes to be implemented in a rule-based way. + +Changes to the platform can take various forms, including modifications to parameters, minting or burning of tokens, and adding, upgrading, or deprecating system contracts. + +## LISA DAO Architecture + +
+ +### Main DAO Components Overview + +This architecture has the following main components: + +#### LISA-DAO Contract + +This is the core contract responsible for the DAO's operations and privileges. It is in charge of: + +* Bootstrapping the DAO +* Defining new DAO features through extensions (modules) +* Executing proposals +* Authorizing components and extensions + +#### Operators Contract + +This contract manages the governance of the DAO and is implemented within LISA's platform as an extension. It is responsible for: + +* Managing and controlling the users with permission to propose and vote changes to the platform. +* Establishing proposal signaling thresholds +* Receive and hold presented proposals while being voted/accepted +* Signaling (voting on) registered proposals +* Delegating proposal execution to the DAO operation contract +* Controlling the validity, resubmissions, and expirations of proposals + +#### Extension Contracts + +These individual contracts are designed to enhance the features and operations of the DAO by providing new specific implementations. These contracts usually have the same permissions as the DAO contract itself. (see is-dao-or-extension) + +#### Proposal Contracts + +Proposals are contracts that define updates to the DAO platform. They are meant to execute tasks reserved for the DAO's privileged executors (the LISA DAO contract itself, or enabled extensions). These tasks can include platform state changes, executing actions, and introducing extensions to the platform. Each proposal is approved through a voting system implemented in the operator's extension. They are executed only once with the DAO contract as the transaction sender. + +### Operations Proposal **Lifecycle** + +
+ +**Proposal created** + +A proposal is ready to be used when its contract is finally deployed. + +**New Proposal** + +Procedure to register the address of a given contract that conforms to the predefined proposal interface (trait). + +The operator that creates the proposal automatically signals 1 vote for it. Resubmissions (i.e. proposing again) are restricted only to non-executed expired proposals. This operation is restricted to enabled operators. + +**Signaling** + +Signaling is the process of voting for a certain registered and non-expired proposal in a boolean fashion (i.e., adding or subtracting 1 vote). + +Operators can only signal the same proposal twice if it has been resubmitted. The signaling procedure will trigger the execution step automatically if the proposal's signal count meets the threshold for execution. This operation is restricted to enabled operators. + +**Execution** + +As described in the signaling procedure, execution happens automatically when the signal count for the proposal meets the threshold. + +The procedure is delegated to the DAO operation contract, which restricts the operation to authorized extensions or the DAO contract itself. Finally, the execution invokes the proposal contract's execution method. + +**Expiration** + +Proposal expiration occurs at a certain point in time (in the underlying burn blockchain) when the block height surpasses the validity period for that proposal. + +The validity period is defined as the range of blocks from when the proposal was created until reaching the sum of that block plus a predefined delta (currently set to 144 blocks). + +**Validation Logic** + +Proposals have a validation status, which is accomplished if two conditions are met: + +* The proposal has not expired. +* The proposal was created after the operator extension was set up, including any updates to operators or thresholds. + +This validation is used in both new proposals and signaling procedures. + +#### Extensions + +#### **New extension** + +Only DAO operator members (i.e. the core contract lisa-dao or previously registered and enabled extensions) can perform this step. Typically, new extensions are only registered through proposal contracts when they receive a majority of votes.\ +\ +**Availability** + +During or after the registration of a module (extension), other DAO operator members can enable or disable the extension in a boolean fashion. Although disabled extensions will remain registered in the core contract, they will not be permitted to perform future operations while in that state. + +As with the registration process, only DAO operator members have the authority to change the status of extensions.\ + + +**Callbacks** + +Extensions that conform to the predefined extension interface (trait) have access to the core contract’s "Extension Requests" special feature. This feature allows other enabled extensions to call the core contract, which in turn, can call back the initiating extension to perform a specific callback method with lisa-dao privileges. This includes the sender that triggered the call and a provided payload. + +## Examples + +### A proposal: lip-004.clar. + +The lip-004 contract is a multi-purpose proposal that modifies the DAO-platform structure by adding and removing extensions while performing a few reconfigurations. + +For it to be executed, it must first be accepted by the platform. The process is as follows: + +* The newly proposed extension contracts (lqstx-mint-endpoint-v2-01 and public-pools-strategy-manager-v2) must be created along with this proposal contract, which will contain the code for the system reconfiguration. +* Once both contracts are created and deployed, the proposal is submitted to the DAO-platform through the operators (extension) contract. This contract verifies that the submission is made by a DAO-operator. +* The proposal is then put to a vote by the remaining DAO-operators (it is assumed that the submitting operator votes in favor, and its vote is automatically counted with the submission). +* At some point, the proposal either reaches a predefined voting threshold or it expires. If the voting threshold is reached, the operators contract invokes the executor-dao contract to run the proposal's execute() code with DAO privileges. In this way, the code in the proposal gains the necessary permissions, allowing it to invoke any required DAO-platform functionality as if it were already part of the DAO. This enables the proposal to do things like: + * Include new extensions to the platform (as well as remove, stop, pause, etc.). + * Reconfigure token pools. + * Reconfigure blocklists. + * Confirm special cases of token migrations. + * Perform other necessary tasks. +* After all actions by the proposal are executed, it is discarded and cannot execute its code again or regain DAO privileges. + +#### In this particular case + +As mentioned before, in this particular case, the proposal contains code to perform different reconfiguration actions: + +1. Newly deployed extension contracts must be set up in the DAO-platform, while the replaced versions must be removed from the platform. +2. Contracts that are removed from the platform must be also paused. +3. One of the new extensions requires initial setup. + +To perform the extension replacement in the platform, a new invocation is made to the executor-dao contract, which tracks the extensions in use and allows verification of whether an invoking contract is approved. + +The deprecated extensions must be paused to prevent them from being operated if invoked. + +Finally, the public-pools-strategy-manager-v2 extension will be invoked to perform its initial setup. + +DAO-operator: a contract already integrated into the DAO-platform or a system user with operator privileges. + +
+ +### Extension Example: Treasury + +Is a crucial part of the DAO’s financial management. It allows authorized transfers of both STX and SIP-010 tokens, ensuring that only the DAO or its extensions can initiate these transfers. Additionally, it provides functionality for making proxy calls to other contracts, further enhancing the DAO's capability to interact with and manage external contracts. This setup ensures secure and authorized management of the DAO’s treasury. + +\ diff --git a/governance/lisa-dao/lisa-dao-improvements.md b/governance/lisa-dao/lisa-dao-improvements.md new file mode 100644 index 0000000..0edc6df --- /dev/null +++ b/governance/lisa-dao/lisa-dao-improvements.md @@ -0,0 +1,9 @@ +--- +description: lip contracts +--- + +# LISA DAO Improvements + +* lip001: Update LiSTX token meta data, introduce mint delay, whitelist users for testing, +* lip002: Mint LiSTX NFTs for testers +* lip003: Add auto-whitelist for FAST pool and Xverse pool members diff --git a/governance/stacking-strategies.md b/governance/stacking-strategies.md new file mode 100644 index 0000000..dadffe0 --- /dev/null +++ b/governance/stacking-strategies.md @@ -0,0 +1,20 @@ +--- +description: How STX is used by LISA to earn rewards +--- + +# Stacking Strategies + +### Public Pools Strategy v1 + +With the Public Pools Strategy, LISA delegates stacking to public stacking pools. Currently, the strategy uses + +* [FAST Pool](https://fastpool.org) by Ryder +* [Xverse Pool](https://pool.xverse.app) + +An authorized strategy manager is allowed to transfer STX between LISA's vault and the strategy. The strategy consists of 20 contracts that act as pool members of one of the public pools. The strategy manager distributes the funds to the pool members and manages their delegation to the pools. + +Currently, authorized strategy managers are + +* 'SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH +* 'SP2G5X5HCJW31Q3Z71XGPV5S8FNBZMWW7PK45ZWG8 + diff --git a/is-lisa-safe/deployed-contracts.md b/is-lisa-safe/deployed-contracts.md new file mode 100644 index 0000000..3fd14ee --- /dev/null +++ b/is-lisa-safe/deployed-contracts.md @@ -0,0 +1,16 @@ +# Deployed Contracts + +### Extensions + +| Contract | Description | +| --------------------------------------------------------------- | -------------------------------------------------------------------------------- | +| `SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH.operators` | Implments a smart contract based multisig to execute LISA Improvement Proposals. | +| `SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH.lqstx-vault` | Holds STX of the members | +| `SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH.lqstx-mint-endpoint` | Interacts with the members and mints / burns LiSTX. | + +### Stacking Strategies + +| Contract | Description | +| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | +| `SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH.public-pools-strategy` | Using public stacking pools (10 pool members with FAST pool, 10 pool members with Xverse pool). | +| `SM26NBC8SFHNW4P1Y4DFH27974P56WN86C92HPEHH.public-pools-strategy-manager` | Endpoint used by strategy managers. | diff --git a/is-lisa-safe/external-analytics.md b/is-lisa-safe/external-analytics.md new file mode 100644 index 0000000..afa350a --- /dev/null +++ b/is-lisa-safe/external-analytics.md @@ -0,0 +1,9 @@ +# External Analytics + +Signal21 + +
+ +Signal21 is a leading blockchain data and intelligence platform designed specifically for navigating the Bitcoin Economy. + +To view LISA data on Signal21, click here: https://app.signal21.io/lisa diff --git a/is-lisa-safe/security-audits.md b/is-lisa-safe/security-audits.md new file mode 100644 index 0000000..6f82227 --- /dev/null +++ b/is-lisa-safe/security-audits.md @@ -0,0 +1,5 @@ +# Security Audits + +The smart contracts are audited by CoinFabrik: + +[https://cdn.lisalab.io/pdf/LISA\_Audit\_2024-04.pdf](https://cdn.lisalab.io/pdf/LISA_Audit_2024-04.pdf) diff --git a/lisa-faqs/can-i-bridge-out-my-lisa-tokens-to-other-networks.md b/lisa-faqs/can-i-bridge-out-my-lisa-tokens-to-other-networks.md new file mode 100644 index 0000000..f7a45e6 --- /dev/null +++ b/lisa-faqs/can-i-bridge-out-my-lisa-tokens-to-other-networks.md @@ -0,0 +1,7 @@ +# Can I bridge out my LISA Tokens to other networks? + +Yes! + +Plus, for example, if you are holding vLiSTX on other networks, it will still accrue stacking rewards similar to those in the Stacks network. + +Additionally, you might even be eligible for bonus rewards, depending on the campaigns run by other networks. diff --git a/lisa-faqs/do-i-earn-rewards-if-i-withdraw-before-a-cycle-ends.md b/lisa-faqs/do-i-earn-rewards-if-i-withdraw-before-a-cycle-ends.md new file mode 100644 index 0000000..a48abc4 --- /dev/null +++ b/lisa-faqs/do-i-earn-rewards-if-i-withdraw-before-a-cycle-ends.md @@ -0,0 +1,6 @@ +# Do I Earn Rewards if I withdraw before a Cycle Ends? + +No, you will not earn any rewards if you withdraw your Stack In before your cycle ends. + +We highly recommend that you commit to your stacking cycles! + diff --git a/lisa-faqs/how-are-rewards-paid-out.md b/lisa-faqs/how-are-rewards-paid-out.md new file mode 100644 index 0000000..265319f --- /dev/null +++ b/lisa-faqs/how-are-rewards-paid-out.md @@ -0,0 +1,4 @@ +# How are Rewards Paid Out? + +Rewards are paid out after each participated cycle ends. + diff --git a/lisa-faqs/how-can-i-check-my-past-transactions-on-lisa.md b/lisa-faqs/how-can-i-check-my-past-transactions-on-lisa.md new file mode 100644 index 0000000..3e7c7c0 --- /dev/null +++ b/lisa-faqs/how-can-i-check-my-past-transactions-on-lisa.md @@ -0,0 +1,11 @@ +# How can I check my past transactions on LISA? + +
+ +The ALEX Explorer provides the most accurate representation of any amount of tokens swapped historically. This means you can see how much X you swapped for Y. + +You can review both your personal transaction records and global transaction records, dating back to when ALEX was launched. + +Currently, the ALEX Explorer supports interactions with both ALEX and LISA tokens. + +Most importantly, the ALEX Explorer supports the rebasing mechanism! This feature is crucial because many wallets and explorers do not support rebasing, which can lead to inaccurate amounts being displayed on third-party user interfaces. diff --git a/lisa-faqs/how-can-i-check-the-accurate-listx-amount-ive-swapped-via-amm.md b/lisa-faqs/how-can-i-check-the-accurate-listx-amount-ive-swapped-via-amm.md new file mode 100644 index 0000000..e2ec918 --- /dev/null +++ b/lisa-faqs/how-can-i-check-the-accurate-listx-amount-ive-swapped-via-amm.md @@ -0,0 +1,11 @@ +# How can I check the accurate LiSTX amount I’ve swapped via AMM? + +To check how much LiSTX you have received via AMM swaps: + +1. Connect your wallet on either LISA or ALEX. +2. Click ‘Explorer’ on the upper right of the LISA webpage. +3. Choose ‘LISA’. +4. Click on ‘My Records only’ +5. You should be able to track back your swap history. + +Important to note, if you are using an external service to swap like Bitflow, it may not show up here. diff --git a/lisa-faqs/how-do-i-calculate-my-earnings.md b/lisa-faqs/how-do-i-calculate-my-earnings.md new file mode 100644 index 0000000..644efe5 --- /dev/null +++ b/lisa-faqs/how-do-i-calculate-my-earnings.md @@ -0,0 +1,8 @@ +# How do I calculate my earnings? + +You can check your earning via: + + + +* My Reward Page (LiSTX and LiALEX uses a different page) +* Unwrap Page (Check the difference between the initial STX balance and compare it to current; given if you have held the wrapped token through cycles) diff --git a/lisa-faqs/how-is-apr-determined.md b/lisa-faqs/how-is-apr-determined.md new file mode 100644 index 0000000..fa6c3db --- /dev/null +++ b/lisa-faqs/how-is-apr-determined.md @@ -0,0 +1,18 @@ +# How is APR determined? + +APR are calculated based on the total number of stacking/staking cycles per year \* percentage of reward earned per cycle. + +The $STX earnings are generated from the Stacks Chain stacking mechanism; your earnings will therefore vary from cycle to cycle. + +Assuming the entire year's APY stays constant at 12% and you hold 25,000 $LiSTX for a year (26 Stacking Cycles). + +* You started with 25,000 LiSTX +* After ONE stacking cycle, you will earn: 115.3825 LiSTX. +* The LiSTX balance in your wallet is then increased from 25,000 LiSTX to 25,115.3825 LiSTX +* You can keep checking after every cycle to see your updated $LiSTX balance. + +Important to note that not all wallets or explorers support rebasing mechanism, which means that your LiSTX will not reflect accurately. + +For LiSTX, to see your balance accurately, check it here: [https://app.lisalab.io/li/stx/redeem](https://app.lisalab.io/li/stx/redeem) + +For LiALEX, to see your balance accurately, check it here: [https://app.lisalab.io/li/alex/redeem](https://app.lisalab.io/li/alex/redeem) diff --git a/lisa-faqs/how-to-participate-in-lisa-merkl-campaign.md b/lisa-faqs/how-to-participate-in-lisa-merkl-campaign.md new file mode 100644 index 0000000..caaa530 --- /dev/null +++ b/lisa-faqs/how-to-participate-in-lisa-merkl-campaign.md @@ -0,0 +1,20 @@ +# How to Participate in LISA Merkl Campaign? + +To participate in the Merkl Campaign, here's what you need to do: + +1. If you have Stacks ($STX), convert them into $LiSTX either by [stacking](../features-how-tos/staking-stacking.md) or by [buying it via the AMM](https://app.alexlab.co/swap). Please note that stacking has a cooldown period; if you need $LiSTX more quickly, it is advisable to buy them through the AMM. +2. Once you have $LiSTX, use the [Wrap](../features-how-tos/wrapping-unwrapping.md) feature to convert it to vLiSTX, which is a yield-bearing version of $LiSTX. + +

Sufficient Balance will not display Insufficient Amount

+ +3. Then, head to [XLink](https://app.xlink.network/bridge/cross-bridge) and connect your wallet that holds the vLiSTX. +4. Once connected to XLink, select: + +* From: **Stacks Chain** +* To: **Mode Network** + +5. Enter the amount you want to bridge, scroll down in the Bridge UI, and check the approximate time and fees required for the bridge. +6. Once everything checks out, you may proceed to bridge over to the MODE Network. +7. Remember, you can always bridge back to the Stacks Network. + +**Note:** This example uses the MODE Network as a reference. diff --git a/lisa-point-system/entry-exit-cycle-cooldown-faqs.md b/lisa-point-system/entry-exit-cycle-cooldown-faqs.md new file mode 100644 index 0000000..2804572 --- /dev/null +++ b/lisa-point-system/entry-exit-cycle-cooldown-faqs.md @@ -0,0 +1,13 @@ +# Entry / Exit Cycle Cooldown FAQs + +### Do I earn points during Stacking/Staking In? + +Yes, you will start earning points if you have stacked or staked your supported tokens on LISA! + +### Do I still earn points after Stacking/Staking Out? + +No, you will no longer earn any LISA points once you have exited your current staking/stacking positions; this applies to both LiALEX and LiSTX. + +### Do I earn points immediately after buying LISA tokens via AMM? + +Yes, the moment you start holding LISA tokens, you will begin earning LISA points. Important to note that, your earning comes the next day, not instantly. diff --git a/lisa-point-system/point-reward-scores.md b/lisa-point-system/point-reward-scores.md new file mode 100644 index 0000000..bf16db6 --- /dev/null +++ b/lisa-point-system/point-reward-scores.md @@ -0,0 +1,29 @@ +# Point Reward Scores + +### LiSTX + +Every 1 LiSTX = 1 LISA Points per day + +### LiALEX + +Every 1 LiALEX = 1/20 LISA Points per day + +Which is equivalent to 20 LiALEX = 1 LISA Points per day. + +### Wrapped Token Points + +You will still earn points if you are holding $vLiSTX on the Stacks network, the amount will be calculated based on the amount of $LiSTX amount from your current $vLiSTX holdings. + +Unfortunately, due to certain technical limitations, you will not earn points if you hold LISA-issued assets such as $LiSTX, $vLiSTX, $LiALEX, or $vLiALEX on networks other than the Stacks network. + +Points are only available for holding these assets on the Stacks network. + +### STX-LiSTX LP Farm via ALEX + +You will receive LISA Points based on the amount of LiSTX you currently have in your STX-LiSTX pair. + +For example, if your LP pair has 1,000 STX : 1,000 LiSTX within your LP pair; even though that would be equivalent to 2,000 STX since 1 LiSTX = 1 STX, you will earn 1,000 LISA Points since there’s only 1,000 LiSTX within the LP pair. + +### **LiaBTC** + +Point is not available yet.\ diff --git a/lisa-point-system/points-to-loot-box-conversion.md b/lisa-point-system/points-to-loot-box-conversion.md new file mode 100644 index 0000000..f2711e5 --- /dev/null +++ b/lisa-point-system/points-to-loot-box-conversion.md @@ -0,0 +1,23 @@ +# Points to Loot Box Conversion + +Each 2,000 LISA points will reward you ONE Loot box. + +Important to note that you cannot double earn a loot box on an existing 2,000 LISA Points. + +### Loot Box Rarity + + + +There are three different rarity : + +* **Uncommon** +* **Rare** +* **Legendary**\ + + +In some cases, LISA may drop Unique event-based loot boxes that cannot be earned via LISA Points. + +Some of the Unique loot boxes are: + +* **WELSH** +* **MODE** diff --git a/rebasing-mechanism-101/depositing-withdrawing-from-lisa.md b/rebasing-mechanism-101/depositing-withdrawing-from-lisa.md new file mode 100644 index 0000000..19906e8 --- /dev/null +++ b/rebasing-mechanism-101/depositing-withdrawing-from-lisa.md @@ -0,0 +1,38 @@ +# Depositing / Withdrawing from LISA + +### Depositing into LISA + +**Request LiSTX:** Users submit a mint request and receive an NFT ticket, transferring the specified STX to the LISA Vault. + +To be included in the next stacking cycle, requests must be confirmed 300 blocks before the next cycle's preparation stage starts; otherwise, they're deferred. + +**Finalize mint:** Minting finalizes 432 blocks after the cycle begins, exchanging the NFT ticket for LiSTX. + +**Cancel mint:** If conditions allow (unlocked STX are available and not committed elsewhere), users can revoke their requests, recovering their STX. Revocation is not possible if the STX is allocated for strategies or outstanding burn requests. + +#### Do I earn Points after Depositing into LISA? + +Yes, once you have deposited into LISA, you will start earning points even if you have not yet received your LISA tokens. + +### Withdrawing from LISA + +You can use our Redeem tabs to redeem LiSTX and receive STX at a 1:1 exchange ratio. + +The redemption steps are as follows: + +* **Requesting Burns:** For burning LiSTX, users receive an NFT ticket and transfer LiSTX to the LISA Vault, with rewards continuing to accrue during the wait. +* **Finalizing Burns:** Burns depend on unlocked STX availability in the Vault and may proceed immediately or be queued. +* **Revoking Burns:** Users can revoke burn requests at any point, canceling the ticket and retrieving their LiSTX. + +#### **How Long to Wait for Withdrawal and do I still earn Points?** + +If there is enough STX within the unstacking balance, you will be able to redeem your STX instantly. + +However, under normal circumstances, redemption requests can take anywhere from 1 to 14 days until the next stacking cycle is completed, after which you can claim your STX using the Claim dashboard. + +**Easier way to put it:** + +* If there's sufficient STX for redemption: **Instant—but no more LISA points.** +* If there's insufficient STX for redemption: **Wait for one cycle—still earn LISA points.** + +You can also exchange LiSTX on DEX LISA integrations (e.g., ALEX swap). diff --git a/rebasing-mechanism-101/rebasing-vs-reward-bearing-mechanism.md b/rebasing-mechanism-101/rebasing-vs-reward-bearing-mechanism.md new file mode 100644 index 0000000..b1da298 --- /dev/null +++ b/rebasing-mechanism-101/rebasing-vs-reward-bearing-mechanism.md @@ -0,0 +1,30 @@ +# Rebasing vs Reward-Bearing Mechanism + +### **Rebasing Tokens** + +Assuming you have 100 LiSTX, you would have approximately 110 LiSTX after a year if the average APR is 10%, which you can then unstack to get back 110 STX. + +**Today :** 1 STX = 1 LiSTX + +**Tomorrow :** 1 STX = 1 LiSTX + +\ +**Mechanism:** Rebasing tokens adjust their total supply to smooth out the value of each token over time. When the protocol's staking rewards increase the overall value, the rebase mechanism might increase the number of tokens in your wallet, or decrease them if the value goes down, to keep the token price relatively stable. + +**User Experience:** You might hold 100 tokens today, but after a rebase, you could have 110 tokens (or fewer), but ideally, each token retains roughly the same proportionate value of the total supply. The idea is that the price per token remains more consistent, but your token count changes. + +**Purpose:** This aims to reduce volatility by adjusting the supply dynamically. + +### **Reward-bearing Tokens** + +Assuming you have 100 vLiSTX, you would still have 100 vLiSTX after a year, but if the average APR is 10%, you could then unstack them to receive 110 STX. + +**Today :** 1 STX = 1 vLiSTX + +**Future :** 1.1 STX = 1 vLiSTX + +**Mechanism:** These tokens do not change in quantity in your wallet due to rebasing. Instead, the value of the token itself increases over time as rewards from staking are accrued. The number of tokens you have remains constant, but their inherent value goes up because they represent a share in a growing pool of staked assets. + +**User Experience:** If you start with 100 tokens, you'll still have 100 tokens later, but each token might give you claim to a larger portion of the staked assets or the rewards accumulated. + +**Purpose:** To provide a straightforward staking reward mechanism where the token count is stable, but the value of each token appreciates with staking rewards. diff --git a/supported-tokens/alex.md b/supported-tokens/alex.md new file mode 100644 index 0000000..27a8d9a --- /dev/null +++ b/supported-tokens/alex.md @@ -0,0 +1,9 @@ +# ALEX ($ALEX) + +LiALEX is a rebasing token of ALEX. + +LiALEX replaces the legacy manual staking system previously offered by the ALEX AMM DEX. Instead of committing to a fixed number of cycles, holding LiALEX allows you to continuously earn staking rewards without the need to repeatedly re-enter your staking position after each cycle ends. + +## 1 LiALEX = 1 ALEX + +To fully view the current APR of holding $LiALEX, please visit here: [https://app.lisalab.io/li/alex/stacking](https://app.lisalab.io/li/alex/stacking) diff --git a/supported-tokens/bitcoin-usdbtc/README.md b/supported-tokens/bitcoin-usdbtc/README.md new file mode 100644 index 0000000..19f26f9 --- /dev/null +++ b/supported-tokens/bitcoin-usdbtc/README.md @@ -0,0 +1,19 @@ +# Bitcoin ($BTC) + +
+ +**LiaBTC** is a rebasing tokens for aBTC. + +aBTC is designed to have the same value as Bitcoin, maintaining a 1:1 ratio (1 aBTC = 1 BTC). It's created on the Stacks platform, which enables smart contracts and apps for Bitcoin, thereby aiming to expand the utility of Bitcoin within decentralized finance (DeFi). + +## 1 LiaBTC = 1 aBTC + +LiaBTC rebasing mechanism is similar to other LISA rebasing token mechanism. + +### How Long to Stake In and Out? + +You can stake your BTC to LiaBTC immediately; however, to unstake, you would need to wait 1,000 Bitcoin blocks for your LiaBTC to be converted back to BTC. + +* **Stake In:** Immediate +* **Stake Out:** 1,000 Bitcoin blocks + diff --git a/supported-tokens/bitcoin-usdbtc/how-liabtc-earns-bitcoin-yield.md b/supported-tokens/bitcoin-usdbtc/how-liabtc-earns-bitcoin-yield.md new file mode 100644 index 0000000..cbec738 --- /dev/null +++ b/supported-tokens/bitcoin-usdbtc/how-liabtc-earns-bitcoin-yield.md @@ -0,0 +1,15 @@ +# How LiaBTC Earns Bitcoin Yield? + +LiaBTC earns yield by staking BTC on Babylon via the COBO API. The staked BTC is used to secure Proof of Stake (PoS) chains and generate yield. + +The staked BTC supports the network's security budget, and stakers are rewarded with token emissions from the network that it secures. + +It is important to note that LiaBTC yield accrues based on Bitcoin blocks, not on cycles like LiSTX or LiALEX. + +**Video explanation available here:** [https://x.com/LisaLab\_BTC/status/1848152280190857572](https://x.com/LisaLab_BTC/status/1848152280190857572) + +### How long does Withdrawal Takes? + +Babylon has 7-day (\~1,008 blocks) unbonding wait upon request. + +However, the withdrawal process would be similar to LiSTX withdrawal process. diff --git a/supported-tokens/bitcoin-usdbtc/how-liabtc-utilizes-cobo.md b/supported-tokens/bitcoin-usdbtc/how-liabtc-utilizes-cobo.md new file mode 100644 index 0000000..fb77061 --- /dev/null +++ b/supported-tokens/bitcoin-usdbtc/how-liabtc-utilizes-cobo.md @@ -0,0 +1,11 @@ +# How LiaBTC utilizes COBO? + +
+ +XLink, in partnership with COBO as the custodian of BTC reserves, instructs COBO to securely stake the relevant Bitcoin on the Babylon platform. The underlying Bitcoin that backs the aBTC is staked at Babylon, with COBO serving as the finality provider to ensure security and the irreversibility of transactions. + +As rewards from the staking process accrue, LiaBTC balances automatically increase, ensuring a continuous stream of rewards for holders. + +Similar to other liquid staking products offered by LISA, LiaBTC is a rebase token, meaning its supply adjusts based on rewards, ensuring continuous compounding without manual reinvestment. + +\ diff --git a/supported-tokens/bitcoin-usdbtc/how-would-alex-v2-upgrade-affects-liabtc.md b/supported-tokens/bitcoin-usdbtc/how-would-alex-v2-upgrade-affects-liabtc.md new file mode 100644 index 0000000..b77152c --- /dev/null +++ b/supported-tokens/bitcoin-usdbtc/how-would-alex-v2-upgrade-affects-liabtc.md @@ -0,0 +1,7 @@ +# How would ALEX V2 Upgrade Affects LiaBTC? + +With the ALEX V2 upgrades, XLink will integrate with LISA, allowing Bitcoin users to send BTC and receive vLiaBTC (in BRC-20) in their Bitcoin wallet (i.e., users won't need a Stacks wallet to interact with LISA). + +This approach will also be applied to all other liquid staking products on LISA over time (in which case it will be STX/ALEX/USDT in BRC-20 => vLiSTX/vLiALEX/vLiUSDT in BRC-20). + +Currently, LISA only supports staking in and out via the Stacks network, even though you can bridge the LSTs out of the Stacks network. diff --git a/supported-tokens/bitcoin-usdbtc/what-is-liabtc-backed-by.md b/supported-tokens/bitcoin-usdbtc/what-is-liabtc-backed-by.md new file mode 100644 index 0000000..5f69972 --- /dev/null +++ b/supported-tokens/bitcoin-usdbtc/what-is-liabtc-backed-by.md @@ -0,0 +1,5 @@ +# What is LiaBTC backed by? + +The underlying BTC backing aBTC is securely staked at Babylon, with COBO ensuring the finality of transactions, offering both security and irreversibility. + +When users stake aBTC through LISA, they receive LiaBTC at a 1:1 ratio, directly reflecting their staked aBTC. From there, LISA coordinates with XLink, the designated staking manager, to stake the Bitcoin backing those aBTCs. diff --git a/supported-tokens/stx/README.md b/supported-tokens/stx/README.md new file mode 100644 index 0000000..48c2f7c --- /dev/null +++ b/supported-tokens/stx/README.md @@ -0,0 +1,31 @@ +# Stacks ($STX) + +**LiSTX** uses a rebasing mechanism for balance growth, while **vLiSTX** appreciates in value as stacking rewards accumulate. This design ensures both liquidity and adaptability, maintaining LiSTX at a 1:1 ratio with STX, whereas vLiSTX’s value diverges over time due to rewards. + +## 1 LiSTX = 1 STX + +Locking STX grants users LiSTX, which grows in the balance to reflect stacking yields. LiSTX can be traded at any time: It can be redeemed for STX at face value or traded against STX and other assets on supporting exchanges. + +Both LiSTX and vLiSTX adhere to the SIP-10 standard, yet they distinguish themselves in how rewards are accumulated. LiSTX rebases to increase balance, while vLiSTX’s balance remains constant as its value grows from stacking rewards. Users can interchange LiSTX and vLiSTX via a smart contract, ensuring sharing liquidity. + +LiSTX’s rebasing keeps its value aligned with STX, enabling efficient trading with minimal slippage. In contrast, vLiSTX, expected to diverge in value from STX due to rewards, may experience higher slippage when traded. + +### What are the differences between the STX tokens? + +**$STX:** + +* Can be used to participate in STX mining to earn BTC—e.g: via [Xverse](../../ecosystem-partners/xverse.md). +* Most CEX and DEXs use STX pairs for trading. +* Does not earn yield by itself, but you can add it to a liquidity pool (LP) to earn fees on a DEX like ALEX. + +**$LiSTX:** + +* Earns up to \~10% in STX yield rewards annually. +* Your LiSTX balance increases with each stacking cycle via a rebasing mechanism. +* Requires you to unstake back to STX for CEX deposits. + +**$vLiSTX:** + +* Its intrinsic value increases as rewards accrue with each cycle, but your balance remains the same. +* Requires you to wrap it from LiSTX; which you can also unwrap via the [Unwrap](../../features-how-tos/wrapping-unwrapping.md) feature. +* Bridgeable to other networks via XLink (Allows you to participate in different network campaigns). diff --git a/supported-tokens/stx/how-listx-architecture-works/README.md b/supported-tokens/stx/how-listx-architecture-works/README.md new file mode 100644 index 0000000..4aaa2a7 --- /dev/null +++ b/supported-tokens/stx/how-listx-architecture-works/README.md @@ -0,0 +1,12 @@ +# How LiSTX Architecture Works? + +
+ +LISA's LiSTX runs on three core components, all of which are operated by LISA DAO: + +* LiSTX Mint Factory +* LISA Vault +* Strategies + +Please read the subsection to understand how those mechanism works. + diff --git a/supported-tokens/stx/how-listx-architecture-works/lisa-vault.md b/supported-tokens/stx/how-listx-architecture-works/lisa-vault.md new file mode 100644 index 0000000..c92d7cd --- /dev/null +++ b/supported-tokens/stx/how-listx-architecture-works/lisa-vault.md @@ -0,0 +1,7 @@ +# LISA Vault + +## LISA Vault + +LISA Vault holds STX that are received from the LISA users and that are available for LiSTX redemption. + +LISA Vault permissions Strategies to pull STX from itself to be deployed to the members of the Strategies. In return, Strategies are implemented so that they can send STX only to LISA Vault. diff --git a/supported-tokens/stx/how-listx-architecture-works/mint-factory.md b/supported-tokens/stx/how-listx-architecture-works/mint-factory.md new file mode 100644 index 0000000..b3ecdb5 --- /dev/null +++ b/supported-tokens/stx/how-listx-architecture-works/mint-factory.md @@ -0,0 +1,41 @@ +# Mint Factory + +## LiSTX Mint Factory + +LiSTX Mint Factory is the main smart contract LISA users interact to mint/burn LiSTX/vLiSTX. + +LiSTX Mint Factory implements the logic of LiSTX minting/burning process, while the relevant data is stored at LiSTX Mint Registry. Such separation of the logic and the data storage allows for future upgrades of the logic, while preserving the data layout. + +### Request to mint LiSTX + +When a user requests to mint LiSTX, a mint request ticket (in form of NFT) is issued to the user and the relevant STX is sent to LISA Vault. + +In order for a user to start stacking from the next cycle, a mint request must be confirmed at least 300 blocks before the prepare stage of stacking begins for the next cycle (100 blocks before the current cycle end). Otherwise, the mint request is queued for the following cycle. + +### Finalise the mint request + +When LiSTX is ready to be minted (which is 432 blocks after the relevant stacking cycle start), the user can finalise the mint request at which time the mint request ticket will be burnt in exchange for LiSTX. + +### Revoke the mint request + +Subject to availability of unlocked STX at LISA Vault, a user may revoke a mint request, in which case the mint request ticket is burnt and the relevant STX sent to the user. + +A user may not revoke a mint request if the unlocked STX at LISA Vault were sent to Strategies for stacking, or if the unlocked STX were redeemed to meet any outstanding burn requests. + +### Request to burn LiSTX + +When a user requests to burn LiSTX, a burn request ticket (in form of NFT) is issued to the user and the relevant LiSTX is sent to LISA Vault. + +While the user waits to burn LiSTX, the stacking rewards will continue to be accrued. + +### Finalise the burn request + +Finalisation of a burn request is subject to the availability of unlocked STX at LISA Vault. When a burn request is made, LiSTX Mint Factory will try to finalise immediately (in which case the user would immediately burn the burn request ticket and receive the relevant STX). Otherwise, the burn request is queued. + +### Revoke the burn request + +A user may revoke a burn request any time, in which case the burn request ticket will be burnt and the relevant LiSTX sent to the user. + +## LiSTX and vLiSTX + +LiSTX may be wrapped to vLiSTX any time, and vice versa. diff --git a/supported-tokens/stx/how-listx-architecture-works/strategies.md b/supported-tokens/stx/how-listx-architecture-works/strategies.md new file mode 100644 index 0000000..867965f --- /dev/null +++ b/supported-tokens/stx/how-listx-architecture-works/strategies.md @@ -0,0 +1,7 @@ +# Strategies + +## Strategies + +Strategies are the smart contracts that implement particular stacking strategies. Each strategy may have one or more "members" which join and delegate STX to different stacking pools. + +They are managed by Strategy Managers, who decide the allocation of STX across the members of its strategy for each cycle.