Cross Program Invocation

Tässä osiossa edellisen PDA-osion CRUD-ohjelmaa päivitetään lisäämällä Cross Program Invocation (CPI) -kutsuja, ominaisuus joka mahdollistaa Solana-ohjelmien kutsumisen toistensa välillä.

Tämä opas näyttää myös, miten ohjelmat voivat "allekirjoittaa" Program Derived Address (PDA) -osoitteiden puolesta tehdessään Cross Program Invocation -kutsuja.

Ohjeita update ja delete täytyy muokata käsittelemään SOL-siirtoja tilien välillä kutsumalla System Program -ohjelmaa.

Tämän osion tarkoituksena on käydä läpi CPI-kutsujen toteuttamisprosessi Solana-ohjelmassa käyttäen Anchor-kehystä, rakentaen edellisessä osiossa tutkittujen PDA- konseptien päälle. Lisätietoja löytyy Cross Program Invocation -sivulta.

Viitteeksi, tämä linkki sisältää lopullisen koodin sekä PDA- että CPI-osioiden suorittamisen jälkeen.

Tämän osion aloituskoodi sisältää vain valmiiksi tehdyn PDA-osion.

Päivitä Update-ohje

Ensin ohjelmaan tarvitaan yksinkertainen "maksa päivityksestä" -mekanismi muuttamalla Update -rakennetta ja update-funktiota.

Aloita päivittämällä lib.rs-tiedosto tuodaksesi näkyvyysalueeseen kohteita system_program-moduulista.

lib.rs
use anchor_lang::system_program::{transfer, Transfer};

Seuraavaksi päivitä Update-rakenne sisältämään uusi tili nimeltä vault_account. Tämä tili, jota ohjelma hallinnoi, vastaanottaa SOL-tokeneita käyttäjältä, kun he päivittävät viestitiliään.

lib.rs
#[account(
mut,
seeds = [b"vault", user.key().as_ref()],
bump,
)]
pub vault_account: SystemAccount<'info>,

Seuraavaksi lisää CPI-logiikka update -ohjeeseen siirtääksesi 0,001 SOL käyttäjän tililtä holvitilille.

lib.rs
let transfer_accounts = Transfer {
from: ctx.accounts.user.to_account_info(),
to: ctx.accounts.vault_account.to_account_info(),
};
let cpi_context = CpiContext::new(
ctx.accounts.system_program.to_account_info(),
transfer_accounts,
);
transfer(cpi_context, 1_000_000)?;

Rakenna ohjelma uudelleen.

Terminal
$
build

Päivitä poisto-ohje

Lisää nyt "hyvitys poistettaessa" -mekanismi muuttamalla Delete -rakennetta ja delete -funktiota.

Päivitä ensin Delete -rakenne sisältämään vault_account. Tämä mahdollistaa holvissa olevan SOL:n siirtämisen takaisin käyttäjälle, kun he sulkevat viestinsä tilin.

lib.rs
#[account(
mut,
seeds = [b"vault", user.key().as_ref()],
bump,
)]
pub vault_account: SystemAccount<'info>,

Lisää myös system_program, koska siirron CPI vaatii System Program -ohjelman kutsumista.

lib.rs
pub system_program: Program<'info, System>,

Seuraavaksi lisää CPI-logiikka deleteohjeeseen siirtääksesi SOL:ia holvitilistä takaisin käyttäjän tilille.

lib.rs
let user_key = ctx.accounts.user.key();
let signer_seeds: &[&[&[u8]]] =
&[&[b"vault", user_key.as_ref(), &[ctx.bumps.vault_account]]];
let transfer_accounts = Transfer {
from: ctx.accounts.vault_account.to_account_info(),
to: ctx.accounts.user.to_account_info(),
};
let cpi_context = CpiContext::new(
ctx.accounts.system_program.to_account_info(),
transfer_accounts,
).with_signer(signer_seeds);
transfer(cpi_context, ctx.accounts.vault_account.lamports())?;

