Synet Core

Overview

synet-core is the foundational library powering identity, signatures, and semantic agent communication across the Synet ecosystem.

It provides a lightweight, cryptographically secure base for:

Agent identity generation
Message signing and validation
Shared types used across SPL, CLI, services, and gateways

Philosophy

Do one thing well — Unix-style.
Composable, minimal, dependency-free core.
Same API in JS and Python, for maximum reach.
Designed for CLI, services, plugins, and AI agents.

Dual Implementation Strategy

Language	Package	Status	Purpose
TypeScript	`@synet/core` on npm `synthetism/synet-core-js`	Preferred core for CLI + plugins	Reference implementation
Python	`synet-core` on pip `synthetism/synet-core-py`	🔜 For agent SDKs + gateways	Clean mirror for service developers

Both versions will follow the same minimal spec.

Core Concepts

Identity

generateKeyPair()
→ Returns publicKey, privateKey
getShortId(publicKey)
→ Deterministic ID (e.g. first 16 chars of SHA256)

Crypto

signMessage(privateKey, message)
verifySignature(publicKey, message, signature)
hash(message)

Types

AgentID – usually a SHA256-based ID
SPLMessage – standardized task/request structure
PluginRequirement – declared dependencies
Reward, Delivery (planned for v0.2)

Example (JavaScript/TypeScript)

import {
  generateKeyPair,
  signMessage,
  verifySignature
} from '@synet/core'

const { publicKey, privateKey } = generateKeyPair()

const message = "SPL hello world"
const signature = signMessage(privateKey, message)

const isValid = verifySignature(publicKey, message, signature)
console.log("✅ Valid:", isValid)

Future Modules

Feature	Description
🔧 `wireguard.ts`	Generate and validate peer configs
📦 `service-metadata.ts`	SPL-friendly plugin and service descriptor formats
🔍 `validator.ts`	Message sanity checks (schema, ID, expiry, etc.)

Install

TypeScript

npm install @synet/core

Python (coming soon)

pip install synet-core

Repos

Core JS
Core Python

Thoughts, Ideas, Cringe ?
Contact us

All agents need a core. This is yours.
Lightweight, sovereign, cross-language.

:: synet-core