Proyecto TypeScript andamio para el marco de taxonomía de token
Blockchain App Builder toma la entrada de su archivo de especificación de token y genera un proyecto de código de cadenas de andamios totalmente funcional.
El proyecto genera automáticamente clases y funciones de ciclo de vida de token, incluidos los métodos CRUD y no CRUD. La validación de argumentos, la canalización/anulación de canalización y la capacidad de persistencia transparente se admiten automáticamente.
Para obtener información sobre el proyecto andamio y los métodos que no están directamente relacionados con los tokens, consulte Scaffolded TypeScript Chaincode Project.
Modelo
Cada clase de modelo con token amplía la clase Token
, que a su vez amplía la clase OchainModel
. La clase Token
se importa de ../lib/token
. La capacidad de persistencia transparente, o ORM simplificado, se captura en la clase OchainModel
.
import * as yup from 'yup';
import { Id, Mandatory, Validate, ReadOnly } from '../lib/decorators';
import { Token } from '../lib/token';
@Id('token_id')
export class Digicur extends Token<Digicur> {
public readonly assetType = 'otoken';
@Mandatory()
@Validate(yup.string().required().matches(/^[A-Za-z0-9][A-Za-z0-9_-]*$/).max(16))
public token_id: string;
@ReadOnly('digicur')
public token_name: string;
@Validate(yup.string().trim().max(256))
public token_desc: string;
@ReadOnly('fungible')
public token_type: string;
@ReadOnly(["divisible","mintable","transferable","burnable","holdable","roles"])
public behaviors: string[];
@ReadOnly({minter_role_name: "minter", burner_role_name: "burner", notary_role_name: "notary"})
public roles: object;
@ReadOnly({max_mint_quantity: 20000})
public mintable: object;
@ReadOnly({decimal: 1})
public divisible: object;
@Validate(yup.number())
public token_to_currency_ratio: number;
@Validate(yup.string())
public currency_representation: string;
}
Controlador
La clase de controlador principal amplía la clase OchainController
. Solo hay un controlador principal.
export class DigiCurrCCController extends OchainController{
Puede crear cualquier número de clases, funciones o archivos, pero solo se pueden invocar los métodos definidos en la clase de controlador principal. Los otros métodos están ocultos.
Puede utilizar los métodos de SDK de token para escribir métodos personalizados para la aplicación de negocio.
Métodos de token generados automáticamente
Blockchain App Builder genera automáticamente métodos para admitir tokens y ciclos de vida de tokens. Puede utilizar estos métodos para inicializar tokens, gestionar roles y cuentas y realizar otras tareas del ciclo de vida del token sin necesidad de codificación adicional. Los métodos de controlador deben tener un decorador @Validator(...params)
para que se pueda invocar.
- Gestión del Control de Acceso
- Gestión de configuración de token
- Gestión de cuentas
- Gestión de Roles
- Gestión del historial de transacciones
- Gestión del comportamiento de los tokens
Métodos para la gestión del control de acceso
-
addTokenAdmin
- Este método agrega un usuario como
Token Admin
del código de cadenas. Este método solo puede ser llamado por unToken Admin
del código de cadena. -
removeTokenAdmin
- Este método elimina un usuario como
Token Admin
del código de cadenas. Este método solo puede ser llamado por unToken Admin
del código de cadena. -
isTokenAdmin
- Este método devuelve el valor booleano
true
si el emisor de llamada de la función esToken Admin
; de lo contrario, devuelvefalse
. UnToken Admin
oOrg Admin
puede llamar a esta función en cualquier otro usuario de la red de blockchain. Otros usuarios pueden llamar a este método solo en sus propias cuentas. -
getAllTokenAdmins
- Este método devuelve una lista de todos los usuarios que son
Token Admin
del código de cadenas. Este método solo puede ser llamado porToken Admin
o cualquierOrg Admin
del código de cadena. -
addOrgAdmin
- Este método agrega un usuario como
Org Admin
de la organización. Este método sólo puede ser llamado por unToken Admin
del código de cadena o unOrg Admin
de la organización especificada. -
removeOrgAdmin
- Este método elimina un usuario como
Org Admin
de la organización. Este método sólo puede ser llamado por unToken Admin
del código de cadena o por unOrg Admin
de la organización especificada. -
getOrgAdmins
- Este método devuelve una lista de todos los usuarios que son
Org Admin
de una organización. Este método solo puede ser llamado por unToken Admin
del código de cadena o por unOrg Admin
de cualquier organización.
Métodos para la gestión de configuración de token
-
init
- Se llama a este método cuando se despliega o actualiza el código de cadenas. Cada
Token Admin
se identifica mediante la informaciónuser_id
yorg_id
en el parámetroadminList
obligatorio.user_id
es el nombre de usuario o el ID de correo electrónico del propietario de la instancia o del usuario que está conectado a la instancia.org_id
es el ID de proveedor de servicios de miembros (MSP) del usuario en la organización de red actual. -
initialize<Token Name>Token
- Este método crea un token e inicializa las propiedades del token. El activo y sus propiedades se guardan en la base de datos de estado. Este método solo puede ser llamado por un
Token Admin
del código de cadena. -
update<Token Name>Token
- Este método actualiza las propiedades del token. Después de crear un activo de token, solo se pueden actualizar la propiedad
token_desc
y las propiedades personalizadas. Este método solo puede ser llamado por unToken Admin
del código de cadena. -
getTokenDecimals
- Este método devuelve el número de posiciones decimales configuradas para un token fraccional. Si no se ha especificado el comportamiento
divisible
para el token, el valor por defecto es 0. Este método solo se puede llamar medianteToken Admin
oOrg Admin
del código de cadenas. -
getTokenById
- Este método devuelve un objeto de token si está presente en la base de datos de estado. Este método solo se puede llamar mediante
Token Admin
oOrg Admin
del código de cadenas. -
getTokenHistory
- Este método devuelve el historial de tokens para un ID de token especificado. Cualquier usuario puede llamar a este método.
-
getAllTokens
- Este método devuelve todos los tokens que se almacenan en la base de datos de estado. Este método solo se puede llamar mediante
Token Admin
oOrg Admin
del código de cadenas. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform. -
getTokensByName
- Este método devuelve todos los objetos de token con un nombre especificado. Este método solo se puede llamar mediante
Token Admin
oOrg Admin
del código de cadenas. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform.
Métodos para la gestión de cuentas
-
createAccount
- Este método crea una cuenta para un usuario y token especificados. Se debe crear una cuenta para cualquier usuario que tenga tokens en cualquier momento. Las cuentas realizan un seguimiento de los saldos, los saldos retenidos y el historial de transacciones. Un ID de cuenta es un juego alfanumérico de caracteres, con el prefijo
oaccount~<token asset name>~
y seguido de un hash del nombre de usuario o ID de correo electrónico (user_id
) del propietario de la instancia o del usuario que está conectado a la instancia, el ID del proveedor de servicios de miembros (org_id
) del usuario en la organización de red actual. Este método sólo puede ser llamado por unToken Admin
del código de cadena o por unOrg Admin
de la organización especificada. -
associateTokenToAccount
- Este método asocia un token fungible a una cuenta. Este método solo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización relevante. -
getAccount
- Este método devuelve los detalles de cuenta de un usuario y token especificados. Este método sólo puede ser llamado por un
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta. -
getAccountHistory
- Este método devuelve los detalles del historial de cuentas de un usuario y token especificados. Este método solo puede ser llamado por un
Token Admin
del código de cadena o elAccountOwner
de la cuenta. -
getAccountOnHoldBalance
- Este método devuelve el saldo retenido actual de una cuenta y token especificados. Este método sólo puede ser llamado por un
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta. -
getAllAccounts
- Este método devuelve una lista de todas las cuentas. Este método solo puede ser llamado por un
Token Admin
del código de cadena. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform. -
getUserByAccountId
- Este método devuelve los detalles del usuario (
org_id
yuser_id
) para una cuenta especificada. Este método puede ser llamado por cualquier usuario del código de cadenas. -
getAccountBalance
- Este método devuelve el saldo actual de una cuenta y un token especificados. Este método sólo puede ser llamado por un
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta. -
getAllOrgAccounts
- Este método devuelve una lista de todas las cuentas de token que pertenecen a una organización especificada. Este método sólo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización especificada.
Métodos para la gestión de roles
-
addRole
- Este método agrega un rol a un usuario y token especificados. Este método sólo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización especificada que también posee el rol especificado. -
removeRole
- Este método elimina un rol de un usuario y token especificados. Este método sólo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización especificada que también posee el rol especificado. -
getAccountsByRole
- Este método devuelve una lista de todos los ID de cuenta para un rol y token especificados. Este método solo puede ser llamado por un
Token Admin
del código de cadena. -
getAccountsByUser
- Este método devuelve una lista de todos los ID de cuenta para un ID de organización y un ID de usuario especificados. Este método sólo puede ser llamado por el
Token Admin
del código de cadena, por elOrg Admin
de la organización especificada o por elAccount Owner
especificado en los parámetros. -
getUsersByRole
- Este método devuelve una lista de todos los usuarios para un rol y token especificados. Este método solo puede ser llamado por un
Token Admin
del código de cadena. -
isInRole
- Este método devuelve un valor booleano para indicar si un usuario y un token tienen un rol especificado. Este método sólo puede ser llamado por un
Token Admin
del código de cadena, elAccountOwner
de la cuenta o unOrg Admin
de la organización especificada. -
getOrgAccountsByRole
- Este método devuelve información sobre todas las cuentas que tienen un rol especificado en una organización especificada. Este método sólo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización especificada. -
getOrgUsersByRole
- Este método devuelve información sobre todos los usuarios que tienen un rol especificado en una organización especificada. Este método sólo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización especificada.
Métodos para la gestión del historial de transacciones
-
getAccountTransactionHistory
- Este método devuelve una matriz de detalles de historial de transacciones de cuenta para un usuario y token especificados. Este método sólo puede ser llamado por el
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta. -
getAccountTransactionHistoryWithFilters
- Este método devuelve una matriz de detalles de historial de transacciones de cuenta para un usuario y token especificados. Este método sólo puede ser llamado por el
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta. Este método solo se puede llamar cuando está conectado a la red remota de Oracle Blockchain Platform. -
getSubTransactionById
- Este método devuelve una matriz de detalles de historial de transacciones de cuenta para un usuario y token especificados. Este método solo puede ser llamado por el
Token Admin
del código de cadena o elAccountOwner
de la cuenta. -
getSubTransactionsByIdWithFilters
- Este método devuelve una matriz de detalles de historial de subtransacciones de cuenta para una transacción especificada.
-
getTransactionById
- Este método devuelve el historial de un activo
Transaction
. -
deleteHistoricalTransactions
- Este método suprime las transacciones anteriores de la base de datos de estado.
Métodos para la gestión del comportamiento de los tokens: comportamiento de Mintable
-
issueTokens
- Este método extrae tokens, que luego son propiedad del emisor del método. La persona que llama debe tener una cuenta y el rol de minter. El número de tokens que se pueden extraer está limitado por la propiedad
max_mint_quantity
del comportamientomintable
en el archivo de especificación. Si no se especifica la propiedadmax_mint_quantity
, se puede minar un número ilimitado de tokens. La cantidad debe estar dentro de los valores decimales especificados por el parámetrodecimal
del comportamientodivisible
en el archivo de especificación. Este método solo puede ser llamado por elAccountOwner
de la cuenta con el rol minter. -
getTotalMintedTokens
- Este método devuelve el número total de tokens minados para un token especificado. Este método solo puede ser llamado por un
Token Admin
o cualquierOrg Admin
del código de cadena. -
getNetTokens
- Este método devuelve el número neto total de tokens disponibles en el sistema para un token especificado. El total de tokens netos es la cantidad de tokens restantes después de quemar los tokens. En forma de ecuación: tokens netos = total de tokens minados - total de tokens quemados. Si no se graban tokens, el número de tokens de red es igual al total de tokens acuñados. Este método solo puede ser llamado por un
Token Admin
o cualquierOrg Admin
del código de cadena.
Métodos para la gestión del comportamiento de los tokens: comportamiento transferible
-
transferTokens
- Este método transfiere tokens del emisor de llamada a una cuenta especificada. El emisor de la llamada del método debe tener una cuenta. La cantidad debe estar dentro de los valores decimales especificados por el parámetro
decimal
del comportamientodivisible
en el archivo de especificación. Este método solo puede ser llamado por elAccountOwner
de la cuenta. -
bulkTransferTokens
- Este método se utiliza para realizar una transferencia masiva de tokens de la cuenta de emisor de llamada a las cuentas especificadas en el objeto
flow
. Las cantidades deben estar dentro de los valores decimales especificados por el parámetrodecimal
del comportamientodivisible
en el emisor de llamada file.The de la especificación de este método deben tener una cuenta ya creada. Este método solo puede ser llamado por elAccountOwner
de la cuenta.
Métodos para la gestión del comportamiento de los tokens: comportamiento retenible
-
holdTokens
- Este método crea una retención en nombre del propietario de los tokens con la cuenta
to_account_id
. Se especifica una cuenta de notario, que es responsable de completar o liberar la retención. Cuando se crea la retención, el saldo de token especificado del pagador se retiene. Un saldo retenido no se puede transferir hasta que la retención se haya completado o liberado. El emisor de llamada de este método debe tener una cuenta ya creada. Este método solo puede ser llamado por elAccountOwner
de la cuenta. -
executeHoldTokens
- Este método completa una retención de un token. Una cantidad de tokens previamente retenidos por un propietario de token se transfiere a un receptor. Si el valor
quantity
es menor que el valor de retención real, la cantidad restante estará disponible de nuevo para el propietario original de los tokens. Este método sólo puede ser llamado por el IDAccountOwner
con el rolnotary
para el ID de operación especificado. La retención solo puede ser completada por el notario. -
releaseHoldTokens
- Este método libera una retención de tokens. La transferencia no se ha completado y todos los tokens retenidos están disponibles de nuevo para el propietario original. El ID
AccountOwner
con el rolnotary
puede llamar a este método dentro del límite de tiempo especificado o bien el pagador, el beneficiario o el notario después del límite de tiempo especificado. -
getOnHoldIds
- Este método devuelve una lista de todos los IDs de tenencia de una cuenta especificada. Un
Token Admin
del código de cadena, unOrg Admin
de la organización especificada o elAccountOwner
de la cuenta pueden llamar a este método. -
getOnHoldDetailsWithOperationId
- Este método devuelve los detalles de la transacción retenida para un ID de operación y token especificados. Este método puede ser invocado por cualquier persona.
-
getOnHoldBalanceWithOperationId
- Este método devuelve el saldo retenido de un ID de operación y token especificados. Este método puede ser invocado por cualquier persona.
Métodos para la gestión del comportamiento de los tokens: comportamiento que se puede quemar
-
burnTokens
- Este método desactiva o graba tokens de la cuenta del emisor de la llamada de la transacción. El emisor de la llamada de este método debe tener una cuenta y el rol de quemador. La cantidad debe estar dentro de los valores decimales especificados por el parámetro
decimal
del comportamientodivisible
en el archivo de especificación.AccountOwner
de la cuenta con el rol de quemador puede llamar a este método.
Métodos personalizados
Puede utilizar los métodos de SDK de token para escribir métodos personalizados para la aplicación de negocio.
Para evitar el doble gasto, no combine varias funciones asíncronas que funcionen en los mismos pares clave-valor en la base de datos de estado. En su lugar, utilice el método bulkTransferTokens
para realizar varias transferencias en un método.
En el siguiente ejemplo se muestra cómo utilizar métodos de SDK de token en métodos personalizados. Cuando se llama al método buyTicket
, transfiere 20 tokens de la cuenta del emisor de la llamada a la cuenta del vendedor y devuelve el mensaje de transacción de la transferencia.
@Validator(yup.string(), yup.string(), yup.string(), yup.string(), yup.string())
public async buyTicket(token_id: string, seller_org_id: string, seller_user_id: string) {
const token = await this.getTokenObject(token_id);
/**
* The following method this.Ctx.Account.generateAccountId(token_id, seller_org_id, seller_user_id) generates account id of the seller.
*/
const seller_account_id = await this.Ctx.Account.generateAccountId(token_id, seller_org_id, seller_user_id);
/**
* The following method this.Ctx.Token.transfer(seller_account_id, 20, token) transfers the quantity 20 from caller's
* account & to seller's account.
*/
const transaction = await this.Ctx.Token.transfer(seller_account_id, 20, token);
return transaction;
}
Si utiliza más de un método SDK de token en un método personalizado, no utilice métodos que afecten a los mismos pares clave-valor en la base de datos de estado. En el siguiente ejemplo, se muestra la manera incorrecta de realizar varias transferencias:
@Validator(yup.string(), yup.string(), yup.string(), yup.string(), yup.string())
public async sendTokens(token_id: string, user1_org_id: string, user1_user_id: string, user2_org_id: string, user2_user_id: string) {
const token = await this.getTokenObject(token_id);
const user1_account_id = await Account.generateAccountId(token_id, user1_org_id, user1_user_id);
const user2_account_id = await Account.generateAccountId(token_id, user2_org_id, user2_user_id);
await token.transfer(user1_account_id, 20);
await token.transfer(user2_account_id, 30);
}
En su lugar, utilice el método bulkTransferTokens
para transferir a varias cuentas desde la cuenta del emisor de la llamada, como se muestra en el siguiente fragmento de código.
bulkTransferTokens(token_id: string, flow: object[])
Note:
Si utiliza más de un método SDK de token en un método personalizado que puede afectar a los mismos pares clave-valor en la base de datos de estado, active la optimización de MVCC para los códigos de cadenas de token. Para obtener más información, consulte Optimización de MVCC.Métodos de SDK de token
- Gestión del Control de Acceso
- Gestión de configuración de token
- Gestión de cuentas
- Gestión de Roles
- Gestión del historial de transacciones
- Gestión del comportamiento de los tokens
Métodos para la gestión del control de acceso
Token Admin
, Org Admin
o AccountOwner
del token. Puede utilizar esta función para asegurarse de que las operaciones solo las realizan los usuarios deseados. Cualquier acceso no autorizado genera un error. Para utilizar la función de control de acceso, importe la clase Authorization
del módulo ../lib/auth
.import { Authorization } from '../lib/auth';
-
addAdmin
- Este método agrega un usuario como
Token Admin
del código de cadena de token. -
removeAdmin
- Este método elimina un usuario como
Token Admin
del código de cadena de token. -
getAllAdmins
- Este método devuelve una lista de todos los usuarios que son
Token Admin
del código de cadena de token. -
checkAuthorization
- Utilice este método para agregar una comprobación de control de acceso a una operación. Algunos métodos de token solo pueden ser ejecutados por
Token Admin
oAccountOwner
del token o porMultipleAccountOwner
para usuarios con varias cuentas. La asignación de control de acceso se describe en el archivo../lib/constant.ts
. Puede modificar el control de acceso editando el archivo../lib/constant.ts
. Para utilizar su propio control de acceso o para desactivar el control de acceso, elimine el código de control de acceso de los métodos de controlador generados automáticamente y los métodos personalizados.export const TOKENACCESS = { ADMIN: { isUserTokenAdmin: ["Admin", "OrgAdmin"], addTokenAdmin: ["Admin"], removeTokenAdmin: ["Admin"], getAllAdmins: ["Admin", "OrgAdmin"], addOrgAdmin: ["Admin", "OrgAdminForOrgId"], removeOrgAdmin: ["Admin", "OrgAdminForOrgId"], getOrgAdmins: ["Admin", "OrgAdmin"], }, TOKEN: { save: ["Admin"], getAllTokens: ["Admin", "OrgAdmin"], get: ["Admin", "OrgAdmin"], update: ["Admin"], getDecimals: ["Admin", "OrgAdmin"], getTokensByName: ["Admin", "OrgAdmin"], addRoleMember: ["Admin", "OrgAdminRoleCheck"], removeRoleMember: ["Admin", "OrgAdminRoleCheck"], isInRole: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getTotalMintedTokens: ["Admin", "OrgAdmin"], getNetTokens: ["Admin", "OrgAdmin"], getTokenHistory: ["Admin", "OrgAdmin"], }, ROLE: { getAccountsByRole: ["Admin"], getOrgAccountsByRole: ["Admin", "OrgAdminForOrgId"], getUsersByRole: ["Admin"], getOrgUsersByRole: ["Admin", "OrgAdminForOrgId"], }, TRANSACTION: { deleteTransactions: ["Admin"], },ACCOUNT: { createAccount: ["Admin", "OrgAdminForOrgId"], associateToken: ["Admin", "OrgAdminForAccountId"], getAllAccounts: ["Admin"], getAllOrgAccounts: ["Admin", "OrgAdminForOrgId"], getAccountsByUser: ["Admin", "OrgAdminForOrgId", "MultipleAccountOwner"], getAccount: ["Admin", "OrgAdminForAccountId", "AccountOwner"], history: ["Admin", "AccountOwner"], getAccountTransactionHistory: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getAccountTransactionHistoryWithFilters: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getSubTransactionsById: ["Admin", "TransactionInvoker"], getSubTransactionsByIdWithFilters: ["Admin", "TransactionInvoker"], getAccountBalance: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getAccountOnHoldBalance: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getOnHoldIds: ["Admin", "OrgAdminForAccountId", "AccountOwner"], getConversionHistory: ["Admin", "OrgAdminForAccountId", "AccountOwner"], }, ACCOUNT_STATUS: { get: ["Admin", "OrgAdminForAccountId", "AccountOwner"], history: ["Admin", "OrgAdminForAccountId", "AccountOwner"], activateAccount: ["Admin", "OrgAdminForOrgId"], suspendAccount: ["Admin", "OrgAdminForOrgId"], deleteAccount: ["Admin", "OrgAdminForOrgId"], }, TOKEN_CONVERSION: { initializeExchangePoolUser: ["Admin"], addConversionRate: ["Admin"], updateConversionRate: ["Admin"], getConversionRate: ["Admin", "OrgAdmin", "AnyAccountOwner"], getConversionRateHistory: ["Admin", "OrgAdmin", "AnyAccountOwner"], tokenConversion: ["Admin", "AnyAccountOwner"], getExchangePoolUser: ["Admin"], }, }
-
isUserTokenAdmin
- Este método devuelve el valor booleano
true
si el emisor de llamada de la función esToken Admin
. De lo contrario, el método devuelvefalse
. -
addOrgAdmin
- Este método agrega un usuario como
Org Admin
de la organización. -
removeOrgAdmin
- Este método elimina un usuario como
Org Admin
de la organización. -
getOrgAdmins
- Este método devuelve una lista de todos los usuarios que son
Org Admin
de una organización.
Métodos para la gestión de configuración de token
-
getTokenDecimals
- Este método devuelve el número de posiciones decimales disponibles para un token fraccional. Si no se especifica el comportamiento
divisible
, el valor por defecto es 0. -
getAllTokens
- Este método devuelve todos los activos de token guardados en la base de datos de estado. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform.
-
getTokensByName
- Este método devuelve todos los activos de token con el nombre especificado. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform.
-
get
- Este método devuelve un objeto de token si está presente en la base de datos de estado.
-
isTokenType
- Este método indica si existe un activo de token con el ID especificado.
-
save
- Este método crea un token y guarda sus propiedades en la base de datos de estado.
-
update
- Este método actualiza las propiedades del token. Después de crear un activo de token, solo actualiza el valor
token_desc
y sus propiedades personalizadas. -
getByRange
- Este método llama internamente al método
getStateByRange
del tejido. Aunque el libro mayor devuelva cualquier activo con el ID especificado, este método convierte el activo en el tipo de activo de emisor de llamada. -
history
- Este método devuelve el historial para el token especificado.
Métodos para la gestión de cuentas
-
getCallerAccountId
- Este método devuelve el ID de cuenta del emisor de llamada.
-
generateAccountId
- Este método devuelve un ID de cuenta, que es un juego alfanumérico de caracteres, con el prefijo
oaccount~<token asset name>~
y seguido de un hash del nombre de usuario o ID de correo electrónico (user_id
) del propietario de la instancia o del usuario que está conectado a la instancia, el ID de proveedor de servicios de miembros (org_id
) del usuario en la organización de red actual y el ID de token único (token_id
). -
createAccount
- Este método crea una cuenta para un usuario y token especificados. Cada usuario que tenga tokens en cualquier momento debe tener una cuenta. Las cuentas realizan un seguimiento del saldo de un usuario, el saldo retenido y el historial de transacciones. Un ID de cuenta es un juego alfanumérico de caracteres, con el prefijo
oaccount~<token asset name>~
y seguido de un hash del nombre de usuario o ID de correo electrónico (user_id
) del propietario de la instancia o del usuario que está conectado a la instancia, el ID del proveedor de servicios de miembros (org_id
) del usuario en la organización de red actual. Este método sólo puede ser llamado por elToken Admin
del código de cadena o por unOrg Admin
de la organización especificada. -
associateTokenToAccount
- Este método asocia un token fungible a una cuenta. Este método solo puede ser llamado por un
Token Admin
del código de cadena o por unOrg Admin
de la organización relevante. -
getAccountWithStatus
- Este método devuelve los detalles de una cuenta especificada, incluido el estado de la cuenta.
-
getAccount
- Este método devuelve los detalles de una cuenta especificada.
-
history
- Este método devuelve una matriz de los detalles del historial de cuentas para una cuenta especificada.
-
getAccountOnHoldBalance
- Este método devuelve el saldo retenido de una cuenta especificada.
-
getAllAccounts
- Este método devuelve una lista de todas las cuentas. Este método utiliza consultas enriquecidas de SQL de base de datos de Berkeley y solo se puede llamar cuando se conecta a la red remota de Oracle Blockchain Platform.
-
getUserByAccountId
- Este método devuelve los detalles de usuario de una cuenta especificada.
-
getAccountBalance
- Este método devuelve el saldo de una cuenta especificada.
-
getAllOrgAccounts
- Este método devuelve una lista de todas las cuentas de token que pertenecen a una organización especificada.
Métodos para la gestión de roles
-
addRoleMember
- Este método agrega un rol a un usuario y token especificados.
-
removeRoleMember
- Este método elimina un rol de un usuario y token especificados.
-
getAccountsByRole
- Este método devuelve una lista de todas las cuentas para un rol y token especificados.
-
getAccountsByUser
- Este método devuelve una lista de todos los ID de cuenta de un usuario especificado.
-
getUsersByRole
- Este método devuelve una lista de todos los usuarios para un rol y token especificados.
-
isInRole
- Este método indica si un usuario y un token tienen un rol especificado.
-
roleCheck
- Este método comprueba si el ID de cuenta proporcionado es miembro de cualquier rol.
-
getOrgUsersByRole
- Este método devuelve información sobre todos los usuarios que tienen un rol especificado en una organización especificada.
-
getOrgAccountsByRole
- Este método devuelve información sobre todas las cuentas que tienen un rol especificado en una organización especificada.
Métodos para la gestión del historial de transacciones
-
getTransactionById
- Este método devuelve el historial de un activo
Transaction
. -
deleteHistoricalTransactions
- Este método devuelve una matriz de los detalles del historial de transacciones para una cuenta especificada.
-
getAccountTransactionHistory
- Este método devuelve una matriz de los detalles del historial de transacciones para una cuenta especificada.
-
getAccountTransactionHistoryWithFilters
- Este método devuelve una matriz de los detalles del historial de transacciones para una cuenta especificada. Este método solo se puede llamar cuando está conectado a la red remota de Oracle Blockchain Platform.
-
getSubTransactionHistory
- Este método devuelve una matriz de los detalles del historial de transacciones para una transacción especificada.
-
getSubTransactionHistoryWithFilters
- Este método devuelve una matriz de los detalles del historial de subtransacciones para una transacción especificada.
Gestión del comportamiento de los tokens
Token
del módulo ../lib/token
.
import { Token } from '../lib/token';
Métodos para la gestión del comportamiento de los tokens: comportamiento de Mintable
-
mint
- Este método importa una cantidad de tokens, que luego son propiedad del emisor del método. La persona que llama debe tener una cuenta y el rol de minter. La cantidad debe estar dentro de los valores decimales especificados por el parámetro
decimal
del comportamientodivisible
en el archivo de especificación. -
getTotalMintedTokens
- Este método devuelve el número total de tokens acuñados.
-
getNetTokens
- Este método devuelve la cantidad neta de tokens que están disponibles en el sistema. Los tokens de red son la cantidad de tokens que quedan después de que los tokens se queman. En forma de ecuación: tokens netos = total de tokens minados - total de tokens quemados. Si no se graban tokens, el número de tokens de red es igual al total de tokens acuñados.
-
getMaxMintQuantity
- Este método devuelve la cantidad máxima que se puede reducir para un token. Si no se especifica el comportamiento
max_mint_quantity
, el valor por defecto es 0, lo que permite la minería de cualquier número de tokens.
Métodos para la gestión del comportamiento de los tokens: comportamiento transferible
-
transfer
- Este método transfiere tokens del emisor de llamada de la transacción a la cuenta
to_account_id
. El emisor de la llamada de este método debe tener una cuenta y la cantidad debe estar dentro de los valores decimales especificados por el parámetrodecimal
del comportamientodivisible
en el archivo de especificación. -
bulkTransfer
- Este método se utiliza para realizar una transferencia masiva de tokens de la cuenta de emisor de llamada a las cuentas especificadas en el objeto
flow
. El emisor de llamada de este método debe tener una cuenta ya creada.
Métodos para la gestión del comportamiento de los tokens: comportamiento retenible
-
hold
- Este método crea una retención en nombre del propietario de los tokens con la cuenta
to_account_id
. Se especifica una cuenta de notario, que es responsable de completar o liberar la retención. Cuando se crea la retención, el saldo de token especificado del pagador se retiene. Un saldo retenido no se puede transferir hasta que la retención se haya completado o liberado. El emisor de llamada de este método debe tener una cuenta ya creada. -
executeHold
- Este método completa una retención de tokens, transfiriendo la cantidad especificada de tokens previamente retenidos al receptor. Si el valor
quantity
es menor que el valor de retención real, la cantidad restante estará disponible de nuevo para el propietario original de los tokens. Este método sólo puede ser llamado por el IDAccountOwner
con el rolnotary
para el ID de operación especificado. La retención solo puede ser completada por el notario. -
releaseHold
- Este método libera una retención de tokens. La transferencia no se ha completado y todos los tokens retenidos están disponibles de nuevo para el propietario original. El ID
AccountOwner
con el rolnotary
puede llamar a este método dentro del límite de tiempo especificado o bien el pagador, el beneficiario o el notario después del límite de tiempo especificado. -
getOnHoldIds
- Este método devuelve una lista de todos los IDs de tenencia de una cuenta especificada.
-
getOnHoldDetailsWithOperationId
- Este método devuelve los detalles de la transacción retenida para un ID de operación y token especificados.
-
getOnHoldBalanceWithOperationId
- Este método devuelve el saldo retenido de un ID de operación y token especificados. Este método puede ser invocado por cualquier persona.
Métodos para la gestión del comportamiento de los tokens: comportamiento que se puede quemar
-
burn
- Este método desactiva o graba tokens de la cuenta del emisor de la llamada de la transacción. El emisor de la llamada de este método debe tener una cuenta y el rol de quemador. La cantidad debe estar dentro de los valores decimales especificados por el parámetro
decimal
del comportamientodivisible
en el archivo de especificación.