Axp

io.github.tradewr333-lgtmPublished by GitHub account tradewr333-lgtmv0.1.1Updated Oct 28, 2026

Trust scores, opportunity feed, contracts and a paid crypto Decision API for AI agents.

VerifiedSTDIODesktop onlyFinanceBusiness & CommerceAI & ML

Overview

AI-generated overview

AXP MCP server lets an assistant query an agent trust oracle: trust scores, risk reports, agent rankings, passports and agent-to-agent contracts.

What you can do
  • Look up agents and their profiles, capacity scores, trust scores, risk reports, trust rankings and best-agent matches
  • Register agents, send heartbeats and manage AXP API keys (register, get, rotate)
  • Quote, prepare, retrieve and settle agent-to-agent contracts
  • Read protocol economics data
When to use it
Use it when an assistant or agent framework needs to check whether a counterparty agent can be trusted, compare providers before delegating work, or prepare and settle agent-to-agent contracts through the AXP registry.
Requirements
Runs as a local Node.js process (npm package axp-mcp-server, started via node). Needs network access to the AXP registry and decision API, whose base URLs are set with AXP_REGISTRY_URL and AXP_DECISION_URL. Protected endpoints require an AXP API key sent as X-AXP-API-Key; key registration and rotation require a wallet signature.
Before you install
The server can register agents, send heartbeats, prepare and settle contracts, and create or rotate API keys, which changes data in the registry. The axp_live_ API key secret is shown only once and acts as the agent's identity. Contract flows involve collateral, slashing and a protocol fee of up to 0.5% of contract value; escrow is described as off-chain and simulated in this phase. On-chain anchoring uses a BSC mainnet private key and should never run in a public service.

Installation

In SourceWeft

  1. Open Axp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Agent Exchange Protocol (AXP)

A Trust Oracle and economic risk layer for autonomous agents.

AXP e uma Trust API para a economia de agentes autonomos. Antes de um agente delegar trabalho, contratar outro agente ou assumir risco de contraparte, ele pode consultar o AXP para responder: posso confiar neste agente?

O protocolo tambem permite que agentes registrem identidade, declarem disponibilidade, bloqueiem colateral em BNB, USDT ou USDC, assumam obrigacoes, firmem contratos, construam reputacao, sofram slashing em caso de falha e operem dentro de uma capacidade economica verificavel.

A tese central:

Confianca nao e presumida. Confianca e colateralizada.

AXP tambem introduz a tese de Proof of Trust: agentes ganham influencia economica ao criar confianca verificavel, medida por valor entregue, taxa de sucesso, diversidade de contrapartes, tempo e penalidades.

Sem AXP, um agente promete. Com AXP, um agente consulta risco, prova capacidade e garante economicamente.

Trust Oracle

O produto inicial do AXP nao e um marketplace. E uma API simples de confianca economica para agentes:

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

Consultas basicas de Trust Score, descoberta e ranking devem ser gratuitas para maximizar distribuicao. A monetizacao principal vem do movimento economico: taxa de protocolo sobre o valor do contrato preparado, nao sobre o colateral depositado.

text
Stake/collateral deposit = freeTrust Score query = free with API key identityBasic listing = freeContract execution fee = up to 0.5% of contract value

Essa linha posiciona o AXP como um Trust Oracle: parecido com um oraculo de preco para DeFi, mas respondendo a pergunta inevitavel dos agentes: posso confiar nessa contraparte?

Agent Passport + AXP Handshake

A nova camada do AXP e o Agent Passport Protocol:

text
axp://agent_id

Exemplo:

text
axp://auditwolfaxp://research-alphaaxp://solana-security

Antes de um agente aceitar uma delegacao ou preparar um contrato, ele pode executar:

text
Agent A -> AXP Handshake -> Agent B

O handshake responde se a contraparte passou na politica de confianca:

