Contratos inteligentes

Documentación de contratos inteligentes de STON.fi: referencias técnicas para los contratos DEX v1 y v2

Documentación de interacción directa con contratos inteligentes para el protocolo DEX STON.fi.

Importante: Estos documentos describen la arquitectura de contratos inteligentes de bajo nivel, los métodos y los opcodes. Para aplicaciones de producción, recomendamos encarecidamente usar el SDK oficial + TonConnect en lugar de compilar BOC manualmente y enviar transacciones. El SDK ofrece una mejor experiencia para desarrolladores, maneja casos límite y recibe soporte oficial. La compilación personalizada de BOC solo debe usarse para casos de uso especializados o avanzados.

Arquitectura de contratos

El DEX consta de cuatro tipos principales de contratos:

• Router: Punto de entrada para todas las operaciones

• Pool: Gestiona la liquidez y los intercambios para pares de tokens

• Cuenta: Registra las posiciones de liquidez del usuario

• Monedero: Gestiona las operaciones de tokens LP

Versiones

v2

Última implementación de contrato con:

• Gestión de liquidez mejorada

• Sistema de bóveda para la recaudación de comisiones

• Consumo de gas optimizado

v1

Implementación original del contrato:

• Funcionalidad AMM estándar

• Seguridad y fiabilidad comprobadas

Diferencias clave entre versiones

Función	v1	v2
LP de una sola parte	❌	✅
Sistema de bóveda	❌	✅
Eficiencia del gas	Estándar	Optimizado
Quemas de tokens LP	Manual	Automático

Consideraciones de integración

• Usa el SDK para la mayoría de las integraciones

• Llamadas directas al contrato para casos de uso avanzados

• Prueba siempre primero en la red de pruebas

• Considera estrategias de optimización del gas

Seguridad

Todos los contratos son:

• Código abierto

• Auditados

• Inmutables (pools)

• Bloqueados por tiempo (actualizaciones del router)