Marco legal y técnico

NFT de utilidad, no de inversión

Cada colección se concibe como acceso, pertenencia y experiencias (contenido, comunidad, gamificación). No se vincula el token al rendimiento económico futuro del menor ni a derechos de explotación deportiva como “acción” o “participación” financiera.

Marco general del ecosistema: El proyecto — explicación detallada.

Mint desde el navegador (voucher + gas del usuario)

Si el contrato desplegado incluye mintWithVoucher y el operador configura MINT_SIGNER_PRIVATE_KEY y setMintSigner, el titular puede mintear desde mint.html: la API devuelve una firma, MetaMask envía la transacción y el usuario paga gas (y mintPrice si no es cero). Tras confirmar, el admin debe alinear el ledger (on_chain_token_id, tx_mint, estado).

Arquitectura técnica

Cadena: Polygon (EVM) recomendada — compatible con Ethereum y costes bajos.
Estándar: ERC-721 (cada token único) con metadatos JSON servidos por nuestra API (/api/v1/nft/metadata/{colección}/{índice}).
Ledger interno: MySQL registra índices reservados, titular (usuario/wallet), tx de mint y estado hasta alinear con contrato desplegado.
Wallet: vinculación EIP-55 desde cuenta web (MetaMask) con sesión; verificación criptográfica EIP-191 opcional si habilitas ext-gmp en PHP.

Puesta en marcha (checklist)

Entorno web: en el servidor, APP_PUBLIC_URL en .env debe ser la URL pública (sin barra final). La API servirá metadata en /api/v1/nft/metadata/{id_colección}/{índice}.
Colección y ledger: Admin → Colecciones (crear/editar) → Ledger NFT: reserva índices (token_index). Opcional: asigna titular por usuario antes del mint.
Deploy del contrato (en tu máquina con Node): NFT_BASE_URI=https://tudominio.com/api/v1/nft/metadata/{ID}/ (barra final; {ID} = id numérico de la fila en BD). Ver URL exacta en Admin al editar la colección.
Enlazar contrato: pega la dirección en Admin → Colecciones. Estado recomendado: live cuando proceda.
Mint: npm run mint:amoy o mint:polygon con NFT_CONTRACT, MINT_TO y TOKEN_ID (igual que on_chain_token_id / índice acordado).
Cuenta usuario: cuenta.html — registro, vincular MetaMask (cambia a la red con ?chain=80002 si usas Amoy). Tras mint, actualiza el token en Admin (tx, estado minted) y el usuario verá enlaces a metadata y exploradores.

Contrato inteligente

En la carpeta contracts/ del proyecto hay un contrato Hardhat listo para deploy (testnet primero). Tras el deploy, pega la dirección del contrato en el panel Admin → Colecciones y alinea los tokenId on-chain con el ledger.

Tokenomics — valor jugador / comunidad / plataforma · Ver colecciones · Cuenta y wallet · Inicio