> ## Documentation Index
> Fetch the complete documentation index at: https://blackswan-23965643.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BlackSwan Roadmap: Current Features and Planned Releases

> See what's live in BlackSwan v1.0 and what's planned for v1.1 and v2.0 — mainnet support, webhook notifications, GraphQL API, and more.

BlackSwan is actively evolving. Version 1.0 ships a complete testnet credit infrastructure stack — REST API, JavaScript and Python SDKs, and smart contracts on Polygon Amoy and Ethereum Sepolia. The roadmap below outlines what's live today and what's coming in the next two major releases. Priorities may shift based on community feedback, so check back regularly or follow us on Twitter for the latest updates.

## v1.0 — Current

Everything listed here is live and available to use today on Polygon Amoy and Ethereum Sepolia.

<CardGroup cols={2}>
  <Card title="Credit Dashboard API" icon="gauge">
    Single-call endpoint returning trust ratio, tier, and APR for any wallet.
  </Card>

  <Card title="Reputation API" icon="star">
    Granular reputation data including on-chain score and behavioral signals.
  </Card>

  <Card title="APR Calculation" icon="percent">
    Real-time APR in basis points, derived from a wallet's credit tier.
  </Card>

  <Card title="Trust Tier Scoring" icon="ranking-star">
    Five-tier (A–E) credit classification mapped from the 0–10,000 trust ratio.
  </Card>

  <Card title="Loan History" icon="clock-rotate-left">
    Full on-chain loan history for any wallet, including repayment outcomes.
  </Card>

  <Card title="JavaScript SDK" icon="js">
    TypeScript-first SDK with React and Next.js integration support.
  </Card>

  <Card title="Python SDK" icon="python">
    Python 3.8+ SDK with FastAPI and Flask integration support.
  </Card>

  <Card title="Amoy + Sepolia Testnet" icon="flask">
    Deployed and verified contracts on Polygon Amoy and Ethereum Sepolia.
  </Card>
</CardGroup>

## v1.1 — Planned

v1.1 brings mainnet support and infrastructure improvements for production-grade applications.

* **Polygon mainnet** — Deploy and interact with BlackSwan contracts on Polygon PoS mainnet
* **Ethereum mainnet** — Mainnet deployment on Ethereum L1
* **Optimism and Arbitrum support** — Expand to leading Ethereum L2 networks
* **Webhook notifications** — Subscribe to on-chain events (repayments, defaults, new loans) via HTTP webhooks
* **Rate limit headers** — `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `Retry-After` headers on all REST responses

## v2.0 — Planned

v2.0 focuses on developer experience, scale, and cross-chain capabilities.

* **Production API keys** — Managed API keys with per-key rate limits and usage analytics
* **Advanced analytics** — Cohort analysis, portfolio-level credit metrics, and trend data
* **Bulk wallet queries** — Submit a list of wallet addresses and receive credit profiles in a single request
* **GraphQL API** — Flexible querying of credit data with field selection and nested resolves
* **Cross-chain reputation** — Unified trust ratio that aggregates behavior across all supported networks

<Note>
  Roadmap timelines are estimates and subject to change. Follow [@BlackSwanFi](https://twitter.com/BlackSwanFi) on Twitter for real-time announcements, release previews, and community updates.
</Note>