Default package

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc GetLastestHeight (GetLatestHeightRequest, GetLatestHeightResponse)

  blazar.proto:6

  message GetLatestHeightRequest

  blazar.proto:9

  (message has no fields)

  message GetLatestHeightResponse

  blazar.proto:11

  • int64 height = 1

  • string network = 2

• rpc AddUpgrade (AddUpgradeRequest, AddUpgradeResponse)

  upgrades_registry.proto:9

  register a new upgrade with blazar

  message AddUpgradeRequest

  upgrades_registry.proto:162

  • optional Upgrade upgrade = 1

    The new upgrade to be registered

  • bool overwrite = 2

    If set to true, the upgrade will be overwritten if it already exists

  message AddUpgradeResponse

  upgrades_registry.proto:170

  (message has no fields)

• rpc CancelUpgrade (CancelUpgradeRequest, CancelUpgradeResponse)

  upgrades_registry.proto:19

  cancel upgrade

  message CancelUpgradeRequest

  upgrades_registry.proto:186

  • int64 height = 1

  • ProviderType source = 2

  • bool force = 3

    if set to true, the upgrade is cancelled through the state machine, in this case 'source' is ignored

  message CancelUpgradeResponse

  upgrades_registry.proto:194

  (message has no fields)

• rpc ForceSync (ForceSyncRequest, ForceSyncResponse)

  upgrades_registry.proto:24

  force the registry to sync the upgrades from all registered providers

  message ForceSyncRequest

  upgrades_registry.proto:197

  ForceSyncRequest is used to force the registry to sync the upgrades from all registered providers

  (message has no fields)

  message ForceSyncResponse

  upgrades_registry.proto:199

  • int64 height = 1

    the height at which the registry is currently synced

• rpc ListUpgrades (ListUpgradesRequest, ListUpgradesResponse)

  upgrades_registry.proto:14

  list upgrades registered with blazar

  message ListUpgradesRequest

  upgrades_registry.proto:172

  • bool disable_cache = 1

  • optional int64 height = 2

  • optional UpgradeType type = 3

  • optional ProviderType source = 4

  • repeated UpgradeStatus status = 5

  • optional int64 limit = 6

  message ListUpgradesResponse

  upgrades_registry.proto:182

  • repeated Upgrade upgrades = 1

• rpc AddVersion (RegisterVersionRequest, RegisterVersionResponse)

  version_resolver.proto:11

  register a new version tag for a given height and network

  message RegisterVersionRequest

  version_resolver.proto:51

  • optional Version version = 1

  • bool overwrite = 2

  message RegisterVersionResponse

  version_resolver.proto:56

  (message has no fields)

• rpc GetVersion (GetVersionRequest, GetVersionResponse)

  version_resolver.proto:16

  retrieve the version tag for a given height and network

  message GetVersionRequest

  version_resolver.proto:58

  • bool disable_cache = 1

  • int64 height = 2

  message GetVersionResponse

  version_resolver.proto:63

  • optional Version version = 1

• rpc ListVersions (ListVersionsRequest, ListVersionsResponse)

  version_resolver.proto:21

  list all registered versions

  message ListVersionsRequest

  version_resolver.proto:67

  • bool disable_cache = 1

  • optional int64 height = 2

  • optional ProviderType source = 3

  message ListVersionsResponse

  version_resolver.proto:73

  • repeated Version versions = 1

• PENDING = 0

  Check is waiting to be executed

• RUNNING = 1

  Check is currently being executed

• FINISHED = 2

  Check execution has finished

• GRPC_RESPONSIVE = 0

  Check if the gRPC endpoint is reachable

• CHAIN_HEIGHT_INCREASED = 1

  Check if node reached the next block height

• FIRST_BLOCK_VOTED = 2

  Check if we signed the first block post upgrade

• PULL_DOCKER_IMAGE = 0

  Try to fetch the docker image before upgrade

• SET_HALT_HEIGHT = 1

  Set the node's halt-height before non-governance coordinated upgrades

Used in: CancelUpgradeRequest, ListUpgradesRequest, ListVersionsRequest, Upgrade, Version

• CHAIN = 0

  CHAIN means that the upgrade is coming from onchain governance

• LOCAL = 1

  LOCAL means that the upgrade is coming from blazar local storage

• DATABASE = 2

  DATABASE means that the upgrade is coming from the database (e.g PostgreSQL)

Used in: AddUpgradeRequest, ListUpgradesResponse, Upgrades

• int64 height = 1

  the height at which the upgrade is expected to happen @gotags: gorm:"primaryKey;not null"

