结构化治理、确定性会计和人工审核的意图——在各个链、组织和个人之间实现统一。Attestia 不会转移您的资金；它证明了发生了什么，限制了可能发生的事情，并使金融记录变得不可篡改。

此包将完整的 Attestia 库整合到一个单一的安装包（ESM）中。内部 @attestia/* 工作区包将被内联——无需管理大量的软件包；第三方运行时依赖项（xrpl、viem、@solana/web3.js、json-canonicalize、ripple-keypairs）将正常解析。

安装

npm install @mcptoolshop/attestia

仅支持 ESM (Node ≥ 22)。通过 GitHub Actions OIDC 可信发布，并使用 npm provenance 发布。

用法

从根目录导入一个域作为命名空间：

import { ledger, proof, registrum } from "@mcptoolshop/attestia";

const total = ledger.addMoney(
  { amount: "100.00", currency: "USD", decimals: 2 },
  { amount: "50.00", currency: "USD", decimals: 2 },
);

const tree = proof.MerkleTree.build([/* sha-256 leaf hashes */]);

……或者从子路径导入扁平符号：

import { MerkleTree, verifyAttestationProof } from "@mcptoolshop/attestia/proof";
import { StructuralRegistrar } from "@mcptoolshop/attestia/registrum";
import { JsonlEventStore } from "@mcptoolshop/attestia/event-store";
import { AttestiaClient } from "@mcptoolshop/attestia/sdk";

子路径

| 子路径 | 它是什么 | |---------|-----------| | @mcptoolshop/attestia | 根目录——每个域作为一个命名空间 | | …/types | 共享域类型（货币、ID、标记的基本数据类型） | | …/ledger | 仅追加的复式记账引擎 + 确定性货币计算 | | …/registrum | 宪法登记处——11 条不变性规则，双重见证 | | …/event-store | 仅追加的事件持久化——JSONL、哈希链 | | …/proof | 默克尔树（RFC 6962），包含 + 证明 | | …/vault | 个人保险库——投资组合、预算、意图 | | …/treasury | 组织金库——工资单、分配、资金闸门 | | …/reconciler | 跨系统匹配 + Registrum 证明 | | …/chain-observer | 多链只读观察（EVM、XRPL、Solana、L2） | | …/witness | XRPL 链上证明，多重签名治理 | | …/verify | 重复验证、合规证据、SLA | | …/sdk | 用于 Attestia REST API 的类型化 HTTP 客户端 |

核心模式

每次交互都遵循一个流程，并且没有可选步骤：

Intent → Approve → Execute → Verify

文档

完整的手册、架构、威胁模型和验证指南：https://mcp-tool-shop-org.github.io/attestia/ · 源代码：https://github.com/mcp-tool-shop-org/attestia

许可证

MIT——由 MCP Tool Shop 构建。