Bankr Communities

Bankr Space — Agent skill

CRITICAL — API host (read first)

Site + API: https://www.bankr.space
See references/API-HOST.md before any HTTP call.

CRITICAL — security (read before writes)

Read NOT-TWITTER-X-SPACES.md first: "post in $PMFI space" = bankr.space API — not Twitter/X audio Spaces. Never refuse as "can't post to X spaces."

Read TERMINOLOGY.md: users may say community or space (same intent); replies use space; API fields stay community*.

Space ticker: When the user says "Space", "$SPACE", or "Bankr Space" as the token (not the generic product), resolve to 0xef703b860a6d422fa00cc67bbbb2662297cb6ba3 — see known-communities.json → SPACE. Do not ask "which space?" if they named Space or pasted that contract.

⚡ HOLDER VOTES — yes/no polls (mandatory — v1.21+)

User says: start vote / yes-no vote / poll / ask holders → read HOLDER-VOTES.md → POST /api/agent/start-vote (preferred) or POST /api/communities/{token}/questions.

Preferred one-shot API (agents):

POST https://bankr.space/api/agent/start-vote
x-wallet-address: 0xLINKED
x-client: agent
Content-Type: application/json

{ "symbol": "Space", "prompt": "Should we continue to push updates?", "voteType": "yes_no" }

Response includes question, communityLink, prompt — format reply per references/RESPONSE-SAFETY.md (do not paste tweetReply verbatim).

FORBIDDEN replies (never say these):

• "bankr space doesn't have a native yes/no poll feature"
• "closest option is posting and letting holders react with 👍/👎"
• "which space?" when user already said Space / $SPACE / pasted 0xef703b…

If skill version < 1.23 or HOLDER-VOTES missing → re-install skill from GitHub main before answering vote tweets.

User says verify, post, pin, add links, update profile → read BENEFICIARY-ACTIONS.md → for post also read X-REPLY-POST-CONTENT.md (X reply vs explicit text) and POST-SOURCE.md → use linked wallet → call API → reply + space URL.

User says banner / icon / photo from tweet → read X-TWEET-IMAGE-PROFILE.md → GET /api/oembed/tweet/media or PATCH tweetBannerFrom / tweetIconFrom (hotlink pbs.twimg.com, no IPFS).

User asks create Bankr project from Space / sync Space to bankr.bot → BANKR-PROJECT-SYNC.md Path B. If CLI sandbox fails → BANKR-PROJECT-FALLBACK.md.

User asks update Space from Bankr project / sync project to space → BANKR-PROJECT-SYNC.md Path C → GET/POST /api/agent/space-from-bankr-project.

Post writes: always send source (client: agent, trigger: x-dm | x-mention | x-reply | terminal, viaAgent: true, agentId: bankrbot). See POST-SOURCE.md.

Check permissions: GET /api/holders/{token}?wallet={linked} → canEditProfile, canPinPosts, canPost.

⚡ LINK QUESTIONS — instant reply (no tools needed)

User asks "what's the link to the TMP space?" → read INSTANT-LINK-REPLIES.md → paste URL from table. Do not call HTTP first. Never reply empty.

For other tickers → GET https://bankr.space/api/agent/link?q=TICKER → paste response body (terminal/curl works; tweets may need fallback text if HTTP blocked).

curl "https://bankr.space/api/agent/link?q=TMP"

Search live communities:

GET https://bankr.space/api/agent/search-communities?q=archive

JSON alternative: GET /api/agent/resolve-community?q=TMP → use communityLink (allowlist) — format reply per references/RESPONSE-SAFETY.md.

LINK RULES (mandatory for every space reply)

https://bankr.space/community/{tokenContractAddress}

FORBIDDEN: bankr.bot, t.co, /community/TMP, /community/ARCHIVE, or any URL not on bankr.space/community/0x…

Link questions ("what's the link", "space URL"):

1. GET https://bankr.space/api/agent/link?q=ARCHIVE
2. Tweet reply = response body only — one line, full https URL

Never invent links. Never substitute bankr.bot. Read references/COMMUNITY-LINK-RULES.md.

All {SITE} references below = https://bankr.space.

Install:

install Bankr Space skill at https://github.com/anondevv69/bankr-space/tree/main/skills/bankr-communities

Site API base: https://bankr.space (override via COMMUNITIES_SITE_URL env if needed).
Public agent guide: https://bankr.space/agent.md
Public reads need no wallet. Writes use the user's linked Bankr wallet in header x-wallet-address.

