探索我们的 SDK，用于构建加密支付应用程序、出入金集成等。
KillB SDK 通过提供类型安全、开发者友好的接口来简化与 KillB API 的集成。
可用的 SDK
为什么使用 SDK？
完整的 TypeScript 支持，包含自动补全和类型检查// TypeScript 知道响应结构
const user = await killb.users.create({
type: 'PERSON',
data: { /* 自动补全可用 */ }
});
自动令牌管理和刷新const killb = new KillB({
email: '[email protected]',
password: 'your-password'
});
// 自动处理身份验证
带有有用消息的类型化错误try {
await killb.ramps.create(rampData);
} catch (error) {
if (error.code === 'RAMP.0001') {
// 处理过期的报价
}
}
- 支持 async/await
- 基于 Promise 的 API
- 全面的文档
- 积极维护
- 社区支持
快速对比
| 功能 | REST API | JavaScript SDK | Python SDK |
|---|
| 设置 | 手动身份验证 | 简单配置 | 简单配置 |
| 类型安全 | ❌ | ✅ TypeScript | ✅ 类型提示 |
| 身份验证管理 | 手动 | 自动 | 自动 |
| 错误类型 | 通用 | 类型化 | 类型化 |
| IDE 支持 | 有限 | 优秀 | 良好 |
| 学习曲线 | 中等 | 简单 | 简单 |
快速开始
常见用例
// 使用 SDK 完成入金流程
const killb = new KillB(config);
// 1. 创建用户
const user = await killb.users.create({
type: 'PERSON',
data: userData
});
// 2. 创建钱包
const wallet = await killb.accounts.create({
type: 'WALLET',
userId: user.id,
data: walletData
});
// 3. 获取报价
const quote = await killb.quotations.create({
fromCurrency: 'COP',
toCurrency: 'USDC',
amount: 100000,
cashInMethod: 'PSE',
cashOutMethod: 'POLYGON'
});
// 4. 创建入金
const ramp = await killb.ramps.create({
quotationId: quote.id,
userId: user.id,
accountId: wallet.id
});
console.log('支付 URL:', ramp.paymentInfo[0].url);
// 使用 SDK 完成出金流程
const killb = new KillB(config);
// 获取报价
const quote = await killb.quotations.create({
fromCurrency: 'USDC',
toCurrency: 'COP',
amount: 100,
cashInMethod: 'POLYGON',
cashOutMethod: 'PSE'
});
// 创建出金到银行账户
const ramp = await killb.ramps.create({
quotationId: quote.id,
userId: user.id,
accountId: bankAccount.id
});
console.log('发送 USDC 到:', ramp.paymentInfo[0].address);
// SDK 包含 webhook 辅助函数
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('无效签名');
}
// 处理 webhook
handleEvent(req.body);
res.status(200).send('OK');
});
SDK 功能
社区与支持
下一步
