Program Derived Address

In diesem Abschnitt lernen Sie, wie Sie ein grundlegendes Create, Read, Update, Delete (CRUD)-Programm erstellen.

Diese Anleitung demonstriert ein einfaches Programm, bei dem Benutzer eine Nachricht erstellen, aktualisieren und löschen können. Jede Nachricht existiert in einem Konto mit einer deterministischen Adresse, die vom Programm selbst abgeleitet wird (Program Derived Address oder PDA).

Diese Anleitung führt Sie durch die Erstellung und das Testen eines Solana-Programms mit dem Anchor-Framework und demonstriert dabei Program Derived Addresses (PDAs). Weitere Details finden Sie auf der Seite Program Derived Addresses.

Als Referenz können Sie den endgültigen Code nach Abschluss beider Abschnitte zu PDA und Cross-Program Invocation (CPI) einsehen.

Starter-Code

Beginnen Sie, indem Sie diesen Solana Playground-Link mit dem Starter-Code öffnen. Klicken Sie dann auf die Schaltfläche "Import", um das Programm zu Ihren Solana Playground-Projekten hinzuzufügen.

Import Import

In der lib.rs Datei finden Sie ein Programm mit den create, update und delete Anweisungen, die in den folgenden Schritten hinzugefügt werden sollen.

lib.rs

use anchor_lang::prelude::*;

declare_id!("8KPzbM2Cwn4Yjak7QYAEH9wyoQh86NcBicaLuzPaejdw");

#[program]
pub mod pda {
    use super::*;

    pub fn create(_ctx: Context<Create>) -> Result<()> {
        Ok(())
    }

    pub fn update(_ctx: Context<Update>) -> Result<()> {
        Ok(())
    }

    pub fn delete(_ctx: Context<Delete>) -> Result<()> {
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Create {}

#[derive(Accounts)]
pub struct Update {}

#[derive(Accounts)]
pub struct Delete {}

#[account]
pub struct MessageAccount {}

Führen Sie vor Beginn build im Playground-Terminal aus, um zu überprüfen, ob das Starter-Programm erfolgreich erstellt wird.

Terminal

$ build

Nachrichtenkonto-Typ definieren

Definieren Sie zunächst die Struktur für das Nachrichtenkonto, das das Programm erstellt. Diese Struktur definiert die Daten, die in dem vom Programm erstellten Konto gespeichert werden sollen.

In lib.rs, aktualisiere die MessageAccount Struktur mit folgendem:

lib.rs

#[account]
pub struct MessageAccount {
    pub user: Pubkey,
    pub message: String,
    pub bump: u8,
}

Baue das Programm erneut, indem du build im Terminal ausführst.

Terminal

$ build

Dieser Code definiert, welche Daten im Nachrichtenkonto gespeichert werden sollen. Als nächstes fügst du die Programmanweisungen hinzu.

Erstellen-Anweisung hinzufügen

Füge nun die create Anweisung hinzu, die das MessageAccount erstellt und initialisiert.

Beginne damit, die für die Anweisung erforderlichen Konten zu definieren, indem du die Create Struktur mit folgendem aktualisierst:

lib.rs

#[derive(Accounts)]
#[instruction(message: String)]
pub struct Create<'info> {
    #[account(mut)]
    pub user: Signer<'info>,

    #[account(
        init,
        seeds = [b"message", user.key().as_ref()],
        bump,
        payer = user,
        space = 8 + 32 + 4 + message.len() + 1
    )]
    pub message_account: Account<'info, MessageAccount>,
    pub system_program: Program<'info, System>,
}

Als Nächstes fügen Sie die Geschäftslogik für die create Anweisung hinzu, indem Sie die create Funktion mit Folgendem aktualisieren:

lib.rs

pub fn create(ctx: Context<Create>, message: String) -> Result<()> {
    msg!("Create Message: {}", message);
    let account_data = &mut ctx.accounts.message_account;
    account_data.user = ctx.accounts.user.key();
    account_data.message = message;
    account_data.bump = ctx.bumps.message_account;
    Ok(())
}

Baue das Programm neu.

Terminal

$ build

Anweisung zum Aktualisieren hinzufügen

Als Nächstes füge die Anweisung update hinzu, um die MessageAccount mit einer neuen Nachricht zu ändern.

Wie im vorherigen Schritt, gib zuerst die Konten an, die von der Anweisung update benötigt werden.

Aktualisiere die Struktur Update mit Folgendem:

lib.rs

#[derive(Accounts)]
#[instruction(message: String)]
pub struct Update<'info> {
    #[account(mut)]
    pub user: Signer<'info>,

    #[account(
        mut,
        seeds = [b"message", user.key().as_ref()],
        bump = message_account.bump,
        realloc = 8 + 32 + 4 + message.len() + 1,
        realloc::payer = user,
        realloc::zero = true,
    )]
    pub message_account: Account<'info, MessageAccount>,
    pub system_program: Program<'info, System>,
}

Als Nächstes füge die Logik für die update Anweisung hinzu.

lib.rs

