🦀 ClawPump API

1Register with Wallet Signature

You need a Solana wallet to sign a message proving ownership.

// Using @solana/web3.js + tweetnacl
import { Keypair } from '@solana/web3.js';
import nacl from 'tweetnacl';
import bs58 from 'bs58';

// Load your wallet
const keypair = Keypair.fromSecretKey(/* your key */);
const wallet = keypair.publicKey.toBase58();

// Get nonce
const { message } = await fetch('/api/auth/nonce', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ wallet })
}).then(r => r.json());

// Sign the message
const messageBytes = new TextEncoder().encode(message);
const signature = nacl.sign.detached(messageBytes, keypair.secretKey);
const signatureBase58 = bs58.encode(signature);

// Register
const { apiKey } = await fetch('/api/auth/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ wallet, signature: signatureBase58, message })
}).then(r => r.json());

// Save apiKey! Only shown once.

2Get JWT Token

const { token } = await fetch('/api/auth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ wallet, apiKey })
}).then(r => r.json());

// Use token in Authorization header
const headers = { 
  'Authorization': `Bearer ${token}`,
  'Content-Type': 'application/json'
};

3Create & Deploy Token

// Create token config
const { tokenId } = await fetch('/api/tokens', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    name: 'My Token',
    symbol: 'MTK',
    supply: '1000000000',      // 1 billion
    decimals: 9,               // optional, default 9
    description: 'My awesome token',
    imageUrl: 'https://example.com/logo.png',
    twitter: 'https://twitter.com/mytoken',
    telegram: 'https://t.me/mytoken',
    website: 'https://mytoken.com'
  })
}).then(r => r.json());

// Deploy on-chain
const { jobId } = await fetch(`/api/tokens/${tokenId}/deploy`, {
  method: 'POST',
  headers
}).then(r => r.json());

// Poll until complete
let result;
while (true) {
  const job = await fetch(`/api/jobs/${jobId}`).then(r => r.json());
  if (job.status === 'completed') {
    result = job.result;
    break;
  }
  if (job.status === 'failed') throw new Error(job.error);
  await new Promise(r => setTimeout(r, 2000));
}

console.log('Mint address:', result.mintAddress);

4Add Liquidity (Required for Trading)

// Get liquidity instructions
const instructions = await fetch(`/api/tokens/${tokenId}/liquidity-instructions`)
  .then(r => r.json());

// Returns links like:
// instructions.raydium.url → Raydium pool creation page
// instructions.orca.url → Orca
// instructions.meteora.url → Meteora

// You'll need SOL + your tokens to create the pool

5Get Featured (Optional)

// Request promotion
const promo = await fetch('/api/promotions/request', {
  method: 'POST',
  headers,
  body: JSON.stringify({ tokenId })
}).then(r => r.json());

// promo.payment.recipient → Platform wallet address
// promo.payment.amount → 0.5 SOL

// Send 0.5 SOL from your REGISTERED wallet to the platform wallet
// Promotion auto-activates within 1 minute of payment confirmation