txline 0.3.0

Devnet-only Rust SDK for TxLINE.
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

//! Devnet faucet instruction builder.

use solana_sdk::instruction::{AccountMeta, Instruction};
use solana_sdk::pubkey::Pubkey;

use super::pda::{
    ASSOCIATED_TOKEN_PROGRAM_ID, DevnetPdas, LEGACY_TOKEN_PROGRAM_ID, SYSTEM_PROGRAM_ID,
    parse_pubkey,
};
use crate::Result;

pub const REQUEST_DEVNET_FAUCET_DISCRIMINATOR: [u8; 8] = [49, 178, 104, 8, 23, 120, 186, 21];

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct RequestDevnetFaucetAccounts {
    pub user: Pubkey,
    pub faucet_tracker: Pubkey,
    pub usdt_mint: Pubkey,
    pub user_usdt_ata: Pubkey,
    pub usdt_treasury_pda: Pubkey,
    pub token_program: Pubkey,
    pub associated_token_program: Pubkey,
    pub system_program: Pubkey,
}

pub fn devnet_request_faucet_accounts(
    user: Pubkey,
    faucet_tracker: Pubkey,
) -> Result<RequestDevnetFaucetAccounts> {
    let pdas = DevnetPdas::new()?;
    Ok(RequestDevnetFaucetAccounts {
        user,
        faucet_tracker,
        usdt_mint: pdas.usdt_mint,
        user_usdt_ata: pdas.user_usdt_ata(&user)?.address,
        usdt_treasury_pda: pdas.usdt_treasury().address,
        token_program: parse_pubkey(LEGACY_TOKEN_PROGRAM_ID)?,
        associated_token_program: parse_pubkey(ASSOCIATED_TOKEN_PROGRAM_ID)?,
        system_program: parse_pubkey(SYSTEM_PROGRAM_ID)?,
    })
}

pub fn request_devnet_faucet_instruction(
    program_id: Pubkey,
    accounts: RequestDevnetFaucetAccounts,
) -> Instruction {
    Instruction {
        program_id,
        accounts: vec![
            AccountMeta::new(accounts.user, true),
            AccountMeta::new(accounts.faucet_tracker, false),
            AccountMeta::new(accounts.usdt_mint, false),
            AccountMeta::new(accounts.user_usdt_ata, false),
            AccountMeta::new_readonly(accounts.usdt_treasury_pda, false),
            AccountMeta::new_readonly(accounts.token_program, false),
            AccountMeta::new_readonly(accounts.associated_token_program, false),
            AccountMeta::new_readonly(accounts.system_program, false),
        ],
        data: REQUEST_DEVNET_FAUCET_DISCRIMINATOR.to_vec(),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn faucet_instruction_uses_devnet_discriminator() {
        let program_id = Pubkey::new_unique();
        let user = Pubkey::new_unique();
        let tracker = Pubkey::new_unique();
        let accounts = devnet_request_faucet_accounts(user, tracker).unwrap();
        let instruction = request_devnet_faucet_instruction(program_id, accounts);

        assert_eq!(instruction.program_id, program_id);
        assert_eq!(instruction.data, REQUEST_DEVNET_FAUCET_DISCRIMINATOR);
        assert_eq!(instruction.accounts[0], AccountMeta::new(user, true));
        assert_eq!(instruction.accounts[1], AccountMeta::new(tracker, false));
    }
}