Configurar un RPC personalizado en MetaMask y Rabby: URL y Chain ID

Añada la URL RPC, el ID de cadena y el símbolo nativo en MetaMask o Rabby, y utilice una clave dedicada para la billetera cuando se requiera autenticación.

• Primer paso: Lea la tabla de parámetros de red de billeteras e introduzca sus campos en su billetera, utilizando /v1/{chain}/{api_key} para RPC autenticado.
• Se completa cuando: Al guardar, se añade la red y se cambia a ella en MetaMask; el ID de cadena configurado coincide con el ID devuelto por el endpoint.

Parámetros de cadena y opciones de acceso.

1. Por qué utilizar un RPC personalizado

Los ecosistemas blockchain suelen ofrecer endpoints RPC públicos predeterminados para el uso básico de la comunidad y la incorporación de desarrolladores. Sin embargo, la documentación oficial de las redes define límites de tasa y ámbitos de uso explícitos para estos endpoints:

• Robinhood Chain: La página de documentación oficial Conectarse a Robinhood Chain señala que el endpoint público https://rpc.mainnet.chain.robinhood.com tiene límites de tasa y no se recomienda para cargas de producción (Los siguientes endpoints públicos están disponibles, pero tienen límites de tasa y no se recomiendan para uso en producción. Para producción, utilice un proveedor).
• HyperEVM: La página de documentación oficial Límites de tasa y límites de usuario especifica un límite por IP para el endpoint público rpc.hyperliquid.xyz/evm de un máximo de 100 solicitudes EVM JSON-RPC por minuto (Máximo de 100 solicitudes EVM JSON-RPC por minuto para rpc.hyperliquid.xyz/evm).

2. Campos obligatorios de la billetera y parámetros de red

Las billeteras EVM requieren varios campos específicos al añadir o editar una red:

1. Nombre de red: La etiqueta legible por humanos que se muestra en la interfaz de la billetera.
2. URL RPC: El endpoint de comunicación. La API key debe colocarse en la ruta de la URL, utilizando la ruta /v1/{chain}/{api_key} en api.blockvectra.com:

   Copiar texto

   /v1/{chain}/{api_key}

   Importante: Las billeteras como MetaMask y Rabby solo aceptan URLs HTTP(S) estándar en su campo de URL RPC y no admiten encabezados de solicitud personalizados (como x-api-key: {api_key}). Por tanto, las conexiones de billeteras deben proporcionar la API key directamente en la ruta de la URL. No incluya una barra final después de {api_key} y tenga en cuenta que las solicitudes dirigidas a un {chain} desconocido devuelven HTTP 404.

3. Chain ID: El identificador entero de cadena EIP-155.
4. Símbolo de moneda: El símbolo del activo nativo de gas de la cadena (p. ej., ETH, HYPE).
5. URL del explorador de bloques: La dirección web principal del explorador de bloques de la red.

Tabla de parámetros de red de cadenas compatibles

Limitación de solo lectura de HyperEVM: El endpoint HyperEVM de BlockVectra admite lecturas, pero no transmite transacciones. Utilice un RPC compatible con eth_sendRawTransaction al enviar desde su billetera. Consulte Desplegar con Foundry o Hardhat en la guía de HyperEVM para conocer los detalles de transmisión.

Una API key funciona en las cadenas compatibles al sustituir {chain} en la ruta por el slug de la cadena deseada. Para conocer las cuotas compartidas y el enrutamiento de URLs, consulte la guía Una clave, muchas cadenas.

3. Instrucciones paso a paso para billeteras

Pasos de configuración de MetaMask

Según la guía de ayuda oficial de MetaMask Cómo añadir un RPC de red personalizado:

