Coin Community SDK

@coin-communities/sdk is a typed TypeScript client for the Coin Communities API. The HTTP client is generated directly from the OpenAPI schema, so types always stay in lockstep with the server.

What it covers

  • Communities — fetch a community by token address; read, post, like, reply to, and report messages; upload media; list members; subscribe to realtime events via WebSocket.
  • Feed — browse the cross-community activity feed (authenticated or public).
  • Users — Twitter OAuth sign-in, profile management, wallet linking (EVM + Solana), and in-platform follow graph.

Runtime targets

The package ships three runtime entries plus an optional React Query layer. Your bundler/runtime resolves the right entry automatically via conditional exports.

RuntimeConditional entryExplicit import
Browser (React)browser@coin-communities/sdk/react
React Nativereact-native@coin-communities/sdk/react-native
Node.jsnode / default@coin-communities/sdk/node

For React apps, @coin-communities/sdk/react-query ships pre-baked useQuery / useMutation hooks, optimistic-post reconciliation, and a stable queryKeys factory — see the React Query page.

Authentication

Two schemes are in use:

  • API key (x-api-key header) — required for all community, user, and feed operations, including the */public read endpoints. Keys are provisioned by the Coin Communities team — contact support to request one.
  • Bearer JWT — required for user-scoped writes. Obtained by completing the Twitter OAuth flow.

Only GET /health and GET /ping are open — every other endpoint needs an API key.

Next steps