sns-wasm 0.1.1

Client-side SDK for interacting with Solana Name Service Program.
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

//! Build instruction for registering new SNS record.

pub mod domain;
pub mod subdomain;

use solana_instruction::{AccountMeta, Instruction};
use solana_program_error::ProgramError;
use solana_pubkey::Pubkey;
use solana_rent::Rent;

use crate::{
    SNS_PROGRAM_ID, SNSNode, constants::SNS_RECORD_HEADER_BYTE_LEN,
    instruction_builder::NameRegistryInstruction, name_record::SNSNodeWithOwner,
};

/// Builds instruction to include in transaction to register SNS record.
#[derive(Debug, Clone, Copy)]
pub struct CreateInstBuilder {
    payer: Pubkey,
    account: SNSNode,
    owner: Option<Pubkey>,
    class: Option<Pubkey>,
    parent: SNSNodeWithOwner,
    space: Option<u32>,
}

impl CreateInstBuilder {
    /// Builds SNS Program CREATE instruction.
    pub fn build(self) -> Result<Instruction, ProgramError> {
        let Self {
            payer,
            account: SNSNode { pda, hashed_name },
            owner,
            class,
            parent: SNSNodeWithOwner { pda: parent, owner: parent_owner },
            space,
        } = self;

        let owner = owner.unwrap_or(payer);
        let hashed_name = hashed_name.to_bytes().to_vec();
        let space = space.unwrap_or_default();
        let lamports = calculate_rent_exemption(space);

        let inst = NameRegistryInstruction::Create { hashed_name, lamports, space };

        // instruction to register new sns node
        create(SNS_PROGRAM_ID, inst, pda, payer, owner, class, Some(parent), Some(parent_owner))
    }
}

/// Returns rent exemption in lamports for [`SNS_RECORD_HEADER_BYTE_LEN`] + given space in bytes.
pub fn calculate_rent_exemption(bytes: u32) -> u64 {
    Rent::default().minimum_balance((bytes as usize).saturating_add(SNS_RECORD_HEADER_BYTE_LEN))
}

/// Code ported from archived <https://github.com/solana-labs/solana-program-library>
#[allow(clippy::too_many_arguments)]
pub fn create(
    name_service_program_id: Pubkey,
    instruction_data: NameRegistryInstruction,
    name_account_key: Pubkey,
    payer_key: Pubkey,
    name_owner: Pubkey,
    name_class_opt: Option<Pubkey>,
    name_parent_opt: Option<Pubkey>,
    name_parent_owner_opt: Option<Pubkey>,
) -> Result<Instruction, ProgramError> {
    let data: Vec<u8> = bincode::serialize(&instruction_data).unwrap();
    let mut accounts = vec![
        AccountMeta::new_readonly(Pubkey::default(), false), // system program aka null address
        AccountMeta::new(payer_key, true),
        AccountMeta::new(name_account_key, false),
        AccountMeta::new_readonly(name_owner, false),
    ];
    if let Some(name_class) = name_class_opt {
        accounts.push(AccountMeta::new_readonly(name_class, true));
    } else {
        accounts.push(AccountMeta::new_readonly(Pubkey::default(), false));
    }
    if let Some(name_parent) = name_parent_opt {
        accounts.push(AccountMeta::new_readonly(name_parent, false));
    } else {
        accounts.push(AccountMeta::new_readonly(Pubkey::default(), false));
    }
    if let Some(key) = name_parent_owner_opt {
        accounts.push(AccountMeta::new_readonly(key, true));
    }

    Ok(Instruction { program_id: name_service_program_id, accounts, data })
}