TypeScript SDK

npm install @passentry/pow-cards-client

import { useWallet } from "@solana/wallet-adapter-react";
import {
  ClaimsApi,
  VerifySignatureAndCreatePassRequestWalletTypeEnum,
} from "@passentry/pow-cards-client";
import bs58 from "bs58";
import { useState } from "react";

export const useWalletSignIn = () => {
  const { publicKey, signMessage, wallet } = useWallet();
  const [isLoading, setIsLoading] = useState(false);
  const [error, setError] = useState<string | null>(null);
  const [isSuccess, setIsSuccess] = useState(false);
  const signIn = async () => {
    if (!publicKey || !signMessage) {
      throw new Error("Wallet not connected");
    }
    try {
      setIsLoading(true);
      setError(null);

      // 1. Initialize the Claims API client
      const claimsApi = new ClaimsApi();

      // 2. Get sign-in data from backend
      const initResponse = await claimsApi.initializeClaimProcess({
        publicKey: publicKey.toBase58(),
      });

      // 3. Request signature from wallet
      const encodedMessage = new TextEncoder().encode(initResponse.message);
      const signature = await signMessage(encodedMessage);
      
      // 4. Verify signature and create pass
      const verifyResponse = await claimsApi.verifySignatureAndCreatePass({
        verifySignatureAndCreatePassRequest: {
          message: initResponse.message,
          publicKey: publicKey.toBase58(),
          signature: bs58.encode(signature),
          walletType:
            (wallet?.adapter
              .name as VerifySignatureAndCreatePassRequestWalletTypeEnum) ||
            "Generic",
        },
      });
      setIsSuccess(true);
      return verifyResponse;
    } catch (err) {
      setError("Error with your request. Please try again.");
      throw err;
    } finally {
      setIsLoading(false);
    }
  };
  return { signIn, isLoading, error, isSuccess };
};

import { useWallet } from "@solana/wallet-adapter-react";
import { WalletMultiButton } from "@solana/wallet-adapter-react-ui";
import { useWalletSignIn } from "../hooks/useWalletSignIn";
function WalletSignIn() {
  const { connected } = useWallet();
  const { signIn, isLoading, error, isSuccess } = useWalletSignIn();
  const handleSignIn = async () => {
    try {
      const response = await signIn();
      // Redirect to pass download page
      window.location.href = response.downloadUrl;
    } catch (err) {
      console.error("Sign-in failed:", err);
    }
  };
  return (
    <div>
      {!connected ? (
        <WalletMultiButton />
      ) : (
        <button onClick={handleSignIn} disabled={isLoading}>
          {isLoading ? "Creating Pass..." : "Create POW Card"}
        </button>
      )}
      {error && <div className="error">{error}</div>}
      {isSuccess && (
        <div className="success">POW Card created successfully!</div>
      )}
    </div>
  );
}

async initializeClaimProcess(request: { publicKey: string }): Promise<InitializeClaimProcess200Response>

async verifySignatureAndCreatePass(request: {
verifySignatureAndCreatePassRequest: {
message: string;
signature: string;
publicKey: string;
walletType?: VerifySignatureAndCreatePassRequestWalletTypeEnum;
}
}): Promise<VerifySignatureAndCreatePass200Response>

try {
  await claimsApi.verifySignatureAndCreatePass(/ ... /);
} catch (error) {
  if (error instanceof ApiErrorResponse) {
    console.error(error.details || error.error);
  }
}