Account

代表帳本中帳戶的狀態。

JSON 表示法 
{
  "sequenceNumber": string,
  "publicKey": string,
  "roundId": string,
  "comment": string,

  // Union field account_details can be only one of the following:
  "userDetails": {
    object (UserDetails)
  },
  "accountManagerDetails": {
    object (AccountManagerDetails)
  },
  "tokenManagerDetails": {
    object (TokenManagerDetails)
  },
  "contractTokenManagerDetails": {
    object (ContractTokenManagerDetails)
  },
  "contractDetails": {
    object (ContractDetails)
  },
  "clearinghouseDetails": {
    object (ClearingHouseDetails)
  },
  "currencyOperatorDetails": {
    object (CurrencyOperatorDetails)
  },
  "platformOperatorDetails": {
    object (PlatformOperatorDetails)
  }
  // End of list of possible types for union field account_details.
}
欄位
sequenceNumber

string (int64 format)

僅供輸出。這個帳戶的序號。這個數字會隨著此帳戶傳送的每筆交易遞增。
publicKey

string (bytes format)

僅供輸出。與這個帳戶相關聯的主要公開金鑰，用於驗證簽章。

Base64 編碼字串。
roundId

string (int64 format)

僅供輸出。執行回合的 ID (類似於區塊「高度」)，提供帳戶資訊時的準確度。
comment

string

僅供輸出。建立這個帳戶時儲存的帳戶註解。
聯集欄位 account_details。具體詳細資料取決於帳戶類型。account_details 只能是下列其中一個設定：
userDetails

object (UserDetails)

僅供輸出。標準使用者帳戶的詳細資料。
accountManagerDetails

object (AccountManagerDetails)

僅供輸出。帳戶管理員帳戶的詳細資料。
tokenManagerDetails

object (TokenManagerDetails)

僅供輸出。權杖管理員帳戶的詳細資料。
contractTokenManagerDetails

object (ContractTokenManagerDetails)

僅供輸出。合約代幣管理員帳戶的詳細資料。
contractDetails

object (ContractDetails)

僅供輸出。智慧合約帳戶的詳細資料。
clearinghouseDetails

object (ClearingHouseDetails)

僅供輸出。結算中心帳戶的詳細資料。
currencyOperatorDetails

object (CurrencyOperatorDetails)

僅供輸出。貨幣營運商帳戶的詳細資料。
platformOperatorDetails

object (PlatformOperatorDetails)

僅供輸出。平台營運商帳戶的詳細資料。

UserDetails

使用者帳戶的詳細資料。

JSON 表示法 
{
  "accountManager": {
    object (Entity)
  },
  "accountManagerId": string,
  "tokenManager": {
    object (Entity)
  },
  "tokenManagerId": string,
  "roles": [
    enum (Role)
  ],
  "accountStatus": enum (AccountStatus),
  "balance": {
    object (CurrencyValue)
  },
  "accountFields": {
    string: {
      object (Fields)
    },
    ...
  },
  "contractAccountFields": {
    string: {
      object (Fields)
    },
    ...
  }
}
欄位
accountManager
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 accountManagerId。這位使用者的帳戶管理員。
accountManagerId

string

僅供輸出。這位使用者的帳戶管理員 ID。
tokenManager
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 tokenManagerId。這位使用者的權杖管理員。
tokenManagerId

string

僅供輸出。這個使用者的權杖管理工具 ID。
roles[]

enum (Role)

僅供輸出。授予這個帳戶的角色清單。
accountStatus

enum (AccountStatus)

僅供輸出。這個帳戶的狀態。
balance

object (CurrencyValue)

僅供輸出。這個使用者帳戶的權杖餘額。
accountFields
(deprecated)

map (key: string, value: object (Fields))

僅供輸出。已淘汰：請改用 contractAccountFields。這個使用者的合約帳戶欄位 (合約 ID -> 欄位)。

包含 "key": value 組合清單的物件，例如 { "name": "wrench", "mass": "1.3kg", "count": "3" }。
contractAccountFields

map (key: string, value: object (Fields))

僅供輸出。這個使用者的合約帳戶欄位 (合約 ID -> 欄位)。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

實體

Universal Ledger 網路中的實體。所有帳戶都附加至實體。實體 ID (也常稱為帳戶 ID) 是網路中專屬且不可變更的 ID。

