Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content Edits #20

Open
wants to merge 17 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 25 additions & 6 deletions docs/learn/mars-hub/mars-token/mars-token-and-distribution.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,33 @@
sidebar_position: 1
---

import MarsTokenAndDistributionUrl from '@site/static/img/learn/mars-hub/mars-token-and-distribution.png';
import MarsTokenAndDistributionUrl from '@site/static/img/learn/mars-hub/fee-distribution.jpg';

# Distribution
# Distribution of Mars Token in Mars V2

In Mars V1 the Community Pool (CP) holds a large amount of MARS tokens that aren't actively used (i.e., 633.4 Million). This represents a significant portion of the total token supply locked away.

Mars V2 has reduced the CP by burning most of the excess tokens, leaving only 300M MARS for future protocol needs.

## Fee Distribution Mechanism

50% of protocol fees used to go to the Safety Fund as axlUSDC, while the other 50% was reserved for Mars Hub stakers as MARS tokens. Mars V2 changes it.

- **Safety Fund**: A portion of fees will be used to buy nobleUSDC and add to the Safety Fund.
- **Buy and Burn**: A portion of fees will be used to purchase MARS tokens from the market and burn them, reducing the circulating supply.
- **Buy and LP**: A portion of fees will be used to create liquidity pairs (MARS with another token like OSMO, NTRN, or nobleUSDC) on decentralized exchanges like Osmosis or Neutron. This increases the token's liquidity and potentially reduces reliance on liquidity mining incentives.

Helping coordinate and align incentives of the different stakeholders involved, the MARS token is a key piece of the Mars ecosystem. The maximum supply of MARS tokens will be 1 billion and the final token allocation is as follows:

<img src={MarsTokenAndDistributionUrl} style={{ paddingBottom: 15 }} />

