Robinhood Chain: dữ liệu on-chain và cổ phiếu token hóa, gọi JSON-RPC và Data API chỉ với một khóa →

BlockVectraTài liệu
Hướng dẫn

Cấu hình RPC tùy chỉnh cho MetaMask và Rabby: URL và Chain ID

Thêm URL RPC BlockVectra vào MetaMask hoặc Rabby. Tìm Chain ID và ký hiệu tài sản gốc, cấu hình API key trong đường dẫn và quản lý key riêng cho ví.

Thêm URL RPC, Chain ID và ký hiệu tài sản gốc trong MetaMask hoặc Rabby, và dùng key riêng cho ví khi cần xác thực.

  • Bước đầu tiên: Đọc bảng tham số mạng cho ví và nhập các trường vào ví, dùng /v1/{chain}/{api_key} cho RPC có xác thực.
  • Hoàn thành khi: Thao tác lưu thêm mạng và chuyển sang mạng đó trong MetaMask; Chain ID đã cấu hình khớp ID endpoint trả về.

Tham số chuỗi và tùy chọn truy cập.

1. Vì sao dùng RPC tùy chỉnh

Hệ sinh thái blockchain thường cung cấp endpoint RPC công khai mặc định cho nhu cầu cơ bản của cộng đồng và nhà phát triển mới bắt đầu. Tuy nhiên, tài liệu mạng chính thức quy định rõ giới hạn tốc độ và phạm vi sử dụng cho các endpoint này:

  • Robinhood Chain: Trang tài liệu chính thức Kết nối với Robinhood Chain nêu rằng endpoint công khai https://rpc.mainnet.chain.robinhood.com bị giới hạn tốc độ và không được khuyến nghị cho tác vụ production (Các endpoint công khai sau đây khả dụng nhưng bị giới hạn tốc độ và không được khuyến nghị cho production. Với production, hãy dùng nhà cung cấp).
  • HyperEVM: Trang tài liệu chính thức Giới hạn tốc độ và giới hạn người dùng quy định giới hạn theo IP cho endpoint công khai rpc.hyperliquid.xyz/evm là tối đa 100 yêu cầu EVM JSON-RPC mỗi phút (Tối đa 100 yêu cầu EVM JSON-RPC mỗi phút cho rpc.hyperliquid.xyz/evm).

2. Các trường bắt buộc trong ví và tham số mạng

Ví EVM yêu cầu một số trường cụ thể khi thêm hoặc chỉnh sửa mạng:

  1. Tên mạng: Nhãn dễ đọc hiển thị trong giao diện ví.
  2. RPC URL: Endpoint giao tiếp. API key phải nằm trong đường dẫn URL, dùng đường dẫn /v1/{chain}/{api_key} trên api.blockvectra.com: 
    /v1/{chain}/{api_key}

    Quan trọng: Ví như MetaMask và Rabby chỉ chấp nhận URL HTTP(S) tiêu chuẩn trong trường RPC URL và không hỗ trợ header yêu cầu tùy chỉnh (chẳng hạn x-api-key: {api_key}). Vì vậy, kết nối ví phải cung cấp API key trực tiếp trong đường dẫn URL. Không thêm dấu gạch chéo cuối sau {api_key}, và lưu ý yêu cầu tới {chain} không được biết đến trả HTTP 404.

  3. Chain ID: Định danh chuỗi dạng số nguyên theo EIP-155.
  4. Ký hiệu tiền tệ: Ký hiệu tài sản gas gốc của chuỗi (ví dụ ETH, HYPE).
  5. URL trình khám phá khối: Địa chỉ web chính của trình khám phá khối của mạng.

Bảng tham số mạng của các chuỗi được hỗ trợ

Tên mạngURL RPC (Key trên đường dẫn)Chain IDKý hiệu tiền tệURL trình khám phá khối
arb_mainnethttps://api.blockvectra.com/v1/arb_mainnet/{api_key}42161ETHarbiscan.io
base_mainnethttps://api.blockvectra.com/v1/base_mainnet/{api_key}8453ETHbasescan.org
bsc_mainnethttps://api.blockvectra.com/v1/bsc_mainnet/{api_key}56BNBbscscan.com
Ethereumhttps://api.blockvectra.com/v1/eth_mainnet/{api_key}1ETHetherscan.io
eth_sepoliahttps://api.blockvectra.com/v1/eth_sepolia/{api_key}11155111SepoliaETHsepolia.etherscan.io
HyperEVMhttps://api.blockvectra.com/v1/hyperevm_mainnet/{api_key}999HYPEhyperscan.com
polygon_mainnethttps://api.blockvectra.com/v1/polygon_mainnet/{api_key}137POLpolygonscan.com
Robinhood Chainhttps://api.blockvectra.com/v1/robinhood_mainnet/{api_key}4663ETHrobinhoodchain.blockscout.com
robinhood_testnethttps://api.blockvectra.com/v1/robinhood_testnet/{api_key}46630ETHexplorer.testnet.chain.robinhood.com

Giới hạn chỉ đọc của HyperEVM: Endpoint HyperEVM của BlockVectra hỗ trợ đọc nhưng không phát giao dịch. Dùng RPC hỗ trợ eth_sendRawTransaction khi gửi từ ví. Xem Triển khai bằng Foundry hoặc Hardhat trong hướng dẫn HyperEVM để biết chi tiết phát giao dịch.

Một API key hoạt động trên các chuỗi được hỗ trợ bằng cách thay {chain} trong đường dẫn bằng slug chuỗi mong muốn. Để biết chi tiết hạn mức dùng chung và định tuyến URL, xem hướng dẫn một key, nhiều chuỗi.

3. Hướng dẫn từng bước cho ví

Các bước cấu hình MetaMask

