# Operaciones ### Registrar un nombre El registro de nombres se realiza llamando a la función correspondiente del contrato BNSv2. El llamador se convierte en el propietario del nombre. **Flujo de alto nivel:** 1. Comprobar disponibilidad 2. Enviar transacción de registro 3. Pagar la tarifa STX requerida 4. Esperar la confirmación 5. El nombre se asigna al principal que llama **Ruta 1 — Preorder + Registro (seguro, evita el front-running):** 1. Generar un hash salado del nombre totalmente calificado: hash160(name.namespace.salt) 2. Enviar name-preorder con el hash y STX para quemar 3. Esperar al menos 1 bloque 4. Enviar name-register con el nombre real, el namespace y la salt 5. El contrato verifica que los hashes coincidan, quema STX y acuña el NFT al llamador **Ruta 2 — Reclamo rápido (una sola tx, vulnerable al front-running):** 1. Enviar name-claim-fast con nombre, namespace y destinatario 2. STX quemados en un paso, NFT acuñado inmediatamente 3. Riesgo: el nombre es visible en el mempool antes de la confirmación, por lo que puede ser capturado Para namespaces gestionados: usar `mng-name-preorder` + `mng-name-register` (sin quema de STX, el gestor controla los precios). ### Actualización de registros Una vez que un nombre es propiedad de alguien, el propietario puede actualizar registros mediante llamadas al contrato. Las actualizaciones se realizan a través del `zonefile-resolver` contrato vía `update-zonefile(name, namespace, new-zonefile)`. El llamador debe ser o bien el propietario del nombre O el gestor del namespace (para namespaces gestionados). Mencionar el límite de 8KB. Ejemplos de actualizaciones de registros podrían incluir: * Establecer una dirección de Stacks * Actualizar metadatos de perfil * Agregar pares clave-valor personalizados Sólo el propietario actual puede modificar los registros. ### Transferir un nombre Los nombres son activos digitales transferibles. `transfer(id, sender, recipient)` en el contrato BNS-V2. Para namespaces gestionados, usar `mng-transfer(id, sender, recipient)`, pero sólo si las transferencias por parte del gestor no han sido desactivadas vía `turn-off-manager-transfers` . El propietario puede: * Transferir la propiedad a otro principal * Usar un nombre dentro de otros contratos * Integrar nombres en mercados o sistemas de identidad Debido a que la propiedad es nativa en Clarity, las transferencias no requieren confianza. ### Resolver un nombre La resolución implica consultar los contratos BNSv2 para el registro almacenado de un nombre. `resolve-name(name, namespace)` en `zonefile-resolver` Las funciones correspondientes del SDK de BNSv2: `resolveNameZonefile()`, `getNameInfo()`, `getPrimaryName()`. Las aplicaciones pueden: * Llamar al contrato directamente vía RPC * Usar ayudantes del SDK * Usar indexadores para mayor comodidad La resolución es determinista y no depende de servidores centralizados. ### **Precios** Los precios de los nombres se calculan en base a: * Longitud del nombre * Presencia de vocales * Presencia de caracteres no alfabéticos * Funciones de fijación de precios específicas del namespace * **Para namespaces gestionados, el precio será gestionado directamente por el contrato del gestor del namespace** ### **Integración con NFT** Cada nombre se acuña como un NFT, lo que permite: * Transferencias de propiedad sencillas * Integración con mercados de NFT y otras aplicaciones ### Renovaciones Los nombres en namespaces no gestionados expiran después de bloques de vida. Los propietarios tienen un período de gracia de 5.000 bloques (\~34 días) después del vencimiento para renovar vía `name-renewal(namespace, name)`. * La renovación quema STX según el precio actual del nombre. * Si no se renueva dentro del período de gracia, el nombre queda disponible para que cualquiera lo registre. * Los nombres de namespaces gestionados NO expiran (renewal-height = 0). ### Marketplace BNSv2 tiene un marketplace nativo: * `list-in-ustx(id, price, commission-trait)`, listar un nombre para la venta * `unlist-in-ustx(id)`, eliminar el listado * `buy-in-ustx(id, commission-trait)`, comprar un nombre listado La comisión se gestiona mediante el trait de comisión SIP-009. * Para namespaces gestionados, el contrato del gestor debe envolver estas funciones. ### Establecer un nombre primario * `set-primary-name(id)` en BNS-V2 permite a un propietario designar uno de sus nombres como su identidad primaria. * Esto es lo que las billeteras y aplicaciones usan para mostrar. * Sólo un nombre primario por dirección.