JSON 表示法 
{
  "id": string
}
欄位
id

string

僅供輸出。指派給實體的 ID。這是由電視網在建立帳戶時指派。

角色

一般角色。

列舉
ROLE_UNSPECIFIED 角色無效。
ROLE_PAYER 可讓帳戶啟動付款交易的角色。
ROLE_RECEIVER 可讓帳戶收款的角色。
ROLE_CONTRACT_CREATOR 這個角色可讓帳戶部署合約。
ROLE_CONTRACT_PARTICIPANT 這個角色可讓帳戶與已部署的合約互動。

AccountStatus

帳戶狀態。

列舉
ACCOUNT_STATUS_UNSPECIFIED 狀態無效。
ACCOUNT_STATUS_ACTIVE 帳戶處於有效狀態，可執行角色允許的操作。
ACCOUNT_STATUS_INACTIVE 帳戶處於非使用中狀態，禁止進行所有交易。帳戶管理員仍可傳送帳戶管理交易。

CurrencyValue

代表貨幣金額 (即金錢)。請注意，這則訊息不會顯示幣別。相關幣別由交易傳送帳戶決定。每個帳戶都有專屬的固定幣別。

JSON 表示法 
{
  "value": string
}
欄位
value

string (int64 format)

這是必要旗標，貨幣的次要單位數。

這個最小有效面額稱為「次要單位」，並在 ISO 4217 中指定。舉例來說，如果是美元，值會是美分數量；如果是英鎊，值會是便士數量。日圓沒有輔幣，因此會是日圓數量。

欄位

合約中的欄位對應 (欄位名稱 -> 值)，用於代表合約欄位或帳戶欄位。

JSON 表示法 
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
欄位
fields

map (key: string, value: object (Value))

僅供輸出。欄位名稱與值的對應。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

值

某種型別的具體值。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "noneValue": enum (NoneValue),
  "boolValue": boolean,
  "int64Value": string,
  "stringValue": string,
  "accountId": string,
  "dictValue": {
    object (DictValue)
  },
  "qualifiedCurrencyValue": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": {
    object (AmountValue)
  }
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。實際值。value 只能是下列其中一個設定：
noneValue

enum (NoneValue)

選用。表示 None 值。
boolValue

boolean

選用。布林值。
int64Value

string (int64 format)

選用。int64 值。
stringValue

string

選用。字串值。
accountId

string

選用。帳戶 ID。
dictValue

object (DictValue)

選用。字典值。
qualifiedCurrencyValue

object (QualifiedCurrencyValue)

選用。有效貨幣值。
amountValue

object (AmountValue)

選用。金額值。

NoneValue

代表 None 值的單例列舉。

列舉
NONE_VALUE_UNSPECIFIED None 值。

DictValue

索引會將鍵對應至值。舉例來說，keys[0] 鍵會對應至 values[0]。

JSON 表示法 
{

  // Union field keys can be only one of the following:
  "boolKeys": {
    object (BoolList)
  },
  "stringKeys": {
    object (StringList)
  },
  "int64Keys": {
    object (Int64List)
  },
  "accountIdKeys": {
    object (AccountIdList)
  }
  // End of list of possible types for union field keys.

  // Union field values can be only one of the following:
  "boolValues": {
    object (BoolList)
  },
  "stringValues": {
    object (StringList)
  },
  "int64Values": {
    object (Int64List)
  },
  "dictValues": {
    object (DictList)
  }
  // End of list of possible types for union field values.
}
欄位
聯集欄位 keys。每個鍵只能是一種。keys 只能是下列其中一個設定：
boolKeys

object (BoolList)

選用。布林值鍵清單。
stringKeys

object (StringList)

選用。字串鍵清單。
int64Keys

object (Int64List)

選用。int64 鍵清單。
accountIdKeys

object (AccountIdList)

選用。帳戶 ID 金鑰清單。
聯集欄位 values。每個值只能是一種。values 只能是下列其中一個設定：
boolValues

object (BoolList)

選用。布林值清單。
stringValues

object (StringList)

選用。字串值清單。
int64Values

object (Int64List)

選用。int64 值的清單。
dictValues

object (DictList)

選用。值是巢狀字典清單。

BoolList

布林值清單。

