@four-meme/four-meme-ai 1.0.4 → 1.0.6

package/skills/four-meme-integration/references/contract-addresses.md

@@ -1,34 +1,47 @@
-# Four.meme Contract Addresses (BSC only)
-
-This skill supports **BSC only** (chainId 56). Arbitrum and Base are not supported.
-
-## TokenManager (V1)
-
-Used for tokens created **before** September 5, 2024. Only trading (no create).
-
-| Chain | Address |
-|-------|---------|
-| BSC   | `0xEC4549caDcE5DA21Df6E6422d448034B5233bFbC` |
-
-## TokenManager2 (V2)
-
-Used for tokens created **after** September 5, 2024. Create and trade.
-
-| Chain | Address |
-|-------|---------|
-| BSC   | `0x5c952063c7fc8610FFDB798152D69F0B9550762b` |
-
-## TokenManagerHelper3 (V3)
-
-Use for **getTokenInfo**, **tryBuy**, **trySell**. Supports both V1 and V2 tokens.
-
-| Chain | Address |
-|-------|---------|
-| BSC   | `0xF251F83e40a78868FcfA3FA4599Dad6494E46034` |
-
-## Usage
-
-1. Call **TokenManagerHelper3.getTokenInfo(token)** to get `version` and `tokenManager`.
-2. If `version === 1` → use TokenManager V1 for buy/sell.
-3. If `version === 2` → use TokenManager2 for buy/sell (and check X Mode / TaxToken / AntiSniperFeeMode if needed).
-4. Token creation is only via **TokenManager2** on BSC after obtaining `createArg` and `signature` from the four.meme API.
+# Four.meme Contract Addresses (BSC only)
+
+This skill supports **BSC only** (chainId 56). Arbitrum and Base are not supported.
+
+## TokenManager (V1)
+
+Used for tokens created **before** September 5, 2024. Only trading (no create).
+
+| Chain | Address |
+|-------|---------|
+| BSC   | `0xEC4549caDcE5DA21Df6E6422d448034B5233bFbC` |
+
+## TokenManager2 (V2)
+
+Used for tokens created **after** September 5, 2024. Create and trade.
+
+| Chain | Address |
+|-------|---------|
+| BSC   | `0x5c952063c7fc8610FFDB798152D69F0B9550762b` |
+
+## TokenManagerHelper3 (V3)
+
+Use for **getTokenInfo**, **tryBuy**, **trySell**. Supports both V1 and V2 tokens.
+
+| Chain | Address |
+|-------|---------|
+| BSC   | `0xF251F83e40a78868FcfA3FA4599Dad6494E46034` |
+
+## AgentIdentifier (BSC)
+
+Used to check if a wallet is an **Agent wallet** (holds an Agent NFT). See [agent-creator-and-wallets.md](agent-creator-and-wallets.md).
+
+| Chain | Address |
+|-------|---------|
+| BSC   | `0x09B44A633de9F9EBF6FB9Bdd5b5629d3DD2cef13` |
+
+- **Interface**: `isAgent(address wallet)`, `nftCount()`, `nftAt(uint256 index)`.
+
+---
+
+## Usage
+
+1. Call **TokenManagerHelper3.getTokenInfo(token)** to get `version` and `tokenManager`.
+2. If `version === 1` → use TokenManager V1 for buy/sell.
+3. If `version === 2` → use TokenManager2 for buy/sell (and check X Mode / TaxToken / AntiSniperFeeMode if needed).
+4. Token creation is only via **TokenManager2** on BSC after obtaining `createArg` and `signature` from the four.meme API.
+5. **Agent Creator**: Token created by agent wallet — on-chain `(template & (1 << 85)) != 0`; off-chain API `data.aiCreator === true`. Agent wallets: call **AgentIdentifier.isAgent(wallet)** on BSC.

package/skills/four-meme-integration/references/create-token-scripts.md

