Token-2022 En Profundidad

Token-2022 (Extensiones de Token) es el programa de tokens de Solana que mantiene el modelo familiar de mint, cuenta y transferencia del SPL Token clásico, al tiempo que permite extensiones opcionales para adjuntar campos y reglas adicionales en la inicialización.

No es una nueva cadena ni una actualización silenciosa del programa clásico. Es un ID de programa diferente con un diseño base compatible, cuentas más grandes cuando se habilitan las extensiones y una compatibilidad de clientes y lugares de uso que varía según la extensión.

Esta página es el paraguas para las extensiones de token-2022: cómo Token-2022 se relaciona con el Token clásico, cómo funciona el modelo de extensiones, qué significan las principales extensiones para el producto y el código, y cómo ocurre realmente la migración.

Resumen

• Token-2022 (TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb) es un programa de tokens superconjunto: mismos conceptos base de mint y cuenta de token que el SPL Token clásico (TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA), más una región de extensión tipo-largo-valor (TLV) para tarifas, ganchos, metadatos, reglas de alma, visualización de rendimiento y montos confidenciales.
• Por Qué Importa: Elegir Token-2022 es una decisión de producto e integración, no solo una opción de CLI. Un ID de programa incorrecto en la derivación de ATA, la falta de cuentas de gancho, la ignorancia de las tarifas retenidas o la suposición de saldos clásicos bajo mints confidenciales o que devengan intereses rompen billeteras, DEX y bóvedas.
• Conceptos Clave: SPL Token clásico, ID de programa Token-2022, extensión de mint, extensión de cuenta, diseño TLV, metadatos / puntero de metadatos, gancho de transferencia, delegado permanente, no transferible, que devenga intereses, estado de cuenta predeterminado, transferencia confidencial, token_interface, migración (nuevo mint).
• Cuándo Usar: Necesita políticas o datos en el mint que el Token clásico no puede expresar, o su pila se estandariza en Token-2022 para nuevos mints con una matriz de soporte verificada.
• Limitaciones / Compensaciones: No todas las billeteras, enrutadores o indexadores admiten todas las extensiones. Las extensiones en la inicialización son a menudo compromisos de producto permanentes. Las rutas confidenciales y con muchos ganchos aumentan el costo de CU, la complejidad del cliente y el cumplimiento.
• Temas Relacionados: Conceptos básicos de Token-2022, tarifas y ganchos de transferencia, metadatos, delegado permanente y no transferible, intereses devengados y estado de cuenta predeterminado, transferencias confidenciales y migración desde SPL Token.

Fundamentos

SPL Token Clásico frente a Token-2022

El SPL Token clásico es el programa de larga data que la mayoría de las billeteras y DEX asumen por defecto. Sus diseños de mint y cuenta de token son fijos: suministro, decimales, autoridades, saldos, delegados, estado congelado. Las políticas más allá de eso residen en programas separados (mercados, PDAs de metadatos de Metaplex, envolturas de transferencia personalizadas).

Token-2022 mantiene ese diseño base al frente de la cuenta y añade datos de extensión. Sin extensiones, un mint de Token-2022 se comporta de manera muy similar a un mint clásico para mint, quemar y transferir, pero:

• El mint y los ATA son propiedad del programa Token-2022, no del SPL Token clásico.
• Las direcciones de los ATA dependen del ID del programa de token pasado a la derivación.
• Los clientes deben codificar instrucciones contra Token-2022 (o interfaces compatibles con ambos), no asumir Tokenkeg....

No hay una ruta de actualización compartida que convierta un mint clásico existente en Token-2022. Misma marca, nuevo programa significa nuevo mint, nuevos ATA y una migración operativa de titulares y liquidez.

El modelo de extensiones

Las extensiones son módulos opcionales inicializados cuando se crea el mint y/o la cuenta de token (o, para algunas extensiones de cuenta, cuando se configura la cuenta). Residen en una región TLV después de los campos base de SPL.

Reglas prácticas:

1. Elegir al nacer. Muchas extensiones de mint no se pueden eliminar más tarde. Habilitar la tarifa de transferencia, el no transferible o el delegado permanente es un compromiso de producto permanente para ese mint.
2. Ámbito del mint frente a la cuenta. La configuración de tarifas, el ID del programa de gancho, el puntero de metadatos, el delegado permanente y la autoridad de tasa de interés se encuentran en el mint. Las tarifas retenidas, los saldos confidenciales y algunas banderas se encuentran en las cuentas de token.
3. El alquiler y el tamaño escalan. Más datos de extensión significan cuentas más grandes y mínimos más altos exentos de alquiler.
4. Los clientes deben ser conscientes de las extensiones. Prefiera jsonParsed donde sea compatible, los códecs oficiales de Token-2022 o DAS para lecturas; aún así, ramifique según el ID del programa para escrituras.

Metadatos y puntero de metadatos

Los metadatos de token incrustan nombre, símbolo y URI en los datos de extensión del mint para que los fungibles simples no necesiten un PDA de Metadatos de Token de Metaplex para la marca básica. El puntero de metadatos almacena una clave pública que apunta a una cuenta de metadatos externa cuando desea que los metadatos estén fuera del mint.

