shll-skills 5.4.1 → 5.5.0

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: shll-run
 description: Execute DeFi transactions on BSC via SHLL AgentNFA. The AI handles all commands — users only need to chat.
-version: 5.4.1
+version: 5.5.0
 author: SHLL Team
 website: https://shll.run
 twitter: https://twitter.com/shllrun
@@ -150,6 +150,8 @@ Examples:
 - "Lend 10 USDT on Venus"
 - "How much am I earning on Venus?"
 - "Redeem my USDT from Venus"
+- "Check this Four.meme token: 0xABC..."
+- "Buy 0.01 BNB of tokens on Four.meme"
 
 ---
 
@@ -183,6 +185,17 @@ Examples:
 
 Supported lending tokens: **BNB, USDT, USDC, BUSD**
 
+### Four.meme Launchpad (Bonding Curve)
+| Command | What it does |
+|---------|-------------|
+| `shll-run four-info --token <ADDR>` | Query token bonding curve info (price, progress, DEX status) |
+| `shll-run four-buy --token <ADDR> -a <BNB> -k <ID>` | Buy tokens on internal bonding curve with BNB |
+| `shll-run four-sell --token <ADDR> -a <TOKENS> -k <ID>` | Sell tokens on internal bonding curve for BNB |
+
+**Requires:** FOUR_MEME DeFi Pack enabled on the agent (renter enables via Console > Safety).
+**Slippage:** Default 10% (meme tokens are volatile). Override with `-s <percent>`.
+**Note:** These commands only work while tokens are in bonding curve phase. Once migrated to DEX, use `swap` instead.
+
 ### Market Data (read-only)
 | Command | What it does |
 |---------|-------------|

package/dist/index.js

