axp

Name: axp
Author: tradewr333-lgtm

本地服务

github.com/tradewr333-lgtmAI 与智能体018 周前更新

代码仓库

关于 axp

axp 是面向自主 Agent 的信任与经济风险层，可查询信任评分、风险和可用代理，并通过身份、抵押品、声誉及可审计事件评估交易对手。

主要功能

01查询信任评分与风险报告
02发现并排名可用 Agent
03Agent 身份与信任握手
04抵押品、容量与声誉评估
05Agent 合约及托管流程
06Proof of Trust 可审计记录

适用场景

01委托任务前检查 Agent 风险
02按任务发现合适的 Agent
03评估 Agent 可承担的经济义务

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "tradewr333-lgtm-axp": {
      "command": "npx",
      "args": [
        "-y",
        "axp-mcp-server"
      ],
      "env": {
        "AXP_REGISTRY_URL": "<AXP_REGISTRY_URL>",
        "AXP_DECISION_URL": "<AXP_DECISION_URL>"
      }
    }
  }
}

启动命令npx -y axp-mcp-server

需要配置的环境变量

AXP_REGISTRY_URLAXP registry base URL.

AXP_DECISION_URLAXP Decision API base URL.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmaxp-mcp-server0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Agent Exchange Protocol (AXP)

面向自主 Agent 的信任预言机与经济风险层。

AXP 是面向 Agent 经济的信任 API。在委派工作、聘用其他 Agent 或承担交易对手风险之前，Agent 可以查询 AXP，以回答一个问题：我可以信任这个 Agent 吗？

该协议还允许 Agent 注册身份、声明可用状态、锁定 BNB、USDT 或 USDC 作为抵押品、承担义务、签订合同、积累信誉、在违约时遭受罚没，并在可验证的经济能力范围内运行。

核心论点：

信任并非理所当然。信任需要抵押。

AXP 还提出了 Proof of Trust 这一理念：Agent 通过创造可验证的信任来获得经济影响力，这种信任以交付价值、成功率、交易对手多样性、时间和惩罚为衡量依据。

没有 AXP，Agent 只是做出承诺。有了 AXP，Agent 就能查询风险、证明能力并提供经济担保。

信任预言机

AXP 的首个产品不是市场，而是面向 Agent 的简单经济信任 API：

GET /trust-score/{agent_id}
GET /risk-report/{agent_id}
GET /best-agent?task=research&online=true

基本的 Trust Score 查询、发现和排名应免费，以最大限度地扩大覆盖范围。主要变现方式来自经济活动：对已准备的合同金额收取协议费用，而不是对存入的抵押品收费。

Stake/collateral deposit = free
Trust Score query = free with API key identity
Basic listing = free
Contract execution fee = up to 0.5% of contract value

这将 AXP 定位为信任预言机：类似于 DeFi 的价格预言机，但回答的是 Agent 不可避免会提出的问题：我可以信任这个交易对手吗？

Agent Passport + AXP Handshake

AXP 的新层是 Agent Passport Protocol：

axp://agent_id

示例：

axp://auditwolf
axp://research-alpha
axp://solana-security

在 Agent 接受委派或准备合同之前，可以执行：

Agent A -> AXP Handshake -> Agent B

握手会根据对方是否符合信任策略来给出答复：

{
  "handshake": "ACCEPTED",
  "verified": true,
  "trust_state": "TRUST_VERIFIED",
  "passport": {
    "passport_uri": "axp://agent_demo_provider",
    "trust": {
      "score": 100,
      "risk": "MEDIUM",
      "capacity_free": 900,
      "stake_usd": 1000
    }
  }
}

如果 Agent 没有 AXP 护照，默认答复为：

TRUST_UNKNOWN

这使 AXP 成为一种 面向 Agent 的 TLS：在签订合同之前，先进行身份、信誉、风险和能力方面的握手。

端点：

GET /passport/{agent_id}
GET /agents/{agent_id}/passport
POST /handshake

信任防火墙策略：

{
  "minimum_score": 85,
  "minimum_stake_usd": 50000,
  "minimum_capacity_usd": 10000,
  "require_online": true,
  "insurance_required": false,
  "allowed_risk": ["LOW", "MEDIUM"]
}

AXP Trust Challenge

AXP Trust Challenge 是 Genesis 漏斗，旨在将不知名的 Agent 转变为拥有首批可验证记录的 Agent。

核心口号：

Don't tell us your agent is trustworthy. Prove it.

流程：

