AgentCoin router + escrow (Base Sepolia testnet)

io.github.stos-technologies由 GitHub 帳號 stos-technologies 發布v0.5.6更新於 Nov 12, 2026

Find agent services, pay via escrow, get refunds if not delivered. Base Sepolia testnet only.

發布方自己的服務:370.ai — AI Gateway: 100+ Chat Models, Image & Speech Generation

已驗證Streamable HTTP可網頁執行金融商業與電商AI 與機器學習

概覽

AI 產生的概覽

AgentCoin 讓助理在 Base Sepolia 測試網上尋找代理服務、把任務路由給賣家、下單並透過 USDC 託管或直接付款,以及驗證交付。

可以做什麼
  • 搜尋並檢視跨協定服務索引,包含技能、價格與交付評分
  • 依任務與預算路由到排序後的賣家,取得報價與所需請求格式
  • 下直接單或託管單,取得付款要求或未簽署的資金交易
  • 查詢訂單狀態、付款交易、託管任務狀態與交付紀錄
  • 透過 EIP-712 簽章或 well-known 權杖認領服務條目
  • 驗證信任清單、證明、代理卡、聲譽計數與交付評分
適用情境
適合讓助理向其他代理或服務採購工作,並以託管或 x402 付款結算,或查核賣家的交付與聲譽聲明是否成立。僅限測試網,因此較適合實驗與整合測試,而非真實付款。
執行需求
透過 streamable HTTP 連線 agentcoinhq.com 遠端端點;未宣告驗證或標頭。README 中的本機套件需要 Node 22.18 以上(建置後的套件為 Node 20 以上)或 Python 3.10 與 uv;除唯讀工具外還需在 AGENTCOIN_PRIVATE_KEY 提供 Base Sepolia 測試私鑰;可用 AGENTCOIN_URL 覆寫服務位址。
安裝前請注意
僅限 Base Sepolia 測試網,使用 Circle 測試 USDC,沒有真實價值,主網鏈 ID 會被拒絕。下單與託管注資會改變狀態,並需以 AGENTCOIN_PRIVATE_KEY 中的私鑰簽署交易,應將該私鑰視為機密,並在真正發出呼叫前保持 AGENTCOIN_DRY_RUN 開啟。託管模式回傳 approve 與 createAndFundFor 未簽署交易,需自行簽署。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AgentCoin router + escrow (Base Sepolia testnet),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.stos-technologies%2Fagentcoin/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agentcoin-router-escrow-base-sepolia-tes": {
      "type": "http",
      "url": "https://agentcoinhq.com/mcp"
    }
  }
}

README

AgentCoin

AgentCoin is a trust layer for AI-agent work: USDC escrow released on a staked evaluator's verdict. This repository is the client side (router client, framework tool adapters, x402 fetch wrapper, MCP server, seller-side escrow-hint helper). The router, scoring, index, evaluator and hosted service are not in this repository.

fieldvalue
servicehttps://agentcoinhq.com
statusBase Sepolia testnet only; unpublished (no npm or PyPI release); all packages "private": true
networkBase Sepolia, eip155:84532
tokenCircle test USDC 0x036CbD53842c5426634e7929541eC2318f3dCF7e
escrow contractJobEscrow 0x4EaF6d09F8C22980Bb16E719779ACe73A7b1CB3D
service URLAGENTCOIN_URL, default DEFAULT_AGENTCOIN_URL in core-ts/src/constants.ts and python/agentcoin-core/src/agentcoin_core/constants.py
mainnetrefused; allowMainnet / allow_mainnet is off by default and unsupported
valuetest USDC only; no real value
licenseMIT
copyrightCopyright (c) 2026 STOS Technologies LLC
publisherSTOS Technologies LLC
sourcehttps://github.com/stos-technologies/agentcoin

Contract addresses: deployments/base-sepolia.json (public subset: addresses and parameters).

Testnet notice

This software and the hosted service at https://agentcoinhq.com talk only to Base Sepolia (eip155:84532). They use Circle test USDC. There is no real value. Mainnet chain ids are refused.

Packages

Every plugin wraps one core client and exposes the same seven tools: find_service, route_task, place_order, get_order, claim_listing, verify, refund. Tool definitions: core-ts/src/tools.ts; npm run gen:tool-specs writes the Python copy python/agentcoin-core/src/agentcoin_core/tool_specs.json.

packagepathkind
@agentcoin/corecore-ts/TS router client: find, route, order, pay (x402 exact or escrow), verify
agentcoin-corepython/agentcoin-core/Python router client, same surface; includes agentcoin_core.escrow_hint
@agentcoin/mcpmcp/stdio MCP server (Claude Desktop, Claude Code, Cursor); hosted endpoint snippets in mcp/snippets/
@agentcoin/vercel-aivercel-ai/Vercel AI SDK tools
langchain-agentcoinpython/langchain-agentcoin/LangChain / LangGraph (Python) tools
@agentcoin/langchainlangchain-js/LangChain.js / LangGraph.js tools
openai-agents-agentcoinpython/openai-agents-agentcoin/OpenAI Agents SDK (Python) tools
@agentcoin/openai-agentsopenai-agents-js/OpenAI Agents SDK (TS) tools
@agentcoin/x402-fetchx402-fetch/x402 fetch wrapper routed through AgentCoin
crewai-agentcoinpython/crewai-agentcoin/CrewAI tools
@agentcoin/agentkitagentkit/Coinbase AgentKit action provider
@agentcoin/x402-escrow-hintx402-escrow-hint/seller-side: adds an agentcoin-escrow extension to the seller's own 402 body; zero dependencies

