StellarID Docs

import { StellarID } from 'stellarid-sdk';

const stellarId = new StellarID({
  apiKey: 'your-developer-api-key',
  // Optional: Custom base URL (e.g. for local testing)
  // baseURL: 'http://localhost:5555/api/v1' 
});

async function checkUserReputation(walletAddress: string) {
  try {
    const profile = await stellarId.verifyWallet(walletAddress);
    
    console.log(`Score: ${profile.reputation_score}`);
    console.log(`Tier: ${profile.tier}`);
    console.log(`Is Verified: ${profile.verified}`);
    
    // List user credentials
    profile.credentials.forEach(cred => {
      console.log(`- ${cred.name} (${cred.status}) issued by ${cred.issuer_name}`);
    });
  } catch (error) {
    console.error('Verification failed:', error.message);
  }
}

checkUserReputation('GA2C7...55');

async function renderUserBadge(walletAddress: string) {
  const badge = await stellarId.getBadge({
    walletAddress,
    style: 'dark', // 'light' | 'dark'
    size: 'md',     // 'sm' | 'md' | 'lg'
  });

  console.log('Insert this HTML to display the badge:');
  console.log(badge.html);
  
  // Or get the direct URL to use as you wish:
  console.log('Iframe URL:', badge.iframe_url);
}

async function sendDeveloperCredential(recipientEmail: string, walletAddress?: string) {
  const result = await stellarId.issueCredential({
    recipientEmail,
    recipientWallet: walletAddress, // Optional
    credential: {
      name: 'github_developer',
      description: 'Verified GitHub Contributor',
      metadata: {
        repositoriesContributionCount: 15,
        languages: ['Rust', 'TypeScript']
      },
      expires_at: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000).toISOString() // 1 year
    }
  });

  console.log(`Credential Pending! Claim URL: ${result.claim_url}`);
}

import React, { useState, useEffect } from 'react';
import { StellarID, VerifyWalletResponse } from 'stellarid-sdk';

const stellarIdClient = new StellarID({ apiKey: process.env.NEXT_PUBLIC_STELLARID_KEY! });

export function UserReputationWidget({ walletAddress }: { walletAddress: string }) {
  const [data, setData] = useState<VerifyWalletResponse | null>(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    stellarIdClient.verifyWallet(walletAddress)
      .then(setData)
      .finally(() => setLoading(false));
  }, [walletAddress]);

  if (loading) return <div>Loading reputation...</div>;
  if (!data) return <div>Unverified User</div>;

  return (
    <div className="reputation-card">
      <h4>Reputation: {data.reputation_score}</h4>
      <span className="tier-tag">{data.tier}</span>
    </div>
  );
}

import { useStellarIDProfile, useVerifyCredential } from 'stellarid-react';

export function ProfileDashboard({ walletAddress }: { walletAddress: string }) {
  const { profile, loading, error, refetch } = useStellarIDProfile(walletAddress);
  
  if (loading) return <div>Fetching credentials from IPFS...</div>;
  if (error) return <div>Failed to verify: {error.message}</div>;

  return (
    <div className="p-6 bg-slate-900 rounded-2xl border border-slate-800">
      <h3 className="text-lg font-bold">Reputation: {profile?.reputation_score} ({profile?.tier})</h3>
      <p className="text-xs text-slate-400 mt-1">Stellar Address: {walletAddress}</p>
      
      <div className="mt-4 space-y-2">
        {profile?.credentials.map(cred => (
          <div key={cred.id} className="flex justify-between text-xs py-1 border-b border-slate-800">
            <span>{cred.name}</span>
            <span className="font-mono text-emerald-400">STATUS_MINTED</span>
          </div>
        ))}
      </div>
    </div>
  );
}

// tsup.config.ts
import { defineConfig } from 'tsup';

export default defineConfig({
  entry: ['src/index.ts'],
  format: ['cjs', 'esm'],
  dts: true,
  clean: true,
  minify: true,
  sourcemap: true,
  external: ['stellar-sdk', '@privy-io/react-auth'],
});