Account

Representa el estado de una cuenta en el libro mayor.

Representación JSON
{
  "sequenceNumber": string,
  "publicKey": string,
  "roundId": string,
  "comment": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
Campos
sequenceNumber

string (int64 format)

Solo salida. Es el número de secuencia de esta cuenta. Este número se incrementa con cada transacción que envía esta cuenta.

publicKey

string (bytes format)

Solo salida. Es la clave pública principal asociada con esta cuenta, que se usa para verificar la firma.

Es una cadena codificada en Base64.

roundId

string (int64 format)

Solo salida. Es el ID de la ronda de ejecución (similar a la "altura" del bloque) en la que la información de la cuenta proporcionada es precisa.

comment

string

Solo salida. Es el comentario de la cuenta que se almacenó cuando se creó.

Detalles específicos según el tipo de cuenta La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
userDetails

object (UserDetails)

Solo salida. Son los detalles de una cuenta de usuario estándar.

accountManagerDetails

object (AccountManagerDetails)

Solo salida. Son los detalles de una cuenta de administrador de cuentas.

tokenManagerDetails

object (TokenManagerDetails)

Solo salida. Son los detalles de una cuenta de administrador de tokens.

contractTokenManagerDetails

object (ContractTokenManagerDetails)

Solo salida. Son los detalles de una cuenta de administrador de tokens de contrato.

contractDetails

object (ContractDetails)

Solo salida. Son los detalles de una cuenta de contrato inteligente.

clearinghouseDetails

object (ClearingHouseDetails)

Solo salida. Son los detalles de una cuenta de cámara de compensación.

currencyOperatorDetails

object (CurrencyOperatorDetails)

Solo salida. Son los detalles de una cuenta de operador de moneda.

platformOperatorDetails

object (PlatformOperatorDetails)

Solo salida. Detalles de una cuenta de operador de plataforma

Fin de los campos mutuamente excluyentes.

UserDetails

Son detalles específicos de una cuenta de usuario.

Representación JSON
{
  "accountManagerId": string,
  "tokenManagerId": string,
  "roles": [
    enum (Role)
  ],
  "accountStatus": enum (AccountStatus),
  "balance": {
    object (CurrencyValue)
  },
  "contractAccountFields": {
    string: {
      object (Fields)
    },
    ...
  }
}
Campos
accountManagerId

string

Solo salida. Es el ID del administrador de cuentas de este usuario.

tokenManagerId

string

Solo salida. Es el ID del administrador de tokens de este usuario.

roles[]

enum (Role)

Solo salida. Es la lista de roles otorgados a esta cuenta.

accountStatus

enum (AccountStatus)

Solo salida. Es el estado de esta cuenta.

balance

object (CurrencyValue)

Solo salida. Es el saldo de tokens de esta cuenta de usuario.

contractAccountFields

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

Solo salida. Los campos de la cuenta de contrato (ID de contrato -> campos) para este usuario.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Rol

El conjunto habitual de roles.

Enums
ROLE_UNSPECIFIED El rol no es válido.
ROLE_PAYER Es el rol que permite que una cuenta inicie una transacción de pago.
ROLE_RECEIVER Es el rol que permite que una cuenta reciba pagos.
ROLE_CONTRACT_CREATOR Es el rol que permite que una cuenta implemente contratos.
ROLE_CONTRACT_PARTICIPANT Es el rol que permite que una cuenta interactúe con los contratos implementados.

AccountStatus

Es el estado de una cuenta.

Enums
ACCOUNT_STATUS_UNSPECIFIED El estado no es válido.
ACCOUNT_STATUS_ACTIVE Estado activo en el que la cuenta puede realizar las operaciones permitidas por sus roles.
ACCOUNT_STATUS_INACTIVE Estado inactivo en el que se prohíben todas las transacciones en la cuenta. El administrador de la cuenta aún puede enviar transacciones de administración de cuentas.

CurrencyValue

Representa un importe de moneda (es decir, dinero). Ten en cuenta que la moneda denominada no se incluye en este mensaje. La moneda correspondiente la decide la cuenta que envía la transacción. Cada cuenta tiene asociada una moneda única e inmutable.

Representación JSON
{
  "value": string
}
Campos
value

string (int64 format)

Obligatorio. Es la cantidad de unidades menores de la moneda.

Esta denominación válida más pequeña se denomina "unidades menores" y se especifica en la norma ISO 4217. Por ejemplo, para USD, el valor será la cantidad de centavos, y para GBP, será la cantidad de peniques. En el caso del yen japonés, que no tiene una unidad menor, será la cantidad de yenes.

Campos

Es un mapa de campos (nombre del campo -> valor) de un contrato que se usa para representar campos de contrato o de cuenta.

Representación JSON
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
Campos
fields

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

Solo salida. Es el mapa de nombres de campos con sus valores.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Valor

Es un valor concreto de algún tipo.

Representación JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "noneValue": enum (NoneValue),
  "boolValue": boolean,
  "int64Value": string,
  "stringValue": string,
  "dictValue": {
    object (DictValue)
  },
  "contractValue": {
    object (ContractValue)
  },
  "listValue": {
    object (ListValue)
  },
  "qualifiedCurrencyValue": {
    object (QualifiedCurrencyValue)
  },
  "accountValue": {
    object (AccountValue)
  },
  "amountValue": {
    object (AmountValue)
  }
  // End of mutually exclusive fields.
}
Campos
Es el valor real. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
noneValue

