> ## 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)

> Cổng biên hiệu năng cao của Helius, được xây dựng chuyên biệt cho Solana

Gatekeeper là cổng biên mới của Helius, hiện đang ở giai đoạn beta công khai, giúp loại bỏ Cloudflare khỏi luồng xử lý trọng yếu. Việc loại bỏ độ trễ tại biên giúp khai thác tốc độ thực sự của các API và dịch vụ cốt lõi—thời gian phản hồi được cải thiện từ hàng chục đến hàng trăm mili giây.

Gatekeeper đóng vai trò là một điểm vào duy nhất, hợp nhất cho mọi yêu cầu (ví dụ: JSON-RPC, WebSocket và các API của Helius): Gatekeeper kết thúc kết nối tại các vị trí biên phân tán theo địa lý và định tuyến yêu cầu một cách thông minh đến hạ tầng backend của chúng tôi.

Đối với các khối lượng công việc nhạy cảm với độ trễ, Gatekeeper cung cấp đường truyền mạng ngắn nhất, giảm số chặng và tiết kiệm từng mili giây.

## Bắt đầu nhanh

Để sử dụng Gatekeeper, hãy thay điểm cuối hiện tại bằng điểm cuối 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>

**Chỉ vậy thôi!**

Khóa API hiện tại của bạn hoạt động mà không cần thêm bất kỳ thay đổi nào.

## Các phương thức được hỗ trợ

Gatekeeper hiện hỗ trợ:

* Tất cả các điểm cuối RPC tiêu chuẩn của Solana
* Tất cả các điểm cuối RPC dành riêng cho Helius (ví dụ: gTFA) 
* Tất cả các điểm cuối WebSocket của Helius (các phương thức Solana tiêu chuẩn cùng với những tiện ích mở rộng của Helius như `transactionSubscribe`)
* [Luồng đã phân tích](/docs/vi/parsed-streams) (`parsedTransactionSubscribe`)
* Tất cả các điểm cuối DAS API
* Tất cả các điểm cuối Photon API (tức là ZK Compression)
* Helius Priority Fee API
* Enhanced Transactions API