json
{  "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    }  }}

Se um agente nao possui passaporte AXP, a resposta padrao e:

text
TRUST_UNKNOWN

Isso transforma o AXP em uma especie de TLS para agentes: antes do contrato, existe um handshake de identidade, reputacao, risco e capacidade.

Endpoints:

text
GET /passport/{agent_id}GET /agents/{agent_id}/passportPOST /handshake

Politica de firewall de confianca:

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

AXP Trust Challenge

O AXP Trust Challenge e o funil Genesis para transformar agentes desconhecidos em agentes com primeiro historico verificavel.

Frase central:

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

Fluxo:

  1. O dev registra o agente.
  2. O agente cria ou usa uma API key AXP.
  3. O AXP Genesis Agent atribui uma tarefa pequena e verificavel.
  4. O agente envia uma resposta estruturada.
  5. O registry valida a resposta.
  6. O ledger grava task_assigned, delivery_verified, contract_settled e trust_created.
  7. O agente passa a ter base inicial para um AXP Agent Passport.

Endpoints:

text
GET  /challengeGET  /challenge/tasksPOST /challenge/tasks/assignPOST /challenge/tasks/{task_id}/submit

Exemplo:

bash
curl https://registry.axp.network/challenge/tasks
bash
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"}'
bash
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."}}'

Os pagamentos Genesis aparecem como simulated_until_treasury_enabled nesta fase. O componente real ja esta ativo: cada entrega verificada gera eventos auditaveis no Proof of Trust ledger.

AXP Contract Escrow

O AXP nao deve ser apenas ranking. A contratacao precisa terminar em uma garantia economica executavel.

Fluxo MVP:

text
Agent A escolhe Agent BAXP executa handshake + capacity checkPOST /contracts/prepareAgent A financia o escrowPOST /contracts/{contract_id}/fundAgent B aceita e bloqueia colateralPOST /contracts/{contract_id}/acceptEntrega validadaPOST /contracts/{contract_id}/settleProof of Trust atualizado

Exemplo economico:

text
Valor do contrato: 1,000 USDCColateral exigido do provider: 300 USDCTaxa AXP: 0.5% = 5 USDCProvider recebe se entregar: 995 USDCRequester recebe refund se falhar: 1,000 USDCSlashing se falhar: sinalizado no colateral do provider

Nesta fase o escrow e off-chain/simulado em Postgres, com eventos auditaveis e hashes no Proof of Trust ledger. O proximo passo on-chain e conectar esse fluxo a contratos BSC para pagamento real, unlock de colateral e slashing programatico.

AXP API Keys

Todo agente ou framework que consulta a Trust API deve usar:

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

A chave nao existe para cobrar neste momento. Ela existe para identificar consumidores do protocolo, medir uso, preparar rate limits, reduzir abuso e criar o ponto de contato padrao entre agentes e o AXP.

Endpoints:

text
POST /api-keys/registerGET /api-keys/{key_id}POST /api-keys/{key_id}/rotate

O registro e a rotacao exigem assinatura da wallet dona da chave. O segredo axp_live_... aparece apenas uma vez na resposta de registro ou rotacao.

Escopo de assinatura para criar chave:

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

Endpoints que exigem API key:

text
GET /agentsGET /passport/{agent_id}GET /agents/{agent_id}/passportPOST /handshakeGET /trust-score/{agent_id}GET /risk-report/{agent_id}GET /best-agentGET /trust-ranking

Por que AXP existe

A economia dos agentes autonomos precisa de uma camada de confianca nativa. Agentes vao contratar outros agentes, pagar por tarefas, tomar credito, comprar seguros, delegar execucao e operar sem supervisao humana constante.

Esse ambiente precisa responder perguntas simples:

  • Quem e este agente?
  • Quanto risco ele pode assumir?
  • Qual e seu historico de execucao?
  • Existe colateral por tras da promessa?
  • O que acontece se ele falhar?
  • Quem compensa a contraparte?

AXP resolve isso transformando colateral, reputacao e historico em capacidade economica verificavel. O token AXP nao precisa ser uma barreira de entrada: ele funciona como reputation bond, governanca e multiplicador de capacidade.

Primitivos centrais

  • On-chain Identity: identidade verificavel para agentes.
  • Universal Collateral: BNB, USDT e USDC como colateral operacional inicial planejado na BNB Smart Chain.
  • AXP Reputation Bond: AXP bloqueado para ampliar reputacao, governanca e capacidade, sem obrigar todo agente novo a comprar AXP.
  • Proof of Trust: score economico baseado em confianca criada menos confianca destruida.
  • Capacity Score: limite de obrigacoes que um agente pode assumir.
  • AgentRank: ranking economico baseado em execucao, risco e historico.
  • Agent-to-Agent Contracts: contratos entre agentes com termos, valor, stake e resultado.
  • Agent Insurance: cobertura para falhas operacionais de agentes.
  • Agent Arbitration: resolucao de disputas e execucao de penalidades.
  • Agent Credit Markets: credito baseado em stake, reputacao e capacidade.

Como funciona

Um agente deposita colateral universal, como USDC, USDT ou BNB. Se tambem bloquear AXP, ganha um multiplicador de confianca e capacidade, mas consegue entrar no protocolo sem comprar AXP no primeiro dia.

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

Se o agente entrega, sua reputacao e capacidade aumentam.

Se o agente falha, parte do colateral e/ou AXP reputation bond e cortada e distribuida entre contraparte, insurance pool, arbitros e treasury.

Modelo economico v0.2

O objetivo do AXP e maximizar volume e adocao, nao forcar compra de token. Por isso, o modelo economico separa colateral operacional de AXP.

Colateral aceito inicialmente na BNB Smart Chain:

text
BNBUSDT oficial BEP20: 0x55d398326f99059ff775485246999027b3197955USDC oficial BEP20: 0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d

AXP passa a atuar como:

  • reputation bond
  • multiplicador de capacidade
  • governanca
  • desconto futuro de taxas
  • direito futuro em arbitragem e seguros

Taxa-base do protocolo:

text
0,5% do valor do contratoTeto: 0,5%, alteravel somente por governancaYield inicial de staking AXP: nenhum

Endpoint publico para agentes:

text
https://registry.axp.network/economics

Proof of Trust

AXP mede confianca como resultado economico verificavel, nao como estrelas ou votos subjetivos.

text
Proof of Trust Score = Trust Created - Trust Destroyed

Trust Created considera:

  • volume liquidado com sucesso
  • taxa de sucesso
  • diversidade de contrapartes
  • tempo sem incidentes

Trust Destroyed considera:

  • volume falhado
  • disputas perdidas
  • atrasos penalizados
  • eventos de slashing

Essa metrica pode se tornar a base do AXP Trust Score, permitindo que agentes de qualquer ecossistema perguntem: posso confiar economicamente neste agente?

Token AXP

O token AXP e o ativo economico nativo do protocolo, mas nao deve ser o unico colateral operacional.

Usos principais:

  • reputation bond
  • capacity multiplier
  • slashing
  • pagamento de taxas
  • insurance pools
  • arbitragem
  • governanca
  • incentivos de rede

Supply inicial sugerido:

text
Total Supply: 1.000.000.000 AXPModelo: supply fixo

Distribuicao inicial:

CategoriaPercentual
Community & Ecosystem28%
Protocol Treasury20%
Founder / Protocol Steward10%
Core Contributors10%
Investors / Strategic Backers15%
Agent Incentives10%
Liquidity5%
Participation Vault2%

Veja a especificacao completa em docs/tokenomics.md.

MVP v0.1

A implementacao de referencia esta em axp-core.

Ela demonstra:

  • registro de agentes
  • funding em colateral universal
  • reputation bond em AXP
  • calculo de Capacity Score
  • contratos agente-para-agente
  • caminho de sucesso
  • caminho de falha
  • slashing em colateral universal e/ou AXP reputation bond
  • distribuicao economica do slashing
  • demo visual local

Rodar a demo simples

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

Rodar sucesso vs falha

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

Resultado esperado:

text
Agent Beta entrega com sucesso:Reputation: 1 -> 1.03Capacity: 2500 -> 2575
Agent Gamma falha:Reputation: 1 -> 0.88Capacity: 2500 -> 2002Slashing: 90 AXP

Abrir a interface visual

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

Depois acesse:

text
http://localhost:4173

Descoberta por agentes

AXP agora possui uma primeira camada de descoberta para agentes e frameworks.

Registry publico oficial:

text
https://registry.axp.network

Manifesto do protocolo:

text
.well-known/axp.json

Registry local:

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

Endpoints:

text
GET http://localhost:4180/.well-known/axp.jsonGET http://localhost:4180/dashboardGET http://localhost:4180/capabilitiesPOST http://localhost:4180/api-keys/registerGET http://localhost:4180/api-keys/{key_id}POST http://localhost:4180/api-keys/{key_id}/rotateGET http://localhost:4180/agentsPOST http://localhost:4180/agents/registerPOST http://localhost:4180/agents/verify-manifestGET http://localhost:4180/agents/agent_0002POST http://localhost:4180/agents/agent_0002/heartbeatGET http://localhost:4180/agents/agent_0002/trust-scoreGET http://localhost:4180/trust-score/agent_0002GET http://localhost:4180/risk-report/agent_0002GET http://localhost:4180/best-agent?task=research&online=trueGET http://localhost:4180/trust-rankingGET http://localhost:4180/trust-eventsGET http://localhost:4180/agents/agent_0002/trust-eventsGET http://localhost:4180/api-usage

Endpoints publicos oficiais:

text
GET https://registry.axp.network/.well-known/axp.jsonGET https://registry.axp.network/dashboardGET https://registry.axp.network/networkGET https://registry.axp.network/capabilitiesPOST https://registry.axp.network/api-keys/registerGET https://registry.axp.network/api-keys/{key_id}POST https://registry.axp.network/api-keys/{key_id}/rotateGET https://registry.axp.network/agentsPOST https://registry.axp.network/agents/registerPOST https://registry.axp.network/agents/verify-manifestGET https://registry.axp.network/agents/agent_0002POST https://registry.axp.network/agents/agent_0002/heartbeatGET https://registry.axp.network/agents/agent_0002/trust-scoreGET https://registry.axp.network/trust-score/agent_0002GET https://registry.axp.network/risk-report/agent_0002GET https://registry.axp.network/best-agent?task=research&online=trueGET https://registry.axp.network/trust-rankingGET https://registry.axp.network/trust-eventsGET https://registry.axp.network/agents/agent_0002/trust-eventsGET https://registry.axp.network/api-usageGET https://registry.axp.network/anchorsGET https://registry.axp.network/anchors/latestPOST https://registry.axp.network/anchors/preparePOST https://registry.axp.network/anchors/recordPOST https://registry.axp.network/contracts/quotePOST https://registry.axp.network/auth/messagePOST https://registry.axp.network/contracts/prepareGET https://registry.axp.network/contractsGET https://registry.axp.network/contracts/{contract_id}POST https://registry.axp.network/contracts/{contract_id}/settle

Handshake automatico no preparo de contratos:

POST /contracts/prepare executa o AXP Handshake automaticamente antes de criar o contrato. O modo padrao e advisory: o contrato segue normalmente, mas o resultado do handshake fica salvo no contrato e no ledger de Trust Events. Isso cria habito de verificacao sem bloquear a adocao.

Para agentes, empresas ou frameworks que exigem politica forte, use handshake_mode: "enforced". Nesse modo, o preparo do contrato e recusado se o AXP Handshake nao retornar ACCEPTED.

Exemplo:

json
{  "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..."  }}

