Skip to main content
This changelog tracks notable additions, changes, and fixes across the BlackSwan REST API, JavaScript SDK, and Python SDK. Entries are listed in reverse chronological order. For a forward-looking view of what’s coming next, see the Roadmap.

​
v1.0.0

Initial release — BlackSwan v1.0.0 ships the full testnet credit infrastructure stack, including a REST API, two SDK clients, and verified smart contract deployments on Polygon Amoy and Ethereum Sepolia.

​
REST API

  • Launched with six endpoints covering the full credit data surface:
    • GET /credit — Credit dashboard: trust ratio, tier, and APR in a single call
    • GET /reputation — Granular reputation data and on-chain behavioral signals
    • GET /apr — APR in basis points for a given wallet address
    • GET /tier — Credit tier (A–E) for a given wallet address
    • GET /history — Full on-chain loan history including repayment outcomes
    • GET /health — API health check endpoint

​
JavaScript SDK

  • Released blackswan-sdk on npm with full TypeScript support
  • Typed response objects for all SDK methods — no manual ABI parsing required
  • First-class React and Next.js integration patterns
  • Named exports AMOY_CONTRACTS and SEPOLIA_CONTRACTS for direct contract access
  • Compatible with ethers.js and viem

​
Python SDK

  • Released blackswan-sdk-py on PyPI supporting Python 3.8+
  • Async-first design with asyncio support
  • Integration guides for FastAPI and Flask
  • Pydantic models for all response types

​
Network Support

  • Polygon Amoy testnet — P2PLending and BlackSwansSBT contracts verified
  • Ethereum Sepolia testnet — P2PLending and BlackSwansSBT contracts verified