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

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

@@ -1,77 +1,77 @@
-# Tax Token parameters (tokenTaxInfo)
-
-When creating a **Tax-type token**, send a `tokenTaxInfo` object in the create request body. If omitted, a normal token is created. Agent interaction (whether to create a tax token, parameter order) is in [SKILL.md](../SKILL.md) “Create token (full flow)”. This page only lists fields and constraints.
-
-## Field summary
-
-| Parameter | Type | Description | Allowed values / constraint |
-|-----------|------|-------------|------------------------------|
-| **feeRate** | number | Trading fee rate (%) | **Exactly one of**: `1`, `3`, `5`, `10` |
-| **burnRate** | number | Burn share (%) | Custom; see constraints below |
-| **divideRate** | number | Dividend share (%) | Custom; see below |
-| **liquidityRate** | number | Liquidity share (%) | Custom; see below |
-| **recipientRate** | number | Recipient share (%) | Custom; use `0` if not used |
-| **recipientAddress** | string | Address that receives allocation | Use `""` if not used |
-| **minSharing** | number | Min balance for dividends (ether units) | Must satisfy `d × 10ⁿ`, n≥5, 1≤d≤9 |
-
-## Constraints
-
-1. **feeRate** must be one of **1, 3, 5, 10** (1%, 3%, 5%, 10%).
-2. **burnRate + divideRate + liquidityRate + recipientRate = 100** (the four shares must sum to 100).
-3. If no recipient: **recipientAddress = ""** and **recipientRate = 0**.
-4. **minSharing** examples: `100000` (1×10⁵), `200000`, `500000`, `1000000` (1×10⁶), `9000000`, `10000000` (1×10⁷), i.e. `d × 10ⁿ` with n≥5, 1≤d≤9.
-
-## Examples
-
-**Example 1: 5% fee, 20% burn, 30% dividend, 40% liquidity, 10% recipient**
-
-```json
-{
-  "tokenTaxInfo": {
-    "feeRate": 5,
-    "burnRate": 20,
-    "divideRate": 30,
-    "liquidityRate": 40,
-    "recipientRate": 10,
-    "recipientAddress": "0x1234567890123456789012345678901234567890",
-    "minSharing": 100000
-  }
-}
-```
-
-**Example 2: 3% fee, 100% liquidity, no dividend/burn/recipient**
-
-```json
-{
-  "tokenTaxInfo": {
-    "feeRate": 3,
-    "burnRate": 0,
-    "divideRate": 0,
-    "liquidityRate": 100,
-    "recipientRate": 0,
-    "recipientAddress": "",
-    "minSharing": 100000
-  }
-}
-```
-
-**Example 3: 10% fee, 50% dividend, 50% burn, min share 1×10⁶**
-
-```json
-{
-  "tokenTaxInfo": {
-    "feeRate": 10,
-    "burnRate": 50,
-    "divideRate": 50,
-    "liquidityRate": 0,
-    "recipientRate": 0,
-    "recipientAddress": "",
-    "minSharing": 1000000
-  }
-}
-```
-
-## Use in scripts
-
-- **Option 1 (recommended)**: Write the above `tokenTaxInfo` to a JSON file (can contain only `tokenTaxInfo`) and pass that file path as the last argument to `create-token-api.ts`; the script merges it into the create body.
-- **Option 2**: Build tax params via env vars (see “Create token (API)” optional env in SKILL.md).
+# Tax Token parameters (tokenTaxInfo)
+
+When creating a **Tax-type token**, send a `tokenTaxInfo` object in the create request body. If omitted, a normal token is created. Agent interaction (whether to create a tax token, parameter order) is in [SKILL.md](../SKILL.md) “Create token (full flow)”. This page only lists fields and constraints.
+
+## Field summary
+
+| Parameter | Type | Description | Allowed values / constraint |
+|-----------|------|-------------|------------------------------|
+| **feeRate** | number | Trading fee rate (%) | **Exactly one of**: `1`, `3`, `5`, `10` |
+| **burnRate** | number | Burn share (%) | Custom; see constraints below |
+| **divideRate** | number | Dividend share (%) | Custom; see below |
+| **liquidityRate** | number | Liquidity share (%) | Custom; see below |
+| **recipientRate** | number | Recipient share (%) | Custom; use `0` if not used |
+| **recipientAddress** | string | Address that receives allocation | Use `""` if not used |
+| **minSharing** | number | Min balance for dividends (ether units) | Must satisfy `d × 10ⁿ`, n≥5, 1≤d≤9 |
+
+## Constraints
+
+1. **feeRate** must be one of **1, 3, 5, 10** (1%, 3%, 5%, 10%).
+2. **burnRate + divideRate + liquidityRate + recipientRate = 100** (the four shares must sum to 100).
+3. If no recipient: **recipientAddress = ""** and **recipientRate = 0**.
+4. **minSharing** examples: `100000` (1×10⁵), `200000`, `500000`, `1000000` (1×10⁶), `9000000`, `10000000` (1×10⁷), i.e. `d × 10ⁿ` with n≥5, 1≤d≤9.
+
+## Examples
+
+**Example 1: 5% fee, 20% burn, 30% dividend, 40% liquidity, 10% recipient**
+
+```json
+{
+  "tokenTaxInfo": {
+    "feeRate": 5,
+    "burnRate": 20,
+    "divideRate": 30,
+    "liquidityRate": 40,
+    "recipientRate": 10,
+    "recipientAddress": "0x1234567890123456789012345678901234567890",
+    "minSharing": 100000
+  }
+}
+```
+
+**Example 2: 3% fee, 100% liquidity, no dividend/burn/recipient**
+
+```json
+{
+  "tokenTaxInfo": {
+    "feeRate": 3,
+    "burnRate": 0,
+    "divideRate": 0,
+    "liquidityRate": 100,
+    "recipientRate": 0,
+    "recipientAddress": "",
+    "minSharing": 100000
+  }
+}
+```
+
+**Example 3: 10% fee, 50% dividend, 50% burn, min share 1×10⁶**
+
+```json
+{
+  "tokenTaxInfo": {
+    "feeRate": 10,
+    "burnRate": 50,
+    "divideRate": 50,
+    "liquidityRate": 0,
+    "recipientRate": 0,
+    "recipientAddress": "",
+    "minSharing": 1000000
+  }
+}
+```
+
+## Use in scripts
+
+- **Option 1 (recommended)**: Write the above `tokenTaxInfo` to a JSON file (can contain only `tokenTaxInfo`) and pass that file path as the last argument to `create-token-api.ts`; the script merges it into the create body.
+- **Option 2**: Build tax params via env vars (see “Create token (API)” optional env in SKILL.md).

