Ohjelmien kehittäminen Rustilla

Ensin, luo uusi Rust-projekti käyttäen standardia cargo new komentoa --lib lipulla.

$ 
cargo new hello_world --libCopy

Siirry projektin hakemistoon. Sinun pitäisi nähdä oletusarvoiset src/lib.rs ja Cargo.toml tiedostot

$ 
cd hello_worldCopy

Seuraavaksi lisää solana-program riippuvuus. Tämä on vähimmäisriippuvuus, joka vaaditaan Solana-ohjelman rakentamiseen.

$ 
cargo add solana-program@2.2.0Copy

Seuraavaksi lisää alla oleva koodi tiedostoon Cargo.toml.

[lib]
crate-type = ["cdylib", "lib"]

Sinun Cargo.toml tiedoston pitäisi näyttää seuraavalta:

[package]
name = "hello_world"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib", "lib"]

[dependencies]
solana-program = "2.2.0"

Seuraavaksi korvaa tiedoston src/lib.rs sisältö seuraavalla koodilla. Tämä on minimaalinen Solana-ohjelma, joka tulostaa "Hello, world!" ohjelman lokiin, kun ohjelma suoritetaan.

msg! makroa käytetään Solana-ohjelmissa viestin tulostamiseen ohjelman lokiin.

use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,
};

entrypoint!(process_instruction);

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
    msg!("Hello, world!");
    Ok(())
}

Seuraavaksi rakenna ohjelma käyttäen cargo build-sbf komentoa.

$ 
cargo build-sbfCopy

Tämä komento luo target/deploy hakemiston, joka sisältää kaksi tärkeää tiedostoa:

1. .so tiedosto (esim. hello_world.so): Tämä on käännetty Solana-ohjelma, joka tullaan ottamaan käyttöön verkossa "älysopimuksena".
2. Keypair-tiedosto (esim. hello_world-keypair.json): Tämän keypair:in julkista avainta käytetään ohjelmatunnuksena (program ID) ohjelmaa käyttöönotettaessa.

Nähdäksesi ohjelmatunnuksen, suorita seuraava komento päätteessäsi. Tämä komento tulostaa määritetyssä tiedostopolussa olevan keypair:in julkisen avaimen:

$ 
solana address -k ./target/deploy/hello_world-keypair.jsonCopy

Esimerkki tulostuksesta:

Tämä on yksinkertainen "Hello, world!" -ohjelma Solana-lohkoketjulle. Ohjelma kirjoittaa viestin "Hello, world!" ohjelman lokiin, kun se suoritetaan.

Tässä on ohjelman koodi:

Tämä ohjelma ottaa vastaan yhden tilin, joka on ohjelman kutsuja. Kun ohjelma suoritetaan, se kirjoittaa viestin "Hello, world!" ohjelman lokiin.

Seuraavaksi, testaa ohjelma käyttäen litesvm -pakettia. Lisää seuraavat riippuvuudet tiedostoon Cargo.toml.

Tämä lisää tarvittavat riippuvuudet ohjelman testaamiseen.

Tämä määrittää testiriippuvuudet, jotka tarvitaan Solana-ohjelman testaamiseen.

Lisää seuraava testi tiedostoon src/lib.rs, ohjelmakoodin alapuolelle. Tämä on testi moduuli, joka kutsuu hello world -ohjelmaa.

Tämä testi luo uuden testiympäristön, kutsuu hello world -ohjelmaa ja tarkistaa, että ohjelma suoritetaan onnistuneesti.

Suorita testi käyttäen cargo test -komentoa. Ohjelman lokissa näkyy "Hello, world!".

$ 
cargo test -- --no-captureCopy

Esimerkki tulostuksesta:

Testi suoritetaan onnistuneesti ja ohjelman lokissa näkyy "Hello, world!".

Seuraavaksi, ota ohjelma käyttöön. Kun kehitämme paikallisesti, voimme käyttää solana-test-validator.

Ensin, määritä Solana CLI käyttämään paikallista Solana-klusteria.

$ 
solana config set -ulCopy

Esimerkki tulostuksesta:

Solana CLI on nyt määritetty käyttämään paikallista Solana-klusteria.

Avaa uusi terminaali ja suorita solana-test-validators -komento käynnistääksesi paikallisen validaattorin.

$ 
solana-test-validatorCopy

Kun testivalidaattori on käynnissä, suorita solana program deploy -komento erillisessä terminaalissa ottaaksesi ohjelman käyttöön paikallisessa validaattorissa.

$ 
solana program deploy ./target/deploy/hello_world.soCopy

Esimerkki tulostuksesta:

Program Id: 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz
Signature:
5osMiNMiDZGM7L1e2tPHxU8wdB8gwG8fDnXLg5G7SbhwFz4dHshYgAijk4wSQL5cXiu8z1MMou5kLadAQuHp7ybH

Voit tarkastella ohjelmatunnusta ja tapahtuman allekirjoitusta Solana Explorerissa.

Seuraavaksi näytämme, miten ohjelmaa kutsutaan Rust-asiakkaalla.

Luo ensin examples hakemisto ja client.rs tiedosto.

$ 
mkdir -p examples && touch examples/client.rsCopy

Lisää seuraava sisältö tiedostoon Cargo.toml.

[[example]]
name = "client"
path = "examples/client.rs"