@@ -1,63 +1,111 @@
-# Create Token Scripts (Four.meme)
-
-## One-shot flow
-
-1. **get-public-config.ts** (optional)  
-   Fetches `raisedToken` from `https://four.meme/meme-api/v1/public/config`. Use when building the create body manually.
-
-2. **create-token-api.ts**  
-   - Env: `PRIVATE_KEY`.  
-   - Args: `imagePath`, `name`, `shortName`, `desc`, `label`.  
-   - Optional env: `WEB_URL`, `TWITTER_URL`, `TELEGRAM_URL`, `PRE_SALE` (default `"0"`), `FEE_PLAN` (default `"false"`).  
-   - Performs: nonce → login (signs `You are sign in Meme {nonce}`) → upload image → GET public config → POST create.  
-   - Output: JSON `{ "createArg": "0x...", "signature": "0x..." }`.
-
-3. **create-token-chain.ts**  
-   - Env: same key for wallet; optional `BSC_RPC_URL`, `CREATION_FEE_WEI` (set if you need to attach extra BNB; default 0).  
-   - Input: `createArg` and `signature` (hex) as args or JSON on stdin (`--`).  
-   - Calls `TokenManager2.createToken(createArg, sign)` on BSC.
-
-## Example (piped)
-
-```bash
-export PRIVATE_KEY=your_hex_private_key
-npx tsx skills/four-meme-integration/scripts/create-token-api.ts ./logo.png MyToken MTK "My desc" AI \
-  | npx tsx skills/four-meme-integration/scripts/create-token-chain.ts --
-```
-
-## Example (two steps)
-
-```bash
-export PRIVATE_KEY=your_hex_private_key
-npx tsx skills/four-meme-integration/scripts/create-token-api.ts ./logo.png MyToken MTK "My desc" AI > create-out.json
-npx tsx skills/four-meme-integration/scripts/create-token-chain.ts "$(jq -r .createArg create-out.json)" "$(jq -r .signature create-out.json)"
-```
-
-## Tax token
-
-Pass a JSON file path as the last argument; the file must contain `tokenTaxInfo`. Example:
-
-**tax-options.json**:
-```json
-{
-  "tokenTaxInfo": {
-    "feeRate": 5,
-    "burnRate": 20,
-    "divideRate": 30,
-    "liquidityRate": 40,
-    "recipientRate": 10,
-    "recipientAddress": "0x1234567890123456789012345678901234567890",
-    "minSharing": 100000
-  }
-}
-```
-
-Requirements: `feeRate` must be 1, 3, 5, or 10; `burnRate + divideRate + liquidityRate + recipientRate = 100`. See [token-tax-info.md](token-tax-info.md).
-
-```bash
-npx tsx .../create-token-api.ts ./logo.png TaxToken TAX "Tax token" AI tax-options.json
-```
-
-You can also use env vars: `TAX_TOKEN=1`, `TAX_FEE_RATE=5`, `TAX_BURN_RATE=20`, `TAX_DIVIDE_RATE=30`, `TAX_LIQUIDITY_RATE=40`, `TAX_RECIPIENT_RATE=10`, `TAX_RECIPIENT_ADDRESS=0x...`, `TAX_MIN_SHARING=100000`.
-
-Chain and Labels: see [SKILL.md](../SKILL.md) or [api-create-token.md](api-create-token.md).
+# Create Token Scripts (Four.meme)
+
+## One-shot (create-token-instant)
+
+**create-token-instant.ts** runs API create + on-chain submit in one command. Same args as create-token-api; on success submits createToken and outputs `txHash`.
+
+```bash
+# Same as create-token-api, all --key=value
+npx tsx .../create-token-instant.ts --image=./logo.png --name=MyToken --short-name=MTK --desc="My desc" --label=AI
+# Or via CLI
+fourmeme create-instant --image=./logo.png --name=MyToken --short-name=MTK --desc="My desc" --label=AI
+```
+
+Optional `--value=wei` overrides the value; otherwise API output `creationFeeWei` is used. Env: `PRIVATE_KEY`, optional `BSC_RPC_URL`.
+
+---
+
+## Step-by-step flow
+
+1. **get-public-config.ts** (optional)  
+   Fetches `raisedToken` from `https://four.meme/meme-api/v1/public/config`. Use when building the create body manually.
+
+2. **create-token-api.ts**  
+   - All options as `--key=value`; no positionals.  
+   - Required: `--image=`, `--name=`, `--short-name=`, `--desc=`, `--label=`.  
+   - Optional: `--web-url=`, `--twitter-url=`, `--telegram-url=` (only sent when non-empty); `--pre-sale=0` (**presale in ether units**, e.g. `0.001` for 0.001 BNB, not wei); `--fee-plan=false`, `--tax-options=<path>`.  
+   - Tax token: `--tax-options=tax.json` or `--tax-token` with `--tax-fee-rate=5` etc. (burn+divide+liquidity+recipient=100).  
+   - Env: `PRIVATE_KEY`; RPC via `BSC_RPC_URL`.  
+   - Flow: nonce → login → upload image → GET public config → POST create.  
+   - Output: JSON `{ "createArg", "signature", "creationFeeWei" }`; script hints required value for chain step.
+
+3. **create-token-chain.ts**  
+   - Env: `PRIVATE_KEY`.  
+   - Input: `createArg`, `signature` (positional or stdin JSON with `--`).  
+   - Optional (CLI overrides env): `--value=<wei>` (env `CREATION_FEE_WEI`). RPC via env `BSC_RPC_URL`.  
+   - Calls `TokenManager2.createToken(createArg, sign)`; excess BNB is refunded by the contract.
+
+## createToken value (CREATION_FEE_WEI) formula
+
+**Formula**
+
+- **No presale (or quote is ERC20)**  
+  `value = launch_fee`  
+  `launch_fee`: read from TokenManager2 `_launchFee()` (wei).
+
+- **With presale and quote is BNB**  
+  `value = launch_fee + presale_wei + trading_fee`  
+  - `presale_wei`: presale amount in wei (API sends preSale in BNB/ether; script converts to wei for value).  
+  - `trading_fee`: see below.
+
+**How to compute trading_fee**
+
+- Contract uses basis-point rate: `trading_fee = presale_wei × fee_rate / 10000` (integer division).  
+- `fee_rate` from TokenManager2 `_tradingFeeRate()` (basis points).  
+- If the contract enforces a minimum fee per trade, use `max(computed trading_fee, minimum_fee)`.
+
+## Example (piped)
+
+```bash
+export PRIVATE_KEY=your_hex_private_key
+npx tsx skills/four-meme-integration/scripts/create-token-api.ts --image=./logo.png --name=MyToken --short-name=MTK --desc="My desc" --label=AI \
+  | npx tsx skills/four-meme-integration/scripts/create-token-chain.ts --
+```
+
+The chain script reads `creationFeeWei` from stdin JSON when present; you can also pass `--value=<wei>` explicitly.
+
+## Example (two steps)
+
+```bash
+export PRIVATE_KEY=your_hex_private_key
+npx tsx skills/four-meme-integration/scripts/create-token-api.ts --image=./logo.png --name=MyToken --short-name=MTK --desc="My desc" --label=AI > create-out.json
+npx tsx skills/four-meme-integration/scripts/create-token-chain.ts "$(jq -r .createArg create-out.json)" "$(jq -r .signature create-out.json)" --value=$(jq -r .creationFeeWei create-out.json)
+```
+
+## Example (with presale)
+
+`--pre-sale` is in **ether units** (e.g. `0.001` = 0.001 BNB; do not pass wei).
+
+```bash
+npx tsx .../create-token-api.ts --image=./logo.png --name=MyToken --short-name=MTK --desc="My desc" --label=AI --pre-sale=0.01
+```
+
+## Tax token
+
+Tax options file must contain `tokenTaxInfo`. Example **tax-options.json**:
+
+```json
+{
+  "tokenTaxInfo": {
+    "feeRate": 5,
+    "burnRate": 20,
+    "divideRate": 30,
+    "liquidityRate": 40,
+    "recipientRate": 10,
+    "recipientAddress": "0x1234567890123456789012345678901234567890",
+    "minSharing": 100000
+  }
+}
+```
+
+`feeRate` must be 1, 3, 5, or 10; burn+divide+liquidity+recipient=100. See [token-tax-info.md](token-tax-info.md).
+
+```bash
+# Option A: --tax-options= path to JSON file
+npx tsx .../create-token-api.ts --image=./logo.png --name=TaxToken --short-name=TAX --desc="Tax token" --label=AI --tax-options=tax-options.json
+
+# Option B: --tax-token with rate args
+npx tsx .../create-token-api.ts --image=./logo.png --name=TaxToken --short-name=TAX --desc="Tax token" --label=AI --tax-token --tax-fee-rate=5 --tax-burn-rate=20 --tax-divide-rate=30 --tax-liquidity-rate=40 --tax-recipient-rate=10 --tax-recipient-address=0x... --tax-min-sharing=100000
+```
+
+Chain and Labels: see [SKILL.md](../SKILL.md) or [api-create-token.md](api-create-token.md).