package/skills/four-meme-integration/scripts/8004-balance.ts

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-/**
- * EIP-8004 NFT – query balance (number of identity NFTs owned by address).
- *
- * Usage:
- *   npx tsx 8004-balance.ts <ownerAddress>
- *
- * Optional env: BSC_RPC_URL, 8004_NFT_ADDRESS.
- * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
- */
-
-import { createPublicClient, http, parseAbi } from 'viem';
-import { bsc } from 'viem/chains';
-
-const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
-
-const ABI = parseAbi(['function balanceOf(address owner) view returns (uint256)']);
-
-function isAddress(s: string): boolean {
-  return /^0x[0-9a-fA-F]{40}$/.test(s);
-}
-
-async function main() {
-  const ownerAddress = process.argv[2];
-  if (!ownerAddress || !isAddress(ownerAddress)) {
-    console.error('Usage: 8004-balance.ts <ownerAddress>');
-    console.error('  ownerAddress: 0x... wallet address');
-    process.exit(1);
-  }
-
-  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
-  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
-
-  const client = createPublicClient({
-    chain: bsc,
-    transport: http(rpcUrl),
-  });
-
-  const balance = await client.readContract({
-    address: contractAddress,
-    abi: ABI,
-    functionName: 'balanceOf',
-    args: [ownerAddress as `0x${string}`],
-  });
-
-  console.log(JSON.stringify({ owner: ownerAddress, balance: Number(balance) }, null, 2));
-}
-
-main().catch((e) => {
-  console.error(e.message || e);
-  process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * EIP-8004 NFT – query balance (number of identity NFTs owned by address).
+ *
+ * Usage:
+ *   npx tsx 8004-balance.ts <ownerAddress>
+ *
+ * Optional env: BSC_RPC_URL, 8004_NFT_ADDRESS.
+ * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
+ */
+
+import { createPublicClient, http, parseAbi } from 'viem';
+import { bsc } from 'viem/chains';
+
+const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
+
+const ABI = parseAbi(['function balanceOf(address owner) view returns (uint256)']);
+
+function isAddress(s: string): boolean {
+  return /^0x[0-9a-fA-F]{40}$/.test(s);
+}
+
+async function main() {
+  const ownerAddress = process.argv[2];
+  if (!ownerAddress || !isAddress(ownerAddress)) {
+    console.error('Usage: 8004-balance.ts <ownerAddress>');
+    console.error('  ownerAddress: 0x... wallet address');
+    process.exit(1);
+  }
+
+  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
+  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+
+  const client = createPublicClient({
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+
+  const balance = await client.readContract({
+    address: contractAddress,
+    abi: ABI,
+    functionName: 'balanceOf',
+    args: [ownerAddress as `0x${string}`],
+  });
+
+  console.log(JSON.stringify({ owner: ownerAddress, balance: Number(balance) }, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});

package/skills/four-meme-integration/scripts/8004-register.ts

@@ -1,108 +1,108 @@
-#!/usr/bin/env node
-/**
- * EIP-8004 NFT – register agent (mint identity NFT).
- * Builds agentURI as data:application/json;base64,<payload> and calls contract.register(agentURI).
- *
- * Usage:
- *   npx tsx 8004-register.ts <name> [imageUrl] [description]
- *   - name: required
- *   - imageUrl: optional (URL string)
- *   - description: optional
- *
- * Env: PRIVATE_KEY. Optional: BSC_RPC_URL, 8004_NFT_ADDRESS.
- * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
- */
-
-import { createPublicClient, createWalletClient, decodeEventLog, http, parseAbi } from 'viem';
-import { privateKeyToAccount } from 'viem/accounts';
-import { bsc } from 'viem/chains';
-
-const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
-
-const REGISTRATION_TYPE = 'https://eips.ethereum.org/EIPS/eip-8004#registration-v1';
-
-const ABI = parseAbi([
-  'function register(string agentURI) returns (uint256 agentId)',
-  'event Registered(uint256 indexed agentId, string agentURI, address indexed owner)',
-]);
-
-function buildAgentURI(name: string, imageUrl: string, description: string): string {
-  const payload = {
-    type: REGISTRATION_TYPE,
-    name: name || '',
-    description: description || 'I\'m four.meme trading agent',
-    image: imageUrl || '',
-    active: true,
-    supportedTrust: [''],
-  };
-  const json = JSON.stringify(payload);
-  const base64 = Buffer.from(json, 'utf8').toString('base64');
-  return `data:application/json;base64,${base64}`;
-}
-
-async function main() {
-  const privateKey = process.env.PRIVATE_KEY;
-  if (!privateKey) {
-    console.error('Set PRIVATE_KEY');
-    process.exit(1);
-  }
-  const pk = privateKey.startsWith('0x') ? (privateKey as `0x${string}`) : (`0x${privateKey}` as `0x${string}`);
-  const account = privateKeyToAccount(pk);
-
-  const name = process.argv[2];
-  const imageUrl = process.argv[3] ?? '';
-  const description = process.argv[4] ?? '';
-
-  if (!name || name.trim() === '') {
-    console.error('Usage: 8004-register.ts <name> [imageUrl] [description]');
-    console.error('  name: required. imageUrl and description are optional.');
-    process.exit(1);
-  }
-
-  const agentURI = buildAgentURI(name.trim(), imageUrl.trim(), description.trim());
-  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
-  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
-
-  const wallet = createWalletClient({
-    account,
-    chain: bsc,
-    transport: http(rpcUrl),
-  });
-  const publicClient = createPublicClient({
-    chain: bsc,
-    transport: http(rpcUrl),
-  });
-
-  const txHash = await wallet.writeContract({
-    address: contractAddress,
-    abi: ABI,
-    functionName: 'register',
-    args: [agentURI],
-  });
-
-  const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
-  let agentId: number | null = null;
-  for (const l of receipt.logs) {
-    if (l.address.toLowerCase() !== contractAddress.toLowerCase()) continue;
-    try {
-      const d = decodeEventLog({
-        abi: ABI,
-        data: l.data,
-        topics: l.topics,
-      });
-      if (d.eventName === 'Registered') {
-        agentId = Number((d.args as { agentId: bigint }).agentId);
-        break;
-      }
-    } catch {
-      /* ignore */
-    }
-  }
-
-  console.log(JSON.stringify({ txHash, agentId, agentURI }, null, 2));
-}
-
-main().catch((e) => {
-  console.error(e.message || e);
-  process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * EIP-8004 NFT – register agent (mint identity NFT).
+ * Builds agentURI as data:application/json;base64,<payload> and calls contract.register(agentURI).
+ *
+ * Usage:
+ *   npx tsx 8004-register.ts <name> [imageUrl] [description]
+ *   - name: required
+ *   - imageUrl: optional (URL string)
+ *   - description: optional
+ *
+ * Env: PRIVATE_KEY. Optional: BSC_RPC_URL, 8004_NFT_ADDRESS.
+ * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
+ */
+
+import { createPublicClient, createWalletClient, decodeEventLog, http, parseAbi } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { bsc } from 'viem/chains';
+
+const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
+
+const REGISTRATION_TYPE = 'https://eips.ethereum.org/EIPS/eip-8004#registration-v1';
+
+const ABI = parseAbi([
+  'function register(string agentURI) returns (uint256 agentId)',
+  'event Registered(uint256 indexed agentId, string agentURI, address indexed owner)',
+]);
+
+function buildAgentURI(name: string, imageUrl: string, description: string): string {
+  const payload = {
+    type: REGISTRATION_TYPE,
+    name: name || '',
+    description: description || 'I\'m four.meme trading agent',
+    image: imageUrl || '',
+    active: true,
+    supportedTrust: [''],
+  };
+  const json = JSON.stringify(payload);
+  const base64 = Buffer.from(json, 'utf8').toString('base64');
+  return `data:application/json;base64,${base64}`;
+}
+
+async function main() {
+  const privateKey = process.env.PRIVATE_KEY;
+  if (!privateKey) {
+    console.error('Set PRIVATE_KEY');
+    process.exit(1);
+  }
+  const pk = privateKey.startsWith('0x') ? (privateKey as `0x${string}`) : (`0x${privateKey}` as `0x${string}`);
+  const account = privateKeyToAccount(pk);
+
+  const name = process.argv[2];
+  const imageUrl = process.argv[3] ?? '';
+  const description = process.argv[4] ?? '';
+
+  if (!name || name.trim() === '') {
+    console.error('Usage: 8004-register.ts <name> [imageUrl] [description]');
+    console.error('  name: required. imageUrl and description are optional.');
+    process.exit(1);
+  }
+
+  const agentURI = buildAgentURI(name.trim(), imageUrl.trim(), description.trim());
+  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
+  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+
+  const wallet = createWalletClient({
+    account,
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+  const publicClient = createPublicClient({
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+
+  const txHash = await wallet.writeContract({
+    address: contractAddress,
+    abi: ABI,
+    functionName: 'register',
+    args: [agentURI],
+  });
+
+  const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+  let agentId: number | null = null;
+  for (const l of receipt.logs) {
+    if (l.address.toLowerCase() !== contractAddress.toLowerCase()) continue;
+    try {
+      const d = decodeEventLog({
+        abi: ABI,
+        data: l.data,
+        topics: l.topics,
+      });
+      if (d.eventName === 'Registered') {
+        agentId = Number((d.args as { agentId: bigint }).agentId);
+        break;
+      }
+    } catch {
+      /* ignore */
+    }
+  }
+
+  console.log(JSON.stringify({ txHash, agentId, agentURI }, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});