Safe Skills

核心用法

SafeSkills 是一款面向 AI Agent 的密钥托管与代理执行服务，核心解决「Agent 需要操作加密钱包但不可接触私钥」的安全悖论。其架构采用「服务端托管密钥 + API 代理执行」模式：用户创建 EVM 钱包后，私钥由 SafeSkills 服务器保管，Agent 仅持有 API Key 用于发起操作请求，所有交易签名均在服务端完成。

支持功能：

• 创建智能账户钱包（基于 ERC-4337）
• 查询原生代币与 ERC-20 代币余额
• 执行 ETH/代币转账
• 发送任意合约调用交易（含自定义 calldata）

关键机制：

• 创建钱包后返回 apiKey（Agent 凭据）与 claimUrl（用户管理入口）
• 用户通过 claimUrl 配置支出策略（如限额、白名单），形成「Agent 请求-用户授权」的双签制衡
• 默认接入 Sepolia 测试网（chainId: 11155111），可配置其他 EVM 链

显著优点

1. 密钥零暴露：Agent 永远接触不到私钥原文，从根本上消除提示注入导致的密钥泄露风险
2. 用户可控策略：claimUrl 机制让用户保留最终控制权，Agent 的每笔敏感操作受预设策略约束
3. 无状态集成：Agent 无需持久化私钥，仅保管 API Key，降低终端环境的安全要求
4. 兼容智能账户：基于 ERC-4337 的账户抽象架构，支持未来升级（如多签、社交恢复）

潜在缺点与局限性

• 中心化信任假设：私钥托管于 SafeSkills 服务端，存在供应商单点故障与内部威胁风险
• 网络依赖性强：所有交易必须经 API 路由，Offline 场景不可用，且受服务可用性 SLA 约束
• 策略灵活性受限：当前仅支持基础限额策略，复杂 DeFi 交互（如授权管理、闪电贷）的细粒度控制待完善
• 测试网默认：文档示例指向 Sepolia，主网生产使用需显式配置 chainId，存在误配风险
• 无 MEV 保护：交易通过单一中继提交，缺乏隐私 mempool 或 Flashbots 集成

适合人群

• AI Agent 开发者：需为 Agent 赋予链上交互能力，但不愿承担私钥托管责任
• DeFi 自动化场景：定投、再平衡、收益收割等周期性策略执行
• 企业/机构用户：需合规审计轨迹，要求「操作可追踪但密钥不可见」的监管环境

常规风险

| 风险类别 | 说明 |

|---------|------|

| 供应商锁定 | API Key 与密钥绑定于 SafeSkills，迁移需重新创建钱包 |

| API Key 泄露 | 若 Agent 环境被攻破，攻击者可滥用已授权策略内的资金 |

| 策略配置失误 | 用户误设宽松限额可能导致 Agent 超额支出 |

| 服务端不可用 | 服务宕机时 Agent 无法执行任何链上操作，需考虑降级方案 |

核心用法

SafeSkills 是一个专为 AI Agent 设计的安全密钥管理服务，核心设计理念是"私钥永不离开服务器"。Agent 通过 API Key 调用服务端托管的钱包功能，执行转账、查余额、发送交易等操作，但永远无法获取原始私钥。

使用流程分为三步：首先通过 /api/secrets 创建 EVM 钱包，获取 API Key（后续所有请求的 Bearer Token）和 claim URL（用户管理策略）；然后使用 API Key 调用各类钱包操作，包括查询地址、检查余额（支持原生代币和 ERC-20）、转账 ETH 或代币、发送任意交易等；最后将 claim URL 提供给终端用户，由用户自行配置消费策略和监控钱包状态。

该设计实现了权限分离：Agent 拥有操作权限但无密钥知情权，用户掌握策略控制权，服务方托管密钥但受策略约束。

显著优点

1. 安全架构设计优秀
私钥完全隔离在服务端，Agent 仅通过 API Key 调用操作，即使 Agent 环境被入侵，攻击者也无法提取私钥。这比传统的环境变量存储私钥方案安全性显著提升。

2. 操作功能完整
支持完整的 EVM 钱包生命周期：创建钱包、查询余额（多代币）、原生 ETH 转账、ERC-20 代币转账、自定义交易（智能合约交互）。基本覆盖 DeFi 和区块链自动化场景需求。

3. 用户可控策略
通过 claim URL 机制，终端用户可以自主设置消费限额、白名单等策略，既保证 Agent 的自动化能力，又保留人工风控能力。

4. 集成成本低
纯 REST API 设计，使用标准 curl 示例即可集成，无复杂 SDK 依赖，适合快速原型开发和轻量级集成。

潜在缺点与局限性

1. 中心化信任依赖
密钥托管于第三方服务（Railway 平台），用户需完全信任 SafeSkills 服务提供商的运维能力和诚信度。服务下线、数据泄露或被恶意利用均会导致资金损失。

2. 网络依赖性强
所有操作必须联网调用 API，无法离线签名，也无法应对服务中断或网络审查场景。API 延迟也会直接影响 Agent 响应速度。

3. 功能深度有限
当前仅支持 EVM 生态，不支持其他主流链（Solana、Cosmos 等）。也不支持多签、硬件钱包集成等企业级安全方案。

4. 调试与审计困难
交易失败时难以定位是策略限制、余额不足还是网络问题。服务端黑盒运行，用户无法审计实际签名逻辑。

适合的目标群体

• AI Agent 开发者：需要为 Agent 赋予链上操作能力，但不愿将私钥暴露在 Agent 环境中
• 自动化交易场景：量化策略、套利机器人、DeFi 收益聚合等需要程序化操作的场景
• MCP/插件生态建设者：希望快速集成钱包功能的低代码/无代码平台
• 测试网开发者：在 Sepolia 等测试网进行智能合约交互和自动化测试

不适合：高净值资产管理、机构级托管需求、强合规要求场景、需要完全自主掌控密钥的极客用户。

使用风险

资金安全风险（高）：API Key 泄露可导致钱包被恶意操作，且区块链交易不可逆。建议严格限制 API Key 的存储环境，避免日志泄露。

服务可用性风险（中）：Railway 免费/低成本托管可能面临服务不稳定、冷启动延迟、域名变更等问题。关键业务应考虑服务降级方案。

智能合约交互风险（中）：send-transaction 接口允许任意 calldata，若 Agent 被诱导调用恶意合约，可能造成授权盗窃或资金损失。

隐私泄露风险（低）：API 调用会暴露钱包地址、交易模式等链上行为指纹，可被用于用户画像分析。