package/skills/four-meme-integration/references/errors.md

@@ -1,27 +1,29 @@
-# Four.meme Error Codes
-
-## buyToken
-
-| Code       | Meaning |
-|-----------|---------|
-| GW (GWEI) | Amount precision not aligned to GWEI |
-| ZA        | Zero Address – `to` must not be address(0) |
-| TO        | Invalid to – `to` must not be PancakePair address |
-| Slippage  | Spent amount > maxFunds |
-| More BNB  | Insufficient BNB in msg.value |
-| A         | X Mode token bought with wrong method – use X Mode buy |
-
-## sellToken
-
-| Code      | Meaning |
-|----------|---------|
-| GW (GWEI)| Amount precision not aligned to GWEI |
-| FR (FeeRate) | Fee rate > 5% |
-| SO (Small Order) | Order amount too small |
-| Slippage | Received amount < minFunds |
-
-## Identification
-
-- **X Mode (exclusive)**: Off-chain – API token info `version === "V8"`. On-chain – `TokenManager2._tokenInfos[token].template & 0x10000 > 0`.
-- **TaxToken**: Off-chain – API response has `taxInfo`. On-chain – `(template >> 10) & 0x3F === 5`.
-- **AntiSniperFeeMode**: Off-chain – API `feePlan === true`. On-chain – `TokenManager2._tokenInfoEx1s[token].feeSetting > 0`.
+# Four.meme Error Codes
+
+## buyToken
+
+| Code       | Meaning |
+|-----------|---------|
+| GW (GWEI) | Amount precision not aligned to GWEI |
+| ZA        | Zero Address – `to` must not be address(0) |
+| TO        | Invalid to – `to` must not be PancakePair address |
+| Slippage  | Spent amount > maxFunds |
+| More BNB  | Insufficient BNB in msg.value |
+| A         | X Mode token bought with wrong method – use X Mode buy |
+
+## sellToken
+
+| Code      | Meaning |
+|----------|---------|
+| GW (GWEI)| Amount precision not aligned to GWEI |
+| FR (FeeRate) | Fee rate > 5% |
+| SO (Small Order) | Order amount too small |
+| Slippage | Received amount < minFunds |
+
+## Identification
+
+- **X Mode (exclusive)**: Off-chain – API token info `version === "V8"`. On-chain – `TokenManager2._tokenInfos[token].template & 0x10000 > 0`.
+- **TaxToken**: Off-chain – API response has `taxInfo`. On-chain – `(template >> 10) & 0x3F === 5`.
+- **AntiSniperFeeMode**: Off-chain – API `feePlan === true`. On-chain – `TokenManager2._tokenInfoEx1s[token].feeSetting > 0`.
+- **Token created by Agent Creator**: Off-chain – API `data.aiCreator === true`. On-chain – `(TokenManager2._tokenInfos[token].template & (1 << 85)) != 0`. Does not change trading behavior.
+- **Agent wallets**: Call **AgentIdentifier.isAgent(wallet)** on BSC; see [agent-creator-and-wallets.md](agent-creator-and-wallets.md) and [contract-addresses.md](contract-addresses.md).

