v2

API de contratos inteligentes v2 de STON.fi: contratos avanzados con arquitectura de vault y optimización de gas

Referencia de la API

Importante: Esta referencia de la API documenta métodos y opcodes de bajo nivel de contratos inteligentes. 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.

Resumen

La sección contiene documentos separados para cada contrato inteligente utilizado en AMM:

• Pool

• Enrutador

• LpAccount

• LpWallet

• Bóveda

Esquemas de ejemplo

Los esquemas de ejemplo se pueden encontrar aquí:

• Ejemplos de intercambio

• Ejemplos de provisión de LP

• Ejemplos de Vault

Lista de opcodes

Una tabla con los opcodes de DEX v2:

• Op Codes

Nuevas funciones de DEX v2:

Swap

• carga útil personalizada y operaciones anidadas después de los intercambios

• encadenar múltiples intercambios en el mismo Enrutador

• encadenar múltiples intercambios en diferentes v2 Routers

• dirección de reembolso personalizada y carga útil en caso de fallo del intercambio

• plazo para completar la transacción

Liquidez

• carga útil personalizada después de la provisión de liquidez

• gestión mejorada del bloqueo inicial de liquidez, ya no se pierden monedas

• ahora siempre acuña para el usuario la cantidad máxima posible de tokens LP, incluso si la proporción de provisión es diferente de la actual en Pool

• provisión de liquidez de un solo lado

• plazo para completar la transacción

Referidos

• las comisiones por referidos se almacenan en Bóveda contrato

• valor personalizado de la comisión de referido en cada intercambio (máximo 1%)

Nota: Las comisiones de protocolo en DEX v2 se cobran en jetton ASK.

Comisiones por referidos

DEX v2 acumula la porción de referido de cada intercambio en un Bóveda contrato dedicado (uno por referrer × token par). Las comisiones se pueden configurar en el 0.01 %–1 % rango y posteriormente deben ser retiradas por el referente. Consulta la guía de comisiones por referidos de Omniston guía de comisiones por referidos (nota: aunque la guía está orientada a Omniston, el párrafo citado explica en detalle cómo funcionan las comisiones por referidos de DEX V2).

Puedes inspeccionar los saldos del vault y el historial de acumulaciones usando la API REST de Stats & Vaults:

• GET /v1/wallets/{addr_str}/fee_vaults – lista todos los vaults conocidos por referente

• GET /v1/stats/fee_accruals – muestra todas las operaciones que llevaron a la acumulación de comisiones para el referente, filtrables por período

• GET /v1/stats/fee_withdrawals – lista todos los retiros de los vaults del referente, filtrables por período

• GET /v1/stats/fees – devuelve métricas agregadas de comisiones por referido (por ejemplo, el valor total acumulado en USD) por intervalo de tiempo

Todos los endpoints están documentados en el Swagger UI.

pTON v2

• ahora usa un opcode personalizado para transferencias de ton

• la transferencia de ton al usuario no es rebotable

• gestión de gas mejorada

• puede encadenar transferencias de ton entre 2 wallets pTON (para encadenar intercambios pTON en v2 Routers)

Otros

• LpAccount y Bóveda se eliminan si tienen 0 tokens en el saldo para evitar pagar costos de almacenamiento

• mejor gestión de errores: no se pierden monedas si Pool no existe / la carga útil no es correcta

• refactorización completa de la base de código y del uso de bibliotecas en masterchain para hacer que todas las operaciones sean más baratas

• se corrigieron varios problemas de excesos

• se corrigieron algunos Pools que tenían roto get_jetton_data

Eliminado

Pool

• fuera de la cadena get_expected_outputs

• fuera de la cadena get_expected_tokens

• fuera de la cadena get_expected_liquidity

• en la cadena getter_expected_outputs

• en la cadena getter_expected_tokens

• en la cadena getter_expected_liquidity

• llamado por el usuario collect_fees