SDKs

Introduction

Explore our SDKs for building crypto payment applications, on/off-ramp integrations, and more.

KillB SDKs simplify integration by providing type-safe, developer-friendly interfaces to the KillB API.

Available SDKs

JavaScript/TypeScript SDK

Official Node.js and TypeScript SDK for KillB APInpm: @killb/sdk

Python SDK

Official Python SDK for KillB API (Coming Soon)pip: killb-sdk

Go SDK

Official Go SDK for KillB API (Coming Soon)go: github.com/killb/killb-go

PHP SDK

Official PHP SDK for KillB API (Coming Soon)composer: killb/sdk

Why Use an SDK?

Type Safety

Full TypeScript support with autocomplete and type checking

// TypeScript knows the response structure
const user = await killb.users.create({
  type: 'PERSON',
  data: { /* autocomplete available */ }
});

Simplified Authentication

Automatic token management and refresh

const killb = new KillB({
  email: '[email protected]',
  password: 'your-password'
});
// Authentication handled automatically

Built-in Error Handling

Typed errors with helpful messages

try {
  await killb.ramps.create(rampData);
} catch (error) {
  if (error.code === 'RAMP.0001') {
    // Handle expired quotation
  }
}

Developer Experience

Async/await support
Promise-based API
Comprehensive documentation
Active maintenance
Community support

Quick Comparison

Feature	REST API	JavaScript SDK	Python SDK
Setup	Manual auth	Simple config	Simple config
Type Safety	❌	✅ TypeScript	✅ Type hints
Auth Management	Manual	Automatic	Automatic
Error Types	Generic	Typed	Typed
IDE Support	Limited	Excellent	Good
Learning Curve	Moderate	Easy	Easy

Getting Started

Choose Your SDK

Select the SDK for your programming language

Install

Install via package manager (npm, pip, etc.)

Initialize

Configure with your API credentials

Build

Start using SDK methods to interact with KillB

Popular Use Cases

On-Ramp
Off-Ramp
Webhooks

// Complete on-ramp flow with SDK
const killb = new KillB(config);

// 1. Create user
const user = await killb.users.create({
  type: 'PERSON',
  data: userData
});

// 2. Create wallet
const wallet = await killb.accounts.create({
  type: 'WALLET',
  userId: user.id,
  data: walletData
});

// 3. Get quote
const quote = await killb.quotations.create({
  fromCurrency: 'COP',
  toCurrency: 'USDC',
  amount: 100000,
  cashInMethod: 'PSE',
  cashOutMethod: 'POLYGON'
});

// 4. Create ramp
const ramp = await killb.ramps.create({
  quotationId: quote.id,
  userId: user.id,
  accountId: wallet.id
});

console.log('Payment URL:', ramp.paymentInfo[0].url);

// Complete off-ramp flow with SDK
const killb = new KillB(config);

// Get quote
const quote = await killb.quotations.create({
  fromCurrency: 'USDC',
  toCurrency: 'COP',
  amount: 100,
  cashInMethod: 'POLYGON',
  cashOutMethod: 'PSE'
});

// Create ramp to bank account
const ramp = await killb.ramps.create({
  quotationId: quote.id,
  userId: user.id,
  accountId: bankAccount.id
});

console.log('Send USDC to:', ramp.paymentInfo[0].address);

// SDK includes webhook helpers
import { verifyWebhookSignature } from '@killb/sdk';

app.post('/webhooks/killb', (req, res) => {
  const isValid = verifyWebhookSignature(
    req.body,
    req.headers['x-signature-sha256'],
    process.env.WEBHOOK_SECRET
  );
  
  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }
  
  // Process webhook
  handleEvent(req.body);
  res.status(200).send('OK');
});

SDK Features

Auto Retry

Automatic retry with exponential backoff

Token Refresh

Automatic token refresh before expiry

Request Logging

Built-in logging for debugging

Error Handling

Structured error responses

Type Definitions

Full TypeScript definitions

Webhook Helpers

Signature verification utilities

Community & Support

GitHub

View source code and contribute

NPM

View package details

Discord

Get help from the community

Next Steps

JavaScript SDK

Get started with the JavaScript/TypeScript SDK

REST API

Use the REST API directly

JavaScript/TypeScript

Other SDKs

​Introduction

​Available SDKs

JavaScript/TypeScript SDK

Python SDK

Go SDK

PHP SDK

​Why Use an SDK?

​Quick Comparison

​Getting Started

​Popular Use Cases

​SDK Features

Auto Retry

Token Refresh

Request Logging

Error Handling

Type Definitions

Webhook Helpers

​Community & Support

GitHub

NPM

Discord

​Next Steps

JavaScript SDK

REST API

Introduction

Available SDKs

Why Use an SDK?

Quick Comparison

Getting Started

Popular Use Cases

SDK Features

Community & Support

Next Steps