GRPC API for node version 9.0

This release supports protocol version 9. In particular, it supports events, data and endpoints related to protocol-level tokens (PLTs) introduced in protocol version 9 and node version 9.0.7.

Changes

• Extend NextUpdateSequenceNumbers with sequence number for updates to protocol level tokens (field protocol_level_tokens).
• Extend ProtocolVersion enum with a protocol version 9 variant PROTOCOL_VERSION_9.
• Support for protocol level tokens.
  • Extend AccountInfo with tokens field for account state per token.
  • Extend enum TransactionType with value TOKEN_UPDATE representing a token update transaction.
  • Extend enum UpdateType with value UPDATE_CREATE_PLT representing chain updates creating protocol level tokens.
  • Extend effect oneof in AccountTransactionEffects with token_update_effect.
  • Add rpc endpoint GetTokenInfo for accessing state of each token for some block.
  • Add rpc endpoint GetTokenList to query list of existing protocol level tokens for some block.
  • Extend reason oneof in RejectReason with:
    • non_existent_token_id: the transaction referred to a protocol-level token that
      does not exist.
    • token_holder_transaction_failed: the token-holder transaction failed.
    • token_governance_transaction_failed: the token-governance transaction failed.
    • unauthorized_token_governance: Sender account is not authorized for governing the provided protocol level token.
  • Extend details oneof in BlockItemSummary with token_creation: this is the
    result of a chain-update that creates a protocol-level token.
• Rename the bakerId fields of ValidatorSuspended and ValidatorPrimedForSuspension to baker_id.

GRPC API for node version 8.0

This release supports protocol version 8. In particular, it supports events and data relating to validator suspension. It also adds new endpoints supported in version 8.0 of the Concordium node.

Changes

• Extend ProtocolVersion enum with a protocol version 8 variant PROTOCOL_VERSION_8.
• Support for changes related to validator suspension in protocol version 8:
  • Added BakerSuspended, BakerResumed message types and corresponding
    events to BakerEvent.
  • Added validator_suspended and validator_primed_for_suspension cases
    for BlockSpecialEvent.
  • Extended PoolCurrentPaydayInfo and PoolInfoResponse.
• Add GetConsensusDetailedStatus endpoint for querying detailed consensus
  status information.
• Add GetScheduledReleaseAccounts endpoint for querying the list of accounts that
  have scheduled releases.
• Add GetCooldownAccounts, GetPreCooldownAccounts and GetPrePreCooldownAccounts
  endpoints for querying the lists of accounts that have pending cooldowns in protocol
  version 7 onwards.
• Add parameter field to ContractInitializedEvent containing the parameter passed
  to the contract initializer.
• Add chain parameters v3 with the new ValidatorScoreParameters parameters.
• Add validator_score_parameters to NextUpdateSequenceNumbers.

GRPC API for node version 7.0

This release supports protocol version 7. In particular, the behavior of stake cooldown (resulting from reducing the stake of a baker or delegator) is different.

Changes

• Extend ProtocolVersion enum with a protocol version 7 variant PROTOCOL_VERSION_7.
• Support for changes to cooldown behavior in protocol version 7:
  • AccountInfo has a new repeated cooldowns field. Each Cooldown records
    the amount, (expected) release time and whether it's a regular cooldown,
    pre-cooldown or pre-pre-cooldown.
  • AccountInfo now includes available_balance. This is included since the
    method for calculating it has changed (it now must account for the
    cooldowns), so this is provided as a convenience.
  • PoolInfoResponse is revised to make the fields equity_capital,
    delegated_capital, delegated_capital_cap and pool_info optional. This
    is since in protocol 7 a validator can be unregistered, but still part of the
    current epoch validators.
  • BakerEvent now has an additional case delegation_removed, as configuring a baker can
    result in a delegator being removed (from protocol 7).
  • DelegationEvent now has an additional case baker_removed, as configuring a delegator
    can result in a baker being removed (from protocol 7).

GRPC API for node version 6.2

This release adds a new DryRun endpoint for simulating transaction execution, and removes the legacy V1 API.

Changes

• Add a new health service that conforms to the API expected
  by Google https://github.com/grpc/grpc-proto/blob/master/grpc/health/v1/health.proto
• Add DryRun endpoint.
• Remove UpdateInstructionSignature. It was not used in any endpoints.
• Remove V1 API.

GRPC API for node version 6.1

This release adds new endpoints and amends the response of GetPoolInfo response.

This is the API implemented by node version 6.1.7.

Changes

• Add GetBakersRewardPeriod endpoint.
• Add GetBlockCertificates endpoint.
• Add GetBakerEarliestWinTime endpoint.
• Add GetWinningBakersEpoch endpoint.
• Add GetFirstBlockEpoch endpoint.
• Add a CommissionRates field for PoolCurrentPaydayInfo.

GRPC API for node version 6.0

GRPC API for node version 6 and protocol version 6.

Changes

• Expand BlockHashInput to support querying by block height.
• Add protocol_version to the return of BlockInfo.
• Make slot_duration optional in ConsensusInfo.
• Add optional fields current_timeout_duration, current_round, current_epoch,
  and trigger_block_time to ConsensusInfo.
• Make slot_number optional in BlockInfo.
• Add optional fields round and epoch to BlockInfo.
• Make election_difficulty optional in ElectionInfo.

GRPC API for node version 5.0

Support for protocol version 5.