JSON 表示法 
{
  "values": [
    boolean
  ]
}
欄位
values[]

boolean

選用。布林值。

StringList

字串清單。

JSON 表示法 
{
  "values": [
    string
  ]
}
欄位
values[]

string

選用。字串值。

Int64List

int64 清單。

JSON 表示法 
{
  "values": [
    string
  ]
}
欄位
values[]

string (int64 format)

選用。int64 值。

AccountIdList

帳戶 ID 清單。

JSON 表示法 
{
  "values": [
    string
  ]
}
欄位
values[]

string

選用。帳戶 ID 值。

DictList

字典清單。

JSON 表示法 
{
  "values": [
    {
      object (DictValue)
    }
  ]
}
欄位
values[]

object (DictValue)

選用。DictValue 值。所有巢狀字典都必須具有相同的具體型別。

QualifiedCurrencyValue

代表帳本中的貨幣，由貨幣運算子限定。

JSON 表示法 
{
  "operatorId": string
}
欄位
operatorId

string

這是必要旗標，管理貨幣的貨幣營運商 ID。

AmountValue

表示以某種貨幣計價的金額。

JSON 表示法 
{
  "currency": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": string
}
欄位
currency

object (QualifiedCurrencyValue)

這是必要旗標，金額的幣別。
amountValue

string (int64 format)

這是必要旗標，貨幣的次要單位數。

AccountManagerDetails

客戶經理專屬詳細資料。

JSON 表示法 
{
  "tokenManager": {
    object (Entity)
  },
  "numAccounts": integer,
  "tokenManagerId": string
}
欄位
tokenManager
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 tokenManagerId。這個帳戶管理員建立的帳戶預設權杖管理員。
numAccounts

integer

僅供輸出。這個帳戶管理員建立的帳戶數量。
tokenManagerId

string

僅供輸出。這個帳戶管理員所建立帳戶的預設權杖管理員 ID。

TokenManagerDetails

權杖管理工具的專屬詳細資料。

JSON 表示法 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
欄位
issuanceLimit

object (CurrencyValue)

僅供輸出。這個權杖管理工具可鑄造的權杖數量。
issuedTokens

object (CurrencyValue)

僅供輸出。這個權杖管理員鑄造的權杖數量。鑄造時會增加，銷毀時會減少。

ContractTokenManagerDetails

合約權杖管理工具的專屬詳細資料。

JSON 表示法 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  },
  "previousContractTokenManagerId": string,
  "accountStatus": enum (AccountStatus)
}
欄位
issuanceLimit

object (CurrencyValue)

僅供輸出。這個合約權杖管理員可提供的擔保權杖數量。

由於合約代幣管理員無法提高或降低發行上限，因此這應等於 issuedTokens。
issuedTokens

object (CurrencyValue)

僅供輸出。這份合約代幣管理工具提供的擔保代幣數量 (即總負債)。

這等於以該幣別計價的所有合約餘額總和，加上結算矩陣中的淨部位。
previousContractTokenManagerId

string

僅供輸出。此幣別先前合約權杖管理員的帳戶 ID。這會形成稽核追蹤記錄，可供您找出所有先前的管理員。如果這是該幣別的第一個合約代幣管理員，這個欄位會是空白。
accountStatus

enum (AccountStatus)

僅供輸出。這個帳戶的狀態。

ContractDetails

智慧合約專屬詳細資料。

JSON 表示法 
{
  "owner": {
    object (Entity)
  },
  "ownerId": string,
  "code": string,
  "contractFields": {
    object (Fields)
  },
  "currencyBalances": {
    string: {
      object (CurrencyValue)
    },
    ...
  }
}
欄位
owner
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 ownerId。合約擁有者。
ownerId

string

僅供輸出。合約擁有者的 ID。
code

string (bytes format)

僅供輸出。序列化合約代碼。

Base64 編碼字串。
contractFields

object (Fields)

僅供輸出。這份合約的合約欄位 (欄位名稱 -> 值)。
currencyBalances

map (key: string, value: object (CurrencyValue))

僅供輸出。合約持有的貨幣餘額 (貨幣運算子 -> 餘額)。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

ClearingHouseDetails

結算機構專屬詳細資料。

