Base RPC URL: truy cập không cần key, ví dụ curl và viem

Bắt đầu với RPC URL công khai của Base mainnet bên dưới để đọc chain ID mà không cần API key. Kiểm tra các phương thức được hỗ trợ và giới hạn theo IP trên trang chuỗi Base; dùng key cho các phương thức mà chuỗi cho phép nằm ngoài public.methods.

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Thông tin mạng và endpoint

Mỗi yêu cầu tới Base xác định rõ mạng đích trong đường dẫn URL bằng slug base_mainnet. JSON-RPC hỗ trợ cả xác thực bằng key trong đường dẫn và xác thực qua header yêu cầu (x-api-key).

Ví dụ gọi trực tiếp bằng curl và viem

Bạn có thể thực hiện lệnh gọi JSON-RPC trực tiếp bằng curl hoặc thư viện client web3 như viem. Đặt API key trong biến môi trường BLOCKVECTRA_API_KEY:

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Cấu trúc phản hồi

Phản hồi tuân theo đặc tả JSON-RPC 2.0:

• Thành công: Trả về một đối tượng chứa jsonrpc: "2.0", số nguyên id khớp với yêu cầu và result được mã hóa thập lục phân (eth_chainId trả về chain ID dạng thập lục phân; eth_blockNumber trả về chiều cao khối mới nhất).
• Phương thức không được phép: Yêu cầu một phương thức ngoài các phương thức được mạng cho phép trả về mã lỗi JSON-RPC -32601 (method not available, không tính phí).
• Truy vấn ngoài cửa sổ: Yêu cầu trạng thái lịch sử trước cửa sổ lưu giữ trạng thái trả về mã lỗi JSON-RPC -32011 (không tính phí).
• Thiếu API key: Không cung cấp key trả về HTTP 401 với mã lỗi JSON-RPC -32024 (missing_api_key, không tính phí).
• Tham số không hợp lệ: Tham số yêu cầu sai định dạng trả về mã lỗi JSON-RPC -32602 (không tính phí).

Khả năng hỗ trợ và chính sách phương thức

Giá trị hiện tại: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Data API blockchain

Giá trị hiện tại: GET /v1/chains (data).

Bắt đầu và API key

• Console web: Đăng ký bằng chữ ký ví Ethereum và tạo API key trong Console. Xem hướng dẫn bắt đầu nhanh để biết chi tiết thiết lập.
• Đăng ký bằng chương trình: AI agent tự chủ, script tự động và pipeline CI có thể đăng nhập và tạo API key bằng chữ ký ví Ethereum (EIP-191) mà không cần trình duyệt. Làm theo hướng dẫn đăng ký bằng chương trình.
• AI agent: AI agent tự chủ có thể khám phá các khả năng của Base bằng server Model Context Protocol (MCP) chính thức. Xem Kết nối AI Agent với BlockVectra.
• Nâng giới hạn: Sau khi nạp tiền, giới hạn lệnh gọi mỗi giây trên toàn tài khoản được gỡ bỏ; mỗi key vẫn chịu giới hạn tốc độ và burst Compute Unit (CU). Để biết mức giá và đơn vị tính phí hiện tại, xem Trang bảng giá.

Hướng dẫn và tài nguyên liên quan

• Tài liệu dành cho nhà phát triển Base: Để biết đặc tả mạng, cơ chế gas và hợp đồng trên Base, xem tài liệu Base chính thức.
• RPC tùy chỉnh cho ví: Cấu hình endpoint RPC tùy chỉnh cho Base trong MetaMask và Rabby theo hướng dẫn RPC tùy chỉnh cho ví.
• Mô phỏng giao dịch: Kiểm thử thực thi giao dịch và đánh giá thay đổi trạng thái trước khi phát giao dịch bằng eth_simulateV1 trong hướng dẫn mô phỏng giao dịch.

Các bước tiếp theo

• Khám phá danh mục bộ dữ liệu để xem mọi bộ dữ liệu mà BlockVectra lập chỉ mục.
• Xem gói miễn phí và bảng giá để kiểm tra những gì tài khoản của bạn bao gồm.
• Đăng nhập vào console để tạo API key.