API支付服务

MCP服务器为AI代理提供加密货币支付API的功能,支持Solana和Base网络,适用于API的买卖和令牌交易。

  • by 1lystore
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 1lystore/1ly-mcp-server

使用说明

@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代理钱包应用程序正在运行并经过身份验证。

如果您尚未安装代理钱包:

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——通过用户界面(无需钱包):

  1. 首选 1ly.store 并登录
  2. 打开设置→ 启用 开发者模式
  3. 从仪表板创建API键
  4. 设置为 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添加到您的钱包

安全


链接

许可证

麻省理工学院