Apache-2.0 developer preview
The Open Commerce Graph for Solana
A public schema, deterministic validator, and content-hashing format for representing real-world businesses in Solana commerce.
Browser-safe. Offline by default. No tokens, no accounts, no vendor lock-in.
Why this exists
Autonomous agents now book appointments, place orders, and route payments on a user's behalf. To act safely they need to verify that a business is real, currently operating, and accepting the asset the user wants to spend before money moves.
Solana settles transactions in seconds. Settlement alone does not tell a wallet whether the merchant on the other end is real, what they sell, which currencies they accept, or whether the payment endpoint matches the brand the user clicked.
Schema.org gives the web a shared vocabulary, but it does not define a content hash, readiness score, authority-strength taxonomy, payment-endpoint shape, or privacy boundary for on-chain anchors.
What's in the box
Six independently usable TypeScript packages, one CLI, and a demo posture that stays fictional and devnet-only.
@realworldcommerce/ocg-schema
TypeScript types, JSON Schema, Zod parsing, RFC 8785 canonicalization, SHA-256 content hashing, Schema.org JSON-LD, and PII detectors.
@realworldcommerce/known-business-validator
Deterministic offline scoring across Identity, Understanding, Proof, and Consistency. Browser-safe, with zero network calls.
@realworldcommerce/solana-pay-readiness
Local mint registry, amount conversion, Solana Pay URL build and parse helpers, payment intent checks, and memo PII safeguards.
@realworldcommerce/known-business-blinks
Solana Action templates for pay-known-business and verify-business-record, with strict GET response builders and a mock transaction adapter.
@realworldcommerce/solana-attestation-schemas
Five devnet-first Solana Attestation Service templates plus a privacy validator that refuses full records or PII on chain.
@realworldcommerce/agentic-commerce-x402
Experimental facilitator-agnostic verifier interface, free search endpoint, paid enriched endpoint, and hardened development bypass.
Run the real demo
The live demo runs the OSS Next app against the same release-candidate packages and fictional fixtures. It exposes pages and APIs for record inspection, scoring, Solana Pay readiness, Blinks, x402, and attestation references.
Fixture browser
Search six fictional Known Business Records, inspect readiness scores, and open the normalized record JSON served by the demo runtime.
Open `/demo`Solana Pay readiness
Build and inspect a devnet-only Solana Pay URL, readiness report, memo checks, and payment-intent diagnostics.
Open pay demoBlinks and Actions
Fetch the live `actions.json` discovery payload and the strict Action GET/POST responses backed by the OSS Blinks package.
Open `actions.json`x402 merchant data
Query the free merchant search projection and compare it with the paid enriched endpoint contract.
Open search APIShow, don't tell
The quickstart path is parse, score, hash. The same core posture runs in Node and in the browser.
import { parseKnownBusinessRecord } from '@realworldcommerce/ocg-schema/zod';
const raw = await readFile('./record.json', 'utf8');
const parsed = parseKnownBusinessRecord(JSON.parse(raw));
if (!parsed.ok) {
for (const issue of parsed.error) {
console.error(`${issue.path.join('.')}: ${issue.message}`);
}
process.exit(1);
}Who's it for
Solana developers
Drop the schema and validator into an indexer, wallet, or back-office tool. Parse a record, get a report, compute a content hash.
Open the developer guideAI agent developers
Use Known Business Records as ground truth before an agent acts. The schema is authoritative and the readiness report is deterministic.
Open the agent guideWallet engineers
Verify a merchant before showing a Pay button. Render who backed each claim, not just a generic verified label.
Open the wallet guideWhat it is not
- A KYC product.
- A KYB product.
- An official Solana verification, endorsement, or certification system.
- A payment processor.
- A transaction submitter. No code path in this repository submits Solana transactions.
- A token. No governance token, no rewards token, no on-chain registry that issues tokens.
- A registry of real businesses. The demo runs on six fictional records and only on devnet.