Skip to main content
For the complete documentation index, see llms.txt

Midnight agent skills

Claude, GitHub Copilot, Cursor 같은 AI 코딩 어시스턴트는 학습 데이터에 Compact을 포함하고 있지 않습니다. Compact 컨트랙트 작성을 요청하면 그럴듯해 보이지만 컴파일되지 않는 코드를 생성합니다.

midnight_agent_skills은 이 문제를 해결합니다. 한 번 설치하면 AI 어시스턴트가 Compact 문법, Midnight SDK, 네트워크 설정, 그리고 개발자 커뮤니티에서 수집한 흔한 함정에 대한 정확한 지식을 갖게 됩니다.

Install​

전체 스킬을 한 번에 설치합니다.

npx skills add https://github.com/mzf11125/midnight_agent_skills

개별 스킬만 설치할 수도 있습니다.

npx skills add https://github.com/mzf11125/midnight_agent_skills --skill midnight-compact
npx skills add https://github.com/mzf11125/midnight_agent_skills --skill midnight-api

Available skills​

다음 4개 스킬은 개별적으로 또는 한 번에 설치할 수 있습니다. 각 스킬은 Midnight 개발의 특정 영역을 다룹니다.

midnight-concepts​

Midnight의 zero-knowledge 아키텍처에 대한 기초 지식입니다. Kachina 프로토콜, DUST/NIGHT 토크노믹스, 이중 상태 모델(public ledger 대 private state), ZK proof의 기본 원리를 다룹니다.

midnight-compact​

Compact 언어(v0.22+) 전반에 대한 가이드입니다.

  • Circuit 문법과 제약 모델
  • Ledger 연산: Counter, Map, Set, MerkleTree
  • disclose() 메커니즘과 witness 보호
  • 자주 틀리는 문법(.value()가 아닌 .read(), ::가 아닌 .로 enum 접근, witness 함수에는 본문이 없다는 점)
  • 실전 환경에서 검증된 온체인 설계 패턴

midnight-api​

DApp 개발을 위한 SDK 통합입니다.

  • midnight-wallet-kit을 통한 지갑 연결(Lace, 1AM)
  • 컨트랙트 배포와 상호작용
  • SDK 호환성 매트릭스와 알려진 silent failure
  • Preprod 네트워크 설정과 트러블슈팅

midnight-network​

네트워크 인프라입니다.

  • Docker 기반 Proof server 구성
  • Indexer 설정
  • Node 배포

What skills cover​

스킬은 공식 Midnight 문서와 Midnight Aliit Fellowship의 커뮤니티 글을 바탕으로 만들어졌습니다. 다음 내용을 포함합니다.

EVM 출신 개발자를 위한 멘탈 모델 교정​

  • Circuit은 제약을 선언하지, 실행하지 않습니다. assert는 런타임 가드가 아니라 제약 선언입니다.
  • disclose()는 암호화가 아니라 컴파일 타임 어노테이션입니다. 컴파일러가 산술 연산을 통해 witness 데이터를 추적해 선언되지 않은 disclosure를 거부합니다.
  • 블록 한도는 가스 비용이 아니라 하드 리미트입니다. BlockLimitExceeded가 발생하면 트랜잭션은 아예 실행될 수 없습니다.

온체인 설계 패턴​

  • Struct map 대신 flat map 사용 (struct 읽기는 모든 필드를 circuit에 끌어옵니다)
  • Merkle root 검증 기반의 오프체인 연산
  • 최소한의 온체인 상태

자주 틀리는 문법​

다음 예시는 자주 잘못 쓰이는 문법과 올바른 형태를 보여줍니다.

// WRONG
const val = counter.value();
if (state == GameState::playing) { ... }
witness get_key(): Bytes<32> { return local_key(); }

// CORRECT
const val = counter.read();
if (state == GameState.playing) { ... }
witness local_key(): Bytes<32>;

Relationship to Midnight MCP​

midnight_agent_skills과 Midnight MCP은 같은 문제를 다른 각도에서 해결합니다.

Midnight MCP은 AI 어시스턴트에 102개 Midnight 저장소에 대한 실시간 접근과 실제 컴파일러 검증을 제공합니다. MCP 호환 도구(Claude Desktop, Cursor 등)가 필요합니다.

midnight_agent_skills은 모든 agent skills 호환 도구에서 동작하며, 공식 문서에 없는 커뮤니티 출처의 함정과 실전 패턴을 포함한 구조화된 참조 지식을 제공합니다.

두 도구는 함께 사용할 수도 있습니다.

Source​