LpAccount (v1)

Contrato LpAccount v1 de STON.fi: gestiona posiciones de proveedores de liquidez y acuñación de tokens LP

Métodos get fuera de la cadena

get_lp_account_data

Devuelve el estado actual de la cuenta lp: dirección del propietario, dirección del pool y cantidad de ambos tokens Jetton.

(slice, slice, int, int) get_lp_account_data() method_id;

Argumentos

Ninguno

Resultado

Devuelve el estado actual de la cuenta lp.

Estructura de retorno

Clave	Tipo	Índice	Descripción
user_address	address	0	Dirección del propietario
pool_address	address	1	Dirección del pool
amount0	coins	2	Saldo del primer token Jetton (en unidades básicas del token)
amount1	coins	3	Saldo del segundo token Jetton (en unidades básicas del token)

Consultas en la cadena

Contrapartes en la cadena de los métodos getter.

Tabla de operaciones

Nombre	Valor	Descripción
getter_lp_account_data	0x1d439ae0	Envía un mensaje con el estado actual del pool

getter_lp_account_data (0x1d439ae0)

Envía un mensaje con el estado actual de la cuenta lp. Equivalente en la cadena de get_lp_account_data.

TL-B

getter_lp_account_data#1d439ae0 query_id:uint64 = InternalMsgBody;

Cuerpo del mensaje

Ninguno

Mensajes salientes

Envía un mensaje con el estado actual de la cuenta lp a sender_address

Cuerpo del mensaje de respuesta

Nombre	Tipo	Descripción
op	uint32	Código de operación igual a getter_lp_account_data
query_id	uint64	Id de consulta
user_address	address	Dirección del propietario
pool_address	address	Dirección del pool
amount0	coins	Saldo del primer token Jetton (en unidades básicas del token)
amount1	coins	Saldo del segundo token Jetton (en unidades básicas del token)

Manejadores de mensajes del pool

Gestiona los mensajes entrantes de un pool

Tabla de operaciones

Nombre	Valor	Descripción
add_liquidity	0x3ebe5431	Añadir liquidez

add_liquidity (0x3ebe5431)

Almacena la cantidad de tokens enviada por el usuario para añadirla como nueva liquidez. Al recibir una cantidad apropiada de ambos tokens, envía un mensaje con esas cantidades a un pool para que se añadan como nueva liquidez. La adición automática de liquidez solo ocurre si la cantidad de ambos tokens es mayor que 1000 y distinta de cero min_lp_out se especificó, de lo contrario el usuario puede seguir aumentando la cantidad de tokens almacenados.

TL-B

add_liquidity#3ebe5431 query_id:uint64 new_amount0:Grams new_amount1:Grams min_lp_out:Grams = InternalMsgBody;

Cuerpo del mensaje

Nombre	Tipo	Descripción
new_amount0	coins	Cantidad de los primeros tokens Jetton añadidos (en unidades básicas del token)
new_amount1	coins	Cantidad de los segundos tokens Jetton añadidos (en unidades básicas del token)
min_lp_out	coins	Cantidad mínima requerida de nuevos tokens de liquidez recibidos (en unidades básicas del token)

Notas:

• la adición de liquidez fallará si un usuario debe recibir menos de min_lp_out tokens lp como resultado

Mensajes salientes

Envía un mensaje al pool con cb_add_liquidity op

Cuerpo del mensaje de respuesta

Nombre	Tipo	Descripción
op	uint32	Código de operación, igual a cb_add_liquidity
query_id	uint64	Id de consulta
amount0	coins	Cantidad de los primeros tokens Jetton añadidos (en unidades básicas del token)
amount1	coins	Cantidad de los segundos tokens Jetton añadidos (en unidades básicas del token)
user_address	address	Dirección del propietario
min_lp_out	coins	Cantidad mínima de tokens de liquidez recibidos (en unidades básicas del token)

Notas:

• la adición de liquidez fallará si un usuario debe recibir menos de min_lp_out tokens lp como resultado

