ChipIngress: Introduce per-event idempotency keys

[tarcisiozf]

This pull request adds support for an idempotency key as a CloudEvent extension attribute in the NewEvent function, allowing downstream consumers to deduplicate events.

Idempotency Key Support:

• Added the constant IdempotencyKeyAttr in types.go to define the CloudEvent extension attribute name for idempotency keys, with documentation explaining its usage and behavior in ChIP Ingress and Kafka headers.
• Updated NewEvent in client.go to set the idempotency key as a CloudEvent extension if provided and non-empty in the attributes map.

[github-actions]

✅ API Diff Results - github.com/smartcontractkit/chainlink-common/pkg/chipingress

✅ Compatible Changes (1)

./ (1)

• IdempotencyKeyAttr — ➕ Added

---

📄 View full apidiff report

[Copilot]

Pull request overview

Adds a per-event idempotency key as a CloudEvent extension attribute emitted by NewEvent, enabling downstream consumers (e.g., via Kafka header mappings) to deduplicate events.

Changes:

• Introduced IdempotencyKeyAttr constant defining the extension attribute name.
• Updated NewEvent to set idempotencykey as a CloudEvent extension when present and non-empty.
• Added unit tests validating extension presence/absence behavior for the idempotency key.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
pkg/chipingress/types.go	Adds the exported IdempotencyKeyAttr constant and associated documentation.
pkg/chipingress/client.go	Sets the idempotency key extension on newly created CloudEvents when provided.
pkg/chipingress/client_test.go	Adds coverage ensuring the idempotency key extension is set only when non-empty.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.