测试你的程序

快速入口

如果你想直接进入代码：

GitHub

Rust Counter 的测试

GitHub

Pinocchio Counter 的测试

Guide

本地开发

分步指南

构建能够调用程序中 delegation 和 undelegation instruction 的有效交易。该项目的完整测试可以在 Typescript 测试脚本中找到。

导入 SDK 并初始化 Connection

设置 connection 和账户

在 Base Layer 上 Delegate PDA

测试在 Base Layer 上委托状态账户的 CPI hook

这些公共验证器可用于开发环境。请确保在你的委托指令中添加对应的 ER 验证器：

主网

亚洲 (as.magicblock.app): MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57
欧盟 (eu.magicblock.app): MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e
美国 (us.magicblock.app): MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd
TEE (mainnet-tee.magicblock.app): MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo

开发网

亚洲 (devnet-as.magicblock.app): MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57
欧盟 (devnet-eu.magicblock.app): MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e
美国 (devnet-us.magicblock.app): MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd
TEE (devnet-tee.magicblock.app): MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo

本地网络

本地 ER (localhost:7799): mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev

在 ER 上 Commit PDA

测试在 ER 上提交状态账户的 CPI hook

在 ER 上 Undelegate PDA

测试在 ER 上取消委托状态账户的 CPI hook

Counter 示例

你可能需要以下软件包，其他版本也可能兼容：

软件	版本	安装指南
Solana	3.1.9	安装 Solana
Rust	1.89.0	安装 Rust
Node	24.10.0	安装 Node

代码片段

1. Connection
2. Delegate
3. Commit
4. Undelegate

导入 SDK 并创建 Connection

导入相关库 @magicblock-labs/ephemeral-rollups-sdk 或 @magicblock-labs/ephemeral-rollups-kit。在测试和发送交易之前先初始化 connection。

yarn add @magicblock-labs/ephemeral-rollups-kit@latest

yarn add @magicblock-labs/ephemeral-rollups-sdk@latest

这些公共 RPC 端点目前可免费用于开发：
Magic Router Devnet: https://devnet-router.magicblock.app
Solana Devnet: https://api.devnet.solana.com
ER Devnet: https://devnet.magicblock.app
TEE Devnet: https://devnet-tee.magicblock.app/
查看更多详情请点击这里。

import {
  Instruction,
  getAddressEncoder,
  getProgramDerivedAddress,
  AccountRole,
  createKeyPairFromBytes,
  getAddressFromPublicKey,
  address,
  createTransactionMessage,
  appendTransactionMessageInstructions,
  pipe,
  setTransactionMessageFeePayer,
} from "@solana/kit";

import {
  Connection,
  DELEGATION_PROGRAM_ID,
  delegationRecordPdaFromDelegatedAccount,
  delegationMetadataPdaFromDelegatedAccount,
  delegateBufferPdaFromDelegatedAccountAndOwnerProgram,
  MAGIC_CONTEXT_ID,
  MAGIC_PROGRAM_ID,
} from "@magicblock-labs/ephemeral-rollups-kit";

// Set up a base and ephemeral connection (alternatively use router, see Magic Router)
const connection = await Connection.create(
  process.env.PROVIDER_ENDPOINT || "https://api.devnet.solana.com",
  process.env.WS_ENDPOINT || "wss://api.devnet.solana.com"
);
const ephemeralConnection = await Connection.create(
  process.env.EPHEMERAL_PROVIDER_ENDPOINT || "https://devnet-as.magicblock.app",
  process.env.EPHEMERAL_WS_ENDPOINT || "wss://devnet-as.magicblock.app"
);

// Prepare user
const userKeypair = await initializeSolSignerKeypair();
const userPubkey = await getAddressFromPublicKey(userKeypair.publicKey);

// Get PDA
const addressEncoder = getAddressEncoder();
const [counterPda, bump] = await getProgramDerivedAddress({
  programAddress: PROGRAM_ID,
  seeds: [Buffer.from("counter"), addressEncoder.encode(userPubkey)],
});

import {
  Keypair,
  PublicKey,
  SystemProgram,
  Transaction,
  TransactionInstruction,
  Connection,
  sendAndConfirmTransaction,
} from "@solana/web3.js";

