Add GET /account/:id/trustlines with stellar.toml resolution

[Sulex45]

Description:
Add an endpoint that returns all trustlines for an account. For each asset, resolve the issuer's home_domain from their Stellar account and fetch their stellar.toml to return the asset's official name, description, and image.
Acceptance Criteria:

GET /account/:id/trustlines returns all non-native balances
For each asset, attempt to resolve issuer home_domain → fetch https://<home_domain>/.well-known/stellar.toml
Parse TOML and return name, description, image per asset if available
Gracefully handles issuers with no home_domain or unreachable TOML (toml: null)
Validates account ID
Tests cover both resolved and unresolved cases

[Oby38]

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

Please assign this issue to me. I have extensive experience with this stack, my local environment is ready, and I can deliver a clean, well-documented solution quickly.

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

[mayasimi]

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

i can resolve this

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

[sammycee769]

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

I’d like to work on this issue because it combines external data enrichment with core Stellar account data, which is exactly the kind of backend work that improves both usability and product value. Transforming raw trustlines into enriched asset metadata (name, description, image) makes the API significantly more useful for clients, but it also introduces real-world complexity around unreliable external sources and partial data availability.

I’ve worked on backend features that involve aggregating blockchain or external API data and enriching it with metadata from third-party sources. I’m comfortable handling cases where external resources (like TOML files or metadata endpoints) may be missing, malformed, or temporarily unavailable, and ensuring the system still returns a consistent and usable response. I’ve also implemented similar “best-effort enrichment” patterns where fallback values (like null) are returned gracefully instead of failing the entire request.

For this task, I would:

• Implement GET /account/:id/trustlines returning only non-native assets

• Resolve each asset issuer’s home_domain from their Stellar account

• Attempt to fetch https://<home_domain>/.well-known/stellar.toml

• Parse TOML safely and extract name, description, and image

• Ensure failures (missing domain, network errors, invalid TOML) return toml: null without breaking the response

• Validate the account ID before processing

• Write tests covering:

  • Successful TOML resolution
  • Missing home_domain
  • Unreachable or invalid TOML responses

I would also ensure the implementation is efficient (likely batching or parallel requests where safe) and keeps the endpoint response stable even when external metadata sources are unreliable.

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

[drips-wave]

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

🧑‍💻 @mayasimi: 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 🌊