Lisää solana-client ja tokio riippuvuudet.

$ 
cargo add solana-client@2.2.0 --dev
Copy
$ 
cargo add tokio --devCopy

Lisää seuraava koodi tiedostoon examples/client.rs. Tämä on Rust-asiakaskoodi, joka rahoittaa uuden keypair-avaimen tapahtumamaksujen maksamiseksi ja kutsuu sitten hello world -ohjelmaa.

use solana_client::rpc_client::RpcClient;
use solana_sdk::{
    commitment_config::CommitmentConfig,
    instruction::Instruction,
    pubkey::Pubkey,
    signature::{Keypair, Signer},
    transaction::Transaction,
};
use std::str::FromStr;

#[tokio::main]
async fn main() {
    // Program ID (replace with your actual program ID)
    let program_id = Pubkey::from_str("4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz").unwrap();

    // Connect to the Solana devnet
    let rpc_url = String::from("http://localhost:8899");
    let client = RpcClient::new_with_commitment(rpc_url, CommitmentConfig::confirmed());

    // Generate a new keypair for the payer
    let payer = Keypair::new();

    // Request airdrop
    let airdrop_amount = 1_000_000_000; // 1 SOL
    let signature = client
        .request_airdrop(&payer.pubkey(), airdrop_amount)
        .expect("Failed to request airdrop");

    // Wait for airdrop confirmation
    loop {
        let confirmed = client.confirm_transaction(&signature).unwrap();
        if confirmed {
            break;
        }
    }

    // Create the instruction
    let instruction = Instruction::new_with_borsh(
        program_id,
        &(),    // Empty instruction data
        vec![], // No accounts needed
    );

    // Add the instruction to new transaction
    let mut transaction = Transaction::new_with_payer(&[instruction], Some(&payer.pubkey()));
    transaction.sign(&[&payer], client.get_latest_blockhash().unwrap());

    // Send and confirm the transaction
    match client.send_and_confirm_transaction(&transaction) {
        Ok(signature) => println!("Transaction Signature: {}", signature),
        Err(err) => eprintln!("Error sending transaction: {}", err),
    }
}

Ennen asiakaskoodin suorittamista korvaa koodinpätkässä oleva ohjelmatunnus ohjelmasi tunnuksella.

Saat ohjelmatunnuksesi suorittamalla seuraavan komennon.

$ 
solana address -k ./target/deploy/hello_world-keypair.jsonCopy

Suorita asiakaskoodi seuraavalla komennolla.

$ 
cargo run --example clientCopy

Esimerkki tulostuksesta:

Transaction Signature: 54TWxKi3Jsi3UTeZbhLGUFX6JQH7TspRJjRRFZ8NFnwG5BXM9udxiX77bAACjKAS9fGnVeEazrXL4SfKrW7xZFYV

Voit tarkastella transaktiosignatuuria Solana Explorerissa (paikallinen klusteri) nähdäksesi "Hello, world!" ohjelman lokissa.

Solana-ohjelmia voidaan päivittää ottamalla ne uudelleen käyttöön samalla ohjelmatunnuksella. Päivitä ohjelma tiedostossa src/lib.rs tulostamaan "Hello, Solana!" "Hello, world!" sijaan.

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
-
    msg!("Hello, world!");
+
    msg!("Hello, Solana!");
    Ok(())
}

Suorita komento cargo build-sbf luodaksesi päivitetyn .so tiedoston.

$ 
cargo build-sbfCopy

Testaa päivitettyä ohjelmaa suorittamalla komento cargo test.

$ 
cargo test -- --no-captureCopy

Ohjelman lokissa pitäisi näkyä "Hello, Solana!".

running 1 test
Logs: [
    "Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV invoke [1]",
    "Program log: Hello, Solana!",
    "Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV consumed 211 of 200000 compute units",
    "Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV success",
]
test test::test_hello_world ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.08s

Ota ohjelma uudelleen käyttöön samalla solana program deploy komennolla.

$ 
solana program deploy ./target/deploy/hello_world.soCopy

Suorita asiakaskoodi uudelleen ja tarkastele transaktiosignatuuria Solana Explorerissa nähdäksesi "Hello, Solana!" ohjelman lokissa.

$ 
cargo run --example clientCopy

Voit sulkea Solana-ohjelmasi saadaksesi takaisin tilille allokoidun SOL:n. Ohjelman sulkeminen on peruuttamatonta, joten se tulisi tehdä varoen.

Sulkeaksesi ohjelman käytä komentoa solana program close <PROGRAM_ID>. Esimerkiksi:

$ 
solana program close 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz --bypass-warningCopy

Esimerkki tulostuksesta:

Closed Program Id 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz, 0.1350588 SOL
reclaimed

Huomaa, että kun ohjelma on suljettu, sen ohjelmatunnusta ei voi käyttää uudelleen. Yritys käyttöönottaa ohjelma aiemmin suljetulla ohjelmatunnuksella johtaa virheeseen.

Error: Program 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz has been closed, use
a new Program Id

Jos haluat ottaa uudelleen käyttöön ohjelman samalla lähdekoodilla sulkemisen jälkeen, sinun on luotava uusi ohjelmatunnus. Luodaksesi uuden keypair-parin ohjelmalle, suorita seuraava komento:

$ 
solana-keygen new -o ./target/deploy/hello_world-keypair.json --forceCopy