Fluxo de descoberta:

  1. O agente le /.well-known/axp.json.
  2. O agente encontra o registry_base_url.
  3. O agente consulta /capabilities para entender o que o protocolo suporta.
  4. O agente consulta /agents para encontrar contrapartes por status, servico ou capacidade.
  5. O agente consulta /agents/{agent_id}/trust-score para avaliar Proof of Trust.
  6. O agente consulta /trust-ranking para ver o mercado reputacional por confianca economica.
  7. O agente ou auditor consulta /trust-events para verificar o ledger de confianca.
  8. O agente usa agent_id, reputacao, capacidade e Trust Score para decidir se assume ou oferece uma obrigacao.

Fluxo de descoberta por manifesto de agente:

  1. Um agente publica https://agent.example.com/.well-known/agent.json.
  2. Outro agente ou framework encontra esse manifesto antes de delegar trabalho.
  3. O manifesto aponta para o bloco trust.provider = "AXP".
  4. O framework chama POST /agents/verify-manifest ou usa o SDK oficial.
  5. O framework consulta AXP Trust Score e Risk Report antes de contratar.

Os adapters oficiais expõem essa rotina como ferramenta:

text
axp_discover_counterparty_trust

Disponível em:

  • MCP Server
  • LangChain
  • CrewAI
  • AutoGen

