Métodos TypeScript para la conversión de token
Blockchain App Builder genera automáticamente métodos que puede utilizar para convertir tokens fungibles que utilizan el estándar de Token Taxonomy Framework.
Los métodos de conversión de tokens incluyen el concepto de la agrupación de intercambio. La cuenta de grupo de intercambio está financiada por otras cuentas de token. Cuando acuña tokens, puede especificar que un porcentaje de los tokens acuñados se transfiera a la cuenta de grupo de intercambio.
Proceso de Conversión de Token
Un flujo típico para convertir tokens sigue estos pasos:- Llame al método
initializeExchangePoolUser
para inicializar el usuario del pool de intercambio. - Llame al método
createExchangePoolAccounts
para crear cuentas de grupo de intercambio. Cree una cuenta de grupo de intercambio para cada tipo de token fungible que desee convertir o convertir. - Llame al método
addConversionRate
para establecer la tasa de conversión para cada par de tokens entre los que desea convertir. - Financie las cuentas de token de grupo de cambio de una de las siguientes maneras:
- Transfiera tokens a las cuentas de token de grupo de intercambio mediante los métodos de transferencia estándar.
- Llame al método
mintWithFundingExchangePoolToken
al acuñar tokens, que puede transferir un porcentaje de tokens acuñados a una cuenta de grupo de intercambio.
- Llame al método
tokenConversion
para convertir entre dos tokens fungibles. Un solo usuario puede convertir tokens entre dos de sus cuentas de token, o un par de usuarios pueden convertir tokens directamente de una cuenta a otra. - El usuario de grupo de cambio puede ver los saldos de cuenta de grupo de cambio y las transacciones de cuenta.
- Llame al método
getAccount
para ver los saldos de cada una de las cuentas de token de pool de cambios. - Llame a los métodos
getAccountTransactionHistory
ygetAccountTransactionHistoryWithFilters
para ver las transacciones de cuenta de cada una de las cuentas de token de grupo de intercambio.
- Llame al método
Métodos de conversión de token generados automáticamente
Blockchain App Builder genera automáticamente métodos para convertir entre diferentes tipos de tokens fungibles. Los métodos de controlador deben tener un decorador @Validator(...params)
para que se pueda invocar.
-
initializeExchangePoolUser
- Este método inicializa el usuario del pool de intercambio, que es una actividad única. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
createExchangePoolAccounts
- Este método crea cuentas de token de pool de intercambio para una matriz determinada de ID de token. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
addConversionRate
- Este método agrega una tasa de conversión para un par de tokens. La tasa de conversión del token se puede especificar hasta ocho decimales. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
getConversionRate
- Este método obtiene la tasa de conversión actual para un par de tokens. Este método lo puede llamar el
Token Admin
del código de cadenas, cualquierOrg Admin
y cualquier propietario de cuenta de token. -
updateConversionRate
- Este método actualiza la tasa de conversión actual para un par de tokens. La tasa de conversión del token se puede especificar hasta ocho decimales. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
mintWithFundingExchangePool
- Este método acuña tokens en la cuenta del emisor de llamada en función del ID de token y la cantidad especificados. A continuación, se transfiere un porcentaje de tokens de la cantidad acuñada a la cuenta de token de grupo de intercambio.
-
tokenConversion
- Este método convierte tokens de la cuenta del emisor de llamada a la cuenta especificada por los valores
to_token_id
,to_org_id
yto_user_id
. Este método lo puede llamar elToken Admin
del código de cadenas y cualquier propietario de cuenta de token. Un usuario de grupo de intercambio no puede llamar a este método. -
getConversionHistory
- Este método devuelve el historial de conversión de token para una cuenta de token especificada. Este método puede ser llamado por el
Token Admin
del código de cadenas, unOrg Admin
de la organización especificada o por el propietario de la cuenta de token. -
getConversionRateHistory
- Este método devuelve el historial de ratio de conversión de tokens para un par de tokens. Este método lo puede llamar el
Token Admin
del código de cadenas, cualquierOrg Admin
y cualquier propietario de cuenta de token. -
getExchangePoolUser
- Este método devuelve los valores
org_id
yuser_id
para el usuario del pool de intercambio. Este método solo puede ser llamado porToken Admin
del código de cadenas.
Métodos SDK de conversión de token
-
initializeExchangePoolUser
- Este método inicializa el usuario del pool de intercambio, que es una actividad única. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
createExchangePoolAccounts
- Este método crea cuentas de token de pool de intercambio para una matriz determinada de ID de token. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
addConversionToken
- Este método agrega tokens con una nueva tasa de conversión para un token especificado. La tasa de conversión del token se puede especificar hasta ocho decimales. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
get
- Este método obtiene la tasa de conversión actual para un par de tokens. Este método lo puede llamar el
Token Admin
del código de cadenas y cualquier propietario de cuenta de token. -
updateTokenConversionRate
- Este método actualiza la tasa de conversión actual para un par de tokens. La tasa de conversión del token se puede especificar hasta ocho decimales. Este método solo puede ser llamado por
Token Admin
del código de cadenas. -
mintWithFundingExchangePool
- Este método acuña tokens en la cuenta del emisor de llamada en función del ID de token y la cantidad especificados. A continuación, se transfiere un porcentaje de tokens de la cantidad acuñada a la cuenta de token de grupo de intercambio.
-
tokenConversion
- Este método convierte tokens de la cuenta del emisor de llamada a la cuenta especificada por los valores
to_token_id
,to_org_id
yto_user_id
. Este método lo puede llamar elToken Admin
del código de cadenas y cualquier propietario de cuenta de token. Un usuario de grupo de intercambio no puede llamar a este método. -
getTokenConversionHistory
- Este método devuelve el historial de conversión de token para una cuenta de token especificada. Este método puede ser llamado por el
Token Admin
del código de cadenas, unOrg Admin
de la organización especificada y por el propietario de la cuenta de token. -
history
- Este método devuelve el historial de ratio de conversión de tokens para un par de tokens. Este método lo puede llamar el
Token Admin
del código de cadenas, cualquierOrg Admin
y cualquier propietario de cuenta de token. -
getExchangePoolUser
- Este método devuelve los valores
OrgId
yUserId
para el usuario del pool de intercambio. Este método solo puede ser llamado porToken Admin
del código de cadenas.