Huomaa, että _ctx: Context<Delete> muuttuu muotoon ctx: Context<Delete> käyttääkseen kontekstia funktion rungossa.

Rakenna ohjelma uudelleen.

Terminal
$
build

Ohjelman uudelleenjakelu

Tehtyäsi nämä muutokset, jaa päivitetty ohjelma uudelleen. Tämä varmistaa, että muokattu ohjelma on käytettävissä testausta varten. Solanassa ohjelman päivittäminen vaatii vain ohjelman jakamisen samalla ohjelmatunnuksella.

Varmista, että Playground-lompakossasi on devnet SOL -tokeneita. Hanki devnet SOL -tokeneita Solana Faucet -palvelusta.

Terminal
$
deploy

Testitiedoston päivittäminen

Seuraavaksi päivitä anchor.test.ts -tiedosto sisältämään uusi vault-tili ohjeissa. Tämä vaatii vault PDA:n johtamisen ja sen sisällyttämisen update- ja delete-ohjekutsuihin.

Johda holvin PDA

Ensin, lisää holvin PDA-johtaminen:

anchor.test.ts
const [vaultPda, vaultBump] = PublicKey.findProgramAddressSync(
[Buffer.from("vault"), wallet.publicKey.toBuffer()],
program.programId
);

Muuta päivitystestiä

Päivitä sitten päivitysohje sisältämään vaultAccount

anchor.test.ts
const transactionSignature = await program.methods
.update(message)
.accounts({
messageAccount: messagePda,
vaultAccount: vaultPda
})
.rpc({ commitment: "confirmed" });

Muuta poistotestiä

Päivitä sitten poisto-ohje sisältämään vaultAccount

anchor.test.ts
const transactionSignature = await program.methods
.delete()
.accounts({
messageAccount: messagePda,
vaultAccount: vaultPda
})
.rpc({ commitment: "confirmed" });

Suorita testi uudelleen

Kun olet tehnyt nämä muutokset, suorita testit varmistaaksesi, että kaikki toimii odotetusti:

Terminal
$
test

Voit sitten tarkastella SolanaFM-linkkejä nähdäksesi tapahtuman tiedot, joista löydät siirtokomentojen CPIt update- ja delete-komentojen sisällä.

Update CPIUpdate CPI

Delete CPIDelete CPI

Jos kohtaat virheitä, voit tarkistaa lopullisen koodin.

Seuraavat vaiheet

Onnittelut Solana Quickstart -oppaan suorittamisesta. Olet saanut käytännön kokemusta keskeisistä Solana-konsepteista, kuten:

  • Tietojen hakeminen ja lukeminen tileiltä
  • Tapahtumien rakentaminen ja lähettäminen
  • Solana-ohjelmien käyttöönotto ja päivittäminen
  • Program Derived Address (PDA) -osoitteiden käyttö
  • Cross-Program Invocation (CPI) -kutsujen tekeminen

Syventääksesi ymmärrystäsi näistä konsepteista, tutustu Ydinkäsitteet -dokumentaatioon, joka tarjoaa yksityiskohtaisia selityksiä tässä oppaassa käsitellyistä aiheista.

Tutustu lisäesimerkkeihin

Jos opit mieluummin esimerkkien kautta, tutustu Program Examples Repository -sivustoon, josta löydät erilaisia esimerkkiohjelmia.

Solana Playground tarjoaa kätevän ominaisuuden, jonka avulla voit tuoda tai tarkastella projekteja niiden GitHub-linkkien avulla. Esimerkiksi avaa tämä Solana Playground -linkki nähdäksesi Anchor-projektin tästä Github-reposta.

Napsauta Import -painiketta ja anna projektin nimi lisätäksesi sen Solana Playground -projektiluetteloosi. Kun projekti on tuotu, kaikki muutokset tallentuvat automaattisesti.

Is this page helpful?

Sisällysluettelo

Muokkaa sivua