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)

פלט בלבד. המזהה של סבב ההפעלה (דומה ל'גובה' הבלוק) שבו פרטי החשבון שסופקו מדויקים.
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

פלט בלבד. המזהה של מנהל החשבון של המשתמש הזה.
tokenManager
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-tokenManagerId. הכלי לניהול אסימונים של המשתמש הזה.
tokenManagerId

string

פלט בלבד. המזהה של מנהל האסימונים של המשתמש.
roles[]

enum (Role)

פלט בלבד. רשימת התפקידים שהוקצו לחשבון הזה.
accountStatus

enum (AccountStatus)

פלט בלבד. הסטטוס של החשבון הזה.
balance

object (CurrencyValue)

פלט בלבד. יתרת האסימונים בחשבון המשתמש הזה.
accountFields
(deprecated)

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

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-contractAccountFields. שדות חשבון החוזה (מזהה החוזה -> שדות) של המשתמש הזה.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contractAccountFields

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

פלט בלבד. שדות חשבון החוזה (מזהה החוזה -> שדות) של המשתמש הזה.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ישות

ישות ברשת Universal Ledger. כל החשבונות משויכים לישות. מזהה הישות, שנקרא גם מזהה החשבון, הוא ייחודי וקבוע ברשת.

ייצוג ב-JSON 
{
  "id": string
}
שדות
id

string

פלט בלבד. המזהה שהוקצה לישות. המספר הזה מוקצה על ידי הרשת כשיוצרים את החשבון.

תפקיד

קבוצת התפקידים הרגילה.

טיפוסים בני מנייה (enum)
ROLE_UNSPECIFIED תפקיד לא חוקי.
ROLE_PAYER התפקיד שמאפשר לחשבון ליזום עסקת תשלום.
ROLE_RECEIVER התפקיד שמאפשר לחשבון לקבל תשלומים.
ROLE_CONTRACT_CREATOR התפקיד שמאפשר לחשבון לפרוס חוזים.
ROLE_CONTRACT_PARTICIPANT התפקיד שמאפשר לחשבון ליצור אינטראקציה עם חוזים שנפרסו.

AccountStatus

הסטטוס של החשבון.

טיפוסים בני מנייה (enum)
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

זה שינוי אופציונלי. מזהה חשבון.
dictValue

object (DictValue)

זה שינוי אופציונלי. ערך במילון.
qualifiedCurrencyValue

object (QualifiedCurrencyValue)

זה שינוי אופציונלי. ערך מטבע תקין.
amountValue

object (AmountValue)

זה שינוי אופציונלי. ערך של סכום.

NoneValue

מספור יחיד שמייצג את הערך None.

טיפוסים בני מנייה (enum)
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)

זה שינוי אופציונלי. רשימה של מפתחות מזהי חשבונות.
שדה איחוד 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

רשימה של מספרי חשבונות.

ייצוג ב-JSON 
{
  "values": [
    string
  ]
}
שדות
values[]

string

זה שינוי אופציונלי. ערכי מזהה החשבון.

DictList

רשימה של מילונים.

ייצוג ב-JSON 
{
  "values": [
    {
      object (DictValue)
    }
  ]
}
שדות
values[]

object (DictValue)

זה שינוי אופציונלי. הערכים של DictValue. כל המילונים המקוננים צריכים להיות מאותו סוג קונקרטי.

QualifiedCurrencyValue

מייצג מטבע בספר החשבונות, שמוגדר על ידי מפעיל המטבע.

ייצוג ב-JSON 
{
  "operatorId": string
}
שדות
operatorId

string

חובה. מזהה האופרטור של המטבע שמנהל את המטבע.

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

פלט בלבד. המזהה של מנהל האסימונים שמוגדר כברירת מחדל בחשבונות שנוצרו על ידי מנהל החשבונות הזה.

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

פלט בלבד. מספר החשבון של מנהל אסימוני החוזה הקודם במטבע הזה. כך נוצר נתיב ביקורת שאפשר לעבור עליו כדי לגלות את כל חשבונות הניהול הקודמים. אם זהו מנהל האסימונים הראשון של החוזה עבור המטבע, השדה הזה יהיה ריק.
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

פלט בלבד. המזהה של הבעלים של החוזה.
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

פלט בלבד. מספר החשבון שחייב את היתרה שצריך להסדיר.
balanceReceiver
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-balanceReceiverId. החשבון שבו יש יתרה שצריך להסדיר.
balanceReceiverId

string

פלט בלבד. המזהה של החשבון שבו יש יתרה לתשלום.
balance

object (CurrencyValue)

פלט בלבד. היתרה להסדרה. הערך חייב להיות חיובי.

SettlementMode

מצב הסליקה של מרכז סליקה.

טיפוסים בני מנייה (enum)
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

פלט בלבד. המזהה של המטבע שמשויך לחשבון הזה, שמיוצג על ידי קוד בן 3 אותיות לפי תקן ISO 4217.
accountStatus

enum (AccountStatus)

פלט בלבד. הסטטוס של החשבון הזה.
previousEntityId
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-previousCurrencyOperatorId. המפעיל הקודם של המטבע שהעביר את הבעלות על התפקיד של מפעיל המטבע לחשבון הזה. אם זה האופרטור הראשון של המטבע, השדה הזה יהיה ריק.
previousCurrencyOperatorId

string

פלט בלבד. המזהה של המפעיל הקודם של המטבע שהעביר את הבעלות על תפקיד המפעיל של המטבע לחשבון הזה. אם זה האופרטור הראשון של המטבע, השדה הזה יהיה ריק.
platformOperatorEntityId
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-platformOperatorId. מפעיל הפלטפורמה שיצר את אופרטור המטבע הזה.
platformOperatorId

string

פלט בלבד. המזהה של מפעיל הפלטפורמה שיצר את מפעיל המטבע הזה.
contractTokenManager
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-contractTokenManagerId. מנהל אסימוני החוזה שמשויך למפעיל המטבע הזה.
contractTokenManagerId

string

פלט בלבד. המזהה של מנהל אסימוני החוזה שמשויך לאופרטור המטבע הזה.
clearinghouseId

string

פלט בלבד. המזהה של מרכז הסליקה שמשויך למפעיל המטבע הזה.

PlatformOperatorDetails

פרטים ספציפיים למפעיל פלטפורמה.

ייצוג ב-JSON 
{
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousPlatformOperatorId": string
}
שדות
accountStatus

enum (AccountStatus)

פלט בלבד. הסטטוס של החשבון הזה.
previousEntityId
(deprecated)

object (Entity)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-previousPlatformOperatorId. המפעיל הקודם של הפלטפורמה שהעביר את הבעלות על תפקיד המפעיל של הפלטפורמה לחשבון הזה. אם זה המפעיל הראשון של הפלטפורמה, השדה הזה יהיה ריק.
previousPlatformOperatorId

string

פלט בלבד. המזהה של מפעיל הפלטפורמה הקודם שהעביר את הבעלות על תפקיד מפעיל הפלטפורמה לחשבון הזה. אם זה המפעיל הראשון של הפלטפורמה, השדה הזה יהיה ריק.