kvault-interface 0.1.0

Instruction builders for Kamino Vault (kvault) — no anchor-lang dependency
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use borsh::BorshSerialize;
use solana_instruction::{AccountMeta, Instruction};
use solana_pubkey::Pubkey;

use crate::{discriminators, pda, util::*, KVAULT_PROGRAM_ID};

// ---------------------------------------------------------------------------
// Accounts shared by deposit and buy
// ---------------------------------------------------------------------------

/// Account addresses required by the `deposit` and `buy` instructions.
pub struct DepositAccounts {
    pub user: Pubkey,
    pub vault_state: Pubkey,
    pub token_vault: Pubkey,
    pub token_mint: Pubkey,
    pub base_vault_authority: Pubkey,
    pub shares_mint: Pubkey,
    pub user_token_ata: Pubkey,
    pub user_shares_ata: Pubkey,
    pub klend_program: Pubkey,
    pub token_program: Pubkey,
    pub shares_token_program: Pubkey,
}

fn build_deposit_accounts(accounts: &DepositAccounts) -> Vec<AccountMeta> {
    let (evt_auth, _) = pda::event_authority(&KVAULT_PROGRAM_ID);
    vec![
        signer_writable(accounts.user),
        writable(accounts.vault_state),
        writable(accounts.token_vault),
        readonly(accounts.token_mint),
        readonly(accounts.base_vault_authority),
        writable(accounts.shares_mint),
        writable(accounts.user_token_ata),
        writable(accounts.user_shares_ata),
        readonly(accounts.klend_program),
        readonly(accounts.token_program),
        readonly(accounts.shares_token_program),
        // event_cpi accounts
        readonly(evt_auth),
        readonly(KVAULT_PROGRAM_ID),
    ]
}

// ---------------------------------------------------------------------------
// deposit
// ---------------------------------------------------------------------------

/// Build a raw `deposit` instruction.
///
/// Transfers up to `max_amount` tokens from the user into the vault and
/// mints vault shares in return. `remaining_accounts` must contain the refresh
/// list: writable reserve metas followed by readonly lending-market metas, in
/// allocation-slot order.
pub fn deposit(
    accounts: DepositAccounts,
    max_amount: u64,
    remaining_accounts: Vec<AccountMeta>,
) -> Instruction {
    #[derive(BorshSerialize)]
    struct Args {
        max_amount: u64,
    }

    let args = Args { max_amount };
    let mut data = discriminators::DEPOSIT.to_vec();
    args.serialize(&mut data).unwrap();

    let mut account_metas = build_deposit_accounts(&accounts);
    account_metas.extend(remaining_accounts);

    Instruction {
        program_id: KVAULT_PROGRAM_ID,
        accounts: account_metas,
        data,
    }
}

// ---------------------------------------------------------------------------
// buy (same accounts and args as deposit, different discriminator)
// ---------------------------------------------------------------------------

/// Build a raw `buy` instruction.
///
/// Same accounts and semantics as [`deposit`], but uses the `buy`
/// discriminator. The amount is interpreted as the maximum tokens to spend.
pub fn buy(
    accounts: DepositAccounts,
    max_amount: u64,
    remaining_accounts: Vec<AccountMeta>,
) -> Instruction {
    #[derive(BorshSerialize)]
    struct Args {
        max_amount: u64,
    }

    let args = Args { max_amount };
    let mut data = discriminators::BUY.to_vec();
    args.serialize(&mut data).unwrap();

    let mut account_metas = build_deposit_accounts(&accounts);
    account_metas.extend(remaining_accounts);

    Instruction {
        program_id: KVAULT_PROGRAM_ID,
        accounts: account_metas,
        data,
    }
}