@soul/sdk

Official TypeScript SDK for the Soul trust platform.

Install

npm install @soul/sdk

Quick start

import { Soul } from '@soul/sdk'

const soul = new Soul({ apiKey: 'sk_live_...' })

// Verify content
const scan = await soul.scan('https://example.com/photo.jpg')
console.log(scan.verdict) // "LIKELY_AUTHENTIC"

// Detect AI / deepfakes
const detection = await soul.shield.detect({ url: 'https://...' })
console.log(detection.engines)

// Register content provenance
const record = await soul.provenance.register({ url: 'https://...', creator: 'soul:S-00142' })

// Verify provenance
const check = await soul.provenance.verify(record.sha256)

// Authenticate a physical product
const product = await soul.bridge.create({ product_name: 'Aspirin 500mg', product_type: 'pharma', manufacturer: 'Bayer' })

// Verify a product (public, no API key needed)
const verified = await soul.bridge.verify(product.id)

// Composite trust score
const trust = await soul.trust.score({ soul_id: 'S-00142', world_id: '0x...', content_hash: 'sha256:...' })
console.log(trust.trust_score) // 92

API Reference

Full documentation at soulverified.com/developers.

License

MIT