Add end-to-end contract-to-API test coverage

[Lakes41]

Summary

Add an end-to-end test path that proves a contract membership event can result in an API access decision.

Current Behaviour

Contract tests and backend code exist separately. There is no test that validates the integration boundary between MembershipNFT, contract ABI helpers, database state, the policy engine, and the access API.

Expected Behaviour

The repository should include at least one deterministic integration scenario that starts with contract-like membership data and ends with a successful or denied API access decision.

Suggested Implementation

Use Foundry tests for contract behaviour and TypeScript integration tests for decoded fixture events. Generate or maintain event fixtures from the Solidity contract, apply them to the database through the indexer or sync service, then call the Fastify route with app.inject().

Files or Areas Likely Affected

• contracts/test/MembershipNFT.t.sol
• packages/contracts/src/index.ts
• apps/access-api/src/workers/
• apps/access-api/src/**/*.test.ts
• apps/access-api/prisma/
• README.md

Acceptance Criteria

• Test fixtures are derived from or aligned with MembershipNFT events
• Event ingestion creates expected wallet and membership records
• API access checks reflect the ingested membership state
• Suspended or expired memberships produce deny decisions
• Tests can run locally without a live public chain

Additional Notes

This can depend on the on-chain event indexing issue, but should remain focused on regression coverage rather than worker implementation details.

[shadrach68]

I would like to work on this issue because I am a full-stack developer with 5+ years experience. I focus on identifying root causes and delivering clean, efficient, and maintainable solutions, with thorough testing to ensure reliable results.

[Hassanmovic98]

I'll write an end-to-end test that connects the contract layer to the API. I'll create Foundry tests for MembershipNFT events, generate TypeScript fixtures aligned with those events, ingest them through the indexer to populate database state, then call the Fastify API with app.inject() to verify access decisions. I'll test happy path (access granted), suspended memberships (access denied), and expired memberships (access denied). All fixtures derive from actual contract events, all tests run locally without a live chain. I can deliver this in 4–5 hours with tested, documented code.

[grantfox-oss]

🦊 GrantFox — @Hassanmovic98 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 #17)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.