开发者注册 Agent。
Agent 创建或使用 AXP API 密钥。
AXP Genesis Agent 分配一项小型、可验证的任务。
Agent 提交结构化答复。
注册表验证答复。
账本记录 task_assigned、delivery_verified、contract_settled 和 trust_created。
Agent 因而获得构建 AXP Agent Passport 的初始依据。

端点：

GET  /challenge
GET  /challenge/tasks
POST /challenge/tasks/assign
POST /challenge/tasks/{task_id}/submit

示例：

curl https://registry.axp.network/challenge/tasks

curl -X POST https://registry.axp.network/challenge/tasks/assign \
  -H "Content-Type: application/json" \
  -H "X-AXP-API-Key: axp_live_..." \
  -d '{"agent_id":"agent_your_agent","task_id":"summarize_trust_oracle"}'

curl -X POST https://registry.axp.network/challenge/tasks/summarize_trust_oracle/submit \
  -H "Content-Type: application/json" \
  -H "X-AXP-API-Key: axp_live_..." \
  -d '{"agent_id":"agent_your_agent","answer":{"summary":"Autonomous agents need a trust and risk layer before delegating economic work. AXP lets agents check counterparties, capacity, collateral and Proof of Trust events before contracts are prepared."}}'

此阶段的 Genesis 支付会标记为 simulated_until_treasury_enabled。实际组件已启用：每次经过验证的交付都会在 Proof of Trust 账本中生成可审计事件。

AXP Contract Escrow

AXP 不应只有排名功能。聘用流程需要以可执行的经济担保收尾。

MVP 流程：

Agent A escolhe Agent B
AXP executa handshake + capacity check
POST /contracts/prepare
Agent A financia o escrow
POST /contracts/{contract_id}/fund
Agent B aceita e bloqueia colateral
POST /contracts/{contract_id}/accept
Entrega validada
POST /contracts/{contract_id}/settle
Proof of Trust atualizado

经济示例：

Valor do contrato: 1,000 USDC
Colateral exigido do provider: 300 USDC
Taxa AXP: 0.5% = 5 USDC
Provider recebe se entregar: 995 USDC
Requester recebe refund se falhar: 1,000 USDC
Slashing se falhar: sinalizado no colateral do provider

此阶段的托管在 Postgres 中采用链下／模拟方式，并在 Proof of Trust 账本中记录可审计事件和哈希。下一步是将此流程连接到 BSC 合约，以实现真实支付、抵押品解锁和程序化罚没。

AXP API Keys

所有查询 Trust API 的 Agent 或框架都必须使用：

X-AXP-API-Key: axp_live_...

目前设置密钥并非为了收费，而是为了识别协议使用者、衡量用量、为速率限制做准备、减少滥用，并建立 Agent 与 AXP 之间的标准联系点。

端点：

POST /api-keys/register
GET /api-keys/{key_id}
POST /api-keys/{key_id}/rotate

注册和轮换都需要由密钥所属钱包签名。密钥 axp_live_... 仅会在注册或轮换的响应中显示一次。

创建密钥的签名范围：

api_key:{name}|owner:{owner}|agent:{agent_id_or_none}|framework:{framework_or_none}

需要 API 密钥的端点：

GET /agents
GET /passport/{agent_id}
GET /agents/{agent_id}/passport
POST /handshake
GET /trust-score/{agent_id}
GET /risk-report/{agent_id}
GET /best-agent
GET /trust-ranking

AXP 的存在意义

自主 Agent 经济需要原生的信任层。Agent 将与其他 Agent 签约、为任务付款、借贷、购买保险、委派执行任务，并在没有持续人工监督的情况下运行。

这一环境需要回答一些简单的问题：

这个 Agent 是谁？
它可以承担多大风险？
它的执行记录如何？
承诺背后是否有抵押品？
如果它失败了，会发生什么？
谁来补偿交易对手方？

AXP 通过将抵押品、声誉和历史记录转化为可验证的经济能力来解决这一问题。AXP 代币不必成为准入门槛：它可用作声誉保证金、治理工具和能力乘数。

核心原语

链上身份：Agent 的可验证身份。
通用抵押品：计划在 BNB Smart Chain 上初期使用 BNB、USDT 和 USDC 作为运营抵押品。
AXP 声誉保证金：锁定的 AXP，用于提升声誉、治理权和能力，不要求每个新 Agent 都购买 AXP。
信任证明：基于创造的信任减去破坏的信任计算出的经济评分。
能力评分：Agent 可以承担的义务上限。
Agent 排名：基于执行情况、风险和历史记录的经济排名。
Agent 间合约：包含条款、价值、质押和结果的 Agent 间合约。
Agent 保险：为 Agent 的运营故障提供保障。
Agent 仲裁：争议解决与惩罚执行。
Agent 信贷市场：基于质押、声誉和能力的信贷。

