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

> Source: https://docs.blockvectra.com/es/guides/wallet-custom-rpc/

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](#supported-chains-network-parameter-table) 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](https://blockvectra.com/es/chains/robinhood_mainnet/).

## 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](https://docs.robinhood.com/chain/connecting) 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](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/rate-limits-and-user-limits) 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`:
   ```http
   /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

| Nombre de la red | URL de RPC (clave en la ruta) | Chain ID | Símbolo de la moneda | URL del explorador de bloques |
| --- | --- | --- | --- | --- |
| [arb_mainnet](https://blockvectra.com/es/chains/arb_mainnet/) | `https://api.blockvectra.com/v1/arb_mainnet/{api_key}` | 42161 | [ETH](https://docs.arbitrum.io/build-decentralized-apps/reference/node-providers) | [arbiscan.io](https://arbiscan.io) |
| [base_mainnet](https://blockvectra.com/es/chains/base_mainnet/) | `https://api.blockvectra.com/v1/base_mainnet/{api_key}` | 8453 | [ETH](https://docs.base.org/docs/network-information/) | [basescan.org](https://basescan.org) |
| [bsc_mainnet](https://blockvectra.com/es/chains/bsc_mainnet/) | `https://api.blockvectra.com/v1/bsc_mainnet/{api_key}` | 56 | [BNB](https://docs.bnbchain.org/) | [bscscan.com](https://bscscan.com) |
| [Ethereum](https://blockvectra.com/es/chains/eth_mainnet/) | `https://api.blockvectra.com/v1/eth_mainnet/{api_key}` | 1 | [ETH](https://ethereum.org/) | [etherscan.io](https://etherscan.io) |
| [eth_sepolia](https://blockvectra.com/es/chains/eth_sepolia/) | `https://api.blockvectra.com/v1/eth_sepolia/{api_key}` | 11155111 | [SepoliaETH](https://ethereum.org/en/developers/docs/networks/#sepolia) | [sepolia.etherscan.io](https://sepolia.etherscan.io) |
| [HyperEVM](https://blockvectra.com/es/chains/hyperevm_mainnet/) | `https://api.blockvectra.com/v1/hyperevm_mainnet/{api_key}` | 999 | [HYPE](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm) | [hyperscan.com](https://www.hyperscan.com/) |
| [polygon_mainnet](https://blockvectra.com/es/chains/polygon_mainnet/) | `https://api.blockvectra.com/v1/polygon_mainnet/{api_key}` | 137 | [POL](https://docs.polygon.technology/) | [polygonscan.com](https://polygonscan.com) |
| [Robinhood Chain](https://blockvectra.com/es/chains/robinhood_mainnet/) | `https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}` | 4663 | [ETH](https://docs.robinhood.com/chain/connecting) | [robinhoodchain.blockscout.com](https://robinhoodchain.blockscout.com) |
| [robinhood_testnet](https://blockvectra.com/es/chains/robinhood_testnet/) | `https://api.blockvectra.com/v1/robinhood_testnet/{api_key}` | 46630 | [ETH](https://docs.robinhood.com/chain/connecting) | [explorer.testnet.chain.robinhood.com](https://explorer.testnet.chain.robinhood.com) |

> **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](https://docs.blockvectra.com/es/guides/hyperevm-backfill/#deploy-with-foundry-or-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](https://docs.blockvectra.com/en/guides/one-key-many-chains/).

## 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](https://support.metamask.io/networks-and-sidechains/managing-networks/how-to-add-a-custom-network-rpc/):

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](https://docs.blockvectra.com/es/guides/hyperevm-backfill/#deploy-with-foundry-or-hardhat)).

> **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](https://blockvectra.com/es/pricing/)), con cargo a los límites de su cuenta.
2. **Cree una API key dedicada para cada billetera**:
   En la [Consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F), 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?](https://docs.blockvectra.com/en/guides/programmatic-signup/#lost-your-session-or-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](https://docs.blockvectra.com/es/guides/evm-historical-state/): 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](https://docs.blockvectra.com/en/guides/one-key-many-chains/): 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](https://blockvectra.com/es/pricing/): 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](https://blockvectra.com/es/data/) para ver todos los conjuntos de datos indexados por BlockVectra.
* [Consulte el plan gratuito y los precios](https://blockvectra.com/es/pricing/#free) para comprobar lo que incluye su cuenta.
* [Inicie sesión en la consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F) para crear una API key.