Token Developer Docs

// 1. Create a payment intent via the API
const response = await fetch('https://api.blacklab.studio/v1/token/payments', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount: '100.00',          // BLT amount
    currency: 'BLT',
    description: 'Mastering credit pack (10)',
    metadata: { order_id: 'ord_12345' },
    webhook_url: 'https://yourapp.com/webhooks/payment',
  }),
});

const payment = await response.json();
// { id: "pay_abc123", status: "pending", approval_url: "..." }

// 2. Redirect user to approval_url or embed the payment widget
window.location.href = payment.approval_url;

// 3. Handle the webhook callback
// POST to your webhook_url with payment confirmation

<!-- Include the BlackLab payment script -->
<script src="https://js.blacklab.studio/v1/payment.js"></script>

<!-- Create a payment button -->
<div id="blt-payment"></div>

<script>
  BlackLab.Payment.create({
    container: '#blt-payment',
    clientId: 'your_client_id',
    amount: '50.00',
    currency: 'BLT',
    description: '5 Mastering Credits',
    onSuccess: (payment) => {
      console.log('Payment confirmed:', payment.id);
    },
    onError: (error) => {
      console.error('Payment failed:', error.message);
    },
  });
</script>

import { BlackLabSDK } from '@blacklab/sdk';

const sdk = new BlackLabSDK({
  apiKey: 'sk_live_xxx',
  network: 'mainnet',
});

// Check staking balance
const stakeInfo = await sdk.staking.getPosition(walletAddress);
console.log('Staked:', stakeInfo.amount, 'BLT');
console.log('Rewards:', stakeInfo.pendingRewards, 'BLT');
console.log('Tier:', stakeInfo.tier);

// Stake tokens (requires user wallet approval)
const tx = await sdk.staking.stake({
  amount: '1000.00',
  lockPeriod: 90, // days
});

// Claim rewards
const claimTx = await sdk.staking.claimRewards();

# npm
npm install @blacklab/sdk

# yarn
yarn add @blacklab/sdk

# pnpm
pnpm add @blacklab/sdk

import { BlackLabSDK } from '@blacklab/sdk';

const sdk = new BlackLabSDK({
  apiKey: process.env.BLACKLAB_API_KEY,
  network: 'mainnet', // or 'testnet'
});

const balance = await sdk.token.balanceOf(walletAddress);
console.log(`Balance: ${balance.formatted} BLT`);

const tx = await sdk.token.transfer({
  to: recipientAddress,
  amount: '500.00',
});
console.log(`TX Hash: ${tx.hash}`);

sdk.token.on('Transfer', (from, to, amount) => {
  console.log(`${from} sent ${amount} BLT to ${to}`);
});