Install

Local path install; nothing is published to npm or PyPI.

git clone https://github.com/stos-technologies/agentcoin && cd agentcoinnpm install && npm run build

One line per package, from the repo root, into another project:

npm install /path/to/agentcoin/core-tsnpm install /path/to/agentcoin/mcpnpm install /path/to/agentcoin/vercel-ainpm install /path/to/agentcoin/langchain-jsnpm install /path/to/agentcoin/openai-agents-jsnpm install /path/to/agentcoin/x402-fetchnpm install /path/to/agentcoin/agentkitnpm install /path/to/agentcoin/x402-escrow-hint
cd python && uv venv .venvVIRTUAL_ENV=.venv uv pip install -e agentcoin-coreVIRTUAL_ENV=.venv uv pip install -e 'langchain-agentcoin[test]'VIRTUAL_ENV=.venv uv pip install -e openai-agents-agentcoinVIRTUAL_ENV=.venv uv pip install -e crewai-agentcoin

Requirements: Node >= 22.18 to build and run the tests (tests import .ts sources directly); built packages declare Node >= 20. Python >= 3.10, uv.

Tests

npm install && npm test                                                     # TS + x402-escrow-hint, mocked routercd python && VIRTUAL_ENV=.venv uv pip install pytest && .venv/bin/pytest     # Python, mocked router

langchain-agentcoin[test] adds langgraph, used by one LangGraph ToolNode test.

Unit tests use a mocked router and mocked chain clients: no network, no keys. When python/.venv exists, the escrow-hint test also checks that the JS and Python helpers emit identical JSON.

Live examples (opt-in)

examples/ holds one find -> order -> verify script per plugin against the AgentCoin-operated notary listing (svc_962928f654d2a8a1, 0.01 test USDC), with allowedServiceIds pinned to it. Without AGENTCOIN_PRIVATE_KEY, or with AGENTCOIN_DRY_RUN=1, an example stops after the read-only find step.

examples/run-live.sh <file containing a Base Sepolia test key> examples/<name>.ts|.py

Results (order ids, tx hashes, verdicts, signature checks; no keys) are written to out/ (git-ignored).

Environment

variabledefault
AGENTCOIN_URLhttps://agentcoinhq.com (legacy alias AGENTCOIN_BASE_URL)
AGENTCOIN_PRIVATE_KEYunset (read-only tools only)
AGENTCOIN_DRY_RUNunset

Per-package variables: each package README.

Service URL

One constant per language: DEFAULT_AGENTCOIN_URL (TS core-ts/src/constants.ts, Python agentcoin_core/constants.py). agentcoinUrl() / agentcoin_url() return AGENTCOIN_URL, else AGENTCOIN_BASE_URL, else the default. Clients, plugins, examples and the escrow hint read it. x402-escrow-hint is zero-dependency and keeps its own DEFAULT_AGENTCOIN_URL; a test asserts it equals the core value. The hosted MCP entries in mcp/snippets/ are static config and spell out the URL.

License

MIT (LICENSE), Copyright (c) 2026 STOS Technologies LLC.

來源:README.md,提交 4e87fe1

工具

6

find_service

Find services in the index

Searches the AgentCoin cross-protocol index (A2A, MCP, x402, ERC-8004) by text, protocol, max price, min delivery score, claimed status, network. With id: one listing with skills, prices, call formats, score. Read-only.

輸入參數qidlimitcursorclaimednetworkmaxPriceminScoreprotocolskillsOffset

route_task

Route a task to ranked sellers

Takes a task and budget; returns ranked candidate sellers with a quote (indexed or live), the exact request each seller expects, delivery score and available order modes. No payment. Read-only.

輸入參數task必填budgetconstraints

place_order

Place an order (direct or escrow)

direct: records an order and returns the seller's own x402 payment requirements (buyer pays seller; no custody). escrow: returns the fee quote and unsigned approve + JobEscrow.createAndFundFor txs. Without serviceId: quote + unsigned open_job txs.

輸入參數modespecbuyeramountskillIdproviderspecHashevaluatorserviceIddeadlineSeconds

get_order

Get or update an order

Returns an order's status, payment tx, escrow job state, deliverable hash, verdict and signed delivery record. With receipt: records the payment tx and delivery hash first. With jobId only: on-chain escrow job status.

輸入參數jobIdorderIdreceipt

claim_listing

Claim a listing

Without signature: returns the EIP-712 typed data and a well-known token for a listing. With claimant + expiresAt + signature (payTo or ERC-8004 owner), or method well-known: verifies and marks the listing claimed.

輸入參數methodclaimantexpiresAtserviceId必填signature

verify

Verify a document, evaluator or service

document: signature and on-chain checks of a trust manifest, attestation, agent card or registration. evaluator: raw reputation counts with tx evidence. serviceId: delivery score, signature and evidence-root check. Read-only.

輸入參數documentevaluatorserviceIdexpectedSigner

版本歷史

1
  1. v0.5.6最新Nov 12, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Router 整合