SDK Overview

import { ZKScoreSDK } from '@zkscore/sdk';

const sdk = new ZKScoreSDK({ apiKey: 'your-api-key' });

// Create identity
const identity = await sdk.identity.mint({
  address: '0x742d35...',
  username: 'alice',
});

// Get identity
const userIdentity = await sdk.identity.getIdentity('0x742d35...');

// Get overall score
const score = await sdk.scores.getScore('0x742d35...');

// Get detailed breakdown
const breakdown = await sdk.scores.getBreakdown('0x742d35...');

// Get score history
const history = await sdk.scores.getHistory('0x742d35...');

// List all achievements
const achievements = await sdk.achievements.listAchievements();

// Get user achievements
const userAchievements = await sdk.achievements.getUserAchievements('0x742d35...');

// Claim achievement
await sdk.achievements.claim({
  achievementId: 'defi-expert',
  proof: zkProof,
});

// Generate score proof
const proof = await sdk.zkProofs.generate({
  address: '0x742d35...',
  type: 'score-threshold',
  threshold: 700,
  hideExactScore: true,
});

// Verify proof
const isValid = await sdk.zkProofs.verify(proof);

// Create attestation
const attestation = await sdk.trustLayer.createAttestation({
  subject: '0x742d35...',
  schema: 'kyc-verification',
  data: { verified: true, level: 'tier-2' },
});

// Get attestations
const attestations = await sdk.trustLayer.getAttestations('0x742d35...');

import { useScore, useIdentity, useAchievements } from '@zkscore/react';

function UserProfile({ address }: { address: string }) {
  const { identity } = useIdentity(address);
  const { score } = useScore(address);
  const { achievements } = useAchievements(address);

  return (
    <div>
      <h1>{identity?.username || 'Anonymous'}</h1>
      <p>Score: {score?.overall}/1000</p>
      <p>Achievements: {achievements?.length || 0}</p>
    </div>
  );
}

import { ZKScoreSDK } from '@zkscore/sdk';

const sdk = new ZKScoreSDK({
  apiKey: process.env.ZKSCORE_API_KEY,
  network: 'mainnet',
});

// Get a user's score
const score = await sdk.scores.getScore('0x742d35...');
console.log(`Score: ${score.overall}/1000`);

import { ZKScoreSDK } from '@zkscore/sdk';
import type { Score, Identity, Achievement } from '@zkscore/types';

const sdk = new ZKScoreSDK({ apiKey: 'your-key' });

// Fully typed responses
const score: Score = await sdk.scores.getScore('0x742d35...');
const identity: Identity = await sdk.identity.getIdentity('0x742d35...');

try {
  const score = await sdk.scores.getScore(address);
} catch (error) {
  if (error.code === 'IDENTITY_NOT_FOUND') {
    console.log('User needs to create an identity first');
  } else if (error.code === 'RATE_LIMIT_EXCEEDED') {
    console.log('Too many requests, please wait');
  }
}

const sdk = new ZKScoreSDK({
  apiKey: 'your-key',
  cacheTime: 300000, // 5 minutes
  retryAttempts: 3,
});

// Automatic caching
const score1 = await sdk.scores.getScore(address); // API call
const score2 = await sdk.scores.getScore(address); // Cached

async function checkAccess(userAddress: string, minScore: number) {
  const score = await sdk.scores.getScore(userAddress);
  return score.overall >= minScore;
}

async function trackProgress(userAddress: string) {
  const achievements = await sdk.achievements.getUserAchievements(userAddress);
  const progress = await sdk.achievements.getProgress(userAddress, 'defi-expert');
  
  return { earned: achievements.length, progress };
}

async function verifyWithPrivacy(userAddress: string) {
  const proof = await sdk.zkProofs.generate({
    address: userAddress,
    type: 'score-threshold',
    threshold: 700,
    hideExactScore: true,
  });
  
  return sdk.zkProofs.verify(proof);
}

// v1 (deprecated)
const client = new ZKScoreClient(apiKey);
const score = await client.getScore(address);

// v2 (current)
const sdk = new ZKScoreSDK({ apiKey });
const score = await sdk.scores.getScore(address);