Saltar al contenido principal

Visión General

El SDK JavaScript de KillB proporciona una interfaz segura por tipo y fácil de usar para integrar la API de on/off-ramp cripto de KillB en tus aplicaciones Node.js o TypeScript.

Instalación

npm install @killb/sdk

Inicio Rápido

Inicializar el SDK

import { KillB } from '@killb/sdk';

const killb = new KillB({
  email: process.env.KILLB_EMAIL,
  password: process.env.KILLB_PASSWORD,
  environment: 'sandbox' // o 'production'
});

// SDK maneja autenticación automáticamente
await killb.initialize();

Características Principales

Gestión de Usuarios

// Crear usuario
const user = await killb.users.create({
  type: 'PERSON',
  externalId: 'user-12345',
  data: {
    firstName: 'Juan',
    lastName: 'García',
    email: '[email protected]',
    phone: '+573001234567',
    dateOfBirth: '1990-01-01',
    address: {
      street1: 'Calle 123',
      city: 'Bogotá',
      state: 'Cundinamarca',
      zipCode: '110111',
      countryCode: 'CO'
    },
    document: {
      type: 'NUIP',
      number: '1234567890',
      issuedCountryCode: 'CO'
    }
  }
});

console.log('Usuario creado:', user.id);
console.log('Nivel KYC:', user.accessLevel);

Gestión de Cuentas

// Crear cuenta de billetera
const wallet = await killb.accounts.create({
  type: 'WALLET',
  userId: user.id,
  externalId: 'wallet-polygon-usdc',
  data: {
    firstName: 'Juan',
    lastName: 'García',
    email: '[email protected]',
    phone: '+573001234567',
    currency: 'USDC',
    network: 'POLYGON',
    address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
    countryCode: 'CO',
    document: {
      type: 'NUIP',
      number: '1234567890',
      issuedCountryCode: 'CO'
    }
  }
});

console.log('Billetera creada:', wallet.id);

Cotizaciones

// Crear cotización
const quote = await killb.quotations.create({
  fromCurrency: 'COP',
  toCurrency: 'USDC',
  amount: 100000,
  amountIsToCurrency: false,
  cashInMethod: 'PSE',
  cashOutMethod: 'POLYGON'
});

console.log('Tasa:', quote.rate);
console.log('Recibirás:', quote.toAmount, 'USDC');
console.log('Expira en:', new Date(quote.expiresAt));

Ramps

// Crear on-ramp
const ramp = await killb.ramps.create({
  quotationId: quote.id,
  userId: user.id,
  accountId: wallet.id,
  externalId: 'onramp-123'
});

console.log('ID del Ramp:', ramp.id);
console.log('Estado:', ramp.status);
console.log('URL de Pago:', ramp.paymentInfo[0].url);

Soporte de TypeScript

Definiciones completas de TypeScript incluidas:
import type {
  User,
  CreateUserRequest,
  Account,
  CreateAccountRequest,
  Ramp,
  CreateRampRequest,
  Quotation,
  WebhookEvent
} from '@killb/sdk';

// Operaciones seguras por tipo
const createUser = async (data: CreateUserRequest): Promise<User> => {
  return await killb.users.create(data);
};

Próximos Pasos