BaseCred — Onchain Reputation Queries

Prerequisites

1. Package installed in workspace: npm i basecred-sdk
2. API keys in workspace .env:

   TALENT_PROTOCOL_API_KEY=<key>
   NEYNAR_API_KEY=<key>          # optional — enables Farcaster scoring
   

   Ethos Network requires no key.

Quick workflow

1. Run the query script from the workspace:

   node /path/to/skills/basecred/scripts/query.mjs <0x-address>
   

   The script auto-locates node_modules/basecred-sdk and .env by walking up from cwd. Run it with cwd set to the workspace.

2. Parse the JSON output and present results to the user. Use the level tables in references/output-schema.md to translate raw scores into human-readable levels.

Presenting results

Summarize the three facets clearly:

• Ethos — score + credibility level + review sentiment + vouches. Flag hasNegativeReviews if true.
• Talent Protocol — builder score/level + creator score/level. Note verified status.
• Farcaster — quality score (0–1) and whether it passes threshold.
• Recency — recent / stale / dormant. Mention if stale or dormant as a caveat.

Highlight actionable signals: e.g. zero vouches on Ethos is an easy win, or a dormant Talent score that needs activity.

Reference

• Output schema + all level tables: references/output-schema.md — read when you need to map scores → levels or explain the shape of a response.