Skip to content

Commit

Permalink
Docs edits (#3615)
Browse files Browse the repository at this point in the history 
- [x] PR title is my best effort to provide summary of changes and has
clear text to be part of release notes
- [x] I marked PR by `misc` label if it should not be in release notes
- [ ] I have linked Zenhub/Github or any other reference item if one
exists
- [ ] I was clear on what type of deployment required to release my
changes (node, runtime, contract, indexer, on chain operation, frontend,
infrastructure) if any in PR title or description
- [ ] I waited and did best effort for `pr-workflow-check /
draft-release-check` to finish with success(green check mark) with my
changes
- [x] I have added at least one reviewer in reviewers list
- [x] I tagged(@) or used other form of notification of one person who I
think can handle best review of this PR
  • Loading branch information
@JafarAz
JafarAz authored May 18, 2023
1 parent a62ee58 commit feb48a5
Show file tree
Hide file tree
Showing 6 changed files with 52 additions and 50 deletions.
11 changes: 11 additions & 0 deletions docs/docs/parachains/composable/composable-crowdloan.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,3 +23,14 @@ Additionally,
[we announced an increase](https://composablefi.medium.com/christmas-comes-early-for-crowdloan-contributors-30-increase-in-rewards-ffc11c911af7)
in the rewards for Composable crowdloan stakers. These added rewards come on top of the above early bird incentives.
We ended up unlocking additional rewards and allocating 16% of LAYR's token supply for the crowdloan.

## DOT Purchase Log

This page catalogues all the stablecoin conversions to DOT via TPS (the OTC desk of 3AC ) and contributed to the
crowdloan for the Composable Parachain.

| Date | Stablecoins | DOT purchase price |
| ---------- | -------------- | ------------------ |
| 12/01/2022 | 252795.77 DAI | 27.1993 |
| 12/01/2022 | 157807.4 USDT | 27.1993 |
| 12/01/2022 | 48129.881 USDT | 27.1993 |
37 changes: 19 additions & 18 deletions docs/docs/parachains/picasso/token-transparency.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,13 @@ Thus, to reward and thank the devoted users who supported us through this proces
we are allocating a portion of the PICA token supply to crowdloan participants.
Finally, 15% of the total PICA token supply is targeted to be released as rewards for participants in Liquidity Programs in Picasso.

:::info

Total supply refers to the number of coins or tokens that currently exist and are either in circulation or locked somehow. It is the sum of coins that were already minted (or issued) minus the total number of coins that were burned or destroyed.

Therefore, the total supply refers to both the circulating supply and the tokens that are yet to hit the open market including tokens that are being held under a lockup or vesting period, which typically follows a private sale or Token Generation Event. Coins or tokens that are eventually burned are excluded from the total supply.
:::

### Supporting Growth, Development, and Security on Picasso

Tokens from Composable’s “Treasury” PICA allocation may be used for a number of initiatives towards advancing
Expand Down Expand Up @@ -62,6 +69,11 @@ Upon token launch, the genesis pools would be the multisig addresses below.
We have published this list for the community to monitor for purposes of transparency.
The other non-multisig addresses are labeled as protocol controlled addresses.

info:::
Circulating supply refers to all tokens that are held in accounts outside of the non-circulating Composable and protocol-controlled addresses listed above.
- Circulating supply is currently the unvested tokens associated with the crowdloan rewards. No other multisig wallets or tokens will be considered circulating unless voted upon by protocol governance to become circulating, unless otherwise above.

:::
### Non-Circulating Genesis Addresses

The following multisigs are controlled by the governance council and are activated only by governance.
Expand All @@ -79,9 +91,15 @@ Liquidity Programs Multisig : 5ys4cFxQBDs8qhkXbs9smn7yVMSmJ3QdLeqNTHfhk5QmX5Pj
Treasury Pallet for accruing fees: https://polkadot.js.org/apps/#/treasury


### Protocol Controlled Addresses
### Alignment of allocation

In accordance with [Council motion #16](https://picasso.polkassembly.io/motion/16), the Picasso Treasury has been reimbursed for the allocation portion of the Infrastructure Round, which should have been sourced from the allocation designated for Ecosystem Incentives. This amount encompasses complete PICA allocations for oracle and collator providers, along with 12 months' worth of allocated rewards. The total PICA transferred sums up to 78,282,699.80.

Pursuant to [Council motion #19](https://picasso.polkassembly.io/motion/19), the Picasso Team Multisig will be reimbursed at its designated address from the Picasso Treasury. These tokens were mistakenly spent from the Team multisig address prior to the migration of a new Team Multisig, and therefore, reimbursed by the intended location, the Picasso treasury. The total PICA amount to be reimbursed is 51,874,200 PICA.

**Neither of these events aims to modify any previously established token allocations; rather, they intend to rectify an accounting error between multisig addresses.**

### Protocol Controlled Addresses

#### Crowdloan Pallet Funds

Expand Down Expand Up @@ -125,23 +143,6 @@ HCMDYY3ittCoNQEtZV9XAxMQkC6YYKgC6cxZuJkAdikhuqQ

No other tokens will be considered circulating unless approved by governance.


## Glossary

- **Circulating Supply**:
Circulating supply refers to all tokens that are held in accounts
outside of the non-circulating Composable and protocol-controlled addresses listed above.
- Circulating supply is currently the unvested tokens associated with the crowdloan rewards.
No other multisig wallets or tokens will be considered circulating unless voted upon by protocol governance to become circulating, unless otherwise above.

- **Total Supply**:
Total supply refers to the number of coins or tokens that currently exist and are either in circulation or locked somehow.
It is the sum of coins that were already minted (or issued) minus the total number of coins that were burned or destroyed.
Therefore, the total supply includes both the circulating supply and the tokens that are yet to hit the open market.
Tokens that are being held under a lockup or vesting period, which typically follows a private sale or Token Generation Event.
Coins or tokens that are eventually burned are excluded from the total supply.


#### Disclaimer
This document is meant for informational purposes only.
It is not meant to serve as investment advice or an offer to sell or buy any securities, utility tokens, or any financial instruments or services.
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/parachains/picasso/tokenomics.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The total supply of PICA is 10 billion tokens. PICA Token distribution is intend
| 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)_ | 76,632,699.80 | ~0.766% | 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. |
| 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 token purchasers that participated in the second Composable Finance token sale, 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. This includes programs such as xPICA. |

Expand Down
26 changes: 15 additions & 11 deletions docs/docs/products/pablo-overview.md
View file
Original file line number Diff line number Diff line change
@@ -1,28 +1,32 @@
# Pablo: The Decentralized Exchange

Pablo is the native decentralized exchange (DEX) of Picasso. It is a DeFi primitive, in that it fulfills a fundamental
basic need of any DeFi ecosystem. In this case that function is token swaps whilst incorporating novel innovations to
provide a complete suite of features that together form a protocol that is greater than the sum of its parts.
[Pablo](https://www.pablo.finance/) is the native decentralized exchange (DEX) of Picasso. It is a DeFi primitive, in that it fulfills a fundamental basic need of any DeFi ecosystem. In this case that function is token swaps whilst incorporating novel innovations to provide a complete suite of features that together form a protocol that is greater than the sum of its parts.

Pablo offers multiple AMM-types, enhanced customizability for LPs and traders, liquidity-bootstrapping pools,
cross-chain assets through our IBC and EVM bridges, and single sided staking.
Pablo will offer multiple AMM-types, enhanced customizability for LPs and traders, liquidity-bootstrapping pools and
cross-chain assets and liquidity pools via [Centauri](../products/centauri-overview.md).
Upon launch, Pablo will support dual asset Constant product(x * y = k) pools based on [BalancerFi weighted math]
followed shortly after by Stableswap and the aforementioned liquidity-bootstrapping pools (LBP).
In addition, Pablo aims to overcome the short-falls that other DEXs face such as mercenary capital
and relying solely on a high inflationary reward token.
Through bonding and protocol-owned liquidity, a completely fair-launch token, and strong value capture tokenomics,

Pablo is set to provide sustainable yield and strong utility to the Composable ecosystem.
As a result, it provides deep liquidity for asset swaps, yields for liquidity providers,
and plays a significant role in kick starting the flywheel of DeFI activity on the Picasso chain.
For example, Pablo will support future planned protocols such as our isolated lending market - Angular.

Pablo will focus on achieving strong liquidity for Substrate-native assets on our Kusama and Polkadot parachains,
and then continue to evolve as future infrastructure such as our Substrate <<!--\-->>IBC bridge — Centauri, goes live.
Therefore, Pablo is positioned not only to capture liquidity from the DotSama ecosystem
but also to become a cross-chain hub that can natively tap into liquidity from IBC-enabled blockchains.
Pablo will focus on achieving strong liquidity for Substrate-native assets on our Kusama and Polkadot parachains, and then continue to evolve as future Centauri, establishes new connections. Therefore, Pablo is positioned not only to capture liquidity from the DotSama ecosystem but also to become a cross-chain DEX that can natively tap into liquidity from IBC-enabled blockchains.

This is only furthered by each IBC connection we add, such as to NEAR, and eventually ETH 2.0 and Layer 2s.

Pablo will kickstart the Composable DeFi ecosystem and act as a catalyst for our broader cross-chain vision.

[BalancerFi weighted math]: https://docs.balancer.fi/concepts/math/weighted-math

:::tip

Explore the following user guides for interacting with the [Pablo dApp](https://www.app.pablo.finance/) that explain:

- [How to trade PICA on Pablo](../user-guides/how-to-trade-pica-on-pablo.md)
- [How to provide liquidity on Pablo](../user-guides/how-to-provide-liquidity.md)
- [How to LP DOT on Pablo via Centauri](../user-guides/centauri-guide.md)

:::
9 changes: 6 additions & 3 deletions docs/docs/products/pablo/launch-pools.md
View file
Original file line number Diff line number Diff line change
@@ -1,15 +1,18 @@
# Liquidity Pools on Launch

On launch, Pablo will be the only way of swapping for PICA through dual asset constant product pools,
On launch, Pablo was the only platform for acquiring PICA through dual asset constant product pools,
based on the BalancerFi weighted math implementation of (x * y = K) for:

- KSM/USDT
- PICA/USDT
- PICA/KSM

Since of the launch of Centauri, we have added the following pools:

- PICA/DOT
- DOT/KSM
- DOT/USDT

Pablo’s native token, PBLO, is set for launch in late Q1 2023.

Liquidity providers(LPs) directly benefit from the success and adoption of Pablo.
LPs are provided LP-tokens relative to the funds they add to a liquidity pool on Pablo.
Expand All @@ -32,4 +35,4 @@ Transactions through Pablo native liquidity pools for asset swaps and buy/sell o
0.3% of the total amount traded and are paid by the trader in the input asset.

### Initialization of pools
According to this passed proposal at the following link: https://picasso.subscan.io/council/2, the initial pools are seeded by the treasury at $150m FDV for PICA with $50,000 of liquidity, and the 30 day price of KSM for the KSM/USDT pool with $50,000 of liquidity as well. On Tuesday, the 27th of December, trading began at 19:00 UTC (14:00 EST) on Pablo.
According to this passed proposal at the following link: https://picasso.subscan.io/council/2, the initial pools were seeded by the treasury at $150m FDV for PICA with $50,000 of liquidity, and the 30 day price of KSM for the KSM/USDT pool with $50,000 of liquidity as well. On Tuesday, the 27th of December, trading began at 19:00 UTC (14:00 EST) on Pablo.
17 changes: 0 additions & 17 deletions docs/sidebars.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -58,20 +58,6 @@ const sidebars = {
'parachains/picasso/pica-use-cases'
]
},
{
type: 'category',
label: 'xPICA fNFTs',
link: {
type: 'doc',
id: 'products/xpica-fnft-overview'
},
collapsible: true,
collapsed: true,
items: [
'products/xpica-fnft/picasso-treasury',
'products/xpica-fnft/use-cases'
],
},
],
},
{
Expand All @@ -85,7 +71,6 @@ const sidebars = {
collapsed: true,
items: [
'parachains/composable/composable-crowdloan',
'parachains/composable/DOT-purchase-log',
'parachains/composable/LAYR-tokenomics',
],
}
Expand Down Expand Up @@ -202,9 +187,7 @@ const sidebars = {
'products/pablo/swaps-trading',
'products/pablo/launch-pools',
'products/pablo/auctions-bonding',
'products/pablo/xPBLO-fNFT-staking',
'products/pablo/cross-chain-DEX',
'products/pablo/governance-tokenomics',
],
},
{
Expand Down

0 comments on commit feb48a5

Please sign in to comment.