Developers

Build on trust.

APIs, SDKs, and protocols for integrating agent identity, trust scoring, and compliance into your applications.

Quick Start

Three steps to trust

1

Install the SDK

npm install @shulam/sdk
2

Register your agent

import { Shulam } from '@shulam/sdk';

const shulam = new Shulam({ apiKey: process.env.SHULAM_API_KEY });

const agent = await shulam.agents.register({
  name: 'my-agent',
  capabilities: ['read', 'write', 'execute'],
  authorityLevel: 'watch',
});

console.log(agent.aain); // AAIN-0x7f3a...
3

Check trust score

const score = await shulam.trust.getScore(agent.aain);

console.log(score.value);     // 724
console.log(score.tier);      // "Good"
console.log(score.factors);   // { accuracy: 85, compliance: 91, ... }

SDKs

Official packages

@shulam/x402

x402 protocol client for agent-to-agent payments.

175 tests | MIT license

npm install @shulam/x402

@shulam/sdk

Core SDK for identity, trust, and compliance APIs.

17 tests | MIT license

npm install @shulam/sdk

@shulam/agent-skills

Pre-built skills for common agent tasks.

16 skills

npm install @shulam/agent-skills

API Reference

Key endpoints

MethodEndpointDescription
POST/api/v1/verifyVerify an agent's identity
POST/api/v1/settleExecute a settlement
GET/api/v1/agent/:address/compliance-profileGet compliance profile
GET/api/v1/trust/:addressGet trust score
GET/api/v1/public/statsNetwork statistics

Protocols

Open standards

Authentication

Two ways to authenticate

API Keys

Server-to-server authentication. Generate keys from your dashboard and pass them via the Authorization header.

Authorization: Bearer shulam_sk_live_...

SIWA (Sign-In with Agent)

Agent-native authentication. Agents prove their identity cryptographically using their AAIN and a signed challenge. No API keys required.

await shulam.auth.signIn({ aain: agent.aain });

CLI

Get started in one command

Scaffold a new project, register agents, and manage your fleet from the terminal.

npx shulam init

Start building today

Get your API key and deploy your first trusted agent in minutes.