package/skills/four-meme-integration/references/event-listening.md

@@ -1,75 +1,75 @@
-# Event listening (TokenManager2, V2 only)
-
-Only **TokenManager2 (V2)** is supported. V1 is not supported. Contract address (BSC): `0x5c952063c7fc8610FFDB798152D69F0B9550762b`.
-
-The agent can react to **token creation, buy/sell, and liquidity add** by listening to the events below (e.g. copy-trading).
-
-## Event list
-
-| Event           | Meaning           | Main args                                                                 |
-|-----------------|-------------------|---------------------------------------------------------------------------|
-| **TokenCreate** | New token created | `creator`, `token`, `requestId`, `name`, `symbol`, `totalSupply`, `launchTime`, `launchFee` |
-| **TokenPurchase** | Buy             | `token`, `account`, `price`, `amount`, `cost`, `fee`, `offers`, `funds`   |
-| **TokenSale**   | Sell              | `token`, `account`, `price`, `amount`, `cost`, `fee`, `offers`, `funds`   |
-| **LiquidityAdded** | Liquidity added | `base`, `offers`, `quote`, `funds`                                        |
-
-- **TokenCreate**: With `token` (new token address) and `requestId`, you can call Helper3 `getTokenInfo(token)` or execute buy/sell immediately.
-- **TokenPurchase / TokenSale**: Use for copy-trading, stats, etc.; `token` is the token address, `account` is the buyer/seller.
-- **LiquidityAdded**: `base` is the token address; the token has been added to the pool and can be traded on the DEX.
-
-## How to listen (viem)
-
-### Option 1: Poll historical blocks with `getLogs`
-
-```typescript
-import { createPublicClient, http, parseAbiItem } from 'viem';
-import { bsc } from 'viem/chains';
-
-const TOKEN_MANAGER2 = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
-
-const client = createPublicClient({
-  chain: bsc,
-  transport: http(process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org'),
-});
-
-const logs = await client.getLogs({
-  address: TOKEN_MANAGER2,
-  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)'),
-  ],
-  fromBlock: fromBlockNumber,
-  toBlock: toBlockNumber,
-});
-```
-
-### Option 2: Real-time subscription with `watchContractEvent`
-
-```typescript
-import { createPublicClient, http, parseAbiItem } from 'viem';
-import { bsc } from 'viem/chains';
-
-const client = createPublicClient({ chain: bsc, transport: http(rpcUrl) });
-
-const unwatch = client.watchContractEvent({
-  address: TOKEN_MANAGER2,
-  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)'),
-  ],
-  onLogs: (logs) => {
-    for (const log of logs) {
-      console.log(log.eventName, log.args);
-    }
-  },
-});
-// To stop: unwatch()
-```
-
-## Script
-
-Use `fourmeme events <fromBlock> [toBlock]` (script `get-recent-events.ts`) to fetch the four event types in a block range and output JSON. See the events section in [SKILL.md](../SKILL.md).
+# Event listening (TokenManager2, V2 only)
+
+Only **TokenManager2 (V2)** is supported. V1 is not supported. Contract address (BSC): `0x5c952063c7fc8610FFDB798152D69F0B9550762b`.
+
+The agent can react to **token creation, buy/sell, and liquidity add** by listening to the events below (e.g. copy-trading).
+
+## Event list
+
+| Event           | Meaning           | Main args                                                                 |
+|-----------------|-------------------|---------------------------------------------------------------------------|
+| **TokenCreate** | New token created | `creator`, `token`, `requestId`, `name`, `symbol`, `totalSupply`, `launchTime`, `launchFee` |
+| **TokenPurchase** | Buy             | `token`, `account`, `price`, `amount`, `cost`, `fee`, `offers`, `funds`   |
+| **TokenSale**   | Sell              | `token`, `account`, `price`, `amount`, `cost`, `fee`, `offers`, `funds`   |
+| **LiquidityAdded** | Liquidity added | `base`, `offers`, `quote`, `funds`                                        |
+
+- **TokenCreate**: With `token` (new token address) and `requestId`, you can call Helper3 `getTokenInfo(token)` or execute buy/sell immediately.
+- **TokenPurchase / TokenSale**: Use for copy-trading, stats, etc.; `token` is the token address, `account` is the buyer/seller.
+- **LiquidityAdded**: `base` is the token address; the token has been added to the pool and can be traded on the DEX.
+
+## How to listen (viem)
+
+### Option 1: Poll historical blocks with `getLogs`
+
+```typescript
+import { createPublicClient, http, parseAbiItem } from 'viem';
+import { bsc } from 'viem/chains';
+
+const TOKEN_MANAGER2 = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
+
+const client = createPublicClient({
+  chain: bsc,
+  transport: http(process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org'),
+});
+
+const logs = await client.getLogs({
+  address: TOKEN_MANAGER2,
+  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)'),
+  ],
+  fromBlock: fromBlockNumber,
+  toBlock: toBlockNumber,
+});
+```
+
+### Option 2: Real-time subscription with `watchContractEvent`
+
+```typescript
+import { createPublicClient, http, parseAbiItem } from 'viem';
+import { bsc } from 'viem/chains';
+
+const client = createPublicClient({ chain: bsc, transport: http(rpcUrl) });
+
+const unwatch = client.watchContractEvent({
+  address: TOKEN_MANAGER2,
+  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)'),
+  ],
+  onLogs: (logs) => {
+    for (const log of logs) {
+      console.log(log.eventName, log.args);
+    }
+  },
+});
+// To stop: unwatch()
+```
+
+## Script
+
+Use `fourmeme events <fromBlock> [toBlock]` (script `get-recent-events.ts`) to fetch the four event types in a block range and output JSON. See the events section in [SKILL.md](../SKILL.md).