@@ -1036,6 +1036,7 @@ rawCmd.action(async (opts) => {
   try {
     const client = createClient(opts);
     const tokenId = BigInt(opts.tokenId);
+    await checkAccess(opts, tokenId);
     let actions;
     if (opts.batch) {
       if (!opts.actions) {
@@ -2274,6 +2275,325 @@ myAgentsCmd.action(async (opts) => {
     process.exit(1);
   }
 });
+var FOUR_MEME_HELPER_V3 = "0xF251F83e40a78868FcfA3FA4599Dad6494E46034";
+var FOUR_MEME_HELPER_ABI = [
+  {
+    type: "function",
+    name: "getTokenInfo",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      { name: "version", type: "uint256" },
+      { name: "tokenManager", type: "address" },
+      { name: "quote", type: "address" },
+      { name: "lastPrice", type: "uint256" },
+      { name: "tradingFeeRate", type: "uint256" },
+      { name: "minTradingFee", type: "uint256" },
+      { name: "launchTime", type: "uint256" },
+      { name: "offers", type: "uint256" },
+      { name: "maxOffers", type: "uint256" },
+      { name: "funds", type: "uint256" },
+      { name: "maxFunds", type: "uint256" },
+      { name: "liquidityAdded", type: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tryBuy",
+    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" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "trySell",
+    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" }
+    ],
+    stateMutability: "view"
+  }
+];
+var FOUR_MEME_V1_ABI = [
+  {
+    type: "function",
+    name: "purchaseTokenAMAP",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "funds", type: "uint256" },
+      { name: "minAmount", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "payable"
+  },
+  {
+    type: "function",
+    name: "saleToken",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
+var FOUR_MEME_V2_ABI = [
+  {
+    type: "function",
+    name: "buyTokenAMAP",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "funds", type: "uint256" },
+      { name: "minAmount", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "payable"
+  },
+  {
+    type: "function",
+    name: "sellToken",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
+var fourInfoCmd = new import_commander.Command("four-info").description("Query Four.meme bonding curve token info (price, progress, DEX status)").requiredOption("--token <address>", "Token contract address on Four.meme").option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC);
+fourInfoCmd.action(async (opts) => {
+  try {
+    const rpcUrl = opts.rpc || DEFAULT_RPC;
+    const publicClient = (0, import_viem2.createPublicClient)({ chain: import_chains2.bsc, transport: (0, import_viem2.http)(rpcUrl) });
+    const tokenAddr = opts.token;
+    const info = await publicClient.readContract({
+      address: FOUR_MEME_HELPER_V3,
+      abi: FOUR_MEME_HELPER_ABI,
+      functionName: "getTokenInfo",
+      args: [tokenAddr]
+    });
+    const [
+      version,
+      tokenManager,
+      quote,
+      lastPrice,
+      tradingFeeRate,
+      minTradingFee,
+      launchTime,
+      offers,
+      maxOffers,
+      funds,
+      maxFunds,
+      liquidityAdded
+    ] = info;
+    const progressPct = maxFunds > 0n ? Number(funds * 10000n / maxFunds) / 100 : 0;
+    const offersPct = maxOffers > 0n ? Number((maxOffers - offers) * 10000n / maxOffers) / 100 : 0;
+    output({
+      status: "success",
+      token: tokenAddr,
+      version: Number(version),
+      tokenManager,
+      quoteToken: quote === "0x0000000000000000000000000000000000000000" ? "BNB" : quote,
+      lastPrice: lastPrice.toString(),
+      lastPriceHuman: (Number(lastPrice) / 1e18).toExponential(4),
+      tradingFeeRate: `${Number(tradingFeeRate) / 100}%`,
+      minTradingFee: minTradingFee.toString(),
+      launchTime: new Date(Number(launchTime) * 1e3).toISOString(),
+      offers: offers.toString(),
+      maxOffers: maxOffers.toString(),
+      tokensSoldPct: `${offersPct.toFixed(2)}%`,
+      fundsRaised: funds.toString(),
+      fundsRaisedBNB: (Number(funds) / 1e18).toFixed(4),
+      maxFunds: maxFunds.toString(),
+      maxFundsBNB: (Number(maxFunds) / 1e18).toFixed(4),
+      bondingCurveProgress: `${progressPct.toFixed(2)}%`,
+      liquidityAdded,
+      tradingPhase: liquidityAdded ? "DEX (PancakeSwap)" : "Internal (Bonding Curve)"
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    output({ status: "error", message });
+    process.exit(1);
+  }
+});
+var fourBuyCmd = new import_commander.Command("four-buy").description("Buy tokens on Four.meme internal bonding curve using BNB").requiredOption("--token <address>", "Token contract address").requiredOption("-a, --amount <bnb>", "BNB amount to spend (human-readable, e.g. 0.01)").option("-s, --slippage <percent>", "Slippage tolerance in percent (default: 10)", "10");
+addSharedOptions(fourBuyCmd);
+fourBuyCmd.action(async (opts) => {
+  try {
+    const client = createClient(opts);
+    const tokenId = BigInt(opts.tokenId);
+    await checkAccess(opts, tokenId);
+    const rpcUrl = opts.rpc || DEFAULT_RPC;
+    const publicClient = (0, import_viem2.createPublicClient)({ chain: import_chains2.bsc, transport: (0, import_viem2.http)(rpcUrl) });
+    const vault = await client.getVault(tokenId);
+    const tokenAddr = opts.token;
+    const slippage = Number(opts.slippage);
+    const bnbAmount = parseAmount(opts.amount, 18);
+    const info = await publicClient.readContract({
+      address: FOUR_MEME_HELPER_V3,
+      abi: FOUR_MEME_HELPER_ABI,
+      functionName: "getTokenInfo",
+      args: [tokenAddr]
+    });
+    const [version, tokenManager, quote, , , , , , , , , liquidityAdded] = info;
+    if (liquidityAdded) {
+      output({ status: "error", message: "Token has already migrated to DEX. Use the 'swap' command instead of 'four-buy'." });
+      process.exit(1);
+    }
+    const isQuoteBNB = quote === "0x0000000000000000000000000000000000000000";
+    if (!isQuoteBNB) {
+      output({ status: "error", message: `Token uses BEP20 quote (${quote}), not BNB. BEP20 quote pairs are not yet supported in this tool.` });
+      process.exit(1);
+    }
+    const tryBuyResult = await publicClient.readContract({
+      address: FOUR_MEME_HELPER_V3,
+      abi: FOUR_MEME_HELPER_ABI,
+      functionName: "tryBuy",
+      args: [tokenAddr, 0n, bnbAmount]
+    });
+    const [, , estimatedAmount, estimatedCost, estimatedFee, amountMsgValue] = tryBuyResult;
+    const minAmount = estimatedAmount * BigInt(100 - slippage) / 100n;
+    const alignedMinAmount = minAmount / 1000000000n * 1000000000n;
+    output({
+      status: "info",
+      message: `Four.meme Buy: ~${(Number(estimatedAmount) / 1e18).toFixed(4)} tokens for ${opts.amount} BNB | fee: ${(Number(estimatedFee) / 1e18).toFixed(6)} BNB | minOut: ${(Number(alignedMinAmount) / 1e18).toFixed(4)} (${slippage}% slippage)`
+    });
+    let data;
+    if (Number(version) === 1) {
+      data = (0, import_viem2.encodeFunctionData)({
+        abi: FOUR_MEME_V1_ABI,
+        functionName: "purchaseTokenAMAP",
+        args: [tokenAddr, bnbAmount, alignedMinAmount]
+      });
+    } else {
+      data = (0, import_viem2.encodeFunctionData)({
+        abi: FOUR_MEME_V2_ABI,
+        functionName: "buyTokenAMAP",
+        args: [tokenAddr, bnbAmount, alignedMinAmount]
+      });
+    }
+    const action = {
+      target: tokenManager,
+      value: amountMsgValue,
+      data
+    };
+    const simResult = await client.validate(tokenId, action);
+    if (!simResult.ok) {
+      output({ status: "rejected", reason: simResult.reason });
+      process.exit(0);
+    }
+    const result = await client.execute(tokenId, action, true);
+    output({
+      status: "success",
+      hash: result.hash,
+      protocol: "four.meme",
+      action: "buy",
+      bnbSpent: opts.amount,
+      estimatedTokens: (Number(estimatedAmount) / 1e18).toFixed(4)
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    output({ status: "error", message });
+    process.exit(1);
+  }
+});
+var fourSellCmd = new import_commander.Command("four-sell").description("Sell tokens on Four.meme internal bonding curve").requiredOption("--token <address>", "Token contract address").requiredOption("-a, --amount <number>", "Amount of tokens to sell (human-readable, e.g. 1000)").option("-s, --slippage <percent>", "Slippage tolerance in percent (default: 10)", "10");
+addSharedOptions(fourSellCmd);
+fourSellCmd.action(async (opts) => {
+  try {
+    const client = createClient(opts);
+    const tokenId = BigInt(opts.tokenId);
+    await checkAccess(opts, tokenId);
+    const rpcUrl = opts.rpc || DEFAULT_RPC;
+    const publicClient = (0, import_viem2.createPublicClient)({ chain: import_chains2.bsc, transport: (0, import_viem2.http)(rpcUrl) });
+    const tokenAddr = opts.token;
+    const sellAmount = parseAmount(opts.amount, 18);
+    const alignedAmount = sellAmount / 1000000000n * 1000000000n;
+    const info = await publicClient.readContract({
+      address: FOUR_MEME_HELPER_V3,
+      abi: FOUR_MEME_HELPER_ABI,
+      functionName: "getTokenInfo",
+      args: [tokenAddr]
+    });
+    const [version, tokenManager, , , , , , , , , , liquidityAdded] = info;
+    if (liquidityAdded) {
+      output({ status: "error", message: "Token has already migrated to DEX. Use the 'swap' command instead of 'four-sell'." });
+      process.exit(1);
+    }
+    const trySellResult = await publicClient.readContract({
+      address: FOUR_MEME_HELPER_V3,
+      abi: FOUR_MEME_HELPER_ABI,
+      functionName: "trySell",
+      args: [tokenAddr, alignedAmount]
+    });
+    const [, , estimatedFunds, estimatedFee] = trySellResult;
+    output({
+      status: "info",
+      message: `Four.meme Sell: ${opts.amount} tokens \u2192 ~${(Number(estimatedFunds) / 1e18).toFixed(6)} BNB | fee: ${(Number(estimatedFee) / 1e18).toFixed(6)} BNB`
+    });
+    const actions = [];
+    const approveData = (0, import_viem2.encodeFunctionData)({
+      abi: ERC20_ABI,
+      functionName: "approve",
+      args: [tokenManager, alignedAmount]
+    });
+    actions.push({ target: tokenAddr, value: 0n, data: approveData });
+    let sellData;
+    if (Number(version) === 1) {
+      sellData = (0, import_viem2.encodeFunctionData)({
+        abi: FOUR_MEME_V1_ABI,
+        functionName: "saleToken",
+        args: [tokenAddr, alignedAmount]
+      });
+    } else {
+      sellData = (0, import_viem2.encodeFunctionData)({
+        abi: FOUR_MEME_V2_ABI,
+        functionName: "sellToken",
+        args: [tokenAddr, alignedAmount]
+      });
+    }
+    actions.push({ target: tokenManager, value: 0n, data: sellData });
+    for (const action of actions) {
+      const simResult = await client.validate(tokenId, action);
+      if (!simResult.ok) {
+        output({ status: "rejected", reason: simResult.reason });
+        process.exit(0);
+      }
+    }
+    const result = await client.executeBatch(tokenId, actions, true);
+    output({
+      status: "success",
+      hash: result.hash,
+      protocol: "four.meme",
+      action: "sell",
+      tokensSold: opts.amount,
+      estimatedBNB: (Number(estimatedFunds) / 1e18).toFixed(6)
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    output({ status: "error", message });
+    process.exit(1);
+  }
+});
 program.addCommand(swapCmd);
 program.addCommand(rawCmd);
 program.addCommand(tokensCmd);
@@ -2296,4 +2616,7 @@ program.addCommand(lendCmd);
 program.addCommand(redeemCmd);
 program.addCommand(lendingInfoCmd);
 program.addCommand(myAgentsCmd);
+program.addCommand(fourInfoCmd);
+program.addCommand(fourBuyCmd);
+program.addCommand(fourSellCmd);
 program.parse(process.argv);