> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gatekeeper (Beta)

> Solana를 위해 특별히 제작된 Helius의 고성능 엣지 게이트웨이

Gatekeeper는 Helius의 새로운 엣지 게이트웨이로, 현재 공개 베타 중이며 Cloudflare를 주요 경로에서 제거합니다. 엣지 지연시간을 제거하면 우리의 핵심 API 및 서비스의 진정한 속도를 발휘할 수 있으며, 응답 시간 개선은 수십에서 수백 밀리세컨드에 이릅니다.

Gatekeeper는 모든 요청(e.g., JSON-RPC, WebSockets, 및 Helius API)에 대한 단일 통합 진입점으로 작동합니다. 이는 지리적으로 분산된 엣지 위치에서 연결을 종료하고, 요청을 백엔드 인프라로 지능적으로 라우팅합니다.

지연 시간이 중요한 작업의 경우, Gatekeeper는 가장 짧은 네트워크 경로를 제공하여 홉을 줄이고 밀리세컨드를 절약합니다.

## Quickstart

Gatekeeper를 사용하려면 기존 엔드포인트를 Gatekeeper (Beta) 엔드포인트로 교체하십시오:

<CodeGroup>
  ```javascript Before theme={"system"}
  const url = "https://mainnet.helius-rpc.com?api-key=YOUR_API_KEY";
  ```

  ```javascript After theme={"system"}
  const url = "https://beta.helius-rpc.com?api-key=YOUR_API_KEY";
  ```
</CodeGroup>

**끝입니다!**

기존 API 키는 추가 변경 없이 작동합니다.

## Supported Methods

Gatekeeper는 현재 다음을 지원합니다:

* 모든 표준 Solana RPC 엔드포인트
* 모든 Helius 전용 RPC 엔드포인트(e.g., gTFA) 
* 모든 Helius WebSocket 엔드포인트(표준 Solana 메서드 및 `transactionSubscribe`와 같은 Helius 확장 포함)
* 모든 DAS API 엔드포인트
* 모든 Photon API 엔드포인트(ZK Compression)
* Helius 우선 수수료 API
* 향상된 트랜잭션 API

<Note>
  **현재 지원되지 않음**: LaserStream은 아직 Gatekeeper에서 사용 불가능합니다. gRPC 연결을 위해 전용 [LaserStream 엔드포인트](/docs/ko/laserstream/grpc#메인넷-엔드포인트)를 계속 사용하십시오.
</Note>

## Usage Examples

<CodeGroup>
  ```javascript JavaScript/TypeScript theme={"system"}
  const url = `https://beta.helius-rpc.com?api-key=${YOUR_API_KEY}`;

  const response = await fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'getLatestBlockhash',
      params: []
    })
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={"system"}
  import requests

  url = f"https://beta.helius-rpc.com?api-key={YOUR_API_KEY}"

  response = requests.post(url, json={
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getLatestBlockhash",
      "params": []
  })

  print(response.json())
  ```

  ```rust Rust theme={"system"}
  use reqwest;
  use serde_json::json;

  #[tokio::main]
  async fn main() -> Result<(), Box<dyn std::error::Error>> {
      let url = format!("https://beta.helius-rpc.com?api-key={}", YOUR_API_KEY);

      let client = reqwest::Client::new();
      let response = client
          .post(&url)
          .json(&json!({
              "jsonrpc": "2.0",
              "id": 1,
              "method": "getLatestBlockhash",
              "params": []
          }))
          .send()
          .await?;

      let data = response.json::<serde_json::Value>().await?;
      println!("{:?}", data);

      Ok(())
  }
  ```

  ```bash cURL theme={"system"}
  curl https://beta.helius-rpc.com?api-key=YOUR_API_KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getLatestBlockhash",
      "params": []
    }'
  ```
</CodeGroup>

## WebSocket Support

Gatekeeper는 Helius WebSockets — 표준 Solana 구독 방법과 Helius 확장(`transactionSubscribe`, 개선된 `accountSubscribe`)을 지원하며 동일한 성능 향상을 제공합니다.

```javascript theme={"system"}
const ws = new WebSocket(`wss://beta.helius-rpc.com?api-key=${YOUR_API_KEY}`);

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'transactionSubscribe',
    params: [
      {
        accountInclude: ['YOUR_ACCOUNT_ADDRESS']
      },
      {
        commitment: 'confirmed',
        encoding: 'jsonParsed',
        transactionDetails: 'full',
        showRewards: true,
        maxSupportedTransactionVersion: 0
      }
    ]
  }));
});

