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 jsonEverything 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 viewSee /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 stateFree tier: 60 req/min; higher tiers on request. Everything is mirrored from RPC every ~15 s.
Last updated