K402

io.github.Kali123411由 GitHub 帳號 Kali123411 發布v0.7.0更新於 Oct 24, 2026

Agent-payable APIs on Kaspa: LLMs, chain data, covenants, zk proofs — pay per call, no API key

已驗證Streamable HTTP可網頁執行金融開發者工具AI 與機器學習

概覽

AI 產生的概覽

K402 提供可按次付費的 Kaspa 服務:LLM 呼叫、Kaspa 鏈上資料、covenant 工具與 zk 證明,費用從預付 KAS 工作階段或鏈上付款中扣除。

可以做什麼
探索與定價:列出閘道服務目錄、搜尋服務交易市場、查看提供者信譽與付款方式、查詢通道設定與狀態。管理付款:開啟預付工作階段並取得 Kaspa 主網儲值地址、綁定既有工作階段金鑰、查詢餘額、以交易 ID 完成按次付款。文字與網頁任務:摘要、依 JSON schema 擷取結構化資料、改寫、分類、讀取公開網頁、產生文字向量、在伺服器端集合建立索引並做語意搜尋。查詢 Kaspa 主網:位址餘額、UTXO、交易記憶池狀態、手續費估算與網路狀態。GPU 模型等級:chat、reason、code、kaspa-expert 等推論。Covenant 與證明:編譯 Silverscript covenant、推導位址、查詢 UTXO、建構與驗證交易、廣播交易,以及上傳 RISC Zero 程式、預檢、提交證明、輪詢任務、取得結果並驗證回執。
適用情境
當助理需要免 API 金鑰、按次付費地使用 LLM 推論、Kaspa 鏈上資料、covenant 腳本或 RISC Zero 證明,且你願意預先儲值 KAS 時適用。適合必須按呼叫付費而非持有服務商金鑰的代理程式。
執行需求
可作為遠端 streamable HTTP 端點執行,也可透過 stdio 執行本機 PyPI 套件 k402-mcp。付款需要 Kaspa 主網錢包與 KAS,預付工作階段最低儲值 0.25 KAS。選用環境變數 K402_GATEWAY(閘道位址)與 K402_SESSION(固定已儲值的工作階段金鑰)。需要連線至閘道與 Kaspa 主網的網路。
安裝前請注意
付費工具會從預付餘額或按次鏈上付款花費真實 KAS,證明費用隨週期數增加。covenant_broadcast 會在主網轉移真實 KAS,應先執行 covenant_check。工作階段金鑰是儲存在本機的持有者憑證,須保密;索引集合名稱應不可猜測並保密。儲值與付款會送往第三方閘道與提供者位址。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 K402,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "k402": {
      "type": "http",
      "url": "https://x402-compute.68cxgfyr0.workers.dev/mcp"
    }
  }
}

工具

36

catalog

List every service this gateway sells (text tools, Kaspa chain data, LLM tiers) with live prices in KAS and USD. Free. Start here to see what's available and what calls cost.

無需輸入參數。

open_session

Open a prepaid payment session: returns a session key and a personal Kaspa MAINNET deposit address. Send KAS to the address from any wallet (min 0.25 KAS); confirmed deposits become spendable balance within seconds and every paid tool call meters against it. Free. The session is saved locally so subsequent calls use it automatically.

無需輸入參數。

use_session

Attach an existing k402 session key (from a previous open_session) so paid calls meter against its balance — use after reconnecting to the hosted endpoint, or to carry one funded session across clients. Returns the session's current balance. Free.

輸入參數session必填

session_status

Check the current payment session: deposit address, deposited / spent / remaining KAS. Free.

無需輸入參數。

registry_provider

Full detail on one provider in the service exchange by its payee pubkey: every service it lists, its chain-verified reputation (settled KAS volume + settlement count), and its payee address. Free.

輸入參數payee_pubkey必填

channel_config