package/skills/four-meme-integration/references/execute-trade.md

@@ -1,31 +1,31 @@
-# Execute Buy / Sell (Four.meme BSC)
-
-Executes buy/sell (sends on-chain transactions). Requires `PRIVATE_KEY`. Only **TokenManager2 (V2)** tokens are supported.
-
-## Buy
-
-- **By amount**: `buyToken(token, amount, maxFunds)`  
-  CLI: `fourmeme buy <token> amount <amountWei> <maxFundsWei>`  
-  Meaning: Spend at most `maxFundsWei` of quote (BNB or BEP20) to buy `amountWei` tokens.
-
-- **By funds**: `buyTokenAMAP(token, funds, minAmount)`  
-  CLI: `fourmeme buy <token> funds <fundsWei> <minAmountWei>`  
-  Meaning: Spend `fundsWei` of quote and receive at least `minAmountWei` tokens.
-
-If quote is BEP20 (not BNB), the script will `approve` TokenManager2 first, then send the buy transaction.
-
-## Sell
-
-- Contract requirement: First `approve(tokenManager, amount)` on TokenManager2, then call `sellToken(token, amount)` or `sellToken(origin, token, amount, minFunds)` for slippage protection.
-- The CLI runs approve then sell automatically; no need to do both manually.
-
-```bash
-fourmeme sell <tokenAddress> <amountWei> [minFundsWei]
-```
-
-- `minFundsWei` is optional: minimum quote to receive (slippage protection).
-
-## Relation to quote commands
-
-- `quote-buy` / `quote-sell`: Read-only estimates; no transaction is sent.
-- `buy` / `sell`: Actually send transactions. Recommended: use `quote-buy` / `quote-sell` first to get estimates, then choose `maxFundsWei`, `minAmountWei`, `minFundsWei` and call `buy` / `sell`.
+# Execute Buy / Sell (Four.meme BSC)
+
+Executes buy/sell (sends on-chain transactions). Requires `PRIVATE_KEY`. Only **TokenManager2 (V2)** tokens are supported.
+
+## Buy
+
+- **By amount**: `buyToken(token, amount, maxFunds)`  
+  CLI: `fourmeme buy <token> amount <amountWei> <maxFundsWei>`  
+  Meaning: Spend at most `maxFundsWei` of quote (BNB or BEP20) to buy `amountWei` tokens.
+
+- **By funds**: `buyTokenAMAP(token, funds, minAmount)`  
+  CLI: `fourmeme buy <token> funds <fundsWei> <minAmountWei>`  
+  Meaning: Spend `fundsWei` of quote and receive at least `minAmountWei` tokens.
+
+If quote is BEP20 (not BNB), the script will `approve` TokenManager2 first, then send the buy transaction.
+
+## Sell
+
+- Contract requirement: First `approve(tokenManager, amount)` on TokenManager2, then call `sellToken(token, amount)` or `sellToken(origin, token, amount, minFunds)` for slippage protection.
+- The CLI runs approve then sell automatically; no need to do both manually.
+
+```bash
+fourmeme sell <tokenAddress> <amountWei> [minFundsWei]
+```
+
+- `minFundsWei` is optional: minimum quote to receive (slippage protection).
+
+## Relation to quote commands
+
+- `quote-buy` / `quote-sell`: Read-only estimates; no transaction is sent.
+- `buy` / `sell`: Actually send transactions. Recommended: use `quote-buy` / `quote-sell` first to get estimates, then choose `maxFundsWei`, `minAmountWei`, `minFundsWei` and call `buy` / `sell`.

