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 hash of the input data
  string data_hash = 2;
  // The notarised asset identifier (typically calculated as SHA of asset data)
  string asset_id = 3;
}

// 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 notarised_asset_id = 3;
}

// Emitted on route updates
message EventUpdateNotaryInfo {
  // The id of the notary info
  uint64 id = 1;
  // Caller Tx ExtensionOption VP Route and additional request parameters in AnteHandler
  d.vcv.v1.RouteAndAdditionalReq caller_route_and_additional_req = 3;
  // Asset Route and additional request params
  d.vcv.v1.RouteAndAdditionalReq asset_route_and_additional_req = 4;
}

// 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
  • data_hash: Hash of the original input data
  • asset_id: The calculated asset identifier (SHA hash of asset data), used for tracking and referencing the notarised asset

EventRegisterNotaryInfo​

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

EventUpdateNotaryInfo​

  • id: The NotaryInfoId being updated
  • caller_route_and_additional_req: New or updated caller verification route (nil if not updated)
  • asset_route_and_additional_req: New or updated asset verification route (nil if not updated)

Note: Route updates are nil-safe - only routes that are explicitly provided (not nil) will be 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 VCV verification:

  • EventNotarise: Only emitted after both caller verification (via VCV AnteHandler) and asset verification (via VcvKeeper.VerifiablePresentationChecker) have succeeded. If either verification fails, no event is emitted and the transaction is rejected.

  • EventRegisterNotaryInfo and EventUpdateNotaryInfo: Only emitted after route validation via VcvKeeper.CheckAppOrRouteOnVerifier confirms that the specified routes exist on the verifier contracts.

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