import {
  DELEGATION_PROGRAM_ID,
  delegationRecordPdaFromDelegatedAccount,
  delegationMetadataPdaFromDelegatedAccount,
  delegateBufferPdaFromDelegatedAccountAndOwnerProgram,
  MAGIC_CONTEXT_ID,
  MAGIC_PROGRAM_ID,
  GetCommitmentSignature,
} from "@magicblock-labs/ephemeral-rollups-sdk";

// Set up a base and ephemeral connection (alternatively use router, see Magic Router)
const connectionBaseLayer = new Connection(
  process.env.PROVIDER_ENDPOINT || "https://api.devnet.solana.com",
  { wsEndpoint: process.env.WS_ENDPOINT || "wss://api.devnet.solana.com" }
);
const connectionEphemeralRollup = new Connection(
  process.env.EPHEMERAL_PROVIDER_ENDPOINT ||
    "https://devnet-as.magicblock.app/",
  {
    wsEndpoint:
      process.env.EPHEMERAL_WS_ENDPOINT || "wss://devnet-as.magicblock.app/",
  }
);

// Create user keypair and airdrop SOL if needed
const userKeypair = initializeSolSignerKeypair();

// Get pda
let [counterPda, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("counter"), userKeypair.publicKey.toBuffer()],
  PROGRAM_ID
);

⬆️ Back to Top

测试 `delegation` 交易

创建一个 instruction，确保账户顺序与属性正确，并使用程序中 delegation 的 instruction discriminator。然后将包含该 instruction 的交易发送到 Base Layer（Solana）网络。

交易（Base Layer）：Delegate

在 Solana Explorer 中查看交易详情

// "Delegate" transaction

// Add local validator identity to the remaining accounts if running on localnet
const remainingAccounts =
  connection.clusterUrlHttp.includes("localhost") ||
  connection.clusterUrlHttp.includes("127.0.0.1")
    ? [
        {
          address: address("mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev"),
          role: AccountRole.READONLY,
        },
      ]
    : [];
const accounts = [
  { address: userPubkey, role: AccountRole.WRITABLE_SIGNER },
  { address: SYSTEM_PROGRAM_ADDRESS, role: AccountRole.READONLY },
  { address: counterPda, role: AccountRole.WRITABLE },
  { address: PROGRAM_ID, role: AccountRole.READONLY },
  {
    address: await delegateBufferPdaFromDelegatedAccountAndOwnerProgram(
      counterPda,
      PROGRAM_ID
    ),
    role: AccountRole.WRITABLE,
  },
  {
    address: await delegationRecordPdaFromDelegatedAccount(counterPda),
    role: AccountRole.WRITABLE,
  },
  {
    address: await delegationMetadataPdaFromDelegatedAccount(counterPda),
    role: AccountRole.WRITABLE,
  },
  { address: DELEGATION_PROGRAM_ID, role: AccountRole.READONLY },
  ...remainingAccounts,
];
const serializedInstructionData = Buffer.from(
  CounterInstruction.Delegate,
  "hex"
);
const delegateIx: Instruction = {
  accounts,
  programAddress: PROGRAM_ID,
  data: serializedInstructionData,
};
const transactionMessage = pipe(
  createTransactionMessage({ version: 0 }),
  (tx) => setTransactionMessageFeePayer(userPubkey, tx),
  (tx) => appendTransactionMessageInstructions([delegateIx], tx)
);

// Send and confirm transaction on base layer
const txHash = await connection.sendAndConfirmTransaction(
  transactionMessage,
  [userKeypair],
  { commitment: "confirmed", skipPreflight: true }
);

// "Delegate" transaction

// Add local validator identity to the remaining accounts if running on localnet
const remainingAccounts =
  connectionEphemeralRollup.rpcEndpoint.includes("localhost") ||
  connectionEphemeralRollup.rpcEndpoint.includes("127.0.0.1")
    ? [
        {
          pubkey: new PublicKey("mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev"),
          isSigner: false,
          isWritable: false,
        },
      ]
    : [];