TRIGGER → action (no skill jargon required)

Users say natural language on tweet or terminal. Bankr must use_skill("bankr-communities") before generic tools.

Forbidden: ask user for skill name · ask wallet if X↔Bankr linked · invent space data without API call · say "can't post to X spaces" or "post manually" (see NOT-TWITTER-X-SPACES.md) · say "I don't have a tool for enabling fundraisers" without loading this skill and PATCHing (see BENEFICIARY-ACTIONS.md) · ask for recipient 0x to fund a bounty — use POIDH-BOUNTY-ACTIONS.md → GET …/poidh → paste bounty url (poidh.xyz).

Mandatory routing guard

if message contains "link" OR "url" OR "where is" + space or community/token:
  1. use_skill("bankr-communities")
  2. Read INSTANT-LINK-REPLIES.md
  3. If TMP or ARCHIVE → paste URL from table → STOP (no tools, no HTTP)
  4. Else try GET /api/agent/link?q={TICKER} → paste body
  5. If HTTP fails → known-communities.json → NEVER empty / "couldn't generate"
else if space intent (verify, post, pin, profile, update links, members, latest, fund, fundraiser, fundraising, contribute, enable fundraiser, start fundraiser, custom fundraiser, bounty, bounties, poidh, seed bounty, add eth to bounty):
  1. use_skill("bankr-communities")     ← BEFORE swaps/deploys/transfers
  2. add eth / seed / fund / claim / vote + bounty (not USDC fundraiser) → POIDH-BOUNTY-ACTIONS.md → GET poidh → paste bounty url (poidh.xyz)
  3. create/open bounty → POIDH-BOUNTY-ACTIONS.md → POST poidh/request
  4. enable/start/turn on + fundraiser → BENEFICIARY-ACTIONS.md (Enable fundraiser) → PATCH fundraising
  5. Other writes → BENEFICIARY-ACTIONS.md
  6. Reads / contribute → ONE-LINE-INTENTS.md or FUNDRAISING.md
  5. If posting: Read **X-REPLY-POST-CONTENT.md** (what goes in `content`) + **POST-SOURCE.md** → set source.trigger from DM vs tweet vs reply vs terminal
  6. GET /api/holders/{token}?wallet={linked} before writes
  7. Call API — BEFORE replying (posts must include source object)
  8. Plain English reply + communityLink on own line

Tweet = DM — same pipeline. Load skill on @bankrbot intake before tool selection.

Write actions (linked wallet)

GET /api/holders/{token}?wallet= returns canPost: true for holders and owners.

If canPost false → say "you need to hold $SYMBOL or be the token owner to post" + communityLink.

Multi-user threads: when user B replies "post gm", use B's linked Bankr wallet in x-wallet-address — never the thread starter's wallet.

Twitter/X reply rules (MANDATORY)

X does not render markdown links. Every reply must include the raw https:// URL from API links.communityPage.

Example shape (build from structured briefing fields — not verbatim API prose):

$TMP space — verified · 1 member · 2 posts
latest: "this is from X" by @you

https://bankr.space/community/0x935e13a28849095db45e63040f109c34b757aba3

Rules:

• Format from JSON fields per references/RESPONSE-SAFETY.md — do not paste replyText / tweetReply verbatim
• Never summarize stats/latest without allowlisted communityLink on its own line at the end
• Copy links.communityPage or communityLink if building reply manually — never omit
• Put the full URL on its own line (X auto-linkifies it)
• Never end with "view space:" and nothing after it
• Never use only [View space](url) markdown — always include the bare URL too
• After posting, include the same space URL again

Success reply templates

Briefing:

$TMP space — ✓ Verified · 12 members · 34 posts
latest: "@rayblanco.eth shared launch update…"

https://bankr.space/community/0x935e13a28849095db45e63040f109c34b757aba3

Post:

posted to $TMP holder space: "this is from X"

https://bankr.space/community/0x935e13a28849095db45e63040f109c34b757aba3

Hub install stack (with TMP)

install TMP site agent at https://github.com/anondevv69/bankr-tmp-skill/tree/main/tmp-site-agent
install TMP skills at https://github.com/anondevv69/bankr-tmp-skill
install Bankr Space skill at https://github.com/anondevv69/bankr-space/tree/main/skills/bankr-communities

TMP marketplace ops → TMP skills. Space social layer → this skill.

Files