JSON 表示法 
{
  "accountStatus": enum (AccountStatus),
  "balances": [
    {
      object (BalanceToSettle)
    }
  ],
  "settlementMode": enum (SettlementMode)
}
欄位
accountStatus

enum (AccountStatus)

僅供輸出。這個帳戶的狀態。
balances[]

object (BalanceToSettle)

僅供輸出。結算中心目前追蹤的結算餘額。
settlementMode

enum (SettlementMode)

僅供輸出。這個結算中心的結算模式。

BalanceToSettle

兩個權杖管理員之間待結算的餘額。

JSON 表示法 
{
  "balancePayer": {
    object (Entity)
  },
  "balancePayerId": string,
  "balanceReceiver": {
    object (Entity)
  },
  "balanceReceiverId": string,
  "balance": {
    object (CurrencyValue)
  }
}
欄位
balancePayer
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 balancePayerId。應結清餘額的帳戶。
balancePayerId

string

僅供輸出。應付結算餘額的帳戶 ID。
balanceReceiver
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 balanceReceiverId。應結清餘額的帳戶。
balanceReceiverId

string

僅供輸出。應結清餘額的帳戶 ID。
balance

object (CurrencyValue)

僅供輸出。要結算的餘額。必須為正數。

SettlementMode

結算所的結算模式。

列舉
SETTLEMENT_MODE_UNSPECIFIED 未指定結算模式。這個值無效，不應使用。
SETTLEMENT_MODE_DEFERRED 結算所負責追蹤帳外資金的擁有權，並定期發出 SettlementRequest 交易，確保帳本上的相應餘額保持同步。
SETTLEMENT_MODE_INSTANT 結算中心會維護單一資金池，而帳本則做為黃金來源，負責在權杖管理員之間分配這些資金。這種結算模式也可稱為「即時總額結算」。

CurrencyOperatorDetails

貨幣營運商專屬詳細資料。

JSON 表示法 
{
  "currency": string,
  "currencyCode": string,
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousCurrencyOperatorId": string,
  "platformOperatorEntityId": {
    object (Entity)
  },
  "platformOperatorId": string,
  "contractTokenManager": {
    object (Entity)
  },
  "contractTokenManagerId": string,
  "clearinghouseId": string
}
欄位
currency
(deprecated)

string

僅供輸出。已淘汰：請改用 currencyCode。與這個帳戶相關聯的貨幣，以 3 個字母表示的 ISO 4217 代碼。
currencyCode

string

僅供輸出。與這個帳戶相關聯的貨幣 ID，以 3 個字母的 ISO 4217 代碼表示。
accountStatus

enum (AccountStatus)

僅供輸出。這個帳戶的狀態。
previousEntityId
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 previousCurrencyOperatorId。先前將貨幣營運商角色擁有權轉移給這個帳戶的貨幣營運商。如果這是該幣別的第一個貨幣運算子，這個欄位會是空白。
previousCurrencyOperatorId

string

僅供輸出。先前貨幣營運商的 ID，該營運商已將貨幣營運商角色的擁有權轉移給這個帳戶。如果這是該幣別的第一個貨幣運算子，這個欄位會是空白。
platformOperatorEntityId
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 platformOperatorId。建立這個貨幣運算子的平台運算子。
platformOperatorId

string

僅供輸出。建立這個貨幣營運商的平台營運商 ID。
contractTokenManager
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 contractTokenManagerId。與這個幣別運算子相關聯的合約權杖管理員。
contractTokenManagerId

string

僅供輸出。與這個幣別運算子相關聯的合約權杖管理員 ID。
clearinghouseId

string

僅供輸出。與這個幣別營運商相關聯的結算中心 ID。

PlatformOperatorDetails

平台營運商專屬詳細資料。

JSON 表示法 
{
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousPlatformOperatorId": string
}
欄位
accountStatus

enum (AccountStatus)

僅供輸出。這個帳戶的狀態。
previousEntityId
(deprecated)

object (Entity)

僅供輸出。已淘汰：請改用 previousPlatformOperatorId。將平台營運商角色擁有權轉移給這個帳戶的前平台營運商。如果這是第一個平台運算子，這個欄位會是空白。
previousPlatformOperatorId

string

僅供輸出。先前平台營運者的 ID，該營運者已將平台營運者角色擁有權轉移給這個帳戶。如果這是第一個平台運算子，這個欄位會是空白。