标记分类框架的脚手架 Go 项目
Blockchain App Builder 从令牌规范文件中获取输入,并生成一个功能齐全的脚手架链代码项目。
项目自动生成令牌生命周期类和函数,包括 CRUD 和非 CRUD 方法。自动支持参数验证、编集/编集和透明持久性功能。
有关脚手架项目以及与令牌无关的方法的信息,请参见 Scaffolded Go Chaincode Project 。
型号
透明持久性功能或简化的 ORM 在 OchainModel
类中捕获。
package src
type Digicur struct {
AssetType string `json:"AssetType" final:"otoken"`
Token_id string `json:"Token_id" id:"true" mandatory:"true" validate:"regexp=^[A-Za-z0-9][A-Za-z0-9_-]*$,max=16"`
Token_name string `json:"Token_name" final:"digicur"`
Token_desc string `json:"Token_desc" validate:"max=256"`
Token_type string `json:"Token_type" final:"fungible" validate:"regexp=^fungible$"`
Behavior []string `json:"Behavior" final:"[\"divisible\",\"mintable\",\"transferable\",\"burnable\",\"holdable\",\"roles\"]"`
Roles map[string]interface{} `json:"Roles" final:"{\"minter_role_name\":\"minter\",\"burner_role_name\":\"burner\",\"notary_role_name\":\"notary\"}"`
Mintable map[string]interface{} `json:"Mintable" final:"{\"Max_mint_quantity\":20000}"`
Divisible map[string]interface{} `json:"Divisible" final:"{\"Decimal\":1}"`
Token_to_currency_ratio int `json:"Token_to_currency_ratio" validate:"int"`
Currency_representation string `json:"Currency_representation" validate:"string"`
Metadata interface{} `json:"Metadata,omitempty"`
}
主管
只有一个主控制器。
type Controller struct {
Ctx trxcontext.TrxContext
}
您可以创建任意数量的类、函数或文件,但只能调用在主控制器类中定义的方法。其他方法处于隐藏状态。
您可以使用令牌 SDK 方法为业务应用程序编写定制方法。
如果在定制方法中使用多个令牌 SDK 方法,请不要使用会影响状态数据库中相同键 - 值对的方法。
而是使用 BulkTransferTokens
方法从调用者的帐户转移到多个帐户,如以下代码片段中所示。
BulkTransferTokens(token_id string, flow: []map[string]interface{})
注意:
如果在可能影响状态数据库中相同键 - 值对的定制方法中使用多个标记 SDK 方法,请为标记链代码启用 MVCC 优化。有关更多信息,请参见 MVCC Optimization 。自动生成的标记方法
Blockchain App Builder 自动生成支持令牌和令牌生命周期的方法。您可以使用这些方法来初始化令牌、管理角色和账户,以及完成其他令牌生命周期任务,而无需任何额外的编码。控制器方法必须是 public 才能调用。公共方法名称以大写字符开头。以小写字符开头的方法名称是专用的。
访问控制管理方法
-
AddTokenAdmin
- 此方法将用户添加为链代码的
Token Admin
。此方法只能由链代码的Token Admin
调用。 -
RemoveTokenAdmin
- 此方法将用户删除为链代码的
Token Admin
。此方法只能由链代码的Token Admin
调用。 -
IsTokenAdmin
- 如果函数的调用方为
Token Admin
,则此方法返回布尔值true
,否则返回false
。Token Admin
或Org Admin
可以对区块链网络中的任何其他用户调用此函数。其他用户只能在自己的账户中调用此方法。 -
GetAllTokenAdmins
- 此方法返回链代码
Token Admin
的所有用户的列表。此方法只能由链代码的Token Admin
或Org Admin
调用。 -
AddOrgAdmin
- 此方法将用户添加为组织的
Org Admin
。此方法只能由链代码的Token Admin
或指定组织的Org Admin
调用。 -
RemoveOrgAdmin
- 此方法将用户删除为组织的
Org Admin
。此方法只能由链代码的Token Admin
或指定组织的Org Admin
调用。 -
GetOrgAdmins
- 此方法返回作为组织
Org Admin
的所有用户的列表。此方法只能由链代码的Token Admin
或任何Org Admin
调用。
标记配置管理方法
-
Init
- 部署链代码时将调用此方法。每个
Token Admin
由必需的adminList
参数中的user_id
和org_id
信息标识。user_id
是实例所有者或登录到实例的用户的用户名或电子邮件 ID。org_id
是当前网络组织中用户的成员服务提供者 (member service provider,MSP) ID。 -
Initialize<Token Name>Token
- 此方法创建令牌并初始化令牌属性。资产及其属性保存在状态数据库中。此方法只能由链代码的
Token Admin
调用。 -
Update<Token Name>Token
- 此方法更新令牌属性。创建令牌资产后,只能更新
token_desc
属性和定制属性。此方法只能由链代码的Token Admin
调用。 -
GetTokenDecimals
- 此方法返回为小数标记配置的小数位数。如果未为该标记指定
divisible
行为,则缺省值为 0。此方法只能由链代码的Token Admin
或Org Admin
调用。 -
GetTokenById
- 如果标记对象存在于状态数据库中,则此方法将返回该对象。此方法只能由链代码的
Token Admin
或Org Admin
调用。 -
GetTokenHistory
- 此方法返回指定令牌 ID 的令牌历史记录。任何用户都可以调用此方法。
-
GetAllTokens
- 此方法返回存储在状态数据库中的所有标记。此方法只能由链代码的
Token Admin
或Org Admin
调用。 -
GetTokensByName
- 此方法返回具有指定名称的所有标记对象。此方法只能由链代码的
Token Admin
或Org Admin
调用。此方法使用 Berkeley DB SQL 丰富的查询,并且只能在连接到远程 Oracle Blockchain Platform 网络时调用。
帐户管理方法
-
CreateAccount
- 此方法为指定的用户和令牌创建帐户。必须为在任何时候都具有令牌的任何用户创建账户。账户跟踪余额、暂挂余额和事务处理历史记录。帐户 ID 是字母数字字符集,前缀为
oaccount~<token asset name>~
,后跟实例所有者或登录实例的用户的用户的用户名或电子邮件 ID (user_id
) 的散列,即当前网络组织中用户的成员服务提供商 ID (org_id
)。此方法只能由链代码的Token Admin
或指定组织的Org Admin
调用。 -
AssociateTokenToAccount
- 此方法将可替换令牌与账户关联。此方法只能由链代码的
Token Admin
或相关组织的Org Admin
调用。 -
GetAccount
- 此方法返回指定用户和令牌的帐户详细信息。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。 -
GetAccountHistory
- 此方法返回指定用户和令牌的帐户历史记录详细信息。此方法只能由链代码的
Token Admin
或帐户的AccountOwner
调用。 -
GetAccountOnHoldBalance
- 此方法返回指定账户和令牌的当前暂挂余额。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。 -
GetAllAccounts
- 此方法返回所有帐户的列表。此方法只能由链代码的
Token Admin
调用。此方法使用 Berkeley DB SQL 丰富的查询,并且只能在连接到远程 Oracle Blockchain Platform 网络时调用。 -
GetUserByAccountId
- 此方法返回指定帐户的用户详细信息(
org_id
和user_id
)。链代码的任何用户都可以调用此方法。 -
GetAccountBalance
- 此方法返回指定帐户和令牌的当前余额。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。 -
GetAllOrgAccounts
- 此方法返回属于指定组织的所有令牌账户的列表。此方法只能由链代码的
Token Admin
或指定组织的Org Admin
调用。
角色管理方法
-
AddRole
- 此方法将角色添加到指定的用户和令牌。此方法只能由链代码的
Token Admin
或具有指定角色的指定组织的Org Admin
调用。 -
RemoveRole
- 此方法从指定用户和令牌中删除角色。此方法只能由链代码的
Token Admin
或同时具有指定角色的指定组织的Org Admin
调用。 -
GetAccountsByRole
- 此方法返回指定角色和令牌的所有帐户 ID 的列表。此方法只能由链代码的
Token Admin
调用。 -
GetAccountsByUser
- 此方法返回指定组织 ID 和用户 ID 的所有帐户 ID 的列表。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或参数中指定的Account Owner
调用。 -
GetUsersByRole
- 此方法返回指定角色和令牌的所有用户的列表。此方法只能由链代码的
Token Admin
或参数中指定的Account Owner
调用。 -
IsInRole
- 此方法返回布尔值,以指示用户和令牌是否具有指定的角色。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。 -
GetOrgUsersByRole
- 此方法返回有关在指定组织中具有指定角色的所有用户的信息。此方法只能由链代码的
Token Admin
或指定组织的Org Admin
调用。 -
GetOrgAccountsByRole
- 此方法返回有关在指定组织中具有指定角色的所有帐户的信息。此方法只能由链代码的
Token Admin
或指定组织的Org Admin
调用。
事务处理历史记录管理方法
-
GetAccountTransactionHistory
- 此方法返回指定用户和令牌的账户事务处理历史记录详细信息数组。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。 -
GetAccountTransactionHistoryWithFilters
- 此方法返回指定用户和令牌的账户事务处理历史记录详细信息数组。此方法只能由链代码的
Token Admin
、指定组织的Org Admin
或帐户的AccountOwner
调用。只能在连接到远程 Oracle Blockchain Platform 网络时调用此方法。 -
GetSubTransactionsById
- 此方法返回指定事务处理的子事务处理历史记录详细信息数组。
-
GetSubTransactionsByIdWithFilters
- 此方法返回指定事务处理的子事务处理历史记录详细信息数组。
-
GetTransactionById
- 此方法返回
Transaction
资产的历史记录。 -
DeleteHistoricalTransactions
- 此方法从状态数据库中删除较早的事务处理。
令牌行为管理方法 - 最小行为
-
IssueTokens
- 此方法铸造标记,然后由方法的调用方拥有。调用方必须具有帐户和 minter 角色。可铸造的标记数受规范文件中
mintable
行为的max_mint_quantity
属性的限制。如果未指定max_mint_quantity
属性,则可以建立无限数量的标记。数量必须在规范文件中divisible
行为的decimal
参数指定的小数值范围内。此方法只能由具有 minter 角色的帐户的AccountOwner
调用。 -
GetTotalMintedTokens
- 此方法返回指定令牌的铸造令牌总数。此方法只能由链代码的
Token Admin
或Org Admin
调用。 -
GetNetTokens
- 此方法返回系统中指定令牌的可用令牌总数。净令牌总数是指刻录令牌后剩余的令牌数量。在方程式中,净令牌 = 总铸造令牌 - 总燃烧令牌数。如果没有刻录令牌,则净令牌数等于铸造令牌总数。此方法只能由链代码的
Token Admin
或Org Admin
调用。
令牌行为管理方法 - 可转移行为
-
TransferTokens
- 此方法将令牌从调用方转移到指定的帐户。方法的调用者必须有一个帐户。数量必须在规范文件中
divisible
行为的decimal
参数指定的小数值范围内。此方法只能由帐户的AccountOwner
调用。 -
BulkTransferTokens
- 此方法用于将标记从调用方帐户批量传输到
flow
对象中指定的帐户。数量必须位于此方法的 file.The 调用方规范中divisible
行为的decimal
参数指定的小数值内,并且必须已创建帐户。此方法只能由帐户的AccountOwner
调用。
令牌行为管理方法 - 可持有行为
-
HoldTokens
- 此方法代表具有
to_account_id
帐户的令牌的所有者创建暂挂。指定了公证帐户,该帐户负责完成或释放暂挂。创建暂挂时,付款人指定的标记余额将被暂挂。在完成或释放暂挂之前,无法转移暂挂余额。此方法的调用者必须已创建账户。此方法只能由帐户的AccountOwner
调用。 -
ExecuteHoldTokens
- 此方法完成对令牌的暂挂。令牌所有者以前持有的一定数量的令牌会传输到接收者。如果
quantity
值小于实际暂挂值,则剩余金额将再次提供给令牌的原始所有者。此方法只能由具有notary
角色的AccountOwner
ID 调用。持仓只能由公证人完成。 -
ReleaseHoldTokens
- 此方法释放对令牌的暂挂。转移未完成,所有保留的令牌都可供原始所有者使用。此方法可由具有
notary
角色的Account Owner
ID 在指定时间限制内调用,或在指定时间限制后由付款人、收款人或公证人调用。 -
GetOnHoldIds
- 此方法返回指定帐户的所有暂挂 ID 的列表。此方法可由链代码的
Token Admin
、指定组织的Org Admin
或帐户的Account Owner
调用。 -
GetOnHoldDetailsWithOperationId
- 此方法返回指定操作 ID 和令牌的暂挂事务处理详细信息。任何人都可以调用此方法。
-
GetOnHoldBalanceWithOperationId
- 此方法返回指定操作 ID 和令牌的暂挂余额。任何人都可以调用此方法。
令牌行为管理方法 - 可燃行为
定制方法
您可以使用令牌 SDK 方法为业务应用程序编写定制方法。
使用令牌 SDK 方法时,请确保跟踪返回值。此外,为了避免双重花费,请不要组合多个对状态数据库中的相同键 - 值对进行操作的异步函数。请改用 BulkTransferTokens
方法,以一种方法进行多次传输。
以下示例说明如何在定制方法中使用令牌 SDK 方法。调用 BuyTicket
方法时,它将 20 个令牌从调用者的帐户传输到卖方的帐户,并返回传输的交易消息。
func (t *Controller) BuyTicket(TokenId string, SellerOrgId string, SellerUserId string) (interface{}, error){
token, err := t.Ctx.Token.Get(TokenId)
if err != nil {
return nil, err
}
/**
* The following method t.Ctx.Account.GenerateAccountId(TokenId, SellerOrgId, SellerUserId) generates account id of the seller
*/
sellerAccountId, err := t.Ctx.Account.GenerateAccountId(TokenId, SellerOrgId, SellerUserId)
if err != nil {
return nil, err
}
/**
* The following method t.Ctx.Token.Transfer(sellerAccountId, 20, token) transfers the quantity 20 from caller's
* account & to seller's account.
*/
transaction, err := t.Ctx.Token.Transfer(sellerAccountId, 20, token)
if err != nil {
return nil, err
}
return transaction, nil
}
标记 SDK 方法
访问控制管理方法
Token Admin
、Org Admin
或 AccountOwner
调用。您可以使用此功能来确保操作仅由目标用户执行。任何未经授权的访问都会导致错误。要使用访问控制函数,请从 ../lib/auth
模块导入 Authorization
类。import { Authorization } from '../lib/auth';
-
AddAdmin
- 此方法将用户添加为令牌链代码的
Token Admin
。 -
RemoveAdmin
- 此方法将用户删除为令牌链代码的
Token Admin
。 -
GetAllAdmins
- 此方法返回作为令牌链代码的
Token Admin
的所有用户的列表。 -
GetAllAdminUsers
- 此方法返回作为令牌链代码的
Token Admin
的所有用户的列表。 -
CheckAuthorization
- 使用此方法向链代码添加访问控制。许多自动生成的令牌方法都使用访问控制。
oChainUtil.go
文件中介绍了 SDK 接收器与具有访问控制的方法之间的映射。要使用您自己的访问控制或禁用访问控制,请从自动生成的控制器方法和定制方法中删除访问控制代码。var t TokenAccess var r RoleAccess var a AccountAccess var as AccountStatusAccess var h HoldAccess var ad AdminAccess var trx TransactionAccess var tc TokenConversionAccess var auth AuthAccess auth.IsTokenAdmin = []string{"Admin", "MultipleAccountOwner"} trx.DeleteHistoricalTransactions = []string{"Admin"} ad.AddAdmin = []string{"Admin"} ad.RemoveAdmin = []string{"Admin"} ad.GetAllAdmins = []string{"Admin", "OrgAdmin"} ad.AddOrgAdmin = []string{"Admin", "OrgAdminOrgIdCheck"} ad.RemoveOrgAdmin = []string{"Admin", "OrgAdminOrgIdCheck"} ad.GetOrgAdmins = []string{"Admin", "OrgAdmin"} ad.IsTokenAdmin = []string{"Admin", "MultipleAccountOwner", "OrgAdmin"} t.Save = []string{"Admin"} t.GetAllTokens = []string{"Admin", "OrgAdmin"} t.Update = []string{"Admin"} t.GetTokenDecimals = []string{"Admin", "OrgAdmin"} t.GetTokensByName = []string{"Admin", "OrgAdmin"} t.AddRoleMember = []string{"Admin", "OrgAdminRoleCheck"} t.RemoveRoleMember = []string{"Admin", "OrgAdminRoleCheck"} t.IsInRole = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} t.GetTotalMintedTokens = []string{"Admin", "OrgAdmin"} t.GetNetTokens = []string{"Admin", "OrgAdmin"} t.Get = []string{"Admin", "OrgAdmin"} t.GetTokenHistory = []string{"Admin", "OrgAdmin"} a.CreateAccount = []string{"Admin", "OrgAdminOrgIdCheck"} a.AssociateToken = []string{"Admin", "OrgAdminAccountIdCheck"} a.GetAllAccounts = []string{"Admin"} a.GetAllOrgAccounts = []string{"Admin", "OrgAdminOrgIdCheck"} a.GetAccount = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.History = []string{"Admin", "AccountOwner"} a.GetAccountTransactionHistory = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountTransactionHistoryWithFilters = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetSubTransactionsById = []string{"Admin", "TransactionInvoker"} a.GetSubTransactionsByIdWithFilters = []string{"Admin", "TransactionInvoker"} a.GetAccountBalance = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountOnHoldBalance = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetOnHoldIds = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountsByUser = []string{"Admin", "OrgAdminOrgIdCheck", "MultipleAccountOwner"} as.Get = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} as.ActivateAccount = []string{"Admin", "OrgAdminOrgIdCheck"} as.SuspendAccount = []string{"Admin", "OrgAdminOrgIdCheck"} as.DeleteAccount = []string{"Admin", "OrgAdminOrgIdCheck"} r.GetAccountsByRole = []string{"Admin"} r.GetUsersByRole = []string{"Admin"} r.GetOrgAccountsByRole = []string{"Admin", "OrgAdminOrgIdCheck"} r.GetOrgUsersByRole = []string{"Admin", "OrgAdminOrgIdCheck"} tc.InitializeExchangePoolUser = []string{"Admin"} tc.AddConversionRate = []string{"Admin"} tc.UpdateConversionRate = []string{"Admin"} tc.GetConversionRate = []string{"Admin", "OrgAdmin", "AnyAccountOwner"} tc.GetConversionRateHistory = []string{"Admin", "OrgAdmin", "AnyAccountOwner"} tc.TokenConversion = []string{"Admin", "AnyAccountOwner"} tc.GetExchangePoolUser = []string{"Admin"}
-
IsUserTokenAdmin
- 如果函数的调用方为
Token Admin
,则此方法返回布尔值true
。否则,方法返回false
。 -
AddOrgAdmin
- 此方法将用户添加为组织的
Org Admin
。 -
RemoveOrgAdmin
- 此方法将用户删除为组织的
Org Admin
。 -
GetOrgAdmins
- 此方法返回作为组织
Org Admin
的所有用户的列表。
标记配置管理方法
-
GetTokenDecimals
- 此方法返回可用于小数标记的小数位数。如果未指定
divisible
行为,则缺省值为 0。 -
GetAllTokens
- 此方法返回保存在状态数据库中的所有标记资产。此方法使用 Berkeley DB SQL 丰富的查询,并且只能在连接到远程 Oracle Blockchain Platform 网络时调用。
-
GetTokensByName
- 此方法返回具有指定名称的所有标记资产。此方法使用 Berkeley DB SQL 丰富的查询,并且只能在连接到远程 Oracle Blockchain Platform 网络时调用。
-
Get
- 如果标记对象存在于状态数据库中,则此方法将返回该对象。此方法只能由令牌链代码的
Token Admin
调用。 -
IsTokenType
- 此方法测试指定令牌 ID 是否存在令牌资产。
-
Save
- 此方法创建令牌并将其属性保存在状态数据库中。
-
Update
- 此方法更新令牌属性。创建令牌资产后,只能更新
token_desc
值及其定制属性。 -
GetByRange
- 此方法在内部调用网状结构网络
getStateByRange
方法。即使从分类账返回具有给定 ID 的任何资产,此方法也会将资产转换为调用方资产类型。 -
History
- 此方法返回指定令牌 ID 的令牌历史记录。
帐户管理方法
-
GenerateAccountId
- 此方法返回帐户 ID,这是一组字母数字字符,前缀为
oaccount~<token asset name>~
,后跟实例所有者或登录实例的用户的用户的用户名或电子邮件 ID (user_id
)、当前网络组织中用户的成员服务提供商 ID (org_id
) 和唯一令牌 ID (token_id
) 的散列。 -
CreateAccount
- 此方法为指定的用户和令牌创建帐户。任何时候都有代币的用户都必须有一个帐户。账户跟踪用户的余额、暂挂余额和事务处理历史记录。帐户 ID 是字母数字字符集,前缀为
oaccount~<token asset name>~
,后跟实例所有者或登录实例的用户的用户的用户名或电子邮件 ID (user_id
) 的散列,即当前网络组织中用户的成员服务提供商 ID (org_id
)。此方法只能由链代码的Token Admin
调用。 -
AssociateToken
- 此方法将可替换令牌与账户关联。此方法只能由链代码的
Token Admin
调用。 -
GetAccountWithStatus
- 此方法返回指定帐户的帐户详细信息,包括帐户状态。
-
GetAccount
- 此方法返回指定帐户的帐户详细信息。
-
GetAccountHistory
- 此方法返回指定帐户的帐户历史记录详细信息数组。
-
GetAccountOnHoldBalance
- 此方法返回指定帐户的暂挂余额。
-
GetAllAccounts
- 此方法返回所有帐户的列表。此方法使用 Berkeley DB SQL 丰富的查询,并且只能在连接到远程 Oracle Blockchain Platform 网络时调用。
-
GetUserByAccountId
- 此方法返回指定帐户的用户详细信息。
-
GetAccountBalance
- 此方法返回指定帐户的帐户余额。
-
GetAllOrgAccounts
- 此方法返回属于指定组织的所有令牌账户的列表。
角色管理方法
-
AddRoleMember
- 此方法将角色添加到指定的用户和令牌。
-
RemoveRoleMember
- 此方法从指定用户和令牌中删除角色。
-
GetAccountsByRole
- 此方法返回指定角色和令牌的所有帐户的列表。
-
GetUsersByRole
- 此方法返回指定角色和令牌的所有用户的列表。
-
IsInRole
- 此方法指示用户和令牌是否具有指定的角色。
-
RoleCheck
- 此方法检查提供的账户 ID 是否为任何角色的成员。
-
GetOrgUsersByRole
- 此方法返回有关在指定组织中具有指定角色的所有用户的信息。
-
GetOrgAccountsByRole
- 此方法返回有关在指定组织中具有指定角色的所有帐户的信息。
事务处理历史记录管理方法
-
GetAccountTransactionHistory
- 此方法返回指定帐户的事务处理历史记录详细信息数组。
-
GetAccountTransactionHistoryWithFilters
- 此方法返回指定事务处理的事务处理历史记录详细信息数组。只能在连接到远程 Oracle Blockchain Platform 网络时调用此方法。
-
GetSubTransactionsById
- 此方法返回指定事务处理的事务处理历史记录详细信息数组。
-
GetSubTransactionsByIdWithFilters
- 此方法返回指定事务处理的事务处理历史记录详细信息数组。
-
GetTransactionById
- 此方法返回
Transaction
资产的历史记录。 -
DeleteHistoricalTransactions
- 此方法从状态数据库中删除较早的事务处理。
令牌行为管理方法 - 最小行为
-
Mint
- 此方法铸造标记,然后由方法的调用方拥有。调用方必须具有帐户和 minter 角色。可铸造的标记数受规范文件中
mintable
行为的max_mint_quantity
属性的限制。如果未指定max_mint_quantity
属性,则可以建立无限数量的标记。数量必须在规范文件中divisible
行为的decimal
参数指定的小数值范围内。此方法只能由具有 minter 角色的帐户的AccountOwner
调用。 -
GetTotalMintedTokens
- 此方法返回铸造的标记总数。
-
GetNetTokens
- 此方法返回系统中可用于指定令牌的令牌的净数量。净令牌是烧毁令牌后剩余的令牌数量。在方程式中:净令牌 = 总铸造令牌 - 总燃烧令牌数。如果没有刻录令牌,则净令牌数等于铸造令牌总数。
-
GetMaxMintQuantity
- 此方法返回令牌的最大可最小数量。如果未指定
max_mint_quantity
行为,则缺省值为 0,这允许建立任意数量的标记。
令牌行为管理方法 - 可转移行为
-
Transfer
- 此方法将令牌从调用方转移到指定的帐户。方法的调用者必须有一个帐户。数量必须在规范文件中
divisible
行为的decimal
参数指定的小数值范围内。此方法只能由帐户的AccountOwner
调用。 -
BulkTransfer
- 此方法用于将标记从调用方帐户批量传输到
flow
对象中指定的帐户。此方法的调用者必须已创建账户。
令牌行为管理方法 - 可持有行为
-
Hold
- 此方法代表具有
to_account_id
帐户的令牌的所有者创建暂挂。指定了公证帐户,该帐户负责完成或释放暂挂。创建暂挂时,付款人指定的标记余额将被暂挂。在完成或释放暂挂之前,无法转移暂挂余额。此方法的调用者必须已创建账户。 -
ExecuteHold
- 此方法完成对令牌的暂挂,将以前暂挂的指定数量的令牌转移到接收者。如果
quantity
值小于实际暂挂值,则剩余金额将再次提供给令牌的原始所有者。此方法只能由具有notary
角色的AccountOwner
ID 调用。 -
ReleaseHold
- 此方法释放对令牌的暂挂。转移未完成,所有保留的令牌都可供原始所有者使用。此方法可由具有
notary
角色的Account Owner
ID 在指定时间限制内调用,或在指定时间限制后由付款人、收款人或公证人调用。 -
GetOnHoldIds
- 此方法返回指定用户和令牌的所有保留 ID 的列表。
-
GetOnHoldDetailsWithOperationID
- 此方法返回指定操作 ID 和令牌的暂挂事务处理详细信息。
-
GetOnHoldBalanceWithOperationID
- 此方法返回指定操作 ID 和令牌的暂挂余额。
令牌行为管理方法 - 可燃行为