• string tag = 2

  docker image tag @gotags: gorm:"type:text;not null"

• string network = 3

  cosmos network name (e.g. cosmoshub) or chain id (e.g. cosmoshub-4) @gotags: gorm:"primaryKey;type:text;not null"

• string name = 4

  the short title of the upgrade (e.g. "Coordinated upgrade to v0.42.4 announced on discord channel #announcements") @gotags: gorm:"type:text;not null"

• UpgradeType type = 5

  type of the upgrade (defines what checks and actions should be taken) @gotags: gorm:"not null"

• UpgradeStatus status = 6

  status of the upgrade (DONT set this field manually, it's managed by the registry) @gotags: gorm:"default:0;not null"

• UpgradeStep step = 7

  current execution step (DONT set this field manually, it's managed by the registry) @gotags: gorm:"default:0;not null"

• int32 priority = 8

  priority of the upgrade (highest priority wins) @gotags: gorm:"primaryKey;not null"

• ProviderType source = 9

  source of the upgrade @gotags: gorm:"not null"

• optional int64 proposal_id = 10

  propoal id associated with the upgrade

• uint64 created_at = 11

  created_at timestamp @gotags: gorm:"not null"

Used in: ListUpgradesRequest, Upgrade

• UNKNOWN = 0

  UNKNOWN is the default status of an upgrade. It means that the status

• SCHEDULED = 1

  SCHEDULED is the initial status of an upgrade. It means that the upgrade is registered with the registry but it's not active yet. An upgrade coming from the chain governance that is still being voted on, is marked as scheduled

• ACTIVE = 2

  ACTIVE means that the upgrade is acknowledged by network governance or a user and is ready to be executed.

• EXECUTING = 3

  EXECUTING means that the upgrade is currently being executed. The height is reached.

• COMPLETED = 4

  COMPLETED means that the upgrade has been successfully executed.

• FAILED = 5

  FAILED means that the upgrade has failed to execute.

• CANCELLED = 6

  CANCELLED means that the upgrade has been cancelled by a user or the network

• EXPIRED = 7

  EXPIRED means that the upgrade time has passed and blazar did not do anything about it (e.g historical upgrade from the chain governance)

Used in: Upgrade

• NONE = 0

  NONE is the default step of an upgrade. It means that the upgrade is not being executed

• MONITORING = 1

  MONITORING means that blazar sees the upcoming upgrade and is monitoring the chain for the upgrade height

• COMPOSE_FILE_UPGRADE = 2

  DOCKER_COMPOSE_FILE_UPGRADE indicates the blazar is executing the core part of the upgrade vua docker compose

• PRE_UPGRADE_CHECK = 3

  PRE_UPGRADE_CHECK indicates that the blazar is executing the pre-upgrade checks

• POST_UPGRADE_CHECK = 4

  POST_UPGRADE_CHECK indicates that the blazar is executing the post-upgrade checks

Used in: ListUpgradesRequest, Upgrade

• GOVERNANCE = 0

  GOVERNANCE is a coordinated upgrade that is initiated by the chain governance. The upgrade is expected to be coordinated across all validators at specific height. Requirements: * there is an onchain governance proposal that has passed

• NON_GOVERNANCE_COORDINATED = 1

  NON_GOVERNANCE_COORDINATED the upgrade is not coming from the chain, but rather is initiated by the operators. Requirements: * there should be no onchain governance proposal * the upgrade is expected to happen at the same height for all validators (usually it's a state breaking change)

• NON_GOVERNANCE_UNCOORDINATED = 2

  NON_GOVERNANCE_UNCOORDINATED the upgrade is not coming from the chain, but rather is initiated by the operators. Requirements: * there should be no onchain governance proposal * the upgrade is not expected to happen at any specific height. Validators are free to upgrade at their own pace. (usually non-state breaking changes)

This is the structure of <chain-home>/blazar/upgrades.json

• repeated Upgrade upgrades = 1

Used in: GetVersionResponse, ListVersionsResponse, RegisterVersionRequest

• int64 height = 1

  upgrade height the version tag is valid for @gotags: gorm:"primaryKey;not null"

• string network = 2

  chain network name @gotags: gorm:"primaryKey;type:text;not null"

• string tag = 3

  version tag

• ProviderType source = 4

  source of the upgrade @gotags: gorm:"not null"

• int32 priority = 5

  the version priority @gotags: gorm:"primaryKey;not null"

• uint64 created_at = 11

  created_at timestamp @gotags: gorm:"not null"