Lista de Operaciones
Las operaciones son objetos que representan un cambio deseado en el ledger y se envían a la red agrupadas en una transacción. Para cada operación, hay un tipo de resultado exitoso o fallido. En caso de éxito, el usuario puede reunir información sobre el efecto de la operación. En caso de fallo, el usuario puede aprender más sobre el error.
Aprende más sobre transacciones y operaciones en nuestra sección de Operaciones y Transacciones.
Actualmente hay 26 operaciones que puedes utilizar en la red Stellar, estas operaciones, sus definiciones, SDKs, umbrales, parámetros y errores se enumeran a continuación.
Crear cuenta
Crea y financia una nueva cuenta con el saldo inicial especificado
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: CreateAccountResult
Parámetros:
| Parámetro | Tipo | Descripción |
|---|---|---|
| Destino | ID de cuenta | Dirección de cuenta que se crea y se financia. |
| Saldo inicial | entero | Cantidad de XLM a enviar a la cuenta recién creada. Este XLM proviene de la cuenta fuente. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
CREAR_CUENTA_MALFORMADA | -1 | El destino es inválido. |
CREAR_CUENTA_BAJO_FONDO | -2 | La cuenta fuente que realiza el comando no tiene suficientes fondos para darle al destino el saldo inicial de XLM y todavía mantener su reserva mínima de XLM más satisfacer sus obligaciones de venta de XLM. |
CREAR_CUENTA_BAJO_RESERVA | -3 | Esta operación crearía una cuenta con menos del número mínimo de XLM que una cuenta debe mantener. |
CREAR_CUENTA_YA_EXISTE | -4 | La cuenta destino ya existe. |
Pago
Envía una cantidad en un activo específico a una cuenta de destino
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: PaymentResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Destino | ID de cuenta | Dirección de cuenta que recibe el pago. |
| Activo | activo | Activo a enviar a la cuenta de destino. |
| Cantidad | entero | Cantidad del activo mencionado a enviar. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
PAGO_MALFORMADO | -1 | La entrada para el pago es inválida. |
PAGO_BAJO_FONDO | -2 | La cuenta fuente (remitente) no tiene suficientes fondos para enviar cantidad y todavía satisfacer sus obligaciones de venta. Ten en cuenta que si envías XLM, entonces el remitente debe además mantener su reserva mínima de XLM. Ten en cuenta que este error no se devolverá si la cuenta receptora es el emisor de activo. |
PAGO_SRC_SIN_CONFIANZA | -3 | La cuenta fuente no confía en el emisor del activo que está tratando de enviar. |
PAGO_SRC_NO_AUTORIZADO | -4 | La cuenta fuente no está autorizada para enviar este pago. |
PAGO_SIN_DESTINO | -5 | La cuenta receptora no existe. Ten en cuenta que este error no se devolverá si la cuenta receptora es el emisor del activo. |
PAGO_SIN_CONFIANZA | -6 | El receptor no confía en el emisor del activo que se envía. Para más información, consulta la sección de Activos. |
PAGO_NO_AUTORIZADO | -7 | La cuenta de destino no está autorizada por el emisor del activo para mantener el activo. |
PAGO_LÍNEA_LLENA | -8 | La cuenta de destino (receptora) no tiene suficientes límites para recibir cantidad y aún satisfacer sus obligaciones de compra. |
Pago estricto de ruta
Un pago en el que el activo enviado puede ser diferente del activo recibido; permite al usuario especificar la cantidad del activo a enviar
Aprende más sobre pagos de ruta: Entrada de Enciclopedia de Pagos de Ruta
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: PathPaymentStrictSendResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Enviar activo | activo | El activo descontado de la cuenta del remitente. |
| Enviar cantidad | entero | La cantidad de enviar activo a descontar (excluyendo tarifas). |
| Destino | ID de cuenta | ID de cuenta del destinatario. |
| Activo de destino | activo | El activo que recibe la cuenta de destino. |
| Mínimo de destino | entero | La cantidad mínima de activo de destino que la cuenta de destino puede recibir. |
| Ruta | lista de activos | Los activos (además de enviar activo y activo de destino) involucrados en las ofertas que toma la ruta. Por ejemplo, si solo puedes encontrar una ruta de USD a EUR a través de XLM y BTC, la ruta sería USD -> XLM -> BTC -> EUR y el campo ruta contendría XLM y BTC. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
PAGO_RUTA_ENVIAR_MALFORMADO | -1 | La entrada a este pago de ruta es inválida. |
PAGO_RUTA_ENVIAR_BAJO_FONDO | -2 | La cuenta fuente (remitente) no tiene suficientes fondos para enviar y aún satisfacer sus obligaciones de venta. Ten en cuenta que si envías XLM, entonces el remitente debe además mantener su reserva mínima de XLM. Ten en cuenta que si envías XLM, entonces el remitente debe además mantener su reserva mínima de XLM. |
PAGO_RUTA_ENVIAR_SRC_SIN_CONFIANZA | -3 | La cuenta fuente no confía en el emisor del activo que está tratando de enviar. |
PAGO_RUTA_ENVIAR_SRC_NO_AUTORIZADO | -4 | La cuenta fuente no está autorizada para enviar este pago. |
PAGO_RUTA_ENVIAR_SIN_DESTINO | -5 | La cuenta de destino no existe. |
PAGO_RUTA_ENVIAR_SIN_CONFIANZA | -6 | La cuenta de destino no confía en el emisor del activo que se envía. Para más información, consulta la sección de Activos. |
PAGO_RUTA_ENVIAR_NO_AUTORIZADO | -7 | La cuenta de destino no está autorizada por el emisor del activo para mantener el activo. |
PAGO_RUTA_ENVIAR_LÍNEA_LLENA | -8 | La cuenta de destino no tiene límites suficientes para recibir importe de destino y aún satisfacer sus obligaciones de compra. |
PAGO_RUTA_ENVIAR_MUY_POCAS_OFERTAS | -10 | No hay una ruta de ofertas conectando el enviar activo y el activo de destino. Stellar solo considera rutas de longitud 5 o más cortas. |
PAGO_RUTA_ENVIAR_OFERTA_CROSS_SELF | -11 | El pago cruzaría una de sus propias ofertas. |
PAGO_RUTA_ENVIAR_BAJO_DESTMIN | -12 | Las rutas que podrían enviar importe de destino de activo de destino serían insuficientes para mínimo de destino. |
Pago estricto de ruta recibir
Un pago en el que el activo recibido puede ser diferente del activo enviado; permite al usuario especificar la cantidad del activo recibido
Aprende más sobre pagos de ruta: Entrada de Enciclopedia de Pagos de Ruta
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: PathPaymentStrictReceiveResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Enviar activo | activo | El activo descontado de la cuenta del remitente. |
| Enviar máximo | entero | La cantidad máxima de enviar activo a descontar (excluyendo tarifas). |
| Destino | ID de cuenta | ID de cuenta del destinatario. |
| Activo de destino | activo | El activo que recibe la cuenta de destino. |
| Cantidad de destino | entero | La cantidad de activo de destino que recibe la cuenta de destino. |
| Ruta | lista de activos | Los activos (además de activo de envío y activo de destino) involucrados en las ofertas que toma la ruta. Por ejemplo, si solo puedes encontrar una ruta desde USD a EUR a través de XLM y BTC, la ruta sería USD -> XLM -> BTC -> EUR y el campo ruta contendría XLM y BTC. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
PAGO_RUTA_RECIBIR_MALFORMADO | -1 | La entrada a este pago de ruta no es válida. |
PAGO_RUTA_RECIBIR_BAJO_FONDO | -2 | La cuenta de origen (remitente) no tiene suficientes fondos para enviar y aún así satisfacer sus obligaciones de venta. Ten en cuenta que si envías XLM, el remitente debe además mantener su reserva mínima de XLM. |
PAGO_RUTA_RECIBIR_SRC_SIN_CONFIANZA | -3 | La cuenta de origen no confía en el emisor del activo que está tratando de enviar. |
PAGO_RUTA_RECIBIR_SRC_NO_AUTORIZADO | -4 | La cuenta de origen no está autorizada para enviar este pago. |
PAGO_RUTA_RECIBIR_SIN_DESTINO | -5 | La cuenta de destino no existe. |
PAGO_RUTA_RECIBIR_SIN_CONFIANZA | -6 | La cuenta de destino no confía en el emisor del activo que se está enviando. Para más información, consulta la sección de Activos. |
PAGO_RUTA_RECIBIR_NO_AUTORIZADO | -7 | La cuenta de destino no está autorizada por el emisor del activo para mantener el activo. |
PAGO_RUTA_RECIBIR_LÍNEA_LLENA | -8 | La cuenta de destino no tiene límites suficientes para recibir cantidad de destino y aún así satisfacer sus obligaciones de compra. |
PAGO_RUTA_RECIBIR_MUY_POCAS_OFERTAS | -10 | No hay ninguna ruta de ofertas que conecte el activo de envío y el activo de destino. Stellar solo considera rutas de longitud 5 o menor. |
PAGO_RUTA_RECIBIR_OFERTA_CROSS_SELF | -11 | El pago cruzaría una de sus propias ofertas. |
PAGO_RUTA_RECIBIR_SOBRE_SENDMAX | -12 | Las rutas que podrían enviar cantidad de destino de activo de destino excederían máx. de envío. |
Gestionar oferta de compra
Crea, actualiza o elimina una oferta para comprar una cantidad específica de un activo por otro
Aprende más sobre las ofertas de venta pasiva: Liquidez en Stellar: SDEX y Fondos de Liquidez
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ManageBuyOfferResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Venta | activo | Activo que el creador de la oferta está vendiendo. |
| Compra | activo | Activo que el creador de la oferta está comprando. |
| Cantidad | entero | Cantidad de compras que se está comprando. Establecer en 0 si deseas eliminar una oferta existente. |
| Precio | {numerador, denominador} | Precio de 1 unidad de compras en términos de ventas. Por ejemplo, si quisieras comprar 30 XLM y vender 5 BTC, el precio sería {5,30}. |
| ID de oferta | entero sin signo | El ID de la oferta. 0 para nueva oferta. Establecer en el ID de oferta existente para actualizar o eliminar. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
GESTIONAR_OFERTA_COMPRA_MALFORMADA | -1 | La entrada es incorrecta y resultaría en una oferta no válida. |
GESTIONAR_OFERTA_COMPRA_VENDER_SIN_CONFIANZA | -2 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está vendiendo. |
GESTIONAR_OFERTA_COMPRA_COMPRAR_SIN_CONFIANZA | -3 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está comprando. |
GESTIONAR_OFERTA_COMPRA_COMPRAR_NO_AUTORIZADO | -4 | La cuenta que crea la oferta no está autorizada a vender este activo. |
GESTIONAR_OFERTA_COMPRA_VENDER_NO_AUTORIZADO | -5 | La cuenta que crea la oferta no está autorizada a comprar este activo. |
GESTIONAR_OFERTA_COMPRA_LÍNEA_LLENA | -6 | La cuenta que crea la oferta no tiene suficientes límites para recibir compras y aún así satisfacer sus obligaciones de compra. |
GESTIONAR_OFERTA_COMPRA_BAJO_FONDO | -7 | La cuenta que crea la oferta no tiene suficientes límites para enviar ventas y aún satisfacer sus obligaciones de venta. Ten en cuenta que si vendes XLM, la cuenta debe además mantener su reserva mínima de XLM, que se calcula asumiendo que esta oferta no se ejecutará completamente de inmediato. |
GESTIONAR_OFERTA_COMPRA_CROSS_SELF | -8 | La cuenta tiene una oferta opuesta de precio igual o menor activa, por lo que la cuenta que crea esta oferta cruzaría inmediatamente. |
GESTIONAR_OFERTA_COMPRA_NO_ENCONTRADA | -11 | No se puede encontrar una oferta con ese ID de oferta. |
GESTIONAR_OFERTA_COMPRA_BAJA_RESERVA | -12 | La cuenta que crea esta oferta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por agregar una subentrada y seguir satisfaciendo sus obligaciones de venta de XLM. Por cada oferta que una cuenta crea, la cantidad mínima de XLM que esa cuenta debe mantener aumentará. |
Gestionar oferta de venta
Crea, actualiza o elimina una oferta para vender una cantidad específica de un activo por otro
Aprende más sobre las ofertas de venta pasiva: Liquidez en Stellar: SDEX y Fondos de Liquidez
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ManageSellOfferResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Venta | activo | Activo que el creador de la oferta está vendiendo. |
| Compra | activo | Activo que el creador de la oferta está comprando. |
| Cantidad | entero | Cantidad de ventas que se está vendiendo. Establecer en 0 si deseas eliminar una oferta existente. |
| Precio | {numerador, denominador} | Precio de 1 unidad de ventas en términos de compras. Por ejemplo, si quisieras vender 30 XLM y comprar 5 BTC, el precio sería {5,30}. |
| ID de oferta | entero sin signo | El ID de la oferta. 0 para nueva oferta. Establecer en el ID de oferta existente para actualizar o eliminar. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
GESTIONAR_OFERTA_VENTA_MALFORMADA | -1 | La entrada es incorrecta y resultaría en una oferta no válida. |
GESTIONAR_OFERTA_VENTA_VENDER_SIN_CONFIANZA | -2 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está vendiendo. |
GESTIONAR_OFERTA_VENTA_COMPRAR_SIN_CONFIANZA | -3 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está comprando. |
GESTIONAR_OFERTA_VENTA_VENDER_NO_AUTORIZADO | -4 | La cuenta que crea la oferta no está autorizada a vender este activo. |
GESTIONAR_OFERTA_VENTA_COMPRAR_NO_AUTORIZADO | -5 | La cuenta que crea la oferta no está autorizada a comprar este activo. |
GESTIONAR_OFERTA_VENTA_LÍNEA_LLENA | -6 | La cuenta que crea la oferta no tiene suficientes límites para recibir compras y aún así satisfacer sus obligaciones de compra. |
GESTIONAR_OFERTA_VENTA_BAJO_FONDO | -7 | La cuenta que crea la oferta no tiene suficientes límites para enviar ventas y aún así satisfacer sus obligaciones de venta. Ten en cuenta que si vendes XLM, la cuenta debe además mantener su reserva mínima de XLM, que se calcula asumiendo que esta oferta no se ejecutará completamente de inmediato. |
GESTIONAR_OFERTA_VENTA_CROSS_SELF | -8 | La cuenta tiene una oferta opuesta de precio igual o menor activa, por lo que la cuenta que crea esta oferta cruzaría inmediatamente. |
GESTIONAR_OFERTA_VENTA_NO_ENCONTRADA | -11 | No se puede encontrar una oferta con ese ID de oferta. |
ADMINISTRAR_OFERTA_DE_VENTA_BAJO_RESERVA | -12 | La cuenta que crea esta oferta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por agregar una subentrada y aún así satisfacer sus obligaciones de venta de XLM. Por cada oferta que una cuenta crea, la cantidad mínima de XLM que esa cuenta debe mantener aumentará. |
Crear oferta de venta pasiva
Crea una oferta para vender un activo por otro sin aceptar una oferta inversa de precio igual
Aprende más sobre las ofertas de venta pasiva: Liquidez en Stellar: SDEX y Fondos de Liquidez
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ManageSellOfferResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Venta | activo | Activo que el creador de la oferta está vendiendo. |
| Compra | activo | Activo que el creador de la oferta está comprando. |
| Cantidad | entero | Cantidad de ventas que se está vendiendo. |
| Precio | {numerador, denominador} | Precio de 1 unidad de ventas en términos de compras. Por ejemplo, si quisieras vender 30 XLM y comprar 5 BTC, el precio sería {5,30}. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
ADMINISTRAR_OFERTA_DE_VENTA_MAL_FORMADA | -1 | La entrada es incorrecta y resultaría en una oferta no válida. |
ADMINISTRAR_OFERTA_DE_VENTA_NO_CONFIABLE | -2 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está vendiendo. |
ADMINISTRAR_OFERTA_DE_VENTA_NO_CONFIABLE_COMPRA | -3 | La cuenta que crea la oferta no tiene una línea de confianza para el activo que está comprando. |
ADMINISTRAR_OFERTA_DE_VENTA_NO_AUTORIZADA | -4 | La cuenta que crea la oferta no está autorizada para vender este activo. |
ADMINISTRAR_OFERTA_DE_VENTA_NO_AUTORIZADA_COMPRA | -5 | La cuenta que crea la oferta no está autorizada para comprar este activo. |
ADMINISTRAR_OFERTA_DE_VENTA_LÍNEA_LLENA | -6 | La cuenta que crea la oferta no tiene límites suficientes para recibir buying y aún así satisfacer sus obligaciones de compra. |
ADMINISTRAR_OFERTA_DE_VENTA_FONDOS_INSUFICIENTES | -7 | La cuenta que crea la oferta no tiene límites suficientes para enviar selling y aún así satisfacer sus obligaciones de venta. Ten en cuenta que si vendes XLM, la cuenta debe mantener además su reserva mínima de XLM, que se calcula asumiendo que esta oferta no se ejecutará completamente de inmediato. |
ADMINISTRAR_OFERTA_DE_VENTA_CRUZARSE_A_SÍ_MISMO | -8 | La cuenta tiene una oferta opuesta de igual o menor precio activa, por lo que la cuenta que crea esta oferta se cruzaría inmediatamente a sí misma. |
ADMINISTRAR_OFERTA_DE_VENTA_NO_ENCONTRADA | -11 | No se puede encontrar una oferta con ese offerID. |
ADMINISTRAR_OFERTA_DE_VENTA_BAJO_RESERVA | -12 | La cuenta que crea esta oferta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por agregar una subentrada y aún satisfacer sus obligaciones de venta de XLM. Por cada oferta que crea una cuenta, la cantidad mínima de XLM que esa cuenta debe mantener aumentará. |
Establecer opciones
Establecer opciones para una cuenta como flags, destino de inflación, firmantes, dominio principal y peso de la clave maestra
Aprende más sobre los flags: Entrada de la Enciclopedia de Flags
Aprende más sobre el dominio de casa: Propuestas del Ecosistema Stellar SEP-0001
Aprende más sobre las operaciones de firmantes y el peso de las claves: Entrada de la Enciclopedia de Firmas y Multifirma
SDKs: JavaScript | Java | Go
Umbral: Alto (cuando se actualizan los firmantes u otros umbrales) o Medio (cuando se actualiza todo lo demás)
Resultado: SetOptionsResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Destino de Inflación | ID de cuenta | Cuenta del destino de inflación. |
| Eliminar flags | entero | Indica qué cuenta flags eliminar. Estos flags a nivel de cuenta son utilizados principalmente por emisores de activos; para más detalles sobre los flags, por favor consulta la página de Consideraciones de Diseño de Activos. La máscara de bits entera se resta de los flags existentes de la cuenta. Esto permite establecer bits específicos sin conocimiento de los flags existentes. |
| Establecer flags | entero | Indica qué cuenta flags establecer. Estos flags a nivel de cuenta son utilizados principalmente por emisores de activos; para más detalles sobre los flags, por favor consulta la página de Consideraciones de Diseño de Activos La máscara de bits entera se suma a los flags existentes de la cuenta. Esto permite establecer bits específicos sin conocimiento de los flags existentes. |
| Peso maestro | entero | Un número del 0 al 255 (inclusive) que representa el peso de la clave maestra. Si el peso de la clave maestra se actualiza a 0, se desactiva efectivamente. |
| Umbral bajo | entero | Un número del 0 al 255 (inclusive) que representa el umbral que esta cuenta establece en todas las operaciones que realiza que tienen un umbral bajo. |
| Umbral medio | entero | Un número del 0 al 255 (inclusive) que representa el umbral que esta cuenta establece en todas las operaciones que realiza que tienen un umbral medio. |
| Umbral alto | entero | Un número del 0 al 255 (inclusive) que representa el umbral que esta cuenta establece en todas las operaciones que realiza que tienen un umbral alto. |
| Dominio de casa | cadena | Establece el dominio de casa de una cuenta. Consulta Federación. |
| Firmante | {Public Key, weight} | Agregar, actualizar o eliminar un firmante de una cuenta. El peso del firmante es un número del 0 al 255 (inclusive). El firmante se elimina si el peso es 0. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
ESTABLECER_OPCIONES_BAJO_RESERVA | -1 | Esta cuenta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por agregar una subentrada y aún satisfacer sus obligaciones de venta de XLM. Por cada nuevo firmante agregado a una cuenta, la reserva mínima de XLM que esa cuenta debe mantener aumenta. |
ESTABLECER_OPCIONES_DE_MÁS_FIRMANTES | -2 | 20 es el número máximo de firmantes que una cuenta puede tener, y agregar otro firmante excedería eso. |
ESTABLECER_OPCIONES_FLAJOS_ERRÓNEOS | -3 | Los flags establecidos y/o eliminados son inválidos por sí mismos o en combinación. |
ESTABLECER_OPCIONES_INFLACIÓN_INVÁLIDA | -4 | La cuenta de destino establecida en el campo inflation no existe. |
ESTABLECER_OPCIONES_NO_SE_PUEDE_CAMBIAR | -5 | Esta cuenta ya no puede cambiar la opción que desea cambiar. |
ESTABLECER_OPCIONES_FLAJO_DESCONOCIDO | -6 | La cuenta está tratando de establecer un flag que es desconocido. |
ESTABLECER_OPCIONES_LIMITE_DE_UMBRAL_FUERA_DE_RANGO | -7 | El valor para un peso de clave o umbral es inválido. |
ESTABLECER_OPCIONES_FIRMANTE_ERRÓNEO | -8 | Cualquier firmante adicional agregado a la cuenta no puede ser la clave maestra. |
ESTABLECER_OPCIONES_DOMINIO_HOGAR_INVÁLIDO | -9 | El dominio de casa está mal formado. |
Cambiar confianza
Crea, actualiza o elimina una línea de confianza
Aprende más sobre líneas de confianza: sección de líneas de confianza
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ChangeTrustResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Línea | ChangeTrustAsset | El activo de la línea de confianza. Por ejemplo, si un usuario extiende una línea de confianza de hasta 200 USD a un anchor, la line es USD:anchor. |
| Límite | entero | El límite de la línea de confianza. En el ejemplo anterior, el limit sería 200. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
CAMBIO_DE_CONFIANZA_MAL_FORMADO | -1 | La entrada a esta operación es inválida. |
CAMBIO_DE_CONFIANZA_NO_HAY_EMISOR | -2 | No se puede encontrar al emisor del activo. |
CAMBIO_DE_CONFIANZA_LIMITE_INVÁLIDO | -3 | El limit no es suficiente para mantener el saldo actual de la línea de confianza y aún satisfacer sus obligaciones de compra. Este error ocurre al intentar eliminar una línea de confianza con un saldo de activo distinto de cero. |
CAMBIO_DE_CONFIANZA_BAJO_RESERVA | -4 | Esta cuenta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por la adición de una subentrada y aún así satisfacer sus responsabilidades de venta de XLM. Por cada nueva línea de confianza agregada a una cuenta, la reserva mínima de XLM que esa cuenta debe mantener aumenta. |
CAMBIO_DE_CONFIANZA_NO_SE_PUEDE_AUTOCONFIANZAR | -5 | La cuenta de origen intentó crear una línea de confianza para sí misma, lo cual no está permitido. |
CAMBIO_DE_CONFIANZA_FILA_DE_CONFIANZA_FALTANTE | -6 | Falta la línea de confianza del activo para el fondo de liquidez. |
CAMBIO_DE_CONFIANZA_NO_SE_PUEDE_ELIMINAR | -7 | La línea de confianza del activo todavía está referenciada por un fondo de liquidez. |
CAMBIO_DE_CONFIANZA_NO_AUTORIZADO_MANTENER_LIABILIDADES | -8 | La línea de confianza del activo está desautorizada. |
Permitir confianza
Actualiza la bandera autorizada de una línea de confianza existente
Esta operación está en desuso desde el Protocolo 17; preferir SetTrustlineFlags en su lugar
SDKs: JavaScript | Java | Go
Umbral: Bajo
Resultado: AllowTrustResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Confiador | ID de cuenta | La cuenta del destinatario de la línea de confianza. |
| Tipo | código de activo | El código de activo de un máximo de 4 o 12 caracteres de la línea de confianza que la cuenta de origen está autorizando. Por ejemplo, si una cuenta emisora quiere permitir que otra cuenta mantenga su crédito en USD, el tipo es USD. |
| Autorizar | entero | Bandera que indica si la línea de confianza está autorizada. 1 si la cuenta está autorizada para transaccionar con el activo. 2 si la cuenta está autorizada para mantener ofertas, pero no para realizar otras transacciones |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
PERMITIR_CONFIANZA_MAL_FORMADA | -1 | El activo especificado en tipo no es válido. Además, este error ocurre cuando se especifica el activo nativo. |
PERMITIR_CONFIANZA_NO_HAY_LINEA_DE_CONFIANZA | -2 | El confiador no tiene una línea de confianza con el emisor que realiza esta operación. |
PERMITIR_CONFIANZA_NO_REQUERIDA | -3 | La cuenta de origen (emisor que realiza esta operación) no requiere confianza. En otras palabras, no tiene la bandera AUTH_REQUIRED_FLAG establecida. |
PERMITIR_CONFIANZA_NO_SE_PUEDE_REVOKAR | -4 | La cuenta de origen está intentando revocar la línea de confianza del confiador, pero no puede hacerlo. |
PERMITIR_CONFIANZA_NO_SE_PUEDE_AUTOCONFIANZAR | -5 | La cuenta de origen intentó permitir una línea de confianza para sí misma, lo cual no está permitido porque una cuenta no puede crear una línea de confianza consigo misma. |
PERMITIR_CONFIANZA_BAJO_RESERVA | -6 | Los saldos reclamables no pueden ser creados tras la revocación de líneas de confianza de activos (o acciones de fondos) asociadas con un fondo de liquidez debido a reservas bajas. |
Fusión de cuentas
Transfiere el saldo de XLM de una cuenta a otra cuenta y elimina la cuenta de origen del ledger.
SDKs: JavaScript | Java | Go
Umbral: Alto
Resultado: AccountMergeResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Destino | ID de cuenta | La cuenta que recibe el saldo restante de XLM de la cuenta de origen. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
FUSIÓN_DE_CUENTA_MAL_FORMADA | -1 | La operación está malformada porque la cuenta de origen no puede fusionarse consigo misma. La destino debe ser una cuenta diferente. El destino debe ser una cuenta diferente. |
FUSIÓN_DE_CUENTA_NO_HAY_CUENTA | -2 | La cuenta destino no existe. |
FUSIÓN_DE_CUENTA_CONJUNTO_INMUTABLE | -3 | La cuenta de origen tiene la bandera AUTH_IMMUTABLE establecida. |
FUSIÓN_DE_CUENTA_TIENE_SUBENTRADAS | -4 | La cuenta de origen tiene líneas de confianza/ofertas. |
FUSIÓN_DE_CUENTA_NUMERO_DE_SECUENCIA_DEMASIADO_LEJANO | -5 | El número de secuencia de la cuenta de origen es demasiado alto. Debe ser menor que (ledgerSeq << 32) = (ledgerSeq * 0x100000000). |
FUSIÓN_DE_CUENTA_DESTINO_LLENO | -6 | La cuenta destino no puede recibir el saldo de la cuenta de origen y aún así satisfacer sus responsabilidades de compra de lumen. |
FUSIÓN_DE_CUENTA_ES_ESPATOS | -7 | La cuenta de origen es un patrocinador. |
Administrar datos
Establece, modifica o elimina una entrada de datos (par nombre/valor) que está adjunta a una cuenta.
Aprende más sobre entradas y subentradas: Sección de cuentas
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ManageDataResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Nombre | cadena | Cadena de hasta 64 bytes de longitud. Si este es un nuevo nombre, se añadirá el par nombre/valor dado a la cuenta. Si este nombre ya está presente, entonces el valor asociado será modificado. |
| Valor | datos binarios | (opcional) Si no está presente, entonces el nombre existente será eliminado. Si está presente, entonces este valor será establecido en la entrada de datos. De hasta 64 bytes de longitud. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
ADMINISTRAR_DATOS_NO_SOPORTADOS_AÚN | -1 | La red aún no ha cambiado a este cambio de protocolo. Este error significa que la red no soporta esta función todavía. |
ADMINISTRAR_DATOS_NOMBRE_NO_ENCONTRADO | -2 | Intentando eliminar una entrada de datos que no está allí. Esto sucederá si el nombre está establecido (y el valor no) pero la cuenta no tiene una entrada de datos con ese nombre. |
ADMINISTRAR_DATOS_BAJO_RESERVA | -3 | Esta cuenta no tiene suficiente XLM para satisfacer el aumento de la reserva mínima de XLM causado por la adición de una subentrada y aún así satisfacer sus responsabilidades de venta de XLM. Por cada nueva entrada de datos agregada a una cuenta, la reserva mínima de XLM que esa cuenta debe mantener aumenta. |
ADMINISTRAR_DATOS_NOMBRE_INVÁLIDO | -4 | Nombre no es una cadena válida. |
Aumentar secuencia
Aumenta hacia adelante el número de secuencia de la cuenta de origen al número de secuencia dado, invalidando cualquier transacción con un número de secuencia más pequeño.
SDKs: JavaScript | Java | Go
Umbral: Bajo
Resultado: BumpSequenceResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| bumpTo | Número de secuencia | valor deseado para el número de secuencia de la cuenta de origen de la operación. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
AUMENTAR_SECUENCIA_SECUENCIA_ERRÓNEA | -1 | El número de secuencia bumpTo especificado no es un número de secuencia válido. Debe estar entre 0 y INT64_MAX (9223372036854775807 o 0x7fffffffffffffff). |
Crear saldo reclamable
Mueve una cantidad de activo de la cuenta fuente de la operación a una nueva ClaimableBalanceEntry.
Aprende más sobre saldos reclamables: Entrada de enciclopedia de saldos reclamables
SDKs: Java
Umbral: Medio
Resultado: CreateClaimableBalanceResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Activo | activo | Activo que se mantendrá en la ClaimableBalanceEntry en la forma asset_code:issuing_address o native (XLM). |
| Cantidad | entero | Cantidad de activo almacenada en la ClaimableBalanceEntry. |
| Reclamantes | lista de reclamantes | Lista de reclamantes (dirección de la cuenta y par ClaimPredicate) que pueden reclamar esta ClaimableBalanceEntry. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
CREAR_SALDO_RECLAMABLE_MAL_FORMADO | -1 | La entrada a esta operación no es válida. |
CREAR_SALDO_RECLAMABLE_BAJO_RESERVA | -2 | La cuenta que crea esta entrada no tiene suficientes XLM para satisfacer el mínimo aumento de reserva de XLM causado por agregar una ClaimableBalanceEntry. Por cada reclamante en la lista, la cantidad mínima de XLM que esta cuenta debe tener aumentará por baseReserve. |
CREAR_SALDO_RECLAMABLE_NO_CONFIABLE | -3 | La cuenta de origen no confía en el emisor del activo que está tratando de incluir en la ClaimableBalanceEntry. |
CREAR_SALDO_RECLAMABLE_NO_AUTORIZADO | -4 | La cuenta de origen no está autorizada para transferir este activo. |
CREAR_SALDO_RECLAMABLE_FONDOS_INSUFICIENTES | -5 | La cuenta de origen no tiene suficientes fondos para transferir la cantidad de este activo a la ClaimableBalanceEntry. |
Reclamar saldo reclamable
Reclama una ClaimableBalanceEntry que corresponde al BalanceID y agrega la cantidad de un activo de la entrada a la cuenta de origen
Aprende más sobre los saldos reclamables y ve más parámetros: Entrada de la Enciclopedia de Saldos Reclamables
SDKs: Java
Umbral: Bajo
Resultado: ClaimClaimableBalanceResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| BalanceID | claimableBalanceID | BalanceID en la ClaimableBalanceEntry que la cuenta de origen está reclamando. El balanceID se puede recuperar de un CreateClaimableBalanceResult exitoso. Consulta Entrada de la Enciclopedia de Saldos Reclamables para más información. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
RECLAMAR_SALDO_RECLAMABLE_NO_EXISTE | -1 | No hay una ClaimableBalanceEntry existente que coincida con el BalanceID de entrada. |
RECLAMAR_SALDO_RECLAMABLE_NO_SE_PUEDE_RECLAMAR | -2 | No hay un reclamante que coincida con la cuenta de origen, o el predicado de los reclamantes no está satisfecho. |
RECLAMAR_SALDO_RECLAMABLE_LÍNEA_LLENA | -3 | La cuenta que reclama la ClaimableBalanceEntry no tiene límites suficientes para recibir la cantidad del activo y seguir satisfaciendo sus obligaciones de compra. |
RECLAMAR_SALDO_RECLAMABLE_NO_CONFIABLE | -4 | La cuenta de origen no confía en el emisor del activo que está tratando de reclamar en la ClaimableBalanceEntry. |
RECLAMAR_SALDO_RECLAMABLE_NO_AUTORIZADO | -5 | La cuenta de origen no está autorizada para reclamar el activo en la ClaimableBalanceEntry. |
Comenzar a patrocinar reservas futuras
Permite a una cuenta pagar las reservas básicas para otra cuenta; la cuenta patrocinadora establece la relación de que está patrocinando reservas futuras
También debe haber una operación de fin de patrocinio de reservas futuras en la misma transacción
Aprende más sobre reservas patrocinadas: Entrada de la Enciclopedia de Reservas Patrocinadas
SDKs: Java
Umbral: Medio
Resultado: BeginSponsoringFutureReservesResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| SponsoredID | account ID | Cuenta que tendrá sus reservas patrocinadas. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
COMENZAR_A_ESPATOS_MAL_FORMADO | -1 | La cuenta de origen es igual a sponsoredID. |
COMENZAR_A_ESPATOS_YA_ESPATOS | -2 | La cuenta de origen ya está patrocinando sponsoredID. |
COMENZAR_A_ESPATOS_RECURSIVO | -3 | O la cuenta de origen está siendo patrocinada actualmente, o sponsoredID está patrocinando otra cuenta. |
Finalizar patrocinio de reservas futuras
Termina la relación actual de patrocinio de reservas futuras en la que la cuenta de origen está patrocinada
Aprende más sobre reservas patrocinadas: Entrada de la Enciclopedia de Reservas Patrocinadas
SDKs: Java
Umbral: Medio
Resultado: EndSponsoringFutureReservesResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| begin_sponsor | account ID | El ID de la cuenta que inició el patrocinio. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
FINALIZAR_ESPATOS_NO_ESPATOS | -1 | La cuenta de origen no está patrocinada. |
Revocar patrocinio
La cuenta patrocinadora puede eliminar o transferir patrocinios de ledgerEntries y signatarios existentes; la lógica de esta operación depende del estado de la cuenta de origen
Aprende más sobre reservas patrocinadas: Entrada de la Enciclopedia de Reservas Patrocinadas
Umbral: Medio
Resultado: RevokeSponsorshipResult
Esta operación es una unión con dos tipos posibles:
| Tipo de unión | Parámetros | Tipo | Descripción |
|---|---|---|---|
REVOCAR_ESAMIENTOS_ENTRADA_DE_LIBRO | LedgerKey | ledgerKey | Clave de ledger que contiene información para identificar una entrada de ledger específica cuya patrocinación puede ser modificada. Consulta LedgerKey para más información. |
O
| Tipo de unión | Parámetros | Tipo | Descripción |
|---|---|---|---|
REVOCAR_ESAMIENTOS_FIRMANTE | Firmante | {account ID, Signer Key} | Firmante que puede tener su patrocinio modificado. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
REVOCAR_ESAMIENTOS_NO_EXISTE | -1 | La ledgerEntry para LedgerKey no existe, el ID de la cuenta en el firmante no existe, o la Signer Key no existe en la cuenta del ID de cuenta. |
REVOCAR_ESAMIENTOS_NO_ESPATOS | -2 | Si la ledgerEntry/firmante está siendo patrocinado, entonces la cuenta de origen debe ser el patrocinador. Si la ledgerEntry/firmante no está patrocinado, la cuenta de origen debe ser el propietario. Este error se lanzará de lo contrario. |
REVOCAR_ESAMIENTOS_BAJO_RESERVA | -3 | La cuenta patrocinada no tiene suficientes XLM para satisfacer el aumento mínimo de saldo causado por revocar el patrocinio de una ledgerEntry/firmante que posee, o el patrocinador de la cuenta de origen no tiene suficientes XLM para satisfacer el aumento mínimo de saldo causado por patrocinar una ledgerEntry/firmante transferido. |
REVOCAR_ESAMIENTOS_SOLO_TRANSFERIBLE | -4 | No se puede eliminar el patrocinio de esta ledgerEntry. Este error ocurrirá si el usuario intenta quitar el patrocinio de una ClaimableBalanceEntry. |
REVOCAR_ESAMIENTOS_MAL_FORMADO | -5 | Uno o más de los insumos para la operación estaban mal formados. |
Recuperación
Destruye una cantidad en un activo específico de una cuenta receptora
Aprende más sobre recuperaciones: Entrada de la Enciclopedia de Recuperaciones
SDKs: JavaScript | Java | Go
Umbral: Medio
Resultado: ClawbackResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Desde | account ID | Dirección de cuenta que recibe la recuperación. |
| Activo | activo | Activo en posesión de la cuenta de destino. |
| Cantidad | entero | Cantidad del activo mencionado para destruir. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
RETROCEDER_MAL_FORMADO | -1 | La entrada a la recuperación no es válida. |
RETROCEDER_NO_HA_SIDO_ACTIVADO | -2 | La línea de confianza entre Desde y la cuenta emisora para este activo no tiene recuperación habilitada. |
RETROCEDER_NO_CONFIABLE | -3 | La cuenta Desde no confía en el emisor del activo. |
RETROCEDER_FONDOS_INSUFICIENTES | -4 | La cuenta Desde no tiene un saldo disponible suficiente del activo (teniendo en cuenta las obligaciones de venta). |
Recuperación de saldo reclamable
Recupera una ClaimableBalanceEntry no reclamada, destruyendo la cantidad pendiente del activo
Aprende más sobre recuperaciones: Entrada de la Enciclopedia de Recuperaciones
Aprende más sobre saldos reclamables: Entrada de la Enciclopedia de Saldos Reclamables
SDKs: Java
Umbral: Medio
Resultado: ClaimClaimableBalanceResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| BalanceID | claimableBalanceID | El BalanceID en la ClaimableBalanceEntry que la cuenta de origen está reclamando, que se puede recuperar de un CreateClaimableBalanceResult exitoso. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
RETROCEDER_SALDO_RECLAMABLE_NO_EXISTE | -1 | No hay una ClaimableBalanceEntry existente que coincida con el BalanceID de entrada. |
RETROCEDER_SALDO_RECLAMABLE_NO_ES_EMISOR | -2 | La cuenta de origen no es el emisor del activo en el saldo reclamable. |
RETROCEDER_SALDO_RECLAMABLE_NO_HA_SIDO_ACTIVADO | -3 | El CLAIMABLE_BALANCE_CLAWBACK_ENABLED_FLAG no está configurado para esta línea de confianza. |
Configurar las banderas de la línea de confianza
Permite a la cuenta emisora configurar la autorización y las banderas de la línea de confianza para un activo
El parámetro Activo es del tipo TrustLineAsset. Si estás modificando una línea de confianza a un activo regular (es decir, uno en formato Code:Issuer), esto es equivalente al tipo de Activo. Si estás modificando una línea de confianza a una participación de pool, sin embargo, esto se compone del ID único del pool de liquidez.
Aprende más sobre banderas: Entrada del Glosario sobre Banderas
SDKs: Java
Umbral: Bajo
Resultado: SetTrustLineFlagsResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Fiduciario | ID de cuenta | La cuenta que estableció esta línea fiduciaria. |
| Activo | TrustLineAsset | La línea fiduciaria del activo cuyos flags están siendo modificados. |
| EstablecerFlags | entero | Uno o más flags (combinados a través de OR a nivel de bits) indicando qué flags establecer. Los posibles flags son: 1 si el fiduciario está autorizado a transaccionar con el activo o 2 si el fiduciario está autorizado a mantener ofertas pero no a realizar otras transacciones. |
| BorrarFlags | entero | Uno o más flags (combinados a través de OR a nivel de bits) indicando qué flags borrar. Las posibilidades incluyen las de EstablecerFlags así como 4, que impide que el emisor recupere su activo (tanto de cuentas como de saldos reclamables). |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
ESTABLECER_FLAGS_DE_LINEA_DE_CONFIANZA_MAL_FORMADO | -1 | Esto puede suceder por varias razones: el activo especificado por AssetCode y AssetIssuer es inválido; el emisor del activo no es la cuenta fuente; el Fiduciario es la cuenta fuente; el activo nativo está especificado; o los flags que se están estableciendo/borrando son conflictivos o de otro modo inválidos. |
ESTABLECER_FLAGS_DE_LINEA_DE_CONFIANZA_NO_HAY_LINEA_DE_CONFIANZA | -2 | El Fiduciario no tiene una línea fiduciaria con el emisor que está realizando esta operación. |
ESTABLECER_FLAGS_DE_LINEA_DE_CONFIANZA_NO_SE_PUEDE_REVOKAR | -3 | El emisor está intentando revocar la autorización de la línea fiduciaria de Fiduciario, pero no puede hacerlo porque AUTH_REVOCABLE_FLAG no está establecido en la cuenta. |
ESTABLECER_FLAGS_DE_LINEA_DE_CONFIANZA_ESTADO_INVÁLIDO | -4 | Si el estado final de la línea fiduciaria tiene tanto AUTHORIZED_FLAG (1) como AUTHORIZED_TO_MAINTAIN_LIABILITIES_FLAG (2) establecidos, lo cual es mutuamente exclusivo. |
ESTABLECER_FLAGS_DE_LINEA_DE_CONFIANZA_BAJO_RESERVA | -5 | No se pueden crear saldos reclamables al revocar líneas fiduciarias de activos (o de participación en el pool) asociadas con un fondo de liquidez debido a reservas bajas. |
Depósito en el fondo de liquidez
Deposita activos en un fondo de liquidez, aumentando las reservas de un fondo de liquidez a cambio de participaciones del pool
Los parámetros de esta operación dependen del orden de los activos en el fondo de liquidez: “A” se refiere al primer activo en el fondo de liquidez, y “B” se refiere al segundo activo en el fondo de liquidez.
Si el pool está vacío, entonces esta operación deposita maxAmountA de A y maxAmountB de B en el pool. Si el pool no está vacío, entonces esta operación deposita como máximo maxAmountA de A y maxAmountB de B en el pool. Los montos reales depositados se determinan utilizando las reservas actuales del pool. Puedes usar estos parámetros para controlar un porcentaje de deslizamiento.
Aprende más sobre fondos de liquidez: Entrada de la Enciclopedia de Fondos de Liquidez
SDKs: Java
Umbral: Mediano
Resultado: LiquidityPoolDepositResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| ID del Fondo de Liquidez | liquidityPoolID | El PoolID para el Fondo de Liquidez en el que depositar. |
| Máximo Monto A | entero | Monto máximo del primer activo a depositar. |
| Máximo Monto B | entero | Monto máximo del segundo activo a depositar. |
| Precio Mínimo | {numerador, denominador} | Depósito mínimo A/deposito B. |
| Precio Máximo | {numerador, denominador} | Depósito máximo A/deposito B. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_MAL_FORMADO | -1 | Uno o más de los insumos de la operación estaban mal formados. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_NO_CONFIABLE | -2 | No existe una línea fiduciaria para uno de los activos que se están depositando. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_NO_AUTORIZADO | -3 | La cuenta no tiene autorización para uno de los activos. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_FONDOS_INSUFICIENTES | -4 | No hay suficiente saldo de uno de los activos para realizar el depósito. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_LÍNEA_LLENA | -5 | La línea fiduciaria de participación del pool no tiene un límite suficiente. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_PRECIO_ERRÓNEO | -6 | El precio de depósito está fuera de los límites dados. |
DEPÓSITO_DE_POOL_DE_LIQUIDEZ_POOL_LLENO | -7 | Las reservas del fondo de liquidez están completas. |
Retiro de fondo de liquidez
Retira activos de un fondo de liquidez, reduciendo el número de participaciones del pool a cambio de reservas de un fondo de liquidez
Los parámetros de minAmountA y minAmountB se pueden usar para controlar un porcentaje de deslizamiento desde el "precio de mercado" en el pool.
Aprende más sobre fondos de liquidez: Entrada de la Enciclopedia de Fondos de Liquidez
SDKs: Java
Umbral: Mediano
Resultado: LiquidityPoolWithdrawResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| ID del Fondo de Liquidez | liquidityPoolID | El PoolID para el Fondo de Liquidez del que retirar. |
| Monto | entero | Monto de participaciones del pool a retirar. |
| Monto Mínimo A | entero | Cantidad mínima del primer activo a retirar. |
| Monto Mínimo B | entero | Cantidad mínima del segundo activo a retirar. |
Posibles errores:
| Error | Código | Descripción |
|---|---|---|
RETIRAR_DE_POOL_DE_LIQUIDEZ_MAL_FORMADO | -1 | Uno o más de los insumos de la operación estaban mal formados. |
RETIRAR_DE_POOL_DE_LIQUIDEZ_NO_CONFIABLE | -2 | No hay línea fiduciaria para uno de los activos. |
RETIRAR_DE_POOL_DE_LIQUIDEZ_FONDOS_INSUFICIENTES | -3 | Saldo insuficiente para las participaciones del pool. |
RETIRAR_DE_POOL_DE_LIQUIDEZ_LÍNEA_LLENA | -4 | El retiro excedería el límite de la línea fiduciaria para uno de los activos. |
RETIRAR_DE_POOL_DE_LIQUIDEZ_INFERIOR_A_MÍNIMO | -5 | No se puede retirar lo suficiente para satisfacer el precio mínimo. |
Invocar función del host
Invoca e implementa contratos inteligentes de Soroban con InvokeHostFunctionOp.
InvokeHostFunctionOp se puede usar para realizar las siguientes operaciones de Soroban:
- Invocar funciones del contrato:
HOST_FUNCTION_TYPE_INVOKE_CONTRACT - Subir Wasm de los contratos:
HOST_FUNCTION_TYPE_UPLOAD_CONTRACT_WASM - Desplegar nuevos contratos usando el Wasm subido o implementaciones integradas:
HOST_FUNCTION_TYPE_CREATE_CONTRACT
Ten en cuenta que las transacciones de Soroban solo pueden contener una operación por transacción.
Aprende más aquí.
SDKs: Java
Umbral: Mediano
Resultado: InvokeHostFunctionResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Función del Host | FunciónDelHost | La función del host a invocar |
| Autenticación | Entrada de Autorización de Soroban | Autorizaciones por dirección para esta función del host. |
Errores posibles:
| Error | Código | Descripción |
|---|---|---|
INVOCAR_FUNCION_HOSPEDADA_MAL_FORMADO | -1 | Uno o más de los inputs de la operación estaban malformados. |
INVOCAR_FUNCION_HOSPEDADA_ATASCADA | -2 | La invocación de la función se atrap ó en la ejecución de Soroban. |
INVOCAR_FUNCION_HOSPEDADA_LIMITE_DE_RECURSOS_EXCEDIDO | -3 | La invocación de la función no pudo completarse dentro de las restricciones de recursos actualmente configuradas de la red. |
INVOCAR_FUNCION_HOSPEDADA_ENTRADA_ARCHIVADA | -4 | Una entrada de ledger requerida para la huella de esta función está en estado archivado y debe ser restaurada. |
INVOCAR_FUNCION_HOSPEDADA_FEE_DEVOLUTIVO_INSUFICIENTE | -5 | La tarifa reembolsable de Soroban proporcionada no fue suficiente para pagar por los recursos computacionales requeridos por esta invocación de función. |
Extender TTL de Huella
Extender el tiempo de vida (TTL) de las entradas para contratos inteligentes de Soroban con la ExtendFootprintTTLOp. Esta operación extiende el TTL de las entradas especificadas en la huella readOnly de la transacción para que vivan al menos hasta que se alcance el número de secuencia del ledger extendTo.
Ten en cuenta que las transacciones de Soroban solo pueden contener una operación por transacción.
Aprende más en la sección de Archivo de Estado.
SDKs: Java
Umbral: Medio
Resultado: ExtendFootprintTTLResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Ext | Punto de Extensión | Reservado para uso futuro. |
| Extender Hasta | entero | El número de secuencia del ledger hasta el que las entradas vivirán. |
Errores posibles:
| Error | Código | Descripción |
|---|---|---|
EXTENDER_TTL_DE_HUELLA_MAL_FORMADO | -1 | Uno o más de los inputs de la operación estaban malformados. |
EXTENDER_TTL_DE_HUELLA_LIMITE_DE_RECURSOS_EXCEDIDO | -2 | La extensión TTL no pudo completarse dentro de las restricciones de recursos actualmente configuradas de la red. |
EXTENDER_TTL_DE_HUELLA_FEE_DEVOLUTIVO_INSUFICIENTE | -3 | La tarifa reembolsable de Soroban proporcionada no fue suficiente para pagar por la extensión TTL de las entradas del ledger especificadas. |
Restaurar Huella
Hacer que las entradas archivadas de contratos inteligentes de Soroban sean accesibles nuevamente restaurándolas con RestoreFootprintOp. Esta operación restaura las entradas archivadas especificadas en la huella readWrite.
Ten en cuenta que las transacciones de Soroban solo pueden contener una operación por transacción.
Aprende más en la sección de Archivo de Estado.
SDKs: JavaScript | Java
Umbral: Medio
Resultado: RestoreFootprintResult
Parámetros:
| Parámetros | Tipo | Descripción |
|---|---|---|
| Ext | Punto de Extensión | Reservado para uso futuro. |
Errores posibles:
| Error | Código | Descripción |
|---|---|---|
RESTABLECER_HUELLA_MAL_FORMADO | -1 | Uno o más de los inputs de la operación estaban malformados. |
RESTABLECER_HUELLA_LIMITE_DE_RECURSOS_EXCEDIDO | -2 | La restauración del archivo no pudo completarse dentro de las restricciones de recursos actualmente configuradas de la red. |
RESTABLECER_HUELLA_FEE_DEVOLUTIVO_INSUFICIENTE | -3 | La tarifa reembolsable de Soroban proporcionada no fue suficiente para pagar por la restauración del archivo de las entradas del ledger especificadas. |