Linkora is an open-source SocialFi platform built on Stellar and Soroban. It combines social networking with on-chain financial primitives — creator profiles, follow graphs, posts, token tipping, community pools, and a mini app ecosystem — for creators, communities, and investors. The protocol is governed on-chain and designed to give creators direct ownership of their audience and revenue.
| Package | State |
|---|---|
packages/contracts |
✅ Core social + DeFi primitives, unit tested |
packages/sdk |
🔧 In progress — typed contract client |
apps/web |
🔧 In progress — Next.js web frontend |
apps/mobile |
🔧 In progress — Expo / React Native mobile app |
services/indexer |
🔧 In progress — off-chain event indexer |
services/dm-relay |
🔧 In progress — E2EE direct-message relay |
services/analytics-oracle |
🔧 In progress — on-chain analytics oracle |
examples/mini-apps |
✅ Example mini apps available |
┌─────────────────────────────────────────────────────────────────┐
│ Soroban Smart Contract (packages/contracts) │
│ Profiles · Posts · Tips · Pools · Governance · Moderation │
└───────────┬────────────────────────┬────────────────────────────┘
│ contract calls (XDR) │ events (Stellar RPC)
▼ ▼
┌──────────────────────┐ ┌─────────────────────────────────────┐
│ SDK (packages/sdk) │ │ Indexer (services/indexer) │
│ LinkoraClient │ │ PostgreSQL · full-text search API │
│ TransactionQueue │ └─────────────────────────────────────┘
└──────────┬───────────┘ │ REST / WebSocket
│ ▼
│ ┌────────────────────────────────────┐
└─────────────►│ Web (apps/web) · Mobile (apps/mobile) │
│ Next.js 15 · Expo / React Native │
└────────────────────────────────────┘
# 1. Clone and run the setup script (checks prerequisites, installs deps, builds contracts)
./scripts/setup.sh
# 2. Web frontend
cd apps/web && pnpm dev # http://localhost:3000
# 3. Mobile app
cd apps/mobile && pnpm start # press 'a' (Android) or 'i' (iOS)
# 4. Indexer
cd services/indexer
cp .env.example .env # fill in DATABASE_URL and SOROBAN_RPC_URL
pnpm dev
# 5. Contract tests
pnpm --filter contracts test # or: cd packages/contracts && cargo test# Contract unit tests
pnpm --filter contracts test
# Indexer database migrations (requires Docker + Compose v2)
# Spins up a throwaway PostgreSQL, applies all migrations forward, checks the
# schema against the committed snapshot, verifies idempotency on re-apply, and
# tears the database down. Runs in well under a minute.
bash tests/migrations/test-migrations.shSee services/indexer/migrations/README.md
for the migration authoring rules, reversibility policy, and how to refresh the
schema snapshot after an intentional change.
The complete, organized documentation index lives at docs/INDEX.md — start there for a full table of contents covering Getting Started, Architecture, Smart Contracts, SDK, Backend Services, Frontend, Mini Apps, Security, and Release & Deployment.
| Document | Description |
|---|---|
| Documentation Index | Master table of contents for all developer docs |
| Contract API Reference | Full function reference, storage layout, and event schema |
| SDK Reference | Typed TypeScript client, transaction queue, and event API |
| Contract Archival ADR | Tombstone lifecycle, cleanup permissions, and rent policy |
| System Architecture | Component overview and data flows |
| Design System | UI/UX specifications and brand identity |
| Mobile UI Spec | Screen inventory, components, tokens, accessibility |
| Mobile Developer Guide | Expo setup, simulators, EAS builds |
| Indexer Design | Event indexing strategy and search API |
| Indexer OpenAPI Spec | REST API schema, authentication, and response definitions |
| Indexer Migrations | Migration rules, reversibility policy, and testing |
| Mini Apps Developer Guide | Build and submit a Linkora mini app |
| Mini Apps Bridge API | Bridge method reference |
| Mini Apps Submission Guide | Submission, security review, publication, and revocation |
| Security Policy | Vulnerability disclosure guidance |
| Security Audit Reference | Threat model, pre-deployment checklist, and incident response runbook |
New to the project? Read docs/INDEX.md first — it is the primary entry point for all developer documentation.
See CONTRIBUTING.md for how to set up your environment, branch conventions, and the PR process.