Bankr Twitter bot guide

import { TwitterApi } from 'twitter-api-v2';

// Initialize the Twitter client with your credentials
const client = new TwitterApi({
  appKey: process.env.TWITTER_API_KEY!,
  appSecret: process.env.TWITTER_API_SECRET!,
  accessToken: process.env.TWITTER_ACCESS_TOKEN!,
  accessSecret: process.env.TWITTER_ACCESS_SECRET!,
});

// Get the read/write client
const rwClient = client.readWrite;

async function pollMentions() {
  let sinceId: string | undefined = undefined;
  while (true) {
    const mentions = await rwClient.v2.userMentionTimeline('YOUR_BOT_USER_ID', {
      since_id: sinceId,
      expansions: ['author_id', 'entities.mentions.username'],
      'user.fields': ['username', 'name'],
      max_results: 5,
    });
    for (const tweet of mentions.data?.data || []) {
      const parsed = processTweet(tweet, mentions);
      if (parsed) {
        // Call your LLM or transaction logic here
        // e.g. handleCommand(parsed)
      }
      sinceId = tweet.id;
    }
    await new Promise(res => setTimeout(res, 10000)); // poll every 10s
  }
}

function processTweet(tweet, mentionsResponse) {
  // Extract basic tweet information
  const text = tweet.text;
  const authorId = tweet.author_id;
  const tweetId = tweet.id;
  const mentions = tweet.entities?.mentions || [];

  // Extract all mentioned users
  const mentionedUsers = mentions.map(mention => {
    const username = mention.username;
    const user = mentionsResponse.includes?.users.find(u => u.username === username);
    return {
      username,
      userId: user?.id,
      isBot: username === 'bankr_bot' // Identify if this is our bot
    };
  });

  // Pass the structured data to the LLM for intent detection
  return {
    text,
    authorId,
    tweetId,
    mentions: mentionedUsers,
    // Additional context can be added here
  };
}

User: Launch a token called $CAT with 1B supply
System: Extract the intent and parameters for a token launch on Base.
Output format: { action: string, params: object }

{
  "action": "launch_token",
  "params": {
    "name": "CAT",
    "symbol": "$CAT",
    "supply": "1000000000"
  }
}

// Pseudocode: send user message to LLM and parse response
const llmResponse = await llm.query({ prompt: userMessage });
if (llmResponse.action === 'launch_token') {
  // Proceed to Clanker integration
}

User: create a new $Example token
System: Extract the intent and parameters for a token launch on Base.
Output format: { action: string, params: object }

{
  "action": "launch_token",
  "params": {
    "name": "Example",
    "symbol": "$Example"
  }
}

// Example incoming tweet
const tweet = {
  text: "@YOUR_BOT_HANDLE create a new $Example token",
  author_id: "1234567890",
  id: "9876543210",
  // ...other fields
};
// Remove bot mention to get user command
const userMessage = tweet.text.replace(/@YOUR_BOT_HANDLE\s*/i, "").trim();

// Send the user message to your LLM
const llmResponse = await llm.query({ prompt: userMessage });
// Example LLM response:
// {
//   action: "launch_token",
//   params: { name: "Example", symbol: "$Example" }
// }
if (llmResponse.action !== 'launch_token') {
  throw new Error('Not a token launch command');
}
const { name, symbol } = llmResponse.params;

// Get or create a wallet for the user
const wallet = await getOrCreateUserWallet(tweet.author_id);
// wallet.address will be used as the requestorAddress

import axios from 'axios';
import crypto from 'crypto';

const apiKey = process.env.CLANKER_API_KEY;
const requestKey = crypto.randomBytes(16).toString('hex');
const payload = {
  name,
  symbol,
  image: 'https://example.com/token.png', // Optional: add your image
  requestorAddress: wallet.address,
  requestKey,
  // ...other optional params
};
const response = await axios.post('https://www.clanker.world/api/tokens/deploy', payload, {
  headers: {
    'x-api-key': apiKey,
    'Content-Type': 'application/json'
  }
});
const tokenInfo = response.data;

// Send a DM or reply to the user with the token address
await twitterClient.sendDM({
  userId: tweet.author_id,
  text: `Token deployed! Address: ${tokenInfo.address}`
});

User: Hey bot, send 0.01 ETH from my wallet to @privy_io on twitter
System: Extract the intent and parameters for a token transfer on Base.
Output format: { action: string, params: object }

{
  "action": "send_token",
  "params": {
    "amount": "0.01",
    "token": "ETH",
    "recipient": "@privy_io"
  }
}

// 1. Get sender's Twitter ID from the parsed tweet
const senderTwitterId = parsed.authorId;

// 2. Get recipient's Twitter handle from LLM response (e.g., '@privy_io')
const recipientHandle = llmResponse.params.recipient.replace('@', '');

// 3. Look up recipient's Twitter ID from parsed mentions
const recipientMention = parsed.mentions.find(m => m.username === recipientHandle);
if (!recipientMention || !recipientMention.userId) {
  throw new Error('Recipient not found in tweet mentions');
}
const recipientTwitterId = recipientMention.userId;

// 4. Get or create recipient's wallet
const recipientWallet = await getOrCreateUserWallet(recipientTwitterId);

// 5. Get or create sender's wallet
const senderWallet = await getOrCreateUserWallet(senderTwitterId);

import { parseEther } from 'viem';

// 1. Parse the amount to wei (ETH uses 18 decimals)
const amountEth = llmResponse.params.amount; // e.g., '1'
const amountWei = parseEther(amountEth); // '1000000000000000000'

// 2. Prepare transaction details
const transaction = {
  to: recipientWallet.address,      // Recipient's EVM address
  value: amountWei,                // Amount in wei
  chainId: 8453,                   // Base chain ID
  // (Optional: add gas, data, etc.)
};

// 3. Send the transaction using Privy wallet
const sendResult = await privy.walletApi.ethereum.sendTransaction({
  walletId: senderWallet.id,        // Sender's Privy wallet ID
  caip2: 'eip155:8453',           // CAIP2 for Base
  transaction,
});