#vesting #amount #tokens #time #astroport #address #astro

astroport-vesting

Astroport Vesting Contract holds tokens and releases them to the beneficiary over time

2 stable releases

1.3.2 Mar 26, 2024
1.3.1 Jul 20, 2023

#5 in #vesting

Download history 55/week @ 2024-01-08 88/week @ 2024-01-15 114/week @ 2024-01-22 283/week @ 2024-01-29 172/week @ 2024-02-05 408/week @ 2024-02-12 130/week @ 2024-02-19 106/week @ 2024-02-26 191/week @ 2024-03-04 109/week @ 2024-03-11 66/week @ 2024-03-18 234/week @ 2024-03-25 127/week @ 2024-04-01 125/week @ 2024-04-08 99/week @ 2024-04-15

593 downloads per month
Used in 4 crates (via cw-it)

GPL-3.0-only

230KB
5K SLoC

Astroport Generator Vesting

The Generator Vesting contract progressively unlocks ASTRO that can then be distributed to LP stakers via the Generator contract.


InstantiateMsg

Initializes the contract with the address of the ASTRO token.

{
  "token_addr": "terra..."
}

receive

CW20 receive msg.

{
  "receive": {
    "sender": "terra...",
    "amount": "123",
    "msg": "<base64_encoded_json_string>"
  }
}

RegisterVestingAccounts

Creates vesting schedules for the ASTRO token. Each vesting token should have the Generator contract address as the VestingContractAddress. Also, each schedule will unlock tokens at a different rate according to its time duration.

Execute this message by calling the ASTRO token contract address.

{
  "send": {
    "contract": <VestingContractAddress>,
    "amount": "999",
    "msg": "base64-encodedStringOfWithdrawMsg"
  }
}

In send.msg, you may encode this JSON string into base64 encoding.

{
  "RegisterVestingAccounts": {
    "vesting_accounts": [
      {
        "address": "terra...",
        "schedules": {
          "start_point": {
            "time": "1634125119000000000",
            "amount": "123"
          },
          "end_point": {
            "time": "1664125119000000000",
            "amount": "123"
          }
        }
      }
    ]
  }
}

claim

Transfer vested tokens from all vesting schedules that have the same VestingContractAddress (address that's vesting tokens).

{
  "claim": {
    "recipient": "terra...",
    "amount": "123"
  }
}

withdraw_from_active_schedule

Withdraw tokens from active vesting schedule.
Withdraw is possible if there is only one active vesting schedule. Active schedule's remaining amount must be greater than withdraw amount. This endpoint terminates current active schedule (updates end_point) and creates a new one with remaining amount minus withdrawn amount.

{
  "withdraw_from_active_schedule": {
    "account": "terra...",
    "recipient": "terra...",
    "withdraw_amount": "123"
  }
}

QueryMsg

All query messages are described below. A custom struct is defined for each query response.

config

Returns the vesting token contract address (the ASTRO token address).

{
  "config": {}
}

vesting_account

Returns all vesting schedules with their details for a specific vesting recipient.

{
  "vesting_account": {
    "address": "terra..."
  }
}

vesting_accounts

Returns a paginated list of vesting schedules in chronological order. Given fields are optional.

{
  "vesting_accounts": {
    "start_after": "terra...",
    "limit": 10,
    "order_by": {
      "desc": {}
    }
  }
}

available amount

Returns the claimable amount (vested but not yet claimed) of ASTRO tokens that a vesting target can claim.

{
  "available_amount": {
    "address": "terra..."
  }
}

Dependencies

~4.5–6MB
~133K SLoC