BlackSwan JavaScript SDK Examples and Integrations

The examples below show you how to integrate the BlackSwan JavaScript SDK into the most common application frameworks. Each example is self-contained — pick the one that matches your stack and adapt it to your use case.

React
Next.js
Node.js
Express.js

Render a borrower’s credit profile inside a React component. The component initializes the client outside the render cycle so it isn’t recreated on every re-render, then fetches the dashboard on mount whenever the wallet prop changes.

import { useState, useEffect } from "react";
import { BlackSwanClient } from "blackswan-sdk";

const client = new BlackSwanClient({
  network: "amoy",
  rpcUrl: process.env.NEXT_PUBLIC_RPC_URL
});

function CreditCard({ wallet }: { wallet: string }) {
  const [credit, setCredit] = useState<any>(null);

  useEffect(() => {
    client.getCreditDashboard(wallet).then(setCredit);
  }, [wallet]);

  if (!credit) return <p>Loading...</p>;

  return (
    <div>
      <p>Trust Ratio: {credit.trustRatio}</p>
      <p>Tier: {credit.trustTierScore}</p>
      <p>APR: {credit.currentApr / 1000}%</p>
    </div>
  );
}

Share a single BlackSwanClient instance across your Next.js application by exporting it from a library file, then call it from an App Router route handler to expose a credit API endpoint.

lib/blackswan.ts

import { BlackSwanClient } from "blackswan-sdk";

export const blackswan = new BlackSwanClient({
  network: "amoy",
  rpcUrl: process.env.NEXT_PUBLIC_RPC_URL!
});

app/api/credit/[wallet]/route.ts

import { NextRequest } from "next/server";
import { blackswan } from "@/lib/blackswan";

export async function GET(
  req: NextRequest,
  { params }: { params: { wallet: string } }
) {
  const credit = await blackswan.getCreditDashboard(params.wallet);
  return Response.json(credit);
}

Run a standalone Node.js script to fetch and log a wallet’s full credit dashboard. This is useful for scripts, cron jobs, or CLI tooling.

node.ts

import { BlackSwanClient } from "blackswan-sdk";

const client = new BlackSwanClient({
  network: "amoy",
  rpcUrl: "https://polygon-amoy.g.alchemy.com/v2/your-key"
});

async function main() {
  const wallet = "0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4";
  const dashboard = await client.getCreditDashboard(wallet);
  console.log(`Trust Ratio: ${dashboard.trustRatio}`);
  console.log(`Tier: ${dashboard.trustTierScore}`);
  console.log(`APR: ${dashboard.currentApr / 1000}%`);
}

main();

Expose a REST endpoint in an Express application that returns a wallet’s credit dashboard as JSON. The route handler uses a try/catch block so RPC errors return a structured error response rather than crashing the server.

import express from "express";
import { BlackSwanClient } from "blackswan-sdk";

const app = express();
const client = new BlackSwanClient({
  network: "amoy",
  rpcUrl: process.env.RPC_URL!
});

app.get("/credit/:wallet", async (req, res) => {
  try {
    const credit = await client.getCreditDashboard(req.params.wallet);
    res.json(credit);
  } catch (err: any) {
    res.status(500).json({ error: err.message });
  }
});

app.listen(3000);

Get Started

Core Concepts

JavaScript SDK

Python SDK

Tutorials

Protocol

Resources

BlackSwan JavaScript SDK Examples and Integrations