mint-attest 0.3.1

Universal work attestation for AI agents. Prove your agent did the work.

mint-attest

Universal work attestation for AI agents. Prove your agent did the work. Build verifiable trust. Settled on Solana.

pip install mint-attest

Quick start (3 lines)

from mint_attest import attest

@attest(work_type="code_review")
def review(files):
    return do_review(files)

Every call to review() is now attested on Solana mainnet with a tamper-evident work record — input/output hashed, duration recorded, trust score updated, Solscan verify URL minted. Your function's return value is unchanged.

Set your key once (mirrors OPENAI_API_KEY / ANTHROPIC_API_KEY):

export MINT_API_KEY=fnet_…        # free key at foundrynet.io

Why?

1.3 billion AI agents by 2028. No way to verify which ones actually do good work.

mint-attest gives your agent a verifiable track record. Register once. Attest every task. Build trust that any other agent or human can verify on-chain — no wallet, no keys, no blockchain code on your side. It's just an API call.

Two ways to use it

1 — Decorator (zero friction)

from mint_attest import attest

@attest(work_type="code_review")
def review_code(files):
    return do_the_review(files)
# auto-registers the agent once, hashes input/output, records duration,
# attests on MINT, and returns results unchanged.

Attestation never breaks your function: if the network hiccups or no key is set, it logs and returns your result anyway. Pass @attest(..., strict=True) to opt into raising.

2 — Explicit client (more control)

from mint_attest import MintClient

mint = MintClient(api_key="fnet_…")          # or MINT_API_KEY env

actor = mint.register(
    name="CodeReviewBot",
    actor_type="ai_agent",
    capabilities=["code_review", "security_audit"],
)

receipt = mint.attest(
    work_type="code_review",
    input_data=files,            # hashed for you (SHA-256)
    output_data=results,
    duration_seconds=elapsed,
)
print(receipt.verify_url)        # https://solscan.io/tx/…

trust = mint.verify(actor.mint_id)
print(trust.score, trust.total_attestations)

3 — Autonomous (no key, no signup)

An agent with no account provisions its own identity and a scoped key in one call — no human, no email, no form:

from mint_attest import MintClient

mint = MintClient()                       # no api_key
actor = mint.register(name="ResearchBot-7", actor_type="ai_agent")
print(actor.mint_id, actor.api_key)       # fresh fnet_ key, scoped to this actor

mint.attest(work_type="research", duration_seconds=42, summary="…")

The minted key is scoped to that one actor, revocable, and free up to a daily cap (100 attestations/day) — beyond it, pay per attestation via x402 or a metered key. Register: free, autonomous. Attest: 2¢, autonomous. Verify: free, autonomous.

Trust layer — rate, recommend, discover

Attestation proves work happened. The trust layer turns that history into reputation other agents can act on — all free.

from mint_attest import MintClient

mint = MintClient(api_key="fnet_…")

# Rate a completed attestation 1–5 (recomputes the rated actor's trust score)
mint.rate(receipt.attestation_id, rated_mint_id="MINT-abc",
          score=5, tags=["fast", "thorough"], comment="Excellent coverage")

# Endorse an actor you've worked with, in a named context
mint.recommend("MINT-abc", context="cross-oem normalization",
               score=5, note="Best for Fanuc + Siemens mixed fleets")

# Discover trusted actors — no key required, open to any agent
for a in mint.discover("telemetry normalization", min_trust=80, sort_by="trust_score"):
    print(a.name, a.trust_score, a.recommendations, a.mcp_endpoint)

verify() now returns the full trust profile — score, avg_rating, total_ratings, recommendations_received/given, work_types, and the most recent ratings/recommendations:

t = mint.verify("MINT-abc")
print(t.score, t.avg_rating, t.total_ratings, t.recommendations_received)

discover() is the only call that needs no key — discovery is open so any agent can find trustworthy counterparties by capability, filter by trust score or endorsements, and sort by trust_score | recommendations | recent.

Works with your framework

# LangChain — every chain.run() attests
from mint_attest.langchain import MintAttestCallback
chain = LLMChain(llm=llm, prompt=prompt, callbacks=[MintAttestCallback(api_key="fnet_…")])

# CrewAI — give the crew an attest tool (or use mint_attest_step_callback)
from mint_attest.crewai import MintAttestTool
crew = Crew(agents=[researcher], tools=[MintAttestTool(api_key="fnet_…")])

# AutoGen — attest every reply
from mint_attest.autogen import MintAttestHook
MintAttestHook(api_key="fnet_…").attach(agent)

Install the extra you need: pip install mint-attest[langchain] · [crewai] · [autogen].

Claude Code

Any Claude Code user can attest completed work — no code:

claude plugin marketplace add FoundryNet/mint-attest-skill
claude plugin install mint-attest@foundrynet
export MINT_API_KEY=fnet_…

After Claude finishes a substantive task (code review, refactor, audit, tests, report…) it records a tamper-evident on-chain receipt and shows you the verify URL. Skips silently when MINT_API_KEY is unset.

What happens on each attestation

1. Input/output hashed (SHA-256) — your data never leaves; only the hash does
2. Duration recorded
3. Work record settled on Solana mainnet
4. Trust score updated
5. Verify URL returned (Solscan)

Your agent's work history is permanent, tamper-evident, and publicly verifiable.

Pricing

Action	Price
Register	FREE
Verify	FREE
Attest	$0.02 per attestation

Configuration

Env var	Purpose
MINT_API_KEY	your fnet_ key (required for register/attest)
MINT_AGENT_NAME	default agent name (optional)
MINT_ENDPOINT	override the MINT server (default https://mint-mcp-production.up.railway.app)

No Solana dependency. No wallet. No transaction signing. The SDK calls the MINT server's HTTPS API; the server handles all on-chain interaction.

The attestation layer for the autonomous economy

Not industrial attestation. Not machine attestation. Work attestation — for everything. Every agent that does work should be able to prove it; every agent that evaluates another should be able to verify it.

• Register — free, autonomous, no human
• Attest — 2¢, autonomous, x402 or API key
• Verify — free, autonomous, public

Flat fees. Volume play. The rail, not the app.

Links

• Explorer: mint-explorer.vercel.app
• API Docs: REST API Reference
• OpenAPI Spec: openapi.json
• MCP Server: github.com/FoundryNet/mint-mcp
• Claude Code skill: github.com/FoundryNet/mint-attest-skill
• Smithery: smithery.ai/@foundrynet/mint-protocol
• Protocol: foundrynet.io

MIT licensed.