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.

Sign up for GitHub

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

Jump to bottom

docs(edits): minor edits + pica tokenomics edits based on recent events #4443

Merged
merged 2 commits into from
Feb 5, 2024
Merged

docs(edits): minor edits + pica tokenomics edits based on recent events #4443

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c30fd54
grazie mister
JafarAz Feb 2, 2024
4454d13
Update tokenomics.md
JafarAz Feb 2, 2024
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
4 changes: 2 additions & 2 deletions docs/docs/networks/picasso/pica-allocation-pie.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 10 additions & 8 deletions docs/docs/networks/picasso/pica-use-cases.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,18 +20,20 @@ A summary of PICA use cases is as follows:
Within the Picasso ecosystem there are multiple staking avenues that can be utilized to earn yield in PICA. This tri-staking model strengthens the security of the network while maintaining liquidity and distributing maximum value back to Picasso token holders.

### Oracle staking​
Apollo is a permissionless, MEV-resistant oracle solution. Anyone can run an oracle node on Picasso by providing a PICA stake.
Apollo is a permissionless, MEV-resistant oracle solution. Anyone can run an oracle node on Picasso by providing stake in PICA.

### Collator staking​
25% of fees on Picasso are distributed to collators, with the remaining 75% going directly to the community-governed treasury. Collators on Picasso are required to put down a stake to produce blocks on our parachain, as with most proof of stake networks.

### Composable Cosmos staking
PICA is also used to secure the Composable Cosmos chain. This is the first instance of a token being utilized for validation within both the Kusama and Cosmos ecosystems and highlights the critical role PICA plays within cross-ecosystem communication. The Delegation Program sources 1bn PICA tokens from the Picasso Treasury to validators to ensure a robust and secure network while providing a ~10% APR in PICA.
PICA is also used to secure the Composable Cosmos chain. This is the first instance of a token being utilized for validation within both the Kusama and Cosmos ecosystems and highlights the critical role PICA plays within cross-ecosystem communication. The Delegation Program sources 1bn PICA tokens from the Picasso Treasury to validators to ensure a robust and secure network while aiming to provide a ~10% APR in PICA with the initial reward pool.

A percentage of the bridging fees generated by each new IBC connection involving Picasso will be allocated to [stakers of PICA on Composable Cosmos](/docs/docs/user-guides/composable-cosmos-staking.md). At present, stakers receive rewards from the Polkadot-Cosmos IBC connection. With the introduction of Solana and Ethereum IBC connections in Q1 of 2024, 20% of the bridging fees from these connections will be distributed to PICA stakers. Additionally, distribution of fees from Polkadot Liquid Staking is also planned for these stakers.

