// DEVELOPER QUICKSTART

Build trust-aware
agent applications.

One middleware. Any framework. W3C standard.

$ npm install @moltrust/sdk

Explore API Docs → View on GitHub

// GET STARTED IN 3 STEPS

Install

bash

npm install @moltrust/sdk

Add middleware

typescript
import { AgentTrust } from '@moltrust/sdk';

// Express
app.use(AgentTrust.verify({ minScore: 60 }));

// Hono
app.use('*', AgentTrust.honoVerify({ minScore: 60 }));

Read the result

typescript
app.get('/api/resource', (req, res) => {
  const { did, trustScore, grade, aae }
    = req.agentVerification;
  // Agent verified — proceed with trust context
});

// WORKS WITH YOUR STACK

Framework adapters

typescript
import express from 'express';
import { AgentTrust } from '@moltrust/sdk';

const app = express();

// Verify all agents — minimum trust score 60
app.use(AgentTrust.verify({ minScore: 60 }));

app.post('/api/purchase', (req, res) => {
  const { did, trustScore, aae } = req.agentVerification;

  // AAE already evaluated — safe to proceed
  res.json({ authorized: true, agentDid: did });
});

typescript
import { Hono } from 'hono';
import { AgentTrust } from '@moltrust/sdk';

const app = new Hono();

app.use('*', AgentTrust.honoVerify({ minScore: 60 }));

app.post('/api/purchase', (c) => {
  const verification = c.get('agentVerification');
  return c.json({ authorized: true, did: verification.did });
});

typescript
import Fastify from 'fastify';
import { AgentTrust } from '@moltrust/sdk';

const app = Fastify();

app.addHook('preHandler', AgentTrust.verify({ minScore: 60 }));

// WHAT YOUR AGENTS CARRY

Agent Authorization Envelope

Every MolTrust credential embeds an Agent Authorization Envelope — a machine-readable permission contract your API can inspect before every transaction.

📜 MANDATE

Purpose & allowed actions
Denied actions
Target resources
Delegation rules

🔒 CONSTRAINTS

Time bounds & TTL
Financial thresholds
Autonomous: < $100 · Step-up: $100–$1,000 · Human approval: > $10,000
Jurisdictions
Counterparty min score

✅ VALIDITY

Issuer DID
Holder binding
Expiry timestamp
Revocation endpoint
Base L2 anchor

Read the full specification in Protocol Whitepaper v0.5 →

// TRY IT LIVE

Query any agent's trust score

GET /skill/trust-score/...

// CONFIGURATION

VerifyOptions

Option	Type	Default	Description
minScore	number	0	Minimum trust score required to pass verification. Agents below this threshold receive a 403.
requireAAE	boolean	false	Require a valid Agent Authorization Envelope in the credential. Rejects agents without one.
evaluateAction	string	—	Check whether the AAE mandate permits this specific action (e.g. "purchase", "transfer").
evaluateAmount	number	—	Evaluate AAE financial constraints against this transaction amount (USD).
evaluateJurisdiction	string	—	Verify the AAE permits operations in this ISO 3166-1 jurisdiction code.
apiBase	string	api.moltrust.ch	Override the MolTrust API base URL. Useful for staging or self-hosted deployments.

// WHAT YOU GET

AgentVerification interface

typescript
interface AgentVerification {
  did:          string;        // e.g. "did:moltrust:d34ed796a4dc4698"
  trustScore:   number;        // 0–100
  grade:         'S'|'A'|'B'|'C'|'D'|'F';
  aae:           AAE | null;    // parsed Agent Authorization Envelope
  credential:   VerifiableCredential; // full W3C VC
  issuer:        string;        // issuer DID
  issuedAt:      Date;
  expiresAt:     Date;
  onChainAnchor: string | null; // Base L2 tx hash
}

// RESOURCES

@moltrust/sdk

Express + Hono middleware for agent trust verification.

npm → GitHub →

@moltrust/aae

AAE schema definition & runtime validator.

npm → GitHub →

Protocol WP v0.5

Full specification — trust scoring, AAE, swarm intelligence.

Download PDF →

API Reference

All endpoints — identity, scoring, credentials, swarm.

Explore →

Build trust-awareagent applications.