La URI generalmente hace referencia a JSON fuera de la cadena (imagen, descripción); prefiera el almacenamiento inmutable sobre los hosts HTTP mutables. Los exploradores y DAS indexan cada vez más los metadatos de Token-2022, pero algunas billeteras todavía esperan Metaplex para activos similares a NFT. Los metadatos en el mint no hacen que un NFT por sí solos.

Detalle: Metadatos y Puntero de Metadatos.

Ganchos de transferencia (concepto)

Un mint con gancho de transferencia almacena un ID de programa personalizado. En cada transferencia (y movimiento relacionado), Token-2022 invoca ese programa para que la política se ejecute atmicamente con el movimiento del token: listas blancas, registros de regalías, verificaciones de cumplimiento, contabilidad.

El programa de gancho debe implementar la interfaz que espera Token-2022 y permanecer mínimo (CU se comparte con la transferencia). Los clientes deben resolver y pasar las cuentas adicionales que requiere el gancho; la falta de cuentas es el fallo de integración más común. Prefiera la extensión tarifa de transferencia incorporada cuando la única necesidad sea el ingreso por puntos porcentuales.

Detalle: Ganchos de Transferencia. Tarifas: Tarifas de Transferencia.

Delegado permanente y no transferible

El delegado permanente incrusta una clave pública en el mint que puede transferir tokens sin la aprobación de delegado por cuenta habitual del titular. Es un fuerte control del emisor para rutas de recuperación y una seria divulgación de confianza para los usuarios.

No transferible marca el mint para que las transferencias estándar fallen. Los tokens están efectivamente ligados al alma después de la emisión (credenciales, insignias, acceso no comercializable). Aún pueden aplicarse mint y quemar bajo las autoridades que configure. Los mercados secundarios y los pools AMM son la superficie de producto incorrecta.

A menudo se combina con el estado de cuenta predeterminado congelado para que las nuevas cuentas no puedan mover fondos hasta que una autoridad de congelación descongele después del flujo de KYC o reclamo.

Detalle: Delegado Permanente y No Transferible.

Intereses devengados, estado de cuenta predeterminado y transferencias confidenciales

Que devenga intereses almacena una tasa (y autoridad de tasa) en el mint. Los saldos mostrados o efectivos crecen según la fórmula basada en el tiempo de Token-2022 sin una bóveda de préstamos externa para matemáticas simples de productos de tipo ahorro. Las interfaces de usuario deben actualizarse con lecturas conscientes de las extensiones.

El estado de cuenta predeterminado establece si las nuevas cuentas de token comienzan inicializadas o congeladas. Congelado por defecto es un patrón de cumplimiento y airdrop: la creación tiene éxito, las transferencias esperan la descongelación.

Las transferencias confidenciales utilizan pruebas de conocimiento cero para que los montos puedan descansar y moverse de forma cifrada mientras el programa aún impone la conservación de valor. El campo público amount clásico no es la imagen económica completa una vez que el valor se deposita en estado confidencial. La generación de pruebas es del lado del cliente y el soporte de billeteras o RPC es más limitado que las transferencias simples.

Detalles: Intereses Devengados y Estado de Cuenta Predeterminado, Transferencias Confidenciales.

Consideraciones de migración

Migrar desde SPL Token clásico significa: diseñar el conjunto de extensiones y mint de Token-2022; confirmar el soporte de billeteras, DEX, custodia e indexadores; capturar instantáneas de titulares (y posiciones de LP); crear el nuevo mint y hacer airdrop o reclamar en ATAs de Token-2022; ejecutar ambos mints en paralelo; luego, retirar los depósitos heredados.

No hay una instrucción de "actualizar este mint" en cadena entre programas. Los programas que aceptan mints arbitrarios de usuarios deben usar token_interface (Anchor) o rutas duales equivalentes para que los clásicos y Token-2022 puedan coexistir durante la transición.

Detalle: Migración desde SPL Token.

Mecánicas e Interacciones

De extremo a extremo, un activo Token-2022 toca tres capas:

  Inicialización del Mint (ID de programa Token-2022 + TLV de extensión)
           |
           v
  Cuentas de Token / ATAs (mismo ID de programa en la derivación)
           |
           v
  Instrucciones (transferencia, mint, congelar, cosechar, CPI de gancho, pruebas confidenciales)
           |
           v
  Clientes, billeteras, enrutadores, bóvedas (ramificar por propietario + extensiones)

El ID del programa es la primera bifurcación. Antes de construir PDAs de ATA o instrucciones de transferencia, lea el owner de la cuenta del mint. Si es Token-2022, cada constructor, objetivo de CPI y paquete posterior debe coincidir.

La derivación de ATA incluye el programa de token. Con un nuevo mint de Token-2022, siempre obtienes nuevos ATA. Pasar el tokenProgram incorrecto produce una dirección incorrecta y errores silenciosos de cuenta vacía.

