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 とも呼ばれます)は、ネットワーク全体で一意であり、変更できません。

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。各キーは 1 種類のみにできます。keys は次のいずれかになります。
boolKeys

object (BoolList)

省略可。ブール値のキーのリスト。

stringKeys

object (StringList)

省略可。文字列キーのリスト。

int64Keys

object (Int64List)

省略可。int64 キーのリスト。

accountIdKeys

object (AccountIdList)

省略可。アカウント ID キーのリスト。

共用体フィールド values。各値は 1 種類のみにできます。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

Token Manager に固有の詳細。

JSON 表現
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
フィールド
issuanceLimit

object (CurrencyValue)

出力専用。このトークン マネージャーが作成できるトークンの量。

issuedTokens

object (CurrencyValue)

出力専用。このトークン マネージャーによって発行されたトークンの量。この数は、ミント時に増加し、バーン時に減少します。

ContractTokenManagerDetails

Contract Token Manager に固有の詳細。

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

2 つのトークン マネージャー間で決済する残高。

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。これが最初のプラットフォーム オペレーターの場合、これは空になります。