hashproof

Name: hashproof
Author: csacanam

本地服务

github.com/csacanam安全1今天更新

代码仓库

关于 hashproof

HashProof 是面向组织和个人的凭证签发 API，供其创建可公开验证的凭证。它结合 IPFS 备份、Celo 链上登记，并支持按次付费或预付 API 密钥。

主要功能

01签发可验证凭证
02将凭证 JSON 备份到 IPFS
03在 Celo 上登记凭证
04通过公开 URL 验证凭证
05使用 x402 或预付 API 密钥付款

适用场景

01为个人签发凭证
02通过公开 URL 验证凭证

MCP 相关

其 MCP 服务允许 AI Agent 预览模板、签发和验证凭证，以及获取模板要求。本地使用支持 x402 付款或 API 密钥；远程服务签发凭证需要 API 密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "csacanam-hashproof": {
      "command": "npx",
      "args": [
        "-y",
        "hashproof-mcp"
      ],
      "env": {
        "HASHPROOF_API_KEY": "<HASHPROOF_API_KEY>",
        "HASHPROOF_WALLET_PRIVATE_KEY": "<HASHPROOF_WALLET_PRIVATE_KEY>",
        "HASHPROOF_X402_NETWORK": "<HASHPROOF_X402_NETWORK>"
      }
    }
  }
}

启动命令npx -y hashproof-mcp

需要配置的环境变量

HASHPROOF_API_KEY密钥Prepaid API key (alternative to wallet). One of the two payment methods is required only for issue_credential.

HASHPROOF_WALLET_PRIVATE_KEY密钥EVM private key of a dedicated wallet holding USDC on Base or Celo — pays $0.10 per issuance via x402.

HASHPROOF_X402_NETWORKbase (default) or celo

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

安装包

npmhashproof-mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
template_ref	string	是	模板 slug 或 UUID

详细介绍

HashProof

通过 IPFS 备份、链上注册表和基于 x402 的按次付费 API，实现可验证凭证。

项目简介

HashProof 是一个凭证签发 API。组织和个人（实体）向用户签发可验证凭证。每份凭证都会：

以 JSON 格式存储在数据库中，并备份到 IPFS（Pinata）
在 Celo 上的 CredentialRegistry 合约中进行链上注册
通过公开 URL 验证：https://hashproof.dev/verify/:id

有两种支付方式：通过 x402 使用 USDC 进行小额支付（Base 或 Celo）——无需 API 密钥或订阅；或者使用预付费 API 密钥，供企业客户端使用（无需加密货币）。AI Agent 可以使用已充值的钱包直接调用 API。

项目结构

backend/       Express API — credential issuance, verification, payments
frontend/      React app — landing page, credential verification, entity pages
contracts/     CredentialRegistry smart contract (Celo)
mcp/           MCP server (hashproof-mcp on npm) — use HashProof from any AI agent
skills/        Agent skill (npx skills add csacanam/hashproof)
docs/          Architecture and flow documentation

已部署的合约

网络	合约	地址
Celo 主网	CredentialRegistry	`0x7a1B759A602Aba72a70f99Dffd0a386d7504ce9B`

付费 API 端点

端点	价格	说明
`POST /issueCredential`	$0.10 USDC	签发一份可验证凭证
`POST /entities/:id/verificationRequests`	$49 USDC	提交验证请求

通过 x402 使用 Base 或 Celo 上的 USDC 付款。客户端对链下授权进行签名——无需支付 Gas。

免费端点

端点	说明
`GET /verify/:id`	完整的 3 层验证
`GET /templates/:ref/requirements`	获取模板所需字段
`POST /templates/:ref/preview`	生成带水印的预览 PDF（免费）
`GET /stats`	链上凭证计数

面向 AI Agent

HashProof 完全支持 Agent 使用——无需账户，也无需人工注册。可通过以下三种方式接入：

MCP 服务，本地或远程（已列入官方 MCP 注册表，名称为 io.github.csacanam/hashproof）：
```
# local (stdio) — pays per credential with your own wallet via x402, or an API key
claude mcp add hashproof -- npx -y hashproof-mcp

# remote (Streamable HTTP) — nothing to install, API key required to issue
claude mcp add --transport http hashproof https://api.hashproof.dev/mcp
```
工具：preview_template（免费——可迭代自定义布局）、issue_credential（通过 x402 或 API 密钥支付 $0.10）、verify_credential 和 get_template_requirements（免费）。远程服务没有钱包，因此无法使用 x402——需要提供 Authorization: Bearer <api-key>。请参阅 mcp/README.md。
Agent 技能：npx skills add csacanam/hashproof，或在 hashproof.dev/skill.md 阅读。
纯 HTTP + x402：POST /issueCredential 会返回 402 挑战，任何 x402-v2 客户端都可以支付（使用 Base 或 Celo 上的 USDC）。大模型索引：hashproof.dev/llms.txt。