@four-meme/four-meme-ai 1.0.0

package/skills/four-meme-integration/scripts/quote-buy.ts

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - buy quote via TokenManagerHelper3.tryBuy (BSC only).
+ * Usage: npx tsx quote-buy.ts <tokenAddress> <amountWei> [fundsWei]
+ */
+
+import { createPublicClient, http } from 'viem';
+import { bsc } from 'viem/chains';
+
+const HELPER_ADDRESS = '0xF251F83e40a78868FcfA3FA4599Dad6494E46034' as const;
+
+const HELPER_ABI = [
+  {
+    name: 'tryBuy',
+    type: 'function',
+    stateMutability: 'view',
+    inputs: [
+      { name: 'token', type: 'address' },
+      { name: 'amount', type: 'uint256' },
+      { name: 'funds', type: 'uint256' },
+    ],
+    outputs: [
+      { name: 'tokenManager', type: 'address' },
+      { name: 'quote', type: 'address' },
+      { name: 'estimatedAmount', type: 'uint256' },
+      { name: 'estimatedCost', type: 'uint256' },
+      { name: 'estimatedFee', type: 'uint256' },
+      { name: 'amountMsgValue', type: 'uint256' },
+      { name: 'amountApproval', type: 'uint256' },
+      { name: 'amountFunds', type: 'uint256' },
+    ],
+  },
+] as const;
+
+const RPC_URL = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+
+async function main() {
+  const tokenAddress = process.argv[2] as `0x${string}`;
+  const amountWei = BigInt(process.argv[3] ?? '0');
+  const fundsWei = BigInt(process.argv[4] ?? '0');
+
+  if (!tokenAddress) {
+    console.error('Usage: npx tsx quote-buy.ts <tokenAddress> <amountWei> [fundsWei]');
+    console.error('BSC only. amountWei: token amount (0 for funds-based); fundsWei: quote to spend (0 for amount-based)');
+    process.exit(1);
+  }
+
+  const client = createPublicClient({
+    chain: bsc,
+    transport: http(RPC_URL),
+  });
+
+  const [
+    tokenManager,
+    quote,
+    estimatedAmount,
+    estimatedCost,
+    estimatedFee,
+    amountMsgValue,
+    amountApproval,
+    amountFunds,
+  ] = await client.readContract({
+    address: HELPER_ADDRESS,
+    abi: HELPER_ABI,
+    functionName: 'tryBuy',
+    args: [tokenAddress, amountWei, fundsWei],
+  });
+
+  const out = {
+    tokenManager,
+    quote: quote === '0x0000000000000000000000000000000000000000' ? 'native' : quote,
+    estimatedAmount: estimatedAmount.toString(),
+    estimatedCost: estimatedCost.toString(),
+    estimatedFee: estimatedFee.toString(),
+    amountMsgValue: amountMsgValue.toString(),
+    amountApproval: amountApproval.toString(),
+    amountFunds: amountFunds.toString(),
+  };
+  console.log(JSON.stringify(out, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/quote-sell.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - sell quote via TokenManagerHelper3.trySell (BSC only).
+ * Usage: npx tsx quote-sell.ts <tokenAddress> <amountWei>
+ */
+
+import { createPublicClient, http } from 'viem';
+import { bsc } from 'viem/chains';
+
+const HELPER_ADDRESS = '0xF251F83e40a78868FcfA3FA4599Dad6494E46034' as const;
+
+const HELPER_ABI = [
+  {
+    name: 'trySell',
+    type: 'function',
+    stateMutability: 'view',
+    inputs: [
+      { name: 'token', type: 'address' },
+      { name: 'amount', type: 'uint256' },
+    ],
+    outputs: [
+      { name: 'tokenManager', type: 'address' },
+      { name: 'quote', type: 'address' },
+      { name: 'funds', type: 'uint256' },
+      { name: 'fee', type: 'uint256' },
+    ],
+  },
+] as const;
+
+const RPC_URL = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+
+async function main() {
+  const tokenAddress = process.argv[2] as `0x${string}`;
+  const amountWei = BigInt(process.argv[3] ?? '0');
+
+  if (!tokenAddress) {
+    console.error('Usage: npx tsx quote-sell.ts <tokenAddress> <amountWei>');
+    console.error('BSC only.');
+    process.exit(1);
+  }
+
+  const client = createPublicClient({
+    chain: bsc,
+    transport: http(RPC_URL),
+  });
+
+  const [tokenManager, quote, funds, fee] = await client.readContract({
+    address: HELPER_ADDRESS,
+    abi: HELPER_ABI,
+    functionName: 'trySell',
+    args: [tokenAddress, amountWei],
+  });
+
+  const out = {
+    tokenManager,
+    quote: quote === '0x0000000000000000000000000000000000000000' ? 'native' : quote,
+    funds: funds.toString(),
+    fee: fee.toString(),
+  };
+  console.log(JSON.stringify(out, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/send-token.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - send BNB or ERC20 from current wallet to a target address (BSC).
+ *
+ * Usage:
+ *   npx tsx send-token.ts <toAddress> <amountWei> [tokenAddress]
+ *   - toAddress: recipient wallet address (0x...)
+ *   - amountWei: amount in wei (for BNB or token decimals)
+ *   - tokenAddress: optional; omit or use "BNB" / "0x0" for native BNB; otherwise ERC20 token contract address
+ *
+ * Env: PRIVATE_KEY or FOURMEME_PRIVATE_KEY. Optional: BSC_RPC_URL.
+ */
+
+import { createWalletClient, http, parseAbi } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { bsc } from 'viem/chains';
+
+const ZERO = '0x0000000000000000000000000000000000000000' as const;
+
+const ERC20_ABI = parseAbi([
+  'function transfer(address to, uint256 amount) returns (bool)',
+]);
+
+function isAddress(s: string): boolean {
+  return /^0x[0-9a-fA-F]{40}$/.test(s);
+}
+
+async function main() {
+  const privateKey = process.env.PRIVATE_KEY || process.env.FOURMEME_PRIVATE_KEY;
+  if (!privateKey) {
+    console.error('Set PRIVATE_KEY or FOURMEME_PRIVATE_KEY');
+    process.exit(1);
+  }
+  const pk = privateKey.startsWith('0x') ? (privateKey as `0x${string}`) : (`0x${privateKey}` as `0x${string}`);
+  const account = privateKeyToAccount(pk);
+
+  const toAddress = process.argv[2];
+  const amountWeiRaw = process.argv[3];
+  const tokenAddress = process.argv[4]; // optional: BNB if omitted or "BNB" or 0x0
+
+  if (!toAddress || !amountWeiRaw) {
+    console.error('Usage: send-token.ts <toAddress> <amountWei> [tokenAddress]');
+    console.error('  toAddress:   recipient 0x... address');
+    console.error('  amountWei:   amount in wei (for BNB or token smallest unit)');
+    console.error('  tokenAddress: optional; omit or BNB/0x0 = native BNB; else ERC20 contract address');
+    process.exit(1);
+  }
+  if (!isAddress(toAddress)) {
+    console.error('Invalid toAddress:', toAddress);
+    process.exit(1);
+  }
+
+  const amountWei = BigInt(amountWeiRaw);
+  if (amountWei <= 0n) {
+    console.error('amountWei must be positive');
+    process.exit(1);
+  }
+
+  const isNative =
+    !tokenAddress ||
+    tokenAddress.toUpperCase() === 'BNB' ||
+    tokenAddress === ZERO ||
+    tokenAddress.toLowerCase() === '0x0000000000000000000000000000000000000000';
+
+  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+  const client = createWalletClient({
+    account,
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+
+  let txHash: `0x${string}`;
+
+  if (isNative) {
+    txHash = await client.sendTransaction({
+      to: toAddress as `0x${string}`,
+      value: amountWei,
+    });
+  } else {
+    if (!isAddress(tokenAddress)) {
+      console.error('Invalid tokenAddress:', tokenAddress);
+      process.exit(1);
+    }
+    txHash = await client.writeContract({
+      address: tokenAddress as `0x${string}`,
+      abi: ERC20_ABI,
+      functionName: 'transfer',
+      args: [toAddress as `0x${string}`, amountWei],
+    });
+  }
+
+  console.log(JSON.stringify({ txHash, to: toAddress, amountWei: amountWei.toString(), native: isNative }, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/token-get.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - token detail + trading info (REST API)
+ * GET /meme-api/v1/private/token/get/v2?address=<address>
+ * Usage: npx tsx token-get.ts <tokenAddress>
+ * Output: JSON token info and trading info.
+ */
+
+const API_BASE = 'https://four.meme/meme-api/v1';
+
+async function main() {
+  const address = process.argv[2];
+  if (!address) {
+    console.error('Usage: npx tsx token-get.ts <tokenAddress>');
+    process.exit(1);
+  }
+  const url = `${API_BASE}/private/token/get/v2?address=${encodeURIComponent(address)}`;
+  const res = await fetch(url, {
+    headers: { Accept: 'application/json' },
+  });
+  if (!res.ok) {
+    throw new Error(`token/get/v2 failed: ${res.status} ${await res.text()}`);
+  }
+  const data = await res.json();
+  console.log(JSON.stringify(data, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/token-list.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - token list (REST API)
+ * GET /meme-api/v1/private/token/query
+ * Usage: npx tsx token-list.ts [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
+ * Output: JSON list of tokens.
+ */
+
+const API_BASE = 'https://four.meme/meme-api/v1';
+
+function parseArg(name: string, defaultValue: string): string {
+  const prefix = `--${name}=`;
+  for (let i = 2; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg.startsWith(prefix)) return arg.slice(prefix.length);
+  }
+  return defaultValue;
+}
+
+async function main() {
+  const orderBy = parseArg('orderBy', 'Hot');
+  const tokenName = parseArg('tokenName', '');
+  const listedPancake = parseArg('listedPancake', 'false');
+  const pageIndex = parseArg('pageIndex', '1');
+  const pageSize = parseArg('pageSize', '30');
+  const symbol = parseArg('symbol', '');
+  const labels = parseArg('labels', '');
+
+  const params = new URLSearchParams({
+    orderBy,
+    tokenName,
+    listedPancake,
+    pageIndex,
+    pageSize,
+    symbol,
+    labels,
+  });
+  const url = `${API_BASE}/private/token/query?${params.toString()}`;
+  const res = await fetch(url, {
+    headers: { Accept: 'application/json' },
+  });
+  if (!res.ok) {
+    throw new Error(`token/query failed: ${res.status} ${await res.text()}`);
+  }
+  const data = await res.json();
+  console.log(JSON.stringify(data, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/token-rankings.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * Four.meme - token rankings (REST API)
+ * POST /meme-api/v1/private/token/query/advanced
+ * Body: { orderBy: "Time"|"ProgressDesc"|"TradingDesc"|"Hot"|"Graduated" [, barType: "HOUR24" ] }
+ * Usage: npx tsx token-rankings.ts <orderBy> [--barType=HOUR24]
+ *   orderBy: Time | ProgressDesc | TradingDesc | Hot | Graduated
+ *   --barType only for TradingDesc (24h volume)
+ * Output: JSON ranking list.
+ */
+
+const API_BASE = 'https://four.meme/meme-api/v1';
+
+function parseArg(name: string): string | undefined {
+  const prefix = `--${name}=`;
+  for (let i = 3; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg.startsWith(prefix)) return arg.slice(prefix.length);
+  }
+  return undefined;
+}
+
+async function main() {
+  const orderBy = process.argv[2];
+  const validOrderBy = ['Time', 'ProgressDesc', 'TradingDesc', 'Hot', 'Graduated'];
+  if (!orderBy || !validOrderBy.includes(orderBy)) {
+    console.error('Usage: npx tsx token-rankings.ts <orderBy> [--barType=HOUR24]');
+    console.error('orderBy: Time | ProgressDesc | TradingDesc | Hot | Graduated');
+    process.exit(1);
+  }
+  const body: Record<string, string> = { orderBy };
+  const barType = parseArg('barType');
+  if (barType) body.barType = barType;
+
+  const url = `${API_BASE}/private/token/query/advanced`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      Accept: 'application/json',
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) {
+    throw new Error(`token/query/advanced failed: ${res.status} ${await res.text()}`);
+  }
+  const data = await res.json();
+  console.log(JSON.stringify(data, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/verify-events.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * Verification helper: fetch TokenManager2 events for the last N blocks on BSC.
+ * Usage: npx tsx verify-events.ts [blockCount]
+ * Default blockCount 50. No private key or tx, read-only.
+ */
+
+import { createPublicClient, http, parseAbiItem } from 'viem';
+import { bsc } from 'viem/chains';
+
+const TOKEN_MANAGER2_BSC = '0x5c952063c7fc8610FFDB798152D69F0B9550762b' as const;
+const EVENTS = [
+  parseAbiItem(
+    'event TokenCreate(address creator, address token, uint256 requestId, string name, string symbol, uint256 totalSupply, uint256 launchTime, uint256 launchFee)'
+  ),
+  parseAbiItem(
+    'event TokenPurchase(address token, address account, uint256 price, uint256 amount, uint256 cost, uint256 fee, uint256 offers, uint256 funds)'
+  ),
+  parseAbiItem(
+    'event TokenSale(address token, address account, uint256 price, uint256 amount, uint256 cost, uint256 fee, uint256 offers, uint256 funds)'
+  ),
+  parseAbiItem('event LiquidityAdded(address base, uint256 offers, address quote, uint256 funds)'),
+];
+
+async function main() {
+  const blockCount = parseInt(process.argv[2] ?? '50', 10) || 50;
+  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+  const client = createPublicClient({
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+  const block = await client.getBlockNumber();
+  const fromBlock = block - BigInt(blockCount);
+  const toBlock = block;
+  const logs = await client.getLogs({
+    address: TOKEN_MANAGER2_BSC,
+    events: EVENTS,
+    fromBlock: fromBlock < 0n ? 0n : fromBlock,
+    toBlock,
+  });
+  console.log(JSON.stringify({ fromBlock: String(fromBlock), toBlock: String(toBlock), count: logs.length, events: logs.map((l) => ({ eventName: l.eventName, blockNumber: Number(l.blockNumber), args: l.args })) }, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "types": ["node"]
+  },
+  "include": ["skills/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}