Quick Start

Minimal example: buy tokens using the SDK in under 30 lines.

View on GitHub

Setup

git clone https://github.com/darkfibre-dev/darkfibre-examples.git
cd darkfibre-examples/01-quick-start
npm install
cp .env.example .env

Edit .env with your credentials:

DARKFIBRE_API_KEY=your-api-key
SOLANA_PRIVATE_KEY=your-base58-private-key

Edit index.ts to set the token mint address you want to buy.

Run

npm start

Code

import { DarkfibreSDK } from '@darkfibre/sdk';
import 'dotenv/config';

async function main() {
  const sdk = new DarkfibreSDK({
    apiKey: process.env.DARKFIBRE_API_KEY!,
    privateKey: process.env.SOLANA_PRIVATE_KEY!,
  });

  // Replace with the token address you want to buy
  const TOKEN_ADDRESS = 'PASTE_YOUR_TOKEN_ADDRESS_HERE';

  const result = await sdk.buy({
    mint: TOKEN_ADDRESS,
    solAmount: 0.005,
    slippage: 0.05,
    priority: 'fast',
  });

  console.log('Transaction:', result.signature);
  console.log('SOL spent:', result.tradeResult.inputAmount);
  console.log('Tokens received:', result.tradeResult.outputAmount);
  console.log('Priority fee:', result.priorityCost, 'SOL');
  console.log(`View on Solscan: https://solscan.io/tx/${result.signature}`);
}

main().catch(console.error);

What It Does

1. Initializes the SDK with your credentials
2. Buys tokens with 0.005 SOL
3. Prints the transaction signature and tokens received

Configuration

Edit index.ts to change:

Variable	Description	Default
TOKEN_ADDRESS	Token mint address to buy	-
solAmount	Amount of SOL to spend	0.005
slippage	Slippage tolerance (0.05 = 5%)	0.05
priority	Transaction priority	'fast'

Expected Output

Transaction: 5xK7j...abc123
SOL spent: 0.005
Tokens received: 1234567.89
Priority fee: 0.0001 SOL
View on Solscan: https://solscan.io/tx/5xK7j...abc123

Related

• SDK Overview - Installation and setup
• buy() - Full method documentation