enum (NoneValue)

Es opcional. Representa un valor None.

boolValue

boolean

Es opcional. Un valor booleano

int64Value

string (int64 format)

Es opcional. Es un valor int64.

stringValue

string

Es opcional. Un valor de cadena.

dictValue

object (DictValue)

Es opcional. Un valor de diccionario.

contractValue

object (ContractValue)

Es opcional. Una referencia de contrato

listValue

object (ListValue)

Es opcional. Un valor de lista.

qualifiedCurrencyValue

object (QualifiedCurrencyValue)

Es opcional. Un valor de moneda calificado.

accountValue

object (AccountValue)

Es opcional. Es un valor de la cuenta.

amountValue

object (AmountValue)

Es opcional. Es un valor de importe.

Fin de los campos mutuamente excluyentes.

NoneValue

Es una enumeración de singleton para representar el valor None.

Enums
NONE_VALUE_UNSPECIFIED El valor None.

DictValue

Los índices asignan la clave al valor. Por ejemplo, la clave keys[0] se asigna a values[0].

Representación JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "boolKeys": {
    object (BoolList)
  },
  "stringKeys": {
    object (StringList)
  },
  "int64Keys": {
    object (Int64List)
  },
  "genericKeys": {
    object (RepeatedValue)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "boolValues": {
    object (BoolList)
  },
  "stringValues": {
    object (StringList)
  },
  "int64Values": {
    object (Int64List)
  },
  "genericValues": {
    object (RepeatedValue)
  }
  // End of mutually exclusive fields.
}
Campos
Cada clave puede ser de un solo tipo. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
boolKeys

object (BoolList)

Es opcional. Es una lista de claves booleanas.

stringKeys

object (StringList)

Es opcional. Es una lista de claves de cadena.

int64Keys

object (Int64List)

Es opcional. Es una lista de claves int64.

genericKeys

object (RepeatedValue)

Es opcional. Es una lista genérica de claves.

Fin de los campos mutuamente excluyentes.
Cada valor puede ser exactamente de un tipo. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
boolValues

object (BoolList)

Es opcional. Es una lista de valores booleanos.

stringValues

object (StringList)

Es opcional. Es una lista de valores de cadena.

int64Values

object (Int64List)

Es opcional. Es una lista de valores int64.

genericValues

object (RepeatedValue)

Es opcional. Una lista genérica de valores como valores.

Fin de los campos mutuamente excluyentes.

BoolList

Es una lista de valores booleanos.

Representación JSON
{
  "values": [
    boolean
  ]
}
Campos
values[]

boolean

Es opcional. Los valores booleanos.

StringList

Es una lista de cadenas.

Representación JSON
{
  "values": [
    string
  ]
}
Campos
values[]

string

Es opcional. Son los valores de cadena.

Int64List

Es una lista de int64.

Representación JSON
{
  "values": [
    string
  ]
}
Campos
values[]

string (int64 format)

Es opcional. Los valores int64.

RepeatedValue

Es una lista genérica de valores.