const tx = new web3.Transaction();
const keys = [
  // Initializer
  {
    pubkey: userKeypair.publicKey,
    isSigner: true,
    isWritable: true,
  },
  // System Program
  {
    pubkey: web3.SystemProgram.programId,
    isSigner: false,
    isWritable: false,
  },
  // Counter Account
  {
    pubkey: counterPda,
    isSigner: false,
    isWritable: true,
  },
  // Owner Program
  {
    pubkey: PROGRAM_ID,
    isSigner: false,
    isWritable: false,
  },
  // Delegation Buffer
  {
    pubkey: getDelegationBufferPda(counterPda, PROGRAM_ID),
    isSigner: false,
    isWritable: true,
  },
  // Delegation Record
  {
    pubkey: getDelegationRecordPda(counterPda),
    isSigner: false,
    isWritable: true,
  },
  // Delegation Metadata
  {
    pubkey: getDelegationMetadataPda(counterPda),
    isSigner: false,
    isWritable: true,
  },
  // Delegation Program
  {
    pubkey: DELEGATION_PROGRAM_ID,
    isSigner: false,
    isWritable: false,
  },
  // ER Validator
  ...remainingAccounts,
];
const serializedInstructionData = Buffer.from(
  CounterInstruction.Delegate,
  "hex"
);
const delegateIx = new web3.TransactionInstruction({
  keys: keys,
  programId: PROGRAM_ID,
  data: serializedInstructionData,
});
tx.add(delegateIx);

// Send and confirm transaction to Base Layer
const txHash = await sendAndConfirmTransaction(
  connectionBaseLayer,
  tx,
  [userKeypair],
  {
    skipPreflight: true,
    commitment: "confirmed",
  }
);

⬆️ Back to Top

测试 `commit` 交易

创建一个 instruction，确保账户顺序与属性正确，并使用程序中 commit 的 instruction discriminator。然后将包含该 instruction 的交易发送到 ER 网络。

交易（ER）：Commit

在 Solana Explorer 中查看交易详情

交易（Base layer）：Commit

在 Solana Explorer 中查看交易详情

// "Commit" transaction

const accounts = [
  { address: userPubkey, role: AccountRole.WRITABLE_SIGNER },
  { address: counterPda, role: AccountRole.WRITABLE },
  { address: address(MAGIC_PROGRAM_ID.toString()), role: AccountRole.READONLY },
  { address: address(MAGIC_CONTEXT_ID.toString()), role: AccountRole.WRITABLE },
];
const serializedInstructionData = Buffer.from(CounterInstruction.Commit, "hex");
const commitIx: Instruction = {
  accounts,
  programAddress: PROGRAM_ID,
  data: serializedInstructionData,
};
const transactionMessage = pipe(
  createTransactionMessage({ version: 0 }),
  (tx) => setTransactionMessageFeePayer(userPubkey, tx),
  (tx) => appendTransactionMessageInstructions([commitIx], tx)
);

// Send and confirm transaction on ER
const txHash = await ephemeralConnection.sendAndConfirmTransaction(
  transactionMessage,
  [userKeypair],
  { commitment: "confirmed", skipPreflight: true }
);

// "Commit" transaction

const tx = new web3.Transaction();
const keys = [
  // Initializer
  {
    pubkey: userKeypair.publicKey,
    isSigner: true,
    isWritable: true,
  },
  // Counter Account
  {
    pubkey: counterPda,
    isSigner: false,
    isWritable: true,
  },
  // Magic Program
  {
    pubkey: MAGIC_PROGRAM_ID,
    isSigner: false,
    isWritable: false,
  },
  // Magic Context
  {
    pubkey: MAGIC_CONTEXT_ID,
    isSigner: false,
    isWritable: true,
  },
];
const serializedInstructionData = Buffer.from(CounterInstruction.Commit, "hex");
const commitIx = new web3.TransactionInstruction({
  keys: keys,
  programId: PROGRAM_ID,
  data: serializedInstructionData,
});
tx.add(commitIx);

// Send and confirm transaction to ER
const txHash = await sendAndConfirmTransaction(
  connectionEphemeralRollup,
  tx,
  [userKeypair],
  {
    skipPreflight: true,
    commitment: "confirmed",
  }
);

⬆️ Back to Top

测试 `undelegation` 交易

创建一个 instruction，确保账户顺序与属性正确，并使用程序中 undelegation 的 instruction discriminator。然后将包含该 instruction 的交易发送到 ER 网络。

交易（ER）：Undelegate

在 Solana Explorer 中查看交易详情

交易（Base layer）：Undelegate

在 Solana Explorer 中查看交易详情

// "Undelegate" transaction

