Guide to asset proposals

Propose a new or make changes to a ERC-20 asset to be used as collateral.

Get started:

Title

VAP-[Number] - [Create/Update] Asset - [Asset Name]

This same title should be used in the formal on-chain proposal

Summary

Provide a basic summary of your proposal

Rationale

Provide a full justification for why you think this asset would be useful on the Vega network. This will be submitted on-chain so ideally also include rationale for why the values provided in the details section have been chosen.

(Note: Both Summary & Rationale should be submitted in fully formatted markdown in the “Description” section of the “Rationale” in the JSON proposal.)

New Asset/Update Details:

  • Asset symbol
  • Decimals
  • Quantum
  • ERC20 contract address
  • Withdrawal delay threshold
  • Lifetime deposit limit

Full Proposal JSON:

type or paste code here

See the tutorials for full details on the meaning of all data attributes and example JSON

--------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------FULL FORUM POST EXAMPLE------------------------------------------------
--------------------------------------------------------------------------------------------------------------------------------------

Title

VAP-[000] - Create Asset - TestAsset ($TESTA)

Summary

Propose to create the settlement asset TestAsset ($TESTA) on the Vega network.

Rationale

  • TestAsset ($TESTA) is a widely used test asset which will be very useful to others on the Vega network.
  • The Name, Symbol & Decimals are all driven by the values of the ERC20 contract so will not be discussed here.
  • The value of 5 for Quantum is taken because at the time of proposal 1 $TESTA is worth approx 20c so the amount approximately equal to 1 USD is 5.
  • The withdrawal delay threshold is set to the 1, the lowest value possible so that all withdrawals will be subject to the withdrawal delay.
  • The lifetime limit is set to 2.5E+22 because this is 25,000 in human readable format, which is roughly equivalent to $5,000 USD.

New Asset/Update Details:

  • Name = TestAsset
  • Asset symbol = TESTA
  • Decimals = 18
  • Quantum = 5
  • ERC20 contract address = 0xaDD385b5127135bzc2309Cj370FBd08107d59849
  • Withdrawal delay threshold = 1
  • Lifetime deposit limit = 2.5E+22

Full Proposal JSON:

{
    "rationale": {
        "title": "VAP-[000] - Create Asset - TestAsset ($TESTA)",
        "description": "Summary\n\nPropose to create the settlement asset TestAsset ($TESTA) on the Vega network.\n\nRationale\n\n- TestAsset ($TESTA) is a widely used test asset which will be very useful to others on the Vega network.\n- The Name, Symbol & Decimals are all driven by the values of the ERC20 contract so will not be discussed here.\n- The value of 5 for Quantum is taken because at the time of proposal 1 $TESTA is worth approx 20c so the amount approximately equal to 1 USD is 5.\n- The withdrawal delay is set to the 1, the lowest value possible so that all withdrawals will be subject to the withdrawal delay.\nThe lifetime limit is set to 2.5E+22 because this is 25,000 in human readable format, which is roughly equivalent to $5,000 USD."
    },
    "terms": {
        "newAsset": {
            "changes": {
                "name": "TestAsset",
                "symbol": "TESTA",
                "decimals": "18",
                "quantum": "5",
                "erc20": {
                    "contractAddress": "0xaDD385b5127135bzc2309Cj370FBd08107d59849",
                    "withdrawThreshold": "1",
                    "lifetimeLimit": "25000000000000000000000"
                }
            }
        },
        "closingTimestamp": 1683754220,
        "enactmentTimestamp": 1683754220,
        "validationTimestamp": 1683754220
    }
}