dibd-led-protocol 1.2.0__tar.gz

dibd_led_protocol-1.2.0/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may accept support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 DabitSol Co., Ltd.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing permissions
+   and limitations under the License.

dibd_led_protocol-1.2.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+include openrpc.json
+recursive-include dibd *.py *.typed
+exclude *.pyc
+prune __pycache__
+prune *.egg-info

dibd_led_protocol-1.2.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: dibd-led-protocol
+Version: 1.2.0
+Summary: DIBD LED 전광판 JSON-RPC 2.0 envelope client (UDP / TCP / HTTP)
+Author: DabitSol Co., Ltd.
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/DabitSol/dibd-led-protocol
+Project-URL: Repository, https://github.com/DabitSol/dibd-led-protocol
+Project-URL: Documentation, https://github.com/DabitSol/dibd-led-protocol#readme
+Project-URL: Issues, https://github.com/DabitSol/dibd-led-protocol/issues
+Keywords: dibd,led,display,protocol,jsonrpc,openrpc,iot
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# dibd-led-protocol — DIBD LED 전광판 공개 표준 프로토콜
+
+JSON-RPC 2.0 envelope 정합 + Python SDK + OpenRPC 1.3.2 spec + conformance test 본질 정합.
+
+## 본 repo 영역
+
+| 영역 | 위치 |
+|---|---|
+| Python SDK 본문 | `dibd/` (96 method auto-gen, jsonrpc 2.0 envelope, stdlib 한정) |
+| OpenRPC spec | `openrpc.json` (96 method spec, 표준 1.3.2) |
+| 변환 도구 | `../schema_to_openrpc.py` (protocol_schema.json → openrpc.json) |
+| SDK 생성 wrapper | `generate_sdk.py` (openrpc.json → dibd/methods.py) |
+| 빌드 설정 | `pyproject.toml` (setuptools 본문, Python ≥3.10, Apache-2.0) |
+| LICENSE | Apache 2.0 |
+
+## 5분 시작
+
+로컬 설치 (PyPI 부재 영역):
+
+```bash
+cd Controller/tools/python_sdk/
+pip install -e .
+```
+
+사용:
+
+```python
+from dibd import DibdClient
+
+c = DibdClient("192.168.1.211")            # UDP default port 50000
+size = c.invoke("display.size.read")
+c.invoke("display.brightness.write", {"level": 50})
+c.close()
+```
+
+상세 본 본문 = `dibd/README.md`.
+
+## 옛 ASCII frame 호환
+
+`raw_ascii()` path 옛 ASCII frame 본문 직접 송신. 옛 다빛채 호환 영역 그대로.
+
+## SDK 재생성 흐름
+
+protocol_schema.json 갱신 후:
+
+```bash
+# Step 1: openrpc.json 갱신
+python Controller/tools/schema_to_openrpc.py \
+    --schema docs/20_기술_사양/21_DIBD_프로토콜/protocol_schema.json \
+    --out Controller/tools/python_sdk/
+
+# Step 2: methods.py 자동 생성
+python Controller/tools/python_sdk/generate_sdk.py
+```
+
+`methods.py` 본문 직접 편집 금지 — 본 흐름 본문 재호출 의무.
+
+## 외부 vendor 본 path
+
+본 SDK 본 본문 외부 vendor 본 path 본 path는 별 트랙 `0515x-vendor-integration` 본 본문 적재 예정. 현 trunk 본 본 path 본 본 본 본문 path 한정.
+
+GitHub repo `dibd-led-protocol` 공개 본 path는 사용자 GitHub 계정 직접 영역 (gh CLI 또는 web UI).
+
+## SSOT
+
+- 펌웨어 본문: `Controller/shared/app/protocol/envelope_v3_lookup.c` (95 method entry)
+- 프로토콜 spec: `docs/20_기술_사양/21_DIBD_프로토콜/protocol_schema.json` (95+ method, 1.2.0)
+- 마감 결정: `docs/00_AI_가이드/Decisions/0514f_protocol_8_areas_standardization.plan.md`
+- conformance test: `tests/conformance/run_conformance.py` (33/33 PASS)
+
+## 라이선스
+
+Apache License 2.0. © 2026 DabitSol Co., Ltd.

dibd_led_protocol-1.2.0/README.md

