langchain - ✅(Solved) Fix Add TTTPoTTool — Proof-of-Time temporal attestation for agent transactions [2 pull requests, 8 comments, 6 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
langchain-ai/langchain#35999Fetched 2026-04-08 00:53:02
View on GitHub
Comments
8
Participants
6
Timeline
21
Reactions
0
Timeline (top)
commented ×8labeled ×7cross-referenced ×4closed ×1

Fix Action

Fixed

PR fix notes

PR #35998: community[tool]: TTTPoTTool - Proof-of-Time attestation for agent transactions

Description (problem / solution / changelog)

Summary

Adds TTTPoTTool and TTTPoTVerifyTool for generating and verifying cryptographic temporal attestations on blockchain transactions.

Motivation

When multiple AI agents compete for the same on-chain resource, ordering disputes are inevitable. TTT provides Byzantine-resistant proof of when a transaction was submitted, using 4 independent HTTPS time sources.

New tools

  • TTTPoTTool — Generate a PoT attestation before a transaction hits the chain
  • TTTPoTVerifyTool — Verify a PoT attestation after transaction confirms

Dependencies

  • httpx (already in langchain deps)

Links

Changed files

  • libs/langchain/langchain_classic/tools/ttt/__init__.py (added, +3/-0)
  • libs/langchain/langchain_classic/tools/ttt/ttt_pot_tool.py (added, +83/-0)
  • libs/langchain/tests/unit_tests/tools/ttt/__init__.py (added, +0/-0)
  • libs/langchain/tests/unit_tests/tools/ttt/test_ttt_pot_tool.py (added, +29/-0)

PR #36007: community: add TTTPoTTool for Proof-of-Time transaction attestation

Description (problem / solution / changelog)

Closes #35999

Summary

Adds TTTPoTTool and TTTPoTVerifyTool for generating and verifying cryptographic temporal attestations on blockchain transactions.

Motivation

When multiple AI agents compete for the same on-chain resource, ordering disputes are inevitable. TTT provides Byzantine-resistant proof of when a transaction was submitted, using 4 independent HTTPS time sources.

New tools

  • TTTPoTTool — Generate a PoT attestation before a transaction
  • TTTPoTVerifyTool — Verify a PoT attestation after confirmation

Dependencies

  • httpx (already in langchain deps)

Links

Changed files

  • libs/langchain/langchain_classic/tools/ttt/__init__.py (added, +3/-0)
  • libs/langchain/langchain_classic/tools/ttt/ttt_pot_tool.py (added, +92/-0)
  • libs/langchain/tests/unit_tests/tools/ttt/__init__.py (added, +0/-0)
  • libs/langchain/tests/unit_tests/tools/ttt/test_ttt_pot_tool.py (added, +29/-0)
RAW_BUFFERClick to expand / collapse

Checked other resources

  • This is a feature request, not a bug report or usage question.
  • I added a clear and descriptive title that summarizes the feature request.
  • I used the GitHub search to find a similar feature request and didn't find it.
  • I checked the LangChain documentation and API reference to see if this feature already exists.
  • This is not related to the langchain-community package.

Package (Required)

  • langchain
  • langchain-openai
  • langchain-anthropic
  • langchain-classic
  • langchain-core
  • langchain-model-profiles
  • langchain-tests
  • langchain-text-splitters
  • langchain-chroma
  • langchain-deepseek
  • langchain-exa
  • langchain-fireworks
  • langchain-groq
  • langchain-huggingface
  • langchain-mistralai
  • langchain-nomic
  • langchain-ollama
  • langchain-openrouter
  • langchain-perplexity
  • langchain-qdrant
  • langchain-xai
  • Other / not sure / general

Feature Description

Add TTTPoTTool and TTTPoTVerifyTool to langchain-community. These tools wrap the openttt SDK to provide cryptographic Proof-of-Time attestation for agent transactions.

from langchain_community.tools.ttt import TTTPoTTool, TTTPoTVerifyTool

pot_tool = TTTPoTTool() pot = pot_tool.run({"tx_hash": "0x...", "chain_id": 8453})

verify_tool = TTTPoTVerifyTool() result = verify_tool.run({"pot_hash": pot["potHash"]})

Implementation is ready in PR #35998.

Use Case

AI agents executing transactions have no way to prove temporal ordering. When an agent reports "executed at time T", there is no standard way to verify the timestamp wasn't manipulated between agent intent and on-chain execution.

TTTPoTTool generates an Ed25519-signed timestamp BEFORE the transaction hits chain. TTTPoTVerifyTool confirms ordering AFTER confirmation. This detects front-running and timestamp manipulation at the protocol level.

Works with any agent that calls smart contracts, DeFi protocols, or time-sensitive APIs — especially relevant as AI agents increasingly handle autonomous payments (140M+ agent transactions in 9 months per Circle data).

Proposed Solution

Add two tools to langchain-community under langchain_community.tools.ttt:

  1. TTTPoTTool — generates an Ed25519-signed Proof-of-Time anchor BEFORE a transaction hits chain. Returns a cryptographic timestamp bound to chain context (chainId + poolAddress).

  2. TTTPoTVerifyTool — verifies a PoT anchor AFTER transaction confirms. Detects if ordering was manipulated.

Usage:

from langchain_community.tools.ttt import TTTPoTTool, TTTPoTVerifyTool

# Anchor before tx
pot_tool = TTTPoTTool()
pot = pot_tool.run({"tx_hash": "0x...", "chain_id": 8453})

# Verify after confirmation
verify_tool = TTTPoTVerifyTool()
result = verify_tool.run({"pot_hash": pot["potHash"]})

The tools wrap the openttt SDK (npm: openttt) and are compatible
with Claude Desktop, LangChain, and OpenAI function calling via
@helm-protocol/ttt-mcp MCP server.


### Alternatives Considered



∙	Using block timestamp alone: unreliable, manipulable by builders
	∙	Trusted third-party timestamping: centralized, not verifiable
	∙	Current approach: no standard solution exists in LangChain

### Additional Context

	∙	SDK: npm install openttt | npm install @helm-protocol/ttt-mcp
	∙	GitHub: https://github.com/Helm-Protocol/OpenTTT
	∙	IETF Draft: https://datatracker.ietf.org/doc/draft-helmprotocol-tttps/
	∙	Live data: 49,000+ Proof-of-Time records on Base Sepolia (3 channels)
	∙	PR ready: #35998 (pending issue approval)
	∙	MCP server registered on modelcontextprotocol.io
The protocol is being standardized at IETF as an Experimental Draft.
AI agent channel generates PoTs 2x faster than DEX swaps —
agents are the dominant use case.

extent analysis

Fix Plan

To integrate TTTPoTTool and TTTPoTVerifyTool into langchain-community, follow these steps:

  1. Install required dependencies:

    • Install the openttt SDK using npm: npm install openttt
    • Install the @helm-protocol/ttt-mcp MCP server: npm install @helm-protocol/ttt-mcp
  2. Implement TTTPoTTool:

    • Create a new file ttt.py in langchain_community/tools/ with the following code:

from openttt import OpenTTT

class TTTPoTTool: def init(self): self.openttt = OpenTTT()

def run(self, params):
    tx_hash = params["tx_hash"]
    chain_id = params["chain_id"]
    # Generate Ed25519-signed Proof-of-Time anchor
    pot = self.openttt.generate_pot(tx_hash, chain_id)
    return pot

3. **Implement TTTPoTVerifyTool**:
- Add the following code to `ttt.py`:
```python
class TTTPoTVerifyTool:
 def __init__(self):
     self.openttt = OpenTTT()

 def run(self, params):
     pot_hash = params["pot_hash"]
     # Verify Proof-of-Time anchor
     result = self.openttt.verify_pot(pot_hash)
     return result
  1. Integrate with langchain-community:
    • Import the tools in langchain_community/tools/__init__.py:

from .ttt import TTTPoTTool, TTTPoTVerifyTool

- Use the tools as described in the proposed solution:
```python
from langchain_community.tools.ttt import TTTPoTTool, TTTPoTVerifyTool

pot_tool = TTTPoTTool()
pot = pot_tool.run({"tx_hash": "0x...", "chain_id": 8453})

verify_tool = TTTPoTVerifyTool()
result = verify_tool.run({"pot_hash": pot["potHash"]})

Verification

To verify the fix, test the TTTPoTTool and TTTPoTVerifyTool with sample transactions and verify that the Proof-of-Time anchors are generated and verified correctly.

Extra Tips

  • Ensure the openttt SDK and @helm-protocol/ttt-mcp MCP server are properly installed and configured.
  • Review the IETF Draft and GitHub repository for the latest updates on the OpenTTT protocol.
  • Consider implementing additional error handling and logging mechanisms for the TTTPoTTool and TTTPoTVerifyTool.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

langchain - ✅(Solved) Fix Add TTTPoTTool — Proof-of-Time temporal attestation for agent transactions [2 pull requests, 8 comments, 6 participants]