pub fn update(ctx: Context<Update>, message: String) -> Result<()> {
    msg!("Update Message: {}", message);
    let account_data = &mut ctx.accounts.message_account;
    account_data.message = message;
    Ok(())
}

Baue das Programm neu

Terminal

$ build

Löschanweisung hinzufügen

Als Nächstes füge die delete Anweisung hinzu, um das MessageAccount zu schließen.

Aktualisiere die Delete Struktur mit Folgendem:

lib.rs

#[derive(Accounts)]
pub struct Delete<'info> {
    #[account(mut)]
    pub user: Signer<'info>,

    #[account(
        mut,
        seeds = [b"message", user.key().as_ref()],
        bump = message_account.bump,
        close = user,
    )]
    pub message_account: Account<'info, MessageAccount>,
}

Als nächstes füge die Logik für die delete Anweisung hinzu.

lib.rs

pub fn delete(_ctx: Context<Delete>) -> Result<()> {
    msg!("Delete Message");
    Ok(())
}

Baue das Programm neu.

Terminal

$ build

Deployment des Programms

Du hast jetzt das grundlegende CRUD-Programm fertiggestellt. Deploye das Programm, indem du deploy im Playground-Terminal ausführst.

In diesem Beispiel wirst du das Programm auf dem Devnet deployen, einem Solana-Cluster für Entwicklungstests.

Das Playground-Wallet verbindet sich standardmäßig mit dem Devnet. Stelle sicher, dass dein Playground- Wallet über Devnet SOL verfügt, um für das Deployment des Programms zu bezahlen. Hol dir Devnet SOL vom Solana Faucet.

Terminal

$ deploy

Testdatei einrichten

Der Starter-Code enthält auch eine Testdatei in anchor.test.ts.

anchor.test.ts

import { PublicKey } from "@solana/web3.js";

describe("pda", () => {
  it("Create Message Account", async () => {});

  it("Update Message Account", async () => {});

  it("Delete Message Account", async () => {});
});

Füge den Code unten innerhalb von describe() ein, aber vor den it() Abschnitten.

anchor.test.ts

const program = pg.program;
const wallet = pg.wallet;

const [messagePda, messageBump] = PublicKey.findProgramAddressSync(
  [Buffer.from("message"), wallet.publicKey.toBuffer()],
  program.programId
);

Führe die Testdatei aus, indem du test im Playground-Terminal ausführst, um zu überprüfen, dass sie wie erwartet läuft. Die nächsten Schritte fügen die eigentlichen Tests hinzu.

Terminal

$ test

Create-Anweisung aufrufen

Aktualisiere den ersten Test mit Folgendem:

anchor.test.ts

it("Create Message Account", async () => {
  const message = "Hello, World!";
  const transactionSignature = await program.methods
    .create(message)
    .accounts({
      messageAccount: messagePda
    })
    .rpc({ commitment: "confirmed" });

  const messageAccount = await program.account.messageAccount.fetch(
    messagePda,
    "confirmed"
  );

  console.log(JSON.stringify(messageAccount, null, 2));
  console.log(
    "Transaction Signature:",
    `https://solana.fm/tx/${transactionSignature}?cluster=devnet-solana`
  );
});

Update-Anweisung aufrufen

Aktualisiere den zweiten Test mit folgendem:

anchor.test.ts

it("Update Message Account", async () => {
  const message = "Hello, Solana!";
  const transactionSignature = await program.methods
    .update(message)
    .accounts({
      messageAccount: messagePda
    })
    .rpc({ commitment: "confirmed" });

  const messageAccount = await program.account.messageAccount.fetch(
    messagePda,
    "confirmed"
  );

  console.log(JSON.stringify(messageAccount, null, 2));
  console.log(
    "Transaction Signature:",
    `https://solana.fm/tx/${transactionSignature}?cluster=devnet-solana`
  );
});

Delete-Anweisung aufrufen

Aktualisieren Sie den dritten Test mit Folgendem:

anchor.test.ts

it("Delete Message Account", async () => {
  const transactionSignature = await program.methods
    .delete()
    .accounts({
      messageAccount: messagePda
    })
    .rpc({ commitment: "confirmed" });

  const messageAccount = await program.account.messageAccount.fetchNullable(
    messagePda,
    "confirmed"
  );

  console.log("Expect Null:", JSON.stringify(messageAccount, null, 2));
  console.log(
    "Transaction Signature:",
    `https://solana.fm/tx/${transactionSignature}?cluster=devnet-solana`
  );
});

Test ausführen

Nachdem Sie Ihre Tests vorbereitet haben, führen Sie die Testdatei mit test im Playground-Terminal aus. Dieser Befehl führt die Tests gegen das auf dem Devnet bereitgestellte Programm aus und protokolliert Links zu SolanaFM, um die Transaktionsdetails anzuzeigen.

Terminal

$ test

Überprüfen Sie die SolanaFM-Links, um die Transaktionsdetails anzusehen.

Beachten Sie, dass in diesem Beispiel, wenn Sie den Test erneut ausführen, die create Anweisung fehlschlägt, weil messageAccount bereits als Konto existiert. Für eine bestimmte PDA kann nur ein Konto existieren.

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Diff

Explanation

Inhaltsverzeichnis