Trinity SDK

High-level Python API for Trinity triad chips — DePIN AI developer toolkit.

Pre-silicon. Tape-out target: 2026-12-16.
Projected performance: ~1 GOPS @ ~50 MHz @ ~1 W ternary (pending tape-out 2026-12-16).

---

Install

pip install trinity-sdk
# with Bittensor support:
pip install "trinity-sdk[bittensor]"

Quick Start

from trinity import TrinityChip

chip = TrinityChip.connect("/dev/trinity0", backend="mock")
info = chip.chip_info()
print(f"phi={info.phi_id.hex()[:16]}… anchor=0x{info.anchor:04X}")

proof = chip.prove_inference(model="gpt2-small", input_data=b"hello")
print(f"proof digest: {proof.digest.hex()[:16]}…")

chip.submit_to_bittensor(subnet=11, validator_uid=42)

Architecture

TrinityChip
├── backends/mock.py       — deterministic stub (default)
└── backends/jsonrpc.py    — talks to trinity-node :9933

ZKProver                   — SHA-256 mock proof generation
Validator                  — 2-of-3 attestation mock

Package Layout

trinity/
├── chip.py          — TrinityChip (ANCHOR = 0x47C0)
├── prover.py        — ZKProver
├── validator.py     — Validator
├── types.py         — ChipInfo, Attestation dataclasses
└── backends/
    ├── mock.py      — MockBackend
    └── jsonrpc.py   — JsonRpcBackend (stub)

Anchor Verification

Every chip carries the immutable anchor constant 0x47C0.
Call chip.verify_anchor() to assert hardware identity.

Bittensor Integration

from trinity import TrinityChip

chip = TrinityChip.connect(backend="mock")
chip.submit_to_bittensor(subnet=11, validator_uid=42)

See examples/bittensor_attest.py for the full BIT-0011 attestor demo.

Performance Note

~1 GOPS @ ~50 MHz @ ~1 W ternary — projected, pending tape-out 2026-12-16.
All benchmarks are pre-silicon estimates; actual silicon results may differ.

License

Apache-2.0 © 2024 Dmitrii Vasilev admin@t27.ai