Saltar al contenido principal

Despliega en QoreChain en 5 Minutos

Esta página es para un desarrollador de Solidity que nunca ha usado QoreChain. Sigues con Foundry o Hardhat y con la misma frase de recuperación que usas en MetaMask. Lo único nuevo es una breve ventana de autorización: QoreChain protege cada cuenta con una clave post-cuántica, una transacción de Ethereum no puede llevarla, así que primero abres una ventana acotada y tus transacciones EVM normales se admiten mientras está abierta. Los pasos siguientes usan la testnet (qorechain-diana, chain ID EVM 9800), donde nada cuesta dinero real.

nota

Este camino se ejecutó en la testnet: se abrió una ventana en QoreX y después se creó y se llamó a un contrato con Foundry cast desde la misma frase de recuperación. forge create y Hardhat envían el mismo tipo de transacción EVM, pero no formaron parte de esa prueba. También está confirmada una ventana abierta desde la línea de comandos de qorechaind; consulta Alternativa: la línea de comandos.

Lo que necesitas​

  • La frase de recuperación de la cuenta desde la que quieras desplegar. QoreX no puede importar una clave privada en bruto. Si solo tienes una clave privada, usa en su lugar la línea de comandos.
  • QoreX, el monedero de QoreChain (aplicación o extensión del navegador).
  • Foundry o Hardhat ya instalado.

1. Añade una cuenta coin 60 a QoreX​