Representación JSON
{
  "values": [
    {
      object (Value)
    }
  ]
}
Campos
values[]

object (Value)

Es opcional. Son los valores de la lista.

ContractValue

Representa una referencia de contrato.

Representación JSON
{
  "contractId": string
}
Campos
contractId

string

Obligatorio. Es el ID del contrato.

ListValue

Es una lista de valores.

Representación JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "boolValues": {
    object (BoolList)
  },
  "stringValues": {
    object (StringList)
  },
  "int64Values": {
    object (Int64List)
  },
  "genericValues": {
    object (RepeatedValue)
  }
  // End of mutually exclusive fields.
}
Campos
Cada valor puede ser exactamente de un tipo. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
boolValues

object (BoolList)

Es opcional. Es una lista de valores booleanos.

stringValues

object (StringList)

Es opcional. Es una lista de valores de cadena.

int64Values

object (Int64List)

Es opcional. Es una lista de valores int64.

genericValues

object (RepeatedValue)

Es opcional. Es una lista genérica de valores.

Fin de los campos mutuamente excluyentes.

QualifiedCurrencyValue

Representa una moneda en el libro mayor, que se califica por su operador de moneda.

Representación JSON
{
  "operatorId": string
}
Campos
operatorId

string

Obligatorio. Es el ID del operador de moneda que administra la moneda.

AccountValue

Es una referencia a una cuenta en el libro mayor.

El entorno de ejecución del libro mayor cambia esta referencia por un objeto gcul.Account completo. Para obtener más detalles, consulta la clase gcul.Account en la referencia del lenguaje de GCULpy.

Representación JSON
{
  "accountId": string
}
Campos
accountId

string

Obligatorio. Es el ID de la cuenta.

AmountValue

Representa un importe denominado en una moneda.

Representación JSON
{
  "currency": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": string
}
Campos
currency

object (QualifiedCurrencyValue)

Obligatorio. Es la moneda del importe.

amountValue

string (int64 format)

Obligatorio. Es la cantidad de unidades menores de la moneda.

AccountManagerDetails

Detalles específicos de un administrador de cuentas.

Representación JSON
{
  "numAccounts": integer,
  "tokenManagerId": string
}
Campos
numAccounts

integer

Solo salida. Es la cantidad de cuentas que creó este administrador de cuentas.

tokenManagerId

string

Solo salida. Es el ID del administrador de tokens predeterminado para las cuentas que crea este administrador de cuentas.

TokenManagerDetails

Detalles específicos de un administrador de tokens.

Representación JSON
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
Campos
issuanceLimit

object (CurrencyValue)

Solo salida. Es la cantidad de tokens que este administrador de tokens puede acuñar.

issuedTokens

object (CurrencyValue)

Solo salida. Es la cantidad de tokens que acuñó este administrador de tokens. Este número aumentará cuando se acuñen y disminuirá cuando se quemen.

ContractTokenManagerDetails

Son los detalles específicos de un administrador de tokens de contrato.

Representación JSON
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  },
  "previousContractTokenManagerId": string,
  "accountStatus": enum (AccountStatus)
}
Campos
issuanceLimit

object (CurrencyValue)

Solo salida. Es la cantidad de tokens para los que este administrador de tokens de contrato puede proporcionar respaldo.

Dado que los administradores de tokens de contrato no pueden aumentar ni disminuir su límite de emisión, este debe ser igual al issuedTokens.

issuedTokens

object (CurrencyValue)

Solo salida. Es la cantidad de tokens que respalda este administrador de tokens de contrato (es decir, su responsabilidad total).

Esto equivale a la suma de todos los saldos mantenidos en contratos para su moneda, más su posición neta en la matriz de liquidación.

previousContractTokenManagerId

string

Solo salida. Es el ID de cuenta del administrador de tokens de contrato anterior para esta moneda. Esto forma un registro de auditoría que se puede recorrer para descubrir todos los administradores anteriores. Si este es el primer administrador de tokens de contrato para la moneda, este campo estará vacío.

accountStatus

enum (AccountStatus)

Solo salida. Es el estado de esta cuenta.

ContractDetails

Detalles específicos de un contrato inteligente.