const accounts = [
  { address: userPubkey, role: AccountRole.WRITABLE_SIGNER },
  { address: counterPda, role: AccountRole.WRITABLE },
  { address: address(MAGIC_PROGRAM_ID.toString()), role: AccountRole.READONLY },
  { address: address(MAGIC_CONTEXT_ID.toString()), role: AccountRole.WRITABLE },
];
const serializedInstructionData = Buffer.from(
  CounterInstruction.CommitAndUndelegate,
  "hex"
);
const undelegateIx: Instruction = {
  accounts,
  programAddress: PROGRAM_ID,
  data: serializedInstructionData,
};
const transactionMessage = pipe(
  createTransactionMessage({ version: 0 }),
  (tx) => setTransactionMessageFeePayer(userPubkey, tx),
  (tx) => appendTransactionMessageInstructions([undelegateIx], tx)
);

// Send and confirm transaction on ER
const txHash = await ephemeralConnection.sendAndConfirmTransaction(
  transactionMessage,
  [userKeypair],
  { commitment: "confirmed", skipPreflight: true }
);

// "Undelegate" transaction

const tx = new web3.Transaction();
const keys = [
  // Initializer
  {
    pubkey: userKeypair.publicKey,
    isSigner: true,
    isWritable: true,
  },
  // Counter Account
  {
    pubkey: counterPda,
    isSigner: false,
    isWritable: true,
  },
  // Magic Program
  {
    pubkey: MAGIC_PROGRAM_ID,
    isSigner: false,
    isWritable: false,
  },
  // Magic Context
  {
    pubkey: MAGIC_CONTEXT_ID,
    isSigner: false,
    isWritable: true,
  },
];
const serializedInstructionData = Buffer.from(
  CounterInstruction.CommitAndUndelegate,
  "hex"
);
const undelegateIx = new web3.TransactionInstruction({
  keys: keys,
  programId: PROGRAM_ID,
  data: serializedInstructionData,
});
tx.add(undelegateIx);

// Send and confirm transaction to ER. Afterwards CPI callback will be triggered to "Undelegate" instruction of your program on the Base Layer.
const txHash = await sendAndConfirmTransaction(
  connectionEphemeralRollup,
  tx,
  [userKeypair],
  {
    skipPreflight: true,
    commitment: "confirmed",
  }
);

⬆️ Back to Top

Solana 浏览器

查看你在 Solana 上的交易和账户详情：

Solana 浏览器

官方 Solana 浏览器

Solscan

浏览 Solana 区块链

Solana RPC 提供商

通过现有 RPC 提供商发送交易和请求：

Solana

Free Public Nodes

Helius

Free Shared Nodes

Triton

Dedicated High-Performance Nodes

Solana 验证器仪表盘

查看 Solana 验证器基础设施的实时更新：

Solana Beach

Get Validator Insights

Validators App

Discover Validator Metrics

服务状态

订阅 Solana 与 MagicBlock 的服务状态：

Solana Status

Subscribe to Solana Server Updates

MagicBlock Status

Subscribe to MagicBlock Server Status

操作指南

参考资料

ROUTER API

RPC API

快速入口

GitHub

GitHub

Guide

分步指南

Counter 示例

代码片段

导入 SDK 并创建 Connection

测试 `delegation` 交易

交易（Base Layer）：Delegate

测试 `commit` 交易

交易（ER）：Commit

交易（Base layer）：Commit

测试 `undelegation` 交易

交易（ER）：Undelegate

交易（Base layer）：Undelegate

Solana 浏览器

Solana 浏览器

Solscan

Solana RPC 提供商

Solana

Helius

Triton

Solana 验证器仪表盘

Solana Beach

Validators App

服务状态

Solana Status

MagicBlock Status

​快速入口

GitHub

GitHub

Guide

​分步指南

​Counter 示例

​代码片段

​导入 SDK 并创建 Connection

​测试 delegation 交易

交易（Base Layer）：Delegate

​测试 commit 交易

交易（ER）：Commit

交易（Base layer）：Commit

​测试 undelegation 交易

交易（ER）：Undelegate

交易（Base layer）：Undelegate

​Solana 浏览器

Solana 浏览器

Solscan

​Solana RPC 提供商

Solana

Helius

Triton

​Solana 验证器仪表盘

Solana Beach

Validators App

​服务状态

Solana Status

MagicBlock Status

快速入口

分步指南

Counter 示例

代码片段

导入 SDK 并创建 Connection

测试 `delegation` 交易

测试 `commit` 交易

测试 `undelegation` 交易

Solana 浏览器

Solana RPC 提供商

Solana 验证器仪表盘

服务状态