3. Workspace(?)

개념 정리 — 왜 4 단계로 나누는가

한 회사가 여러 client 의 자산을 보관할 때, 모든 자산을 한 통에 섞으면 누가 무엇을 가지고 있는지 추적 불가능. 그래서 다음처럼 계층을 나눈다:

1. Workspace — 최상위 격리 공간

Fireblocks 직접 인용: "Every workspace requires one (and only one) Owner to set up the Vault."

→ 의미: Vault 를 운영하려면 workspace 에 정확히 1 명의 Owner 가 존재해야 한다는 필요조건. Owner 만 vault setup 작업을 할 수 있다는 뜻이 아님 — 실제 vault account 생성은 Owner / Admin / NSA / Signer / Approver / Editor 모두 가능 (권한표 "Assets and addresses" 절).

1.1 핵심 규칙

• 1 workspace = 1 Owner 강제 (DB UNIQUE constraint)
• workspace type 2 종: hot / cold (아래 표 참조)
• workspace-level 거버넌스 작업 (Policy 변경 · Admin Quorum 변경 · AML 설정 · Freeze 등) 은 모두 다수결 승인 흐름 (Q / Q+O)

1.2 Workspace type 2 종 — 무엇을 의미하는가

1.3 workspaces 테이블

CREATE TABLE workspaces (
  id              BINARY(16) PRIMARY KEY,
  type            ENUM('hot', 'cold') NOT NULL,
  owner_user_id   BINARY(16) NOT NULL UNIQUE,
  name            VARCHAR(128) NOT NULL,
  aml_default     ENUM('fail-on-unknown', 'pass-on-unknown') NOT NULL,
  created_by      BINARY(16) NOT NULL,
  created_at      DATETIME(6) NOT NULL,
  modified_by     BINARY(16) NOT NULL,
  modified_at     DATETIME(6) NOT NULL,
  frozen_at       DATETIME(6),
  frozen_by       BINARY(16),
  KEY (frozen_at)
);

1.4 필드별 설명

1.5 workspace_change_events — 모든 변경의 append-only 이력

workspace 의 모든 field 변경마다 1 row 추가. UPDATE / DELETE 금지 (audit-grade evidence).

CREATE TABLE workspace_change_events (
  id                BINARY(16) PRIMARY KEY,
  workspace_id      BINARY(16) NOT NULL,
  event_type        ENUM('created', 'renamed', 'type-changed', 'owner-transferred', 'aml-default-changed') NOT NULL,
  field_name        VARCHAR(64) NOT NULL,
  old_value         JSON,
  new_value         JSON,
  actor_user_id     BINARY(16) NOT NULL,
  approval_request_id BINARY(16),
  audit_event_id    BINARY(16),
  occurred_at       DATETIME(6) NOT NULL,
  KEY (workspace_id, occurred_at),
  KEY (event_type)
);

1.6 workspace_freeze_events — Freeze 이력 테이블

CREATE TABLE workspace_freeze_events (
  id              BINARY(16) PRIMARY KEY,
  workspace_id    BINARY(16) NOT NULL,
  event_type      ENUM('freeze', 'unfreeze') NOT NULL,
  actor_user_id   BINARY(16) NOT NULL,
  support_ticket_id VARCHAR(64),
  occurred_at     DATETIME(6) NOT NULL
);

이 테이블은 append-only (UPDATE / DELETE 금지) — freeze 이력은 audit evidence 라서 영구 보존.

1.7 왜 change_events 와 freeze_events 를 분리하는가

두 테이블을 합쳐서 하나로 만들 수도 있다 — `event_type` ENUM 에 'freeze' / 'unfreeze' 만 추가하면 가능. 그럼에도 본 reference 는 분리 유지를 권장하는 이유:

1.8 Workspace Freeze 모델 — 풀어 쓰기

참고글

• Fireblocks — User roles · workspace 의 9 role 권한표
• Fireblocks — Freeze your workspace · 비상 freeze 흐름 + Unfreeze 절차
• 4. Vault · workspace 안의 자산 보관 단위 (vault account)
• 2. DB 분할 · workspaces 가 walletdb 에 속하는 이유
• 9. Admin Quorum · Approval Group · workspace-level 거버넌스 (Q / Q+O / AG)
• 20. Audit Log · workspace_change_events / freeze_events 의 cross-DB hash chain 영속화
• 24. Storage Discipline · append-only / set-once 규율