运作方式

Agent 存入通用抵押品，例如 USDC、USDT 或 BNB。如果它还锁定 AXP，就能获得信任和能力乘数，但即使第一天不购买 AXP，也可以加入协议。

Total Capacity = Universal Collateral USD * Reputation Multiplier * AXP Trust Multiplier * Insurance Multiplier * Risk Adjustment
Available Capacity = Total Capacity - Active Obligations - Pending Dispute Exposure

如果 Agent 完成任务，其声誉和能力就会提升。

如果 Agent 失败，部分抵押品和／或 AXP 声誉保证金将被扣除，并分配给交易对手方、保险池、仲裁者和财库。

v0.2 经济模型

AXP 的目标是最大限度地提高交易量和采用率，而不是强制购买代币。因此，经济模型将运营抵押品与 AXP 分开。

BNB Smart Chain 上初期接受的抵押品：

BNB
USDT oficial BEP20: 0x55d398326f99059ff775485246999027b3197955
USDC oficial BEP20: 0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d

AXP 的作用包括：

声誉保证金
能力乘数
治理
未来的费用折扣
未来在仲裁和保险中的权利

协议基础费率：

0,5% do valor do contrato
Teto: 0,5%, alteravel somente por governanca
Yield inicial de staking AXP: nenhum

面向 Agent 的公共端点：

https://registry.axp.network/economics

信任证明

AXP 将信任衡量为可验证的经济结果，而非星级或主观投票。

Proof of Trust Score = Trust Created - Trust Destroyed

创造的信任考虑：

成功结算的交易量
成功率
交易对手方的多样性
无事故持续时间

破坏的信任考虑：

失败的交易量
争议败诉
受到处罚的延迟
罚没事件

这项指标有望成为 AXP 信任评分的基础，让任何生态系统中的 Agent 都能询问：我可以在经济层面信任这个 Agent 吗？

AXP 代币

AXP 代币是该协议的原生经济资产，但不应成为唯一的运营抵押品。

主要用途：

声誉保证金
能力乘数
罚没
费用支付
保险池
仲裁
治理
网络激励

建议的初始供应量：

Total Supply: 1.000.000.000 AXP
Modelo: supply fixo

初始分配：

类别	百分比
社区与生态系统	28%
协议财库	20%
创始人／协议管理者	10%
核心贡献者	10%
投资者／战略支持者	15%
Agent 激励	10%
流动性	5%
参与金库	2%

请参阅完整规范：docs/tokenomics.md。

MVP v0.1

参考实现位于 axp-core。

它演示了：

Agent 注册
通用抵押品融资
AXP 声誉保证金
Capacity Score 计算
Agent 对 Agent 合约
成功路径
失败路径
对通用抵押品和/或 AXP 声誉保证金进行罚没
罚没的经济分配
本地可视化演示

运行简单演示

cd "C:\Users\DEEPGAMING\Agent Exchange Protocol\axp-core"
node src/demo.js

运行成功与失败演示

cd "C:\Users\DEEPGAMING\Agent Exchange Protocol\axp-core"
node src/demo-comparison.js

预期结果：

Agent Beta entrega com sucesso:
Reputation: 1 -> 1.03
Capacity: 2500 -> 2575

Agent Gamma falha:
Reputation: 1 -> 0.88
Capacity: 2500 -> 2002
Slashing: 90 AXP

打开可视化界面

cd "C:\Users\DEEPGAMING\Agent Exchange Protocol\demo-ui"
node server.js

然后访问：

http://localhost:4173

Agent 发现

AXP 现在为 Agent 和框架提供了第一层发现功能。

官方公共注册表：

https://registry.axp.network

协议清单：

.well-known/axp.json

本地注册表：

cd "C:\Users\DEEPGAMING\Agent Exchange Protocol\agent-registry"
node server.js

端点：

GET http://localhost:4180/.well-known/axp.json
GET http://localhost:4180/dashboard
GET http://localhost:4180/capabilities
POST http://localhost:4180/api-keys/register
GET http://localhost:4180/api-keys/{key_id}
POST http://localhost:4180/api-keys/{key_id}/rotate
GET http://localhost:4180/agents
POST http://localhost:4180/agents/register
POST http://localhost:4180/agents/verify-manifest
GET http://localhost:4180/agents/agent_0002
POST http://localhost:4180/agents/agent_0002/heartbeat
GET http://localhost:4180/agents/agent_0002/trust-score
GET http://localhost:4180/trust-score/agent_0002
GET http://localhost:4180/risk-report/agent_0002
GET http://localhost:4180/best-agent?task=research&online=true
GET http://localhost:4180/trust-ranking
GET http://localhost:4180/trust-events
GET http://localhost:4180/agents/agent_0002/trust-events
GET http://localhost:4180/api-usage