Parameters for opening a kaspa-channel — a covenant-enforced payment channel that settles per-call vouchers on Kaspa L1 with NO custodian (the trustless alternative to a prepaid session). Returns the payee pubkey, min/max channel size, required expiry lead, and maxfee. Free. Opening a channel means funding the channel covenant on-chain (payer holds the key), then paying per call with signed vouchers — use the `k402` Python client (`pip install k402`, k402.channel) to build the covenant and sign vouchers, since that flow needs your Kaspa key. Returns {error} if this gateway hasn't enabled the (experimental) channel rail.

無需輸入參數。

channel_status

Status of a kaspa-channel by its channel id (covenant id): funded value, amount spent via vouchers, remaining, expiry, and whether it has been closed on-chain. Free.

輸入參數channel_id必填

payment_options

Which coins and schemes this gateway accepts for payment. Free. Ways to pay any paid tool: a prepaid KAS session (open_session — simplest, no per-call step); per-call in any listed coin (pay the offer a 402 returns, then pay_per_call); or, where the experimental 'kaspa-channel' scheme is offered, a covenant payment channel that settles per-call vouchers on L1 with no custodian (see channel_config). Coins may include Kaspa, Pearl, BTC, LTC, DOGE, BCH, DASH, and EVM assets (ETC, ETH, USDC, USDT).

無需輸入參數。

pay_per_call

Complete a PER-CALL coin payment. After a paid tool returns a 402 with pay_per_call_offers, pay one offer on-chain from your own wallet, then call this with the 402's `endpoint` and `request_body`, the chosen offer's `scheme` and `payment_id`, and your payment `txid`. The gateway verifies the payment landed and returns the tool's real result. (Alternative to a prepaid session — use this when you'd rather pay each call directly in a specific coin.)

輸入參數txid必填scheme必填endpoint必填payment_id必填request_body必填

summarize

Summarize text or a public URL in at most max_words. Paid (~$0.001 in KAS).

輸入參數urltextmax_words

extract

Extract structured data from text as JSON guaranteed to match your JSON schema (schema-constrained decoding, not best-effort). Paid (~$0.0015 in KAS).

輸入參數text必填schema必填instruction

rewrite

Rewrite text per an instruction (tone, format, length...). Paid (~$0.001 in KAS).

輸入參數text必填instruction必填

classify

Classify text into one (or multiple, if multi=true) of 2-32 labels; the result is constrained to your label set. Paid (~$0.0003 in KAS).

輸入參數text必填multilabels必填

read_url

Fetch a public web page and return its title + clean markdown; distill=true adds key-fact bullets. Useful when you have no web access of your own. Paid (~$0.0012 in KAS).

輸入參數url必填distill

embed_text

Embed up to 64 texts (768-dim vectors, nomic-embed-text). Paid (~$0.0003 in KAS).

輸入參數texts必填

search_index

Store documents [{id, text, meta?}] in a named server-side collection for semantic search. Use an unguessable collection name and keep it secret. Paid (~$0.0015 in KAS).

輸入參數replacedocuments必填collection必填

search_query

Semantic-search a collection you indexed earlier; returns top-k matches with scores. Paid (~$0.0003 in KAS).

輸入參數q必填top_kcollection必填

kaspa_balance

Balance of any Kaspa MAINNET address, straight from a node (no indexer, no API key). Paid (~$0.00015 in KAS).

輸入參數address必填

kaspa_utxos

UTXO set of a Kaspa mainnet address, including scriptPublicKey and covenant_id where set. Paid (~$0.0003 in KAS).

輸入參數address必填

kaspa_tx_status

Mempool status of a Kaspa transaction. Absent from mempool means accepted-or-unknown — confirm acceptance by checking one of its outputs with kaspa_utxos. Paid (~$0.00015).

輸入參數txid必填

kaspa_fee_estimate

Current Kaspa mainnet feerate buckets (sompi per gram of tx mass). Paid (~$0.00015).

