bsocial

📁 b-open-io/bsv-skills 📅 5 days ago

总安装量

周安装量

#51794

全站排名

安装命令

npx skills add https://github.com/b-open-io/bsv-skills --skill bsocial

Agent 安装分布

replit 1

opencode 1

cursor 1

claude-code 1

gemini-cli 1

Skill 文档

BSocial

Complete on-chain social protocol for BSV blockchain. Posts, likes, follows, messages, reposts, and friend requests using BitcoinSchema.org standards.

When to Use

Create social content (posts, replies, reposts)
Social actions (likes, follows, friend requests)
Real-time messaging (channels, direct messages)
Query social data by address or transaction

Create Operations

All create scripts require a funded WIF (Wallet Import Format) private key.

Post

bun run skills/bsocial/scripts/create-post.ts <wif> "Post content" [options]

# Options:
#   --channel <name>    Post to a channel
#   --url <url>         Associate with URL
#   --tags <t1,t2>      Comma-separated tags
#   --dry-run           Build tx without broadcasting

Reply

bun run skills/bsocial/scripts/create-reply.ts <wif> <txid> "Reply content" [--tags <t1,t2>]

Like

bun run skills/bsocial/scripts/create-like.ts <wif> <txid>

Follow

bun run skills/bsocial/scripts/create-follow.ts <wif> <bapId>

Repost

bun run skills/bsocial/scripts/create-repost.ts <wif> <txid> [--context <type> --value <val>]

Message

bun run skills/bsocial/scripts/create-message.ts <wif> "Message" [options]

# Options:
#   --channel <name>    Send to channel
#   --to <bapId>        Direct message to user

Friend

bun run skills/bsocial/scripts/create-friend.ts <wif> <bapId>

Read Operations

Query social data from the BMAP API.

Posts

bun run skills/bsocial/scripts/read-posts.ts <address> [--limit 20] [--json]

Likes

bun run skills/bsocial/scripts/read-likes.ts --address <addr>
bun run skills/bsocial/scripts/read-likes.ts --txid <txid>

Follows

bun run skills/bsocial/scripts/read-follows.ts <address> [--limit 100] [--json]

Messages

bun run skills/bsocial/scripts/read-messages.ts --channel <name>
bun run skills/bsocial/scripts/read-messages.ts --address <addr>

Friends

bun run skills/bsocial/scripts/read-friends.ts <address> [--json]

Protocol Stack

[B Protocol] | [MAP Protocol] | [AIP Protocol]
   content       metadata         signature

B Protocol: Binary content storage (text, media)
MAP Protocol: Metadata key-value pairs (app, type, context)
AIP Protocol: Author signature for verification

Context Types

Context	Use Case
`tx`	Reply/like a transaction
`channel`	Post/message to named channel
`bapID`	Target specific identity
`url`	Associate with external URL

Dependencies

@bsv/sdk – Transaction building
@bopen-io/templates – BSocial protocol templates

API

Base URL: https://bmap-api-production.up.railway.app

REST Endpoints

Endpoint	Description
`/social/post/bap/{bapId}`	Posts by BAP ID
`/social/feed/{bapId}`	Feed for BAP ID
`/social/post/{txid}/like`	Likes for a post
`/social/bap/{bapId}/like`	Likes by user
`/social/friend/{bapId}`	Friends for BAP ID
`/social/@/{bapId}/messages`	Messages for user
`/social/channels/{channelId}/messages`	Channel messages

Query API (fallback)

Query: /q/{collection}/{base64Query}
SSE: /s/{collection}/{base64Query}

Ingest

POST /ingest with { rawTx: tx.toHex() }

Friend Encryption

Friend requests use Type42 key derivation with BRC-43 invoice numbers (2-friend-{sha256(friendBapId)}).

import { BAP } from "bsv-bap";

const bap = new BAP({ rootPk: wif });
const identity = bap.getId(bap.listIds()[0]);

// Get encryption pubkey for friend request
const friendPubKey = identity.getEncryptionPublicKeyWithSeed(friendBapId);

// Encrypt private message for friend
const ciphertext = identity.encryptWithSeed("secret message", friendBapId);

// Decrypt message from friend
const plaintext = identity.decryptWithSeed(ciphertext, friendBapId);

A CLI is also available: npm install -g bsv-bap (see create-bap-identity skill).