Integrate

Walletless verification

Liveness-check tier for non-crypto users. The Pulse SDK generates a proof and submits via the IAM relayer. No wallet needed. The integrator optionally funds verifications via API key.

import { PulseSDK } from '@iam-protocol/pulse-sdk';
const pulse = new PulseSDK({
  cluster: 'devnet',
  relayerUrl: 'https://relayer.iam-protocol.org',
});
// User completes Pulse challenge on your site
const result = await pulse.verify();
if (result.success) {
  // result.commitment — the on-chain TBH hash
  grantAccess(result.commitment);
}

Wallet-connected verification

The primary verification flow. The user pays a small protocol fee (~0.005 SOL) and signs the transaction with their wallet. Your app reads the result on-chain for free.

import { PulseSDK } from '@iam-protocol/pulse-sdk';
import { useWallet, useConnection } from '@solana/wallet-adapter-react';
const pulse = new PulseSDK({ cluster: 'devnet' });
const { wallet } = useWallet();
const { connection } = useConnection();
// User completes challenge, signs tx with wallet
const result = await pulse.verify(
  touchElement, wallet.adapter, connection
);
if (result.success) {
  // result.txSignature — Solana transaction signature
  grantAccess(result.commitment);
}

Check if a wallet is human

Use this to verify if a wallet has a valid IAM attestation on-chain.

import { verifyIAMAttestation } from '@iam-protocol/pulse-sdk';
import { useConnection } from '@solana/wallet-adapter-react';
// Inside your component or API route
const { connection } = useConnection();
try {
  // attestation: { isHuman: boolean, trustScore: number, verifiedAt: number, mode: string, expired: boolean } | null
  const attestation = await verifyIAMAttestation(walletAddress, connection);
  if (!attestation || !attestation.isHuman || attestation.expired) {
    throw new Error("Access Denied: User is not verified.");
  }
  // Proceed securely
  grantAccess();
} catch (e) {
  console.error("IAM Verification failed:", e);
}

Gate access on Trust Score

Drop-in React component. Renders children only if the connected wallet meets your Trust Score threshold. Source and live preview at /gate-demo.

import { IAMGate } from "@/components/ui/iam-gate";
export function PremiumPage() {
  return (
    <IAMGate minTrustScore={100}>
      {/* Children render only when the connected wallet
          has an IAM Anchor with trust score >= 100 */}
      <h1>Welcome, verified human.</h1>
    </IAMGate>
  );
}