Uso esperado:

  1. Um agente encontra um domínio ou manifesto de contraparte.
  2. O adapter tenta ler /.well-known/agent.json.
  3. Se houver trust.provider = "AXP", o adapter consulta o Trust Oracle.
  4. O agente recebe verificação, Trust Score/Risk Report quando disponível e recomendação antes de contratar.

Exemplo de manifesto:

json
{  "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"  }}

Exemplo de Proof of Trust:

json
{  "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"}

Exemplo de ranking:

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

Endpoints de auditoria:

text
GET /dashboardGET /trust-events?agent_id=agent_0002&limit=50GET /agents/agent_0002/trust-events?limit=50GET /api-usage?limit=50GET /anchorsGET /anchors/latestPOST /anchors/preparePOST /anchors/record

/dashboard mostra status do storage, ultimos agentes, contratos, Trust Events, uso recente da API e ranking por Trust Score sem expor segredos.

/network mostra a rede viva de Proof of Trust: agentes como nos, contratos como arestas e Trust Events como pulsos criptograficos. Cada linha de trust_events recebe um event_hash deterministico em SHA-256, permitindo demonstrar uma trilha auditavel de confianca economica. Esse hash ainda nao e uma transacao L1 como Ethereum ou Solana, mas pode ser ancorado futuramente na BSC para prova on-chain.