Las interacciones de extensiones se acumulan. Tarifa de transferencia más gancho significa que las matemáticas de tarifas y las cuentas de gancho se aplican ambas. No transferible más delegado permanente bloquean la transferencia del usuario mientras el delegado aún puede mover valor. Congelado por defecto más autoridad de descongelación crea cuentas que no pueden transferir hasta la descongelación. Confidencial más depósito o retiro público requiere estado de UI de varios pasos (público, pendiente, confidencial).

Programas duales de mint de Anchor. Prefiera los tipos InterfaceAccount + TokenInterface de anchor-spl sobre las restricciones clásicas solo de Token cuando las bóvedas listen mints externos o elegidos por el usuario.

CLI y pila. Con Solana CLI 3.0.10, apunte spl-token a Token-2022 a través de --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb. El trabajo local en validadores Agave 4.1.1-class, Surfpool o LiteSVM aún requiere el orden correcto de inicialización del programa y las extensiones. @solana/kit 7.0.0 proporciona RPC tipado y códecs; detecte el propietario a través de getAccountInfo, luego codifique con ayudantes conscientes de Token-2022.

Consideraciones Avanzadas y Aplicaciones

Elegir Token-2022 en absoluto

Elija SPL Token clásico por defecto cuando necesite la máxima compatibilidad de lugares de uso y no se requiera ninguna extensión. Elija Token-2022 cuando una extensión sea un requisito de producto estricto y haya verificado el soporte. Lanzar Token-2022 solo porque es más nuevo es cómo los lanzamientos dejan liquidez varada.

Conjunto de extensiones como modelo de amenazas

Trate la inicialización del mint como un documento legal y de seguridad:

• El delegado permanente y la autoridad de congelación son poderes de incautación y bloqueo; prefiera multisig o gobernanza y divulgación clara.
• Los ganchos de transferencia amplían el código confiable en cada transferencia; audite el gancho como código de producción.
• Las transferencias confidenciales cambian lo que los observadores externos y los sistemas de riesgo pueden observar; alinéese con el cumplimiento antes de la red principal.
• La autoridad de tasa de interés puede cambiar los parámetros de rendimiento mostrados; documente la propiedad y el proceso de actualización.

Matriz de clientes y lugares de uso antes de la red principal

Para cada extensión habilitada, verifique las billeteras de destino (visualización, envío, creación de ATA, montos netos de tarifas), las rutas de DEX o enrutador y las cuentas adicionales de gancho, el soporte de depósito de custodia, la semántica de saldos del indexador o DAS, y sus propias rutas de programa (token_interface, cosecha de tarifas, metadatos de gancho). Pruebas de humo con pequeñas cantidades en devnet y mainnet antes de una gran liquidez.

Carga operativa

Las tarifas de transferencia necesitan rutas de cosecha o ejecución para que los tokens retenidos lleguen a la tesorería. Los ganchos necesitan resolutores de cuentas adicionales versionados en cada ruta de cliente. Los intereses devengados necesitan una política de actualización de UI. Lo confidencial necesita arquitectura de custodia de claves y generación de pruebas (trabajador, servidor o billetera especializada).

Greenfield es un mint y un árbol de ATA. La migración es un registro de mint dual, pools duales, analíticas duales y un plan de comunicación. Presupueste ingeniería para la ejecución dual; generalmente supera el día del airdrop.

Conceptos Erróneos Comunes

• "Token-2022 reemplaza a Token clásico para cada mint." Token clásico sigue siendo ampliamente compatible. Token-2022 es opcional por mint a través de un programa diferente.
• "Puedo actualizar mi mint clásico in situ." No puedes. Nuevo mint, nuevos ATA, migración de titulares y liquidez.
• "Sin extensiones, el ID del programa no importa." Siempre importa para la propiedad, la derivación de ATA y la codificación de instrucciones.
• "La extensión de metadatos es Metaplex." Objetivos de marca relacionados, modelos de cuenta diferentes.
• "Los ganchos de transferencia son políticas gratuitas." Cuestan CU, cuentas adicionales y soporte completo del cliente; las tarifas simples deben usar la extensión de tarifas.
• "El delegado permanente es solo otro administrador opcional." Puede mover tokens de titulares bajo las reglas de extensión; trátelo como de alta confianza.
• "Los tokens no transferibles aún se pueden listar en un DEX." Las transferencias ordinarias fallan; los pools son el ajuste incorrecto.
• "El monto público siempre es la riqueza total bajo mints confidenciales." Los saldos confidenciales no se reflejan completamente en el monto público una vez depositados.
• "token_interface es opcional para bóvedas de mint múltiple." Las restricciones solo clásicas rechazan los depósitos de Token-2022.

Preguntas Frecuentes

Relacionados

• Conceptos básicos de Token-2022 - ID de programa, ATA, mint/transferencia CLI, token_interface
• Metadatos y Puntero de Metadatos - marca en el mint y cuentas puntero
• Delegado Permanente y No Transferible - control del emisor y mints de alma ligada
• Intereses Devengados y Estado de Cuenta Predeterminado - visualización de tasa y cuentas congeladas por defecto
• Transferencias Confidenciales - montos ZK, depósito/retiro, pruebas de cliente
• Migración desde SPL Token - soporte dual de programas y cambio de titulares

Versiones de la pila: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, Rust 1.91.1 y @solana/kit 7.0.0.