Define Distributions GraphQL schema

[pragmaticAweds]

Repository

This issue belongs in Fundable-Protocol/Backend under indexer/.

Migrated from https://github.com/Fundable-Protocol/stellar_indexer/issues/18.

Context

The distributions GraphQL schema should describe the public API shape before Apollo resolvers are implemented.

Scope

• Expand indexer/distributions/schema.graphql
• Add types for distribution batches and claims
• Add query input shapes needed for filters/pagination
• Keep schema aligned with the database model

Out of Scope

• Unrelated package work
• Docker, CI, or deployment work unless named in scope
• Broad refactors outside the touched package

Acceptance Criteria

• Scope items are complete
• Relevant tests are added or updated
• Documentation is updated when needed
• bun run type-check passes
• bun run test passes
• bun run lint passes
• bun run indexer:type-check passes
• bun run indexer:test passes
• bun run indexer:lint passes

Dependencies

• Define Distributions database schema #36

Suggested Files or Packages

• indexer/distributions/schema.graphql

[playmaker410]

@playmaker410 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello Maintainer,
I’d love to take this on. I have hands-on experience with Rust, Soroban, Cairo, and TypeScript, and I’m confident I can deliver a solid solution within 24 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @playmaker410 to this issue.

[modrispath]

@modrispath has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

On it.

I'll expand indexer/distributions/schema.graphql with types for DistributionBatch and Claim, keeping field names and types aligned with the database model from #36. Query input types will cover filtering and pagination for listing batches by contract/status and claims by recipient or batch.

Changes stay strictly within the schema file. All bun run checks pass before the PR opens, ready to start once #36 is merged.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @modrispath to this issue.

[Danielodingz]

@Danielodingz has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hey maintainer, Please i would like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Danielodingz to this issue.

[oscarj007]

@oscarj007 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

permit me to work on this issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @oscarj007 to this issue.

[Skinny001]

@Skinny001 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi, I'd like to work on this issue.

I will expand the distributions GraphQL schema by adding types for distribution batches and claims, define the required query inputs for filtering and pagination, and ensure the schema stays aligned with the database model. I'll also update the relevant tests and documentation to keep everything consistent.

Could this issue be assigned to me? Thanks.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Skinny001 to this issue.

[drips-wave]

Congratulations, @modrispath! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @modrispath: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