Node.js SDK

npm install @chainscreen/sdk

import { Client } from '@chainscreen/sdk'

const client = new Client({ apiKey: 'sk_live_...' })

const result = await client.screen('0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c', 'ethereum')
console.log(result.level)   // "CRITICAL"
console.log(result.score)   // 100

if (result.isHighRisk) {
  throw new Error(`High-risk address: ${result.level}`)
}

const { results, summary } = await client.screenBatch([
  { address: '0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c', chain: 'ethereum' },
  { address: '0x0000000000000000000000000000000000000000', chain: 'ethereum' },
])

console.log(summary.critical)  // 1
for (const r of results) {
  console.log(r.address, r.level)
}

import {
  AuthError, InvalidAddressError,
  QuotaExceededError, RateLimitError, ScreeningError,
} from '@chainscreen/sdk'

try {
  const result = await client.screen(address, chain)
} catch (err) {
  if (err instanceof InvalidAddressError) {
    console.error('Bad address:', err.message)
  } else if (err instanceof QuotaExceededError) {
    console.error('Monthly quota exhausted')
  } else if (err instanceof RateLimitError) {
    console.error(`Rate limited — retry after ${err.retryAfter}s`)
  } else if (err instanceof AuthError) {
    console.error('Invalid API key')
  } else if (err instanceof ScreeningError) {
    console.error(`API error (${err.statusCode}):`, err.message)
  }
}

import type { ScreeningResult, RiskLevel, BatchScreeningResult } from '@chainscreen/sdk'

function checkRisk(result: ScreeningResult): void {
  const level: RiskLevel = result.level  // fully typed
  if (level === 'CRITICAL' || level === 'HIGH') {
    // block the transaction
  }
}