TypeScript SDK for the Mippo LaaS API

import { MippoLaas } from '@mippo/laas-sdk';

const mippo = new MippoLaas({
  apiKey: process.env.MIPPO_API_KEY,
  environment: 'sandbox', // 'production' | 'sandbox'
});

const client = await mippo.kyc.submit({
  cpf: '123.456.789-09',          // required
  biometricHash: 'sha256:abc',    // required
  personType: 'PF',               // 'PF' | 'PJ', default: 'PF'
  partnerKycToken: 'your_token',  // optional — Model 2 only
});

// Returns: KycToken
// client.token      → string
// client.status     → 'APPROVED' | 'PENDING' | 'REJECTED'
// client.riskTier   → 'STANDARD' | 'HIGH' | 'PEP'
// client.expiresAt  → Date

const status = await mippo.kyc.status('kyc_1719000000_abc123');
// Returns: KycStatusResponse

const tx = await mippo.transactions.initiate({
  kycToken: client.token,                  // required
  amountBrl: 500,                          // required, min 50
  asset: 'USDT',                           // 'USDT' | 'USDC'
  walletAddress: '0xYourWalletAddress',    // required, EIP-55
});

// Returns: TransactionInitiateResponse
// tx.transactionId              → string
// tx.status                     → 'PENDING_AUTH'
// tx.authChallenge.type         → 'MFA_TOTP' | 'LIVENESS'
// tx.authChallenge.livenessUrl  → string (LIVENESS path only)

const confirmed = await mippo.transactions.confirmMfa({
  transactionId: tx.transactionId,  // required
  totpCode: '482910',               // required
});

// Returns: TransactionConfirmMfaResponse
// confirmed.pixPayload  → string (Pix Copia e Cola)
// confirmed.pixExpiry   → Date

const status = await mippo.transactions.status('tx_1719000000_xyz');

// Returns: TransactionStatusResponse
// status.status      → 'PENDING_AUTH' | 'PENDING_PAYMENT' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
// status.txHash      → string | undefined (present when COMPLETED)
// status.completedAt → Date | undefined

import { MippoApiError } from '@mippo/laas-sdk';

try {
  const tx = await mippo.transactions.initiate({ ... });
} catch (err) {
  if (err instanceof MippoApiError) {
    console.error(err.code);     // 'KYC_TOKEN_EXPIRED'
    console.error(err.message);  // Human-readable
    console.error(err.status);   // HTTP status code
  }
}

import type {
  KycSubmitRequest,
  KycToken,
  KycStatusResponse,
  RiskTier,
  TransactionInitiateRequest,
  TransactionInitiateResponse,
  TransactionConfirmMfaResponse,
  TransactionStatusResponse,
  AuthChallenge,
} from '@mippo/laas-sdk';