CPI senza firmatari PDA

Riepilogo

Usa invoke per le CPI dove tutti i firmatari richiesti hanno già firmato la transazione originale. Non è necessaria la firma PDA. I privilegi di firmatario e scrittura si estendono dal chiamante al chiamato.

CPI senza firmatari PDA

Quando una CPI non richiede firmatari PDA, viene utilizzata la funzione invoke. La funzione invoke chiama la funzione invoke_signed con un array signers_seeds vuoto. L'array di firmatari vuoto indica che non sono richiesti PDA per la firma.

Invoke function

pub fn invoke(instruction: &Instruction, account_infos: &[AccountInfo]) -> ProgramResult {
    invoke_signed(instruction, account_infos, &[])
}

Gli esempi seguenti effettuano una CPI utilizzando Anchor e Rust nativo. Include una singola istruzione che trasferisce SOL da un account a un altro.

Anchor

I seguenti esempi mostrano due approcci per implementare le CPI in un programma Anchor. Gli esempi sono funzionalmente equivalenti, ma dimostrano diversi livelli di astrazione.

Esempio 1: utilizza CpiContext di Anchor e la funzione helper.
Esempio 2: utilizza la funzione system_instruction::transfer dal crate solana_program.
Esempio 3: costruisce manualmente l'istruzione CPI. Questo approccio è utile quando non esiste un crate per aiutare a costruire l'istruzione che vuoi invocare.

use anchor_lang::prelude::*;
use anchor_lang::system_program::{transfer, Transfer};

declare_id!("9AvUNHjxscdkiKQ8tUn12QCMXtcnbR9BVGq3ULNzFMRi");

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

    pub fn sol_transfer(ctx: Context<SolTransfer>, amount: u64) -> Result<()> {
        let from_pubkey = ctx.accounts.sender.to_account_info();
        let to_pubkey = ctx.accounts.recipient.to_account_info();
        let program_id = ctx.accounts.system_program.to_account_info();

        let cpi_context = CpiContext::new(
            program_id,
            Transfer {
                from: from_pubkey,
                to: to_pubkey,
            },
        );

        transfer(cpi_context, amount)?;
        Ok(())
    }
}

#[derive(Accounts)]
pub struct SolTransfer<'info> {
    #[account(mut)]
    sender: Signer<'info>,
    #[account(mut)]
    recipient: SystemAccount<'info>,
    system_program: Program<'info, System>,
}

Rust

L'esempio seguente mostra come effettuare una CPI da un programma scritto in Rust nativo. Include una singola istruzione che trasferisce SOL da un account a un altro. (Il file di test utilizza LiteSVM per testare il programma.)

use borsh::BorshDeserialize;
use solana_program::{
    account_info::AccountInfo,
    entrypoint,
    entrypoint::ProgramResult,
    program::invoke,
    program_error::ProgramError,
    pubkey::Pubkey,
    system_instruction,
};

// Declare program entrypoint
entrypoint!(process_instruction);

// Define program instructions
#[derive(BorshDeserialize)]
enum ProgramInstruction {
    SolTransfer { amount: u64 },
}

impl ProgramInstruction {
    fn unpack(input: &[u8]) -> Result<Self, ProgramError> {
        Self::try_from_slice(input).map_err(|_| ProgramError::InvalidInstructionData)
    }
}

pub fn process_instruction(
    _program_id: &Pubkey,
    accounts: &[AccountInfo],
    instruction_data: &[u8],
) -> ProgramResult {
    // Deserialize instruction data
    let instruction = ProgramInstruction::unpack(instruction_data)?;

    // Process instruction
    match instruction {
        ProgramInstruction::SolTransfer { amount } => {
            // Parse accounts
            let [sender_info, recipient_info, system_program_info] = accounts else {
                return Err(ProgramError::NotEnoughAccountKeys);
            };

            // Verify the sender is a signer
            if !sender_info.is_signer {
                return Err(ProgramError::MissingRequiredSignature);
            }

            // Create and invoke the transfer instruction
            let transfer_ix = system_instruction::transfer(
                sender_info.key,
                recipient_info.key,
                amount,
            );

            invoke(
                &transfer_ix,
                &[
                    sender_info.clone(),
                    recipient_info.clone(),
                    system_program_info.clone(),
                ],
            )?;

            Ok(())
        }
    }
}

CPI senza firmatari PDA