Add webhook ingestion endpoints for dashboard activity

[Lakes41]

Summary

Add secure webhook ingestion routes that can receive membership, pass, guild, and verification events and turn them into dashboard activity records.

Current Behaviour

The dashboard activity feed is static mock data, and the optional webhook utilities are not wired into dashboard route handlers.

Expected Behaviour

The dashboard should have server-side webhook endpoints that verify signatures, parse supported event types, and record or expose resulting activity events.

Suggested Implementation

Create Next.js route handlers under app/api/webhooks/. Use packages/webhook-utils for signature verification. Define an event mapping layer from webhook payloads to the dashboard ActivityEvent model.

Files or Areas Likely Affected

• apps/dashboard/app/api/webhooks/
• apps/dashboard/lib/activity/
• apps/dashboard/lib/env.ts
• packages/webhook-utils/src/
• apps/dashboard/app/activity/page.tsx
• README.md

Acceptance Criteria

• Webhook routes verify signatures before processing payloads
• Unsupported event types return a safe response without crashing
• Valid events are mapped into typed dashboard activity records
• Replayed or duplicate webhook events are handled idempotently
• Tests cover valid, invalid, duplicate, and malformed webhook payloads
• Documentation explains how to configure webhook secrets

Additional Notes

Assumption: durable persistence may not exist yet. If so, use an interface that can support in-memory mock storage now and database storage later.

[Davidemulo]

i will love to work on this issue

[GazzyLee]

hey boss, I’d be happy to take this on. I can build a reliable webhook ingestion flow that integrates cleanly with dashboard activity tracking, while keeping the implementation secure, maintainable, and well-tested for future growth. please assign, thank you.

[jaynomyaro]

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

[shamsss04]

Hi maintainers,

I would like to work on this issue. I have reviewed the description and believe I can contribute a solution.

If the issue is not already assigned, I would appreciate being assigned to it. Please let me know if there are any specific requirements, implementation details, or considerations I should be aware of before I begin.

Thank you!

[grantfox-oss]

🦊 GrantFox — @shamsss04 has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #31)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.