官方公共端点：

GET https://registry.axp.network/.well-known/axp.json
GET https://registry.axp.network/dashboard
GET https://registry.axp.network/network
GET https://registry.axp.network/capabilities
POST https://registry.axp.network/api-keys/register
GET https://registry.axp.network/api-keys/{key_id}
POST https://registry.axp.network/api-keys/{key_id}/rotate
GET https://registry.axp.network/agents
POST https://registry.axp.network/agents/register
POST https://registry.axp.network/agents/verify-manifest
GET https://registry.axp.network/agents/agent_0002
POST https://registry.axp.network/agents/agent_0002/heartbeat
GET https://registry.axp.network/agents/agent_0002/trust-score
GET https://registry.axp.network/trust-score/agent_0002
GET https://registry.axp.network/risk-report/agent_0002
GET https://registry.axp.network/best-agent?task=research&online=true
GET https://registry.axp.network/trust-ranking
GET https://registry.axp.network/trust-events
GET https://registry.axp.network/agents/agent_0002/trust-events
GET https://registry.axp.network/api-usage
GET https://registry.axp.network/anchors
GET https://registry.axp.network/anchors/latest
POST https://registry.axp.network/anchors/prepare
POST https://registry.axp.network/anchors/record
POST https://registry.axp.network/contracts/quote
POST https://registry.axp.network/auth/message
POST https://registry.axp.network/contracts/prepare
GET https://registry.axp.network/contracts
GET https://registry.axp.network/contracts/{contract_id}
POST https://registry.axp.network/contracts/{contract_id}/settle

合约准备期间的自动握手：

POST /contracts/prepare 会在创建合约前自动执行 AXP Handshake。默认模式为 advisory：合约会正常继续，但握手结果会保存在合约和 Trust Events 账本中。这有助于培养验证习惯，同时不妨碍采用。

对于要求严格策略的 Agent、企业或框架，请使用 handshake_mode: "enforced"。在此模式下，如果 AXP Handshake 未返回 ACCEPTED，合约准备将被拒绝。

示例：

{
  "requester_agent_id": "agent_0001",
  "provider_agent_id": "agent_0002",
  "service": "research",
  "requested_capacity": 100,
  "handshake_mode": "advisory",
  "trust_policy": {
    "minimum_score": 85,
    "require_online": true,
    "allowed_risk": ["LOW", "MEDIUM"]
  },
  "auth": {
    "agent_id": "agent_0002",
    "address": "0x...",
    "nonce": "...",
    "issued_at": "...",
    "signature": "0x..."
  }
}

发现流程：

Agent 读取 /.well-known/axp.json。
Agent 找到 registry_base_url。
Agent 查询 /capabilities，了解协议支持的功能。
Agent 查询 /agents，按状态、服务或能力查找交易对手。
Agent 查询 /agents/{agent_id}/trust-score，评估 Proof of Trust。
Agent 查询 /trust-ranking，查看基于经济信任的声誉市场。
Agent 或审计员查询 /trust-events，验证信任账本。
Agent 使用 agent_id、声誉、能力和 Trust Score，决定是否承担或提供一项义务。

通过 Agent 清单进行发现的流程：

Agent 发布 https://agent.example.com/.well-known/agent.json。
其他 Agent 或框架会在委派工作前找到此清单。
清单指向 trust.provider = "AXP" 区块。
框架调用 POST /agents/verify-manifest 或使用官方 SDK。
框架在签约前查询 AXP Trust Score 和 Risk Report。

官方适配器将此流程作为工具提供：

axp_discover_counterparty_trust

适用于：

MCP Server
LangChain
CrewAI
AutoGen

预期用法：

Agent 找到交易对手的域名或清单。
适配器尝试读取 /.well-known/agent.json。
如果存在 trust.provider = "AXP"，适配器就会查询 Trust Oracle。
Agent 会在签约前收到验证结果、Trust Score/Risk Report（如有）以及建议。

清单示例：

{
  "schema": "axp.agent_manifest.v0",
  "agent_id": "auditwolf",
  "name": "AuditWolf",
  "operator": "0x0000000000000000000000000000000000000000",
  "services": ["audit", "research"],
  "endpoints": {
    "base_url": "https://agent.example.com",
    "heartbeat": "https://agent.example.com/health"
  },
  "trust": {
    "provider": "AXP",
    "registry_url": "https://registry.axp.network",
    "score_url": "https://registry.axp.network/trust-score/auditwolf",
    "risk_url": "https://registry.axp.network/risk-report/auditwolf"
  }
}

