Ephemeral SPL Token クイックスタート

AI コーディングエージェントで開発していますか？ MagicBlock Dev Skill をインストールすると、デリゲーションフロー、Magic Actions、Crank、VRF など、MagicBlock 固有の開発パターンをエージェントに提供できます。Claude Code でのクイックインストール：

npx add-skill https://github.com/magicblock-labs/magicblock-dev-skill

Cursor、Codex、Windsurf、Cline などをお使いの場合は、AI Dev Skill ページですべてのインストール方法をご確認ください。

クイックアクセス

サンプルを確認：

GitHub

SPL Token の Anchor 実装

ライブサンプルアプリ

プライベート決済を試す

これらのスニペットは、legacy-vault パスを使う @magicblock-labs/ephemeral-rollups-sdk v0.14.3 向けです。idempotent-shuttle パスは v0.15.3 向けです。1 つのライフサイクルでは delegateSpl / undelegateIx / withdrawSpl に同じパスを使用してください。

ステップ別ガイド

Ephemeral SPL Token プログラム SPLxh1LVZzEkX99H6rqYizhytLWPZVV296zyYDPagv2 で SPL token のライフサイクル全体を実行します。委任し、 ER 上で取引してから Solana に決済します：

token account を委任

base layer 上で所有者の残高を validator に委任します。mint の初回委任時に共有 Global Vault が作成されます。

ER 上で送金

rollup 内の eATA 間で token を公開またはプライベートに移動します。

委任解除してコミット

ER 上で委任を解除し、base layer へのコミットを待ちます。

base layer に出金

残高を Global Vault から base-layer token account に移動します。

Ephemeral SPL Token の例

以下のソフトウェアパッケージが必要になる場合があります。ほかのバージョンでも互換性がある可能性があります。

ソフトウェア	バージョン	インストールガイド
Solana	3.1.9	Solana をインストール
Rust	1.89.0	Rust をインストール
Anchor	1.0.2	Anchor をインストール
Node	24.10.0	Node をインストール

SDK をインストールします：

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

コードスニペット

1. 委任
2. 送金
3. 委任解除
4. 出金
ER 対応プログラム

delegateSpl は所有者の残高を validator に委任します。mint の初回委任時に共有 Global Vault を作成し（initVaultIfMissing: true）、以降は再利用します。base layer 上で送信し、委任前に rent sponsor（deriveRentPda()）へ資金を入れてください。

// Legacy vault flow — keep the same idempotent setting across
// delegateSpl / undelegateIx / withdrawSpl within one lifecycle.
const delegateOpts = { validator, idempotent: false as const, payer: admin.publicKey };

const ixs = await delegateSpl(owner.publicKey, mint.publicKey, amount, {
  ...delegateOpts,
  initVaultIfMissing, // true for the first owner of this mint, false after
});

await provider.sendAndConfirm(
  new anchor.web3.Transaction().add(...ixs),
  [owner, admin],
  { commitment: "confirmed", skipPreflight: true },
);

⬆️ トップに戻る

transferSpl は rollup 内の eATA 間で token を移動します。ephemeral provider で送信します。プライベート決済には visibility: "private"、通常の高速送金には "public" を設定します。

// Delegation confirms on base before the ER clones the account —
// poll the ER view before transferring.
await waitForErTokenAccount(ata, expectedAmount);

const transferIxs = await transferSpl(
  recipientA.publicKey,
  recipientB.publicKey,
  mint.publicKey,
  2n,
  { visibility: "public", fromBalance: "ephemeral", toBalance: "ephemeral" },
);

await providerEphemeralRollup.sendAndConfirm(
  new anchor.web3.Transaction().add(...transferIxs),
  [recipientA],
  { commitment: "confirmed", skipPreflight: true },
);

⬆️ トップに戻る

ER 上で所有者ごとに委任を解除し（1 トランザクションにつき 1 件）、出金前に GetCommitmentSignature で base layer へのコミットを待ちます。

const sgn = await providerEphemeralRollup.sendAndConfirm(
  new anchor.web3.Transaction().add(undelegateIx(owner.publicKey, mint.publicKey)),
  [owner],
  { commitment: "confirmed", skipPreflight: true },
);

// Wait for the commit back to base before withdrawing, or the withdraw
// races the commit and fails with InvalidAccountOwner.
const commit = await GetCommitmentSignature(sgn, providerEphemeralRollup.connection);
await connection.confirmTransaction(commit, "confirmed");

⬆️ トップに戻る

withdrawSpl は残高を Global Vault から所有者の base-layer ATA に戻します。

const withdrawIxs = await withdrawSpl(owner.publicKey, mint.publicKey, amount, {
  idempotent: false,
});

await provider.sendAndConfirm(
  new anchor.web3.Transaction().add(...withdrawIxs),
  [owner],
  { commitment: "confirmed" },
);

⬆️ トップに戻る

SDK helper ではなく独自プログラム経由で ER 側の送金を処理するには、#[ephemeral] 属性を追加します。この命令は通常の SPL Token CPI です。カストディと PDA 署名送金についてはスマートコントラクト統合を参照してください。

use anchor_lang::prelude::*;
use anchor_spl::token::{self, Token, TokenAccount, Transfer as SplTransfer};
use ephemeral_rollups_sdk::anchor::ephemeral;

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

    /// Transfer `amount` of SPL tokens from `from` to `to`.
    pub fn transfer(ctx: Context<TransferTokens>, amount: u64) -> Result<()> {
        require!(amount > 0, ErrorCode::InvalidAmount);
        let cpi_accounts = SplTransfer {
            from: ctx.accounts.from.to_account_info(),
            to: ctx.accounts.to.to_account_info(),
            authority: ctx.accounts.payer.to_account_info(),
        };
        let cpi_ctx = CpiContext::new(ctx.accounts.token_program.to_account_info(), cpi_accounts);
        token::transfer(cpi_ctx, amount)?;
        Ok(())
    }
}

⬆️ トップに戻る

ローカルで実行： yarn → yarn build → yarn setup（ローカルの base + ER クラスターを起動し、そのまま実行）→ 2 つ目のターミナルで yarn test:local。

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

MagicBlock 製品

エフェメラルロールアップ（ER）

Solana 上でリアルタイムかつ手数料ゼロのトランザクションを安全に実行します。

プライベート・エフェメラルロールアップ（PER）

コンプライアンスを保ちながら機密データを保護 — Ephemeral Rollups の上に構築されています。