feat: Add GET /account/:id/trustlines endpoint with TOML resolution

[Babigdk]

Close #19

Add GET /account/:id/trustlines with TOML Resolution

Overview

This PR implements a new endpoint that returns all trustlines for a Stellar account with asset metadata resolved from the issuer's stellar.toml file.

Changes

New Features

1. New Endpoint: GET /account/:id/trustlines

   • Returns all trustlines (non-native asset balances) for a given account
   • For each trustline, resolves the issuer's account information
   • Automatically fetches and parses the issuer's stellar.toml file
   • Extracts asset metadata (name, description, image) from TOML
   • Gracefully handles missing or unreachable TOML files

2. New Utility: TOML Resolver (src/utils/tomlResolver.js)

   • fetchStellarToml(homeDomain): Fetches and parses TOML from a domain
   • getAssetMetadataFromToml(homeDomain, assetCode): Extracts asset metadata from TOML
   • Implements robust error handling with 5-second timeout
   • Returns null gracefully for network errors, timeouts, or malformed TOML

Modified Files

src/routes/account.js

• Added import for TOML resolver utility
• Implemented /:id/trustlines route with:
  • Account ID validation
  • Trustline fetching from Horizon
  • Parallel TOML resolution for all assets
  • Comprehensive error handling

src/index.js

• Updated API documentation to include the new endpoint

tests/api.test.js

• Added test suite for the trustlines endpoint
• Tests for invalid account ID validation
• Tests for graceful error handling

Acceptance Criteria ✅

• For each asset, resolves issuer home_domain and fetches stellar.toml
• Returns name, description, image from TOML if available
• Gracefully handles missing or unreachable TOML
• Tests added

API Usage

Request

[drips-wave]

@Babigdk Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[Sulex45]

Resolve src/routes/account.js and tests/api.test.js before i can merge

[Sulex45]

Resolve src/index.js, src/routes/account.js and tests/api.test.js

[Babigdk]

Resolved