Following up on my previous posts about Midnight Agent Skills ( GitHub - mzf11125/midnight_agent_skills: 4 modular agent skills for building on Midnight Network's zero-knowledge blockchain · GitHub ), I’ve just shipped v2.0.3 with the biggest content update yet.
The core idea hasn’t changed: give AI coding assistants accurate, up-to-date knowledge of Compact so they stop hallucinating syntax. What’s new is the source material.
What’s in v2.0.3
I went through all 27 articles published by the Midnight Aliit Fellowship on dev.to and distilled them into the skill reference files. These are builders documenting real production failures, not documentation writers explaining happy paths.
Mental model corrections
Circuits declare constraints, they don’t execute. assert is a constraint declaration. If the condition is false, the proof can’t be generated. disclose() is a compile-time annotation, not encryption. The compiler tracks witness data through arithmetic and rejects undeclared disclosures.
On-chain design patterns from production
Tushar Pamnani hit Midnight’s block limits twice building a prediction market. The v3 architecture he landed on (flat maps instead of struct maps, off-chain computation with Merkle root verification, minimal on-chain state) is now in the midnight-compact skill as a reference pattern.
SDK compatibility and silent failures
Fred Santana documented 16 hours of debugging silent failures across 5 incidents. The midnight-api skill now includes the full compatibility matrix and the known WalletFacade.init() hang on standalone nodes. facade 2.x + standalone = wallet stuck in syncing forever, no error.
Wallet integration
Tushar’s midnight-wallet-kit patterns are now in the API skill: the 4 React hooks, typed errors, SSR safety, and MockWalletAdapter for CI testing without a browser extension.
Preprod troubleshooting
Gutopro’s week-in-the-trenches post is now a reference table: 6 common issues with fixes, including the faucet “Invalid Address” trap (set network to preprod before copying your address) and the Lace sync issue that breaks contract interactions mid-session.
Also shipped
- GitHub Actions CI: JSON validation, Python linting, skill structure checks
- PR to the official midnight-docs repo adding agent skills to the AI tools section: Add Midnight Agent Skills to AI tools documentation by mzf11125 · Pull Request #873 · midnightntwrk/midnight-docs · GitHub
- Published article on dev.to under the Midnight Aliit org: Vibe Code Your First Midnight dApp with AI Agent Skills - DEV Community
Install
npx skills add GitHub - mzf11125/midnight_agent_skills: 4 modular agent skills for building on Midnight Network's zero-knowledge blockchain · GitHub
Release notes: Release v2.0.3 - Full Midnight Aliit community knowledge base · mzf11125/midnight_agent_skills · GitHub
If you’ve hit a pattern that’s missing, PRs are open.