minara

核心用法

Minara 是一款面向加密货币交易者的智能 Agent Skill，提供从市场分析到链上执行的完整闭环。其核心功能涵盖四大模块：

1. 智能市场对话（Chat）：通过自然语言与 Minara API 交互，获取实时行情、项目分析、交易策略建议，支持 fast/expert 两种模式。

2. 兑换意图解析（Intent-to-Swap）：用户以自然语言描述兑换需求（如"将 0.1 ETH 兑换为 USDC"），系统自动解析意图、获取报价、生成未签名交易，并处理 EVM 链的 ERC-20 授权流程。

3. 永续合约建议（Perp Trading）：针对 Hyperliquid 平台提供杠杆交易建议，支持 1-40 倍杠杆，输出入场价、止损止盈位、置信度及风险分析，需用户确认后执行 EIP-712 签名上链。

4. 预测市场分析（Prediction Market）：解析 Polymarket 等预测市场事件，提供概率预测与推理逻辑。

技术架构上，Minara 采用双轨认证体系：优先使用 MINARA_API_KEY 进行标准 API 调用；未配置时则通过 x402 协议实现按量付费，支持 Circle Wallet（推荐）、EVM EOA 或 Solana EOA 三种签名方式。Circle Wallet 作为首选方案，将私钥托管于服务器端，通过 CLI 与 SDK 提供跨链钱包管理、USDC 转账、合约执行、类型化数据签名等能力。

显著优点

• 双链原生支持：同时覆盖 EVM（Base、Ethereum、Arbitrum 等）与 Solana 生态，自动识别地址格式并路由至对应链，降低多链操作复杂度。
• 安全架构设计：明确推荐 Circle Wallet 服务器端签名方案，私钥永不暴露于本地环境或 LLM 上下文；文档中设置醒目的安全警告，强调私钥保护红线。
• 灵活的支付与认证：API Key 与 x402 双模式并存，满足不同用户的接入偏好；x402 实现真正的按调用付费，无需预存或订阅。
• 完整的交易生命周期：从自然语言意图解析、报价展示、授权检查、交易构建到签名广播，流程闭环且文档详尽，提供 EVM 与 Solana 的完整代码示例。
• 专业级金融功能：整合 DEX 兑换、永续合约、预测市场等高级场景，支持最高 40 倍杠杆的策略建议，满足进阶交易者需求。

潜在缺点与局限性

• 高风险操作无二次确认：交易一旦签名即上链，系统未内置金额限制、频率控制或人工二次确认机制，误操作或提示词注入可能导致即时资金损失。
• 依赖外部服务可用性：核心功能依赖 Minara API、Circle Wallet、Hyperliquid、区块链 RPC 等多方服务，任一节点故障或作恶均可能影响交易执行或资金安全。
• 隐私性不足：交易数据需上传至 Minara API 并广播至公共区块链，链上行为完全可追踪，缺乏隐私保护机制；API Key 与配置文件的本地存储也存在泄露风险。
• 智能合约授权风险：EVM 兑换需预先授权合约花费用户代币，若合约存在漏洞或为恶意合约，可能导致资金被抽走；文档虽提醒检查授权地址，但无自动化审计机制。
• 杠杆交易的爆仓风险：永续合约建议支持高杠杆，市场波动可能导致超过本金的损失，系统仅提供风险提示，无强制风控拦截。
• T3 来源可信度：作为第三方商业项目，缺乏知名大厂背书及独立安全审计，长期维护与合规性存在不确定性。

适合的目标群体

• 进阶加密交易者：熟悉 DEX 操作、理解 Gas 费与滑点、具备链上交易经验，需要自动化工具提升效率的用户。
• 多链资产管理用户：同时在 EVM 与 Solana 生态持有资产，希望统一界面管理跨链操作。
• 量化与策略研究者：需要程序化获取市场分析、兑换报价、永续合约策略建议，作为交易决策辅助。
• 开发者与交易员：具备一定技术能力，能够阅读示例代码、配置 Circle Wallet、理解 EIP-712 与 Solana 交易签名机制。

不适合：区块链新手、无法承担资金全部损失风险的用户、需要高度隐私保护的大额交易者、缺乏技术背景无法验证交易详情的普通用户。

使用风险

• 资金损失风险：涉及真实资金转账、兑换及高杠杆合约，市场波动、操作失误、API 故障均可能导致不可逆损失。
• 私钥泄露风险：若未使用 Circle Wallet 而采用 EOA 模式，私钥管理不当（如硬编码、权限配置错误）将导致钱包被盗。
• 供应链攻击风险：依赖 Circle Wallet SDK、Minara API、x402 协议等第三方代码与服务，存在被植入恶意逻辑或遭遇服务中断的可能。
• 授权滥用风险：ERC-20 approve 操作授权第三方合约花费代币，若未定期清理授权或遭遇恶意合约，资金可能被非法转移。
• 提示词注入风险：自然语言意图解析环节若未充分过滤，恶意构造的输入可能诱导系统执行非预期交易。