Skip to content
View ProofCore-Protocol's full-sized avatar

Block or report ProofCore-Protocol

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
.github/profile/README.md

πŸ› ProofCore Protocol

The Cryptographic Evidence & Provenance Layer on TON Blockchain

PyPI Version MCP Server GitHub Action Smart Contract Compliance License: MIT

Turn digital events, AI outputs, and release binaries into tamper-evident, verifiable proof.
Zero-Auth. Zero-Storage. O(log N) Merkle Batching on The Open Network (TON).

🌐 Web Platform β€’ ⚑ Interactive Playground β€’ πŸ€– Telegram Bot β€’ πŸ“– Documentation β€’ πŸ€– llms.txt


⚑ The Core Axiom

"Don't trust ProofCore. Verify the mathematical proof yourself."

ProofCore is not a centralized SaaS notary. It is a cryptographic commitment protocol designed to bridge human communication, DevOps release chains, and autonomous AI agents with the TON Blockchain.

  • Payload Integrity (SHA-256): Verifies the raw bytes have not changed.
  • Batch Inclusion (O(log N) Merkle Trees): Proves an individual item belongs to an anchored batch without requiring access to other batch data.
  • Timestamped Existence: Anchors the root cryptographic commitment into an immutable TON Blockchain block transaction.
  • Zero-Storage Architecture: Raw user files and private datasets are never stored on-chain. Only the 64-character Merkle Root is committed publicly.

πŸ—Ί The Ecosystem Repositories

Repository Distribution Channel Target Audience Description
proofcore pip install proofcore Python, AI & Web3 Devs Core Python SDK, LangChain/CrewAI tools, and ProofRegistry.tact contracts.
proofcore-mcp uvx proofcore-mcp Cursor, Claude Desktop Model Context Protocol (MCP) server for autonomous AI audit notarization.
proofcore-action GitHub Marketplace DevOps, Security Teams CI/CD Action to notarize release binaries and SBOMs with GitHub OIDC authentication.
cursor-web3-auditor cursor.directory Smart Contract Auditors Cursor IDE (.mdc) rule to automatically seal security audit verdicts.

πŸš€ Quickstarts by Environment

1. Python SDK (proofcore)

pip install proofcore
from proofcore import seal, verify

# 1. Seal an artifact anonymously (Zero-Auth / Zero-Storage)
receipt = seal(
    content="Security Audit: Vault.sol passed with 0 Critical issues.",
    agent_id="Claude-3.5-Sonnet",
    title="Vault.sol Audit Report"
)
print(f"Verified URL: {receipt['verification_url']}")
print(f"Citation Badge: {receipt['citation']}")

# 2. Programmatically verify authenticity (M2M)
result = verify(
    deal_id=receipt["deal_id"],
    content="Security Audit: Vault.sol passed with 0 Critical issues."
)
assert result["valid"] is True

2. Model Context Protocol (MCP) for Cursor / Claude Desktop

Run instantly without installation:

# Claude Code CLI
claude mcp add proofcore https://mcp.proofcore.org

Or add to your .cursor/mcp.json / claude_desktop_config.json:

{
  "mcpServers": {
    "proofcore": {
      "url": "https://mcp.proofcore.org"
    }
  }
}

3. GitHub Actions CI/CD Supply Chain Notarization

Automatically hash compiled release binaries on GitHub runners and anchor them to TON:

name: Release & Notarize
on:
  release:
    types: [published]

permissions:
  id-token: write # Required for Cryptographically Proven GitHub OIDC Identity
  contents: read

jobs:
  notarize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: ProofCore Notary
        uses: ProofCore-Protocol/proofcore-action@v1
        with:
          files: "dist/*.tar.gz, dist/*.whl"
          title: "Release ${{ github.ref_name }}"

πŸ“¦ Autonomous Evidence Package (ZIP)

Every proof anchored by the protocol can be exported into an air-gapped, self-contained Evidence Archive (GET /api/download/{deal_id}):

proof_evidence_package.zip
β”œβ”€β”€ πŸ“ 1_ORIGINAL_ASSET/        ← Unmodified raw payload (HTML, PDF, Media)
β”œβ”€β”€ πŸ“ 2_PROOF_DATA/           ← proof.json (Merkle path) + forensic_metadata.json
β”œβ”€β”€ πŸ“ 3_VERIFIERS/            ← verify.html & verify.py (100% Offline 3-Way Match)
β”œβ”€β”€ πŸ“ 4_LEGAL_CERTIFICATE/    ← FRE 902(14) / eIDAS PDF with verification QR
└── πŸ“ 5_README/               ← Offline audit instructions

Verification Principle: The 3-Way Match

Local Asset SHA-256  ──(+ Siblings)──►  Calculated Root == Manifest Root == TON Block Payload

πŸ“ Mathematical Specification (proofcore-merkle-v1)

       [ Merkle Root ]  ◄── Committed to TON (Opcode 0 payload: "MR: <root>")
          /        \
     Hash(0-1)   Hash(2-3)
       /   \       /   \
     H(A) H(B)   H(C) H(D)
  • 1. Asset Digest:
    H_asset = SHA256(raw_bytes)
    
  • 2. Metadata Digest:
    H_meta = SHA256(forensics_json_bytes)
    
  • 3. Combined Deal Hash:
    H_deal = SHA256( (H_asset_1 + ... + H_asset_n + H_meta).encode('utf-8') )
    
  • 4. Tree Traversal: For each sibling in merkle_path:
    • direction == 'left' βž” H_next = SHA256( (sibling + H_current).encode('utf-8') )
    • direction == 'right' βž” H_next = SHA256( (H_current + sibling).encode('utf-8') )

πŸ› Legal Admissibility & Jurisprudence

  • πŸ‡ΊπŸ‡Έ US Federal Rules of Evidence (FRE 902): Rule 902(14) establishes that electronic data authenticated by a certified digital identification process (cryptographic hash) is self-authenticating in judicial proceedings.
  • πŸ‡ͺπŸ‡Ί EU eIDAS Regulation (EU No 910/2014): Article 41(1) recognizes electronic time stamps as legally admissible evidence, prohibiting denial of legal effect solely due to electronic form.
  • βš–οΈ The "Proof is Not Truth" Distinction: ProofCore cryptographically certifies Integrity (bytes match), Inclusion (belongs to the batch), and Existence (anchored at time T). It does not evaluate the factual truthfulness of the underlying claims.

🌐 Public Gateways & Discovery


Built by the ProofCore Protocol Core Contributors. Open-source under MIT License.

Pinned Loading

  1. proofcore-action proofcore-action Public

    GitHub Action to cryptographically seal Release Notes on the TON Blockchain via ProofCore.

    3

  2. cursor-web3-auditor cursor-web3-auditor Public

    Web3 security auditor config for Cursor IDE. Makes your AI assistant automatically notarize smart contract audits on the TON Blockchain via ProofCore.

    1

  3. proofcore proofcore Public

    πŸ›‘ Trust you can't delete. Cryptographic Proof-of-Existence (PoE) engine built on TON Blockchain. Seal Telegram chats, E-Mails, and files into immutable digital evidence compliant with FRE 902 & eIDAS.

    Python 1

  4. proofcore-mcp proofcore-mcp Public

    Python 1