Theo hướng dẫn trợ giúp MetaMask chính thức Cách thêm RPC mạng tùy chỉnh:

  1. Mở tiện ích trình duyệt hoặc ứng dụng di động MetaMask.
  2. Nhấp danh sách chọn mạng ở đầu giao diện (hoặc vào Cài đặt > Mạng).
  3. Chọn Thêm mạng, rồi chọn Thêm mạng thủ công ở cuối.
  4. Điền thông tin mạng theo bảng phía trên:
    • Tên mạng: Nhập tên chuỗi từ bảng phía trên.
    • URL RPC mới: Nhập endpoint xác thực bằng đường dẫn, chẳng hạn https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} (thay {api_key} bằng API key thực tế).
    • Chain ID: Nhập Chain ID dạng số nguyên từ bảng phía trên.
    • Ký hiệu tiền tệ: Nhập ký hiệu tài sản gốc từ bảng phía trên.
    • URL trình khám phá khối: Nhập địa chỉ trình khám phá khối chính thức từ bảng phía trên (tùy chọn).
  5. Nhấp Lưu để thêm mạng và chuyển sang mạng đó.

Gửi giao dịch trên HyperEVM: Endpoint HyperEVM của BlockVectra hỗ trợ đọc nhưng không phát giao dịch. Dùng RPC hỗ trợ eth_sendRawTransaction khi gửi từ ví (xem giải thích về phát giao dịch trên HyperEVM).

Chỉnh sửa mạng hiện có: Để cập nhật endpoint RPC cho mạng đã có trong danh sách, vào Cài đặt > Mạng, chọn mạng mục tiêu, chỉnh sửa hoặc thêm URL BlockVectra trong trường RPC URL, rồi lưu thay đổi.

Các bước cấu hình Rabby Wallet

Trong phần cài đặt mạng tùy chỉnh hoặc RPC tùy chỉnh của Rabby, nhập tham số từ bảng phía trên: Tên mạng, RPC URL (với key trong đường dẫn https://api.blockvectra.com/v1/{chain}/{api_key}), Chain ID, Ký hiệu tiền tệ và URL trình khám phá khối.

Lưu ý: Khi thêm mạng tùy chỉnh hoặc testnet, bảo đảm Chain ID khớp ID endpoint trả về để tránh lỗi không khớp ID mạng.

4. Mẹo bảo mật và quản lý sử dụng

Ghi nhớ các nguyên tắc bảo mật và thanh toán sau khi vận hành RPC tùy chỉnh:

[!WARNING] Nguy cơ lộ API key: Đường dẫn URL RPC chứa API key dưới dạng văn bản thuần. Tuyệt đối không chia sẻ ảnh chụp cấu hình mạng của ví trong phòng chat hoặc diễn đàn công khai, và không commit URL chứa key đang dùng vào kho mã hoặc tài liệu công khai.

  1. Yêu cầu của ví tính vào mức sử dụng tài khoản: Mở ví, chuyển tài khoản hoặc làm mới danh sách tài sản sẽ kích hoạt lệnh gọi JSON-RPC trực tiếp (chẳng hạn eth_blockNumber, eth_getBalance và eth_call). Các yêu cầu này tiêu thụ dung lượng theo trọng số CU của phương thức được gọi (xem trang giá) trong giới hạn tài khoản.
  2. Tạo API key riêng cho từng ví: Trong Bảng điều khiển, tạo API key riêng có nhãn dành cho ví (ví dụ metamask-desktop hoặc rabby-extension). Việc này tách lưu lượng ví cá nhân khỏi ứng dụng máy chủ, script tự động và AI Agent.
  3. Thu hồi riêng khi bị lộ: Nếu nghi ngờ API key cấu hình trong ví đã bị lộ, lập tức thu hồi riêng key đó trong bảng điều khiển mà không ảnh hưởng các key hoặc dịch vụ khác đang chạy. Nếu phiên hết hạn hoặc mất key, xem Mất phiên hoặc API key? trong hướng dẫn đăng ký bằng chương trình để lấy lại quyền kiểm soát bằng chữ ký ví Ethereum.

5. Tài nguyên liên quan

  • Giới hạn trạng thái lịch sử: Kiểm tra cửa sổ trạng thái có xác thực và lịch sử không cần key trước khi yêu cầu số dư hoặc giá trị hợp đồng trước đó; khoảng truy vấn log là giới hạn riêng.
  • Hướng dẫn một key, nhiều chuỗi: Quy tắc định tuyến URL chi tiết, khám phá bằng chương trình qua GET /v1/chains và cơ chế hạn mức giữa các chuỗi.
  • Giá và giới hạn gói: Thông tin trọng số CU, tốc độ bổ sung thông lượng và nâng cấp bằng nạp tiền thanh toán.

Các bước tiếp theo

Cập nhật lần cuối:

Trang tài sản ví

Xây dựng trang tài sản ví với số dư token ERC-20 khác 0, lịch sử chuyển token và siêu dữ liệu theo lô. Kiểm tra phạm vi chuỗi, phân trang kết quả và quy đổi số tiền nguyên theo decimals.

Webhook push

Tạo đăng ký địa chỉ qua HTTP, xác minh chữ ký trên raw body, loại bỏ trùng lặp theo ID sự kiện và khôi phục các mục khớp được lưu giữ hoặc các khối bị thiếu.

Trên trang này

1. Vì sao dùng RPC tùy chỉnh2. Các trường bắt buộc trong ví và tham số mạngBảng tham số mạng của các chuỗi được hỗ trợ3. Hướng dẫn từng bước cho víCác bước cấu hình MetaMaskCác bước cấu hình Rabby Wallet4. Mẹo bảo mật và quản lý sử dụng5. Tài nguyên liên quanCác bước tiếp theo