feat(wallet): comprehensive asset management for Stellar/Soroban tokens (#108)

[mayokun-max]

Summary

Closes #108 — adds comprehensive asset management for Stellar/Soroban tokens to the wallet backend: trustlines, real-time balances, SEP-1 token metadata, spam filtering, liquidity pool tokens, a portfolio API, and transfer helpers.

What's included

Trustline management

• Create / update / delete trustlines via API (apps/backend/wallet/src/assets/trustlines.ts)
• Supports credit_alphanum4, credit_alphanum12, and Soroban contract tokens
• Exposes authorized, authorizedToMaintainLiabilities, clawbackEnabled flags

Asset balances & real-time updates

• Balance tracking in stroops with available / locked breakdowns (balances.ts)
• Real-time updates pushed over the existing websocket layer (websocket/server.ts, websocket/types.ts)
• Queue integration for reliable balance refresh (queue/txQueue.ts, transactions/index.ts)

Token metadata & discovery

• SEP-1 / stellar.toml metadata resolution (discovery.ts, metadata.ts) — name, symbol, decimals, logo, description, website
• Asset flags: authRequired, authRevocable, authImmutable

Spam filtering

• Configurable spam asset filter (spamFilter.ts, config.ts) with env-driven configuration (see .env.example)

Liquidity pool tokens & portfolio API

• liquidity_pool asset type support
• Portfolio endpoint (portfolio.ts) — native balance + per-asset balances, targeting < 200ms
• Shared types in packages/types/src/assets.ts

Transfer helpers

• Helpers for all asset types, including Soroban contract tokens (transfers.ts, submitter.ts)

Tests

• 8 new test files covering trustlines, balances, transfers, portfolio, spam filter, config, and utils (~1,069 lines of tests)
• Full wallet suite: 285 tests, 0 failures

Notes for reviewers

• pnpm install --frozen-lockfile previously failed because the feature commit added a smol-toml importer entry to pnpm-lock.yaml without declaring the package in apps/backend/wallet/package.json (it's unused in code — SEP-1 resolution uses StellarToml.Resolver from @stellar/stellar-sdk). This PR removes the orphaned specifier.
• Two pre-existing repo-wide issues exist on upstream main (not touched here): merge-conflict markers committed in packages/utils/src/index.ts and an unclosed block in apps/backend/payments/src/routes.ts. Both predate this branch.

Files

31 files changed, ~3,570 insertions: asset module under apps/backend/wallet/src/assets/, types in packages/types/, websocket + queue integration, docs in docs/assets-management.md.

[drips-wave]

@mayokun-max 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

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 885a0a91-7380-499b-95eb-ac0635dbcbc1

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}