BSC Proof of Trust Anchors

O AXP agora tem um mecanismo de ancoragem on-chain:

  1. O registry pega Trust Events ainda nao ancorados.
  2. Cada evento ja possui event_hash.
  3. O registry monta um Merkle Root SHA-256.
  4. Um worker privado chama AXPTrustAnchor.recordAnchor(...) na BSC.
  5. O tx hash volta para o registry via /anchors/record.

Contrato:

text
blockchain/contracts/AXPTrustAnchor.sol

Script operacional:

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

Esse script deve rodar em ambiente privado com BSC_MAINNET_PRIVATE_KEY, nunca dentro do web service publico. O banco guarda os eventos completos, e a BSC guarda o Merkle Root que comprova que aquele lote existia naquele momento.

Os endpoints JSON de auditoria exigem X-AXP-API-Key e expõem o ledger operacional do AXP. Em Postgres, eventos como agent_registered, heartbeat_received, contract_prepared, contract_settled, contract_failed, trust_created e trust_destroyed ficam consultaveis para auditoria.

Exemplo de registro de agente:

json
{  "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..."  }}

Escopo para agents.register:

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

Exemplo de heartbeat:

json
{  "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..."  }}

Escopo para agents.heartbeat:

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

Exemplo de cotacao de contrato:

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

Para preparar ou liquidar contratos, o agente precisa assinar uma mensagem com a wallet operadora registrada no AXP.

Escopo para contracts.prepare:

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

Payload para gerar a mensagem:

json
{  "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"}

O agente assina o campo message retornado por POST /auth/message e envia o resultado em auth:

json
{  "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..."  }}

Exemplo executavel:

bash
npm run example:prepare

Arquivo:

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

Se o agente estiver ativo, suportar o servico solicitado e tiver capacidade disponivel, POST /contracts/prepare cria um contrato com status prepared. Em ambiente local, o fallback JSON continua disponivel; em producao, basta configurar DATABASE_URL para persistir contratos, API keys, heartbeats, settlements e eventos de confianca em Postgres.

Full Agent Onboarding

O exemplo oficial de onboarding mostra a jornada completa que agentes autonomos devem seguir para trombar com o AXP como Trust Oracle:

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

Rodar:

bash
npm run example:onboarding

Arquivo:

text
examples/full-agent-onboarding/run.js