El carril EVM solo funciona con una clave eth_secp256k1 (coin type 60). Una clave estándar secp256k1 de Cosmos (coin type 118, el valor por defecto de QoreX) no puede firmar para su dirección EVM, así que una ventana abierta en una cuenta coin 118 no sirve de nada para las herramientas EVM. Necesitas una cuenta de Ethereum (coin 60). En QoreX abre Your accounts y toca Add an Ethereum account (coin 60). QoreX la deriva de la propia frase de recuperación del monedero con la ruta de Ethereum m/44'/60'. Su dirección 0x… coincide con la de MetaMask o Foundry solo cuando estos usan esa misma frase (para Foundry, ruta de derivación m/44'/60'/0'/0/0, índice 0). Si tu cuenta de MetaMask proviene de otra frase, QoreX muestra una dirección distinta, y una ventana abierta allí no cubre la clave con la que despliegas. La dirección 0x… es la misma clave que una dirección qor1… en QoreChain.

La cuenta tiene su propia dirección, así que fóndala y selecciónala en QoreX antes de los pasos siguientes. Consulta Restaurar una frase de MetaMask o del Dashboard.

Nunca pegues una frase de producción en herramientas de desarrollo

Usa una frase de recuperación creada para pruebas, solo con QOR de prueba. No escribas en Foundry, Hardhat ni en un script la frase de una cuenta que tenga fondos reales.

2. Cambia QoreX a la testnet​

  • Aplicación: Ajustes → Use testnet (developers).
  • Extensión del navegador: desbloquéala, toca siete veces el número de versión de la parte inferior y elige Switch to testnet (diana).

La insignia de red en Inicio cambia a TESTNET.

3. Consigue QOR de testnet​

Solicita QOR de testnet para tu dirección 0x… o qor1… en el Faucet del Dashboard. Es el mismo saldo en ambas formas de la dirección.

4. Abre la ventana EVM en QoreX​

  • Extensión y aplicación: la tarjeta titulada MetaMask on QoreChain (con una marca 0x) en la ventana emergente principal o en Inicio. Abre la pantalla Ventana de acceso EVM.
  • Aplicación: también Ajustes → Seguridad → Ventana de acceso EVM.

Si esta cuenta aún no tiene una clave post-cuántica, QoreX la registra por ti en este paso. El registro cuesta 0,09 QOR, una sola vez por cuenta, y la transacción de la ventana paga además su propia comisión de red. Después eliges tres límites:

CampoRangoValor por defecto de QoreX
Bloques (cuánto tiempo permanece abierta la ventana)1 a 17.280300
Máximo de transacciones1 a 1.0005
Tope de gasto, en QORmayor que 01

El tope de gasto cuenta el valor de cada transacción más su comisión máxima (límite de gas por el tope de comisión), no solo lo que transfiere. Un despliegue de contrato no mueve QOR pero aun así cuenta su comisión máxima: un despliegue de 3.000.000 de gas enviado por Hardhat cuenta unos 0,64 QOR.

Para una sesión de despliegue los valores por defecto se quedan cortos. Una elección razonable es 3.000 bloques (aproximadamente una hora en la testnet), 20 transacciones y un tope de 10 QOR. Mantenlos tan pequeños como permita tu sesión y cierra la ventana cuando termines.

Abre la ventana primero

Abrir una ventana avanza el nonce de la cuenta. Ábrela antes de desplegar: una transacción firmada antes se rechaza con "nonce too low".

5. Despliega con Foundry o Hardhat​

Usa la clave de la misma cuenta coin 60 con fondos. QoreX no puede actuar como firmante de Foundry, así que dale a Foundry o a Hardhat la clave de la misma frase de recuperación, por ejemplo --mnemonic con el índice 0 en Foundry. La configuración de red:

AjusteValor
URL RPChttps://evm-testnet.qore.host
Chain ID9800
MonedaQOR, 18 decimales

Foundry

export ETH_RPC_URL=https://evm-testnet.qore.host

forge create src/Counter.sol:Counter --private-key $DEPLOYER_KEY --broadcast
cast send <contract> "increment()" --private-key $DEPLOYER_KEY
cast call <contract> "number()(uint256)"

Hardhat

// hardhat.config.js
module.exports = {
solidity: "0.8.24",
networks: {
diana: {
url: "https://evm-testnet.qore.host",
chainId: 9800,
accounts: [process.env.DEPLOYER_KEY],
},
},
};
DEPLOYER_KEY=0x... npx hardhat run scripts/deploy.js --network diana

Cada transacción que envías (despliegue o llamada) usa una de las transacciones de la ventana. Las lecturas (cast call, funciones view, estimación de gas) no necesitan ventana y no consumen nada de ella.

Comprueba la ventana y gestiona su caducidad​

Una ventana caduca: cuando se agotan sus bloques, sus transacciones o su tope de gasto, la vía EVM rechaza tu siguiente transacción con no open EVM authorisation window o EVM authorisation window exhausted. Abre una nueva en QoreX; una ventana nueva reemplaza a la anterior.

Para ver su estado, usa la pestaña PQ key status de dashboard.qorechain.io/developers (consulta Desarrolladores), o la ruta REST:

curl -s https://api-testnet.qore.host/qorechain/pqc/v1/evm_window/<qor1-address>

live: true con remaining_blocks, remaining_txs y remaining_value (en uqor) significa que está abierta.

Alternativa: la línea de comandos​

Con el binario de la versión oficial de qorechaind puedes importar una clave privada en bruto, registrar su clave post-cuántica y abrir la ventana sin QoreX. Esta es la vía para un desarrollador que solo tiene una clave privada. gen-key y cosign no están en una compilación de la comunidad, así que esto requiere el binario de la versión oficial. Las reglas de la ventana están en la sección Ventana de autorización EVM de Desarrollo EVM. Una ventana abierta así, seguida de una transacción enviada con cast, está confirmada en la testnet.

export QNODE=https://rpc-testnet.qore.host:443
export QCHAIN=qorechain-diana

# import the private key as an eth_secp256k1 key: the qor1... and 0x... addresses are one account
qorechaind keys import-hex deployer <private-key-hex-without-0x> --key-type eth_secp256k1

# register a post-quantum key once per account (back up the .dilithium file)
qorechaind tx pqc gen-key deployer-mldsa
qorechaind tx pqc register-key-v2 dilithium5 <public_key_hex> hybrid --pqc-key deployer-mldsa \
--from deployer --chain-id $QCHAIN --node $QNODE --gas auto --gas-adjustment 1.3 --gas-prices 0.2uqor

# open the window

qorechaind tx pqc open-evm-window 3000 20 10qor --from deployer \
--chain-id $QCHAIN --node $QNODE --gas 400000 --fees 80000uqor --generate-only > window.json
qorechaind tx pqc cosign window.json --from deployer --pqc-key deployer-mldsa \
--chain-id $QCHAIN --node $QNODE

No estreches una ventana de despliegue con --native-only ni con --allowed-targets: ambos rechazan la creación de contratos. Son para sesiones posteriores, una vez que el contrato existe.

Qué es distinto en la testnet​

  • CosmWasm solo acepta códigos aprobados por gobernanza en la testnet, así que no puedes subir tu propio contrato allí. Solidity es el camino abierto.
  • SVM no está disponible.
  • La mainnet funciona de la misma manera con el chain ID 9801 y https://evm.qore.host, pero empieza en la testnet.

Errores comunes​

MensajeCausaSolución
account ... has no registered post-quantum keyla cuenta no tiene clave ML-DSA-87abre una ventana en QoreX, que la registra, o regístrala desde la línea de comandos
no open EVM authorisation windowno hay ventana, o caducóabre una ventana
EVM authorisation window exhaustedse agotaron las transacciones o el tope de gastoabre una ventana nueva con límites mayores
nonce too lowla ventana se abrió después de que firmarasabre primero la ventana y luego envía
only replay-protected (EIP-155) Ethereum transactions are accepteduna transacción firmada sin chain IDdefine chainId en la configuración de tu red

Siguiente: Desarrollo EVM, Seguridad y recuperación de QoreX, Desarrolladores.