用隔离私钥与支付规则约束智能体
方案将钱包私钥和签名规则放在 Lit Protocol 安全飞地内,智能体仅持有调用指定函数的 API 密钥。示例通过地址白名单和单笔 20 USDC 上限,约束 Base 网络上的付款请求。
AI 深度解读
给 AI agent 钱包,关键不是让它学会转账,而是让它即使被恶意网页带偏,也只能在限定范围内花钱。作者给出的方案是:用 Lit Protocol 保管私钥并执行支付规则,agent 只拿到调用指定支付函数的权限。
这套示例支持在 Base 上向白名单商家支付 USDC,单笔不超过 20 USDC。对程序员来说,最值得借鉴的是它划分权限的方式:模型负责提出请求,独立的执行层决定请求能否通过。
支付规则为什么不能只写在提示词里
agent 会根据上下文行动。它读取的网页、邮件里如果藏着提示注入,就可能尝试向错误地址付款。把「不要乱转账」写进系统提示词,无法替代真正的支付限制。
作者把私钥和规则一起放进安全飞地(secure enclave),也就是与外部程序隔离的执行环境。规则写成 JavaScript 函数,称为 Lit Action,在每次签名前执行。agent 获得的 API key 只能运行指定函数,不能读取私钥或修改规则。
真正有效的额度限制,必须落在模型无法修改的执行层。
下面的代码把收款地址和单笔额度同时锁住,解决「agent 提出了不该执行的付款请求」的问题。
// agent-pay.js
const USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
const VENDORS = ["0xDataVendor...", "0xComputeVendor..."].map(a => a.toLowerCase());
const MAX = 20_000000; // 20 USDC, which has 6 decimals
async function main({ pkpId, to, amount }) {
if (!VENDORS.includes(to.toLowerCase())) return { paid: false, reason: "not an approved vendor" };
if (!(Number(amount) > 0 && Number(amount) <= MAX)) return { paid: false, reason: "amount must be between 0 and 20 USDC" };
const provider = new ethers.providers.StaticJsonRpcProvider("https://mainnet.base.org");
const wallet = new ethers.Wallet(await Lit.Actions.getPrivateKey({ pkpId }), provider);
const usdc = new ethers.Contract(USDC, ["function transfer(address,uint256) returns (bool)"], wallet);
const tx = await usdc.transfer(to, amount);
return { paid: true, hash: tx.hash };
}
要看清 MAX = 20_000000:USDC 有 6 位小数,这里使用最小单位。白名单里的地址是占位内容,使用前需要替换。Lit.Actions.getPrivateKey 出现在 Action 内部,也不代表私钥会交给外面的 agent。
拒绝付款时,函数返回 paid: false 和具体原因,agent 可以据此向用户解释。
但单笔 20 USDC 不能阻止连续付款。作者建议,最简单的总预算就是钱包余额:本周允许花多少,就存多少。若希望余额充足时仍受每日上限约束,Action 还要在签名前读取自己的支出记录。原文没有给出这部分实现。
接入时,最重要的是发对那把 key
配置从 Lit dashboard 的 Create an account 开始,选择 API key,填写邮箱和账户名,保存 account API key,再通过 Add Funds 增加服务额度。
随后,用账户密钥创建钱包,把钱包和 Action 放进同一个 group,再创建只能执行该 group 的 usage key。原文用 curl 发请求、用 jq 提取响应,API 基址为 https://api.chipotle.litprotocol.com/core/v1。
流程依次涉及 /create_wallet、/get_lit_action_ipfs_id、/add_group、/add_action_to_group、/add_pkp_to_group 和 /add_usage_api_key。对应的是创建钱包、取得代码 CID、建立分组、绑定代码、绑定钱包和发放执行凭证。
权限配置才是这里的重点:can_create_groups、can_delete_groups、can_create_pkps 都设为 false;manage_ipfs_ids_in_groups、add_pkp_to_groups、remove_pkp_from_groups 都为空数组;只有 execute_in_groups 包含目标 group。
account key 留在管理端,usage key 交给工具进程。修改代码会产生新的哈希,原有执行权限不会自动覆盖新代码,因此 agent 不能靠替换白名单或提高额度绕过限制。
钱包还需要收到 USDC,以及少量用于 Base gas 的 ETH。新权限最多需要 30 秒生效,作者建议首次付款前等一分钟,或者在被拒绝后重试。删除 usage key 可以停止后续调用,但完全失效最多需要五分钟,不能把它当成即时断电开关。
Node 工具只是入口,不能承担最终授权
agent 看到的是工具名、描述和两个参数,宿主代码负责把请求发给 Lit。下面保留原文的 Node 接入代码,它采用 Anthropic API 的工具定义格式,并补上宿主程序调用的 run 函数。
import { readFileSync } from "node:fs";
const CODE = readFileSync("agent-pay.js", "utf8");
export const payVendor = {
name: "pay_vendor",
description: "Pay an approved vendor in USDC on Base. At most 20 USDC per payment.",
input_schema: {
type: "object",
properties: { to: { type: "string" }, amount_usdc: { type: "number" } },
required: ["to", "amount_usdc"],
},
async run({ to, amount_usdc }) {
const res = await fetch("https://api.chipotle.litprotocol.com/core/v1/lit_action", {
method: "POST",
headers: { "X-Api-Key": process.env.LIT_USAGE_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
code: CODE,
js_params: { pkpId: process.env.AGENT_WALLET, to, amount: String(Math.round(amount_usdc * 1e6)) },
}),
});
const out = await res.json();
if (!res.ok) return { paid: false, reason: typeof out === "string" ? out : out.message || `Lit returned ${res.status}` };
return out.response;
},
};
重点看 Math.round(amount_usdc * 1e6):工具接收以 USDC 为单位的数字,再换算为最小单位字符串。LIT_USAGE_KEY 设置为 usage key,AGENT_WALLET 设置为钱包地址。描述里的 20 USDC 只帮助模型选择,最终仍由 Action 检查。
usage key 依然是凭证,不能放进 agent 的对话记录。作者推荐 Agent Keychain,由它保存密钥并注入工具进程,避免模型直接看到密钥。对前端项目而言,这段携带凭证的调用应放在服务端工具进程,不能直接搬进浏览器。
我的判断
这套设计最有价值的地方,是把「模型想做什么」和「系统允许做什么」分开。相比只靠提示词限制付款,它有独立的执行边界;相比每笔人工审批,它允许规则内的付款自动进行。
不过,原文提供的是接入示例,没有攻击测试、可靠性数据或方案对照,不能据此认定整套系统已经验证安全。它依赖 Lit 的隔离执行、代码授权和凭证管理机制,这些是采用方案时需要接受的前提。
代码也留下了上线前必须补齐的问题。拿到 tx.hash 后就返回 paid: true,示例没有等待链上确认,产品界面不宜直接显示「付款已完成」。每日额度如果只靠读取支出记录,还要处理并发检查和记账,否则多笔请求可能同时通过。原文也没有展示防重复付款机制,超时后直接重试需要格外谨慎。
钱包余额适合做简单预算,但白名单商家仍可能被反复支付。它限制了损失范围,没有解决所有付款风险。
能拿来做什么
- 给 Node agent 接支付能力时,可以沿用「提出请求、独立校验、执行签名」的分层方式,把白名单和额度放到模型无权修改的位置。
- 小范围试用可以先采用单独钱包和固定余额预算,同时准备 Base gas,避免一开始就接入余额充足的业务钱包。
- 前端应分别呈现请求被拒绝、交易已提交和链上已确认,保留拒绝原因与交易哈希,避免把工具返回成功等同于到账。
- 正式开放自动付款前,应补齐累计额度、并发记账和防重复执行,并让 usage key 留在工具进程中,由管理端保管 account key。