1. Abra la extensión de navegador o la aplicación móvil de MetaMask.
2. Haga clic en el selector desplegable de redes en la parte superior de la interfaz (o vaya a Configuración > Redes).
3. Seleccione Añadir red y después Añadir una red manualmente en la parte inferior.
4. Complete los datos de la red utilizando la tabla anterior:
   • Nombre de red: Introduzca el nombre de la cadena de la tabla anterior.
   • Nueva URL RPC: Introduzca su endpoint autenticado por ruta, como https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} (sustituya {api_key} por su API key real).
   • Chain ID: Introduzca el ID de cadena entero de la tabla anterior.
   • Símbolo de moneda: Introduzca el símbolo del activo nativo de la tabla anterior.
   • URL del explorador de bloques: Introduzca la dirección oficial del explorador de bloques de la tabla anterior (opcional).
5. Haga clic en Guardar para añadir la red y cambiar a ella.

Enviar transacciones en HyperEVM: El endpoint HyperEVM de BlockVectra admite lecturas, pero no transmite transacciones. Utilice un RPC compatible con eth_sendRawTransaction al enviar desde su billetera (consulte la explicación sobre la transmisión en HyperEVM).

Editar una red existente: Para actualizar el endpoint RPC de una red que ya está en su lista, vaya a Configuración > Redes, seleccione la red de destino, edite o añada su URL de BlockVectra en el campo de URL RPC y guarde los cambios.

Pasos de configuración de Rabby Wallet

En la configuración de red personalizada o RPC personalizado de Rabby, introduzca los parámetros de la tabla anterior: nombre de red, URL RPC (con la clave en la ruta https://api.blockvectra.com/v1/{chain}/{api_key}), Chain ID, símbolo de moneda y URL del explorador de bloques.

Nota: Al añadir una red personalizada o testnet, asegúrese de que el Chain ID coincida con el ID devuelto por el endpoint para evitar errores de discrepancia de ID de red.

4. Consejos de seguridad y gestión del uso

Tenga presentes los siguientes principios de seguridad y facturación al utilizar un RPC personalizado:

[!WARNING] Riesgo de exposición de la API key: La ruta de la URL RPC contiene su API key en texto plano. Nunca comparta capturas de la configuración de red de su billetera en chats o foros públicos ni incluya URLs con su clave activa en repositorios de código o documentación públicos.

1. Las solicitudes de la billetera cuentan para el uso de la cuenta: Abrir la billetera, cambiar de cuenta o actualizar las listas de activos genera llamadas JSON-RPC en tiempo real (como eth_blockNumber, eth_getBalance y eth_call). Estas solicitudes consumen capacidad según el peso CU del método llamado (consulte la página de precios), con cargo a los límites de su cuenta.
2. Cree una API key dedicada para cada billetera: En la Consola, cree una API key dedicada con una etiqueta específica para su billetera (p. ej., metamask-desktop o rabby-extension). Esto aísla el tráfico de su billetera personal del de sus aplicaciones de servidor, scripts automatizados y agentes de IA.
3. Revocación independiente en caso de exposición: Si sospecha que una API key configurada en una billetera ha quedado expuesta, revoque inmediatamente esa clave individual en la consola sin afectar a las demás claves o servicios en ejecución. Si su sesión caduca o pierde una clave, consulte ¿Perdió su sesión o API key? en la guía de registro programático para recuperar el control mediante la firma de su billetera Ethereum.

5. Recursos relacionados

• Límites de estado histórico: Compruebe las ventanas de estado autenticadas y el historial sin clave antes de solicitar un saldo o valor de contrato anterior; la amplitud de las consultas de logs es un límite distinto.
• Guía Una clave, muchas cadenas: Reglas detalladas de enrutamiento de URLs, descubrimiento programático con GET /v1/chains y mecanismos de cuotas entre cadenas.
• Precios y límites de planes: Información sobre pesos CU, tasas de reposición de capacidad y mejoras mediante recargas.

Próximos pasos

• Explore el directorio de conjuntos de datos para ver todos los conjuntos de datos indexados por BlockVectra.
• Consulte el plan gratuito y los precios para comprobar lo que incluye su cuenta.
• Inicie sesión en la consola para crear una API key.