Skip to main content
Version: 3.0

Messages

InstantiateMsg

{
// Account which can update config
"owner": "neutron...",
// Account which can update token addresses and generator
"token_info_manager": "neutron...",
// Credits contract address
"credits_contract": "neutron...",
// Auction contract address
"auction_contract": "neutron...",
// Timestamp when Contract will start accepting LP Token deposits
"init_timestamp": 1234567890,
// Number of seconds during which lockup deposits will be accepted
"lock_window": 10000,
// Withdrawal Window Length :: Post the deposit window
"withdrawal_window": 1000,
// Min. no. of weeks allowed for lockup
"min_lock_duration": 1000,
// Max. no. of weeks allowed for lockup
"max_lock_duration": 1000,
// Max lockup positions a user can have
"max_positions_per_user": 100,
// Describes rewards coefficients for each lockup duration
"lockup_rewards_info": [
{
"duration": 10000,
"coefficient": "0.5"
},
{
"duration": 20000,
"coefficient": "1"
}
]
}

ExecuteMsg

receive

CW20 receive msg.

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

initialize_pool

{
"initialize_pool": {
// pool type: "usdc" or "atom"
"pool_type": "usdc",
// incentives for this concrete pool
"incentives_share": "10000"
}
}

Initializes necessary structs and info for a specific LP pool in the Lockdrop contract. Can be called only by the Auction contract. Execute this message by calling the LP token contract address of the corresponding pool.

increase_lockup_for

{
"increase_lockup_for": {
"user_address": "neutron...",
"pool_type": "usdc",
"amount": "10000",
"duration": 100
}
}

Facilitates opening a new user position or adding to an existing position.

increase_ntrn_incentives

{
"increase_ntrn_incentives": {}
}

Admin function to increase the NTRN incentives that are to be distributed.

update_config

{
"update_config": {
// Bootstrap Auction contract address
"auction_contract_address": "neutron....",
// Generator (Staking for dual rewards) contract address
"generator_address": "neutron...",
}
}

Can only be called by the admin. Facilitates updating configuration parameters.

set_token_info

{
"set_token_info": {
// Address of LP token of ATOM/NTRN pool
"atom_token": "neutron...",
// Address of LP token of USDC/NTRN pool
"usdc_token": "neutron...",
// Address of generator contract
"generator": "neutron..."
}
}

Sets info about ATOM/NTRN, USDC/NTRN LP tokens and a Generator contract.

withdraw_from_lockup

{
"withdraw_from_lockup": {
"user_address": "neutron...",
"pool_type": "usdc",
"duration": 111,
"amount": "1000"
}
}

Facilitates LP token withdrawals from lockup positions by users. 100% amount can be withdrawn during deposit window, which is then limited to 50% during 1st half of deposit window which then decreases linearly during 2nd half of deposit window. Only 1 withdrawal can be made by a user during the withdrawal windows.

claim_rewards_and_optionally_unlock

{
"claim_rewards_and_optionally_unlock": {
"pool_type": "usdc",
"duration": 100,
"withdraw_lp_stake": true
}
}

Facilitates rewards claim by users for a particular lockup position along with unlock when possible.

propose_new_owner

{ "propose_new_owner": {
// Newly proposed contract owner
"owner": "neutron...",
// The date after which this proposal expires
"expires_in": 1111
}
}

Admin function. Creates an offer to change the contract ownership. The validity period of the offer is set in the expires_in variable. After expires_in seconds pass, the proposal expires and cannot be accepted anymore.

drop_ownership_proposal

{
"drop_ownership_proposal": {}
}

Admin function. Removes an existing offer to change the contract owner.

claim_ownership

{
"claim_ownership": {}
}

Admin function. Used to claim contract ownership.

callback

update_pool_on_dual_rewards_claim

{
"update_pool_on_dual_rewards_claim":
{
"pool_type": "usdc",
"prev_ntrn_balance": "1000",
"prev_proxy_reward_balances": []
}
}

Callback function to update contract state after pending dual staking rewards are claimed from the generator contract.

withdraw_user_lockup_rewards_callback

{
"withdraw_user_lockup_rewards_callback": {
"pool_type": "usdc",
"user_address": "neutron...",
"duration": 100,
"withdraw_lp_stake": true
}
}

Callback function to withdraw user rewards for a particular lockup position along with optional LP tokens withdrawal (upon lockup duration expiration).