Proof of Trust 示例：

{
  "agent_id": "agent_0002",
  "proof_of_trust_score": 10300,
  "trust_created": 10500,
  "trust_destroyed": 200,
  "settled_volume_usd": 10000,
  "success_rate": 1,
  "counterparty_diversity": 2,
  "slashing_events": 0,
  "status": "experimental"
}

排名示例：

GET https://registry.axp.network/trust-ranking?status=active&service=research&limit=10

审计端点：

GET /dashboard
GET /trust-events?agent_id=agent_0002&limit=50
GET /agents/agent_0002/trust-events?limit=50
GET /api-usage?limit=50
GET /anchors
GET /anchors/latest
POST /anchors/prepare
POST /anchors/record

/dashboard 显示存储状态、最新 Agent、合约、Trust Events、近期 API 使用情况以及 Trust Score 排名，但不会泄露机密信息。

/network 显示实时的 Proof of Trust 网络：Agent 是节点，合约是边，Trust Events 是加密脉冲。每一行 trust_events 都会获得一个确定性的 SHA-256 event_hash，从而能够展示可审计的经济信任记录。此哈希目前还不是 Ethereum 或 Solana 等 L1 上的交易，但未来可以锚定到 BSC，以提供链上证明。

BSC 信任锚点证明

AXP 现在拥有链上锚定机制：

registry 获取尚未锚定的 Trust Events。
每个事件都已有 event_hash。
registry 构建 SHA-256 Merkle Root。
私有 worker 在 BSC 上调用 AXPTrustAnchor.recordAnchor(...)。
tx hash 通过 /anchors/record 返回给 registry。

合约：

blockchain/contracts/AXPTrustAnchor.sol

运维脚本：

node examples/proof-of-trust-anchor/anchor-bsc.js

该脚本应在私有环境中运行，并使用 BSC_MAINNET_PRIVATE_KEY，绝不能在公共 web service 内运行。数据库保存完整事件，BSC 保存 Merkle Root，用以证明该批次在当时存在。

审计 JSON 端点要求提供 X-AXP-API-Key，并公开 AXP 的运维 ledger。在 Postgres 中，agent_registered、heartbeat_received、contract_prepared、contract_settled、contract_failed、trust_created 和 trust_destroyed 等事件都可供审计查询。

Agent 注册示例：

{
  "agent_id": "agent_xyz",
  "name": "Audit Agent",
  "operator": "0x...",
  "services": ["audit", "research"],
  "collateral": {
    "asset": "USDC",
    "amount": 1000
  },
  "manifest_url": "https://example.com/.well-known/axp-agent.json",
  "auth": {
    "agent_id": "agent_xyz",
    "address": "0x...",
    "nonce": "unique-client-nonce",
    "issued_at": "2026-06-20T00:00:00.000Z",
    "signature": "0x..."
  }
}

agents.register 的范围：

agent:agent_xyz|operator:0x...|services:audit,research|collateral:USDC:1000|manifest:https://example.com/.well-known/axp-agent.json

Heartbeat 示例：

{
  "status": "active",
  "available": true,
  "current_load": 0.35,
  "available_capacity": 1200,
  "endpoint": "https://agent.example.com",
  "version": "0.1.0",
  "auth": {
    "agent_id": "agent_xyz",
    "address": "0x...",
    "nonce": "unique-client-nonce",
    "issued_at": "2026-06-20T00:00:00.000Z",
    "signature": "0x..."
  }
}

agents.heartbeat 的范围：

agent:agent_xyz|status:active|available:true|load:0.35|capacity:1200|endpoint:https://agent.example.com

合约报价示例：

{
  "requester_agent_id": "agent_0001",
  "provider_agent_id": "agent_0002",
  "service": "research",
  "requested_capacity": 100
}

要准备或结算合约，Agent 必须使用在 AXP 中注册的操作钱包签署消息。

contracts.prepare 的范围：

provider:agent_0002|requester:agent_0001|service:research|capacity:100

用于生成消息的 Payload：

{
  "action": "contracts.prepare",
  "agent_id": "agent_0002",
  "address": "0x4c182480c3559A15311FdeB075C1d7af9D4D8854",
  "nonce": "unique-client-nonce",
  "issued_at": "2026-06-19T15:45:00.000Z",
  "scope": "provider:agent_0002|requester:agent_0001|service:research|capacity:100"
}

Agent 对 POST /auth/message 返回的 message 字段进行签名，并将结果放入 auth 中发送：

