Issues

• [SPIKE] Investigate a unified Result<T, E> type across all SDK methods instead of the current mix of throwing and ok/data/error returns

  coredifficulty: spikehelp wantedpriority: mediumsdk
  trustflow-protocol/trustflow-sdk#810 · Filter by author meshackyaro opened on Oct 29, 2026
  2

• [ENHANCEMENT] Add a dedicated TrustFlowClient.healthCheck() method for monitoring/status-page use cases

  coredifficulty: easyenhancementgood first issuepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#809 · Filter by author meshackyaro opened on Oct 29, 2026
  2

• [BUG] schemas.ts Zod schema for EscrowParams allows an amount string containing leading/trailing whitespace, which then fails downstream BigInt parsing

  bugcoredifficulty: easygood first issuepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#808 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] events.ts event emitter's off() method doesn't actually remove a listener if it was registered via the once() helper and already fired

  bugcoredifficulty: easygood first issuepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#807 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] errors.ts error class hierarchy doesn't preserve the instanceof relationship after being caught across a Promise boundary bundled by some bundlers

  bugcoredifficulty: mediumpriority: mediumsdk
  trustflow-protocol/trustflow-sdk#806 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] TrustFlowClient.connect() doesn't reject if the configured contractId doesn't exist on the target network, resolving as if everything is fine

  bugcoredifficulty: mediumpriority: highsdk
  trustflow-protocol/trustflow-sdk#805 · Filter by author meshackyaro opened on Oct 29, 2026
  2

• [SPIKE] Investigate consolidating amount-handling utilities (xlmToStroops, stroopsToXlm, formatAmount, deepEqual-for-BigInt) into one well-tested 'money' module

  difficulty: spikehelp wantedpriority: mediumsdk
  trustflow-protocol/trustflow-sdk#804 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [ENHANCEMENT] Add a formatDuration() helper for converting a ledger-count duration into a human-readable estimate

  difficulty: easyenhancementgood first issuepriority: lowsdk
  trustflow-protocol/trustflow-sdk#803 · Filter by author meshackyaro opened on Oct 29, 2026
  2

• [BUG] assertValidPublicKey() utility accepts a valid-looking StrKey that actually decodes to a muxed account or contract address, when only a plain account address is expected

  bugdifficulty: mediumgood first issuepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#802 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] deepEqual() utility used internally for cache-comparison doesn't handle BigInt values, always reporting them as unequal

  bugdifficulty: mediumpriority: mediumsdk
  trustflow-protocol/trustflow-sdk#801 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] debounce() utility's cancel() method doesn't prevent an already-scheduled trailing call that was mid-flight when cancel() was invoked

  bugdifficulty: easydocumentationgood first issuepriority: lowsdk
  trustflow-protocol/trustflow-sdk#800 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] formatAmount() utility doesn't respect the caller's locale for decimal/thousands separators

  bugdifficulty: easygood first issuepriority: lowsdk
  trustflow-protocol/trustflow-sdk#799 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] retry() utility's exponential backoff calculation can produce a delay of 0ms on the first retry due to an off-by-one in the exponent

  bugdifficulty: easygood first issuepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#798 · Filter by author meshackyaro opened on Oct 29, 2026

• [SPIKE] Investigate adding mutation testing to catch undertested code paths the coverage percentage alone doesn't reveal

  difficulty: spikepriority: lowsdktesting
  trustflow-protocol/trustflow-sdk#797 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [ENHANCEMENT] Add a shared @trustflow/sdk/testing export with reusable mocks for consuming apps' own test suites

  difficulty: mediumenhancementpriority: mediumsdktesting
  trustflow-protocol/trustflow-sdk#796 · Filter by author meshackyaro opened on Oct 29, 2026

• [BUG] Test coverage reporting (via .size-limit.json-adjacent tooling) excludes the node subpath entirely, hiding its actual coverage level

  bugdifficulty: easygood first issuepriority: lowsdktesting
  trustflow-protocol/trustflow-sdk#795 · Filter by author meshackyaro opened on Oct 29, 2026
  1

• [BUG] CI's e2e test suite is flaky because it polls testnet ledger close with a fixed short timeout that's sometimes too short under real network conditions

  bugdifficulty: easygood first issuepriority: mediumsdktesting
  trustflow-protocol/trustflow-sdk#794 · Filter by author meshackyaro opened on Oct 29, 2026

• [BUG] Mock Soroban RPC server used in unit tests doesn't simulate realistic latency, masking race-condition bugs that only appear under real network timing

  bugdifficulty: mediumpriority: mediumsdktesting
  trustflow-protocol/trustflow-sdk#793 · Filter by author meshackyaro opened on Oct 29, 2026
  3

• [BUG] Shared test fixtures for escrow scenarios hardcode a specific testnet contract ID that's no longer deployed, breaking tests that don't mock the RPC

  bugdifficulty: easygood first issuepriority: mediumsdktesting
  trustflow-protocol/trustflow-sdk#792 · Filter by author meshackyaro opened on Oct 29, 2026

• [SPIKE] Investigate encrypting cached session/profile data at rest in browser storage

  difficulty: spikeinfrastructurepriority: lowsdk
  trustflow-protocol/trustflow-sdk#791 · Filter by author meshackyaro opened on Oct 29, 2026

• [ENHANCEMENT] Add a configurable storage adapter interface so integrators can plug in AsyncStorage for React Native

  difficulty: mediumenhancementhelp wantedinfrastructurepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#790 · Filter by author meshackyaro opened on Oct 29, 2026

• [BUG] Storage adapter interface doesn't expose a way to detect storage availability before use, so SSR environments throw at import time

  bugdifficulty: mediumgood first issueinfrastructurepriority: highsdk
  trustflow-protocol/trustflow-sdk#789 · Filter by author meshackyaro opened on Oct 29, 2026

• [BUG] IndexedDB-backed cache adapter doesn't version its schema, so an SDK upgrade that changes the stored shape can throw on read for existing users

  bugdifficulty: mediuminfrastructurepriority: mediumreliabilitysdk
  trustflow-protocol/trustflow-sdk#788 · Filter by author meshackyaro opened on Oct 29, 2026

• [BUG] LocalStorageAdapter doesn't handle QuotaExceededError, silently failing to persist session data instead of surfacing a usable error

  bugdifficulty: easygood first issueinfrastructurepriority: mediumsdk
  trustflow-protocol/trustflow-sdk#787 · Filter by author meshackyaro opened on Oct 29, 2026

• [SPIKE] Investigate standardizing all polling-based hooks on a single shared usePolling() primitive

  difficulty: spikehelp wantedpriority: mediumsdk
  trustflow-protocol/trustflow-sdk#786 · Filter by author meshackyaro opened on Oct 29, 2026
  1