Guía versionada
Builders y acciones
Sección enlazable con contratos de datos y ejemplos reproducibles.
- Los ejemplos identifican cluster e IDs esperados.
El Program ID y la evidencia coinciden con el manifiesto Lite; la autoridad fue revocada.
Contrato de esta guía
Registro, transferencia, resolver, precio, compra y liberación firmados por wallet.
Usa el manifiesto Lite como fuente de Program ID, slot, hash, autoridad y parámetros de cuenta. El programa está finalizado: el manifiesto publica la revocación de autoridad y el programa es inmutable.
Las seis operaciones Lite
| Operación | Opcode | Firmante | Efecto |
|---|---|---|---|
| register | 0 | payer | crea el registro; payer pasa a ser propietario y resolver |
| transfer | 1 | owner | cambia propietario; reinicia resolver y precio |
| setResolver | 2 | owner | cambia sólo el resolver |
| setPrice | 3 | owner | fija precio en lamports; cero elimina el listado |
| buy | 4 | buyer | paga SOL nativo exacto y transfiere la propiedad |
| release | 5 | owner | cierra el registro; cualquiera puede volver a registrarlo |
Construir localmente
import {
createLiteBuyInstruction,
createLiteRegisterInstruction,
createLiteReleaseInstruction,
createLiteSetPriceInstruction,
createLiteSetResolverInstruction,
createLiteTransferInstruction,
} from "@tocnp/sdk";
// Each builder requires the canonical name, Program ID, and exact actors/amounts.
// Builders never sign, submit, or call tocnp.com.El ejemplo completo verificado por el compilador está en packages/sdk/examples/lite-self-hosted.ts. Incluye todos los builders, verificación finalizada, rent, simulación, integridad del mensaje, envío y seguimiento de finalización.
Límite de transacción
- Vuelve a leer y valida el estado finalizado; el índice en caché es sólo informativo.
- Construye con lamports enteros, blockhash reciente y minContextSlot.
- Estima la tarifa de red, conserva SOL suficiente y simula.
- Muestra acción, destino, monto exacto, red, tarifa y efectos irreversibles.
- Exige confirmación explícita, solicita la firma y rechaza un mensaje firmado modificado.
- Envía una vez, conserva la firma, sigue processed/confirmed/finalized y vuelve a validar.
Liberar exige escribir el nombre normalizado exacto y confirmar la irreversibilidad. Si cambia el propietario o precio de compra, exige una nueva revisión; nunca lo actualices silenciosamente.
Soporte Rust
Aún no existe un SDK Rust compatible con TOCNP-LITE. El crate Rust del workspace implementa el modelo Full no desplegado y no debe decodificar registros Lite. Hasta contar con fixtures de bytes y pruebas en validador local, usa TypeScript verificado por compilación o considera no disponible el soporte Lite en Rust.