Skip to main content

Events

Events are emitted following the messages execution. These events allow external systems and applications to track notarisation activities and configuration changes.

// Emitted on Notarise Msg
message EventNotarise {
  // The id of the notary info
  uint64 id = 1;
  // The id of the notarised asset created
  string notarised_asset_id = 2;
  // The amount of adt burned as notarisation fee
  cosmos.base.v1beta1.Coin fee_burnt = 3;
}

// Emitted on notarised asset update
message EventUpdateNotarisedAsset {
  // The id of the notarised asset
  string notarised_asset_id = 1;
}

// Emitted on decentralised application registration of a notary info
message EventRegisterNotaryInfo {
  // The id of the notary info
  uint64 id = 1;
  // The address used to create this object and can be used to update it
  string notary_info_admin = 2
    [ (cosmos_proto.scalar) = "cosmos.AddressString" ];
  // The asset type id
  uint64 asset_type_id = 3;
}

// Emitted on notary info update
message EventUpdateNotaryInfo {
  // The id of the notary info
  uint64 id = 1;
}

// Emitted on notary info deletion
message EventDeleteNotaryInfo {
  // The id of the notary info
  uint64 id = 1;
}

// Emitted on notary info admin update
message EventUpdateNotaryInfoAdmin {
  // The id of the notary info
  uint64 id = 1;
  // The address used to create this object and can be used to update it
  string new_notary_info_admin = 2
    [ (cosmos_proto.scalar) = "cosmos.AddressString" ];
}

Event Details​

EventNotarise​

  • id: The NotaryInfoId used for notarisation
  • notarised_asset_id: The calculated asset identifier (SHA256 hash of asset data), used for tracking and referencing the notarised asset
  • fee_burnt: The amount of adt burned as the notarisation fee

EventUpdateNotarisedAsset​

  • notarised_asset_id: The id of the notarised asset that was updated

EventRegisterNotaryInfo​

  • id: The newly assigned NotaryInfoId
  • notary_info_admin: Admin address that can manage this NotaryInfo
  • asset_type_id: The type of assets this notary configuration handles

EventUpdateNotaryInfo​

  • id: The NotaryInfoId being updated

EventDeleteNotaryInfo​

  • id: The NotaryInfoId being removed

EventUpdateNotaryInfoAdmin​

  • id: The NotaryInfoId whose admin is being updated
  • new_notary_info_admin: The new admin address

VCV Integration Notes​

Events are only emitted after successful message execution. For messages that involve native x/vcv verification:

  • EventNotarise: Only emitted after VcvKeeper.VerifyVerifiablePresentation has successfully verified the supplied verifiable presentation against the NotaryInfo's x/vcv route, the asset has been stored, and the notarisation fee has been burned. If verification fails, no event is emitted and the transaction is rejected.

  • EventRegisterNotaryInfo: Emitted after the NotaryInfo is stored and its native x/vcv route has been provisioned via VcvKeeper.SetRoute.

This ensures that all emitted events represent successfully verified and stored state changes.