無需輸入參數。

kaspa_network

Kaspa mainnet status: DAA score, block count, difficulty, node sync state. Paid (~$0.00015 in KAS).

無需輸入參數。

generate

Run a prompt on a GPU model tier: 'chat' (fast 7B, ~$0.0015), 'llama' (budget 8B, ~$0.0008), 'reason' (35B, ~$0.004), 'think' (deep chain-of-thought 35B MoE, ~$0.004), 'code' (coder model, ~$0.0025), or 'kaspa-expert' (RAG-grounded, current Kaspa knowledge, ~$0.0015). Returns the completion text.

輸入參數tierprompt必填systemmax_tokens

covenant_compile

Compile a Silverscript covenant to script hex, ABI, hardened template hash, and its P2SH address on each network. constructor_args is the silverc ctor JSON (e.g. [{"kind":"int","data":7}]). Paid (~$0.002). NOTE: 'compiles' ≠ proven on-chain.

輸入參數source必填constructor_args

covenant_address

Derive the covenant P2SH address for a compiled script on 'mainnet' or 'testnet-10'. Paid (~$0.0003).

輸入參數networkscript_hex必填

covenant_utxos

Live UTXO set locked under a covenant address (covenant state inspection), from the node. Optionally filter by covenant_id. Paid (~$0.0003).

輸入參數address必填networkcovenant_id

covenant_build

Assemble a covenant spend tx. Each input: {txid, index, entry, compute_budget?, and either sigscript:{source,decl,args,is_leader?} to build a covenant sigscript server-side, or omit sigscript for a P2PK input you sign locally}. Each output: {amount, address|script_public_key_hex, covenant?:{authorizing_input,covenant_id}}. Returns the tx, a broadcast-ready rpc_transaction, fee accounting, and (if fully authorized) a pre-verify. We never sign. Paid (~$0.001).

輸入參數inputs必填networkoutputs必填lock_timepayload_hex

covenant_check

Local txscript pre-verify of a signed covenant tx BEFORE broadcast — catches script failures that would otherwise cost you a broadcast. 'entries' are the spent UTXOs (covenant_utxos output plugs in directly). Returns {all_ok, inputs:[{index, ok, error?}]}. Paid (~$0.0005).

輸入參數entries必填transaction必填

covenant_broadcast

Broadcast a signed covenant tx (RpcTransaction JSON from covenant_build). MAINNET moves real KAS — run covenant_check first. Paid (~$0.0003).

輸入參數networktransaction必填

prove_guest_upload

Upload a RISC Zero program binary (the .bin risc0-build emits, base64) once; returns its content-addressed image_id (also the verification key), reusable across proofs. Paid (~$0.01).

輸入參數program_b64必填

prove_preflight

Execute a guest WITHOUT proving: exact cycle count + a signed price quote {total_cycles, price_kas, quote_id, quote_expires}. Run this first — proving cost scales with cycles by orders of magnitude. Paid (~$0.002).

輸入參數image_id必填input_b64

prove_submit

Queue a proving job -> {job_id, cost_kas}. Pass quote_id (from prove_preflight; charged the quote) or max_kas (skip preflight; priced on actual cycles, refuses if over the cap). Then poll job_status and fetch job_result. Paid: the proof's cycle-based price (dynamic).

輸入參數max_kasimage_id必填quote_idinput_b64

job_status

Poll a proving job: queued/running/done/failed, queue position, cost. Free.

輸入參數job_id必填

job_result

Fetch a finished proving job's result {image_id, total_cycles, journal_b64, receipt_b64}. 404 until done; results kept 24h. Free.

輸入參數job_id必填

attest_verify

Verify a RISC Zero receipt against an image_id -> {valid, journal_b64}. Anyone can check an attestation without trusting the prover. Paid (~$0.0002).

輸入參數image_id必填receipt_b64必填

版本歷史

1
  1. v0.7.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

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

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

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。