diff --git a/docs/concepts/trading-framework/fees.md b/docs/concepts/trading-framework/fees.md index d2bcf1e80..0c1d2a737 100644 --- a/docs/concepts/trading-framework/fees.md +++ b/docs/concepts/trading-framework/fees.md @@ -9,7 +9,7 @@ import NetworkParameter from '@site/src/components/NetworkParameter'; The Vega software is designed such that participants in a network who place orders on the order book, provide liquidity and run the network infrastructure receive the fees that traders pay on filled trades and transfers. The protocol does not have a mechanism to charge gas fees for interacting with the network. -Users can offset some of those fees, or earn even more, by receiving discounts or getting rewards based on trading activity. Rewards can be funded by anyone, and can be in any asset. +Users can offset some of those fees, or earn even more, by receiving discounts or getting rewards based on trading activity. Rewards can be funded by anyone, and can be in any asset. :::note Read more [Concept: Discounts and rewards](./discounts-rewards.md) @@ -34,7 +34,7 @@ The aggressor *buying* the base asset for the quote asset pays more in their tra ### Fee distribution and breakdown Fees are calculated when a trade is filled, and paid in the market's settlement currency. The fees due are taken from the collateral in the trader's general account. -The fee is divided between the maker for the trade, the infrastructure providers, and the liquidity provider(s) for each market. +If each fee type is set to have a value, the fee is divided between the maker for the trade, the infrastructure providers, the liquidity provider(s) for each market, and the network's treasury. ### Maker fee The maker portion of the fee is paid by the aggressive party in a trade (the taker), and transferred to the non-aggressive, or passive party in the trade (the maker, as opposed to the taker). This is done as soon as the trade settles. @@ -59,19 +59,27 @@ The fees paid are transferred to a liquidity fee account, and distributed to eac [How the liquidity fee is set](../liquidity/rewards-penalties.md#determining-the-liquidity-fee-percentage) ::: +### Network treasury fee +The network treasury fee is collected from takers and transferred to the [network treasury](../assets/accounts.md#network-treasury-accounts). + +The amount charged for this fee is set by a network parameter. + +### Buyback fee +The buyback fee is collected from takers and is used to buy specific tokens on a spot market through automated purchase programs. The amount charged for this fee is set by a network parameter. + ### Fee calculations At a high level, the trading fee that someone pays is calculated using the following formulas: -* Total fee = (infrastructure fee factor + maker fee factor + liquidity fee factor) x trade value for fee purposes +* Total fee = (infrastructure fee factor + maker fee factor + liquidity fee factor + buyback fee + network treasury fee) x trade value for fee purposes * Trade value for fee purposes = notional value of the trade = size of trade x price of trade #### Fee calculation example * Trade value for fee purposes: If you were to place an order for 100 at USDC50, the trade value for fee purposes is: *100 x USDC50 = USDC5000*. -* Fee factor: For this example, each of the 3 fees is *0.001*, meaning total fee factor is *0.003*. -* Trade value and fee factor: *USDC5000 x 0.003 = USDC15* +* Fee factor: For this example, each of the 5 fees is *0.001*, meaning total fee factor is *0.005*. +* Trade value and fee factor: *USDC5000 x 0.005 = USDC25* * The fee is the same regardless of the number of transactions the order needs to be completely filled, as long as they trade at the same price. -Two of the three fee factors are set through network parameters: , . The liquidity fee is set by the liquidity providers on the market. +Four of the five fee factors are set through network parameters. , . The liquidity fee is set by the liquidity providers on the market. ## Transfer fees You may need to pay a fee to transfer assets, whether from one Vega key to another, or from a Vega key to a reward pool to fund trading rewards. The fee amount is taken when the transfer is executed, on top of the total amount to be transferred. It's charged in the same asset that is being transferred. diff --git a/docs/tutorials/proposals/asset-transfer-proposal.md b/docs/tutorials/proposals/asset-transfer-proposal.md index 92e5a30de..4f6001b48 100644 --- a/docs/tutorials/proposals/asset-transfer-proposal.md +++ b/docs/tutorials/proposals/asset-transfer-proposal.md @@ -1,7 +1,6 @@ --- sidebar_position: 9 title: Transfer assets -vega_network: TESTNET hide_title: true keywords: - proposal @@ -43,6 +42,7 @@ For **one-off transfers** use `deliverOn` to set a delivery date/time for when t For **recurring transfers**, such as for funding rewards, you'll need to include the following information: * `startEpoch`: The number of the epoch in which you want the first transfer to be made. It will initiate at the end of that epoch. * `endEpoch`: The transfer will repeated indefinitely, unless you add this optional parameter to end the recurring transfer in a specified epoch. +* `factor`: Factor that the initial transfer amount is multiplied by for each epoch that it is executed. For example if the initial transfer amount is 1000 and the factor is 0.5, then the amounts transferred per epoch will be 1000, 500, 250, 125, etc. **Amount** is the cap on how much will be transferred, as whole number with the asset decimal places implied. For example, if the asset has a decimal place of 2 and the transfer is for 100, then the amount needs to be set at 10000. The maximum you can propose to transfer is the value of the network parameter , which is a multiplier for the asset's [quantum value](../../concepts/assets/asset-framework.md#quantum). Before proposing, make sure the account you're transferring from exists and has a balance. The full amount may not be transferred if there isn't enough to transfer. For specifics on how the final amount is determined, see the [calculations in the transfers spec ↗](https://github.com/vegaprotocol/specs/blob/master/protocol/0057-TRAN-transfers.md#recurring-transfers). @@ -139,7 +139,8 @@ These templates show an example of how to fund rewards with a governance transfe "destinationType": "ACCOUNT_TYPE_REWARD_AVERAGE_POSITION", "recurring": { "startEpoch": 116515, - "endEpoch": 116615 + "endEpoch": 116615, + "factor": "1" "dispatchStrategy": { "assetForMetric": "b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663", "metric": "DISPATCH_METRIC_MAKER_FEES_PAID", @@ -183,6 +184,7 @@ These templates show an example of how to fund rewards with a governance transfe "recurring": { "startEpoch": 1111110, "endEpoch": 1111111, + "factor": "1" "dispatchStrategy": { "assetForMetric": "b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663", "metric": "DISPATCH_METRIC_MAKER_FEES_PAID", @@ -228,8 +230,9 @@ vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KE \"fractionOfBalance\": `\"0.1\", ^ \"destinationType\": \"ACCOUNT_TYPE_REWARD_AVERAGE_POSITION\", ^ \"recurring\": {^ - \"startEpoch\": \"1111110\" ^ - \"endEpoch\": \"1111111\" ^ + \"startEpoch\": \"1111110\", ^ + \"endEpoch\": \"1111111\", ^ + \"factor\": \"1\" ^ \"dispatchStrategy\": { ^ \"assetForMetric\": \"b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663\", ^ \"metric\": \"DISPATCH_METRIC_MAKER_FEES_PAID\", ^ diff --git a/docs/tutorials/proposals/maker-volume-rebate-program.md b/docs/tutorials/proposals/maker-volume-rebate-program.md new file mode 100644 index 000000000..5d708d37a --- /dev/null +++ b/docs/tutorials/proposals/maker-volume-rebate-program.md @@ -0,0 +1,179 @@ +--- +sidebar_position: 11 +title: Enable or replace maker rebate program +hide_title: false +vega_network: TESTNET +keywords: +- proposal +- governance +--- + +import NetworkParameter from '@site/src/components/NetworkParameter'; +import JSONInstructions from './_json-instructions.md'; +import TerminalInstructions from './_terminal-instructions.md'; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import Batch from './_batch-sample.md'; + +When a high-volume maker rebate program is enabled, market makers can receive a rebate of a portion of their paid fees. The higher their maker volume across all markets over the program's window length, the greater the rebate that makers can receive. + +The program needs to be enabled by governance. Once it's enabled, both the requirements and the benefits can also be replaced with a new program. + +This page describes what you need to propose enabling or replacing the program, and provides example proposal templates that you will need to edit before sharing and submitting. + +## Requirements + +You will need: +* A connected [Vega wallet](../../tools/vega-wallet/index.md), with your wallet name and public key to hand +* A minimum of the value set in the following network parameters. You need whichever amount is larger associated with that public key: or . +* Familiarity with [governance](../../concepts/governance/index.md) + +## Anatomy of a maker rebate program proposal +The fields below all need to be defined to enable the program or replace an existing one. + +If you are suggesting a replacement program, you'll need to include all the fields, even if you don't want to change their values. Just use the existing values from the current maker rebate program program. + +**End of program timestamp**: Date and time after which, when the current epoch ends, the program will end and rebates will be disabled. + +**Window length**: Number of epochs over which to evaluate each participant's volume of maker trades across all markets. + +To end an existing program early, set your proposal up with the exact same parameters. Set the *end of program timestamp* to be the same as the proposal's *enactment* timestamp. + +#### Benefit tier fields + +| Benefit tier field | Description | Accepted values | +| ----------- | ----------- | ----------- | +| `benefitTiers` | List of values defining the rebate factors for the program | Holds the details of each tier of rebates, listed below. Maximum of tiers | +| `minimumPartyMakerVolumeFraction` | To access this tier, the required percentage of trading volume, across all markets, that a party was the maker for, in the window length. This is expresssed as a fraction. | Greater than 0 and up to 1, inclusive | +| `additionalMakerRebate` | Additional fraction of fees a party will receive as a rebate when they are on the maker side of a trade. | Greater than 0 and up to 1, inclusive | + +## Submitting proposals in a batch + + + +## Templates and submitting + +Below you will find: +* JSON example that can be submitted with the [governance dApp ↗](https://governance.fairground.wtf/proposals/propose/raw) +* Command line examples for different operating systems + + + + + +```json +{ + "proposalSubmission": { + "rationale": { + "title": "Maker volume rebate proposal title", + "description": "This enacts or replaces the maker volume rebate program" + }, + "terms": { + "UpdateVolumeRebateProgram": { + "changes": { + "endOfProgramTimestamp": 1234567890, + + "window_length": 11, + "benefitTiers": [ + { + "minimumPartyMakerVolumeFraction": "10000", + "additionalMakerRebate": "0.002" + }, + { + "minimumPartyMakerVolumeFraction": "10198", + "additionalMakerRebate": "0.098" + } + ], + } + }, + "closingTimestamp": 1111111111, + "enactmentTimestamp": 1111111155 + } + } +} +``` + + + + + +``` +./vegawallet transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KEY --network NETWORK_NAME +'{"proposalSubmission": { + "rationale": { + "title": "Maker volume rebate proposal title", + "description": "This enacts or replaces the volume rebate program" + }, + "terms": { + "UpdateVolumeRebateProgram": { + "changes": { + "end_of_program_timestamp": 1234567890, + + "window_length": 3, + "benefitTiers": [ + { + "minimumPartyMakerVolumeFraction": "10020", + "additionalMakerRebate": "0.001" + }, + { + "minimumPartyMakerVolumeFraction": "10198", + "additionalMakerRebate": "0.098" + } + ], + } + }, + "closingTimestamp": 1111111111, + "enactmentTimestamp": 1111111155 + } + } +}' +``` + + + + + +``` +vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KEY --network NETWORK_NAME ^ +"{^ +\"proposalSubmission\": {^ + \"rationale\": {^ + \"title\": \"Maker volume rebate program proposal title\",^ + \"description\": \"This explains why I want to enact or replace the volume rebate program\"^ + },^ + \"terms\": {^ + : { + \"UpdateVolumeRebateProgram\":^ { + \"changes\": {^ + \"end_of_program_timestamp\": \"1234567890\",:^ + + \"window_length\": \"3\", + \"benefitTiers\": [ + { + \"minimumPartyMakerVolumeFraction\": \"10100\",^ + \"additionalMakerRebate\": \"0.001\"^ + + }, + { + \"minimumPartyMakerVolumeFraction\": \"11000\",^ + \"additionalMakerRebate\": \"0.098\"^ + } + ], + } + }, + \"closingTimestamp\": \"1111111111\",^ + \"enactmentTimestamp\": \"1111111155\" + }^ + }^ +}'^ +``` + + + +## Voting +To vote, participants need, at a minimum, the larger of the value of the following network parameters: or associated to their Vega key. + +A proposal will need [participation](../../concepts/governance/lifecycle.md#how-the-outcome-is-calculated) of at least the value of the network parameter and a majority that's the value of the network parameter . + +## Enactment +If successful, the program changes will go live in the epoch following the time you specify in the `enactmentTimestamp` field. \ No newline at end of file diff --git a/docs/tutorials/proposals/volume-discount-program-proposal.md b/docs/tutorials/proposals/volume-discount-program-proposal.md index a3c879cee..447ce9603 100644 --- a/docs/tutorials/proposals/volume-discount-program-proposal.md +++ b/docs/tutorials/proposals/volume-discount-program-proposal.md @@ -2,7 +2,6 @@ sidebar_position: 11 title: Enable or replace volume discount program hide_title: false -vega_network: TESTNET keywords: - proposal - governance @@ -26,7 +25,7 @@ This page describes what you need to propose enabling or replacing the volume di You will need: * A connected [Vega wallet](../../tools/vega-wallet/index.md), with your wallet name and public key to hand * A minimum of whichever is larger, associated with that public key: based on the network parameter values for or -* Familiarity with [governance on Vega](../../concepts/governance/index.md) +* Familiarity with [governance](../../concepts/governance/index.md) ## Anatomy of a volume discount program proposal The fields below all need to be defined to enable the volume discount program or replace an existing one. @@ -37,7 +36,7 @@ If you are suggesting a replacement program, you'll need to include all the fiel **Window length**: Number of epochs over which to evaluate traders' volume of taker trades. -To end an existing program early, set your proposal up with the exact same parameters. Set the *end of program timestamp* to be the same as the proposal's *enactment* timestamp. +To end an existing program early, set your proposal up with the exact same parameters. Set the *end of program timestamp* to be the same as the proposal's *enactment* timestamp. #### Benefit tier fields @@ -45,7 +44,12 @@ To end an existing program early, set your proposal up with the exact same param | ----------- | ----------- | ----------- | | `benefitTiers` | List of values defining the discount factors for the program | Holds the details of each tier of discounts, listed below. Maximum of tiers | | `minimumRunningNotionalTakerVolume` | The notional volume of aggressive trades that a trader is required to have across the aggregation window, to access the discount in this tier | Integer greater than or equal to 1 | -| `volumeDiscountFactor` | Proportion of each trader's fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `volumeDiscountFactors` | Each fee type must be listed separately. | Listed below | +| `makerVolumeDiscountFactor` | Proportion of each trader's maker fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `liquidityVolumeDiscountFactor` | Proportion of each trader's liquidity fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `infrastructureVolumeDiscountFactor` | Proportion of each trader's infrastructure fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | + + ## Submitting proposals in a batch @@ -71,27 +75,38 @@ Below you will find: "terms": { "updateVolumeDiscountProgram": { "changes": { - "end_of_program_timestamp": 1234567890, - - "window_length": 11, "benefitTiers": [ - { - "minimumRunningNotionalTakerVolume": "10000", - "volumeDiscountFactor": "0.002" + { + "minimumRunningNotionalTakerVolume": "11", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.02", + "liquidityDiscountFactor": "0.021", + "makerDiscountFactor": "0.022" }, - { - "minimumRunningNotionalTakerVolume": "10198", - "volumeDiscountFactor": "0.098" - } - ], - } + }, + { + "minimumRunningNotionalTakerVolume": "1000", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.044", + "liquidityDiscountFactor": "0.045", + "makerDiscountFactor": "0.046" + }, }, + ], + "endOfProgramTimestamp": 1234567890, + "windowLength": "11" "closingTimestamp": 1111111111, "enactmentTimestamp": 1111111155 } } } -``` +} +} +``` @@ -107,21 +122,35 @@ Below you will find: "terms": { "updateVolumeDiscountProgram": { "changes": { - "end_of_program_timestamp": 1234567890, - - "window_length": 3, "benefitTiers": [ { "minimumRunningNotionalTakerVolume": "10020", + "minimumEpochs": "1", "volumeDiscountFactor": "0.001" }, { "minimumRunningNotionalTakerVolume": "10198", - "volumeDiscountFactor": "0.098" - } - ], - } + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.02", + "liquidityDiscountFactor": "0.021", + "makerDiscountFactor": "0.022" + }, + }, + { + "minimumRunningNotionalTakerVolume": "1000", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.044", + "liquidityDiscountFactor": "0.045", + "makerDiscountFactor": "0.046" + }, + }, + ], + } }, + "endOfProgramTimestamp": 1234567890, + "windowLength": 3, "closingTimestamp": 1111111111, "enactmentTimestamp": 1111111155 } @@ -145,23 +174,32 @@ vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KE : { \"updateVolumeDiscountProgram\":^ { \"changes\": {^ - \"end_of_program_timestamp\": \"1234567890\",:^ - - \"window_length\": \"3\", - \"benefitTiers\": [ + \"endOfProgramTimestamp\": \"1234567890\",:^ + \"windowLength\": \"3\",^ + \"benefitTiers\": [^ { - \"minimumRunningNotionalTakerVolume\": \"10100\",^ - \"volumeDiscountFactor\": \"0.001\"^ + \"minimumEpochs\": \"1\"^ + \"minimumRunningNotionalTakerVolume\": \"11\",^ + \"volumeDiscountFactor\":^ + \"volumeDiscountFactors\":^ + \"infrastructureDiscountFactor\": \"0.02\",^ + \"liquidityDiscountFactor\": \"0.021\",^ + \"makerDiscountFactor\": \"0.022\",^ }, { - \"minimumRunningNotionalTakerVolume\": \"11000\",^ - \"volumeDiscountFactor\": \"0.098\"^ - } - ], - } - }, + \"minimumEpochs\": \"1\"^ + \"minimumRunningNotionalTakerVolume\": \"1000\",^ + \"volumeDiscountFactor\":^ + \"volumeDiscountFactors\":^ + \"infrastructureDiscountFactor\": \"0.02\",^ + \"liquidityDiscountFactor\": \"0.021\",^ + \"makerDiscountFactor\": \"0.022\",^ + },^ + ],^ + }^ + },^ \"closingTimestamp\": \"1111111111\",^ - \"enactmentTimestamp\": \"1111111155\" + \"enactmentTimestamp\": \"1111111155\"^ }^ }^ }'^ @@ -170,13 +208,9 @@ vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KE ## Voting -All proposals are voted on by the community. - -To vote, community members need, at a minimum, the larger of the value of the following network parameters or associated to their Vega key. - -Your proposal will need [participation](../../concepts/governance/lifecycle.md#how-the-outcome-is-calculated) of and a majority of . +To vote, participants need, at a minimum, the larger of the value of the following network parameters or associated to their Vega key. -Proposers who invite feedback, engage with comments, and make revisions to meet the needs of the community are more likely to be successful. +The proposal will need [participation](../../concepts/governance/lifecycle.md#how-the-outcome-is-calculated) of and a majority of . ## Enactment If successful, the program changes will go live in the epoch following the time you specify in the `enactmentTimestamp` field. \ No newline at end of file diff --git a/versioned_docs/version-v0.77/concepts/trading-framework/discounts-rewards.md b/versioned_docs/version-v0.77/concepts/trading-framework/discounts-rewards.md index e4905424c..7a415454b 100644 --- a/versioned_docs/version-v0.77/concepts/trading-framework/discounts-rewards.md +++ b/versioned_docs/version-v0.77/concepts/trading-framework/discounts-rewards.md @@ -54,6 +54,11 @@ All of the details for the volume discount program are proposed and accepted thr * [Spec: Technical design of the volume discount program ↗](https://github.com/vegaprotocol/specs/blob/master/protocol/0084-VDPR-volume_discount_program.md). ::: +## Rebate for high-volume market makers +Market makers who are involved in a significant fraction of all trading can receive a rebate on their trading fees from trades in which they're involved. + +This program must be set up using a governance proposal. + ### Rewards for eligible participants Participants who exceed certain eligibility criteria can be rewarded when the eligible entities reward is funded. diff --git a/versioned_docs/version-v0.77/concepts/trading-framework/fees.md b/versioned_docs/version-v0.77/concepts/trading-framework/fees.md index b6dd7a301..b06779b8a 100644 --- a/versioned_docs/version-v0.77/concepts/trading-framework/fees.md +++ b/versioned_docs/version-v0.77/concepts/trading-framework/fees.md @@ -34,7 +34,7 @@ The aggressor *buying* the base asset for the quote asset pays more in their tra ### Fee distribution and breakdown Fees are calculated when a trade is filled, and paid in the market's settlement currency. The fees due are taken from the collateral in the trader's general account. -The fee is divided between the maker for the trade, the infrastructure providers, and the liquidity provider(s) for each market. +If each fee type is set to have a value, the fee is divided between the maker for the trade, the infrastructure providers, the liquidity provider(s) for each market, and the network's treasury. ### Maker fee The maker portion of the fee is paid by the aggressive party in a trade (the taker), and transferred to the non-aggressive, or passive party in the trade (the maker, as opposed to the taker). This is done as soon as the trade settles. @@ -59,19 +59,29 @@ The fees paid are transferred to a liquidity fee account, and distributed to eac [How the liquidity fee is set](../liquidity/rewards-penalties.md#determining-the-liquidity-fee-percentage) ::: +### Network treasury fee +The network treasury fee is collected from takers and transferred to the [network treasury](../assets/accounts.md#network-treasury-accounts). + +The amount charged for this fee is set by a network parameter. + +### Buyback fee +The buyback fee is collected from takers and is used to buy governance tokens on a spot market via regular auctions. If there is no relevant spot market, and the fee is set to a value higher than 0, the accrued fee payments are transferred to the [network treasury](../assets/accounts.md#network-treasury-accounts). + +The amount charged for this fee is set by a network parameter. + ### Fee calculations At a high level, the trading fee that someone pays is calculated using the following formulas: -* Total fee = (infrastructure fee factor + maker fee factor + liquidity fee factor) x trade value for fee purposes +* Total fee = (infrastructure fee factor + maker fee factor + liquidity fee factor + buyback fee + network treasury fee) x trade value for fee purposes * Trade value for fee purposes = notional value of the trade = size of trade x price of trade #### Fee calculation example * Trade value for fee purposes: If you were to place an order for 100 at USDC50, the trade value for fee purposes is: *100 x USDC50 = USDC5000*. -* Fee factor: For this example, each of the 3 fees is *0.001*, meaning total fee factor is *0.003*. -* Trade value and fee factor: *USDC5000 x 0.003 = USDC15* +* Fee factor: For this example, each of the 5 fees is *0.001*, meaning total fee factor is *0.005*. +* Trade value and fee factor: *USDC5000 x 0.005 = USDC25* * The fee is the same regardless of the number of transactions the order needs to be completely filled, as long as they trade at the same price. -Two of the three fee factors are set through network parameters: , . The liquidity fee is set by the liquidity providers on the market. +Four of the five fee factors are set through network parameters. , . The liquidity fee is set by the liquidity providers on the market. ## Transfer fees You may need to pay a fee to transfer assets, whether from one Vega key to another, or from a Vega key to a reward pool to fund trading rewards. The fee amount is taken when the transfer is executed, on top of the total amount to be transferred. It's charged in the same asset that is being transferred. diff --git a/versioned_docs/version-v0.77/concepts/trading-framework/orders.md b/versioned_docs/version-v0.77/concepts/trading-framework/orders.md index 33cf4f878..be0b5d147 100644 --- a/versioned_docs/version-v0.77/concepts/trading-framework/orders.md +++ b/versioned_docs/version-v0.77/concepts/trading-framework/orders.md @@ -145,7 +145,7 @@ Your stop order can be set to have a [time in force](#times-in-force), and it ca If the trigger is breached, an order is submitted with the parameters that you provided, and with your existing position's size if it's linked to the position. Your position isn't affected unless the order is filled. -A stop order can be set with a fixed size or have its size dictated by your open position. A stop order must reduce your position, and will be rejected otherwise. +A stop order can be set with a fixed size or have its size dictated by your open position. Once the last traded price "rises above" or "falls below" the given stop price/percentage move, depending on your instruction, your order is executed. diff --git a/versioned_docs/version-v0.77/tutorials/proposals/asset-transfer-proposal.md b/versioned_docs/version-v0.77/tutorials/proposals/asset-transfer-proposal.md index 92e5a30de..4f6001b48 100644 --- a/versioned_docs/version-v0.77/tutorials/proposals/asset-transfer-proposal.md +++ b/versioned_docs/version-v0.77/tutorials/proposals/asset-transfer-proposal.md @@ -1,7 +1,6 @@ --- sidebar_position: 9 title: Transfer assets -vega_network: TESTNET hide_title: true keywords: - proposal @@ -43,6 +42,7 @@ For **one-off transfers** use `deliverOn` to set a delivery date/time for when t For **recurring transfers**, such as for funding rewards, you'll need to include the following information: * `startEpoch`: The number of the epoch in which you want the first transfer to be made. It will initiate at the end of that epoch. * `endEpoch`: The transfer will repeated indefinitely, unless you add this optional parameter to end the recurring transfer in a specified epoch. +* `factor`: Factor that the initial transfer amount is multiplied by for each epoch that it is executed. For example if the initial transfer amount is 1000 and the factor is 0.5, then the amounts transferred per epoch will be 1000, 500, 250, 125, etc. **Amount** is the cap on how much will be transferred, as whole number with the asset decimal places implied. For example, if the asset has a decimal place of 2 and the transfer is for 100, then the amount needs to be set at 10000. The maximum you can propose to transfer is the value of the network parameter , which is a multiplier for the asset's [quantum value](../../concepts/assets/asset-framework.md#quantum). Before proposing, make sure the account you're transferring from exists and has a balance. The full amount may not be transferred if there isn't enough to transfer. For specifics on how the final amount is determined, see the [calculations in the transfers spec ↗](https://github.com/vegaprotocol/specs/blob/master/protocol/0057-TRAN-transfers.md#recurring-transfers). @@ -139,7 +139,8 @@ These templates show an example of how to fund rewards with a governance transfe "destinationType": "ACCOUNT_TYPE_REWARD_AVERAGE_POSITION", "recurring": { "startEpoch": 116515, - "endEpoch": 116615 + "endEpoch": 116615, + "factor": "1" "dispatchStrategy": { "assetForMetric": "b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663", "metric": "DISPATCH_METRIC_MAKER_FEES_PAID", @@ -183,6 +184,7 @@ These templates show an example of how to fund rewards with a governance transfe "recurring": { "startEpoch": 1111110, "endEpoch": 1111111, + "factor": "1" "dispatchStrategy": { "assetForMetric": "b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663", "metric": "DISPATCH_METRIC_MAKER_FEES_PAID", @@ -228,8 +230,9 @@ vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KE \"fractionOfBalance\": `\"0.1\", ^ \"destinationType\": \"ACCOUNT_TYPE_REWARD_AVERAGE_POSITION\", ^ \"recurring\": {^ - \"startEpoch\": \"1111110\" ^ - \"endEpoch\": \"1111111\" ^ + \"startEpoch\": \"1111110\", ^ + \"endEpoch\": \"1111111\", ^ + \"factor\": \"1\" ^ \"dispatchStrategy\": { ^ \"assetForMetric\": \"b340c130096819428a62e5df407fd6abe66e444b89ad64f670beb98621c9c663\", ^ \"metric\": \"DISPATCH_METRIC_MAKER_FEES_PAID\", ^ diff --git a/versioned_docs/version-v0.77/tutorials/proposals/volume-discount-program-proposal.md b/versioned_docs/version-v0.77/tutorials/proposals/volume-discount-program-proposal.md index a3c879cee..b41dc16eb 100644 --- a/versioned_docs/version-v0.77/tutorials/proposals/volume-discount-program-proposal.md +++ b/versioned_docs/version-v0.77/tutorials/proposals/volume-discount-program-proposal.md @@ -2,7 +2,6 @@ sidebar_position: 11 title: Enable or replace volume discount program hide_title: false -vega_network: TESTNET keywords: - proposal - governance @@ -37,7 +36,7 @@ If you are suggesting a replacement program, you'll need to include all the fiel **Window length**: Number of epochs over which to evaluate traders' volume of taker trades. -To end an existing program early, set your proposal up with the exact same parameters. Set the *end of program timestamp* to be the same as the proposal's *enactment* timestamp. +To end an existing program early, set your proposal up with the exact same parameters. Set the *end of program timestamp* to be the same as the proposal's *enactment* timestamp. #### Benefit tier fields @@ -45,7 +44,12 @@ To end an existing program early, set your proposal up with the exact same param | ----------- | ----------- | ----------- | | `benefitTiers` | List of values defining the discount factors for the program | Holds the details of each tier of discounts, listed below. Maximum of tiers | | `minimumRunningNotionalTakerVolume` | The notional volume of aggressive trades that a trader is required to have across the aggregation window, to access the discount in this tier | Integer greater than or equal to 1 | -| `volumeDiscountFactor` | Proportion of each trader's fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `volumeDiscountFactors` | Each fee type must be listed separately. | Listed below | +| `makerVolumeDiscountFactor` | Proportion of each trader's maker fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `liquidityVolumeDiscountFactor` | Proportion of each trader's liquidity fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | +| `infrastructureVolumeDiscountFactor` | Proportion of each trader's infrastructure fees to be discounted, will be converted to a percentage | Must be greater than or equal to 0 and less than / equal to | + + ## Submitting proposals in a batch @@ -71,27 +75,38 @@ Below you will find: "terms": { "updateVolumeDiscountProgram": { "changes": { - "end_of_program_timestamp": 1234567890, - - "window_length": 11, "benefitTiers": [ - { - "minimumRunningNotionalTakerVolume": "10000", - "volumeDiscountFactor": "0.002" + { + "minimumRunningNotionalTakerVolume": "11", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.02", + "liquidityDiscountFactor": "0.021", + "makerDiscountFactor": "0.022" }, - { - "minimumRunningNotionalTakerVolume": "10198", - "volumeDiscountFactor": "0.098" - } - ], - } + }, + { + "minimumRunningNotionalTakerVolume": "1000", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.044", + "liquidityDiscountFactor": "0.045", + "makerDiscountFactor": "0.046" + }, }, + ], + "endOfProgramTimestamp": 1234567890, + "windowLength": "11" "closingTimestamp": 1111111111, "enactmentTimestamp": 1111111155 } } } -``` +} +} +``` @@ -107,21 +122,35 @@ Below you will find: "terms": { "updateVolumeDiscountProgram": { "changes": { - "end_of_program_timestamp": 1234567890, - - "window_length": 3, "benefitTiers": [ { "minimumRunningNotionalTakerVolume": "10020", + "minimumEpochs": "1", "volumeDiscountFactor": "0.001" }, { "minimumRunningNotionalTakerVolume": "10198", - "volumeDiscountFactor": "0.098" - } - ], - } + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.02", + "liquidityDiscountFactor": "0.021", + "makerDiscountFactor": "0.022" + }, + }, + { + "minimumRunningNotionalTakerVolume": "1000", + "minimumEpochs": "1", + "volumeDiscountFactor": "", + "volumeDiscountFactors": { + "infrastructureDiscountFactor": "0.044", + "liquidityDiscountFactor": "0.045", + "makerDiscountFactor": "0.046" + }, + }, + ], + } }, + "endOfProgramTimestamp": 1234567890, + "windowLength": 3, "closingTimestamp": 1111111111, "enactmentTimestamp": 1111111155 } @@ -145,23 +174,32 @@ vegawallet.exe transaction send --wallet YOUR_WALLETNAME --pubkey YOUR_PUBLIC_KE : { \"updateVolumeDiscountProgram\":^ { \"changes\": {^ - \"end_of_program_timestamp\": \"1234567890\",:^ - - \"window_length\": \"3\", - \"benefitTiers\": [ + \"endOfProgramTimestamp\": \"1234567890\",:^ + \"windowLength\": \"3\",^ + \"benefitTiers\": [^ { - \"minimumRunningNotionalTakerVolume\": \"10100\",^ - \"volumeDiscountFactor\": \"0.001\"^ + \"minimumEpochs\": \"1\"^ + \"minimumRunningNotionalTakerVolume\": \"11\",^ + \"volumeDiscountFactor\":^ + \"volumeDiscountFactors\":^ + \"infrastructureDiscountFactor\": \"0.02\",^ + \"liquidityDiscountFactor\": \"0.021\",^ + \"makerDiscountFactor\": \"0.022\",^ }, { - \"minimumRunningNotionalTakerVolume\": \"11000\",^ - \"volumeDiscountFactor\": \"0.098\"^ - } - ], - } - }, + \"minimumEpochs\": \"1\"^ + \"minimumRunningNotionalTakerVolume\": \"1000\",^ + \"volumeDiscountFactor\":^ + \"volumeDiscountFactors\":^ + \"infrastructureDiscountFactor\": \"0.02\",^ + \"liquidityDiscountFactor\": \"0.021\",^ + \"makerDiscountFactor\": \"0.022\",^ + },^ + ],^ + }^ + },^ \"closingTimestamp\": \"1111111111\",^ - \"enactmentTimestamp\": \"1111111155\" + \"enactmentTimestamp\": \"1111111155\"^ }^ }^ }'^