Manejadores de mensajes del usuario

Gestiona los mensajes entrantes de un usuario

Tabla de operaciones

Nombre	Valor	Descripción
refund_me	0xbf3f447	Devuelve al usuario los tokens enviados previamente
direct_add_liquidity	0x4cf82803	Añade liquidez directamente con una cantidad especificada de tokens y una cantidad mínima de tokens de liquidez recibidos
reset_gas	0x42a0fb43	Reiniciar gas

refund_me (0xbf3f447)

Inicia un reembolso de los tokens almacenados por add_liquidity si el usuario decide cancelar la adición de nueva liquidez. La cantidad de tokens almacenados se enviará al pool, que iniciará una transferencia de vuelta al usuario.

TL-B

refund_me#bf3f447 query_id:uint64 = InternalMsgBody;

Cuerpo del mensaje

Ninguno

Mensajes salientes

Envía un mensaje con cb_refund_me código op y la cantidad de tokens almacenados a un pool. El pool enviará un mensaje para reembolsar esos tokens al usuario.

Cuerpo del mensaje de respuesta

Nombre	Tipo	Descripción
op	uint32	Código de operación
query_id	uint64	Id de consulta
amount0	coins	Cantidad de los primeros tokens Jetton (en unidades básicas del token)
amount1	coins	Cantidad de los segundos tokens Jetton (en unidades básicas del token)
user_address	address	Dirección del propietario

direct_add_liquidity (0x4cf82803)

Inicia una adición de nueva liquidez a un pool con una cantidad especificada de ambos tokens y una cantidad mínima de liquidez recibida. La operación solo tiene éxito si hay una cantidad igual o mayor de ambos tokens almacenada en la cuenta (la cantidad de ambos tokens debe ser mayor que 1000). Este método es útil si no se ha desencadenado una adición automática de liquidez al depositar tokens.

TL-B

direct_add_liquidity#4cf82803 query_id:uint64 amount0:Grams amount1:Grams min_lp_out:Grams = InternalMsgBody;

Cuerpo del mensaje

Nombre	Tipo	Descripción
amount0	coins	Cantidad de los primeros tokens Jetton (en unidades básicas del token)
amount1	coins	Cantidad de los segundos tokens Jetton (en unidades básicas del token)
min_lp_out	coins	Cantidad mínima de tokens de liquidez recibidos (en unidades básicas del token)

Notas:

• la adición de liquidez fallará si un usuario debe recibir menos de min_lp_out tokens lp como resultado

• min_lp_out el valor debe ser mayor que cero para que esta operación continúe

Mensajes salientes

Envía un mensaje con cb_add_liquidity código op y cantidad de ambos tokens que se añadirán como nueva liquidez.

Cuerpo del mensaje de respuesta

Nombre	Tipo	Descripción
op	uint32	Código de operación
query_id	uint64	Id de consulta
am0	coins	Cantidad de los primeros tokens Jetton (en unidades básicas del token)
am1	coins	Cantidad de los segundos tokens Jetton (en unidades básicas del token)
user_address	address	Dirección del propietario
min_lp_out	coins	Cantidad mínima de tokens de liquidez recibidos (en unidades básicas del token)

Notas:

• la adición de liquidez fallará si un usuario debe recibir menos de min_lp_out tokens lp como resultado

reset_gas (0x42a0fb43)

Actualiza la cantidad de $TON (en nanoTons) en la cuenta lp a REQUIRED_TON_RESERVE (10000000) de la cuenta. El $TON restante se enviará de vuelta a la user_address

TL-B

reset_gas#42a0fb43 query_id:uint64 = InternalMsgBody;

Cuerpo del mensaje

Ninguno

Mensajes salientes

Envía un mensaje vacío de vuelta al usuario con el $TON restante

Constantes

Nombre	Valor	Descripción
WORKCHAIN	0	Id de workchain
REQUIRED_TON_RESERVE	10000000	Cantidad de $TON (en nanoTons) que debe quedar en el contrato de la cuenta lp como gas