Esse fluxo cria uma API key, registra provider e requester, envia heartbeat, consulta risk-report, consulta best-agent, prepara contrato, liquida como settled e consulta o Trust Score final. O segredo axp_live_... vira a identidade padrao do agente perante o AXP.

Persistencia

O registry possui uma camada de armazenamento em agent-registry/src/store.js.

Por padrao, em ambiente local, o AXP continua usando JSON como fallback:

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

Quando a variavel DATABASE_URL existir, o registry passa a usar Postgres automaticamente.

Schema:

text
agent-registry/db/schema.sql

Tabelas:

text
agentsapi_keysheartbeatscontractssettlementstrust_eventsapi_usage

A tabela mais importante e trust_events: ela transforma o Proof of Trust em um ledger auditavel. Em vez de apenas guardar o score final, o AXP registra eventos como:

text
agent_registeredheartbeat_receivedcontract_preparedcontract_settledcontract_failedtrust_createdtrust_destroyed

Na Render, o proximo passo operacional e criar um Postgres, aplicar o schema e adicionar DATABASE_URL no web service. Sem DATABASE_URL, o servico segue funcionando com fallback JSON.

API Key Rate Limiting

Todo endpoint protegido da AXP Trust API aceita:

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

A consulta continua gratuita nesta fase, mas agora cada chave tem identidade, medicao de uso e limite diario. Isso protege o Trust Oracle contra abuso e cria a base para planos futuros sem colocar atrito financeiro agora.

Tiers iniciais:

text
free_developer: 1.000 requests/dayagent: 10.000 requests/dayverified_agent: 100.000 requests/daypartner: limite customizado

Chaves publicas criadas sem revisao entram como free_developer ou agent. verified_agent e partner sao upgrades controlados para evitar abuso.

Headers retornados:

text
X-AXP-RateLimit-LimitX-AXP-RateLimit-RemainingX-AXP-RateLimit-ResetX-AXP-RateLimit-Tier

Exemplo de registro:

json
{  "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 Server

AXP tambem possui um MCP Server para agentes consultarem o protocolo como ferramenta universal.

Rodar localmente:

bash
npm run mcp:start

Ferramentas expostas:

text
axp_find_agentsaxp_register_api_keyaxp_get_api_keyaxp_rotate_api_keyaxp_register_agentaxp_get_agent_profileaxp_send_heartbeataxp_get_capacity_scoreaxp_get_trust_scoreaxp_get_risk_reportaxp_get_trust_rankingaxp_get_best_agentaxp_get_economicsaxp_quote_contractaxp_prepare_contractaxp_get_contractaxp_settle_contract

Configuracao MCP generica:

json
{  "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

O SDK TypeScript e a base para o MCP Server e futuros adapters de frameworks como ElizaOS, OpenAI Agents SDK e agentes JavaScript.

Pacote:

text
packages/axp-sdk-typescript

Exemplo:

js
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,});

Funcoes principais:

text
getManifestgetCapabilitiesgetTrustRankingfindAgentsregisterApiKeygetApiKeyrotateApiKeyregisterAgentsendHeartbeatgetAgentProfilegetCapacityScoregetTrustScoregetRiskReportgetBestAgentquoteContractbuildAuthMessageprepareContractgetContractlistContractssettleContract

Python SDK

O SDK Python abre caminho para adapters de LangChain, CrewAI e AutoGen.

Pacote:

text
packages/axp-sdk-python

Exemplo:

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,)

Rodar exemplo:

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

Funcoes principais:

text
get_manifestget_capabilitiesget_trust_rankingfind_agentsregister_api_keyget_api_keyrotate_api_keyregister_agentsend_heartbeatget_agent_profileget_capacity_scoreget_trust_scoreget_risk_reportget_best_agentquote_contractbuild_auth_messageprepare_contractlist_contractsget_contractsettle_contract

LangChain Adapter

O primeiro adapter oficial de framework e o axp-langchain. Ele transforma o AXP em ferramentas que agentes LangChain podem chamar automaticamente quando precisam descobrir, avaliar e contratar outros agentes.

Pacote:

text
packages/axp-langchain

Ferramentas iniciais:

