Skip to content

Security: odarome132/trustlend-stellar

Security

SECURITY.md

Security Policy & Bug Bounty Program

TrustLend is dedicated to ensuring the security and safety of our decentralized lending protocol built on Stellar and Soroban. We welcome white-hat security researchers and developers to inspect our smart contracts, API endpoints, and infrastructure to help identify potential vulnerabilities.


1. Reporting a Vulnerability

If you discover a security vulnerability within TrustLend, do NOT open a public GitHub issue or publicly disclose the issue until it has been acknowledged, investigated, and remediated by the TrustLend team.

Secure Disclosure Instructions

  1. Email: Send your report securely to security@trustlend.io (or submit via GitHub Private Vulnerability Reporting).
  2. Details Required:
    • Summary: Concise explanation of the vulnerability and its potential impact.
    • Component: The specific smart contract, API endpoint, script, or component affected.
    • Reproduction Steps: Step-by-step instructions or executable Proof-of-Concept (PoC) code/test case.
    • Suggested Mitigation: Optional recommendations for remediation.
  3. Response SLA:
    • Initial Response: Within 48 hours acknowledging receipt of report.
    • Triage & Evaluation: Status update within 5 business days.
    • Remediation & Reward: Resolution and bounty payout upon patch deployment and confirmation.

2. Bug Bounty Program Scope

In-Scope Assets

A. Smart Contracts (contracts/)

  • Lending Pool Contract (contracts/lending): Core liquidity pool operations, deposits, borrowing, repayments, interest rate models, and flash loans.
  • Escrow / Collateral Contract (contracts/escrow): Lockup, withdrawal, collateral ratio management, and custody logic.
  • Borrower Reputation Contract (contracts/borrower_reputation): Credit score verification, reputation tiers, and rate assignment.
  • Default Management Contract (contracts/default_management): Liquidation triggers, grace period handling, keeper execution, and auction mechanisms.
  • Governance Contract (contracts/governance): Voting logic, proposal execution, timelocks, and token voting rules.
  • Multisig Admin Contract (contracts/multisig_admin): M-of-N threshold signature validation, admin actions, and key management.

B. Backend Services & APIs (app/api/ & proxy.ts)

  • Authentication & Authorization (app/api/auth/*, proxy.ts): Sign-In with Stellar (SIWS) authentication, session handling, and JWT validation.
  • Core Loan & Pool APIs (app/api/loans/*, app/api/pools/*): Loan request creation, repayment processing, pool analytics.
  • Gas & Sponsor Service (app/api/sponsor/*): Fee sponsorship, relayer protection, rate limits, and abuse prevention.
  • Reputation & Oracle System (app/api/reputation/*, scripts/oracle-post-credit-score.mjs): Credit score calculation, oracle posting logic, and data validation.
  • Automation Keepers & Cron (app/api/cron/*, app/api/tasks/*, scripts/liquidation-keeper.ts): Automated liquidations and background task runners.

Out-of-Scope Assets & Issues

  • Frontend/UI Bugs: Visual presentation flaws, CSS issues, or non-security UI bugs without impact on user funds or data.
  • Denial of Service (DoS): Volumetric DoS/DDoS attacks against infrastructure or public Stellar RPC endpoints not caused by application design flaws.
  • Social Engineering: Phishing, spam, or social engineering attacks targeted at TrustLend maintainers or users.
  • Third-Party Dependencies: Vulnerabilities in underlying infrastructure (e.g. Stellar Core, Soroban SDK, Supabase platform) unless directly exploitable through TrustLend code logic.
  • Known Issues: Vulnerabilities already reported, tracked in public issues/PRs, or previously disclosed in security audit reports.

3. Severity Classification & Reward Tiers

Bounties are rewarded in USDC or equivalent XLM based on severity assessment following standard CVSS v3.1 frameworks and threat modeling specific to DeFi protocols.

Severity Level Description & Examples Reward Tier (USDC / XLM)
Critical Direct theft/loss of user funds or escrowed collateral, unauthorized minting/draining of liquidity pool assets, flash loan exploits causing uncollateralized fund extraction, or full admin key / governance takeover. $5,000 – $15,000
High Permanent lockup/freeze of collateral without recovery mechanism, manipulation of oracle credit scores/price feeds leading to unauthorized borrowing/liquidation, or unauthorized manipulation of borrower reputation scores. $1,500 – $5,000
Medium Partial fee/interest loss, rate limiting / fee-sponsorship bypass draining sponsor reserve balance, or high-impact API authentication / session bypass without direct access to vault collateral. $500 – $1,500
Low Minor API information disclosure, telemetry data leakage, non-critical state inconsistencies, or isolated contract panic / DoS conditions on non-essential functions. $100 – $500

4. Rules of Engagement & Safe Harbor

Researcher Guidelines

  • Make good-faith efforts to avoid privacy violations, destruction of data, and interruption or degradation of services.
  • Do not exploit a vulnerability beyond what is necessary to prove the existence of the vulnerability (use testnet/mock environments for PoC).
  • Do not access user data or private keys that do not belong to you.

Safe Harbor Protection

TrustLend considers security research conducted in accordance with this policy to be:

  • Authorized under applicable anti-hacking laws, and we will not initiate legal action against researchers for good-faith security research.
  • Exempt from restrictions in our Terms of Service that prohibit reverse engineering or probing.
  • Supported and valued as a essential contribution to protocol security.

5. Supported Versions

Version Supported
0.1.x

There aren't any published security advisories