使用说明
@1ly/mcp服务器
MCP服务器 1ly.store --使AI代理能够使用加密货币发现、支付和销售API。
概述
此MCP服务器使AI代理能够:
- 买 --使用自动加密支付(x402协议)搜索、发现和支付API/资源
- 卖 -创建商店,列出付费的API端点或资源,并接受付款
- 启动代币 --在Bags.fm上创建和交易代币,并索取费用份额
支持的网络: Solana(主网)、Base(主网 付款货币: 美元和100万美元(仅限索拉纳)
这是什么?
此MCP服务器使AI代理(Claude、GPT、Cursor等)能够:
- 在1ly.store上创建商店
- 使用1ly作为支付层接受API/资源的付款
- 创建任何兼容x402的代理都可以调用并自动支付的付费链接
- 在1ly市场上列出付费链接,以便即时发现代理
- 在1ly.store上搜索API和服务
- 获取有关定价、评论和使用的详细信息
- 安全地调用带有自动加密支付(x402协议)的付费API
- 购买后留下评论(可选但推荐)
- 在Bags.fm上推出代币,交易solana代币,并收取索赔费
快速开始
钱包路径规则: 钱包文件必须位于您的主目录中(推荐)或 /tmp。出于安全考虑,这些位置之外的路径将被拒绝。 ~/ 支持并在直接从终端运行时扩展到您的主目录。
重要提示: Claude桌面和光标配置JSON do 不 扩展 ~。在JSON配置文件中始终使用绝对路径(例如。 /Users/yourname/.1ly/wallets/solana.json).
1.安装并运行
选项A:原始钱包(默认)
# Solana wallet
ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server
# OR Base/EVM wallet
ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" npx @1ly/mcp-server
# OR both wallets
ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" \
ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" \
npx @1ly/mcp-server
选项B:Coinbase代理钱包(仅限Base)
ONELY_WALLET_PROVIDER="coinbase" npx @1ly/mcp-server
使用代理钱包时,您 不要 传递原始私钥。
确保Coinbase代理钱包应用程序正在运行并经过身份验证。
如果您尚未安装代理钱包:
- 关注Coinbase代理钱包文档: docs.cdp.coinbase.com/agent-wallet/welcome
- 快速安装:
npx skills add coinbase/agentic-wallet-skills
npx awal show
选项C:DCP本地(建议用于安全签名)
# Start DCP locally
dcp init
npx @dcprotocol/server
# Run MCP (auto-detects DCP at localhost:8420)
npx @1ly/mcp-server
选项D:DCP远程(继电器)
# Pairing outputs these values
DCP_VAULT_ID="vault_..." \
DCP_RELAY_URL="wss://relay.dcp.1ly.store" \
DCP_VAULT_HPKE_PUBLIC_KEY="base64..." \
npx @1ly/mcp-server
2.验证设置
ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server --self-test
配置
HTTP模式(云MCP)
通过HTTP运行MCP(用于云托管或 mcp.1ly.store):
# HTTP transport
MCP_TRANSPORT=http npx @1ly/mcp-server
# Custom host/port
MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=3000 npx @1ly/mcp-server
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
ONELY_WALLET_SOLANA_KEY |
否 | Solana密钥对JSON文件或内联JSON数组的路径 |
ONELY_WALLET_EVM_KEY |
否 | EVM私钥文件或内联十六进制密钥(有或没有)的路径 0x) |
ONELY_API_KEY |
卖方工具没有 | API密钥。自动加载后 1ly_create_store |
ONELY_BUDGET_PER_CALL |
否 | 每次API调用的最高美元数(默认值: 1.00) |
ONELY_BUDGET_DAILY |
否 | 每日美元支出限额(默认值: 50.00) |
ONELY_BUDGET_STATE_FILE |
否 | 本地预算状态文件的路径(默认: ~/.1ly-mcp-budget.json) |
ONELY_NETWORK |
否 | 首选网络: solana 或 base (默认值: solana) |
ONELY_SOLANA_RPC_URL |
否 | Solana RPC URL(默认值: https://api.mainnet-beta.solana.com) |
ONELY_API_BASE |
没有 | API基本URL(默认值: https://1ly.store) |
ONELY_WALLET_PROVIDER |
没有 | raw (默认)或 coinbase (代理钱包,仅限Base) |
ONELY_SOLANA_DRY_RUN |
否 | 设置为 1 模拟Solana交易,无需广播。没有实际付款。仅用于测试。 |
MCP_TRANSPORT |
没有 | http 运行HTTP MCP服务器(默认:stdio) |
MCP_HTTP_HOST |
否 | HTTP MCP服务器的主机(默认值: 0.0.0.0) |
MCP_HTTP_PORT |
否 | HTTP MCP服务器的端口(默认值: 3000) |
DCP_VAULT_ID |
无 | DCP继电器的保险库ID(远程模式) |
DCP_RELAY_URL |
否 | 中继URL(例如。, wss://relay.dcp.1ly.store) |
DCP_RELAY_TOKEN |
否 | 中继配对令牌(如果需要) |
DCP_VAULT_HPKE_PUBLIC_KEY |
没有 | 保管库的Base64 HPKE公钥(远程模式) |
DCP_RELAY_PLAINTEXT |
否 | 设置为 1 禁用HPKE(仅限开发人员) |
只需要钱包 已支付 电话。对于免费搜索/详细信息,您可以在没有钱包的情况下运行。
使用 一 关于: ONELY_WALLET_SOLANA_KEY, ONELY_WALLET_EVM_KEY,或 ONELY_WALLET_PROVIDER=coinbase.
Claude桌面配置
添加 claude_desktop_config.json:
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": ["@1ly/mcp-server"],
"env": {
"ONELY_WALLET_SOLANA_KEY": "/Users/yourname/.1ly/wallets/solana.json",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}
注: 替换
/Users/yourname使用您的实际主目录。Linux使用/home/yourname.~在Claude Desktop配置中不起作用。
Base/EVM wallet configuration
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": ["@1ly/mcp-server"],
"env": {
"ONELY_WALLET_EVM_KEY": "/Users/yourname/.1ly/wallets/evm.key",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}
光标一键安装
光标使用 .cursor/mcp.json。如果您更喜欢手动设置,请使用:
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": ["@1ly/mcp-server"],
"env": {
"ONELY_WALLET_SOLANA_KEY": "/absolute/path/to/solana.json",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}
Both Solana + Base wallets
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": ["@1ly/mcp-server"],
"env": {
"ONELY_WALLET_SOLANA_KEY": "~/.1ly/wallets/solana.json",
"ONELY_WALLET_EVM_KEY": "~/.1ly/wallets/evm.key",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}
工具参考
买家工具
钱包 仅限付费电话 (1ly_call).无需钱包即可搜索/查看详细信息。
1ly_search
在1ly.store市场上搜索API。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
字符串 | 是 | 搜索词(例如“天气api”) |
type |
string | 否 | 筛选器: "api" 或 "standard" |
maxPrice |
number | 否 | 最高价格(美元) |
minPrice |
number | 否 | 最低价格(美元) |
limit |
number | 否 | 要返回的结果(默认值:10,最大值:50) |
{
"query": "weather api",
"type": "api",
"maxPrice": 0.10
}
退货:
{
"ok": true,
"data": {
"results": [
{
"title": "Real-time Weather",
"endpoint": "/api/link/joe/weather",
"price": "$0.010000000000000000 USDC",
"type": "api",
"seller": "Joe's APIs",
"stats": { "buyers": 150, "rating": "95%" }
}
],
"total": 42,
"showing": 10
}
}
1ly_get_details
获取有关特定API的详细信息。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint |
字符串 | 是 | API端点(例如。, "joe/weather") |
{
"endpoint": "joe/weather"
}
返回(示例):
{
"ok": true,
"data": {
"endpoint": "/api/link/joe/weather",
"fullUrl": "https://1ly.store/api/link/joe/weather",
"link": {
"title": "Real-time Weather",
"description": "Global weather data",
"slug": "weather",
"price": "0.010000000000000000",
"currency": "USDC"
},
"paymentInfo": { "networks": ["solana", "base"] },
"reviews": {
"stats": { "total": 50, "positive": 48 },
"recent": [{ "positive": true, "comment": "Fast!" }]
}
}
}
1ly_call
使用自动加密货币支付呼叫付费API。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint |
字符串 | 是 | API端点(例如。, "joe/weather") |
method |
string | 否 | HTTP方法: GET, POST, PUT, DELETE, PATCH (默认值: GET) |
body |
object | 否 | 请求POST/PUT/PATCH的正文 |
headers |
object | 否 | 其他标头 |
{
"endpoint": "joe/weather",
"method": "POST",
"body": { "city": "NYC" }
}
返回(示例):
{
"ok": true,
"data": {
"data": {
"temp": 72,
"conditions": "sunny"
},
"_1ly": {
"purchaseId": "abc123",
"txHash": "tx_hash_here",
"reviewUrl": "https://1ly.store/api/review/abc123",
"reviewToken": "xyz789"
}
}
}
注: 这
_1ly对象包含以下所需的令牌1ly_review。如果您想留下评论,请保存这些。
对于免费API,_1ly可能是{ "note": "No payment required (free API)" }.
代理钱包(仅限基本款):
- 集
ONELY_WALLET_PROVIDER=coinbase. - 确保Coinbase代理钱包已安装、正在运行并经过身份验证。
- 不需要本地私钥。
1ly_review
购买成功后留下评论。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
purchaseId |
字符串 | 是 | 从 _1ly.purchaseId 在 1ly_call 回应 |
reviewToken |
字符串 | 是 | 从 _1ly.reviewToken 在 1ly_call 回应 |
positive |
布尔值 | 是 | true 对于积极的, false 对于负数 |
comment |
string | 否 | 评论(最多500个字符) |
{
"purchaseId": "abc123",
"reviewToken": "xyz789",
"positive": true,
"comment": "Fast and accurate!"
}
退货:
{
"ok": true,
"data": {
"success": true,
"reviewId": "rev_456",
"message": "Positive review submitted!"
}
}
卖家工具(接受付款)
这些工具需要 API密钥。有两种方法可以获得一个:
选项A——通过MCP工具(代理为您完成):
跑 1ly_create_store 并且密钥自动保存在本地。
选项B——通过用户界面(无需钱包):
- 首选 1ly.store 并登录
- 打开设置→ 启用 开发者模式
- 从仪表板创建API键
- 设置为
ONELY_API_KEY在MCP配置中
1ly_create_store
创建一个新存储并获取一个API密钥。 运行一次。 API密钥自动保存在本地。
注: 创建商店需要一个原始钱包密钥(Solana或EVM)。代理钱包尚不支持创建商店。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
username |
string | 否 | 存储用户名(3-20个字符,如果省略则自动生成) |
displayName |
string | 否 | 显示名称(最多50个字符) |
avatarUrl |
string | 否 | 头像URL |
{
"username": "myagent",
"displayName": "My Agent Store"
}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"store": {
"username": "myagent",
"displayName": "My Agent Store",
"storeUrl": "https://1ly.store/myagent",
"createdBy": "agent",
"avatarUrl": null
},
"apiKey": "1ly_live_...",
"apiKeyPrefix": "1ly_live_..."
},
"meta": {
"savedKeyPath": "~/Library/Application Support/1ly/onely_api_key.json"
}
}
}
API密钥存储:
- macOS:
~/Library/Application Support/1ly/onely_api_key.json- Linux:
~/.config/1ly/onely_api_key.json- 窗户:
%APPDATA%\1ly\onely_api_key.json
1ly_create_link
创建一个新的API链接(付费或免费)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
title |
字符串 | 是 | 链接标题(最多200个字符) |
url |
字符串 | 是 | 目标URL(API端点) |
price |
string | 否 | 美元价格(例如。, "0.10").免费省略 |
description |
string | 否 | 描述(最多500个字符) |
slug |
string | 否 | 自定义slug(3-64个字符,小写,允许使用连字符) |
currency |
string | 否 | 始终 "USDC" |
isPublic |
boolean | 否 | 公开列出(默认值: true) |
isStealth |
boolean | 否 | 隐藏搜索(默认值: false) |
webhookUrl |
string | 否 | 购买事件的可选webhook URL |
{
"title": "Premium Weather API",
"url": "https://api.example.com/weather",
"price": "0.05",
"description": "Real-time weather data",
"webhookUrl": "https://example.com/webhooks/1ly"
}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"id": "uuid-here",
"slug": "premium-weather-api",
"fullUrl": "https://1ly.store/myagent/premium-weather-api",
"privateSlug": null,
"privateUrl": null,
"price": "0.050000000000000000",
"currency": "USDC",
"linkType": "api",
"createdAt": "2026-01-01T00:00:00.000Z"
}
}
}
1ly_list_links
列出所有API链接。
没有参数。
{}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"links": [
{
"id": "uuid-here",
"url": "https://api.example.com/weather",
"title": "Premium Weather API",
"description": "Real-time weather data",
"slug": "premium-weather-api",
"privateSlug": null,
"price": "0.050000000000000000",
"currency": "USDC",
"isPaid": true,
"isPublic": true,
"isActive": true,
"linkType": "api",
"isStealth": false,
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}
}
}
1ly_update_link
更新现有的API链接。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
字符串(UUID) | 是 | 链接ID |
title |
string | 否 | 新标题 |
url |
string | 否 | 新目标URL |
price |
string | 否 | 新价格 |
description |
string | 否 | 新描述 |
slug |
string | 否 | 新slug |
isPublic |
boolean | 否 | 更新可见性 |
isStealth |
boolean | 否 | 更新隐身模式 |
webhookUrl |
string | 否 | 更新webhook URL(设置为 null 清除) |
{
"id": "uuid-here",
"price": "0.10"
}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"id": "uuid-here",
"profileId": "profile-id",
"url": "https://api.example.com/weather",
"title": "Premium Weather API (updated)",
"description": "Real-time weather data",
"slug": "premium-weather-api",
"privateSlug": null,
"price": "0.100000000000000000",
"currency": "USDC",
"isPaid": true,
"isPublic": true,
"isActive": true,
"linkType": "api",
"isStealth": false,
"displayOrder": 1,
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}
}
1ly_delete_link
删除API链接。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
字符串(UUID) | 是 | 要删除的链接ID |
{
"id": "uuid-here"
}
返回(示例):
{
"ok": true,
"data": {
"success": true
}
}
1ly_get_stats
获取商店或链接统计信息。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
period |
string | 否 | 时间段: "7d", "30d", "90d", "all" |
linkId |
string(UUID) | 否 | 特定链接ID(对于全存储统计数据省略) |
{
"period": "30d"
}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"period": "30d",
"views": 0,
"buyers": 9,
"revenue": "0.081000000000000009"
}
}
}
1ly_list_keys
列出您的商店的所有API密钥。
没有参数。
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"keys": [
{
"id": "uuid-here",
"name": "Agent Key",
"keyPrefix": "1ly_live_...",
"isActive": true,
"lastUsedAt": "2026-01-01T00:00:00.000Z",
"createdAt": "2026-01-01T00:00:00.000Z"
}
]
}
}
}
1ly_create_key
创建一个新的API密钥。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name |
string | 否 | 键名(最多64个字符) |
{
"name": "production-key"
}
返回(达到密钥限制时的示例):
{
"ok": false,
"error": {
"message": "Create key failed | status=400 | ... | body={\"success\":false,\"error\":{\"code\":\"LIMIT_REACHED\",\"message\":\"Maximum number of API keys reached\"}}"
}
}
1ly_revoke_key
吊销API密钥。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
字符串(UUID) | 是 | 要撤销的密钥ID |
{
"id": "uuid-here"
}
返回(示例):
{
"ok": true,
"data": {
"success": true,
"data": {
"id": "uuid-here",
"revoked": true
}
}
}
1ly_update_profile
更新基本配置文件字段。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
username |
string | 否 | 新用户名(小写+下划线) |
displayName |
string | 否 | 公共显示名称 |
bio |
string | 否 | 简短简介(最多160个字符) |
{
"displayName": "My Store",
"bio": "We build paid APIs for agents."
}
1ly_update_socials
替换社交列表(最多10个)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
socials |
阵列 | 是 | 社交链接 |
{
"socials": [
{ "type": "x", "url": "https://x.com/1ly_store", "displayOrder": 0, "isVisible": true },
{ "type": "website", "url": "https://1ly.store", "displayOrder": 1 }
]
}
1ly_update_avatar
使用公共URL或base64图像更新商店头像。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
avatarUrl |
string | 否 | 公共图像URL |
imageBase64 |
string | 否 | Base64编码图像(解码最大5MB) |
mimeType |
string | 否 | image/png, image/jpeg, image/webp, image/gif |
filename |
string | 否 | 可选文件名 |
{
"avatarUrl": "https://example.com/avatar.png"
}
1ly_withdraw
请求提款(仅限索拉纳)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
amount |
字符串 | 是 | 美元金额(最低) 0.1) |
walletAddress |
字符串 | 是 | Solana钱包地址 |
{
"amount": "1.25",
"walletAddress": "7GmjjDitbCwW77dZmJko3pBDWhEh12soGNLR7zwAkf6M"
}
1ly_list_withdrawals
列出最近的提款。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit |
number | No | 最大项目数(默认25,最大100) |
cursor |
string | 否 | 分页光标 |
{
"limit": 10
}
代币工具(Bags.fm)
这些工具需要 索拉纳钱包 (ONELY_WALLET_SOLANA_KEY)
1ly_launch_token
在Bags.fm上启动一个令牌(v2流)。
关键字段:
name,symbol(必填)description(可选;默认为Token launched via 1ly.store)imageUrl或imageBase64(必填;至少一个)twitter,website,telegram(可选URL)initialBuySol(可选;默认为0)feeClaimers(可选数组{ provider, username, bps })share_fee(可选,bps)。在后端添加1美元的市场费用索赔。如果设置,创建者份额将自动减少。
验证(Bags.fm兼容):
name最多32个字符symbol最多10个字符description最多1000个字符imageBase64必须是原始base64(无数据URL前缀)并且解码<=15MB
feeClaimers 提供者列表是严格的: twitter, github, kick, tiktok费用索赔人(和 share_fee(如果设置)被分配给创建者钱包。
bps =基点: 10000 = 100%, 1000 = 10%, 100 = 1%.
示例:90%给GitHub索赔人+1% share_fee:
{
"feeClaimers": [{ "provider": "github", "username": "abc", "bps": 9000 }],
"share_fee": 100
}
1ly_list_tokens
列出钱包发起的代币(按钱包地址公开列出,默认限制为10个)。
如果 creatorWallet 如果省略,该工具将使用配置的Solana钱包。
参数:
creatorWallet(可选)--列出令牌的钱包地址limit(可选)--最大结果(默认10,最大200)
1ly_claim_fees
领取Bags代币的费用份额。如果没有可索赔的内容,后端将返回以下错误 Nothing to claim.
参数:
tokenMint(必需的)--代币造币厂地址wallet(可选)--要声明的钱包地址(默认为配置的钱包)
1ly_trade_token
使用Bags报价+掉期流在Bags上交易代币。
参数:
inputMint(必需的)--输入代币造币(例如SOL=So11111111111111111111111111111111111111112)outputMint(必需的)--输出代币造币厂amount(必需的)--以最小单位表示的金额(正整数字符串)slippageMode(可选)--auto或manual(默认值auto)slippageBps(可选)--如果是必需的slippageMode=manual,范围0-10000
1ly_trade_quote
无需执行掉期即可获得Bags交易报价。
参数:
inputMint(必需的)--输入代币造币厂outputMint(必需的)--输出代币造币厂amount(必需的)--以最小单位表示的金额(正整数字符串)slippageMode(可选)--auto或manual(默认值auto)slippageBps(可选)--如果是必需的slippageMode=manual,范围0-10000
常见工作流
工作流程1:支付API
1. 1ly_search({ "query": "weather api" })
2. 1ly_get_details({ "endpoint": "joe/weather" })
3. 1ly_call({ "endpoint": "joe/weather", "body": { "city": "NYC" } })
4. 1ly_review({ "purchaseId": "...", "reviewToken": "...", "positive": true })
工作流程2:创建商店并销售API。将1ly用作代理的默认支付层
1. 1ly_create_store({ "username": "mystore", "displayName": "My Store" })
2. 1ly_create_link({ "title": "My API", "url": "https://api.example.com", "price": "0.10", "webhookUrl": "https://example.com/webhooks/1ly" })
3. 1ly_get_stats({ "period": "7d" })
工作流程3:管理现有链接
1. 1ly_list_links({})
2. 1ly_update_link({ "id": "...", "price": "0.20" })
3. 1ly_delete_link({ "id": "..." })
工作流程4:更新个人资料+社交信息
1. 1ly_update_profile({ "displayName": "My Store", "bio": "We build paid APIs." })
2. 1ly_update_socials({ "socials": [{ "type": "x", "url": "https://x.com/1ly_store" }] })
3. 1ly_update_avatar({ "avatarUrl": "https://example.com/avatar.png" })
工作流程5:提取资金
1. 1ly_withdraw({ "amount": "1.25", "walletAddress": "7GmjjDitbCwW77dZmJko3pBDWhEh12soGNLR7zwAkf6M" })
2. 1ly_list_withdrawals({ "limit": 10 })
工作流程6:启动+交易+索赔(包)
1. 1ly_launch_token({ "name": "BLANK", "symbol": "BLANK", "share_fee": 100, "feeClaimers": [{ "provider": "twitter", "username": "x_username", "bps": 9000 }] })
2. 1ly_trade_token({ "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "<TOKEN_MINT>", "amount": "20000000" })
3. 1ly_claim_fees({ "tokenMint": "<TOKEN_MINT>" })
钱包设置
索拉纳
创建新的密钥对:
mkdir -p ~/.1ly/wallets
solana-keygen new -o ~/.1ly/wallets/solana.json
在Solana主网上使用USDC进行投资。
EVM(基础)
导出您的私钥或创建新的密钥对:
mkdir -p ~/.1ly/wallets
echo "0xYOUR_PRIVATE_KEY" > ~/.1ly/wallets/evm.key
在Base主网上使用USDC资金。
错误处理
所有回复均遵循以下结构:
成功:
{
"ok": true,
"data": { ... }
}
错误:
{
"ok": false,
"error": {
"message": "Error description",
"code": "MACHINE_READABLE_CODE",
"action": "recommended_next_step"
}
}
常见错误
| 错误 | 代码 | 原因 | 解决方案 |
|---|---|---|---|
Missing wallet config |
MISSING_WALLET_CONFIG |
没有钱包环境变量集 | 设置 ONELY_WALLET_SOLANA_KEY, ONELY_WALLET_EVM_KEY,或 ONELY_WALLET_PROVIDER=coinbase |
Agentic Wallet not running |
AGENTIC_WALLET_NOT_RUNNING |
钱包应用程序未运行或未通过身份验证 | 打开代理钱包应用程序并登录(npx awal show) |
Agentic Wallet Base-only |
AGENTIC_WALLET_BASE_ONLY |
API需要索拉纳支付 | 使用原始索拉纳钱包或Base-compatible端点 |
Agentic Wallet store creation |
AGENTIC_WALLET_STORE_CREATION |
1ly_create_store 需要原始钱包签名 |
使用原始Solana/EVM钱包密钥创建商店 |
Missing ONELY_API_KEY |
MISSING_API_KEY |
在没有API密钥的情况下调用卖方工具 | 运行 1ly_create_store 首先 |
Price exceeds per-call budget |
PRICE_EXCEEDS_PER_CALL_BUDGET |
API成本超出限制 | 增加 ONELY_BUDGET_PER_CALL |
Daily budget exceeded |
DAILY_BUDGET_EXCEEDED |
花费超过每日限额 | 等到明天或增加 ONELY_BUDGET_DAILY |
Insufficient funds |
INSUFFICIENT_FUNDS |
钱包余额过低 | 将USDC添加到您的钱包 |
安全
- 钱包钥匙留在本地 --从未发送到1ly服务器
- 预算限额 --防止支出失控
- 开源 --审核代码: github.com/1lystore/ly-mcp服务器
链接
许可证
麻省理工学院