## Polkadot Liquid Staking
Composable is launching Liquid Staked DOT (LSDOT) in the ecosystem. Revenue will flow to PICA, providing yield emissions from liquid staking, but only while stakings are locked. The value accrual for liquid staking is a 1% fee + 75% of 10% of the yield generated.
Composable launched Liquid Staked DOT (LSDOT) on [trustless.zone](https://app.trustless.zone/stake/), a liquid staked token for Polkadot's native token. Revenue from this activity will flow to PICA, providing yield emissions from liquid staking, but only while stakings are locked. The value accrual for liquid staking is a 1% fee + 75% of 10% of the yield generated.

## Staking Reward Curve for Bridging Fees
<!-- ## Staking Reward Curve for Bridging Fees

Users may stake their PICA for a % share of revenue generated from bridging fees. The PICA staking rewards curve acts as a method of rewarding users who have staked their PICA over a threshold duration of time. Users who hit a maximum duration of 90-days staked will receive a proportional share of the 20% of bridge revenue allocated towards PICA stakers.

Expand Down Expand Up @@ -61,7 +63,7 @@ Share of redistributed revenue up the curve for longer-duration stakers will onl

- 30 Days <= x < 60 Days : receive 15% of redistributed revenue from stakers lower in the curve
- 60 Days <= x < 90 Days : receive 35% of redistributed revenue from stakers lower in the curve
- 90 Days <= x : receive 50% of redistributed revenue from stakers lower in the curve
- 90 Days <= x : receive 50% of redistributed revenue from stakers lower in the curve -->

## The first cross-ecosystem token
As Picasso plays a pivotal role in both our Kusama and Cosmos strategies, PICA will be utilized across both ecosystems as we continue to explore new use cases and integrations.
Expand All @@ -80,10 +82,10 @@ New use cases will continue to be established as we move forward with HRMP chann

## Governance

Picasso is waging war on centralization with a vision of a seamlessly interoperable, trustless future for DeFi. As such the PICA token will play an important role in helping to realize this vision, as governance will soon be powered by phase 2 of Picasso's [OpenGov](./governance.md).
Picasso is waging war on centralization with a vision of a seamlessly interoperable, trustless future for DeFi. As such the PICA token will play an important role in helping to realize this vision, as governance is powered by phase 2 of Picasso's [OpenGov](./governance.md).

As PICA also serves as the native token of Composable Cosmos, it is required for governance of the chain aswell.
As PICA also serves as the native token of Composable Cosmos, it is required for governance of [Composable Cosmos](../composable-cosmos.md) aswell.

## Where is PICA available?

Since its launch, the PICA token has been made available across a number of different blockchain ecosystems thanks to Composable IBC. Therefore, PICA can be acquired on Composable’s own [Pablo DEX](https://app.pablo.finance/) on Picasso and the [Osmosis DEX](https://app.osmosis.zone/).
Since its launch, the PICA token has been made available across a number of different blockchain ecosystems thanks to Composable IBC. Therefore, PICA can be acquired on Composable’s own [Pablo DEX](https://app.pablo.finance/) on Picasso and the [Osmosis DEX](https://app.osmosis.zone/).
4 changes: 2 additions & 2 deletions docs/docs/networks/picasso/pica-vesting-schedule.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 5 additions & 7 deletions docs/docs/networks/picasso/tokenomics.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,12 @@ The total supply of PICA is 10 billion tokens. PICA Token distribution is intend

| Allocation | Amount | Percentage (%) | Description |
|:-----------------------------------------------------:|---------------:|:----------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Founders, Early Team Members and Current Contributors | 1,365,000,000 | 13,65% | 13.65% of PICA are earmarked for distribution to founders, early team members, and current key team members along a 2-year linear vesting schedule with an initial 6-month lock. |
| Key Partners & Advisors | 635,000,000 | 6,35% | 6.35% of PICA are intended to be distributed to key strategic partners and advisors along a 2-year linear vesting schedule with a 6 month lock. This will form part of the Team allocation. |
| Treasury | 1,800,297,200 | ~18% | Approximately 18% of PICA’s supply is allocated to account for the long-term sustainability of the Picasso Network. Picasso Network treasury receives transaction fees and is governed by the Picasso General Council, which is intended to later be governed by PICA token holders. 75% of spent network fees will automatically flow into this fund (the remaining 25% of spent fees are intended to be distributed to collators).** |
| Founders, Current Contributors, Key Partners & Advisors | 2,000,000,000 | 20% | 20% of PICA is earmarked for distribution to founders, current key team members, Key Partners & Advisors along a 2-year linear vesting schedule with an initial 6-month lock. |
| Treasury | 2,708,674,592 | ~27.1% | Approximately 18% of PICA’s supply was allocated to account for the long-term sustainability of Picasso. 75% of spent network fees will automatically flow into this fund (the remaining 25% of gas fees are distributed to collators). Following the approval of Referendum 63 on Picasso, ~9% of unclaimed crowdloan rewards were transferred to the Treasury. Following council motion 23, 1 billion PICA from this allocation is currently bonded on [Composable Cosmos](../composable-cosmos.md) to secure the network. ** |
| Future Personnel Incentives _(part of Treasury)_ | 200,000,000 | ~2% | 2% of PICA is intended to be reserved for future personnel incentives. Future issues from this pool will be subject to a 4-year vesting schedule from network launch or grant date (whichever is later) with a 1-year cliff and monthly vesting thereafter.** |
| Crowdloan | 3,000,000,000 | 30% | 30% of Picasso token supply will be allocated to crowdloan stakers for the parachain lease slot dated November 30, 2021 - October 31, 2022. The crowdloan stakers will earn 50% of their PICA upon TGE, with the remainder being released linearly within 48 weeks. The full balance can be used to participate in governance and other activities besides transferring. Any unclaimed rewards from the crowdloan will be transferred to the Picasso treasury three months after the crowdloan vesting period is concluded via a treasury proposal. |
| Ecosystem Incentives | 1,000,000,000 | 10% | 10% of PICA’s total token supply will be released from the protocol as rewards and incentives for a number of actions involved in the protocol. These are programmatic incentives to bootstrap network growth such as running an oracle on Apollo. |
| Infrastructure Round _(part of Ecosystem Incentives)_ | 78,282,699.80 | ~0.78% | Participants in the Infrastructure Round (i.e., those who will operate collators and oracles) will have their PICA locked for up to 3 months before they are released for staking for a minimum target period of 6 months. |
| Series A Token Purchasers | 699,702,800 | 7% | This portion of PICA tokens is allocated to Series A token purchasers, with a 3 month lock-up plus 2 years vesting. |
| Crowdloan | 2,091,622,608 | ~20.9% | 30% of Picasso's token supply was originally allocated to crowdloan stakers for the parachain lease slot dated November 30, 2021 - October 31, 2022. The crowdloan stakers earned 50% of their PICA upon TGE, with the remainder released linearly within 48 weeks. The full balance can be used to participate in governance and other activities besides transferring. Any unclaimed rewards from the crowdloan will be transferred to the Picasso treasury three months after the crowdloan vesting period is concluded via a treasury proposal. This was executed after community referendum 63 on OpenGov. |
| Ecosystem Incentives | 1,000,000,000 | 10% | 10% of PICA’s total token supply will be released from the protocol as rewards and incentives for a number of actions involved in the protocol. These are programmatic incentives to bootstrap network growth such as running an oracle on Apollo. | |
| Series A Token Purchasers | 699,702,800 | ~7% | This portion of PICA tokens is allocated to Series A token purchasers, with a 3 month lock-up plus 2 years vesting. |
| Liquidity Programs | 1,500,000,000 | 15% | 15% of the total token supply will be released as rewards for participants in Liquidity Programs on Picasso. |


Expand Down
2 changes: 1 addition & 1 deletion docs/docs/technology/mantis/integration-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The end-to-end flow for getting data for solvers, posting the solution, and exec
- The problem format is [here](https://github.com/ComposableFi/composable/blob/f65076f5fcf2f0903b3d21e62ba22d7ba91c0c9f/code/xcvm/cosmwasm/contracts/order/src/lib.rs#L65).
- In JSON format, in https://www.npmjs.com/package/cvm-cw-types?activeTab=code, open `/cvm-cw-types/dist/cw-mantis-order/response_to_get_all_orders.json`.

2. Solvers Collect Data Needed to Solve Problems
2. **Solvers Collect Data Needed to Solve Problems**
- AMM amounts/fees, tokens denominations, and routes are needed.
- [AMM Neutron](https://app.astroport.fi/api/trpc/pools.getAll?input=%7B%22json%22%3A%7B%22chainId%22%3A%22phoenix-1%22%7D%7D)
- [AMM Osmosis](https://app.osmosis.zone/api/pools?page=1&limit=300&min_liquidity=500000)
Expand Down
6 changes: 4 additions & 2 deletions docs/docs/technology/mantis/protocol-flow.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,13 @@ A summary of the flow of the MANTIS protocol is below, with further details foun
3. **Single-Chain Execution Scenario**:
- **Efficient Execution**: The platform swiftly matches orders in a single transaction block for prompt fulfillment.
- **Batch Auctions**: Batch Auctions process multiple orders simultaneously, maximizing the product of exchanged amounts (A * B) for efficient matching.
**Order Pricing**:

**Order Pricing**:

- **Dynamic Price Matching**: The platform matches orders to achieve optimal trading volume without violating user-set limits.
- **Execution at Optimal Prices**: Execution occurs at a price that maximizes volume, ensuring efficiency.

4. **Cross-Chain Execution Scenario**:
1. **Cross-Chain Execution Scenario**:
- **Multi-Chain Execution**: Certain orders are executed using liquidity pools across multiple blockchain networks, involving several blocks and chains.
- **Cross-Chain Virtual Machine (CVM) Program**: The CVM facilitates these transactions, ensuring efficient multi-chain swaps.
- **Monitoring Interface**: A detailed interface provides real-time updates for multi-chain transactions.
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/technology/mantis/solver-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This tutorial describes how to run a solver node and how users can post problems
| **Chain** | **Stage** | **ID** |
| -------- | -------- | -------- |
| centauri-1 | mainnet | centauri1lnyecncq9akyk8nk0qlppgrq6yxktr68483ahryn457x9ap4ty2sthjcyt |
| osmosis-1 | mainnet | Text |
| osmosis-1 | mainnet | |


### Problem Submission
Expand Down
Loading