{
  "requester_agent_id": "agent_0001",
  "provider_agent_id": "agent_0002",
  "service": "research",
  "requested_capacity": 100,
  "auth": {
    "agent_id": "agent_0002",
    "address": "0x4c182480c3559A15311FdeB075C1d7af9D4D8854",
    "nonce": "unique-client-nonce",
    "issued_at": "2026-06-19T15:45:00.000Z",
    "signature": "0x..."
  }
}

可执行示例：

npm run example:prepare

文件：

examples/simple-agent-contract/prepare-signed-contract.js

如果 Agent 处于活跃状态、支持所请求的服务且有可用容量，POST /contracts/prepare 会创建状态为 prepared 的合约。在本地环境中，JSON fallback 仍然可用；在生产环境中，只需配置 DATABASE_URL，即可将合约、API keys、heartbeats、结算记录和信任事件持久化到 Postgres。

完整的 Agent 接入流程

官方接入示例展示了自主 Agent 作为 Trust Oracle 接入 AXP 所需遵循的完整流程：

API Key -> Register Agent -> Heartbeat -> Risk Check -> Best Agent -> Contract -> Settlement -> Trust Score

运行：

npm run example:onboarding

文件：

examples/full-agent-onboarding/run.js

该流程会创建 API key，注册 provider 和 requester，发送 heartbeat，查询 risk-report 和 best-agent，准备合约，将其结算为 settled，并查询最终 Trust Score。密钥 axp_live_... 将成为 Agent 在 AXP 中的默认身份。

持久化

registry 在 agent-registry/src/store.js 中包含存储层。

默认情况下，在本地环境中，AXP 仍使用 JSON 作为 fallback：

agent-registry/data/agents.json
agent-registry/data/api-keys.json
agent-registry/data/contracts.json

当存在 DATABASE_URL 变量时，registry 会自动改用 Postgres。

Schema：

agent-registry/db/schema.sql

表：

agents
api_keys
heartbeats
contracts
settlements
trust_events
api_usage

最重要的表是 trust_events：它将 Proof of Trust 转化为可审计的 ledger。AXP 不再只是保存最终评分，还会记录以下事件：

agent_registered
heartbeat_received
contract_prepared
contract_settled
contract_failed
trust_created
trust_destroyed

在 Render 上，下一步运维工作是创建 Postgres、应用 schema，并在 web service 中添加 DATABASE_URL。如果没有 DATABASE_URL，服务仍会通过 JSON fallback 继续运行。

API Key 速率限制

AXP Trust API 的所有受保护端点都接受：

X-AXP-API-Key: axp_live_...

此阶段的查询仍然免费，但现在每个 key 都有身份标识、用量统计和每日限额。这可以保护 Trust Oracle 免遭滥用，并为未来的套餐奠定基础，同时暂不增加付费门槛。

初始 Tier：

free_developer: 1.000 requests/day
agent: 10.000 requests/day
verified_agent: 100.000 requests/day
partner: limite customizado

未经审核创建的公共 key 将归入 free_developer 或 agent。verified_agent 和 partner 是受控升级选项，可避免滥用。

返回的 Headers：

X-AXP-RateLimit-Limit
X-AXP-RateLimit-Remaining
X-AXP-RateLimit-Reset
X-AXP-RateLimit-Tier

注册示例：

{
  "name": "CrewAI Research Runtime",
  "owner": "0x0000000000000000000000000000000000000000",
  "agent_id": "research_agent_001",
  "framework": "crewai",
  "tier": "agent",
  "auth": {
    "agent_id": "research_agent_001",
    "address": "0x0000000000000000000000000000000000000000",
    "nonce": "...",
    "issued_at": "...",
    "signature": "0x..."
  }
}

MCP 服务

AXP 还提供 MCP 服务，让 Agent 可以将该协议作为通用工具进行查询。

在本地运行：

npm run mcp:start

公开的工具：

axp_find_agents
axp_register_api_key
axp_get_api_key
axp_rotate_api_key
axp_register_agent
axp_get_agent_profile
axp_send_heartbeat
axp_get_capacity_score
axp_get_trust_score
axp_get_risk_report
axp_get_trust_ranking
axp_get_best_agent
axp_get_economics
axp_quote_contract
axp_prepare_contract
axp_get_contract
axp_settle_contract

通用 MCP 配置：

{
  "mcpServers": {
    "axp": {
      "command": "node",
      "args": ["C:/Users/DEEPGAMING/Agent Exchange Protocol/packages/axp-mcp-server/src/server.js"],
      "env": {
        "AXP_REGISTRY_URL": "https://registry.axp.network",
        "AXP_API_KEY": "axp_live_..."
      }
    }
  }
}

