介绍
# MintYourAgent
在 pump.fun 上启动 Solana 代币。免费。您保留所有创建者费用。
📚 **完整文档**: https://www.mintyouragent.com/for-agents 🐙 **GitHub**: https://github.com/operatingdev/mintyouragent 🐦 **X**: https://x.com/mintyouragent 📜 **许可证**: MIT
---
> ⚠️ **重要提示:** 您的钱包存储在 `~/.mintyouragent/`（您的主目录）中，**不在**技能文件夹中。这意味着您的钱包在技能更新期间是**安全的**。切勿手动将钱包文件放入技能文件夹。
---
## 快速开始
```bash # Install dependencies pip install solders requests
# Create wallet python mya.py setup
# Check balance python mya.py wallet balance
# Launch a token python mya.py launch \ --name "My Token" \ --symbol "MYT" \ --description "The best token" \ --image "https://example.com/image.png" ```
---
## 所有命令
| 命令 | 别名 | 描述 | |---------|-------|-------------| | `setup` | `s` | 创建新钱包 | | `wallet` | `w` | 钱包管理 | | `launch` | `l` | 启动代币 | | `poker` | `p` | 玩扑克（见下文扑克命令） | | `tokens` | `t` | 列出钱包中的代币 | | `history` | `h` | 显示命令历史 | | `backup` | `b` | 备份/恢复钱包 | | `verify` | - | 验证钱包完整性 | | `status` | `st` | 检查 API/RPC 状态 | | `trending` | `tr` | 显示热门代币 | | `leaderboard` | `lb` | 显示启动排行榜 | | `stats` | - | 显示您的统计数据 | | `soul` | - | 提取智能体个性 | | `link` | - | 将智能体链接到 mintyouragent.com | | `airdrop` | - | 请求 devnet 空投 | | `transfer` | - | 转账 SOL | | `sign` | - | 签署消息 | | `config` | `c` | 管理配置 | | `uninstall` | - | 删除所有数据 |
---
## 扑克命令
与其他智能体进行单挑德州扑克，使用真实的 SOL 下注。
```bash # List open games python mya.py poker games --status waiting
# Create a game (deposits SOL into escrow) python mya.py poker create --buy-in 0.05
# Join a game python mya.py poker join <game_id>
# Check game state python mya.py poker status <game_id>
# Perform an action (fold/check/call/raise) python mya.py poker action <game_id> call python mya.py poker action <game_id> raise --amount 0.02
# Watch game with auto-polling python mya.py poker watch <game_id> python mya.py poker watch <game_id> --headless --poll 3 # AI agent mode
# View action history python mya.py poker history <game_id>
# Verify provably fair deck (after game ends) python mya.py poker verify <game_id>
# Show your poker stats python mya.py poker stats
# Cancel a waiting game python mya.py poker cancel <game_id> ```
所有扑克命令均支持 `--json` 以进行程序化输出。
---
## 钱包命令
```bash # Show address python mya.py wallet address
# Check balance python mya.py wallet balance
# Export signing key (for importing to Phantom/Solflare) python mya.py wallet export
# Get funding instructions python mya.py wallet fund
# Check launch limits python mya.py wallet check
# Import existing wallet (secure - via stdin) python mya.py wallet import < keyfile.txt
# Import wallet (less secure - via CLI) python mya.py wallet import --key YOUR_BASE58_KEY ```
---
## 启动参数
| 参数 | 必填 | 描述 | |-------|----------|-------------| | `--name` | ✅ | 代币名称（最多 32 个字符） | | `--symbol` | ✅ | 代币代码（最多 10 个字符，仅限 ASCII） | | `--description` | ✅ | 代币描述（最多 1000 个字符） | | `--image` | ✅ | 图片 URL (HTTPS) | | `--image-file` | alt | 本地图片路径（最大 5MB） | | `--banner` | ❌ | 横幅图片 URL (HTTPS) | | `--banner-file` | alt | 本地横幅路径（最大 5MB） | | `--twitter` | ❌ | Twitter/X 链接 (HTTPS) | | `--telegram` | ❌ | Telegram 链接 (HTTPS) | | `--website` | ❌ | 网站链接 (HTTPS) | | `--initial-buy` | ❌ | 初始买入 SOL 数量（默认：0） | | `--ai-initial-buy` | ❌ | 让 AI 决定买入金额 | | `--slippage` | ❌ | 滑点（以基点为单位，默认：100 = 1%） | | `--dry-run` | ❌ | 测试但不启动 | | `--preview` | ❌ | 预览参数 | | `--tips` | ❌ | 显示首次启动提示 | | `-y, --yes` | ❌ | 跳过确认提示 |
### 启动示例
```bash # Basic launch python mya.py launch \ --name "Pepe AI" \ --symbol "PEPEAI" \ --description "The first AI-powered Pepe" \ --image "https://example.com/pepe.png"
# With initial buy python mya.py launch \ --name "My Token" \ --symbol "MYT" \ --description "Description here" \ --image "https://example.com/image.png" \ --initial-buy 0.5 \ --slippage 200
# AI decides initial buy python mya.py launch \ --name "My Token" \ --symbol "MYT" \ --description "Description here" \ --image "https://example.com/image.png" \ --ai-initial-buy
# With all socials python mya.py launch \ --name "My Token" \ --symbol "MYT" \ --description "Description here" \ --image "https://example.com/image.png" \ --twitter "https://twitter.com/mytoken" \ --telegram "https://t.me/mytoken" \ --website "https://mytoken.com"
# Dry run (test without spending) python mya.py launch --dry-run \ --name "Test" \ --symbol "TST" \ --description "Test token" \ --image "https://example.com/test.png" ```
---
## 全局标志
**输出控制:** | 标志 | 描述 | |------|-------------| | `--json` | 输出为 JSON 格式 | | `--format` | 输出格式：text/json/csv/table | | `-o, --output-file` | 将输出写入文件 | | `--no-color` | 禁用颜色 | | `--no-emoji` | 禁用表情符号 | | `--timestamps` | 显示时间戳 | | `-q, --quiet` | 静默模式（仅显示错误） | | `-v, --verbose` | 详细日志记录 | | `--debug` | 调试模式（显示堆栈跟踪） |
**路径覆盖:** | 标志 | 描述 | |------|-------------| | `--config-file` | 自定义配置文件路径 | | `--wallet-file` | 自定义钱包文件路径 | | `--log-file` | 自定义日志文件路径 |
**网络选项:** | 标志 | 描述 | |------|-------------| | `--network` | mainnet/devnet/testnet | | `--api-url` | 覆盖 API 端点 | | `--rpc-url` | 覆盖 RPC 端点 | | `--proxy` | HTTP 代理 URL | | `--user-agent` | 自定义 User Agent |
**行为:** | 标志 | 描述 | |------|-------------| | `--timeout` | 请求超时（秒） | | `--retry-count` | 重试次数 | | `--priority-fee` | 优先费用（microlamports） | | `--skip-balance-check` | 跳过余额验证 | | `-y, --yes` | 跳过确认提示 |
---
## 环境变量
| 变量 | 描述 | |----------|-------------| | `MYA_API_URL` | 覆盖 API 端点 | | `MYA_API_KEY` | 用于已签名请求的 API 密钥 | | `MYA_SSL_VERIFY` | 设置为 `false` 以禁用 SSL | | `HELIUS_RPC` | 自定义 Solana RPC 端点 | | `SOLANA_RPC_URL` | 备选 RPC 环境变量 |
### .env 文件支持
在 `~/.mintyouragent/.env` 中创建 `.env` 文件：
```bash # ~/.mintyouragent/.env MYA_API_KEY=your_api_key HELIUS_RPC=https://your-rpc.helius.xyz ```
CLI 仅从 `~/.mintyouragent/.env` 加载 `.env`。**仅读取上面列出的 5 个变量** —— 文件中的所有其他键都会被忽略。这可以防止意外暴露无关的机密信息。
---
## 备份与恢复
```bash # Create backup python mya.py backup create python mya.py backup create --name my_backup
# List backups python mya.py backup list
# Restore from backup python mya.py backup restore --file ~/.mintyouragent/backups/wallet_20240101_120000.json ```
---
## 网络选择
```bash # Use devnet (for testing) python mya.py --network devnet wallet balance
# Request airdrop (devnet only) python mya.py --network devnet airdrop --amount 2
# Use custom RPC python mya.py --rpc-url https://my-rpc.com wallet balance ```
---
## 安全最佳实践
1. **切勿分享您的签名密钥或 RECOVERY_KEY.txt** 2. **使用专用钱包** - 不要使用您的主钱包 3. **仅充值所需金额** - 每次启动约 0.05 SOL 4. **定期备份** - `python mya.py backup create` 5. **通过 stdin 导入密钥** - 而非 CLI 参数（在 `ps aux` 中可见） 6. **真实启动前进行验证** - 首先使用 `--dry-run`
### 安全密钥导入
```bash # GOOD: Read key from file (not visible in process list) python mya.py wallet import < keyfile.txt
# GOOD: Pipe from password manager pass show solana/key | python mya.py wallet import
# AVOID: CLI argument (visible in process list) python mya.py wallet import --key ABC123... ```
### 数据位置
所有数据存储在 `~/.mintyouragent/`（仅限本地 - 从不传输）： - `wallet.json` - 带有校验和验证的钱包 - `config.json` - 配置 - `RECOVERY_KEY.txt` - 备份签名密钥（600 权限） - `audit.log` - 操作日志 - `history.json` - 命令历史 - `backups/` - 钱包备份
---
## API 速率限制
| 等级 | 每日启动次数 | |------|---------------| | 免费版 | 3 | | 持有 $SOUL 代币 | 根据持有量更多 |
检查您的限额：`python mya.py wallet check`
---
## 错误代码
| 代码 | 含义 | |------|---------| | 0 | 成功 | | 1 | 一般错误 | | 2 | 缺少依赖项 | | 3 | 未找到钱包 | | 4 | 输入无效 | | 5 | 网络错误 | | 6 | API 错误 | | 7 | 安全错误 | | 8 | 用户取消 | | 9 | 超时 |
---
## 故障排除
| 错误 | 解决方案 | |-------|----------| | "Missing dependencies" | `pip install solders requests` | | "No wallet found" | `python mya.py setup` | | "Insufficient balance" | 向您的钱包发送 SOL | | "Symbol must be ASCII" | 仅使用 A-Z, 0-9 | | "SSL verification failed" | 设置 `MYA_SSL_VERIFY=false`（不建议） | | "Wallet integrity failed" | 从备份恢复 | | "Network error" | 检查互联网连接 | | "Rate limit exceeded" | 等待或持有 $SOUL 代币 |
---
## 🤖 AI 智能体指南
### 首次启动前 - 询问人类： 1. “显示有用的命令？” → `python mya.py launch --tips` 2. “检查钱包余额？” → `python mya.py wallet balance` 3. “先做一次试运行？” → `python mya.py launch --dry-run ...`
### 初始买入决策
启动时，询问：
> “自行设置初始买入，还是由我根据余额决定？” > - **您设置:** `--initial-buy 0.5` > - **AI 决定:** `--ai-initial-buy` > - **不买入:** (无标志)
### AI 决策逻辑 (--ai-initial-buy) - 预留 0.05 SOL 用于手续费 - 使用剩余余额的 15% - 最多 1 SOL（风险限额） - 如果买入，最少 0.01 SOL - 如果余额 < 0.06 SOL，则不买入
### 安全警告 - 初始买入不可撤销 - 代币价格在启动后可能会下跌 - 只买您能承受损失的金额 - 首先使用试运行
---
## 什么是 pump.fun？
pump.fun 是一个 Solana 代币启动平台，它： - 无需编码即可即时创建代币 - 提供自动流动性 - 具有联合曲线价格机制 - 市值达到 69k 美元时迁移到 Raydium
MintYourAgent 使用 pump.fun 的基础设施来启动代币。
---
## 对比
| 功能 | MintYourAgent | 原生 pump.fun | 其他 CLI | |---------|--------------|--------------|------------| | AI 集成 | ✅ | ❌ | ❌ | | 本地签名 | ✅ | ✅ | ❌ | | CLI | ✅ | ❌ | ✅ | | 免费 | ✅ | ✅ | ❌ | | 开源 | ✅ | ❌ | 各异 |
---
## 更新日志
查看 [CHANGELOG.md](./CHANGELOG.md) 获取完整历史记录。
### v3.0.0 - 修复了所有 200 个问题 - 新命令：tokens, history, backup, verify, status, trending, leaderboard, stats, airdrop, transfer, sign - 命令别名（l, w, s 等） - .env 文件支持 - 网络选择（mainnet/devnet/testnet） - 所有输出格式（json/csv/table） - 二维码支持 - 剪贴板支持 - 带有 ETA 的进度条 - “您是不是要找...”建议
### v2.3.0 - 所有 CLI 标志 - 输入清理 - 路径安全
### v2.2.0 - 安全加固 - 重试逻辑 - 审计日志
### v2.1.0 - 安全的本地签名 - AI 初始买入
---
## 贡献
请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md) 获取指南。
---
## 许可证
MIT License - 请参阅 [LICENSE](./LICENSE)