Representación JSON
{
  "ownerId": string,
  "code": string,
  "contractFields": {
    object (Fields)
  },
  "currencyBalances": {
    string: {
      object (CurrencyValue)
    },
    ...
  }
}
Campos
ownerId

string

Solo salida. Es el ID del propietario del contrato.

code

string (bytes format)

Solo salida. Es el código del contrato serializado.

Es una cadena codificada en Base64.

contractFields

object (Fields)

Solo salida. Son los campos del contrato (nombre del campo -> valor) para este contrato.

currencyBalances

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

Solo salida. Son los saldos de moneda que mantiene el contrato (operador de moneda -> saldo).

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ClearingHouseDetails

Detalles específicos de una cámara de compensación.

Representación JSON
{
  "accountStatus": enum (AccountStatus),
  "balances": [
    {
      object (BalanceToSettle)
    }
  ],
  "settlementMode": enum (SettlementMode)
}
Campos
accountStatus

enum (AccountStatus)

Solo salida. Es el estado de esta cuenta.

balances[]

object (BalanceToSettle)

Solo salida. Son los saldos de los que esta cámara de compensación realiza un seguimiento para la liquidación.

settlementMode

enum (SettlementMode)

Solo salida. Es el modo de liquidación de esta cámara de compensación.

BalanceToSettle

Un saldo que se debe liquidar entre dos administradores de tokens.

Representación JSON
{
  "balancePayerId": string,
  "balanceReceiverId": string,
  "balance": {
    object (CurrencyValue)
  }
}
Campos
balancePayerId

string

Solo salida. Es el ID de la cuenta que debe el saldo que se liquidará.

balanceReceiverId

string

Solo salida. Es el ID de la cuenta a la que se le debe el saldo que se liquidará.

balance

object (CurrencyValue)

Solo salida. Es el saldo que se debe liquidar. Debe ser positivo.

SettlementMode

Es el modo de liquidación de una cámara de compensación.

Enums
SETTLEMENT_MODE_UNSPECIFIED No se especificó el modo de liquidación. Este valor no es válido y no se debe usar.
SETTLEMENT_MODE_DEFERRED La cámara de compensación es responsable de hacer un seguimiento de la propiedad de los fondos fuera del libro mayor y de emitir transacciones de SettlementRequest de forma periódica para mantener sincronizados los saldos correspondientes en el libro mayor.
SETTLEMENT_MODE_INSTANT La cámara de compensación mantiene un fondo común único, y el libro mayor actúa como la fuente de referencia para la asignación de esos fondos entre los administradores de tokens. Este modo de liquidación también se puede describir como "liquidación bruta instantánea".

CurrencyOperatorDetails

Son los detalles específicos de un operador de moneda.

Representación JSON
{
  "currencyCode": string,
  "accountStatus": enum (AccountStatus),
  "previousCurrencyOperatorId": string,
  "platformOperatorId": string,
  "contractTokenManagerId": string,
  "clearinghouseId": string
}
Campos
currencyCode

string

Solo salida. Es el ID de la moneda asociada con esta cuenta, representado por el código ISO 4217 de 3 letras.

accountStatus

enum (AccountStatus)

Solo salida. Es el estado de esta cuenta.

previousCurrencyOperatorId

string

Solo salida. Es el ID del operador de moneda anterior que transfirió la propiedad del rol de operador de moneda a esta cuenta. Si este es el primer operador de moneda para la moneda, este campo estará vacío.

platformOperatorId

string

Solo salida. Es el ID del operador de la plataforma que creó este operador de moneda.

contractTokenManagerId

string

Solo salida. Es el ID del administrador de tokens de contrato asociado con este operador de moneda.

clearinghouseId

string

Solo salida. Es el ID de la cámara de compensación asociada con este operador de moneda.

PlatformOperatorDetails

Detalles específicos de un operador de plataforma.

Representación JSON
{
  "accountStatus": enum (AccountStatus),
  "previousPlatformOperatorId": string
}
Campos
accountStatus

enum (AccountStatus)

Solo salida. Es el estado de esta cuenta.

previousPlatformOperatorId

string

Solo salida. Es el ID del operador de plataforma anterior que transfirió la propiedad del rol de operador de plataforma a esta cuenta. Si este es el primer operador de plataforma, este campo estará vacío.