Build

Open-source, permissionless, and forever on-chain—tap into portable identity, reputation, and economic advertising without reinventing the wheel.

---

⚠️ The api's listed are not currently available. Developer access will be enabled soon.

1. Why build on the social protocol?

Reason	What It Unlocks
Immutable Access	The program will be immutable after audit; no surprise API shutdowns or paywalls.
Plug-in Moderation	Protocol is censorship-free; each app chooses its own moderation layer.
Instant Network Effects	Re-use existing profiles, social scores, brands, and ad-groups from day one.
Economic Primitives	Monetise with built-in tipping, auction ads, and brand fees.

---

2. TL;DR for New Builders

# 1. Request an API key (optional convenience)
curl -X POST https://dev.social.sol/api/v1/keys -d '{"email":"[email protected]"}'

# 2. Pull the Anchor IDL
git clone https://github.com/social-protocol/social-program.git
cd social-program/idl && ls social.json

# 3. Fetch a wallet profile via RPC (no key required)
solana account $(solana address) --output json

Everything is public on-chain; API endpoints just save you RPC parsing time.

---

3. Program Overview

Item	Value
Program ID	2FgbLNxeikF8ThoV8itmjqLGBU3AJUw77T7AyW8REiBf (devnet)
Solana Version	2.1.0 (Agave)
Anchor	0.31.1
Instructions	36
Event Types	67

Prod cluster will receive a new Program ID after audit & freeze.

---

4. Core PDAs

PDA	Seeds	Purpose
Profile	profile: + user	Identity, verification, ad prefs, tips
Score	score: + user	Reputation balance (up-vs-down)
Timeline	timeline: + user	Post counters & penalty levels
Brand	brand: + brandId	Company data & activity timers
Advertiser	advertiser: + wallet	Spend history & penalty flags
Group	group: + groupId	Ad-auction config & state

Full account layouts live in the IDL and repo docs.

---

5. Key Instructions (Anchor)

initializeUser        // profile + timeline + score
createPost            // on-chain post with anti-spam fee
createVote            // up/down vote another user
initializeAdvertiser  // create advertiser profile
initializeAuction     // crankable; starts group auction
createBid             // place bid (lamports escrow)
finalizeAuction       // crankable; selects winner
claimPayout           // user claims SOL from ad view

See /programs/social/instructions/*.rs for full list.

---

6. REST Convenience API

GET /v1/wallets/{pubkey}/profile   // economic JSON
GET /v1/wallets/{pubkey}/score     // socials score
GET /v1/brands/{id}                // brand meta
GET /v1/groups                     // live ad groups
GET /v1/auctions/{groupId}         // auction state

Free tier: 60 req/min; higher tiers on request. Everything is mirrored from RPC every ~15 s.