package/skills/four-meme-integration/references/tax-token-query.md

@@ -1,38 +1,38 @@
-# Query Tax Token fee/tax info
-
-Only for **TaxToken** (creatorType 5). The token contract address is the TaxToken contract; call view functions on that address.
-
-## On-chain view functions (TaxToken.abi)
-
-| Function / variable | Description | Unit / meaning |
-|---------------------|-------------|----------------|
-| **feeRate** | Trading fee rate | Basis points; 10000 = 100%, e.g. 500 = 5% |
-| **rateFounder** | Founder allocation share | Percent; 100 = 100%, e.g. 10 = 10% |
-| **rateHolder** | Holder dividend share | Same |
-| **rateBurn** | Burn share | Same |
-| **rateLiquidity** | Liquidity add share | Same; rateFounder + rateHolder + rateBurn + rateLiquidity = 100 |
-| **minDispatch** | Cumulative fee threshold to trigger distribution | Token units |
-| **minShare** | Min balance to participate in dividends | Token units (ether); below this, no dividend |
-| **quote** | Quote token address | 0 = BNB/ETH |
-| **founder** | Founder address | Receives founder allocation |
-
-See also **claimableFee(account)**, **claimedFee(account)**, **userInfo(account)** for claimable/claimed fees and user info in the [official API/Contract docs](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (e.g. API-Contract-TaxToken).
-
-## Script
-
-```bash
-npx fourmeme tax-info <tokenAddress>
-```
-
-Or run: `npx tsx .../get-tax-token-info.ts <tokenAddress>`. BSC only.
-
-Example output (JSON): `feeRateBps`, `feeRatePercent`, `rateFounder`, `rateHolder`, `rateBurn`, `rateLiquidity`, `minDispatch`, `minShare`, `quote`, `founder`.
-
-## How to identify a TaxToken
-
-- **Off-chain**: Call four.meme API `GET /v1/private/token/get?address=<token>`; if response `data` contains `taxInfo`, it is a TaxToken.
-- **On-chain**: In TokenManager2, `(template >> 10) & 0x3F === 5` means TaxToken. Or run `get-tax-token-info`; if it succeeds and e.g. `feeRateBps > 0`, treat as TaxToken.
-
-## References
-
-- [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) – API documents (API-Contract-TaxToken, etc.) and ABIs (TaxToken.abi)
+# Query Tax Token fee/tax info
+
+Only for **TaxToken** (creatorType 5). The token contract address is the TaxToken contract; call view functions on that address.
+
+## On-chain view functions (TaxToken.abi)
+
+| Function / variable | Description | Unit / meaning |
+|---------------------|-------------|----------------|
+| **feeRate** | Trading fee rate | Basis points; 10000 = 100%, e.g. 500 = 5% |
+| **rateFounder** | Founder allocation share | Percent; 100 = 100%, e.g. 10 = 10% |
+| **rateHolder** | Holder dividend share | Same |
+| **rateBurn** | Burn share | Same |
+| **rateLiquidity** | Liquidity add share | Same; rateFounder + rateHolder + rateBurn + rateLiquidity = 100 |
+| **minDispatch** | Cumulative fee threshold to trigger distribution | Token units |
+| **minShare** | Min balance to participate in dividends | Token units (ether); below this, no dividend |
+| **quote** | Quote token address | 0 = BNB/ETH |
+| **founder** | Founder address | Receives founder allocation |
+
+See also **claimableFee(account)**, **claimedFee(account)**, **userInfo(account)** for claimable/claimed fees and user info in the [official API/Contract docs](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (e.g. API-Contract-TaxToken).
+
+## Script
+
+```bash
+npx fourmeme tax-info <tokenAddress>
+```
+
+Or run: `npx tsx .../get-tax-token-info.ts <tokenAddress>`. BSC only.
+
+Example output (JSON): `feeRateBps`, `feeRatePercent`, `rateFounder`, `rateHolder`, `rateBurn`, `rateLiquidity`, `minDispatch`, `minShare`, `quote`, `founder`.
+
+## How to identify a TaxToken
+
+- **Off-chain**: Call four.meme API `GET /v1/private/token/get?address=<token>`; if response `data` contains `taxInfo`, it is a TaxToken.
+- **On-chain**: In TokenManager2, `(template >> 10) & 0x3F === 5` means TaxToken. Or run `get-tax-token-info`; if it succeeds and e.g. `feeRateBps > 0`, treat as TaxToken.
+
+## References
+
+- [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) – API documents (API-Contract-TaxToken, etc.) and ABIs (TaxToken.abi)