@blackcube/bullet-sdk

SDK TypeScript pour Bullet — DEX de perpétuels sur un rollup Sovereign SDK (écosystème Solana, clés Ed25519). Même surface que les autres SDK DEX Blackcube (Hyperliquid / Aster / Pacifica / Lighter / Paradex / Extended).

Documentation : doc/README.md (index) — contrat commun doc/common.md, surplus natif doc/native.md, signature doc/signing.md.

Tout passe par la classe Bullet

import { Bullet } from '@blackcube/bullet-sdk';

// Lectures publiques (sans signer)
const pub = new Bullet();
await pub.perp().getPairs();
await pub.perp().getOrderBook({ name: 'SOL-USD', limit: 20 });

// Signé (clé Ed25519 / compte rollup Bullet)
const dex = new Bullet({ desk: { privateKey: '…', network: 'testnet' } }, { default: 'desk' });
await dex.account().getBalances();
await dex.perp().place({ name: 'SOL-USD', side: 'buy', type: 'limit', size: '0.1', price: '50', tif: 'gtc' });

Spécificités Bullet

• Auth : pas d'API key/JWT — les écritures sont des transactions rollup signées Ed25519 (sérialisation Borsh pilotée par le schéma du rollup). Signature via le signer WASM officiel @bulletxyz/sdk-wasm (modèle Lighter). Lectures publiques paramétrées par address.
• REST calqué Binance Futures (/fapi/v1, /fapi/v3, /api/v1). Bougies = WebSocket uniquement (pas d'endpoint REST klines). Timestamps en microsecondes.
• Perp-only, cross-margin (brackets de levier, pas de setLeverage). Pas de dead-man-switch serveur.
• Marchés BASE-USD (ex. SOL-USD, BTC-USD).

Licence

BSD-3-Clause — Blackcube.