ws.on('message', (data) => {
  console.log('Transaction:', JSON.parse(data));
});
```

## What to Expect

베타 기간 동안:

* **더 낮은 지연 시간** - 전반적인 응답 시간 대폭 개선
* **부하 시 더 나은 성능** - 높은 트래픽 기간 동안 신뢰성 향상
* **더 일관된 응답 시간** - 지연 시간 변화 감소
* **개선된 WebSocket 안정성** - 더 신뢰할 수 있는 실시간 연결
* **완전한 API 호환성** - 모든 기존 RPC 메서드가 동일하게 작동
* **동일한 가격** - 베타 액세스에 추가 비용 없음
* **전 세계 배포** - 여러 대륙의 엣지 노드

## Who should use Gatekeeper?

Gatekeeper는 성능이 중요한 애플리케이션에 이상적입니다:

* **고빈도 애플리케이션** - 지연 시간이 중요한 모든 앱
* **거래 봇** - 차익 거래 기회를 위한 최대 속도
* **DeFi 프로토콜** - 실시간 가격 피드 및 빠른 트랜잭션 제출
* **게임 애플리케이션** - 원활한 UX를 위한 낮은 응답 시간
* **NFT 마켓플레이스** - 즉각적인 민팅 및 낮은 지연 시간 쿼리

## Migration Checklist

<Steps>
  <Step title="엔드포인트 업데이트">
    `mainnet.helius-rpc.com`을(를) `beta.helius-rpc.com`로 코드에서 변경합니다
  </Step>

  <Step title="개발에서 테스트">
    모든 것이 예상대로 작동하는지 확인하기 위해 테스트 수트를 실행합니다
  </Step>

  <Step title="성능 모니터링">
    메트릭을 확인하십시오. 개선된 지연 시간과 더 일관된 응답 시간을 볼 수 있습니다
  </Step>

  <Step title="프로덕션에 배포">
    확인 후 변경 사항을 프로덕션에 배포합니다
  </Step>
</Steps>

## Rollback

어떤 이유로든 롤백이 필요하면 표준 엔드포인트로 다시 전환하십시오:

```javascript theme={"system"}
const url = "https://mainnet.helius-rpc.com?api-key=YOUR_API_KEY";
```

## Limitations & Known Issues

<Warning>
  **베타 상태**: Gatekeeper는 프로덕션 준비가 되어 있지만 여전히 최적화되고 있습니다. 프로덕션 트래픽으로 전환하기 전에 개발에서 테스트할 것을 권장합니다.
</Warning>

**아직 지원되지 않음:**

* **LaserStream**: gRPC 연결을 위해 전용 [LaserStream 엔드포인트](/docs/ko/laserstream/grpc#메인넷-엔드포인트)를 사용하세요

**현재 상태:**

* 일부 고급 기능은 여전히 출시 중입니다
* 우리는 지속적으로 라우팅 알고리즘을 최적화하고 있습니다
* 성능 향상이 진행 중입니다

## Rollout Plan

Gatekeeper는 현재 성능 최적화 및 피드백 수집을 위해 **옵트인** 상태입니다.

타임라인:

* **현재**: 모든 사용자가 사용할 수 있는 공개 베타
* **앞으로 몇 주**: 추가 최적화 및 성능 향상
* **앞으로 몇 달**: Gatekeeper를 기본값으로 모든 트래픽을 점진적으로 마이그레이션

## Feedback & Support

우리는 Gatekeeper의 성능을 적극적으로 모니터링하고 있으며 귀하의 피드백을 환영합니다:

* **문제나 질문이 있습니까?** [support@helius.dev](mailto:support@helius.dev)로 연락하십시오
* 실시간 토론을 위해 **디스코드에 참여하십시오**: [https://discord.com/invite/6GXdee3gBj](https://discord.com/invite/6GXdee3gBj)
* 개발자 대시보드를 통해 **버그를 보고하십시오**

## FAQs

<AccordionGroup>
  <Accordion title="새로운 API 키가 필요합니까?">
    아닙니다. 기존 API 키는 변경 없이 Gatekeeper와 함께 작동합니다.
  </Accordion>

  <Accordion title="Gatekeeper는 추가 비용이 드나요?">
    아닙니다. Gatekeeper는 추가 비용 없이 사용 가능합니다. 기존 요금제가 적용됩니다.
  </Accordion>

  <Accordion title="Gatekeeper에서 지원되는 엔드포인트는 무엇입니까?">
    표준 Solana RPC 메서드, Helius 전용 RPC 엔드포인트(e.g., gTFA), DAS, Photon, 우선 수수료 API, 향상된 트랜잭션 API를 포함한 모든 JSON-RPC 엔드포인트가 완전히 지원됩니다. WebSockets — 표준 Solana 구독 메서드 및 `transactionSubscribe`와 같은 Helius 확장도 지원됩니다.
  </Accordion>

  <Accordion title="Gatekeeper에서 아직 지원되지 않는 엔드포인트는 무엇입니까?">
    LaserStream은 아직 Gatekeeper에서 사용 불가능합니다. gRPC 연결을 위해 전용 [LaserStream 엔드포인트](/docs/ko/laserstream/grpc#메인넷-엔드포인트)를 사용하십시오.
  </Accordion>

  <Accordion title="Gatekeeper 사용 시 문제가 발생하면 어떻게 해야 합니까?">
    `mainnet.helius-rpc.com`로 다시 전환하여 쉽게 롤백할 수 있습니다. 도움이 필요하면 [support](https://www.helius.dev/docs/support)에 연락하십시오.
  </Accordion>

  <Accordion title="Gatekeeper가 기본값이 되는 시기는 언제입니까?">
    우리는 앞으로 몇 달 동안 점진적으로 롤아웃을 계획하고 있습니다. 기본 Helius 엔드포인트에 변경 사항을 만들기 전에 모든 사용자에게 알릴 것입니다.
  </Accordion>

  <Accordion title="Gatekeeper를 Solana Devnet 또는 Testnet에서 사용할 수 있습니까?">
    아니요, Gatekeeper는 현재 Solana Mainnet에서만 사용 가능합니다. Solana Devnet 및 Testnet 지원은 곧 제공될 예정입니다.
  </Accordion>
</AccordionGroup>

## Get Started

<CardGroup cols={2}>
  <Card title="Gatekeeper 시도하기" icon="rocket" href="https://www.helius.dev/docs/gatekeeper/migration-guide">
    5분 이내에 Gatekeeper로 마이그레이션
  </Card>

  <Card title="Gatekeeper에 대해 알아보기" icon="book" href="https://www.helius.dev/blog/introducing-gatekeeper">
    Gatekeeper가 작동하는 방식을 이해하기 위해 블로그 읽기
  </Card>
</CardGroup>