이제 설치할 수 있습니다

npm install cronozen

Cronozen Proof SDK가 npm 레지스트리에 공개되었습니다. 누구나 설치하고, 즉시 사용할 수 있습니다.

패키지 스펙

항목 값
패키지명 cronozen
크기 11.2KB
의존성 Zero — 외부 패키지 없음
모듈 형식 CJS + ESM + TypeScript 타입 선언
런타임 Node.js, Deno, Bun, Edge Runtime
라이선스 MIT

외부 의존성이 없다는 건, node_modules에 추가되는 게 cronozen 하나뿐이라는 뜻입니다. 번들 사이즈 걱정 없이 프로덕션에 넣을 수 있습니다.

30초 만에 시작하기

import { Cronozen } from "cronozen"

const cz = new Cronozen({
  apiKey: process.env.CZ_KEY!,
  baseUrl: "https://cronozen.com/api/v1",
})

// AI 에이전트가 결정을 내릴 때
const event = await cz.decision.record({
  type: "agent_execution",
  actor: { id: "billing_agent", type: "ai_agent" },
  action: {
    type: "invoice_approved",
    input: { invoiceId: "INV-001", amount: 280000 },
  },
  aiContext: { model: "gpt-4", confidence: 0.91 },
})

// 사람이 승인하면 SHA-256으로 봉인
const approval = await cz.decision.approve(event.id, {
  approver: { id: "finance_lead", type: "human" },
  result: "approved",
  reason: "계약 조건 확인 완료",
})

console.log(approval.sealedHash)
// → "sha256:9943798c6313e9dd2cffa71..."

세 단계입니다: 기록 → 승인 → 봉인. 봉인된 이벤트는 해시 체인에 연결되어 변조 불가능합니다.

왜 "SDK-first"인가

대부분의 컴플라이언스 도구는 대시보드에서 시작합니다. 설정 화면, 체크리스트, 매뉴얼.

Cronozen Proof는 코드에서 시작합니다.

npm install → import → cz.decision.record()

대시보드가 아니라 package.json에 추가하는 것이 첫 단계입니다. 개발자가 워크플로우 코드에 직접 통합하기 때문에:

  • 증빙이 "나중에 추가하는 것"이 아니라 비즈니스 로직의 일부가 됩니다
  • CI/CD 파이프라인에서 테스트할 수 있습니다
  • 환경변수 하나로 on/off 전환이 가능합니다

에러 핸들링도 타입 안전

import { ConflictError, NotFoundError, ValidationError } from "cronozen"

try {
  await cz.decision.approve(eventId, payload)
} catch (e) {
  if (e instanceof ConflictError) {
    // 이미 봉인됨 — 정상 (재시도 시 발생)
  }
  if (e instanceof ValidationError) {
    // 필수 필드 누락
    console.error(e.details)
  }
}

9개 에러 클래스가 모든 실패 시나리오를 커버합니다. catch (e: any)로 퉁치지 않아도 됩니다.

프로덕션에서 안전하게

fireProof() 패턴으로 증빙 실패가 비즈니스 로직을 방해하지 않습니다:

fireProof(cz, (cz) =>
  cz.decision.record({
    type: "automated_action",
    actor: { id: "cron_job", type: "system" },
    action: { type: "daily_settlement", input: { date: "2026-03-13" } },
    idempotencyKey: "daily-settle-2026-03-13",
  }),
  "daily-settlement",
)
  • idempotencyKey로 중복 방지
  • 실패해도 정산 흐름은 계속 진행
  • API 키 없으면 자동 비활성화

문서

다음 단계

SDK는 시작입니다. 앞으로:

  • Proof Admin Console — 의사결정 타임라인 시각화
  • Webhook 알림 — 특정 이벤트 유형 실시간 알림
  • Python SDK — pip install cronozen

지금 바로 시작하세요:

npm install cronozen

AI가 결정을 내리는 시대. 증명은 인프라입니다.