메인 콘텐츠로 건너뛰기

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

Private Counter의 Anchor 구현

라이브 예제 앱

Private Counter 사용해보기
MagicBlock의 Private Ephemeral Rollup은 진입 단계에서 트랜잭션이 수락되거나 실행되기 전에, 노드 수준의 IP 지오펜싱, OFAC 제재 목록 및 제한 관할 구역을 기반으로 컴플라이언스 통제를 수행합니다. 자세히 알아보기

단계별 가이드

프로그램을 빌드하고, 상태를 TEE 밸리데이터에 위임한 뒤, MagicBlock의 Permission Program ACLseoPoyC3cBqoUtkbjZ4aDrkurZW86v19pXz2XQnp1과 Delegation Program DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh을 통해 ER에서 직접 EphemeralPermission 계정을 생성하세요:
1

프로그램 작성

평소처럼 Solana 프로그램을 작성하세요.
2

위임 및 permission 생성

delegate은 Base Layer에서 counter를 TEE 밸리데이터에게 위임합니다. 이어서 init_permission이 ER에서 실행되며, 위임된 PDA가 PDA로 서명하고 자체 ephemeral permission 렌트를 지불합니다(initialize 시점에 미리 충전됨). set_privacy로 필요에 따라 공개 / 비공개 플래그를 전환합니다. Base Layer에 permission 계정을 생성하거나 위임하거나 commit-and-undelegate할 필요가 없습니다. 접근 제어 상세 보기.

이 공용 검증자들은 개발용으로 지원됩니다. 위임 명령에 해당 ER 검증자를 반드시 추가하세요.

메인넷
  • 아시아 (as.magicblock.app): MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57
  • EU (eu.magicblock.app): MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e
  • 미국 (us.magicblock.app): MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd
  • TEE (mainnet-tee.magicblock.app): MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo
데브넷
  • 아시아 (devnet-as.magicblock.app): MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57
  • EU (devnet-eu.magicblock.app): MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e
  • 미국 (devnet-us.magicblock.app): MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd
  • TEE (devnet-tee.magicblock.app): MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo
로컬넷
  • 로컬 ER (localhost:7799): mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev
3

Solana에 프로그램 배포

Anchor CLI로 Solana 프로그램을 배포합니다.
4

클라이언트에 인가 로직 구현

사용자가 메시지에 서명하도록 하여 TEE 엔드포인트로부터 인가 토큰을 받습니다.
5

트랜잭션 실행 및 프라이버시 테스트

인가 토큰을 요청하고 기밀 트랜잭션을 전송합니다.

Private Counter 예제

다음 소프트웨어 패키지가 필요할 수 있으며, 다른 버전도 호환될 수 있습니다.
소프트웨어버전설치 가이드
Solana3.1.9Solana 설치
Rust1.89.0Rust 설치
Anchor1.0.2Anchor 설치
Node24.10.0Node 설치
아래 표시된 EphemeralPermission 흐름은 ephemeral-rollups-sdk v0.14+가 필요합니다 (CreateEphemeralPermissionCpi / UpdateEphemeralPermissionCpi / CloseEphemeralPermissionCpi가 도입되었습니다). 구버전 SDK 및 Anchor를 사용 중이라면 legacy examples를 참고하세요.

코드 스니펫

initializeincrement 명령을 가진 단순한 counter 프로그램으로, 공개 counter와 모양이 동일합니다 — 프라이버시 기능은 다음 단계에서 추가됩니다:
#[ephemeral]
#[program]
pub mod private_counter {
    use super::*;

    /// Initialize the counter.
    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.count = 0;
        Ok(())
    }

    /// Increment the counter.
    pub fn increment(ctx: Context<Increment>) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.count += 1;
        Ok(())
    }

    /// ... Other instructions for delegation, permission, and privacy
}

pub const COUNTER_SEED: &[u8] = b"counter";

/// Context for initializing counter
#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(init_if_needed, payer = user, space = 8 + 8, seeds = [COUNTER_SEED], bump)]
    pub counter: Account<'info, Counter>,
    #[account(mut)]
    pub user: Signer<'info>,
    pub system_program: Program<'info, System>,
}

/// Context for incrementing counter
#[derive(Accounts)]
pub struct Increment<'info> {
    #[account(mut, seeds = [COUNTER_SEED], bump)]
    pub counter: Account<'info, Counter>,
}

/// Counter struct
#[account]
pub struct Counter {
    pub count: u64,
}

/// Other context and accounts for delegation and privacy ...
⬆️ 맨 위로

접근 제어

세밀한 접근 제어

온체인 프라이버시

프라이버시 메커니즘과 개념

인가

인가 프레임워크

컴플라이언스 프레임워크

컴플라이언스 기준 및 가이드라인

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 위에 구축되었습니다.

프라이빗 결제 API

몇 초 만에 앱에 온체인 비공개 송금을 통합하세요 — 기본적으로 규정 준수.

Solana VRF

게임, 추첨, 실시간 앱에 증명 가능하게 공정한 온체인 랜덤니스를 추가하세요.

가격 오라클

트레이딩과 DeFi를 위한 저지연 온체인 가격 피드에 접근하세요.