AISP Agent 技能

Agent Inference Sharing Protocol（AISP）允许 Agent 通过 USDC 托管机制租用空闲的 DIEM/Venice API 算力资源。服务提供方（Provider）发布带用量上限的 API 密钥；Agent 完成链上资金注入后，系统自动发放密钥。

架构

Agent：调用 fund() → 后端监听到 Funded 事件 → 密钥释放 → Agent 使用 Venice API  
Provider：调用 list() → Agent 注资 → 租期到期 → 调用 settle() → Provider 收款（99%，1% 为协议手续费）

Agent 工作流（租用流程）

1. 获取列表：从后端拉取可用清单：GET /api/listings
2. 批准 USDC 授权（如尚未授权）：合约需获得在 fund 操作中代为支出 USDC 的权限
3. 链上注资：contract.fund(listingId, termDays, diemAmount) → 返回 rentalId
4. 获取密钥：POST /api/key/{rentalId}，请求体中携带签名消息 diem-marketplace:get-key:{rentalId}:{timestamp}
5. 在 expiresAt（Unix 时间戳）之前，使用返回的 apiKey 调用 Venice API

SDK（Agent 端）

import { DiemAgent } from "diem-marketplace-sdk";

const agent = new DiemAgent({
  signer: wallet,
  contractAddress: "0x...",
  backendUrl: "https://diem-marketplace-backend.fly.dev",
  usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
});

const listings = await agent.getListings();
const { apiKey, expiresAt } = await agent.rent(
  listings[0].listingId,
  termDays,
  ethers.parseUnits(diemAmount, 6)
);

Provider 工作流（上架流程）

1. 链上创建清单：contract.list(pricePerDay, termDays, diemMin, diemMax) → 返回 listingId
2. 向后端存储密钥：POST /api/keys，请求体为 { listingId, apiKey, signature, timestamp }
   • 签名消息格式：diem-marketplace:store-key:{listingId}:{timestamp}
3. 租期结束后结算：contract.settle(rentalId) → Provider 收到到账金额的 99%（1% 为协议手续费）

SDK（Provider 端）

import { DiemProvider } from "diem-marketplace-sdk";

const provider = new DiemProvider({
  signer: wallet,
  contractAddress: "0x...",
  backendUrl: "https://diem-marketplace-backend.fly.dev",
  usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
});

const listingId = await provider.createListing({
  pricePerDay: ethers.parseUnits("0.80", 6),
  termDays: 30,
  diemMin: ethers.parseUnits("1000", 6),
  diemMax: ethers.parseUnits("4000", 6),
  apiKey: "vn-scoped-...",
});

关键路径

后端 API

签名规范

所有需要身份认证的后端请求均采用 EIP-191 标准签名：

• getKey：签名消息为 diem-marketplace:get-key:{rentalId}:{timestamp}
• storeKey：签名消息为 diem-marketplace:store-key:{listingId}:{timestamp}
• balance：请求体中直接传入 apiKey（无需签名）

合约（基础链）

• 链：Base（8453）
• 主网地址：0xeeDa7657f2018b3b71B444b7ca2D8dE91b3B08f3
• USDC 地址：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

安全与签名要求

• 务必使用外部签名器（如硬件钱包）进行操作；切勿粘贴原始私钥。
• 所有资金划转或凭据使用操作，必须显式获得用户确认。
• Venice API 密钥须为受限作用域（仅限 inference）、支持主动撤销，并满足托管所需的最小权限原则。

注意事项

• Venice API 密钥必须为 inference-only 类型（不可为 admin 权限）
• 结算时扣除 1% 协议手续费