chainforge
Security-first blockchain architect profile for smart contracts, protocol design, tokenomics, audit readiness, Solana and EVM reviews, governance, and launch controls.
repocodegraphtheory/chainforgedocshttps://graphtheory.xyz/chainforge/statusoriginal GraphTheory workaudiencedevelopers and maintainersoverview
Security-first blockchain architect profile for smart contracts, protocol design, tokenomics, audit readiness, Solana and EVM reviews, governance, and launch controls.
threat model firstDefine assets, adversaries, trust boundaries, governance powers, oracle assumptions, and economic incentives.contract reviewReview Solidity, Foundry, Hardhat, OpenZeppelin, Solady, Solana Anchor, Move, or CosmWasm context when supplied.tokenomics reviewCheck emissions, vesting, governance capture, liquidity risks, sustainability, and asymmetric extraction.audit readinessProduce test, fuzz, invariant, deployment, verification, monitoring, and incident-response checklists.quickstart
Use these commands first. They are intentionally copyable and match the public repository workflow.
install or run
hermes profile install github.com/codegraphtheory/chainforge --aliaschainforge chatlocal developer setup
git clone https://github.com/codegraphtheory/chainforge.gitcd chainforgepython3 scripts/validate_profile.py .hermes profile install . --name chainforge-local --yeshermes -p chainforge-local chatdeveloper workflows
The project is useful when the workflow is explicit. These are the paths to test before treating the project as production-ready.
threat model firstDefine assets, adversaries, trust boundaries, governance powers, oracle assumptions, and economic incentives.contract reviewReview Solidity, Foundry, Hardhat, OpenZeppelin, Solady, Solana Anchor, Move, or CosmWasm context when supplied.tokenomics reviewCheck emissions, vesting, governance capture, liquidity risks, sustainability, and asymmetric extraction.audit readinessProduce test, fuzz, invariant, deployment, verification, monitoring, and incident-response checklists.repo map
Start with these files when debugging, extending, or reviewing the project.
SOUL.mdSecurity-first identity, refusal rules, EVM standards, Octra support, and engineering posture.skills/chainforge-blockchain-engineering/SKILL.mdReusable blockchain engineering workflow.skills/octra-support/SKILL.mdOctra wallet and client support procedures.skills/profile-craft/SKILL.mdProfile generation workflow for related agents.scripts/validate_profile.pyDistribution validation script.templates/profile.params.yamlParams for generating related profile distributions.validation
Do not trust the docs. Run the checks and inspect the output.
python3 scripts/validate_profile.py .hermes profile install . --name chainforge-local --yes --forcehermes -p chainforge-local chat -q "Reply OK if ChainForge is installed."configuration
Configuration surface and credential expectations.
OPENROUTER_API_KEYOptional model provider key.GITHUB_TOKENOptional for GitHub-heavy smart contract repositories. Prefer gh auth.Never commit .env files, OAuth tokens, API keys, cookies, private documents, or Hermes runtime state.
troubleshooting
Common failure modes and where to look first.
review lacks repo contextProvide contract paths, deployment target, compiler version, test framework, and protocol threat model.tokenomics request is unsafeChainForge refuses rug-pull mechanics, hidden controls, fake audit claims, and deceptive launches.Octra details are staleVerify official Octra repos and project files before relying on network-specific assumptions.contribute
Open a focused issue or pull request with commands run, expected behavior, actual behavior, and relevant logs. Keep changes scoped. For GraphTheory public repos, maintainer commits use the GraphTheory identity and avoid private personal data.