@@ -0,0 +1,73 @@
+# dibd-led-protocol — DIBD LED 전광판 공개 표준 프로토콜
+
+JSON-RPC 2.0 envelope 정합 + Python SDK + OpenRPC 1.3.2 spec + conformance test 본질 정합.
+
+## 본 repo 영역
+
+| 영역 | 위치 |
+|---|---|
+| Python SDK 본문 | `dibd/` (96 method auto-gen, jsonrpc 2.0 envelope, stdlib 한정) |
+| OpenRPC spec | `openrpc.json` (96 method spec, 표준 1.3.2) |
+| 변환 도구 | `../schema_to_openrpc.py` (protocol_schema.json → openrpc.json) |
+| SDK 생성 wrapper | `generate_sdk.py` (openrpc.json → dibd/methods.py) |
+| 빌드 설정 | `pyproject.toml` (setuptools 본문, Python ≥3.10, Apache-2.0) |
+| LICENSE | Apache 2.0 |
+
+## 5분 시작
+
+로컬 설치 (PyPI 부재 영역):
+
+```bash
+cd Controller/tools/python_sdk/
+pip install -e .
+```
+
+사용:
+
+```python
+from dibd import DibdClient
+
+c = DibdClient("192.168.1.211")            # UDP default port 50000
+size = c.invoke("display.size.read")
+c.invoke("display.brightness.write", {"level": 50})
+c.close()
+```
+
+상세 본 본문 = `dibd/README.md`.
+
+## 옛 ASCII frame 호환
+
+`raw_ascii()` path 옛 ASCII frame 본문 직접 송신. 옛 다빛채 호환 영역 그대로.
+
+## SDK 재생성 흐름
+
+protocol_schema.json 갱신 후:
+
+```bash
+# Step 1: openrpc.json 갱신
+python Controller/tools/schema_to_openrpc.py \
+    --schema docs/20_기술_사양/21_DIBD_프로토콜/protocol_schema.json \
+    --out Controller/tools/python_sdk/
+
+# Step 2: methods.py 자동 생성
+python Controller/tools/python_sdk/generate_sdk.py
+```
+
+`methods.py` 본문 직접 편집 금지 — 본 흐름 본문 재호출 의무.
+
+## 외부 vendor 본 path
+
+본 SDK 본 본문 외부 vendor 본 path 본 path는 별 트랙 `0515x-vendor-integration` 본 본문 적재 예정. 현 trunk 본 본 path 본 본 본 본문 path 한정.
+
+GitHub repo `dibd-led-protocol` 공개 본 path는 사용자 GitHub 계정 직접 영역 (gh CLI 또는 web UI).
+
+## SSOT
+
+- 펌웨어 본문: `Controller/shared/app/protocol/envelope_v3_lookup.c` (95 method entry)
+- 프로토콜 spec: `docs/20_기술_사양/21_DIBD_프로토콜/protocol_schema.json` (95+ method, 1.2.0)
+- 마감 결정: `docs/00_AI_가이드/Decisions/0514f_protocol_8_areas_standardization.plan.md`
+- conformance test: `tests/conformance/run_conformance.py` (33/33 PASS)
+
+## 라이선스
+
+Apache License 2.0. © 2026 DabitSol Co., Ltd.

dibd_led_protocol-1.2.0/dibd/__init__.py

@@ -0,0 +1,30 @@
+"""dibd — Python SDK for DIBD LED display protocol (0514f Phase 1 호출 3 산출물)
+
+옛 ASCII path 본문 호환:
+    DibdClient.raw_ascii("![00H1!]") → 옛 ASCII frame 본 path 직접 송신.
+
+본 신 path:
+    c = DibdClient("192.168.1.211")
+    c.invoke("display.size.read")
+    c.invoke("display.brightness.write", {"level": 50})
+
+SSOT:
+- protocol_schema.json (95+ method)
+- Decisions/0514f_*.plan.md
+"""
+from __future__ import annotations
+
+from .client import DibdClient
+from .errors import DibdError, ErrorCode
+from .envelope import build_request, parse_response
+from .methods import _MethodCatalog as MethodCatalog
+
+__version__ = "1.2.0"
+__all__ = [
+    "DibdClient",
+    "DibdError",
+    "ErrorCode",
+    "MethodCatalog",
+    "build_request",
+    "parse_response",
+]

dibd_led_protocol-1.2.0/dibd/client.py

