OnSocial Protocol

Own the Graph.

Identity, relationships, and social state — portable across dApps. Profiles, posts, groups, scarces, boosts, and spend — with a gateway SDK on NEAR.

Live: onsocial.id · App · Portal · API
Testnet: testnet.onsocial.id · testnet app · core · token · boost · social-spend · scarces

---

Quick start

pnpm install
make setup                 # Docker images for contracts / Node
pnpm --filter @onsocial/portal dev   # http://localhost:3000
pnpm --filter @onsocial/app dev      # http://localhost:3060

Build against the SDK and gateway first; contract and indexer details live in their package READMEs. Full make targets: Resources/MAKE_TARGETS.md.

---

Architecture

flowchart LR
  Clients[App / Portal / SDK] --> GW[Gateway]
  GW --> Hasura[Hasura]
  GW --> Relayer[Relayer]
  GW --> Storage[Storage]
  Hasura --> PG[(Postgres)]
  Indexer[Chain index] --> PG
  Relayer --> NEAR[NEAR]
  Indexer --> NEAR

Clients talk HTTP to the gateway. Indexed reads come from Hasura/Postgres, filled by the chain index on the NEAR node. Writes go on-chain via wallets or the relayer. Contracts on NEAR hold the graph, token, boost, social-spend, and scarces logic.

---

Repo map

Path	Role
Contracts
contracts/core-onsocial	Posts, groups, profiles, permissions
contracts/token-onsocial	SOCIAL (NEP-141)
contracts/boost-onsocial	Lock SOCIAL, boost-seconds rewards
contracts/social-spend-onsocial	Support, amplify, seasons, endorsements
contracts/scarces-onsocial	Listings & commerce
contracts/intents-onsocial	Outcome bounties / escrow
contracts/vesting-onsocial	Token vesting vaults
Packages
packages/onsocial-sdk	Gateway-first TypeScript SDK
packages/onsocial-gateway	GraphQL, storage, relay API
packages/onsocial-relayer	Tx relayer (Rust, KMS signing)
packages/onsocial-rpc	NEAR RPC client (failover / retry)
packages/onsocial-app

---

Links

Contributing · Mainnet go-live · Deployment · Make targets · Resources

MIT — LICENSE.md