URL RPC de Base: acceso sin clave y ejemplos de curl y viem

Empiece con la URL RPC pública de la red principal de Base que aparece a continuación para leer el chain ID sin API key. Consulte los métodos admitidos y los límites por IP en la página de la cadena Base; use una clave para los métodos permitidos por la cadena que no figuren en 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":[]}'

Información de la red y endpoints

Cada solicitud a Base identifica explícitamente la red de destino en la ruta de la URL mediante el slug base_mainnet. JSON-RPC admite tanto la autenticación con clave en la ruta como la autenticación mediante encabezado de solicitud (x-api-key).

Ejemplos directos de curl y viem

Puede realizar llamadas JSON-RPC directamente con curl o bibliotecas cliente web3 como viem. Defina su API key en la variable de entorno 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":[]}'

Estructura de la respuesta

Las respuestas siguen la especificación JSON-RPC 2.0:

• Éxito: Devuelve un objeto que contiene jsonrpc: "2.0", un entero id coincidente y result codificado en hexadecimal (eth_chainId devuelve el chain ID codificado en hexadecimal; eth_blockNumber devuelve la altura del último bloque).
• Métodos no permitidos: Solicitar un método que no figure entre los permitidos por la red devuelve el código de error JSON-RPC -32601 (method not available, no facturado).
• Consultas fuera de la ventana: Las solicitudes de estado histórico anteriores a la ventana de retención del estado devuelven el código de error JSON-RPC -32011 (no facturado).
• API key ausente: Omitir la clave devuelve HTTP 401 con el código de error JSON-RPC -32024 (missing_api_key, no facturado).
• Parámetros no válidos: Los parámetros de solicitud mal formados devuelven el código de error JSON-RPC -32602 (no facturado).

Capacidades y política de métodos

Valores en tiempo real: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Data API de blockchain

Valores en tiempo real: GET /v1/chains (data).

Primeros pasos y API keys

• Consola web: Regístrese mediante una firma de billetera Ethereum y genere una API key en la Consola. Consulte la guía de inicio rápido para obtener detalles de configuración.
• Registro programático: Los agentes autónomos de IA, los scripts automatizados y los pipelines de CI pueden iniciar sesión y aprovisionar API keys mediante firmas de billetera Ethereum (EIP-191) sin navegador. Siga la guía de registro programático.
• Agentes de IA: Los agentes autónomos de IA pueden descubrir las capacidades de Base mediante el servidor oficial del Model Context Protocol (MCP). Consulte Conectar agentes de IA a BlockVectra.
• Ampliación de límites: Tras una recarga, se elimina el límite de llamadas por segundo a nivel de cuenta; cada clave sigue sujeta a los límites de frecuencia y ráfaga de unidades de cómputo (CU). Para conocer las tarifas y unidades de facturación actuales, consulte la página de Precios.

Guías y recursos relacionados

• Documentación para desarrolladores de Base: Para conocer las especificaciones de la red, la mecánica del gas y los contratos en Base, consulte la documentación oficial de Base.
• RPC personalizado en billeteras: Configure endpoints RPC personalizados para Base en MetaMask y Rabby mediante la guía de RPC personalizado en billeteras.
• Simulación de transacciones: Pruebe la ejecución de transacciones y evalúe los cambios de estado antes de transmitirlas mediante eth_simulateV1 en la guía de simulación de transacciones.

Próximos pasos

• Explore el catálogo de conjuntos de datos para ver todos los conjuntos de datos que indexa BlockVectra.
• Consulte el plan gratuito y los precios para comprobar qué incluye su cuenta.
• Inicie sesión en la consola para crear una API key.