@@ -0,0 +1,158 @@
+"""client.py — DibdClient (0514f Phase 1 호출 3 산출물).
+
+채널 본문 3건 — UDP / TCP / HTTP envelope POST. 옛 ASCII path 본문 호환 raw_ascii() 별도.
+
+본문 사용:
+    c = DibdClient("192.168.1.211", channel="udp", port=50000)
+    result = c.invoke("display.size.read")
+    c.invoke("display.brightness.write", {"level": 50})
+    c.close()
+
+본문 자동 method dispatch path 부재 — 본 path 시점에 invoke() 본 path 박힘. dot-path
+본문 직접 method 호출은 추가 path (catalog 본문 회수 후 setattr 본 path 박음)."""
+from __future__ import annotations
+
+import socket
+import urllib.request
+from typing import Any
+
+from .envelope import build_request, parse_response
+from .errors import DibdError
+from .methods import _MethodCatalog
+
+
+class DibdClient:
+    """DIBD 보드 본문 JSON-RPC 2.0 client.
+
+    Args:
+        host: 보드 IP 본문 (예: "192.168.1.211").
+        channel: "udp" / "tcp" / "http" 본문 본 path 선택.
+        port: UDP/TCP port (default 50000), HTTP port (default 80).
+        timeout_s: 응답 대기 timeout (default 2.0).
+        hmac_key: 본문 박힐 시 envelope `_dibd.security.sig` 본 영역 적재 (옵션).
+    """
+
+    DEFAULT_UDP_PORT = 50000
+    DEFAULT_TCP_PORT = 50000
+    DEFAULT_HTTP_PORT = 80
+
+    def __init__(
+        self,
+        host: str,
+        *,
+        channel: str = "udp",
+        port: int | None = None,
+        timeout_s: float = 2.0,
+        hmac_key: bytes | None = None,
+    ) -> None:
+        self.host = host
+        self.channel = channel
+        self.timeout_s = timeout_s
+        self.hmac_key = hmac_key
+        if port is None:
+            defaults = {
+                "udp": self.DEFAULT_UDP_PORT,
+                "tcp": self.DEFAULT_TCP_PORT,
+                "http": self.DEFAULT_HTTP_PORT,
+            }
+            port = defaults.get(channel, self.DEFAULT_UDP_PORT)
+        self.port = port
+        self._sock: socket.socket | None = None
+        self.catalog = _MethodCatalog
+
+    def _ensure_socket(self) -> socket.socket:
+        if self._sock is not None:
+            return self._sock
+        if self.channel == "udp":
+            s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        elif self.channel == "tcp":
+            s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            s.connect((self.host, self.port))
+        else:
+            raise DibdError(-32603, f"channel {self.channel} 본 path socket 부재")
+        s.settimeout(self.timeout_s)
+        self._sock = s
+        return s
+
+    def invoke(
+        self,
+        method: str,
+        params: dict[str, Any] | list[Any] | None = None,
+        *,
+        notification: bool = False,
+    ) -> dict[str, Any] | None:
+        """JSON-RPC 2.0 method 본문 본 path 호출. notification=True 시 None 반환."""
+        if self.catalog.lookup(method) is None:
+            # 본 catalog 부재 method도 호출 허용 (보드 본문 신 method 부재 path).
+            pass
+        req = build_request(method, params, notification=notification)
+        if self.hmac_key is not None:
+            req = self._sign(req)
+        if notification:
+            self._send_only(req)
+            return None
+        raw = self._send_recv(req)
+        body = parse_response(raw)
+        return body.get("result")
+
+    def raw_ascii(self, frame: str | bytes) -> bytes:
+        """옛 ASCII frame 본문 직접 송신 path. 본 path = 옛 호환 영역."""
+        if isinstance(frame, str):
+            frame = frame.encode("ascii")
+        return self._send_recv(frame)
+
+    def _send_only(self, payload: bytes) -> None:
+        s = self._ensure_socket()
+        if self.channel == "udp":
+            s.sendto(payload, (self.host, self.port))
+        elif self.channel == "tcp":
+            s.sendall(payload)
+        else:
+            urllib.request.urlopen(
+                f"http://{self.host}:{self.port}/jsonrpc",
+                data=payload,
+                timeout=self.timeout_s,
+            )
+
+    def _send_recv(self, payload: bytes) -> bytes:
+        if self.channel == "http":
+            req = urllib.request.Request(
+                f"http://{self.host}:{self.port}/jsonrpc",
+                data=payload,
+                headers={"Content-Type": "application/json"},
+            )
+            with urllib.request.urlopen(req, timeout=self.timeout_s) as resp:
+                return resp.read()
+        s = self._ensure_socket()
+        if self.channel == "udp":
+            s.sendto(payload, (self.host, self.port))
+            data, _addr = s.recvfrom(4096)
+            return data
+        # tcp
+        s.sendall(payload)
+        return s.recv(4096)
+
+    def _sign(self, payload: bytes) -> bytes:
+        """HMAC-SHA256 본문 envelope `_dibd.security.sig` 본 영역 적재.
+
+        본 path = client-side 적재 본문 박음. 보드 본문 verify path 별 본문."""
+        import hmac
+        import hashlib
+        import json
+
+        body = json.loads(payload.decode("utf-8"))
+        body.setdefault("_dibd", {}).setdefault("security", {})
+        sig = hmac.new(self.hmac_key, payload, hashlib.sha256).hexdigest()
+        body["_dibd"]["security"]["sig"] = sig
+        return json.dumps(body, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
+
+    def close(self) -> None:
+        if self._sock is not None:
+            self._sock.close()
+            self._sock = None
+
+    def __enter__(self) -> "DibdClient":
+        return self
+
+    def __exit__(self, *exc: object) -> None:
+        self.close()

dibd_led_protocol-1.2.0/dibd/envelope.py

@@ -0,0 +1,70 @@
+"""envelope.py — JSON-RPC 2.0 envelope encode/decode (0514f Phase 1 호출 3).
+
+본문 책임:
+- build_request: dict → bytes (UTF-8 cJSON, magic byte '{' 본 path 정합).
+- parse_response: bytes → dict (jsonrpc 본문 검사 + DibdError raise path)."""
+from __future__ import annotations
+
+import json
+import secrets
+from typing import Any
+
+from .errors import DibdError
+
+
+_NEXT_ID = 0
+
+
+def _next_request_id() -> int:
+    global _NEXT_ID
+    _NEXT_ID += 1
+    return _NEXT_ID
+
+
+def build_request(
+    method: str,
+    params: dict[str, Any] | list[Any] | None = None,
+    *,
+    request_id: int | str | None = None,
+    nonce: str | None = None,
+    notification: bool = False,
+) -> bytes:
+    """JSON-RPC 2.0 request 본문 본 path 적재.
+
+    notification=True 시 id 부재 박음 (응답 부재 의무).
+    nonce 본문 박힐 시 `_dibd.security.nonce` 본 영역 적재 (replay 방지)."""
+    body: dict[str, Any] = {"jsonrpc": "2.0", "method": method}
+    if params is not None:
+        body["params"] = params
+    if not notification:
+        body["id"] = request_id if request_id is not None else _next_request_id()
+    if nonce is not None:
+        body.setdefault("_dibd", {}).setdefault("security", {})["nonce"] = nonce
+    return json.dumps(body, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
+
+
+def parse_response(raw: bytes) -> dict[str, Any]:
+    """JSON-RPC 2.0 response 본문 본 path 회수. error 본문 박힐 시 DibdError raise."""
+    try:
+        body = json.loads(raw.decode("utf-8"))
+    except (UnicodeDecodeError, json.JSONDecodeError) as exc:
+        raise DibdError(-32700, f"parse error: {exc}") from exc
+
+    if not isinstance(body, dict):
+        raise DibdError(-32600, "envelope is not an object")
+    if body.get("jsonrpc") != "2.0":
+        raise DibdError(-32600, f"jsonrpc != 2.0: {body.get('jsonrpc')!r}")
+
+    if "error" in body:
+        err = body["error"]
+        raise DibdError(
+            int(err.get("code", -32603)),
+            str(err.get("message", "unknown error")),
+            err.get("data"),
+        )
+    return body
+
+
+def fresh_nonce(num_bytes: int = 16) -> str:
+    """replay-방지 nonce 본문 (hex 문자열)."""
+    return secrets.token_hex(num_bytes)

dibd_led_protocol-1.2.0/dibd/errors.py

@@ -0,0 +1,38 @@
+"""errors.py — DIBD JSON-RPC 2.0 error code 본 매트릭스 (0514f Phase 1 호출 3).
+
+JSON-RPC 표준 -32700~-32603 + DIBD reserved -30000~-30999.
+SSOT: protocol_schema.json `errorCodes` 영역."""
+from __future__ import annotations
+
+from enum import IntEnum
+
+
+class ErrorCode(IntEnum):
+    """JSON-RPC 표준 + DIBD reserved range 본문."""
+
+    PARSE_ERROR = -32700
+    INVALID_REQUEST = -32600
+    METHOD_NOT_FOUND = -32601
+    INVALID_PARAMS = -32602
+    INTERNAL_ERROR = -32603
+
+    ENVELOPE_SIZE_LIMIT = -30000
+    BATCH_SIZE_LIMIT = -30001
+    CHUNK_FRAGMENT_TIMEOUT = -30002
+
+    BINARY_CHECKSUM_MISMATCH = -30100
+    BINARY_TOO_LARGE = -30101
+
+    AUTH_HMAC_INVALID = -30200
+    AUTH_REPLAY_DETECTED = -30201
+    AUTH_NONCE_MISSING = -30202
+
+
+class DibdError(Exception):
+    """DIBD JSON-RPC error 본문 raise path. code/message/data 본문 회수."""
+
+    def __init__(self, code: int, message: str, data: object | None = None) -> None:
+        super().__init__(f"[{code}] {message}")
+        self.code = code
+        self.message = message
+        self.data = data