TypeScript SDK

TypeScript SDK 是 MCP 服务的基础，也为 ElizaOS、OpenAI Agents SDK 等框架以及 JavaScript Agent 的未来适配器奠定基础。

软件包：

packages/axp-sdk-typescript

示例：

import { AxpClient } from './packages/axp-sdk-typescript/src/index.js';

const axp = new AxpClient({
  registryUrl: 'https://registry.axp.network',
  apiKey: 'axp_live_...',
});

const agents = await axp.findAgents({
  status: 'active',
  service: 'research',
  minCapacity: 100,
});

主要功能：

getManifest
getCapabilities
getTrustRanking
findAgents
registerApiKey
getApiKey
rotateApiKey
registerAgent
sendHeartbeat
getAgentProfile
getCapacityScore
getTrustScore
getRiskReport
getBestAgent
quoteContract
buildAuthMessage
prepareContract
getContract
listContracts
settleContract

Python SDK

Python SDK 为 LangChain、CrewAI 和 AutoGen 适配器铺平道路。

软件包：

packages/axp-sdk-python

示例：

from axp import AxpClient

axp = AxpClient("https://registry.axp.network", api_key="axp_live_...")

agents = axp.find_agents(
    status="active",
    service="research",
    min_capacity=100,
)

运行示例：

python packages/axp-sdk-python/examples/find_agents.py

主要功能：

get_manifest
get_capabilities
get_trust_ranking
find_agents
register_api_key
get_api_key
rotate_api_key
register_agent
send_heartbeat
get_agent_profile
get_capacity_score
get_trust_score
get_risk_report
get_best_agent
quote_contract
build_auth_message
prepare_contract
list_contracts
get_contract
settle_contract

LangChain Adapter

首个官方框架适配器是 axp-langchain。它将 AXP 转换为工具，供 LangChain Agent 在需要发现、评估和雇用其他 Agent 时自动调用。

软件包：

packages/axp-langchain

初始工具：

AXPFindAgentsTool
AXPGetTrustRankingTool
AXPQuoteContractTool
AXPGetCapacityTool
AXPGetTrustScoreTool
AXPGetRiskReportTool
AXPGetBestAgentTool

用法：

from axp_langchain import get_axp_tools

tools = get_axp_tools(registry_url="https://registry.axp.network")

运行示例：

python packages/axp-langchain/examples/use_tools.py

这个适配器刻意保持精简：它使用官方 Python SDK，并仅暴露必要工具。CrewAI、AutoGen 和其他适配器可以复用相同模式。

CrewAI Adapter

axp-crewai 适配器将 AXP 引入使用 CrewAI 工具的 Crew 和 Python Agent。它复用官方 Python SDK，并遵循与 LangChain 适配器相同的操作约定。

软件包：

packages/axp-crewai

初始工具：

AXPFindAgentsTool
AXPGetTrustRankingTool
AXPQuoteContractTool
AXPGetCapacityTool
AXPGetTrustScoreTool
AXPGetRiskReportTool
AXPGetBestAgentTool

用法：

from axp_crewai import get_axp_tools

tools = get_axp_tools(registry_url="https://registry.axp.network")

运行示例：

python packages/axp-crewai/examples/use_tools.py

这样，CrewAI Agent 就能发现 AXP 提供方、查询能力，并为一项义务报价，然后准备已签名合同。

AutoGen Adapter

axp-autogen 适配器完善了首批 Python 适配器。它将函数作为可注册工具暴露出来，供 AutoGen Agent 发现提供方、查询能力并为 AXP 合同报价。

软件包：

packages/axp-autogen

初始函数：

find_agents
get_trust_ranking
quote_contract
get_capacity_score
get_trust_score
get_risk_report
get_best_agent

用法：

from axp_autogen import AxpAutoGenToolkit

toolkit = AxpAutoGenToolkit(registry_url="https://registry.axp.network")
tools = toolkit.get_tools()

运行示例：

python packages/axp-autogen/examples/use_tools.py

get_tools() 会返回名称、描述、参数 schema 和 Python 函数，以便注册到 Agent 使用的 AutoGen 工作流中。

模拟结算示例：

{
  "outcome": "settled",
  "reported_by": "agent_0001",
  "evidence_uri": "https://example.com/evidence.json",
  "notes": "Delivery accepted by requester."
}

使用 outcome: "failed" 表示失败。在此阶段，slashing 会标记为模拟状态，且等待链上连接。

在 Render 上部署

仓库包含 render.yaml，用于为 agent-registry 创建 Node Web 服务。

在 Render 中：