- **Token Claim (~66.6M):** To be distributed to all persons who were $MARS-Classic token holders on Terra Classic as of the applicable snapshot periods, as described [here](https://mars-protocol.medium.com/unveiling-the-mars-airdrop-and-snapshot-data-ea4f3926f2ca). These tokens will be fully unlocked and claimable upon genesis.
- **Community Pool (~633.4M):** Governed by the Martian Council. Some of the use cases of this pool of funds could include rewarding of staking/lending/borrowing, token grants and other community building programs.
- **Mars Contributors (300M):** Unlocking/vesting builder allocations. 1/3rd unlocks from a smart contract escrow on September 1, 2023, with the remainder unlocking linearly on a daily basis over the following two-year period. Vesting and other contractual restrictions may apply in addition to the smart contract lockup, depending on the particular token grantee.

## Overall Goals

- **Optimize token distribution**: Ensure that MARS tokens are allocated efficiently and effectively.
- **Increase token utility**: Enhance the use cases for MARS tokens beyond staking rewards.
- **Strengthen protocol finances**: Build a more robust Safety Fund and reduce reliance on the Community Pool.
- **Promote token liquidity**: Improve trading opportunities for MARS tokens.
- **Create deflationary pressure**: Reduce the circulating supply of MARS tokens through burning.

These changes aim to make the MARS token more valuable and the Mars Protocol more sustainable by optimizing token distribution, increasing utility, and strengthening the protocol's financial position.

5 changes: 3 additions & 2 deletions docs/learn/mars-hub/mars-token/mars-token-intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ import Cards from '@site/src/components/Cards';

# Mars Token

Learn more about the role of the MARS token in the Mars ecosystem.
Mars Token is the native cryptocurrency of Mars Protocol. It serves as the backbone of the ecosystem, powering various functionalities and incentivizing participation through discounts on protocol fees. Mars Token plays a crucial role in governing the platform and establishing a truly decentralized financial ecosystem.

<Cards title="Mars Token" />

<Cards title="Mars Token" />
23 changes: 14 additions & 9 deletions docs/learn/mars-hub/mars-token/staking.mdx
Original file line number Diff line number Diff line change
@@ -1,19 +1,24 @@
---
sidebar_position: 2
title: "STAKING MARS TOKEN"
---

import Admonition from '@theme/Admonition'

# Staking

In Mars v1, MARS stakers were responsible for governing the protocol and backstopping it in the event of a shortfall event. Staked tokens were represented by xMARS, a transferable liquid staking token.

The token’s utility will mainly materialise via delegation. Specifically, MARS holders will be able to stake (or delegate) their tokens to a number of validators within the network in order to:
Mars Protocol is designed to incentivize token holders and contribute to the protocol's growth. By staking your MARS tokens, you actively participate in the governance while, in the future, potentially reducing trading fees.

1. **Secure the chain**: All else being equal, the more tokens staked within the network, the more secure the chain as it becomes more expensive to attack. As a result, by delegating MARS tokens to a validator, users will help secure the chain.
2. **Access delegated governance**: When staking tokens with a particular validator, users are delegating the voting power of their tokens to that validator. In this sense, delegation allows users to participate in governance by staking their tokens with (and thereby increasing the voting power of) validators who align with their views. A user can passively allow a validator to vote on their behalf or they can actively participate in votes themselves.
3. **Receive fees**: In return for securing the chain, a share of protocol fees will flow to validators and their delegators. Note that the share that flows to delegators depends on the specific commission charged by each validator. Specific details are provided in the fololowing [section](../../mars-v2/fees).
## Benefits of Staking MARS

- **Stakers Fee Discounts**: Stakers in the future could get discounts on the protocol fees for trading activities within the Mars ecosystem. This provides consistent encouragement to token holders.
- **Participate in Governance**: Stakers have a direct say in shaping the future of the protocol through governance proposals and voting.

## Staking Mechanics

If you have already staked your tokens on Mars Hub, you can unstake them and Stake them on [DAODAO](https://daodao.zone/dao/neutron1pxjszcmmdxwtw9kv533u3hcudl6qahsa42chcs24gervf4ge40usaw3pcr/home). Before staking you must transfer your holdings of MARS tokens on Neutron Blockchain. Once you complete the staking process, you can view and express your opinions and vote for the upcoming governance proposals.

## Unstaking

If you need to access your staked MARS tokens before the end of the staking period, you can initiate an unstaking process. However, the usual waiting period is 1 day before you can withdraw your tokens.

<Admonition type="info" title="NOTE">
The unbonding period (the length of time to return staking amount after unstaking) is 14 days.
</Admonition>
11 changes: 10 additions & 1 deletion docs/learn/mars-v2/mars-v2-intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,14 @@ import Cards from '@site/src/components/Cards';

# Mars v2

Mars V1 was already a successful money market. However, Mars V2 is an upgraded version with a credit account that helps the protocol enhance the DeFi experience. It aims to expand the protocol's capabilities by introducing new features and improving existing ones.

<Cards title="Mars v2" />
Key aspects of Mars V2 include:

- **Enhanced DeFi products**: Earlier Mars V1 had limited lending, borrowing, and yield farming. With Mars V2 we are set to offer a wider range of Defi functionalities, such as spot trading, margin trading, copy trading vaults to imitate and learn from experienced traders, and high-leverage strategies. However, two breakthrough innovations are cross-margined and cross-collateralization accounts. Any on-chain asset can act as collateral, including LPs, and tokens, and every perp is cross-margined.

- **Amplified Leverage**: The new credit account enables users to maximize their leverage by under collateralization. On top of that, using High Leverage Strategy (HLS), you can further increase your leverage up to 10x.



<Cards title="Mars v2" />
26 changes: 21 additions & 5 deletions docs/overview/security/bug-bounty-program.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,31 @@
sidebar_position: 2
---

import BugBountyUrl from '@site/static/img/overview/bug-bounty.png';
import BugBountyUrl from '@site/static/img/overview/Bug-Bounty-New.jpg';

# Bug Bounty

A bug bounty is currently open for Mars Hub and peripheral contracts. If you uncover a bug on Mars Hub testnet, report it via [Immunefi.com](https://immunefi.com/bounty/mars/) to potentially earn a bounty worth as much as $100,000. Rewards are distributed according to the impact of the vulnerability based on the [Immunefi Vulnerability Severity Classification System V2.2](https://immunefi.com/immunefi-vulnerability-severity-classification-system-v2-2/). This is a simplified 5-level scale, with separate scales for websites/apps, smart contracts, and blockchains/DLTs. As shown in the table below, the scale focuses on the impact of a given vulnerability.
Mars Protocol is committed to building a secure and robust DeFi ecosystem. We value your expertise in helping us identify and address vulnerabilities in our protocol. This bug bounty program rewards security researchers who discover and responsibly report vulnerabilities in our smart contracts and blockchain applications.

##Program Overview

Mars Protocol majorly consists of key components:
**Red Bank**: A money market protocol for lending and borrowing.
**Credit Accounts**: A generalized credit primitive for Mars outposts.

**Maximum Bounty: $100,000**

We offer competitive rewards for identified vulnerabilities. The severity of the vulnerability determines the reward amount.

##Rewards by Threat Level

<img src={BugBountyUrl} style={{ paddingBottom: 15 }} />

All bug reports must come with a PoC with an end-effect impacting an asset-in-scope in order to be considered for a reward. Explanations and statements are not accepted as a PoC and code is required.
##Reward Determination

- Rewards are based on the severity of the vulnerability using the [Immunefi Vulnerability Severity Classification System V2.2](https://immunefi.com/immunefi-vulnerability-severity-classification-system-v2-2/)
- All reports must include a Proof of Concept (PoC) demonstrating the vulnerability and its impact on in-scope assets. Code is required, not just explanations.
- Rewards for critical vulnerabilities are capped at 10% of the potential economic damage on mainnet, with a minimum of $20,000 and a maximum of $100,000.

Rewards for critical blockchain/DLT vulnerabilities are further capped at 10% of the economic damage potentially caused. However, there is a minimum reward of $20,000 and a maximum reward of $100,000. Please visit the [Mars Bug Bounty page on Immunefi](https://immunefi.com/bounty/mars/) for complete details.
Please visit the [Mars Bug Bounty page on Immunefi](https://immunefi.com/bounty/mars/) for complete details.

For a detailed explanation, you can check out [immunefi bug bounty page](https://immunefi.com/bounty/mars/)
9 changes: 8 additions & 1 deletion docs/overview/security/security-intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,11 @@ import Cards from '@site/src/components/Cards';

# Security

<Cards title="Security" />
Security is a paramount concern for any decentralized financial protocol, and Mars Protocol is committed to maintaining the highest standards of protection for its users and assets. To ensure the utmost security and transparency, we have conducted rigorous security audits and implemented a robust bug bounty program.

The attached audit report provides a comprehensive evaluation of the Mars Protocol's smart contracts, identifying potential vulnerabilities and outlining the measures taken to address them.

Our bug bounty program serves as an additional layer of defense, incentivizing white-hat hackers to discover and report security flaws before they can be exploited. Through these proactive security measures, the Mars Protocol aims to foster a secure and trustworthy environment for all participants in the ecosystem.


<Cards title="Security" />
17 changes: 16 additions & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,8 @@
"react-dom": "^17.0.2",
"rehype-katex": "^5.0.0",
"remark-math": "^3.0.1",
"tailwindcss": "^3.2.4"
"tailwindcss": "^3.2.4",
"yarn": "^1.22.22"
},
"devDependencies": {
"@docusaurus/module-type-aliases": "2.2.0"
Expand Down
Loading