Skip to content

About

Resources

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Repository files navigation

CryptoDirectory

Minimal static directory for active onchain companies and projects.

Directory email/wallet sign-in, Editor/Reviewer permissions, submissions and required deployment/authority setup: directory roles. Page/workflow coverage and the default-off, Roles-authorized editorial MCP: editorial MCP contract.

Source status (October 29, 2026)

  • Repository: https://github.com/Bittrees-Technology/crypto-directory
  • Default branch: main (protected)
  • Required status check on main: build-and-check
  • Directory source: 1,131 listings across 15 categories, including 13 crypto/Web3 AI Agents.
  • The 500-listing expansion has two publication reviews: the first 100 additions and 400 completion additions. The latter replaces unsuitable research candidates with additional primary-site projects; research alone never approves a listing.
  • Source proposals reach both public addresses only after the protected release is approved, deployed and synchronized.
  • Security policy: SECURITY.md

Scope (v1)

  • Active companies/projects with live products
  • Global coverage; all copy in English
  • New research batches may extend coverage beyond the initial 1,000-entry target; suggestions remain separate from accepted listings until reviewed.
  • Exclude obvious scams and dead projects
  • Mostly exclude memecoins (exception: cultural/community significance)
  • Multi-tag entries, sorted by lead category
  • AI Agents initially covers crypto and Web3 agents only; see content/categories.md for its scope.

Entry fields

Each project entry is a Markdown file in content/projects/ using front matter:

  • name
  • lead_category
  • tags
  • ecosystem
  • description
  • primary_url
  • product_url
  • founded
  • hq
  • token
  • twitter
  • verification_status

Policy and operations docs:

  • content/curation-policy.md
  • content/monthly-ops.md

Process/spec tracking:

  • content/processes/specs/ holds the written design and plan specs
  • content/processes/projects/ defines tracked projects and weighted requirements
  • content/processes/history/ stores progress snapshots used for timeline projection

Build

npm run build

Build output is static HTML/JSON in site/.

  • Public catalogue and category pages use bounded crawlable pagination; the full data feed and project IDs remain unchanged.
  • site/process-status.html shows project completion vs design/plan specs
  • site/data/process-status.json exposes machine-readable progress and timeline data

Audit report:

node scripts/audit-report.mjs

Direct process status report:

npm run process-status

Submission import:

npm run import-submissions

Submission docs:

  • content/submissions/README.md
  • content/submissions/submission-template.json
  • site/submit.html

Bulk status updates:

cp content/status-updates.example.csv content/status-updates.csv
# edit content/status-updates.csv
npm run update-statuses

Then rebuild:

npm run build

Review queue page:

  • site/review.html (generated by build)
  • site/needs-update.html (generated by build)

Automatic first pass (no manual review required initially):

npm run auto-first-pass
npm run build
npm run audit

Monthly release ritual:

npm run release:monthly -- "optional notes for this release"

Reference checklist: monthly-release-checklist.md. This records audit and process-status evidence, builds and pins a release, appends its CID to releases.md, and prints an offline ENS contenthash packet. It does not sign or submit an ENS transaction. Normal live updates use the approved production IPNS synchronizer described in docs/ipns-publishing.md.

Extending completion logic

  • Add new tracked projects in content/processes/projects/*.json
  • Add more historical snapshots in content/processes/history/*.json to improve timeline projections
  • Extend scripts/lib/process-metrics.mjs with new check types as more scripts and data sources become available

IPFS releases and ENS recovery packets

The deployed ENS name uses the existing IPNS publisher. Keep that IPNS record for normal site releases; publishing a new release does not require a new ENS transaction. These commands prepare recovery information for cryptodirectory.eth on Ethereum mainnet. They do not hold a signer or send transactions, and cannot prepare a direct IPFS replacement for an active IPNS record. Any such migration belongs in the existing TLD/Safe review flow.

Install the declared, locked CID dependency and run the tests:

npm ci --ignore-scripts --no-audit --no-fund
npm run test:ens

multiformats validates CIDs and normalizes them to CIDv1. Contenthash packets follow ERC-1577, including its CIDv1 payload requirement for CIDv0 input. ENS packet generation, gating and tests are self-contained. The pre-existing publish:ipfs uploader still requires the separately installed shared IPFS storage integration; these ENS tools do not import that sibling installation.

For a manual recovery review:

  1. Build (npm run build), publish and verify a pinned release through the existing shared IPFS storage process.
  2. Record the complete CID in a dated entry in releases.md: - YYYY-MM-DD: CID=<cid> | entries=... | notes=....
  3. Inspect an offline packet: npm run ens:contenthash -- <cid>.
  4. Configure ETH_RPC_URL locally and install Foundry's cast for read-only chain checks. Optionally set ENS_RESOLVER_ADDRESS to the expected resolver; a mismatch with the live ENS registry blocks the operation. Keep RPC credentials out of source control and command-line arguments.
  5. Run npm run ens:gate -- --cid <cid> and npm run ens:set-contenthash -- --dry-run --cid <cid>.
  6. Where appropriate, explicitly request an unsigned proposal: npm run ens:set-contenthash -- --prepare --cid <cid>.
  7. Review availability, current ENS authority, the transaction destination and calldata, and simulation in the existing wallet, Safe or TLD approval flow. All owner, membership, controller and Safe threshold requirements still apply there.

The release gate runs before external reads or unsigned transaction preparation. CIDv0 and equivalent CIDv1 entries match by content identity; substring matches or mentions in notes do not satisfy the gate. Read-only checks verify mainnet, the current registry resolver, contenthash support and the current record. An already-current record produces no transaction proposal.

The default is read-only even when an inherited environment sets ENS_SET_CONTENTHASH_EXECUTE. --execute is rejected. No signer key is accepted or forwarded to child processes. RPC secrets stay out of argv, and raw child errors are suppressed because they may contain credentials. The --prepare result is unsigned and grants no authority; it must go through the existing wallet/Safe/TLD approvals.

Snapshot strategy

Keep immutable release CIDs in releases.md for rollback and audit. Preserve old pins. A packet or an entry in that file does not prove network availability or grant permission to change the live ENS record.

Bittrees central tool discovery

The root bittrees.tools.json registers Crypto Directory in the Bittrees central MCP catalog. The catalog's source allowlist includes this repository; its sync script reads the manifest from main at a resolved commit SHA.

The manifest uses bittrees.app-tools.v1, version 1, with project ID crypto-directory and discovery endpoint https://mcp.bittrees.org/mcp. Its reviewed local stdio adapter offers public read-only search, listing lookup, category counts and checked release metadata. See adapter setup and boundaries. The data-artifact URL in its local route is not an HTTP MCP endpoint. The static site build does not read the manifest; existing publishing gates still apply.

Consumers remain responsible for endpoint trust, authentication, project scope and operation permissions. Catalog discovery does not launch code or grant access; gateway registration requires its exact route and setup to be separately reviewed and allowlisted.

About

Resources

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages