Blockchain App Builder genera automaticamente metodi per gestire lo stato dell'account token. I metodi del controller devono essere pubblici per poter essere richiamati. I nomi dei metodi pubblici iniziano con un carattere maiuscolo. I nomi dei metodi che iniziano con un carattere minuscolo sono privati.
-
GetAccountStatus
- Questo metodo recupera lo stato corrente dell'account token. Questo metodo può essere richiamato dal
Token Admin
del codice concatenato, da un Org Admin
dell'organizzazione specificata o dal proprietario del conto token. Questo metodo supporta anche la migrazione dei dati per il codice concatenato esistente aggiornato a una versione più recente.
-
func (t *Controller) GetAccountStatus(token_id string, org_id string, user_id string) (interface{}, error) {
account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
if err != nil {
return nil, fmt.Errorf("error in getting the generating account_id of (Org-Id: %s, User-Id: %s)", org_id, user_id)
}
auth, err := t.Ctx.Auth.CheckAuthorization("AccountStatus.Get", "TOKEN", map[string]string{"account_id": account_id})
if err != nil && !auth {
return nil, fmt.Errorf("error in authorizing the caller %s", err.Error())
}
accountStatus, err := t.Ctx.AccountStatus.GetAccountStatus(account_id)
if err != nil {
return t.Ctx.AccountStatus.GetDefaultAccountStatus(account_id)
}
return accountStatus, nil
}
- Parametri:
token_id: string
: l'ID del token.
org_id: string
: l'ID del provider di servizi di appartenenza (MSP) dell'utente nell'organizzazione corrente.
user_id: string
: il nome utente o l'ID di posta elettronica dell'utente.
- Restituisce:
- In caso di operazione riuscita, un messaggio che include i dettagli dello stato dell'account token.
- Esempio di valore restituito:
{
"AssetType": "oaccountStatus",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7",
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"Status": "active"
}
-
GetAccountStatusHistory
- Questo metodo recupera la cronologia dello stato dell'account. Questo metodo può essere richiamato dal
Token Admin
del codice concatenato, da un Org Admin
dell'organizzazione specificata o dal proprietario del conto token.
-
func (t *Controller) GetAccountStatusHistory(token_id string, org_id string, user_id string) (interface{}, error) {
account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
if err != nil {
return nil, fmt.Errorf("error in getting the generating account_id of (Org-Id: %s, User-Id: %s)", org_id, user_id)
}
_, err = t.Ctx.Account.GetAccount(account_id)
if err != nil {
return nil, fmt.Errorf("error in GetAccountStatusHistory: %s", err)
}
auth, err := t.Ctx.Auth.CheckAuthorization("AccountStatus.Get", "TOKEN", map[string]string{"account_id": account_id})
if err != nil && !auth {
return nil, fmt.Errorf("error in authorizing the caller %s", err.Error())
}
status_id, err := t.Ctx.AccountStatus.GenerateAccountStatusId(account_id)
if err != nil {
return nil, err
}
account_status_history, err := t.Ctx.AccountStatus.History(status_id)
if err != nil {
return []map[string]interface{}{}, nil
}
return account_status_history, nil
}
- Parametri:
token_id: string
: l'ID del token.
org_id: string
: l'ID del provider di servizi di appartenenza (MSP) dell'utente nell'organizzazione corrente.
user_id: string
: il nome utente o l'ID di posta elettronica dell'utente.
- Restituisce:
- In caso di operazione riuscita, un messaggio che include i dettagli della cronologia dello stato dell'account.
- Esempio di valore restituito:
[
{
"IsDelete": "false",
"Timestamp": "2022-12-02T16:20:34+05:30",
"TxId": "af1601c7a14b4becf4bb3b285d85553b39bf234caaf1cd488a284a31a2d9df78",
"Value": {
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"AssetType": "oaccountStatus",
"Status": "suspended",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7"
}
},
{
"IsDelete": "false",
"Timestamp": "2022-12-02T16:19:15+05:30",
"TxId": "4b307b989063e43add5357ab110e19174d586b9746cc8a30c9aa3a2b0b48a34e",
"Value": {
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"AssetType": "oaccountStatus",
"Status": "active",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7"
}
}
]
-
ActivateAccount
- Questo metodo attiva un account token. Questo metodo può essere chiamato solo da un
Token Admin
del codice concatenato o da un Org Admin
dell'organizzazione specificata. Impossibile attivare gli account eliminati.
-
func (t *Controller) ActivateAccount(token_id string, org_id string, user_id string) (interface{}, error) {
account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
if err != nil {
return nil, fmt.Errorf("error in getting the generating account_id of (Org-Id: %s, User-Id: %s)", org_id, user_id)
}
auth, err := t.Ctx.Auth.CheckAuthorization("AccountStatus.ActivateAccount", "TOKEN", map[string]string{"org_id": org_id})
if err != nil && !auth {
return nil, fmt.Errorf("error in authorizing the caller %s", err.Error())
}
return t.Ctx.Account.ActivateAccount(account_id)
}
- Parametri:
token_id: string
: l'ID del token.
org_id: string
: l'ID del provider di servizi di appartenenza (MSP) dell'utente nell'organizzazione corrente.
user_id: string
: il nome utente o l'ID di posta elettronica dell'utente.
- Restituisce:
- In caso di operazione riuscita, una rappresentazione JSON dell'oggetto stato account per l'account token specificato.
- Esempio di valore restituito:
{
"AssetType": "oaccountStatus",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7",
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"Status": "active"
}
-
SuspendAccount
- Questo metodo sospende un account token. Gli account sospesi possono comunque completare le operazioni di lettura. Gli utenti con account sospesi non possono inviare, ricevere, coniare o masterizzare token. Questo metodo può essere chiamato solo da un
Token Admin
del codice concatenato o da un Org Admin
dell'organizzazione specificata. Dopo la sospensione di un conto, non è possibile completare le operazioni che lo aggiornano. Impossibile sospendere un account eliminato.
-
func (t *Controller) SuspendAccount(token_id string, org_id string, user_id string) (interface{}, error) {
account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
if err != nil {
return nil, fmt.Errorf("error in getting the generating account_id of (Org-Id: %s, User-Id: %s)", org_id, user_id)
}
auth, err := t.Ctx.Auth.CheckAuthorization("AccountStatus.SuspendAccount", "TOKEN", map[string]string{"org_id": org_id})
if err != nil && !auth {
return nil, fmt.Errorf("error in authorizing the caller %s", err.Error())
}
return t.Ctx.Account.SuspendAccount(account_id)
}
- Parametri:
token_id: string
: l'ID del token.
org_id: string
: l'ID del provider di servizi di appartenenza (MSP) dell'utente nell'organizzazione corrente.
user_id: string
: il nome utente o l'ID di posta elettronica dell'utente.
- Restituisce:
- In caso di operazione riuscita, una rappresentazione JSON dell'oggetto stato account per l'account token specificato.
- Esempio di valore restituito:
{
"AssetType": "oaccountStatus",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7",
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"Status": "suspended"
}
-
DeleteAccount
- Questo metodo elimina un account token. Questo metodo può essere chiamato solo da un
Token Admin
del codice concatenato o da un Org Admin
dell'organizzazione specificata. Dopo l'eliminazione di un account, non è possibile completare le operazioni che lo aggiornano. L'account eliminato è in uno stato finale e non può essere modificato in nessun altro stato. Per eliminare un conto, il saldo del conto e il saldo in sospeso devono essere pari a zero.
-
func (t *Controller) DeleteAccount(token_id string, org_id string, user_id string) (interface{}, error) {
account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
if err != nil {
return nil, fmt.Errorf("error in getting the generating account_id of (Org-Id: %s, User-Id: %s)", org_id, user_id)
}
auth, err := t.Ctx.Auth.CheckAuthorization("AccountStatus.DeleteAccount", "TOKEN", map[string]string{"org_id": org_id})
if err != nil && !auth {
return nil, fmt.Errorf("error in authorizing the caller %s", err.Error())
}
return t.Ctx.Account.DeleteAccount(account_id)
}
- Parametri:
token_id: string
: l'ID del token.
org_id: string
: l'ID del provider di servizi di appartenenza (MSP) dell'utente nell'organizzazione corrente.
user_id: string
: il nome utente o l'ID di posta elettronica dell'utente.
- Restituisce:
- In caso di operazione riuscita, una rappresentazione JSON dell'oggetto stato account per l'account token specificato.
- Esempio di valore restituito:
{
"AssetType": "oaccountStatus",
"StatusId": "oaccountStatus~5a0b0d8b1c6433af9fedfe0d9e6580e7cf6b6bb62a0de6267aaf79f79d5e96d7",
"AccountId": "oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1",
"Status": "deleted"
}