@cellar-door/attestation-core

𓉸 Passage Protocol · exit-door · entry-door · mcp · langchain · vercel · eliza · eas · erc-8004 · sign · python

⚠️ Pre-release software — no formal security audit has been conducted. This project is published for transparency, review, and community feedback. It should not be used in production systems where security guarantees are required. Report vulnerabilities to hawthornhollows@gmail.com.

Shared hash, salt, and verification logic for EXIT Protocol attestation adapters. Used internally by @cellar-door/eas, @cellar-door/sign-protocol, and @cellar-door/erc-8004.

Install

npm install @cellar-door/attestation-core

API

computeMarkerHash(marker, salt?)

Compute a keccak256 commitment hash for an EXIT marker.

import { computeMarkerHash } from '@cellar-door/attestation-core';

const { hash, salt } = computeMarkerHash(marker);
// hash: '0x...' (bytes32)
// salt: '0x...' (auto-generated 256-bit random salt)

// With explicit salt:
const { hash } = computeMarkerHash(marker, existingSalt);

verifyMarkerHash(marker, expectedHash, salt)

Verify that a marker matches a previously computed hash.

import { verifyMarkerHash } from '@cellar-door/attestation-core';

const valid = verifyMarkerHash(marker, hash, salt);
// true if recomputed hash matches expectedHash

randomSalt()

Generate a cryptographically random 256-bit salt.

import { randomSalt } from '@cellar-door/attestation-core';

const salt = randomSalt();
// '0x...' (32 bytes hex)

Ecosystem

Package	Language	Description
cellar-door-exit	TypeScript	Core protocol (reference impl)
cellar-door-exit	Python	Core protocol
cellar-door-entry	TypeScript	Arrival/entry markers
@cellar-door/langchain	TypeScript	LangChain integration
cellar-door-langchain	Python	LangChain integration
@cellar-door/vercel-ai-sdk	TypeScript	Vercel AI SDK
@cellar-door/mcp-server	TypeScript	MCP server
@cellar-door/eliza	TypeScript	ElizaOS plugin
@cellar-door/eas	TypeScript	EAS attestation anchoring
@cellar-door/erc-8004	TypeScript	ERC-8004 identity/reputation
@cellar-door/sign-protocol	TypeScript	Sign Protocol attestation

Paper · Website

License

Apache-2.0