Skip to content

Add stable event type IDs and cross-chain compatibility metadata #38

Description

@grantfox-oss

Contract event names and schemas can change across versions without a stable identifier, which weakens cross-chain compatibility and schema migration for backends and analytics.

Affected areas: app/contract/contracts/Folder/src/events.rs, app/contract/contracts/Folder/src/lib.rs, app/contract/contracts/Folder/src/metadata.rs, backend parser docs.

Implementation scope:

  • Assign stable numeric or semantic event type IDs to every emitted event.
  • Embed compatibility metadata in event payloads or schema definitions.
  • Document event type stability guarantees and versioning rules.
  • Update backend parser to use the stable IDs for compatibility checks.

Acceptance criteria:

  • Every contract event is associated with a stable identifier across releases.
  • Backend schema validation uses IDs and not only event names.
  • Documentation explains how event compatibility is maintained.

Metadata

Metadata

Assignees

Labels

GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial CampaignCampaign: Official CampaigndocumentationImprovements or additions to documentationenhancementNew feature or request

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions