Skip to content

nutstrut/verified-task

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SAR Protocol x402 Native Ed25519 Signed

Verified Task

Verify any agent output before it is trusted, paid for, or acted on.


🧠 The Problem

AI agents generate outputs β€” but:

  • there is no guarantee the output matches the task
  • incorrect results can silently pass through
  • payments can be triggered without verification
  • downstream systems rely on unverified data

Most workflows assume correctness.

That assumption breaks systems.


βœ… The Solution

Verified Task is a universal verification pattern for agent workflows.

It ensures that:

  • outputs are validated against a defined specification
  • results are deterministically verified
  • proof is generated before any action is taken
  • payment and execution only proceed on success

πŸ” How It Works

  1. Define the task specification
  2. Generate the output
  3. Verify the output using SAR
  4. Receive a verdict + receipt
  5. Proceed only if PASS

πŸ” What You Get

  • PASS / FAIL / INDETERMINATE verdict
  • Signed SAR receipt (verifiable proof)
  • Safe-to-proceed signal
  • TrustScore update per verified task

βš™οΈ Example

Input

{
  "task_id": "task-001",
  "agent_id": "0xYourWallet:your-agent",
  "task_spec": "Summarize x402 news in 3 bullet points",
  "expected_output_format": "JSON array of 3 strings",
  "output": ["...", "...", "..."],
  "counterparty": "0xOptionalCounterpartyWallet"
}

Verification Call

settlement_witness({
  task_id: "task-001",
  agent_id: "0xYourWallet:your-agent",
  spec: { expected: task_spec },
  output: { result: agent_output }
})

Endpoint: POST https://defaultverifier.com/settlement-witness

Output

{
  "verdict": "PASS",
  "safe_to_proceed": true,
  "sar_receipt": {
    "receipt_v0_1": {
      "verdict": "PASS",
      "confidence": 1.0,
      "reason_code": "SPEC_MATCH",
      "receipt_id": "sha256:...",
      "verifier_kid": "sar-prod-ed25519-02",
      "sig": "base64url:..."
    },
    "trustscore_update": {
      "score": 54,
      "tier": "bronze",
      "receipts_to_next": 10
    }
  }
}

πŸ”’ Why This Matters

Without verification:

  • agents produce incorrect results undetected
  • payments settle on unverified work
  • trust is assumed instead of proven

With Verified Task:

  • outputs are provable
  • workflows become deterministic
  • trust becomes explicit and auditable

🧩 Use It Anywhere

Verified Task wraps any workflow:

  • content generation
  • data processing
  • API results
  • automation pipelines
  • agent-to-agent transactions

If an output matters β€” verify it.


πŸ” Offline Verification

Every SAR receipt is independently verifiable:

  1. Fetch public key registry:
    https://defaultverifier.com/.well-known/sar-keys.json

  2. Match verifier_kid to registry key

  3. Canonicalize signed core (RFC 8785)

  4. SHA256 hash β†’ Ed25519 verify

No callbacks required. Receipt remains valid forever.

TypeScript SDK: https://www.npmjs.com/package/sar-sdk
Protocol docs: https://sarprotocol.org
SAR spec: https://defaultverifier.com/spec/sar-v0.1


🌐 Part of the Agent Commerce Stack

x402 β†’ SettlementWitness β†’ TrustScore
Payment β†’ Delivery verification β†’ Reputation

Verified Task is the standard pattern that connects agent workflows to this verification layer.


πŸ”— Relationship to SettlementWitness

Verified Task is a standard usage pattern for SettlementWitness (SAR).

  • SettlementWitness performs verification
  • Verified Task makes it easy to apply

This repository defines how to use SAR β€” not replace it.


πŸš€ The Default Pattern

If an agent is going to:

  • get paid
  • trigger execution
  • make a decision

β†’ wrap it in Verified Task first.


πŸ“¦ Installation

Direct endpoint

POST https://defaultverifier.com/settlement-witness

MCP server

https://defaultverifier.com/mcp

TypeScript SDK

npm install sar-sdk

SkillsMP / Claude Skills Search: Verified Task


πŸ“„ Resources


🏷️ Tags

ai-agents Β· verification Β· workflow-safety Β· agent-commerce Β·
trust Β· automation Β· sar-protocol Β· sarprotocol Β·
settlementwitness Β· deterministic-verification Β·
x402 Β· ed25519 Β· agent-safety Β· output-validation


πŸ“‹ License

MIT

Metadata

Last updated: 2026-04-02

About

Verify any agent output before it is trusted, paid for, or acted on. A universal SAR verification pattern for AI agent workflows.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages