Rust Anchor框架CPI接口生成库anchor-generate-cpi-interface使用指南

完整示例demo

基于提供的内容，下面是一个完整的示例demo，展示如何使用anchor-generate-cpi-interface实现CPI调用：

1. 目标程序(target_program)

use anchor_lang::prelude::*;

// 定义目标程序ID
declare_id!("TARGET11111111111111111111111111111111111111");

#[program]
pub mod target_program {
    use super::*;
    
    // 转账操作
    pub fn transfer(ctx: Context<Transfer>, amount: u64) -> Result<()> {
        // 实现转账逻辑
        let from = &mut ctx.accounts.from;
        let to = &mut ctx.accounts.to;
        from.sub(amount)?;
        to.add(amount)?;
        Ok(())
    }

    // 授权操作
    pub fn approve(ctx: Context<Approve>, amount: u64) -> Result<()> {
        // 实现授权逻辑
        ctx.accounts.delegate.approved_amount = amount;
        Ok(())
    }
}

// 转账所需账户
#[derive(Accounts)]
pub struct Transfer<'info> {
    #[account(mut)]
    pub from: Account<'info, TokenAccount>,
    #[account(mut)]
    pub to: Account<'info, TokenAccount>,
    pub authority: Signer<'info>,
}

// 授权所需账户
#[derive(Accounts)]
pub struct Approve<'info> {
    #[account(mut)]
    pub delegate: Account<'info, DelegateAccount>,
    pub owner: Signer<'info>,
}

// 账户结构定义
#[account]
pub struct TokenAccount {
    pub balance: u64,
    // 其他字段
}

#[account]
pub struct DelegateAccount {
    pub approved_amount: u64,
    // 其他字段
}

2. 调用程序(caller_program)

use anchor_lang::prelude::*;
use anchor_generate_cpi_interface::generate_cpi_interface;

// 生成目标程序的CPI接口
generate_cpi_interface!(
    TargetProgramInterface,
    target_program::ID,
    {
        Transfer: target_program::cpi::accounts::Transfer,
        Approve: target_program::cpi::accounts::Approve
    },
    {
        Transfer: target_program::instruction::Transfer { amount: u64 },
        Approve: target_program::instruction::Approve { amount: u64 }
    }
);

// 定义调用程序ID
declare_id!("CALLER1111111111111111111111111111111111111");

#[program]
pub mod caller_program {
    use super::*;
    
    // 调用目标程序的转账方法
    pub fn call_transfer(ctx: Context<CallTransfer>, amount: u64) -> Result<()> {
        // 使用生成的接口进行CPI调用
        TargetProgramInterface::transfer(
            ctx.accounts.target_program.clone(),
            ctx.accounts.transfer_accounts.clone(),
            amount
        )?;
        
        Ok(())
    }

    // 调用目标程序的授权方法
    pub fn call_approve(ctx: Context<CallApprove>, amount: u64) -> Result<()> {
        // 使用CpiContext进行更灵活的调用
        let cpi_ctx = CpiContext::new(
            ctx.accounts.target_program.clone(),
            TargetProgramInterface::approve_ctx(
                ctx.accounts.approve_accounts.clone(),
                amount
            )
        );
        TargetProgramInterface::approve(cpi_ctx, amount)?;
        
        Ok(())
    }
}

// 调用转账所需的账户
#[derive(Accounts)]
pub struct CallTransfer<'info> {
    #[account(mut)]
    pub target_program: AccountInfo<'info>,
    #[account(signer)]
    pub authority: AccountInfo<'info>,
    pub transfer_accounts: TransferAccounts<'info>,
}

// 调用授权所需的账户
#[derive(Accounts)]
pub struct CallApprove<'info> {
    #[account(mut)]
    pub target_program: AccountInfo<'info>,
    #[account(signer)]
    pub owner: AccountInfo<'info>,
    pub approve_accounts: ApproveAccounts<'info>,
}

// 生成的CPI接口账户类型
#[derive(Accounts)]
pub struct TransferAccounts<'info> {
    #[account(mut)]
    pub from: Account<'info, TokenAccount>,
    #[account(mut)]
    pub to: Account<'info, TokenAccount>,
}

#[derive(Accounts)]
pub struct ApproveAccounts<'info> {
    #[account(mut)]
    pub delegate: Account<'info, DelegateAccount>,
}

3. 项目结构

/solana_cpi_example
  /programs
    /target_program
      src/
        lib.rs  # 目标程序代码
    /caller_program
      src/
        lib.rs  # 调用程序代码
        cpi_interfaces.rs  # 存放生成的CPI接口(可选)
  Cargo.toml

4. Cargo.toml配置

[workspace]
members = [
    "programs/target_program",
    "programs/caller_program"
]

[dependencies]
anchor-lang = "0.24.2"
anchor-generate-cpi-interface = "0.1.0"

这个完整示例展示了：

1. 目标程序定义了两个操作(transfer和approve)
2. 调用程序使用anchor-generate-cpi-interface生成了CPI接口
3. 两种CPI调用方式：直接调用和使用CpiContext
4. 完整的账户结构和类型安全验证
5. 模块化的项目结构

开发者可以根据实际需求调整账户结构和业务逻辑，但核心的CPI接口生成和使用模式保持不变。