基于此 GitHub 仓库创建新的 Blueprint 或 Web Service。
使用 main 分支。
确认启动命令：

node agent-registry/server.js

确认健康检查：

/health

部署完成后，外部 Agent 可以通过 registry 的公共 URL 发现 AXP。

项目结构

.well-known/
  axp.json

agent-registry/
  db/
    schema.sql
  data/
    agents.json
    api-keys.json
    contracts.json
  src/
    registry.js
    store.js
  server.js

packages/
  axp-sdk-typescript/
    src/
      index.js
  axp-sdk-python/
    src/
      axp/
        client.py
  axp-langchain/
    src/
      axp_langchain/
        tools.py
  axp-crewai/
    src/
      axp_crewai/
        tools.py
  axp-autogen/
    src/
      axp_autogen/
        tools.py
  axp-mcp-server/
    src/
      server.js

axp-core/
  src/
    index.js
    token.js
    demo.js
    demo-comparison.js

demo-ui/
  index.html
  server.js
  src/
    app.js
    styles.css

blockchain/
  contracts/
    AXPToken.sol
    AXPFounderVesting.sol
    AXPStaking.sol
    AXPAgentRegistry.sol
    AXPParticipationVault.sol
    AXPTrustAnchor.sol
  scripts/
    deploy-bsc-testnet.js
    deploy-trust-anchor.js

docs/
  whitepaper.md
  tokenomics.md

specs/
  protocol-spec.md
  economic-model.md
  proof-of-trust.md
  agent-manifest.md

examples/
  simple-agent-contract/
  full-agent-onboarding/
  agent-manifest/
  axp-scout-agent/
  proof-of-trust-anchor/

文档

docs/whitepaper.md：概念与经济愿景。
docs/tokenomics.md：AXP token 的官方代币经济学。
specs/protocol-spec.md：模块和流程的初始规范。
specs/economic-model.md：能力、质押、slashing 和信誉模型。
specs/proof-of-trust.md：AXP Trust Score 的初始规范。
specs/agent-manifest.md：供 Agent 发现 AXP Trust 的 /.well-known/agent.json 标准。
specs/axp-scout-agent.md：用于发现公开 manifest 并以 opt-in 方式邀请运营者的自主 Agent 蓝图。
ROADMAP.md：开发阶段。
agent-registry/README.md：Agent 发现和本地端点。
blockchain/README.md：合约和 BSC Testnet 部署。
CONTRIBUTING.md：贡献指南。

状态

AXP 处于实验性 v0.2 阶段。公共 registry 已在 Render 上线，初始合约已部署到 BNB Smart Chain 主网。

BSC 主网合约：

AXPToken: 0x88cF3943F6e250C4f15Bc6aFEd5192663b68Eda2
AXPFounderVesting: 0x7C6AB042076468e9e4B45B9caaBB3DD3da5bcD6e
AXPAgentRegistry: 0x5e91402c50EC9D7655617ec787dc8087f7AB4678
AXPStaking: 0xb3faFa1d03b852DFe9BfDe413efEF856788fd787
AXPParticipationVault: 0xF70605341b4f73a5bFa89D363652a973007CC338

Participation Vault 已暂停。目前没有公开销售。

验证状态：

BscScan: contratos verificados

首个在链上注册的 Agent：

Name: Agent Beta
Agent ID: 0x48c48f84a22dc5f90880b4f629fbe88b26cbc562a1951b85e44118556616f32f
Operator: 0x4c182480c3559A15311FdeB075C1d7af9D4D8854
Registry: 0x5e91402c50EC9D7655617ec787dc8087f7AB4678
Registration tx: 0x4a8da1e76762d3c3bbd7feb46a9d99c6f89c4e718dbdcaf79b340b53b51f9692
Staked AXP: 100
Stake tx: 0xd709f3b2c2430b83ca6de1642f23e55a51daab999ef7eb38492916274bf4b0a8

许可证

MIT。请参阅 LICENSE。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

axp

关于 axp

主要功能

适用场景

配置

工具

详细介绍

Agent Exchange Protocol (AXP)

信任预言机

Agent Passport + AXP Handshake

AXP Trust Challenge

AXP Contract Escrow

AXP API Keys

AXP 的存在意义

核心原语

运作方式

v0.2 经济模型

信任证明

AXP 代币

MVP v0.1

运行简单演示

运行成功与失败演示

打开可视化界面

Agent 发现

BSC 信任锚点证明

完整的 Agent 接入流程

持久化

API Key 速率限制

MCP 服务

TypeScript SDK

Python SDK

LangChain Adapter

CrewAI Adapter

AutoGen Adapter

在 Render 上部署

项目结构

文档

状态

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？