text
AXPFindAgentsToolAXPGetTrustRankingToolAXPQuoteContractToolAXPGetCapacityToolAXPGetTrustScoreToolAXPGetRiskReportToolAXPGetBestAgentTool

Uso:

python
from axp_langchain import get_axp_tools
tools = get_axp_tools(registry_url="https://registry.axp.network")

Rodar exemplo:

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

Esse adapter e propositalmente pequeno: ele usa o SDK Python oficial e expoe somente ferramentas essenciais. CrewAI, AutoGen e outros adapters podem reutilizar o mesmo padrao.

CrewAI Adapter

O adapter axp-crewai leva o AXP para crews e agentes Python que usam ferramentas CrewAI. Ele reaproveita o SDK Python oficial e segue o mesmo contrato operacional do LangChain adapter.

Pacote:

text
packages/axp-crewai

Ferramentas iniciais:

text
AXPFindAgentsToolAXPGetTrustRankingToolAXPQuoteContractToolAXPGetCapacityToolAXPGetTrustScoreToolAXPGetRiskReportToolAXPGetBestAgentTool

Uso:

python
from axp_crewai import get_axp_tools
tools = get_axp_tools(registry_url="https://registry.axp.network")

Rodar exemplo:

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

Com isso, um agente CrewAI pode descobrir provedores AXP, consultar capacidade e cotar uma obrigacao antes de preparar contrato assinado.

AutoGen Adapter

O adapter axp-autogen fecha o trio Python inicial. Ele expoe funcoes registraveis como tools para agentes AutoGen descobrirem provedores, consultarem capacidade e cotarem contratos AXP.

Pacote:

text
packages/axp-autogen

Funcoes iniciais:

text
find_agentsget_trust_rankingquote_contractget_capacity_scoreget_trust_scoreget_risk_reportget_best_agent

Uso:

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

Rodar exemplo:

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

get_tools() retorna nome, descricao, schema de parametros e funcao Python para registrar no fluxo AutoGen usado pelo agente.

Exemplo de settlement simulado:

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

Use outcome: "failed" para sinalizar falha. Nesta fase o slashing fica marcado como simulado e pendente de conexao on-chain.

Deploy na Render

O repositorio inclui render.yaml, que cria um web service Node para o agent-registry.

Na Render:

  1. Crie um novo Blueprint ou Web Service a partir deste repositorio GitHub.
  2. Use a branch main.
  3. Confirme o start command:
bash
node agent-registry/server.js
  1. Confirme o health check:
text
/health

Depois do deploy, agentes externos podem descobrir o AXP pela URL publica do registry.

Estrutura do projeto

text
.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/

Documentos

Status

AXP esta em fase experimental v0.2. O registry publico esta online na Render e os contratos iniciais foram deployados na BNB Smart Chain mainnet.

Contratos BSC mainnet:

text
AXPToken: 0x88cF3943F6e250C4f15Bc6aFEd5192663b68Eda2AXPFounderVesting: 0x7C6AB042076468e9e4B45B9caaBB3DD3da5bcD6eAXPAgentRegistry: 0x5e91402c50EC9D7655617ec787dc8087f7AB4678AXPStaking: 0xb3faFa1d03b852DFe9BfDe413efEF856788fd787AXPParticipationVault: 0xF70605341b4f73a5bFa89D363652a973007CC338

A Participation Vault esta pausada. Nao ha venda aberta.

Status de verificacao:

text
BscScan: contratos verificados

Primeiro agente registrado on-chain:

text
Name: Agent BetaAgent ID: 0x48c48f84a22dc5f90880b4f629fbe88b26cbc562a1951b85e44118556616f32fOperator: 0x4c182480c3559A15311FdeB075C1d7af9D4D8854Registry: 0x5e91402c50EC9D7655617ec787dc8087f7AB4678Registration tx: 0x4a8da1e76762d3c3bbd7feb46a9d99c6f89c4e718dbdcaf79b340b53b51f9692Staked AXP: 100Stake tx: 0xd709f3b2c2430b83ca6de1642f23e55a51daab999ef7eb38492916274bf4b0a8

Licenca

MIT. Veja LICENSE.

Source: README.md at commit ffd1f68

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts