Public alpha package workspace for Intuition protocol and semantic engineering libraries.
These packages split Intuition's protocol, identity, and knowledge-graph modeling tools into focused ESM-only TypeScript packages. Builders can install only the layers they need while still converging on shared Intuition vocabulary, deterministic IDs, and graph modeling conventions.
View the @0xintuition npm organization.
The fastest way to see the packages working together is the hackathon quickstart:
cd examples/hackathon-quickstart
bun run devThe example is dry-run only: no wallet, API key, or live submission service is required. It shows how Creation Profiles drive atom data, metadata predicate relationships, sameAs identity links, deterministic IDs, and generated UI surfaces.
Use these packages to build Intuition-aligned knowledge graph flows:
- schema-backed atom creation forms with shared classification fields
- metadata predicate pickers that suggest valid relationship triples
- deterministic atom, predicate, triple, and counter-triple IDs before writing on-chain
- sameAs identity-linking flows that separate atom payload choices from graph-growth choices
- generated creation UIs from package data instead of app-local shadow maps
- protocol read/write surfaces once your app owns submission and wallet flow
For known creation flows, start from a Creation Profile:
import { musicRecordingCreationProfile } from '@0xintuition/classifications/creation/music-recording'
const fields = musicRecordingCreationProfile.fields
const relationships = musicRecordingCreationProfile.relationshipsUse fields to render atom inputs and relationships to suggest triples such as
MusicRecording -> inPlaylist -> MusicPlaylist.
| Layer | Packages | Purpose |
|---|---|---|
| Semantic / data modeling | schema-org, classifications, predicates |
Canonical vocabulary, schema references, recommended atom fields, metadata predicates, and relationship guardrails |
| Identity | ids |
Deterministic content-addressable IDs for atoms, predicates, triples, counter-triples, and OAuth atoms |
| Builder helpers | primitives |
Higher-level atom, predicate, triple, discovery, and validation helpers |
| Protocol plumbing | protocol, deployments, periphery, curves, react |
ABIs, chain/deployment metadata, bridge/router helpers, curve math, and React hooks |
@0xintuition/schema-org- pinned schema.org vocabulary with inherited property lookup.@0xintuition/classifications- Intuition classification specs, Creation Profiles, recommended atom fields, and metadata predicates.@0xintuition/predicates- canonical predicate registry, deterministic predicate IDs, launch constants, and display helpers.@0xintuition/ids- deterministic atom, predicate, triple, counter-triple, and OAuth atom IDs.@0xintuition/primitives- high-level builders and validators for off-chain Intuition data.@0xintuition/protocol- core contract ABIs, event parsers, and protocol interaction helpers.@0xintuition/deployments- Intuition chain metadata and core protocol deployment addresses.@0xintuition/periphery- periphery bridge/router deployment helpers and calldata utilities.@0xintuition/curves- bonding curve math helpers.@0xintuition/react- React provider and hooks for protocol reads/writes.
Most fresh packages are alpha packages:
bun add @0xintuition/classifications@alpha @0xintuition/predicates@alpha@0xintuition/protocol uses the 3.x line because it supersedes the previous monolithic protocol package.
bun install --frozen-lockfile
bun run build
bun run typecheck
bun run test
bun run check
bun run schema:validate
bun run schema-org:check-generated
bun run classifications:check-creation-profiles
bun run predicates:check-generated
bun run guard:supply-chain
bun run pack:dry-run
bun run smoke:tarballsPackage roots are npm-publishable artifacts. Release PRs should follow the validation gate, dist-tag policy, and publish order documented in docs/release.md.