<Note>
  **Hiện chưa được hỗ trợ**: LaserStream chưa khả dụng trên Gatekeeper. Hãy tiếp tục sử dụng các [điểm cuối LaserStream](/docs/vi/laserstream/grpc#điểm-cuối-mainnet) chuyên dụng cho kết nối gRPC.
</Note>

## Ví dụ sử dụng

<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>

## Hỗ trợ WebSocket

Gatekeeper hỗ trợ WebSocket của Helius—bao gồm cả các phương thức đăng ký Solana tiêu chuẩn và các tiện ích mở rộng của Helius (`transactionSubscribe`, `accountSubscribe` nâng cao)—với mức cải thiện hiệu năng tương tự.

```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: 1
      }
    ]
  }));
});

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

## Những điều có thể mong đợi

Trong giai đoạn beta:

* **Độ trễ thấp hơn** - Thời gian phản hồi nhanh hơn đáng kể trên toàn hệ thống
* **Hiệu năng tốt hơn khi chịu tải** - Độ tin cậy cao hơn trong những thời điểm có lưu lượng lớn
* **Thời gian phản hồi ổn định hơn** - Giảm mức độ dao động của độ trễ
* **Độ ổn định WebSocket được cải thiện** - Kết nối thời gian thực đáng tin cậy hơn
* **Tương thích hoàn toàn với API** - Tất cả các phương thức RPC hiện có đều hoạt động giống hệt nhau
* **Giữ nguyên mức giá** - Không phát sinh thêm chi phí khi tham gia beta
* **Phân bố toàn cầu** - Các nút biên trên nhiều châu lục

## Ai nên sử dụng Gatekeeper?

Gatekeeper phù hợp với các ứng dụng coi trọng hiệu năng:

* **Ứng dụng tần suất cao** - Mọi ứng dụng mà độ trễ là yếu tố quan trọng
* **Bot giao dịch** - Tốc độ tối đa để tận dụng các cơ hội kinh doanh chênh lệch giá
* **Giao thức DeFi** - Nguồn cấp giá theo thời gian thực và gửi giao dịch nhanh chóng
* **Ứng dụng trò chơi** - Thời gian phản hồi thấp để mang lại trải nghiệm người dùng mượt mà
* **Thị trường NFT** - Đúc tức thì và truy vấn có độ trễ thấp

## Danh sách kiểm tra khi di chuyển

<Steps>
  <Step title="Update Your Endpoint">
    Thay `mainnet.helius-rpc.com` bằng `beta.helius-rpc.com` trong mã của bạn
  </Step>

  <Step title="Test in Development">
    Chạy bộ kiểm thử để xác minh mọi thứ hoạt động như mong đợi
  </Step>

  <Step title="Monitor Performance">
    Kiểm tra các chỉ số—bạn sẽ thấy độ trễ được cải thiện và thời gian phản hồi ổn định hơn
  </Step>

  <Step title="Deploy to Production">
    Sau khi xác minh, hãy triển khai các thay đổi lên môi trường production
  </Step>
</Steps>

## Quay lui

Nếu cần quay lui vì bất kỳ lý do nào, chỉ cần chuyển lại sang điểm cuối tiêu chuẩn:

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

## Hạn chế và các vấn đề đã biết

<Warning>
  **Trạng thái beta**: Gatekeeper đã sẵn sàng cho môi trường production nhưng vẫn đang được tối ưu hóa. Chúng tôi khuyên bạn nên kiểm thử trong môi trường phát triển trước khi chuyển lưu lượng production.
</Warning>

**Chưa được hỗ trợ:**

* **LaserStream**: Sử dụng các [điểm cuối LaserStream](/docs/vi/laserstream/grpc#điểm-cuối-mainnet) chuyên dụng cho kết nối gRPC

**Trạng thái hiện tại:**

* Một số tính năng nâng cao vẫn đang được triển khai
* Chúng tôi đang liên tục tối ưu hóa các thuật toán định tuyến
* Các hoạt động cải thiện hiệu năng vẫn đang tiếp tục

## Kế hoạch triển khai

Gatekeeper hiện là tính năng **tự nguyện tham gia** trong khi chúng tôi tối ưu hóa hiệu năng và thu thập ý kiến phản hồi.

Lộ trình:

* **Hiện tại**: Bản beta công khai khả dụng cho tất cả người dùng
* **Trong vài tuần tới**: Tiếp tục tối ưu hóa và cải thiện hiệu năng
* **Trong vài tháng tới**: Dần chuyển toàn bộ lưu lượng sang Gatekeeper làm lựa chọn mặc định

## Phản hồi và hỗ trợ

Chúng tôi đang tích cực theo dõi hiệu năng của Gatekeeper và rất mong nhận được ý kiến phản hồi của bạn:

* **Có vấn đề hoặc câu hỏi?** Liên hệ [support@helius.dev](mailto:support@helius.dev)
* **Tham gia Discord của chúng tôi** để thảo luận theo thời gian thực: [https://discord.com/invite/6GXdee3gBj](https://discord.com/invite/6GXdee3gBj)
* **Báo cáo lỗi** qua bảng điều khiển dành cho nhà phát triển

## Câu hỏi thường gặp

<AccordionGroup>
  <Accordion title="Do I need a new API key?">
    Không. Khóa API hiện tại của bạn hoạt động với Gatekeeper mà không cần bất kỳ thay đổi nào.
  </Accordion>

  <Accordion title="Will Gatekeeper cost extra?">
    Không. Gatekeeper được cung cấp mà không phát sinh thêm chi phí. Gói giá hiện tại của bạn vẫn được áp dụng.
  </Accordion>

  <Accordion title="What endpoints are supported on Gatekeeper?">
    Tất cả các điểm cuối JSON-RPC đều được hỗ trợ đầy đủ, bao gồm các phương thức RPC tiêu chuẩn của Solana, các điểm cuối RPC dành riêng cho Helius (ví dụ: gTFA), DAS, Photon, Priority Fee API và Enhanced Transactions API. WebSocket—bao gồm cả các phương thức đăng ký Solana tiêu chuẩn và những tiện ích mở rộng của Helius như `transactionSubscribe`—cũng được hỗ trợ, cùng với [Luồng đã phân tích](/docs/vi/parsed-streams).
  </Accordion>

  <Accordion title="What endpoints are not yet supported on Gatekeeper?">
    LaserStream chưa khả dụng trên Gatekeeper. Đối với kết nối gRPC, hãy sử dụng các [điểm cuối LaserStream](/docs/vi/laserstream/grpc#điểm-cuối-mainnet) chuyên dụng.
  </Accordion>

  <Accordion title="What if I encounter issues using Gatekeeper?">
    Bạn có thể dễ dàng quay lui bằng cách chuyển lại sang `mainnet.helius-rpc.com`. Liên hệ với bộ phận [hỗ trợ](https://www.helius.dev/docs/support) nếu cần trợ giúp.
  </Accordion>

  <Accordion title="When will Gatekeeper become the default?">
    Chúng tôi dự định triển khai dần trong vài tháng tới. Chúng tôi sẽ thông báo cho tất cả người dùng trước khi thực hiện bất kỳ thay đổi nào đối với các điểm cuối Helius mặc định.
  </Accordion>

  <Accordion title="Can I use Gatekeeper on Solana Devnet or Testnet?">
    Không, Gatekeeper hiện chỉ khả dụng trên Solana Mainnet. Tính năng hỗ trợ Solana Devnet và Testnet sẽ sớm ra mắt.
  </Accordion>
</AccordionGroup>

## Bắt đầu

<CardGroup cols={2}>
  <Card title="Try Gatekeeper" icon="rocket" href="https://www.helius.dev/docs/gatekeeper/migration-guide">
    Di chuyển sang Gatekeeper trong chưa đầy 5 phút
  </Card>

  <Card title="Learn About Gatekeeper" icon="book" href="https://www.helius.dev/blog/introducing-gatekeeper">
    Đọc blog của chúng tôi để tìm hiểu cách Gatekeeper hoạt động
  </Card>
</CardGroup>