P5840:[{"_1872":5881,"_778":5882,"_5403":21480,"_5448":21712,"_5450":21713,"_5471":21820,"_5483":21861},"eyJ2IjoxLCJ2YWx1ZXMiOnsicHVibGlzaGVkQXQiOnsiJHR5cGUiOiJEYXRlIiwidmFsdWUiOjE3ODQwNTkwOTk3MjF9LCJjcmVhdGVkQXQiOnsiJHR5cGUiOiJEYXRlIiwidmFsdWUiOjE3ODQwNTAxMzgyNjB9LCJpZCI6ImNtcmt4ZTB0MDAxcHoxMGxudXd4ejVxdngifX0",[5883,6252,6707,7263,7551,7994,8510,8944,9270,9495,10240,10852,11319,11792,11909,12000,12413,12972,13576,13700,14096,14193,14739,15223,15734,16188,16521,17010,17124,17627,17740,18124,18634,18916,19446,19575,19959,20433,20729,21074],{"_950":5884,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":5885,"_1889":5893,"_2455":-5,"_2456":-5,"_2457":-5,"_9":5897,"_2450":5905,"_2458":5906,"_2460":-5,"_723":5907,"_1886":5908,"_332":5911,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":5912,"_2003":5913,"_2480":5914,"_2482":-5,"_2483":5915,"_2485":-5,"_2486":-5,"_2487":5916,"_1144":5926,"_2527":5939,"_2555":-5,"_2556":5961,"_2798":6250,"_266":6251},"cmsbqjytw07cu10nvkvdkqj38",{"_1801":1802,"_214":5886,"_2429":5887,"_2434":5890,"_2438":2439},2944,{"_1892":5888,"_1893":1997,"_1802":5889,"_2433":1997},1065,1879,{"_1892":5891,"_1893":1997,"_1802":5892,"_2433":1997},0.3617527173913043,0.6382472826086957,{"_9":5894,"_2445":5898,"_2450":5902},{"_1892":5895,"_1893":5896,"_1802":5897},"MCP v2.0 + Fastify Security — Encryption Patterns to Prevent Agent Authorization Hijacking","MCP v2.0 + Fastifyセキュリティ — エージェントの権限奪取を防ぐ暗号化パターン","MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴",{"_1892":5899,"_1893":5900,"_1802":5901},"MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴\n\nMCP v2.0 + Fastify Security — Encryption Patterns to Prevent Agent Authorization Hijacking\n\nThe introduction of the Model Context Protocol (MCP) v2.0 has shifted how AI agents integrate tools toward a stateless HTTP architecture. Moving away from session-based communication allows infrastructure to scale like a standard web API, but delegating intermediate transaction state data to untrusted clients introduces vulnerabilities such as unauthorized privilege escalation or token reuse. Consequently, it is essential to implement robust encryption and integrity verification mechanisms at the backend application layer. This post outlines key patterns for controlling abnormal agent calls and enhancing integration security within Fastify and Node.js environments.\n\nStateless MCP v2.0 Architecture and New Security Threats\n\nThe most significant change in MCP v2.0 is the complete removal of connection-oriented handshakes and session identifiers, adopting stateless HTTP as the default transport protocol. This enables the backend to scale infinitely like a standard web API without needing to maintain session states. However, unlike traditional session-based communication, this creates new security vulnerabilities when handling conversational flows that require additional user input or explicit approval, such as multi-round trip requests.\n\nTo control these multi-step transactions, a 'requestState' parameter has been introduced, allowing the server to temporarily delegate intermediate state data externally. However, clients and LLM hosts that mediate transactions are inherently untrusted environments. If this state data is transmitted in plain text, it creates a conduit for attacks where malicious clients can modify internal database identifiers or user privilege levels before sending them back to the server.\n\nUltimately, unverified delegation of state information leads to 'confused deputy' attacks, where an attacker with lower privileges bypasses the system's security boundaries. Therefore, designing an encryption verification layer that guarantees the integrity and confidentiality of state values stored on the client is the core challenge of securing stateless agent architectures.\n\nGuaranteeing requestState Encryption and Integrity with Node.js Crypto\n\nIn a stateless environment, the requestState parameter exposed to the outside becomes a direct conduit where agent intermediate transaction parameters or user data can be tampered with. The safest way to prevent this is to apply symmetric encryption at the application layer to ensure both data confidentiality and integrity. For multiple Fastify servers behind a load balancer to perform decryption correctly, a synchronized symmetric key must be shared in advance via environment variables.\n\nUsing the aes-256-gcm algorithm in the built-in Node.js crypto module generates an authentication tag for integrity verification during encryption, effectively blocking any attempts at external tampering. The following is an example of a TypeScript implementation that can be utilized immediately as a Fastify decorator or utility.\n\nimport crypto from 'node:crypto';\n\nconst ALGORITHM = 'aes-256-gcm';\nconst KEY = Buffer.from(process.env.ENCRYPTION_KEY || '', 'hex'); // 32바이트 대칭키\n\nexport function encryptState(state: Record): string {\n const iv = crypto.randomBytes(12);\n const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);\n const encrypted = Buffer.concat([cipher.update(JSON.stringify(state), 'utf8'), cipher.final()]);\n const tag = cipher.getAuthTag();\n return `${iv.toString('hex')}:${tag.toString('hex')}:${encrypted.toString('hex')}`;\n}\n\nexport function decryptState(payload: string): Record {\n const [ivHex, tagHex, encryptedHex] = payload.split(':');\n const decipher = crypto.createDecipheriv(ALGORITHM, KEY, Buffer.from(ivHex, 'hex'));\n decipher.setAuthTag(Buffer.from(tagHex, 'hex'));\n const decrypted = Buffer.concat([decipher.update(Buffer.from(encryptedHex, 'hex')), decipher.final()]);\n return JSON.parse(decrypted.toString('utf8'));\n}\n\nApplying this encryption method makes it impossible for malicious clients or compromised LLM hosts to decrypt or directly modify internal state values. As a result, you can effectively defend against confused deputy attacks where attackers attempt to bypass flows to gain illegal privileges.\n\nPreventing Token Reuse Based on RFC 9728 and RFC 8707 Standards\n\nIn the stateless MCP 2.0 environment, network boundary-level defense is essential to prevent token theft and reuse. To achieve this, MCP 2.0 fully adopts the OAuth 2.1 specification, introducing standard metadata for protected resources based on RFC 9728 and resource indicators based on RFC 8707. In this structure, individual MCP servers that an agent intends to call act as independent resource servers, directly controlling their own authorization boundaries.\n\nThe operational mechanism is clear. If an unauthenticated agent client attempts to access a resource, the MCP server follows the RFC 9728 standard by including a metadata link in the header and returning a 401 error, or by exposing its own metadata endpoint to announce trusted authorization server information. Subsequently, when the client requests a token from the authorization server, it must specify the unique identifier address of the target MCP server as a resource parameter in accordance with the RFC 8707 specification. The authorization server then issues a token restricted specifically to that MCP server.\n\nFastify handles these standard flows efficiently and powerfully within onRequest hooks. As soon as an agent's request is received, the server executes a hook to validate the token's signature and verify that the target identifier contained in the internal 'aud' claim exactly matches its own unique address. If a token issued for a different MCP server is re-submitted or if the authorization scope is inconsistent, the request is blocked immediately to prevent confused deputy attacks.\n\nBuilding Agent Security Infrastructure with a Zero-Trust Perspective\n\nTo secure agent operations in the stateless MCP 2.0 environment, adopting a zero-trust perspective—where even large language models are treated as untrusted entities—is critical. You must build strict integrity verification and protective barriers at the application layer to ensure that external clients or agents cannot arbitrarily manipulate intermediate transaction state data.\n\nBy organically combining Fastify's schema validation, the built-in Node.js crypto API, and token verification mechanisms based on RFC 9728 and RFC 8707 standards, you can safely control autonomous agents. Backend engineers must move beyond the role of providing tool APIs to becoming security boundary architects who prevent agents from malfunctioning or misusing their privileges.\n\nReference Links\n\nModel Context Protocol GitHub — MCP TypeScript SDK v2.0.0 Stable Release & Package Splitting\nFastify Official Docs — Fastify v5.10.0 Release - LogController and Dynamic Logging Deprecations","MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴\n\nMCP v2.0 + Fastifyセキュリティ — エージェントの権限奪取を防ぐ暗号化パターン\n\nModel Context Protocol (MCP) v2.0の導入により、AIエージェントのツール連携方式はステートレスなHTTPアーキテクチャへと移行しました。従来のセッションベースの通信から脱却し、標準的なWeb APIのようにインフラをスケールさせることが可能になった一方、トランザクションの中間状態データを信頼できないクライアントに委ねることで、権限の悪用やトークンの再利用といったセキュリティ上の脆弱性が生じやすい構造にもなっています。そのため、バックエンドのアプリケーションレイヤーにおいて、これを防御する強力な暗号化および整合性検証の仕組みを備える必要があります。本記事では、FastifyとNode.js環境においてエージェントの異常な呼び出しを制御し、連携セキュリティを強化するための主要なパターンを解説します。\n\nステートレスなMCP v2.0アーキテクチャと新たなセキュリティ脅威\n\nMCP v2.0の最も大きな変更点は、コネクション指向のハンドシェイクとセッション識別子を完全に廃止し、ステートレスなHTTPを標準の転送プロトコルとして採用したことです。これにより、サーバーはセッションの状態を維持することなく、標準のWeb APIのようにバックエンドを柔軟かつ無限に拡張できるようになりました。しかし、従来のセッションベースの通信とは異なり、マルチラウンドトリップリクエストのように、ユーザーの追加入力や明示的な承認を必要とする会話フローを扱う際に新たなセキュリティの脆弱性が生じます。\n\nこのような複数ステップのトランザクションを制御するため、サーバーが中間状態データを一時的に外部へ委ねる「requestState」パラメータが導入されました。しかし、クライアントやトランザクションを仲介するLLMホストは、本質的に信頼できない環境です。もしこの状態データを単純な平文として送信すれば、悪意のあるクライアントが内部データベースの識別子やユーザーの権限レベルを改ざんしてサーバーへ再送信する、侵入の入り口となってしまいます。\n\n結局のところ、検証されていない状態情報の委任は、低権限の攻撃者がシステムのセキュリティ境界を回避する「代理人混同攻撃（Confused Deputy Attack）」につながります。したがって、クライアントに保存される中間状態値の整合性と機密性を確実に保証する暗号化検証レイヤーを設計することが、ステートレスなエージェントアーキテクチャのセキュリティにおける核心課題となります。\n\nNode.js CryptoベースのrequestState暗号化と整合性保証\n\nステートレスな環境下で外部へ露出するrequestStateパラメータは、エージェントの中間トランザクションパラメータやユーザーデータが改ざんされる直接的な経路となります。これを防ぐ最も安全な方法は、アプリケーションレイヤーで共通鍵暗号方式を適用し、データの機密性と整合性を同時に保証することです。ロードバランサー配下にある複数のFastifyサーバーが正常に復号を行うには、環境変数で同期された共通鍵を事前に共有しておく必要があります。\n\nNode.js組み込みのcryptoモジュールによるaes-256-gcmアルゴリズムを使用すれば、暗号化の過程で整合性検証のための認証タグが生成されるため、外部からの改ざん試行を根本から遮断できます。Fastifyのデコレータやユーティリティとしてすぐに利用可能なTypeScriptの実装例を以下に示します。\n\nimport crypto from 'node:crypto';\n\nconst ALGORITHM = 'aes-256-gcm';\nconst KEY = Buffer.from(process.env.ENCRYPTION_KEY || '', 'hex'); // 32바이트 대칭키\n\nexport function encryptState(state: Record): string {\n const iv = crypto.randomBytes(12);\n const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);\n const encrypted = Buffer.concat([cipher.update(JSON.stringify(state), 'utf8'), cipher.final()]);\n const tag = cipher.getAuthTag();\n return `${iv.toString('hex')}:${tag.toString('hex')}:${encrypted.toString('hex')}`;\n}\n\nexport function decryptState(payload: string): Record {\n const [ivHex, tagHex, encryptedHex] = payload.split(':');\n const decipher = crypto.createDecipheriv(ALGORITHM, KEY, Buffer.from(ivHex, 'hex'));\n decipher.setAuthTag(Buffer.from(tagHex, 'hex'));\n const decrypted = Buffer.concat([decipher.update(Buffer.from(encryptedHex, 'hex')), decipher.final()]);\n return JSON.parse(decrypted.toString('utf8'));\n}\n\nこの暗号化方式を適用すれば、悪意のあるクライアントや乗っ取られたLLMホストが内部の状態値を解読したり直接修正したりすることは不可能になります。結果として、攻撃者がフローを迂回して不正な権限を獲得しようとする代理人攻撃を効果的に防御できます。\n\nRFC 9728およびRFC 8707標準に基づくトークン再利用防止\n\nステートレス環境へ移行したMCP 2.0では、トークンの窃取や再利用を防ぐためにネットワーク境界レベルの防御が不可欠です。そのためにMCP 2.0はOAuth 2.1仕様を全面的に受け入れ、RFC 9728に基づく「保護リソースメタデータ」標準と、RFC 8707に基づく「リソースインジケーター」標準を導入しました。この構造において、エージェントが呼び出そうとする個々のMCPサーバーは独立したリソースサーバーの役割を果たし、権限の境界を直接管理します。\n\n動作の仕組みは明確です。認証されていないエージェントクライアントがアクセスすると、MCPサーバーはRFC 9728標準に従い、ヘッダーにメタデータリンクを含めて401エラーを返したり、独自のメタデータエンドポイントを公開して信頼できる認可サーバーの情報を通知したりします。その後、クライアントが認可サーバーへトークンを要求する際、RFC 8707仕様に基づき対象MCPサーバーの固有識別子アドレスをリソースパラメータとして明示する必要があります。認可サーバーはこのリクエストに基づいて、該当MCPサーバー専用に制限されたトークンを発行します。\n\nFastifyは、こうした標準的なフローをonRequestフックで軽量かつ強力に処理します。サーバーはエージェントからのリクエストを受け取ると直ちにフックを実行し、トークンの署名を検証します。さらに、内部のaudクレームに含まれる対象識別子が自分自身の固有アドレスと正確に一致するかを確認します。もし別のMCPサーバー宛に発行されたトークンが再利用されたり、権限の範囲が一致しなかったりした場合は、即座にリクエストを早期遮断することで、権限が悪用される代理人混同攻撃を未然に防ぎます。\n\nゼロトラストの観点から構築するエージェントセキュリティインフラ\n\nステートレスへ移行したMCP 2.0環境においてエージェントのセキュリティを確保するには、大規模言語モデルでさえ信頼できない主体として定義する「ゼロトラスト」の観点が重要です。外部クライアントやエージェントがトランザクションの中間状態データを任意に操作できないよう、アプリケーションレイヤーで厳格な整合性検証と保護障壁を構築しなければなりません。\n\nFastifyのスキーマ検証、Node.jsの内蔵暗号化API、そしてRFC 9728およびRFC 8707標準に基づくトークン検証メカニズムを有機的に組み合わせることで、自律的に動作するエージェントを安全に制御できます。バックエンドエンジニアは単にツールAPIを提供する役割を超え、エージェントが誤動作や権限の乱用を起こさないよう食い止める「セキュリティ境界の設計者」として中心的な役割を担うべきです。\n\n参考リンク\n\nModel Context Protocol GitHub — MCP TypeScript SDK v2.0.0 Stable Release & Package Splitting\nFastify Official Docs — Fastify v5.10.0 Release - LogController and Dynamic Logging Deprecations","MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴\n\nMCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴\n\n모델 컨텍스트 프로토콜(MCP) v2.0의 도입으로 AI 에이전트의 도구 연동 방식이 무상태 HTTP 아키텍처로 전환되었습니다. 기존의 세션 기반 통신에서 벗어나 표준 웹 API처럼 인프라를 확장할 수 있게 되었지만, 트랜잭션의 중간 상태 데이터를 신뢰할 수 없는 클라이언트에 위임하면서 권한 남용이나 토큰 재사용 같은 보안 취약점이 발생하기 쉬운 구조가 되었습니다. 따라서 백엔드 애플리케이션 레이어에서 이를 방어하는 강력한 암호화 및 무결성 검증 체계를 갖춰야 합니다. Fastify와 Node.js 환경에서 에이전트의 비정상적 호출을 제어하고 연동 보안을 강화하는 핵심 패턴을 정리합니다.\n\n무상태 MCP v2.0 아키텍처와 새로운 보안 위협\n\nMCP v2.0의 가장 핵심적인 변화는 연결 지향적 핸드셰이크와 세션 식별자를 완전히 제거하고 무상태 HTTP를 기본 전송 프로토콜로 채택한 점입니다. 이를 통해 서버는 세션 상태를 유지할 필요 없이 표준 웹 API처럼 유연하게 백엔드를 무한 확장할 수 있게 되었습니다. 하지만 기존 세션 기반 통신과 달리, 다중 라운드 트립 요청처럼 추가적인 사용자 입력이나 명시적 승인이 필요한 대화형 흐름을 다룰 때 새로운 보안 취약점이 발생합니다.\n\n이러한 다중 단계 트랜잭션을 제어하기 위해 서버가 중간 상태 데이터를 일시적으로 외부에 위임하는 requestState 파라미터가 도입되었습니다. 그러나 클라이언트나 트랜잭션을 중개하는 LLM 호스트는 기본적으로 신뢰할 수 없는 환경입니다. 만약 이 상태 데이터를 단순한 평문 정보로 전달하면, 악의적인 클라이언트가 내부 데이터베이스 식별자나 사용자 권한 수준을 변조하여 서버로 다시 전송하는 침투 통로가 열립니다.\n\n결국 검증되지 않은 상태 정보 위임은 권한이 낮은 공격자가 시스템의 보안 경계를 우회하는 대리인 혼동 공격으로 이어집니다. 따라서 클라이언트에 저장되는 중간 상태 값의 무결성과 기밀성을 반드시 보장하는 암호화 검증 레이어를 설계하는 것이 무상태 에이전트 아키텍처 보안의 핵심 과제입니다.\n\nNode.js Crypto 기반의 requestState 암호화 및 무결성 보장\n\n무상태 환경에서 외부로 노출되는 requestState 파라미터는 에이전트의 중간 트랜잭션 매개변수나 사용자 데이터가 변조될 수 있는 직접적인 통로가 됩니다. 이를 방지하는 가장 안전한 방법은 애플리케이션 레이어에서 대칭키 암호화를 적용하여 데이터의 기밀성과 무결성을 동시에 보장하는 것입니다. 로드 밸런서 하위에 있는 여러 대의 Fastify 서버가 복호화를 정상적으로 수행하려면, 환경 변수로 동기화된 대칭키가 반드시 사전에 공유되어야 합니다.\n\nNode.js 내장 crypto 모듈의 aes-256-gcm 알고리즘을 사용하면 암호화 과정에서 무결성 검증을 위한 인증 태그가 함께 생성되므로 외부 위변조 시도를 원천 차단할 수 있습니다. Fastify 데코레이터나 유틸리티로 즉시 활용 가능한 TypeScript 구현 예시는 다음과 같습니다.\n\nimport crypto from 'node:crypto';\n\nconst ALGORITHM = 'aes-256-gcm';\nconst KEY = Buffer.from(process.env.ENCRYPTION_KEY || '', 'hex'); // 32바이트 대칭키\n\nexport function encryptState(state: Record): string {\n const iv = crypto.randomBytes(12);\n const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);\n const encrypted = Buffer.concat([cipher.update(JSON.stringify(state), 'utf8'), cipher.final()]);\n const tag = cipher.getAuthTag();\n return `${iv.toString('hex')}:${tag.toString('hex')}:${encrypted.toString('hex')}`;\n}\n\nexport function decryptState(payload: string): Record {\n const [ivHex, tagHex, encryptedHex] = payload.split(':');\n const decipher = crypto.createDecipheriv(ALGORITHM, KEY, Buffer.from(ivHex, 'hex'));\n decipher.setAuthTag(Buffer.from(tagHex, 'hex'));\n const decrypted = Buffer.concat([decipher.update(Buffer.from(encryptedHex, 'hex')), decipher.final()]);\n return JSON.parse(decrypted.toString('utf8'));\n}\n\n이 암호화 방식을 적용하면 악의적인 클라이언트나 탈취된 LLM 호스트가 내부 상태 값을 해독하거나 직접 수정하는 행위가 불가능해집니다. 결과적으로 공격자가 흐름을 우회하여 불법적인 권한을 획득하는 대리인 공격을 효과적으로 방어할 수 있습니다.\n\nRFC 9728과 RFC 8707 표준 기반의 토큰 재사용 방지\n\n무상태 환경으로 전환된 MCP 2.0에서는 토큰 탈취 및 재사용을 방지하기 위해 네트워크 경계 수준의 방어가 필수적입니다. 이를 위해 MCP 2.0은 OAuth 2.1 명세를 전면 수용하며, RFC 9728 기반의 보호 자원 메타데이터 표준과 RFC 8707 기반의 리소스 인디케이터 표준을 도입했습니다. 이 구조에서는 에이전트가 호출하려는 개별 MCP 서버가 독립적인 리소스 서버 역할을 수행하며 권한 경계를 직접 통제합니다.\n\n동작 방식은 명확합니다. 인증되지 않은 에이전트 클라이언트가 접근하면, MCP 서버는 RFC 9728 표준에 따라 헤더에 메타데이터 링크를 담아 401 오류를 반환하거나 자체 메타데이터 엔드포인트를 노출해 신뢰하는 인가 서버 정보를 알립니다. 이후 클라이언트는 인가 서버에 토큰을 요청할 때 RFC 8707 명세에 맞춰 대상 MCP 서버의 고유 식별자 주소를 리소스 파라미터로 명시해야 합니다. 인가 서버는 이 요청을 바탕으로 해당 MCP 서버 전용으로 제한된 토큰을 발행합니다.\n\nFastify는 이러한 표준 흐름을 onRequest 훅에서 가볍고 강력하게 처리합니다. 서버는 에이전트의 요청이 인입되는 즉시 훅을 실행해 토큰의 서명을 유효화하고, 내부 aud 클레임에 담긴 대상 식별자가 자신의 고유 주소와 정확히 일치하는지 검증합니다. 만약 다른 MCP 서버를 대상으로 발급된 토큰이 재입력되거나 권한 범위가 불일치할 경우, 즉시 요청을 조기 차단하여 권한이 남용되는 대리인 혼동 공격을 예방합니다.\n\n제로 트러스트 관점의 에이전트 보안 인프라 구축\n\n무상태로 전환된 MCP 2.0 환경에서 에이전트 보안을 확보하려면 대규모 언어 모델조차 신뢰할 수 없는 주체로 정의하는 제로 트러스트 관점이 핵심입니다. 외부 클라이언트나 에이전트가 트랜잭션의 중간 상태 데이터를 임의로 조작할 수 없도록 애플리케이션 레이어에서 엄격한 무결성 검증과 보호 장벽을 구축해야 합니다.\n\nFastify의 스키마 검증, Node.js 내장 암호화 API, 그리고 RFC 9728 및 RFC 8707 표준 기반의 토큰 검증 메커니즘을 유기적으로 결합하면 자율적으로 동작하는 에이전트를 안전하게 통제할 수 있습니다. 백엔드 엔지니어는 단순히 도구 API를 제공하는 역할을 넘어 에이전트가 오작동하거나 권한을 오용하지 못하도록 차단하는 보안 경계 설계자로서 중심을 잡아야 합니다.\n\n참고 링크\n\nModel Context Protocol GitHub — MCP TypeScript SDK v2.0.0 Stable Release & Package Splitting\nFastify Official Docs — Fastify v5.10.0 Release - LogController and Dynamic Logging Deprecations",{"_1892":5903,"_1893":5904,"_1802":5905},"MCP v2.0 + Fastify Security — Encryption Patterns to Prevent Agent Authorization Hijacking The introduction of the Model Context Protocol (MCP) v2.0 has shifted how AI agents integrate tools toward a stateless HTTP archi…","MCP v2.0 + Fastifyセキュリティ — エージェントの権限奪取を防ぐ暗号化パターン Model Context Protocol (MCP) v2.0の導入により、AIエージェントのツール連携方式はステートレスなHTTPアーキテクチャへと移行しました。従来のセッションベースの通信から脱却し、標準的なWeb APIのようにインフラをスケールさせることが可能になった一方、トランザクションの中間状態データを信頼できないクライアン…","MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴 모델 컨텍스트 프로토콜(MCP) v2.0의 도입으로 AI 에이전트의 도구 연동 방식이 무상태 HTTP 아키텍처로 전환되었습니다. 기존의 세션 기반 통신에서 벗어나 표준 웹 API처럼 인프라를 확장할 수 있게 되었지만, 트랜잭션의 중간 상태 데이터를 신뢰할 수 없는 클라이언트에 위임하면서 권한 남용이나 토큰 재사…","cmsbsteyw07e510nvsflmmtwz",[3122],[3124,3792,5909,3126,5910,3793],"mcp-v","security",[],"2026-08-03T03:03:56.228Z","2026-08-02T11:47:25.076Z","2026-08-03T03:04:25.731Z","2026-08-03T03:04:25.699Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":5917},{"_1901":5918},{"_1903":5919,"_1908":1909,"_1910":5920,"_1921":5921,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":5922,"_1928":5923,"_1933":5924,"_1938":5925},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":5927,"_1883":1884,"_1200":1204,"_1899":5930},{"_633":5928,"_11":5929},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":5931},{"_1903":5932,"_1908":1909,"_1910":5933,"_1921":5934,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":5935,"_1928":5936,"_1933":5937,"_1938":5938},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":5940},{"_1948":-5,"_1908":1909,"_1910":5941,"_1960":-5,"_1943":5947,"_1962":5948},{"_1912":5942,"_1914":5943,"_1952":5944,"_1810":2534,"_944":1992,"_1917":5945,"_1957":2536,"_1919":5946},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/df9c48fc-e8fc-4ada-96c7-1a3249270e98.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/df9c48fc-e8fc-4ada-96c7-1a3249270e98.jpg",392121,"L67nao~XM{E0xuoyRjof004.xb%M","#181818","2026-08-02T12:50:45.703Z",{"_1964":5949,"_1972":5953,"_1979":5957,"_1986":-5},{"_1912":5950,"_1914":5951,"_1952":5952,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/large.webp",20580,{"_1912":5954,"_1914":5955,"_1952":5956,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/small.webp",5528,{"_1912":5958,"_1914":5959,"_1952":5960,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsbsteyw07e510nvsflmmtwz/medium.webp",11448,{"_950":5962,"_2559":5884,"_2560":5963,"_2716":6168,"_2788":6246,"_2790":6247,"_2792":5397,"_2794":1997,"_2003":6248,"_2480":6249,"_2797":-5},"cmsbqjyu107cv10nv9c4lucx9",{"_918":5964,"_1908":1909},[5965,5967,5970,5974,5977,5982,5985,5990,5993,5998,6001,6010,6013,6018,6021,6026,6029,6038,6041,6054,6057,6060,6063,6068,6071,6076,6079,6084,6087,6092,6095,6110,6113,6118,6121,6126,6129,6134,6137,6139,6142,6147,6150],{"_950":5966,"_2565":5897,"_2420":2566,"_2567":5906},"d3aa6cb3-8f94-4c2c-a6e3-7d66e8a2303e",{"_950":5968,"_2420":2570,"_2571":5969},"c31292e4-bae2-4951-ba17-0493a071dfa1",[],{"_950":5971,"_2420":2575,"_2576":1909,"_2571":5972},"c8d3a23d-e773-4b85-8e59-30eb5a1d311e",[5973],{"_2579":5897,"_2420":2579},{"_950":5975,"_2420":2570,"_2571":5976},"6cda15fa-71df-4b7d-83bd-a45a4f1958be",[],{"_950":5978,"_2420":2570,"_2571":5979},"8b5a1638-a42f-440e-983d-0ef3df7b9ef3",[5980],{"_2579":5981,"_2420":2579},"모델 컨텍스트 프로토콜(MCP) v2.0의 도입으로 AI 에이전트의 도구 연동 방식이 무상태 HTTP 아키텍처로 전환되었습니다. 기존의 세션 기반 통신에서 벗어나 표준 웹 API처럼 인프라를 확장할 수 있게 되었지만, 트랜잭션의 중간 상태 데이터를 신뢰할 수 없는 클라이언트에 위임하면서 권한 남용이나 토큰 재사용 같은 보안 취약점이 발생하기 쉬운 구조가 되었습니다. 따라서 백엔드 애플리케이션 레이어에서 이를 방어하는 강력한 암호화 및 무결성 검증 체계를 갖춰야 합니다. Fastify와 Node.js 환경에서 에이전트의 비정상적 호출을 제어하고 연동 보안을 강화하는 핵심 패턴을 정리합니다.",{"_950":5983,"_2420":2570,"_2571":5984},"50427ab7-a9a2-4632-80c5-7812e8ea4118",[],{"_950":5986,"_2420":2575,"_2576":2007,"_2571":5987},"618bc2de-2939-4f84-8ff4-fea000e9f756",[5988],{"_2579":5989,"_2420":2579},"무상태 MCP v2.0 아키텍처와 새로운 보안 위협",{"_950":5991,"_2420":2570,"_2571":5992},"dc6b93d1-839c-495c-9770-3493af7ab5e8",[],{"_950":5994,"_2420":2570,"_2571":5995},"b4bbb6c1-37f0-438e-8011-caf10582616c",[5996],{"_2579":5997,"_2420":2579},"MCP v2.0의 가장 핵심적인 변화는 연결 지향적 핸드셰이크와 세션 식별자를 완전히 제거하고 무상태 HTTP를 기본 전송 프로토콜로 채택한 점입니다. 이를 통해 서버는 세션 상태를 유지할 필요 없이 표준 웹 API처럼 유연하게 백엔드를 무한 확장할 수 있게 되었습니다. 하지만 기존 세션 기반 통신과 달리, 다중 라운드 트립 요청처럼 추가적인 사용자 입력이나 명시적 승인이 필요한 대화형 흐름을 다룰 때 새로운 보안 취약점이 발생합니다.",{"_950":5999,"_2420":2570,"_2571":6000},"eead2f58-f491-4a90-8318-e0a6a98f21ff",[],{"_950":6002,"_2420":2570,"_2571":6003},"6cc2d690-a645-42fc-bb83-14464183ede3",[6004,6006,6008],{"_2579":6005,"_2420":2579},"이러한 다중 단계 트랜잭션을 제어하기 위해 서버가 중간 상태 데이터를 일시적으로 외부에 위임하는 ",{"_2579":3895,"_2420":2579,"_3365":6007},{"_3351":3367},{"_2579":6009,"_2420":2579}," 파라미터가 도입되었습니다. 그러나 클라이언트나 트랜잭션을 중개하는 LLM 호스트는 기본적으로 신뢰할 수 없는 환경입니다. 만약 이 상태 데이터를 단순한 평문 정보로 전달하면, 악의적인 클라이언트가 내부 데이터베이스 식별자나 사용자 권한 수준을 변조하여 서버로 다시 전송하는 침투 통로가 열립니다.",{"_950":6011,"_2420":2570,"_2571":6012},"c326e919-2cc6-480c-ae09-b264a5e56020",[],{"_950":6014,"_2420":2570,"_2571":6015},"22c9c8d6-69cb-43b0-a425-d011ce7af573",[6016],{"_2579":6017,"_2420":2579},"결국 검증되지 않은 상태 정보 위임은 권한이 낮은 공격자가 시스템의 보안 경계를 우회하는 대리인 혼동 공격으로 이어집니다. 따라서 클라이언트에 저장되는 중간 상태 값의 무결성과 기밀성을 반드시 보장하는 암호화 검증 레이어를 설계하는 것이 무상태 에이전트 아키텍처 보안의 핵심 과제입니다.",{"_950":6019,"_2420":2570,"_2571":6020},"d06234fe-60fc-4a2d-a342-7a9d4ef265ee",[],{"_950":6022,"_2420":2575,"_2576":2007,"_2571":6023},"a20b8be6-30ae-4315-9c5c-0a86fe927b64",[6024],{"_2579":6025,"_2420":2579},"Node.js Crypto 기반의 requestState 암호화 및 무결성 보장",{"_950":6027,"_2420":2570,"_2571":6028},"9063d3b7-0b54-4fcd-b21b-c1f38aa087d4",[],{"_950":6030,"_2420":2570,"_2571":6031},"df32ba84-f0b3-46ec-b4aa-bbc46e31775e",[6032,6034,6036],{"_2579":6033,"_2420":2579},"무상태 환경에서 외부로 노출되는 ",{"_2579":3895,"_2420":2579,"_3365":6035},{"_3351":3367},{"_2579":6037,"_2420":2579}," 파라미터는 에이전트의 중간 트랜잭션 매개변수나 사용자 데이터가 변조될 수 있는 직접적인 통로가 됩니다. 이를 방지하는 가장 안전한 방법은 애플리케이션 레이어에서 대칭키 암호화를 적용하여 데이터의 기밀성과 무결성을 동시에 보장하는 것입니다. 로드 밸런서 하위에 있는 여러 대의 Fastify 서버가 복호화를 정상적으로 수행하려면, 환경 변수로 동기화된 대칭키가 반드시 사전에 공유되어야 합니다.",{"_950":6039,"_2420":2570,"_2571":6040},"7fc33ee2-34f7-4f2b-85f8-b8843fdb10e3",[],{"_950":6042,"_2420":2570,"_2571":6043},"33e24780-14ee-4f6b-a904-4ddb940b1478",[6044,6045,6047,6049,6052],{"_2579":3938,"_2420":2579},{"_2579":31,"_2420":2579,"_3365":6046},{"_3351":3367},{"_2579":6048,"_2420":2579}," 모듈의 ",{"_2579":6050,"_2420":2579,"_3365":6051},"aes-256-gcm",{"_3351":3367},{"_2579":6053,"_2420":2579}," 알고리즘을 사용하면 암호화 과정에서 무결성 검증을 위한 인증 태그가 함께 생성되므로 외부 위변조 시도를 원천 차단할 수 있습니다. Fastify 데코레이터나 유틸리티로 즉시 활용 가능한 TypeScript 구현 예시는 다음과 같습니다.",{"_950":6055,"_2420":2570,"_2571":6056},"3aaba918-56d6-45f9-b6b5-c048de23f68f",[],{"_950":6058,"_3351":6059,"_2420":3351,"_625":3125},"b76711ee-b663-4083-90bb-ef8682717ec6","import crypto from 'node:crypto';\n\nconst ALGORITHM = 'aes-256-gcm';\nconst KEY = Buffer.from(process.env.ENCRYPTION_KEY || '', 'hex'); // 32바이트 대칭키\n\nexport function encryptState(state: Record): string {\n const iv = crypto.randomBytes(12);\n const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);\n const encrypted = Buffer.concat([cipher.update(JSON.stringify(state), 'utf8'), cipher.final()]);\n const tag = cipher.getAuthTag();\n return `${iv.toString('hex')}:${tag.toString('hex')}:${encrypted.toString('hex')}`;\n}\n\nexport function decryptState(payload: string): Record {\n const [ivHex, tagHex, encryptedHex] = payload.split(':');\n const decipher = crypto.createDecipheriv(ALGORITHM, KEY, Buffer.from(ivHex, 'hex'));\n decipher.setAuthTag(Buffer.from(tagHex, 'hex'));\n const decrypted = Buffer.concat([decipher.update(Buffer.from(encryptedHex, 'hex')), decipher.final()]);\n return JSON.parse(decrypted.toString('utf8'));\n}",{"_950":6061,"_2420":2570,"_2571":6062},"e57a1106-2c96-4054-b1ac-d27efd1e552e",[],{"_950":6064,"_2420":2570,"_2571":6065},"ff2709b4-e96e-420d-812f-22de61e58e53",[6066],{"_2579":6067,"_2420":2579},"이 암호화 방식을 적용하면 악의적인 클라이언트나 탈취된 LLM 호스트가 내부 상태 값을 해독하거나 직접 수정하는 행위가 불가능해집니다. 결과적으로 공격자가 흐름을 우회하여 불법적인 권한을 획득하는 대리인 공격을 효과적으로 방어할 수 있습니다.",{"_950":6069,"_2420":2570,"_2571":6070},"f048036b-0139-4f4c-a4c6-9f20ad2793ca",[],{"_950":6072,"_2420":2575,"_2576":2007,"_2571":6073},"6a95d15a-8d3f-4ceb-8408-5efce6e63a6f",[6074],{"_2579":6075,"_2420":2579},"RFC 9728과 RFC 8707 표준 기반의 토큰 재사용 방지",{"_950":6077,"_2420":2570,"_2571":6078},"0885632a-757b-4070-be95-7b3223a0f4bc",[],{"_950":6080,"_2420":2570,"_2571":6081},"3c7066bf-20de-4c97-ae0c-0cd7f9d15d7d",[6082],{"_2579":6083,"_2420":2579},"무상태 환경으로 전환된 MCP 2.0에서는 토큰 탈취 및 재사용을 방지하기 위해 네트워크 경계 수준의 방어가 필수적입니다. 이를 위해 MCP 2.0은 OAuth 2.1 명세를 전면 수용하며, RFC 9728 기반의 보호 자원 메타데이터 표준과 RFC 8707 기반의 리소스 인디케이터 표준을 도입했습니다. 이 구조에서는 에이전트가 호출하려는 개별 MCP 서버가 독립적인 리소스 서버 역할을 수행하며 권한 경계를 직접 통제합니다.",{"_950":6085,"_2420":2570,"_2571":6086},"40498aa9-ad82-4a89-bfab-e365bf60ae86",[],{"_950":6088,"_2420":2570,"_2571":6089},"9a6477ac-e2cd-4d22-be75-554e981f6dab",[6090],{"_2579":6091,"_2420":2579},"동작 방식은 명확합니다. 인증되지 않은 에이전트 클라이언트가 접근하면, MCP 서버는 RFC 9728 표준에 따라 헤더에 메타데이터 링크를 담아 401 오류를 반환하거나 자체 메타데이터 엔드포인트를 노출해 신뢰하는 인가 서버 정보를 알립니다. 이후 클라이언트는 인가 서버에 토큰을 요청할 때 RFC 8707 명세에 맞춰 대상 MCP 서버의 고유 식별자 주소를 리소스 파라미터로 명시해야 합니다. 인가 서버는 이 요청을 바탕으로 해당 MCP 서버 전용으로 제한된 토큰을 발행합니다.",{"_950":6093,"_2420":2570,"_2571":6094},"625bf8b7-5420-475a-979d-f87dbd7e6074",[],{"_950":6096,"_2420":2570,"_2571":6097},"b54a1722-a5dd-4eaf-ba6c-377bd97088ee",[6098,6100,6103,6105,6108],{"_2579":6099,"_2420":2579},"Fastify는 이러한 표준 흐름을 ",{"_2579":6101,"_2420":2579,"_3365":6102},"onRequest",{"_3351":3367},{"_2579":6104,"_2420":2579}," 훅에서 가볍고 강력하게 처리합니다. 서버는 에이전트의 요청이 인입되는 즉시 훅을 실행해 토큰의 서명을 유효화하고, 내부 ",{"_2579":6106,"_2420":2579,"_3365":6107},"aud",{"_3351":3367},{"_2579":6109,"_2420":2579}," 클레임에 담긴 대상 식별자가 자신의 고유 주소와 정확히 일치하는지 검증합니다. 만약 다른 MCP 서버를 대상으로 발급된 토큰이 재입력되거나 권한 범위가 불일치할 경우, 즉시 요청을 조기 차단하여 권한이 남용되는 대리인 혼동 공격을 예방합니다.",{"_950":6111,"_2420":2570,"_2571":6112},"7b892745-bdc2-4e9e-b617-a02fecf97188",[],{"_950":6114,"_2420":2575,"_2576":2007,"_2571":6115},"1933613f-0259-4a39-b1ff-9f72268006d2",[6116],{"_2579":6117,"_2420":2579},"제로 트러스트 관점의 에이전트 보안 인프라 구축",{"_950":6119,"_2420":2570,"_2571":6120},"e19bceb6-11e0-4a33-9e30-9689b5dba4b3",[],{"_950":6122,"_2420":2570,"_2571":6123},"06d3fc75-2c26-4a74-8a70-168310ea20fc",[6124],{"_2579":6125,"_2420":2579},"무상태로 전환된 MCP 2.0 환경에서 에이전트 보안을 확보하려면 대규모 언어 모델조차 신뢰할 수 없는 주체로 정의하는 제로 트러스트 관점이 핵심입니다. 외부 클라이언트나 에이전트가 트랜잭션의 중간 상태 데이터를 임의로 조작할 수 없도록 애플리케이션 레이어에서 엄격한 무결성 검증과 보호 장벽을 구축해야 합니다.",{"_950":6127,"_2420":2570,"_2571":6128},"167c2595-1ccf-4185-9ec1-e06dc59921f5",[],{"_950":6130,"_2420":2570,"_2571":6131},"a76c599c-0617-4229-8bff-63e09ac91dda",[6132],{"_2579":6133,"_2420":2579},"Fastify의 스키마 검증, Node.js 내장 암호화 API, 그리고 RFC 9728 및 RFC 8707 표준 기반의 토큰 검증 메커니즘을 유기적으로 결합하면 자율적으로 동작하는 에이전트를 안전하게 통제할 수 있습니다. 백엔드 엔지니어는 단순히 도구 API를 제공하는 역할을 넘어 에이전트가 오작동하거나 권한을 오용하지 못하도록 차단하는 보안 경계 설계자로서 중심을 잡아야 합니다.",{"_950":6135,"_2420":2570,"_2571":6136},"6a792d30-c3aa-4cea-8c78-a2c97492a4b3",[],{"_950":6138,"_2420":3473},"41505ade-2716-4d8a-a4de-5723ba947f74",{"_950":6140,"_2420":2570,"_2571":6141},"9bdf6f3f-b6eb-4094-8328-9c05c3aba8ef",[],{"_950":6143,"_2420":2570,"_2571":6144},"c6db7992-15bf-4f47-ada8-63f855817831",[6145],{"_2579":3483,"_2420":2579,"_3365":6146},{"_3485":3367},{"_950":6148,"_2420":2570,"_2571":6149},"6ff856be-6ba3-4cfa-9d7a-eb4e2b79349e",[],{"_950":6151,"_1881":3492,"_2420":3493,"_778":6152},"05ed290f-0be9-4471-b1f2-7121c0dc6a2a",[6153,6160],{"_950":6154,"_2571":6155},"bf27c4ef-84b3-454c-bb0a-26f0999f4382",[6156],{"_3499":5316,"_2420":3501,"_3502":6157},[6158],{"_2579":6159,"_2420":2579},"Model Context Protocol GitHub — MCP TypeScript SDK v2.0.0 Stable Release & Package Splitting",{"_950":6161,"_2571":6162},"7e4765f1-2657-42ed-a82b-bf3da8751176",[6163],{"_3499":6164,"_2420":3501,"_3502":6165},"https://github.com/fastify/fastify",[6166],{"_2579":6167,"_2420":2579},"Fastify Official Docs — Fastify v5.10.0 Release - LogController and Dynamic Logging Deprecations",{"_6151":6169,"_6122":6174,"_6114":6178,"_6014":6182,"_6042":6186,"_6080":6191,"_5986":6195,"_6072":6199,"_6002":6203,"_5978":6208,"_6088":6212,"_6022":6216,"_6130":6220,"_5994":6224,"_6096":6228,"_6143":6233,"_5971":6235,"_6030":6237,"_6064":6242},{"_6170":6171,"_6172":6173},"item:7e4765f1-2657-42ed-a82b-bf3da8751176",{"_1892":6167,"_1893":6167,"_1802":6167},"item:bf27c4ef-84b3-454c-bb0a-26f0999f4382",{"_1892":6159,"_1893":6159,"_1802":6159},{"_2571":6175},{"_1892":6176,"_1893":6177,"_1802":6125},"To secure agent operations in the stateless MCP 2.0 environment, adopting a zero-trust perspective—where even large language models are treated as untrusted entities—is critical. You must build strict integrity verification and protective barriers at the application layer to ensure that external clients or agents cannot arbitrarily manipulate intermediate transaction state data.","ステートレスへ移行したMCP 2.0環境においてエージェントのセキュリティを確保するには、大規模言語モデルでさえ信頼できない主体として定義する「ゼロトラスト」の観点が重要です。外部クライアントやエージェントがトランザクションの中間状態データを任意に操作できないよう、アプリケーションレイヤーで厳格な整合性検証と保護障壁を構築しなければなりません。",{"_2571":6179},{"_1892":6180,"_1893":6181,"_1802":6117},"Building Agent Security Infrastructure with a Zero-Trust Perspective","ゼロトラストの観点から構築するエージェントセキュリティインフラ",{"_2571":6183},{"_1892":6184,"_1893":6185,"_1802":6017},"Ultimately, unverified delegation of state information leads to 'confused deputy' attacks, where an attacker with lower privileges bypasses the system's security boundaries. Therefore, designing an encryption verification layer that guarantees the integrity and confidentiality of state values stored on the client is the core challenge of securing stateless agent architectures.","結局のところ、検証されていない状態情報の委任は、低権限の攻撃者がシステムのセキュリティ境界を回避する「代理人混同攻撃（Confused Deputy Attack）」につながります。したがって、クライアントに保存される中間状態値の整合性と機密性を確実に保証する暗号化検証レイヤーを設計することが、ステートレスなエージェントアーキテクチャのセキュリティにおける核心課題となります。",{"_2571":6187},{"_1892":6188,"_1893":6189,"_1802":6190},"Using the aes-256-gcm algorithm in the built-in Node.js crypto module generates an authentication tag for integrity verification during encryption, effectively blocking any attempts at external tampering. The following is an example of a TypeScript implementation that can be utilized immediately as a Fastify decorator or utility.","Node.js組み込みのcryptoモジュールによるaes-256-gcmアルゴリズムを使用すれば、暗号化の過程で整合性検証のための認証タグが生成されるため、外部からの改ざん試行を根本から遮断できます。Fastifyのデコレータやユーティリティとしてすぐに利用可能なTypeScriptの実装例を以下に示します。","Node.js 내장 crypto 모듈의 aes-256-gcm 알고리즘을 사용하면 암호화 과정에서 무결성 검증을 위한 인증 태그가 함께 생성되므로 외부 위변조 시도를 원천 차단할 수 있습니다. Fastify 데코레이터나 유틸리티로 즉시 활용 가능한 TypeScript 구현 예시는 다음과 같습니다.",{"_2571":6192},{"_1892":6193,"_1893":6194,"_1802":6083},"In the stateless MCP 2.0 environment, network boundary-level defense is essential to prevent token theft and reuse. To achieve this, MCP 2.0 fully adopts the OAuth 2.1 specification, introducing standard metadata for protected resources based on RFC 9728 and resource indicators based on RFC 8707. In this structure, individual MCP servers that an agent intends to call act as independent resource servers, directly controlling their own authorization boundaries.","ステートレス環境へ移行したMCP 2.0では、トークンの窃取や再利用を防ぐためにネットワーク境界レベルの防御が不可欠です。そのためにMCP 2.0はOAuth 2.1仕様を全面的に受け入れ、RFC 9728に基づく「保護リソースメタデータ」標準と、RFC 8707に基づく「リソースインジケーター」標準を導入しました。この構造において、エージェントが呼び出そうとする個々のMCPサーバーは独立したリソースサーバーの役割を果たし、権限の境界を直接管理します。",{"_2571":6196},{"_1892":6197,"_1893":6198,"_1802":5989},"Stateless MCP v2.0 Architecture and New Security Threats","ステートレスなMCP v2.0アーキテクチャと新たなセキュリティ脅威",{"_2571":6200},{"_1892":6201,"_1893":6202,"_1802":6075},"Preventing Token Reuse Based on RFC 9728 and RFC 8707 Standards","RFC 9728およびRFC 8707標準に基づくトークン再利用防止",{"_2571":6204},{"_1892":6205,"_1893":6206,"_1802":6207},"To control these multi-step transactions, a 'requestState' parameter has been introduced, allowing the server to temporarily delegate intermediate state data externally. However, clients and LLM hosts that mediate transactions are inherently untrusted environments. If this state data is transmitted in plain text, it creates a conduit for attacks where malicious clients can modify internal database identifiers or user privilege levels before sending them back to the server.","このような複数ステップのトランザクションを制御するため、サーバーが中間状態データを一時的に外部へ委ねる「requestState」パラメータが導入されました。しかし、クライアントやトランザクションを仲介するLLMホストは、本質的に信頼できない環境です。もしこの状態データを単純な平文として送信すれば、悪意のあるクライアントが内部データベースの識別子やユーザーの権限レベルを改ざんしてサーバーへ再送信する、侵入の入り口となってしまいます。","이러한 다중 단계 트랜잭션을 제어하기 위해 서버가 중간 상태 데이터를 일시적으로 외부에 위임하는 requestState 파라미터가 도입되었습니다. 그러나 클라이언트나 트랜잭션을 중개하는 LLM 호스트는 기본적으로 신뢰할 수 없는 환경입니다. 만약 이 상태 데이터를 단순한 평문 정보로 전달하면, 악의적인 클라이언트가 내부 데이터베이스 식별자나 사용자 권한 수준을 변조하여 서버로 다시 전송하는 침투 통로가 열립니다.",{"_2571":6209},{"_1892":6210,"_1893":6211,"_1802":5981},"The introduction of the Model Context Protocol (MCP) v2.0 has shifted how AI agents integrate tools toward a stateless HTTP architecture. Moving away from session-based communication allows infrastructure to scale like a standard web API, but delegating intermediate transaction state data to untrusted clients introduces vulnerabilities such as unauthorized privilege escalation or token reuse. Consequently, it is essential to implement robust encryption and integrity verification mechanisms at the backend application layer. This post outlines key patterns for controlling abnormal agent calls and enhancing integration security within Fastify and Node.js environments.","Model Context Protocol (MCP) v2.0の導入により、AIエージェントのツール連携方式はステートレスなHTTPアーキテクチャへと移行しました。従来のセッションベースの通信から脱却し、標準的なWeb APIのようにインフラをスケールさせることが可能になった一方、トランザクションの中間状態データを信頼できないクライアントに委ねることで、権限の悪用やトークンの再利用といったセキュリティ上の脆弱性が生じやすい構造にもなっています。そのため、バックエンドのアプリケーションレイヤーにおいて、これを防御する強力な暗号化および整合性検証の仕組みを備える必要があります。本記事では、FastifyとNode.js環境においてエージェントの異常な呼び出しを制御し、連携セキュリティを強化するための主要なパターンを解説します。",{"_2571":6213},{"_1892":6214,"_1893":6215,"_1802":6091},"The operational mechanism is clear. If an unauthenticated agent client attempts to access a resource, the MCP server follows the RFC 9728 standard by including a metadata link in the header and returning a 401 error, or by exposing its own metadata endpoint to announce trusted authorization server information. Subsequently, when the client requests a token from the authorization server, it must specify the unique identifier address of the target MCP server as a resource parameter in accordance with the RFC 8707 specification. The authorization server then issues a token restricted specifically to that MCP server.","動作の仕組みは明確です。認証されていないエージェントクライアントがアクセスすると、MCPサーバーはRFC 9728標準に従い、ヘッダーにメタデータリンクを含めて401エラーを返したり、独自のメタデータエンドポイントを公開して信頼できる認可サーバーの情報を通知したりします。その後、クライアントが認可サーバーへトークンを要求する際、RFC 8707仕様に基づき対象MCPサーバーの固有識別子アドレスをリソースパラメータとして明示する必要があります。認可サーバーはこのリクエストに基づいて、該当MCPサーバー専用に制限されたトークンを発行します。",{"_2571":6217},{"_1892":6218,"_1893":6219,"_1802":6025},"Guaranteeing requestState Encryption and Integrity with Node.js Crypto","Node.js CryptoベースのrequestState暗号化と整合性保証",{"_2571":6221},{"_1892":6222,"_1893":6223,"_1802":6133},"By organically combining Fastify's schema validation, the built-in Node.js crypto API, and token verification mechanisms based on RFC 9728 and RFC 8707 standards, you can safely control autonomous agents. Backend engineers must move beyond the role of providing tool APIs to becoming security boundary architects who prevent agents from malfunctioning or misusing their privileges.","Fastifyのスキーマ検証、Node.jsの内蔵暗号化API、そしてRFC 9728およびRFC 8707標準に基づくトークン検証メカニズムを有機的に組み合わせることで、自律的に動作するエージェントを安全に制御できます。バックエンドエンジニアは単にツールAPIを提供する役割を超え、エージェントが誤動作や権限の乱用を起こさないよう食い止める「セキュリティ境界の設計者」として中心的な役割を担うべきです。",{"_2571":6225},{"_1892":6226,"_1893":6227,"_1802":5997},"The most significant change in MCP v2.0 is the complete removal of connection-oriented handshakes and session identifiers, adopting stateless HTTP as the default transport protocol. This enables the backend to scale infinitely like a standard web API without needing to maintain session states. However, unlike traditional session-based communication, this creates new security vulnerabilities when handling conversational flows that require additional user input or explicit approval, such as multi-round trip requests.","MCP v2.0の最も大きな変更点は、コネクション指向のハンドシェイクとセッション識別子を完全に廃止し、ステートレスなHTTPを標準の転送プロトコルとして採用したことです。これにより、サーバーはセッションの状態を維持することなく、標準のWeb APIのようにバックエンドを柔軟かつ無限に拡張できるようになりました。しかし、従来のセッションベースの通信とは異なり、マルチラウンドトリップリクエストのように、ユーザーの追加入力や明示的な承認を必要とする会話フローを扱う際に新たなセキュリティの脆弱性が生じます。",{"_2571":6229},{"_1892":6230,"_1893":6231,"_1802":6232},"Fastify handles these standard flows efficiently and powerfully within onRequest hooks. As soon as an agent's request is received, the server executes a hook to validate the token's signature and verify that the target identifier contained in the internal 'aud' claim exactly matches its own unique address. If a token issued for a different MCP server is re-submitted or if the authorization scope is inconsistent, the request is blocked immediately to prevent confused deputy attacks.","Fastifyは、こうした標準的なフローをonRequestフックで軽量かつ強力に処理します。サーバーはエージェントからのリクエストを受け取ると直ちにフックを実行し、トークンの署名を検証します。さらに、内部のaudクレームに含まれる対象識別子が自分自身の固有アドレスと正確に一致するかを確認します。もし別のMCPサーバー宛に発行されたトークンが再利用されたり、権限の範囲が一致しなかったりした場合は、即座にリクエストを早期遮断することで、権限が悪用される代理人混同攻撃を未然に防ぎます。","Fastify는 이러한 표준 흐름을 onRequest 훅에서 가볍고 강력하게 처리합니다. 서버는 에이전트의 요청이 인입되는 즉시 훅을 실행해 토큰의 서명을 유효화하고, 내부 aud 클레임에 담긴 대상 식별자가 자신의 고유 주소와 정확히 일치하는지 검증합니다. 만약 다른 MCP 서버를 대상으로 발급된 토큰이 재입력되거나 권한 범위가 불일치할 경우, 즉시 요청을 조기 차단하여 권한이 남용되는 대리인 혼동 공격을 예방합니다.",{"_2571":6234},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":6236},{"_1892":5895,"_1893":5896,"_1802":5897},{"_2571":6238},{"_1892":6239,"_1893":6240,"_1802":6241},"In a stateless environment, the requestState parameter exposed to the outside becomes a direct conduit where agent intermediate transaction parameters or user data can be tampered with. The safest way to prevent this is to apply symmetric encryption at the application layer to ensure both data confidentiality and integrity. For multiple Fastify servers behind a load balancer to perform decryption correctly, a synchronized symmetric key must be shared in advance via environment variables.","ステートレスな環境下で外部へ露出するrequestStateパラメータは、エージェントの中間トランザクションパラメータやユーザーデータが改ざんされる直接的な経路となります。これを防ぐ最も安全な方法は、アプリケーションレイヤーで共通鍵暗号方式を適用し、データの機密性と整合性を同時に保証することです。ロードバランサー配下にある複数のFastifyサーバーが正常に復号を行うには、環境変数で同期された共通鍵を事前に共有しておく必要があります。","무상태 환경에서 외부로 노출되는 requestState 파라미터는 에이전트의 중간 트랜잭션 매개변수나 사용자 데이터가 변조될 수 있는 직접적인 통로가 됩니다. 이를 방지하는 가장 안전한 방법은 애플리케이션 레이어에서 대칭키 암호화를 적용하여 데이터의 기밀성과 무결성을 동시에 보장하는 것입니다. 로드 밸런서 하위에 있는 여러 대의 Fastify 서버가 복호화를 정상적으로 수행하려면, 환경 변수로 동기화된 대칭키가 반드시 사전에 공유되어야 합니다.",{"_2571":6243},{"_1892":6244,"_1893":6245,"_1802":6067},"Applying this encryption method makes it impossible for malicious clients or compromised LLM hosts to decrypt or directly modify internal state values. As a result, you can effectively defend against confused deputy attacks where attackers attempt to bypass flows to gain illegal privileges.","この暗号化方式を適用すれば、悪意のあるクライアントや乗っ取られたLLMホストが内部の状態値を解読したり直接修正したりすることは不可能になります。結果として、攻撃者がフローを迂回して不正な権限を獲得しようとする代理人攻撃を効果的に防御できます。","![MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴](file:cmsbsteyw07e510nvsflmmtwz)\n\n# MCP v2.0 + Fastify 보안 — 에이전트 권한 탈취를 막는 암호화 패턴\n\n모델 컨텍스트 프로토콜(MCP) v2.0의 도입으로 AI 에이전트의 도구 연동 방식이 무상태 HTTP 아키텍처로 전환되었습니다. 기존의 세션 기반 통신에서 벗어나 표준 웹 API처럼 인프라를 확장할 수 있게 되었지만, 트랜잭션의 중간 상태 데이터를 신뢰할 수 없는 클라이언트에 위임하면서 권한 남용이나 토큰 재사용 같은 보안 취약점이 발생하기 쉬운 구조가 되었습니다. 따라서 백엔드 애플리케이션 레이어에서 이를 방어하는 강력한 암호화 및 무결성 검증 체계를 갖춰야 합니다. Fastify와 Node.js 환경에서 에이전트의 비정상적 호출을 제어하고 연동 보안을 강화하는 핵심 패턴을 정리합니다.\n\n## 무상태 MCP v2.0 아키텍처와 새로운 보안 위협\n\nMCP v2.0의 가장 핵심적인 변화는 연결 지향적 핸드셰이크와 세션 식별자를 완전히 제거하고 무상태 HTTP를 기본 전송 프로토콜로 채택한 점입니다. 이를 통해 서버는 세션 상태를 유지할 필요 없이 표준 웹 API처럼 유연하게 백엔드를 무한 확장할 수 있게 되었습니다. 하지만 기존 세션 기반 통신과 달리, 다중 라운드 트립 요청처럼 추가적인 사용자 입력이나 명시적 승인이 필요한 대화형 흐름을 다룰 때 새로운 보안 취약점이 발생합니다.\n\n이러한 다중 단계 트랜잭션을 제어하기 위해 서버가 중간 상태 데이터를 일시적으로 외부에 위임하는 `requestState` 파라미터가 도입되었습니다. 그러나 클라이언트나 트랜잭션을 중개하는 LLM 호스트는 기본적으로 신뢰할 수 없는 환경입니다. 만약 이 상태 데이터를 단순한 평문 정보로 전달하면, 악의적인 클라이언트가 내부 데이터베이스 식별자나 사용자 권한 수준을 변조하여 서버로 다시 전송하는 침투 통로가 열립니다.\n\n결국 검증되지 않은 상태 정보 위임은 권한이 낮은 공격자가 시스템의 보안 경계를 우회하는 대리인 혼동 공격으로 이어집니다. 따라서 클라이언트에 저장되는 중간 상태 값의 무결성과 기밀성을 반드시 보장하는 암호화 검증 레이어를 설계하는 것이 무상태 에이전트 아키텍처 보안의 핵심 과제입니다.\n\n## Node.js Crypto 기반의 requestState 암호화 및 무결성 보장\n\n무상태 환경에서 외부로 노출되는 `requestState` 파라미터는 에이전트의 중간 트랜잭션 매개변수나 사용자 데이터가 변조될 수 있는 직접적인 통로가 됩니다. 이를 방지하는 가장 안전한 방법은 애플리케이션 레이어에서 대칭키 암호화를 적용하여 데이터의 기밀성과 무결성을 동시에 보장하는 것입니다. 로드 밸런서 하위에 있는 여러 대의 Fastify 서버가 복호화를 정상적으로 수행하려면, 환경 변수로 동기화된 대칭키가 반드시 사전에 공유되어야 합니다.\n\nNode.js 내장 `crypto` 모듈의 `aes-256-gcm` 알고리즘을 사용하면 암호화 과정에서 무결성 검증을 위한 인증 태그가 함께 생성되므로 외부 위변조 시도를 원천 차단할 수 있습니다. Fastify 데코레이터나 유틸리티로 즉시 활용 가능한 TypeScript 구현 예시는 다음과 같습니다.\n\n```typescript\nimport crypto from 'node:crypto';\n\nconst ALGORITHM = 'aes-256-gcm';\nconst KEY = Buffer.from(process.env.ENCRYPTION_KEY || '', 'hex'); // 32바이트 대칭키\n\nexport function encryptState(state: Record): string {\n const iv = crypto.randomBytes(12);\n const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);\n const encrypted = Buffer.concat([cipher.update(JSON.stringify(state), 'utf8'), cipher.final()]);\n const tag = cipher.getAuthTag();\n return `${iv.toString('hex')}:${tag.toString('hex')}:${encrypted.toString('hex')}`;\n}\n\nexport function decryptState(payload: string): Record {\n const [ivHex, tagHex, encryptedHex] = payload.split(':');\n const decipher = crypto.createDecipheriv(ALGORITHM, KEY, Buffer.from(ivHex, 'hex'));\n decipher.setAuthTag(Buffer.from(tagHex, 'hex'));\n const decrypted = Buffer.concat([decipher.update(Buffer.from(encryptedHex, 'hex')), decipher.final()]);\n return JSON.parse(decrypted.toString('utf8'));\n}\n```\n\n이 암호화 방식을 적용하면 악의적인 클라이언트나 탈취된 LLM 호스트가 내부 상태 값을 해독하거나 직접 수정하는 행위가 불가능해집니다. 결과적으로 공격자가 흐름을 우회하여 불법적인 권한을 획득하는 대리인 공격을 효과적으로 방어할 수 있습니다.\n\n## RFC 9728과 RFC 8707 표준 기반의 토큰 재사용 방지\n\n무상태 환경으로 전환된 MCP 2.0에서는 토큰 탈취 및 재사용을 방지하기 위해 네트워크 경계 수준의 방어가 필수적입니다. 이를 위해 MCP 2.0은 OAuth 2.1 명세를 전면 수용하며, RFC 9728 기반의 보호 자원 메타데이터 표준과 RFC 8707 기반의 리소스 인디케이터 표준을 도입했습니다. 이 구조에서는 에이전트가 호출하려는 개별 MCP 서버가 독립적인 리소스 서버 역할을 수행하며 권한 경계를 직접 통제합니다.\n\n동작 방식은 명확합니다. 인증되지 않은 에이전트 클라이언트가 접근하면, MCP 서버는 RFC 9728 표준에 따라 헤더에 메타데이터 링크를 담아 401 오류를 반환하거나 자체 메타데이터 엔드포인트를 노출해 신뢰하는 인가 서버 정보를 알립니다. 이후 클라이언트는 인가 서버에 토큰을 요청할 때 RFC 8707 명세에 맞춰 대상 MCP 서버의 고유 식별자 주소를 리소스 파라미터로 명시해야 합니다. 인가 서버는 이 요청을 바탕으로 해당 MCP 서버 전용으로 제한된 토큰을 발행합니다.\n\nFastify는 이러한 표준 흐름을 `onRequest` 훅에서 가볍고 강력하게 처리합니다. 서버는 에이전트의 요청이 인입되는 즉시 훅을 실행해 토큰의 서명을 유효화하고, 내부 `aud` 클레임에 담긴 대상 식별자가 자신의 고유 주소와 정확히 일치하는지 검증합니다. 만약 다른 MCP 서버를 대상으로 발급된 토큰이 재입력되거나 권한 범위가 불일치할 경우, 즉시 요청을 조기 차단하여 권한이 남용되는 대리인 혼동 공격을 예방합니다.\n\n## 제로 트러스트 관점의 에이전트 보안 인프라 구축\n\n무상태로 전환된 MCP 2.0 환경에서 에이전트 보안을 확보하려면 대규모 언어 모델조차 신뢰할 수 없는 주체로 정의하는 제로 트러스트 관점이 핵심입니다. 외부 클라이언트나 에이전트가 트랜잭션의 중간 상태 데이터를 임의로 조작할 수 없도록 애플리케이션 레이어에서 엄격한 무결성 검증과 보호 장벽을 구축해야 합니다.\n\nFastify의 스키마 검증, Node.js 내장 암호화 API, 그리고 RFC 9728 및 RFC 8707 표준 기반의 토큰 검증 메커니즘을 유기적으로 결합하면 자율적으로 동작하는 에이전트를 안전하게 통제할 수 있습니다. 백엔드 엔지니어는 단순히 도구 API를 제공하는 역할을 넘어 에이전트가 오작동하거나 권한을 오용하지 못하도록 차단하는 보안 경계 설계자로서 중심을 잡아야 합니다.\n\n---\n\n**참고 링크**\n\n- [Model Context Protocol GitHub — MCP TypeScript SDK v2.0.0 Stable Release & Package Splitting](https://github.com/modelcontextprotocol/typescript-sdk)\n- [Fastify Official Docs — Fastify v5.10.0 Release - LogController and Dynamic Logging Deprecations](https://github.com/fastify/fastify)","12bd4b347e5b75223d993b4f7020e97f9f0563dd740f40934504574e42ce6578","2026-08-02T11:47:25.081Z","2026-08-03T03:04:25.735Z",[],[],{"_950":6253,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":3769,"_2426":6254,"_1889":6262,"_2455":-5,"_2456":-5,"_2457":-5,"_9":6264,"_2450":6271,"_2458":6273,"_2460":-5,"_723":6274,"_1886":6275,"_332":6277,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":6278,"_2003":6279,"_2480":6280,"_2482":-5,"_2483":6281,"_2485":-5,"_2486":-5,"_2487":6282,"_1144":6292,"_2527":6305,"_2555":-5,"_2556":6331,"_2798":6705,"_266":6706},"cmsagxycs05xn10nvnvptd5az",{"_1801":1892,"_214":6255,"_2429":6256,"_2434":6259,"_2438":2439},4584,{"_1892":6257,"_1893":1997,"_1802":6258,"_2433":1997},2468,2116,{"_1892":6260,"_1893":1997,"_1802":6261,"_2433":1997},0.5383944153577661,0.46160558464223383,{"_9":6263,"_2445":6266,"_2450":6270},{"_1892":6264,"_1893":6265,"_1802":6264},"Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴","Fastifyエージェンティックミドルウェア — 手動実装不要のMCP v2.0バックエンドパターン",{"_1892":6267,"_1893":6268,"_1802":6269},"Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\nFastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\n모델 컨텍스트 프로토콜(MCP) v2.0 규격이 무상태 HTTP 표준을 채택하면서, AI 에이전트와 백엔드 API를 연결하는 방식이 전환되고 있습니다. 기존에는 LLM이 호출할 도구를 개발자가 매번 가공하고 복잡한 라우팅 규칙을 일일이 수작업으로 관리해야 했습니다. 하지만 현재 Fastify 생태계는 공식 어댑터와 고성능 플러그인을 활용해 상태 비저장 분산 처리와 보안 검증을 자동으로 수행하는 에이전틱 미들웨어 패턴으로 빠르게 발전하고 있습니다.\n\n공식 @modelcontextprotocol/fastify 어댑터 도입하기\n\n공식 @modelcontextprotocol/fastify 패키지는 Fastify 애플리케이션 위에서 MCP 규격을 준수하는 도구를 호스팅하기 위한 최적의 전용 어댑터입니다. 이 어댑터는 무상태 환경에서 필수적인 DNS 리바인딩 보호와 호스트 헤더 검증을 Fastify 고유의 고성능 라이프사이클 안에서 자연스럽게 처리합니다. 특히 2026년 7월에 발표된 MCP v2.0 스펙을 온전히 지원하기 위해 모놀리식 구조를 탈피하고 경량 모듈로 리팩터링되었습니다.\n\n다음은 @modelcontextprotocol/server 및 관련 패키지 v2.0.0 버전을 적용하여 구축한 고성능 무상태 MCP 서버의 구현 예시입니다.\n\nimport { createMcpFastifyApp } from '@modelcontextprotocol/fastify';\nimport { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';\nimport { McpServer } from '@modelcontextprotocol/server';\nimport { z } from 'zod';\n\nconst app = createMcpFastifyApp();\nconst mcpServer = new McpServer({\n name: 'my-agent-tools',\n version: '2.0.0',\n});\n\n// v2.0.0 규격의 registerTool API 사용\nmcpServer.registerTool(\n 'calculate',\n {\n description: '두 숫자의 사칙연산을 수행합니다.',\n inputSchema: z.object({\n a: z.number(),\n b: z.number(),\n operator: z.enum(['add', 'subtract', 'multiply', 'divide']),\n }),\n },\n async ({ a, b, operator }) => {\n let result = 0;\n if (operator === 'add') result = a + b;\n else if (operator === 'subtract') result = a - b;\n else if (operator === 'multiply') result = a * b;\n else if (operator === 'divide') result = a / b;\n\n return {\n content: [{ type: 'text', text: String(result) }],\n };\n }\n);\n\n// 무상태 HTTP 라우트 등록\napp.post('/mcp', async (request, reply) => {\n const transport = new NodeStreamableHTTPServerTransport({\n sessionIdGenerator: undefined, // 무상태 모드 활성화\n });\n\n await mcpServer.connect(transport);\n\n reply.raw.on('close', () => {\n transport.close();\n });\n\n await transport.handleRequest(request.raw, reply.raw, request.body);\n});\n\nawait app.listen({ port: 3000 });\n\n이 구조를 사용하면 복잡한 세션 유지 없이도 개별 HTTP 요청을 독립적으로 처리할 수 있어, 분산 서버 환경에서 서버 자원을 극대화하고 유연한 수평 확장이 가능해집니다.\n\n@platformatic/mcp를 활용한 엔터프라이즈급 확장성 확보\n\n단일 인스턴스 환경을 넘어 멀티테넌트 및 컨테이너 환경에서 에이전트 백엔드를 운영할 때 가장 큰 장벽은 상태 관리와 세션 유지입니다. 기존 Model Context Protocol(MCP) 구성은 단일 커넥션에 의존하는 상태 기반 연결이 많아, 다중 노드로 구성된 클라우드 환경에서 트래픽을 분산하면 세션이 유실되거나 동기화가 깨지는 치명적인 한계가 있었습니다. @platformatic/mcp 플러그인은 Fastify 프레임워크 위에서 이 아키텍처적 한계를 극복하기 위해 설계되었습니다.\n\n이 플러그인은 레디스(Redis)를 메시지 브로드캐스팅과 세션 상태 공유 백엔드로 활용합니다. 로드 밸런서 뒤에 가동 중인 백엔드 노드가 무작위로 교체되거나 수평 확장되더라도, 에이전트 클라이언트가 맺고 있는 서버 전송 이벤트(SSE) 커넥션의 세션을 지속해서 추적하고 복구할 수 있습니다. 또한, Fastify 생태계의 고성능 스키마 컴파일러인 타입박스(TypeBox)를 기본 검증 레이어로 결합하여 런타임 스키마 검증 성능을 극대화합니다.\n\n다음은 레디스를 백엔드로 결합하여 분산 인프라에서 수평 확장을 지원하는 MCP 서버의 구체적인 구현 예시입니다.\n\nimport Fastify from 'fastify';\nimport mcp from '@platformatic/mcp';\nimport { Type } from '@sinclair/typebox';\n\nconst app = Fastify();\n\nawait app.register(mcp, {\n redis: {\n host: 'localhost',\n port: 6379\n },\n enableSSE: true\n});\n\napp.mcpAddTool({\n name: 'get_user_activity',\n description: '사용자의 최근 활동 로그를 조회합니다.',\n inputSchema: Type.Object({\n userId: Type.String(),\n limit: Type.Optional(Type.Number({ default: 10 }))\n })\n}, async (params) => {\n const { userId, limit } = params;\n return {\n content: [{ type: 'text', text: `사용자 ${userId}의 최근 활동 ${limit}건을 조회했습니다.` }]\n };\n});\n\n개발자는 복잡한 분산 동기화 코드를 직접 구현할 필요 없이 선언적인 플러그인 설정만으로 분산 클러스터 전역에서 동작하는 에이전트 도구를 배포할 수 있습니다.\n\n@mcp-it/fastify로 기존 API를 AI 도구로 자동 변환\n\n기존에 공들여 작성한 수십 개의 비즈니스 API를 에이전트용 도구로 변환하는 작업은 백엔드 개발자에게 큰 부담입니다. @mcp-it/fastify 플러그인은 Fastify의 강력한 스키마 기반 라우팅 아키텍처를 그대로 활용하여 이 병목을 해결합니다. 라우트에 이미 선언된 JSON 스키마를 동적으로 분석해, LLM이 즉시 이해하고 호출할 수 있는 MCP 도구 명세로 자동 변환하기 때문입니다.\n\n추가적인 코드 중복 없이 기존 Fastify API를 AI 도구로 전환하는 방법은 다음과 같습니다.\n\nimport Fastify from 'fastify';\nimport mcpPlugin from '@mcp-it/fastify';\n\nconst app = Fastify();\n\nawait app.register(mcpPlugin, {\n name: 'Core Business API',\n description: 'AI 에이전트 연동용 핵심 비즈니스 API',\n});\n\napp.get('/users/:id', {\n schema: {\n operationId: 'get_user_by_id',\n summary: '사용자 정보 조회',\n description: 'ID 기반으로 특정 사용자의 프로필 상세 정보를 반환합니다.',\n params: {\n type: 'object',\n required: ['id'],\n properties: {\n id: { type: 'number', description: '사용자의 고유 식별자' }\n }\n }\n }\n}, async (request) => {\n const { id } = request.params as { id: number };\n return { id, name: '홍길동', email: 'user@example.com' };\n});\n\n@mcp-it/fastify는 애플리케이션의 라우트 등록 훅을 가로채 모든 경로를 자동 검색합니다. 이 과정에서 operationId가 도구의 고유 이름으로 지정되며, 기존 스키마 구조가 도구 매개변수 정의로 1대1 연동됩니다. 개발자는 동일한 유효성 검증과 비즈니스 로직을 이중으로 유지관리할 필요가 없어 에이전트 대응 비용을 드라마틱하게 낮출 수 있습니다.\n\nMastra와 Genkit 어댑터로 에이전트 오케스트레이션\n\n단순히 개별 도구를 노출하는 단계를 넘어, 복잡한 멀티 에이전트 워크플로나 프롬프트 파이프라인을 구축할 때는 마스트라(Mastra)와 구글 젠키트(Genkit) 같은 오케스트레이션 프레임워크의 전용 어댑터가 유용합니다. 과거처럼 별도의 에이전트 독립 서버를 띄워 관리 비용과 시스템 복잡도를 늘릴 필요 없이, 기존에 운영 중인 Fastify 프로세스 내에 에이전트 엔진을 직접 마운트하여 하나의 단일 서버로 고성능 비즈니스 로직과 에이전트 기능을 한 번에 운영할 수 있습니다.\n\n공식 @mastra/fastify 패키지는 마스트라 인스턴스에 등록된 모든 에이전트, 워크플로, MCP 서버 엔드포인트를 Fastify 라우터에 자동으로 바인딩해 줍니다. 특히 스트림 응답 내의 민감한 정보(시스템 프롬프트, 도구 사양, API 키 등)를 마스킹하는 필터링 옵션(streamOptions)이나 경로별 인증 정책 설정을 생성자 단계에서 선언적으로 지원하여 보안 및 프라이버시 통제가 한층 수월해집니다.\n\n// Fastify 환경에 Mastra 에이전트 통합하기 (Mastra 1.0 기준)\nimport Fastify from 'fastify';\nimport { MastraServer } from '@mastra/fastify';\nimport { mastra } from './mastra'; // 초기화된 mastra 인스턴스\n\nconst app = Fastify({ logger: true });\n\n// 어댑터를 통해 Mastra 에이전트 및 워크플로 엔드포인트를 Fastify에 마운트\nconst server = new MastraServer({ app, mastra });\nawait server.init();\n\nawait app.listen({ port: 3000 });\n\n구글이 배포한 @genkit-ai/fastify 패키지 역시 뛰어난 개발자 경험을 선사합니다. 이 패키지가 제공하는 fastifyHandler는 복잡한 입출력 스키마 검증과 스트리밍 처리를 간결하게 묶어주는 미들웨어 역할을 합니다. 클라이언트가 SSE 스트리밍을 요청할 경우 별도의 스트림 파이핑 코드 없이도 실시간 청크 전송과 CORS 헤더 복사를 자동으로 수행하므로, 프론트엔드와 실시간 대화 인터페이스를 맞물릴 때 발생하기 쉬운 통신 병목을 우아하게 해소합니다.\n\n플러그인 기반의 미래 지향적 에이전트 인프라 설계\n\n에이전트 인프라를 설계할 때 Fastify의 독보적인 플러그인 캡슐화 아키텍처는 개별 도구와 워크플로를 안전하게 격리하고 유연하게 결합하는 최적의 기반을 제공합니다. 이제는 라우팅이나 데이터 변환을 수동으로 구현하는 비효율에서 벗어나, 표준화된 어댑터와 미들웨어를 도입해 복잡한 비동기 흐름을 위임해야 할 때입니다. 검증된 생태계 도구를 통해 무상태 환경의 보안 규격을 손쉽게 충족하면서, 비즈니스 핵심 로직과 성능 최적화에 집중하는 것이 다음 단계의 에이전틱 백엔드 아키텍처가 나아가야 할 방향입니다.\n\n참고 링크\n\nGitHub / modelcontextprotocol/typescript-sdk — Official Model Context Protocol (MCP) TypeScript SDK v2.0.0 Splits Monolith and Introduces Official @modelcontextprotocol/fastify Helper\nGitHub / AdirAmsalem/mcp-it — The @mcp-it/fastify Plugin Enables Zero-Configuration MCP Tool Generation from Fastify Route Schemas\nGitHub / platformatic/mcp — Platformatic Releases Scalable Fastify Adapter @platformatic/mcp with Redis State Store Support","Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\nFastifyエージェンティックミドルウェア — 手動実装不要のMCP v2.0バックエンドパターン\n\nModel Context Protocol (MCP) v2.0仕様がステートレスなHTTP標準を採用したことで、AIエージェントとバックエンドAPIを接続する手法が転換期を迎えています。従来、開発者はLLMが呼び出すツールを毎回加工し、複雑なルーティングルールをすべて手動で管理する必要がありました。しかし、現在のFastifyエコシステムは、公式アダプターと高性能プラグインを活用し、ステートレスな分散処理とセキュリティ検証を自動化する「エージェンティックミドルウェア」パターンへと急速に進化しています。\n\n公式 @modelcontextprotocol/fastify アダプターの導入\n\n公式の @modelcontextprotocol/fastify パッケージは、Fastifyアプリケーション上でMCP仕様に準拠したツールをホストするための最適な専用アダプターです。このアダプターは、ステートレス環境で不可欠なDNSリバインディング保護やホストヘッダー検証を、Fastify独自の高性能ライフサイクルの中で自然に処理します。特に2026年7月に発表されたMCP v2.0スペックを完全サポートするため、モノリシックな構造を脱却し、軽量モジュールとしてリファクタリングされました。\n\n@modelcontextprotocol/server および関連パッケージのv2.0.0を適用して構築した、高性能ステートレスMCPサーバーの実装例です。\n\nimport { createMcpFastifyApp } from '@modelcontextprotocol/fastify';\nimport { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';\nimport { McpServer } from '@modelcontextprotocol/server';\nimport { z } from 'zod';\n\nconst app = createMcpFastifyApp();\nconst mcpServer = new McpServer({\n name: 'my-agent-tools',\n version: '2.0.0',\n});\n\n// v2.0.0 규격의 registerTool API 사용\nmcpServer.registerTool(\n 'calculate',\n {\n description: '두 숫자의 사칙연산을 수행합니다.',\n inputSchema: z.object({\n a: z.number(),\n b: z.number(),\n operator: z.enum(['add', 'subtract', 'multiply', 'divide']),\n }),\n },\n async ({ a, b, operator }) => {\n let result = 0;\n if (operator === 'add') result = a + b;\n else if (operator === 'subtract') result = a - b;\n else if (operator === 'multiply') result = a * b;\n else if (operator === 'divide') result = a / b;\n\n return {\n content: [{ type: 'text', text: String(result) }],\n };\n }\n);\n\n// 무상태 HTTP 라우트 등록\napp.post('/mcp', async (request, reply) => {\n const transport = new NodeStreamableHTTPServerTransport({\n sessionIdGenerator: undefined, // 무상태 모드 활성화\n });\n\n await mcpServer.connect(transport);\n\n reply.raw.on('close', () => {\n transport.close();\n });\n\n await transport.handleRequest(request.raw, reply.raw, request.body);\n});\n\nawait app.listen({ port: 3000 });\n\nこの構成により、複雑なセッション維持なしで個々のHTTPリクエストを独立して処理できるため、分散サーバー環境においてリソースを最大限に活用し、柔軟な水平スケーリングが可能になります。\n\n@platformatic/mcp を活用したエンタープライズ級のスケーラビリティ確保\n\n単一インスタンス環境を超え、マルチテナントやコンテナ環境でエージェントバックエンドを運用する際の最大の障壁は、状態管理とセッション維持です。従来のModel Context Protocol (MCP) 構成は単一接続に依存するステートフルな接続が多いため、マルチノード構成のクラウド環境でトラフィックを分散させると、セッションの消失や同期ズレが発生するという致命的な限界がありました。@platformatic/mcp プラグインは、Fastifyフレームワーク上でこのアーキテクチャの限界を克服するために設計されました。\n\nこのプラグインはRedisをメッセージブロードキャストおよびセッション状態共有のバックエンドとして活用します。ロードバランサー配下でバックエンドノードが動的に入れ替わったり水平スケーリングしたりしても、エージェントクライアントが確立しているServer-Sent Events (SSE) 接続のセッションを継続的に追跡・復旧できます。さらに、Fastifyエコシステムの高性能スキーマコンパイラであるTypeBoxを検証レイヤーとして組み込み、ランタイムでのスキーマ検証性能を極限まで高めています。\n\n以下はRedisをバックエンドに統合し、分散インフラでの水平スケーリングをサポートするMCPサーバーの具体的な実装例です。\n\nimport Fastify from 'fastify';\nimport mcp from '@platformatic/mcp';\nimport { Type } from '@sinclair/typebox';\n\nconst app = Fastify();\n\nawait app.register(mcp, {\n redis: {\n host: 'localhost',\n port: 6379\n },\n enableSSE: true\n});\n\napp.mcpAddTool({\n name: 'get_user_activity',\n description: '사용자의 최근 활동 로그를 조회합니다.',\n inputSchema: Type.Object({\n userId: Type.String(),\n limit: Type.Optional(Type.Number({ default: 10 }))\n })\n}, async (params) => {\n const { userId, limit } = params;\n return {\n content: [{ type: 'text', text: `사용자 ${userId}의 최근 활동 ${limit}건을 조회했습니다.` }]\n };\n});\n\n開発者は複雑な分散同期コードを自前で実装することなく、宣言的なプラグイン設定だけで分散クラスタ全体で動作するエージェントツールをデプロイできます。\n\n@mcp-it/fastify による既存APIのAIツール自動変換\n\n既存のビジネスAPIをエージェント用ツールに変換する作業は、バックエンド開発者にとって大きな負担です。@mcp-it/fastify プラグインは、Fastifyの強力なスキーマベースのルーティングアーキテクチャを活用することで、このボトルネックを解消します。ルートに宣言済みのJSONスキーマを動的に解析し、LLMが即座に理解・呼び出し可能なMCPツール仕様へと自動変換するためです。\n\nコードの重複なしに既存のFastify APIをAIツールへ変換する方法は以下の通りです。\n\nimport Fastify from 'fastify';\nimport mcpPlugin from '@mcp-it/fastify';\n\nconst app = Fastify();\n\nawait app.register(mcpPlugin, {\n name: 'Core Business API',\n description: 'AI 에이전트 연동용 핵심 비즈니스 API',\n});\n\napp.get('/users/:id', {\n schema: {\n operationId: 'get_user_by_id',\n summary: '사용자 정보 조회',\n description: 'ID 기반으로 특정 사용자의 프로필 상세 정보를 반환합니다.',\n params: {\n type: 'object',\n required: ['id'],\n properties: {\n id: { type: 'number', description: '사용자의 고유 식별자' }\n }\n }\n }\n}, async (request) => {\n const { id } = request.params as { id: number };\n return { id, name: '홍길동', email: 'user@example.com' };\n});\n\n@mcp-it/fastify はアプリケーションのルート登録フックを傍受し、すべてのパスを自動的に探索します。この過程でoperationIdがツール固有の名前として指定され、既存のスキーマ構造がツール引数の定義と1対1で連携されます。開発者は同一の検証ロジックやビジネスロジックを二重に保守する必要がなくなり、エージェント対応コストを大幅に削減可能です。\n\nMastraとGenkitアダプターによるエージェントオーケストレーション\n\n単なる個別のツール公開を超え、複雑なマルチエージェントワークフローやプロンプトパイプラインを構築する場合、MastraやGoogle Genkitのようなオーケストレーションフレームワーク専用のアダプターが役立ちます。過去のように独立したエージェントサーバーを立ち上げて運用コストやシステム複雑性を高める必要はなく、既存のFastifyプロセス内にエージェントエンジンを直接マウントし、単一のサーバーで高性能なビジネスロジックとエージェント機能を同時に運用できます。\n\n公式の @mastra/fastify パッケージは、Mastraインスタンスに登録されたすべてのアージェント、ワークフロー、MCPサーバーエンドポイントをFastifyルーターに自動バインディングします。特にストリーム応答内の機密情報（システムプロンプト、ツール仕様、APIキーなど）をマスクするフィルタリングオプション (streamOptions) や、パスごとの認証ポリシー設定をコンストラクタ段階で宣言的にサポートしており、セキュリティおよびプライバシー制御が容易になります。\n\n// Fastify 환경에 Mastra 에이전트 통합하기 (Mastra 1.0 기준)\nimport Fastify from 'fastify';\nimport { MastraServer } from '@mastra/fastify';\nimport { mastra } from './mastra'; // 초기화된 mastra 인스턴스\n\nconst app = Fastify({ logger: true });\n\n// 어댑터를 통해 Mastra 에이전트 및 워크플로 엔드포인트를 Fastify에 마운트\nconst server = new MastraServer({ app, mastra });\nawait server.init();\n\nawait app.listen({ port: 3000 });\n\nGoogleが提供する @genkit-ai/fastify パッケージも優れた開発者体験を提供します。このパッケージが提供する fastifyHandler は、複雑な入出力スキーマ検証とストリーミング処理を簡潔にまとめるミドルウェアとして機能します。クライアントがSSEストリーミングをリクエストした場合、ストリームパイピングコードを別途書かなくともリアルタイムのチャンク転送とCORSヘッダーのコピーが自動で行われるため、フロントエンドとのリアルタイム対話インターフェース実装時に発生しがちな通信ボトルネックをスムーズに解消できます。\n\nプラグインベースの未来志向型エージェントインフラ設計\n\nエージェントインフラを設計する際、Fastify特有のプラグインカプセル化アーキテクチャは、個別のツールやワークフローを安全に分離し、柔軟に統合するための最適な基盤となります。ルーティングやデータ変換を手動で実装する非効率性から脱却し、標準化されたアダプターやミドルウェアを導入して複雑な非同期フローを委任すべき時です。検証済みのエコシステムツールを活用し、ステートレス環境でのセキュリティ要件を容易に満たしつつ、ビジネスのコアロジックとパフォーマンスの最適化に注力することこそが、次世代エージェントバックエンドアーキテクチャの進むべき方向です。\n\n参考リンク\n\nGitHub / modelcontextprotocol/typescript-sdk — 公式 Model Context Protocol (MCP) TypeScript SDK v2.0.0：モノリスの分割と公式 @modelcontextprotocol/fastify ヘルパーの導入\nGitHub / AdirAmsalem/mcp-it — @mcp-it/fastify プラグイン：Fastifyルートスキーマからゼロ設定でMCPツールを生成\nGitHub / platformatic/mcp — PlatformaticがスケーラブルなFastifyアダプター @platformatic/mcp をリリース（Redis状態ストアをサポート）","Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\nFastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\n모델 컨텍스트 프로토콜(MCP) v2.0 규격이 무상태 HTTP 표준을 채택하면서, AI 에이전트와 백엔드 API를 연결하는 방식이 전환되고 있습니다. 기존에는 LLM이 호출할 도구를 개발자가 매번 가공하고 복잡한 라우팅 규칙을 일일이 수작업으로 관리해야 했습니다. 하지만 현재 Fastify 생태계는 공식 어댑터와 고성능 플러그인을 활용해 상태 비저장 분산 처리와 보안 검증을 자동으로 수행하는 에이전틱 미들웨어 패턴으로 빠르게 발전하고 있습니다.\n\n공식 @modelcontextprotocol/fastify 어댑터 도입하기\n\n공식 @modelcontextprotocol/fastify 패키지는 Fastify 애플리케이션 위에서 MCP 규격을 준수하는 도구를 호스팅하기 위한 최적의 전용 어댑터입니다. 이 어댑터는 무상태 환경에서 필수적인 DNS 리바인딩 보호와 호스트 헤더 검증을 Fastify 고유의 고성능 라이프사이클 안에서 자연스럽게 처리합니다. 특히 2026년 7월에 발표된 MCP v2.0 스펙을 온전히 지원하기 위해 모놀리식 구조를 탈피하고 경량 모듈로 리팩터링되었습니다.\n\n다음은 @modelcontextprotocol/server 및 관련 패키지 v2.0.0 버전을 적용하여 구축한 고성능 무상태 MCP 서버의 구현 예시입니다.\n\nimport { createMcpFastifyApp } from '@modelcontextprotocol/fastify';\nimport { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';\nimport { McpServer } from '@modelcontextprotocol/server';\nimport { z } from 'zod';\n\nconst app = createMcpFastifyApp();\nconst mcpServer = new McpServer({\n name: 'my-agent-tools',\n version: '2.0.0',\n});\n\n// v2.0.0 규격의 registerTool API 사용\nmcpServer.registerTool(\n 'calculate',\n {\n description: '두 숫자의 사칙연산을 수행합니다.',\n inputSchema: z.object({\n a: z.number(),\n b: z.number(),\n operator: z.enum(['add', 'subtract', 'multiply', 'divide']),\n }),\n },\n async ({ a, b, operator }) => {\n let result = 0;\n if (operator === 'add') result = a + b;\n else if (operator === 'subtract') result = a - b;\n else if (operator === 'multiply') result = a * b;\n else if (operator === 'divide') result = a / b;\n\n return {\n content: [{ type: 'text', text: String(result) }],\n };\n }\n);\n\n// 무상태 HTTP 라우트 등록\napp.post('/mcp', async (request, reply) => {\n const transport = new NodeStreamableHTTPServerTransport({\n sessionIdGenerator: undefined, // 무상태 모드 활성화\n });\n\n await mcpServer.connect(transport);\n\n reply.raw.on('close', () => {\n transport.close();\n });\n\n await transport.handleRequest(request.raw, reply.raw, request.body);\n});\n\nawait app.listen({ port: 3000 });\n\n이 구조를 사용하면 복잡한 세션 유지 없이도 개별 HTTP 요청을 독립적으로 처리할 수 있어, 분산 서버 환경에서 서버 자원을 극대화하고 유연한 수평 확장이 가능해집니다.\n\n@platformatic/mcp를 활용한 엔터프라이즈급 확장성 확보\n\n단일 인스턴스 환경을 넘어 멀티테넌트 및 컨테이너 환경에서 에이전트 백엔드를 운영할 때 가장 큰 장벽은 상태 관리와 세션 유지입니다. 기존 Model Context Protocol(MCP) 구성은 단일 커넥션에 의존하는 상태 기반 연결이 많아, 다중 노드로 구성된 클라우드 환경에서 트래픽을 분산하면 세션이 유실되거나 동기화가 깨지는 치명적인 한계가 있었습니다. @platformatic/mcp 플러그인은 Fastify 프레임워크 위에서 이 아키텍처적 한계를 극복하기 위해 설계되었습니다.\n\n이 플러그인은 레디스(Redis)를 메시지 브로드캐스팅과 세션 상태 공유 백엔드로 활용합니다. 로드 밸런서 뒤에 가동 중인 백엔드 노드가 무작위로 교체되거나 수평 확장되더라도, 에이전트 클라이언트가 맺고 있는 서버 전송 이벤트(SSE) 커넥션의 세션을 지속해서 추적하고 복구할 수 있습니다. 또한, Fastify 생태계의 고성능 스키마 컴파일러인 타입박스(TypeBox)를 기본 검증 레이어로 결합하여 런타임 스키마 검증 성능을 극대화합니다.\n\n다음은 레디스를 백엔드로 결합하여 분산 인프라에서 수평 확장을 지원하는 MCP 서버의 구체적인 구현 예시입니다.\n\nimport Fastify from 'fastify';\nimport mcp from '@platformatic/mcp';\nimport { Type } from '@sinclair/typebox';\n\nconst app = Fastify();\n\nawait app.register(mcp, {\n redis: {\n host: 'localhost',\n port: 6379\n },\n enableSSE: true\n});\n\napp.mcpAddTool({\n name: 'get_user_activity',\n description: '사용자의 최근 활동 로그를 조회합니다.',\n inputSchema: Type.Object({\n userId: Type.String(),\n limit: Type.Optional(Type.Number({ default: 10 }))\n })\n}, async (params) => {\n const { userId, limit } = params;\n return {\n content: [{ type: 'text', text: `사용자 ${userId}의 최근 활동 ${limit}건을 조회했습니다.` }]\n };\n});\n\n개발자는 복잡한 분산 동기화 코드를 직접 구현할 필요 없이 선언적인 플러그인 설정만으로 분산 클러스터 전역에서 동작하는 에이전트 도구를 배포할 수 있습니다.\n\n@mcp-it/fastify로 기존 API를 AI 도구로 자동 변환\n\n기존에 공들여 작성한 수십 개의 비즈니스 API를 에이전트용 도구로 변환하는 작업은 백엔드 개발자에게 큰 부담입니다. @mcp-it/fastify 플러그인은 Fastify의 강력한 스키마 기반 라우팅 아키텍처를 그대로 활용하여 이 병목을 해결합니다. 라우트에 이미 선언된 JSON 스키마를 동적으로 분석해, LLM이 즉시 이해하고 호출할 수 있는 MCP 도구 명세로 자동 변환하기 때문입니다.\n\n추가적인 코드 중복 없이 기존 Fastify API를 AI 도구로 전환하는 방법은 다음과 같습니다.\n\nimport Fastify from 'fastify';\nimport mcpPlugin from '@mcp-it/fastify';\n\nconst app = Fastify();\n\nawait app.register(mcpPlugin, {\n name: 'Core Business API',\n description: 'AI 에이전트 연동용 핵심 비즈니스 API',\n});\n\napp.get('/users/:id', {\n schema: {\n operationId: 'get_user_by_id',\n summary: '사용자 정보 조회',\n description: 'ID 기반으로 특정 사용자의 프로필 상세 정보를 반환합니다.',\n params: {\n type: 'object',\n required: ['id'],\n properties: {\n id: { type: 'number', description: '사용자의 고유 식별자' }\n }\n }\n }\n}, async (request) => {\n const { id } = request.params as { id: number };\n return { id, name: '홍길동', email: 'user@example.com' };\n});\n\n@mcp-it/fastify는 애플리케이션의 라우트 등록 훅을 가로채 모든 경로를 자동 검색합니다. 이 과정에서 operationId가 도구의 고유 이름으로 지정되며, 기존 스키마 구조가 도구 매개변수 정의로 1대1 연동됩니다. 개발자는 동일한 유효성 검증과 비즈니스 로직을 이중으로 유지관리할 필요가 없어 에이전트 대응 비용을 드라마틱하게 낮출 수 있습니다.\n\nMastra와 Genkit 어댑터로 에이전트 오케스트레이션\n\n단순히 개별 도구를 노출하는 단계를 넘어, 복잡한 멀티 에이전트 워크플로나 프롬프트 파이프라인을 구축할 때는 마스트라(Mastra)와 구글 젠키트(Genkit) 같은 오케스트레이션 프레임워크의 전용 어댑터가 유용합니다. 과거처럼 별도의 에이전트 독립 서버를 띄워 관리 비용과 시스템 복잡도를 늘릴 필요 없이, 기존에 운영 중인 Fastify 프로세스 내에 에이전트 엔진을 직접 마운트하여 하나의 단일 서버로 고성능 비즈니스 로직과 에이전트 기능을 한 번에 운영할 수 있습니다.\n\n공식 @mastra/fastify 패키지는 마스트라 인스턴스에 등록된 모든 에이전트, 워크플로, MCP 서버 엔드포인트를 Fastify 라우터에 자동으로 바인딩해 줍니다. 특히 스트림 응답 내의 민감한 정보(시스템 프롬프트, 도구 사양, API 키 등)를 마스킹하는 필터링 옵션(streamOptions)이나 경로별 인증 정책 설정을 생성자 단계에서 선언적으로 지원하여 보안 및 프라이버시 통제가 한층 수월해집니다.\n\n// Fastify 환경에 Mastra 에이전트 통합하기 (Mastra 1.0 기준)\nimport Fastify from 'fastify';\nimport { MastraServer } from '@mastra/fastify';\nimport { mastra } from './mastra'; // 초기화된 mastra 인스턴스\n\nconst app = Fastify({ logger: true });\n\n// 어댑터를 통해 Mastra 에이전트 및 워크플로 엔드포인트를 Fastify에 마운트\nconst server = new MastraServer({ app, mastra });\nawait server.init();\n\nawait app.listen({ port: 3000 });\n\n구글이 배포한 @genkit-ai/fastify 패키지 역시 뛰어난 개발자 경험을 선사합니다. 이 패키지가 제공하는 fastifyHandler는 복잡한 입출력 스키마 검증과 스트리밍 처리를 간결하게 묶어주는 미들웨어 역할을 합니다. 클라이언트가 SSE 스트리밍을 요청할 경우 별도의 스트림 파이핑 코드 없이도 실시간 청크 전송과 CORS 헤더 복사를 자동으로 수행하므로, 프론트엔드와 실시간 대화 인터페이스를 맞물릴 때 발생하기 쉬운 통신 병목을 우아하게 해소합니다.\n\n플러그인 기반의 미래 지향적 에이전트 인프라 설계\n\n에이전트 인프라를 설계할 때 Fastify의 독보적인 플러그인 캡슐화 아키텍처는 개별 도구와 워크플로를 안전하게 격리하고 유연하게 결합하는 최적의 기반을 제공합니다. 이제는 라우팅이나 데이터 변환을 수동으로 구현하는 비효율에서 벗어나, 표준화된 어댑터와 미들웨어를 도입해 복잡한 비동기 흐름을 위임해야 할 때입니다. 검증된 생태계 도구를 통해 무상태 환경의 보안 규격을 손쉽게 충족하면서, 비즈니스 핵심 로직과 성능 최적화에 집중하는 것이 다음 단계의 에이전틱 백엔드 아키텍처가 나아가야 할 방향입니다.\n\n참고 링크\n\nGitHub / modelcontextprotocol/typescript-sdk — 공식 Model Context Protocol (MCP) TypeScript SDK v2.0.0, 모놀리식 구조 분리 및 공식 @modelcontextprotocol/fastify 헬퍼 도입\nGitHub / AdirAmsalem/mcp-it — Fastify 라우트 스키마로부터 무설정 MCP 도구 생성을 지원하는 @mcp-it/fastify 플러그인\nGitHub / platformatic/mcp — Redis 상태 저장소 지원을 포함한 확장 가능한 Fastify 어댑터 @platformatic/mcp 출시",{"_1892":6271,"_1893":6272,"_1802":6271},"Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴 모델 컨텍스트 프로토콜(MCP) v2.0 규격이 무상태 HTTP 표준을 채택하면서, AI 에이전트와 백엔드 API를 연결하는 방식이 전환되고 있습니다. 기존에는 LLM이 호출할 도구를 개발자가 매번 가공하고 복잡한 라우팅 규칙을 일일이 수작업으로 관리해야 했습니다. 하지만 현재 Fastify 생태계는 공식 어댑터…","Fastifyエージェンティックミドルウェア — 手動実装不要のMCP v2.0バックエンドパターン Model Context Protocol (MCP) v2.0仕様がステートレスなHTTP標準を採用したことで、AIエージェントとバックエンドAPIを接続する手法が転換期を迎えています。従来、開発者はLLMが呼び出すツールを毎回加工し、複雑なルーティングルールをすべて手動で管理する必要がありました。しかし、現在のFastifyエコシ…","cmsaiyaol05za10nvp741bzws",[3122],[3124,3792,4943,3126,3125,6276],"ai-sdk",[],"2026-08-02T07:31:34.706Z","2026-08-01T14:30:35.308Z","2026-08-02T13:50:50.324Z","2026-08-02T07:32:20.004Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":6283},{"_1901":6284},{"_1903":6285,"_1908":1909,"_1910":6286,"_1921":6287,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":6288,"_1928":6289,"_1933":6290,"_1938":6291},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":6293,"_1883":1884,"_1200":1204,"_1899":6296},{"_633":6294,"_11":6295},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":6297},{"_1903":6298,"_1908":1909,"_1910":6299,"_1921":6300,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":6301,"_1928":6302,"_1933":6303,"_1938":6304},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":6306},{"_1948":-5,"_1908":1909,"_1910":6307,"_1960":-5,"_1943":6314,"_1962":6315},{"_1912":6308,"_1914":6309,"_1952":6310,"_1810":6311,"_944":1992,"_1917":6312,"_1957":2536,"_1919":6313},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/db4a0c28-8eb6-428e-9f49-50d431632e35.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/db4a0c28-8eb6-428e-9f49-50d431632e35.jpg",480819,1408,"L25iW^.RI+%$x_yDx]Ri00sr-?IA","#183868","2026-08-01T15:26:51.071Z",{"_1964":6316,"_1972":6321,"_1979":6326,"_1986":-5},{"_1912":6317,"_1914":6318,"_1952":6319,"_1810":1969,"_944":6320,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/large.webp",35678,655,{"_1912":6322,"_1914":6323,"_1952":6324,"_1810":1977,"_944":6325,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/small.webp",8870,196,{"_1912":6327,"_1914":6328,"_1952":6329,"_1810":1984,"_944":6330,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmsaiyaol05za10nvp741bzws/medium.webp",20280,393,{"_950":6332,"_2559":6253,"_2560":6333,"_2716":6616,"_2788":6701,"_2790":6702,"_2792":4226,"_2794":1997,"_2003":6703,"_2480":6704,"_2797":-5},"cmsagxycw05xo10nvfx2aw8a2",{"_918":6334,"_1908":1909},[6335,6337,6340,6344,6347,6352,6355,6360,6363,6373,6376,6386,6389,6392,6395,6400,6403,6408,6411,6421,6424,6429,6432,6437,6440,6443,6446,6451,6454,6459,6462,6472,6475,6480,6483,6486,6489,6501,6504,6509,6512,6517,6520,6534,6537,6540,6543,6558,6561,6566,6569,6574,6577,6579,6582,6587,6590],{"_950":6336,"_2565":6264,"_2420":2566,"_2567":6273},"593a6cad-c691-45ad-ade0-f2b26f63983e",{"_950":6338,"_2420":2570,"_2571":6339},"50207587-5cbd-44b3-9f06-e8eb7fa659e9",[],{"_950":6341,"_2420":2575,"_2576":1909,"_2571":6342},"d3a92763-b181-4015-95aa-6e24924d2a58",[6343],{"_2579":6264,"_2420":2579},{"_950":6345,"_2420":2570,"_2571":6346},"953e6e10-f594-4139-b600-96f2fdd766a2",[],{"_950":6348,"_2420":2570,"_2571":6349},"fd9e0dd7-99b2-4729-931e-e75f12dc0407",[6350],{"_2579":6351,"_2420":2579},"모델 컨텍스트 프로토콜(MCP) v2.0 규격이 무상태 HTTP 표준을 채택하면서, AI 에이전트와 백엔드 API를 연결하는 방식이 전환되고 있습니다. 기존에는 LLM이 호출할 도구를 개발자가 매번 가공하고 복잡한 라우팅 규칙을 일일이 수작업으로 관리해야 했습니다. 하지만 현재 Fastify 생태계는 공식 어댑터와 고성능 플러그인을 활용해 상태 비저장 분산 처리와 보안 검증을 자동으로 수행하는 에이전틱 미들웨어 패턴으로 빠르게 발전하고 있습니다.",{"_950":6353,"_2420":2570,"_2571":6354},"712b519e-25e7-49b5-92dd-2befdc55e133",[],{"_950":6356,"_2420":2575,"_2576":2007,"_2571":6357},"64733608-e8d8-4f37-ac9f-7868eb5001d4",[6358],{"_2579":6359,"_2420":2579},"공식 @modelcontextprotocol/fastify 어댑터 도입하기",{"_950":6361,"_2420":2570,"_2571":6362},"e9bba558-7136-4fba-be5f-8bc23472775f",[],{"_950":6364,"_2420":2570,"_2571":6365},"ae10454e-ea48-4625-be24-1058fa54adbe",[6366,6368,6371],{"_2579":6367,"_2420":2579},"공식 ",{"_2579":6369,"_2420":2579,"_3365":6370},"@modelcontextprotocol/fastify",{"_3351":3367},{"_2579":6372,"_2420":2579}," 패키지는 Fastify 애플리케이션 위에서 MCP 규격을 준수하는 도구를 호스팅하기 위한 최적의 전용 어댑터입니다. 이 어댑터는 무상태 환경에서 필수적인 DNS 리바인딩 보호와 호스트 헤더 검증을 Fastify 고유의 고성능 라이프사이클 안에서 자연스럽게 처리합니다. 특히 2026년 7월에 발표된 MCP v2.0 스펙을 온전히 지원하기 위해 모놀리식 구조를 탈피하고 경량 모듈로 리팩터링되었습니다.",{"_950":6374,"_2420":2570,"_2571":6375},"ff813614-bb5f-4a66-9211-2a76c14b9902",[],{"_950":6377,"_2420":2570,"_2571":6378},"8f0a9d41-4f14-4004-9622-5993860adfb3",[6379,6381,6384],{"_2579":6380,"_2420":2579},"다음은 ",{"_2579":6382,"_2420":2579,"_3365":6383},"@modelcontextprotocol/server",{"_3351":3367},{"_2579":6385,"_2420":2579}," 및 관련 패키지 v2.0.0 버전을 적용하여 구축한 고성능 무상태 MCP 서버의 구현 예시입니다.",{"_950":6387,"_2420":2570,"_2571":6388},"c411c644-e022-4fdd-ade7-420be80bff77",[],{"_950":6390,"_3351":6391,"_2420":3351,"_625":3125},"c954b6b2-7fd1-4ed2-a73f-08dd15bf7cb6","import { createMcpFastifyApp } from '@modelcontextprotocol/fastify';\nimport { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';\nimport { McpServer } from '@modelcontextprotocol/server';\nimport { z } from 'zod';\n\nconst app = createMcpFastifyApp();\nconst mcpServer = new McpServer({\n name: 'my-agent-tools',\n version: '2.0.0',\n});\n\n// v2.0.0 규격의 registerTool API 사용\nmcpServer.registerTool(\n 'calculate',\n {\n description: '두 숫자의 사칙연산을 수행합니다.',\n inputSchema: z.object({\n a: z.number(),\n b: z.number(),\n operator: z.enum(['add', 'subtract', 'multiply', 'divide']),\n }),\n },\n async ({ a, b, operator }) => {\n let result = 0;\n if (operator === 'add') result = a + b;\n else if (operator === 'subtract') result = a - b;\n else if (operator === 'multiply') result = a * b;\n else if (operator === 'divide') result = a / b;\n\n return {\n content: [{ type: 'text', text: String(result) }],\n };\n }\n);\n\n// 무상태 HTTP 라우트 등록\napp.post('/mcp', async (request, reply) => {\n const transport = new NodeStreamableHTTPServerTransport({\n sessionIdGenerator: undefined, // 무상태 모드 활성화\n });\n\n await mcpServer.connect(transport);\n\n reply.raw.on('close', () => {\n transport.close();\n });\n\n await transport.handleRequest(request.raw, reply.raw, request.body);\n});\n\nawait app.listen({ port: 3000 });",{"_950":6393,"_2420":2570,"_2571":6394},"316528a8-a9d6-4505-84c1-b1f616687d2c",[],{"_950":6396,"_2420":2570,"_2571":6397},"2f8e0c9b-14b8-4383-acdc-bc14bb909d6b",[6398],{"_2579":6399,"_2420":2579},"이 구조를 사용하면 복잡한 세션 유지 없이도 개별 HTTP 요청을 독립적으로 처리할 수 있어, 분산 서버 환경에서 서버 자원을 극대화하고 유연한 수평 확장이 가능해집니다.",{"_950":6401,"_2420":2570,"_2571":6402},"6deb05ce-83fa-4332-9ba4-c862168e1801",[],{"_950":6404,"_2420":2575,"_2576":2007,"_2571":6405},"6ae401e7-3b02-4f5d-b9aa-0505085af9e7",[6406],{"_2579":6407,"_2420":2579},"@platformatic/mcp를 활용한 엔터프라이즈급 확장성 확보",{"_950":6409,"_2420":2570,"_2571":6410},"177f99e2-a7ff-464f-a049-02ef3a871e7c",[],{"_950":6412,"_2420":2570,"_2571":6413},"a9b6cee1-3fb3-461e-b77f-8bc7a6a92fa1",[6414,6416,6419],{"_2579":6415,"_2420":2579},"단일 인스턴스 환경을 넘어 멀티테넌트 및 컨테이너 환경에서 에이전트 백엔드를 운영할 때 가장 큰 장벽은 상태 관리와 세션 유지입니다. 기존 Model Context Protocol(MCP) 구성은 단일 커넥션에 의존하는 상태 기반 연결이 많아, 다중 노드로 구성된 클라우드 환경에서 트래픽을 분산하면 세션이 유실되거나 동기화가 깨지는 치명적인 한계가 있었습니다. ",{"_2579":6417,"_2420":2579,"_3365":6418},"@platformatic/mcp",{"_3351":3367},{"_2579":6420,"_2420":2579}," 플러그인은 Fastify 프레임워크 위에서 이 아키텍처적 한계를 극복하기 위해 설계되었습니다.",{"_950":6422,"_2420":2570,"_2571":6423},"1023c274-9118-4b9d-9bea-dd5bf5583935",[],{"_950":6425,"_2420":2570,"_2571":6426},"50f9ecdf-993e-4602-9e71-4c41f289a607",[6427],{"_2579":6428,"_2420":2579},"이 플러그인은 레디스(Redis)를 메시지 브로드캐스팅과 세션 상태 공유 백엔드로 활용합니다. 로드 밸런서 뒤에 가동 중인 백엔드 노드가 무작위로 교체되거나 수평 확장되더라도, 에이전트 클라이언트가 맺고 있는 서버 전송 이벤트(SSE) 커넥션의 세션을 지속해서 추적하고 복구할 수 있습니다. 또한, Fastify 생태계의 고성능 스키마 컴파일러인 타입박스(TypeBox)를 기본 검증 레이어로 결합하여 런타임 스키마 검증 성능을 극대화합니다.",{"_950":6430,"_2420":2570,"_2571":6431},"b9cf6a4a-4757-41cf-bbd2-bdb84ae22f11",[],{"_950":6433,"_2420":2570,"_2571":6434},"9ae39d89-02a4-4dc0-9b8f-bd0fc75a8c49",[6435],{"_2579":6436,"_2420":2579},"다음은 레디스를 백엔드로 결합하여 분산 인프라에서 수평 확장을 지원하는 MCP 서버의 구체적인 구현 예시입니다.",{"_950":6438,"_2420":2570,"_2571":6439},"62e16b23-bad2-41c5-b444-85a03eb3dced",[],{"_950":6441,"_3351":6442,"_2420":3351,"_625":3125},"b5e18346-bcd2-4108-880d-febafaf77623","import Fastify from 'fastify';\nimport mcp from '@platformatic/mcp';\nimport { Type } from '@sinclair/typebox';\n\nconst app = Fastify();\n\nawait app.register(mcp, {\n redis: {\n host: 'localhost',\n port: 6379\n },\n enableSSE: true\n});\n\napp.mcpAddTool({\n name: 'get_user_activity',\n description: '사용자의 최근 활동 로그를 조회합니다.',\n inputSchema: Type.Object({\n userId: Type.String(),\n limit: Type.Optional(Type.Number({ default: 10 }))\n })\n}, async (params) => {\n const { userId, limit } = params;\n return {\n content: [{ type: 'text', text: `사용자 ${userId}의 최근 활동 ${limit}건을 조회했습니다.` }]\n };\n});",{"_950":6444,"_2420":2570,"_2571":6445},"61b054d9-986a-4cea-925f-09a4417282fb",[],{"_950":6447,"_2420":2570,"_2571":6448},"929b13c2-bdad-48d6-9c08-8e798993f0cf",[6449],{"_2579":6450,"_2420":2579},"개발자는 복잡한 분산 동기화 코드를 직접 구현할 필요 없이 선언적인 플러그인 설정만으로 분산 클러스터 전역에서 동작하는 에이전트 도구를 배포할 수 있습니다.",{"_950":6452,"_2420":2570,"_2571":6453},"edf83c40-d1c3-4bfe-8be9-f9aff6d37645",[],{"_950":6455,"_2420":2575,"_2576":2007,"_2571":6456},"28a75812-90ac-4679-8be9-80845ec6c52a",[6457],{"_2579":6458,"_2420":2579},"@mcp-it/fastify로 기존 API를 AI 도구로 자동 변환",{"_950":6460,"_2420":2570,"_2571":6461},"12065da4-3a78-4e1e-81f9-bda997f846b0",[],{"_950":6463,"_2420":2570,"_2571":6464},"44eff14d-9b95-4705-bd37-03c490e7805e",[6465,6467,6470],{"_2579":6466,"_2420":2579},"기존에 공들여 작성한 수십 개의 비즈니스 API를 에이전트용 도구로 변환하는 작업은 백엔드 개발자에게 큰 부담입니다. ",{"_2579":6468,"_2420":2579,"_3365":6469},"@mcp-it/fastify",{"_3351":3367},{"_2579":6471,"_2420":2579}," 플러그인은 Fastify의 강력한 스키마 기반 라우팅 아키텍처를 그대로 활용하여 이 병목을 해결합니다. 라우트에 이미 선언된 JSON 스키마를 동적으로 분석해, LLM이 즉시 이해하고 호출할 수 있는 MCP 도구 명세로 자동 변환하기 때문입니다.",{"_950":6473,"_2420":2570,"_2571":6474},"db6deddc-bf1b-4498-afc4-578d9f10923b",[],{"_950":6476,"_2420":2570,"_2571":6477},"f280affc-dfaf-4b42-9f9e-078f60f8c0fc",[6478],{"_2579":6479,"_2420":2579},"추가적인 코드 중복 없이 기존 Fastify API를 AI 도구로 전환하는 방법은 다음과 같습니다.",{"_950":6481,"_2420":2570,"_2571":6482},"f9612879-eb54-4ab3-b4f9-cb896a97a27d",[],{"_950":6484,"_3351":6485,"_2420":3351,"_625":3125},"7628c545-68b2-473b-9c13-10a86eec5e98","import Fastify from 'fastify';\nimport mcpPlugin from '@mcp-it/fastify';\n\nconst app = Fastify();\n\nawait app.register(mcpPlugin, {\n name: 'Core Business API',\n description: 'AI 에이전트 연동용 핵심 비즈니스 API',\n});\n\napp.get('/users/:id', {\n schema: {\n operationId: 'get_user_by_id',\n summary: '사용자 정보 조회',\n description: 'ID 기반으로 특정 사용자의 프로필 상세 정보를 반환합니다.',\n params: {\n type: 'object',\n required: ['id'],\n properties: {\n id: { type: 'number', description: '사용자의 고유 식별자' }\n }\n }\n }\n}, async (request) => {\n const { id } = request.params as { id: number };\n return { id, name: '홍길동', email: 'user@example.com' };\n});",{"_950":6487,"_2420":2570,"_2571":6488},"50b219bc-33a4-4c0d-8f08-91df301ded1d",[],{"_950":6490,"_2420":2570,"_2571":6491},"b7b97487-a45d-4154-9f0b-bc1ddcde2dae",[6492,6494,6496,6499],{"_2579":6468,"_2420":2579,"_3365":6493},{"_3351":3367},{"_2579":6495,"_2420":2579},"는 애플리케이션의 라우트 등록 훅을 가로채 모든 경로를 자동 검색합니다. 이 과정에서 ",{"_2579":6497,"_2420":2579,"_3365":6498},"operationId",{"_3351":3367},{"_2579":6500,"_2420":2579},"가 도구의 고유 이름으로 지정되며, 기존 스키마 구조가 도구 매개변수 정의로 1대1 연동됩니다. 개발자는 동일한 유효성 검증과 비즈니스 로직을 이중으로 유지관리할 필요가 없어 에이전트 대응 비용을 드라마틱하게 낮출 수 있습니다.",{"_950":6502,"_2420":2570,"_2571":6503},"b7b28ffd-4b2a-4f1d-a213-ea27a15a10bd",[],{"_950":6505,"_2420":2575,"_2576":2007,"_2571":6506},"baa820ea-4434-466a-ada9-35aa1fd40ecf",[6507],{"_2579":6508,"_2420":2579},"Mastra와 Genkit 어댑터로 에이전트 오케스트레이션",{"_950":6510,"_2420":2570,"_2571":6511},"c8d4eb81-be1a-4b57-99e6-1598354a512d",[],{"_950":6513,"_2420":2570,"_2571":6514},"62370354-5469-4928-925b-92fd1ef7a069",[6515],{"_2579":6516,"_2420":2579},"단순히 개별 도구를 노출하는 단계를 넘어, 복잡한 멀티 에이전트 워크플로나 프롬프트 파이프라인을 구축할 때는 마스트라(Mastra)와 구글 젠키트(Genkit) 같은 오케스트레이션 프레임워크의 전용 어댑터가 유용합니다. 과거처럼 별도의 에이전트 독립 서버를 띄워 관리 비용과 시스템 복잡도를 늘릴 필요 없이, 기존에 운영 중인 Fastify 프로세스 내에 에이전트 엔진을 직접 마운트하여 하나의 단일 서버로 고성능 비즈니스 로직과 에이전트 기능을 한 번에 운영할 수 있습니다.",{"_950":6518,"_2420":2570,"_2571":6519},"e96458ed-d602-4a37-a991-146cc3201279",[],{"_950":6521,"_2420":2570,"_2571":6522},"2f12319d-97a3-40f7-ac7f-83a838cada19",[6523,6524,6527,6529,6532],{"_2579":6367,"_2420":2579},{"_2579":6525,"_2420":2579,"_3365":6526},"@mastra/fastify",{"_3351":3367},{"_2579":6528,"_2420":2579}," 패키지는 마스트라 인스턴스에 등록된 모든 에이전트, 워크플로, MCP 서버 엔드포인트를 Fastify 라우터에 자동으로 바인딩해 줍니다. 특히 스트림 응답 내의 민감한 정보(시스템 프롬프트, 도구 사양, API 키 등)를 마스킹하는 필터링 옵션(",{"_2579":6530,"_2420":2579,"_3365":6531},"streamOptions",{"_3351":3367},{"_2579":6533,"_2420":2579},")이나 경로별 인증 정책 설정을 생성자 단계에서 선언적으로 지원하여 보안 및 프라이버시 통제가 한층 수월해집니다.",{"_950":6535,"_2420":2570,"_2571":6536},"0db9b92e-7758-4805-b6ce-c5cfe3bb1f60",[],{"_950":6538,"_3351":6539,"_2420":3351,"_625":3125},"fbc0c6d0-d46b-417c-8f71-6a12473ab45d","// Fastify 환경에 Mastra 에이전트 통합하기 (Mastra 1.0 기준)\nimport Fastify from 'fastify';\nimport { MastraServer } from '@mastra/fastify';\nimport { mastra } from './mastra'; // 초기화된 mastra 인스턴스\n\nconst app = Fastify({ logger: true });\n\n// 어댑터를 통해 Mastra 에이전트 및 워크플로 엔드포인트를 Fastify에 마운트\nconst server = new MastraServer({ app, mastra });\nawait server.init();\n\nawait app.listen({ port: 3000 });",{"_950":6541,"_2420":2570,"_2571":6542},"1e2af7b8-3e96-4bff-812b-8fd8bc5ac486",[],{"_950":6544,"_2420":2570,"_2571":6545},"3a77ed77-b0da-4c7b-9b61-01dae0952adb",[6546,6548,6551,6553,6556],{"_2579":6547,"_2420":2579},"구글이 배포한 ",{"_2579":6549,"_2420":2579,"_3365":6550},"@genkit-ai/fastify",{"_3351":3367},{"_2579":6552,"_2420":2579}," 패키지 역시 뛰어난 개발자 경험을 선사합니다. 이 패키지가 제공하는 ",{"_2579":6554,"_2420":2579,"_3365":6555},"fastifyHandler",{"_3351":3367},{"_2579":6557,"_2420":2579},"는 복잡한 입출력 스키마 검증과 스트리밍 처리를 간결하게 묶어주는 미들웨어 역할을 합니다. 클라이언트가 SSE 스트리밍을 요청할 경우 별도의 스트림 파이핑 코드 없이도 실시간 청크 전송과 CORS 헤더 복사를 자동으로 수행하므로, 프론트엔드와 실시간 대화 인터페이스를 맞물릴 때 발생하기 쉬운 통신 병목을 우아하게 해소합니다.",{"_950":6559,"_2420":2570,"_2571":6560},"4bed28df-1894-4c13-8548-f90ac68e8f1f",[],{"_950":6562,"_2420":2575,"_2576":2007,"_2571":6563},"ef6c782b-5c28-4a8b-a255-8af55f50d0f4",[6564],{"_2579":6565,"_2420":2579},"플러그인 기반의 미래 지향적 에이전트 인프라 설계",{"_950":6567,"_2420":2570,"_2571":6568},"efc8440c-7a5f-434c-a565-bb66f2d4a84b",[],{"_950":6570,"_2420":2570,"_2571":6571},"4f980730-e521-4503-832e-8e6a8fd916c8",[6572],{"_2579":6573,"_2420":2579},"에이전트 인프라를 설계할 때 Fastify의 독보적인 플러그인 캡슐화 아키텍처는 개별 도구와 워크플로를 안전하게 격리하고 유연하게 결합하는 최적의 기반을 제공합니다. 이제는 라우팅이나 데이터 변환을 수동으로 구현하는 비효율에서 벗어나, 표준화된 어댑터와 미들웨어를 도입해 복잡한 비동기 흐름을 위임해야 할 때입니다. 검증된 생태계 도구를 통해 무상태 환경의 보안 규격을 손쉽게 충족하면서, 비즈니스 핵심 로직과 성능 최적화에 집중하는 것이 다음 단계의 에이전틱 백엔드 아키텍처가 나아가야 할 방향입니다.",{"_950":6575,"_2420":2570,"_2571":6576},"eea2a84e-bfe9-468f-aa75-6cc0ac5134de",[],{"_950":6578,"_2420":3473},"b33e59f8-fc2f-41d3-bf3c-8a289d28320b",{"_950":6580,"_2420":2570,"_2571":6581},"0d5a27ae-52e5-4cb0-8826-11db72249ecb",[],{"_950":6583,"_2420":2570,"_2571":6584},"11206232-209f-48fd-a807-c8771a0d188d",[6585],{"_2579":3483,"_2420":2579,"_3365":6586},{"_3485":3367},{"_950":6588,"_2420":2570,"_2571":6589},"9475770c-9f4d-450e-a8c5-96f4c1dbbb95",[],{"_950":6591,"_1881":3492,"_2420":3493,"_778":6592},"e7168946-f9f2-459b-b1a3-c1afeba8b8a0",[6593,6600,6608],{"_950":6594,"_2571":6595},"72685cbe-9f57-4c87-9dd3-467b9414119b",[6596],{"_3499":5316,"_2420":3501,"_3502":6597},[6598],{"_2579":6599,"_2420":2579},"GitHub / modelcontextprotocol/typescript-sdk — Official Model Context Protocol (MCP) TypeScript SDK v2.0.0 Splits Monolith and Introduces Official @modelcontextprotocol/fastify Helper",{"_950":6601,"_2571":6602},"70c5ae33-ac77-488a-97e7-1082345f47f4",[6603],{"_3499":6604,"_2420":3501,"_3502":6605},"https://github.com/AdirAmsalem/mcp-it",[6606],{"_2579":6607,"_2420":2579},"GitHub / AdirAmsalem/mcp-it — The @mcp-it/fastify Plugin Enables Zero-Configuration MCP Tool Generation from Fastify Route Schemas",{"_950":6609,"_2571":6610},"091e68ad-cba4-4e2a-8aac-3236551c820c",[6611],{"_3499":6612,"_2420":3501,"_3502":6613},"https://github.com/platformatic/mcp",[6614],{"_2579":6615,"_2420":2579},"GitHub / platformatic/mcp — Platformatic Releases Scalable Fastify Adapter @platformatic/mcp with Redis State Store Support",{"_6583":6617,"_6455":6619,"_6521":6622,"_6396":6626,"_6544":6629,"_6463":6633,"_6570":6637,"_6425":6640,"_6513":6643,"_6356":6646,"_6404":6649,"_6377":6652,"_6447":6656,"_6433":6659,"_6412":6662,"_6364":6666,"_6490":6670,"_6505":6674,"_6341":6677,"_6591":6679,"_6562":6692,"_6476":6695,"_6348":6698},{"_2571":6618},{"_1892":3483,"_1893":3604,"_1802":3483},{"_2571":6620},{"_1892":6458,"_1893":6621,"_1802":6458},"@mcp-it/fastify による既存APIのAIツール自動変換",{"_2571":6623},{"_1892":6624,"_1893":6625,"_1802":6624},"공식 @mastra/fastify 패키지는 마스트라 인스턴스에 등록된 모든 에이전트, 워크플로, MCP 서버 엔드포인트를 Fastify 라우터에 자동으로 바인딩해 줍니다. 특히 스트림 응답 내의 민감한 정보(시스템 프롬프트, 도구 사양, API 키 등)를 마스킹하는 필터링 옵션(streamOptions)이나 경로별 인증 정책 설정을 생성자 단계에서 선언적으로 지원하여 보안 및 프라이버시 통제가 한층 수월해집니다.","公式の @mastra/fastify パッケージは、Mastraインスタンスに登録されたすべてのアージェント、ワークフロー、MCPサーバーエンドポイントをFastifyルーターに自動バインディングします。特にストリーム応答内の機密情報（システムプロンプト、ツール仕様、APIキーなど）をマスクするフィルタリングオプション (streamOptions) や、パスごとの認証ポリシー設定をコンストラクタ段階で宣言的にサポートしており、セキュリティおよびプライバシー制御が容易になります。",{"_2571":6627},{"_1892":6399,"_1893":6628,"_1802":6399},"この構成により、複雑なセッション維持なしで個々のHTTPリクエストを独立して処理できるため、分散サーバー環境においてリソースを最大限に活用し、柔軟な水平スケーリングが可能になります。",{"_2571":6630},{"_1892":6631,"_1893":6632,"_1802":6631},"구글이 배포한 @genkit-ai/fastify 패키지 역시 뛰어난 개발자 경험을 선사합니다. 이 패키지가 제공하는 fastifyHandler는 복잡한 입출력 스키마 검증과 스트리밍 처리를 간결하게 묶어주는 미들웨어 역할을 합니다. 클라이언트가 SSE 스트리밍을 요청할 경우 별도의 스트림 파이핑 코드 없이도 실시간 청크 전송과 CORS 헤더 복사를 자동으로 수행하므로, 프론트엔드와 실시간 대화 인터페이스를 맞물릴 때 발생하기 쉬운 통신 병목을 우아하게 해소합니다.","Googleが提供する @genkit-ai/fastify パッケージも優れた開発者体験を提供します。このパッケージが提供する fastifyHandler は、複雑な入出力スキーマ検証とストリーミング処理を簡潔にまとめるミドルウェアとして機能します。クライアントがSSEストリーミングをリクエストした場合、ストリームパイピングコードを別途書かなくともリアルタイムのチャンク転送とCORSヘッダーのコピーが自動で行われるため、フロントエンドとのリアルタイム対話インターフェース実装時に発生しがちな通信ボトルネックをスムーズに解消できます。",{"_2571":6634},{"_1892":6635,"_1893":6636,"_1802":6635},"기존에 공들여 작성한 수십 개의 비즈니스 API를 에이전트용 도구로 변환하는 작업은 백엔드 개발자에게 큰 부담입니다. @mcp-it/fastify 플러그인은 Fastify의 강력한 스키마 기반 라우팅 아키텍처를 그대로 활용하여 이 병목을 해결합니다. 라우트에 이미 선언된 JSON 스키마를 동적으로 분석해, LLM이 즉시 이해하고 호출할 수 있는 MCP 도구 명세로 자동 변환하기 때문입니다.","既存のビジネスAPIをエージェント用ツールに変換する作業は、バックエンド開発者にとって大きな負担です。@mcp-it/fastify プラグインは、Fastifyの強力なスキーマベースのルーティングアーキテクチャを活用することで、このボトルネックを解消します。ルートに宣言済みのJSONスキーマを動的に解析し、LLMが即座に理解・呼び出し可能なMCPツール仕様へと自動変換するためです。",{"_2571":6638},{"_1892":6573,"_1893":6639,"_1802":6573},"エージェントインフラを設計する際、Fastify特有のプラグインカプセル化アーキテクチャは、個別のツールやワークフローを安全に分離し、柔軟に統合するための最適な基盤となります。ルーティングやデータ変換を手動で実装する非効率性から脱却し、標準化されたアダプターやミドルウェアを導入して複雑な非同期フローを委任すべき時です。検証済みのエコシステムツールを活用し、ステートレス環境でのセキュリティ要件を容易に満たしつつ、ビジネスのコアロジックとパフォーマンスの最適化に注力することこそが、次世代エージェントバックエンドアーキテクチャの進むべき方向です。",{"_2571":6641},{"_1892":6428,"_1893":6642,"_1802":6428},"このプラグインはRedisをメッセージブロードキャストおよびセッション状態共有のバックエンドとして活用します。ロードバランサー配下でバックエンドノードが動的に入れ替わったり水平スケーリングしたりしても、エージェントクライアントが確立しているServer-Sent Events (SSE) 接続のセッションを継続的に追跡・復旧できます。さらに、Fastifyエコシステムの高性能スキーマコンパイラであるTypeBoxを検証レイヤーとして組み込み、ランタイムでのスキーマ検証性能を極限まで高めています。",{"_2571":6644},{"_1892":6516,"_1893":6645,"_1802":6516},"単なる個別のツール公開を超え、複雑なマルチエージェントワークフローやプロンプトパイプラインを構築する場合、MastraやGoogle Genkitのようなオーケストレーションフレームワーク専用のアダプターが役立ちます。過去のように独立したエージェントサーバーを立ち上げて運用コストやシステム複雑性を高める必要はなく、既存のFastifyプロセス内にエージェントエンジンを直接マウントし、単一のサーバーで高性能なビジネスロジックとエージェント機能を同時に運用できます。",{"_2571":6647},{"_1892":6359,"_1893":6648,"_1802":6359},"公式 @modelcontextprotocol/fastify アダプターの導入",{"_2571":6650},{"_1892":6407,"_1893":6651,"_1802":6407},"@platformatic/mcp を活用したエンタープライズ級のスケーラビリティ確保",{"_2571":6653},{"_1892":6654,"_1893":6655,"_1802":6654},"다음은 @modelcontextprotocol/server 및 관련 패키지 v2.0.0 버전을 적용하여 구축한 고성능 무상태 MCP 서버의 구현 예시입니다.","@modelcontextprotocol/server および関連パッケージのv2.0.0を適用して構築した、高性能ステートレスMCPサーバーの実装例です。",{"_2571":6657},{"_1892":6450,"_1893":6658,"_1802":6450},"開発者は複雑な分散同期コードを自前で実装することなく、宣言的なプラグイン設定だけで分散クラスタ全体で動作するエージェントツールをデプロイできます。",{"_2571":6660},{"_1892":6436,"_1893":6661,"_1802":6436},"以下はRedisをバックエンドに統合し、分散インフラでの水平スケーリングをサポートするMCPサーバーの具体的な実装例です。",{"_2571":6663},{"_1892":6664,"_1893":6665,"_1802":6664},"단일 인스턴스 환경을 넘어 멀티테넌트 및 컨테이너 환경에서 에이전트 백엔드를 운영할 때 가장 큰 장벽은 상태 관리와 세션 유지입니다. 기존 Model Context Protocol(MCP) 구성은 단일 커넥션에 의존하는 상태 기반 연결이 많아, 다중 노드로 구성된 클라우드 환경에서 트래픽을 분산하면 세션이 유실되거나 동기화가 깨지는 치명적인 한계가 있었습니다. @platformatic/mcp 플러그인은 Fastify 프레임워크 위에서 이 아키텍처적 한계를 극복하기 위해 설계되었습니다.","単一インスタンス環境を超え、マルチテナントやコンテナ環境でエージェントバックエンドを運用する際の最大の障壁は、状態管理とセッション維持です。従来のModel Context Protocol (MCP) 構成は単一接続に依存するステートフルな接続が多いため、マルチノード構成のクラウド環境でトラフィックを分散させると、セッションの消失や同期ズレが発生するという致命的な限界がありました。@platformatic/mcp プラグインは、Fastifyフレームワーク上でこのアーキテクチャの限界を克服するために設計されました。",{"_2571":6667},{"_1892":6668,"_1893":6669,"_1802":6668},"공식 @modelcontextprotocol/fastify 패키지는 Fastify 애플리케이션 위에서 MCP 규격을 준수하는 도구를 호스팅하기 위한 최적의 전용 어댑터입니다. 이 어댑터는 무상태 환경에서 필수적인 DNS 리바인딩 보호와 호스트 헤더 검증을 Fastify 고유의 고성능 라이프사이클 안에서 자연스럽게 처리합니다. 특히 2026년 7월에 발표된 MCP v2.0 스펙을 온전히 지원하기 위해 모놀리식 구조를 탈피하고 경량 모듈로 리팩터링되었습니다.","公式の @modelcontextprotocol/fastify パッケージは、Fastifyアプリケーション上でMCP仕様に準拠したツールをホストするための最適な専用アダプターです。このアダプターは、ステートレス環境で不可欠なDNSリバインディング保護やホストヘッダー検証を、Fastify独自の高性能ライフサイクルの中で自然に処理します。特に2026年7月に発表されたMCP v2.0スペックを完全サポートするため、モノリシックな構造を脱却し、軽量モジュールとしてリファクタリングされました。",{"_2571":6671},{"_1892":6672,"_1893":6673,"_1802":6672},"@mcp-it/fastify는 애플리케이션의 라우트 등록 훅을 가로채 모든 경로를 자동 검색합니다. 이 과정에서 operationId가 도구의 고유 이름으로 지정되며, 기존 스키마 구조가 도구 매개변수 정의로 1대1 연동됩니다. 개발자는 동일한 유효성 검증과 비즈니스 로직을 이중으로 유지관리할 필요가 없어 에이전트 대응 비용을 드라마틱하게 낮출 수 있습니다.","@mcp-it/fastify はアプリケーションのルート登録フックを傍受し、すべてのパスを自動的に探索します。この過程でoperationIdがツール固有の名前として指定され、既存のスキーマ構造がツール引数の定義と1対1で連携されます。開発者は同一の検証ロジックやビジネスロジックを二重に保守する必要がなくなり、エージェント対応コストを大幅に削減可能です。",{"_2571":6675},{"_1892":6508,"_1893":6676,"_1802":6508},"MastraとGenkitアダプターによるエージェントオーケストレーション",{"_2571":6678},{"_1892":6264,"_1893":6265,"_1802":6264},{"_6680":6681,"_6684":6685,"_6688":6689},"item:091e68ad-cba4-4e2a-8aac-3236551c820c",{"_1892":6615,"_1893":6682,"_1802":6683},"GitHub / platformatic/mcp — PlatformaticがスケーラブルなFastifyアダプター @platformatic/mcp をリリース（Redis状態ストアをサポート）","GitHub / platformatic/mcp — Redis 상태 저장소 지원을 포함한 확장 가능한 Fastify 어댑터 @platformatic/mcp 출시","item:70c5ae33-ac77-488a-97e7-1082345f47f4",{"_1892":6607,"_1893":6686,"_1802":6687},"GitHub / AdirAmsalem/mcp-it — @mcp-it/fastify プラグイン：Fastifyルートスキーマからゼロ設定でMCPツールを生成","GitHub / AdirAmsalem/mcp-it — Fastify 라우트 스키마로부터 무설정 MCP 도구 생성을 지원하는 @mcp-it/fastify 플러그인","item:72685cbe-9f57-4c87-9dd3-467b9414119b",{"_1892":6599,"_1893":6690,"_1802":6691},"GitHub / modelcontextprotocol/typescript-sdk — 公式 Model Context Protocol (MCP) TypeScript SDK v2.0.0：モノリスの分割と公式 @modelcontextprotocol/fastify ヘルパーの導入","GitHub / modelcontextprotocol/typescript-sdk — 공식 Model Context Protocol (MCP) TypeScript SDK v2.0.0, 모놀리식 구조 분리 및 공식 @modelcontextprotocol/fastify 헬퍼 도입",{"_2571":6693},{"_1892":6565,"_1893":6694,"_1802":6565},"プラグインベースの未来志向型エージェントインフラ設計",{"_2571":6696},{"_1892":6479,"_1893":6697,"_1802":6479},"コードの重複なしに既存のFastify APIをAIツールへ変換する方法は以下の通りです。",{"_2571":6699},{"_1892":6351,"_1893":6700,"_1802":6351},"Model Context Protocol (MCP) v2.0仕様がステートレスなHTTP標準を採用したことで、AIエージェントとバックエンドAPIを接続する手法が転換期を迎えています。従来、開発者はLLMが呼び出すツールを毎回加工し、複雑なルーティングルールをすべて手動で管理する必要がありました。しかし、現在のFastifyエコシステムは、公式アダプターと高性能プラグインを活用し、ステートレスな分散処理とセキュリティ検証を自動化する「エージェンティックミドルウェア」パターンへと急速に進化しています。","![Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴](file:cmsaiyaol05za10nvp741bzws)\n\n# Fastify 에이전틱 미들웨어 — 수동 구현 없는 MCP v2.0 백엔드 패턴\n\n모델 컨텍스트 프로토콜(MCP) v2.0 규격이 무상태 HTTP 표준을 채택하면서, AI 에이전트와 백엔드 API를 연결하는 방식이 전환되고 있습니다. 기존에는 LLM이 호출할 도구를 개발자가 매번 가공하고 복잡한 라우팅 규칙을 일일이 수작업으로 관리해야 했습니다. 하지만 현재 Fastify 생태계는 공식 어댑터와 고성능 플러그인을 활용해 상태 비저장 분산 처리와 보안 검증을 자동으로 수행하는 에이전틱 미들웨어 패턴으로 빠르게 발전하고 있습니다.\n\n## 공식 @modelcontextprotocol/fastify 어댑터 도입하기\n\n공식 `@modelcontextprotocol/fastify` 패키지는 Fastify 애플리케이션 위에서 MCP 규격을 준수하는 도구를 호스팅하기 위한 최적의 전용 어댑터입니다. 이 어댑터는 무상태 환경에서 필수적인 DNS 리바인딩 보호와 호스트 헤더 검증을 Fastify 고유의 고성능 라이프사이클 안에서 자연스럽게 처리합니다. 특히 2026년 7월에 발표된 MCP v2.0 스펙을 온전히 지원하기 위해 모놀리식 구조를 탈피하고 경량 모듈로 리팩터링되었습니다.\n\n다음은 `@modelcontextprotocol/server` 및 관련 패키지 v2.0.0 버전을 적용하여 구축한 고성능 무상태 MCP 서버의 구현 예시입니다.\n\n```typescript\nimport { createMcpFastifyApp } from '@modelcontextprotocol/fastify';\nimport { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';\nimport { McpServer } from '@modelcontextprotocol/server';\nimport { z } from 'zod';\n\nconst app = createMcpFastifyApp();\nconst mcpServer = new McpServer({\n name: 'my-agent-tools',\n version: '2.0.0',\n});\n\n// v2.0.0 규격의 registerTool API 사용\nmcpServer.registerTool(\n 'calculate',\n {\n description: '두 숫자의 사칙연산을 수행합니다.',\n inputSchema: z.object({\n a: z.number(),\n b: z.number(),\n operator: z.enum(['add', 'subtract', 'multiply', 'divide']),\n }),\n },\n async ({ a, b, operator }) => {\n let result = 0;\n if (operator === 'add') result = a + b;\n else if (operator === 'subtract') result = a - b;\n else if (operator === 'multiply') result = a * b;\n else if (operator === 'divide') result = a / b;\n\n return {\n content: [{ type: 'text', text: String(result) }],\n };\n }\n);\n\n// 무상태 HTTP 라우트 등록\napp.post('/mcp', async (request, reply) => {\n const transport = new NodeStreamableHTTPServerTransport({\n sessionIdGenerator: undefined, // 무상태 모드 활성화\n });\n\n await mcpServer.connect(transport);\n\n reply.raw.on('close', () => {\n transport.close();\n });\n\n await transport.handleRequest(request.raw, reply.raw, request.body);\n});\n\nawait app.listen({ port: 3000 });\n```\n\n이 구조를 사용하면 복잡한 세션 유지 없이도 개별 HTTP 요청을 독립적으로 처리할 수 있어, 분산 서버 환경에서 서버 자원을 극대화하고 유연한 수평 확장이 가능해집니다.\n\n## @platformatic/mcp를 활용한 엔터프라이즈급 확장성 확보\n\n단일 인스턴스 환경을 넘어 멀티테넌트 및 컨테이너 환경에서 에이전트 백엔드를 운영할 때 가장 큰 장벽은 상태 관리와 세션 유지입니다. 기존 Model Context Protocol(MCP) 구성은 단일 커넥션에 의존하는 상태 기반 연결이 많아, 다중 노드로 구성된 클라우드 환경에서 트래픽을 분산하면 세션이 유실되거나 동기화가 깨지는 치명적인 한계가 있었습니다. `@platformatic/mcp` 플러그인은 Fastify 프레임워크 위에서 이 아키텍처적 한계를 극복하기 위해 설계되었습니다.\n\n이 플러그인은 레디스(Redis)를 메시지 브로드캐스팅과 세션 상태 공유 백엔드로 활용합니다. 로드 밸런서 뒤에 가동 중인 백엔드 노드가 무작위로 교체되거나 수평 확장되더라도, 에이전트 클라이언트가 맺고 있는 서버 전송 이벤트(SSE) 커넥션의 세션을 지속해서 추적하고 복구할 수 있습니다. 또한, Fastify 생태계의 고성능 스키마 컴파일러인 타입박스(TypeBox)를 기본 검증 레이어로 결합하여 런타임 스키마 검증 성능을 극대화합니다.\n\n다음은 레디스를 백엔드로 결합하여 분산 인프라에서 수평 확장을 지원하는 MCP 서버의 구체적인 구현 예시입니다.\n\n```typescript\nimport Fastify from 'fastify';\nimport mcp from '@platformatic/mcp';\nimport { Type } from '@sinclair/typebox';\n\nconst app = Fastify();\n\nawait app.register(mcp, {\n redis: {\n host: 'localhost',\n port: 6379\n },\n enableSSE: true\n});\n\napp.mcpAddTool({\n name: 'get_user_activity',\n description: '사용자의 최근 활동 로그를 조회합니다.',\n inputSchema: Type.Object({\n userId: Type.String(),\n limit: Type.Optional(Type.Number({ default: 10 }))\n })\n}, async (params) => {\n const { userId, limit } = params;\n return {\n content: [{ type: 'text', text: `사용자 ${userId}의 최근 활동 ${limit}건을 조회했습니다.` }]\n };\n});\n```\n\n개발자는 복잡한 분산 동기화 코드를 직접 구현할 필요 없이 선언적인 플러그인 설정만으로 분산 클러스터 전역에서 동작하는 에이전트 도구를 배포할 수 있습니다.\n\n## @mcp-it/fastify로 기존 API를 AI 도구로 자동 변환\n\n기존에 공들여 작성한 수십 개의 비즈니스 API를 에이전트용 도구로 변환하는 작업은 백엔드 개발자에게 큰 부담입니다. `@mcp-it/fastify` 플러그인은 Fastify의 강력한 스키마 기반 라우팅 아키텍처를 그대로 활용하여 이 병목을 해결합니다. 라우트에 이미 선언된 JSON 스키마를 동적으로 분석해, LLM이 즉시 이해하고 호출할 수 있는 MCP 도구 명세로 자동 변환하기 때문입니다.\n\n추가적인 코드 중복 없이 기존 Fastify API를 AI 도구로 전환하는 방법은 다음과 같습니다.\n\n```typescript\nimport Fastify from 'fastify';\nimport mcpPlugin from '@mcp-it/fastify';\n\nconst app = Fastify();\n\nawait app.register(mcpPlugin, {\n name: 'Core Business API',\n description: 'AI 에이전트 연동용 핵심 비즈니스 API',\n});\n\napp.get('/users/:id', {\n schema: {\n operationId: 'get_user_by_id',\n summary: '사용자 정보 조회',\n description: 'ID 기반으로 특정 사용자의 프로필 상세 정보를 반환합니다.',\n params: {\n type: 'object',\n required: ['id'],\n properties: {\n id: { type: 'number', description: '사용자의 고유 식별자' }\n }\n }\n }\n}, async (request) => {\n const { id } = request.params as { id: number };\n return { id, name: '홍길동', email: 'user@example.com' };\n});\n```\n\n`@mcp-it/fastify`는 애플리케이션의 라우트 등록 훅을 가로채 모든 경로를 자동 검색합니다. 이 과정에서 `operationId`가 도구의 고유 이름으로 지정되며, 기존 스키마 구조가 도구 매개변수 정의로 1대1 연동됩니다. 개발자는 동일한 유효성 검증과 비즈니스 로직을 이중으로 유지관리할 필요가 없어 에이전트 대응 비용을 드라마틱하게 낮출 수 있습니다.\n\n## Mastra와 Genkit 어댑터로 에이전트 오케스트레이션\n\n단순히 개별 도구를 노출하는 단계를 넘어, 복잡한 멀티 에이전트 워크플로나 프롬프트 파이프라인을 구축할 때는 마스트라(Mastra)와 구글 젠키트(Genkit) 같은 오케스트레이션 프레임워크의 전용 어댑터가 유용합니다. 과거처럼 별도의 에이전트 독립 서버를 띄워 관리 비용과 시스템 복잡도를 늘릴 필요 없이, 기존에 운영 중인 Fastify 프로세스 내에 에이전트 엔진을 직접 마운트하여 하나의 단일 서버로 고성능 비즈니스 로직과 에이전트 기능을 한 번에 운영할 수 있습니다.\n\n공식 `@mastra/fastify` 패키지는 마스트라 인스턴스에 등록된 모든 에이전트, 워크플로, MCP 서버 엔드포인트를 Fastify 라우터에 자동으로 바인딩해 줍니다. 특히 스트림 응답 내의 민감한 정보(시스템 프롬프트, 도구 사양, API 키 등)를 마스킹하는 필터링 옵션(`streamOptions`)이나 경로별 인증 정책 설정을 생성자 단계에서 선언적으로 지원하여 보안 및 프라이버시 통제가 한층 수월해집니다.\n\n```typescript\n// Fastify 환경에 Mastra 에이전트 통합하기 (Mastra 1.0 기준)\nimport Fastify from 'fastify';\nimport { MastraServer } from '@mastra/fastify';\nimport { mastra } from './mastra'; // 초기화된 mastra 인스턴스\n\nconst app = Fastify({ logger: true });\n\n// 어댑터를 통해 Mastra 에이전트 및 워크플로 엔드포인트를 Fastify에 마운트\nconst server = new MastraServer({ app, mastra });\nawait server.init();\n\nawait app.listen({ port: 3000 });\n```\n\n구글이 배포한 `@genkit-ai/fastify` 패키지 역시 뛰어난 개발자 경험을 선사합니다. 이 패키지가 제공하는 `fastifyHandler`는 복잡한 입출력 스키마 검증과 스트리밍 처리를 간결하게 묶어주는 미들웨어 역할을 합니다. 클라이언트가 SSE 스트리밍을 요청할 경우 별도의 스트림 파이핑 코드 없이도 실시간 청크 전송과 CORS 헤더 복사를 자동으로 수행하므로, 프론트엔드와 실시간 대화 인터페이스를 맞물릴 때 발생하기 쉬운 통신 병목을 우아하게 해소합니다.\n\n## 플러그인 기반의 미래 지향적 에이전트 인프라 설계\n\n에이전트 인프라를 설계할 때 Fastify의 독보적인 플러그인 캡슐화 아키텍처는 개별 도구와 워크플로를 안전하게 격리하고 유연하게 결합하는 최적의 기반을 제공합니다. 이제는 라우팅이나 데이터 변환을 수동으로 구현하는 비효율에서 벗어나, 표준화된 어댑터와 미들웨어를 도입해 복잡한 비동기 흐름을 위임해야 할 때입니다. 검증된 생태계 도구를 통해 무상태 환경의 보안 규격을 손쉽게 충족하면서, 비즈니스 핵심 로직과 성능 최적화에 집중하는 것이 다음 단계의 에이전틱 백엔드 아키텍처가 나아가야 할 방향입니다.\n\n---\n\n**참고 링크**\n\n- [GitHub / modelcontextprotocol/typescript-sdk — Official Model Context Protocol (MCP) TypeScript SDK v2.0.0 Splits Monolith and Introduces Official @modelcontextprotocol/fastify Helper](https://github.com/modelcontextprotocol/typescript-sdk)\n- [GitHub / AdirAmsalem/mcp-it — The @mcp-it/fastify Plugin Enables Zero-Configuration MCP Tool Generation from Fastify Route Schemas](https://github.com/AdirAmsalem/mcp-it)\n- [GitHub / platformatic/mcp — Platformatic Releases Scalable Fastify Adapter @platformatic/mcp with Redis State Store Support](https://github.com/platformatic/mcp)","7bc7d4c0bb694080286b13ee647522cd4a7aac5541923705c7576496cb7ea666","2026-08-01T14:30:35.312Z","2026-08-02T07:32:20.039Z",[],[],{"_950":6708,"_2416":6709,"_2418":2803,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":6710,"_1889":6718,"_2455":-5,"_2456":-5,"_2457":-5,"_9":6722,"_2450":6730,"_2458":6731,"_2460":-5,"_723":6732,"_1886":6734,"_332":6741,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":6742,"_2003":6743,"_2480":6744,"_2482":6745,"_2483":6746,"_2485":-5,"_2486":-5,"_2487":6747,"_1144":6772,"_2527":6785,"_2555":-5,"_2556":6807,"_2798":7259,"_266":7260},"cms7mk7gq02v310nv52ll9q4s","cmqx0mggs00004jcg8uoj3tmt",{"_1801":1802,"_214":6711,"_2429":6712,"_2434":6715,"_2438":2439},3354,{"_1892":6713,"_1893":1997,"_1802":6714,"_2433":1997},950,2404,{"_1892":6716,"_1893":1997,"_1802":6717,"_2433":1997},0.28324388789505067,0.7167561121049493,{"_9":6719,"_2445":6723,"_2450":6727},{"_1892":6720,"_1893":6721,"_1802":6722},"GIWA Chain Analysis — What Can You Build with 1-Second Blocks and the Dojang Identity Layer?","GIWAチェーン分析 — 1秒ブロックとDojang身元レイヤーで何を作るか","GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나",{"_1892":6724,"_1893":6725,"_1802":6726},"GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나\n\nGIWA Chain Analysis — What Can You Build with 1-Second Blocks and the Dojang Identity Layer?\n\nA new OP Stack chain for enterprises and institutions has emerged in the Ethereum Layer 2 ecosystem. The GIWA chain, built by Dunamu, goes beyond a simple rollup to offer a differentiated development environment through a proprietary technical structure. Features such as 1-second block times, sub-200ms flashblock pre-confirmation technology, and the EAS-based Dojang identity layer provide a performance and regulatory compliance environment distinct from existing Layer 2 solutions. We analyze the technical core elements currently applicable in practice through the testnet and the shifts from a developer's perspective.\n\nProprietary Sequencer and 1-Second Blocks — OP Enterprise Self-Managed Architecture\n\nThe GIWA chain is an OP Stack-based Layer 2, making it the first to implement the Self-Managed tier of OP Enterprise, Optimism's enterprise-grade license. Unlike typical rollups that use a shared sequencer pool, Dunamu operates its sequencer independently. This grants them full sovereignty to control transaction ordering rules and block space operation policies in line with enterprise requirements.\n\nFurthermore, it has reduced transaction latency by half by shortening the standard OP Stack 2-second block time to 1 second. While you can currently build freely on the GIWA Sepolia testnet (Chain ID 91342), the future production mainnet will be deployed as a private, whitelisted environment accessible only to authorized partners. Builders should keep in mind the potential access restrictions for the mainnet deployment during their architecture design phase.\n\nThe optimization of the node infrastructure to push execution layer performance to its limit is also noteworthy. Following the Kast hard fork in July 2026, official support for the legacy op-geth was discontinued, and the execution layer was fully migrated to op-reth, a high-performance Rust-based client. Engine-level rule changes, such as limiting the gas per transaction to 16,777,216 and adjusting P256VERIFY precompile gas costs to 6,900, have been applied, so these should be considered when optimizing contracts.\n\nUser Experience Under 200ms — Flashblocks RPC Integration\n\nFor fields requiring immediate response, such as on-chain payments or real-time gaming, even a 1-second block time can feel like a delay. The GIWA chain solves this by introducing flashblock technology, providing pre-confirmation in under 200ms before transactions are finally recorded in a block.\n\nDevelopers can implement and test this ultra-fast user experience directly using the dedicated RPC endpoint provided by the GIWA Sepolia testnet.\n\nFlashblocks-dedicated RPC endpoint: https://sepolia-rpc-flashblocks.giwa.io\n\nBy integrating this endpoint, your frontend can be updated in real-time by receiving pre-confirmation signals sent immediately by the node while the transaction is still in the mempool. This mitigates the bottlenecks that previously occurred in L2 nodes while receiving transactions, estimating gas, and fully generating blocks, ensuring smooth, Web2-like responsiveness.\n\nHowever, there are development constraints to note for real-world product applications. While anyone can freely integrate this performance on the Chain ID 91342-based GIWA Sepolia testnet, the official mainnet will operate as a private, whitelist-based chain where only authorized builders can deploy smart contracts. Therefore, after validating the flashblock integration performance during the testnet development phase, you must account for the design and operational policies suited to the mainnet entry barriers.\n\nEAS-Based Identity Layer — On-Chain Regulatory Compliance with the Dojang Protocol\n\nThe most significant differentiator of the GIWA chain is the Dojang protocol, its proprietary identity verification system implemented on top of EAS (Ethereum Attestation Service). Dojang links Upbit's off-chain real-name account verification data with on-chain wallet addresses without exposing personal information. Users can prove their KYC status via attestation data stored in their wallets without revealing sensitive personal details.\n\nDevelopers control identity data through the EAS contract (0x4200000000000000000000000000000000000021) and schema registry (0x4200000000000000000000000000000000000020) deployed on the GIWA Sepolia testnet. Specifically, by using the verified address schema UID (0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08), you can instantly determine the verification status of a specific address on-chain. For convenience, the DojangScroll contract (0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9) allows verification in a single call, eliminating the need for complex EAS data parsing.\n\nFor example, regulatory-compliant control logic that blocks access to unauthorized addresses in a Solidity smart contract can be implemented as follows:\n\ninterface IDojangScroll {\n function isVerified(address addr, bytes32 attesterId) external view returns (bool);\n}\n\ncontract VerifiedAction {\n address private constant DOJANG = 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9;\n bytes32 private constant UPBIT = 0xd99b42e778498aa3c9c1f6a012359130252780511687a35982e8e52735453034;\n\n function secureAction() external view {\n require(IDojangScroll(DOJANG).isVerified(msg.sender, UPBIT), \"Forbidden\");\n }\n}\n\nCurrently, on the GIWA Sepolia testnet (Chain ID: 91342), anyone can freely integrate the Dojang protocol to build dApps. However, the production mainnet will be operated as a whitelist-based private chain where only authorized services can be deployed. Therefore, builders should actively utilize this identity layer during the testnet phase to preemptively verify the functionality of regulatory-conservative DeFi or settlement protocols.\n\nGIWA Chain Testnet Practical Deployment and Development Environment for L2 Builders\n\nThe GIWA Sepolia testnet, using Chain ID 91342, is fully EVM-compatible, allowing the use of standard Ethereum development tools such as Hardhat or Foundry. Through RPC endpoints and faucets provided by the official infrastructure partner, Nodit, anyone can quickly set up a development environment and deploy smart contracts. Notably, gas costs are set at approximately 1 KRW per transaction, making it ideal for testing micro-payments or frequent on-chain interactions without cost burdens.\n\nHowever, a key constraint to recognize during development is the difference in operational models between the testnet and the mainnet. Unlike the testnet, where anyone can deploy freely, the GIWA mainnet, where the actual production will run, is built on a whitelist-based private model where only pre-authorized partners can deploy and use smart contracts. Therefore, builders must clearly design their on-chain access control structure from the initial planning stage, considering the mainnet roadmap.\n\nThe most definitive path to entering this restricted mainnet ecosystem is GASOK, Dunamu's builder program. This program, which provides a total of $100,000 in milestone-based grants, offers selected teams infrastructure and technical consulting support, as well as priority rights for future private mainnet deployment.\n\nGIWA Chain Adoption Guide — Practical Checklist for Developers\n\nThe GIWA chain offers clear appeal to dApp builders with its independent sequencer operation, sub-200ms ultra-fast pre-confirmation, and the Dojang identity layer that adheres to institutional regulations. However, you must establish your entry strategy with the awareness that, unlike the public testnet (Chain ID 91342), the production mainnet is deployed as a whitelist-based private model.\n\nFurthermore, your architecture should account for the fact that transaction acceptance by the L2 sequencer is not synonymous with final confirmation on the Ethereum mainnet, and that there is a withdrawal delay period characteristic of rollups when passing through the bridge. If you are deliberating on the balance between regulatory-aware contract design and high-performance user experience, it is recommended to start by deploying a smart contract on the GIWA Sepolia testnet.\n\nReference Links\n\nOptimism Foundation / Dunamu Press Releases — GIWA Chain Architecture & OP Enterprise Self-Managed Strategy\nGIWA Chain Developer Notices — Flashblocks RPC Endpoint & Node Execution Layer\nOptimism Foundation / Dunamu Press Releases — Upbit (Dunamu) Partnering with Optimism Foundation on GIWA Chain","GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나\n\nGIWAチェーン分析 — 1秒ブロックとDojang身元レイヤーで何を作るか\n\nイーサリアムのレイヤー2エコシステムに、企業や機関向けの新しいOP Stackチェーンが登場しました。Dunamuが構築したGIWAチェーンは、単なるロールアップを超え、独自の技術構造で差別化された開発環境を提供します。1秒のブロックタイムと200ms未満のフラッシュブロック事前確定技術、そしてEASベースのDojang身元レイヤーは、既存のレイヤー2とは異なるパフォーマンスと規制遵守環境を提示します。テストネットを通じて、今すぐ実戦で適用可能な技術的コア要素と、開発者視点での変化を分析します。\n\n独自のシーケンサーと1秒ブロック — OP Enterprise Self-Managedアーキテクチャ\n\nGIWAチェーンはOP Stackベースのレイヤー2であり、Optimismの企業向けライセンスである「OP Enterprise」のSelf-Managedティアを初めて適用しました。共有シーケンサープールを使用する一般的なロールアップと異なり、Dunamuがシーケンサーを独自に運営します。そのため、トランザクションの順序付けルールやブロック領域の運営方針を企業の要件に合わせて完全に制御できる主権を持っています。\n\nまた、標準的なOP Stackの2秒ブロックタイムを1秒に短縮し、トランザクション処理の遅延を半分に短縮しました。現在はチェーンID 91342のGIWA Sepoliaテストネットで自由にビルドできますが、今後のプロダクションメインネットは、承認されたパートナーのみが参加できるプライベートなホワイトリスト形式で配布される予定です。ビルダーは、メインネット配布段階で要求されるアクセス権制限事項を、アーキテクチャ設計時にあらかじめ考慮しておく必要があります。\n\n実行レイヤーのパフォーマンスを限界まで引き出すためのノードインフラ最適化にも注目です。2026年7月に行われたKastハードフォーク以降、従来のop-gethのサポートは公式に終了し、Rustベースの高性能クライアントであるop-rethへと実行レイヤーが完全に移行しました。今回のアップグレードにより、トランザクションあたりのガス上限が16,777,216ガスに制限され、P256VERIFYプリコンパイルのガス料金が6,900ガスに調整されるなど、エンジンレベルのルール変更が適用されたため、コントラクトの最適化時に参考にしてください。\n\n200ms未満のユーザーエクスペリエンス — フラッシュブロックRPC連携\n\nオンチェーン決済やリアルタイムゲームのように即時反応が必要な分野では、1秒のブロックタイムですら待ち時間に感じられることがあります。GIWAチェーンは、トランザクションがブロックに最終記録される前、200ms未満の速度で事前確定を提供する「フラッシュブロック」技術を導入することで、この問題を解決します。\n\n開発者は、GIWA Sepoliaテストネットで提供される専用RPCエンドポイントを使用して、この超高速なユーザーエクスペリエンスを直接実装およびテストできます。\n\nフラッシュブロック専用RPCエンドポイント: https://sepolia-rpc-flashblocks.giwa.io\n\nこのエンドポイントを連携すると、トランザクションがメンプール（mempool）に留まっている間にノードが即座に送信する事前確定信号を受信し、フロントエンドの画面をリアルタイムで更新できます。既存のL2ノードがトランザクションを受信し、ガスを推定した後にブロックが完全に生成されるまで発生していたボトルネックを補完し、Web2並みのスムーズな応答性を保証します。\n\nただし、実際の製品段階に適用する際には注意すべき開発制限があります。現在、チェーンID 91342ベースのGIWA Sepoliaテストネットでは誰でもこのパフォーマンスを自由に連携して試せますが、正式にリリースされるメインネットは、許可されたビルダーのみがスマートコントラクトをデプロイできるホワイトリスト形式のプライベートチェーンとして運営される予定です。そのため、テストネットでの開発段階でフラッシュブロック連携のパフォーマンスを検証した後、メインネットの参入障壁に合わせた設計や運営方針をあわせて考慮する必要があります。\n\nEASベースの身元レイヤー — Dojangプロトコルを活用したオンチェーン規制遵守\n\nGIWAチェーンの最大の差別化ポイントは、EAS上に実装された独自の身元認証体系である「Dojang（道場）」プロトコルです。Dojangは、Upbitのオフチェーン実名口座認証情報を、個人情報を露呈することなくオンチェーンのウォレットアドレスと連携させます。ユーザーは自身の機密個人情報を明らかにすることなく、KYC完了の有無のみを証明データとしてウォレットに保持し、活用することができます。\n\n開発者は、GIWA SepoliaテストネットにデプロイされたEASコントラクト（0x4200000000000000000000000000000000000021）とスキーマレジストリ（0x4200000000000000000000000000000000000020）を通じて身元データを制御します。特に「検証済みアドレススキーマUID」（0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08）を活用すれば、特定アドレスの認証状態をオンチェーンで即座に判別可能です。利便性のために提供されるDojangScrollコントラクト（0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9）を利用すれば、複雑なEASデータのパースなしで、わずか1回の呼び出しで検証が完了します。\n\n例えば、Solidityスマートコントラクトで未承認アドレスのアクセスを遮断する、規制遵守型の制御ロジックは以下のように実装できます。\n\ninterface IDojangScroll {\n function isVerified(address addr, bytes32 attesterId) external view returns (bool);\n}\n\ncontract VerifiedAction {\n address private constant DOJANG = 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9;\n bytes32 private constant UPBIT = 0xd99b42e778498aa3c9c1f6a012359130252780511687a35982e8e52735453034;\n\n function secureAction() external view {\n require(IDojangScroll(DOJANG).isVerified(msg.sender, UPBIT), \"Forbidden\");\n }\n}\n\n現在、GIWA Sepoliaテストネット（チェーンID: 91342）では誰でも自由にDojangプロトコルを連携してdAppを構築できます。しかし、実際のプロダクションメインネットは許可されたサービスのみがデプロイできるホワイトリスト方式のプライベートチェーンとして運営される予定です。したがって、ビルダーはテストネット段階でこの身元レイヤーを積極的に活用し、規制に対して保守的なDeFiや決済プロトコルの動作性を先制的に検証しておく必要があります。\n\nL2ビルダーのためのGIWAチェーンテストネット実戦デプロイおよび開発環境\n\nチェーンID 91342を使用するGIWA Sepoliaテストネットは、EVM互換性を完全に備えており、HardhatやFoundryのような標準的なイーサリアム開発ツールをそのまま使用できます。公式インフラパートナーのNoditが提供するRPCエンドポイントとフォーセットを通じて、誰でも迅速に開発環境を構築し、スマートコントラクトをデプロイ可能です。特に、トランザクションあたりのガス料金が約1ウォン水準に設定されているため、少額決済や頻繁なオンチェーンインタラクションを気軽にテストするのに最適です。\n\nただし、開発時に認識すべき重要な制限は、テストネットとメインネットの運営モデルの違いです。誰でも自由にデプロイできるテストネットとは異なり、実際のプロダクションが実行されるGIWAメインネットは、事前に許可されたパートナーのみがスマートコントラクトをデプロイし使用できる、ホワイトリストベースのプライベートモデルで構築されます。そのため、ビルダーはメインネットのロードマップを考慮し、初期企画段階からオンチェーンのアクセス権限構造を明確に設計する必要があります。\n\nこのような制限されたメインネットエコシステムに参入するための最も確実なルートは、Dunamuのビルダープログラム「GASOK」です。総額10万ドル規模のマイルストーンベースの助成金を提供するこのプログラムは、選抜されたチームに対してインフラおよび技術コンサルティングの支援を行うとともに、将来的に非公開のメインネットへのデプロイ権限を優先的に付与します。\n\nGIWAチェーン導入ガイド — 開発者のための実戦チェックリスト\n\nGIWAチェーンは、独自のシーケンサー運営と200ms未満の超高速事前確定、そして制度上の規制を遵守するDojang身元レイヤーにより、dAppビルダーに確かな魅力を提供します。ただし、チェーンID 91342を使用するパブリックテストネットとは異なり、実際のプロダクション段階のメインネットはホワイトリストベースのプライベートモデルで配布されるという制約条件を認識し、参入戦略を立てる必要があります。\n\nまた、L2シーケンサーによるトランザクションの承認がイーサリアムメインネットの最終確定と同義ではないこと、ブリッジ通過時にロールアップ特有の引き出し遅延期間が存在することなどもアーキテクチャに反映させなければなりません。規制を考慮したコントラクト設計と高性能なユーザー体験の両立を検討しているなら、まずはGIWA Sepoliaテストネットでスマートコントラクトをデプロイしてみることから始めるのが良いでしょう。\n\n参考リンク\n\nOptimism Foundation / Dunamu Press Releases — GIWA Chain Architecture & OP Enterprise Self-Managed Strategy\nGIWA Chain Developer Notices — Flashblocks RPC Endpoint & Node Execution Layer\nOptimism Foundation / Dunamu Press Releases — Upbit (Dunamu) Partnering with Optimism Foundation on GIWA Chain","GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나\n\nGIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나\n\n이더리움 레이어 2 생태계에 기업과 기관을 위한 새로운 OP Stack 체인이 등장했습니다. 두나무가 구축한 GIWA 체인은 단순한 롤업을 넘어 독자적인 기술 구조로 차별화된 개발 환경을 제공합니다. 1초 블록 타임과 200ms 미만의 플래시블록 사전 확정 기술, 그리고 EAS 기반의 Dojang 신원 레이어는 기존 레이어 2와 다른 성능과 규제 준수 환경을 제시합니다. 테스트넷을 통해 지금 바로 실전에서 적용 가능한 기술적 핵심 요소와 개발자 관점의 변화를 분석합니다.\n\n독자적인 시퀀서와 1초 블록 — OP Enterprise Self-Managed 아키텍처\n\n기와 체인은 OP Stack 기반 레이어 2로, 오프티미즘의 기업용 라이선스인 OP Enterprise의 Self-Managed 티어를 최초로 적용했습니다. 공유 시퀀서 풀을 사용하는 일반적인 롤업과 달리 두나무가 시퀀서를 독자적으로 운영합니다. 덕분에 트랜잭션 순서 정렬 규칙과 블록 공간 운영 정책을 기업 요구사항에 맞춰 완전히 제어할 수 있는 주권을 가집니다.\n\n또한 표준 OP Stack의 2초 블록 타임을 1초로 단축해 트랜잭션 처리 지연을 절반으로 줄였습니다. 현재 체인 ID 91342인 기와 세폴리아 테스트넷에서 자유롭게 빌딩할 수 있지만, 향후 프로덕션 메인넷은 인가된 파트너만 참여할 수 있는 프라이빗 화이트리스트 형태로 배포될 예정입니다. 빌더들은 메인넷 배포 단계에서 요구될 접근 권한 제약 사항을 아키텍처 설계 시 미리 염두에 두어야 합니다.\n\n실행 레이어의 성능을 한계까지 끌어올리기 위한 노드 인프라 최적화도 눈여겨볼 만합니다. 2026년 7월 진행된 카스트 하드포크 이후 기존 op-geth 지원은 공식 종료되었으며, Rust 기반 고성능 클라이언트인 op-reth로 실행 레이어가 완전히 이전되었습니다. 이번 업그레이드로 트랜잭션당 가스 한도가 16,777,216 가스로 제한되고, P256VERIFY 프리컴파일 가스 비용이 6,900 가스로 조정되는 등 엔진 레벨의 규칙 변화가 적용되었으므로 컨트랙트 최적화 시 참고해야 합니다.\n\n200ms 미만의 사용자 경험 — 플래시블록 RPC 연동\n\n온체인 결제나 실시간 게임처럼 즉각적인 반응이 필요한 분야에서는 1초의 블록 타임조차 대기 시간으로 느껴질 수 있습니다. 기와 체인은 트랜잭션이 블록에 최종 기록되기 전, 200ms 미만의 속도로 사전 확정을 제공하는 플래시블록 기술을 도입하여 이 문제를 해결합니다.\n\n개발자는 기와 세폴리아 테스트넷에서 제공하는 전용 RPC 엔드포인트를 사용해 이 초고속 사용자 경험을 직접 구현하고 테스트할 수 있습니다.\n\n플래시블록 전용 RPC 엔드포인트: https://sepolia-rpc-flashblocks.giwa.io\n\n해당 엔드포인트를 연동하면 트랜잭션이 멤풀에 머무는 동안 노드가 즉각 전송하는 사전 확정 신호를 받아 프론트엔드 화면을 실시간으로 업데이트할 수 있습니다. 기존 L2 노드가 트랜잭션을 수신하고 가스를 추정한 뒤 블록을 완전히 생성하기까지 발생하던 병목을 보완하여 웹2에 준하는 매끄러운 반응성을 보장합니다.\n\n다만 실제 제품 단계에 적용할 때 주의해야 할 개발 제약이 있습니다. 현재 체인 ID 91342 기반의 기와 세폴리아 테스트넷에서는 누구나 이 성능을 자유롭게 연동해 볼 수 있지만, 정식 출시될 메인넷은 허가된 빌더만 스마트 컨트랙트를 배포할 수 있는 화이트리스트 형태의 프라이빗 체인으로 운영될 예정입니다. 따라서 테스트넷 개발 단계에서 플래시블록 연동 성능을 미리 검증한 후, 메인넷 진입 장벽에 맞춘 설계 및 운영 정책을 함께 고려해야 합니다.\n\nEAS 기반 신원 레이어 — Dojang 프로토콜을 활용한 온체인 규제 준수\n\n기와 체인의 가장 큰 차별점은 EAS 위에 구현된 자체 신원 인증 체계인 도장(Dojang) 프로토콜입니다. 도장은 업비트의 오프체인 실명 계좌 인증 정보를 개인정보 노출 없이 온체인 지갑 주소와 연결해 줍니다. 사용자는 자신의 민감한 개인정보를 밝히지 않고도 KYC 완료 여부만 증명 데이터 형태로 지갑에 담아 활용할 수 있습니다.\n\n개발자는 기와 세폴리아 테스트넷에 배포된 EAS 컨트랙트(0x4200000000000000000000000000000000000021)와 스키마 레지스트리(0x4200000000000000000000000000000000000020)를 통해 신원 데이터를 제어합니다. 특히 검증된 주소 스키마 UID(0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08)를 활용하면 특정 주소의 인증 상태를 온체인에서 즉시 판별할 수 있습니다. 편의성을 위해 제공되는 도장스크롤(DojangScroll) 컨트랙트(0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9)를 이용하면 복잡한 EAS 데이터 파싱 없이 단 한 번의 호출로 검증이 끝납니다.\n\n예를 들어 Solidity 스마트 계약에서 비인가 주소의 접근을 차단하는 규제 준수형 제어 로직은 다음과 같이 구현할 수 있습니다.\n\ninterface IDojangScroll {\n function isVerified(address addr, bytes32 attesterId) external view returns (bool);\n}\n\ncontract VerifiedAction {\n address private constant DOJANG = 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9;\n bytes32 private constant UPBIT = 0xd99b42e778498aa3c9c1f6a012359130252780511687a35982e8e52735453034;\n\n function secureAction() external view {\n require(IDojangScroll(DOJANG).isVerified(msg.sender, UPBIT), \"Forbidden\");\n }\n}\n\n현재 기와 세폴리아 테스트넷(체인 ID: 91342)에서는 누구나 자유롭게 도장 프로토콜을 연동하여 dApp을 빌드할 수 있습니다. 하지만 실제 프로덕션 메인넷은 인가된 서비스만 배포할 수 있는 화이트리스트 방식의 프라이빗 체인으로 운영될 예정입니다. 따라서 빌더들은 테스트넷 단계에서 이 신원 레이어를 적극 활용해 규제 보수적인 디파이나 정산 프로토콜의 작동성을 선제적으로 검증해야 합니다.\n\nL2 빌더를 위한 기와 체인 테스트넷 실전 배포 및 개발 환경\n\n체인 ID 91342를 사용하는 기와 세폴리아 테스트넷은 EVM 호환성을 완벽히 갖추고 있어 Hardhat이나 Foundry 같은 표준 이더리움 개발 도구를 그대로 사용할 수 있습니다. 공식 인프라 파트너인 Nodit이 제공하는 RPC 엔드포인트와 수도꼭지를 통해 누구나 빠르게 개발 환경을 구축하고 스마트 컨트랙트를 배포할 수 있습니다. 특히 트랜잭션당 가스 비용이 약 1원 수준으로 책정되어 소액 결제나 빈번한 온체인 상호작용을 부담 없이 테스트하기에 적합합니다.\n\n다만 개발 시 인지해야 할 핵심 제약은 테스트넷과 메인넷의 운영 모델 차이입니다. 누구나 자유롭게 배포할 수 있는 테스트넷과 달리, 실제 프로덕션이 실행될 기와 메인넷은 사전에 허가된 파트너만 스마트 컨트랙트를 배포하고 사용할 수 있는 화이트리스트 기반의 프라이빗 모델로 구축됩니다. 따라서 빌더들은 메인넷 로드맵을 고려해 초기 기획 단계부터 온체인 접근 권한 구조를 명확히 설계해야 합니다.\n\n이러한 제한된 메인넷 생태계에 진입하기 위한 가장 확실한 경로는 두나무의 빌더 프로그램인 가속(GASOK)입니다. 총 10만 달러 규모의 마일스톤 기반 지원금을 제공하는 이 프로그램은 선발된 팀에게 인프라 및 기술 컨설팅 지원과 함께 향후 비공개 메인넷 배포 권한을 우선적으로 부여합니다.\n\n기와 체인 도입 가이드 — 개발자를 위한 실전 체크리스트\n\n기와 체인은 독자적인 시퀀서 운영과 200ms 미만의 초고속 사전 확정, 그리고 제도권 규제를 준수하는 도장 신원 레이어로 디앱 빌더에게 확실한 매력을 제공합니다. 다만 체인 ID 91342를 사용하는 퍼블릭 테스트넷과 달리, 실제 프로덕션 단계의 메인넷은 화이트리스트 기반의 프라이빗 모델로 배포된다는 제약 조건을 인지하고 진입 전략을 세워야 합니다.\n\n또한 L2 시퀀서의 트랜잭션 수락이 이더리움 메인넷의 최종 확정과 동의어가 아니라는 점, 브릿지 통과 시 롤업 특유의 인출 지연 기간이 존재한다는 점도 아키텍처에 반영해야 합니다. 규제 인지형 계약 설계와 고성능 사용자 경험의 균형을 고민하고 있다면 기와 세폴리아 테스트넷에서 직접 스마트 계약을 배포해 보는 것부터 시작하는 편이 좋습니다.\n\n참고 링크\n\nOptimism Foundation / Dunamu Press Releases — GIWA Chain Architecture & OP Enterprise Self-Managed Strategy\nGIWA Chain Developer Notices — Flashblocks RPC Endpoint & Node Execution Layer\nOptimism Foundation / Dunamu Press Releases — Upbit (Dunamu) Partnering with Optimism Foundation on GIWA Chain",{"_1892":6728,"_1893":6729,"_1802":6730},"GIWA Chain Analysis — What Can You Build with 1-Second Blocks and the Dojang Identity Layer? A new OP Stack chain for enterprises and institutions has emerged in the Ethereum Layer 2 ecosystem. The GIWA chain, built by D…","GIWAチェーン分析 — 1秒ブロックとDojang身元レイヤーで何を作るかイーサリアムのレイヤー2エコシステムに、企業や機関向けの新しいOP Stackチェーンが登場しました。Dunamuが構築したGIWAチェーンは、単なるロールアップを超え、独自の技術構造で差別化された開発環境を提供します。1秒のブロックタイムと200ms未満のフラッシュブロック事前確定技術、そしてEASベースのDojang身元レイヤーは、既存のレイヤー2とは異な…","GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나 이더리움 레이어 2 생태계에 기업과 기관을 위한 새로운 OP Stack 체인이 등장했습니다. 두나무가 구축한 GIWA 체인은 단순한 롤업을 넘어 독자적인 기술 구조로 차별화된 개발 환경을 제공합니다. 1초 블록 타임과 200ms 미만의 플래시블록 사전 확정 기술, 그리고 EAS 기반의 Dojang 신원 레이어는 기존…","cms7ukp2h034110nv66fhd12n",[6733],"framework-release",[6735,6736,6737,6738,6739,6740,995],"giwa-chain","op-stack","ethereum-l","eas","dojang","flashblocks",[],"2026-08-02T01:00:02.649Z","2026-07-30T14:44:33.098Z","2026-08-02T08:07:02.839Z","2026-08-02T03:15:45.567Z","2026-08-02T03:17:18.229Z",{"_950":6709,"_1881":1324,"_1675":-5,"_2489":6748,"_1780":6749,"_1899":6750},"삼코딩","samcoding",{"_1901":6751},{"_1903":6752,"_1908":1909,"_1910":6753,"_1921":6758,"_1943":6771},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":6754,"_1914":6755,"_1810":1916,"_944":1916,"_1917":6756,"_1919":6757},"users/cmqx0mggs00004jcg8uoj3tmt/avatars/original/ab3dc16b-2a30-46ca-a1c9-96bf9e83a479.png","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/avatars/original/ab3dc16b-2a30-46ca-a1c9-96bf9e83a479.png","LeHzhjozJba*#bjbOqX8P6fkrsax","#98c8f8",{"_1923":6759,"_1928":6762,"_1933":6765,"_1938":6768},{"_1912":6760,"_1914":6761,"_1810":1927,"_944":1927},"users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_lg/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_lg/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg",{"_1912":6763,"_1914":6764,"_1810":1932,"_944":1932},"users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_md/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_md/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg",{"_1912":6766,"_1914":6767,"_1810":1937,"_944":1937},"users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_sm/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_sm/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg",{"_1912":6769,"_1914":6770,"_1810":1942,"_944":1942},"users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_xs/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/avatars/avatar_xs/7a67d941168113a11fe63c3b7db8ed176c28dec34eeddb3bd6a5c4864bfdf898_c219c00e386a19a6.jpg","2026-06-27T23:53:03.275Z",{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":6773,"_1883":1884,"_1200":1204,"_1899":6776},{"_633":6774,"_11":6775},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":6777},{"_1903":6778,"_1908":1909,"_1910":6779,"_1921":6780,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":6781,"_1928":6782,"_1933":6783,"_1938":6784},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":6786},{"_1948":-5,"_1908":1909,"_1910":6787,"_1960":-5,"_1943":6793,"_1962":6794},{"_1912":6788,"_1914":6789,"_1952":6790,"_1810":2534,"_944":1992,"_1917":6791,"_1957":2536,"_1919":6792},"users/cmqx0mggs00004jcg8uoj3tmt/images/originals/df9fc617-8988-4f1b-bc1b-dec9b6544452.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/originals/df9fc617-8988-4f1b-bc1b-dec9b6544452.jpg",423116,"L48}Pv00?bD%M|%gIoog00~WD%-;","#182838","2026-07-30T18:28:53.417Z",{"_1964":6795,"_1972":6799,"_1979":6803,"_1986":-5},{"_1912":6796,"_1914":6797,"_1952":6798,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/large.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/large.webp",25662,{"_1912":6800,"_1914":6801,"_1952":6802,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/small.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/small.webp",6046,{"_1912":6804,"_1914":6805,"_1952":6806,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/medium.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms7ukp2h034110nv66fhd12n/medium.webp",13756,{"_950":6808,"_2559":6708,"_2560":6809,"_2716":7137,"_2788":7255,"_2790":7256,"_2792":3640,"_2794":1997,"_2003":7257,"_2480":7258,"_2797":-5},"cms7mk7gv02v410nvxuzo3d7g",{"_918":6810,"_1908":1909},[6811,6814,6818,6823,6827,6833,6837,6843,6847,6853,6857,6863,6867,6873,6877,6883,6887,6893,6897,6903,6907,6918,6922,6928,6932,6938,6942,6948,6952,6958,6962,6988,6992,6998,7002,7006,7010,7016,7020,7026,7030,7036,7040,7046,7050,7056,7060,7066,7070,7076,7080,7086,7090,7092,7096,7102,7106,7133],{"_950":6812,"_2565":6722,"_2420":2566,"_3202":591,"_3203":6813,"_2567":6731},"982019e5-e860-44af-addf-2eb80bd88d34",{"_3205":591},{"_950":6815,"_2420":2570,"_3203":6816,"_2571":6817},"93d6b75c-c05e-488e-9677-dc33bb01eb10",{"_3205":591},[],{"_950":6819,"_2420":2575,"_2576":1909,"_3203":6820,"_2571":6821},"4ae56c1c-af42-444a-ab40-23ec4520c570",{"_3205":591},[6822],{"_2579":6722,"_2420":2579},{"_950":6824,"_2420":2570,"_3203":6825,"_2571":6826},"d19d8c6a-2a31-42e1-8e65-eb4ff8aa6f80",{"_3205":591},[],{"_950":6828,"_2420":2570,"_3203":6829,"_2571":6830},"bcb33573-1475-42ef-bf0b-5d7117d8654c",{"_3205":591},[6831],{"_2579":6832,"_2420":2579},"이더리움 레이어 2 생태계에 기업과 기관을 위한 새로운 OP Stack 체인이 등장했습니다. 두나무가 구축한 GIWA 체인은 단순한 롤업을 넘어 독자적인 기술 구조로 차별화된 개발 환경을 제공합니다. 1초 블록 타임과 200ms 미만의 플래시블록 사전 확정 기술, 그리고 EAS 기반의 Dojang 신원 레이어는 기존 레이어 2와 다른 성능과 규제 준수 환경을 제시합니다. 테스트넷을 통해 지금 바로 실전에서 적용 가능한 기술적 핵심 요소와 개발자 관점의 변화를 분석합니다.",{"_950":6834,"_2420":2570,"_3203":6835,"_2571":6836},"7991b4bb-d014-4545-a180-6740a4cf3dbc",{"_3205":591},[],{"_950":6838,"_2420":2575,"_2576":2007,"_3203":6839,"_2571":6840},"bf888319-5761-4926-89d1-2a437f372c39",{"_3205":591},[6841],{"_2579":6842,"_2420":2579},"독자적인 시퀀서와 1초 블록 — OP Enterprise Self-Managed 아키텍처",{"_950":6844,"_2420":2570,"_3203":6845,"_2571":6846},"04f71e7d-16bd-4b1d-8376-433ae1c78787",{"_3205":591},[],{"_950":6848,"_2420":2570,"_3203":6849,"_2571":6850},"985fc5c8-6119-43d9-a3d9-039d3e3528de",{"_3205":591},[6851],{"_2579":6852,"_2420":2579},"기와 체인은 OP Stack 기반 레이어 2로, 오프티미즘의 기업용 라이선스인 OP Enterprise의 Self-Managed 티어를 최초로 적용했습니다. 공유 시퀀서 풀을 사용하는 일반적인 롤업과 달리 두나무가 시퀀서를 독자적으로 운영합니다. 덕분에 트랜잭션 순서 정렬 규칙과 블록 공간 운영 정책을 기업 요구사항에 맞춰 완전히 제어할 수 있는 주권을 가집니다.",{"_950":6854,"_2420":2570,"_3203":6855,"_2571":6856},"5f681c13-81d1-4a4a-b9fa-31bce7005c03",{"_3205":591},[],{"_950":6858,"_2420":2570,"_3203":6859,"_2571":6860},"168db9f9-3bc6-4180-8b34-9de90eda64ca",{"_3205":591},[6861],{"_2579":6862,"_2420":2579},"또한 표준 OP Stack의 2초 블록 타임을 1초로 단축해 트랜잭션 처리 지연을 절반으로 줄였습니다. 현재 체인 ID 91342인 기와 세폴리아 테스트넷에서 자유롭게 빌딩할 수 있지만, 향후 프로덕션 메인넷은 인가된 파트너만 참여할 수 있는 프라이빗 화이트리스트 형태로 배포될 예정입니다. 빌더들은 메인넷 배포 단계에서 요구될 접근 권한 제약 사항을 아키텍처 설계 시 미리 염두에 두어야 합니다.",{"_950":6864,"_2420":2570,"_3203":6865,"_2571":6866},"d344ad3c-8ba3-48bf-bc9e-3ccf8bdb9efc",{"_3205":591},[],{"_950":6868,"_2420":2570,"_3203":6869,"_2571":6870},"060eb469-bce4-42c8-89d0-4371f6dc01d5",{"_3205":591},[6871],{"_2579":6872,"_2420":2579},"실행 레이어의 성능을 한계까지 끌어올리기 위한 노드 인프라 최적화도 눈여겨볼 만합니다. 2026년 7월 진행된 카스트 하드포크 이후 기존 op-geth 지원은 공식 종료되었으며, Rust 기반 고성능 클라이언트인 op-reth로 실행 레이어가 완전히 이전되었습니다. 이번 업그레이드로 트랜잭션당 가스 한도가 16,777,216 가스로 제한되고, P256VERIFY 프리컴파일 가스 비용이 6,900 가스로 조정되는 등 엔진 레벨의 규칙 변화가 적용되었으므로 컨트랙트 최적화 시 참고해야 합니다.",{"_950":6874,"_2420":2570,"_3203":6875,"_2571":6876},"d3aec3fe-1889-4d49-9e51-d209383ff820",{"_3205":591},[],{"_950":6878,"_2420":2575,"_2576":2007,"_3203":6879,"_2571":6880},"342ac294-2628-4887-bb45-b4877bdd7966",{"_3205":591},[6881],{"_2579":6882,"_2420":2579},"200ms 미만의 사용자 경험 — 플래시블록 RPC 연동",{"_950":6884,"_2420":2570,"_3203":6885,"_2571":6886},"2b0598b9-da0a-4708-a72b-96383710a011",{"_3205":591},[],{"_950":6888,"_2420":2570,"_3203":6889,"_2571":6890},"3c3b9277-b862-4c8c-9c99-be04ae3d5734",{"_3205":591},[6891],{"_2579":6892,"_2420":2579},"온체인 결제나 실시간 게임처럼 즉각적인 반응이 필요한 분야에서는 1초의 블록 타임조차 대기 시간으로 느껴질 수 있습니다. 기와 체인은 트랜잭션이 블록에 최종 기록되기 전, 200ms 미만의 속도로 사전 확정을 제공하는 플래시블록 기술을 도입하여 이 문제를 해결합니다.",{"_950":6894,"_2420":2570,"_3203":6895,"_2571":6896},"8895752f-bc7b-40c3-8b00-f2b81ffcace3",{"_3205":591},[],{"_950":6898,"_2420":2570,"_3203":6899,"_2571":6900},"a8a2ee75-a10e-4cfb-bdaf-b3859448cb90",{"_3205":591},[6901],{"_2579":6902,"_2420":2579},"개발자는 기와 세폴리아 테스트넷에서 제공하는 전용 RPC 엔드포인트를 사용해 이 초고속 사용자 경험을 직접 구현하고 테스트할 수 있습니다.",{"_950":6904,"_2420":2570,"_3203":6905,"_2571":6906},"bc6c9632-02cc-48cb-b40a-46875035bcd2",{"_3205":591},[],{"_950":6908,"_1881":3492,"_2420":3493,"_778":6909},"6b89ad56-2418-4d6a-8066-cd418673c438",[6910],{"_950":6911,"_2571":6912},"6c3ad320-6469-44d1-87e8-84dd3888864e",[6913,6915],{"_2579":6914,"_2420":2579},"플래시블록 전용 RPC 엔드포인트: ",{"_2579":6916,"_2420":2579,"_3365":6917},"https://sepolia-rpc-flashblocks.giwa.io",{"_3351":3367},{"_950":6919,"_2420":2570,"_3203":6920,"_2571":6921},"8cbf7c44-1248-45a7-85d9-e24e1298160a",{"_3205":591},[],{"_950":6923,"_2420":2570,"_3203":6924,"_2571":6925},"f82bda34-b8d3-4db0-82cc-5dfa0acbb56c",{"_3205":591},[6926],{"_2579":6927,"_2420":2579},"해당 엔드포인트를 연동하면 트랜잭션이 멤풀에 머무는 동안 노드가 즉각 전송하는 사전 확정 신호를 받아 프론트엔드 화면을 실시간으로 업데이트할 수 있습니다. 기존 L2 노드가 트랜잭션을 수신하고 가스를 추정한 뒤 블록을 완전히 생성하기까지 발생하던 병목을 보완하여 웹2에 준하는 매끄러운 반응성을 보장합니다.",{"_950":6929,"_2420":2570,"_3203":6930,"_2571":6931},"8dfcd91b-7ead-428e-bab7-c95cf1c6dfe6",{"_3205":591},[],{"_950":6933,"_2420":2570,"_3203":6934,"_2571":6935},"798dcff1-d1ea-4711-984a-b52d45559b3e",{"_3205":591},[6936],{"_2579":6937,"_2420":2579},"다만 실제 제품 단계에 적용할 때 주의해야 할 개발 제약이 있습니다. 현재 체인 ID 91342 기반의 기와 세폴리아 테스트넷에서는 누구나 이 성능을 자유롭게 연동해 볼 수 있지만, 정식 출시될 메인넷은 허가된 빌더만 스마트 컨트랙트를 배포할 수 있는 화이트리스트 형태의 프라이빗 체인으로 운영될 예정입니다. 따라서 테스트넷 개발 단계에서 플래시블록 연동 성능을 미리 검증한 후, 메인넷 진입 장벽에 맞춘 설계 및 운영 정책을 함께 고려해야 합니다.",{"_950":6939,"_2420":2570,"_3203":6940,"_2571":6941},"0cad5608-dfea-4e5b-9e65-56c5f8877ec0",{"_3205":591},[],{"_950":6943,"_2420":2575,"_2576":2007,"_3203":6944,"_2571":6945},"f569a8dc-3a27-4b8d-b7c3-2b7b1fd56c5f",{"_3205":591},[6946],{"_2579":6947,"_2420":2579},"EAS 기반 신원 레이어 — Dojang 프로토콜을 활용한 온체인 규제 준수",{"_950":6949,"_2420":2570,"_3203":6950,"_2571":6951},"17bb8476-016e-406f-80c4-30dde81c65c0",{"_3205":591},[],{"_950":6953,"_2420":2570,"_3203":6954,"_2571":6955},"cb15097f-52ea-402f-87ad-a07d822366d7",{"_3205":591},[6956],{"_2579":6957,"_2420":2579},"기와 체인의 가장 큰 차별점은 EAS 위에 구현된 자체 신원 인증 체계인 도장(Dojang) 프로토콜입니다. 도장은 업비트의 오프체인 실명 계좌 인증 정보를 개인정보 노출 없이 온체인 지갑 주소와 연결해 줍니다. 사용자는 자신의 민감한 개인정보를 밝히지 않고도 KYC 완료 여부만 증명 데이터 형태로 지갑에 담아 활용할 수 있습니다.",{"_950":6959,"_2420":2570,"_3203":6960,"_2571":6961},"b0540f33-7ceb-436f-88dd-6e3ed00302b6",{"_3205":591},[],{"_950":6963,"_2420":2570,"_3203":6964,"_2571":6965},"4df25366-136d-4c3a-b886-296f03556570",{"_3205":591},[6966,6968,6971,6973,6976,6978,6981,6983,6986],{"_2579":6967,"_2420":2579},"개발자는 기와 세폴리아 테스트넷에 배포된 EAS 컨트랙트(",{"_2579":6969,"_2420":2579,"_3365":6970},"0x4200000000000000000000000000000000000021",{"_3351":3367},{"_2579":6972,"_2420":2579},")와 스키마 레지스트리(",{"_2579":6974,"_2420":2579,"_3365":6975},"0x4200000000000000000000000000000000000020",{"_3351":3367},{"_2579":6977,"_2420":2579},")를 통해 신원 데이터를 제어합니다. 특히 검증된 주소 스키마 UID(",{"_2579":6979,"_2420":2579,"_3365":6980},"0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08",{"_3351":3367},{"_2579":6982,"_2420":2579},")를 활용하면 특정 주소의 인증 상태를 온체인에서 즉시 판별할 수 있습니다. 편의성을 위해 제공되는 도장스크롤(DojangScroll) 컨트랙트(",{"_2579":6984,"_2420":2579,"_3365":6985},"0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9",{"_3351":3367},{"_2579":6987,"_2420":2579},")를 이용하면 복잡한 EAS 데이터 파싱 없이 단 한 번의 호출로 검증이 끝납니다.",{"_950":6989,"_2420":2570,"_3203":6990,"_2571":6991},"6be9f74a-04c0-4a69-80e9-709b111d93ba",{"_3205":591},[],{"_950":6993,"_2420":2570,"_3203":6994,"_2571":6995},"bdaf489f-bc30-4aab-82e4-76bccb75aa7c",{"_3205":591},[6996],{"_2579":6997,"_2420":2579},"예를 들어 Solidity 스마트 계약에서 비인가 주소의 접근을 차단하는 규제 준수형 제어 로직은 다음과 같이 구현할 수 있습니다.",{"_950":6999,"_2420":2570,"_3203":7000,"_2571":7001},"9897f125-7caf-4e1d-a4ea-d16296e50f95",{"_3205":591},[],{"_950":7003,"_3351":7004,"_2420":3351,"_625":7005},"6d7fce68-3326-43f6-ac6a-26bb63d225d3","interface IDojangScroll {\n function isVerified(address addr, bytes32 attesterId) external view returns (bool);\n}\n\ncontract VerifiedAction {\n address private constant DOJANG = 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9;\n bytes32 private constant UPBIT = 0xd99b42e778498aa3c9c1f6a012359130252780511687a35982e8e52735453034;\n\n function secureAction() external view {\n require(IDojangScroll(DOJANG).isVerified(msg.sender, UPBIT), \"Forbidden\");\n }\n}","solidity",{"_950":7007,"_2420":2570,"_3203":7008,"_2571":7009},"30776e86-23d8-46d3-8789-8c25f1f9abeb",{"_3205":591},[],{"_950":7011,"_2420":2570,"_3203":7012,"_2571":7013},"f02e244d-68e2-424f-99e5-b33ec0ef703f",{"_3205":591},[7014],{"_2579":7015,"_2420":2579},"현재 기와 세폴리아 테스트넷(체인 ID: 91342)에서는 누구나 자유롭게 도장 프로토콜을 연동하여 dApp을 빌드할 수 있습니다. 하지만 실제 프로덕션 메인넷은 인가된 서비스만 배포할 수 있는 화이트리스트 방식의 프라이빗 체인으로 운영될 예정입니다. 따라서 빌더들은 테스트넷 단계에서 이 신원 레이어를 적극 활용해 규제 보수적인 디파이나 정산 프로토콜의 작동성을 선제적으로 검증해야 합니다.",{"_950":7017,"_2420":2570,"_3203":7018,"_2571":7019},"25cb493a-9008-4a13-92fb-724b9384372a",{"_3205":591},[],{"_950":7021,"_2420":2575,"_2576":2007,"_3203":7022,"_2571":7023},"3a8bb84f-1823-4892-a9ad-003cf42d20aa",{"_3205":591},[7024],{"_2579":7025,"_2420":2579},"L2 빌더를 위한 기와 체인 테스트넷 실전 배포 및 개발 환경",{"_950":7027,"_2420":2570,"_3203":7028,"_2571":7029},"c99c91ea-a695-436e-b965-28695fa2062b",{"_3205":591},[],{"_950":7031,"_2420":2570,"_3203":7032,"_2571":7033},"b1260640-041d-4497-91a6-85fe5d7dc2a0",{"_3205":591},[7034],{"_2579":7035,"_2420":2579},"체인 ID 91342를 사용하는 기와 세폴리아 테스트넷은 EVM 호환성을 완벽히 갖추고 있어 Hardhat이나 Foundry 같은 표준 이더리움 개발 도구를 그대로 사용할 수 있습니다. 공식 인프라 파트너인 Nodit이 제공하는 RPC 엔드포인트와 수도꼭지를 통해 누구나 빠르게 개발 환경을 구축하고 스마트 컨트랙트를 배포할 수 있습니다. 특히 트랜잭션당 가스 비용이 약 1원 수준으로 책정되어 소액 결제나 빈번한 온체인 상호작용을 부담 없이 테스트하기에 적합합니다.",{"_950":7037,"_2420":2570,"_3203":7038,"_2571":7039},"34a28d6d-e814-4135-aa58-3880971c4715",{"_3205":591},[],{"_950":7041,"_2420":2570,"_3203":7042,"_2571":7043},"d41a1cd3-2eec-4fd4-98b5-0e0155d5e959",{"_3205":591},[7044],{"_2579":7045,"_2420":2579},"다만 개발 시 인지해야 할 핵심 제약은 테스트넷과 메인넷의 운영 모델 차이입니다. 누구나 자유롭게 배포할 수 있는 테스트넷과 달리, 실제 프로덕션이 실행될 기와 메인넷은 사전에 허가된 파트너만 스마트 컨트랙트를 배포하고 사용할 수 있는 화이트리스트 기반의 프라이빗 모델로 구축됩니다. 따라서 빌더들은 메인넷 로드맵을 고려해 초기 기획 단계부터 온체인 접근 권한 구조를 명확히 설계해야 합니다.",{"_950":7047,"_2420":2570,"_3203":7048,"_2571":7049},"eb8a4b77-4a7f-429c-a01d-575acaf78304",{"_3205":591},[],{"_950":7051,"_2420":2570,"_3203":7052,"_2571":7053},"5ac5a199-34bf-4ccb-9b61-9825e8a5db9a",{"_3205":591},[7054],{"_2579":7055,"_2420":2579},"이러한 제한된 메인넷 생태계에 진입하기 위한 가장 확실한 경로는 두나무의 빌더 프로그램인 가속(GASOK)입니다. 총 10만 달러 규모의 마일스톤 기반 지원금을 제공하는 이 프로그램은 선발된 팀에게 인프라 및 기술 컨설팅 지원과 함께 향후 비공개 메인넷 배포 권한을 우선적으로 부여합니다.",{"_950":7057,"_2420":2570,"_3203":7058,"_2571":7059},"f0939c14-27fe-412d-88f6-ddcdf6fb6e22",{"_3205":591},[],{"_950":7061,"_2420":2575,"_2576":2007,"_3203":7062,"_2571":7063},"c1028da1-c956-4030-8bbc-0a3415dbc68c",{"_3205":591},[7064],{"_2579":7065,"_2420":2579},"기와 체인 도입 가이드 — 개발자를 위한 실전 체크리스트",{"_950":7067,"_2420":2570,"_3203":7068,"_2571":7069},"0d52d51f-14b4-444e-a407-46f798aee0b4",{"_3205":591},[],{"_950":7071,"_2420":2570,"_3203":7072,"_2571":7073},"f4caae86-7ac2-493b-b81f-1e784b423c73",{"_3205":591},[7074],{"_2579":7075,"_2420":2579},"기와 체인은 독자적인 시퀀서 운영과 200ms 미만의 초고속 사전 확정, 그리고 제도권 규제를 준수하는 도장 신원 레이어로 디앱 빌더에게 확실한 매력을 제공합니다. 다만 체인 ID 91342를 사용하는 퍼블릭 테스트넷과 달리, 실제 프로덕션 단계의 메인넷은 화이트리스트 기반의 프라이빗 모델로 배포된다는 제약 조건을 인지하고 진입 전략을 세워야 합니다.",{"_950":7077,"_2420":2570,"_3203":7078,"_2571":7079},"eedc441b-f094-48ef-852b-3e3f4f21c87d",{"_3205":591},[],{"_950":7081,"_2420":2570,"_3203":7082,"_2571":7083},"51bec7b1-11b2-4c80-b3af-3c8d4c0c21e6",{"_3205":591},[7084],{"_2579":7085,"_2420":2579},"또한 L2 시퀀서의 트랜잭션 수락이 이더리움 메인넷의 최종 확정과 동의어가 아니라는 점, 브릿지 통과 시 롤업 특유의 인출 지연 기간이 존재한다는 점도 아키텍처에 반영해야 합니다. 규제 인지형 계약 설계와 고성능 사용자 경험의 균형을 고민하고 있다면 기와 세폴리아 테스트넷에서 직접 스마트 계약을 배포해 보는 것부터 시작하는 편이 좋습니다.",{"_950":7087,"_2420":2570,"_3203":7088,"_2571":7089},"d30a6d88-0085-4bd7-a4a4-d17c0723eee9",{"_3205":591},[],{"_950":7091,"_2420":3473},"7571120e-388d-4cbc-a3be-f61e6a3fea8d",{"_950":7093,"_2420":2570,"_3203":7094,"_2571":7095},"6c238d20-c9f6-4652-a920-d585d5ddfe9f",{"_3205":591},[],{"_950":7097,"_2420":2570,"_3203":7098,"_2571":7099},"58ddccb2-8a5a-4880-829b-397b90a86986",{"_3205":591},[7100],{"_2579":3483,"_2420":2579,"_3365":7101},{"_3485":3367},{"_950":7103,"_2420":2570,"_3203":7104,"_2571":7105},"7eecd78b-60c9-447a-97fc-50a30766e408",{"_3205":591},[],{"_950":7107,"_1881":3492,"_2420":3493,"_778":7108},"ef2a2ab2-b778-4ca9-8f76-5dd4f2e05c04",[7109,7117,7125],{"_950":7110,"_2571":7111},"5c68b061-402e-4bb8-ac49-579d52c7b493",[7112],{"_3499":7113,"_2420":3501,"_3502":7114},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFVsFTca4gg6lBkKUaGGTbfE59ebGHFTfLnDOBQwLdUOxBQLX_0as-ngZXI6UzdDfWMi5HrpW0Aa8SDEG8k5RT9iRWCs9Vx89GY6STaqwgf6Cv6XAdoJP9INRp4MLdtRcqfpu60PuiyKDAyRCXmQA8WFQQL6OjO9szUzmXe1HRy4rr1Y9Oa--injIyGSwRvlN8k-9U4kZ3FEE8POaNExpOJy8P9qogAwKm9WZMJLEIydND1HD4=",[7115],{"_2579":7116,"_2420":2579},"Optimism Foundation / Dunamu Press Releases — GIWA Chain Architecture & OP Enterprise Self-Managed Strategy",{"_950":7118,"_2571":7119},"0f1c3213-9566-40e3-b70b-23057d4bae88",[7120],{"_3499":7121,"_2420":3501,"_3502":7122},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQG-xdNzCk7hjbBoI_F3fHRknc1JjoiMerP_W8t-pfFhSNZiKuPvqRYCF8mvl7eee3X6MRFfotpOD9_N-0ODD1GOSyCXkbAsQ7_d02MHfMm_o3hNGSweGjoC0mUWYZgmXXBopfh1PJh9jyvE",[7123],{"_2579":7124,"_2420":2579},"GIWA Chain Developer Notices — Flashblocks RPC Endpoint & Node Execution Layer",{"_950":7126,"_2571":7127},"552992d5-7baa-44a1-ba0b-fd325c38ec3d",[7128],{"_3499":7129,"_2420":3501,"_3502":7130},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQHg8iaKn9VIglMUo-mGO7ENMWV7ggC7LoJtaxLJ6-uo4vkVIrSpK7G0v0fl_NGZSyrQbGy4gUq0IJpXp1v6HacIk-grbk-1zBS3RvMpZcGAlynfnqAdoM5Y_MEEWeFrOrmzGm36a2hdy9gjrppSdcphe5bu-qtWFIYgoQHjvRuUQ6vclq7rmzbOer12LEwQAvVLC7AGiNxd5lhfvic8g78h_o1HJRiO13HP97ZrVV6x-fHWGcc=",[7131],{"_2579":7132,"_2420":2579},"Optimism Foundation / Dunamu Press Releases — Upbit (Dunamu) Partnering with Optimism Foundation on GIWA Chain",{"_950":7134,"_2420":2570,"_3203":7135,"_2571":7136},"70d9c223-4226-419a-97d2-8be0286e1706",{"_3205":591},[],{"_6868":7138,"_6858":7142,"_6878":7146,"_7021":7150,"_6888":7154,"_6819":7158,"_6963":7160,"_7081":7165,"_7169":7170,"_7180":7181,"_7097":7187,"_7051":7189,"_6908":7193,"_6933":7195,"_6848":7199,"_6898":7203,"_7031":7207,"_6828":7211,"_6993":7215,"_6838":7219,"_7061":7223,"_6953":7227,"_7041":7231,"_7107":7235,"_7011":7239,"_7071":7243,"_6943":7247,"_6923":7251},{"_2571":7139},{"_1892":7140,"_1893":7141,"_1802":6872},"The optimization of the node infrastructure to push execution layer performance to its limit is also noteworthy. Following the Kast hard fork in July 2026, official support for the legacy op-geth was discontinued, and the execution layer was fully migrated to op-reth, a high-performance Rust-based client. Engine-level rule changes, such as limiting the gas per transaction to 16,777,216 and adjusting P256VERIFY precompile gas costs to 6,900, have been applied, so these should be considered when optimizing contracts.","実行レイヤーのパフォーマンスを限界まで引き出すためのノードインフラ最適化にも注目です。2026年7月に行われたKastハードフォーク以降、従来のop-gethのサポートは公式に終了し、Rustベースの高性能クライアントであるop-rethへと実行レイヤーが完全に移行しました。今回のアップグレードにより、トランザクションあたりのガス上限が16,777,216ガスに制限され、P256VERIFYプリコンパイルのガス料金が6,900ガスに調整されるなど、エンジンレベルのルール変更が適用されたため、コントラクトの最適化時に参考にしてください。",{"_2571":7143},{"_1892":7144,"_1893":7145,"_1802":6862},"Furthermore, it has reduced transaction latency by half by shortening the standard OP Stack 2-second block time to 1 second. While you can currently build freely on the GIWA Sepolia testnet (Chain ID 91342), the future production mainnet will be deployed as a private, whitelisted environment accessible only to authorized partners. Builders should keep in mind the potential access restrictions for the mainnet deployment during their architecture design phase.","また、標準的なOP Stackの2秒ブロックタイムを1秒に短縮し、トランザクション処理の遅延を半分に短縮しました。現在はチェーンID 91342のGIWA Sepoliaテストネットで自由にビルドできますが、今後のプロダクションメインネットは、承認されたパートナーのみが参加できるプライベートなホワイトリスト形式で配布される予定です。ビルダーは、メインネット配布段階で要求されるアクセス権制限事項を、アーキテクチャ設計時にあらかじめ考慮しておく必要があります。",{"_2571":7147},{"_1892":7148,"_1893":7149,"_1802":6882},"User Experience Under 200ms — Flashblocks RPC Integration","200ms未満のユーザーエクスペリエンス — フラッシュブロックRPC連携",{"_2571":7151},{"_1892":7152,"_1893":7153,"_1802":7025},"GIWA Chain Testnet Practical Deployment and Development Environment for L2 Builders","L2ビルダーのためのGIWAチェーンテストネット実戦デプロイおよび開発環境",{"_2571":7155},{"_1892":7156,"_1893":7157,"_1802":6892},"For fields requiring immediate response, such as on-chain payments or real-time gaming, even a 1-second block time can feel like a delay. The GIWA chain solves this by introducing flashblock technology, providing pre-confirmation in under 200ms before transactions are finally recorded in a block.","オンチェーン決済やリアルタイムゲームのように即時反応が必要な分野では、1秒のブロックタイムですら待ち時間に感じられることがあります。GIWAチェーンは、トランザクションがブロックに最終記録される前、200ms未満の速度で事前確定を提供する「フラッシュブロック」技術を導入することで、この問題を解決します。",{"_2571":7159},{"_1892":6720,"_1893":6721,"_1802":6722},{"_2571":7161},{"_1892":7162,"_1893":7163,"_1802":7164},"Developers control identity data through the EAS contract (0x4200000000000000000000000000000000000021) and schema registry (0x4200000000000000000000000000000000000020) deployed on the GIWA Sepolia testnet. Specifically, by using the verified address schema UID (0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08), you can instantly determine the verification status of a specific address on-chain. For convenience, the DojangScroll contract (0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9) allows verification in a single call, eliminating the need for complex EAS data parsing.","開発者は、GIWA SepoliaテストネットにデプロイされたEASコントラクト（0x4200000000000000000000000000000000000021）とスキーマレジストリ（0x4200000000000000000000000000000000000020）を通じて身元データを制御します。特に「検証済みアドレススキーマUID」（0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08）を活用すれば、特定アドレスの認証状態をオンチェーンで即座に判別可能です。利便性のために提供されるDojangScrollコントラクト（0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9）を利用すれば、複雑なEASデータのパースなしで、わずか1回の呼び出しで検証が完了します。","개발자는 기와 세폴리아 테스트넷에 배포된 EAS 컨트랙트(0x4200000000000000000000000000000000000021)와 스키마 레지스트리(0x4200000000000000000000000000000000000020)를 통해 신원 데이터를 제어합니다. 특히 검증된 주소 스키마 UID(0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08)를 활용하면 특정 주소의 인증 상태를 온체인에서 즉시 판별할 수 있습니다. 편의성을 위해 제공되는 도장스크롤(DojangScroll) 컨트랙트(0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9)를 이용하면 복잡한 EAS 데이터 파싱 없이 단 한 번의 호출로 검증이 끝납니다.",{"_2571":7166},{"_1892":7167,"_1893":7168,"_1802":7085},"Furthermore, your architecture should account for the fact that transaction acceptance by the L2 sequencer is not synonymous with final confirmation on the Ethereum mainnet, and that there is a withdrawal delay period characteristic of rollups when passing through the bridge. If you are deliberating on the balance between regulatory-aware contract design and high-performance user experience, it is recommended to start by deploying a smart contract on the GIWA Sepolia testnet.","また、L2シーケンサーによるトランザクションの承認がイーサリアムメインネットの最終確定と同義ではないこと、ブリッジ通過時にロールアップ特有の引き出し遅延期間が存在することなどもアーキテクチャに反映させなければなりません。規制を考慮したコントラクト設計と高性能なユーザー体験の両立を検討しているなら、まずはGIWA Sepoliaテストネットでスマートコントラクトをデプロイしてみることから始めるのが良いでしょう。","555368bc-2da3-4a6f-b19e-4f7998a7f2b9",{"_7171":7172,"_7174":7175,"_7177":7178},"item:0f1c3213-9566-40e3-b70b-23057d4bae88",{"_1892":7124,"_1893":7173,"_1802":7124},"GIWAチェーン開発者通知 — フラッシュブロックRPCエンドポイントおよびノード実行レイヤー","item:552992d5-7baa-44a1-ba0b-fd325c38ec3d",{"_1892":7132,"_1893":7176,"_1802":7132},"Optimism Foundation / Dunamu プレスリリース — Upbit（Dunamu）とOptimism FoundationのGIWAチェーンにおける提携","item:5c68b061-402e-4bb8-ac49-579d52c7b493",{"_1892":7116,"_1893":7179,"_1802":7116},"Optimism Foundation / Dunamu プレスリリース — GIWAチェーンアーキテクチャおよびOP Enterprise Self-Managed戦略","5799388f-8fe2-423a-aefe-329715878137",{"_7182":7183},"item:6c3ad320-6469-44d1-87e8-84dd3888864e",{"_1892":7184,"_1893":7185,"_1802":7186},"Flashblocks-dedicated RPC endpoint: https://sepolia-rpc-flashblocks.giwa.io","フラッシュブロック専用RPCエンドポイント: https://sepolia-rpc-flashblocks.giwa.io","플래시블록 전용 RPC 엔드포인트: https://sepolia-rpc-flashblocks.giwa.io",{"_2571":7188},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":7190},{"_1892":7191,"_1893":7192,"_1802":7055},"The most definitive path to entering this restricted mainnet ecosystem is GASOK, Dunamu's builder program. This program, which provides a total of $100,000 in milestone-based grants, offers selected teams infrastructure and technical consulting support, as well as priority rights for future private mainnet deployment.","このような制限されたメインネットエコシステムに参入するための最も確実なルートは、Dunamuのビルダープログラム「GASOK」です。総額10万ドル規模のマイルストーンベースの助成金を提供するこのプログラムは、選抜されたチームに対してインフラおよび技術コンサルティングの支援を行うとともに、将来的に非公開のメインネットへのデプロイ権限を優先的に付与します。",{"_7182":7194},{"_1892":7184,"_1893":7185,"_1802":7186},{"_2571":7196},{"_1892":7197,"_1893":7198,"_1802":6937},"However, there are development constraints to note for real-world product applications. While anyone can freely integrate this performance on the Chain ID 91342-based GIWA Sepolia testnet, the official mainnet will operate as a private, whitelist-based chain where only authorized builders can deploy smart contracts. Therefore, after validating the flashblock integration performance during the testnet development phase, you must account for the design and operational policies suited to the mainnet entry barriers.","ただし、実際の製品段階に適用する際には注意すべき開発制限があります。現在、チェーンID 91342ベースのGIWA Sepoliaテストネットでは誰でもこのパフォーマンスを自由に連携して試せますが、正式にリリースされるメインネットは、許可されたビルダーのみがスマートコントラクトをデプロイできるホワイトリスト形式のプライベートチェーンとして運営される予定です。そのため、テストネットでの開発段階でフラッシュブロック連携のパフォーマンスを検証した後、メインネットの参入障壁に合わせた設計や運営方針をあわせて考慮する必要があります。",{"_2571":7200},{"_1892":7201,"_1893":7202,"_1802":6852},"The GIWA chain is an OP Stack-based Layer 2, making it the first to implement the Self-Managed tier of OP Enterprise, Optimism's enterprise-grade license. Unlike typical rollups that use a shared sequencer pool, Dunamu operates its sequencer independently. This grants them full sovereignty to control transaction ordering rules and block space operation policies in line with enterprise requirements.","GIWAチェーンはOP Stackベースのレイヤー2であり、Optimismの企業向けライセンスである「OP Enterprise」のSelf-Managedティアを初めて適用しました。共有シーケンサープールを使用する一般的なロールアップと異なり、Dunamuがシーケンサーを独自に運営します。そのため、トランザクションの順序付けルールやブロック領域の運営方針を企業の要件に合わせて完全に制御できる主権を持っています。",{"_2571":7204},{"_1892":7205,"_1893":7206,"_1802":6902},"Developers can implement and test this ultra-fast user experience directly using the dedicated RPC endpoint provided by the GIWA Sepolia testnet.","開発者は、GIWA Sepoliaテストネットで提供される専用RPCエンドポイントを使用して、この超高速なユーザーエクスペリエンスを直接実装およびテストできます。",{"_2571":7208},{"_1892":7209,"_1893":7210,"_1802":7035},"The GIWA Sepolia testnet, using Chain ID 91342, is fully EVM-compatible, allowing the use of standard Ethereum development tools such as Hardhat or Foundry. Through RPC endpoints and faucets provided by the official infrastructure partner, Nodit, anyone can quickly set up a development environment and deploy smart contracts. Notably, gas costs are set at approximately 1 KRW per transaction, making it ideal for testing micro-payments or frequent on-chain interactions without cost burdens.","チェーンID 91342を使用するGIWA Sepoliaテストネットは、EVM互換性を完全に備えており、HardhatやFoundryのような標準的なイーサリアム開発ツールをそのまま使用できます。公式インフラパートナーのNoditが提供するRPCエンドポイントとフォーセットを通じて、誰でも迅速に開発環境を構築し、スマートコントラクトをデプロイ可能です。特に、トランザクションあたりのガス料金が約1ウォン水準に設定されているため、少額決済や頻繁なオンチェーンインタラクションを気軽にテストするのに最適です。",{"_2571":7212},{"_1892":7213,"_1893":7214,"_1802":6832},"A new OP Stack chain for enterprises and institutions has emerged in the Ethereum Layer 2 ecosystem. The GIWA chain, built by Dunamu, goes beyond a simple rollup to offer a differentiated development environment through a proprietary technical structure. Features such as 1-second block times, sub-200ms flashblock pre-confirmation technology, and the EAS-based Dojang identity layer provide a performance and regulatory compliance environment distinct from existing Layer 2 solutions. We analyze the technical core elements currently applicable in practice through the testnet and the shifts from a developer's perspective.","イーサリアムのレイヤー2エコシステムに、企業や機関向けの新しいOP Stackチェーンが登場しました。Dunamuが構築したGIWAチェーンは、単なるロールアップを超え、独自の技術構造で差別化された開発環境を提供します。1秒のブロックタイムと200ms未満のフラッシュブロック事前確定技術、そしてEASベースのDojang身元レイヤーは、既存のレイヤー2とは異なるパフォーマンスと規制遵守環境を提示します。テストネットを通じて、今すぐ実戦で適用可能な技術的コア要素と、開発者視点での変化を分析します。",{"_2571":7216},{"_1892":7217,"_1893":7218,"_1802":6997},"For example, regulatory-compliant control logic that blocks access to unauthorized addresses in a Solidity smart contract can be implemented as follows:","例えば、Solidityスマートコントラクトで未承認アドレスのアクセスを遮断する、規制遵守型の制御ロジックは以下のように実装できます。",{"_2571":7220},{"_1892":7221,"_1893":7222,"_1802":6842},"Proprietary Sequencer and 1-Second Blocks — OP Enterprise Self-Managed Architecture","独自のシーケンサーと1秒ブロック — OP Enterprise Self-Managedアーキテクチャ",{"_2571":7224},{"_1892":7225,"_1893":7226,"_1802":7065},"GIWA Chain Adoption Guide — Practical Checklist for Developers","GIWAチェーン導入ガイド — 開発者のための実戦チェックリスト",{"_2571":7228},{"_1892":7229,"_1893":7230,"_1802":6957},"The most significant differentiator of the GIWA chain is the Dojang protocol, its proprietary identity verification system implemented on top of EAS (Ethereum Attestation Service). Dojang links Upbit's off-chain real-name account verification data with on-chain wallet addresses without exposing personal information. Users can prove their KYC status via attestation data stored in their wallets without revealing sensitive personal details.","GIWAチェーンの最大の差別化ポイントは、EAS上に実装された独自の身元認証体系である「Dojang（道場）」プロトコルです。Dojangは、Upbitのオフチェーン実名口座認証情報を、個人情報を露呈することなくオンチェーンのウォレットアドレスと連携させます。ユーザーは自身の機密個人情報を明らかにすることなく、KYC完了の有無のみを証明データとしてウォレットに保持し、活用することができます。",{"_2571":7232},{"_1892":7233,"_1893":7234,"_1802":7045},"However, a key constraint to recognize during development is the difference in operational models between the testnet and the mainnet. Unlike the testnet, where anyone can deploy freely, the GIWA mainnet, where the actual production will run, is built on a whitelist-based private model where only pre-authorized partners can deploy and use smart contracts. Therefore, builders must clearly design their on-chain access control structure from the initial planning stage, considering the mainnet roadmap.","ただし、開発時に認識すべき重要な制限は、テストネットとメインネットの運営モデルの違いです。誰でも自由にデプロイできるテストネットとは異なり、実際のプロダクションが実行されるGIWAメインネットは、事前に許可されたパートナーのみがスマートコントラクトをデプロイし使用できる、ホワイトリストベースのプライベートモデルで構築されます。そのため、ビルダーはメインネットのロードマップを考慮し、初期企画段階からオンチェーンのアクセス権限構造を明確に設計する必要があります。",{"_7171":7236,"_7174":7237,"_7177":7238},{"_1892":7124,"_1893":7124,"_1802":7124},{"_1892":7132,"_1893":7132,"_1802":7132},{"_1892":7116,"_1893":7116,"_1802":7116},{"_2571":7240},{"_1892":7241,"_1893":7242,"_1802":7015},"Currently, on the GIWA Sepolia testnet (Chain ID: 91342), anyone can freely integrate the Dojang protocol to build dApps. However, the production mainnet will be operated as a whitelist-based private chain where only authorized services can be deployed. Therefore, builders should actively utilize this identity layer during the testnet phase to preemptively verify the functionality of regulatory-conservative DeFi or settlement protocols.","現在、GIWA Sepoliaテストネット（チェーンID: 91342）では誰でも自由にDojangプロトコルを連携してdAppを構築できます。しかし、実際のプロダクションメインネットは許可されたサービスのみがデプロイできるホワイトリスト方式のプライベートチェーンとして運営される予定です。したがって、ビルダーはテストネット段階でこの身元レイヤーを積極的に活用し、規制に対して保守的なDeFiや決済プロトコルの動作性を先制的に検証しておく必要があります。",{"_2571":7244},{"_1892":7245,"_1893":7246,"_1802":7075},"The GIWA chain offers clear appeal to dApp builders with its independent sequencer operation, sub-200ms ultra-fast pre-confirmation, and the Dojang identity layer that adheres to institutional regulations. However, you must establish your entry strategy with the awareness that, unlike the public testnet (Chain ID 91342), the production mainnet is deployed as a whitelist-based private model.","GIWAチェーンは、独自のシーケンサー運営と200ms未満の超高速事前確定、そして制度上の規制を遵守するDojang身元レイヤーにより、dAppビルダーに確かな魅力を提供します。ただし、チェーンID 91342を使用するパブリックテストネットとは異なり、実際のプロダクション段階のメインネットはホワイトリストベースのプライベートモデルで配布されるという制約条件を認識し、参入戦略を立てる必要があります。",{"_2571":7248},{"_1892":7249,"_1893":7250,"_1802":6947},"EAS-Based Identity Layer — On-Chain Regulatory Compliance with the Dojang Protocol","EASベースの身元レイヤー — Dojangプロトコルを活用したオンチェーン規制遵守",{"_2571":7252},{"_1892":7253,"_1893":7254,"_1802":6927},"By integrating this endpoint, your frontend can be updated in real-time by receiving pre-confirmation signals sent immediately by the node while the transaction is still in the mempool. This mitigates the bottlenecks that previously occurred in L2 nodes while receiving transactions, estimating gas, and fully generating blocks, ensuring smooth, Web2-like responsiveness.","このエンドポイントを連携すると、トランザクションがメンプール（mempool）に留まっている間にノードが即座に送信する事前確定信号を受信し、フロントエンドの画面をリアルタイムで更新できます。既存のL2ノードがトランザクションを受信し、ガスを推定した後にブロックが完全に生成されるまで発生していたボトルネックを補完し、Web2並みのスムーズな応答性を保証します。","![GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나](file:cms7ukp2h034110nv66fhd12n)\n\n# GIWA 체인 분석 — 1초 블록과 Dojang 신원 레이어로 무엇을 만드나\n\n이더리움 레이어 2 생태계에 기업과 기관을 위한 새로운 OP Stack 체인이 등장했습니다. 두나무가 구축한 GIWA 체인은 단순한 롤업을 넘어 독자적인 기술 구조로 차별화된 개발 환경을 제공합니다. 1초 블록 타임과 200ms 미만의 플래시블록 사전 확정 기술, 그리고 EAS 기반의 Dojang 신원 레이어는 기존 레이어 2와 다른 성능과 규제 준수 환경을 제시합니다. 테스트넷을 통해 지금 바로 실전에서 적용 가능한 기술적 핵심 요소와 개발자 관점의 변화를 분석합니다.\n\n## 독자적인 시퀀서와 1초 블록 — OP Enterprise Self-Managed 아키텍처\n\n기와 체인은 OP Stack 기반 레이어 2로, 오프티미즘의 기업용 라이선스인 OP Enterprise의 Self-Managed 티어를 최초로 적용했습니다. 공유 시퀀서 풀을 사용하는 일반적인 롤업과 달리 두나무가 시퀀서를 독자적으로 운영합니다. 덕분에 트랜잭션 순서 정렬 규칙과 블록 공간 운영 정책을 기업 요구사항에 맞춰 완전히 제어할 수 있는 주권을 가집니다.\n\n또한 표준 OP Stack의 2초 블록 타임을 1초로 단축해 트랜잭션 처리 지연을 절반으로 줄였습니다. 현재 체인 ID 91342인 기와 세폴리아 테스트넷에서 자유롭게 빌딩할 수 있지만, 향후 프로덕션 메인넷은 인가된 파트너만 참여할 수 있는 프라이빗 화이트리스트 형태로 배포될 예정입니다. 빌더들은 메인넷 배포 단계에서 요구될 접근 권한 제약 사항을 아키텍처 설계 시 미리 염두에 두어야 합니다.\n\n실행 레이어의 성능을 한계까지 끌어올리기 위한 노드 인프라 최적화도 눈여겨볼 만합니다. 2026년 7월 진행된 카스트 하드포크 이후 기존 op-geth 지원은 공식 종료되었으며, Rust 기반 고성능 클라이언트인 op-reth로 실행 레이어가 완전히 이전되었습니다. 이번 업그레이드로 트랜잭션당 가스 한도가 16,777,216 가스로 제한되고, P256VERIFY 프리컴파일 가스 비용이 6,900 가스로 조정되는 등 엔진 레벨의 규칙 변화가 적용되었으므로 컨트랙트 최적화 시 참고해야 합니다.\n\n## 200ms 미만의 사용자 경험 — 플래시블록 RPC 연동\n\n온체인 결제나 실시간 게임처럼 즉각적인 반응이 필요한 분야에서는 1초의 블록 타임조차 대기 시간으로 느껴질 수 있습니다. 기와 체인은 트랜잭션이 블록에 최종 기록되기 전, 200ms 미만의 속도로 사전 확정을 제공하는 플래시블록 기술을 도입하여 이 문제를 해결합니다.\n\n개발자는 기와 세폴리아 테스트넷에서 제공하는 전용 RPC 엔드포인트를 사용해 이 초고속 사용자 경험을 직접 구현하고 테스트할 수 있습니다.\n\n- 플래시블록 전용 RPC 엔드포인트: `https://sepolia-rpc-flashblocks.giwa.io`\n\n해당 엔드포인트를 연동하면 트랜잭션이 멤풀에 머무는 동안 노드가 즉각 전송하는 사전 확정 신호를 받아 프론트엔드 화면을 실시간으로 업데이트할 수 있습니다. 기존 L2 노드가 트랜잭션을 수신하고 가스를 추정한 뒤 블록을 완전히 생성하기까지 발생하던 병목을 보완하여 웹2에 준하는 매끄러운 반응성을 보장합니다.\n\n다만 실제 제품 단계에 적용할 때 주의해야 할 개발 제약이 있습니다. 현재 체인 ID 91342 기반의 기와 세폴리아 테스트넷에서는 누구나 이 성능을 자유롭게 연동해 볼 수 있지만, 정식 출시될 메인넷은 허가된 빌더만 스마트 컨트랙트를 배포할 수 있는 화이트리스트 형태의 프라이빗 체인으로 운영될 예정입니다. 따라서 테스트넷 개발 단계에서 플래시블록 연동 성능을 미리 검증한 후, 메인넷 진입 장벽에 맞춘 설계 및 운영 정책을 함께 고려해야 합니다.\n\n## EAS 기반 신원 레이어 — Dojang 프로토콜을 활용한 온체인 규제 준수\n\n기와 체인의 가장 큰 차별점은 EAS 위에 구현된 자체 신원 인증 체계인 도장(Dojang) 프로토콜입니다. 도장은 업비트의 오프체인 실명 계좌 인증 정보를 개인정보 노출 없이 온체인 지갑 주소와 연결해 줍니다. 사용자는 자신의 민감한 개인정보를 밝히지 않고도 KYC 완료 여부만 증명 데이터 형태로 지갑에 담아 활용할 수 있습니다.\n\n개발자는 기와 세폴리아 테스트넷에 배포된 EAS 컨트랙트(`0x4200000000000000000000000000000000000021`)와 스키마 레지스트리(`0x4200000000000000000000000000000000000020`)를 통해 신원 데이터를 제어합니다. 특히 검증된 주소 스키마 UID(`0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08`)를 활용하면 특정 주소의 인증 상태를 온체인에서 즉시 판별할 수 있습니다. 편의성을 위해 제공되는 도장스크롤(DojangScroll) 컨트랙트(`0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9`)를 이용하면 복잡한 EAS 데이터 파싱 없이 단 한 번의 호출로 검증이 끝납니다.\n\n예를 들어 Solidity 스마트 계약에서 비인가 주소의 접근을 차단하는 규제 준수형 제어 로직은 다음과 같이 구현할 수 있습니다.\n\n```solidity\ninterface IDojangScroll {\n function isVerified(address addr, bytes32 attesterId) external view returns (bool);\n}\n\ncontract VerifiedAction {\n address private constant DOJANG = 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9;\n bytes32 private constant UPBIT = 0xd99b42e778498aa3c9c1f6a012359130252780511687a35982e8e52735453034;\n\n function secureAction() external view {\n require(IDojangScroll(DOJANG).isVerified(msg.sender, UPBIT), \"Forbidden\");\n }\n}\n```\n\n현재 기와 세폴리아 테스트넷(체인 ID: 91342)에서는 누구나 자유롭게 도장 프로토콜을 연동하여 dApp을 빌드할 수 있습니다. 하지만 실제 프로덕션 메인넷은 인가된 서비스만 배포할 수 있는 화이트리스트 방식의 프라이빗 체인으로 운영될 예정입니다. 따라서 빌더들은 테스트넷 단계에서 이 신원 레이어를 적극 활용해 규제 보수적인 디파이나 정산 프로토콜의 작동성을 선제적으로 검증해야 합니다.\n\n## L2 빌더를 위한 기와 체인 테스트넷 실전 배포 및 개발 환경\n\n체인 ID 91342를 사용하는 기와 세폴리아 테스트넷은 EVM 호환성을 완벽히 갖추고 있어 Hardhat이나 Foundry 같은 표준 이더리움 개발 도구를 그대로 사용할 수 있습니다. 공식 인프라 파트너인 Nodit이 제공하는 RPC 엔드포인트와 수도꼭지를 통해 누구나 빠르게 개발 환경을 구축하고 스마트 컨트랙트를 배포할 수 있습니다. 특히 트랜잭션당 가스 비용이 약 1원 수준으로 책정되어 소액 결제나 빈번한 온체인 상호작용을 부담 없이 테스트하기에 적합합니다.\n\n다만 개발 시 인지해야 할 핵심 제약은 테스트넷과 메인넷의 운영 모델 차이입니다. 누구나 자유롭게 배포할 수 있는 테스트넷과 달리, 실제 프로덕션이 실행될 기와 메인넷은 사전에 허가된 파트너만 스마트 컨트랙트를 배포하고 사용할 수 있는 화이트리스트 기반의 프라이빗 모델로 구축됩니다. 따라서 빌더들은 메인넷 로드맵을 고려해 초기 기획 단계부터 온체인 접근 권한 구조를 명확히 설계해야 합니다.\n\n이러한 제한된 메인넷 생태계에 진입하기 위한 가장 확실한 경로는 두나무의 빌더 프로그램인 가속(GASOK)입니다. 총 10만 달러 규모의 마일스톤 기반 지원금을 제공하는 이 프로그램은 선발된 팀에게 인프라 및 기술 컨설팅 지원과 함께 향후 비공개 메인넷 배포 권한을 우선적으로 부여합니다.\n\n## 기와 체인 도입 가이드 — 개발자를 위한 실전 체크리스트\n\n기와 체인은 독자적인 시퀀서 운영과 200ms 미만의 초고속 사전 확정, 그리고 제도권 규제를 준수하는 도장 신원 레이어로 디앱 빌더에게 확실한 매력을 제공합니다. 다만 체인 ID 91342를 사용하는 퍼블릭 테스트넷과 달리, 실제 프로덕션 단계의 메인넷은 화이트리스트 기반의 프라이빗 모델로 배포된다는 제약 조건을 인지하고 진입 전략을 세워야 합니다.\n\n또한 L2 시퀀서의 트랜잭션 수락이 이더리움 메인넷의 최종 확정과 동의어가 아니라는 점, 브릿지 통과 시 롤업 특유의 인출 지연 기간이 존재한다는 점도 아키텍처에 반영해야 합니다. 규제 인지형 계약 설계와 고성능 사용자 경험의 균형을 고민하고 있다면 기와 세폴리아 테스트넷에서 직접 스마트 계약을 배포해 보는 것부터 시작하는 편이 좋습니다.\n\n---\n\n**참고 링크**\n\n- [Optimism Foundation / Dunamu Press Releases — GIWA Chain Architecture & OP Enterprise Self-Managed Strategy](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFVsFTca4gg6lBkKUaGGTbfE59ebGHFTfLnDOBQwLdUOxBQLX_0as-ngZXI6UzdDfWMi5HrpW0Aa8SDEG8k5RT9iRWCs9Vx89GY6STaqwgf6Cv6XAdoJP9INRp4MLdtRcqfpu60PuiyKDAyRCXmQA8WFQQL6OjO9szUzmXe1HRy4rr1Y9Oa--injIyGSwRvlN8k-9U4kZ3FEE8POaNExpOJy8P9qogAwKm9WZMJLEIydND1HD4=)\n- [GIWA Chain Developer Notices — Flashblocks RPC Endpoint & Node Execution Layer](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQG-xdNzCk7hjbBoI_F3fHRknc1JjoiMerP_W8t-pfFhSNZiKuPvqRYCF8mvl7eee3X6MRFfotpOD9_N-0ODD1GOSyCXkbAsQ7_d02MHfMm_o3hNGSweGjoC0mUWYZgmXXBopfh1PJh9jyvE)\n- [Optimism Foundation / Dunamu Press Releases — Upbit (Dunamu) Partnering with Optimism Foundation on GIWA Chain](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQHg8iaKn9VIglMUo-mGO7ENMWV7ggC7LoJtaxLJ6-uo4vkVIrSpK7G0v0fl_NGZSyrQbGy4gUq0IJpXp1v6HacIk-grbk-1zBS3RvMpZcGAlynfnqAdoM5Y_MEEWeFrOrmzGm36a2hdy9gjrppSdcphe5bu-qtWFIYgoQHjvRuUQ6vclq7rmzbOer12LEwQAvVLC7AGiNxd5lhfvic8g78h_o1HJRiO13HP97ZrVV6x-fHWGcc=)","e76de5601e3bae36022b1df4a1f3628c95f1fa01680166b2dd22677b5690e8e8","2026-07-30T14:44:33.103Z","2026-08-02T03:17:18.259Z",[],[7261],{"_2802":2803,"_1881":7262},"CHECKED",{"_950":3768,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":3769,"_2426":7264,"_1889":7267,"_2455":-5,"_2456":-5,"_2457":-5,"_9":3780,"_2450":3786,"_2458":3788,"_2460":-5,"_723":7271,"_1886":7272,"_332":7273,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":7274,"_2003":7275,"_2480":7276,"_2482":-5,"_2483":7277,"_2485":-5,"_2486":-5,"_2487":7278,"_1144":7288,"_2527":7301,"_2555":-5,"_2556":7308,"_2798":7548,"_266":7549},{"_1801":1892,"_214":3771,"_2429":7265,"_2434":7266,"_2438":2439},{"_1892":3773,"_1893":1997,"_1802":3774,"_2433":1997},{"_1892":3776,"_1893":1997,"_1802":3777,"_2433":1997},{"_9":7268,"_2445":7269,"_2450":7270},{"_1892":3780,"_1893":3781,"_1802":3780},{"_1892":3783,"_1893":3784,"_1802":3783},{"_1892":3786,"_1893":3787,"_1802":3786},[3790],[3124,3792,3126,3125,3793,3794],[],"2026-08-01T12:21:14.399Z","2026-07-31T22:00:03.220Z","2026-08-02T08:09:50.533Z","2026-08-01T12:22:15.151Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":7279},{"_1901":7280},{"_1903":7281,"_1908":1909,"_1910":7282,"_1921":7283,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":7284,"_1928":7285,"_1933":7286,"_1938":7287},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":7289,"_1883":1884,"_1200":1204,"_1899":7292},{"_633":7290,"_11":7291},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":7293},{"_1903":7294,"_1908":1909,"_1910":7295,"_1921":7296,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":7297,"_1928":7298,"_1933":7299,"_1938":7300},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":7302},{"_1948":-5,"_1908":1909,"_1910":7303,"_1960":-5,"_1943":3830,"_1962":7304},{"_1912":3826,"_1914":3827,"_1952":3828,"_1810":2534,"_944":1992,"_1917":3829,"_1957":2536,"_1919":1920},{"_1964":7305,"_1972":7306,"_1979":7307,"_1986":-5},{"_1912":3833,"_1914":3834,"_1952":3835,"_1810":1969,"_944":2544,"_1957":1971},{"_1912":3837,"_1914":3838,"_1952":3839,"_1810":1977,"_944":2549,"_1957":1971},{"_1912":3841,"_1914":3842,"_1952":3843,"_1810":1984,"_944":2554,"_1957":1971},{"_950":3845,"_2559":3768,"_2560":7309,"_2716":7495,"_2788":4224,"_2790":4225,"_2792":4226,"_2794":1997,"_2003":7546,"_2480":7547,"_2797":-5},{"_918":7310,"_1908":1909},[7311,7312,7314,7317,7319,7322,7324,7327,7329,7332,7334,7343,7345,7351,7353,7356,7358,7364,7366,7372,7374,7375,7377,7383,7385,7388,7390,7393,7395,7404,7406,7415,7417,7418,7420,7429,7431,7434,7436,7439,7441,7444,7446,7449,7451,7452,7454,7457,7459,7462,7464,7467,7469,7470,7472,7476,7478],{"_950":3849,"_2565":3780,"_2420":2566,"_2567":3788},{"_950":3851,"_2420":2570,"_2571":7313},[],{"_950":3854,"_2420":2575,"_2576":1909,"_2571":7315},[7316],{"_2579":3780,"_2420":2579},{"_950":3858,"_2420":2570,"_2571":7318},[],{"_950":3861,"_2420":2570,"_2571":7320},[7321],{"_2579":3864,"_2420":2579},{"_950":3866,"_2420":2570,"_2571":7323},[],{"_950":3869,"_2420":2575,"_2576":2007,"_2571":7325},[7326],{"_2579":3872,"_2420":2579},{"_950":3874,"_2420":2570,"_2571":7328},[],{"_950":3877,"_2420":2570,"_2571":7330},[7331],{"_2579":3880,"_2420":2579},{"_950":3882,"_2420":2570,"_2571":7333},[],{"_950":3885,"_2420":2570,"_2571":7335},[7336,7337,7339,7340,7342],{"_2579":3888,"_2420":2579},{"_2579":3890,"_2420":2579,"_3365":7338},{"_3351":3367},{"_2579":3893,"_2420":2579},{"_2579":3895,"_2420":2579,"_3365":7341},{"_3351":3367},{"_2579":3898,"_2420":2579},{"_950":3900,"_2420":2570,"_2571":7344},[],{"_950":3903,"_2420":2570,"_2571":7346},[7347,7348,7350],{"_2579":3906,"_2420":2579},{"_2579":3895,"_2420":2579,"_3365":7349},{"_3351":3367},{"_2579":3910,"_2420":2579},{"_950":3912,"_2420":2570,"_2571":7352},[],{"_950":3915,"_2420":2575,"_2576":2007,"_2571":7354},[7355],{"_2579":3918,"_2420":2579},{"_950":3920,"_2420":2570,"_2571":7357},[],{"_950":3923,"_2420":2570,"_2571":7359},[7360,7361,7363],{"_2579":3926,"_2420":2579},{"_2579":3895,"_2420":2579,"_3365":7362},{"_3351":3367},{"_2579":3930,"_2420":2579},{"_950":3932,"_2420":2570,"_2571":7365},[],{"_950":3935,"_2420":2570,"_2571":7367},[7368,7369,7371],{"_2579":3938,"_2420":2579},{"_2579":3940,"_2420":2579,"_3365":7370},{"_3351":3367},{"_2579":3943,"_2420":2579},{"_950":3945,"_2420":2570,"_2571":7373},[],{"_950":3948,"_3351":3949,"_2420":3351,"_625":3125},{"_950":3951,"_2420":2570,"_2571":7376},[],{"_950":3954,"_2420":2570,"_2571":7378},[7379,7380,7382],{"_2579":3957,"_2420":2579},{"_2579":3959,"_2420":2579,"_3365":7381},{"_3351":3367},{"_2579":3962,"_2420":2579},{"_950":3964,"_2420":2570,"_2571":7384},[],{"_950":3967,"_2420":2575,"_2576":2007,"_2571":7386},[7387],{"_2579":3970,"_2420":2579},{"_950":3972,"_2420":2570,"_2571":7389},[],{"_950":3975,"_2420":2570,"_2571":7391},[7392],{"_2579":3978,"_2420":2579},{"_950":3980,"_2420":2570,"_2571":7394},[],{"_950":3983,"_2420":2570,"_2571":7396},[7397,7398,7400,7401,7403],{"_2579":3986,"_2420":2579},{"_2579":3988,"_2420":2579,"_3365":7399},{"_3351":3367},{"_2579":3991,"_2420":2579},{"_2579":3993,"_2420":2579,"_3365":7402},{"_3351":3367},{"_2579":3996,"_2420":2579},{"_950":3998,"_2420":2570,"_2571":7405},[],{"_950":4001,"_2420":2570,"_2571":7407},[7408,7409,7411,7412,7414],{"_2579":4004,"_2420":2579},{"_2579":3401,"_2420":2579,"_3365":7410},{"_3351":3367},{"_2579":4008,"_2420":2579},{"_2579":3401,"_2420":2579,"_3365":7413},{"_3351":3367},{"_2579":4012,"_2420":2579},{"_950":4014,"_2420":2570,"_2571":7416},[],{"_950":4017,"_3351":4018,"_2420":3351,"_625":3125},{"_950":4020,"_2420":2570,"_2571":7419},[],{"_950":4023,"_2420":2570,"_2571":7421},[7422,7423,7425,7426,7428],{"_2579":4026,"_2420":2579},{"_2579":4028,"_2420":2579,"_3365":7424},{"_3351":3367},{"_2579":4031,"_2420":2579},{"_2579":3988,"_2420":2579,"_3365":7427},{"_3351":3367},{"_2579":4035,"_2420":2579},{"_950":4037,"_2420":2570,"_2571":7430},[],{"_950":4040,"_2420":2575,"_2576":2007,"_2571":7432},[7433],{"_2579":4043,"_2420":2579},{"_950":4045,"_2420":2570,"_2571":7435},[],{"_950":4048,"_2420":2570,"_2571":7437},[7438],{"_2579":4051,"_2420":2579},{"_950":4053,"_2420":2570,"_2571":7440},[],{"_950":4056,"_2420":2570,"_2571":7442},[7443],{"_2579":4059,"_2420":2579},{"_950":4061,"_2420":2570,"_2571":7445},[],{"_950":4064,"_2420":2570,"_2571":7447},[7448],{"_2579":4067,"_2420":2579},{"_950":4069,"_2420":2570,"_2571":7450},[],{"_950":4072,"_3351":4073,"_2420":3351,"_625":3125},{"_950":4075,"_2420":2570,"_2571":7453},[],{"_950":4078,"_2420":2570,"_2571":7455},[7456],{"_2579":4081,"_2420":2579},{"_950":4083,"_2420":2570,"_2571":7458},[],{"_950":4086,"_2420":2575,"_2576":2007,"_2571":7460},[7461],{"_2579":4089,"_2420":2579},{"_950":4091,"_2420":2570,"_2571":7463},[],{"_950":4094,"_2420":2570,"_2571":7465},[7466],{"_2579":4097,"_2420":2579},{"_950":4099,"_2420":2570,"_2571":7468},[],{"_950":4102,"_2420":3473},{"_950":4104,"_2420":2570,"_2571":7471},[],{"_950":4107,"_2420":2570,"_2571":7473},[7474],{"_2579":3483,"_2420":2579,"_3365":7475},{"_3485":3367},{"_950":4112,"_2420":2570,"_2571":7477},[],{"_950":4115,"_1881":3492,"_2420":3493,"_778":7479},[7480,7485,7490],{"_950":4118,"_2571":7481},[7482],{"_3499":4121,"_2420":3501,"_3502":7483},[7484],{"_2579":4124,"_2420":2579},{"_950":4126,"_2571":7486},[7487],{"_3499":4129,"_2420":3501,"_3502":7488},[7489],{"_2579":4132,"_2420":2579},{"_950":4134,"_2571":7491},[7492],{"_3499":4137,"_2420":3501,"_3502":7493},[7494],{"_2579":4140,"_2420":2579},{"_3954":7496,"_3877":7498,"_4078":7500,"_4107":7502,"_4086":7504,"_3903":7506,"_3861":7508,"_3915":7510,"_4048":7512,"_3935":7514,"_4064":7516,"_3983":7518,"_4040":7520,"_3869":7522,"_3854":7524,"_3967":7526,"_3923":7528,"_4115":7530,"_4023":7534,"_4056":7536,"_4094":7538,"_3885":7540,"_3975":7542,"_4001":7544},{"_2571":7497},{"_1892":4144,"_1893":4145,"_1802":4144},{"_2571":7499},{"_1892":3880,"_1893":4148,"_1802":3880},{"_2571":7501},{"_1892":4081,"_1893":4151,"_1802":4081},{"_2571":7503},{"_1892":3483,"_1893":3604,"_1802":3483},{"_2571":7505},{"_1892":4089,"_1893":4156,"_1802":4089},{"_2571":7507},{"_1892":4159,"_1893":4160,"_1802":4159},{"_2571":7509},{"_1892":3864,"_1893":4163,"_1802":3864},{"_2571":7511},{"_1892":3918,"_1893":4166,"_1802":3918},{"_2571":7513},{"_1892":4051,"_1893":4169,"_1802":4051},{"_2571":7515},{"_1892":4172,"_1893":4173,"_1802":4172},{"_2571":7517},{"_1892":4067,"_1893":4176,"_1802":4067},{"_2571":7519},{"_1892":4179,"_1893":4180,"_1802":4179},{"_2571":7521},{"_1892":4043,"_1893":4183,"_1802":4043},{"_2571":7523},{"_1892":3872,"_1893":4186,"_1802":3872},{"_2571":7525},{"_1892":3780,"_1893":3781,"_1802":3780},{"_2571":7527},{"_1892":3970,"_1893":4191,"_1802":3970},{"_2571":7529},{"_1892":4194,"_1893":4195,"_1802":4194},{"_4197":7531,"_4199":7532,"_4201":7533},{"_1892":4140,"_1893":4140,"_1802":4140},{"_1892":4124,"_1893":4124,"_1802":4124},{"_1892":4132,"_1893":4132,"_1802":4132},{"_2571":7535},{"_1892":4205,"_1893":4206,"_1802":4205},{"_2571":7537},{"_1892":4059,"_1893":4209,"_1802":4059},{"_2571":7539},{"_1892":4097,"_1893":4212,"_1802":4097},{"_2571":7541},{"_1892":4215,"_1893":4216,"_1802":4215},{"_2571":7543},{"_1892":3978,"_1893":4219,"_1802":3978},{"_2571":7545},{"_1892":4222,"_1893":4223,"_1802":4222},"2026-07-31T22:00:03.225Z","2026-08-01T12:22:15.193Z",[],[7550],{"_2802":2806,"_1881":4232},{"_950":7552,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":7553,"_1889":7561,"_2455":-5,"_2456":-5,"_2457":-5,"_9":7565,"_2450":7573,"_2458":7574,"_2460":-5,"_723":7575,"_1886":7577,"_332":7582,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1994,"_2477":7583,"_2003":7584,"_2480":7585,"_2482":-5,"_2483":7586,"_2485":-5,"_2486":-5,"_2487":7587,"_1144":7597,"_2527":7610,"_2555":-5,"_2556":7631,"_2798":7992,"_266":7993},"cms7yqo92037s10nv2ao5crc5",{"_1801":1802,"_214":7554,"_2429":7555,"_2434":7558,"_2438":2439},2522,{"_1892":7556,"_1893":1997,"_1802":7557,"_2433":1997},836,1686,{"_1892":7559,"_1893":1997,"_1802":7560,"_2433":1997},0.33148295003965106,0.6685170499603489,{"_9":7562,"_2445":7566,"_2450":7570},{"_1892":7563,"_1893":7564,"_1802":7565},"Node.js 24 require(esm) Stabilization — Why a Pure ESM Transition is Now Possible for NestJS 12","Node.js 24でrequire(esm)が安定化 — NestJS 12が純粋なESM移行を実現できた理由","Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유",{"_1892":7567,"_1893":7568,"_1802":7569},"Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유\n\nNode.js 24 require(esm) Stabilization — Why a Pure ESM Transition is Now Possible for NestJS 12\n\nThe persistent headache of the ERR_REQUIRE_ESM error in the JavaScript backend ecosystem is finally being consigned to history. This is because Node.js 24 has stabilized the require(esm) feature, allowing CommonJS environments to synchronously load ESM packages directly. This opens the door to naturally adopting the latest ESM packages without needing complex bundler configurations or double-build workarounds. Here, I summarize the essence of this change—a major boost for module integration in the backend ecosystem—and its practical significance.\n\nHow Node.js 24's require(esm) Works and Its Key Constraints\n\nThe ERR_REQUIRE_ESM error that has plagued JavaScript developers for so long has finally been completely resolved in Node.js 24. This mechanism, led by core contributor Joyee Cheung, enables CommonJS environments to synchronously load ESM packages directly.\n\nThe working principle lies in the V8 engine's ability to synchronously parse and analyze ESM module graphs. Under the ECMAScript specification, ESM graphs without top-level await can be evaluated synchronously. The Node.js runtime leverages this to compile modules synchronously and return the result immediately.\n\nThanks to this, existing CommonJS projects can now import pure ESM libraries directly without needing to modify their build toolchains.\n\n// app.cjs (Node.js 24+ 환경)\nconst { someEsmFunction } = require('esm-only-package');\n\n// 별도의 비동기 래핑 없이 즉시 동기 실행 가능\nconst result = someEsmFunction();\nconsole.log(result);\n\nHowever, there is a clear constraint: the ESM module graph you intend to import must not contain top-level await. If top-level await is present, the evaluation becomes asynchronous and returns a promise, leading to the ERR_REQUIRE_ASYNC_MODULE error when called via the synchronous require function.\n\nFortunately, most npm libraries avoid using top-level await for backward compatibility, so for practical purposes, you can integrate and use them without any issues.\n\nWhy the ESM Transition in NestJS 12 Won't Be Painful\n\nThe biggest change in the NestJS 12 roadmap is the shift of all core packages to pure ESM. In the past, this decision would have caused significant friction, breaking backward compatibility for existing CommonJS-based applications. However, thanks to the synchronous require(esm) provided by Node.js 24, you can now load and use the latest pure ESM packages without modifying any code in your existing projects.\n\nAccording to InfoQ's roadmap report and byteiota's analysis, Kamil Myśliwiec, the founder of NestJS, emphasized that Node.js's require(esm) support was the \"final puzzle piece that made the ESM transition truly possible,\" and that without this feature, the current migration would not have held much significance. With compatibility barriers resolved at the runtime level, the framework core team can now confidently move forward with a comprehensive modernization.\n\nAs a result, NestJS 12 serves as a model for shedding long-standing compiler debt and simplifying module configuration complexity without affecting existing business logic. Developers can now freely integrate ESM-only libraries without needing to restructure their projects immediately, finally freeing them from the long-standing conflict between module systems.\n\nThe End of the Dual-Package Hurdle and Simplified Build Pipelines\n\nUntil now, open-source library maintainers have been providing build artifacts for both CommonJS and ESM to support both environments. A persistent issue in this process has been the 'Dual Package Hazard,' which occurs when an application loads the same package using different module systems. This often leads to extremely hard-to-trace runtime bugs, such as duplicate singleton objects in memory, broken global states, or multiple database connections being established.\n\nThe stabilization of require(esm) in Node.js 24 is the key to solving this. Even if a library is distributed only in pure ESM format, a CommonJS backend can now call it directly and synchronously. Since it is evaluated and loaded as a single module instance, the bugs caused by duplicated singleton objects are eliminated at the source.\n\nAs a result, complex build pipelines and tsconfig.json configurations become drastically simpler. Maintainers can end the waste of setting up tricky conditional exports in bundlers and double-compiling CJS and ESM versions. Enterprise development teams are also freed from the stress of hybrid builds and bundling, allowing them to freely introduce pure ESM libraries into production.\n\nPractical Checklist for 2026 Backend Migration\n\nTo safely transition to a pure ESM backend, you should first migrate your runtime environment to Node.js 24, or to LTS versions that have been backported (Node.js 22.12.0+ or 20.19.0+).\n\nNext, change your TypeScript configuration's module and moduleResolution options to NodeNext, and implement a rule to include the .js file extension at the end of all local import paths. For variables like __dirname or __filename, which are not available in ESM environments, update your code to replace them using import.meta.url.\n\nNow is the best time to modernize your backend module architecture, as you can completely clear away complex double-build settings and simplify your compiler toolchain.\n\nReference Links\n\nNode.js Official Changelogs / Joyee Cheung — require(esm) Reaches Full Stability in Node.js v24.15.0 LTS and v25.4.0\nTypeScript Official TSConfig Reference — TypeScript TSConfig Recommendations for Modern Node ESM\nNode.js Official Documentation — The Dual-Package Hazard Solution: 'module-sync' Export Condition","Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유\n\nNode.js 24でrequire(esm)が安定化 — NestJS 12が純粋なESM移行を実現できた理由\n\nJavaScriptバックエンドエコシステムで長年の悩みの種だった「ERR_REQUIRE_ESM」エラーが、ついに過去のものになろうとしています。Node.js 24において、CommonJS環境からESMパッケージを同期的に直接読み込める「require(esm)」機能が安定版となったためです。これにより、複雑なバンドラー設定や二重ビルドといった回避策なしで、最新のESMパッケージを自然に導入できるようになりました。バックエンドのモジュール統合を加速させるこの変化の核心と、実務的な意義をまとめます。\n\nNode.js 24におけるrequire(esm)の動作原理と主な制約\n\n長年JavaScript開発者を苦しめてきたERR_REQUIRE_ESMエラーが、Node.js 24でついに完全に解決されました。主要コントリビューターであるJoyee Cheung氏の主導で完成したこのメカニズムは、CommonJS環境からESMパッケージを同期的に直接呼び出すことを可能にします。\n\n動作原理は、V8エンジンレベルでESMモジュールグラフを同期的にパース・解析する点にあります。本来、ECMAScript仕様上、トップレベルのawaitを含まないESMグラフは同期評価が可能です。Node.jsのランタイムはこの性質を利用し、モジュールを同期的にコンパイルした後に結果を即座に返します。\n\nこれにより、既存のCommonJSプロジェクトでも、ビルドツールの構成を複雑に変更することなく、純粋なESMライブラリを直接呼び出すことができます。\n\n// app.cjs (Node.js 24+ 환경)\nconst { someEsmFunction } = require('esm-only-package');\n\n// 별도의 비동기 래핑 없이 즉시 동기 실행 가능\nconst result = someEsmFunction();\nconsole.log(result);\n\nただし、このメカニズムには「読み込もうとするESMモジュールグラフ内にトップレベルのawaitが存在してはならない」という明確な制約があります。トップレベルのawaitが含まれる場合、評価プロセスが非同期化されPromiseが返されるため、同期関数であるrequireで呼び出すとERR_REQUIRE_ASYNC_MODULEエラーが発生します。\n\n幸いなことに、ほとんどのnpmライブラリは下位互換性のためにトップレベルのawaitを使用していないため、実務上の利用で問題になることはほとんどありません。\n\nNestJS 12のESM移行がスムーズである理由\n\nNestJS 12のロードマップにおける最大の変更点は、すべてのコアパッケージを純粋なESMへと移行することです。過去であれば、この決断は既存のCommonJSベースのアプリケーションとの下位互換性を破壊する致命的な問題を引き起こしていたでしょう。しかし、Node.js 24が提供する同期的なrequire(esm)のおかげで、既存プロジェクトのコードを全く修正することなく、最新の純粋なESMパッケージを読み込んで利用できるようになりました。\n\nInfoQのロードマップレポートやbyteiotaの分析によると、NestJSの創設者であるKamil Myśliwiec氏は、Node.jsによるrequire(esm)のサポートが「ESM移行を実質的に可能にした最後のピース」であり、この機能なしでは今回のマイグレーションは大きな意味を持たなかっただろうと強調しています。互換性の壁がランタイムレベルで解決されたことで、フレームワークのコアチームは安心して全面的な体質改善に着手できるようになったのです。\n\nそのおかげでNestJS 12は、既存のビジネスロジックに影響を与えることなく、長年のコンパイラの負債とモジュール設定の複雑さを完全に解消するという模範的な事例を示しました。開発者はプロジェクトの構造を即座に変更しなくてもESM専用ライブラリを自由に組み合わせられるようになり、モジュールシステム間の長年の対立からついに解放されました。\n\nデュアルパッケージの障壁の終焉とビルドパイプラインの簡素化\n\nこれまでオープンソースライブラリのメンテナーは、CommonJSとESMの両環境をサポートするために、両フォーマットのビルド成果物を同時に提供してきました。この過程で、アプリケーションが同じパッケージを異なるモジュールシステムで個別に読み込む際に発生する「二重パッケージ問題（Dual Package Hazard）」が深刻な問題となっていました。メモリ上でシングルトンオブジェクトが重複して生成され、グローバル状態が壊れたり、データベース接続が二重に確立されたりするなど、追跡が極めて困難なランタイムバグが頻発していました。\n\nNode.js 24のrequire(esm)の安定化は、この問題を解決する重要な鍵となります。ライブラリを純粋なESMフォーマット一つだけで配布しても、CommonJSのバックエンドがそれを直接同期的に呼び出せるからです。単一のモジュールインスタンスとして評価・ロードされるため、シングルトンオブジェクトの重複によるバグを根本から遮断できます。\n\nその結果、複雑だったビルドパイプラインやtsconfig.jsonの設定が劇的に単純化されます。メンテナーは、バンドラーでの煩雑な条件付きエクスポート設定や、CJS・ESM版の二重コンパイルという無駄を終わらせることができます。エンタープライズ開発チームも、ハイブリッドビルドやバンドリングのストレスに悩まされることなく、純粋なESMライブラリをプロダクションへ自由に導入できるようになりました。\n\n2026年バックエンド移行のための実務チェックリスト\n\n純粋なESMバックエンドへ安全に移行するには、まずランタイム環境をrequire(esm)機能が安定化したNode.js 24、またはバックポートが完了しているNode.js 22.12.0以上、20.19.0以上のLTSバージョンへマイグレーションする必要があります。\n\n次に、TypeScriptの設定ファイルのmoduleおよびmoduleResolutionオプションをNodeNextに変更し、すべてのローカルファイルインポートパスの末尾に.js拡張子を明記するルールを適用します。ESM環境で使用できない__dirnameや__filename変数は、import.meta.urlを活用して代替するようにコードを修正します。\n\n複雑な二重ビルド設定を完全に取り除き、コンパイラツールチェーンを簡素化できる今こそ、バックエンドのモジュールアーキテクチャを刷新する絶好の機会です。\n\n参考リンク\n\nNode.js Official Changelogs / Joyee Cheung — require(esm) Reaches Full Stability in Node.js v24.15.0 LTS and v25.4.0\nTypeScript Official TSConfig Reference — TypeScript TSConfig Recommendations for Modern Node ESM\nNode.js Official Documentation — The Dual-Package Hazard Solution: 'module-sync' Export Condition","Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유\n\nNode.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유\n\n자바스크립트 백엔드 생태계의 고질적인 골칫거리였던 ERR_REQUIRE_ESM 에러가 마침내 역사 속으로 사라지고 있습니다. Node.js 24에서 CommonJS 환경이 ESM 패키지를 동기식으로 직접 불러올 수 있는 require(esm) 기능이 안정화되었기 때문입니다. 덕분에 복잡한 번들러 설정이나 이중 빌드 같은 우회책 없이도 최신 ESM 패키지를 자연스럽게 도입할 수 있는 길이 열렸습니다. 백엔드 생태계의 모듈 통합을 가속화하는 이 변화의 핵심과 실무적인 의의를 정리합니다.\n\nNode.js 24의 require(esm) 작동 원리와 핵심 제약\n\n그동안 자바스크립트 개발자를 괴롭히던 ERR_REQUIRE_ESM 에러가 Node.js 24에서 마침내 완전히 해결되었습니다. 핵심 기여자 조이 청의 주도로 완성된 이 메커니즘은 CommonJS 환경에서 ESM 패키지를 동기식으로 직접 불러올 수 있게 지원합니다.\n\n동작 원리는 V8 엔진 수준에서 ESM 모듈 그래프를 동기적으로 파싱하고 분석하는 데 있습니다. 본래 ECMAScript 명세상 탑레벨 await가 없는 ESM 그래프는 동기 평가가 가능합니다. Node.js 런타임은 이 점을 활용해 모듈을 동기식으로 컴파일한 뒤 결과를 즉시 반환합니다.\n\n덕분에 기존 CommonJS 프로젝트에서도 빌드 도구 체인을 복잡하게 수정하지 않고 순수 ESM 라이브러리를 곧바로 호출할 수 있습니다.\n\n// app.cjs (Node.js 24+ 환경)\nconst { someEsmFunction } = require('esm-only-package');\n\n// 별도의 비동기 래핑 없이 즉시 동기 실행 가능\nconst result = someEsmFunction();\nconsole.log(result);\n\n다만 이 메커니즘은 가져오려는 ESM 모듈 그래프 내부에 탑레벨 await가 존재하지 않아야 한다는 명확한 제약이 있습니다. 탑레벨 await가 포함되면 평가 과정이 비동기화되어 프로미스를 반환하므로, 동기 함수인 require로 호출 시 ERR_REQUIRE_ASYNC_MODULE 에러가 발생합니다.\n\n다행히 대다수 npm 라이브러리는 하위 호환성을 위해 탑레벨 await를 사용하지 않으므로 실무 수준에서는 아무런 제약 없이 결합해 사용할 수 있습니다.\n\nNestJS 12의 ESM 전환이 고통스럽지 않은 이유\n\nNestJS 12 로드맵의 가장 큰 변화는 모든 코어 패키지를 순수 ESM으로 전환한다는 점입니다. 과거였다면 이 결정은 기존 CommonJS 기반 애플리케이션의 하위 호환성을 깨뜨리는 치명적인 파열음을 냈을 것입니다. 하지만 Node.js 24가 제공하는 동기식 require(esm) 덕분에, 기존 프로젝트의 코드를 전혀 수정하지 않고도 최신 순수 ESM 패키지를 불러와 사용할 수 있게 되었습니다.\n\nInfoQ의 로드맵 보고서와 byteiota 분석에 따르면, NestJS 창시자인 카밀 미실리비에크는 Node.js의 require(esm) 지원이 'ESM 전환을 실질적으로 가능하게 만든 마지막 퍼즐 조각'이었으며, 이 기능이 없었다면 이번 마이그레이션은 큰 의미가 없었을 것이라고 강조했습니다. 호환성 장벽이 런타임 수준에서 해결되면서, 프레임워크 코어 팀이 안심하고 전면적인 체질 개선에 나설 수 있게 된 셈입니다.\n\n덕분에 NestJS 12는 기존 비즈니스 로직에 영향을 주지 않으면서도, 오랜 컴파일러 부채와 모듈 설정의 복잡성을 완전히 덜어내는 모범 사례를 보여주었습니다. 개발자들은 당장 프로젝트의 구조를 바꾸지 않아도 ESM 전용 라이브러리를 자유롭게 결합할 수 있게 되어, 모듈 시스템 간의 오랜 갈등에서 마침내 해방되었습니다.\n\n듀얼 패키지 허들의 종말과 빌드 파이프라인 단순화\n\n그동안 오픈소스 라이브러리 메인테이너들은 CommonJS와 ESM 환경을 모두 지원하기 위해 두 포맷의 빌드 아티팩트를 동시에 제공해 왔습니다. 이 과정에서 애플리케이션이 동일한 패키지를 서로 다른 모듈 시스템으로 각각 불러올 때 발생하는 '이중 패키지 위험(Dual Package Hazard)'이 고질적인 문제였습니다. 메모리상에서 싱글톤 객체가 중복으로 생성되면서 전역 상태가 깨지거나 데이터베이스 커넥션이 이중으로 수립되는 등 추적하기 극도로 어려운 런타임 버그가 빈번하게 일어났습니다.\n\nNode.js 24의 require(esm) 안정화는 이 문제를 해결하는 핵심 열쇠입니다. 라이브러리를 순수 ESM 포맷 하나로만 배포하더라도 CommonJS 백엔드가 이를 직접 동기식으로 호출할 수 있기 때문입니다. 단 하나의 모듈 인스턴스로만 평가되고 로드되므로, 싱글톤 객체가 중복 생성되어 발생하는 버그가 원천 차단됩니다.\n\n결과적으로 복잡했던 빌드 파이프라인과 tsconfig.json 설정이 획기적으로 단순해집니다. 메인테이너는 번들러에서 까다로운 조건부 내보내기 설정을 거치고 CJS와 ESM 버전을 이중 컴파일하던 낭비를 끝낼 수 있습니다. 엔터프라이즈 개발팀 또한 더 이상 하이브리드 빌드와 번들링 스트레스에 시달리지 않고 순수 ESM 라이브러리를 프로덕션에 자유롭게 도입할 수 있게 되었습니다.\n\n2026년 백엔드 마이그레이션을 위한 실무 체크리스트\n\n순수 ESM 백엔드로 안전하게 전환하려면 먼저 런타임 환경을 require(esm) 기능이 안정화된 Node.js 24 버전이나 백포트가 완료된 Node.js 22.12.0+, 20.19.0+ 이상의 LTS 버전으로 마이그레이션해야 합니다.\n\n그 다음 TypeScript 설정 파일의 module과 moduleResolution 옵션을 NodeNext로 변경하고, 모든 로컬 파일 임포트 경로 끝에 .js 확장자를 명시하는 규칙을 적용합니다. ESM 환경에서 사용할 수 없는 __dirname이나 __filename 변수는 import.meta.url을 활용해 대체하도록 코드를 가볍게 수정해 줍니다.\n\n복잡한 이중 빌드 설정을 완전히 걷어내고 컴파일러 도구 체인을 단순화할 수 있는 지금이 백엔드 모듈 아키텍처를 현대화할 가장 좋은 기회입니다.\n\n참고 링크\n\nNode.js Official Changelogs / Joyee Cheung — require(esm) Reaches Full Stability in Node.js v24.15.0 LTS and v25.4.0\nTypeScript Official TSConfig Reference — TypeScript TSConfig Recommendations for Modern Node ESM\nNode.js Official Documentation — The Dual-Package Hazard Solution: 'module-sync' Export Condition",{"_1892":7571,"_1893":7572,"_1802":7573},"Node.js 24 require(esm) Stabilization — Why a Pure ESM Transition is Now Possible for NestJS 12 The persistent headache of the ERR_REQUIRE_ESM error in the JavaScript backend ecosystem is finally being consigned to histo…","Node.js 24でrequire(esm)が安定化 — NestJS 12が純粋なESM移行を実現できた理由 JavaScriptバックエンドエコシステムで長年の悩みの種だった「ERR_REQUIRE_ESM」エラーが、ついに過去のものになろうとしています。Node.js 24において、CommonJS環境からESMパッケージを同期的に直接読み込める「require(esm)」機能が安定版となったためです。これにより、複雑なバンドラ…","Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유 자바스크립트 백엔드 생태계의 고질적인 골칫거리였던 ERR_REQUIRE_ESM 에러가 마침내 역사 속으로 사라지고 있습니다. Node.js 24에서 CommonJS 환경이 ESM 패키지를 동기식으로 직접 불러올 수 있는 require(esm) 기능이 안정화되었기 때문입니다. 덕분에 복잡…","cms811t26039h10nv5ryx9x5v",[7576],"ecosystem-shift",[3126,7578,7579,7580,7581,3125],"esm","commonjs","require-esm","nestjs",[],"2026-07-31T12:24:04.221Z","2026-07-30T20:25:30.182Z","2026-08-01T06:56:38.166Z","2026-07-31T12:24:24.473Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":7588},{"_1901":7589},{"_1903":7590,"_1908":1909,"_1910":7591,"_1921":7592,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":7593,"_1928":7594,"_1933":7595,"_1938":7596},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":7598,"_1883":1884,"_1200":1204,"_1899":7601},{"_633":7599,"_11":7600},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":7602},{"_1903":7603,"_1908":1909,"_1910":7604,"_1921":7605,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":7606,"_1928":7607,"_1933":7608,"_1938":7609},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":7611},{"_1948":-5,"_1908":1909,"_1910":7612,"_1960":-5,"_1943":7617,"_1962":7618},{"_1912":7613,"_1914":7614,"_1952":7615,"_1810":2534,"_944":1992,"_1917":7616,"_1957":2536,"_1919":2209},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/364a8a50-e27e-4963-bebf-3eab87fc22df.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/364a8a50-e27e-4963-bebf-3eab87fc22df.jpg",496018,"L89aEY.A-oM^l6n7bukn00I9NGxv","2026-07-30T21:30:09.485Z",{"_1964":7619,"_1972":7623,"_1979":7627,"_1986":-5},{"_1912":7620,"_1914":7621,"_1952":7622,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/large.webp",39846,{"_1912":7624,"_1914":7625,"_1952":7626,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/small.webp",10044,{"_1912":7628,"_1914":7629,"_1952":7630,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms811t26039h10nv5ryx9x5v/medium.webp",22536,{"_950":7632,"_2559":7552,"_2560":7633,"_2716":7895,"_2788":7987,"_2790":7988,"_2792":7989,"_2794":1997,"_2003":7990,"_2480":7991,"_2797":-5},"cms7yqo96037t10nv0veq4wbx",{"_918":7634,"_1908":1909},[7635,7637,7640,7644,7647,7652,7655,7660,7663,7668,7671,7676,7679,7684,7687,7691,7694,7699,7702,7707,7710,7715,7718,7723,7726,7731,7734,7739,7742,7747,7750,7755,7758,7768,7771,7781,7784,7789,7792,7801,7804,7844,7847,7852,7855,7857,7860,7865,7868],{"_950":7636,"_2565":7565,"_2420":2566,"_2567":7574},"5b02d9e9-104b-47d0-bd4d-1c2d31dca960",{"_950":7638,"_2420":2570,"_2571":7639},"7f44709d-c15c-484f-80e6-ea2574a65eb6",[],{"_950":7641,"_2420":2575,"_2576":1909,"_2571":7642},"15918dd2-4993-47fb-9a83-ad0c327a4bdf",[7643],{"_2579":7565,"_2420":2579},{"_950":7645,"_2420":2570,"_2571":7646},"be159957-d46a-4386-bf8f-d38d1756481e",[],{"_950":7648,"_2420":2570,"_2571":7649},"b269dbf8-7763-4690-ad15-76eca04150ca",[7650],{"_2579":7651,"_2420":2579},"자바스크립트 백엔드 생태계의 고질적인 골칫거리였던 ERR_REQUIRE_ESM 에러가 마침내 역사 속으로 사라지고 있습니다. Node.js 24에서 CommonJS 환경이 ESM 패키지를 동기식으로 직접 불러올 수 있는 require(esm) 기능이 안정화되었기 때문입니다. 덕분에 복잡한 번들러 설정이나 이중 빌드 같은 우회책 없이도 최신 ESM 패키지를 자연스럽게 도입할 수 있는 길이 열렸습니다. 백엔드 생태계의 모듈 통합을 가속화하는 이 변화의 핵심과 실무적인 의의를 정리합니다.",{"_950":7653,"_2420":2570,"_2571":7654},"6e15435e-bd03-40be-aba6-bf925e4d01ab",[],{"_950":7656,"_2420":2575,"_2576":2007,"_2571":7657},"513cce23-f2c0-4dc1-a0d6-9d276f8985f8",[7658],{"_2579":7659,"_2420":2579},"Node.js 24의 require(esm) 작동 원리와 핵심 제약",{"_950":7661,"_2420":2570,"_2571":7662},"1129449e-1a86-4d1f-97cf-57648ef50123",[],{"_950":7664,"_2420":2570,"_2571":7665},"0e116793-ab54-4f76-8fc5-0b53455ef64a",[7666],{"_2579":7667,"_2420":2579},"그동안 자바스크립트 개발자를 괴롭히던 ERR_REQUIRE_ESM 에러가 Node.js 24에서 마침내 완전히 해결되었습니다. 핵심 기여자 조이 청의 주도로 완성된 이 메커니즘은 CommonJS 환경에서 ESM 패키지를 동기식으로 직접 불러올 수 있게 지원합니다.",{"_950":7669,"_2420":2570,"_2571":7670},"f18d84ba-dd7b-4873-a11e-9e37276103f2",[],{"_950":7672,"_2420":2570,"_2571":7673},"3f5a7b6f-8210-4ae6-9e29-0c7d217b89ad",[7674],{"_2579":7675,"_2420":2579},"동작 원리는 V8 엔진 수준에서 ESM 모듈 그래프를 동기적으로 파싱하고 분석하는 데 있습니다. 본래 ECMAScript 명세상 탑레벨 await가 없는 ESM 그래프는 동기 평가가 가능합니다. Node.js 런타임은 이 점을 활용해 모듈을 동기식으로 컴파일한 뒤 결과를 즉시 반환합니다.",{"_950":7677,"_2420":2570,"_2571":7678},"9007ea0d-7d45-4dad-9681-968ab94f3ead",[],{"_950":7680,"_2420":2570,"_2571":7681},"b3d268c3-c3e9-4a62-a80f-a2a2beffdb26",[7682],{"_2579":7683,"_2420":2579},"덕분에 기존 CommonJS 프로젝트에서도 빌드 도구 체인을 복잡하게 수정하지 않고 순수 ESM 라이브러리를 곧바로 호출할 수 있습니다.",{"_950":7685,"_2420":2570,"_2571":7686},"e09a1397-146a-455b-af58-4ce3d7a25d66",[],{"_950":7688,"_3351":7689,"_2420":3351,"_625":7690},"e91e5776-9903-4c34-a7fe-2ac26ce9d2d5","// app.cjs (Node.js 24+ 환경)\nconst { someEsmFunction } = require('esm-only-package');\n\n// 별도의 비동기 래핑 없이 즉시 동기 실행 가능\nconst result = someEsmFunction();\nconsole.log(result);","javascript",{"_950":7692,"_2420":2570,"_2571":7693},"f84f952e-9da1-4b6c-9e12-1c4390af826c",[],{"_950":7695,"_2420":2570,"_2571":7696},"51f11beb-8ea4-47d2-81c7-6faa27629fb9",[7697],{"_2579":7698,"_2420":2579},"다만 이 메커니즘은 가져오려는 ESM 모듈 그래프 내부에 탑레벨 await가 존재하지 않아야 한다는 명확한 제약이 있습니다. 탑레벨 await가 포함되면 평가 과정이 비동기화되어 프로미스를 반환하므로, 동기 함수인 require로 호출 시 ERR_REQUIRE_ASYNC_MODULE 에러가 발생합니다.",{"_950":7700,"_2420":2570,"_2571":7701},"b7d086f3-5947-4979-88bc-36e7c4b82e43",[],{"_950":7703,"_2420":2570,"_2571":7704},"9ef31e42-a86b-4800-9f22-32554fef6f2f",[7705],{"_2579":7706,"_2420":2579},"다행히 대다수 npm 라이브러리는 하위 호환성을 위해 탑레벨 await를 사용하지 않으므로 실무 수준에서는 아무런 제약 없이 결합해 사용할 수 있습니다.",{"_950":7708,"_2420":2570,"_2571":7709},"f88c9d79-10dd-4b22-b705-bf34f87d5278",[],{"_950":7711,"_2420":2575,"_2576":2007,"_2571":7712},"8c1ddb4f-5c1c-4762-926b-c25db1be7f70",[7713],{"_2579":7714,"_2420":2579},"NestJS 12의 ESM 전환이 고통스럽지 않은 이유",{"_950":7716,"_2420":2570,"_2571":7717},"24c18f74-86e9-4d91-aae4-15257b34159a",[],{"_950":7719,"_2420":2570,"_2571":7720},"66a09847-a2d5-46e0-8903-41455a325001",[7721],{"_2579":7722,"_2420":2579},"NestJS 12 로드맵의 가장 큰 변화는 모든 코어 패키지를 순수 ESM으로 전환한다는 점입니다. 과거였다면 이 결정은 기존 CommonJS 기반 애플리케이션의 하위 호환성을 깨뜨리는 치명적인 파열음을 냈을 것입니다. 하지만 Node.js 24가 제공하는 동기식 require(esm) 덕분에, 기존 프로젝트의 코드를 전혀 수정하지 않고도 최신 순수 ESM 패키지를 불러와 사용할 수 있게 되었습니다.",{"_950":7724,"_2420":2570,"_2571":7725},"f8a5a358-35da-4b1e-8a9a-83dc0c27f8e6",[],{"_950":7727,"_2420":2570,"_2571":7728},"13192496-bfa6-44ce-a68f-79bbf42889da",[7729],{"_2579":7730,"_2420":2579},"InfoQ의 로드맵 보고서와 byteiota 분석에 따르면, NestJS 창시자인 카밀 미실리비에크는 Node.js의 require(esm) 지원이 'ESM 전환을 실질적으로 가능하게 만든 마지막 퍼즐 조각'이었으며, 이 기능이 없었다면 이번 마이그레이션은 큰 의미가 없었을 것이라고 강조했습니다. 호환성 장벽이 런타임 수준에서 해결되면서, 프레임워크 코어 팀이 안심하고 전면적인 체질 개선에 나설 수 있게 된 셈입니다.",{"_950":7732,"_2420":2570,"_2571":7733},"b6701b49-86cd-4854-99ce-173127b6daf0",[],{"_950":7735,"_2420":2570,"_2571":7736},"a5184918-3d72-4e82-af1f-0001ce340924",[7737],{"_2579":7738,"_2420":2579},"덕분에 NestJS 12는 기존 비즈니스 로직에 영향을 주지 않으면서도, 오랜 컴파일러 부채와 모듈 설정의 복잡성을 완전히 덜어내는 모범 사례를 보여주었습니다. 개발자들은 당장 프로젝트의 구조를 바꾸지 않아도 ESM 전용 라이브러리를 자유롭게 결합할 수 있게 되어, 모듈 시스템 간의 오랜 갈등에서 마침내 해방되었습니다.",{"_950":7740,"_2420":2570,"_2571":7741},"a2fe1868-cdae-4063-bb81-edb204c937d5",[],{"_950":7743,"_2420":2575,"_2576":2007,"_2571":7744},"2e683755-016e-4fbf-9ea0-913ad20d9e74",[7745],{"_2579":7746,"_2420":2579},"듀얼 패키지 허들의 종말과 빌드 파이프라인 단순화",{"_950":7748,"_2420":2570,"_2571":7749},"775d2607-c27d-4653-a568-fa796996f9e7",[],{"_950":7751,"_2420":2570,"_2571":7752},"44644075-7921-4e96-9dc4-e3475bf81f7d",[7753],{"_2579":7754,"_2420":2579},"그동안 오픈소스 라이브러리 메인테이너들은 CommonJS와 ESM 환경을 모두 지원하기 위해 두 포맷의 빌드 아티팩트를 동시에 제공해 왔습니다. 이 과정에서 애플리케이션이 동일한 패키지를 서로 다른 모듈 시스템으로 각각 불러올 때 발생하는 '이중 패키지 위험(Dual Package Hazard)'이 고질적인 문제였습니다. 메모리상에서 싱글톤 객체가 중복으로 생성되면서 전역 상태가 깨지거나 데이터베이스 커넥션이 이중으로 수립되는 등 추적하기 극도로 어려운 런타임 버그가 빈번하게 일어났습니다.",{"_950":7756,"_2420":2570,"_2571":7757},"27e3c082-aa16-4c77-878b-caee7518db90",[],{"_950":7759,"_2420":2570,"_2571":7760},"f93d3fff-6297-47f0-8a3d-91a98e6cc014",[7761,7763,7766],{"_2579":7762,"_2420":2579},"Node.js 24의 ",{"_2579":7764,"_2420":2579,"_3365":7765},"require(esm)",{"_3351":3367},{"_2579":7767,"_2420":2579}," 안정화는 이 문제를 해결하는 핵심 열쇠입니다. 라이브러리를 순수 ESM 포맷 하나로만 배포하더라도 CommonJS 백엔드가 이를 직접 동기식으로 호출할 수 있기 때문입니다. 단 하나의 모듈 인스턴스로만 평가되고 로드되므로, 싱글톤 객체가 중복 생성되어 발생하는 버그가 원천 차단됩니다.",{"_950":7769,"_2420":2570,"_2571":7770},"9030ddbf-4324-4769-be8a-1be40273d5dc",[],{"_950":7772,"_2420":2570,"_2571":7773},"2b19ba76-9da8-4652-b0dc-5ae9cf4aabe1",[7774,7776,7779],{"_2579":7775,"_2420":2579},"결과적으로 복잡했던 빌드 파이프라인과 ",{"_2579":7777,"_2420":2579,"_3365":7778},"tsconfig.json",{"_3351":3367},{"_2579":7780,"_2420":2579}," 설정이 획기적으로 단순해집니다. 메인테이너는 번들러에서 까다로운 조건부 내보내기 설정을 거치고 CJS와 ESM 버전을 이중 컴파일하던 낭비를 끝낼 수 있습니다. 엔터프라이즈 개발팀 또한 더 이상 하이브리드 빌드와 번들링 스트레스에 시달리지 않고 순수 ESM 라이브러리를 프로덕션에 자유롭게 도입할 수 있게 되었습니다.",{"_950":7782,"_2420":2570,"_2571":7783},"8ea6853b-574f-462f-8570-fdd106f1c21b",[],{"_950":7785,"_2420":2575,"_2576":2007,"_2571":7786},"45cb1a47-2fa9-4e73-8c0a-31d802196baf",[7787],{"_2579":7788,"_2420":2579},"2026년 백엔드 마이그레이션을 위한 실무 체크리스트",{"_950":7790,"_2420":2570,"_2571":7791},"3c685e61-737f-4eca-a561-bcc191993365",[],{"_950":7793,"_2420":2570,"_2571":7794},"0fde83a4-78fe-4665-a536-2216e8e90349",[7795,7797,7799],{"_2579":7796,"_2420":2579},"순수 ESM 백엔드로 안전하게 전환하려면 먼저 런타임 환경을 ",{"_2579":7764,"_2420":2579,"_3365":7798},{"_3351":3367},{"_2579":7800,"_2420":2579}," 기능이 안정화된 Node.js 24 버전이나 백포트가 완료된 Node.js 22.12.0+, 20.19.0+ 이상의 LTS 버전으로 마이그레이션해야 합니다.",{"_950":7802,"_2420":2570,"_2571":7803},"9772e87d-8385-44e1-b5cf-5941494c6fcc",[],{"_950":7805,"_2420":2570,"_2571":7806},"8ac915f8-2cb5-4573-8d37-4699f349e794",[7807,7809,7812,7814,7817,7819,7822,7824,7827,7829,7832,7834,7837,7839,7842],{"_2579":7808,"_2420":2579},"그 다음 TypeScript 설정 파일의 ",{"_2579":7810,"_2420":2579,"_3365":7811},"module",{"_3351":3367},{"_2579":7813,"_2420":2579},"과 ",{"_2579":7815,"_2420":2579,"_3365":7816},"moduleResolution",{"_3351":3367},{"_2579":7818,"_2420":2579}," 옵션을 ",{"_2579":7820,"_2420":2579,"_3365":7821},"NodeNext",{"_3351":3367},{"_2579":7823,"_2420":2579},"로 변경하고, 모든 로컬 파일 임포트 경로 끝에 ",{"_2579":7825,"_2420":2579,"_3365":7826},".js",{"_3351":3367},{"_2579":7828,"_2420":2579}," 확장자를 명시하는 규칙을 적용합니다. ESM 환경에서 사용할 수 없는 ",{"_2579":7830,"_2420":2579,"_3365":7831},"__dirname",{"_3351":3367},{"_2579":7833,"_2420":2579},"이나 ",{"_2579":7835,"_2420":2579,"_3365":7836},"__filename",{"_3351":3367},{"_2579":7838,"_2420":2579}," 변수는 ",{"_2579":7840,"_2420":2579,"_3365":7841},"import.meta.url",{"_3351":3367},{"_2579":7843,"_2420":2579},"을 활용해 대체하도록 코드를 가볍게 수정해 줍니다.",{"_950":7845,"_2420":2570,"_2571":7846},"760b42fb-9563-46b6-8d8a-531426b2ee24",[],{"_950":7848,"_2420":2570,"_2571":7849},"07affc1f-ecca-4cbc-a3fb-d2f1e1913002",[7850],{"_2579":7851,"_2420":2579},"복잡한 이중 빌드 설정을 완전히 걷어내고 컴파일러 도구 체인을 단순화할 수 있는 지금이 백엔드 모듈 아키텍처를 현대화할 가장 좋은 기회입니다.",{"_950":7853,"_2420":2570,"_2571":7854},"0d3e0a60-428f-47e0-9832-09b0c891e65f",[],{"_950":7856,"_2420":3473},"f023bcef-7a49-493c-9073-245ae99074a4",{"_950":7858,"_2420":2570,"_2571":7859},"0d3415a9-6cce-471b-b4d8-25d882acbecd",[],{"_950":7861,"_2420":2570,"_2571":7862},"87985816-1e3f-49ed-a467-c16847beacf5",[7863],{"_2579":3483,"_2420":2579,"_3365":7864},{"_3485":3367},{"_950":7866,"_2420":2570,"_2571":7867},"077d83cd-c612-47b1-82a1-71152eaf2a10",[],{"_950":7869,"_1881":3492,"_2420":3493,"_778":7870},"2366db48-4820-4f69-a2ed-47eba32ec50c",[7871,7879,7887],{"_950":7872,"_2571":7873},"040cba21-4068-4f86-b7d2-4a01df50631c",[7874],{"_3499":7875,"_2420":3501,"_3502":7876},"https://github.com/nodejs/node/pull/60959",[7877],{"_2579":7878,"_2420":2579},"Node.js Official Changelogs / Joyee Cheung — require(esm) Reaches Full Stability in Node.js v24.15.0 LTS and v25.4.0",{"_950":7880,"_2571":7881},"c71897a2-c580-4ca8-ba6b-61797155920d",[7882],{"_3499":7883,"_2420":3501,"_3502":7884},"https://www.typescriptlang.org/tsconfig/#moduleResolution",[7885],{"_2579":7886,"_2420":2579},"TypeScript Official TSConfig Reference — TypeScript TSConfig Recommendations for Modern Node ESM",{"_950":7888,"_2571":7889},"e36b7cb0-40db-4ffb-b980-510fd6789213",[7890],{"_3499":7891,"_2420":3501,"_3502":7892},"https://github.com/nodejs/node/pull/54648",[7893],{"_2579":7894,"_2420":2579},"Node.js Official Documentation — The Dual-Package Hazard Solution: 'module-sync' Export Condition",{"_7848":7896,"_7664":7900,"_7793":7904,"_7727":7909,"_7641":7913,"_7869":7915,"_7772":7922,"_7743":7927,"_7672":7931,"_7751":7935,"_7785":7939,"_7656":7943,"_7695":7947,"_7719":7951,"_7861":7955,"_7805":7957,"_7711":7962,"_7703":7966,"_7735":7970,"_7648":7974,"_7680":7978,"_7759":7982},{"_2571":7897},{"_1892":7898,"_1893":7899,"_1802":7851},"Now is the best time to modernize your backend module architecture, as you can completely clear away complex double-build settings and simplify your compiler toolchain.","複雑な二重ビルド設定を完全に取り除き、コンパイラツールチェーンを簡素化できる今こそ、バックエンドのモジュールアーキテクチャを刷新する絶好の機会です。",{"_2571":7901},{"_1892":7902,"_1893":7903,"_1802":7667},"The ERR_REQUIRE_ESM error that has plagued JavaScript developers for so long has finally been completely resolved in Node.js 24. This mechanism, led by core contributor Joyee Cheung, enables CommonJS environments to synchronously load ESM packages directly.","長年JavaScript開発者を苦しめてきたERR_REQUIRE_ESMエラーが、Node.js 24でついに完全に解決されました。主要コントリビューターであるJoyee Cheung氏の主導で完成したこのメカニズムは、CommonJS環境からESMパッケージを同期的に直接呼び出すことを可能にします。",{"_2571":7905},{"_1892":7906,"_1893":7907,"_1802":7908},"To safely transition to a pure ESM backend, you should first migrate your runtime environment to Node.js 24, or to LTS versions that have been backported (Node.js 22.12.0+ or 20.19.0+).","純粋なESMバックエンドへ安全に移行するには、まずランタイム環境をrequire(esm)機能が安定化したNode.js 24、またはバックポートが完了しているNode.js 22.12.0以上、20.19.0以上のLTSバージョンへマイグレーションする必要があります。","순수 ESM 백엔드로 안전하게 전환하려면 먼저 런타임 환경을 require(esm) 기능이 안정화된 Node.js 24 버전이나 백포트가 완료된 Node.js 22.12.0+, 20.19.0+ 이상의 LTS 버전으로 마이그레이션해야 합니다.",{"_2571":7910},{"_1892":7911,"_1893":7912,"_1802":7730},"According to InfoQ's roadmap report and byteiota's analysis, Kamil Myśliwiec, the founder of NestJS, emphasized that Node.js's require(esm) support was the \"final puzzle piece that made the ESM transition truly possible,\" and that without this feature, the current migration would not have held much significance. With compatibility barriers resolved at the runtime level, the framework core team can now confidently move forward with a comprehensive modernization.","InfoQのロードマップレポートやbyteiotaの分析によると、NestJSの創設者であるKamil Myśliwiec氏は、Node.jsによるrequire(esm)のサポートが「ESM移行を実質的に可能にした最後のピース」であり、この機能なしでは今回のマイグレーションは大きな意味を持たなかっただろうと強調しています。互換性の壁がランタイムレベルで解決されたことで、フレームワークのコアチームは安心して全面的な体質改善に着手できるようになったのです。",{"_2571":7914},{"_1892":7563,"_1893":7564,"_1802":7565},{"_7916":7917,"_7918":7919,"_7920":7921},"item:040cba21-4068-4f86-b7d2-4a01df50631c",{"_1892":7878,"_1893":7878,"_1802":7878},"item:c71897a2-c580-4ca8-ba6b-61797155920d",{"_1892":7886,"_1893":7886,"_1802":7886},"item:e36b7cb0-40db-4ffb-b980-510fd6789213",{"_1892":7894,"_1893":7894,"_1802":7894},{"_2571":7923},{"_1892":7924,"_1893":7925,"_1802":7926},"As a result, complex build pipelines and tsconfig.json configurations become drastically simpler. Maintainers can end the waste of setting up tricky conditional exports in bundlers and double-compiling CJS and ESM versions. Enterprise development teams are also freed from the stress of hybrid builds and bundling, allowing them to freely introduce pure ESM libraries into production.","その結果、複雑だったビルドパイプラインやtsconfig.jsonの設定が劇的に単純化されます。メンテナーは、バンドラーでの煩雑な条件付きエクスポート設定や、CJS・ESM版の二重コンパイルという無駄を終わらせることができます。エンタープライズ開発チームも、ハイブリッドビルドやバンドリングのストレスに悩まされることなく、純粋なESMライブラリをプロダクションへ自由に導入できるようになりました。","결과적으로 복잡했던 빌드 파이프라인과 tsconfig.json 설정이 획기적으로 단순해집니다. 메인테이너는 번들러에서 까다로운 조건부 내보내기 설정을 거치고 CJS와 ESM 버전을 이중 컴파일하던 낭비를 끝낼 수 있습니다. 엔터프라이즈 개발팀 또한 더 이상 하이브리드 빌드와 번들링 스트레스에 시달리지 않고 순수 ESM 라이브러리를 프로덕션에 자유롭게 도입할 수 있게 되었습니다.",{"_2571":7928},{"_1892":7929,"_1893":7930,"_1802":7746},"The End of the Dual-Package Hurdle and Simplified Build Pipelines","デュアルパッケージの障壁の終焉とビルドパイプラインの簡素化",{"_2571":7932},{"_1892":7933,"_1893":7934,"_1802":7675},"The working principle lies in the V8 engine's ability to synchronously parse and analyze ESM module graphs. Under the ECMAScript specification, ESM graphs without top-level await can be evaluated synchronously. The Node.js runtime leverages this to compile modules synchronously and return the result immediately.","動作原理は、V8エンジンレベルでESMモジュールグラフを同期的にパース・解析する点にあります。本来、ECMAScript仕様上、トップレベルのawaitを含まないESMグラフは同期評価が可能です。Node.jsのランタイムはこの性質を利用し、モジュールを同期的にコンパイルした後に結果を即座に返します。",{"_2571":7936},{"_1892":7937,"_1893":7938,"_1802":7754},"Until now, open-source library maintainers have been providing build artifacts for both CommonJS and ESM to support both environments. A persistent issue in this process has been the 'Dual Package Hazard,' which occurs when an application loads the same package using different module systems. This often leads to extremely hard-to-trace runtime bugs, such as duplicate singleton objects in memory, broken global states, or multiple database connections being established.","これまでオープンソースライブラリのメンテナーは、CommonJSとESMの両環境をサポートするために、両フォーマットのビルド成果物を同時に提供してきました。この過程で、アプリケーションが同じパッケージを異なるモジュールシステムで個別に読み込む際に発生する「二重パッケージ問題（Dual Package Hazard）」が深刻な問題となっていました。メモリ上でシングルトンオブジェクトが重複して生成され、グローバル状態が壊れたり、データベース接続が二重に確立されたりするなど、追跡が極めて困難なランタイムバグが頻発していました。",{"_2571":7940},{"_1892":7941,"_1893":7942,"_1802":7788},"Practical Checklist for 2026 Backend Migration","2026年バックエンド移行のための実務チェックリスト",{"_2571":7944},{"_1892":7945,"_1893":7946,"_1802":7659},"How Node.js 24's require(esm) Works and Its Key Constraints","Node.js 24におけるrequire(esm)の動作原理と主な制約",{"_2571":7948},{"_1892":7949,"_1893":7950,"_1802":7698},"However, there is a clear constraint: the ESM module graph you intend to import must not contain top-level await. If top-level await is present, the evaluation becomes asynchronous and returns a promise, leading to the ERR_REQUIRE_ASYNC_MODULE error when called via the synchronous require function.","ただし、このメカニズムには「読み込もうとするESMモジュールグラフ内にトップレベルのawaitが存在してはならない」という明確な制約があります。トップレベルのawaitが含まれる場合、評価プロセスが非同期化されPromiseが返されるため、同期関数であるrequireで呼び出すとERR_REQUIRE_ASYNC_MODULEエラーが発生します。",{"_2571":7952},{"_1892":7953,"_1893":7954,"_1802":7722},"The biggest change in the NestJS 12 roadmap is the shift of all core packages to pure ESM. In the past, this decision would have caused significant friction, breaking backward compatibility for existing CommonJS-based applications. However, thanks to the synchronous require(esm) provided by Node.js 24, you can now load and use the latest pure ESM packages without modifying any code in your existing projects.","NestJS 12のロードマップにおける最大の変更点は、すべてのコアパッケージを純粋なESMへと移行することです。過去であれば、この決断は既存のCommonJSベースのアプリケーションとの下位互換性を破壊する致命的な問題を引き起こしていたでしょう。しかし、Node.js 24が提供する同期的なrequire(esm)のおかげで、既存プロジェクトのコードを全く修正することなく、最新の純粋なESMパッケージを読み込んで利用できるようになりました。",{"_2571":7956},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":7958},{"_1892":7959,"_1893":7960,"_1802":7961},"Next, change your TypeScript configuration's module and moduleResolution options to NodeNext, and implement a rule to include the .js file extension at the end of all local import paths. For variables like __dirname or __filename, which are not available in ESM environments, update your code to replace them using import.meta.url.","次に、TypeScriptの設定ファイルのmoduleおよびmoduleResolutionオプションをNodeNextに変更し、すべてのローカルファイルインポートパスの末尾に.js拡張子を明記するルールを適用します。ESM環境で使用できない__dirnameや__filename変数は、import.meta.urlを活用して代替するようにコードを修正します。","그 다음 TypeScript 설정 파일의 module과 moduleResolution 옵션을 NodeNext로 변경하고, 모든 로컬 파일 임포트 경로 끝에 .js 확장자를 명시하는 규칙을 적용합니다. ESM 환경에서 사용할 수 없는 __dirname이나 __filename 변수는 import.meta.url을 활용해 대체하도록 코드를 가볍게 수정해 줍니다.",{"_2571":7963},{"_1892":7964,"_1893":7965,"_1802":7714},"Why the ESM Transition in NestJS 12 Won't Be Painful","NestJS 12のESM移行がスムーズである理由",{"_2571":7967},{"_1892":7968,"_1893":7969,"_1802":7706},"Fortunately, most npm libraries avoid using top-level await for backward compatibility, so for practical purposes, you can integrate and use them without any issues.","幸いなことに、ほとんどのnpmライブラリは下位互換性のためにトップレベルのawaitを使用していないため、実務上の利用で問題になることはほとんどありません。",{"_2571":7971},{"_1892":7972,"_1893":7973,"_1802":7738},"As a result, NestJS 12 serves as a model for shedding long-standing compiler debt and simplifying module configuration complexity without affecting existing business logic. Developers can now freely integrate ESM-only libraries without needing to restructure their projects immediately, finally freeing them from the long-standing conflict between module systems.","そのおかげでNestJS 12は、既存のビジネスロジックに影響を与えることなく、長年のコンパイラの負債とモジュール設定の複雑さを完全に解消するという模範的な事例を示しました。開発者はプロジェクトの構造を即座に変更しなくてもESM専用ライブラリを自由に組み合わせられるようになり、モジュールシステム間の長年の対立からついに解放されました。",{"_2571":7975},{"_1892":7976,"_1893":7977,"_1802":7651},"The persistent headache of the ERR_REQUIRE_ESM error in the JavaScript backend ecosystem is finally being consigned to history. This is because Node.js 24 has stabilized the require(esm) feature, allowing CommonJS environments to synchronously load ESM packages directly. This opens the door to naturally adopting the latest ESM packages without needing complex bundler configurations or double-build workarounds. Here, I summarize the essence of this change—a major boost for module integration in the backend ecosystem—and its practical significance.","JavaScriptバックエンドエコシステムで長年の悩みの種だった「ERR_REQUIRE_ESM」エラーが、ついに過去のものになろうとしています。Node.js 24において、CommonJS環境からESMパッケージを同期的に直接読み込める「require(esm)」機能が安定版となったためです。これにより、複雑なバンドラー設定や二重ビルドといった回避策なしで、最新のESMパッケージを自然に導入できるようになりました。バックエンドのモジュール統合を加速させるこの変化の核心と、実務的な意義をまとめます。",{"_2571":7979},{"_1892":7980,"_1893":7981,"_1802":7683},"Thanks to this, existing CommonJS projects can now import pure ESM libraries directly without needing to modify their build toolchains.","これにより、既存のCommonJSプロジェクトでも、ビルドツールの構成を複雑に変更することなく、純粋なESMライブラリを直接呼び出すことができます。",{"_2571":7983},{"_1892":7984,"_1893":7985,"_1802":7986},"The stabilization of require(esm) in Node.js 24 is the key to solving this. Even if a library is distributed only in pure ESM format, a CommonJS backend can now call it directly and synchronously. Since it is evaluated and loaded as a single module instance, the bugs caused by duplicated singleton objects are eliminated at the source.","Node.js 24のrequire(esm)の安定化は、この問題を解決する重要な鍵となります。ライブラリを純粋なESMフォーマット一つだけで配布しても、CommonJSのバックエンドがそれを直接同期的に呼び出せるからです。単一のモジュールインスタンスとして評価・ロードされるため、シングルトンオブジェクトの重複によるバグを根本から遮断できます。","Node.js 24의 require(esm) 안정화는 이 문제를 해결하는 핵심 열쇠입니다. 라이브러리를 순수 ESM 포맷 하나로만 배포하더라도 CommonJS 백엔드가 이를 직접 동기식으로 호출할 수 있기 때문입니다. 단 하나의 모듈 인스턴스로만 평가되고 로드되므로, 싱글톤 객체가 중복 생성되어 발생하는 버그가 원천 차단됩니다.","![Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유](file:cms811t26039h10nv5ryx9x5v)\n\n# Node.js 24 require(esm) 안정화 — NestJS 12의 순수 ESM 전환이 가능했던 이유\n\n자바스크립트 백엔드 생태계의 고질적인 골칫거리였던 ERR\\_REQUIRE\\_ESM 에러가 마침내 역사 속으로 사라지고 있습니다. Node.js 24에서 CommonJS 환경이 ESM 패키지를 동기식으로 직접 불러올 수 있는 require(esm) 기능이 안정화되었기 때문입니다. 덕분에 복잡한 번들러 설정이나 이중 빌드 같은 우회책 없이도 최신 ESM 패키지를 자연스럽게 도입할 수 있는 길이 열렸습니다. 백엔드 생태계의 모듈 통합을 가속화하는 이 변화의 핵심과 실무적인 의의를 정리합니다.\n\n## Node.js 24의 require(esm) 작동 원리와 핵심 제약\n\n그동안 자바스크립트 개발자를 괴롭히던 ERR\\_REQUIRE\\_ESM 에러가 Node.js 24에서 마침내 완전히 해결되었습니다. 핵심 기여자 조이 청의 주도로 완성된 이 메커니즘은 CommonJS 환경에서 ESM 패키지를 동기식으로 직접 불러올 수 있게 지원합니다.\n\n동작 원리는 V8 엔진 수준에서 ESM 모듈 그래프를 동기적으로 파싱하고 분석하는 데 있습니다. 본래 ECMAScript 명세상 탑레벨 await가 없는 ESM 그래프는 동기 평가가 가능합니다. Node.js 런타임은 이 점을 활용해 모듈을 동기식으로 컴파일한 뒤 결과를 즉시 반환합니다.\n\n덕분에 기존 CommonJS 프로젝트에서도 빌드 도구 체인을 복잡하게 수정하지 않고 순수 ESM 라이브러리를 곧바로 호출할 수 있습니다.\n\n```javascript\n// app.cjs (Node.js 24+ 환경)\nconst { someEsmFunction } = require('esm-only-package');\n\n// 별도의 비동기 래핑 없이 즉시 동기 실행 가능\nconst result = someEsmFunction();\nconsole.log(result);\n```\n\n다만 이 메커니즘은 가져오려는 ESM 모듈 그래프 내부에 탑레벨 await가 존재하지 않아야 한다는 명확한 제약이 있습니다. 탑레벨 await가 포함되면 평가 과정이 비동기화되어 프로미스를 반환하므로, 동기 함수인 require로 호출 시 ERR\\_REQUIRE\\_ASYNC\\_MODULE 에러가 발생합니다.\n\n다행히 대다수 npm 라이브러리는 하위 호환성을 위해 탑레벨 await를 사용하지 않으므로 실무 수준에서는 아무런 제약 없이 결합해 사용할 수 있습니다.\n\n## NestJS 12의 ESM 전환이 고통스럽지 않은 이유\n\nNestJS 12 로드맵의 가장 큰 변화는 모든 코어 패키지를 순수 ESM으로 전환한다는 점입니다. 과거였다면 이 결정은 기존 CommonJS 기반 애플리케이션의 하위 호환성을 깨뜨리는 치명적인 파열음을 냈을 것입니다. 하지만 Node.js 24가 제공하는 동기식 require(esm) 덕분에, 기존 프로젝트의 코드를 전혀 수정하지 않고도 최신 순수 ESM 패키지를 불러와 사용할 수 있게 되었습니다.\n\nInfoQ의 로드맵 보고서와 byteiota 분석에 따르면, NestJS 창시자인 카밀 미실리비에크는 Node.js의 require(esm) 지원이 'ESM 전환을 실질적으로 가능하게 만든 마지막 퍼즐 조각'이었으며, 이 기능이 없었다면 이번 마이그레이션은 큰 의미가 없었을 것이라고 강조했습니다. 호환성 장벽이 런타임 수준에서 해결되면서, 프레임워크 코어 팀이 안심하고 전면적인 체질 개선에 나설 수 있게 된 셈입니다.\n\n덕분에 NestJS 12는 기존 비즈니스 로직에 영향을 주지 않으면서도, 오랜 컴파일러 부채와 모듈 설정의 복잡성을 완전히 덜어내는 모범 사례를 보여주었습니다. 개발자들은 당장 프로젝트의 구조를 바꾸지 않아도 ESM 전용 라이브러리를 자유롭게 결합할 수 있게 되어, 모듈 시스템 간의 오랜 갈등에서 마침내 해방되었습니다.\n\n## 듀얼 패키지 허들의 종말과 빌드 파이프라인 단순화\n\n그동안 오픈소스 라이브러리 메인테이너들은 CommonJS와 ESM 환경을 모두 지원하기 위해 두 포맷의 빌드 아티팩트를 동시에 제공해 왔습니다. 이 과정에서 애플리케이션이 동일한 패키지를 서로 다른 모듈 시스템으로 각각 불러올 때 발생하는 '이중 패키지 위험(Dual Package Hazard)'이 고질적인 문제였습니다. 메모리상에서 싱글톤 객체가 중복으로 생성되면서 전역 상태가 깨지거나 데이터베이스 커넥션이 이중으로 수립되는 등 추적하기 극도로 어려운 런타임 버그가 빈번하게 일어났습니다.\n\nNode.js 24의 `require(esm)` 안정화는 이 문제를 해결하는 핵심 열쇠입니다. 라이브러리를 순수 ESM 포맷 하나로만 배포하더라도 CommonJS 백엔드가 이를 직접 동기식으로 호출할 수 있기 때문입니다. 단 하나의 모듈 인스턴스로만 평가되고 로드되므로, 싱글톤 객체가 중복 생성되어 발생하는 버그가 원천 차단됩니다.\n\n결과적으로 복잡했던 빌드 파이프라인과 `tsconfig.json` 설정이 획기적으로 단순해집니다. 메인테이너는 번들러에서 까다로운 조건부 내보내기 설정을 거치고 CJS와 ESM 버전을 이중 컴파일하던 낭비를 끝낼 수 있습니다. 엔터프라이즈 개발팀 또한 더 이상 하이브리드 빌드와 번들링 스트레스에 시달리지 않고 순수 ESM 라이브러리를 프로덕션에 자유롭게 도입할 수 있게 되었습니다.\n\n## 2026년 백엔드 마이그레이션을 위한 실무 체크리스트\n\n순수 ESM 백엔드로 안전하게 전환하려면 먼저 런타임 환경을 `require(esm)` 기능이 안정화된 Node.js 24 버전이나 백포트가 완료된 Node.js 22.12.0+, 20.19.0+ 이상의 LTS 버전으로 마이그레이션해야 합니다.\n\n그 다음 TypeScript 설정 파일의 `module`과 `moduleResolution` 옵션을 `NodeNext`로 변경하고, 모든 로컬 파일 임포트 경로 끝에 `.js` 확장자를 명시하는 규칙을 적용합니다. ESM 환경에서 사용할 수 없는 `\\_\\_dirname`이나 `\\_\\_filename` 변수는 `import.meta.url`을 활용해 대체하도록 코드를 가볍게 수정해 줍니다.\n\n복잡한 이중 빌드 설정을 완전히 걷어내고 컴파일러 도구 체인을 단순화할 수 있는 지금이 백엔드 모듈 아키텍처를 현대화할 가장 좋은 기회입니다.\n\n---\n\n**참고 링크**\n\n- [Node.js Official Changelogs / Joyee Cheung — require(esm) Reaches Full Stability in Node.js v24.15.0 LTS and v25.4.0](https://github.com/nodejs/node/pull/60959)\n- [TypeScript Official TSConfig Reference — TypeScript TSConfig Recommendations for Modern Node ESM](https://www.typescriptlang.org/tsconfig/#moduleResolution)\n- [Node.js Official Documentation — The Dual-Package Hazard Solution: 'module-sync' Export Condition](https://github.com/nodejs/node/pull/54648)","33e3f964b8260f4a9ab108b7ba349752873f81e682553a37c7e014dab0c02424",49,"2026-07-30T20:25:30.186Z","2026-07-31T12:24:24.494Z",[],[],{"_950":7995,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":7996,"_1889":8004,"_2455":-5,"_2456":-5,"_2457":-5,"_9":8008,"_2450":8016,"_2458":8017,"_2460":-5,"_723":8018,"_1886":8019,"_332":8021,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":8022,"_2003":8023,"_2480":8024,"_2482":-5,"_2483":8025,"_2485":-5,"_2486":-5,"_2487":8026,"_1144":8036,"_2527":8049,"_2555":-5,"_2556":8070,"_2798":8508,"_266":8509},"cms70yqac01g810nvtfkxohdw",{"_1801":1802,"_214":7997,"_2429":7998,"_2434":8001,"_2438":2439},3945,{"_1892":7999,"_1893":1997,"_1802":8000,"_2433":1997},1899,2046,{"_1892":8002,"_1893":1997,"_1802":8003,"_2433":1997},0.48136882129277564,0.5186311787072243,{"_9":8005,"_2445":8009,"_2450":8013},{"_1892":8006,"_1893":8007,"_1802":8008},"Fastify 5.10 Guide — Practical Patterns for LogController and TypeBox","Fastify 5.10 ガイド — LogControllerとTypeBoxの実践パターン","Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴",{"_1892":8010,"_1893":8011,"_1802":8012},"Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴\n\nFastify 5.10 Guide — Practical Patterns for LogController and TypeBox\n\nFastify, the standard for building high-performance backends in the Node.js ecosystem, has become even more robust and flexible with the v5.10.x update. This major version removes legacy structures and mandates full compliance with JSON Schema specifications, while significantly enhancing logging performance and extensibility through a new Log Controller layer. Here, we outline the key production design patterns that developers must implement to maximize runtime performance and ensure solid type safety in complex microservice environments.\n\n1. Introducing LogController — Declarative Request Logging\n\nThe most significant architectural change in Fastify v5.10.0 is the introduction of the new Log Controller layer. Previous top-level options such as disableRequestLogging and requestIdLogLabel are now officially deprecated (FSTDEP023, FSTDEP024) and are scheduled for complete removal in version 6. Instead, developers can now inherit from the official LogController class to manage the logging lifecycle in a declarative, object-oriented manner.\n\nUsing this structure, you can easily implement logic to skip logs for health-check paths like /health or consistently log specific metrics when a request completes. Designed according to the architecture defined in Fastify's official GitHub PR #6580, it enables high-performance logging filtering at the engine level without the need for ad-hoc hooks that introduce runtime overhead.\n\nBelow is a practical example of inheriting from LogController to ignore logs for the /health path and log elapsed time when the response finishes.\n\nimport Fastify, { LogController, FastifyRequest, FastifyReply } from 'fastify';\n\nclass CustomLogController extends LogController {\n // /health 헬스체크 경로의 로그 기록을 제외합니다.\n override isLogDisabled(request: FastifyRequest): boolean {\n return request.url === '/health';\n }\n\n // 요청 완료 시점에 실행되어 최종 처리 지표를 기록합니다.\n override requestCompleted(\n error: Error | null,\n request: FastifyRequest,\n reply: FastifyReply,\n metadata?: Record\n ): void {\n const duration = reply.elapsedTime; // Fastify v5에서 표준화된 경과 시간 속성\n const level = error ? 'error' : 'info';\n\n request.log[level]({\n duration,\n statusCode: reply.statusCode,\n err: error\n }, 'request completed');\n }\n}\n\nconst server = Fastify({\n logController: new CustomLogController()\n});\n\nAs shown in the code above, we use the reply.elapsedTime property recommended in v5 instead of the traditional reply.getResponseTime() to precisely record processing time. Thanks to this object-oriented transition in the log controller layer, you can build a logging pipeline that is both highly readable and easy to maintain.\n\n2. Schema-based Validation and Perfect Type Inference with TypeBox\n\nFastify v5 has completely dropped support for previous, incomplete shorthand schemas; all route validation must now adhere to the standard JSON Schema specification. TypeBox is the most effective tool to meet these strict requirements without sacrificing productivity. TypeScript developers can combine it with @fastify/type-provider-typebox to achieve both runtime validation and compile-time type inference from a single definition.\n\nThe key is to call the withTypeProvider method via method chaining directly on the constructor function when creating the Fastify instance. If called independently after the instance is already created, the updated type provider information will not propagate correctly, so caution is advised.\n\nimport Fastify from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport { Type } from '@sinclair/typebox'\n\n// 생성자 호출부에 직접 체이닝하여 인스턴스를 생성합니다.\nconst fastify = Fastify().withTypeProvider()\n\nfastify.post('/users', {\n schema: {\n body: Type.Object({\n name: Type.String(),\n email: Type.String({ format: 'email' })\n }),\n response: {\n 201: Type.Object({\n id: Type.String(),\n name: Type.String()\n })\n }\n }\n}, async (request, reply) => {\n // request.body의 name과 email 타입이 자동으로 완벽하게 추론됩니다.\n const { name, email } = request.body\n \n return reply.status(201).send({\n id: 'user-123',\n name\n })\n})\n\nApplying this pattern ensures that request.body and response data structures are perfectly synchronized with TypeScript's static type system as soon as the schema is defined. Since it uses the high-performance, proven Ajv compiler without adding runtime overhead, this is a standard, essential pattern for enterprise environments requiring both type safety and high performance.\n\n3. avvio-based Plugin Architecture and the Decorator Pattern\n\nFastify utilizes an avvio-based directed acyclic graph (DAG) plugin loader system that provides strict encapsulation by default, thoroughly preventing global state pollution. This structure ensures that middleware or hooks defined in one location cannot inadvertently leak into other routes.\n\nHowever, common resources that must be shared across the entire application—such as database clients or global caches—need to break this encapsulation and be exported to the parent context. Wrapping a plugin with the official helper package fastify-plugin breaks this encapsulation, allowing resources registered as decorators to be accessed globally. Conversely, for standard API route configurations, maintaining encapsulation remains the best practice.\n\nThe following is a best-practice implementation for registering a database client as a global decorator and using it safely in a TypeScript environment.\n\nimport fp from 'fastify-plugin';\nimport { FastifyPluginAsync } from 'fastify';\n\n// 가상의 데이터베이스 클라이언트\nconst dbClient = {\n query: async (sql: string) => `Executed: ${sql}`,\n};\n\n// TypeScript 모듈 보강을 통한 인스턴스 타입 확장\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: typeof dbClient;\n }\n}\n\nconst dbPlugin: FastifyPluginAsync = async (fastify) => {\n // fastify-plugin 덕분에 부모 컨텍스트로 노출됩니다.\n fastify.decorate('db', dbClient);\n};\n\nexport default fp(dbPlugin);\n\nBy wrapping plugins with fastify-plugin and adding module augmentation, you can manage shared resources flexibly while ensuring full type safety at the compiler level.\n\nConclusion: Production Migration Checklist\n\nHere is a key checklist to keep in mind when building new or upgrading existing production applications based on Fastify v5.10.x.\n\nFirst, verify your infrastructure's runtime environment. Fastify v5 has cleared away legacy code and old API debt, raising the minimum requirement to Node.js 20 or higher. If you are using an older version of Node.js, a runtime update must come first.\n\nSecond, reflect changes to performance measurement and route-checking APIs. The reply.getResponseTime() method, commonly used to query response latency, has been removed; you must now read the value directly via the reply.elapsedTime property. Additionally, the fastify.hasRoute() method, which checked for the existence of specific paths, now strictly matches exact string paths and no longer supports ambiguous forward-matching searches.\n\nThird, transition the structure of your schema validation and logging pipelines. As partial support for shorthand schemas has been completely discontinued, all route validation must be defined in compliance with the full standard JSON Schema specification. For logging, since the top-level option disableRequestLogging is now deprecated, we recommend migrating to a lifecycle control approach by inheriting from the LogController class.\n\nFastify, refined through these cleanup efforts, provides significantly enhanced performance and type safety by reducing unnecessary request overhead. For organizations designing high-performance microservice infrastructure or operating large-scale TypeScript backends, Fastify v5.10.x will serve as a solid technical foundation.\n\nReference Links\n\nfastify/fastify GitHub Releases — Fastify v5.10.0 Release & Introduction of the LogController Layer\nfastify/fastify TypeScript Types — LogController Class Typings & Lifecycle Hooks\nfastify-log-controller GitHub — Dynamic Runtime Log Adjustments via fastify-log-controller","Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴\n\nFastify 5.10 ガイド — LogControllerとTypeBoxの実践パターン\n\nNode.jsエコシステムにおいて高性能バックエンド構築の標準となったFastifyが、v5.10.xのアップデートでさらに堅牢かつ柔軟になりました。今回のメジャーバージョンでは、古いレガシーな構造を排除し、完全なJSONスキーマ仕様への準拠を義務付けるとともに、新しいログコントローラー層を通じてロギングの性能と拡張性を大幅に強化しています。複雑なマイクロサービス環境下でランタイム性能を最大化し、堅牢な型安全性を確保するために、開発者が必ず適用すべきコアとなるプロダクション設計パターンをまとめます。\n\n1. LogControllerの導入 — 宣言的に制御するリクエストログ\n\nFastify v5.10.0における最大のアーキテクチャ上の変更点は、新しいログコントローラー層の導入です。従来のトップレベルオプションであったdisableRequestLoggingとrequestIdLogLabelは公式に非推奨となり（FSTDEP023、FSTDEP024）、将来のv6バージョンで完全に削除される予定です。代わりに、開発者は公式のLogControllerクラスを継承することで、宣言的かつオブジェクト指向的な方法でロギングのライフサイクルを制御できるようになりました。\n\nこの構造を利用すれば、/healthのようなヘルスチェック経路のログを省略したり、リクエスト完了時に特定の指標を一貫して記録するロジックを容易に実装できます。Fastify公式GitHubのPR #6580で定義されたアーキテクチャに基づいて設計されており、ランタイムオーバーヘッドを引き起こす一時的なフック呼び出しなしに、エンジンレベルでの高性能なロギングフィルタリングが可能です。\n\n以下は、LogControllerを継承して/healthパスのログを無視し、レスポンス終了時に経過時間を記録する実践例です。\n\nimport Fastify, { LogController, FastifyRequest, FastifyReply } from 'fastify';\n\nclass CustomLogController extends LogController {\n // /health 헬스체크 경로의 로그 기록을 제외합니다.\n override isLogDisabled(request: FastifyRequest): boolean {\n return request.url === '/health';\n }\n\n // 요청 완료 시점에 실행되어 최종 처리 지표를 기록합니다.\n override requestCompleted(\n error: Error | null,\n request: FastifyRequest,\n reply: FastifyReply,\n metadata?: Record\n ): void {\n const duration = reply.elapsedTime; // Fastify v5에서 표준화된 경과 시간 속성\n const level = error ? 'error' : 'info';\n\n request.log[level]({\n duration,\n statusCode: reply.statusCode,\n err: error\n }, 'request completed');\n }\n}\n\nconst server = Fastify({\n logController: new CustomLogController()\n});\n\n上記コードのように、従来のreply.getResponseTime()の代わりにv5で推奨されるreply.elapsedTimeプロパティを活用して、処理時間を精密に記録します。このようにオブジェクト指向パターンへ移行したログコントローラー層のおかげで、可読性が高くメンテナンスの容易なロギングパイプラインを構築できます。\n\n2. TypeBoxによるスキーマベースの検証と完全な型推論\n\nFastify v5では、従来の不完全な簡易短縮スキーマのサポートが完全に終了し、すべてのルート検証において標準JSONスキーマ仕様の遵守が必須となりました。これらの厳格な検証要件を生産性を落とさずに解決する最も効果的なツールがTypeBoxです。TypeScript開発者は@fastify/type-provider-typeboxを組み合わせることで、一度の定義でランタイム検証とコンパイル時の型推論を同時に達成できます。\n\n重要な点は、Fastifyインスタンスを作成する際、withTypeProviderメソッドをコンストラクタ関数に対して直接メソッドチェーンで呼び出す必要があるという点です。既に作成されたインスタンスに対して単独で呼び出すと、変更された型プロバイダー情報が正しく伝播されないため注意が必要です。\n\nimport Fastify from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport { Type } from '@sinclair/typebox'\n\n// 생성자 호출부에 직접 체이닝하여 인스턴스를 생성합니다.\nconst fastify = Fastify().withTypeProvider()\n\nfastify.post('/users', {\n schema: {\n body: Type.Object({\n name: Type.String(),\n email: Type.String({ format: 'email' })\n }),\n response: {\n 201: Type.Object({\n id: Type.String(),\n name: Type.String()\n })\n }\n }\n}, async (request, reply) => {\n // request.body의 name과 email 타입이 자동으로 완벽하게 추론됩니다.\n const { name, email } = request.body\n \n return reply.status(201).send({\n id: 'user-123',\n name\n })\n})\n\nこのパターンを適用すれば、スキーマを定義した瞬間にrequest.bodyおよびレスポンスデータ構造がTypeScriptの静的型システムと完全に同期されます。追加のランタイムオーバーヘッドはなく、パフォーマンスが検証済みのAjvコンパイラをそのまま使用するため、型安全性と高性能を同時に求められるエンタープライズ環境において不可欠な標準パターンです。\n\n3. avvioベースのプラグインアーキテクチャとデコレーターパターン\n\nFastifyは、avvioベースの有向非巡回グラフ（DAG）プラグインローダーシステムを使用し、グローバル状態の汚染を徹底的に防ぐ厳格なカプセル化を標準で提供します。この構造のおかげで、ある場所で定義したミドルウェアやフックが意図せず他のルートに波及する副作用を根本から遮断できます。\n\nしかし、データベースクライアントやグローバルキャッシュのようにアプリケーション全体で共有すべき共通リソースは、このカプセル化を解除して上位コンテキストへエクスポートする必要があります。この時、公式のヘルパーパッケージであるfastify-pluginでプラグインをラップしてエクスポートすれば、カプセル化が解除され、デコレーターとして登録したリソースにグローバルからアクセスできるようになります。一方、一般的なAPIルート構成については、カプセル化をそのまま維持するのがベストプラクティスです。\n\n以下は、TypeScript環境でデータベースクライアントをグローバルデコレーターとして登録し、安全に使用するための模範的な実装方法です。\n\nimport fp from 'fastify-plugin';\nimport { FastifyPluginAsync } from 'fastify';\n\n// 가상의 데이터베이스 클라이언트\nconst dbClient = {\n query: async (sql: string) => `Executed: ${sql}`,\n};\n\n// TypeScript 모듈 보강을 통한 인스턴스 타입 확장\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: typeof dbClient;\n }\n}\n\nconst dbPlugin: FastifyPluginAsync = async (fastify) => {\n // fastify-plugin 덕분에 부모 컨텍스트로 노출됩니다.\n fastify.decorate('db', dbClient);\n};\n\nexport default fp(dbPlugin);\n\nこのようにfastify-pluginでプラグインをラップし、モジュールの拡張（Augmentation）を追加すれば、コンパイラレベルでの型安全性を完全に保証しつつ、柔軟に共有リソースを管理できます。\n\n結論：プロダクションへの移行チェックリスト\n\nFastify v5.10.xをベースにプロダクションアプリケーションを新規構築、あるいはアップグレードする際に必ず確認すべき重要チェックリストです。\n\n第一に、インフラのランタイム環境を確認する必要があります。Fastify v5はレガシーコードや古いAPIの負債を整理し、最小動作要件をNode.js 20以上に引き上げました。以前のバージョンのNode.jsを使用している場合は、ランタイムのアップデートが先行して必要です。\n\n第二に、性能測定およびルート確認APIの変更点を反映する必要があります。レスポンスの遅延時間を取得するために一般的に使用されていたreply.getResponseTime()メソッドが削除されたため、現在はreply.elapsedTimeプロパティから値を直接読み取る必要があります。また、特定のルートが存在するかを確認するfastify.hasRoute()メソッドは、前方一致のような曖昧な探索をサポートせず、完全に一致する文字列パスのみをマッチングするように挙動が厳格化されました。\n\n第三に、スキーマ検証とロギングパイプラインの構造的な転換です。過去に部分的に許容されていた簡易短縮スキーマはサポートが完全に終了したため、すべてのルート検証は完全な標準JSONスキーマ仕様に従って定義しなければなりません。ロギングについては、従来のトップレベルオプションであるdisableRequestLoggingが非推奨となったため、長期的にはLogControllerクラスを継承してライフサイクルを制御する方法へ移行することを推奨します。\n\nこのような整備を経て構築されたFastifyは、不要なリクエストのオーバーヘッドを削減し、より強力な性能と型安全性を提供します。高性能なマイクロサービスインフラを設計したり、大規模なTypeScriptバックエンドを安定的に運用したい組織にとって、Fastify v5.10.xは心強い技術的基盤となるでしょう。\n\n参考リンク\n\nfastify/fastify GitHub Releases — Fastify v5.10.0リリースとLogController層の導入\nfastify/fastify TypeScript Types — LogControllerクラスの型定義とライフサイクルフック\nfastify-log-controller GitHub — fastify-log-controllerによる動的なランタイムログ調整","Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴\n\nFastify 5.10 가이드 — LogController와 TypeBox 실전 패턴\n\nNode.js 생태계에서 고성능 백엔드 구축의 표준으로 자리 잡은 Fastify가 v5.10.x 업데이트를 통해 한층 더 견고하고 유연해졌습니다. 이번 메이저 버전은 오래된 레거시 구조를 걷어내고 완벽한 JSON 스키마 사양 준수를 의무화하는 한편, 새로운 로그 컨트롤러 계층을 통해 로깅 성능과 확장성을 대폭 강화했습니다. 복잡한 마이크로서비스 환경에서 런타임 성능을 극대화하고 견고한 타입 안전성을 확보하기 위해, 개발자가 반드시 적용해야 할 핵심 프로덕션 설계 패턴을 정리합니다.\n\n1. LogController 도입 — 선언적으로 제어하는 요청 로그\n\nFastify v5.10.0의 가장 큰 아키텍처 변화는 새로운 로그 컨트롤러 계층의 도입입니다. 기존 최상위 옵션이던 disableRequestLogging과 requestIdLogLabel은 공식적으로 더 이상 권장되지 않으며(FSTDEP023, FSTDEP024), 향후 v6 버전에서 완전히 제거될 예정입니다. 대신 이제 개발자는 공식 LogController 클래스를 상속받아 선언적이고 객체지향적인 방식으로 로깅 수명 주기를 제어할 수 있습니다.\n\n이 구조를 사용하면 /health 같은 헬스체크 경로의 로그를 생략하거나, 요청이 완료되는 시점에 특정 지표를 일관되게 기록하는 로직을 손쉽게 구현할 수 있습니다. Fastify 공식 깃허브의 PR #6580에 정의된 아키텍처에 따라 설계되어, 런타임 오버헤드를 유발하는 임시방편적인 훅 호출 없이 엔진 수준에서 고성능 로깅 필터링이 가능합니다.\n\n다음은 LogController를 상속받아 /health 경로의 로그를 무시하고, 응답이 끝난 시점에 경과 시간을 기록하는 실전 예시입니다.\n\nimport Fastify, { LogController, FastifyRequest, FastifyReply } from 'fastify';\n\nclass CustomLogController extends LogController {\n // /health 헬스체크 경로의 로그 기록을 제외합니다.\n override isLogDisabled(request: FastifyRequest): boolean {\n return request.url === '/health';\n }\n\n // 요청 완료 시점에 실행되어 최종 처리 지표를 기록합니다.\n override requestCompleted(\n error: Error | null,\n request: FastifyRequest,\n reply: FastifyReply,\n metadata?: Record\n ): void {\n const duration = reply.elapsedTime; // Fastify v5에서 표준화된 경과 시간 속성\n const level = error ? 'error' : 'info';\n\n request.log[level]({\n duration,\n statusCode: reply.statusCode,\n err: error\n }, 'request completed');\n }\n}\n\nconst server = Fastify({\n logController: new CustomLogController()\n});\n\n위 코드처럼 기존의 reply.getResponseTime() 대신 v5에서 권장하는 reply.elapsedTime 속성을 활용해 처리 시간을 정밀하게 기록합니다. 이처럼 객체지향적 패턴으로 전환된 로그 컨트롤러 계층 덕분에 가독성이 뛰어나고 유지보수하기 쉬운 로깅 파이프라인을 구축할 수 있습니다.\n\n2. TypeBox를 통한 스키마 기반 검증과 완벽한 타입 추론\n\nFastify v5에서는 기존의 불완전한 약식 단축 스키마 지원이 완전히 중단되었으며, 모든 라우트 검증에 반드시 표준 JSON 스키마 명세를 준수해야 합니다. 이러한 엄격한 검증 요건을 생산성 저하 없이 해결하는 가장 효과적인 도구가 바로 TypeBox입니다. TypeScript 개발자는 @fastify/type-provider-typebox를 결합하여 단 한 번의 정의로 런타임 검증과 컴파일 타임 타입 추론을 동시에 달성할 수 있습니다.\n\n핵심은 Fastify 인스턴스를 생성할 때 withTypeProvider 메서드를 생성자 함수에 직접 메서드 체이닝으로 호출해야 한다는 점입니다. 이미 생성된 인스턴스 뒤에 단독으로 호출하면 변경된 타입 프로바이더 정보가 올바르게 전파되지 않으므로 주의가 필요합니다.\n\nimport Fastify from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport { Type } from '@sinclair/typebox'\n\n// 생성자 호출부에 직접 체이닝하여 인스턴스를 생성합니다.\nconst fastify = Fastify().withTypeProvider()\n\nfastify.post('/users', {\n schema: {\n body: Type.Object({\n name: Type.String(),\n email: Type.String({ format: 'email' })\n }),\n response: {\n 201: Type.Object({\n id: Type.String(),\n name: Type.String()\n })\n }\n }\n}, async (request, reply) => {\n // request.body의 name과 email 타입이 자동으로 완벽하게 추론됩니다.\n const { name, email } = request.body\n \n return reply.status(201).send({\n id: 'user-123',\n name\n })\n})\n\n이 패턴을 적용하면 스키마를 정의하는 즉시 request.body 및 응답 데이터 구조가 TypeScript의 정적 타입 시스템과 완벽히 동기화됩니다. 추가적인 런타임 오버헤드가 없으며 성능이 검증된 Ajv 컴파일러를 그대로 사용하므로, 타입 안전성과 고성능을 동시에 확보해야 하는 엔터프라이즈 환경에서 필수적인 표준 패턴입니다.\n\n3. avvio 기반 플러그인 아키텍처와 데코레이터 패턴\n\nFastify는 avvio 기반의 방향성 비순환 그래프(DAG) 플러그인 로더 시스템을 사용해 전역 상태 오염을 철저히 방지하는 엄격한 캡슐화를 기본으로 제공합니다. 이 구조 덕분에 한 곳에서 정의한 미들웨어나 훅이 의도치 않게 다른 라우트로 번지는 부작용을 원천 차단할 수 있습니다.\n\n하지만 데이터베이스 클라이언트나 전역 캐시처럼 애플리케이션 전체에서 공유해야 하는 공통 리소스는 이 캡슐화를 깨고 상위 컨텍스트로 내보내야 합니다. 이때 공식 도우미 패키지인 fastify-plugin으로 플러그인을 감싸서 내보내면 캡슐화가 해제되어 데코레이터로 등록한 리소스를 전역에서 접근할 수 있게 됩니다. 반면, 일반적인 API 라우트 구성은 캡슐화를 그대로 유지하는 것이 모범 사례입니다.\n\n다음은 TypeScript 환경에서 데이터베이스 클라이언트를 전역 데코레이터로 등록하고 안전하게 사용하기 위한 모범적인 구현 방식입니다.\n\nimport fp from 'fastify-plugin';\nimport { FastifyPluginAsync } from 'fastify';\n\n// 가상의 데이터베이스 클라이언트\nconst dbClient = {\n query: async (sql: string) => `Executed: ${sql}`,\n};\n\n// TypeScript 모듈 보강을 통한 인스턴스 타입 확장\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: typeof dbClient;\n }\n}\n\nconst dbPlugin: FastifyPluginAsync = async (fastify) => {\n // fastify-plugin 덕분에 부모 컨텍스트로 노출됩니다.\n fastify.decorate('db', dbClient);\n};\n\nexport default fp(dbPlugin);\n\n이와 같이 fastify-plugin으로 플러그인을 래핑하고 모듈 보강을 추가하면 컴파일러 수준에서 타입 안정성을 완벽히 보장받으면서 유연하게 공유 자원을 관리할 수 있습니다.\n\n결론: 프로덕션 마이그레이션 체크리스트\n\nFastify v5.10.x 기반으로 프로덕션 애플리케이션을 새로 구축하거나 업그레이드할 때 반드시 점검해야 할 핵심 체크리스트입니다.\n\n첫째, 인프라의 런타임 환경을 확인해야 합니다. Fastify v5는 레거시 코드와 오래된 API 부채를 정리하며 최소 구동 요구사항을 Node.js 20 이상으로 격상했습니다. 이전 버전의 Node.js를 사용 중이라면 런타임 업데이트가 선행되어야 합니다.\n\n둘째, 성능 측정과 라우트 확인 API의 변경 사항을 반영해야 합니다. 기존에 응답 지연 시간을 조회할 때 흔히 사용하던 reply.getResponseTime() 메서드가 제거되었으므로, 이제는 reply.elapsedTime 속성을 통해 값을 직접 읽어와야 합니다. 또한 특정 경로의 존재 여부를 검사하던 fastify.hasRoute() 메서드는 전방 일치 방식의 모호한 탐색을 지원하지 않으며, 정확히 일치하는 문자열 경로만 매칭하도록 동작이 엄격해졌습니다.\n\n셋째, 스키마 검증과 로깅 파이프라인의 구조적 전환입니다. 과거에 부분적으로 허용되던 약식 단축 스키마는 지원이 완전히 중단되었으므로 모든 라우트 검증은 완전한 표준 JSON 스키마 명세를 준수해 정의해야 합니다. 로깅의 경우, 기존의 최상위 옵션인 disableRequestLogging이 비권장 대상으로 지정되었기 때문에 장기적으로는 LogController 클래스를 상속받아 수명 주기를 제어하는 방식으로 마이그레이션할 것을 권장합니다.\n\n이러한 정돈 작업을 거쳐 구축된 Fastify는 불필요한 요청 오버헤드를 줄여 한층 강력해진 성능과 타입 안전성을 제공합니다. 고성능 마이크로서비스 인프라를 설계하거나 대규모 TypeScript 백엔드를 안정적으로 운영하고자 하는 조직에게 Fastify v5.10.x는 든든한 기술적 기반이 될 것입니다.\n\n참고 링크\n\nfastify/fastify GitHub Releases — Fastify v5.10.0 Release & Introduction of the LogController Layer\nfastify/fastify TypeScript Types — LogController Class Typings & Lifecycle Hooks\nfastify-log-controller GitHub — Dynamic Runtime Log Adjustments via fastify-log-controller",{"_1892":8014,"_1893":8015,"_1802":8016},"Fastify 5.10 Guide — Practical Patterns for LogController and TypeBox Fastify, the standard for building high-performance backends in the Node.js ecosystem, has become even more robust and flexible with the v5.10.x updat…","Fastify 5.10 ガイド — LogControllerとTypeBoxの実践パターン Node.jsエコシステムにおいて高性能バックエンド構築の標準となったFastifyが、v5.10.xのアップデートでさらに堅牢かつ柔軟になりました。今回のメジャーバージョンでは、古いレガシーな構造を排除し、完全なJSONスキーマ仕様への準拠を義務付けるとともに、新しいログコントローラー層を通じてロギングの性能と拡張性を大幅に強化しています。…","Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴 Node.js 생태계에서 고성능 백엔드 구축의 표준으로 자리 잡은 Fastify가 v5.10.x 업데이트를 통해 한층 더 견고하고 유연해졌습니다. 이번 메이저 버전은 오래된 레거시 구조를 걷어내고 완벽한 JSON 스키마 사양 준수를 의무화하는 한편, 새로운 로그 컨트롤러 계층을 통해 로깅 성능과 확장성을 대…","cms734y6r01sx10nvg36we3ae",[3122],[3124,3125,8020,3128,3127],"nodejs",[],"2026-07-30T16:31:32.988Z","2026-07-30T04:39:59.124Z","2026-07-30T16:31:57.175Z","2026-07-30T16:31:57.152Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":8027},{"_1901":8028},{"_1903":8029,"_1908":1909,"_1910":8030,"_1921":8031,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":8032,"_1928":8033,"_1933":8034,"_1938":8035},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":8037,"_1883":1884,"_1200":1204,"_1899":8040},{"_633":8038,"_11":8039},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":8041},{"_1903":8042,"_1908":1909,"_1910":8043,"_1921":8044,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":8045,"_1928":8046,"_1933":8047,"_1938":8048},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":8050},{"_1948":-5,"_1908":1909,"_1910":8051,"_1960":-5,"_1943":8056,"_1962":8057},{"_1912":8052,"_1914":8053,"_1952":8054,"_1810":2534,"_944":1992,"_1917":8055,"_1957":2536,"_1919":3181},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/869a7f83-5835-444a-b777-b7dd66c9edc9.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/869a7f83-5835-444a-b777-b7dd66c9edc9.jpg",428756,"L984-,~X%3OS?b-;xuRjDPJ5ofnT","2026-07-30T05:40:49.138Z",{"_1964":8058,"_1972":8062,"_1979":8066,"_1986":-5},{"_1912":8059,"_1914":8060,"_1952":8061,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/large.webp",28940,{"_1912":8063,"_1914":8064,"_1952":8065,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/small.webp",7034,{"_1912":8067,"_1914":8068,"_1952":8069,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms734y6r01sx10nvg36we3ae/medium.webp",16004,{"_950":8071,"_2559":7995,"_2560":8072,"_2716":8394,"_2788":8504,"_2790":8505,"_2792":4226,"_2794":1997,"_2003":8506,"_2480":8507,"_2797":-5},"cms70yqai01g910nvu0glti5s",{"_918":8073,"_1908":1909},[8074,8076,8079,8083,8086,8091,8094,8099,8102,8119,8122,8132,8135,8147,8150,8153,8156,8171,8174,8179,8182,8191,8194,8209,8212,8215,8218,8227,8230,8235,8238,8243,8246,8256,8259,8264,8267,8270,8273,8282,8285,8290,8293,8298,8301,8306,8309,8327,8330,8343,8346,8351,8354,8356,8359,8364,8367],{"_950":8075,"_2565":8008,"_2420":2566,"_2567":8017},"327974da-d289-44f1-9789-e36eab2b633d",{"_950":8077,"_2420":2570,"_2571":8078},"7d6489cc-62b3-4cd4-99ba-c9abd473db0b",[],{"_950":8080,"_2420":2575,"_2576":1909,"_2571":8081},"ddcf621a-2aed-42f5-be4d-2b5345da5cc0",[8082],{"_2579":8008,"_2420":2579},{"_950":8084,"_2420":2570,"_2571":8085},"41f22711-c229-4f46-9ca8-5de118838826",[],{"_950":8087,"_2420":2570,"_2571":8088},"a81bc895-f455-4217-82af-874517b2006e",[8089],{"_2579":8090,"_2420":2579},"Node.js 생태계에서 고성능 백엔드 구축의 표준으로 자리 잡은 Fastify가 v5.10.x 업데이트를 통해 한층 더 견고하고 유연해졌습니다. 이번 메이저 버전은 오래된 레거시 구조를 걷어내고 완벽한 JSON 스키마 사양 준수를 의무화하는 한편, 새로운 로그 컨트롤러 계층을 통해 로깅 성능과 확장성을 대폭 강화했습니다. 복잡한 마이크로서비스 환경에서 런타임 성능을 극대화하고 견고한 타입 안전성을 확보하기 위해, 개발자가 반드시 적용해야 할 핵심 프로덕션 설계 패턴을 정리합니다.",{"_950":8092,"_2420":2570,"_2571":8093},"fbe9e360-3ab7-49a8-b5f8-dc548c7fd13f",[],{"_950":8095,"_2420":2575,"_2576":2007,"_2571":8096},"549a5fb5-6d55-4330-bd4a-ba57bcb4aa17",[8097],{"_2579":8098,"_2420":2579},"1. LogController 도입 — 선언적으로 제어하는 요청 로그",{"_950":8100,"_2420":2570,"_2571":8101},"698dfe91-81ae-497c-9df1-f0539f32ab2e",[],{"_950":8103,"_2420":2570,"_2571":8104},"d26b6057-bd8b-4ca1-8a09-c0737ad4cfda",[8105,8107,8109,8110,8113,8115,8117],{"_2579":8106,"_2420":2579},"Fastify v5.10.0의 가장 큰 아키텍처 변화는 새로운 로그 컨트롤러 계층의 도입입니다. 기존 최상위 옵션이던 ",{"_2579":3406,"_2420":2579,"_3365":8108},{"_3351":3367},{"_2579":7813,"_2420":2579},{"_2579":8111,"_2420":2579,"_3365":8112},"requestIdLogLabel",{"_3351":3367},{"_2579":8114,"_2420":2579},"은 공식적으로 더 이상 권장되지 않으며(FSTDEP023, FSTDEP024), 향후 v6 버전에서 완전히 제거될 예정입니다. 대신 이제 개발자는 공식 ",{"_2579":3401,"_2420":2579,"_3365":8116},{"_3351":3367},{"_2579":8118,"_2420":2579}," 클래스를 상속받아 선언적이고 객체지향적인 방식으로 로깅 수명 주기를 제어할 수 있습니다.",{"_950":8120,"_2420":2570,"_2571":8121},"4dc2fb14-98af-4a98-a6ce-eaadb2ee32c2",[],{"_950":8123,"_2420":2570,"_2571":8124},"fa99e52b-2af7-485c-af6b-763c8b034beb",[8125,8127,8130],{"_2579":8126,"_2420":2579},"이 구조를 사용하면 ",{"_2579":8128,"_2420":2579,"_3365":8129},"/health",{"_3351":3367},{"_2579":8131,"_2420":2579}," 같은 헬스체크 경로의 로그를 생략하거나, 요청이 완료되는 시점에 특정 지표를 일관되게 기록하는 로직을 손쉽게 구현할 수 있습니다. Fastify 공식 깃허브의 PR #6580에 정의된 아키텍처에 따라 설계되어, 런타임 오버헤드를 유발하는 임시방편적인 훅 호출 없이 엔진 수준에서 고성능 로깅 필터링이 가능합니다.",{"_950":8133,"_2420":2570,"_2571":8134},"59bef498-2e95-49c5-a1f7-2f07561e67c2",[],{"_950":8136,"_2420":2570,"_2571":8137},"98a1ccb5-ea1b-4e2a-b2d9-2244e93803a0",[8138,8139,8141,8143,8145],{"_2579":6380,"_2420":2579},{"_2579":3401,"_2420":2579,"_3365":8140},{"_3351":3367},{"_2579":8142,"_2420":2579},"를 상속받아 ",{"_2579":8128,"_2420":2579,"_3365":8144},{"_3351":3367},{"_2579":8146,"_2420":2579}," 경로의 로그를 무시하고, 응답이 끝난 시점에 경과 시간을 기록하는 실전 예시입니다.",{"_950":8148,"_2420":2570,"_2571":8149},"707f3486-2b66-4ea4-9c9e-937520515fd2",[],{"_950":8151,"_3351":8152,"_2420":3351,"_625":3125},"44dbb7d4-3282-4e39-8d5b-a989beeb0421","import Fastify, { LogController, FastifyRequest, FastifyReply } from 'fastify';\n\nclass CustomLogController extends LogController {\n // /health 헬스체크 경로의 로그 기록을 제외합니다.\n override isLogDisabled(request: FastifyRequest): boolean {\n return request.url === '/health';\n }\n\n // 요청 완료 시점에 실행되어 최종 처리 지표를 기록합니다.\n override requestCompleted(\n error: Error | null,\n request: FastifyRequest,\n reply: FastifyReply,\n metadata?: Record\n ): void {\n const duration = reply.elapsedTime; // Fastify v5에서 표준화된 경과 시간 속성\n const level = error ? 'error' : 'info';\n\n request.log[level]({\n duration,\n statusCode: reply.statusCode,\n err: error\n }, 'request completed');\n }\n}\n\nconst server = Fastify({\n logController: new CustomLogController()\n});",{"_950":8154,"_2420":2570,"_2571":8155},"ac1c82ba-e831-403e-b29c-221ade6bd4d6",[],{"_950":8157,"_2420":2570,"_2571":8158},"2ec16559-7bb4-4e5d-9c2b-5f0344975d42",[8159,8161,8164,8166,8169],{"_2579":8160,"_2420":2579},"위 코드처럼 기존의 ",{"_2579":8162,"_2420":2579,"_3365":8163},"reply.getResponseTime()",{"_3351":3367},{"_2579":8165,"_2420":2579}," 대신 v5에서 권장하는 ",{"_2579":8167,"_2420":2579,"_3365":8168},"reply.elapsedTime",{"_3351":3367},{"_2579":8170,"_2420":2579}," 속성을 활용해 처리 시간을 정밀하게 기록합니다. 이처럼 객체지향적 패턴으로 전환된 로그 컨트롤러 계층 덕분에 가독성이 뛰어나고 유지보수하기 쉬운 로깅 파이프라인을 구축할 수 있습니다.",{"_950":8172,"_2420":2570,"_2571":8173},"5405a5fd-ab1e-432c-9b24-45c03cb174f5",[],{"_950":8175,"_2420":2575,"_2576":2007,"_2571":8176},"e6797a20-a577-4b03-b7dd-06e0489d847d",[8177],{"_2579":8178,"_2420":2579},"2. TypeBox를 통한 스키마 기반 검증과 완벽한 타입 추론",{"_950":8180,"_2420":2570,"_2571":8181},"a18d4395-c541-4ae1-b20f-f976d24f080f",[],{"_950":8183,"_2420":2570,"_2571":8184},"e14b9cab-7706-4cdd-a082-8de18f170387",[8185,8187,8189],{"_2579":8186,"_2420":2579},"Fastify v5에서는 기존의 불완전한 약식 단축 스키마 지원이 완전히 중단되었으며, 모든 라우트 검증에 반드시 표준 JSON 스키마 명세를 준수해야 합니다. 이러한 엄격한 검증 요건을 생산성 저하 없이 해결하는 가장 효과적인 도구가 바로 TypeBox입니다. TypeScript 개발자는 ",{"_2579":4028,"_2420":2579,"_3365":8188},{"_3351":3367},{"_2579":8190,"_2420":2579},"를 결합하여 단 한 번의 정의로 런타임 검증과 컴파일 타임 타입 추론을 동시에 달성할 수 있습니다.",{"_950":8192,"_2420":2570,"_2571":8193},"700ba63f-ccc7-4eed-9818-62725b7dec2d",[],{"_950":8195,"_2420":2570,"_2571":8196},"a5095bcc-635f-4fdd-aef9-18e03c6f1cc8",[8197,8199,8202,8204,8207],{"_2579":8198,"_2420":2579},"핵심은 Fastify 인스턴스를 생성할 때 ",{"_2579":8200,"_2420":2579,"_3365":8201},"withTypeProvider",{"_3351":3367},{"_2579":8203,"_2420":2579}," 메서드를 생성자 함수에 ",{"_2579":8205,"_2420":2579,"_3365":8206},"직접 메서드 체이닝으로 호출",{"_3485":3367},{"_2579":8208,"_2420":2579},"해야 한다는 점입니다. 이미 생성된 인스턴스 뒤에 단독으로 호출하면 변경된 타입 프로바이더 정보가 올바르게 전파되지 않으므로 주의가 필요합니다.",{"_950":8210,"_2420":2570,"_2571":8211},"b4e031c4-204e-42cc-b861-3fe18d97eb83",[],{"_950":8213,"_3351":8214,"_2420":3351,"_625":3125},"e166bc91-d230-4860-97f5-54e3dbf441dc","import Fastify from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport { Type } from '@sinclair/typebox'\n\n// 생성자 호출부에 직접 체이닝하여 인스턴스를 생성합니다.\nconst fastify = Fastify().withTypeProvider()\n\nfastify.post('/users', {\n schema: {\n body: Type.Object({\n name: Type.String(),\n email: Type.String({ format: 'email' })\n }),\n response: {\n 201: Type.Object({\n id: Type.String(),\n name: Type.String()\n })\n }\n }\n}, async (request, reply) => {\n // request.body의 name과 email 타입이 자동으로 완벽하게 추론됩니다.\n const { name, email } = request.body\n \n return reply.status(201).send({\n id: 'user-123',\n name\n })\n})",{"_950":8216,"_2420":2570,"_2571":8217},"f8bb6596-63ec-4fd9-b9ee-cda6ceebae18",[],{"_950":8219,"_2420":2570,"_2571":8220},"79b48e30-fcea-4462-a359-3d0152c29415",[8221,8223,8225],{"_2579":8222,"_2420":2579},"이 패턴을 적용하면 스키마를 정의하는 즉시 ",{"_2579":3364,"_2420":2579,"_3365":8224},{"_3351":3367},{"_2579":8226,"_2420":2579}," 및 응답 데이터 구조가 TypeScript의 정적 타입 시스템과 완벽히 동기화됩니다. 추가적인 런타임 오버헤드가 없으며 성능이 검증된 Ajv 컴파일러를 그대로 사용하므로, 타입 안전성과 고성능을 동시에 확보해야 하는 엔터프라이즈 환경에서 필수적인 표준 패턴입니다.",{"_950":8228,"_2420":2570,"_2571":8229},"77e6b64e-9ab3-4566-afa6-5b2096733b06",[],{"_950":8231,"_2420":2575,"_2576":2007,"_2571":8232},"29cdc6ce-2ed1-4aa7-960e-04a1c46227f9",[8233],{"_2579":8234,"_2420":2579},"3. avvio 기반 플러그인 아키텍처와 데코레이터 패턴",{"_950":8236,"_2420":2570,"_2571":8237},"f123be07-c00c-401c-acd2-a068cc50d909",[],{"_950":8239,"_2420":2570,"_2571":8240},"47c2decc-cfcd-4acf-9e65-186ac91de28c",[8241],{"_2579":8242,"_2420":2579},"Fastify는 avvio 기반의 방향성 비순환 그래프(DAG) 플러그인 로더 시스템을 사용해 전역 상태 오염을 철저히 방지하는 엄격한 캡슐화를 기본으로 제공합니다. 이 구조 덕분에 한 곳에서 정의한 미들웨어나 훅이 의도치 않게 다른 라우트로 번지는 부작용을 원천 차단할 수 있습니다.",{"_950":8244,"_2420":2570,"_2571":8245},"62993655-2cbc-49e1-ba99-58dd235222af",[],{"_950":8247,"_2420":2570,"_2571":8248},"58e0d1f7-be0b-4ec4-af51-61bdbcb3d5dd",[8249,8251,8254],{"_2579":8250,"_2420":2579},"하지만 데이터베이스 클라이언트나 전역 캐시처럼 애플리케이션 전체에서 공유해야 하는 공통 리소스는 이 캡슐화를 깨고 상위 컨텍스트로 내보내야 합니다. 이때 공식 도우미 패키지인 ",{"_2579":8252,"_2420":2579,"_3365":8253},"fastify-plugin",{"_3351":3367},{"_2579":8255,"_2420":2579},"으로 플러그인을 감싸서 내보내면 캡슐화가 해제되어 데코레이터로 등록한 리소스를 전역에서 접근할 수 있게 됩니다. 반면, 일반적인 API 라우트 구성은 캡슐화를 그대로 유지하는 것이 모범 사례입니다.",{"_950":8257,"_2420":2570,"_2571":8258},"e5fb94f0-1110-428c-9539-63f2062fbc4e",[],{"_950":8260,"_2420":2570,"_2571":8261},"ecebccbb-e47d-4d17-b2c4-a7cdafe15c06",[8262],{"_2579":8263,"_2420":2579},"다음은 TypeScript 환경에서 데이터베이스 클라이언트를 전역 데코레이터로 등록하고 안전하게 사용하기 위한 모범적인 구현 방식입니다.",{"_950":8265,"_2420":2570,"_2571":8266},"5b88b9f9-1abf-4208-971d-ca191b2dffa5",[],{"_950":8268,"_3351":8269,"_2420":3351,"_625":3125},"69f733a6-b856-4c1d-bcd4-14bf92e072c0","import fp from 'fastify-plugin';\nimport { FastifyPluginAsync } from 'fastify';\n\n// 가상의 데이터베이스 클라이언트\nconst dbClient = {\n query: async (sql: string) => `Executed: ${sql}`,\n};\n\n// TypeScript 모듈 보강을 통한 인스턴스 타입 확장\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: typeof dbClient;\n }\n}\n\nconst dbPlugin: FastifyPluginAsync = async (fastify) => {\n // fastify-plugin 덕분에 부모 컨텍스트로 노출됩니다.\n fastify.decorate('db', dbClient);\n};\n\nexport default fp(dbPlugin);",{"_950":8271,"_2420":2570,"_2571":8272},"7e059915-e669-4ee0-b0b9-1e6b8b4eb04d",[],{"_950":8274,"_2420":2570,"_2571":8275},"0817b8e2-584c-4301-b70a-81134d6cd141",[8276,8278,8280],{"_2579":8277,"_2420":2579},"이와 같이 ",{"_2579":8252,"_2420":2579,"_3365":8279},{"_3351":3367},{"_2579":8281,"_2420":2579},"으로 플러그인을 래핑하고 모듈 보강을 추가하면 컴파일러 수준에서 타입 안정성을 완벽히 보장받으면서 유연하게 공유 자원을 관리할 수 있습니다.",{"_950":8283,"_2420":2570,"_2571":8284},"a5a5513b-34ee-4496-ab83-22a3f0721896",[],{"_950":8286,"_2420":2575,"_2576":2007,"_2571":8287},"359a4e85-bb84-42e3-b15d-5db21f97697d",[8288],{"_2579":8289,"_2420":2579},"결론: 프로덕션 마이그레이션 체크리스트",{"_950":8291,"_2420":2570,"_2571":8292},"5ccc35b7-4f1d-4968-9ee6-25b4ed640038",[],{"_950":8294,"_2420":2570,"_2571":8295},"36bb70e5-c878-4241-b99e-633f13098b24",[8296],{"_2579":8297,"_2420":2579},"Fastify v5.10.x 기반으로 프로덕션 애플리케이션을 새로 구축하거나 업그레이드할 때 반드시 점검해야 할 핵심 체크리스트입니다.",{"_950":8299,"_2420":2570,"_2571":8300},"5fcf320b-30c1-433f-88aa-a1c161a0b7af",[],{"_950":8302,"_2420":2570,"_2571":8303},"18b15ec2-bf9a-4e9f-b342-9dc3941caa48",[8304],{"_2579":8305,"_2420":2579},"첫째, 인프라의 런타임 환경을 확인해야 합니다. Fastify v5는 레거시 코드와 오래된 API 부채를 정리하며 최소 구동 요구사항을 Node.js 20 이상으로 격상했습니다. 이전 버전의 Node.js를 사용 중이라면 런타임 업데이트가 선행되어야 합니다.",{"_950":8307,"_2420":2570,"_2571":8308},"7413adbb-b25d-40e0-ab8b-c1ca34865d38",[],{"_950":8310,"_2420":2570,"_2571":8311},"30edde77-d008-4060-9dfb-b2c85062afc9",[8312,8314,8316,8318,8320,8322,8325],{"_2579":8313,"_2420":2579},"둘째, 성능 측정과 라우트 확인 API의 변경 사항을 반영해야 합니다. 기존에 응답 지연 시간을 조회할 때 흔히 사용하던 ",{"_2579":8162,"_2420":2579,"_3365":8315},{"_3351":3367},{"_2579":8317,"_2420":2579}," 메서드가 제거되었으므로, 이제는 ",{"_2579":8167,"_2420":2579,"_3365":8319},{"_3351":3367},{"_2579":8321,"_2420":2579}," 속성을 통해 값을 직접 읽어와야 합니다. 또한 특정 경로의 존재 여부를 검사하던 ",{"_2579":8323,"_2420":2579,"_3365":8324},"fastify.hasRoute()",{"_3351":3367},{"_2579":8326,"_2420":2579}," 메서드는 전방 일치 방식의 모호한 탐색을 지원하지 않으며, 정확히 일치하는 문자열 경로만 매칭하도록 동작이 엄격해졌습니다.",{"_950":8328,"_2420":2570,"_2571":8329},"45a6313d-83a2-4aa2-bcf4-f2a50de9a888",[],{"_950":8331,"_2420":2570,"_2571":8332},"b9f2fa1a-01f2-43f4-b48d-30b2d6184840",[8333,8335,8337,8339,8341],{"_2579":8334,"_2420":2579},"셋째, 스키마 검증과 로깅 파이프라인의 구조적 전환입니다. 과거에 부분적으로 허용되던 약식 단축 스키마는 지원이 완전히 중단되었으므로 모든 라우트 검증은 완전한 표준 JSON 스키마 명세를 준수해 정의해야 합니다. 로깅의 경우, 기존의 최상위 옵션인 ",{"_2579":3406,"_2420":2579,"_3365":8336},{"_3351":3367},{"_2579":8338,"_2420":2579},"이 비권장 대상으로 지정되었기 때문에 장기적으로는 ",{"_2579":3401,"_2420":2579,"_3365":8340},{"_3351":3367},{"_2579":8342,"_2420":2579}," 클래스를 상속받아 수명 주기를 제어하는 방식으로 마이그레이션할 것을 권장합니다.",{"_950":8344,"_2420":2570,"_2571":8345},"4c747606-69a6-4490-a32f-798b610e2843",[],{"_950":8347,"_2420":2570,"_2571":8348},"251fb08b-a882-4d43-b221-1edac4733a3a",[8349],{"_2579":8350,"_2420":2579},"이러한 정돈 작업을 거쳐 구축된 Fastify는 불필요한 요청 오버헤드를 줄여 한층 강력해진 성능과 타입 안전성을 제공합니다. 고성능 마이크로서비스 인프라를 설계하거나 대규모 TypeScript 백엔드를 안정적으로 운영하고자 하는 조직에게 Fastify v5.10.x는 든든한 기술적 기반이 될 것입니다.",{"_950":8352,"_2420":2570,"_2571":8353},"7b6340ae-e0ac-4a7c-a49c-db03c21068bf",[],{"_950":8355,"_2420":3473},"e5d60074-e237-4353-abc2-d2a024aebc9a",{"_950":8357,"_2420":2570,"_2571":8358},"3d29f3e7-04d2-4a06-b8fc-a112cb223470",[],{"_950":8360,"_2420":2570,"_2571":8361},"2f0bec73-0285-4760-98b0-6529d572c71b",[8362],{"_2579":3483,"_2420":2579,"_3365":8363},{"_3485":3367},{"_950":8365,"_2420":2570,"_2571":8366},"6d0c5d19-deae-486d-a6b8-f27b97d466cb",[],{"_950":8368,"_1881":3492,"_2420":3493,"_778":8369},"272db7b1-ae97-41aa-8ca2-fe4c6f6b0a6c",[8370,8378,8386],{"_950":8371,"_2571":8372},"fa5f0cf4-c833-4975-9856-340f159d4500",[8373],{"_3499":8374,"_2420":3501,"_3502":8375},"https://github.com/fastify/fastify/releases/tag/v5.10.0",[8376],{"_2579":8377,"_2420":2579},"fastify/fastify GitHub Releases — Fastify v5.10.0 Release & Introduction of the LogController Layer",{"_950":8379,"_2571":8380},"88522e13-b5df-4127-a65c-e1c8ac3b927d",[8381],{"_3499":8382,"_2420":3501,"_3502":8383},"https://github.com/fastify/fastify/blob/main/types/logger.d.ts",[8384],{"_2579":8385,"_2420":2579},"fastify/fastify TypeScript Types — LogController Class Typings & Lifecycle Hooks",{"_950":8387,"_2571":8388},"0bd6863c-cc6e-4340-9d31-aa5325d33b46",[8389],{"_3499":8390,"_2420":3501,"_3502":8391},"https://github.com/Eomm/fastify-log-controller",[8392],{"_2579":8393,"_2420":2579},"fastify-log-controller GitHub — Dynamic Runtime Log Adjustments via fastify-log-controller",{"_8274":8395,"_8302":8400,"_8347":8404,"_8368":8408,"_8231":8418,"_8157":8422,"_8360":8427,"_8310":8429,"_8286":8434,"_8294":8438,"_8239":8442,"_8095":8446,"_8247":8450,"_8219":8455,"_8136":8460,"_8195":8465,"_8087":8470,"_8331":8474,"_8103":8479,"_8080":8484,"_8183":8486,"_8175":8491,"_8260":8495,"_8123":8499},{"_2571":8396},{"_1892":8397,"_1893":8398,"_1802":8399},"By wrapping plugins with fastify-plugin and adding module augmentation, you can manage shared resources flexibly while ensuring full type safety at the compiler level.","このようにfastify-pluginでプラグインをラップし、モジュールの拡張（Augmentation）を追加すれば、コンパイラレベルでの型安全性を完全に保証しつつ、柔軟に共有リソースを管理できます。","이와 같이 fastify-plugin으로 플러그인을 래핑하고 모듈 보강을 추가하면 컴파일러 수준에서 타입 안정성을 완벽히 보장받으면서 유연하게 공유 자원을 관리할 수 있습니다.",{"_2571":8401},{"_1892":8402,"_1893":8403,"_1802":8305},"First, verify your infrastructure's runtime environment. Fastify v5 has cleared away legacy code and old API debt, raising the minimum requirement to Node.js 20 or higher. If you are using an older version of Node.js, a runtime update must come first.","第一に、インフラのランタイム環境を確認する必要があります。Fastify v5はレガシーコードや古いAPIの負債を整理し、最小動作要件をNode.js 20以上に引き上げました。以前のバージョンのNode.jsを使用している場合は、ランタイムのアップデートが先行して必要です。",{"_2571":8405},{"_1892":8406,"_1893":8407,"_1802":8350},"Fastify, refined through these cleanup efforts, provides significantly enhanced performance and type safety by reducing unnecessary request overhead. For organizations designing high-performance microservice infrastructure or operating large-scale TypeScript backends, Fastify v5.10.x will serve as a solid technical foundation.","このような整備を経て構築されたFastifyは、不要なリクエストのオーバーヘッドを削減し、より強力な性能と型安全性を提供します。高性能なマイクロサービスインフラを設計したり、大規模なTypeScriptバックエンドを安定的に運用したい組織にとって、Fastify v5.10.xは心強い技術的基盤となるでしょう。",{"_8409":8410,"_8412":8413,"_8415":8416},"item:0bd6863c-cc6e-4340-9d31-aa5325d33b46",{"_1892":8393,"_1893":8411,"_1802":8393},"fastify-log-controller GitHub — fastify-log-controllerによる動的なランタイムログ調整","item:88522e13-b5df-4127-a65c-e1c8ac3b927d",{"_1892":8385,"_1893":8414,"_1802":8385},"fastify/fastify TypeScript Types — LogControllerクラスの型定義とライフサイクルフック","item:fa5f0cf4-c833-4975-9856-340f159d4500",{"_1892":8377,"_1893":8417,"_1802":8377},"fastify/fastify GitHub Releases — Fastify v5.10.0リリースとLogController層の導入",{"_2571":8419},{"_1892":8420,"_1893":8421,"_1802":8234},"3. avvio-based Plugin Architecture and the Decorator Pattern","3. avvioベースのプラグインアーキテクチャとデコレーターパターン",{"_2571":8423},{"_1892":8424,"_1893":8425,"_1802":8426},"As shown in the code above, we use the reply.elapsedTime property recommended in v5 instead of the traditional reply.getResponseTime() to precisely record processing time. Thanks to this object-oriented transition in the log controller layer, you can build a logging pipeline that is both highly readable and easy to maintain.","上記コードのように、従来のreply.getResponseTime()の代わりにv5で推奨されるreply.elapsedTimeプロパティを活用して、処理時間を精密に記録します。このようにオブジェクト指向パターンへ移行したログコントローラー層のおかげで、可読性が高くメンテナンスの容易なロギングパイプラインを構築できます。","위 코드처럼 기존의 reply.getResponseTime() 대신 v5에서 권장하는 reply.elapsedTime 속성을 활용해 처리 시간을 정밀하게 기록합니다. 이처럼 객체지향적 패턴으로 전환된 로그 컨트롤러 계층 덕분에 가독성이 뛰어나고 유지보수하기 쉬운 로깅 파이프라인을 구축할 수 있습니다.",{"_2571":8428},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":8430},{"_1892":8431,"_1893":8432,"_1802":8433},"Second, reflect changes to performance measurement and route-checking APIs. The reply.getResponseTime() method, commonly used to query response latency, has been removed; you must now read the value directly via the reply.elapsedTime property. Additionally, the fastify.hasRoute() method, which checked for the existence of specific paths, now strictly matches exact string paths and no longer supports ambiguous forward-matching searches.","第二に、性能測定およびルート確認APIの変更点を反映する必要があります。レスポンスの遅延時間を取得するために一般的に使用されていたreply.getResponseTime()メソッドが削除されたため、現在はreply.elapsedTimeプロパティから値を直接読み取る必要があります。また、特定のルートが存在するかを確認するfastify.hasRoute()メソッドは、前方一致のような曖昧な探索をサポートせず、完全に一致する文字列パスのみをマッチングするように挙動が厳格化されました。","둘째, 성능 측정과 라우트 확인 API의 변경 사항을 반영해야 합니다. 기존에 응답 지연 시간을 조회할 때 흔히 사용하던 reply.getResponseTime() 메서드가 제거되었으므로, 이제는 reply.elapsedTime 속성을 통해 값을 직접 읽어와야 합니다. 또한 특정 경로의 존재 여부를 검사하던 fastify.hasRoute() 메서드는 전방 일치 방식의 모호한 탐색을 지원하지 않으며, 정확히 일치하는 문자열 경로만 매칭하도록 동작이 엄격해졌습니다.",{"_2571":8435},{"_1892":8436,"_1893":8437,"_1802":8289},"Conclusion: Production Migration Checklist","結論：プロダクションへの移行チェックリスト",{"_2571":8439},{"_1892":8440,"_1893":8441,"_1802":8297},"Here is a key checklist to keep in mind when building new or upgrading existing production applications based on Fastify v5.10.x.","Fastify v5.10.xをベースにプロダクションアプリケーションを新規構築、あるいはアップグレードする際に必ず確認すべき重要チェックリストです。",{"_2571":8443},{"_1892":8444,"_1893":8445,"_1802":8242},"Fastify utilizes an avvio-based directed acyclic graph (DAG) plugin loader system that provides strict encapsulation by default, thoroughly preventing global state pollution. This structure ensures that middleware or hooks defined in one location cannot inadvertently leak into other routes.","Fastifyは、avvioベースの有向非巡回グラフ（DAG）プラグインローダーシステムを使用し、グローバル状態の汚染を徹底的に防ぐ厳格なカプセル化を標準で提供します。この構造のおかげで、ある場所で定義したミドルウェアやフックが意図せず他のルートに波及する副作用を根本から遮断できます。",{"_2571":8447},{"_1892":8448,"_1893":8449,"_1802":8098},"1. Introducing LogController — Declarative Request Logging","1. LogControllerの導入 — 宣言的に制御するリクエストログ",{"_2571":8451},{"_1892":8452,"_1893":8453,"_1802":8454},"However, common resources that must be shared across the entire application—such as database clients or global caches—need to break this encapsulation and be exported to the parent context. Wrapping a plugin with the official helper package fastify-plugin breaks this encapsulation, allowing resources registered as decorators to be accessed globally. Conversely, for standard API route configurations, maintaining encapsulation remains the best practice.","しかし、データベースクライアントやグローバルキャッシュのようにアプリケーション全体で共有すべき共通リソースは、このカプセル化を解除して上位コンテキストへエクスポートする必要があります。この時、公式のヘルパーパッケージであるfastify-pluginでプラグインをラップしてエクスポートすれば、カプセル化が解除され、デコレーターとして登録したリソースにグローバルからアクセスできるようになります。一方、一般的なAPIルート構成については、カプセル化をそのまま維持するのがベストプラクティスです。","하지만 데이터베이스 클라이언트나 전역 캐시처럼 애플리케이션 전체에서 공유해야 하는 공통 리소스는 이 캡슐화를 깨고 상위 컨텍스트로 내보내야 합니다. 이때 공식 도우미 패키지인 fastify-plugin으로 플러그인을 감싸서 내보내면 캡슐화가 해제되어 데코레이터로 등록한 리소스를 전역에서 접근할 수 있게 됩니다. 반면, 일반적인 API 라우트 구성은 캡슐화를 그대로 유지하는 것이 모범 사례입니다.",{"_2571":8456},{"_1892":8457,"_1893":8458,"_1802":8459},"Applying this pattern ensures that request.body and response data structures are perfectly synchronized with TypeScript's static type system as soon as the schema is defined. Since it uses the high-performance, proven Ajv compiler without adding runtime overhead, this is a standard, essential pattern for enterprise environments requiring both type safety and high performance.","このパターンを適用すれば、スキーマを定義した瞬間にrequest.bodyおよびレスポンスデータ構造がTypeScriptの静的型システムと完全に同期されます。追加のランタイムオーバーヘッドはなく、パフォーマンスが検証済みのAjvコンパイラをそのまま使用するため、型安全性と高性能を同時に求められるエンタープライズ環境において不可欠な標準パターンです。","이 패턴을 적용하면 스키마를 정의하는 즉시 request.body 및 응답 데이터 구조가 TypeScript의 정적 타입 시스템과 완벽히 동기화됩니다. 추가적인 런타임 오버헤드가 없으며 성능이 검증된 Ajv 컴파일러를 그대로 사용하므로, 타입 안전성과 고성능을 동시에 확보해야 하는 엔터프라이즈 환경에서 필수적인 표준 패턴입니다.",{"_2571":8461},{"_1892":8462,"_1893":8463,"_1802":8464},"Below is a practical example of inheriting from LogController to ignore logs for the /health path and log elapsed time when the response finishes.","以下は、LogControllerを継承して/healthパスのログを無視し、レスポンス終了時に経過時間を記録する実践例です。","다음은 LogController를 상속받아 /health 경로의 로그를 무시하고, 응답이 끝난 시점에 경과 시간을 기록하는 실전 예시입니다.",{"_2571":8466},{"_1892":8467,"_1893":8468,"_1802":8469},"The key is to call the withTypeProvider method via method chaining directly on the constructor function when creating the Fastify instance. If called independently after the instance is already created, the updated type provider information will not propagate correctly, so caution is advised.","重要な点は、Fastifyインスタンスを作成する際、withTypeProviderメソッドをコンストラクタ関数に対して直接メソッドチェーンで呼び出す必要があるという点です。既に作成されたインスタンスに対して単独で呼び出すと、変更された型プロバイダー情報が正しく伝播されないため注意が必要です。","핵심은 Fastify 인스턴스를 생성할 때 withTypeProvider 메서드를 생성자 함수에 직접 메서드 체이닝으로 호출해야 한다는 점입니다. 이미 생성된 인스턴스 뒤에 단독으로 호출하면 변경된 타입 프로바이더 정보가 올바르게 전파되지 않으므로 주의가 필요합니다.",{"_2571":8471},{"_1892":8472,"_1893":8473,"_1802":8090},"Fastify, the standard for building high-performance backends in the Node.js ecosystem, has become even more robust and flexible with the v5.10.x update. This major version removes legacy structures and mandates full compliance with JSON Schema specifications, while significantly enhancing logging performance and extensibility through a new Log Controller layer. Here, we outline the key production design patterns that developers must implement to maximize runtime performance and ensure solid type safety in complex microservice environments.","Node.jsエコシステムにおいて高性能バックエンド構築の標準となったFastifyが、v5.10.xのアップデートでさらに堅牢かつ柔軟になりました。今回のメジャーバージョンでは、古いレガシーな構造を排除し、完全なJSONスキーマ仕様への準拠を義務付けるとともに、新しいログコントローラー層を通じてロギングの性能と拡張性を大幅に強化しています。複雑なマイクロサービス環境下でランタイム性能を最大化し、堅牢な型安全性を確保するために、開発者が必ず適用すべきコアとなるプロダクション設計パターンをまとめます。",{"_2571":8475},{"_1892":8476,"_1893":8477,"_1802":8478},"Third, transition the structure of your schema validation and logging pipelines. As partial support for shorthand schemas has been completely discontinued, all route validation must be defined in compliance with the full standard JSON Schema specification. For logging, since the top-level option disableRequestLogging is now deprecated, we recommend migrating to a lifecycle control approach by inheriting from the LogController class.","第三に、スキーマ検証とロギングパイプラインの構造的な転換です。過去に部分的に許容されていた簡易短縮スキーマはサポートが完全に終了したため、すべてのルート検証は完全な標準JSONスキーマ仕様に従って定義しなければなりません。ロギングについては、従来のトップレベルオプションであるdisableRequestLoggingが非推奨となったため、長期的にはLogControllerクラスを継承してライフサイクルを制御する方法へ移行することを推奨します。","셋째, 스키마 검증과 로깅 파이프라인의 구조적 전환입니다. 과거에 부분적으로 허용되던 약식 단축 스키마는 지원이 완전히 중단되었으므로 모든 라우트 검증은 완전한 표준 JSON 스키마 명세를 준수해 정의해야 합니다. 로깅의 경우, 기존의 최상위 옵션인 disableRequestLogging이 비권장 대상으로 지정되었기 때문에 장기적으로는 LogController 클래스를 상속받아 수명 주기를 제어하는 방식으로 마이그레이션할 것을 권장합니다.",{"_2571":8480},{"_1892":8481,"_1893":8482,"_1802":8483},"The most significant architectural change in Fastify v5.10.0 is the introduction of the new Log Controller layer. Previous top-level options such as disableRequestLogging and requestIdLogLabel are now officially deprecated (FSTDEP023, FSTDEP024) and are scheduled for complete removal in version 6. Instead, developers can now inherit from the official LogController class to manage the logging lifecycle in a declarative, object-oriented manner.","Fastify v5.10.0における最大のアーキテクチャ上の変更点は、新しいログコントローラー層の導入です。従来のトップレベルオプションであったdisableRequestLoggingとrequestIdLogLabelは公式に非推奨となり（FSTDEP023、FSTDEP024）、将来のv6バージョンで完全に削除される予定です。代わりに、開発者は公式のLogControllerクラスを継承することで、宣言的かつオブジェクト指向的な方法でロギングのライフサイクルを制御できるようになりました。","Fastify v5.10.0의 가장 큰 아키텍처 변화는 새로운 로그 컨트롤러 계층의 도입입니다. 기존 최상위 옵션이던 disableRequestLogging과 requestIdLogLabel은 공식적으로 더 이상 권장되지 않으며(FSTDEP023, FSTDEP024), 향후 v6 버전에서 완전히 제거될 예정입니다. 대신 이제 개발자는 공식 LogController 클래스를 상속받아 선언적이고 객체지향적인 방식으로 로깅 수명 주기를 제어할 수 있습니다.",{"_2571":8485},{"_1892":8006,"_1893":8007,"_1802":8008},{"_2571":8487},{"_1892":8488,"_1893":8489,"_1802":8490},"Fastify v5 has completely dropped support for previous, incomplete shorthand schemas; all route validation must now adhere to the standard JSON Schema specification. TypeBox is the most effective tool to meet these strict requirements without sacrificing productivity. TypeScript developers can combine it with @fastify/type-provider-typebox to achieve both runtime validation and compile-time type inference from a single definition.","Fastify v5では、従来の不完全な簡易短縮スキーマのサポートが完全に終了し、すべてのルート検証において標準JSONスキーマ仕様の遵守が必須となりました。これらの厳格な検証要件を生産性を落とさずに解決する最も効果的なツールがTypeBoxです。TypeScript開発者は@fastify/type-provider-typeboxを組み合わせることで、一度の定義でランタイム検証とコンパイル時の型推論を同時に達成できます。","Fastify v5에서는 기존의 불완전한 약식 단축 스키마 지원이 완전히 중단되었으며, 모든 라우트 검증에 반드시 표준 JSON 스키마 명세를 준수해야 합니다. 이러한 엄격한 검증 요건을 생산성 저하 없이 해결하는 가장 효과적인 도구가 바로 TypeBox입니다. TypeScript 개발자는 @fastify/type-provider-typebox를 결합하여 단 한 번의 정의로 런타임 검증과 컴파일 타임 타입 추론을 동시에 달성할 수 있습니다.",{"_2571":8492},{"_1892":8493,"_1893":8494,"_1802":8178},"2. Schema-based Validation and Perfect Type Inference with TypeBox","2. TypeBoxによるスキーマベースの検証と完全な型推論",{"_2571":8496},{"_1892":8497,"_1893":8498,"_1802":8263},"The following is a best-practice implementation for registering a database client as a global decorator and using it safely in a TypeScript environment.","以下は、TypeScript環境でデータベースクライアントをグローバルデコレーターとして登録し、安全に使用するための模範的な実装方法です。",{"_2571":8500},{"_1892":8501,"_1893":8502,"_1802":8503},"Using this structure, you can easily implement logic to skip logs for health-check paths like /health or consistently log specific metrics when a request completes. Designed according to the architecture defined in Fastify's official GitHub PR #6580, it enables high-performance logging filtering at the engine level without the need for ad-hoc hooks that introduce runtime overhead.","この構造を利用すれば、/healthのようなヘルスチェック経路のログを省略したり、リクエスト完了時に特定の指標を一貫して記録するロジックを容易に実装できます。Fastify公式GitHubのPR #6580で定義されたアーキテクチャに基づいて設計されており、ランタイムオーバーヘッドを引き起こす一時的なフック呼び出しなしに、エンジンレベルでの高性能なロギングフィルタリングが可能です。","이 구조를 사용하면 /health 같은 헬스체크 경로의 로그를 생략하거나, 요청이 완료되는 시점에 특정 지표를 일관되게 기록하는 로직을 손쉽게 구현할 수 있습니다. Fastify 공식 깃허브의 PR #6580에 정의된 아키텍처에 따라 설계되어, 런타임 오버헤드를 유발하는 임시방편적인 훅 호출 없이 엔진 수준에서 고성능 로깅 필터링이 가능합니다.","![Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴](file:cms734y6r01sx10nvg36we3ae)\n\n# Fastify 5.10 가이드 — LogController와 TypeBox 실전 패턴\n\nNode.js 생태계에서 고성능 백엔드 구축의 표준으로 자리 잡은 Fastify가 v5.10.x 업데이트를 통해 한층 더 견고하고 유연해졌습니다. 이번 메이저 버전은 오래된 레거시 구조를 걷어내고 완벽한 JSON 스키마 사양 준수를 의무화하는 한편, 새로운 로그 컨트롤러 계층을 통해 로깅 성능과 확장성을 대폭 강화했습니다. 복잡한 마이크로서비스 환경에서 런타임 성능을 극대화하고 견고한 타입 안전성을 확보하기 위해, 개발자가 반드시 적용해야 할 핵심 프로덕션 설계 패턴을 정리합니다.\n\n## 1. LogController 도입 — 선언적으로 제어하는 요청 로그\n\nFastify v5.10.0의 가장 큰 아키텍처 변화는 새로운 로그 컨트롤러 계층의 도입입니다. 기존 최상위 옵션이던 `disableRequestLogging`과 `requestIdLogLabel`은 공식적으로 더 이상 권장되지 않으며(FSTDEP023, FSTDEP024), 향후 v6 버전에서 완전히 제거될 예정입니다. 대신 이제 개발자는 공식 `LogController` 클래스를 상속받아 선언적이고 객체지향적인 방식으로 로깅 수명 주기를 제어할 수 있습니다.\n\n이 구조를 사용하면 `/health` 같은 헬스체크 경로의 로그를 생략하거나, 요청이 완료되는 시점에 특정 지표를 일관되게 기록하는 로직을 손쉽게 구현할 수 있습니다. Fastify 공식 깃허브의 PR #6580에 정의된 아키텍처에 따라 설계되어, 런타임 오버헤드를 유발하는 임시방편적인 훅 호출 없이 엔진 수준에서 고성능 로깅 필터링이 가능합니다.\n\n다음은 `LogController`를 상속받아 `/health` 경로의 로그를 무시하고, 응답이 끝난 시점에 경과 시간을 기록하는 실전 예시입니다.\n\n```typescript\nimport Fastify, { LogController, FastifyRequest, FastifyReply } from 'fastify';\n\nclass CustomLogController extends LogController {\n // /health 헬스체크 경로의 로그 기록을 제외합니다.\n override isLogDisabled(request: FastifyRequest): boolean {\n return request.url === '/health';\n }\n\n // 요청 완료 시점에 실행되어 최종 처리 지표를 기록합니다.\n override requestCompleted(\n error: Error | null,\n request: FastifyRequest,\n reply: FastifyReply,\n metadata?: Record\n ): void {\n const duration = reply.elapsedTime; // Fastify v5에서 표준화된 경과 시간 속성\n const level = error ? 'error' : 'info';\n\n request.log[level]({\n duration,\n statusCode: reply.statusCode,\n err: error\n }, 'request completed');\n }\n}\n\nconst server = Fastify({\n logController: new CustomLogController()\n});\n```\n\n위 코드처럼 기존의 `reply.getResponseTime()` 대신 v5에서 권장하는 `reply.elapsedTime` 속성을 활용해 처리 시간을 정밀하게 기록합니다. 이처럼 객체지향적 패턴으로 전환된 로그 컨트롤러 계층 덕분에 가독성이 뛰어나고 유지보수하기 쉬운 로깅 파이프라인을 구축할 수 있습니다.\n\n## 2. TypeBox를 통한 스키마 기반 검증과 완벽한 타입 추론\n\nFastify v5에서는 기존의 불완전한 약식 단축 스키마 지원이 완전히 중단되었으며, 모든 라우트 검증에 반드시 표준 JSON 스키마 명세를 준수해야 합니다. 이러한 엄격한 검증 요건을 생산성 저하 없이 해결하는 가장 효과적인 도구가 바로 TypeBox입니다. TypeScript 개발자는 `@fastify/type-provider-typebox`를 결합하여 단 한 번의 정의로 런타임 검증과 컴파일 타임 타입 추론을 동시에 달성할 수 있습니다.\n\n핵심은 Fastify 인스턴스를 생성할 때 `withTypeProvider` 메서드를 생성자 함수에 **직접 메서드 체이닝으로 호출**해야 한다는 점입니다. 이미 생성된 인스턴스 뒤에 단독으로 호출하면 변경된 타입 프로바이더 정보가 올바르게 전파되지 않으므로 주의가 필요합니다.\n\n```typescript\nimport Fastify from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport { Type } from '@sinclair/typebox'\n\n// 생성자 호출부에 직접 체이닝하여 인스턴스를 생성합니다.\nconst fastify = Fastify().withTypeProvider()\n\nfastify.post('/users', {\n schema: {\n body: Type.Object({\n name: Type.String(),\n email: Type.String({ format: 'email' })\n }),\n response: {\n 201: Type.Object({\n id: Type.String(),\n name: Type.String()\n })\n }\n }\n}, async (request, reply) => {\n // request.body의 name과 email 타입이 자동으로 완벽하게 추론됩니다.\n const { name, email } = request.body\n \n return reply.status(201).send({\n id: 'user-123',\n name\n })\n})\n```\n\n이 패턴을 적용하면 스키마를 정의하는 즉시 `request.body` 및 응답 데이터 구조가 TypeScript의 정적 타입 시스템과 완벽히 동기화됩니다. 추가적인 런타임 오버헤드가 없으며 성능이 검증된 Ajv 컴파일러를 그대로 사용하므로, 타입 안전성과 고성능을 동시에 확보해야 하는 엔터프라이즈 환경에서 필수적인 표준 패턴입니다.\n\n## 3. avvio 기반 플러그인 아키텍처와 데코레이터 패턴\n\nFastify는 avvio 기반의 방향성 비순환 그래프(DAG) 플러그인 로더 시스템을 사용해 전역 상태 오염을 철저히 방지하는 엄격한 캡슐화를 기본으로 제공합니다. 이 구조 덕분에 한 곳에서 정의한 미들웨어나 훅이 의도치 않게 다른 라우트로 번지는 부작용을 원천 차단할 수 있습니다.\n\n하지만 데이터베이스 클라이언트나 전역 캐시처럼 애플리케이션 전체에서 공유해야 하는 공통 리소스는 이 캡슐화를 깨고 상위 컨텍스트로 내보내야 합니다. 이때 공식 도우미 패키지인 `fastify-plugin`으로 플러그인을 감싸서 내보내면 캡슐화가 해제되어 데코레이터로 등록한 리소스를 전역에서 접근할 수 있게 됩니다. 반면, 일반적인 API 라우트 구성은 캡슐화를 그대로 유지하는 것이 모범 사례입니다.\n\n다음은 TypeScript 환경에서 데이터베이스 클라이언트를 전역 데코레이터로 등록하고 안전하게 사용하기 위한 모범적인 구현 방식입니다.\n\n```typescript\nimport fp from 'fastify-plugin';\nimport { FastifyPluginAsync } from 'fastify';\n\n// 가상의 데이터베이스 클라이언트\nconst dbClient = {\n query: async (sql: string) => `Executed: ${sql}`,\n};\n\n// TypeScript 모듈 보강을 통한 인스턴스 타입 확장\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: typeof dbClient;\n }\n}\n\nconst dbPlugin: FastifyPluginAsync = async (fastify) => {\n // fastify-plugin 덕분에 부모 컨텍스트로 노출됩니다.\n fastify.decorate('db', dbClient);\n};\n\nexport default fp(dbPlugin);\n```\n\n이와 같이 `fastify-plugin`으로 플러그인을 래핑하고 모듈 보강을 추가하면 컴파일러 수준에서 타입 안정성을 완벽히 보장받으면서 유연하게 공유 자원을 관리할 수 있습니다.\n\n## 결론: 프로덕션 마이그레이션 체크리스트\n\nFastify v5.10.x 기반으로 프로덕션 애플리케이션을 새로 구축하거나 업그레이드할 때 반드시 점검해야 할 핵심 체크리스트입니다.\n\n첫째, 인프라의 런타임 환경을 확인해야 합니다. Fastify v5는 레거시 코드와 오래된 API 부채를 정리하며 최소 구동 요구사항을 Node.js 20 이상으로 격상했습니다. 이전 버전의 Node.js를 사용 중이라면 런타임 업데이트가 선행되어야 합니다.\n\n둘째, 성능 측정과 라우트 확인 API의 변경 사항을 반영해야 합니다. 기존에 응답 지연 시간을 조회할 때 흔히 사용하던 `reply.getResponseTime()` 메서드가 제거되었으므로, 이제는 `reply.elapsedTime` 속성을 통해 값을 직접 읽어와야 합니다. 또한 특정 경로의 존재 여부를 검사하던 `fastify.hasRoute()` 메서드는 전방 일치 방식의 모호한 탐색을 지원하지 않으며, 정확히 일치하는 문자열 경로만 매칭하도록 동작이 엄격해졌습니다.\n\n셋째, 스키마 검증과 로깅 파이프라인의 구조적 전환입니다. 과거에 부분적으로 허용되던 약식 단축 스키마는 지원이 완전히 중단되었으므로 모든 라우트 검증은 완전한 표준 JSON 스키마 명세를 준수해 정의해야 합니다. 로깅의 경우, 기존의 최상위 옵션인 `disableRequestLogging`이 비권장 대상으로 지정되었기 때문에 장기적으로는 `LogController` 클래스를 상속받아 수명 주기를 제어하는 방식으로 마이그레이션할 것을 권장합니다.\n\n이러한 정돈 작업을 거쳐 구축된 Fastify는 불필요한 요청 오버헤드를 줄여 한층 강력해진 성능과 타입 안전성을 제공합니다. 고성능 마이크로서비스 인프라를 설계하거나 대규모 TypeScript 백엔드를 안정적으로 운영하고자 하는 조직에게 Fastify v5.10.x는 든든한 기술적 기반이 될 것입니다.\n\n---\n\n**참고 링크**\n\n- [fastify/fastify GitHub Releases — Fastify v5.10.0 Release & Introduction of the LogController Layer](https://github.com/fastify/fastify/releases/tag/v5.10.0)\n- [fastify/fastify TypeScript Types — LogController Class Typings & Lifecycle Hooks](https://github.com/fastify/fastify/blob/main/types/logger.d.ts)\n- [fastify-log-controller GitHub — Dynamic Runtime Log Adjustments via fastify-log-controller](https://github.com/Eomm/fastify-log-controller)","4ad96b414a9d3dc4df41e58c474b7b1ff582f0f4e4ff1c2b336649a0c283f756","2026-07-30T04:39:59.130Z","2026-07-30T16:31:57.178Z",[],[],{"_950":8511,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":8512,"_1889":8520,"_2455":-5,"_2456":-5,"_2457":-5,"_9":8524,"_2450":8532,"_2458":8533,"_2460":-5,"_723":8534,"_1886":8535,"_332":8538,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2075,"_2477":8539,"_2003":8540,"_2480":8541,"_2482":-5,"_2483":8542,"_2485":-5,"_2486":-5,"_2487":8543,"_1144":8553,"_2527":8566,"_2555":-5,"_2556":8588,"_2798":8942,"_266":8943},"cms5opri1003w10nv10mndsfs",{"_1801":1802,"_214":8513,"_2429":8514,"_2434":8517,"_2438":2439},3145,{"_1892":8515,"_1893":1997,"_1802":8516,"_2433":1997},1296,1849,{"_1892":8518,"_1893":1997,"_1802":8519,"_2433":1997},0.4120826709062003,0.5879173290937997,{"_9":8521,"_2445":8525,"_2450":8529},{"_1892":8522,"_1893":8523,"_1802":8524},"MCP v2.0 SDK Released — Introducing Stateless HTTP and OAuth 2.1 Security Standards","MCP v2.0 SDKリリース — ステートレスHTTPとOAuth 2.1セキュリティ標準の導入","MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입",{"_1892":8526,"_1893":8527,"_1802":8528},"MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입\n\nMCP v2.0 SDK Released — Introducing Stateless HTTP and OAuth 2.1 Security Standards\n\nThe Model Context Protocol (MCP), a technical standard for connecting AI agents with external tools, has undergone a complete overhaul to a stateless HTTP architecture. Previous versions of MCP relied on local-focused standard I/O or Server-Sent Events, which required state maintenance and created difficulties for scaling in distributed server environments. The recently published 2026-07-28 specification candidate and TypeScript SDK v2.0 overcome these limitations, introducing a stateless network design and robust enterprise-grade security specifications to seamlessly support large-scale production deployments.\n\nParadigm Shift to Stateless HTTP Design and Package Decoupling\n\nThe core change in the Model Context Protocol specification candidate and TypeScript SDK v2.0 is the full transition to stateless HTTP transport. In previous specifications, servers had to maintain connections with clients, issuing and managing session IDs. This created infrastructure overhead for large-scale services, requiring sticky sessions on load balancers or separate session-sharing storage to enable horizontal server scaling.\n\nConversely, in the newly revised specification, the initial handshake is eliminated, and protocol versions and capability definitions are sent with every request independently. Because every request is designed as a self-contained structure, developers can distribute server instances freely using standard round-robin load balancing without the need for complex session maintenance.\n\nTo support the seamless implementation of this stateless architecture, the existing monolithic SDK package has been cleanly split into @modelcontextprotocol/server for server development and @modelcontextprotocol/client for client development. Additionally, various lightweight adapter packages are provided to integrate with developers' preferred web frameworks.\n\nFor example, in Hono or Cloudflare Workers environments that support web-standard interfaces, the SDK's standard handlers can be served directly without any conversion. For the Express environment, widely used in the existing Node.js ecosystem, it can be easily integrated into routers in just a few lines of code using a dedicated adapter.\n\n// @modelcontextprotocol/server v2.0 및 Node.js 어댑터 기준\nimport express from 'express';\nimport { createMcpHandler, McpServer } from '@modelcontextprotocol/server';\nimport { toNodeHandler } from '@modelcontextprotocol/node';\n\nconst mcpHandler = createMcpHandler(() => {\n const server = new McpServer({ name: 'enterprise-tools', version: '2.0.0' });\n // 여기에 도구 및 리소스 등록 로직을 추가합니다.\n return server;\n});\n\nconst app = express();\napp.all('/mcp', toNodeHandler(mcpHandler));\napp.listen(3000);\n\nThanks to the new stateless design and modular package structure, you can now build and operate MCP tool servers with great flexibility, not just in lightweight virtual servers or serverless environments, but also within complex microservice architectures.\n\nSecurity Interoperability Architecture Based on OAuth 2.1 and RFC 9728\n\nFor agents to dynamically discover and securely execute tools on external servers, a robust authentication system is required. To support large-scale distributed environments, MCP v2 has adopted the latest security standards, OAuth 2.1 and RFC 9728 (OAuth Protected Resource Metadata), as its core authentication architecture.\n\nWhen an unauthenticated agent client calls a tool execution API, the MCP server rejects the request while simultaneously sending a challenge response that allows the client to identify the authentication method itself. In this process, the server returns a 401 Unauthorized status code, including the path to the protected resource metadata in the WWW-Authenticate header.\n\nHTTP/1.1 401 Unauthorized\nWWW-Authenticate: Bearer resource_metadata=\"https://mcp.example.com/.well-known/oauth-protected-resource\"\n\nThe client accesses the resource_metadata endpoint specified in the header to retrieve JSON metadata describing the authorization server addresses trusted by the MCP server and the supported scopes. This allows the agent to programmatically initiate the OAuth 2.1 authorization code flow without hardcoded credentials. Consequently, this structure provides a high level of interoperability, enabling multiple MCP servers and clients to dynamically extend trust boundaries without complex pre-configuration.\n\nStreamlined Interface Validation with Standard Schema v1.0 Integration\n\nThe architecture for real-time validation of tool inputs executed by agents has also been significantly overhauled. MCP TypeScript SDK v2 now includes Standard Schema v1.0, the common validation specification for the TypeScript ecosystem. As a result, regardless of whether you use Zod, Valibot, ArkType, or any other validation library, you can use them directly as tool input schemas without needing separate adapters or transformation layers.\n\nPreviously, the SDK was tightly coupled with a specific version of Zod, leading to frequent dependency issues such as conflicts with the Zod version in the developer's project or missing schemas during JSON Schema transformation. The v2 SDK immediately binds any object that meets the Standard Schema specification as an inputSchema, perfectly resolving these recurring version conflicts.\n\nThe following is an example of registering a tool with a Zod schema using the @modelcontextprotocol/server package.\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-service\",\n version: \"1.0.0\"\n});\n\nserver.registerTool(\n \"get_weather\",\n {\n description: \"특정 도시의 현재 날씨를 조회합니다.\",\n inputSchema: z.object({\n city: z.string().describe(\"날씨를 조회할 도시 이름 (예: 서울, 부산)\")\n })\n },\n async ({ city }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 날씨는 맑음입니다.` }]\n };\n }\n);\n\nUsing this approach, the request body sent by the client is automatically validated against the defined schema at call time. Developers can immediately use statically typed input arguments within the handler without complex manual parsing, significantly improving runtime stability and the developer experience.\n\nSecure Tool Infrastructure Realized in Distributed Environments\n\nBy combining stateless HTTP design with the OAuth 2.1 standard security framework, MCP v2.0 elevates AI agent integration from simple prototypes to true enterprise-grade microservice architectures.\n\nDevelopers can now build distributed MCP tool networks that are independently scalable and security-verified, rather than relying on heavy integration logic coupled to clients. As major agent frameworks like Vercel AI SDK and LangChain are rapidly adopting these standards, building tool ecosystems based on stateless APIs will become an essential choice for production deployment.\n\nReference Links\n\nmodelcontextprotocol/typescript-sdk Issues — McpServer registerTool API and Standard Schema Support\nmodelcontextprotocol/typescript-sdk GitHub — Model Context Protocol TypeScript SDK v2.0.0 Released\nModel Context Protocol SEPs — SEP-985: Align OAuth 2.0 Protected Resource Metadata with RFC 9728","MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입\n\nMCP v2.0 SDKリリース — ステートレスHTTPとOAuth 2.1セキュリティ標準の導入\n\nAIエージェントと外部ツールを接続する技術標準であるモデルコンテキストプロトコル（MCP）が、ステートレスHTTPアーキテクチャへと全面的に刷新されます。従来のMCPは、ローカル中心の標準入出力やセッション維持が必須であるサーバー送信イベント（SSE）方式に依存しており、分散サーバー環境での拡張が困難という課題がありました。今回公開された2026-07-28の仕様ドラフトとTypeScript SDK v2.0は、この制約を克服し、ステートレスなネットワーク設計と堅牢なエンタープライズ向けセキュリティ仕様を導入することで、大規模な本番環境の構築を強力にサポートします。\n\nステートレスHTTP設計へのパラダイムシフトとパッケージの分割\n\nモデルコンテキストプロトコルの仕様ドラフトとTypeScript SDK v2.0の最大の変化は、ステートレスHTTPトランスポートへの完全移行です。従来はサーバーがクライアントとの接続を維持し、セッションIDの発行と管理を行う必要がありました。そのため、大規模なサービスでサーバーを水平拡張しようとすると、ロードバランサーでのスティッキーセッション指定や、専用のセッション共有ストレージの構築が必要となり、インフラ面で大きな負担となっていました。\n\n一方、新仕様では初期ハンドシェイクのプロセスが省略され、プロトコルのバージョンや機能定義がリクエストごとに独立して送信されます。すべてのリクエストが単体で完結する自己充足的な構造になったため、開発者は複雑なセッション維持を気にすることなく、標準的なラウンドロビン方式のロードバランシングによってサーバーインスタンスを自由に分散配置できるようになりました。\n\nこのステートレスなアーキテクチャを円滑に実現するため、従来の単一SDKパッケージは、サーバー開発用の「@modelcontextprotocol/server」とクライアント開発用の「@modelcontextprotocol/client」に明確に分割されました。また、好みのWebフレームワークに合わせて統合できるよう、多様な軽量アダプターパッケージも併せて提供されます。\n\n例えば、Web標準インターフェースをサポートするHonoやCloudflare Workers環境では、SDKが提供する標準ハンドラーを変換なしで直接実行できます。一方、従来のNode.jsエコシステムで広く使われているExpress環境であれば、専用アダプターを通じてわずか数行のコードでルーターと簡単に連携可能です。\n\n// @modelcontextprotocol/server v2.0 및 Node.js 어댑터 기준\nimport express from 'express';\nimport { createMcpHandler, McpServer } from '@modelcontextprotocol/server';\nimport { toNodeHandler } from '@modelcontextprotocol/node';\n\nconst mcpHandler = createMcpHandler(() => {\n const server = new McpServer({ name: 'enterprise-tools', version: '2.0.0' });\n // 여기에 도구 및 리소스 등록 로직을 추가합니다.\n return server;\n});\n\nconst app = express();\napp.all('/mcp', toNodeHandler(mcpHandler));\napp.listen(3000);\n\n新しいステートレス設計とモジュール化されたパッケージ構成により、軽量な仮想サーバーやサーバーレスだけでなく、複雑なマイクロサービスアーキテクチャ内においても、MCPツールサーバーを非常に柔軟に構築・運用できるようになりました。\n\nOAuth 2.1およびRFC 9728に基づくセキュアな相互運用構造\n\nエージェントが外部サーバー上のツールを動的に探索し、安全に実行するためには強固な認証体系が不可欠です。MCP v2では、大規模な分散環境に対応するため、最新のセキュリティ標準であるOAuth 2.1と、OAuth保護リソースメタデータ仕様であるRFC 9728を認証アーキテクチャの核として採用しました。\n\n認証されていないエージェントクライアントがツール実行APIを呼び出すと、MCPサーバーはリクエストを拒否すると同時に、クライアント自身が認証方式を特定できるようにチャレンジレスポンスを送信します。この際、サーバーは「401 Unauthorized」ステータスコードと共に、WWW-Authenticateヘッダーに保護リソースメタデータのパスを含めて返却します。\n\nHTTP/1.1 401 Unauthorized\nWWW-Authenticate: Bearer resource_metadata=\"https://mcp.example.com/.well-known/oauth-protected-resource\"\n\nクライアントはヘッダーに記載された「resource_metadata」エンドポイントにアクセスし、該当のMCPサーバーが信頼する認可サーバーのアドレスやサポートされている権限範囲を記述したJSONメタデータを取得します。これにより、エージェントはハードコードされた認証情報なしでも、機械的に次ステップであるOAuth 2.1の認可コードフローを開始できます。結果として、この構造は多数のMCPサーバーとクライアントの間で、事前の複雑な設定なしに信頼境界を動的に拡張できる高度な相互運用性を実現します。\n\nStandard Schema v1.0の統合によるインターフェース検証の簡素化\n\nエージェントが実行するツールの入力値をリアルタイムで検証するアーキテクチャも大幅に刷新されました。MCP TypeScript SDK v2は、TypeScriptエコシステムの共通検証仕様である「Standard Schema v1.0」を内蔵しました。これにより、Zod、Valibot、ArkTypeなど、どの検証ライブラリを使用していても、アダプターや変換レイヤーなしでツールの入力スキーマとして直接活用可能です。\n\n過去には、SDK内部に特定のバージョンのZod依存関係が強く結合されていたため、開発者のプロジェクト側のZodバージョンと衝突したり、JSONスキーマ変換過程でスキーマが欠落したりする依存関係の問題が頻発していました。v2 SDKはStandard Schema規格を満たすオブジェクトであれば、どれでも即座にinputSchemaとしてバインディングできるため、こうした深刻なバージョン競合を完全に解決します。\n\n以下は、@modelcontextprotocol/serverパッケージを使用してZodスキーマでツールを登録する例です。\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-service\",\n version: \"1.0.0\"\n});\n\nserver.registerTool(\n \"get_weather\",\n {\n description: \"특정 도시의 현재 날씨를 조회합니다.\",\n inputSchema: z.object({\n city: z.string().describe(\"날씨를 조회할 도시 이름 (예: 서울, 부산)\")\n })\n },\n async ({ city }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 날씨는 맑음입니다.` }]\n };\n }\n);\n\nこの手法を活用すると、呼び出し時にクライアントが送信したリクエストボディが定義したスキーマに合わせて自動的に検証されます。開発者は複雑な手動パース処理なしに、ハンドラー内部で静的型付けされた入力引数を即座に利用できるため、ランタイムの安定性と開発者体験（DX）が劇的に向上します。\n\n分散環境で実現するセキュアなツールインフラ\n\nステートレスHTTP設計とOAuth 2.1標準のセキュリティ体系を組み合わせたMCP v2.0は、AIエージェントの連携を単なるプロトタイプレベルから、本格的なエンタープライズ向けマイクロサービスアーキテクチャへと昇華させます。\n\nこれからは開発者がクライアントと密結合した重い連携ロジックを実装する代わりに、独立してスケールアウト可能かつセキュリティが検証された、分散型MCPツールネットワークを構築できるようになります。Vercel AI SDKやLangChainといった主要なエージェントフレームワークがこれにいち早く対応しているように、ステートレスなAPIベースのツールエコシステム構築は、実戦的なプロダクション導入における不可欠な選択肢となるでしょう。\n\n参考リンク\n\nmodelcontextprotocol/typescript-sdk Issues — McpServer registerTool API and Standard Schema Support\nmodelcontextprotocol/typescript-sdk GitHub — Model Context Protocol TypeScript SDK v2.0.0 Released\nModel Context Protocol SEPs — SEP-985: Align OAuth 2.0 Protected Resource Metadata with RFC 9728","MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입\n\nMCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입\n\n인공지능 에이전트와 외부 도구를 연결하는 기술 표준인 모델 컨텍스트 프로토콜(MCP)이 무상태 HTTP 아키텍처로 전면 개편됩니다. 기존 MCP는 로컬 중심의 표준 입출력이나 세션 유지가 필수적인 서버 전송 이벤트 방식에 의존하여 분산 서버 환경에서 확장하기 까다로운 한계가 있었습니다. 최근 공개된 2026-07-28 명세 후보와 TypeScript SDK v2.0은 이 제약을 극복하고, 무상태 네트워크 설계와 강력한 엔터프라이즈 보안 사양을 도입해 대규모 프로덕션 환경 구축을 무리 없이 지원합니다.\n\n무상태 HTTP 설계로의 패러다임 변화와 패키지 분할\n\n모델 컨텍스트 프로토콜 명세 후보와 TypeScript SDK v2.0의 핵심 변화는 무상태 HTTP 전송으로의 전면적인 전환입니다. 기존 사양에서는 서버가 클라이언트와 연결을 유지하며 세션 ID를 발급하고 관리해야 했습니다. 이 때문에 대규모 서비스에서 서버를 수평 확장하려면 로드 밸런서에 스티키 세션을 지정하거나 별도의 세션 공유 저장소를 구축해야 하는 인프라 부담이 따랐습니다.\n\n반면 새롭게 개편된 명세에서는 초기 핸드셰이크 과정이 생략되고, 프로토콜 버전과 기능 정의가 매 요청마다 독립적으로 전송됩니다. 모든 요청이 완전히 스스로 동작할 수 있는 자급식 구조로 설계된 덕분에, 개발자는 복잡한 세션 유지 없이 일반적인 라운드 로빈 방식의 로드 밸런싱을 통해 서버 인스턴스를 자유롭게 분산 배치할 수 있습니다.\n\n이러한 무상태 아키텍처를 원활하게 구현할 수 있도록 기존의 단일 SDK 패키지는 서버 개발을 위한 @modelcontextprotocol/server와 클라이언트 개발을 위한 @modelcontextprotocol/client로 깔끔하게 분할되었습니다. 또한 개발자가 선호하는 웹 프레임워크에 맞춰 통합할 수 있도록 다양한 경량 어댑터 패키지가 함께 제공됩니다.\n\n예를 들어 웹 표준 인터페이스를 지원하는 Hono나 클라우드플레어 워커스 환경에서는 SDK가 제공하는 표준 핸들러를 별도의 변환 없이 직접 서빙할 수 있습니다. 반면 기존 Node.js 생태계에서 널리 쓰이는 Express 환경이라면 다음과 같이 전용 어댑터를 통해 몇 줄의 코드만으로 라우터에 쉽게 연동할 수 있습니다.\n\n// @modelcontextprotocol/server v2.0 및 Node.js 어댑터 기준\nimport express from 'express';\nimport { createMcpHandler, McpServer } from '@modelcontextprotocol/server';\nimport { toNodeHandler } from '@modelcontextprotocol/node';\n\nconst mcpHandler = createMcpHandler(() => {\n const server = new McpServer({ name: 'enterprise-tools', version: '2.0.0' });\n // 여기에 도구 및 리소스 등록 로직을 추가합니다.\n return server;\n});\n\nconst app = express();\napp.all('/mcp', toNodeHandler(mcpHandler));\napp.listen(3000);\n\n새로운 무상태 설계와 모듈화된 패키지 구성 덕분에 가벼운 가상 서버나 서버리스 서버뿐만 아니라 복잡한 마이크로서비스 아키텍처 내에서도 MCP 도구 서버를 매우 유연하게 구축하고 운영할 수 있게 되었습니다.\n\nOAuth 2.1과 RFC 9728 기반의 보안 상호연동 구조\n\n에이전트가 외부 서버의 도구를 동적으로 탐색하고 안전하게 실행하려면 견고한 인증 체계가 뒷받침되어야 합니다. MCP v2는 대규모 분산 환경에 대응하기 위해 최신 보안 표준인 OAuth 2.1과 OAuth 보호 자원 메타데이터 명세인 RFC 9728을 핵심 인증 아키텍처로 채택했습니다.\n\n비인증 상태의 에이전트 클라이언트가 도구 실행 API를 호출하면, MCP 서버는 요청을 거절하는 동시에 클라이언트가 스스로 인증 방식을 파악할 수 있도록 챌린지 응답을 전송합니다. 이때 서버는 401 Unauthorized 상태 코드와 함께 WWW-Authenticate 헤더에 보호 자원 메타데이터 경로를 담아 반환합니다.\n\nHTTP/1.1 401 Unauthorized\nWWW-Authenticate: Bearer resource_metadata=\"https://mcp.example.com/.well-known/oauth-protected-resource\"\n\n클라이언트는 헤더에 명시된 resource_metadata 엔드포인트에 접근해 해당 MCP 서버가 신뢰하는 인가 서버 주소와 지원하는 권한 범위를 서술한 JSON 메타데이터를 가져옵니다. 이를 통해 에이전트는 하드코딩된 인증 정보 없이도 기계적으로 다음 단계의 OAuth 2.1 인가 코드 흐름을 시작할 수 있습니다. 결과적으로 이 구조는 다수의 MCP 서버와 클라이언트가 복잡한 사전 연동 설정 없이도 신뢰 경계를 동적으로 확장할 수 있는 고도의 상호운용성을 제공합니다.\n\nStandard Schema v1.0 통합으로 간결해진 인터페이스 검증\n\n에이전트가 실행하는 도구의 입력값을 실시간으로 검증하는 아키텍처도 대폭 개편되었습니다. MCP TypeScript SDK v2는 타입스크립트 에코시스템의 공통 검증 명세인 Standard Schema v1.0을 내장했습니다. 이에 따라 Zod, Valibot, ArkType 등 어떤 검증 라이브러리를 사용하더라도 별도의 어댑터나 변환 레이어 없이 도구의 입력 스키마로 직접 활용할 수 있습니다.\n\n과거에는 SDK 내부에 특정 버전의 Zod 의존성이 강하게 결합되어 있어, 개발자 프로젝트의 Zod 버전과 충돌하거나 JSON 스키마 변환 과정에서 스키마가 누락되는 등의 의존성 문제가 잦았습니다. v2 SDK는 Standard Schema 규격을 충족하는 객체라면 무엇이든 inputSchema로 즉시 바인딩하므로 이러한 고질적인 버전 갈등을 완벽히 해결합니다.\n\n다음은 @modelcontextprotocol/server 패키지를 사용하여 Zod 스키마로 도구를 등록하는 예시입니다.\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-service\",\n version: \"1.0.0\"\n});\n\nserver.registerTool(\n \"get_weather\",\n {\n description: \"특정 도시의 현재 날씨를 조회합니다.\",\n inputSchema: z.object({\n city: z.string().describe(\"날씨를 조회할 도시 이름 (예: 서울, 부산)\")\n })\n },\n async ({ city }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 날씨는 맑음입니다.` }]\n };\n }\n);\n\n이 방식을 활용하면 호출 시점에 클라이언트가 보낸 요청 본문이 정의한 스키마에 맞춰 자동으로 검증됩니다. 개발자는 복잡한 수동 파싱 과정 없이 핸들러 내부에서 정적 타입이 보장된 입력 인자를 즉시 사용할 수 있어 런타임 안정성과 개발 경험이 대폭 향상됩니다.\n\n분산 환경에서 실현되는 보안 도구 인프라\n\n무상태 HTTP 설계와 OAuth 2.1 표준 보안 체계를 결합한 MCP v2.0은 AI 에이전트 연동을 단순한 프로토타입 수준에서 진정한 엔터프라이즈급 마이크로서비스 아키텍처로 끌어올립니다.\n\n이제 개발자들은 클라이언트에 결합한 무거운 연동 로직 대신, 독립적으로 스케일 아웃이 가능하고 보안이 검증된 분산형 MCP 도구 네트워크를 구축할 수 있습니다. Vercel AI SDK나 LangChain 같은 주요 에이전트 프레임워크가 이를 빠르게 흡수하고 있는 만큼, 무상태 API 기반의 도구 생태계 구축은 실전 프로덕션 도입을 위한 필수 선택지가 될 것입니다.\n\n참고 링크\n\nmodelcontextprotocol/typescript-sdk Issues — McpServer registerTool API and Standard Schema Support\nmodelcontextprotocol/typescript-sdk GitHub — Model Context Protocol TypeScript SDK v2.0.0 Released\nModel Context Protocol SEPs — SEP-985: Align OAuth 2.0 Protected Resource Metadata with RFC 9728",{"_1892":8530,"_1893":8531,"_1802":8532},"MCP v2.0 SDK Released — Introducing Stateless HTTP and OAuth 2.1 Security Standards The Model Context Protocol (MCP), a technical standard for connecting AI agents with external tools, has undergone a complete overhaul t…","MCP v2.0 SDKリリース — ステートレスHTTPとOAuth 2.1セキュリティ標準の導入 AIエージェントと外部ツールを接続する技術標準であるモデルコンテキストプロトコル（MCP）が、ステートレスHTTPアーキテクチャへと全面的に刷新されます。従来のMCPは、ローカル中心の標準入出力やセッション維持が必須であるサーバー送信イベント（SSE）方式に依存しており、分散サーバー環境での拡張が困難という課題がありました。今回公開され…","MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입 인공지능 에이전트와 외부 도구를 연결하는 기술 표준인 모델 컨텍스트 프로토콜(MCP)이 무상태 HTTP 아키텍처로 전면 개편됩니다. 기존 MCP는 로컬 중심의 표준 입출력이나 세션 유지가 필수적인 서버 전송 이벤트 방식에 의존하여 분산 서버 환경에서 확장하기 까다로운 한계가 있었습니다. 최근 공개된 2026-…","cms5r0uzf005q10nv80udq68t",[6733],[4943,3792,3125,8536,5910,3126,8537],"oauth","standard-schema",[],"2026-07-29T23:03:18.411Z","2026-07-29T06:09:19.225Z","2026-07-30T06:42:05.010Z","2026-07-29T23:04:20.419Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":8544},{"_1901":8545},{"_1903":8546,"_1908":1909,"_1910":8547,"_1921":8548,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":8549,"_1928":8550,"_1933":8551,"_1938":8552},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":8554,"_1883":1884,"_1200":1204,"_1899":8557},{"_633":8555,"_11":8556},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":8558},{"_1903":8559,"_1908":1909,"_1910":8560,"_1921":8561,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":8562,"_1928":8563,"_1933":8564,"_1938":8565},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":8567},{"_1948":-5,"_1908":1909,"_1910":8568,"_1960":-5,"_1943":8574,"_1962":8575},{"_1912":8569,"_1914":8570,"_1952":8571,"_1810":2534,"_944":1992,"_1917":8572,"_1957":2536,"_1919":8573},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/78dbc1da-1e23-4ede-899e-294966264116.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/78dbc1da-1e23-4ede-899e-294966264116.jpg",366518,"LFNnK=HXK*-p~CD%tRrX9]mlNHt8","#f8f8f8","2026-07-29T07:13:56.798Z",{"_1964":8576,"_1972":8580,"_1979":8584,"_1986":-5},{"_1912":8577,"_1914":8578,"_1952":8579,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/large.webp",27730,{"_1912":8581,"_1914":8582,"_1952":8583,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/small.webp",7872,{"_1912":8585,"_1914":8586,"_1952":8587,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms5r0uzf005q10nv80udq68t/medium.webp",15686,{"_950":8589,"_2559":8511,"_2560":8590,"_2716":8844,"_2788":8937,"_2790":8938,"_2792":8939,"_2794":1997,"_2003":8940,"_2480":8941,"_2797":-5},"cms5opri6003x10nvkliwftt4",{"_918":8591,"_1908":1909},[8592,8594,8597,8601,8604,8609,8612,8617,8620,8625,8628,8633,8636,8650,8653,8658,8661,8664,8667,8672,8675,8680,8683,8688,8691,8705,8708,8712,8715,8724,8727,8732,8735,8740,8743,8753,8756,8764,8767,8770,8773,8778,8781,8786,8789,8794,8797,8802,8805,8807,8810,8815,8818],{"_950":8593,"_2565":8524,"_2420":2566,"_2567":8533},"be75c4ca-dc66-4f5f-b06f-394608d6b137",{"_950":8595,"_2420":2570,"_2571":8596},"6dec4873-72c1-4a0d-aefc-922624c15c2b",[],{"_950":8598,"_2420":2575,"_2576":1909,"_2571":8599},"3511573b-d3c4-4fe1-9316-38ec54e9aa76",[8600],{"_2579":8524,"_2420":2579},{"_950":8602,"_2420":2570,"_2571":8603},"4e8c6232-2e05-4a2d-b011-d9f6dcfdc04f",[],{"_950":8605,"_2420":2570,"_2571":8606},"89c8b08a-54ec-4516-b871-4b527cb3d90f",[8607],{"_2579":8608,"_2420":2579},"인공지능 에이전트와 외부 도구를 연결하는 기술 표준인 모델 컨텍스트 프로토콜(MCP)이 무상태 HTTP 아키텍처로 전면 개편됩니다. 기존 MCP는 로컬 중심의 표준 입출력이나 세션 유지가 필수적인 서버 전송 이벤트 방식에 의존하여 분산 서버 환경에서 확장하기 까다로운 한계가 있었습니다. 최근 공개된 2026-07-28 명세 후보와 TypeScript SDK v2.0은 이 제약을 극복하고, 무상태 네트워크 설계와 강력한 엔터프라이즈 보안 사양을 도입해 대규모 프로덕션 환경 구축을 무리 없이 지원합니다.",{"_950":8610,"_2420":2570,"_2571":8611},"6ad15e1a-8c12-4419-8471-b1fb1383a9bb",[],{"_950":8613,"_2420":2575,"_2576":2007,"_2571":8614},"473d0a28-64f1-411f-9048-eac39adaa7b8",[8615],{"_2579":8616,"_2420":2579},"무상태 HTTP 설계로의 패러다임 변화와 패키지 분할",{"_950":8618,"_2420":2570,"_2571":8619},"c31d4c81-dc6a-42ac-8048-a635752999d1",[],{"_950":8621,"_2420":2570,"_2571":8622},"91857594-6b96-477f-bd8e-ebe020144a55",[8623],{"_2579":8624,"_2420":2579},"모델 컨텍스트 프로토콜 명세 후보와 TypeScript SDK v2.0의 핵심 변화는 무상태 HTTP 전송으로의 전면적인 전환입니다. 기존 사양에서는 서버가 클라이언트와 연결을 유지하며 세션 ID를 발급하고 관리해야 했습니다. 이 때문에 대규모 서비스에서 서버를 수평 확장하려면 로드 밸런서에 스티키 세션을 지정하거나 별도의 세션 공유 저장소를 구축해야 하는 인프라 부담이 따랐습니다.",{"_950":8626,"_2420":2570,"_2571":8627},"73bbd09d-3f6c-4c7a-bfdd-c50d40627bac",[],{"_950":8629,"_2420":2570,"_2571":8630},"273a7cd6-8b1c-43ba-8461-8ba7da7ab864",[8631],{"_2579":8632,"_2420":2579},"반면 새롭게 개편된 명세에서는 초기 핸드셰이크 과정이 생략되고, 프로토콜 버전과 기능 정의가 매 요청마다 독립적으로 전송됩니다. 모든 요청이 완전히 스스로 동작할 수 있는 자급식 구조로 설계된 덕분에, 개발자는 복잡한 세션 유지 없이 일반적인 라운드 로빈 방식의 로드 밸런싱을 통해 서버 인스턴스를 자유롭게 분산 배치할 수 있습니다.",{"_950":8634,"_2420":2570,"_2571":8635},"685ffbd3-3eb3-45d2-a925-9c99090e131e",[],{"_950":8637,"_2420":2570,"_2571":8638},"00fb2130-70b1-4411-affc-22ca0999288e",[8639,8641,8643,8645,8648],{"_2579":8640,"_2420":2579},"이러한 무상태 아키텍처를 원활하게 구현할 수 있도록 기존의 단일 SDK 패키지는 서버 개발을 위한 ",{"_2579":6382,"_2420":2579,"_3365":8642},{"_3351":3367},{"_2579":8644,"_2420":2579},"와 클라이언트 개발을 위한 ",{"_2579":8646,"_2420":2579,"_3365":8647},"@modelcontextprotocol/client",{"_3351":3367},{"_2579":8649,"_2420":2579},"로 깔끔하게 분할되었습니다. 또한 개발자가 선호하는 웹 프레임워크에 맞춰 통합할 수 있도록 다양한 경량 어댑터 패키지가 함께 제공됩니다.",{"_950":8651,"_2420":2570,"_2571":8652},"9630523d-bcbc-4685-a84f-a198f5d69f22",[],{"_950":8654,"_2420":2570,"_2571":8655},"090b70c6-8291-442e-b2d3-042c91d610b2",[8656],{"_2579":8657,"_2420":2579},"예를 들어 웹 표준 인터페이스를 지원하는 Hono나 클라우드플레어 워커스 환경에서는 SDK가 제공하는 표준 핸들러를 별도의 변환 없이 직접 서빙할 수 있습니다. 반면 기존 Node.js 생태계에서 널리 쓰이는 Express 환경이라면 다음과 같이 전용 어댑터를 통해 몇 줄의 코드만으로 라우터에 쉽게 연동할 수 있습니다.",{"_950":8659,"_2420":2570,"_2571":8660},"bed6ca44-27c3-4425-8181-3b08042d6ec6",[],{"_950":8662,"_3351":8663,"_2420":3351,"_625":3125},"3934edcf-77a9-4e53-b31d-10d262d888bd","// @modelcontextprotocol/server v2.0 및 Node.js 어댑터 기준\nimport express from 'express';\nimport { createMcpHandler, McpServer } from '@modelcontextprotocol/server';\nimport { toNodeHandler } from '@modelcontextprotocol/node';\n\nconst mcpHandler = createMcpHandler(() => {\n const server = new McpServer({ name: 'enterprise-tools', version: '2.0.0' });\n // 여기에 도구 및 리소스 등록 로직을 추가합니다.\n return server;\n});\n\nconst app = express();\napp.all('/mcp', toNodeHandler(mcpHandler));\napp.listen(3000);",{"_950":8665,"_2420":2570,"_2571":8666},"83fe5cdb-81e2-45f3-b3b9-1add0eae8386",[],{"_950":8668,"_2420":2570,"_2571":8669},"3faae792-a11c-43b6-926c-9708c7f0b6da",[8670],{"_2579":8671,"_2420":2579},"새로운 무상태 설계와 모듈화된 패키지 구성 덕분에 가벼운 가상 서버나 서버리스 서버뿐만 아니라 복잡한 마이크로서비스 아키텍처 내에서도 MCP 도구 서버를 매우 유연하게 구축하고 운영할 수 있게 되었습니다.",{"_950":8673,"_2420":2570,"_2571":8674},"3a8b4e66-efcd-42c5-b062-2ca6dae93267",[],{"_950":8676,"_2420":2575,"_2576":2007,"_2571":8677},"89f96aa2-85a3-49e8-89a6-ca29c74ec206",[8678],{"_2579":8679,"_2420":2579},"OAuth 2.1과 RFC 9728 기반의 보안 상호연동 구조",{"_950":8681,"_2420":2570,"_2571":8682},"be302aad-6b9a-4cf3-a395-e4732e07cf82",[],{"_950":8684,"_2420":2570,"_2571":8685},"bb799032-b117-4b37-a048-53704fcd84a0",[8686],{"_2579":8687,"_2420":2579},"에이전트가 외부 서버의 도구를 동적으로 탐색하고 안전하게 실행하려면 견고한 인증 체계가 뒷받침되어야 합니다. MCP v2는 대규모 분산 환경에 대응하기 위해 최신 보안 표준인 OAuth 2.1과 OAuth 보호 자원 메타데이터 명세인 RFC 9728을 핵심 인증 아키텍처로 채택했습니다.",{"_950":8689,"_2420":2570,"_2571":8690},"5b3472c0-ba50-43b1-8e71-64033fbc2648",[],{"_950":8692,"_2420":2570,"_2571":8693},"18d37498-2cf6-493f-9bdd-eccde865f235",[8694,8696,8699,8701,8703],{"_2579":8695,"_2420":2579},"비인증 상태의 에이전트 클라이언트가 도구 실행 API를 호출하면, MCP 서버는 요청을 거절하는 동시에 클라이언트가 스스로 인증 방식을 파악할 수 있도록 챌린지 응답을 전송합니다. 이때 서버는 ",{"_2579":8697,"_2420":2579,"_3365":8698},"401 Unauthorized",{"_3351":3367},{"_2579":8700,"_2420":2579}," 상태 코드와 함께 ",{"_2579":3988,"_2420":2579,"_3365":8702},{"_3351":3367},{"_2579":8704,"_2420":2579}," 헤더에 보호 자원 메타데이터 경로를 담아 반환합니다.",{"_950":8706,"_2420":2570,"_2571":8707},"80b2d1ef-06e1-4c7b-8c5f-acb721ca8543",[],{"_950":8709,"_3351":8710,"_2420":3351,"_625":8711},"3cfbf283-5d61-455b-9061-4fe5570c43e1","HTTP/1.1 401 Unauthorized\nWWW-Authenticate: Bearer resource_metadata=\"https://mcp.example.com/.well-known/oauth-protected-resource\"","http",{"_950":8713,"_2420":2570,"_2571":8714},"72de80c1-0ec0-4ba5-8032-ea1a1562f09c",[],{"_950":8716,"_2420":2570,"_2571":8717},"0fe5f51d-f52e-4e12-bf6d-186e02eb258b",[8718,8720,8722],{"_2579":8719,"_2420":2579},"클라이언트는 헤더에 명시된 ",{"_2579":3993,"_2420":2579,"_3365":8721},{"_3351":3367},{"_2579":8723,"_2420":2579}," 엔드포인트에 접근해 해당 MCP 서버가 신뢰하는 인가 서버 주소와 지원하는 권한 범위를 서술한 JSON 메타데이터를 가져옵니다. 이를 통해 에이전트는 하드코딩된 인증 정보 없이도 기계적으로 다음 단계의 OAuth 2.1 인가 코드 흐름을 시작할 수 있습니다. 결과적으로 이 구조는 다수의 MCP 서버와 클라이언트가 복잡한 사전 연동 설정 없이도 신뢰 경계를 동적으로 확장할 수 있는 고도의 상호운용성을 제공합니다.",{"_950":8725,"_2420":2570,"_2571":8726},"3c0aad8b-133f-4bb9-810a-ea46e6e6e8b4",[],{"_950":8728,"_2420":2575,"_2576":2007,"_2571":8729},"177f1ea4-247b-48ff-b469-12d0d8d50671",[8730],{"_2579":8731,"_2420":2579},"Standard Schema v1.0 통합으로 간결해진 인터페이스 검증",{"_950":8733,"_2420":2570,"_2571":8734},"cb7a8cdc-697a-4769-8aa5-bf1f91c28b69",[],{"_950":8736,"_2420":2570,"_2571":8737},"cd818094-0a1e-4402-a9ea-dd22f80f36c0",[8738],{"_2579":8739,"_2420":2579},"에이전트가 실행하는 도구의 입력값을 실시간으로 검증하는 아키텍처도 대폭 개편되었습니다. MCP TypeScript SDK v2는 타입스크립트 에코시스템의 공통 검증 명세인 Standard Schema v1.0을 내장했습니다. 이에 따라 Zod, Valibot, ArkType 등 어떤 검증 라이브러리를 사용하더라도 별도의 어댑터나 변환 레이어 없이 도구의 입력 스키마로 직접 활용할 수 있습니다.",{"_950":8741,"_2420":2570,"_2571":8742},"5597b050-3b4e-4d05-ad90-2c0c20b98e03",[],{"_950":8744,"_2420":2570,"_2571":8745},"d26ded84-4040-457f-86e4-f86e37b7a9d3",[8746,8748,8751],{"_2579":8747,"_2420":2579},"과거에는 SDK 내부에 특정 버전의 Zod 의존성이 강하게 결합되어 있어, 개발자 프로젝트의 Zod 버전과 충돌하거나 JSON 스키마 변환 과정에서 스키마가 누락되는 등의 의존성 문제가 잦았습니다. v2 SDK는 Standard Schema 규격을 충족하는 객체라면 무엇이든 ",{"_2579":8749,"_2420":2579,"_3365":8750},"inputSchema",{"_3351":3367},{"_2579":8752,"_2420":2579},"로 즉시 바인딩하므로 이러한 고질적인 버전 갈등을 완벽히 해결합니다.",{"_950":8754,"_2420":2570,"_2571":8755},"f6ca9704-c9c4-4e90-9a7a-b53733fffc9c",[],{"_950":8757,"_2420":2570,"_2571":8758},"aca4cc6a-c8c0-4b03-93f0-b7358762d83e",[8759,8760,8762],{"_2579":6380,"_2420":2579},{"_2579":6382,"_2420":2579,"_3365":8761},{"_3351":3367},{"_2579":8763,"_2420":2579}," 패키지를 사용하여 Zod 스키마로 도구를 등록하는 예시입니다.",{"_950":8765,"_2420":2570,"_2571":8766},"684b001b-bbe9-4e33-b856-9aff2cc1d45d",[],{"_950":8768,"_3351":8769,"_2420":3351,"_625":3125},"77c400c7-f914-47d3-9f93-1f3756351030","import { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-service\",\n version: \"1.0.0\"\n});\n\nserver.registerTool(\n \"get_weather\",\n {\n description: \"특정 도시의 현재 날씨를 조회합니다.\",\n inputSchema: z.object({\n city: z.string().describe(\"날씨를 조회할 도시 이름 (예: 서울, 부산)\")\n })\n },\n async ({ city }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 날씨는 맑음입니다.` }]\n };\n }\n);",{"_950":8771,"_2420":2570,"_2571":8772},"460d06a8-8d96-4748-aa71-c595bfe6ddd2",[],{"_950":8774,"_2420":2570,"_2571":8775},"9bed6ca1-8699-4541-a2c1-a077e6eafaa0",[8776],{"_2579":8777,"_2420":2579},"이 방식을 활용하면 호출 시점에 클라이언트가 보낸 요청 본문이 정의한 스키마에 맞춰 자동으로 검증됩니다. 개발자는 복잡한 수동 파싱 과정 없이 핸들러 내부에서 정적 타입이 보장된 입력 인자를 즉시 사용할 수 있어 런타임 안정성과 개발 경험이 대폭 향상됩니다.",{"_950":8779,"_2420":2570,"_2571":8780},"91205970-efaf-4e7c-a0ab-3a5a28e4e5cf",[],{"_950":8782,"_2420":2575,"_2576":2007,"_2571":8783},"dc9cd16e-1a3c-4950-9c34-7c3b2aacc1bf",[8784],{"_2579":8785,"_2420":2579},"분산 환경에서 실현되는 보안 도구 인프라",{"_950":8787,"_2420":2570,"_2571":8788},"b25237ba-6cd3-45e7-9fe7-6d6dd576d884",[],{"_950":8790,"_2420":2570,"_2571":8791},"a8e756ea-8ab9-42b1-a759-0b44b7e2da7a",[8792],{"_2579":8793,"_2420":2579},"무상태 HTTP 설계와 OAuth 2.1 표준 보안 체계를 결합한 MCP v2.0은 AI 에이전트 연동을 단순한 프로토타입 수준에서 진정한 엔터프라이즈급 마이크로서비스 아키텍처로 끌어올립니다.",{"_950":8795,"_2420":2570,"_2571":8796},"3cdef8c7-2c0f-4787-93fa-241ab87b68db",[],{"_950":8798,"_2420":2570,"_2571":8799},"cbb17753-16ff-4f4a-8670-59e94a6d06db",[8800],{"_2579":8801,"_2420":2579},"이제 개발자들은 클라이언트에 결합한 무거운 연동 로직 대신, 독립적으로 스케일 아웃이 가능하고 보안이 검증된 분산형 MCP 도구 네트워크를 구축할 수 있습니다. Vercel AI SDK나 LangChain 같은 주요 에이전트 프레임워크가 이를 빠르게 흡수하고 있는 만큼, 무상태 API 기반의 도구 생태계 구축은 실전 프로덕션 도입을 위한 필수 선택지가 될 것입니다.",{"_950":8803,"_2420":2570,"_2571":8804},"428b88bf-3235-48ab-9422-6a7faf1d414c",[],{"_950":8806,"_2420":3473},"02bb9f24-a152-4412-b60c-cb55c291a730",{"_950":8808,"_2420":2570,"_2571":8809},"121a21da-9414-4d33-a923-26350e286fad",[],{"_950":8811,"_2420":2570,"_2571":8812},"49d346f4-02f1-4079-89c2-1565ebacb1a2",[8813],{"_2579":3483,"_2420":2579,"_3365":8814},{"_3485":3367},{"_950":8816,"_2420":2570,"_2571":8817},"ab6df5f3-9964-49ec-af8d-4d0a5ee59b54",[],{"_950":8819,"_1881":3492,"_2420":3493,"_778":8820},"ffee5fde-4205-4532-8e40-8a903095b56f",[8821,8829,8836],{"_950":8822,"_2571":8823},"62fd4bb7-2e87-4a6b-aa6a-8d049f9bb004",[8824],{"_3499":8825,"_2420":3501,"_3502":8826},"https://github.com/modelcontextprotocol/typescript-sdk/issues/2505",[8827],{"_2579":8828,"_2420":2579},"modelcontextprotocol/typescript-sdk Issues — McpServer registerTool API and Standard Schema Support",{"_950":8830,"_2571":8831},"ed39f877-2955-4827-8c4b-963d0ad4e5fe",[8832],{"_3499":5316,"_2420":3501,"_3502":8833},[8834],{"_2579":8835,"_2420":2579},"modelcontextprotocol/typescript-sdk GitHub — Model Context Protocol TypeScript SDK v2.0.0 Released",{"_950":8837,"_2571":8838},"efc1f09c-e5f1-4366-8f88-036b58e8c885",[8839],{"_3499":8840,"_2420":3501,"_3502":8841},"https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/seps/0985-oauth-prm.md",[8842],{"_2579":8843,"_2420":2579},"Model Context Protocol SEPs — SEP-985: Align OAuth 2.0 Protected Resource Metadata with RFC 9728",{"_8637":8845,"_8654":8850,"_8716":8854,"_8728":8859,"_8692":8863,"_8629":8868,"_8598":8872,"_8668":8874,"_8613":8878,"_8811":8882,"_8605":8884,"_8676":8888,"_8621":8892,"_8774":8896,"_8790":8900,"_8757":8904,"_8684":8909,"_8798":8913,"_8736":8917,"_8744":8921,"_8782":8926,"_8819":8930},{"_2571":8846},{"_1892":8847,"_1893":8848,"_1802":8849},"To support the seamless implementation of this stateless architecture, the existing monolithic SDK package has been cleanly split into @modelcontextprotocol/server for server development and @modelcontextprotocol/client for client development. Additionally, various lightweight adapter packages are provided to integrate with developers' preferred web frameworks.","このステートレスなアーキテクチャを円滑に実現するため、従来の単一SDKパッケージは、サーバー開発用の「@modelcontextprotocol/server」とクライアント開発用の「@modelcontextprotocol/client」に明確に分割されました。また、好みのWebフレームワークに合わせて統合できるよう、多様な軽量アダプターパッケージも併せて提供されます。","이러한 무상태 아키텍처를 원활하게 구현할 수 있도록 기존의 단일 SDK 패키지는 서버 개발을 위한 @modelcontextprotocol/server와 클라이언트 개발을 위한 @modelcontextprotocol/client로 깔끔하게 분할되었습니다. 또한 개발자가 선호하는 웹 프레임워크에 맞춰 통합할 수 있도록 다양한 경량 어댑터 패키지가 함께 제공됩니다.",{"_2571":8851},{"_1892":8852,"_1893":8853,"_1802":8657},"For example, in Hono or Cloudflare Workers environments that support web-standard interfaces, the SDK's standard handlers can be served directly without any conversion. For the Express environment, widely used in the existing Node.js ecosystem, it can be easily integrated into routers in just a few lines of code using a dedicated adapter.","例えば、Web標準インターフェースをサポートするHonoやCloudflare Workers環境では、SDKが提供する標準ハンドラーを変換なしで直接実行できます。一方、従来のNode.jsエコシステムで広く使われているExpress環境であれば、専用アダプターを通じてわずか数行のコードでルーターと簡単に連携可能です。",{"_2571":8855},{"_1892":8856,"_1893":8857,"_1802":8858},"The client accesses the resource_metadata endpoint specified in the header to retrieve JSON metadata describing the authorization server addresses trusted by the MCP server and the supported scopes. This allows the agent to programmatically initiate the OAuth 2.1 authorization code flow without hardcoded credentials. Consequently, this structure provides a high level of interoperability, enabling multiple MCP servers and clients to dynamically extend trust boundaries without complex pre-configuration.","クライアントはヘッダーに記載された「resource_metadata」エンドポイントにアクセスし、該当のMCPサーバーが信頼する認可サーバーのアドレスやサポートされている権限範囲を記述したJSONメタデータを取得します。これにより、エージェントはハードコードされた認証情報なしでも、機械的に次ステップであるOAuth 2.1の認可コードフローを開始できます。結果として、この構造は多数のMCPサーバーとクライアントの間で、事前の複雑な設定なしに信頼境界を動的に拡張できる高度な相互運用性を実現します。","클라이언트는 헤더에 명시된 resource_metadata 엔드포인트에 접근해 해당 MCP 서버가 신뢰하는 인가 서버 주소와 지원하는 권한 범위를 서술한 JSON 메타데이터를 가져옵니다. 이를 통해 에이전트는 하드코딩된 인증 정보 없이도 기계적으로 다음 단계의 OAuth 2.1 인가 코드 흐름을 시작할 수 있습니다. 결과적으로 이 구조는 다수의 MCP 서버와 클라이언트가 복잡한 사전 연동 설정 없이도 신뢰 경계를 동적으로 확장할 수 있는 고도의 상호운용성을 제공합니다.",{"_2571":8860},{"_1892":8861,"_1893":8862,"_1802":8731},"Streamlined Interface Validation with Standard Schema v1.0 Integration","Standard Schema v1.0の統合によるインターフェース検証の簡素化",{"_2571":8864},{"_1892":8865,"_1893":8866,"_1802":8867},"When an unauthenticated agent client calls a tool execution API, the MCP server rejects the request while simultaneously sending a challenge response that allows the client to identify the authentication method itself. In this process, the server returns a 401 Unauthorized status code, including the path to the protected resource metadata in the WWW-Authenticate header.","認証されていないエージェントクライアントがツール実行APIを呼び出すと、MCPサーバーはリクエストを拒否すると同時に、クライアント自身が認証方式を特定できるようにチャレンジレスポンスを送信します。この際、サーバーは「401 Unauthorized」ステータスコードと共に、WWW-Authenticateヘッダーに保護リソースメタデータのパスを含めて返却します。","비인증 상태의 에이전트 클라이언트가 도구 실행 API를 호출하면, MCP 서버는 요청을 거절하는 동시에 클라이언트가 스스로 인증 방식을 파악할 수 있도록 챌린지 응답을 전송합니다. 이때 서버는 401 Unauthorized 상태 코드와 함께 WWW-Authenticate 헤더에 보호 자원 메타데이터 경로를 담아 반환합니다.",{"_2571":8869},{"_1892":8870,"_1893":8871,"_1802":8632},"Conversely, in the newly revised specification, the initial handshake is eliminated, and protocol versions and capability definitions are sent with every request independently. Because every request is designed as a self-contained structure, developers can distribute server instances freely using standard round-robin load balancing without the need for complex session maintenance.","一方、新仕様では初期ハンドシェイクのプロセスが省略され、プロトコルのバージョンや機能定義がリクエストごとに独立して送信されます。すべてのリクエストが単体で完結する自己充足的な構造になったため、開発者は複雑なセッション維持を気にすることなく、標準的なラウンドロビン方式のロードバランシングによってサーバーインスタンスを自由に分散配置できるようになりました。",{"_2571":8873},{"_1892":8522,"_1893":8523,"_1802":8524},{"_2571":8875},{"_1892":8876,"_1893":8877,"_1802":8671},"Thanks to the new stateless design and modular package structure, you can now build and operate MCP tool servers with great flexibility, not just in lightweight virtual servers or serverless environments, but also within complex microservice architectures.","新しいステートレス設計とモジュール化されたパッケージ構成により、軽量な仮想サーバーやサーバーレスだけでなく、複雑なマイクロサービスアーキテクチャ内においても、MCPツールサーバーを非常に柔軟に構築・運用できるようになりました。",{"_2571":8879},{"_1892":8880,"_1893":8881,"_1802":8616},"Paradigm Shift to Stateless HTTP Design and Package Decoupling","ステートレスHTTP設計へのパラダイムシフトとパッケージの分割",{"_2571":8883},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":8885},{"_1892":8886,"_1893":8887,"_1802":8608},"The Model Context Protocol (MCP), a technical standard for connecting AI agents with external tools, has undergone a complete overhaul to a stateless HTTP architecture. Previous versions of MCP relied on local-focused standard I/O or Server-Sent Events, which required state maintenance and created difficulties for scaling in distributed server environments. The recently published 2026-07-28 specification candidate and TypeScript SDK v2.0 overcome these limitations, introducing a stateless network design and robust enterprise-grade security specifications to seamlessly support large-scale production deployments.","AIエージェントと外部ツールを接続する技術標準であるモデルコンテキストプロトコル（MCP）が、ステートレスHTTPアーキテクチャへと全面的に刷新されます。従来のMCPは、ローカル中心の標準入出力やセッション維持が必須であるサーバー送信イベント（SSE）方式に依存しており、分散サーバー環境での拡張が困難という課題がありました。今回公開された2026-07-28の仕様ドラフトとTypeScript SDK v2.0は、この制約を克服し、ステートレスなネットワーク設計と堅牢なエンタープライズ向けセキュリティ仕様を導入することで、大規模な本番環境の構築を強力にサポートします。",{"_2571":8889},{"_1892":8890,"_1893":8891,"_1802":8679},"Security Interoperability Architecture Based on OAuth 2.1 and RFC 9728","OAuth 2.1およびRFC 9728に基づくセキュアな相互運用構造",{"_2571":8893},{"_1892":8894,"_1893":8895,"_1802":8624},"The core change in the Model Context Protocol specification candidate and TypeScript SDK v2.0 is the full transition to stateless HTTP transport. In previous specifications, servers had to maintain connections with clients, issuing and managing session IDs. This created infrastructure overhead for large-scale services, requiring sticky sessions on load balancers or separate session-sharing storage to enable horizontal server scaling.","モデルコンテキストプロトコルの仕様ドラフトとTypeScript SDK v2.0の最大の変化は、ステートレスHTTPトランスポートへの完全移行です。従来はサーバーがクライアントとの接続を維持し、セッションIDの発行と管理を行う必要がありました。そのため、大規模なサービスでサーバーを水平拡張しようとすると、ロードバランサーでのスティッキーセッション指定や、専用のセッション共有ストレージの構築が必要となり、インフラ面で大きな負担となっていました。",{"_2571":8897},{"_1892":8898,"_1893":8899,"_1802":8777},"Using this approach, the request body sent by the client is automatically validated against the defined schema at call time. Developers can immediately use statically typed input arguments within the handler without complex manual parsing, significantly improving runtime stability and the developer experience.","この手法を活用すると、呼び出し時にクライアントが送信したリクエストボディが定義したスキーマに合わせて自動的に検証されます。開発者は複雑な手動パース処理なしに、ハンドラー内部で静的型付けされた入力引数を即座に利用できるため、ランタイムの安定性と開発者体験（DX）が劇的に向上します。",{"_2571":8901},{"_1892":8902,"_1893":8903,"_1802":8793},"By combining stateless HTTP design with the OAuth 2.1 standard security framework, MCP v2.0 elevates AI agent integration from simple prototypes to true enterprise-grade microservice architectures.","ステートレスHTTP設計とOAuth 2.1標準のセキュリティ体系を組み合わせたMCP v2.0は、AIエージェントの連携を単なるプロトタイプレベルから、本格的なエンタープライズ向けマイクロサービスアーキテクチャへと昇華させます。",{"_2571":8905},{"_1892":8906,"_1893":8907,"_1802":8908},"The following is an example of registering a tool with a Zod schema using the @modelcontextprotocol/server package.","以下は、@modelcontextprotocol/serverパッケージを使用してZodスキーマでツールを登録する例です。","다음은 @modelcontextprotocol/server 패키지를 사용하여 Zod 스키마로 도구를 등록하는 예시입니다.",{"_2571":8910},{"_1892":8911,"_1893":8912,"_1802":8687},"For agents to dynamically discover and securely execute tools on external servers, a robust authentication system is required. To support large-scale distributed environments, MCP v2 has adopted the latest security standards, OAuth 2.1 and RFC 9728 (OAuth Protected Resource Metadata), as its core authentication architecture.","エージェントが外部サーバー上のツールを動的に探索し、安全に実行するためには強固な認証体系が不可欠です。MCP v2では、大規模な分散環境に対応するため、最新のセキュリティ標準であるOAuth 2.1と、OAuth保護リソースメタデータ仕様であるRFC 9728を認証アーキテクチャの核として採用しました。",{"_2571":8914},{"_1892":8915,"_1893":8916,"_1802":8801},"Developers can now build distributed MCP tool networks that are independently scalable and security-verified, rather than relying on heavy integration logic coupled to clients. As major agent frameworks like Vercel AI SDK and LangChain are rapidly adopting these standards, building tool ecosystems based on stateless APIs will become an essential choice for production deployment.","これからは開発者がクライアントと密結合した重い連携ロジックを実装する代わりに、独立してスケールアウト可能かつセキュリティが検証された、分散型MCPツールネットワークを構築できるようになります。Vercel AI SDKやLangChainといった主要なエージェントフレームワークがこれにいち早く対応しているように、ステートレスなAPIベースのツールエコシステム構築は、実戦的なプロダクション導入における不可欠な選択肢となるでしょう。",{"_2571":8918},{"_1892":8919,"_1893":8920,"_1802":8739},"The architecture for real-time validation of tool inputs executed by agents has also been significantly overhauled. MCP TypeScript SDK v2 now includes Standard Schema v1.0, the common validation specification for the TypeScript ecosystem. As a result, regardless of whether you use Zod, Valibot, ArkType, or any other validation library, you can use them directly as tool input schemas without needing separate adapters or transformation layers.","エージェントが実行するツールの入力値をリアルタイムで検証するアーキテクチャも大幅に刷新されました。MCP TypeScript SDK v2は、TypeScriptエコシステムの共通検証仕様である「Standard Schema v1.0」を内蔵しました。これにより、Zod、Valibot、ArkTypeなど、どの検証ライブラリを使用していても、アダプターや変換レイヤーなしでツールの入力スキーマとして直接活用可能です。",{"_2571":8922},{"_1892":8923,"_1893":8924,"_1802":8925},"Previously, the SDK was tightly coupled with a specific version of Zod, leading to frequent dependency issues such as conflicts with the Zod version in the developer's project or missing schemas during JSON Schema transformation. The v2 SDK immediately binds any object that meets the Standard Schema specification as an inputSchema, perfectly resolving these recurring version conflicts.","過去には、SDK内部に特定のバージョンのZod依存関係が強く結合されていたため、開発者のプロジェクト側のZodバージョンと衝突したり、JSONスキーマ変換過程でスキーマが欠落したりする依存関係の問題が頻発していました。v2 SDKはStandard Schema規格を満たすオブジェクトであれば、どれでも即座にinputSchemaとしてバインディングできるため、こうした深刻なバージョン競合を完全に解決します。","과거에는 SDK 내부에 특정 버전의 Zod 의존성이 강하게 결합되어 있어, 개발자 프로젝트의 Zod 버전과 충돌하거나 JSON 스키마 변환 과정에서 스키마가 누락되는 등의 의존성 문제가 잦았습니다. v2 SDK는 Standard Schema 규격을 충족하는 객체라면 무엇이든 inputSchema로 즉시 바인딩하므로 이러한 고질적인 버전 갈등을 완벽히 해결합니다.",{"_2571":8927},{"_1892":8928,"_1893":8929,"_1802":8785},"Secure Tool Infrastructure Realized in Distributed Environments","分散環境で実現するセキュアなツールインフラ",{"_8931":8932,"_8933":8934,"_8935":8936},"item:62fd4bb7-2e87-4a6b-aa6a-8d049f9bb004",{"_1892":8828,"_1893":8828,"_1802":8828},"item:ed39f877-2955-4827-8c4b-963d0ad4e5fe",{"_1892":8835,"_1893":8835,"_1802":8835},"item:efc1f09c-e5f1-4366-8f88-036b58e8c885",{"_1892":8843,"_1893":8843,"_1802":8843},"![MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입](file:cms5r0uzf005q10nv80udq68t)\n\n# MCP v2.0 SDK 출시 — 무상태 HTTP와 OAuth 2.1 보안 표준 도입\n\n인공지능 에이전트와 외부 도구를 연결하는 기술 표준인 모델 컨텍스트 프로토콜(MCP)이 무상태 HTTP 아키텍처로 전면 개편됩니다. 기존 MCP는 로컬 중심의 표준 입출력이나 세션 유지가 필수적인 서버 전송 이벤트 방식에 의존하여 분산 서버 환경에서 확장하기 까다로운 한계가 있었습니다. 최근 공개된 2026-07-28 명세 후보와 TypeScript SDK v2.0은 이 제약을 극복하고, 무상태 네트워크 설계와 강력한 엔터프라이즈 보안 사양을 도입해 대규모 프로덕션 환경 구축을 무리 없이 지원합니다.\n\n## 무상태 HTTP 설계로의 패러다임 변화와 패키지 분할\n\n모델 컨텍스트 프로토콜 명세 후보와 TypeScript SDK v2.0의 핵심 변화는 무상태 HTTP 전송으로의 전면적인 전환입니다. 기존 사양에서는 서버가 클라이언트와 연결을 유지하며 세션 ID를 발급하고 관리해야 했습니다. 이 때문에 대규모 서비스에서 서버를 수평 확장하려면 로드 밸런서에 스티키 세션을 지정하거나 별도의 세션 공유 저장소를 구축해야 하는 인프라 부담이 따랐습니다.\n\n반면 새롭게 개편된 명세에서는 초기 핸드셰이크 과정이 생략되고, 프로토콜 버전과 기능 정의가 매 요청마다 독립적으로 전송됩니다. 모든 요청이 완전히 스스로 동작할 수 있는 자급식 구조로 설계된 덕분에, 개발자는 복잡한 세션 유지 없이 일반적인 라운드 로빈 방식의 로드 밸런싱을 통해 서버 인스턴스를 자유롭게 분산 배치할 수 있습니다.\n\n이러한 무상태 아키텍처를 원활하게 구현할 수 있도록 기존의 단일 SDK 패키지는 서버 개발을 위한 `@modelcontextprotocol/server`와 클라이언트 개발을 위한 `@modelcontextprotocol/client`로 깔끔하게 분할되었습니다. 또한 개발자가 선호하는 웹 프레임워크에 맞춰 통합할 수 있도록 다양한 경량 어댑터 패키지가 함께 제공됩니다.\n\n예를 들어 웹 표준 인터페이스를 지원하는 Hono나 클라우드플레어 워커스 환경에서는 SDK가 제공하는 표준 핸들러를 별도의 변환 없이 직접 서빙할 수 있습니다. 반면 기존 Node.js 생태계에서 널리 쓰이는 Express 환경이라면 다음과 같이 전용 어댑터를 통해 몇 줄의 코드만으로 라우터에 쉽게 연동할 수 있습니다.\n\n```typescript\n// @modelcontextprotocol/server v2.0 및 Node.js 어댑터 기준\nimport express from 'express';\nimport { createMcpHandler, McpServer } from '@modelcontextprotocol/server';\nimport { toNodeHandler } from '@modelcontextprotocol/node';\n\nconst mcpHandler = createMcpHandler(() => {\n const server = new McpServer({ name: 'enterprise-tools', version: '2.0.0' });\n // 여기에 도구 및 리소스 등록 로직을 추가합니다.\n return server;\n});\n\nconst app = express();\napp.all('/mcp', toNodeHandler(mcpHandler));\napp.listen(3000);\n```\n\n새로운 무상태 설계와 모듈화된 패키지 구성 덕분에 가벼운 가상 서버나 서버리스 서버뿐만 아니라 복잡한 마이크로서비스 아키텍처 내에서도 MCP 도구 서버를 매우 유연하게 구축하고 운영할 수 있게 되었습니다.\n\n## OAuth 2.1과 RFC 9728 기반의 보안 상호연동 구조\n\n에이전트가 외부 서버의 도구를 동적으로 탐색하고 안전하게 실행하려면 견고한 인증 체계가 뒷받침되어야 합니다. MCP v2는 대규모 분산 환경에 대응하기 위해 최신 보안 표준인 OAuth 2.1과 OAuth 보호 자원 메타데이터 명세인 RFC 9728을 핵심 인증 아키텍처로 채택했습니다.\n\n비인증 상태의 에이전트 클라이언트가 도구 실행 API를 호출하면, MCP 서버는 요청을 거절하는 동시에 클라이언트가 스스로 인증 방식을 파악할 수 있도록 챌린지 응답을 전송합니다. 이때 서버는 `401 Unauthorized` 상태 코드와 함께 `WWW-Authenticate` 헤더에 보호 자원 메타데이터 경로를 담아 반환합니다.\n\n```http\nHTTP/1.1 401 Unauthorized\nWWW-Authenticate: Bearer resource_metadata=\"https://mcp.example.com/.well-known/oauth-protected-resource\"\n```\n\n클라이언트는 헤더에 명시된 `resource\\_metadata` 엔드포인트에 접근해 해당 MCP 서버가 신뢰하는 인가 서버 주소와 지원하는 권한 범위를 서술한 JSON 메타데이터를 가져옵니다. 이를 통해 에이전트는 하드코딩된 인증 정보 없이도 기계적으로 다음 단계의 OAuth 2.1 인가 코드 흐름을 시작할 수 있습니다. 결과적으로 이 구조는 다수의 MCP 서버와 클라이언트가 복잡한 사전 연동 설정 없이도 신뢰 경계를 동적으로 확장할 수 있는 고도의 상호운용성을 제공합니다.\n\n## Standard Schema v1.0 통합으로 간결해진 인터페이스 검증\n\n에이전트가 실행하는 도구의 입력값을 실시간으로 검증하는 아키텍처도 대폭 개편되었습니다. MCP TypeScript SDK v2는 타입스크립트 에코시스템의 공통 검증 명세인 Standard Schema v1.0을 내장했습니다. 이에 따라 Zod, Valibot, ArkType 등 어떤 검증 라이브러리를 사용하더라도 별도의 어댑터나 변환 레이어 없이 도구의 입력 스키마로 직접 활용할 수 있습니다.\n\n과거에는 SDK 내부에 특정 버전의 Zod 의존성이 강하게 결합되어 있어, 개발자 프로젝트의 Zod 버전과 충돌하거나 JSON 스키마 변환 과정에서 스키마가 누락되는 등의 의존성 문제가 잦았습니다. v2 SDK는 Standard Schema 규격을 충족하는 객체라면 무엇이든 `inputSchema`로 즉시 바인딩하므로 이러한 고질적인 버전 갈등을 완벽히 해결합니다.\n\n다음은 `@modelcontextprotocol/server` 패키지를 사용하여 Zod 스키마로 도구를 등록하는 예시입니다.\n\n```typescript\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-service\",\n version: \"1.0.0\"\n});\n\nserver.registerTool(\n \"get_weather\",\n {\n description: \"특정 도시의 현재 날씨를 조회합니다.\",\n inputSchema: z.object({\n city: z.string().describe(\"날씨를 조회할 도시 이름 (예: 서울, 부산)\")\n })\n },\n async ({ city }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 날씨는 맑음입니다.` }]\n };\n }\n);\n```\n\n이 방식을 활용하면 호출 시점에 클라이언트가 보낸 요청 본문이 정의한 스키마에 맞춰 자동으로 검증됩니다. 개발자는 복잡한 수동 파싱 과정 없이 핸들러 내부에서 정적 타입이 보장된 입력 인자를 즉시 사용할 수 있어 런타임 안정성과 개발 경험이 대폭 향상됩니다.\n\n## 분산 환경에서 실현되는 보안 도구 인프라\n\n무상태 HTTP 설계와 OAuth 2.1 표준 보안 체계를 결합한 MCP v2.0은 AI 에이전트 연동을 단순한 프로토타입 수준에서 진정한 엔터프라이즈급 마이크로서비스 아키텍처로 끌어올립니다.\n\n이제 개발자들은 클라이언트에 결합한 무거운 연동 로직 대신, 독립적으로 스케일 아웃이 가능하고 보안이 검증된 분산형 MCP 도구 네트워크를 구축할 수 있습니다. Vercel AI SDK나 LangChain 같은 주요 에이전트 프레임워크가 이를 빠르게 흡수하고 있는 만큼, 무상태 API 기반의 도구 생태계 구축은 실전 프로덕션 도입을 위한 필수 선택지가 될 것입니다.\n\n---\n\n**참고 링크**\n\n- [modelcontextprotocol/typescript-sdk Issues — McpServer registerTool API and Standard Schema Support](https://github.com/modelcontextprotocol/typescript-sdk/issues/2505)\n- [modelcontextprotocol/typescript-sdk GitHub — Model Context Protocol TypeScript SDK v2.0.0 Released](https://github.com/modelcontextprotocol/typescript-sdk)\n- [Model Context Protocol SEPs — SEP-985: Align OAuth 2.0 Protected Resource Metadata with RFC 9728](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/seps/0985-oauth-prm.md)","04dc3992ce3597146d9b0afe7185d6bf84635476164726cdce667c9604946c4e",53,"2026-07-29T06:09:19.230Z","2026-07-29T23:04:20.442Z",[],[],{"_950":3097,"_2416":3098,"_2418":2803,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":8945,"_1889":8948,"_2455":-5,"_2456":-5,"_2457":-5,"_9":3111,"_2450":3119,"_2458":3120,"_2460":-5,"_723":8952,"_1886":8953,"_332":8954,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":2142,"_2477":8955,"_2003":8956,"_2480":8957,"_2482":8958,"_2483":8959,"_2485":-5,"_2486":-5,"_2487":8960,"_1144":8970,"_2527":8983,"_2555":-5,"_2556":8990,"_2798":9267,"_266":9268},{"_1801":1802,"_214":3100,"_2429":8946,"_2434":8947,"_2438":2439},{"_1892":3102,"_1893":1997,"_1802":3103,"_2433":1997},{"_1892":3105,"_1893":1997,"_1802":3106,"_2433":1997},{"_9":8949,"_2445":8950,"_2450":8951},{"_1892":3109,"_1893":3110,"_1802":3111},{"_1892":3113,"_1893":3114,"_1802":3115},{"_1892":3117,"_1893":3118,"_1802":3119},[3122],[3124,3125,3126,3127,3128,3129],[],"2026-07-29T02:23:58.428Z","2026-07-28T09:28:36.566Z","2026-07-29T08:59:25.598Z","2026-07-29T08:57:39.528Z","2026-07-29T08:59:25.573Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":8961},{"_1901":8962},{"_1903":8963,"_1908":1909,"_1910":8964,"_1921":8965,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":8966,"_1928":8967,"_1933":8968,"_1938":8969},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":8971,"_1883":1884,"_1200":1204,"_1899":8974},{"_633":8972,"_11":8973},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":8975},{"_1903":8976,"_1908":1909,"_1910":8977,"_1921":8978,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":8979,"_1928":8980,"_1933":8981,"_1938":8982},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":8984},{"_1948":-5,"_1908":1909,"_1910":8985,"_1960":-5,"_1943":3182,"_1962":8986},{"_1912":3177,"_1914":3178,"_1952":3179,"_1810":2534,"_944":1992,"_1917":3180,"_1957":2536,"_1919":3181},{"_1964":8987,"_1972":8988,"_1979":8989,"_1986":-5},{"_1912":3185,"_1914":3186,"_1952":3187,"_1810":1969,"_944":2544,"_1957":1971},{"_1912":3189,"_1914":3190,"_1952":3191,"_1810":1977,"_944":2549,"_1957":1971},{"_1912":3193,"_1914":3194,"_1952":3195,"_1810":1984,"_944":2554,"_1957":1971},{"_950":3197,"_2559":3097,"_2560":8991,"_2716":9208,"_2788":3638,"_2790":3639,"_2792":3640,"_2794":1997,"_2003":9265,"_2480":9266,"_2797":-5},{"_918":8992,"_1908":1909},[8993,8995,8998,9002,9005,9009,9012,9016,9019,9023,9026,9030,9033,9037,9040,9044,9047,9051,9054,9058,9061,9065,9068,9072,9075,9079,9082,9086,9089,9093,9096,9097,9100,9107,9110,9114,9117,9121,9124,9134,9137,9141,9144,9145,9148,9152,9155,9159,9162,9166,9169,9173,9176,9177,9180,9185,9188,9205],{"_950":3201,"_2565":3111,"_2420":2566,"_3202":591,"_3203":8994,"_2567":3120},{"_3205":591},{"_950":3207,"_2420":2570,"_3203":8996,"_2571":8997},{"_3205":591},[],{"_950":3211,"_2420":2575,"_2576":1909,"_3203":8999,"_2571":9000},{"_3205":591},[9001],{"_2579":3111,"_2420":2579},{"_950":3216,"_2420":2570,"_3203":9003,"_2571":9004},{"_3205":591},[],{"_950":3220,"_2420":2570,"_3203":9006,"_2571":9007},{"_3205":591},[9008],{"_2579":3224,"_2420":2579},{"_950":3226,"_2420":2570,"_3203":9010,"_2571":9011},{"_3205":591},[],{"_950":3230,"_2420":2575,"_2576":2007,"_3203":9013,"_2571":9014},{"_3205":591},[9015],{"_2579":3234,"_2420":2579},{"_950":3236,"_2420":2570,"_3203":9017,"_2571":9018},{"_3205":591},[],{"_950":3240,"_2420":2570,"_3203":9020,"_2571":9021},{"_3205":591},[9022],{"_2579":3244,"_2420":2579},{"_950":3246,"_2420":2570,"_3203":9024,"_2571":9025},{"_3205":591},[],{"_950":3250,"_2420":2570,"_3203":9027,"_2571":9028},{"_3205":591},[9029],{"_2579":3254,"_2420":2579},{"_950":3256,"_2420":2570,"_3203":9031,"_2571":9032},{"_3205":591},[],{"_950":3260,"_2420":2570,"_3203":9034,"_2571":9035},{"_3205":591},[9036],{"_2579":3264,"_2420":2579},{"_950":3266,"_2420":2570,"_3203":9038,"_2571":9039},{"_3205":591},[],{"_950":3270,"_2420":2575,"_2576":2007,"_3203":9041,"_2571":9042},{"_3205":591},[9043],{"_2579":3274,"_2420":2579},{"_950":3276,"_2420":2570,"_3203":9045,"_2571":9046},{"_3205":591},[],{"_950":3280,"_2420":2570,"_3203":9048,"_2571":9049},{"_3205":591},[9050],{"_2579":3284,"_2420":2579},{"_950":3286,"_2420":2570,"_3203":9052,"_2571":9053},{"_3205":591},[],{"_950":3290,"_2420":2570,"_3203":9055,"_2571":9056},{"_3205":591},[9057],{"_2579":3294,"_2420":2579},{"_950":3296,"_2420":2570,"_3203":9059,"_2571":9060},{"_3205":591},[],{"_950":3300,"_2420":2570,"_3203":9062,"_2571":9063},{"_3205":591},[9064],{"_2579":3304,"_2420":2579},{"_950":3306,"_2420":2570,"_3203":9066,"_2571":9067},{"_3205":591},[],{"_950":3310,"_2420":2575,"_2576":2007,"_3203":9069,"_2571":9070},{"_3205":591},[9071],{"_2579":3314,"_2420":2579},{"_950":3316,"_2420":2570,"_3203":9073,"_2571":9074},{"_3205":591},[],{"_950":3320,"_2420":2570,"_3203":9076,"_2571":9077},{"_3205":591},[9078],{"_2579":3324,"_2420":2579},{"_950":3326,"_2420":2570,"_3203":9080,"_2571":9081},{"_3205":591},[],{"_950":3330,"_2420":2570,"_3203":9083,"_2571":9084},{"_3205":591},[9085],{"_2579":3334,"_2420":2579},{"_950":3336,"_2420":2570,"_3203":9087,"_2571":9088},{"_3205":591},[],{"_950":3340,"_2420":2570,"_3203":9090,"_2571":9091},{"_3205":591},[9092],{"_2579":3344,"_2420":2579},{"_950":3346,"_2420":2570,"_3203":9094,"_2571":9095},{"_3205":591},[],{"_950":3350,"_3351":3352,"_2420":3351,"_625":3125},{"_950":3354,"_2420":2570,"_3203":9098,"_2571":9099},{"_3205":591},[],{"_950":3358,"_2420":2570,"_3203":9101,"_2571":9102},{"_3205":591},[9103,9104,9106],{"_2579":3362,"_2420":2579},{"_2579":3364,"_2420":2579,"_3365":9105},{"_3351":3367},{"_2579":3369,"_2420":2579},{"_950":3371,"_2420":2570,"_3203":9108,"_2571":9109},{"_3205":591},[],{"_950":3375,"_2420":2575,"_2576":2007,"_3203":9111,"_2571":9112},{"_3205":591},[9113],{"_2579":3379,"_2420":2579},{"_950":3381,"_2420":2570,"_3203":9115,"_2571":9116},{"_3205":591},[],{"_950":3385,"_2420":2570,"_3203":9118,"_2571":9119},{"_3205":591},[9120],{"_2579":3389,"_2420":2579},{"_950":3391,"_2420":2570,"_3203":9122,"_2571":9123},{"_3205":591},[],{"_950":3395,"_2420":2570,"_3203":9125,"_2571":9126},{"_3205":591},[9127,9128,9130,9131,9133],{"_2579":3399,"_2420":2579},{"_2579":3401,"_2420":2579,"_3365":9129},{"_3351":3367},{"_2579":3404,"_2420":2579},{"_2579":3406,"_2420":2579,"_3365":9132},{"_3351":3367},{"_2579":3409,"_2420":2579},{"_950":3411,"_2420":2570,"_3203":9135,"_2571":9136},{"_3205":591},[],{"_950":3415,"_2420":2570,"_3203":9138,"_2571":9139},{"_3205":591},[9140],{"_2579":3419,"_2420":2579},{"_950":3421,"_2420":2570,"_3203":9142,"_2571":9143},{"_3205":591},[],{"_950":3425,"_3351":3426,"_2420":3351,"_625":3125},{"_950":3428,"_2420":2570,"_3203":9146,"_2571":9147},{"_3205":591},[],{"_950":3432,"_2420":2570,"_3203":9149,"_2571":9150},{"_3205":591},[9151],{"_2579":3436,"_2420":2579},{"_950":3438,"_2420":2570,"_3203":9153,"_2571":9154},{"_3205":591},[],{"_950":3442,"_2420":2575,"_2576":2007,"_3203":9156,"_2571":9157},{"_3205":591},[9158],{"_2579":3446,"_2420":2579},{"_950":3448,"_2420":2570,"_3203":9160,"_2571":9161},{"_3205":591},[],{"_950":3452,"_2420":2570,"_3203":9163,"_2571":9164},{"_3205":591},[9165],{"_2579":3456,"_2420":2579},{"_950":3458,"_2420":2570,"_3203":9167,"_2571":9168},{"_3205":591},[],{"_950":3462,"_2420":2570,"_3203":9170,"_2571":9171},{"_3205":591},[9172],{"_2579":3466,"_2420":2579},{"_950":3468,"_2420":2570,"_3203":9174,"_2571":9175},{"_3205":591},[],{"_950":3472,"_2420":3473},{"_950":3475,"_2420":2570,"_3203":9178,"_2571":9179},{"_3205":591},[],{"_950":3479,"_2420":2570,"_3203":9181,"_2571":9182},{"_3205":591},[9183],{"_2579":3483,"_2420":2579,"_3365":9184},{"_3485":3367},{"_950":3487,"_2420":2570,"_3203":9186,"_2571":9187},{"_3205":591},[],{"_950":3491,"_1881":3492,"_2420":3493,"_778":9189},[9190,9195,9200],{"_950":3496,"_2571":9191},[9192],{"_3499":3500,"_2420":3501,"_3502":9193},[9194],{"_2579":3505,"_2420":2579},{"_950":3507,"_2571":9196},[9197],{"_3499":3510,"_2420":3501,"_3502":9198},[9199],{"_2579":3513,"_2420":2579},{"_950":3515,"_2571":9201},[9202],{"_3499":3518,"_2420":3501,"_3502":9203},[9204],{"_2579":3521,"_2420":2579},{"_950":3523,"_2420":2570,"_3203":9206,"_2571":9207},{"_3205":591},[],{"_3462":9209,"_3415":9211,"_3320":9213,"_3432":9215,"_3270":9217,"_3300":9219,"_3250":9221,"_3280":9223,"_3385":9225,"_3240":9227,"_3260":9229,"_3491":9231,"_3340":9235,"_3211":9237,"_3358":9239,"_3220":9241,"_3330":9243,"_3230":9245,"_3479":9247,"_3605":9249,"_3442":9253,"_3290":9255,"_3395":9257,"_3310":9259,"_3375":9261,"_3452":9263},{"_2571":9210},{"_1892":3529,"_1893":3530,"_1802":3466},{"_2571":9212},{"_1892":3533,"_1893":3534,"_1802":3419},{"_2571":9214},{"_1892":3537,"_1893":3538,"_1802":3324},{"_2571":9216},{"_1892":3541,"_1893":3542,"_1802":3436},{"_2571":9218},{"_1892":3545,"_1893":3546,"_1802":3274},{"_2571":9220},{"_1892":3549,"_1893":3550,"_1802":3304},{"_2571":9222},{"_1892":3553,"_1893":3554,"_1802":3254},{"_2571":9224},{"_1892":3557,"_1893":3558,"_1802":3284},{"_2571":9226},{"_1892":3561,"_1893":3562,"_1802":3389},{"_2571":9228},{"_1892":3565,"_1893":3566,"_1802":3244},{"_2571":9230},{"_1892":3569,"_1893":3570,"_1802":3264},{"_3572":9232,"_3574":9233,"_3576":9234},{"_1892":3505,"_1893":3505,"_1802":3505},{"_1892":3521,"_1893":3521,"_1802":3521},{"_1892":3513,"_1893":3513,"_1802":3513},{"_2571":9236},{"_1892":3580,"_1893":3581,"_1802":3344},{"_2571":9238},{"_1892":3109,"_1893":3110,"_1802":3111},{"_2571":9240},{"_1892":3586,"_1893":3587,"_1802":3588},{"_2571":9242},{"_1892":3591,"_1893":3592,"_1802":3224},{"_2571":9244},{"_1892":3595,"_1893":3596,"_1802":3334},{"_2571":9246},{"_1892":3599,"_1893":3600,"_1802":3234},{"_2571":9248},{"_1892":3603,"_1893":3604,"_1802":3483},{"_3572":9250,"_3574":9251,"_3576":9252},{"_1892":3505,"_1893":3608,"_1802":3505},{"_1892":3521,"_1893":3610,"_1802":3521},{"_1892":3513,"_1893":3612,"_1802":3513},{"_2571":9254},{"_1892":3615,"_1893":3616,"_1802":3446},{"_2571":9256},{"_1892":3619,"_1893":3620,"_1802":3294},{"_2571":9258},{"_1892":3623,"_1893":3624,"_1802":3625},{"_2571":9260},{"_1892":3628,"_1893":3629,"_1802":3314},{"_2571":9262},{"_1892":3632,"_1893":3633,"_1802":3379},{"_2571":9264},{"_1892":3636,"_1893":3637,"_1802":3456},"2026-07-28T09:28:36.570Z","2026-07-29T08:59:25.602Z",[],[9269],{"_2802":2809,"_1881":2804},{"_950":5022,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":9271,"_1889":9274,"_2455":-5,"_2456":-5,"_2457":-5,"_9":5035,"_2450":5043,"_2458":5044,"_2460":-5,"_723":9278,"_1886":9279,"_332":9280,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1909,"_2477":9281,"_2003":9282,"_2480":9283,"_2482":-5,"_2483":9284,"_2485":-5,"_2486":-5,"_2487":9285,"_1144":9295,"_2527":9308,"_2555":-5,"_2556":9315,"_2798":9492,"_266":9493},{"_1801":1802,"_214":5024,"_2429":9272,"_2434":9273,"_2438":2439},{"_1892":5026,"_1893":1997,"_1802":5027,"_2433":1997},{"_1892":5029,"_1893":1997,"_1802":5030,"_2433":1997},{"_9":9275,"_2445":9276,"_2450":9277},{"_1892":5033,"_1893":5034,"_1802":5035},{"_1892":5037,"_1893":5038,"_1802":5039},{"_1892":5041,"_1893":5042,"_1802":5043},[5046],[4943,3792,5048,5049,5050,5051],[],"2026-07-28T07:29:16.433Z","2026-07-27T16:15:16.215Z","2026-07-28T14:26:35.789Z","2026-07-28T07:31:25.323Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":9286},{"_1901":9287},{"_1903":9288,"_1908":1909,"_1910":9289,"_1921":9290,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":9291,"_1928":9292,"_1933":9293,"_1938":9294},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":9296,"_1883":1884,"_1200":1204,"_1899":9299},{"_633":9297,"_11":9298},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":9300},{"_1903":9301,"_1908":1909,"_1910":9302,"_1921":9303,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":9304,"_1928":9305,"_1933":9306,"_1938":9307},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":9309},{"_1948":-5,"_1908":1909,"_1910":9310,"_1960":-5,"_1943":5088,"_1962":9311},{"_1912":5083,"_1914":5084,"_1952":5085,"_1810":2534,"_944":1992,"_1917":5086,"_1957":2536,"_1919":5087},{"_1964":9312,"_1972":9313,"_1979":9314,"_1986":-5},{"_1912":5091,"_1914":5092,"_1952":5093,"_1810":1969,"_944":2544,"_1957":1971},{"_1912":5095,"_1914":5096,"_1952":5097,"_1810":1977,"_944":2549,"_1957":1971},{"_1912":5099,"_1914":5100,"_1952":5101,"_1810":1984,"_944":2554,"_1957":1971},{"_950":5103,"_2559":5022,"_2560":9316,"_2716":9451,"_2788":5395,"_2790":5396,"_2792":5397,"_2794":1997,"_2003":9490,"_2480":9491,"_2797":-5},{"_918":9317,"_1908":1909},[9318,9319,9321,9324,9326,9329,9331,9334,9336,9345,9347,9356,9358,9359,9361,9370,9372,9375,9377,9380,9382,9385,9387,9388,9390,9393,9395,9398,9400,9403,9405,9408,9410,9413,9415,9418,9420,9423,9425,9426,9428,9432,9434],{"_950":5107,"_2565":5035,"_2420":2566,"_2567":5044},{"_950":5109,"_2420":2570,"_2571":9320},[],{"_950":5112,"_2420":2575,"_2576":1909,"_2571":9322},[9323],{"_2579":5035,"_2420":2579},{"_950":5116,"_2420":2570,"_2571":9325},[],{"_950":5119,"_2420":2570,"_2571":9327},[9328],{"_2579":5122,"_2420":2579},{"_950":5124,"_2420":2570,"_2571":9330},[],{"_950":5127,"_2420":2575,"_2576":2007,"_2571":9332},[9333],{"_2579":5130,"_2420":2579},{"_950":5132,"_2420":2570,"_2571":9335},[],{"_950":5135,"_2420":2570,"_2571":9337},[9338,9339,9341,9342,9344],{"_2579":5138,"_2420":2579},{"_2579":5140,"_2420":2579,"_3365":9340},{"_3351":3367},{"_2579":5143,"_2420":2579},{"_2579":5145,"_2420":2579,"_3365":9343},{"_3351":3367},{"_2579":5148,"_2420":2579},{"_950":5150,"_2420":2570,"_2571":9346},[],{"_950":5153,"_2420":2570,"_2571":9348},[9349,9350,9352,9353,9355],{"_2579":5156,"_2420":2579},{"_2579":5158,"_2420":2579,"_3365":9351},{"_3351":3367},{"_2579":5161,"_2420":2579},{"_2579":5163,"_2420":2579,"_3365":9354},{"_3351":3367},{"_2579":5166,"_2420":2579},{"_950":5168,"_2420":2570,"_2571":9357},[],{"_950":5171,"_3351":5172,"_2420":3351,"_625":4704},{"_950":5174,"_2420":2570,"_2571":9360},[],{"_950":5177,"_2420":2570,"_2571":9362},[9363,9364,9366,9367,9369],{"_2579":5180,"_2420":2579},{"_2579":5182,"_2420":2579,"_3365":9365},{"_3351":3367},{"_2579":5185,"_2420":2579},{"_2579":5187,"_2420":2579,"_3365":9368},{"_3351":3367},{"_2579":5190,"_2420":2579},{"_950":5192,"_2420":2570,"_2571":9371},[],{"_950":5195,"_2420":2575,"_2576":2007,"_2571":9373},[9374],{"_2579":5198,"_2420":2579},{"_950":5200,"_2420":2570,"_2571":9376},[],{"_950":5203,"_2420":2570,"_2571":9378},[9379],{"_2579":5206,"_2420":2579},{"_950":5208,"_2420":2570,"_2571":9381},[],{"_950":5211,"_2420":2570,"_2571":9383},[9384],{"_2579":5214,"_2420":2579},{"_950":5216,"_2420":2570,"_2571":9386},[],{"_950":5219,"_3351":5220,"_2420":3351,"_625":3125},{"_950":5222,"_2420":2570,"_2571":9389},[],{"_950":5225,"_2420":2570,"_2571":9391},[9392],{"_2579":5228,"_2420":2579},{"_950":5230,"_2420":2570,"_2571":9394},[],{"_950":5233,"_2420":2575,"_2576":2007,"_2571":9396},[9397],{"_2579":5236,"_2420":2579},{"_950":5238,"_2420":2570,"_2571":9399},[],{"_950":5241,"_2420":2570,"_2571":9401},[9402],{"_2579":5244,"_2420":2579},{"_950":5246,"_2420":2570,"_2571":9404},[],{"_950":5249,"_2420":2570,"_2571":9406},[9407],{"_2579":5252,"_2420":2579},{"_950":5254,"_2420":2570,"_2571":9409},[],{"_950":5257,"_2420":2570,"_2571":9411},[9412],{"_2579":5260,"_2420":2579},{"_950":5262,"_2420":2570,"_2571":9414},[],{"_950":5265,"_2420":2575,"_2576":2007,"_2571":9416},[9417],{"_2579":5268,"_2420":2579},{"_950":5270,"_2420":2570,"_2571":9419},[],{"_950":5273,"_2420":2570,"_2571":9421},[9422],{"_2579":5276,"_2420":2579},{"_950":5278,"_2420":2570,"_2571":9424},[],{"_950":5281,"_2420":3473},{"_950":5283,"_2420":2570,"_2571":9427},[],{"_950":5286,"_2420":2570,"_2571":9429},[9430],{"_2579":3483,"_2420":2579,"_3365":9431},{"_3485":3367},{"_950":5291,"_2420":2570,"_2571":9433},[],{"_950":5294,"_1881":3492,"_2420":3493,"_778":9435},[9436,9441,9446],{"_950":5297,"_2571":9437},[9438],{"_3499":5300,"_2420":3501,"_3502":9439},[9440],{"_2579":5303,"_2420":2579},{"_950":5305,"_2571":9442},[9443],{"_3499":5308,"_2420":3501,"_3502":9444},[9445],{"_2579":5311,"_2420":2579},{"_950":5313,"_2571":9447},[9448],{"_3499":5316,"_2420":3501,"_3502":9449},[9450],{"_2579":5319,"_2420":2579},{"_5265":9452,"_5153":9454,"_5286":9456,"_5211":9458,"_5249":9460,"_5225":9462,"_5273":9464,"_5119":9466,"_5241":9468,"_5135":9470,"_5127":9472,"_5257":9474,"_5112":9476,"_5177":9478,"_5233":9480,"_5294":9482,"_5203":9486,"_5195":9488},{"_2571":9453},{"_1892":5323,"_1893":5324,"_1802":5268},{"_2571":9455},{"_1892":5327,"_1893":5328,"_1802":5329},{"_2571":9457},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":9459},{"_1892":5334,"_1893":5335,"_1802":5214},{"_2571":9461},{"_1892":5338,"_1893":5339,"_1802":5252},{"_2571":9463},{"_1892":5342,"_1893":5343,"_1802":5228},{"_2571":9465},{"_1892":5346,"_1893":5347,"_1802":5276},{"_2571":9467},{"_1892":5350,"_1893":5351,"_1802":5122},{"_2571":9469},{"_1892":5354,"_1893":5355,"_1802":5244},{"_2571":9471},{"_1892":5358,"_1893":5359,"_1802":5360},{"_2571":9473},{"_1892":5363,"_1893":5364,"_1802":5130},{"_2571":9475},{"_1892":5367,"_1893":5368,"_1802":5260},{"_2571":9477},{"_1892":5033,"_1893":5034,"_1802":5035},{"_2571":9479},{"_1892":5373,"_1893":5374,"_1802":5375},{"_2571":9481},{"_1892":5378,"_1893":5379,"_1802":5236},{"_5381":9483,"_5383":9484,"_5385":9485},{"_1892":5311,"_1893":5311,"_1802":5311},{"_1892":5303,"_1893":5303,"_1802":5303},{"_1892":5319,"_1893":5319,"_1802":5319},{"_2571":9487},{"_1892":5389,"_1893":5390,"_1802":5206},{"_2571":9489},{"_1892":5393,"_1893":5394,"_1802":5198},"2026-07-27T16:15:16.219Z","2026-07-28T07:31:25.345Z",[],[9494],{"_2802":2806,"_1881":4759},{"_950":9496,"_2416":6709,"_2418":2803,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":9497,"_1889":9505,"_2455":-5,"_2456":-5,"_2457":-5,"_9":9509,"_2450":9517,"_2458":9518,"_2460":-5,"_723":9519,"_1886":9521,"_332":9525,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":9526,"_2003":9527,"_2480":9528,"_2482":9529,"_2483":9530,"_2485":-5,"_2486":-5,"_2487":9531,"_1144":9541,"_2527":9554,"_2555":-5,"_2556":9576,"_2798":10238,"_266":10239},"cms0fzzfm00fe10pb04exf1c6",{"_1801":1802,"_214":9498,"_2429":9499,"_2434":9502,"_2438":2439},4437,{"_1892":9500,"_1893":1997,"_1802":9501,"_2433":1997},1245,3192,{"_1892":9503,"_1893":1997,"_1802":9504,"_2433":1997},0.2805949966193374,0.7194050033806626,{"_9":9506,"_2445":9510,"_2450":9514},{"_1892":9507,"_1893":9508,"_1802":9509},"Reth v2.4.0 and the Evolution of L2: From Native AA to Regulatory Filtering","Reth v2.4.0とL2の進化 — ネイティブAAから規制フィルタリングまで","Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지",{"_1892":9511,"_1893":9512,"_1802":9513},"Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지\n\nReth v2.4.0 and the Evolution of L2: From Native AA to Regulatory Filtering\n\nThe competitive landscape of the Ethereum Layer 2 ecosystem is evolving from simple transaction speed optimization toward directly solving for developer experience and enterprise-grade architecture. In this article, we strip away the marketing narratives and analyze the technical breakthroughs presented by each platform—from Paradigm's Reth v2.4.0 execution client release; Base Cobalt’s implementation of native account abstraction that eliminates the need for bundlers; Arbitrum Elara’s introduction of 96KB WebAssembly smart contracts and regulatory filtering; to the GIWA Chain, which features built-in identity verification and privacy layers tailored for domestic institutional finance standards. We examine the core mechanisms of these Layer 2 architectures and the technical criteria essential for production deployment from the perspective of actual builders.\n\nBase Cobalt and EIP-8130: Native AA Without Bundlers\n\nThe Cobalt hard fork, scheduled for September 2026 on Base, is set to fundamentally overhaul how smart contract wallets operate. The core of this change lies in the direct integration of EIP-8130 native Account Abstraction (AA) into the Reth V2 execution client. The existing ERC-4337 standard relies on a complex structure where off-chain bundlers aggregate user requests, forward them to an EntryPoint contract, and trigger EVM loops for verification. This inherently leads to significant gas fee overhead and transaction latency.\n\nThe Cobalt architecture, based on EIP-8130, resolves these complex verification steps at the protocol layer. When a user submits the new Type 0x79 transaction, the execution engine—powered by the revmc JIT compiler embedded in Reth v2.4.0—intercepts and verifies the transaction during the node consensus phase. By bypassing heavy EVM execution and referencing the on-chain system contract AccountConfiguration directly at the client-native layer, verification gas costs for smart accounts are reduced to the 21,000 gas level, matching standard Externally Owned Accounts (EOAs).\n\nIn an EIP-8130 environment, smart accounts control their interactions by registering signing actors and their corresponding Authenticator units in system contracts. Below is a sample Solidity snippet (based on Solidity v0.8.20) for an environment compliant with EIP-8130, which queries the AccountConfiguration system contract to verify if a specific authenticator meets the network's official specifications.\n\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n\ninterface IAccountConfiguration {\n function isCanonicalAuthenticator(address authenticator) external view returns (bool);\n}\n\ncontract AccountVerifier {\n address public constant ACCOUNT_CONFIG = 0x0000000000000000000000000000000000008130;\n\n function checkCompliance(address authenticator) external view returns (bool) {\n return IAccountConfiguration(ACCOUNT_CONFIG).isCanonicalAuthenticator(authenticator);\n } \n}\n\nThis new native account abstraction flow not only slashes gas costs by over 60% but also eliminates the maintenance burden for developers who previously had to operate off-chain bundler or relayer infrastructure. You can immediately begin prototyping this high-performance native AA environment on Base Vibenet (chain ID 84538453), the testnet currently provided by Base.\n\nArbitrum ArbOS 61 Elara: 96KB Stylus and the Introduction of Regulatory Filtering\n\nThe ArbOS 61 Elara upgrade for Arbitrum is a major turning point for both developers writing high-performance Rust smart contracts and builders constructing enterprise app-chains. This upgrade requires Nitro v3.11.0 and significantly increases the size limit for WebAssembly (WASM)-based Stylus contracts, while introducing compliance tools for transaction control at the protocol level.\n\nDevelopers should pay particular attention to the difference in contract size limits compared to existing virtual machines.\n\nEVM Bytecode Limit (24KB): The standard Ethereum Virtual Machine strictly limits smart contract bytecode size to 24KB according to EIP-170. This creates architectural debt, forcing developers to split contracts and rely on complex delegate calls to accommodate large business logic or sophisticated cryptographic algorithms.\nStylus WASM Size Limit (96KB): With the Elara upgrade, the Stylus contract size limit has been increased to 96KB. Binaries produced by the Rust compiler tend to be larger than EVM bytecode. With this restriction eased, developers can freely import external crates and focus on logic implementation and cryptographic computations rather than size optimization.\n\nIn addition, Elara introduces an optional regulatory filtering technology. This feature filters specific addresses at both the sequencer level—where transactions are collected—and the State Transition Function (STF) layer, which finalizes the network state. Because compliance requirements can be handled at the sequencer and protocol engine level, builders no longer need to redundantly write complex address-blocking code within contract logic, offering an attractive architectural choice for designing institutional finance app-chains.\n\nGIWA Chain: Enterprise Identity and Privacy via Dojang and Bojagi\n\nThe GIWA Chain, led by Dunamu, is a Layer 2 network that adopts the Self-Managed tier of Optimism Enterprise. To balance the openness of the public ecosystem with financial institution-grade regulatory compliance, it integrates Dojang (the on-chain identity layer) and Bojagi (a privacy-specific protocol) into its core architecture. By implementing 1-second block times and low gas fees under 1 KRW, it seamlessly connects institutional finance with high-performance dApps.\n\nThe practical tool developers should focus on for the GIWA Sepolia testnet is the Dojang ecosystem, which is based on the Ethereum Attestation Service (EAS) protocol. Dojang issues on-chain attestations that confirm only whether a wallet address has completed KYC, without exposing personal information. Developers do not need to build complex off-chain authentication systems; they can verify a wallet's authentication status instantly via pre-deployed on-chain contracts.\n\nThe key Dojang contracts deployed in the GIWA Sepolia environment and their essential Schema UID information are as follows.\n\nGIWA Sepolia Dojang Contracts\nEAS Core engine for attestation issuance and verification 0x4200000000000000000000000000000000000021\nSchemaRegistry Registration and lookup for attestation formats 0x4200000000000000000000000000000000000020\nDojangScroll Integrated lookup tool for on-chain attestation data 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9\n\nKey Dojang Schema Specifications\nVerified Address\n데이터 규격: bool isVerified\n스키마 식별자: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\nVerified Balance\n데이터 규격: uint256 balance, bytes32 salt, bytes32[] proofs\n스키마 식별자: 0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9\n\nIn contrast, the Bojagi protocol, aimed at large-scale fund settlement between financial institutions, is a Zero-Knowledge Proof (ZKP)-based privacy engine that operates as a completely closed system. It satisfies bank secrecy regulations by fully concealing transaction amounts and the identities of senders and receivers on-chain. Bojagi has already been successfully applied in a Proof of Concept (PoC) for overseas remittances based on deposit tokens with Hana Financial Group, demonstrating its technical feasibility as a replacement for existing SWIFT networks. The dual-track operation of the open Dojang protocol for developers and the Bojagi protocol for financial institutions forms the unique trust architecture of the GIWA Chain.\n\nThree Common Pitfalls in L2 Development and Mitigation Strategies\n\nRegardless of the technical maturity of the Ethereum Layer 2 ecosystem, builders preparing for mainnet production must consider the unique nature of off-chain execution models. Relying solely on EVM compatibility without due diligence can lead to significant bottlenecks or security vulnerabilities at the architectural level. To build stable services, consider these three core risks that must be validated in advance:\n\nFirst, the discrepancy between immediate sequencer approval and L1 finality. The immediate response provided by an L2 sequencer upon receiving a transaction is merely a 'soft confirmation.' There is a significant time gap until data is bundled and submitted to the Ethereum mainnet for final settlement. For services where high-value asset transfers or definitive approvals are critical, do not treat transactions as complete immediately upon sequencer approval. Instead, implement exception-handling business logic that tracks the L1 state settlement phase.\n\nSecond, liquidity constraints and latency in bridge architecture. Optimistic Rollup networks enforce a 7-day challenge period when moving funds back to L1. Even if you rely on third-party bridge protocols that support fast withdrawals, you must account for the risk of liquidity pools being temporarily exhausted during large fund movements. When designing your service, establish technical alternatives to manage user experience during withdrawal wait times and volatility in bridge fees.\n\nThird, the sequencer single point of failure and upgrade key security. For initial activation, most L2 chains utilize centralized off-chain sequencers and grant contract upgrade authority to multi-sig keys. Before production, you must transparently identify and verify whether there is an 'emergency escape' function that allows for forced transaction submission directly to L1 if the sequencer goes offline, and ensure the ownership structure of the multi-sig keys controlling core bridge contracts is sufficiently trustworthy.\n\nDecision-Making Framework for Production Deployment\n\nThe criteria for choosing an Ethereum Layer 2 have shifted from mere gas fee reduction to architectural optimization that aligns with unique application requirements. If maximizing gas fee sponsorship and smooth user experience is the priority, Base Cobalt—which supports Reth V2-based native account abstraction—is the right fit. If high-performance computation based on Rust and protocol-level regulatory filtering are required, Arbitrum Elara is a clear alternative. Meanwhile, if you need integration with domestic institutional finance or a reliable on-chain identity authentication system, you should actively validate the Dojang ecosystem of the GIWA Chain. By clearly understanding the technical strengths offered by each execution client and selecting a network customized to your product specifications, you can effectively control architectural risks at the production stage.\n\nReference Links\n\nBase Engineering — Base Cobalt and EIP-8130 Native Account Abstraction Technical Architecture\nBase Engineering — Base Cobalt Native Account Abstraction (EIP-8130 / EIP-8140)","Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지\n\nReth v2.4.0とL2の進化 — ネイティブAAから規制フィルタリングまで\n\nイーサリアムレイヤー2（L2）エコシステムの競争は、単なるトランザクション処理速度から、開発者体験とエンタープライズアーキテクチャの直接的な課題解決へと進化しています。本記事では、ParadigmのReth v2.4.0実行クライアントのリリースをはじめ、バンドラー不要のネイティブ・アカウント抽象化（AA）を実装するBase Cobalt、96KBのWebAssemblyスマートコントラクトと規制フィルタリングを導入したArbitrum Elara、そして国内の制度金融基準に合わせて本人確認（KYC）とプライバシーレイヤーを内蔵したGIWAチェーンまで、各プラットフォームが提示する技術的な突破口を分析します。マーケティングのナラティブを取り払い、実際のビルダーの視点から、各L2アーキテクチャの主要メカニズムと本番環境へのデプロイ時に必須となる技術選定基準を考察します。\n\nBase CobaltとEIP-8130 — バンドラーが消えるネイティブAA\n\nBaseが2026年9月に導入予定のCobaltハードフォークは、既存のスマートコントラクトウォレットの仕組みを根本から変えるでしょう。その核心は、Reth v2実行クライアントにEIP-8130ネイティブ・アカウント抽象化（AA）を直接統合することにあります。従来のERC-4337標準では、オフチェーンのバンドラーがユーザーの要求をまとめてEntryPointコントラクトに送信し、それをEVMループで検証するという複雑な構造でした。このため、ガスのオーバーヘッドやトランザクションの遅延が避けられませんでした。\n\nEIP-8130ベースのCobaltアーキテクチャは、この複雑な検証ステップをプロトコルレイヤーで直接解決します。ユーザーが新しい規格であるType 0x79トランザクションを送信すると、Reth v2.4.0に内蔵されたrevmc JITコンパイラベースの実行エンジンが、ノードの合意形成段階でトランザクションをインターセプトして検証します。負荷の高いEVM実行を回避し、クライアントのネイティブレイヤーでオンチェーンのシステムコントラクト「AccountConfiguration」を参照して即座に検証を行うため、スマートアカウントの検証ガス代はEOA（外部所有アカウント）と同じ21,000ガスまで削減されます。\n\nEIP-8130環境において、スマートアカウントは自身の署名を代行するアクターと、それを検証する認証機（Authenticator）をシステムコントラクトに登録して制御します。以下は、EIP-8130準拠環境でAccountConfigurationシステムコントラクトを参照し、特定の認証機がネットワークの公式規格であるかを検証するSolidity（v0.8.20基準）のサンプルコードです。\n\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n\ninterface IAccountConfiguration {\n function isCanonicalAuthenticator(address authenticator) external view returns (bool);\n}\n\ncontract AccountVerifier {\n address public constant ACCOUNT_CONFIG = 0x0000000000000000000000000000000000008130;\n\n function checkCompliance(address authenticator) external view returns (bool) {\n return IAccountConfiguration(ACCOUNT_CONFIG).isCanonicalAuthenticator(authenticator);\n } \n}\n\nこの新しいネイティブAAフローは、ガス代を60%以上劇的に削減するだけでなく、開発者がオフチェーンのバンドラーやリレイヤーインフラを運用しなければならない維持管理の負担を完全に解消します。現在、Baseが提供するテストネット「Base Vibenet」（チェーンID 84538453）にて、この高性能ネイティブAA環境をすぐにプロトタイプ作成可能です。\n\nArbitrum ArbOS 61 Elara — 96KB Stylusと規制フィルタリングの導入\n\nArbitrumのArbOS 61「Elara」アップグレードは、高性能なRustスマートコントラクトを書く開発者にとっても、エンタープライズAppChainを構築するビルダーにとっても重要な転換点です。今回のアップグレードはNitro v3.11.0を必要とし、WebAssembly（WASM）ベースのStylusコントラクトのサイズ制限を大幅に拡大すると同時に、プロトコルレベルでトランザクションを制御できるコンプライアンスツールを前面に打ち出しています。\n\n特に開発者が注目すべきは、従来の仮想マシンとのコントラクトサイズ制限の差です。\n\nEVMバイトコードの制限（24KB）：標準的なイーサリアム仮想マシンは、EIP-170規格によりスマートコントラクトのバイトコードサイズを最大24KBに厳しく制限しています。そのため、大規模なビジネスロジックや高度な暗号アルゴリズムを実装する場合、コントラクトを分割し、委任呼び出し（delegatecall）を複雑に組み合わせるというアーキテクチャ上の負債が発生します。\nStylus WASMのサイズ制限（96KB）：Elaraアップグレードにより、Stylusコントラクトのサイズ制限が96KBに拡大されました。Rustコンパイラが生成するバイナリはEVMバイトコードよりもサイズが大きくなりやすい傾向があります。この制限緩和により、開発者は外部クレートを自由に利用でき、サイズ最適化の代わりにロジックの実装や暗号学的演算そのものに集中できるようになりました。\n\nさらにElaraは、オプションとして規制フィルタリング技術を導入しました。この機能は、トランザクションを収集するシーケンサー段階と、ネットワークの状態を最終確定させる状態遷移関数（STF）レイヤーの両方で、特定の住所をフィルタリングします。コントラクト内のロジックに複雑なブロッキングコードを繰り返し書く必要がなく、シーケンサーとプロトコルエンジンレベルで規制要件を処理できるため、制度金融系AppChainを設計するビルダーにとって魅力的なアーキテクチャ上の選択肢となります。\n\nGIWAチェーン — DojangとBojagiで実現するエンタープライズID管理とプライバシー\n\nDunamuが主導するGIWAチェーンは、Optimismエンタープライズのセルフマネージド（Self-Managed）ティアを採用したL2ネットワークです。パブリックエコシステムの開放性と、金融機関レベルの規制遵守能力を両立させるため、オンチェーン認証レイヤー「Dojang（道場）」とプライバシー専用プロトコル「Bojagi（風呂敷）」を核心アーキテクチャに組み込みました。1秒のブロックタイムと1ウォン未満の低コストなガス代を実現し、制度金融と高性能DAppをシームレスに結びつけます。\n\n開発者がGIWA Sepoliaテストネットで注目すべき実用的なツールは、EAS（Ethereum Attestation Service）プロトコルベースのDojangエコシステムです。Dojangは、個人情報を露出することなく、ウォレットアドレスのKYC（顧客確認）完了の有無のみを証明するオンチェーンアテステーションを発行します。開発者は複雑なオフチェーン認証システムを一から構築する必要はなく、オンチェーン上にデプロイされたコントラクトを通じて、ウォレットの認証状態を即座に検証できます。\n\nGIWA Sepolia環境に搭載された主要なDojangコントラクトと、主要なスキーマ識別子（Schema UID）の設定情報は以下の通りです。\n\nGIWA Sepolia Dojangコントラクト\nEAS 証明書発行および検証の核心エンジン 0x4200000000000000000000000000000000000021\nSchemaRegistry 証明書フォームの登録と照会 0x4200000000000000000000000000000000000020\nDojangScroll オンチェーン証明データの統合照会ツール 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9\n\n主要なDojangスキーマ規格\nVerified Address（検証済みウォレット）\n데이터 규격: bool isVerified\n스키마 식별자: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\nVerified Balance（検証済み残高）\n데이터 규격: uint256 balance, bytes32 salt, bytes32[] proofs\n스키마 식별자: 0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9\n\n一方、金融機関間の大規模な資金決済を目的とするBojagiプロトコルは、Dojangとは異なり、完全に閉鎖的に運用されるゼロ知識証明（ZKP）ベースのプライバシーエンジンです。取引金額や送受信者の身元をオンチェーンで完全に隠蔽し、銀行秘密保持法規制を遵守します。実際、BojagiはHana Financial Groupとの預金トークンベースの海外送金における概念実証（PoC）に成功し、既存のSWIFTネットワークを代替できる技術的実現可能性を証明しました。開発者向けのDojangプロトコルと金融機関向けのBojagiプロトコルが両輪で稼働することで、GIWAチェーン独自の信頼アーキテクチャが形成されます。\n\nL2開発で陥りやすい3つの落とし穴と対応戦略\n\nイーサリアムL2エコシステムの技術的成熟度に関わらず、メインネットでの本番デプロイを準備するビルダーは、オフチェーン実行モデルの特殊性を考慮しなければなりません。単にEVM互換性を信じてスマートコントラクトをデプロイすると、システムアーキテクチャレベルで深刻なボトルネックやセキュリティの穴に直面しやすくなります。安定したサービスを構築するために、事前に必ず検証すべき3つの核心リスクは以下の通りです。\n\n第一に、シーケンサーによる即時承認とL1の最終確定（ファイナリティ）の不一致です。L2シーケンサーがトランザクションを受信して提供する即時の応答は、単なる「ソフトコンファーム（仮承認）」に過ぎません。データがイーサリアムメインネットにバッチとして送信され、合意が最終的に完了するまでにはかなりの時間差が存在します。高額送金や最終的な承認が重要なサービスの場合、シーケンサーの承認をもって直ちにトランザクションが完全に終了したとみなしてはならず、L1へのステータス反映段階を追跡する例外処理ビジネスロジックを実装する必要があります。\n\n第二に、ブリッジアーキテクチャの流動性の制約と遅延時間です。Optimistic Rollup系のネットワークでは、L1に資金を戻す際に7日間の紛争期間が強制されます。高速出金をサポートするサードパーティのブリッジプロトコルに依存する場合でも、大規模な資金移動時に流動性プールが一時的に枯渇するリスクを想定しておくべきです。サービス設計時には、出金待ち時間中にユーザーが経験する体験と、ブリッジ手数料の変動を許容できるかどうかの技術的代替案を用意する必要があります。\n\n第三に、シーケンサーの単一障害点（SPOF）とアップグレードキーのセキュリティ権限です。大半のL2チェーンは、初期アクティベーションのために中央集権的なオフチェーンシーケンサーと、マルチシグ鍵を用いたコントラクトアップグレード権限を保持しています。シーケンサーが非活性化された際に、トランザクションをL1に直接強制提出できるエマージェンシー・エグジット（緊急脱出）機能が備わっているか、また、基幹ブリッジコントラクトを制御するマルチシグの主体と所有構造が十分に信頼できるものか、本番デプロイ前に透明性を確保し検証する必要があります。\n\n本番デプロイのための開発者の意思決定フレームワーク\n\n現在、イーサリアムL2を選択する基準は、単なるガス代の節約から、アプリケーション固有の要求に応じたアーキテクチャの最適化へと完全に移行しました。極限までガス代を代行する構造とシームレスなユーザー体験が鍵であればReth v2ベースのネイティブAAをサポートするBase Cobaltが適しており、Rustベースの高性能な演算やプロトコルレベルの規制フィルタリングが求められるならArbitrum Elaraが確実な代替案です。また、国内の制度金融機関との連携や信頼性の高いオンチェーンID認証体系が必要であれば、GIWAチェーンのDojangエコシステムを積極的に検証すべきです。各実行クライアントが提供する技術的強みを明確に把握し、製品スペックに合わせたネットワークを選択することで、本番段階でのアーキテクチャリスクを完全にコントロールすることができます。\n\n参考リンク\n\nBase Engineering — Base Cobalt and EIP-8130 Native Account Abstraction Technical Architecture\nBase Engineering — Base Cobalt Native Account Abstraction (EIP-8130 / EIP-8140)","Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지\n\nReth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지\n\n이더리움 레이어 2 생태계의 경쟁 구도가 단순한 트랜잭션 처리 속도에서 개발자 경험과 엔터프라이즈 아키텍처를 직접 해결하는 방향으로 진화하고 있습니다. 패러다임의 Reth v2.4.0 실행 클라이언트 출시와 더불어, 번들러가 필요 없는 네이티브 계정 추상화를 구현하는 Base Cobalt, 96KB 웹어셈블리 스마트 컨트랙트와 규제 필터링을 도입한 Arbitrum 엘라라, 그리고 국내 제도권 금융 기준에 맞춰 신원 인증과 프라이버시 레이어를 내장한 기와 체인까지 각 플랫폼이 제시하는 기술적 돌파구를 분석합니다. 본 아티클에서는 마케팅 내러티브를 걷어내고, 실제 빌더의 관점에서 각 레이어 2 아키텍처의 핵심 메커니즘과 프로덕션 배포 시 필수적인 기술 선택 기준을 살펴봅니다.\n\nBase Cobalt와 EIP-8130 — 번들러가 사라지는 네이티브 AA\n\nBase가 2026년 9월 도입 예정인 Cobalt 하드포크는 기존 스마트 계약 지갑의 구동 방식을 완전히 뒤바꿔 놓을 것입니다. 핵심은 Reth V2 실행 클라이언트에 EIP-8130 네이티브 계정 추상화(AA)를 직접 통합하는 데 있습니다. 기존 ERC-4337 표준은 오프체인 번들러가 사용자 요청을 모아 EntryPoint 컨트랙트로 전달하고, 이를 다시 EVM 루프를 돌려 검증하는 복잡한 구조였습니다. 이로 인해 많은 가스 수수료 오버헤드와 트랜잭션 지연이 발생할 수밖에 없었습니다.\n\nEIP-8130 기반의 Cobalt 아키텍처는 이 복잡한 검증 단계를 프로토콜 레이어에서 직접 해결합니다. 사용자가 새로운 규격인 Type 0x79 트랜잭션을 제출하면, Reth v2.4.0에 내장된 revmc JIT 컴파일러 기반의 실행 엔진이 노드 합의 단계에서 트랜잭션을 인터셉트하여 검증합니다. 무거운 EVM 구동을 우회하고 클라이언트 네이티브 레이어에서 온체인 시스템 컨트랙트인 AccountConfiguration을 참조해 곧바로 검증하므로, 스마트 계정의 검증 가스 비용이 외부 소유 계정(EOA)과 동일한 21,000 가스 수준으로 줄어듭니다.\n\nEIP-8130 환경에서 스마트 계정은 자신을 대신해 서명할 액터와 이를 검증할 인증기(Authenticator)를 시스템 계약에 등록해 제어합니다. 아래는 EIP-8130 규격을 준수하는 환경에서 AccountConfiguration 시스템 컨트랙트를 조회해 특정 인증기가 네트워크가 허용하는 공식 규격인지 검증하는 솔리디티(Solidity v0.8.20 기준) 예시 코드입니다.\n\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n\ninterface IAccountConfiguration {\n function isCanonicalAuthenticator(address authenticator) external view returns (bool);\n}\n\ncontract AccountVerifier {\n address public constant ACCOUNT_CONFIG = 0x0000000000000000000000000000000000008130;\n\n function checkCompliance(address authenticator) external view returns (bool) {\n return IAccountConfiguration(ACCOUNT_CONFIG).isCanonicalAuthenticator(authenticator);\n } \n}\n\n이 새로운 네이티브 계정 추상화 흐름은 가스 비용을 60% 이상 획기적으로 낮출 뿐만 아니라, 개발자가 오프체인 번들러나 릴레이어 인프라를 번거롭게 운영해야 하는 유지보수 부담을 완전히 해결합니다. 현재 Base가 제공하는 테스트넷인 Base Vibenet(체인 ID 84538453)에서 이 고성능 네이티브 AA 환경을 즉시 프로토타이핑할 수 있습니다.\n\nArbitrum ArbOS 61 Elara — 96KB Stylus와 규제 필터링의 도입\n\nArbitrum의 ArbOS 61 엘라라 업그레이드는 고성능 러스트 스마트 컨트랙트를 작성하는 개발자와 엔터프라이즈 앱체인을 구축하려는 빌더 모두에게 중요한 전환점입니다. 이번 업그레이드는 Nitro v3.11.0 버전을 요구하며, 웹어셈블리(WASM) 기반의 Stylus 컨트랙트 크기 제한을 크게 늘리는 동시에 프로토콜 수준에서 트랜잭션을 제어할 수 있는 컴플라이언스 도구를 전면에 내세웠습니다.\n\n특히 개발자가 주목해야 할 부분은 기존 가상머신과의 컨트랙트 크기 제한 차이입니다.\n\nEVM 바이트코드 한계 (24KB): 표준 이더리움 가상머신은 EIP-170 규격에 따라 스마트 컨트랙트의 바이트코드 크기를 최대 24KB로 엄격히 제약합니다. 이 때문에 대규모 비즈니스 로직이나 고난도 암호학 알고리즘을 담으려면 컨트랙트를 강제로 분할하고 위임 호출을 복잡하게 엮어야 하는 아키텍처적 부채가 발생합니다.\nStylus WASM 크기 한계 (96KB): 엘라라 업그레이드를 통해 Stylus 컨트랙트의 크기 제한이 96KB로 늘어났습니다. 러스트 컴파일러가 생성하는 바이너리는 EVM 바이트코드보다 용량이 커지기 쉬운 특성이 있습니다. 제한이 완화되면서 개발자는 외부 크레이트를 자유롭게 가져다 쓰며 크기 최적화 대신 로직 구현과 암호학 연산 자체에 집중할 수 있게 되었습니다.\n\n이와 더불어 엘라라는 옵션 형태로 제공되는 규제 필터링 기술을 새롭게 도입했습니다 이 기능은 트랜잭션을 수집하는 시퀀서 단계와 네트워크의 상태를 최종 확정하는 상태 전이 함수(STF) 레이어 모두에서 특정 주소를 필터링합니다. 컨트랙트 내부 로직에 복잡한 주소 차단 코드를 중복해서 작성할 필요 없이, 시퀀서와 프로토콜 엔진 수준에서 규제 준수 요건을 처리할 수 있어 제도권 금융 앱체인을 설계하는 빌더들에게 매력적인 아키텍처적 선택지를 제공합니다.\n\nGIWA 체인 — Dojang과 Bojagi로 구현한 엔터프라이즈 신원 및 프라이버시\n\n두나무가 주도하는 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 레이어 2 네트워크입니다. 퍼블릭 생태계의 개방성과 금융 기관 수준의 규제 준수 역량을 동시에 제공하기 위해 온체인 신원 레이어인 도장(Dojang)과 프라이버시 전용 프로토콜인 보자기(Bojagi)를 핵심 아키텍처에 내장했습니다. 1초의 블록 타임과 1원 미만의 저렴한 가스비를 구현하여 제도권 금융과 고성능 디앱을 매끄럽게 연결합니다.\n\n개발자가 기와 세폴리아(GIWA Sepolia) 테스트넷에서 주목해야 할 실질적인 무기는 이더리움 증명 서비스(EAS) 프로토콜 기반의 도장 생태계입니다. 도장은 개인정보 노출 없이 지갑 주소의 고객확인(KYC) 여부만을 증명하는 온체인 증명서(Attestation)를 발행합니다. 개발자는 복잡한 오프체인 인증 시스템을 직접 구축할 필요 없이, 온체인에 미리 배포된 컨트랙트를 통해 지갑의 인증 상태를 즉각적으로 검증할 수 있습니다.\n\n기와 세폴리아 환경에 탑재된 주요 도장 컨트랙트와 핵심 스키마 식별자(Schema UID) 설정 정보는 다음과 같습니다.\n\n기와 세폴리아 도장 컨트랙트\nEAS 증명서 발행 및 검증 핵심 엔진 0x4200000000000000000000000000000000000021\nSchemaRegistry 증명서 양식 등록 및 조회 0x4200000000000000000000000000000000000020\nDojangScroll 온체인 증명 데이터 통합 조회 도구 0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9\n\n핵심 도장 스키마 규격\nVerified Address (검증 완료 지갑)\n데이터 규격: bool isVerified\n스키마 식별자: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\nVerified Balance (검증 완료 잔고)\n데이터 규격: uint256 balance, bytes32 salt, bytes32[] proofs\n스키마 식별자: 0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9\n\n반면 금융 기관 간 대규모 자금 정산을 겨냥한 보자기 프로토콜은 도장과 달리 완전한 폐쇄형으로 운영되는 영지식 증명(ZKP) 기반 프라이버시 엔진입니다. 거래 금액과 송수신자의 신원을 온체인에서 완전히 은닉하면서 은행 비밀주의 규제를 충족합니다. 실제로 보자기는 하나금융그룹과의 예금 토큰 기반 해외 송금 개념 검증(PoC)에 성공적으로 적용되며 기존 스위프트 통신망을 대체할 수 있는 기술적 실현 가능성을 입증했습니다. 개발자에게 열린 도장 프로토콜과 금융 기관을 위한 보자기 프로토콜이 투트랙으로 가동되면서 기와 체인만의 고유한 신뢰 아키텍처가 형성됩니다.\n\nL2 개발 시 빠지기 쉬운 세 가지 함정과 대응 전략\n\n이더리움 레이어 2 생태계의 기술적 성숙도와 관계없이, 메인넷 프로덕션 배포를 준비하는 빌더는 오프체인 실행 모델의 특수성을 고려해야 합니다. 단순히 EVM 호환성만 믿고 스마트 컨트랙트를 배포했다가 시스템 아키텍처 수준에서 심각한 병목이나 보안 허점을 마주하기 쉽습니다. 안정적인 서비스를 빌드하기 위해 사전에 반드시 검증해야 할 세 가지 핵심 리스크는 다음과 같습니다.\n\n첫째, 시퀀서의 즉각 승인과 L1 최종성 완결의 불일치입니다. L2 시퀀서가 트랜잭션을 수신하고 제공하는 즉각적인 응답은 소프트 컨펌일 뿐입니다. 데이터가 이더리움 메인넷에 배치 형태로 제출되고 합의가 최종 완결될 때까지는 상당한 시간 차가 존재합니다. 고액 자산 전송이나 최종 승인이 중요한 서비스라면 시퀀서 승인 즉시 트랜잭션을 완전히 끝난 것으로 처리해서는 안 되며, L1 상태 정착 단계를 추적하는 예외 처리 비즈니스 로직을 구현해야 합니다.\n\n둘째, 브릿지 아키텍처의 유동성 제약과 지연 시간입니다. 옵티미스틱 롤업 계열의 네트워크는 L1으로 자금을 돌려보낼 때 7일간의 분쟁 기간이 강제됩니다. 고속 출금을 지원하는 타사 브릿지 프로토콜에 의존하더라도 대규모 자금 이동 시 유동성 풀이 일시 고갈되는 위험을 상정해야 합니다. 서비스 설계 시 출금 대기 시간 동안 사용자가 겪을 경험과 브릿지 수수료 변동성을 감당할 수 있는지 기술적 대안을 세워두어야 합니다.\n\n셋째, 시퀀서의 단일 실패 지점과 업그레이드 키 보안 권한입니다. 대다수 L2 체인은 초기 활성화를 위해 중앙화된 오프체인 시퀀서와 다중 서명 키를 활용한 컨트랙트 업그레이드 권한을 보유하고 있습니다. 시퀀서가 비활성화되었을 때 트랜잭션을 L1으로 직접 강제 제출할 수 있는 비상 탈출구 기능이 열려 있는지, 핵심 브릿지 컨트랙트를 통제하는 다중 서명의 주체와 소유 구조가 충분히 신뢰할 수 있는지 프로덕션 이전에 투명하게 파악해 검증해야 합니다.\n\n프로덕션 배포를 위한 개발자 의사결정 프레임워크\n\n이제 이더리움 레이어 2 선택의 기준은 단순한 가스비 절감에서 애플리케이션의 고유 요구사항에 맞는 아키텍처 최적화로 완전히 전환되었습니다. 극대화된 가스 수수료 대납 구조와 매끄러운 사용자 경험이 핵심이라면 Reth V2 기반의 네이티브 계정 추상화를 지원하는 Base Cobalt가 적합하며, Rust 기반의 고성능 연산과 프로토콜 수준의 규제 필터링이 요구된다면 Arbitrum Elara가 확실한 대안입니다. 한편 국내 제도권 금융 기관과의 연동이나 신뢰할 수 있는 온체인 신원 인증 체계가 필요하다면 GIWA 체인의 도장 생태계를 적극적으로 검증해야 합니다. 각 실행 클라이언트가 제공하는 기술적 강점을 명확히 인지하고 제품 스펙에 맞춤화된 네트워크를 선택할 때 프로덕션 단계의 아키텍처 리스크를 완벽히 통제할 수 있습니다.\n\n참고 링크\n\nBase Engineering — Base Cobalt and EIP-8130 Native Account Abstraction Technical Architecture\nBase Engineering — Base Cobalt Native Account Abstraction (EIP-8130 / EIP-8140)",{"_1892":9515,"_1893":9516,"_1802":9517},"Reth v2.4.0 and the Evolution of L2: From Native AA to Regulatory Filtering The competitive landscape of the Ethereum Layer 2 ecosystem is evolving from simple transaction speed optimization toward directly solving for d…","Reth v2.4.0とL2の進化 — ネイティブAAから規制フィルタリングまでイーサリアムレイヤー2（L2）エコシステムの競争は、単なるトランザクション処理速度から、開発者体験とエンタープライズアーキテクチャの直接的な課題解決へと進化しています。本記事では、ParadigmのReth v2.4.0実行クライアントのリリースをはじめ、バンドラー不要のネイティブ・アカウント抽象化（AA）を実装するBase Cobalt、96KBのWeb…","Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지 이더리움 레이어 2 생태계의 경쟁 구도가 단순한 트랜잭션 처리 속도에서 개발자 경험과 엔터프라이즈 아키텍처를 직접 해결하는 방향으로 진화하고 있습니다. 패러다임의 Reth v2.4.0 실행 클라이언트 출시와 더불어, 번들러가 필요 없는 네이티브 계정 추상화를 구현하는 Base Cobalt, 96KB 웹어셈블리 스마트 컨…","cms0o7tsu00py10pbjbfh9p14",[9520],"infrastructure-insight",[51,9522,9523,9524,55,841,6735],"layer","reth","account-abstraction",[],"2026-07-27T21:54:20.494Z","2026-07-25T14:06:28.642Z","2026-07-28T05:44:42.937Z","2026-07-28T05:43:04.631Z","2026-07-28T05:44:42.901Z",{"_950":6709,"_1881":1324,"_1675":-5,"_2489":6748,"_1780":6749,"_1899":9532},{"_1901":9533},{"_1903":9534,"_1908":1909,"_1910":9535,"_1921":9536,"_1943":6771},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":6754,"_1914":6755,"_1810":1916,"_944":1916,"_1917":6756,"_1919":6757},{"_1923":9537,"_1928":9538,"_1933":9539,"_1938":9540},{"_1912":6760,"_1914":6761,"_1810":1927,"_944":1927},{"_1912":6763,"_1914":6764,"_1810":1932,"_944":1932},{"_1912":6766,"_1914":6767,"_1810":1937,"_944":1937},{"_1912":6769,"_1914":6770,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":9542,"_1883":1884,"_1200":1204,"_1899":9545},{"_633":9543,"_11":9544},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":9546},{"_1903":9547,"_1908":1909,"_1910":9548,"_1921":9549,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":9550,"_1928":9551,"_1933":9552,"_1938":9553},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":9555},{"_1948":-5,"_1908":1909,"_1910":9556,"_1960":-5,"_1943":9562,"_1962":9563},{"_1912":9557,"_1914":9558,"_1952":9559,"_1810":2534,"_944":1992,"_1917":9560,"_1957":2536,"_1919":9561},"users/cmqx0mggs00004jcg8uoj3tmt/images/originals/4a1a1a9c-0a46-4937-8cab-1de83ff1a7ea.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/originals/4a1a1a9c-0a46-4937-8cab-1de83ff1a7ea.jpg",412515,"LD8z_k~qWAM_-;t6IUM|IUIUM{js","#181828","2026-07-25T17:56:32.060Z",{"_1964":9564,"_1972":9568,"_1979":9572,"_1986":-5},{"_1912":9565,"_1914":9566,"_1952":9567,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/large.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/large.webp",23428,{"_1912":9569,"_1914":9570,"_1952":9571,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/small.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/small.webp",5910,{"_1912":9573,"_1914":9574,"_1952":9575,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/medium.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cms0o7tsu00py10pbjbfh9p14/medium.webp",13086,{"_950":9577,"_2559":9496,"_2560":9578,"_2716":10058,"_2788":10234,"_2790":10235,"_2792":1937,"_2794":1997,"_2003":10236,"_2480":10237,"_2797":-5},"cms0fzzfr00ff10pbd0ksihqr",{"_918":9579,"_1908":1909},[9580,9583,9587,9592,9596,9602,9606,9612,9616,9622,9626,9652,9656,9666,9670,9673,9677,9683,9687,9693,9697,9703,9707,9713,9717,9736,9740,9746,9750,9756,9760,9766,9770,9776,9780,9786,9790,9796,9860,9864,9870,9920,9924,9930,9934,9940,9944,9950,9954,9965,9969,9980,9984,9995,9999,10005,10009,10015,10019,10021,10025,10031,10035,10054],{"_950":9581,"_2565":9509,"_2420":2566,"_3202":591,"_3203":9582,"_2567":9518},"b5d33e5d-643b-4271-9615-21a77c079be6",{"_3205":591},{"_950":9584,"_2420":2570,"_3203":9585,"_2571":9586},"0152b939-e9c4-4b35-9e2f-cbe081e686f5",{"_3205":591},[],{"_950":9588,"_2420":2575,"_2576":1909,"_3203":9589,"_2571":9590},"9cf7e5fc-4ae5-413e-9c97-298dbedbc2aa",{"_3205":591},[9591],{"_2579":9509,"_2420":2579},{"_950":9593,"_2420":2570,"_3203":9594,"_2571":9595},"04c3f2c0-969d-4bca-b237-ee59f8ce2608",{"_3205":591},[],{"_950":9597,"_2420":2570,"_3203":9598,"_2571":9599},"ea250f8d-a6d4-4936-972b-79bd9047cb0e",{"_3205":591},[9600],{"_2579":9601,"_2420":2579},"이더리움 레이어 2 생태계의 경쟁 구도가 단순한 트랜잭션 처리 속도에서 개발자 경험과 엔터프라이즈 아키텍처를 직접 해결하는 방향으로 진화하고 있습니다. 패러다임의 Reth v2.4.0 실행 클라이언트 출시와 더불어, 번들러가 필요 없는 네이티브 계정 추상화를 구현하는 Base Cobalt, 96KB 웹어셈블리 스마트 컨트랙트와 규제 필터링을 도입한 Arbitrum 엘라라, 그리고 국내 제도권 금융 기준에 맞춰 신원 인증과 프라이버시 레이어를 내장한 기와 체인까지 각 플랫폼이 제시하는 기술적 돌파구를 분석합니다. 본 아티클에서는 마케팅 내러티브를 걷어내고, 실제 빌더의 관점에서 각 레이어 2 아키텍처의 핵심 메커니즘과 프로덕션 배포 시 필수적인 기술 선택 기준을 살펴봅니다.",{"_950":9603,"_2420":2570,"_3203":9604,"_2571":9605},"43bb71ff-822d-4de0-916b-796df5a9fab5",{"_3205":591},[],{"_950":9607,"_2420":2575,"_2576":2007,"_3203":9608,"_2571":9609},"9cee9973-657a-4a2f-93a9-a7bf67825c01",{"_3205":591},[9610],{"_2579":9611,"_2420":2579},"Base Cobalt와 EIP-8130 — 번들러가 사라지는 네이티브 AA",{"_950":9613,"_2420":2570,"_3203":9614,"_2571":9615},"d97590e8-b57a-4cdd-ad35-1ccd0bb84769",{"_3205":591},[],{"_950":9617,"_2420":2570,"_3203":9618,"_2571":9619},"6a8f51c7-9807-4d29-88db-5861205f143e",{"_3205":591},[9620],{"_2579":9621,"_2420":2579},"Base가 2026년 9월 도입 예정인 Cobalt 하드포크는 기존 스마트 계약 지갑의 구동 방식을 완전히 뒤바꿔 놓을 것입니다. 핵심은 Reth V2 실행 클라이언트에 EIP-8130 네이티브 계정 추상화(AA)를 직접 통합하는 데 있습니다. 기존 ERC-4337 표준은 오프체인 번들러가 사용자 요청을 모아 EntryPoint 컨트랙트로 전달하고, 이를 다시 EVM 루프를 돌려 검증하는 복잡한 구조였습니다. 이로 인해 많은 가스 수수료 오버헤드와 트랜잭션 지연이 발생할 수밖에 없었습니다.",{"_950":9623,"_2420":2570,"_3203":9624,"_2571":9625},"bc28b26c-eb17-4b0b-b05d-e7e0849ec44b",{"_3205":591},[],{"_950":9627,"_2420":2570,"_3203":9628,"_2571":9629},"fa0dd50e-2787-4ec5-b8df-4132547cbbc8",{"_3205":591},[9630,9632,9635,9637,9640,9642,9645,9647,9650],{"_2579":9631,"_2420":2579},"EIP-8130 기반의 Cobalt 아키텍처는 이 복잡한 검증 단계를 프로토콜 레이어에서 직접 해결합니다. 사용자가 새로운 규격인 ",{"_2579":9633,"_2420":2579,"_3365":9634},"Type 0x79 트랜잭션",{"_3485":3367},{"_2579":9636,"_2420":2579},"을 제출하면, Reth v2.4.0에 내장된 ",{"_2579":9638,"_2420":2579,"_3365":9639},"revmc",{"_3351":3367},{"_2579":9641,"_2420":2579}," JIT 컴파일러 기반의 실행 엔진이 노드 합의 단계에서 트랜잭션을 인터셉트하여 검증합니다. 무거운 EVM 구동을 우회하고 클라이언트 네이티브 레이어에서 온체인 시스템 컨트랙트인 ",{"_2579":9643,"_2420":2579,"_3365":9644},"AccountConfiguration",{"_3351":3367},{"_2579":9646,"_2420":2579},"을 참조해 곧바로 검증하므로, 스마트 계정의 검증 가스 비용이 외부 소유 계정(EOA)과 동일한 ",{"_2579":9648,"_2420":2579,"_3365":9649},"21,000 가스",{"_3485":3367},{"_2579":9651,"_2420":2579}," 수준으로 줄어듭니다.",{"_950":9653,"_2420":2570,"_3203":9654,"_2571":9655},"6bdd42e9-8c35-487b-9894-6c337d6666f3",{"_3205":591},[],{"_950":9657,"_2420":2570,"_3203":9658,"_2571":9659},"df479406-2133-46df-8b35-b0df044d1aa6",{"_3205":591},[9660,9662,9664],{"_2579":9661,"_2420":2579},"EIP-8130 환경에서 스마트 계정은 자신을 대신해 서명할 액터와 이를 검증할 인증기(Authenticator)를 시스템 계약에 등록해 제어합니다. 아래는 EIP-8130 규격을 준수하는 환경에서 ",{"_2579":9643,"_2420":2579,"_3365":9663},{"_3351":3367},{"_2579":9665,"_2420":2579}," 시스템 컨트랙트를 조회해 특정 인증기가 네트워크가 허용하는 공식 규격인지 검증하는 솔리디티(Solidity v0.8.20 기준) 예시 코드입니다.",{"_950":9667,"_2420":2570,"_3203":9668,"_2571":9669},"959316a1-0c34-42b1-99f7-535505cdda59",{"_3205":591},[],{"_950":9671,"_3351":9672,"_2420":3351,"_625":7005},"eb11f398-a6e6-44c7-9466-906dec4d2254","// SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n\ninterface IAccountConfiguration {\n function isCanonicalAuthenticator(address authenticator) external view returns (bool);\n}\n\ncontract AccountVerifier {\n address public constant ACCOUNT_CONFIG = 0x0000000000000000000000000000000000008130;\n\n function checkCompliance(address authenticator) external view returns (bool) {\n return IAccountConfiguration(ACCOUNT_CONFIG).isCanonicalAuthenticator(authenticator);\n } \n}",{"_950":9674,"_2420":2570,"_3203":9675,"_2571":9676},"baae0b98-185e-4d97-895d-872342e32a5c",{"_3205":591},[],{"_950":9678,"_2420":2570,"_3203":9679,"_2571":9680},"b5f52380-6e18-47be-acc7-3d991466f04e",{"_3205":591},[9681],{"_2579":9682,"_2420":2579},"이 새로운 네이티브 계정 추상화 흐름은 가스 비용을 60% 이상 획기적으로 낮출 뿐만 아니라, 개발자가 오프체인 번들러나 릴레이어 인프라를 번거롭게 운영해야 하는 유지보수 부담을 완전히 해결합니다. 현재 Base가 제공하는 테스트넷인 Base Vibenet(체인 ID 84538453)에서 이 고성능 네이티브 AA 환경을 즉시 프로토타이핑할 수 있습니다.",{"_950":9684,"_2420":2570,"_3203":9685,"_2571":9686},"e62c1d07-1b82-4ae8-b7e8-5ec7135cf952",{"_3205":591},[],{"_950":9688,"_2420":2575,"_2576":2007,"_3203":9689,"_2571":9690},"4b57ac26-3649-4baa-80aa-8ee17fbad4e1",{"_3205":591},[9691],{"_2579":9692,"_2420":2579},"Arbitrum ArbOS 61 Elara — 96KB Stylus와 규제 필터링의 도입",{"_950":9694,"_2420":2570,"_3203":9695,"_2571":9696},"c9abeb6b-8df5-49a5-9717-99792a705343",{"_3205":591},[],{"_950":9698,"_2420":2570,"_3203":9699,"_2571":9700},"6e5917cf-c0d4-4570-8bca-26548941c546",{"_3205":591},[9701],{"_2579":9702,"_2420":2579},"Arbitrum의 ArbOS 61 엘라라 업그레이드는 고성능 러스트 스마트 컨트랙트를 작성하는 개발자와 엔터프라이즈 앱체인을 구축하려는 빌더 모두에게 중요한 전환점입니다. 이번 업그레이드는 Nitro v3.11.0 버전을 요구하며, 웹어셈블리(WASM) 기반의 Stylus 컨트랙트 크기 제한을 크게 늘리는 동시에 프로토콜 수준에서 트랜잭션을 제어할 수 있는 컴플라이언스 도구를 전면에 내세웠습니다.",{"_950":9704,"_2420":2570,"_3203":9705,"_2571":9706},"c095eebe-0981-40a3-afdc-415896789ca8",{"_3205":591},[],{"_950":9708,"_2420":2570,"_3203":9709,"_2571":9710},"8db18600-b55f-4c65-8cb0-dc5b4e092d9a",{"_3205":591},[9711],{"_2579":9712,"_2420":2579},"특히 개발자가 주목해야 할 부분은 기존 가상머신과의 컨트랙트 크기 제한 차이입니다.",{"_950":9714,"_2420":2570,"_3203":9715,"_2571":9716},"ed052e49-9d0c-4fed-bb12-138de42b4c01",{"_3205":591},[],{"_950":9718,"_1881":3492,"_2420":3493,"_778":9719},"a6bcc681-6bd6-41e1-8b6e-d4f02bccf7dc",[9720,9728],{"_950":9721,"_2571":9722},"60b87aa5-01a5-4bdf-95c2-23307ff7ac83",[9723,9726],{"_2579":9724,"_2420":2579,"_3365":9725},"EVM 바이트코드 한계 (24KB):",{"_3485":3367},{"_2579":9727,"_2420":2579}," 표준 이더리움 가상머신은 EIP-170 규격에 따라 스마트 컨트랙트의 바이트코드 크기를 최대 24KB로 엄격히 제약합니다. 이 때문에 대규모 비즈니스 로직이나 고난도 암호학 알고리즘을 담으려면 컨트랙트를 강제로 분할하고 위임 호출을 복잡하게 엮어야 하는 아키텍처적 부채가 발생합니다.",{"_950":9729,"_2571":9730},"e2aec82d-f89c-4426-99bf-4d9a3af5dc2b",[9731,9734],{"_2579":9732,"_2420":2579,"_3365":9733},"Stylus WASM 크기 한계 (96KB):",{"_3485":3367},{"_2579":9735,"_2420":2579}," 엘라라 업그레이드를 통해 Stylus 컨트랙트의 크기 제한이 96KB로 늘어났습니다. 러스트 컴파일러가 생성하는 바이너리는 EVM 바이트코드보다 용량이 커지기 쉬운 특성이 있습니다. 제한이 완화되면서 개발자는 외부 크레이트를 자유롭게 가져다 쓰며 크기 최적화 대신 로직 구현과 암호학 연산 자체에 집중할 수 있게 되었습니다.",{"_950":9737,"_2420":2570,"_3203":9738,"_2571":9739},"98864e17-163a-4f61-9bd7-45ad3e69141e",{"_3205":591},[],{"_950":9741,"_2420":2570,"_3203":9742,"_2571":9743},"d142910c-f799-4ca9-a859-ef7017f82cab",{"_3205":591},[9744],{"_2579":9745,"_2420":2579},"이와 더불어 엘라라는 옵션 형태로 제공되는 규제 필터링 기술을 새롭게 도입했습니다 이 기능은 트랜잭션을 수집하는 시퀀서 단계와 네트워크의 상태를 최종 확정하는 상태 전이 함수(STF) 레이어 모두에서 특정 주소를 필터링합니다. 컨트랙트 내부 로직에 복잡한 주소 차단 코드를 중복해서 작성할 필요 없이, 시퀀서와 프로토콜 엔진 수준에서 규제 준수 요건을 처리할 수 있어 제도권 금융 앱체인을 설계하는 빌더들에게 매력적인 아키텍처적 선택지를 제공합니다.",{"_950":9747,"_2420":2570,"_3203":9748,"_2571":9749},"aafb9ef5-d707-4267-8b31-5c8314b1732a",{"_3205":591},[],{"_950":9751,"_2420":2575,"_2576":2007,"_3203":9752,"_2571":9753},"89802099-ddb8-414f-89e5-ceddd9eada64",{"_3205":591},[9754],{"_2579":9755,"_2420":2579},"GIWA 체인 — Dojang과 Bojagi로 구현한 엔터프라이즈 신원 및 프라이버시",{"_950":9757,"_2420":2570,"_3203":9758,"_2571":9759},"ab7a636d-5956-4804-8b43-8929b2878f61",{"_3205":591},[],{"_950":9761,"_2420":2570,"_3203":9762,"_2571":9763},"377f93ce-f454-423b-9348-fa035644de31",{"_3205":591},[9764],{"_2579":9765,"_2420":2579},"두나무가 주도하는 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 레이어 2 네트워크입니다. 퍼블릭 생태계의 개방성과 금융 기관 수준의 규제 준수 역량을 동시에 제공하기 위해 온체인 신원 레이어인 도장(Dojang)과 프라이버시 전용 프로토콜인 보자기(Bojagi)를 핵심 아키텍처에 내장했습니다. 1초의 블록 타임과 1원 미만의 저렴한 가스비를 구현하여 제도권 금융과 고성능 디앱을 매끄럽게 연결합니다.",{"_950":9767,"_2420":2570,"_3203":9768,"_2571":9769},"e3c7cb19-d259-476f-850a-da53f5cb2453",{"_3205":591},[],{"_950":9771,"_2420":2570,"_3203":9772,"_2571":9773},"cf90cb8f-1695-4784-8537-d294be788a8f",{"_3205":591},[9774],{"_2579":9775,"_2420":2579},"개발자가 기와 세폴리아(GIWA Sepolia) 테스트넷에서 주목해야 할 실질적인 무기는 이더리움 증명 서비스(EAS) 프로토콜 기반의 도장 생태계입니다. 도장은 개인정보 노출 없이 지갑 주소의 고객확인(KYC) 여부만을 증명하는 온체인 증명서(Attestation)를 발행합니다. 개발자는 복잡한 오프체인 인증 시스템을 직접 구축할 필요 없이, 온체인에 미리 배포된 컨트랙트를 통해 지갑의 인증 상태를 즉각적으로 검증할 수 있습니다.",{"_950":9777,"_2420":2570,"_3203":9778,"_2571":9779},"5cb87361-8e10-48c4-b9cb-fa9c7d2f49f3",{"_3205":591},[],{"_950":9781,"_2420":2570,"_3203":9782,"_2571":9783},"332cc84e-c6f6-49a0-998b-f2990d7483a1",{"_3205":591},[9784],{"_2579":9785,"_2420":2579},"기와 세폴리아 환경에 탑재된 주요 도장 컨트랙트와 핵심 스키마 식별자(Schema UID) 설정 정보는 다음과 같습니다.",{"_950":9787,"_2420":2570,"_3203":9788,"_2571":9789},"712c890f-f6fa-4f6e-871d-9decccf61ba7",{"_3205":591},[],{"_950":9791,"_2420":2575,"_2576":2142,"_3203":9792,"_2571":9793},"f8958d1d-74e3-4b2c-bdac-a787fa9ad99d",{"_3205":591},[9794],{"_2579":9795,"_2420":2579},"기와 세폴리아 도장 컨트랙트",{"_950":9797,"_9798":9799,"_2420":9857,"_9858":9859},"2391bf0a-8745-4738-b832-eff4e658dcdd","rows",[9800,9821,9839],{"_9801":9802},"cells",[9803,9811,9816],{"_3203":9804,"_2571":9807},{"_9805":1909,"_9806":1909,"_3205":591},"colspan","rowspan",[9808],{"_2579":9809,"_2420":2579,"_3365":9810},"EAS",{"_3485":3367},{"_3203":9812,"_2571":9813},{"_9805":1909,"_9806":1909,"_3205":591},[9814],{"_2579":9815,"_2420":2579},"증명서 발행 및 검증 핵심 엔진",{"_3203":9817,"_2571":9818},{"_9805":1909,"_9806":1909,"_3205":591},[9819],{"_2579":6969,"_2420":2579,"_3365":9820},{"_3351":3367},{"_9801":9822},[9823,9829,9834],{"_3203":9824,"_2571":9825},{"_9805":1909,"_9806":1909,"_3205":591},[9826],{"_2579":9827,"_2420":2579,"_3365":9828},"SchemaRegistry",{"_3485":3367},{"_3203":9830,"_2571":9831},{"_9805":1909,"_9806":1909,"_3205":591},[9832],{"_2579":9833,"_2420":2579},"증명서 양식 등록 및 조회",{"_3203":9835,"_2571":9836},{"_9805":1909,"_9806":1909,"_3205":591},[9837],{"_2579":6974,"_2420":2579,"_3365":9838},{"_3351":3367},{"_9801":9840},[9841,9847,9852],{"_3203":9842,"_2571":9843},{"_9805":1909,"_9806":1909,"_3205":591},[9844],{"_2579":9845,"_2420":2579,"_3365":9846},"DojangScroll",{"_3485":3367},{"_3203":9848,"_2571":9849},{"_9805":1909,"_9806":1909,"_3205":591},[9850],{"_2579":9851,"_2420":2579},"온체인 증명 데이터 통합 조회 도구",{"_3203":9853,"_2571":9854},{"_9805":1909,"_9806":1909,"_3205":591},[9855],{"_2579":6984,"_2420":2579,"_3365":9856},{"_3351":3367},"table","columnWidths",[-5,-5,-5],{"_950":9861,"_2420":2570,"_3203":9862,"_2571":9863},"d35c0fd7-0e47-44b7-91bc-284823a6eaca",{"_3205":591},[],{"_950":9865,"_2420":2575,"_2576":2142,"_3203":9866,"_2571":9867},"b9ba4761-ea67-4e35-afdf-bf1719c2995e",{"_3205":591},[9868],{"_2579":9869,"_2420":2579},"핵심 도장 스키마 규격",{"_950":9871,"_1881":3492,"_2420":3493,"_778":9872},"9f21666d-fd98-43e0-9f8a-98e0e2d87ce2",[9873,9897],{"_950":9874,"_2571":9875,"_3502":9881},"8daf6ef2-39e2-49d2-bafa-ecc438522405",[9876,9879],{"_2579":9877,"_2420":2579,"_3365":9878},"Verified Address",{"_3485":3367},{"_2579":9880,"_2420":2579}," (검증 완료 지갑)",[9882,9890],{"_950":9883,"_2571":9884},"0d803c2d-762f-451d-b5df-83dc313cf30c",[9885,9887],{"_2579":9886,"_2420":2579},"데이터 규격: ",{"_2579":9888,"_2420":2579,"_3365":9889},"bool isVerified",{"_3351":3367},{"_950":9891,"_2571":9892},"cb0ae8e4-4f0f-4985-95c8-f568d5691659",[9893,9895],{"_2579":9894,"_2420":2579},"스키마 식별자: ",{"_2579":6979,"_2420":2579,"_3365":9896},{"_3351":3367},{"_950":9898,"_2571":9899,"_3502":9905},"d5afe085-b78a-4a1f-9728-e11a563dda42",[9900,9903],{"_2579":9901,"_2420":2579,"_3365":9902},"Verified Balance",{"_3485":3367},{"_2579":9904,"_2420":2579}," (검증 완료 잔고)",[9906,9913],{"_950":9907,"_2571":9908},"53258a0d-6f88-45f7-95e6-996d8557e51a",[9909,9910],{"_2579":9886,"_2420":2579},{"_2579":9911,"_2420":2579,"_3365":9912},"uint256 balance, bytes32 salt, bytes32[] proofs",{"_3351":3367},{"_950":9914,"_2571":9915},"d6fb087d-ed39-4826-baab-3cde2e0226cd",[9916,9917],{"_2579":9894,"_2420":2579},{"_2579":9918,"_2420":2579,"_3365":9919},"0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9",{"_3351":3367},{"_950":9921,"_2420":2570,"_3203":9922,"_2571":9923},"e035cca7-d2d0-4f0a-af47-4c08b85c2523",{"_3205":591},[],{"_950":9925,"_2420":2570,"_3203":9926,"_2571":9927},"d8be1cb0-f051-4e25-b3f3-54cfb8133de2",{"_3205":591},[9928],{"_2579":9929,"_2420":2579},"반면 금융 기관 간 대규모 자금 정산을 겨냥한 보자기 프로토콜은 도장과 달리 완전한 폐쇄형으로 운영되는 영지식 증명(ZKP) 기반 프라이버시 엔진입니다. 거래 금액과 송수신자의 신원을 온체인에서 완전히 은닉하면서 은행 비밀주의 규제를 충족합니다. 실제로 보자기는 하나금융그룹과의 예금 토큰 기반 해외 송금 개념 검증(PoC)에 성공적으로 적용되며 기존 스위프트 통신망을 대체할 수 있는 기술적 실현 가능성을 입증했습니다. 개발자에게 열린 도장 프로토콜과 금융 기관을 위한 보자기 프로토콜이 투트랙으로 가동되면서 기와 체인만의 고유한 신뢰 아키텍처가 형성됩니다.",{"_950":9931,"_2420":2570,"_3203":9932,"_2571":9933},"b3cdbd92-94b0-4e70-a6d4-5853eaa25448",{"_3205":591},[],{"_950":9935,"_2420":2575,"_2576":2007,"_3203":9936,"_2571":9937},"4b8b0a30-0093-4254-b3c5-a2e9e6b73170",{"_3205":591},[9938],{"_2579":9939,"_2420":2579},"L2 개발 시 빠지기 쉬운 세 가지 함정과 대응 전략",{"_950":9941,"_2420":2570,"_3203":9942,"_2571":9943},"86c2ee4c-f7d7-44fd-91dd-455fa25e0423",{"_3205":591},[],{"_950":9945,"_2420":2570,"_3203":9946,"_2571":9947},"11b02d59-8827-44fb-8e5e-b840b3ac4c84",{"_3205":591},[9948],{"_2579":9949,"_2420":2579},"이더리움 레이어 2 생태계의 기술적 성숙도와 관계없이, 메인넷 프로덕션 배포를 준비하는 빌더는 오프체인 실행 모델의 특수성을 고려해야 합니다. 단순히 EVM 호환성만 믿고 스마트 컨트랙트를 배포했다가 시스템 아키텍처 수준에서 심각한 병목이나 보안 허점을 마주하기 쉽습니다. 안정적인 서비스를 빌드하기 위해 사전에 반드시 검증해야 할 세 가지 핵심 리스크는 다음과 같습니다.",{"_950":9951,"_2420":2570,"_3203":9952,"_2571":9953},"f2721e66-62f0-4dc6-94ac-abc831b4aac7",{"_3205":591},[],{"_950":9955,"_2420":2570,"_3203":9956,"_2571":9957},"8b4e50ab-e014-40ab-9ca3-153f222ede1e",{"_3205":591},[9958,9960,9963],{"_2579":9959,"_2420":2579},"첫째, ",{"_2579":9961,"_2420":2579,"_3365":9962},"시퀀서의 즉각 승인과 L1 최종성 완결의 불일치",{"_3485":3367},{"_2579":9964,"_2420":2579},"입니다. L2 시퀀서가 트랜잭션을 수신하고 제공하는 즉각적인 응답은 소프트 컨펌일 뿐입니다. 데이터가 이더리움 메인넷에 배치 형태로 제출되고 합의가 최종 완결될 때까지는 상당한 시간 차가 존재합니다. 고액 자산 전송이나 최종 승인이 중요한 서비스라면 시퀀서 승인 즉시 트랜잭션을 완전히 끝난 것으로 처리해서는 안 되며, L1 상태 정착 단계를 추적하는 예외 처리 비즈니스 로직을 구현해야 합니다.",{"_950":9966,"_2420":2570,"_3203":9967,"_2571":9968},"42e8116a-f9d7-4abc-aa8a-5b303466db2d",{"_3205":591},[],{"_950":9970,"_2420":2570,"_3203":9971,"_2571":9972},"79820d04-9d78-43c8-b96f-1b57ed4ab80d",{"_3205":591},[9973,9975,9978],{"_2579":9974,"_2420":2579},"둘째, ",{"_2579":9976,"_2420":2579,"_3365":9977},"브릿지 아키텍처의 유동성 제약과 지연 시간",{"_3485":3367},{"_2579":9979,"_2420":2579},"입니다. 옵티미스틱 롤업 계열의 네트워크는 L1으로 자금을 돌려보낼 때 7일간의 분쟁 기간이 강제됩니다. 고속 출금을 지원하는 타사 브릿지 프로토콜에 의존하더라도 대규모 자금 이동 시 유동성 풀이 일시 고갈되는 위험을 상정해야 합니다. 서비스 설계 시 출금 대기 시간 동안 사용자가 겪을 경험과 브릿지 수수료 변동성을 감당할 수 있는지 기술적 대안을 세워두어야 합니다.",{"_950":9981,"_2420":2570,"_3203":9982,"_2571":9983},"38dfab41-4986-4a26-ad77-22f4d3ca103d",{"_3205":591},[],{"_950":9985,"_2420":2570,"_3203":9986,"_2571":9987},"56d70ada-f8ff-462f-b6b0-b201a4c06d2b",{"_3205":591},[9988,9990,9993],{"_2579":9989,"_2420":2579},"셋째, ",{"_2579":9991,"_2420":2579,"_3365":9992},"시퀀서의 단일 실패 지점과 업그레이드 키 보안 권한",{"_3485":3367},{"_2579":9994,"_2420":2579},"입니다. 대다수 L2 체인은 초기 활성화를 위해 중앙화된 오프체인 시퀀서와 다중 서명 키를 활용한 컨트랙트 업그레이드 권한을 보유하고 있습니다. 시퀀서가 비활성화되었을 때 트랜잭션을 L1으로 직접 강제 제출할 수 있는 비상 탈출구 기능이 열려 있는지, 핵심 브릿지 컨트랙트를 통제하는 다중 서명의 주체와 소유 구조가 충분히 신뢰할 수 있는지 프로덕션 이전에 투명하게 파악해 검증해야 합니다.",{"_950":9996,"_2420":2570,"_3203":9997,"_2571":9998},"2be99edf-808d-4794-a4cf-20f22b0bb3d6",{"_3205":591},[],{"_950":10000,"_2420":2575,"_2576":2007,"_3203":10001,"_2571":10002},"696fdede-8eb1-40ee-905a-7e106442084b",{"_3205":591},[10003],{"_2579":10004,"_2420":2579},"프로덕션 배포를 위한 개발자 의사결정 프레임워크",{"_950":10006,"_2420":2570,"_3203":10007,"_2571":10008},"f8f5d354-c16d-4b3b-b608-2cd08a6a41d8",{"_3205":591},[],{"_950":10010,"_2420":2570,"_3203":10011,"_2571":10012},"4823d496-0db3-45a7-8e98-97d581099bc2",{"_3205":591},[10013],{"_2579":10014,"_2420":2579},"이제 이더리움 레이어 2 선택의 기준은 단순한 가스비 절감에서 애플리케이션의 고유 요구사항에 맞는 아키텍처 최적화로 완전히 전환되었습니다. 극대화된 가스 수수료 대납 구조와 매끄러운 사용자 경험이 핵심이라면 Reth V2 기반의 네이티브 계정 추상화를 지원하는 Base Cobalt가 적합하며, Rust 기반의 고성능 연산과 프로토콜 수준의 규제 필터링이 요구된다면 Arbitrum Elara가 확실한 대안입니다. 한편 국내 제도권 금융 기관과의 연동이나 신뢰할 수 있는 온체인 신원 인증 체계가 필요하다면 GIWA 체인의 도장 생태계를 적극적으로 검증해야 합니다. 각 실행 클라이언트가 제공하는 기술적 강점을 명확히 인지하고 제품 스펙에 맞춤화된 네트워크를 선택할 때 프로덕션 단계의 아키텍처 리스크를 완벽히 통제할 수 있습니다.",{"_950":10016,"_2420":2570,"_3203":10017,"_2571":10018},"aa6d1d98-a450-460f-b365-3408f5669b76",{"_3205":591},[],{"_950":10020,"_2420":3473},"1b10fc9d-d250-462a-856d-8dd3a7b3e888",{"_950":10022,"_2420":2570,"_3203":10023,"_2571":10024},"62ae953e-273e-4c20-b0cc-7d4869346297",{"_3205":591},[],{"_950":10026,"_2420":2570,"_3203":10027,"_2571":10028},"fbec8666-554e-4087-8ed8-12172acf24d0",{"_3205":591},[10029],{"_2579":3483,"_2420":2579,"_3365":10030},{"_3485":3367},{"_950":10032,"_2420":2570,"_3203":10033,"_2571":10034},"ab8c9935-e030-43a5-9997-1024f827d4af",{"_3205":591},[],{"_950":10036,"_1881":3492,"_2420":3493,"_778":10037},"47a2841b-7700-4d14-a2a8-231105808de3",[10038,10046],{"_950":10039,"_2571":10040},"3c2b7700-9143-4fe4-a59f-22dfd21d08f4",[10041],{"_3499":10042,"_2420":3501,"_3502":10043},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFCGnR-Ulq2FMQUZEA_bXv2iUHhaL9x0cG_7G4medqqq7_iDq_fdpYb9zozrW4JLC9CXmKICb3UJUwZr3iHH3FqKqaH11yj2jHVeZL7",[10044],{"_2579":10045,"_2420":2579},"Base Engineering — Base Cobalt and EIP-8130 Native Account Abstraction Technical Architecture",{"_950":10047,"_2571":10048},"f302f27c-7e82-45c6-b409-1f6040710df1",[10049],{"_3499":10050,"_2420":3501,"_3502":10051},"https://github.com/base/eip-8130",[10052],{"_2579":10053,"_2420":2579},"Base Engineering — Base Cobalt Native Account Abstraction (EIP-8130 / EIP-8140)",{"_950":10055,"_2420":2570,"_3203":10056,"_2571":10057},"82fc7130-9469-460f-8690-d4cd00dea3e8",{"_3205":591},[],{"_9945":10059,"_9797":10063,"_9781":10088,"_9761":10092,"_10036":10096,"_10010":10101,"_9688":10105,"_9935":10109,"_9985":10113,"_10118":10119,"_10000":10122,"_9617":10126,"_10130":10131,"_9698":10140,"_9970":10144,"_9751":10149,"_9955":10153,"_9708":10158,"_9607":10162,"_9588":10166,"_9871":10168,"_9718":10173,"_9678":10184,"_9865":10188,"_10192":10193,"_9771":10202,"_9741":10206,"_9925":10210,"_9657":10214,"_9597":10219,"_9791":10223,"_9627":10227,"_10026":10232},{"_2571":10060},{"_1892":10061,"_1893":10062,"_1802":9949},"Regardless of the technical maturity of the Ethereum Layer 2 ecosystem, builders preparing for mainnet production must consider the unique nature of off-chain execution models. Relying solely on EVM compatibility without due diligence can lead to significant bottlenecks or security vulnerabilities at the architectural level. To build stable services, consider these three core risks that must be validated in advance:","イーサリアムL2エコシステムの技術的成熟度に関わらず、メインネットでの本番デプロイを準備するビルダーは、オフチェーン実行モデルの特殊性を考慮しなければなりません。単にEVM互換性を信じてスマートコントラクトをデプロイすると、システムアーキテクチャレベルで深刻なボトルネックやセキュリティの穴に直面しやすくなります。安定したサービスを構築するために、事前に必ず検証すべき3つの核心リスクは以下の通りです。",{"_10064":10065,"_10066":10067,"_10070":10071,"_10072":10073,"_10074":10075,"_10078":10079,"_10080":10081,"_10082":10083,"_10086":10087},"row:0:cell:0",{"_1892":9809,"_1893":9809,"_1802":9809},"row:0:cell:1",{"_1892":10068,"_1893":10069,"_1802":9815},"Core engine for attestation issuance and verification","証明書発行および検証の核心エンジン","row:0:cell:2",{"_1892":6969,"_1893":6969,"_1802":6969},"row:1:cell:0",{"_1892":9827,"_1893":9827,"_1802":9827},"row:1:cell:1",{"_1892":10076,"_1893":10077,"_1802":9833},"Registration and lookup for attestation formats","証明書フォームの登録と照会","row:1:cell:2",{"_1892":6974,"_1893":6974,"_1802":6974},"row:2:cell:0",{"_1892":9845,"_1893":9845,"_1802":9845},"row:2:cell:1",{"_1892":10084,"_1893":10085,"_1802":9851},"Integrated lookup tool for on-chain attestation data","オンチェーン証明データの統合照会ツール","row:2:cell:2",{"_1892":6984,"_1893":6984,"_1802":6984},{"_2571":10089},{"_1892":10090,"_1893":10091,"_1802":9785},"The key Dojang contracts deployed in the GIWA Sepolia environment and their essential Schema UID information are as follows.","GIWA Sepolia環境に搭載された主要なDojangコントラクトと、主要なスキーマ識別子（Schema UID）の設定情報は以下の通りです。",{"_2571":10093},{"_1892":10094,"_1893":10095,"_1802":9765},"The GIWA Chain, led by Dunamu, is a Layer 2 network that adopts the Self-Managed tier of Optimism Enterprise. To balance the openness of the public ecosystem with financial institution-grade regulatory compliance, it integrates Dojang (the on-chain identity layer) and Bojagi (a privacy-specific protocol) into its core architecture. By implementing 1-second block times and low gas fees under 1 KRW, it seamlessly connects institutional finance with high-performance dApps.","Dunamuが主導するGIWAチェーンは、Optimismエンタープライズのセルフマネージド（Self-Managed）ティアを採用したL2ネットワークです。パブリックエコシステムの開放性と、金融機関レベルの規制遵守能力を両立させるため、オンチェーン認証レイヤー「Dojang（道場）」とプライバシー専用プロトコル「Bojagi（風呂敷）」を核心アーキテクチャに組み込みました。1秒のブロックタイムと1ウォン未満の低コストなガス代を実現し、制度金融と高性能DAppをシームレスに結びつけます。",{"_10097":10098,"_10099":10100},"item:3c2b7700-9143-4fe4-a59f-22dfd21d08f4",{"_1892":10045,"_1893":10045,"_1802":10045},"item:f302f27c-7e82-45c6-b409-1f6040710df1",{"_1892":10053,"_1893":10053,"_1802":10053},{"_2571":10102},{"_1892":10103,"_1893":10104,"_1802":10014},"The criteria for choosing an Ethereum Layer 2 have shifted from mere gas fee reduction to architectural optimization that aligns with unique application requirements. If maximizing gas fee sponsorship and smooth user experience is the priority, Base Cobalt—which supports Reth V2-based native account abstraction—is the right fit. If high-performance computation based on Rust and protocol-level regulatory filtering are required, Arbitrum Elara is a clear alternative. Meanwhile, if you need integration with domestic institutional finance or a reliable on-chain identity authentication system, you should actively validate the Dojang ecosystem of the GIWA Chain. By clearly understanding the technical strengths offered by each execution client and selecting a network customized to your product specifications, you can effectively control architectural risks at the production stage.","現在、イーサリアムL2を選択する基準は、単なるガス代の節約から、アプリケーション固有の要求に応じたアーキテクチャの最適化へと完全に移行しました。極限までガス代を代行する構造とシームレスなユーザー体験が鍵であればReth v2ベースのネイティブAAをサポートするBase Cobaltが適しており、Rustベースの高性能な演算やプロトコルレベルの規制フィルタリングが求められるならArbitrum Elaraが確実な代替案です。また、国内の制度金融機関との連携や信頼性の高いオンチェーンID認証体系が必要であれば、GIWAチェーンのDojangエコシステムを積極的に検証すべきです。各実行クライアントが提供する技術的強みを明確に把握し、製品スペックに合わせたネットワークを選択することで、本番段階でのアーキテクチャリスクを完全にコントロールすることができます。",{"_2571":10106},{"_1892":10107,"_1893":10108,"_1802":9692},"Arbitrum ArbOS 61 Elara: 96KB Stylus and the Introduction of Regulatory Filtering","Arbitrum ArbOS 61 Elara — 96KB Stylusと規制フィルタリングの導入",{"_2571":10110},{"_1892":10111,"_1893":10112,"_1802":9939},"Three Common Pitfalls in L2 Development and Mitigation Strategies","L2開発で陥りやすい3つの落とし穴と対応戦略",{"_2571":10114},{"_1892":10115,"_1893":10116,"_1802":10117},"Third, the sequencer single point of failure and upgrade key security. For initial activation, most L2 chains utilize centralized off-chain sequencers and grant contract upgrade authority to multi-sig keys. Before production, you must transparently identify and verify whether there is an 'emergency escape' function that allows for forced transaction submission directly to L1 if the sequencer goes offline, and ensure the ownership structure of the multi-sig keys controlling core bridge contracts is sufficiently trustworthy.","第三に、シーケンサーの単一障害点（SPOF）とアップグレードキーのセキュリティ権限です。大半のL2チェーンは、初期アクティベーションのために中央集権的なオフチェーンシーケンサーと、マルチシグ鍵を用いたコントラクトアップグレード権限を保持しています。シーケンサーが非活性化された際に、トランザクションをL1に直接強制提出できるエマージェンシー・エグジット（緊急脱出）機能が備わっているか、また、基幹ブリッジコントラクトを制御するマルチシグの主体と所有構造が十分に信頼できるものか、本番デプロイ前に透明性を確保し検証する必要があります。","셋째, 시퀀서의 단일 실패 지점과 업그레이드 키 보안 권한입니다. 대다수 L2 체인은 초기 활성화를 위해 중앙화된 오프체인 시퀀서와 다중 서명 키를 활용한 컨트랙트 업그레이드 권한을 보유하고 있습니다. 시퀀서가 비활성화되었을 때 트랜잭션을 L1으로 직접 강제 제출할 수 있는 비상 탈출구 기능이 열려 있는지, 핵심 브릿지 컨트랙트를 통제하는 다중 서명의 주체와 소유 구조가 충분히 신뢰할 수 있는지 프로덕션 이전에 투명하게 파악해 검증해야 합니다.","63206dd6-e282-41c9-8e67-3d952f6d82e8",{"_10097":10120,"_10099":10121},{"_1892":10045,"_1893":10045,"_1802":10045},{"_1892":10053,"_1893":10053,"_1802":10053},{"_2571":10123},{"_1892":10124,"_1893":10125,"_1802":10004},"Decision-Making Framework for Production Deployment","本番デプロイのための開発者の意思決定フレームワーク",{"_2571":10127},{"_1892":10128,"_1893":10129,"_1802":9621},"The Cobalt hard fork, scheduled for September 2026 on Base, is set to fundamentally overhaul how smart contract wallets operate. The core of this change lies in the direct integration of EIP-8130 native Account Abstraction (AA) into the Reth V2 execution client. The existing ERC-4337 standard relies on a complex structure where off-chain bundlers aggregate user requests, forward them to an EntryPoint contract, and trigger EVM loops for verification. This inherently leads to significant gas fee overhead and transaction latency.","Baseが2026年9月に導入予定のCobaltハードフォークは、既存のスマートコントラクトウォレットの仕組みを根本から変えるでしょう。その核心は、Reth v2実行クライアントにEIP-8130ネイティブ・アカウント抽象化（AA）を直接統合することにあります。従来のERC-4337標準では、オフチェーンのバンドラーがユーザーの要求をまとめてEntryPointコントラクトに送信し、それをEVMループで検証するという複雑な構造でした。このため、ガスのオーバーヘッドやトランザクションの遅延が避けられませんでした。","6b6687c2-9744-45a4-9d60-4c97ef0e4e40",{"_10132":10133,"_10136":10137},"item:8daf6ef2-39e2-49d2-bafa-ecc438522405",{"_1892":9877,"_1893":10134,"_1802":10135},"Verified Address（認証済みウォレット）","Verified Address (검증 완료 지갑)","item:d5afe085-b78a-4a1f-9728-e11a563dda42",{"_1892":9901,"_1893":10138,"_1802":10139},"Verified Balance（認証済み残高）","Verified Balance (검증 완료 잔고)",{"_2571":10141},{"_1892":10142,"_1893":10143,"_1802":9702},"The ArbOS 61 Elara upgrade for Arbitrum is a major turning point for both developers writing high-performance Rust smart contracts and builders constructing enterprise app-chains. This upgrade requires Nitro v3.11.0 and significantly increases the size limit for WebAssembly (WASM)-based Stylus contracts, while introducing compliance tools for transaction control at the protocol level.","ArbitrumのArbOS 61「Elara」アップグレードは、高性能なRustスマートコントラクトを書く開発者にとっても、エンタープライズAppChainを構築するビルダーにとっても重要な転換点です。今回のアップグレードはNitro v3.11.0を必要とし、WebAssembly（WASM）ベースのStylusコントラクトのサイズ制限を大幅に拡大すると同時に、プロトコルレベルでトランザクションを制御できるコンプライアンスツールを前面に打ち出しています。",{"_2571":10145},{"_1892":10146,"_1893":10147,"_1802":10148},"Second, liquidity constraints and latency in bridge architecture. Optimistic Rollup networks enforce a 7-day challenge period when moving funds back to L1. Even if you rely on third-party bridge protocols that support fast withdrawals, you must account for the risk of liquidity pools being temporarily exhausted during large fund movements. When designing your service, establish technical alternatives to manage user experience during withdrawal wait times and volatility in bridge fees.","第二に、ブリッジアーキテクチャの流動性の制約と遅延時間です。Optimistic Rollup系のネットワークでは、L1に資金を戻す際に7日間の紛争期間が強制されます。高速出金をサポートするサードパーティのブリッジプロトコルに依存する場合でも、大規模な資金移動時に流動性プールが一時的に枯渇するリスクを想定しておくべきです。サービス設計時には、出金待ち時間中にユーザーが経験する体験と、ブリッジ手数料の変動を許容できるかどうかの技術的代替案を用意する必要があります。","둘째, 브릿지 아키텍처의 유동성 제약과 지연 시간입니다. 옵티미스틱 롤업 계열의 네트워크는 L1으로 자금을 돌려보낼 때 7일간의 분쟁 기간이 강제됩니다. 고속 출금을 지원하는 타사 브릿지 프로토콜에 의존하더라도 대규모 자금 이동 시 유동성 풀이 일시 고갈되는 위험을 상정해야 합니다. 서비스 설계 시 출금 대기 시간 동안 사용자가 겪을 경험과 브릿지 수수료 변동성을 감당할 수 있는지 기술적 대안을 세워두어야 합니다.",{"_2571":10150},{"_1892":10151,"_1893":10152,"_1802":9755},"GIWA Chain: Enterprise Identity and Privacy via Dojang and Bojagi","GIWAチェーン — DojangとBojagiで実現するエンタープライズID管理とプライバシー",{"_2571":10154},{"_1892":10155,"_1893":10156,"_1802":10157},"First, the discrepancy between immediate sequencer approval and L1 finality. The immediate response provided by an L2 sequencer upon receiving a transaction is merely a 'soft confirmation.' There is a significant time gap until data is bundled and submitted to the Ethereum mainnet for final settlement. For services where high-value asset transfers or definitive approvals are critical, do not treat transactions as complete immediately upon sequencer approval. Instead, implement exception-handling business logic that tracks the L1 state settlement phase.","第一に、シーケンサーによる即時承認とL1の最終確定（ファイナリティ）の不一致です。L2シーケンサーがトランザクションを受信して提供する即時の応答は、単なる「ソフトコンファーム（仮承認）」に過ぎません。データがイーサリアムメインネットにバッチとして送信され、合意が最終的に完了するまでにはかなりの時間差が存在します。高額送金や最終的な承認が重要なサービスの場合、シーケンサーの承認をもって直ちにトランザクションが完全に終了したとみなしてはならず、L1へのステータス反映段階を追跡する例外処理ビジネスロジックを実装する必要があります。","첫째, 시퀀서의 즉각 승인과 L1 최종성 완결의 불일치입니다. L2 시퀀서가 트랜잭션을 수신하고 제공하는 즉각적인 응답은 소프트 컨펌일 뿐입니다. 데이터가 이더리움 메인넷에 배치 형태로 제출되고 합의가 최종 완결될 때까지는 상당한 시간 차가 존재합니다. 고액 자산 전송이나 최종 승인이 중요한 서비스라면 시퀀서 승인 즉시 트랜잭션을 완전히 끝난 것으로 처리해서는 안 되며, L1 상태 정착 단계를 추적하는 예외 처리 비즈니스 로직을 구현해야 합니다.",{"_2571":10159},{"_1892":10160,"_1893":10161,"_1802":9712},"Developers should pay particular attention to the difference in contract size limits compared to existing virtual machines.","特に開発者が注目すべきは、従来の仮想マシンとのコントラクトサイズ制限の差です。",{"_2571":10163},{"_1892":10164,"_1893":10165,"_1802":9611},"Base Cobalt and EIP-8130: Native AA Without Bundlers","Base CobaltとEIP-8130 — バンドラーが消えるネイティブAA",{"_2571":10167},{"_1892":9507,"_1893":9508,"_1802":9509},{"_10132":10169,"_10136":10171},{"_1892":9877,"_1893":10170,"_1802":10135},"Verified Address（検証済みウォレット）",{"_1892":9901,"_1893":10172,"_1802":10139},"Verified Balance（検証済み残高）",{"_10174":10175,"_10179":10180},"item:60b87aa5-01a5-4bdf-95c2-23307ff7ac83",{"_1892":10176,"_1893":10177,"_1802":10178},"EVM Bytecode Limit (24KB): The standard Ethereum Virtual Machine strictly limits smart contract bytecode size to 24KB according to EIP-170. This creates architectural debt, forcing developers to split contracts and rely on complex delegate calls to accommodate large business logic or sophisticated cryptographic algorithms.","EVMバイトコードの制限（24KB）：標準的なイーサリアム仮想マシンは、EIP-170規格によりスマートコントラクトのバイトコードサイズを最大24KBに厳しく制限しています。そのため、大規模なビジネスロジックや高度な暗号アルゴリズムを実装する場合、コントラクトを分割し、委任呼び出し（delegatecall）を複雑に組み合わせるというアーキテクチャ上の負債が発生します。","EVM 바이트코드 한계 (24KB): 표준 이더리움 가상머신은 EIP-170 규격에 따라 스마트 컨트랙트의 바이트코드 크기를 최대 24KB로 엄격히 제약합니다. 이 때문에 대규모 비즈니스 로직이나 고난도 암호학 알고리즘을 담으려면 컨트랙트를 강제로 분할하고 위임 호출을 복잡하게 엮어야 하는 아키텍처적 부채가 발생합니다.","item:e2aec82d-f89c-4426-99bf-4d9a3af5dc2b",{"_1892":10181,"_1893":10182,"_1802":10183},"Stylus WASM Size Limit (96KB): With the Elara upgrade, the Stylus contract size limit has been increased to 96KB. Binaries produced by the Rust compiler tend to be larger than EVM bytecode. With this restriction eased, developers can freely import external crates and focus on logic implementation and cryptographic computations rather than size optimization.","Stylus WASMのサイズ制限（96KB）：Elaraアップグレードにより、Stylusコントラクトのサイズ制限が96KBに拡大されました。Rustコンパイラが生成するバイナリはEVMバイトコードよりもサイズが大きくなりやすい傾向があります。この制限緩和により、開発者は外部クレートを自由に利用でき、サイズ最適化の代わりにロジックの実装や暗号学的演算そのものに集中できるようになりました。","Stylus WASM 크기 한계 (96KB): 엘라라 업그레이드를 통해 Stylus 컨트랙트의 크기 제한이 96KB로 늘어났습니다. 러스트 컴파일러가 생성하는 바이너리는 EVM 바이트코드보다 용량이 커지기 쉬운 특성이 있습니다. 제한이 완화되면서 개발자는 외부 크레이트를 자유롭게 가져다 쓰며 크기 최적화 대신 로직 구현과 암호학 연산 자체에 집중할 수 있게 되었습니다.",{"_2571":10185},{"_1892":10186,"_1893":10187,"_1802":9682},"This new native account abstraction flow not only slashes gas costs by over 60% but also eliminates the maintenance burden for developers who previously had to operate off-chain bundler or relayer infrastructure. You can immediately begin prototyping this high-performance native AA environment on Base Vibenet (chain ID 84538453), the testnet currently provided by Base.","この新しいネイティブAAフローは、ガス代を60%以上劇的に削減するだけでなく、開発者がオフチェーンのバンドラーやリレイヤーインフラを運用しなければならない維持管理の負担を完全に解消します。現在、Baseが提供するテストネット「Base Vibenet」（チェーンID 84538453）にて、この高性能ネイティブAA環境をすぐにプロトタイプ作成可能です。",{"_2571":10189},{"_1892":10190,"_1893":10191,"_1802":9869},"Key Dojang Schema Specifications","主要なDojangスキーマ規格","cc1480fb-8613-4e6f-a3a5-296e8c28d1ac",{"_10174":10194,"_10179":10198},{"_1892":10195,"_1893":10196,"_1802":10197},"EVM Bytecode Limit (24KB): The standard Ethereum Virtual Machine strictly limits smart contract bytecode to 24KB under the EIP-170 standard [research-search-summary:2026-07-24T16:22:39.861Z]. Consequently, incorporating large-scale business logic or complex cryptographic algorithms requires architectural debt, forcing developers to split contracts and use complex delegate calls.","EVMバイトコードの制限（24KB）：標準的なイーサリアム仮想マシンは、EIP-170に基づきコントラクトサイズを最大24KBに厳格に制限しています。そのため、大規模なビジネスロジックや複雑な暗号アルゴリズムを実装するには、コントラクトの分割やデリゲートコールを組み合わせる必要があり、技術的な負債となります。","EVM 바이트코드 한계 (24KB): 표준 이더리움 가상머신은 EIP-170 규격에 따라 스마트 컨트랙트의 바이트코드 크기를 최대 24KB로 엄격히 제약합니다 [research-search-summary:2026-07-24T16:22:39.861Z]. 이 때문에 대규모 비즈니스 로직이나 고난도 암호학 알고리즘을 담으려면 컨트랙트를 강제로 분할하고 위임 호출을 복잡하게 엮어야 하는 아키텍처적 부채가 발생합니다.",{"_1892":10199,"_1893":10200,"_1802":10201},"Stylus WASM Size Limit (96KB): The Elara upgrade increases the size limit for Stylus contracts to 96KB [research-search-summary:2026-07-23T23:42:47.724Z]. Binaries generated by Rust compilers often have a larger footprint than EVM bytecode [research-search-summary:2026-07-24T07:56:02.016Z]. With this limitation relaxed, developers can freely import external crates and focus on logic implementation and cryptographic operations rather than size optimization.","Stylus WASMサイズ制限（96KB）：Elaraアップグレードにより、Stylusコントラクトのサイズ制限が96KBまで拡大されました。Rustコンパイラが生成するバイナリはEVMバイトコードよりも大きくなりやすいため、この制限緩和により、開発者は外部クレートを自由に利用でき、サイズ最適化よりもロジックの実装や暗号計算そのものに集中できるようになりました。","Stylus WASM 크기 한계 (96KB): 엘라라 업그레이드를 통해 Stylus 컨트랙트의 크기 제한이 96KB로 늘어났습니다 [research-search-summary:2026-07-23T23:42:47.724Z]. 러스트 컴파일러가 생성하는 바이너리는 EVM 바이트코드보다 용량이 커지기 쉬운 특성이 있습니다 [research-search-summary:2026-07-24T07:56:02.016Z]. 제한이 완화되면서 개발자는 외부 크레이트를 자유롭게 가져다 쓰며 크기 최적화 대신 로직 구현과 암호학 연산 자체에 집중할 수 있게 되었습니다.",{"_2571":10203},{"_1892":10204,"_1893":10205,"_1802":9775},"The practical tool developers should focus on for the GIWA Sepolia testnet is the Dojang ecosystem, which is based on the Ethereum Attestation Service (EAS) protocol. Dojang issues on-chain attestations that confirm only whether a wallet address has completed KYC, without exposing personal information. Developers do not need to build complex off-chain authentication systems; they can verify a wallet's authentication status instantly via pre-deployed on-chain contracts.","開発者がGIWA Sepoliaテストネットで注目すべき実用的なツールは、EAS（Ethereum Attestation Service）プロトコルベースのDojangエコシステムです。Dojangは、個人情報を露出することなく、ウォレットアドレスのKYC（顧客確認）完了の有無のみを証明するオンチェーンアテステーションを発行します。開発者は複雑なオフチェーン認証システムを一から構築する必要はなく、オンチェーン上にデプロイされたコントラクトを通じて、ウォレットの認証状態を即座に検証できます。",{"_2571":10207},{"_1892":10208,"_1893":10209,"_1802":9745},"In addition, Elara introduces an optional regulatory filtering technology. This feature filters specific addresses at both the sequencer level—where transactions are collected—and the State Transition Function (STF) layer, which finalizes the network state. Because compliance requirements can be handled at the sequencer and protocol engine level, builders no longer need to redundantly write complex address-blocking code within contract logic, offering an attractive architectural choice for designing institutional finance app-chains.","さらにElaraは、オプションとして規制フィルタリング技術を導入しました。この機能は、トランザクションを収集するシーケンサー段階と、ネットワークの状態を最終確定させる状態遷移関数（STF）レイヤーの両方で、特定の住所をフィルタリングします。コントラクト内のロジックに複雑なブロッキングコードを繰り返し書く必要がなく、シーケンサーとプロトコルエンジンレベルで規制要件を処理できるため、制度金融系AppChainを設計するビルダーにとって魅力的なアーキテクチャ上の選択肢となります。",{"_2571":10211},{"_1892":10212,"_1893":10213,"_1802":9929},"In contrast, the Bojagi protocol, aimed at large-scale fund settlement between financial institutions, is a Zero-Knowledge Proof (ZKP)-based privacy engine that operates as a completely closed system. It satisfies bank secrecy regulations by fully concealing transaction amounts and the identities of senders and receivers on-chain. Bojagi has already been successfully applied in a Proof of Concept (PoC) for overseas remittances based on deposit tokens with Hana Financial Group, demonstrating its technical feasibility as a replacement for existing SWIFT networks. The dual-track operation of the open Dojang protocol for developers and the Bojagi protocol for financial institutions forms the unique trust architecture of the GIWA Chain.","一方、金融機関間の大規模な資金決済を目的とするBojagiプロトコルは、Dojangとは異なり、完全に閉鎖的に運用されるゼロ知識証明（ZKP）ベースのプライバシーエンジンです。取引金額や送受信者の身元をオンチェーンで完全に隠蔽し、銀行秘密保持法規制を遵守します。実際、BojagiはHana Financial Groupとの預金トークンベースの海外送金における概念実証（PoC）に成功し、既存のSWIFTネットワークを代替できる技術的実現可能性を証明しました。開発者向けのDojangプロトコルと金融機関向けのBojagiプロトコルが両輪で稼働することで、GIWAチェーン独自の信頼アーキテクチャが形成されます。",{"_2571":10215},{"_1892":10216,"_1893":10217,"_1802":10218},"In an EIP-8130 environment, smart accounts control their interactions by registering signing actors and their corresponding Authenticator units in system contracts. Below is a sample Solidity snippet (based on Solidity v0.8.20) for an environment compliant with EIP-8130, which queries the AccountConfiguration system contract to verify if a specific authenticator meets the network's official specifications.","EIP-8130環境において、スマートアカウントは自身の署名を代行するアクターと、それを検証する認証機（Authenticator）をシステムコントラクトに登録して制御します。以下は、EIP-8130準拠環境でAccountConfigurationシステムコントラクトを参照し、特定の認証機がネットワークの公式規格であるかを検証するSolidity（v0.8.20基準）のサンプルコードです。","EIP-8130 환경에서 스마트 계정은 자신을 대신해 서명할 액터와 이를 검증할 인증기(Authenticator)를 시스템 계약에 등록해 제어합니다. 아래는 EIP-8130 규격을 준수하는 환경에서 AccountConfiguration 시스템 컨트랙트를 조회해 특정 인증기가 네트워크가 허용하는 공식 규격인지 검증하는 솔리디티(Solidity v0.8.20 기준) 예시 코드입니다.",{"_2571":10220},{"_1892":10221,"_1893":10222,"_1802":9601},"The competitive landscape of the Ethereum Layer 2 ecosystem is evolving from simple transaction speed optimization toward directly solving for developer experience and enterprise-grade architecture. In this article, we strip away the marketing narratives and analyze the technical breakthroughs presented by each platform—from Paradigm's Reth v2.4.0 execution client release; Base Cobalt’s implementation of native account abstraction that eliminates the need for bundlers; Arbitrum Elara’s introduction of 96KB WebAssembly smart contracts and regulatory filtering; to the GIWA Chain, which features built-in identity verification and privacy layers tailored for domestic institutional finance standards. We examine the core mechanisms of these Layer 2 architectures and the technical criteria essential for production deployment from the perspective of actual builders.","イーサリアムレイヤー2（L2）エコシステムの競争は、単なるトランザクション処理速度から、開発者体験とエンタープライズアーキテクチャの直接的な課題解決へと進化しています。本記事では、ParadigmのReth v2.4.0実行クライアントのリリースをはじめ、バンドラー不要のネイティブ・アカウント抽象化（AA）を実装するBase Cobalt、96KBのWebAssemblyスマートコントラクトと規制フィルタリングを導入したArbitrum Elara、そして国内の制度金融基準に合わせて本人確認（KYC）とプライバシーレイヤーを内蔵したGIWAチェーンまで、各プラットフォームが提示する技術的な突破口を分析します。マーケティングのナラティブを取り払い、実際のビルダーの視点から、各L2アーキテクチャの主要メカニズムと本番環境へのデプロイ時に必須となる技術選定基準を考察します。",{"_2571":10224},{"_1892":10225,"_1893":10226,"_1802":9795},"GIWA Sepolia Dojang Contracts","GIWA Sepolia Dojangコントラクト",{"_2571":10228},{"_1892":10229,"_1893":10230,"_1802":10231},"The Cobalt architecture, based on EIP-8130, resolves these complex verification steps at the protocol layer. When a user submits the new Type 0x79 transaction, the execution engine—powered by the revmc JIT compiler embedded in Reth v2.4.0—intercepts and verifies the transaction during the node consensus phase. By bypassing heavy EVM execution and referencing the on-chain system contract AccountConfiguration directly at the client-native layer, verification gas costs for smart accounts are reduced to the 21,000 gas level, matching standard Externally Owned Accounts (EOAs).","EIP-8130ベースのCobaltアーキテクチャは、この複雑な検証ステップをプロトコルレイヤーで直接解決します。ユーザーが新しい規格であるType 0x79トランザクションを送信すると、Reth v2.4.0に内蔵されたrevmc JITコンパイラベースの実行エンジンが、ノードの合意形成段階でトランザクションをインターセプトして検証します。負荷の高いEVM実行を回避し、クライアントのネイティブレイヤーでオンチェーンのシステムコントラクト「AccountConfiguration」を参照して即座に検証を行うため、スマートアカウントの検証ガス代はEOA（外部所有アカウント）と同じ21,000ガスまで削減されます。","EIP-8130 기반의 Cobalt 아키텍처는 이 복잡한 검증 단계를 프로토콜 레이어에서 직접 해결합니다. 사용자가 새로운 규격인 Type 0x79 트랜잭션을 제출하면, Reth v2.4.0에 내장된 revmc JIT 컴파일러 기반의 실행 엔진이 노드 합의 단계에서 트랜잭션을 인터셉트하여 검증합니다. 무거운 EVM 구동을 우회하고 클라이언트 네이티브 레이어에서 온체인 시스템 컨트랙트인 AccountConfiguration을 참조해 곧바로 검증하므로, 스마트 계정의 검증 가스 비용이 외부 소유 계정(EOA)과 동일한 21,000 가스 수준으로 줄어듭니다.",{"_2571":10233},{"_1892":3603,"_1893":3604,"_1802":3483},"![Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지](file:cms0o7tsu00py10pbjbfh9p14)\n\n# Reth v2.4.0과 L2의 진화 — 네이티브 AA부터 규제 필터링까지\n\n이더리움 레이어 2 생태계의 경쟁 구도가 단순한 트랜잭션 처리 속도에서 개발자 경험과 엔터프라이즈 아키텍처를 직접 해결하는 방향으로 진화하고 있습니다. 패러다임의 Reth v2.4.0 실행 클라이언트 출시와 더불어, 번들러가 필요 없는 네이티브 계정 추상화를 구현하는 Base Cobalt, 96KB 웹어셈블리 스마트 컨트랙트와 규제 필터링을 도입한 Arbitrum 엘라라, 그리고 국내 제도권 금융 기준에 맞춰 신원 인증과 프라이버시 레이어를 내장한 기와 체인까지 각 플랫폼이 제시하는 기술적 돌파구를 분석합니다. 본 아티클에서는 마케팅 내러티브를 걷어내고, 실제 빌더의 관점에서 각 레이어 2 아키텍처의 핵심 메커니즘과 프로덕션 배포 시 필수적인 기술 선택 기준을 살펴봅니다.\n\n## Base Cobalt와 EIP-8130 — 번들러가 사라지는 네이티브 AA\n\nBase가 2026년 9월 도입 예정인 Cobalt 하드포크는 기존 스마트 계약 지갑의 구동 방식을 완전히 뒤바꿔 놓을 것입니다. 핵심은 Reth V2 실행 클라이언트에 EIP-8130 네이티브 계정 추상화(AA)를 직접 통합하는 데 있습니다. 기존 ERC-4337 표준은 오프체인 번들러가 사용자 요청을 모아 EntryPoint 컨트랙트로 전달하고, 이를 다시 EVM 루프를 돌려 검증하는 복잡한 구조였습니다. 이로 인해 많은 가스 수수료 오버헤드와 트랜잭션 지연이 발생할 수밖에 없었습니다.\n\nEIP-8130 기반의 Cobalt 아키텍처는 이 복잡한 검증 단계를 프로토콜 레이어에서 직접 해결합니다. 사용자가 새로운 규격인 **Type 0x79 트랜잭션**을 제출하면, Reth v2.4.0에 내장된 `revmc` JIT 컴파일러 기반의 실행 엔진이 노드 합의 단계에서 트랜잭션을 인터셉트하여 검증합니다. 무거운 EVM 구동을 우회하고 클라이언트 네이티브 레이어에서 온체인 시스템 컨트랙트인 `AccountConfiguration`을 참조해 곧바로 검증하므로, 스마트 계정의 검증 가스 비용이 외부 소유 계정(EOA)과 동일한 **21,000 가스** 수준으로 줄어듭니다.\n\nEIP-8130 환경에서 스마트 계정은 자신을 대신해 서명할 액터와 이를 검증할 인증기(Authenticator)를 시스템 계약에 등록해 제어합니다. 아래는 EIP-8130 규격을 준수하는 환경에서 `AccountConfiguration` 시스템 컨트랙트를 조회해 특정 인증기가 네트워크가 허용하는 공식 규격인지 검증하는 솔리디티(Solidity v0.8.20 기준) 예시 코드입니다.\n\n```solidity\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n\ninterface IAccountConfiguration {\n function isCanonicalAuthenticator(address authenticator) external view returns (bool);\n}\n\ncontract AccountVerifier {\n address public constant ACCOUNT_CONFIG = 0x0000000000000000000000000000000000008130;\n\n function checkCompliance(address authenticator) external view returns (bool) {\n return IAccountConfiguration(ACCOUNT_CONFIG).isCanonicalAuthenticator(authenticator);\n } \n}\n```\n\n이 새로운 네이티브 계정 추상화 흐름은 가스 비용을 60% 이상 획기적으로 낮출 뿐만 아니라, 개발자가 오프체인 번들러나 릴레이어 인프라를 번거롭게 운영해야 하는 유지보수 부담을 완전히 해결합니다. 현재 Base가 제공하는 테스트넷인 Base Vibenet(체인 ID 84538453)에서 이 고성능 네이티브 AA 환경을 즉시 프로토타이핑할 수 있습니다.\n\n## Arbitrum ArbOS 61 Elara — 96KB Stylus와 규제 필터링의 도입\n\nArbitrum의 ArbOS 61 엘라라 업그레이드는 고성능 러스트 스마트 컨트랙트를 작성하는 개발자와 엔터프라이즈 앱체인을 구축하려는 빌더 모두에게 중요한 전환점입니다. 이번 업그레이드는 Nitro v3.11.0 버전을 요구하며, 웹어셈블리(WASM) 기반의 Stylus 컨트랙트 크기 제한을 크게 늘리는 동시에 프로토콜 수준에서 트랜잭션을 제어할 수 있는 컴플라이언스 도구를 전면에 내세웠습니다.\n\n특히 개발자가 주목해야 할 부분은 기존 가상머신과의 컨트랙트 크기 제한 차이입니다.\n\n- **EVM 바이트코드 한계 (24KB):** 표준 이더리움 가상머신은 EIP-170 규격에 따라 스마트 컨트랙트의 바이트코드 크기를 최대 24KB로 엄격히 제약합니다. 이 때문에 대규모 비즈니스 로직이나 고난도 암호학 알고리즘을 담으려면 컨트랙트를 강제로 분할하고 위임 호출을 복잡하게 엮어야 하는 아키텍처적 부채가 발생합니다.\n- **Stylus WASM 크기 한계 (96KB):** 엘라라 업그레이드를 통해 Stylus 컨트랙트의 크기 제한이 96KB로 늘어났습니다. 러스트 컴파일러가 생성하는 바이너리는 EVM 바이트코드보다 용량이 커지기 쉬운 특성이 있습니다. 제한이 완화되면서 개발자는 외부 크레이트를 자유롭게 가져다 쓰며 크기 최적화 대신 로직 구현과 암호학 연산 자체에 집중할 수 있게 되었습니다.\n\n이와 더불어 엘라라는 옵션 형태로 제공되는 규제 필터링 기술을 새롭게 도입했습니다 이 기능은 트랜잭션을 수집하는 시퀀서 단계와 네트워크의 상태를 최종 확정하는 상태 전이 함수(STF) 레이어 모두에서 특정 주소를 필터링합니다. 컨트랙트 내부 로직에 복잡한 주소 차단 코드를 중복해서 작성할 필요 없이, 시퀀서와 프로토콜 엔진 수준에서 규제 준수 요건을 처리할 수 있어 제도권 금융 앱체인을 설계하는 빌더들에게 매력적인 아키텍처적 선택지를 제공합니다.\n\n## GIWA 체인 — Dojang과 Bojagi로 구현한 엔터프라이즈 신원 및 프라이버시\n\n두나무가 주도하는 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 레이어 2 네트워크입니다. 퍼블릭 생태계의 개방성과 금융 기관 수준의 규제 준수 역량을 동시에 제공하기 위해 온체인 신원 레이어인 도장(Dojang)과 프라이버시 전용 프로토콜인 보자기(Bojagi)를 핵심 아키텍처에 내장했습니다. 1초의 블록 타임과 1원 미만의 저렴한 가스비를 구현하여 제도권 금융과 고성능 디앱을 매끄럽게 연결합니다.\n\n개발자가 기와 세폴리아(GIWA Sepolia) 테스트넷에서 주목해야 할 실질적인 무기는 이더리움 증명 서비스(EAS) 프로토콜 기반의 도장 생태계입니다. 도장은 개인정보 노출 없이 지갑 주소의 고객확인(KYC) 여부만을 증명하는 온체인 증명서(Attestation)를 발행합니다. 개발자는 복잡한 오프체인 인증 시스템을 직접 구축할 필요 없이, 온체인에 미리 배포된 컨트랙트를 통해 지갑의 인증 상태를 즉각적으로 검증할 수 있습니다.\n\n기와 세폴리아 환경에 탑재된 주요 도장 컨트랙트와 핵심 스키마 식별자(Schema UID) 설정 정보는 다음과 같습니다.\n\n### 기와 세폴리아 도장 컨트랙트\n\n| **EAS** | 증명서 발행 및 검증 핵심 엔진 | `0x4200000000000000000000000000000000000021` |\n| **SchemaRegistry** | 증명서 양식 등록 및 조회 | `0x4200000000000000000000000000000000000020` |\n| **DojangScroll** | 온체인 증명 데이터 통합 조회 도구 | `0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9` |\n\n### 핵심 도장 스키마 규격\n\n- **Verified Address** (검증 완료 지갑)\n - 데이터 규격: `bool isVerified`\n - 스키마 식별자: `0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08`\n- **Verified Balance** (검증 완료 잔고)\n - 데이터 규격: `uint256 balance, bytes32 salt, bytes32\\[\\] proofs`\n - 스키마 식별자: `0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9`\n\n반면 금융 기관 간 대규모 자금 정산을 겨냥한 보자기 프로토콜은 도장과 달리 완전한 폐쇄형으로 운영되는 영지식 증명(ZKP) 기반 프라이버시 엔진입니다. 거래 금액과 송수신자의 신원을 온체인에서 완전히 은닉하면서 은행 비밀주의 규제를 충족합니다. 실제로 보자기는 하나금융그룹과의 예금 토큰 기반 해외 송금 개념 검증(PoC)에 성공적으로 적용되며 기존 스위프트 통신망을 대체할 수 있는 기술적 실현 가능성을 입증했습니다. 개발자에게 열린 도장 프로토콜과 금융 기관을 위한 보자기 프로토콜이 투트랙으로 가동되면서 기와 체인만의 고유한 신뢰 아키텍처가 형성됩니다.\n\n## L2 개발 시 빠지기 쉬운 세 가지 함정과 대응 전략\n\n이더리움 레이어 2 생태계의 기술적 성숙도와 관계없이, 메인넷 프로덕션 배포를 준비하는 빌더는 오프체인 실행 모델의 특수성을 고려해야 합니다. 단순히 EVM 호환성만 믿고 스마트 컨트랙트를 배포했다가 시스템 아키텍처 수준에서 심각한 병목이나 보안 허점을 마주하기 쉽습니다. 안정적인 서비스를 빌드하기 위해 사전에 반드시 검증해야 할 세 가지 핵심 리스크는 다음과 같습니다.\n\n첫째, **시퀀서의 즉각 승인과 L1 최종성 완결의 불일치**입니다. L2 시퀀서가 트랜잭션을 수신하고 제공하는 즉각적인 응답은 소프트 컨펌일 뿐입니다. 데이터가 이더리움 메인넷에 배치 형태로 제출되고 합의가 최종 완결될 때까지는 상당한 시간 차가 존재합니다. 고액 자산 전송이나 최종 승인이 중요한 서비스라면 시퀀서 승인 즉시 트랜잭션을 완전히 끝난 것으로 처리해서는 안 되며, L1 상태 정착 단계를 추적하는 예외 처리 비즈니스 로직을 구현해야 합니다.\n\n둘째, **브릿지 아키텍처의 유동성 제약과 지연 시간**입니다. 옵티미스틱 롤업 계열의 네트워크는 L1으로 자금을 돌려보낼 때 7일간의 분쟁 기간이 강제됩니다. 고속 출금을 지원하는 타사 브릿지 프로토콜에 의존하더라도 대규모 자금 이동 시 유동성 풀이 일시 고갈되는 위험을 상정해야 합니다. 서비스 설계 시 출금 대기 시간 동안 사용자가 겪을 경험과 브릿지 수수료 변동성을 감당할 수 있는지 기술적 대안을 세워두어야 합니다.\n\n셋째, **시퀀서의 단일 실패 지점과 업그레이드 키 보안 권한**입니다. 대다수 L2 체인은 초기 활성화를 위해 중앙화된 오프체인 시퀀서와 다중 서명 키를 활용한 컨트랙트 업그레이드 권한을 보유하고 있습니다. 시퀀서가 비활성화되었을 때 트랜잭션을 L1으로 직접 강제 제출할 수 있는 비상 탈출구 기능이 열려 있는지, 핵심 브릿지 컨트랙트를 통제하는 다중 서명의 주체와 소유 구조가 충분히 신뢰할 수 있는지 프로덕션 이전에 투명하게 파악해 검증해야 합니다.\n\n## 프로덕션 배포를 위한 개발자 의사결정 프레임워크\n\n이제 이더리움 레이어 2 선택의 기준은 단순한 가스비 절감에서 애플리케이션의 고유 요구사항에 맞는 아키텍처 최적화로 완전히 전환되었습니다. 극대화된 가스 수수료 대납 구조와 매끄러운 사용자 경험이 핵심이라면 Reth V2 기반의 네이티브 계정 추상화를 지원하는 Base Cobalt가 적합하며, Rust 기반의 고성능 연산과 프로토콜 수준의 규제 필터링이 요구된다면 Arbitrum Elara가 확실한 대안입니다. 한편 국내 제도권 금융 기관과의 연동이나 신뢰할 수 있는 온체인 신원 인증 체계가 필요하다면 GIWA 체인의 도장 생태계를 적극적으로 검증해야 합니다. 각 실행 클라이언트가 제공하는 기술적 강점을 명확히 인지하고 제품 스펙에 맞춤화된 네트워크를 선택할 때 프로덕션 단계의 아키텍처 리스크를 완벽히 통제할 수 있습니다.\n\n---\n\n**참고 링크**\n\n- [Base Engineering — Base Cobalt and EIP-8130 Native Account Abstraction Technical Architecture](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFCGnR-Ulq2FMQUZEA_bXv2iUHhaL9x0cG_7G4medqqq7_iDq_fdpYb9zozrW4JLC9CXmKICb3UJUwZr3iHH3FqKqaH11yj2jHVeZL7)\n- [Base Engineering — Base Cobalt Native Account Abstraction (EIP-8130 / EIP-8140)](https://github.com/base/eip-8130)","6ece24123b1ae4a7caa07b10b14ed63a9061859de7218c61a2825a9727134dda","2026-07-25T14:06:28.647Z","2026-07-28T05:44:42.941Z",[],[],{"_950":10241,"_2416":3098,"_2418":2803,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":10242,"_1889":10250,"_2455":-5,"_2456":-5,"_2457":-5,"_9":10254,"_2450":10262,"_2458":10263,"_2460":-5,"_723":10264,"_1886":10265,"_332":10267,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":10268,"_2003":10269,"_2480":10270,"_2482":10271,"_2483":10272,"_2485":-5,"_2486":-5,"_2487":10273,"_1144":10283,"_2527":10296,"_2555":-5,"_2556":10318,"_2798":10850,"_266":10851},"cms2bcrh700ff10nhug0mncwz",{"_1801":1802,"_214":10243,"_2429":10244,"_2434":10247,"_2438":2439},4051,{"_1892":10245,"_1893":1997,"_1802":10246,"_2433":1997},1395,2656,{"_1892":10248,"_1893":1997,"_1802":10249,"_2433":1997},0.34435941742779563,0.6556405825722044,{"_9":10251,"_2445":10255,"_2450":10259},{"_1892":10252,"_1893":10253,"_1802":10254},"Fastify 5.10 Practical Guide — Encapsulation Architecture and Schema Validation","Fastify 5.10 実践ガイド — カプセル化アーキテクチャとスキーマバリデーション","Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증",{"_1892":10256,"_1893":10257,"_1802":10258},"Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증\n\nFastify 5.10 Practical Guide — Encapsulation Architecture and Schema Validation\n\nFastify is one of the most trusted frameworks for building high-performance API servers in the Node.js backend ecosystem. The recently released Fastify v5.10 maximizes performance by adding runtime log level control and optimizing the request lifecycle, while boldly shedding technical debt from previous versions. In this article, we will take an in-depth look at the key changes in Fastify v5.10 and how to implement it in practice for developers looking to strip away complex structures and build a fast, secure architecture.\n\nKey Changes and Migration in Fastify v5.10\n\nThe Fastify v5 lineup addresses long-standing API debt and mandates Node.js v20 or higher as a requirement. The most significant change impacting backward compatibility is the complete discontinuation of the previously flexible shorthand schema support. From now on, you must strictly adhere to the standard JSON Schema format when defining schemas.\n\nIn v4, the framework would handle omitted properties at the root level of a schema, but now you must explicitly define type: 'object' and properties for validation target roots like body, querystring, params, and response to avoid compilation errors. Additionally, previous wildcard path matching has been completely removed, so you should carefully review your route definitions during migration.\n\n// Fastify v5 기준 명시적 스키마 정의\nconst schema = {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n};\n\nfastify.post('/user', { schema }, async (request, reply) => {\n return { status: 'ok' };\n});\n\nBeyond these structural cleanups, the new features in v5.10 are also noteworthy. The most convenient change is the addition of a 'Log Controller Layer,' which allows you to dynamically alter logging behavior at runtime. This enables real-time log level switching without restarting the service, making it highly useful for urgent troubleshooting and debugging in production environments.\n\nSimultaneously, overhead in the internal request lifecycle has been significantly improved. This optimization, led by core architect Matteo Collina, simplifies unnecessary computation steps to maximize throughput per unit time. As a result, you can maintain stable services with minimal latency even in high-load API environments.\n\nUnderstanding Plugin Encapsulation and the Avvio Architecture\n\nThe core design supporting Fastify’s exceptional performance and stability is the Directed Acyclic Graph (DAG) architecture managed by the Avvio package. Unlike NestJS 12, which uses decorator metadata and dependency injection containers to analyze complex object graphs at runtime, Fastify hierarchically isolates contexts based on Node.js’s native lexical scope rules [2]. Consequently, there is no runtime overhead from complex dependency analysis or reflection, allowing for extremely fast application startup times.\n\nIn Fastify, every plugin and module is created as an independent child context via the register() method [2]. Hooks, decorators, and routes registered in a subtree are not propagated to parent or sibling contexts, but are safely isolated within the child tree. This isolation allows you to implement independent domain services safely without polluting each other's state, even in large-scale applications.\n\nHowever, resources that must be safely shared across the entire application, such as database clients, must break this isolation and be bound directly to the global context. The tool used for this is the fastify-plugin package. By wrapping a plugin with this package, Fastify does not create a new context, and instead safely propagates decorators registered in the child to the parent context.\n\nThe standard example for safely injecting a Prisma client globally is as follows:\n\nimport fp from 'fastify-plugin';\nimport { PrismaClient } from '@prisma/client';\n\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: PrismaClient;\n }\n}\n\nexport default fp(async (fastify) => {\n const prisma = new PrismaClient();\n fastify.decorate('db', prisma);\n fastify.addHook('onClose', async (instance) => {\n await instance.db.$disconnect();\n });\n});\n\nThis pattern is a key technique in the Fastify ecosystem for easily referencing database or external service modules from all routes. Thanks to an architecture that treats isolation as the default principle while allowing flexible shared environments only where needed, you can build a flexible and highly scalable structure.\n\nEnsuring Type Safety with TypeBox and Prisma\n\nThe secret behind Fastify’s superior performance compared to other frameworks lies in its schema-based pre-compilation design. When the application starts, Fastify builds optimized serialization and Ajv validation functions based on predefined JSON schemas. Because it does not dynamically parse or analyze objects at runtime, it can process every request extremely efficiently.\n\nHowever, this powerful schema design can severely degrade developer experience if types must be managed in duplicate for TypeScript environments. The optimal combination that cleanly solves this problem is the pattern using TypeBox and Prisma together.\n\nApplying @fastify/type-provider-typebox allows you to generate an Ajv compiler for runtime validation from a single source schema, while simultaneously and safely inferring static TypeScript types. It is a structure that grants powerful type safety with one click, without redundant code.\n\nimport { Type } from '@sinclair/typebox';\n\n// 1. 단일 스키마 정의로 검증과 정적 타입 일치화\nexport const CreateUserSchema = Type.Object({\n email: Type.String({ format: 'email' }),\n name: Type.String()\n});\n\n// 2. TypeBox 프로바이더로 정적 타입 자동 추론 및 Prisma 연동\nfastify.withTypeProvider().post('/users', {\n schema: { body: CreateUserSchema }\n}, async (request, reply) => {\n // request.body의 정적 타입이 자동으로 추론됨\n const user = await fastify.prisma.user.create({ data: request.body });\n return reply.status(201).send(user);\n});\n\nBy registering Prisma as a global plugin and injecting it as a global decorator, a seamless type chain is completed from the database layer to the network I/O layer. It is the most realistic and powerful architecture to prevent human errors—which frequently arise from mismatches between application schemas and database schemas—at the compilation stage.\n\nConstraints in Serverless Edge Environments and the Right Choice\n\nWhile Fastify boasts overwhelming performance in traditional virtual server or container environments, it faces structural compatibility obstacles in serverless edge runtimes like Cloudflare Workers. The biggest reason is its strong reliance on built-in Node.js modules. Fastify is designed internally based on older Node.js network interfaces like node:http, and cannot run in lightweight edge environments that follow modern web standard specifications like the Fetch API.\n\nExecution constraints of security-focused edge sandboxes are also a significant factor. Fastify uses the Ajv library for high-speed schema validation, which dynamically compiles validation code at runtime by calling new Function to maximize performance. However, Cloudflare Workers completely blocks dynamic code execution to enhance security, leading to runtime errors. Furthermore, the writing operations of the Pino logger—which assumes OS-level file system access—and the multi-step asynchronous boot lifecycle of Avvio also become bottlenecks that increase cold start latency.\n\nTherefore, if edge runtime deployment is a core architectural requirement, it is more reasonable to choose a framework like Hono, which was designed from the ground up for standard web interfaces and lightweight single-threaded execution environments, rather than Fastify.\n\nChecklist for Practical Production Deployment\n\nThere are three key items on the checklist to verify before deploying Fastify v5.10 to a production environment.\n\nFirst, if you are migrating from v4, you must ensure that shorthand schemas and wildcard path settings have been completely removed. From v5, schema validation and serialization will only compile correctly if you strictly follow the standard JSON Schema specifications.\n\nSecond, resources to be shared across the entire application, such as database connections, must be injected as decorators by breaking isolation using fastify-plugin. Omitting this and bypassing lexical scope to pollute global state can cause your DAG-based stable context design to collapse.\n\nFinally, I encourage you to actively utilize the log control layer newly introduced in v5.10. You can dynamically customize log levels at runtime, preventing unnecessary I/O costs. As the core request lifecycle overhead has also been improved in this release, combining thorough schema design and encapsulation rules will allow you to build a faster and more robust backend.\n\nReference Links\n\nNearform / Community Discussions — Fastify Plugin Encapsulation Architecture vs NestJS DI\nOpenReplay Blog — Practical Fastify v5 REST API Pattern with TypeBox and Prisma\nGitHub (fastify/fastify) — Fastify v5.10.0 Release Notes","Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증\n\nFastify 5.10 実践ガイド — カプセル化アーキテクチャとスキーマバリデーション\n\nNode.jsバックエンドエコシステムにおいて、高性能なAPIサーバーを構築する際、Fastifyは最も信頼されているフレームワークの一つです。最近リリースされたFastify v5.10は、ランタイムでのログレベル制御とリクエストライフサイクルの最適化によりパフォーマンスを最大化し、以前のバージョンの技術的負債を大胆に解消しました。本記事では、複雑な構造を排除し、高速かつ安全なアーキテクチャを実現したい開発者のために、Fastify v5.10の主要な変更点と実践的な導入方法を詳しく解説します。\n\nFastify v5.10の主な変更点と移行\n\nFastify v5シリーズは、長年蓄積されたAPIの負債を整理し、最新のNode.js 20以降を必須要件としました。後方互換性を損なう最も代表的な変更は、従来柔軟に許容されていた省略形スキーマのサポート完全廃止です。今後は、スキーマ定義時に標準JSONスキーマ形式を完全に遵守する必要があります。\n\n以前のv4ではスキーマのルートレベルで一部の属性を省略してもフレームワーク側で処理されていましたが、現在はbody、querystring、params、responseなどの検証対象ルートオブジェクトに対して、type: 'object'とpropertiesを明示的に記述しなければ、コンパイル段階でエラーが発生します。また、従来のワイルドカードによるパスルーティング方式も完全に削除されたため、移行プロセスではパス定義を慎重に確認する必要があります。\n\n// Fastify v5 기준 명시적 스키마 정의\nconst schema = {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n};\n\nfastify.post('/user', { schema }, async (request, reply) => {\n return { status: 'ok' };\n});\n\nこのような構造の整理に加え、v5.10で新たに導入された機能も注目に値します。最も便利な変更点は、ランタイム中にログの動作を動的に変更できる「ログコントローラーレイヤー」が追加されたことです。サービスを再起動することなくリアルタイムでログレベルを切り替えられるため、本番環境で緊急の障害診断やデバッグを行う際に非常に有用です。\n\n同時に、内部リクエストライフサイクルのオーバーヘッドも大幅に改善されました。フレームワークの中心設計者であるMatteo Collina氏が主導したこの最適化により、不要な演算ステップが簡素化され、単位時間あたりの処理性能が一段と向上しました。これにより、高負荷なAPI環境下でも遅延を最小限に抑え、安定したサービスを維持できます。\n\nプラグインのカプセル化とAvvioアーキテクチャの理解\n\nFastifyの卓越した性能と安定性を支える強力な設計は、Avvioパッケージが管理する有向非巡回グラフ（DAG）アーキテクチャです。デコレータメタデータと依存性注入（DI）コンテナを使用してランタイムに複雑なオブジェクトグラフを分析するNestJS 12とは異なり、FastifyはNode.js固有のレキシカルスコープ規則に基づき、コンテキストを階層的に隔離します[2]。そのため、複雑な依存関係の分析やリフレクションによるランタイムオーバーヘッドが発生せず、アプリケーションの起動速度も極限まで高めることができます。\n\nFastifyにおいてすべてのプラグインとモジュールは、register()メソッドを通じて独立した子コンテキストとして生成されます[2]。下位ツリーに登録されたフックやデコレータ、ルートなどは親や兄弟コンテキストに伝播せず、子ツリーの内部だけで安全に隔離されて動作します。この隔離のおかげで、大規模アプリケーションでも互いの状態を汚染することなく、独立したドメインサービスを安全に実装できます。\n\nしかし、データベースクライアントのようにアプリケーション全体で安全に共有すべきリソースは、この隔離を破ってグローバルコンテキストに直接バインディングする必要があります。その際に使用するのがfastify-pluginパッケージです。プラグインをこのパッケージでラップすると、Fastifyは新しいコンテキストを作成せず、子で登録したデコレータを親コンテキストまで安全に伝播させます。\n\nPrismaクライアントをグローバルに安全に注入する標準的な例は次の通りです。\n\nimport fp from 'fastify-plugin';\nimport { PrismaClient } from '@prisma/client';\n\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: PrismaClient;\n }\n}\n\nexport default fp(async (fastify) => {\n const prisma = new PrismaClient();\n fastify.decorate('db', prisma);\n fastify.addHook('onClose', async (instance) => {\n await instance.db.$disconnect();\n });\n});\n\nこのパターンは、Fastifyエコシステムにおいてデータベースや外部サービスモジュールをすべてのルートから簡単に参照できるようにする核心技術です。隔離を原則としつつ、必要な箇所だけで柔軟に共有環境を構成するアーキテクチャにより、柔軟で拡張性の高い構造を実現できます。\n\nTypeBoxとPrismaを活用した型安全性の確保\n\nFastifyが他フレームワークを圧倒する性能を出す秘訣は、スキーマベースの事前コンパイル設計にあります。Fastifyはアプリケーション起動時、定義済みのJSONスキーマに基づいて最適化されたシリアライゼーション関数とAjvバリデーション関数を作成します。ランタイムに動的にオブジェクトを解析・分析しないため、リクエストごとの処理が極めて軽量です。\n\nしかし、この強力なスキーマ設計も、TypeScript環境で型定義と二重に管理しなければならない場合、開発者体験を大きく損ねてしまいます。この問題を解決する最適な組み合わせが、TypeBoxとPrismaを併用するパターンです。\n\n@fastify/type-provider-typeboxを適用すると、一つのソーススキーマからランタイム検証を行うAjvコンパイラが生成されると同時に、静的なTypeScriptの型まで安全に推論されます。重複コードなしで、強力な型安全性をワンクリックで手に入れる構造です。\n\nimport { Type } from '@sinclair/typebox';\n\n// 1. 단일 스키마 정의로 검증과 정적 타입 일치화\nexport const CreateUserSchema = Type.Object({\n email: Type.String({ format: 'email' }),\n name: Type.String()\n});\n\n// 2. TypeBox 프로바이더로 정적 타입 자동 추론 및 Prisma 연동\nfastify.withTypeProvider().post('/users', {\n schema: { body: CreateUserSchema }\n}, async (request, reply) => {\n // request.body의 정적 타입이 자동으로 추론됨\n const user = await fastify.prisma.user.create({ data: request.body });\n return reply.status(201).send(user);\n});\n\nここにPrismaをグローバルプラグインとして登録してデコレータとして注入すれば、データベース層からネットワーク入出力層まで隙のない型チェーンが完成します。スキーマとデータベーススキーマの不一致で発生しやすいヒューマンエラーをコンパイル段階で根本的に排除する、最も現実的かつ強力なアーキテクチャです。\n\nサーバーレスエッジ環境における制約と正しい選択\n\nFastifyは従来の仮想サーバーやコンテナ環境では圧倒的な性能を誇りますが、Cloudflare Workersのようなサーバーレスエッジランタイムでは構造的な互換性の問題に直面します。最大の原因は、Node.js固有の組み込みモジュールへの強力な依存です。Fastifyは内部的にnode:httpのような旧来のNode.jsネットワークインターフェースをベースに設計されているため、Fetch APIのような現代のウェブ標準スペックに従う軽量なエッジ環境では動作しません。\n\nセキュリティが厳格なエッジサンドボックスの実行制約も重要な原因です。Fastifyはスキーマの高速検証のためにAjvライブラリを使用しますが、Ajvはパフォーマンスを最大化するために内部でnew Functionを呼び出し、検証コードをランタイムに動的にコンパイルします。しかし、Cloudflare Workersはセキュリティ強化のため動的コード実行を完全にブロックしているため、ランタイムエラーが発生します。さらに、OSレベルのファイルシステムアクセスを前提とするPinoロガーの書き込み動作や、Avvioの多段階非同期起動ライフサイクルも、コールドスタートの遅延を悪化させるボトルネックとなります。\n\nしたがって、エッジランタイムへのデプロイが主要なアーキテクチャ要件である場合、Fastifyではなく、最初から標準ウェブインターフェースと軽量シングルスレッド実行環境に合わせて設計されたHonoのようなフレームワークを選択するのが合理的です。\n\n実戦プロダクション導入のためのチェックリスト\n\nFastify v5.10を本番環境にデプロイする前に確認すべき主要なチェックリストは3つです。\n\n第一に、既存のv4から移行する場合、省略形スキーマとワイルドカードルーティングの設定が完全に取り除かれているか確認してください。v5からは標準JSONスキーマ規格を厳格に守らなければ、スキーマ検証とシリアライゼーションが正常にコンパイルされません。\n\n第二に、データベース接続のようにアプリケーション全体で共有すべきリソースは、必ずfastify-pluginを使用して隔離を解除し、デコレータとして注入する必要があります。これを省略してレキシカルスコープを迂回し、グローバル状態を汚染してしまうと、有向非巡回グラフに基づく安定したコンテキスト設計が崩れる可能性があります。\n\n最後に、v5.10で新たに導入されたログ制御レイヤーを積極的に活用してください。ランタイム中にログレベルを動的にカスタマイズできるため、不要な入出力コストを抑えられます。今回のリリースでコアリクエストライフサイクルのオーバーヘッドも改善されたため、徹底したスキーマ設計とカプセル化ルールを組み合わせれば、より高速で堅牢なバックエンドを構築できるでしょう。\n\n参考リンク\n\nNearform / Community Discussions — Fastify Plugin Encapsulation Architecture vs NestJS DI\nOpenReplay Blog — Practical Fastify v5 REST API Pattern with TypeBox and Prisma\nGitHub (fastify/fastify) — Fastify v5.10.0 Release Notes","Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증\n\nFastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증\n\nNode.js 백엔드 생태계에서 고성능 API 서버를 구축할 때 Fastify는 가장 신뢰받는 프레임워크 중 하나입니다. 최근 출시된 Fastify v5.10은 런타임 로그 레벨 제어와 요청 수명 주기 최적화를 더하며 성능을 극대화했고, 이전 버전의 기술 부채를 과감하게 정리했습니다. 이번 글에서는 복잡한 구조를 걷어내고 빠르고 안전한 아키텍처를 구현하려는 개발자를 위해 Fastify v5.10의 핵심 변화와 실전 도입 방법을 깊이 있게 살펴보겠습니다.\n\nFastify v5.10의 핵심 변화와 마이그레이션\n\nFastify v5 라인업은 오랜 기간 쌓여온 API 부채를 정리하고 현대적인 Node.js 20 이상 버전을 필수 요구 사항으로 지정했습니다. 하위 호환성을 저해하는 가장 대표적인 변화는 기존에 유연하게 허용되던 축약형 스키마 지원의 완전한 중단입니다. 이제는 스키마 정의 시 반드시 표준 JSON 스키마 형식을 완벽하게 준수해야 합니다.\n\n과거 v4 버전에서는 스키마의 루트 수준에서 일부 속성을 생략해도 프레임워크가 알아서 처리해주었지만, 이제는 body, querystring, params, response 등의 검증 대상 루트 객체에 type: 'object'와 properties를 명시적으로 작성해야 컴파일 단계에서 에러가 발생하지 않습니다. 또한 기존의 와일드카드 경로 매칭 방식 역시 완전해 제거되었으므로 마이그레이션 과정에서 경로 정의를 세심하게 검토해야 합니다.\n\n// Fastify v5 기준 명시적 스키마 정의\nconst schema = {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n};\n\nfastify.post('/user', { schema }, async (request, reply) => {\n return { status: 'ok' };\n});\n\n이러한 구조적 정리 외에 v5.10 버전에서 새로 도입된 기능들도 주목할 만합니다. 가장 편리한 변화는 런타임 중에 동적으로 로깅 동작을 변경할 수 있는 '로그 컨트롤러 레이어'가 추가된 점입니다. 서비스를 재시작하지 않고도 실시간으로 로그 레벨을 전환할 수 있어, 운영 환경에서 긴급하게 장애를 진단하고 디버깅을 수행할 때 유용합니다.\n\n동시에 내부 요청 수명 주기의 오버헤드도 크게 개선되었습니다. 프레임워크 핵심 설계자인 마테오 콜리나가 주도한 이 최적화는 불필요한 연산 단계를 단순화하여 단위 시간당 처리율을 한층 더 극대화했습니다. 덕분에 고부하 API 환경에서도 지연 속도를 최소화하면서 안정적인 서비스를 유지할 수 있습니다.\n\n플러그인 캡슐화와 Avvio 아키텍처의 이해\n\nFastify의 뛰어난 성능과 안정성을 지탱하는 가장 강력한 설계는 Avvio 패키지가 관리하는 단방향 비순환 그래프(DAG) 아키텍처입니다. 데코레이터 메타데이터와 의존성 주입 컨테이너를 사용해 런타임에 복잡한 객체 그래프를 분석하는 NestJS 12와 달리, Fastify는 Node.js 고유의 렉시컬 스코프 규칙을 기반으로 컨텍스트를 계층적으로 격리합니다 [2]. 덕분에 복잡한 의존성 분석과 리플렉션으로 인한 런타임 오버헤드가 없으며, 애플리케이션의 기동 속도도 극단적으로 낮출 수 있습니다.\n\nFastify에서 모든 플러그인과 모듈은 register() 메서드를 통해 독립된 자식 컨텍스트로 생성됩니다 [2]. 하위 트리에 등록된 훅이나 데코레이터, 라우트 등은 부모나 형제 컨텍스트로 전혀 전파되지 않고 오직 자식 트리 내부에서만 안전하게 격리되어 동작합니다. 이 격리 덕분에 대규모 애플리케이션에서도 서로의 상태를 오염시키지 않고 안전하게 독립적인 도메인 서비스를 구현할 수 있습니다.\n\n하지만 데이터베이스 클라이언트처럼 전체 애플리케이션에서 안전하게 공유되어야 하는 자원은 이 격리를 깨고 전역 컨텍스트에 직접 바인딩해야 합니다. 이때 사용하는 도구가 바로 fastify-plugin 패키지입니다. 플러그인을 이 패키지로 감싸면 Fastify는 새로운 컨텍스트를 생성하지 않고, 자식에서 등록한 데코레이터를 부모 컨텍스트까지 안전하게 전파해 줍니다.\n\nPrisma 클라이언트를 전역에 안전하게 주입하는 표준 예시는 다음과 같습니다.\n\nimport fp from 'fastify-plugin';\nimport { PrismaClient } from '@prisma/client';\n\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: PrismaClient;\n }\n}\n\nexport default fp(async (fastify) => {\n const prisma = new PrismaClient();\n fastify.decorate('db', prisma);\n fastify.addHook('onClose', async (instance) => {\n await instance.db.$disconnect();\n });\n});\n\n이 패턴은 Fastify 생태계에서 데이터베이스나 외부 서비스 모듈을 모든 라우트에서 간편하게 참조할 수 있도록 만드는 핵심 기법입니다. 격리를 기본 원칙으로 두되, 필요한 부분에서만 유연하게 공유 환경을 구성하는 아키텍처 덕분에 유연하고 확장성 높은 구조를 완성할 수 있습니다.\n\nTypeBox와 Prisma를 활용한 타입 안전성 확보\n\nFastify가 타 프레임워크 대비 압도적인 성능을 내는 비결은 스키마 기반의 사전 컴파일 설계에 있습니다. Fastify는 애플리케이션이 구동될 때 미리 정의된 JSON 스키마를 기반으로 최적화된 직렬화 및 Ajv 검증 함수를 만들어 둡니다. 런타임에 동적으로 객체를 파싱하거나 분석하지 않기 때문에 매 요청을 극도로 가볍게 처리할 수 있습니다.\n\n하지만 이 강력한 스키마 설계도 TypeScript 환경에서 타입 정의와 이중으로 관리해야 한다면 개발자 경험을 크게 해치게 됩니다. 이 문제를 깔끔하게 해결하는 최적의 조합이 바로 TypeBox와 Prisma를 함께 사용하는 패턴입니다.\n\n@fastify/type-provider-typebox를 적용하면 단 하나의 소스 스키마로부터 런타임 검증을 실행할 Ajv 컴파일러를 생성함과 동시에, 정적 TypeScript 타입까지 안전하게 추론해 줍니다. 중복 코드 없이 강력한 타입 안전성을 원클릭으로 가져가는 구조입니다.\n\nimport { Type } from '@sinclair/typebox';\n\n// 1. 단일 스키마 정의로 검증과 정적 타입 일치화\nexport const CreateUserSchema = Type.Object({\n email: Type.String({ format: 'email' }),\n name: Type.String()\n});\n\n// 2. TypeBox 프로바이더로 정적 타입 자동 추론 및 Prisma 연동\nfastify.withTypeProvider().post('/users', {\n schema: { body: CreateUserSchema }\n}, async (request, reply) => {\n // request.body의 정적 타입이 자동으로 추론됨\n const user = await fastify.prisma.user.create({ data: request.body });\n return reply.status(201).send(user);\n});\n\n여기에 Prisma를 글로벌 플러그인 형태로 등록하여 전역 데코레이터로 주입하면, 데이터베이스 계층부터 네트워크 입출력 계층까지 빈틈없는 타입 체인이 완성됩니다. 스키마와 데이터베이스 스키마 간의 불일치로 발생하기 쉬운 휴먼 에러를 컴파일 단계에서 원천 차단하는 가장 현실적이고 강력한 아키텍처입니다.\n\n서버리스 엣지 환경에서의 제약과 올바른 선택\n\nFastify는 전통적인 가상 서버나 컨테이너 환경에서는 압도적인 성능을 자랑하지만, 클라우드플레어 워커스 같은 서버리스 엣지 런타임에서는 구조적 호환성 장애를 겪습니다. 가장 큰 원인은 Node.js 고유의 내장 모듈에 대한 강력한 의존성입니다. Fastify는 내부적으로 node:http 같은 구형 Node.js 네트워크 인터페이스를 기반으로 설계되어, Fetch API 같은 현대 웹 표준 스펙을 따르는 경량 엣지 환경에서는 구동할 수 없습니다.\n\n보안이 엄격한 엣지 샌드박스의 실행 제약도 중요한 원인입니다. Fastify는 스키마 고속 검증을 위해 Ajv 라이브러리를 사용하는데, Ajv는 성능을 극대화하려고 내부적으로 new Function을 호출하여 검증 코드를 런타임에 동적으로 컴파일합니다. 하지만 클라우드플레어 워커스는 보안 강화를 위해 동적 코드 실행을 완벽히 차단하므로 런타임 에러가 발생합니다. 여기에 OS 레벨 파일 시스템 접근을 전제로 하는 Pino 로거의 쓰기 동작과 Avvio의 다단계 비동기 부팅 수명주기 역시 콜드 스타트 지연을 가중시키는 병목이 됩니다.\n\n따라서 엣지 런타임 배포가 핵심 아키텍처 요구사항이라면, Fastify 대신 처음부터 표준 웹 인터페이스와 경량 싱글 스레드 실행 환경에 맞추어 설계된 Hono 같은 프레임워크를 선택하는 편이 합리적입니다.\n\n실전 프로덕션 도입을 위한 체크리스트\n\nFastify v5.10을 프로덕션 환경에 배포하기 전에 점검해야 할 핵심 체크리스트는 세 가지입니다.\n\n첫째, 기존 v4에서 마이그레이션하는 경우 축약형 스키마와 와일드카드 경로 설정을 완전히 제거했는지 확인해야 합니다. v5부터는 표준 JSON 스키마 규격을 엄격히 준수해야만 스키마 검증과 직렬화가 정상적으로 컴파일됩니다.\n\n둘째, 데이터베이스 커넥션처럼 애플리케이션 전반에서 공유할 자원은 반드시 fastify-plugin을 사용해 격리를 해제하고 데코레이터로 주입해야 합니다. 이를 생략하고 렉시컬 스코프를 우회해 전역 상태를 오염시키면 단방향 비순환 그래프 기반의 안정적인 컨텍스트 설계가 무너질 수 있습니다.\n\n마지막으로, v5.10에서 새롭게 도입된 로그 제어 레이어를 적극 활용해 보시기 바랍니다. 런타임 중에 동적으로 로그 레벨을 커스텀할 수 있어 불필요한 입출력 비용을 방지합니다. 이번 릴리스에서 코어 요청 수명 주기의 오버헤드까지 개선된 만큼, 철저한 스키마 설계와 캡슐화 규칙을 결합한다면 더욱 빠르고 견고한 백엔드를 구축할 수 있을 것입니다.\n\n참고 링크\n\nNearform / Community Discussions — Fastify Plugin Encapsulation Architecture vs NestJS DI\nOpenReplay Blog — Practical Fastify v5 REST API Pattern with TypeBox and Prisma\nGitHub (fastify/fastify) — Fastify v5.10.0 Release Notes",{"_1892":10260,"_1893":10261,"_1802":10262},"Fastify 5.10 Practical Guide — Encapsulation Architecture and Schema Validation Fastify is one of the most trusted frameworks for building high-performance API servers in the Node.js backend ecosystem. The recently relea…","Fastify 5.10 実践ガイド — カプセル化アーキテクチャとスキーマバリデーション Node.jsバックエンドエコシステムにおいて、高性能なAPIサーバーを構築する際、Fastifyは最も信頼されているフレームワークの一つです。最近リリースされたFastify v5.10は、ランタイムでのログレベル制御とリクエストライフサイクルの最適化によりパフォーマンスを最大化し、以前のバージョンの技術的負債を大胆に解消しました。本記事では、…","Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증 Node.js 백엔드 생태계에서 고성능 API 서버를 구축할 때 Fastify는 가장 신뢰받는 프레임워크 중 하나입니다. 최근 출시된 Fastify v5.10은 런타임 로그 레벨 제어와 요청 수명 주기 최적화를 더하며 성능을 극대화했고, 이전 버전의 기술 부채를 과감하게 정리했습니다. 이번 글에서는 복잡한 구조를 걷어내고…","cms2dgkig00gl10nhp3unexgv",[3122],[3124,3126,3125,3128,3127,10266],"prisma",[],"2026-07-27T12:02:24.697Z","2026-07-26T21:31:59.131Z","2026-07-27T23:09:20.170Z","2026-07-27T23:08:21.557Z","2026-07-27T23:09:20.128Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":10274},{"_1901":10275},{"_1903":10276,"_1908":1909,"_1910":10277,"_1921":10278,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":10279,"_1928":10280,"_1933":10281,"_1938":10282},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":10284,"_1883":1884,"_1200":1204,"_1899":10287},{"_633":10285,"_11":10286},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":10288},{"_1903":10289,"_1908":1909,"_1910":10290,"_1921":10291,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":10292,"_1928":10293,"_1933":10294,"_1938":10295},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":10297},{"_1948":-5,"_1908":1909,"_1910":10298,"_1960":-5,"_1943":10304,"_1962":10305},{"_1912":10299,"_1914":10300,"_1952":10301,"_1810":2534,"_944":1992,"_1917":10302,"_1957":2536,"_1919":10303},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/c77589ba-9f5a-482a-9e0d-52efcc9cae63.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/c77589ba-9f5a-482a-9e0d-52efcc9cae63.jpg",430138,"L78qTr~UIuE2o$ohs:WA014;$~-o","#282838","2026-07-26T22:30:56.546Z",{"_1964":10306,"_1972":10310,"_1979":10314,"_1986":-5},{"_1912":10307,"_1914":10308,"_1952":10309,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/large.webp",27112,{"_1912":10311,"_1914":10312,"_1952":10313,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/small.webp",7100,{"_1912":10315,"_1914":10316,"_1952":10317,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms2dgkig00gl10nhp3unexgv/medium.webp",15458,{"_950":10319,"_2559":10241,"_2560":10320,"_2716":10713,"_2788":10845,"_2790":10846,"_2792":10847,"_2794":1997,"_2003":10848,"_2480":10849,"_2797":-5},"cms2bcrhc00fg10nh7lqvkrck",{"_918":10321,"_1908":1909},[10322,10325,10329,10334,10338,10344,10348,10354,10358,10364,10368,10401,10405,10408,10412,10418,10422,10428,10432,10438,10442,10448,10452,10463,10467,10477,10481,10487,10491,10494,10498,10504,10508,10514,10518,10524,10528,10534,10538,10546,10550,10553,10557,10563,10567,10573,10577,10588,10592,10603,10607,10613,10617,10623,10627,10633,10637,10643,10647,10653,10657,10663,10667,10669,10673,10679,10683,10709],{"_950":10323,"_2565":10254,"_2420":2566,"_3202":591,"_3203":10324,"_2567":10263},"40332f6b-fad7-4fd1-893f-a226aa5ea834",{"_3205":591},{"_950":10326,"_2420":2570,"_3203":10327,"_2571":10328},"ec83866c-37a0-4a28-b7a9-72aaa27391ee",{"_3205":591},[],{"_950":10330,"_2420":2575,"_2576":1909,"_3203":10331,"_2571":10332},"20cb32d5-b9c9-4abe-83ea-60c8ba5e97a0",{"_3205":591},[10333],{"_2579":10254,"_2420":2579},{"_950":10335,"_2420":2570,"_3203":10336,"_2571":10337},"2f2d6bcf-495f-4801-9f6c-6a283acf3be9",{"_3205":591},[],{"_950":10339,"_2420":2570,"_3203":10340,"_2571":10341},"6e9d57ca-f41a-4ff8-9519-0207b088ba44",{"_3205":591},[10342],{"_2579":10343,"_2420":2579},"Node.js 백엔드 생태계에서 고성능 API 서버를 구축할 때 Fastify는 가장 신뢰받는 프레임워크 중 하나입니다. 최근 출시된 Fastify v5.10은 런타임 로그 레벨 제어와 요청 수명 주기 최적화를 더하며 성능을 극대화했고, 이전 버전의 기술 부채를 과감하게 정리했습니다. 이번 글에서는 복잡한 구조를 걷어내고 빠르고 안전한 아키텍처를 구현하려는 개발자를 위해 Fastify v5.10의 핵심 변화와 실전 도입 방법을 깊이 있게 살펴보겠습니다.",{"_950":10345,"_2420":2570,"_3203":10346,"_2571":10347},"88b4fe91-e998-4690-947a-1dacb5869145",{"_3205":591},[],{"_950":10349,"_2420":2575,"_2576":2007,"_3203":10350,"_2571":10351},"f92c81d4-f11d-4fbd-9823-10f7ee33df2b",{"_3205":591},[10352],{"_2579":10353,"_2420":2579},"Fastify v5.10의 핵심 변화와 마이그레이션",{"_950":10355,"_2420":2570,"_3203":10356,"_2571":10357},"3a76deb9-9061-4cbe-acc8-0ac0a907b844",{"_3205":591},[],{"_950":10359,"_2420":2570,"_3203":10360,"_2571":10361},"ad0b2ef8-1ff3-4516-b61f-0437a5226394",{"_3205":591},[10362],{"_2579":10363,"_2420":2579},"Fastify v5 라인업은 오랜 기간 쌓여온 API 부채를 정리하고 현대적인 Node.js 20 이상 버전을 필수 요구 사항으로 지정했습니다. 하위 호환성을 저해하는 가장 대표적인 변화는 기존에 유연하게 허용되던 축약형 스키마 지원의 완전한 중단입니다. 이제는 스키마 정의 시 반드시 표준 JSON 스키마 형식을 완벽하게 준수해야 합니다.",{"_950":10365,"_2420":2570,"_3203":10366,"_2571":10367},"2cc593de-9616-4ed6-9980-b95f4efb696a",{"_3205":591},[],{"_950":10369,"_2420":2570,"_3203":10370,"_2571":10371},"813b696a-99f4-4b24-8bc1-caa0fbb5d461",{"_3205":591},[10372,10374,10377,10379,10382,10383,10386,10387,10390,10392,10395,10396,10399],{"_2579":10373,"_2420":2579},"과거 v4 버전에서는 스키마의 루트 수준에서 일부 속성을 생략해도 프레임워크가 알아서 처리해주었지만, 이제는 ",{"_2579":10375,"_2420":2579,"_3365":10376},"body",{"_3351":3367},{"_2579":10378,"_2420":2579},", ",{"_2579":10380,"_2420":2579,"_3365":10381},"querystring",{"_3351":3367},{"_2579":10378,"_2420":2579},{"_2579":10384,"_2420":2579,"_3365":10385},"params",{"_3351":3367},{"_2579":10378,"_2420":2579},{"_2579":10388,"_2420":2579,"_3365":10389},"response",{"_3351":3367},{"_2579":10391,"_2420":2579}," 등의 검증 대상 루트 객체에 ",{"_2579":10393,"_2420":2579,"_3365":10394},"type: 'object'",{"_3351":3367},{"_2579":5185,"_2420":2579},{"_2579":10397,"_2420":2579,"_3365":10398},"properties",{"_3351":3367},{"_2579":10400,"_2420":2579},"를 명시적으로 작성해야 컴파일 단계에서 에러가 발생하지 않습니다. 또한 기존의 와일드카드 경로 매칭 방식 역시 완전해 제거되었으므로 마이그레이션 과정에서 경로 정의를 세심하게 검토해야 합니다.",{"_950":10402,"_2420":2570,"_3203":10403,"_2571":10404},"95a1f03b-8b14-4637-ba5b-6feb0e912bf3",{"_3205":591},[],{"_950":10406,"_3351":10407,"_2420":3351,"_625":3125},"71879dc7-5634-4dbe-ba79-21f386d9be04","// Fastify v5 기준 명시적 스키마 정의\nconst schema = {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n};\n\nfastify.post('/user', { schema }, async (request, reply) => {\n return { status: 'ok' };\n});",{"_950":10409,"_2420":2570,"_3203":10410,"_2571":10411},"66b335e7-26f5-4057-b715-cedbf086f442",{"_3205":591},[],{"_950":10413,"_2420":2570,"_3203":10414,"_2571":10415},"6297fa7f-ef8c-440e-94c4-6e76e16351cf",{"_3205":591},[10416],{"_2579":10417,"_2420":2579},"이러한 구조적 정리 외에 v5.10 버전에서 새로 도입된 기능들도 주목할 만합니다. 가장 편리한 변화는 런타임 중에 동적으로 로깅 동작을 변경할 수 있는 '로그 컨트롤러 레이어'가 추가된 점입니다. 서비스를 재시작하지 않고도 실시간으로 로그 레벨을 전환할 수 있어, 운영 환경에서 긴급하게 장애를 진단하고 디버깅을 수행할 때 유용합니다.",{"_950":10419,"_2420":2570,"_3203":10420,"_2571":10421},"cc858d2c-5d13-4dc6-8854-c8d4bc4c9485",{"_3205":591},[],{"_950":10423,"_2420":2570,"_3203":10424,"_2571":10425},"515c1fee-a0f7-41ae-ac1b-95905285f687",{"_3205":591},[10426],{"_2579":10427,"_2420":2579},"동시에 내부 요청 수명 주기의 오버헤드도 크게 개선되었습니다. 프레임워크 핵심 설계자인 마테오 콜리나가 주도한 이 최적화는 불필요한 연산 단계를 단순화하여 단위 시간당 처리율을 한층 더 극대화했습니다. 덕분에 고부하 API 환경에서도 지연 속도를 최소화하면서 안정적인 서비스를 유지할 수 있습니다.",{"_950":10429,"_2420":2570,"_3203":10430,"_2571":10431},"ea30c211-d67e-416d-93f5-86195f44f56f",{"_3205":591},[],{"_950":10433,"_2420":2575,"_2576":2007,"_3203":10434,"_2571":10435},"0e855a11-cbe3-465e-9d0a-b80158c26e01",{"_3205":591},[10436],{"_2579":10437,"_2420":2579},"플러그인 캡슐화와 Avvio 아키텍처의 이해",{"_950":10439,"_2420":2570,"_3203":10440,"_2571":10441},"40adefb2-18ee-4c46-b98a-6de2fc40d21c",{"_3205":591},[],{"_950":10443,"_2420":2570,"_3203":10444,"_2571":10445},"3d1ba7a8-5f60-4b14-98b2-f44d1661e9da",{"_3205":591},[10446],{"_2579":10447,"_2420":2579},"Fastify의 뛰어난 성능과 안정성을 지탱하는 가장 강력한 설계는 Avvio 패키지가 관리하는 단방향 비순환 그래프(DAG) 아키텍처입니다. 데코레이터 메타데이터와 의존성 주입 컨테이너를 사용해 런타임에 복잡한 객체 그래프를 분석하는 NestJS 12와 달리, Fastify는 Node.js 고유의 렉시컬 스코프 규칙을 기반으로 컨텍스트를 계층적으로 격리합니다 [2]. 덕분에 복잡한 의존성 분석과 리플렉션으로 인한 런타임 오버헤드가 없으며, 애플리케이션의 기동 속도도 극단적으로 낮출 수 있습니다.",{"_950":10449,"_2420":2570,"_3203":10450,"_2571":10451},"a0947d34-149c-46bc-a948-cce0cb2bee19",{"_3205":591},[],{"_950":10453,"_2420":2570,"_3203":10454,"_2571":10455},"9e0ca88d-cc5e-4a0f-80a6-a843b2dd7490",{"_3205":591},[10456,10458,10461],{"_2579":10457,"_2420":2579},"Fastify에서 모든 플러그인과 모듈은 ",{"_2579":10459,"_2420":2579,"_3365":10460},"register()",{"_3351":3367},{"_2579":10462,"_2420":2579}," 메서드를 통해 독립된 자식 컨텍스트로 생성됩니다 [2]. 하위 트리에 등록된 훅이나 데코레이터, 라우트 등은 부모나 형제 컨텍스트로 전혀 전파되지 않고 오직 자식 트리 내부에서만 안전하게 격리되어 동작합니다. 이 격리 덕분에 대규모 애플리케이션에서도 서로의 상태를 오염시키지 않고 안전하게 독립적인 도메인 서비스를 구현할 수 있습니다.",{"_950":10464,"_2420":2570,"_3203":10465,"_2571":10466},"4948b2b0-d167-4893-b475-a0df3b32e7e3",{"_3205":591},[],{"_950":10468,"_2420":2570,"_3203":10469,"_2571":10470},"dc55765b-de1a-4cfc-ab85-41b061de0157",{"_3205":591},[10471,10473,10475],{"_2579":10472,"_2420":2579},"하지만 데이터베이스 클라이언트처럼 전체 애플리케이션에서 안전하게 공유되어야 하는 자원은 이 격리를 깨고 전역 컨텍스트에 직접 바인딩해야 합니다. 이때 사용하는 도구가 바로 ",{"_2579":8252,"_2420":2579,"_3365":10474},{"_3351":3367},{"_2579":10476,"_2420":2579}," 패키지입니다. 플러그인을 이 패키지로 감싸면 Fastify는 새로운 컨텍스트를 생성하지 않고, 자식에서 등록한 데코레이터를 부모 컨텍스트까지 안전하게 전파해 줍니다.",{"_950":10478,"_2420":2570,"_3203":10479,"_2571":10480},"f207758f-88bc-45fe-b483-122135abc87a",{"_3205":591},[],{"_950":10482,"_2420":2570,"_3203":10483,"_2571":10484},"8c876f57-2508-4170-a286-667f48f12cef",{"_3205":591},[10485],{"_2579":10486,"_2420":2579},"Prisma 클라이언트를 전역에 안전하게 주입하는 표준 예시는 다음과 같습니다.",{"_950":10488,"_2420":2570,"_3203":10489,"_2571":10490},"e70a7702-f0d1-446d-a138-8aa8e09f961e",{"_3205":591},[],{"_950":10492,"_3351":10493,"_2420":3351,"_625":3125},"bdd419fd-4b8c-4e24-b399-c500b6e94eef","import fp from 'fastify-plugin';\nimport { PrismaClient } from '@prisma/client';\n\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: PrismaClient;\n }\n}\n\nexport default fp(async (fastify) => {\n const prisma = new PrismaClient();\n fastify.decorate('db', prisma);\n fastify.addHook('onClose', async (instance) => {\n await instance.db.$disconnect();\n });\n});",{"_950":10495,"_2420":2570,"_3203":10496,"_2571":10497},"e55df64f-3c68-4e13-9e19-a35caf93a947",{"_3205":591},[],{"_950":10499,"_2420":2570,"_3203":10500,"_2571":10501},"31928401-6d14-4418-b836-8286fa16d4b4",{"_3205":591},[10502],{"_2579":10503,"_2420":2579},"이 패턴은 Fastify 생태계에서 데이터베이스나 외부 서비스 모듈을 모든 라우트에서 간편하게 참조할 수 있도록 만드는 핵심 기법입니다. 격리를 기본 원칙으로 두되, 필요한 부분에서만 유연하게 공유 환경을 구성하는 아키텍처 덕분에 유연하고 확장성 높은 구조를 완성할 수 있습니다.",{"_950":10505,"_2420":2570,"_3203":10506,"_2571":10507},"1bd8daa1-ca64-4577-9060-cba1c296c276",{"_3205":591},[],{"_950":10509,"_2420":2575,"_2576":2007,"_3203":10510,"_2571":10511},"b830325d-0408-4a88-9e5e-0b3f4c768568",{"_3205":591},[10512],{"_2579":10513,"_2420":2579},"TypeBox와 Prisma를 활용한 타입 안전성 확보",{"_950":10515,"_2420":2570,"_3203":10516,"_2571":10517},"ff8a7e5b-933c-4d5d-8c05-95ef44f44bea",{"_3205":591},[],{"_950":10519,"_2420":2570,"_3203":10520,"_2571":10521},"0010f312-d53f-4e08-82f1-66dd68002a21",{"_3205":591},[10522],{"_2579":10523,"_2420":2579},"Fastify가 타 프레임워크 대비 압도적인 성능을 내는 비결은 스키마 기반의 사전 컴파일 설계에 있습니다. Fastify는 애플리케이션이 구동될 때 미리 정의된 JSON 스키마를 기반으로 최적화된 직렬화 및 Ajv 검증 함수를 만들어 둡니다. 런타임에 동적으로 객체를 파싱하거나 분석하지 않기 때문에 매 요청을 극도로 가볍게 처리할 수 있습니다.",{"_950":10525,"_2420":2570,"_3203":10526,"_2571":10527},"26e7d504-c202-46b3-b06c-2899ac2ba127",{"_3205":591},[],{"_950":10529,"_2420":2570,"_3203":10530,"_2571":10531},"f5ac1366-9a03-497f-873f-b86ad34e7d59",{"_3205":591},[10532],{"_2579":10533,"_2420":2579},"하지만 이 강력한 스키마 설계도 TypeScript 환경에서 타입 정의와 이중으로 관리해야 한다면 개발자 경험을 크게 해치게 됩니다. 이 문제를 깔끔하게 해결하는 최적의 조합이 바로 TypeBox와 Prisma를 함께 사용하는 패턴입니다.",{"_950":10535,"_2420":2570,"_3203":10536,"_2571":10537},"0315e69b-c05d-4b3a-973c-0d11b4e09c03",{"_3205":591},[],{"_950":10539,"_2420":2570,"_3203":10540,"_2571":10541},"0a50083c-70d0-4930-8947-b687169f6aa5",{"_3205":591},[10542,10544],{"_2579":4028,"_2420":2579,"_3365":10543},{"_3351":3367},{"_2579":10545,"_2420":2579},"를 적용하면 단 하나의 소스 스키마로부터 런타임 검증을 실행할 Ajv 컴파일러를 생성함과 동시에, 정적 TypeScript 타입까지 안전하게 추론해 줍니다. 중복 코드 없이 강력한 타입 안전성을 원클릭으로 가져가는 구조입니다.",{"_950":10547,"_2420":2570,"_3203":10548,"_2571":10549},"7825f289-c9d0-46ec-9243-a5a749b79618",{"_3205":591},[],{"_950":10551,"_3351":10552,"_2420":3351,"_625":3125},"e25b34b3-939d-4a8b-9790-4c78b984ef05","import { Type } from '@sinclair/typebox';\n\n// 1. 단일 스키마 정의로 검증과 정적 타입 일치화\nexport const CreateUserSchema = Type.Object({\n email: Type.String({ format: 'email' }),\n name: Type.String()\n});\n\n// 2. TypeBox 프로바이더로 정적 타입 자동 추론 및 Prisma 연동\nfastify.withTypeProvider().post('/users', {\n schema: { body: CreateUserSchema }\n}, async (request, reply) => {\n // request.body의 정적 타입이 자동으로 추론됨\n const user = await fastify.prisma.user.create({ data: request.body });\n return reply.status(201).send(user);\n});",{"_950":10554,"_2420":2570,"_3203":10555,"_2571":10556},"09631e03-6e29-498d-af6c-5bc26f85e1ed",{"_3205":591},[],{"_950":10558,"_2420":2570,"_3203":10559,"_2571":10560},"13817e6b-626a-4b22-9564-9aa3fc3a6092",{"_3205":591},[10561],{"_2579":10562,"_2420":2579},"여기에 Prisma를 글로벌 플러그인 형태로 등록하여 전역 데코레이터로 주입하면, 데이터베이스 계층부터 네트워크 입출력 계층까지 빈틈없는 타입 체인이 완성됩니다. 스키마와 데이터베이스 스키마 간의 불일치로 발생하기 쉬운 휴먼 에러를 컴파일 단계에서 원천 차단하는 가장 현실적이고 강력한 아키텍처입니다.",{"_950":10564,"_2420":2570,"_3203":10565,"_2571":10566},"91a8bcff-0b3f-4026-95bf-bb030d25c9ec",{"_3205":591},[],{"_950":10568,"_2420":2575,"_2576":2007,"_3203":10569,"_2571":10570},"9231f20d-4f68-456a-b924-fe81bd4717b6",{"_3205":591},[10571],{"_2579":10572,"_2420":2579},"서버리스 엣지 환경에서의 제약과 올바른 선택",{"_950":10574,"_2420":2570,"_3203":10575,"_2571":10576},"fe83eb04-53ac-4464-a6ba-fc17580799e7",{"_3205":591},[],{"_950":10578,"_2420":2570,"_3203":10579,"_2571":10580},"15e7c252-59dd-47cf-87f0-d28c2faf3fbd",{"_3205":591},[10581,10583,10586],{"_2579":10582,"_2420":2579},"Fastify는 전통적인 가상 서버나 컨테이너 환경에서는 압도적인 성능을 자랑하지만, 클라우드플레어 워커스 같은 서버리스 엣지 런타임에서는 구조적 호환성 장애를 겪습니다. 가장 큰 원인은 Node.js 고유의 내장 모듈에 대한 강력한 의존성입니다. Fastify는 내부적으로 ",{"_2579":10584,"_2420":2579,"_3365":10585},"node:http",{"_3351":3367},{"_2579":10587,"_2420":2579}," 같은 구형 Node.js 네트워크 인터페이스를 기반으로 설계되어, Fetch API 같은 현대 웹 표준 스펙을 따르는 경량 엣지 환경에서는 구동할 수 없습니다.",{"_950":10589,"_2420":2570,"_3203":10590,"_2571":10591},"4676d75c-89bc-4cb3-aa3d-ac96e6a8ff47",{"_3205":591},[],{"_950":10593,"_2420":2570,"_3203":10594,"_2571":10595},"306dbb2d-bf34-4da5-8b87-499ff4269dbb",{"_3205":591},[10596,10598,10601],{"_2579":10597,"_2420":2579},"보안이 엄격한 엣지 샌드박스의 실행 제약도 중요한 원인입니다. Fastify는 스키마 고속 검증을 위해 Ajv 라이브러리를 사용하는데, Ajv는 성능을 극대화하려고 내부적으로 ",{"_2579":10599,"_2420":2579,"_3365":10600},"new Function",{"_3351":3367},{"_2579":10602,"_2420":2579},"을 호출하여 검증 코드를 런타임에 동적으로 컴파일합니다. 하지만 클라우드플레어 워커스는 보안 강화를 위해 동적 코드 실행을 완벽히 차단하므로 런타임 에러가 발생합니다. 여기에 OS 레벨 파일 시스템 접근을 전제로 하는 Pino 로거의 쓰기 동작과 Avvio의 다단계 비동기 부팅 수명주기 역시 콜드 스타트 지연을 가중시키는 병목이 됩니다.",{"_950":10604,"_2420":2570,"_3203":10605,"_2571":10606},"095bc578-ec27-4245-8ebd-ec6c070535d3",{"_3205":591},[],{"_950":10608,"_2420":2570,"_3203":10609,"_2571":10610},"709dd9a4-bf7c-40b2-99bb-a1afbcc823df",{"_3205":591},[10611],{"_2579":10612,"_2420":2579},"따라서 엣지 런타임 배포가 핵심 아키텍처 요구사항이라면, Fastify 대신 처음부터 표준 웹 인터페이스와 경량 싱글 스레드 실행 환경에 맞추어 설계된 Hono 같은 프레임워크를 선택하는 편이 합리적입니다.",{"_950":10614,"_2420":2570,"_3203":10615,"_2571":10616},"8a815244-69b7-49b6-aa12-56a85901a320",{"_3205":591},[],{"_950":10618,"_2420":2575,"_2576":2007,"_3203":10619,"_2571":10620},"bce95b4a-2a4c-4048-8b73-a6ee25677083",{"_3205":591},[10621],{"_2579":10622,"_2420":2579},"실전 프로덕션 도입을 위한 체크리스트",{"_950":10624,"_2420":2570,"_3203":10625,"_2571":10626},"be98c835-fc4e-4239-9013-709e930cd2db",{"_3205":591},[],{"_950":10628,"_2420":2570,"_3203":10629,"_2571":10630},"5bf7a1af-9d06-406b-bc74-c45dc02efbb9",{"_3205":591},[10631],{"_2579":10632,"_2420":2579},"Fastify v5.10을 프로덕션 환경에 배포하기 전에 점검해야 할 핵심 체크리스트는 세 가지입니다.",{"_950":10634,"_2420":2570,"_3203":10635,"_2571":10636},"bad60adb-7c7c-40e1-8d95-4cafdadd0857",{"_3205":591},[],{"_950":10638,"_2420":2570,"_3203":10639,"_2571":10640},"97258eb8-22c0-48d0-9166-c6051639b04e",{"_3205":591},[10641],{"_2579":10642,"_2420":2579},"첫째, 기존 v4에서 마이그레이션하는 경우 축약형 스키마와 와일드카드 경로 설정을 완전히 제거했는지 확인해야 합니다. v5부터는 표준 JSON 스키마 규격을 엄격히 준수해야만 스키마 검증과 직렬화가 정상적으로 컴파일됩니다.",{"_950":10644,"_2420":2570,"_3203":10645,"_2571":10646},"2e286b65-2d1a-4a8a-a8e8-eb495ea968e9",{"_3205":591},[],{"_950":10648,"_2420":2570,"_3203":10649,"_2571":10650},"254d7116-2d97-4d0d-a669-5e6226836cc1",{"_3205":591},[10651],{"_2579":10652,"_2420":2579},"둘째, 데이터베이스 커넥션처럼 애플리케이션 전반에서 공유할 자원은 반드시 fastify-plugin을 사용해 격리를 해제하고 데코레이터로 주입해야 합니다. 이를 생략하고 렉시컬 스코프를 우회해 전역 상태를 오염시키면 단방향 비순환 그래프 기반의 안정적인 컨텍스트 설계가 무너질 수 있습니다.",{"_950":10654,"_2420":2570,"_3203":10655,"_2571":10656},"c9068b08-f4fd-432c-ad61-28bf5287a574",{"_3205":591},[],{"_950":10658,"_2420":2570,"_3203":10659,"_2571":10660},"892054e8-c7a1-478f-a50f-dabcc0bd469b",{"_3205":591},[10661],{"_2579":10662,"_2420":2579},"마지막으로, v5.10에서 새롭게 도입된 로그 제어 레이어를 적극 활용해 보시기 바랍니다. 런타임 중에 동적으로 로그 레벨을 커스텀할 수 있어 불필요한 입출력 비용을 방지합니다. 이번 릴리스에서 코어 요청 수명 주기의 오버헤드까지 개선된 만큼, 철저한 스키마 설계와 캡슐화 규칙을 결합한다면 더욱 빠르고 견고한 백엔드를 구축할 수 있을 것입니다.",{"_950":10664,"_2420":2570,"_3203":10665,"_2571":10666},"41da2a6a-abcc-4745-a25b-ff1967ff077e",{"_3205":591},[],{"_950":10668,"_2420":3473},"095ca389-e0a6-46ce-88cd-65f7a3092e40",{"_950":10670,"_2420":2570,"_3203":10671,"_2571":10672},"69d8ad12-74ee-45df-b81f-250dbd810402",{"_3205":591},[],{"_950":10674,"_2420":2570,"_3203":10675,"_2571":10676},"09827ac1-fddb-4699-8b32-270df2bfe04d",{"_3205":591},[10677],{"_2579":3483,"_2420":2579,"_3365":10678},{"_3485":3367},{"_950":10680,"_2420":2570,"_3203":10681,"_2571":10682},"228d4416-2ffb-4e1a-a346-e4d898cdec27",{"_3205":591},[],{"_950":10684,"_1881":3492,"_2420":3493,"_778":10685},"9e0e7e23-4cb5-47d0-afa5-7431675c0a29",[10686,10694,10702],{"_950":10687,"_2571":10688},"0e574a2b-da40-4ddd-b618-15215c7a5c9a",[10689],{"_3499":10690,"_2420":3501,"_3502":10691},"https://github.com/fastify/fastify/blob/main/docs/Guides/Plugins-Guide.md",[10692],{"_2579":10693,"_2420":2579},"Nearform / Community Discussions — Fastify Plugin Encapsulation Architecture vs NestJS DI",{"_950":10695,"_2571":10696},"e3292ac0-7f55-4679-b2df-1dd30a282349",[10697],{"_3499":10698,"_2420":3501,"_3502":10699},"https://openreplay.com/blog/how-to-build-a-rest-api-with-fastify/",[10700],{"_2579":10701,"_2420":2579},"OpenReplay Blog — Practical Fastify v5 REST API Pattern with TypeBox and Prisma",{"_950":10703,"_2571":10704},"420d9a8e-370d-4a52-938d-1fe6a6ce1aa9",[10705],{"_3499":8374,"_2420":3501,"_3502":10706},[10707],{"_2579":10708,"_2420":2579},"GitHub (fastify/fastify) — Fastify v5.10.0 Release Notes",{"_950":10710,"_2420":2570,"_3203":10711,"_2571":10712},"fd38b45d-74b2-440f-bfd1-d64c7a4668f8",{"_3205":591},[],{"_10519":10714,"_10674":10718,"_10539":10720,"_10433":10725,"_10558":10729,"_10578":10733,"_10330":10738,"_10648":10740,"_10593":10744,"_10499":10749,"_10443":10753,"_10423":10757,"_10628":10761,"_10413":10765,"_10339":10769,"_10608":10773,"_10369":10777,"_10782":10783,"_10658":10790,"_10794":10795,"_10482":10799,"_10568":10803,"_10638":10807,"_10453":10811,"_10684":10816,"_10359":10820,"_10509":10824,"_10618":10828,"_10468":10832,"_10529":10837,"_10349":10841},{"_2571":10715},{"_1892":10716,"_1893":10717,"_1802":10523},"The secret behind Fastify’s superior performance compared to other frameworks lies in its schema-based pre-compilation design. When the application starts, Fastify builds optimized serialization and Ajv validation functions based on predefined JSON schemas. Because it does not dynamically parse or analyze objects at runtime, it can process every request extremely efficiently.","Fastifyが他フレームワークを圧倒する性能を出す秘訣は、スキーマベースの事前コンパイル設計にあります。Fastifyはアプリケーション起動時、定義済みのJSONスキーマに基づいて最適化されたシリアライゼーション関数とAjvバリデーション関数を作成します。ランタイムに動的にオブジェクトを解析・分析しないため、リクエストごとの処理が極めて軽量です。",{"_2571":10719},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":10721},{"_1892":10722,"_1893":10723,"_1802":10724},"Applying @fastify/type-provider-typebox allows you to generate an Ajv compiler for runtime validation from a single source schema, while simultaneously and safely inferring static TypeScript types. It is a structure that grants powerful type safety with one click, without redundant code.","@fastify/type-provider-typeboxを適用すると、一つのソーススキーマからランタイム検証を行うAjvコンパイラが生成されると同時に、静的なTypeScriptの型まで安全に推論されます。重複コードなしで、強力な型安全性をワンクリックで手に入れる構造です。","@fastify/type-provider-typebox를 적용하면 단 하나의 소스 스키마로부터 런타임 검증을 실행할 Ajv 컴파일러를 생성함과 동시에, 정적 TypeScript 타입까지 안전하게 추론해 줍니다. 중복 코드 없이 강력한 타입 안전성을 원클릭으로 가져가는 구조입니다.",{"_2571":10726},{"_1892":10727,"_1893":10728,"_1802":10437},"Understanding Plugin Encapsulation and the Avvio Architecture","プラグインのカプセル化とAvvioアーキテクチャの理解",{"_2571":10730},{"_1892":10731,"_1893":10732,"_1802":10562},"By registering Prisma as a global plugin and injecting it as a global decorator, a seamless type chain is completed from the database layer to the network I/O layer. It is the most realistic and powerful architecture to prevent human errors—which frequently arise from mismatches between application schemas and database schemas—at the compilation stage.","ここにPrismaをグローバルプラグインとして登録してデコレータとして注入すれば、データベース層からネットワーク入出力層まで隙のない型チェーンが完成します。スキーマとデータベーススキーマの不一致で発生しやすいヒューマンエラーをコンパイル段階で根本的に排除する、最も現実的かつ強力なアーキテクチャです。",{"_2571":10734},{"_1892":10735,"_1893":10736,"_1802":10737},"While Fastify boasts overwhelming performance in traditional virtual server or container environments, it faces structural compatibility obstacles in serverless edge runtimes like Cloudflare Workers. The biggest reason is its strong reliance on built-in Node.js modules. Fastify is designed internally based on older Node.js network interfaces like node:http, and cannot run in lightweight edge environments that follow modern web standard specifications like the Fetch API.","Fastifyは従来の仮想サーバーやコンテナ環境では圧倒的な性能を誇りますが、Cloudflare Workersのようなサーバーレスエッジランタイムでは構造的な互換性の問題に直面します。最大の原因は、Node.js固有の組み込みモジュールへの強力な依存です。Fastifyは内部的にnode:httpのような旧来のNode.jsネットワークインターフェースをベースに設計されているため、Fetch APIのような現代のウェブ標準スペックに従う軽量なエッジ環境では動作しません。","Fastify는 전통적인 가상 서버나 컨테이너 환경에서는 압도적인 성능을 자랑하지만, 클라우드플레어 워커스 같은 서버리스 엣지 런타임에서는 구조적 호환성 장애를 겪습니다. 가장 큰 원인은 Node.js 고유의 내장 모듈에 대한 강력한 의존성입니다. Fastify는 내부적으로 node:http 같은 구형 Node.js 네트워크 인터페이스를 기반으로 설계되어, Fetch API 같은 현대 웹 표준 스펙을 따르는 경량 엣지 환경에서는 구동할 수 없습니다.",{"_2571":10739},{"_1892":10252,"_1893":10253,"_1802":10254},{"_2571":10741},{"_1892":10742,"_1893":10743,"_1802":10652},"Second, resources to be shared across the entire application, such as database connections, must be injected as decorators by breaking isolation using fastify-plugin. Omitting this and bypassing lexical scope to pollute global state can cause your DAG-based stable context design to collapse.","第二に、データベース接続のようにアプリケーション全体で共有すべきリソースは、必ずfastify-pluginを使用して隔離を解除し、デコレータとして注入する必要があります。これを省略してレキシカルスコープを迂回し、グローバル状態を汚染してしまうと、有向非巡回グラフに基づく安定したコンテキスト設計が崩れる可能性があります。",{"_2571":10745},{"_1892":10746,"_1893":10747,"_1802":10748},"Execution constraints of security-focused edge sandboxes are also a significant factor. Fastify uses the Ajv library for high-speed schema validation, which dynamically compiles validation code at runtime by calling new Function to maximize performance. However, Cloudflare Workers completely blocks dynamic code execution to enhance security, leading to runtime errors. Furthermore, the writing operations of the Pino logger—which assumes OS-level file system access—and the multi-step asynchronous boot lifecycle of Avvio also become bottlenecks that increase cold start latency.","セキュリティが厳格なエッジサンドボックスの実行制約も重要な原因です。Fastifyはスキーマの高速検証のためにAjvライブラリを使用しますが、Ajvはパフォーマンスを最大化するために内部でnew Functionを呼び出し、検証コードをランタイムに動的にコンパイルします。しかし、Cloudflare Workersはセキュリティ強化のため動的コード実行を完全にブロックしているため、ランタイムエラーが発生します。さらに、OSレベルのファイルシステムアクセスを前提とするPinoロガーの書き込み動作や、Avvioの多段階非同期起動ライフサイクルも、コールドスタートの遅延を悪化させるボトルネックとなります。","보안이 엄격한 엣지 샌드박스의 실행 제약도 중요한 원인입니다. Fastify는 스키마 고속 검증을 위해 Ajv 라이브러리를 사용하는데, Ajv는 성능을 극대화하려고 내부적으로 new Function을 호출하여 검증 코드를 런타임에 동적으로 컴파일합니다. 하지만 클라우드플레어 워커스는 보안 강화를 위해 동적 코드 실행을 완벽히 차단하므로 런타임 에러가 발생합니다. 여기에 OS 레벨 파일 시스템 접근을 전제로 하는 Pino 로거의 쓰기 동작과 Avvio의 다단계 비동기 부팅 수명주기 역시 콜드 스타트 지연을 가중시키는 병목이 됩니다.",{"_2571":10750},{"_1892":10751,"_1893":10752,"_1802":10503},"This pattern is a key technique in the Fastify ecosystem for easily referencing database or external service modules from all routes. Thanks to an architecture that treats isolation as the default principle while allowing flexible shared environments only where needed, you can build a flexible and highly scalable structure.","このパターンは、Fastifyエコシステムにおいてデータベースや外部サービスモジュールをすべてのルートから簡単に参照できるようにする核心技術です。隔離を原則としつつ、必要な箇所だけで柔軟に共有環境を構成するアーキテクチャにより、柔軟で拡張性の高い構造を実現できます。",{"_2571":10754},{"_1892":10755,"_1893":10756,"_1802":10447},"The core design supporting Fastify’s exceptional performance and stability is the Directed Acyclic Graph (DAG) architecture managed by the Avvio package. Unlike NestJS 12, which uses decorator metadata and dependency injection containers to analyze complex object graphs at runtime, Fastify hierarchically isolates contexts based on Node.js’s native lexical scope rules [2]. Consequently, there is no runtime overhead from complex dependency analysis or reflection, allowing for extremely fast application startup times.","Fastifyの卓越した性能と安定性を支える強力な設計は、Avvioパッケージが管理する有向非巡回グラフ（DAG）アーキテクチャです。デコレータメタデータと依存性注入（DI）コンテナを使用してランタイムに複雑なオブジェクトグラフを分析するNestJS 12とは異なり、FastifyはNode.js固有のレキシカルスコープ規則に基づき、コンテキストを階層的に隔離します[2]。そのため、複雑な依存関係の分析やリフレクションによるランタイムオーバーヘッドが発生せず、アプリケーションの起動速度も極限まで高めることができます。",{"_2571":10758},{"_1892":10759,"_1893":10760,"_1802":10427},"Simultaneously, overhead in the internal request lifecycle has been significantly improved. This optimization, led by core architect Matteo Collina, simplifies unnecessary computation steps to maximize throughput per unit time. As a result, you can maintain stable services with minimal latency even in high-load API environments.","同時に、内部リクエストライフサイクルのオーバーヘッドも大幅に改善されました。フレームワークの中心設計者であるMatteo Collina氏が主導したこの最適化により、不要な演算ステップが簡素化され、単位時間あたりの処理性能が一段と向上しました。これにより、高負荷なAPI環境下でも遅延を最小限に抑え、安定したサービスを維持できます。",{"_2571":10762},{"_1892":10763,"_1893":10764,"_1802":10632},"There are three key items on the checklist to verify before deploying Fastify v5.10 to a production environment.","Fastify v5.10を本番環境にデプロイする前に確認すべき主要なチェックリストは3つです。",{"_2571":10766},{"_1892":10767,"_1893":10768,"_1802":10417},"Beyond these structural cleanups, the new features in v5.10 are also noteworthy. The most convenient change is the addition of a 'Log Controller Layer,' which allows you to dynamically alter logging behavior at runtime. This enables real-time log level switching without restarting the service, making it highly useful for urgent troubleshooting and debugging in production environments.","このような構造の整理に加え、v5.10で新たに導入された機能も注目に値します。最も便利な変更点は、ランタイム中にログの動作を動的に変更できる「ログコントローラーレイヤー」が追加されたことです。サービスを再起動することなくリアルタイムでログレベルを切り替えられるため、本番環境で緊急の障害診断やデバッグを行う際に非常に有用です。",{"_2571":10770},{"_1892":10771,"_1893":10772,"_1802":10343},"Fastify is one of the most trusted frameworks for building high-performance API servers in the Node.js backend ecosystem. The recently released Fastify v5.10 maximizes performance by adding runtime log level control and optimizing the request lifecycle, while boldly shedding technical debt from previous versions. In this article, we will take an in-depth look at the key changes in Fastify v5.10 and how to implement it in practice for developers looking to strip away complex structures and build a fast, secure architecture.","Node.jsバックエンドエコシステムにおいて、高性能なAPIサーバーを構築する際、Fastifyは最も信頼されているフレームワークの一つです。最近リリースされたFastify v5.10は、ランタイムでのログレベル制御とリクエストライフサイクルの最適化によりパフォーマンスを最大化し、以前のバージョンの技術的負債を大胆に解消しました。本記事では、複雑な構造を排除し、高速かつ安全なアーキテクチャを実現したい開発者のために、Fastify v5.10の主要な変更点と実践的な導入方法を詳しく解説します。",{"_2571":10774},{"_1892":10775,"_1893":10776,"_1802":10612},"Therefore, if edge runtime deployment is a core architectural requirement, it is more reasonable to choose a framework like Hono, which was designed from the ground up for standard web interfaces and lightweight single-threaded execution environments, rather than Fastify.","したがって、エッジランタイムへのデプロイが主要なアーキテクチャ要件である場合、Fastifyではなく、最初から標準ウェブインターフェースと軽量シングルスレッド実行環境に合わせて設計されたHonoのようなフレームワークを選択するのが合理的です。",{"_2571":10778},{"_1892":10779,"_1893":10780,"_1802":10781},"In v4, the framework would handle omitted properties at the root level of a schema, but now you must explicitly define type: 'object' and properties for validation target roots like body, querystring, params, and response to avoid compilation errors. Additionally, previous wildcard path matching has been completely removed, so you should carefully review your route definitions during migration.","以前のv4ではスキーマのルートレベルで一部の属性を省略してもフレームワーク側で処理されていましたが、現在はbody、querystring、params、responseなどの検証対象ルートオブジェクトに対して、type: 'object'とpropertiesを明示的に記述しなければ、コンパイル段階でエラーが発生します。また、従来のワイルドカードによるパスルーティング方式も完全に削除されたため、移行プロセスではパス定義を慎重に確認する必要があります。","과거 v4 버전에서는 스키마의 루트 수준에서 일부 속성을 생략해도 프레임워크가 알아서 처리해주었지만, 이제는 body, querystring, params, response 등의 검증 대상 루트 객체에 type: 'object'와 properties를 명시적으로 작성해야 컴파일 단계에서 에러가 발생하지 않습니다. 또한 기존의 와일드카드 경로 매칭 방식 역시 완전해 제거되었으므로 마이그레이션 과정에서 경로 정의를 세심하게 검토해야 합니다.","8553bd06-0944-405a-bb74-8820255f07a5",{"_10784":10785,"_10786":10787,"_10788":10789},"item:0e574a2b-da40-4ddd-b618-15215c7a5c9a",{"_1892":10693,"_1893":10693,"_1802":10693},"item:420d9a8e-370d-4a52-938d-1fe6a6ce1aa9",{"_1892":10708,"_1893":10708,"_1802":10708},"item:e3292ac0-7f55-4679-b2df-1dd30a282349",{"_1892":10701,"_1893":10701,"_1802":10701},{"_2571":10791},{"_1892":10792,"_1893":10793,"_1802":10662},"Finally, I encourage you to actively utilize the log control layer newly introduced in v5.10. You can dynamically customize log levels at runtime, preventing unnecessary I/O costs. As the core request lifecycle overhead has also been improved in this release, combining thorough schema design and encapsulation rules will allow you to build a faster and more robust backend.","最後に、v5.10で新たに導入されたログ制御レイヤーを積極的に活用してください。ランタイム中にログレベルを動的にカスタマイズできるため、不要な入出力コストを抑えられます。今回のリリースでコアリクエストライフサイクルのオーバーヘッドも改善されたため、徹底したスキーマ設計とカプセル化ルールを組み合わせれば、より高速で堅牢なバックエンドを構築できるでしょう。","8bb3bb82-7aea-4de0-bd29-e63597e3843c",{"_10784":10796,"_10786":10797,"_10788":10798},{"_1892":10693,"_1893":10693,"_1802":10693},{"_1892":10708,"_1893":10708,"_1802":10708},{"_1892":10701,"_1893":10701,"_1802":10701},{"_2571":10800},{"_1892":10801,"_1893":10802,"_1802":10486},"The standard example for safely injecting a Prisma client globally is as follows:","Prismaクライアントをグローバルに安全に注入する標準的な例は次の通りです。",{"_2571":10804},{"_1892":10805,"_1893":10806,"_1802":10572},"Constraints in Serverless Edge Environments and the Right Choice","サーバーレスエッジ環境における制約と正しい選択",{"_2571":10808},{"_1892":10809,"_1893":10810,"_1802":10642},"First, if you are migrating from v4, you must ensure that shorthand schemas and wildcard path settings have been completely removed. From v5, schema validation and serialization will only compile correctly if you strictly follow the standard JSON Schema specifications.","第一に、既存のv4から移行する場合、省略形スキーマとワイルドカードルーティングの設定が完全に取り除かれているか確認してください。v5からは標準JSONスキーマ規格を厳格に守らなければ、スキーマ検証とシリアライゼーションが正常にコンパイルされません。",{"_2571":10812},{"_1892":10813,"_1893":10814,"_1802":10815},"In Fastify, every plugin and module is created as an independent child context via the register() method [2]. Hooks, decorators, and routes registered in a subtree are not propagated to parent or sibling contexts, but are safely isolated within the child tree. This isolation allows you to implement independent domain services safely without polluting each other's state, even in large-scale applications.","Fastifyにおいてすべてのプラグインとモジュールは、register()メソッドを通じて独立した子コンテキストとして生成されます[2]。下位ツリーに登録されたフックやデコレータ、ルートなどは親や兄弟コンテキストに伝播せず、子ツリーの内部だけで安全に隔離されて動作します。この隔離のおかげで、大規模アプリケーションでも互いの状態を汚染することなく、独立したドメインサービスを安全に実装できます。","Fastify에서 모든 플러그인과 모듈은 register() 메서드를 통해 독립된 자식 컨텍스트로 생성됩니다 [2]. 하위 트리에 등록된 훅이나 데코레이터, 라우트 등은 부모나 형제 컨텍스트로 전혀 전파되지 않고 오직 자식 트리 내부에서만 안전하게 격리되어 동작합니다. 이 격리 덕분에 대규모 애플리케이션에서도 서로의 상태를 오염시키지 않고 안전하게 독립적인 도메인 서비스를 구현할 수 있습니다.",{"_10784":10817,"_10786":10818,"_10788":10819},{"_1892":10693,"_1893":10693,"_1802":10693},{"_1892":10708,"_1893":10708,"_1802":10708},{"_1892":10701,"_1893":10701,"_1802":10701},{"_2571":10821},{"_1892":10822,"_1893":10823,"_1802":10363},"The Fastify v5 lineup addresses long-standing API debt and mandates Node.js v20 or higher as a requirement. The most significant change impacting backward compatibility is the complete discontinuation of the previously flexible shorthand schema support. From now on, you must strictly adhere to the standard JSON Schema format when defining schemas.","Fastify v5シリーズは、長年蓄積されたAPIの負債を整理し、最新のNode.js 20以降を必須要件としました。後方互換性を損なう最も代表的な変更は、従来柔軟に許容されていた省略形スキーマのサポート完全廃止です。今後は、スキーマ定義時に標準JSONスキーマ形式を完全に遵守する必要があります。",{"_2571":10825},{"_1892":10826,"_1893":10827,"_1802":10513},"Ensuring Type Safety with TypeBox and Prisma","TypeBoxとPrismaを活用した型安全性の確保",{"_2571":10829},{"_1892":10830,"_1893":10831,"_1802":10622},"Checklist for Practical Production Deployment","実戦プロダクション導入のためのチェックリスト",{"_2571":10833},{"_1892":10834,"_1893":10835,"_1802":10836},"However, resources that must be safely shared across the entire application, such as database clients, must break this isolation and be bound directly to the global context. The tool used for this is the fastify-plugin package. By wrapping a plugin with this package, Fastify does not create a new context, and instead safely propagates decorators registered in the child to the parent context.","しかし、データベースクライアントのようにアプリケーション全体で安全に共有すべきリソースは、この隔離を破ってグローバルコンテキストに直接バインディングする必要があります。その際に使用するのがfastify-pluginパッケージです。プラグインをこのパッケージでラップすると、Fastifyは新しいコンテキストを作成せず、子で登録したデコレータを親コンテキストまで安全に伝播させます。","하지만 데이터베이스 클라이언트처럼 전체 애플리케이션에서 안전하게 공유되어야 하는 자원은 이 격리를 깨고 전역 컨텍스트에 직접 바인딩해야 합니다. 이때 사용하는 도구가 바로 fastify-plugin 패키지입니다. 플러그인을 이 패키지로 감싸면 Fastify는 새로운 컨텍스트를 생성하지 않고, 자식에서 등록한 데코레이터를 부모 컨텍스트까지 안전하게 전파해 줍니다.",{"_2571":10838},{"_1892":10839,"_1893":10840,"_1802":10533},"However, this powerful schema design can severely degrade developer experience if types must be managed in duplicate for TypeScript environments. The optimal combination that cleanly solves this problem is the pattern using TypeBox and Prisma together.","しかし、この強力なスキーマ設計も、TypeScript環境で型定義と二重に管理しなければならない場合、開発者体験を大きく損ねてしまいます。この問題を解決する最適な組み合わせが、TypeBoxとPrismaを併用するパターンです。",{"_2571":10842},{"_1892":10843,"_1893":10844,"_1802":10353},"Key Changes and Migration in Fastify v5.10","Fastify v5.10の主な変更点と移行","![Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증](file:cms2dgkig00gl10nhp3unexgv)\n\n# Fastify 5.10 실전 가이드 — 캡슐화 아키텍처와 스키마 검증\n\nNode.js 백엔드 생태계에서 고성능 API 서버를 구축할 때 Fastify는 가장 신뢰받는 프레임워크 중 하나입니다. 최근 출시된 Fastify v5.10은 런타임 로그 레벨 제어와 요청 수명 주기 최적화를 더하며 성능을 극대화했고, 이전 버전의 기술 부채를 과감하게 정리했습니다. 이번 글에서는 복잡한 구조를 걷어내고 빠르고 안전한 아키텍처를 구현하려는 개발자를 위해 Fastify v5.10의 핵심 변화와 실전 도입 방법을 깊이 있게 살펴보겠습니다.\n\n## Fastify v5.10의 핵심 변화와 마이그레이션\n\nFastify v5 라인업은 오랜 기간 쌓여온 API 부채를 정리하고 현대적인 Node.js 20 이상 버전을 필수 요구 사항으로 지정했습니다. 하위 호환성을 저해하는 가장 대표적인 변화는 기존에 유연하게 허용되던 축약형 스키마 지원의 완전한 중단입니다. 이제는 스키마 정의 시 반드시 표준 JSON 스키마 형식을 완벽하게 준수해야 합니다.\n\n과거 v4 버전에서는 스키마의 루트 수준에서 일부 속성을 생략해도 프레임워크가 알아서 처리해주었지만, 이제는 `body`, `querystring`, `params`, `response` 등의 검증 대상 루트 객체에 `type: 'object'`와 `properties`를 명시적으로 작성해야 컴파일 단계에서 에러가 발생하지 않습니다. 또한 기존의 와일드카드 경로 매칭 방식 역시 완전해 제거되었으므로 마이그레이션 과정에서 경로 정의를 세심하게 검토해야 합니다.\n\n```typescript\n// Fastify v5 기준 명시적 스키마 정의\nconst schema = {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n};\n\nfastify.post('/user', { schema }, async (request, reply) => {\n return { status: 'ok' };\n});\n```\n\n이러한 구조적 정리 외에 v5.10 버전에서 새로 도입된 기능들도 주목할 만합니다. 가장 편리한 변화는 런타임 중에 동적으로 로깅 동작을 변경할 수 있는 '로그 컨트롤러 레이어'가 추가된 점입니다. 서비스를 재시작하지 않고도 실시간으로 로그 레벨을 전환할 수 있어, 운영 환경에서 긴급하게 장애를 진단하고 디버깅을 수행할 때 유용합니다.\n\n동시에 내부 요청 수명 주기의 오버헤드도 크게 개선되었습니다. 프레임워크 핵심 설계자인 마테오 콜리나가 주도한 이 최적화는 불필요한 연산 단계를 단순화하여 단위 시간당 처리율을 한층 더 극대화했습니다. 덕분에 고부하 API 환경에서도 지연 속도를 최소화하면서 안정적인 서비스를 유지할 수 있습니다.\n\n## 플러그인 캡슐화와 Avvio 아키텍처의 이해\n\nFastify의 뛰어난 성능과 안정성을 지탱하는 가장 강력한 설계는 Avvio 패키지가 관리하는 단방향 비순환 그래프(DAG) 아키텍처입니다. 데코레이터 메타데이터와 의존성 주입 컨테이너를 사용해 런타임에 복잡한 객체 그래프를 분석하는 NestJS 12와 달리, Fastify는 Node.js 고유의 렉시컬 스코프 규칙을 기반으로 컨텍스트를 계층적으로 격리합니다 \\[2\\]. 덕분에 복잡한 의존성 분석과 리플렉션으로 인한 런타임 오버헤드가 없으며, 애플리케이션의 기동 속도도 극단적으로 낮출 수 있습니다.\n\nFastify에서 모든 플러그인과 모듈은 `register()` 메서드를 통해 독립된 자식 컨텍스트로 생성됩니다 \\[2\\]. 하위 트리에 등록된 훅이나 데코레이터, 라우트 등은 부모나 형제 컨텍스트로 전혀 전파되지 않고 오직 자식 트리 내부에서만 안전하게 격리되어 동작합니다. 이 격리 덕분에 대규모 애플리케이션에서도 서로의 상태를 오염시키지 않고 안전하게 독립적인 도메인 서비스를 구현할 수 있습니다.\n\n하지만 데이터베이스 클라이언트처럼 전체 애플리케이션에서 안전하게 공유되어야 하는 자원은 이 격리를 깨고 전역 컨텍스트에 직접 바인딩해야 합니다. 이때 사용하는 도구가 바로 `fastify-plugin` 패키지입니다. 플러그인을 이 패키지로 감싸면 Fastify는 새로운 컨텍스트를 생성하지 않고, 자식에서 등록한 데코레이터를 부모 컨텍스트까지 안전하게 전파해 줍니다.\n\nPrisma 클라이언트를 전역에 안전하게 주입하는 표준 예시는 다음과 같습니다.\n\n```typescript\nimport fp from 'fastify-plugin';\nimport { PrismaClient } from '@prisma/client';\n\ndeclare module 'fastify' {\n interface FastifyInstance {\n db: PrismaClient;\n }\n}\n\nexport default fp(async (fastify) => {\n const prisma = new PrismaClient();\n fastify.decorate('db', prisma);\n fastify.addHook('onClose', async (instance) => {\n await instance.db.$disconnect();\n });\n});\n```\n\n이 패턴은 Fastify 생태계에서 데이터베이스나 외부 서비스 모듈을 모든 라우트에서 간편하게 참조할 수 있도록 만드는 핵심 기법입니다. 격리를 기본 원칙으로 두되, 필요한 부분에서만 유연하게 공유 환경을 구성하는 아키텍처 덕분에 유연하고 확장성 높은 구조를 완성할 수 있습니다.\n\n## TypeBox와 Prisma를 활용한 타입 안전성 확보\n\nFastify가 타 프레임워크 대비 압도적인 성능을 내는 비결은 스키마 기반의 사전 컴파일 설계에 있습니다. Fastify는 애플리케이션이 구동될 때 미리 정의된 JSON 스키마를 기반으로 최적화된 직렬화 및 Ajv 검증 함수를 만들어 둡니다. 런타임에 동적으로 객체를 파싱하거나 분석하지 않기 때문에 매 요청을 극도로 가볍게 처리할 수 있습니다.\n\n하지만 이 강력한 스키마 설계도 TypeScript 환경에서 타입 정의와 이중으로 관리해야 한다면 개발자 경험을 크게 해치게 됩니다. 이 문제를 깔끔하게 해결하는 최적의 조합이 바로 TypeBox와 Prisma를 함께 사용하는 패턴입니다.\n\n`@fastify/type-provider-typebox`를 적용하면 단 하나의 소스 스키마로부터 런타임 검증을 실행할 Ajv 컴파일러를 생성함과 동시에, 정적 TypeScript 타입까지 안전하게 추론해 줍니다. 중복 코드 없이 강력한 타입 안전성을 원클릭으로 가져가는 구조입니다.\n\n```typescript\nimport { Type } from '@sinclair/typebox';\n\n// 1. 단일 스키마 정의로 검증과 정적 타입 일치화\nexport const CreateUserSchema = Type.Object({\n email: Type.String({ format: 'email' }),\n name: Type.String()\n});\n\n// 2. TypeBox 프로바이더로 정적 타입 자동 추론 및 Prisma 연동\nfastify.withTypeProvider().post('/users', {\n schema: { body: CreateUserSchema }\n}, async (request, reply) => {\n // request.body의 정적 타입이 자동으로 추론됨\n const user = await fastify.prisma.user.create({ data: request.body });\n return reply.status(201).send(user);\n});\n```\n\n여기에 Prisma를 글로벌 플러그인 형태로 등록하여 전역 데코레이터로 주입하면, 데이터베이스 계층부터 네트워크 입출력 계층까지 빈틈없는 타입 체인이 완성됩니다. 스키마와 데이터베이스 스키마 간의 불일치로 발생하기 쉬운 휴먼 에러를 컴파일 단계에서 원천 차단하는 가장 현실적이고 강력한 아키텍처입니다.\n\n## 서버리스 엣지 환경에서의 제약과 올바른 선택\n\nFastify는 전통적인 가상 서버나 컨테이너 환경에서는 압도적인 성능을 자랑하지만, 클라우드플레어 워커스 같은 서버리스 엣지 런타임에서는 구조적 호환성 장애를 겪습니다. 가장 큰 원인은 Node.js 고유의 내장 모듈에 대한 강력한 의존성입니다. Fastify는 내부적으로 `node:http` 같은 구형 Node.js 네트워크 인터페이스를 기반으로 설계되어, Fetch API 같은 현대 웹 표준 스펙을 따르는 경량 엣지 환경에서는 구동할 수 없습니다.\n\n보안이 엄격한 엣지 샌드박스의 실행 제약도 중요한 원인입니다. Fastify는 스키마 고속 검증을 위해 Ajv 라이브러리를 사용하는데, Ajv는 성능을 극대화하려고 내부적으로 `new Function`을 호출하여 검증 코드를 런타임에 동적으로 컴파일합니다. 하지만 클라우드플레어 워커스는 보안 강화를 위해 동적 코드 실행을 완벽히 차단하므로 런타임 에러가 발생합니다. 여기에 OS 레벨 파일 시스템 접근을 전제로 하는 Pino 로거의 쓰기 동작과 Avvio의 다단계 비동기 부팅 수명주기 역시 콜드 스타트 지연을 가중시키는 병목이 됩니다.\n\n따라서 엣지 런타임 배포가 핵심 아키텍처 요구사항이라면, Fastify 대신 처음부터 표준 웹 인터페이스와 경량 싱글 스레드 실행 환경에 맞추어 설계된 Hono 같은 프레임워크를 선택하는 편이 합리적입니다.\n\n## 실전 프로덕션 도입을 위한 체크리스트\n\nFastify v5.10을 프로덕션 환경에 배포하기 전에 점검해야 할 핵심 체크리스트는 세 가지입니다.\n\n첫째, 기존 v4에서 마이그레이션하는 경우 축약형 스키마와 와일드카드 경로 설정을 완전히 제거했는지 확인해야 합니다. v5부터는 표준 JSON 스키마 규격을 엄격히 준수해야만 스키마 검증과 직렬화가 정상적으로 컴파일됩니다.\n\n둘째, 데이터베이스 커넥션처럼 애플리케이션 전반에서 공유할 자원은 반드시 fastify-plugin을 사용해 격리를 해제하고 데코레이터로 주입해야 합니다. 이를 생략하고 렉시컬 스코프를 우회해 전역 상태를 오염시키면 단방향 비순환 그래프 기반의 안정적인 컨텍스트 설계가 무너질 수 있습니다.\n\n마지막으로, v5.10에서 새롭게 도입된 로그 제어 레이어를 적극 활용해 보시기 바랍니다. 런타임 중에 동적으로 로그 레벨을 커스텀할 수 있어 불필요한 입출력 비용을 방지합니다. 이번 릴리스에서 코어 요청 수명 주기의 오버헤드까지 개선된 만큼, 철저한 스키마 설계와 캡슐화 규칙을 결합한다면 더욱 빠르고 견고한 백엔드를 구축할 수 있을 것입니다.\n\n---\n\n**참고 링크**\n\n- [Nearform / Community Discussions — Fastify Plugin Encapsulation Architecture vs NestJS DI](https://github.com/fastify/fastify/blob/main/docs/Guides/Plugins-Guide.md)\n- [OpenReplay Blog — Practical Fastify v5 REST API Pattern with TypeBox and Prisma](https://openreplay.com/blog/how-to-build-a-rest-api-with-fastify/)\n- [GitHub (fastify/fastify) — Fastify v5.10.0 Release Notes](https://github.com/fastify/fastify/releases/tag/v5.10.0)","d7caea35af6dcc6cb8ceb705e575d8280729aaeaed118e5e2b4ba567a59dcfbc",68,"2026-07-26T21:31:59.136Z","2026-07-27T23:09:20.179Z",[],[],{"_950":10853,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":10854,"_1889":10862,"_2455":-5,"_2456":-5,"_2457":-5,"_9":10866,"_2450":10874,"_2458":10875,"_2460":-5,"_723":10876,"_1886":10877,"_332":10880,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":10881,"_2003":10882,"_2480":10883,"_2482":-5,"_2483":10884,"_2485":-5,"_2486":-5,"_2487":10885,"_1144":10895,"_2527":10908,"_2555":-5,"_2556":10930,"_2798":11316,"_266":11317},"cms18wm1d01cz10pb4oy3yru5",{"_1801":1802,"_214":10855,"_2429":10856,"_2434":10859,"_2438":2439},3163,{"_1892":10857,"_1893":1997,"_1802":10858,"_2433":1997},1081,2082,{"_1892":10860,"_1893":1997,"_1802":10861,"_2433":1997},0.34176414796079674,0.6582358520392033,{"_9":10863,"_2445":10867,"_2450":10871},{"_1892":10864,"_1893":10865,"_1802":10866},"MCP v2 and Stateless HTTP — The New Standard for AI Agent Tool Integration","MCP v2とステートレスHTTP — AIエージェントツール連携の新しい標準","MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준",{"_1892":10868,"_1893":10869,"_1802":10870},"MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준\n\nMCP v2 and Stateless HTTP — The New Standard for AI Agent Tool Integration\n\nThe way AI agents integrate with external tools and databases has long varied by model, creating significant overhead for developers. The Model Context Protocol (MCP) is rapidly establishing itself as the standard interface to resolve this fragmentation. In particular, the recently released stateless HTTP-based specification candidate and TypeScript SDK v2.0 completely eliminate the burden of complex session management, leading a shift toward lightweight, stateless architectures. In this article, we cover the essential changes in the MCP ecosystem and practical integration patterns that full-stack developers should focus on right now.\n\nThe Shift to Stateless HTTP: The End of Session Management and Infinite Scalability\n\nThe original MCP specification relied on a session-based approach where the client and server maintained a persistent connection. This made horizontal scaling across multiple servers extremely difficult when moving beyond local development environments into production with increased traffic.\n\nThe newly released 2026-07-28 spec candidate introduces a stateless HTTP transport model to address these limitations. The key change is the complete removal of the complex initial handshake process and the session identifier, Mcp-Session-Id.\n\nNow, MCP servers function independently like standard REST APIs without needing to store state. Developers can freely deploy MCP servers behind round-robin load balancers to scale flexibly with traffic, making it easier to operate AI tools as stable service layers in cloud-native environments.\n\nIntegrating TypeScript SDK v2.0 and Standard Schema v1.0\n\nA key change in the new official TypeScript SDK v2.0 is the full standardization of the tool's data validation layer. Previously, developers had to hand-write JSON schemas or rely on dedicated adapter packages; now, it integrates the Standard Schema v1.0—the universal validation specification for the JavaScript ecosystem—directly into the module.\n\nThanks to this, simply defining schemas with tools already widely used in projects—like Zod, Valibot, or ArkType—allows the SDK to automatically convert them into runtime validation and static type inference code. This drastically reduces complex boilerplate code for validation, significantly improving the developer experience.\n\nBelow is a simple example of passing a Zod schema directly to the tool configuration block using the @modelcontextprotocol/server package.\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-mcp-server\",\n version: \"2.0.0\",\n});\n\n// Standard Schema v1.0 지원으로 Zod 스키마가 직접 호환됩니다.\nserver.tool(\n \"get_weather\",\n {\n city: z.string().describe(\"날씨를 조회할 도시 이름\"),\n unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n },\n async ({ city, unit }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 현재 온도는 24도(${unit})입니다.` }],\n };\n }\n);\n\nAs shown, SDK v2.0 provides the flexibility to be agnostic of schema libraries. Developers can quickly build secure MCP tool servers by integrating the validation libraries they are already comfortable with, without needing to rewrite existing runtime validation logic.\n\nClient Integration with Vercel AI SDK and LangChain.js\n\nVercel AI SDK and LangChain.js, the leading AI frameworks in the JavaScript and TypeScript ecosystem, support the latest MCP specification as a first-class citizen, drastically lowering the complexity of client integration.\n\nFor the Vercel AI SDK, the @ai-sdk/mcp package simplifies this process immensely via createMCPClient. A client generated by specifying a remote HTTP server URL dynamically converts server tools into standard AI SDK tool formats without complex handshakes.\n\nThe following is a representative integration pattern that uses the Vercel AI SDK to dynamically inject remote HTTP-based MCP tools into an agent.\n\nimport { createMCPClient } from '@ai-sdk/mcp';\nimport { generateText } from 'ai';\n\nconst mcpClient = await createMCPClient({\n transport: { type: 'http', url: 'https://api.example.com/mcp' }\n});\n\nconst { text } = await generateText({\n model: myModel, // 사전 정의된 AI 모델 객체\n tools: await mcpClient.tools(),\n prompt: '사용 가능한 도구를 사용해 배송 상태를 조회해줘.'\n});\n\nWhen this code runs, the SDK dynamically fetches the tool specifications from the remote server and instantly connects them to the model's tool-calling cycle.\n\nThe LangChain.js side has also introduced the @langchain/mcp-adapters package to increase flexibility in multi-agent workflows. This lightweight adapter converts remote and local MCP tool interfaces into native LangChain Tool classes in real-time. This allows you to immediately inject and utilize external MCP server tools without modifying existing complex workflows or state machine structures.\n\nFrom UI Rendering to Local Execution: MCP Apps and Code Mode\n\nArchitectural innovations are underway, moving beyond simple text responses to agents directly rendering UIs for users or executing code locally. Recent representative shifts in the agent ecosystem can be summarized by the MCP Apps pattern led by Vercel and the Code Mode pattern from Cloudflare.\n\nVercel's MCP Apps approach allows agent tools to return sandboxed HTML UI resources instead of simple text. Because it renders interactive interfaces in real-time within the browser's iframe environment, it can provide a rich visual user experience immediately. However, since the client browser must dynamically render external code, developers bear the responsibility of implementing strict iframe security policies.\n\nConversely, the Code Mode proposed by Cloudflare focuses on drastically reducing latency and API costs. Previously, inefficient round trips were required to combine multiple tools, where the model communicated repeatedly and passed back values. In Code Mode, by utilizing MCP APIs provided by the client, the model writes TypeScript code that can be executed locally in one go and hands over control to execute it directly. While it has the advantage of resolving multiple network round trips with a single code generation, it carries the security burden of having to build a robust, isolated sandbox infrastructure to safely execute arbitrary code written by the model.\n\nConclusion: Building Lightweight and Simple Stateless AI Infrastructure\n\nMCP is positioning itself not just as a simple local development tool, but as a standard specification for stateless agents capable of horizontal scaling across large-scale cloud infrastructure. This evolution, stripping away the hassle of session maintenance and moving toward standard HTTP specs and TypeScript SDK v2.0, provides a clear roadmap for engineers concerned with scalable AI applications.\n\nIf you are a full-stack developer, instead of implementing custom tool integration logic for every framework, it is better to focus on building a standardized MCP layer. We hope you experience for yourself the high productivity and stability that a simple yet robust stateless architecture provides.\n\nReference Links\n\nGitHub - modelcontextprotocol/typescript-sdk & Developer Community — MCP 2026-07-28 Specification Candidate & TypeScript SDK v2.0\nFastAPI Official Release Notes — FastAPI 0.139.2 Maintenance Update\nbyteiota Technical Blog — Serialization Performance: msgspec vs Pydantic V2 (2026 Analysis)","MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준\n\nMCP v2とステートレスHTTP — AIエージェントツール連携の新しい標準\n\nAIエージェントが外部ツールやデータベースと連携する方法は、これまでモデルごとに異なり、開発者にとって大きな手間となっていました。モデルコンテキストプロトコル（MCP）は、この断片化を解消する標準インターフェースとして急速に定着しつつあります。特に最近公開されたステートレスHTTPベースの仕様候補とTypeScript SDK v2.0は、複雑なセッション管理の負担を完全に取り除き、軽量なステートレスアーキテクチャへの転換を促しています。本稿では、フルスタックエンジニアが今すぐ注目すべきMCPエコシステムの変革と、実際の統合パターンについて、その核心を解説します。\n\nステートレスHTTPへの移行：セッション管理の終焉と無限の拡張性\n\n従来のMCP仕様は、クライアントとサーバー間で接続を維持し続けるセッション方式でした。そのため、ローカル開発環境を離れて実際のサービスでトラフィックが増加した際、複数のサーバーへの水平展開が非常に困難でした。\n\n新たに公開された2026-07-28仕様候補では、この制限を解消するためにステートレスHTTPトランスポートモデルが導入されました。従来の複雑な初期ハンドシェイクプロセスと、セッション識別子であるMcp-Session-Idを完全に取り除いたのが核心です。\n\nこれからはMCPサーバーの状態を保持する必要はなく、標準的なREST APIのように独立して動作します。開発者はラウンドロビンロードバランサーの背後にMCPサーバーを自由に配置してトラフィックに応じて柔軟に拡張でき、クラウドネイティブ環境においてAIツールを安定したサービスレイヤーとして容易に運用可能です。\n\nTypeScript SDK v2.0とStandard Schema v1.0の統合\n\n新しい公式TypeScript SDK v2.0の大きな変更点は、ツールのデータ検証レイヤーが完全に標準化されたことです。以前はJSONスキーマを手書きしたり、専用のアダプターパッケージに依存する必要がありましたが、現在はJavaScriptエコシステムの共通検証規格であるStandard Schema v1.0がモジュール内部に統合されました。\n\nこれにより、プロジェクトで既に広く使われているZodやValibot、ArkTypeなどでスキーマを定義するだけで、SDKがそれを自動的にランタイム検証および静的型推論コードに変換します。複雑なバリデーションのボイラープレートコードが劇的に減り、開発者体験が大きく向上しました。\n\n以下は@modelcontextprotocol/serverパッケージを使用して、Zodスキーマをツール設定ブロックに直接渡す簡単な例です。\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-mcp-server\",\n version: \"2.0.0\",\n});\n\n// Standard Schema v1.0 지원으로 Zod 스키마가 직접 호환됩니다.\nserver.tool(\n \"get_weather\",\n {\n city: z.string().describe(\"날씨를 조회할 도시 이름\"),\n unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n },\n async ({ city, unit }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 현재 온도는 24도(${unit})입니다.` }],\n };\n }\n);\n\nこのようにSDK v2.0では、スキーマライブラリに依存しない柔軟性を確保しました。開発者は既存のランタイム検証ロジックを書き直すことなく、使い慣れた検証ライブラリをそのまま活用し、安全なMCPツールサーバーを素早く構築できます。\n\nVercel AI SDKおよびLangChain.jsのクライアント連携\n\nJavaScriptおよびTypeScriptエコシステムの代表的なAIフレームワークであるVercel AI SDKとLangChain.jsは、最新のMCP仕様をファーストクラスでサポートしており、クライアント連携の複雑さを劇的に低減させています。\n\nVercel AI SDKの場合、@ai-sdk/mcpパッケージが提供するcreateMCPClientによって、このプロセスが極めて簡素化されました。リモートHTTPサーバーのURLを指定して作成されたクライアントは、複雑なハンドシェイクなしに、サーバー側のツールを標準のAI SDKツール形式へと動的に変換します。\n\n以下はVercel AI SDKを使用して、リモートHTTPベースのMCPツールをエージェントに動的に注入する代表的な連携パターンです。\n\nimport { createMCPClient } from '@ai-sdk/mcp';\nimport { generateText } from 'ai';\n\nconst mcpClient = await createMCPClient({\n transport: { type: 'http', url: 'https://api.example.com/mcp' }\n});\n\nconst { text } = await generateText({\n model: myModel, // 사전 정의된 AI 모델 객체\n tools: await mcpClient.tools(),\n prompt: '사용 가능한 도구를 사용해 배송 상태를 조회해줘.'\n});\n\nこのコードが実行されると、SDK内部でリモートサーバーのツール定義を動的に取得し、即座にモデルのツール呼び出しサイクルに接続します。\n\nLangChain.js陣営も@langchain/mcp-adaptersパッケージを導入し、マルチエージェントフローにおける柔軟性を高めました。この軽量アダプターは、リモートおよびローカルのMCPツールインターフェースを、ネイティブなLangChain Toolクラスにリアルタイムで変換します。これにより、既存の複雑なワークフローやステートマシン構造を変更することなく、外部MCPサーバーのツールを即座に注入して利用可能です。\n\nUIレンダリングからローカル実行まで：MCP Appsとコードモード\n\n単なるテキスト応答を超え、エージェントがユーザー画面に直接UIを描画したり、ローカルでコードを直接実行したりするアーキテクチャの革新が起きています。最近のエージェントエコシステムにおける代表的な変化は、Vercelが主導する「MCP Apps」パターンと、Cloudflareの「コードモード」パターンに集約されます。\n\nVercelのMCP Appsは、エージェントツールが単純なテキストではなく、サンドボックス化されたHTML UIリソースを返す仕組みです。ブラウザ内のiframe環境で対話型インターフェースをリアルタイムにレンダリングするため、豊かな視覚的ユーザー体験を即座に提供できます。ただし、クライアントブラウザ上で外部コードを動的にレンダリングするため、厳格なiframeセキュリティポリシーを遵守するという開発上の責任が伴います。\n\n一方、Cloudflareが提唱するコードモードは、遅延とAPIコストを劇的に削減することに焦点を当てています。従来、複数のツールを組み合わせるには、モデルと毎回通信して結果を再送するという非効率な往復処理が必要でした。コードモードでは、クライアントが提供するMCP APIを活用してモデルがローカルで実行可能なTypeScriptコードを一括作成し、それを直接実行するよう制御を委譲します。何度もネットワークを往復する手間を一度のコード生成で解決できる利点がありますが、モデルが作成した任意のコードを安全に実行するために、分離された強力なサンドボックスインフラを構築する必要があるというセキュリティ上の負担が存在します。\n\nまとめ：軽量でシンプルなステートレスAIインフラの構築\n\nMCPは単なるローカル開発ツールを超え、大規模クラウドインフラで水平拡張可能なステートレスエージェントの標準規格として定着しつつあります。セッション維持の手間を取り除き、標準HTTP仕様とTypeScript SDK v2.0へと進化した今回の変更は、拡張性のあるAIアプリケーションを模索するエンジニアに明確な道筋を示しています。\n\nフルスタック開発者であれば、フレームワークごとにバラバラだったツール連携ロジックを個別に実装するのではなく、標準化されたMCPレイヤーを構築することに注力するのが良いでしょう。シンプルかつ堅牢なステートレスアーキテクチャがもたらす高い生産性と安定性を、ぜひ体験してみてください。\n\n参考リンク\n\nGitHub - modelcontextprotocol/typescript-sdk & Developer Community — MCP 2026-07-28 Specification Candidate & TypeScript SDK v2.0\nFastAPI Official Release Notes — FastAPI 0.139.2 Maintenance Update\nbyteiota Technical Blog — Serialization Performance: msgspec vs Pydantic V2 (2026 Analysis)","MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준\n\nMCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준\n\nAI 에이전트가 외부 도구나 데이터베이스와 연동하는 방식은 그동안 모델마다 달라 개발자들에게 큰 번거로움이었습니다. 모델 컨텍스트 프로토콜(MCP)은 이러한 파편화를 해결하는 표준 인터페이스로 빠르게 자리 잡고 있습니다. 특히 최근 공개된 무상태 HTTP 기반의 스펙 후보와 타입스크립트 SDK v2.0은 복잡한 세션 관리 부담을 완전히 걷어내며 가벼운 무상태 아키텍처로의 전환을 이끌고 있습니다. 이번 글에서는 풀스택 개발자가 지금 당장 주목해야 할 MCP 생태계의 변화와 실제 통합 패턴을 핵심만 살펴봅니다.\n\n무상태 HTTP로의 전환: 세션 관리의 종말과 무한 확장성\n\n기존 MCP 사양은 클라이언트와 서버가 연결을 계속 유지하는 세션 방식이었습니다. 이 때문에 로컬 개발 환경을 벗어나 실서비스에서 트래픽이 늘어날 때 여러 대의 서버로 수평 확장을 하기가 매우 까다로웠습니다.\n\n새롭게 공개된 2026-07-28 스펙 후보는 이러한 한계를 해결하기 위해 무상태 HTTP 전송 모델을 도입했습니다. 기존의 복잡한 초기 핸드셰이크 과정과 세션 식별자인 Mcp-Session-Id를 완전히 제거한 것이 핵심입니다.\n\n이제 MCP 서버는 상태를 기억할 필요 없이 표준 REST API처럼 독립적으로 동작합니다. 개발자는 라운드 로빈 로드 밸런서 뒤에 MCP 서버를 자유롭게 배치하여 트래픽에 맞춰 유연하게 확장할 수 있으며, 클라우드 네이티브 환경에서 AI 도구를 안정적인 서비스 레이어로 쉽게 운영할 수 있습니다.\n\nTypeScript SDK v2.0과 Standard Schema v1.0의 통합\n\n새로운 공식 TypeScript SDK v2.0의 핵심 변화는 도구의 데이터 검증 레이어가 완전히 표준화되었다는 점입니다. 이전에는 JSON 스키마를 손수 작성하거나 전용 어댑터 패키지에 의존해야 했지만, 이제는 자바스크립트 생태계의 공통 검증 규격인 스탠다드 스키마(Standard Schema) v1.0을 모듈 내부에 통합했습니다.\n\n이 덕분에 프로젝트에서 이미 널리 쓰고 있는 조드(Zod)나 발리보, 아크타입(ArkType) 같은 도구로 스키마를 정의하기만 하면 SDK가 이를 알아서 런타임 검증과 정적 타입 추론 코드로 변환해 줍니다. 복잡한 유효성 검사 보일러플레이트 코드가 획기적으로 줄어들어 개발자 경험이 크게 향상되었습니다.\n\n다음은 @modelcontextprotocol/server 패키지를 사용해 Zod 스키마를 도구 설정 블록에 직접 전달하는 간단한 예시입니다.\n\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-mcp-server\",\n version: \"2.0.0\",\n});\n\n// Standard Schema v1.0 지원으로 Zod 스키마가 직접 호환됩니다.\nserver.tool(\n \"get_weather\",\n {\n city: z.string().describe(\"날씨를 조회할 도시 이름\"),\n unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n },\n async ({ city, unit }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 현재 온도는 24도(${unit})입니다.` }],\n };\n }\n);\n\n이처럼 SDK v2.0에서는 스키마 라이브러리에 종속되지 않는 유연성을 확보했습니다. 개발자는 기존 런타임 유효성 검사 로직을 재작성할 필요 없이, 이미 익숙한 검증 라이브러리를 그대로 결합하여 안전한 MCP 도구 서버를 빠르게 구축할 수 있습니다.\n\nVercel AI SDK 및 LangChain.js의 클라이언트 연동\n\n자바스크립트 및 타입스크립트 생태계의 대표적인 AI 프레임워크인 Vercel AI SDK와 LangChain.js는 최신 MCP 사양을 일급 객체로 지원하며 클라이언트 연동의 복잡성을 획기적으로 낮췄습니다.\n\nVercel AI SDK의 경우, @ai-sdk/mcp 패키지가 제공하는 createMCPClient를 통해 이 과정을 극도로 단순화했습니다. 원격 HTTP 서버 URL을 지정하여 생성된 클라이언트는 복잡한 핸드셰이크 없이도 서버의 도구들을 표준 AI SDK 도구 형태로 동적으로 변환해 줍니다.\n\n다음은 Vercel AI SDK를 사용하여 원격 HTTP 기반 MCP 도구를 에이전트에 동적으로 주입하는 대표적인 연동 패턴입니다.\n\nimport { createMCPClient } from '@ai-sdk/mcp';\nimport { generateText } from 'ai';\n\nconst mcpClient = await createMCPClient({\n transport: { type: 'http', url: 'https://api.example.com/mcp' }\n});\n\nconst { text } = await generateText({\n model: myModel, // 사전 정의된 AI 모델 객체\n tools: await mcpClient.tools(),\n prompt: '사용 가능한 도구를 사용해 배송 상태를 조회해줘.'\n});\n\n이 코드가 실행되면 SDK 내부적으로 원격 서버의 도구 명세를 동적으로 가져와 즉시 모델의 도구 호출 주기에 연결합니다.\n\nLangChain.js 진영 역시 @langchain/mcp-adapters 패키지를 도입하여 멀티 에이전트 흐름에서 유연성을 높였습니다. 이 경량 어댑터는 원격과 로컬의 MCP 도구 인터페이스를 네이티브 LangChain Tool 클래스로 실시간 변환해 줍니다. 덕분에 기존에 구축해 둔 복잡한 워크플로우나 상태 머신 구조를 변경하지 않고도, 외부 MCP 서버의 도구들을 즉시 주입해 활용할 수 있습니다.\n\nUI 렌더링부터 로컬 실행까지: MCP Apps와 코드 모드\n\n단순한 텍스트 답변을 넘어 에이전트가 사용자 화면에 직접 UI를 그리거나 로컬에서 코드를 직접 실행하는 아키텍처 혁신이 일어나고 있습니다. 최근 에이전트 생태계의 대표적인 변화는 버셀이 주도하는 MCP Apps 패턴과 클라우드플레어의 코드 모드 패턴으로 요약할 수 있습니다.\n\n버셀의 MCP Apps는 에이전트 도구가 단순 텍스트 대신 샌드박스 처리된 HTML UI 리소스를 반환하는 방식입니다. 브라우저 내부의 아이프레임 환경에서 실시간으로 대화형 인터페이스를 렌더링하기 때문에 풍부한 시각적 사용자 경험을 즉시 제공할 수 있습니다. 다만 클라이언트 브라우저에서 외부 코드를 동적으로 렌더링해야 하는 만큼, 엄격한 아이프레임 보안 정책을 수반해야 한다는 개발상의 책임이 따릅니다.\n\n반면 클라우드플레어가 제시한 코드 모드는 지연 시간과 API 비용을 극적으로 줄이는 데 집중합니다. 기존에는 여러 도구를 결합하기 위해 모델과 매번 통신하며 결과값을 다시 전달하는 비효율적인 왕복 과정이 필요했습니다. 코드 모드에서는 클라이언트가 제공하는 MCP API들을 활용해 모델이 로컬에서 실행할 수 있는 타입스크립트 코드를 한 번에 작성하고, 이를 직접 수행하도록 제어권을 넘깁니다. 여러 번의 네트워크 왕복을 단 한 번의 코드 생성으로 해결하는 장점이 있지만, 모델이 작성한 임의의 코드를 안전하게 실행하기 위해 격리된 강력한 샌드박스 인프라를 직접 구축해야 하는 보안 부담이 존재합니다.\n\n정리하며: 가볍고 단순한 무상태 AI 인프라 구축하기\n\nMCP는 단순한 로컬 개발 도구를 넘어 대규모 클라우드 인프라에서 수평 확장이 가능한 무상태 에이전트의 표준 규격으로 자리 잡고 있습니다. 세션 유지의 번거로움을 걷어내고 표준 HTTP 사양과 타입스크립트 SDK v2.0으로 진화한 이번 변화는 확장 가능한 AI 애플리케이션을 고민하는 엔지니어들에게 명확한 이정표를 보여줍니다.\n\n풀스택 개발자라면 이제 프레임워크마다 제각각이었던 도구 연동 로직을 직접 구현하는 대신, 표준화된 MCP 레이어를 구축하는 데 집중하는 것이 좋습니다. 단순하면서도 견고한 무상태 아키텍처가 선사하는 높은 생산성과 안정성을 직접 경험해 보시길 바랍니다.\n\n참고 링크\n\nGitHub - modelcontextprotocol/typescript-sdk & Developer Community — MCP 2026-07-28 Specification Candidate & TypeScript SDK v2.0\nFastAPI Official Release Notes — FastAPI 0.139.2 Maintenance Update\nbyteiota Technical Blog — Serialization Performance: msgspec vs Pydantic V2 (2026 Analysis)",{"_1892":10872,"_1893":10873,"_1802":10874},"MCP v2 and Stateless HTTP — The New Standard for AI Agent Tool Integration The way AI agents integrate with external tools and databases has long varied by model, creating significant overhead for developers. The Model C…","MCP v2とステートレスHTTP — AIエージェントツール連携の新しい標準 AIエージェントが外部ツールやデータベースと連携する方法は、これまでモデルごとに異なり、開発者にとって大きな手間となっていました。モデルコンテキストプロトコル（MCP）は、この断片化を解消する標準インターフェースとして急速に定着しつつあります。特に最近公開されたステートレスHTTPベースの仕様候補とTypeScript SDK v2.0は、複雑なセッション管…","MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준 AI 에이전트가 외부 도구나 데이터베이스와 연동하는 방식은 그동안 모델마다 달라 개발자들에게 큰 번거로움이었습니다. 모델 컨텍스트 프로토콜(MCP)은 이러한 파편화를 해결하는 표준 인터페이스로 빠르게 자리 잡고 있습니다. 특히 최근 공개된 무상태 HTTP 기반의 스펙 후보와 타입스크립트 SDK v2.0은 복잡한 세션 관…","cms1b6m8b01g110pb98ifk7tv",[7576],[4943,3792,6276,3125,10878,10879],"vercel-ai-sdk","langchain",[],"2026-07-26T17:27:07.783Z","2026-07-26T03:35:40.177Z","2026-07-27T08:49:08.756Z","2026-07-26T17:27:36.656Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":10886},{"_1901":10887},{"_1903":10888,"_1908":1909,"_1910":10889,"_1921":10890,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":10891,"_1928":10892,"_1933":10893,"_1938":10894},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":10896,"_1883":1884,"_1200":1204,"_1899":10899},{"_633":10897,"_11":10898},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":10900},{"_1903":10901,"_1908":1909,"_1910":10902,"_1921":10903,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":10904,"_1928":10905,"_1933":10906,"_1938":10907},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":10909},{"_1948":-5,"_1908":1909,"_1910":10910,"_1960":-5,"_1943":10916,"_1962":10917},{"_1912":10911,"_1914":10912,"_1952":10913,"_1810":2534,"_944":1992,"_1917":10914,"_1957":2536,"_1919":10915},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/45702930-a672-47d5-ad77-6a53707982c6.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/45702930-a672-47d5-ad77-6a53707982c6.jpg",396606,"L56+9Z~VS7IXtTt8t6jY014;s*%1","#183858","2026-07-26T04:39:26.818Z",{"_1964":10918,"_1972":10922,"_1979":10926,"_1986":-5},{"_1912":10919,"_1914":10920,"_1952":10921,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/large.webp",17548,{"_1912":10923,"_1914":10924,"_1952":10925,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/small.webp",5360,{"_1912":10927,"_1914":10928,"_1952":10929,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms1b6m8b01g110pb98ifk7tv/medium.webp",10580,{"_950":10931,"_2559":10853,"_2560":10932,"_2716":11203,"_2788":11311,"_2790":11312,"_2792":11313,"_2794":1997,"_2003":11314,"_2480":11315,"_2797":-5},"cms18wm1h01d010pb03qzsmti",{"_918":10933,"_1908":1909},[10934,10936,10939,10943,10946,10951,10954,10959,10962,10967,10970,10979,10982,10987,10990,10995,10998,11003,11006,11011,11014,11022,11025,11028,11031,11036,11039,11044,11047,11052,11055,11070,11073,11078,11081,11084,11087,11092,11095,11105,11108,11113,11116,11121,11124,11129,11132,11137,11140,11145,11148,11153,11156,11161,11164,11166,11169,11174,11177],{"_950":10935,"_2565":10866,"_2420":2566,"_2567":10875},"7b73e3ee-f391-4778-9e87-a5b287984e26",{"_950":10937,"_2420":2570,"_2571":10938},"78cc52c2-f88b-44a0-932b-13d8b5fad173",[],{"_950":10940,"_2420":2575,"_2576":1909,"_2571":10941},"d457fbaa-de79-420b-8c4d-ecd9a472a60d",[10942],{"_2579":10866,"_2420":2579},{"_950":10944,"_2420":2570,"_2571":10945},"a7371e06-a481-4c0f-bc6d-5ddeb9170d72",[],{"_950":10947,"_2420":2570,"_2571":10948},"17fc0d2a-0dc4-443e-b740-7fa591fd9870",[10949],{"_2579":10950,"_2420":2579},"AI 에이전트가 외부 도구나 데이터베이스와 연동하는 방식은 그동안 모델마다 달라 개발자들에게 큰 번거로움이었습니다. 모델 컨텍스트 프로토콜(MCP)은 이러한 파편화를 해결하는 표준 인터페이스로 빠르게 자리 잡고 있습니다. 특히 최근 공개된 무상태 HTTP 기반의 스펙 후보와 타입스크립트 SDK v2.0은 복잡한 세션 관리 부담을 완전히 걷어내며 가벼운 무상태 아키텍처로의 전환을 이끌고 있습니다. 이번 글에서는 풀스택 개발자가 지금 당장 주목해야 할 MCP 생태계의 변화와 실제 통합 패턴을 핵심만 살펴봅니다.",{"_950":10952,"_2420":2570,"_2571":10953},"5ba052ad-0a29-49af-9067-fd0d7d1cb7e7",[],{"_950":10955,"_2420":2575,"_2576":2007,"_2571":10956},"48e1ba36-6165-4882-b562-3f5555e88ca3",[10957],{"_2579":10958,"_2420":2579},"무상태 HTTP로의 전환: 세션 관리의 종말과 무한 확장성",{"_950":10960,"_2420":2570,"_2571":10961},"2ed0ad4b-5a15-4a26-a09f-48312934a220",[],{"_950":10963,"_2420":2570,"_2571":10964},"4a57625b-19f6-43da-8e9f-50cce0d151dc",[10965],{"_2579":10966,"_2420":2579},"기존 MCP 사양은 클라이언트와 서버가 연결을 계속 유지하는 세션 방식이었습니다. 이 때문에 로컬 개발 환경을 벗어나 실서비스에서 트래픽이 늘어날 때 여러 대의 서버로 수평 확장을 하기가 매우 까다로웠습니다.",{"_950":10968,"_2420":2570,"_2571":10969},"76d89261-ab90-4c1b-a733-95ea70ab750f",[],{"_950":10971,"_2420":2570,"_2571":10972},"f60b3cfc-71c9-4c3a-ace2-7c61aa184ec5",[10973,10975,10977],{"_2579":10974,"_2420":2579},"새롭게 공개된 2026-07-28 스펙 후보는 이러한 한계를 해결하기 위해 무상태 HTTP 전송 모델을 도입했습니다. 기존의 복잡한 초기 핸드셰이크 과정과 세션 식별자인 ",{"_2579":5145,"_2420":2579,"_3365":10976},{"_3351":3367},{"_2579":10978,"_2420":2579},"를 완전히 제거한 것이 핵심입니다.",{"_950":10980,"_2420":2570,"_2571":10981},"824db236-8fe0-407b-a77f-5ef069542e4b",[],{"_950":10983,"_2420":2570,"_2571":10984},"9d3858a5-97a3-4d0a-ae38-48ff367e0fc0",[10985],{"_2579":10986,"_2420":2579},"이제 MCP 서버는 상태를 기억할 필요 없이 표준 REST API처럼 독립적으로 동작합니다. 개발자는 라운드 로빈 로드 밸런서 뒤에 MCP 서버를 자유롭게 배치하여 트래픽에 맞춰 유연하게 확장할 수 있으며, 클라우드 네이티브 환경에서 AI 도구를 안정적인 서비스 레이어로 쉽게 운영할 수 있습니다.",{"_950":10988,"_2420":2570,"_2571":10989},"9b7b4677-6ef8-478d-8b7e-1d1061b31105",[],{"_950":10991,"_2420":2575,"_2576":2007,"_2571":10992},"62ee6c28-63df-40c5-bc78-86d48dbc17a7",[10993],{"_2579":10994,"_2420":2579},"TypeScript SDK v2.0과 Standard Schema v1.0의 통합",{"_950":10996,"_2420":2570,"_2571":10997},"eb74ce65-34fc-4e59-b655-d6526cfee187",[],{"_950":10999,"_2420":2570,"_2571":11000},"08bc504a-1314-4bed-9757-ea59908c0858",[11001],{"_2579":11002,"_2420":2579},"새로운 공식 TypeScript SDK v2.0의 핵심 변화는 도구의 데이터 검증 레이어가 완전히 표준화되었다는 점입니다. 이전에는 JSON 스키마를 손수 작성하거나 전용 어댑터 패키지에 의존해야 했지만, 이제는 자바스크립트 생태계의 공통 검증 규격인 스탠다드 스키마(Standard Schema) v1.0을 모듈 내부에 통합했습니다.",{"_950":11004,"_2420":2570,"_2571":11005},"fdeafebf-bb75-4312-9e77-144a586160c1",[],{"_950":11007,"_2420":2570,"_2571":11008},"c90f813e-a46b-499e-9575-c5ccd291d21d",[11009],{"_2579":11010,"_2420":2579},"이 덕분에 프로젝트에서 이미 널리 쓰고 있는 조드(Zod)나 발리보, 아크타입(ArkType) 같은 도구로 스키마를 정의하기만 하면 SDK가 이를 알아서 런타임 검증과 정적 타입 추론 코드로 변환해 줍니다. 복잡한 유효성 검사 보일러플레이트 코드가 획기적으로 줄어들어 개발자 경험이 크게 향상되었습니다.",{"_950":11012,"_2420":2570,"_2571":11013},"991e90e5-d4ea-404e-8119-83b841c63cbd",[],{"_950":11015,"_2420":2570,"_2571":11016},"a1791759-6c57-4f9d-a55f-37f1296aa98a",[11017,11018,11020],{"_2579":6380,"_2420":2579},{"_2579":6382,"_2420":2579,"_3365":11019},{"_3351":3367},{"_2579":11021,"_2420":2579}," 패키지를 사용해 Zod 스키마를 도구 설정 블록에 직접 전달하는 간단한 예시입니다.",{"_950":11023,"_2420":2570,"_2571":11024},"89bb1598-58cb-4486-9e5b-691e4203b50f",[],{"_950":11026,"_3351":11027,"_2420":3351,"_625":3125},"2e6da767-e253-444d-9c44-156535cb2c81","import { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-mcp-server\",\n version: \"2.0.0\",\n});\n\n// Standard Schema v1.0 지원으로 Zod 스키마가 직접 호환됩니다.\nserver.tool(\n \"get_weather\",\n {\n city: z.string().describe(\"날씨를 조회할 도시 이름\"),\n unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n },\n async ({ city, unit }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 현재 온도는 24도(${unit})입니다.` }],\n };\n }\n);",{"_950":11029,"_2420":2570,"_2571":11030},"a30cb63b-85cd-4d42-ac3c-e2679d67fef3",[],{"_950":11032,"_2420":2570,"_2571":11033},"a7282db2-7a04-4dc5-96cc-e77b50e585fa",[11034],{"_2579":11035,"_2420":2579},"이처럼 SDK v2.0에서는 스키마 라이브러리에 종속되지 않는 유연성을 확보했습니다. 개발자는 기존 런타임 유효성 검사 로직을 재작성할 필요 없이, 이미 익숙한 검증 라이브러리를 그대로 결합하여 안전한 MCP 도구 서버를 빠르게 구축할 수 있습니다.",{"_950":11037,"_2420":2570,"_2571":11038},"879de0b3-f3cb-4b57-aace-e9b33f899a62",[],{"_950":11040,"_2420":2575,"_2576":2007,"_2571":11041},"b3f8deee-b3d8-490c-8f26-639ee1a35413",[11042],{"_2579":11043,"_2420":2579},"Vercel AI SDK 및 LangChain.js의 클라이언트 연동",{"_950":11045,"_2420":2570,"_2571":11046},"314b3967-eedf-4397-8246-68aade8318fc",[],{"_950":11048,"_2420":2570,"_2571":11049},"637dff07-67e3-476b-9502-d79654d9705a",[11050],{"_2579":11051,"_2420":2579},"자바스크립트 및 타입스크립트 생태계의 대표적인 AI 프레임워크인 Vercel AI SDK와 LangChain.js는 최신 MCP 사양을 일급 객체로 지원하며 클라이언트 연동의 복잡성을 획기적으로 낮췄습니다.",{"_950":11053,"_2420":2570,"_2571":11054},"0e84e885-a20b-4561-93ea-72aa8d2c74c3",[],{"_950":11056,"_2420":2570,"_2571":11057},"bcb0d5e8-d49d-420f-b208-2c39660ee930",[11058,11060,11063,11065,11068],{"_2579":11059,"_2420":2579},"Vercel AI SDK의 경우, ",{"_2579":11061,"_2420":2579,"_3365":11062},"@ai-sdk/mcp",{"_3351":3367},{"_2579":11064,"_2420":2579}," 패키지가 제공하는 ",{"_2579":11066,"_2420":2579,"_3365":11067},"createMCPClient",{"_3351":3367},{"_2579":11069,"_2420":2579},"를 통해 이 과정을 극도로 단순화했습니다. 원격 HTTP 서버 URL을 지정하여 생성된 클라이언트는 복잡한 핸드셰이크 없이도 서버의 도구들을 표준 AI SDK 도구 형태로 동적으로 변환해 줍니다.",{"_950":11071,"_2420":2570,"_2571":11072},"08434bf7-5b2a-4ee8-aba7-eb4832f42903",[],{"_950":11074,"_2420":2570,"_2571":11075},"4ed4e3e0-a81b-40c1-a7fe-e154cf22b998",[11076],{"_2579":11077,"_2420":2579},"다음은 Vercel AI SDK를 사용하여 원격 HTTP 기반 MCP 도구를 에이전트에 동적으로 주입하는 대표적인 연동 패턴입니다.",{"_950":11079,"_2420":2570,"_2571":11080},"6df59a73-7c82-4a36-92dd-2e3bf13130b0",[],{"_950":11082,"_3351":11083,"_2420":3351,"_625":3125},"a70eb4a7-512d-4106-acb3-9f8c9de24a8f","import { createMCPClient } from '@ai-sdk/mcp';\nimport { generateText } from 'ai';\n\nconst mcpClient = await createMCPClient({\n transport: { type: 'http', url: 'https://api.example.com/mcp' }\n});\n\nconst { text } = await generateText({\n model: myModel, // 사전 정의된 AI 모델 객체\n tools: await mcpClient.tools(),\n prompt: '사용 가능한 도구를 사용해 배송 상태를 조회해줘.'\n});",{"_950":11085,"_2420":2570,"_2571":11086},"10f135ae-d398-4da3-8d1f-b6d4e15607ed",[],{"_950":11088,"_2420":2570,"_2571":11089},"6241a63d-5510-4b57-83cb-67f4124b3865",[11090],{"_2579":11091,"_2420":2579},"이 코드가 실행되면 SDK 내부적으로 원격 서버의 도구 명세를 동적으로 가져와 즉시 모델의 도구 호출 주기에 연결합니다.",{"_950":11093,"_2420":2570,"_2571":11094},"57ef2fb2-e89b-4804-a32c-86ea42be7e2d",[],{"_950":11096,"_2420":2570,"_2571":11097},"0deb4b30-728a-4723-a12b-34a81e2832f6",[11098,11100,11103],{"_2579":11099,"_2420":2579},"LangChain.js 진영 역시 ",{"_2579":11101,"_2420":2579,"_3365":11102},"@langchain/mcp-adapters",{"_3351":3367},{"_2579":11104,"_2420":2579}," 패키지를 도입하여 멀티 에이전트 흐름에서 유연성을 높였습니다. 이 경량 어댑터는 원격과 로컬의 MCP 도구 인터페이스를 네이티브 LangChain Tool 클래스로 실시간 변환해 줍니다. 덕분에 기존에 구축해 둔 복잡한 워크플로우나 상태 머신 구조를 변경하지 않고도, 외부 MCP 서버의 도구들을 즉시 주입해 활용할 수 있습니다.",{"_950":11106,"_2420":2570,"_2571":11107},"707fcdef-318e-4c76-bcea-5f25617c2ea4",[],{"_950":11109,"_2420":2575,"_2576":2007,"_2571":11110},"4166796c-ce0e-4452-aecc-fa4fbef30544",[11111],{"_2579":11112,"_2420":2579},"UI 렌더링부터 로컬 실행까지: MCP Apps와 코드 모드",{"_950":11114,"_2420":2570,"_2571":11115},"d0cf3839-c192-4c8d-890f-d981c399580b",[],{"_950":11117,"_2420":2570,"_2571":11118},"f527aa28-9031-401e-a503-1ad2c1a370aa",[11119],{"_2579":11120,"_2420":2579},"단순한 텍스트 답변을 넘어 에이전트가 사용자 화면에 직접 UI를 그리거나 로컬에서 코드를 직접 실행하는 아키텍처 혁신이 일어나고 있습니다. 최근 에이전트 생태계의 대표적인 변화는 버셀이 주도하는 MCP Apps 패턴과 클라우드플레어의 코드 모드 패턴으로 요약할 수 있습니다.",{"_950":11122,"_2420":2570,"_2571":11123},"64d3dc7e-62bb-4bbf-8eb1-160de4b3e149",[],{"_950":11125,"_2420":2570,"_2571":11126},"5d896789-d043-4817-a0f1-9b5a1cb85850",[11127],{"_2579":11128,"_2420":2579},"버셀의 MCP Apps는 에이전트 도구가 단순 텍스트 대신 샌드박스 처리된 HTML UI 리소스를 반환하는 방식입니다. 브라우저 내부의 아이프레임 환경에서 실시간으로 대화형 인터페이스를 렌더링하기 때문에 풍부한 시각적 사용자 경험을 즉시 제공할 수 있습니다. 다만 클라이언트 브라우저에서 외부 코드를 동적으로 렌더링해야 하는 만큼, 엄격한 아이프레임 보안 정책을 수반해야 한다는 개발상의 책임이 따릅니다.",{"_950":11130,"_2420":2570,"_2571":11131},"5fef9373-94b2-4e78-9156-4757bb6e95d5",[],{"_950":11133,"_2420":2570,"_2571":11134},"db2b9e3b-789c-4f2b-8cf9-a5eb1ed5a6d0",[11135],{"_2579":11136,"_2420":2579},"반면 클라우드플레어가 제시한 코드 모드는 지연 시간과 API 비용을 극적으로 줄이는 데 집중합니다. 기존에는 여러 도구를 결합하기 위해 모델과 매번 통신하며 결과값을 다시 전달하는 비효율적인 왕복 과정이 필요했습니다. 코드 모드에서는 클라이언트가 제공하는 MCP API들을 활용해 모델이 로컬에서 실행할 수 있는 타입스크립트 코드를 한 번에 작성하고, 이를 직접 수행하도록 제어권을 넘깁니다. 여러 번의 네트워크 왕복을 단 한 번의 코드 생성으로 해결하는 장점이 있지만, 모델이 작성한 임의의 코드를 안전하게 실행하기 위해 격리된 강력한 샌드박스 인프라를 직접 구축해야 하는 보안 부담이 존재합니다.",{"_950":11138,"_2420":2570,"_2571":11139},"168cbc22-a4db-47e5-a65a-3dbf5a0d66ab",[],{"_950":11141,"_2420":2575,"_2576":2007,"_2571":11142},"b35f2e42-3023-42b9-8be9-aa19af3aabcd",[11143],{"_2579":11144,"_2420":2579},"정리하며: 가볍고 단순한 무상태 AI 인프라 구축하기",{"_950":11146,"_2420":2570,"_2571":11147},"c886ad13-bebd-4440-9070-1997c94c1e7d",[],{"_950":11149,"_2420":2570,"_2571":11150},"a51801e0-b6d6-4521-aa49-be04b303e6e5",[11151],{"_2579":11152,"_2420":2579},"MCP는 단순한 로컬 개발 도구를 넘어 대규모 클라우드 인프라에서 수평 확장이 가능한 무상태 에이전트의 표준 규격으로 자리 잡고 있습니다. 세션 유지의 번거로움을 걷어내고 표준 HTTP 사양과 타입스크립트 SDK v2.0으로 진화한 이번 변화는 확장 가능한 AI 애플리케이션을 고민하는 엔지니어들에게 명확한 이정표를 보여줍니다.",{"_950":11154,"_2420":2570,"_2571":11155},"687080d6-cb9b-4c34-8487-9e3ef5fe720b",[],{"_950":11157,"_2420":2570,"_2571":11158},"3463b74b-c218-4c77-bbee-c07110996fa7",[11159],{"_2579":11160,"_2420":2579},"풀스택 개발자라면 이제 프레임워크마다 제각각이었던 도구 연동 로직을 직접 구현하는 대신, 표준화된 MCP 레이어를 구축하는 데 집중하는 것이 좋습니다. 단순하면서도 견고한 무상태 아키텍처가 선사하는 높은 생산성과 안정성을 직접 경험해 보시길 바랍니다.",{"_950":11162,"_2420":2570,"_2571":11163},"fc936c81-c453-4830-a172-75ad89cde28e",[],{"_950":11165,"_2420":3473},"16ec4d27-470c-45ab-8ec6-d07c611638da",{"_950":11167,"_2420":2570,"_2571":11168},"46459bba-cb03-4acf-a118-5d13a7e2f26a",[],{"_950":11170,"_2420":2570,"_2571":11171},"59ef3d41-8b88-4f44-bdd7-a8a2c57c3b7e",[11172],{"_2579":3483,"_2420":2579,"_3365":11173},{"_3485":3367},{"_950":11175,"_2420":2570,"_2571":11176},"9cc53bc3-f308-4c79-ac8c-192465b98ea3",[],{"_950":11178,"_1881":3492,"_2420":3493,"_778":11179},"1012beb6-5a25-4966-b35d-2cf420b95cc5",[11180,11187,11195],{"_950":11181,"_2571":11182},"c813cbe1-ff34-41b2-9667-446b88db9d1b",[11183],{"_3499":5316,"_2420":3501,"_3502":11184},[11185],{"_2579":11186,"_2420":2579},"GitHub - modelcontextprotocol/typescript-sdk & Developer Community — MCP 2026-07-28 Specification Candidate & TypeScript SDK v2.0",{"_950":11188,"_2571":11189},"1890345d-c535-4bc1-8cc9-e7646bfa2405",[11190],{"_3499":11191,"_2420":3501,"_3502":11192},"https://fastapi.tiangolo.com/release-notes/",[11193],{"_2579":11194,"_2420":2579},"FastAPI Official Release Notes — FastAPI 0.139.2 Maintenance Update",{"_950":11196,"_2571":11197},"c425c266-a90c-4055-9a0e-a725794c32eb",[11198],{"_3499":11199,"_2420":3501,"_3502":11200},"https://byteiota.com/litestar-vs-fastapi-python-speed-test-2026-analysis/",[11201],{"_2579":11202,"_2420":2579},"byteiota Technical Blog — Serialization Performance: msgspec vs Pydantic V2 (2026 Analysis)",{"_10999":11204,"_11096":11208,"_11178":11213,"_10947":11220,"_11157":11224,"_11109":11228,"_10955":11232,"_10963":11236,"_11074":11240,"_11170":11244,"_11125":11246,"_11088":11250,"_10991":11254,"_11048":11258,"_10983":11262,"_11015":11266,"_11149":11271,"_11032":11275,"_11141":11279,"_11040":11283,"_11056":11287,"_11007":11292,"_10940":11296,"_11133":11298,"_11117":11302,"_10971":11306},{"_2571":11205},{"_1892":11206,"_1893":11207,"_1802":11002},"A key change in the new official TypeScript SDK v2.0 is the full standardization of the tool's data validation layer. Previously, developers had to hand-write JSON schemas or rely on dedicated adapter packages; now, it integrates the Standard Schema v1.0—the universal validation specification for the JavaScript ecosystem—directly into the module.","新しい公式TypeScript SDK v2.0の大きな変更点は、ツールのデータ検証レイヤーが完全に標準化されたことです。以前はJSONスキーマを手書きしたり、専用のアダプターパッケージに依存する必要がありましたが、現在はJavaScriptエコシステムの共通検証規格であるStandard Schema v1.0がモジュール内部に統合されました。",{"_2571":11209},{"_1892":11210,"_1893":11211,"_1802":11212},"The LangChain.js side has also introduced the @langchain/mcp-adapters package to increase flexibility in multi-agent workflows. This lightweight adapter converts remote and local MCP tool interfaces into native LangChain Tool classes in real-time. This allows you to immediately inject and utilize external MCP server tools without modifying existing complex workflows or state machine structures.","LangChain.js陣営も@langchain/mcp-adaptersパッケージを導入し、マルチエージェントフローにおける柔軟性を高めました。この軽量アダプターは、リモートおよびローカルのMCPツールインターフェースを、ネイティブなLangChain Toolクラスにリアルタイムで変換します。これにより、既存の複雑なワークフローやステートマシン構造を変更することなく、外部MCPサーバーのツールを即座に注入して利用可能です。","LangChain.js 진영 역시 @langchain/mcp-adapters 패키지를 도입하여 멀티 에이전트 흐름에서 유연성을 높였습니다. 이 경량 어댑터는 원격과 로컬의 MCP 도구 인터페이스를 네이티브 LangChain Tool 클래스로 실시간 변환해 줍니다. 덕분에 기존에 구축해 둔 복잡한 워크플로우나 상태 머신 구조를 변경하지 않고도, 외부 MCP 서버의 도구들을 즉시 주입해 활용할 수 있습니다.",{"_11214":11215,"_11216":11217,"_11218":11219},"item:1890345d-c535-4bc1-8cc9-e7646bfa2405",{"_1892":11194,"_1893":11194,"_1802":11194},"item:c425c266-a90c-4055-9a0e-a725794c32eb",{"_1892":11202,"_1893":11202,"_1802":11202},"item:c813cbe1-ff34-41b2-9667-446b88db9d1b",{"_1892":11186,"_1893":11186,"_1802":11186},{"_2571":11221},{"_1892":11222,"_1893":11223,"_1802":10950},"The way AI agents integrate with external tools and databases has long varied by model, creating significant overhead for developers. The Model Context Protocol (MCP) is rapidly establishing itself as the standard interface to resolve this fragmentation. In particular, the recently released stateless HTTP-based specification candidate and TypeScript SDK v2.0 completely eliminate the burden of complex session management, leading a shift toward lightweight, stateless architectures. In this article, we cover the essential changes in the MCP ecosystem and practical integration patterns that full-stack developers should focus on right now.","AIエージェントが外部ツールやデータベースと連携する方法は、これまでモデルごとに異なり、開発者にとって大きな手間となっていました。モデルコンテキストプロトコル（MCP）は、この断片化を解消する標準インターフェースとして急速に定着しつつあります。特に最近公開されたステートレスHTTPベースの仕様候補とTypeScript SDK v2.0は、複雑なセッション管理の負担を完全に取り除き、軽量なステートレスアーキテクチャへの転換を促しています。本稿では、フルスタックエンジニアが今すぐ注目すべきMCPエコシステムの変革と、実際の統合パターンについて、その核心を解説します。",{"_2571":11225},{"_1892":11226,"_1893":11227,"_1802":11160},"If you are a full-stack developer, instead of implementing custom tool integration logic for every framework, it is better to focus on building a standardized MCP layer. We hope you experience for yourself the high productivity and stability that a simple yet robust stateless architecture provides.","フルスタック開発者であれば、フレームワークごとにバラバラだったツール連携ロジックを個別に実装するのではなく、標準化されたMCPレイヤーを構築することに注力するのが良いでしょう。シンプルかつ堅牢なステートレスアーキテクチャがもたらす高い生産性と安定性を、ぜひ体験してみてください。",{"_2571":11229},{"_1892":11230,"_1893":11231,"_1802":11112},"From UI Rendering to Local Execution: MCP Apps and Code Mode","UIレンダリングからローカル実行まで：MCP Appsとコードモード",{"_2571":11233},{"_1892":11234,"_1893":11235,"_1802":10958},"The Shift to Stateless HTTP: The End of Session Management and Infinite Scalability","ステートレスHTTPへの移行：セッション管理の終焉と無限の拡張性",{"_2571":11237},{"_1892":11238,"_1893":11239,"_1802":10966},"The original MCP specification relied on a session-based approach where the client and server maintained a persistent connection. This made horizontal scaling across multiple servers extremely difficult when moving beyond local development environments into production with increased traffic.","従来のMCP仕様は、クライアントとサーバー間で接続を維持し続けるセッション方式でした。そのため、ローカル開発環境を離れて実際のサービスでトラフィックが増加した際、複数のサーバーへの水平展開が非常に困難でした。",{"_2571":11241},{"_1892":11242,"_1893":11243,"_1802":11077},"The following is a representative integration pattern that uses the Vercel AI SDK to dynamically inject remote HTTP-based MCP tools into an agent.","以下はVercel AI SDKを使用して、リモートHTTPベースのMCPツールをエージェントに動的に注入する代表的な連携パターンです。",{"_2571":11245},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":11247},{"_1892":11248,"_1893":11249,"_1802":11128},"Vercel's MCP Apps approach allows agent tools to return sandboxed HTML UI resources instead of simple text. Because it renders interactive interfaces in real-time within the browser's iframe environment, it can provide a rich visual user experience immediately. However, since the client browser must dynamically render external code, developers bear the responsibility of implementing strict iframe security policies.","VercelのMCP Appsは、エージェントツールが単純なテキストではなく、サンドボックス化されたHTML UIリソースを返す仕組みです。ブラウザ内のiframe環境で対話型インターフェースをリアルタイムにレンダリングするため、豊かな視覚的ユーザー体験を即座に提供できます。ただし、クライアントブラウザ上で外部コードを動的にレンダリングするため、厳格なiframeセキュリティポリシーを遵守するという開発上の責任が伴います。",{"_2571":11251},{"_1892":11252,"_1893":11253,"_1802":11091},"When this code runs, the SDK dynamically fetches the tool specifications from the remote server and instantly connects them to the model's tool-calling cycle.","このコードが実行されると、SDK内部でリモートサーバーのツール定義を動的に取得し、即座にモデルのツール呼び出しサイクルに接続します。",{"_2571":11255},{"_1892":11256,"_1893":11257,"_1802":10994},"Integrating TypeScript SDK v2.0 and Standard Schema v1.0","TypeScript SDK v2.0とStandard Schema v1.0の統合",{"_2571":11259},{"_1892":11260,"_1893":11261,"_1802":11051},"Vercel AI SDK and LangChain.js, the leading AI frameworks in the JavaScript and TypeScript ecosystem, support the latest MCP specification as a first-class citizen, drastically lowering the complexity of client integration.","JavaScriptおよびTypeScriptエコシステムの代表的なAIフレームワークであるVercel AI SDKとLangChain.jsは、最新のMCP仕様をファーストクラスでサポートしており、クライアント連携の複雑さを劇的に低減させています。",{"_2571":11263},{"_1892":11264,"_1893":11265,"_1802":10986},"Now, MCP servers function independently like standard REST APIs without needing to store state. Developers can freely deploy MCP servers behind round-robin load balancers to scale flexibly with traffic, making it easier to operate AI tools as stable service layers in cloud-native environments.","これからはMCPサーバーの状態を保持する必要はなく、標準的なREST APIのように独立して動作します。開発者はラウンドロビンロードバランサーの背後にMCPサーバーを自由に配置してトラフィックに応じて柔軟に拡張でき、クラウドネイティブ環境においてAIツールを安定したサービスレイヤーとして容易に運用可能です。",{"_2571":11267},{"_1892":11268,"_1893":11269,"_1802":11270},"Below is a simple example of passing a Zod schema directly to the tool configuration block using the @modelcontextprotocol/server package.","以下は@modelcontextprotocol/serverパッケージを使用して、Zodスキーマをツール設定ブロックに直接渡す簡単な例です。","다음은 @modelcontextprotocol/server 패키지를 사용해 Zod 스키마를 도구 설정 블록에 직접 전달하는 간단한 예시입니다.",{"_2571":11272},{"_1892":11273,"_1893":11274,"_1802":11152},"MCP is positioning itself not just as a simple local development tool, but as a standard specification for stateless agents capable of horizontal scaling across large-scale cloud infrastructure. This evolution, stripping away the hassle of session maintenance and moving toward standard HTTP specs and TypeScript SDK v2.0, provides a clear roadmap for engineers concerned with scalable AI applications.","MCPは単なるローカル開発ツールを超え、大規模クラウドインフラで水平拡張可能なステートレスエージェントの標準規格として定着しつつあります。セッション維持の手間を取り除き、標準HTTP仕様とTypeScript SDK v2.0へと進化した今回の変更は、拡張性のあるAIアプリケーションを模索するエンジニアに明確な道筋を示しています。",{"_2571":11276},{"_1892":11277,"_1893":11278,"_1802":11035},"As shown, SDK v2.0 provides the flexibility to be agnostic of schema libraries. Developers can quickly build secure MCP tool servers by integrating the validation libraries they are already comfortable with, without needing to rewrite existing runtime validation logic.","このようにSDK v2.0では、スキーマライブラリに依存しない柔軟性を確保しました。開発者は既存のランタイム検証ロジックを書き直すことなく、使い慣れた検証ライブラリをそのまま活用し、安全なMCPツールサーバーを素早く構築できます。",{"_2571":11280},{"_1892":11281,"_1893":11282,"_1802":11144},"Conclusion: Building Lightweight and Simple Stateless AI Infrastructure","まとめ：軽量でシンプルなステートレスAIインフラの構築",{"_2571":11284},{"_1892":11285,"_1893":11286,"_1802":11043},"Client Integration with Vercel AI SDK and LangChain.js","Vercel AI SDKおよびLangChain.jsのクライアント連携",{"_2571":11288},{"_1892":11289,"_1893":11290,"_1802":11291},"For the Vercel AI SDK, the @ai-sdk/mcp package simplifies this process immensely via createMCPClient. A client generated by specifying a remote HTTP server URL dynamically converts server tools into standard AI SDK tool formats without complex handshakes.","Vercel AI SDKの場合、@ai-sdk/mcpパッケージが提供するcreateMCPClientによって、このプロセスが極めて簡素化されました。リモートHTTPサーバーのURLを指定して作成されたクライアントは、複雑なハンドシェイクなしに、サーバー側のツールを標準のAI SDKツール形式へと動的に変換します。","Vercel AI SDK의 경우, @ai-sdk/mcp 패키지가 제공하는 createMCPClient를 통해 이 과정을 극도로 단순화했습니다. 원격 HTTP 서버 URL을 지정하여 생성된 클라이언트는 복잡한 핸드셰이크 없이도 서버의 도구들을 표준 AI SDK 도구 형태로 동적으로 변환해 줍니다.",{"_2571":11293},{"_1892":11294,"_1893":11295,"_1802":11010},"Thanks to this, simply defining schemas with tools already widely used in projects—like Zod, Valibot, or ArkType—allows the SDK to automatically convert them into runtime validation and static type inference code. This drastically reduces complex boilerplate code for validation, significantly improving the developer experience.","これにより、プロジェクトで既に広く使われているZodやValibot、ArkTypeなどでスキーマを定義するだけで、SDKがそれを自動的にランタイム検証および静的型推論コードに変換します。複雑なバリデーションのボイラープレートコードが劇的に減り、開発者体験が大きく向上しました。",{"_2571":11297},{"_1892":10864,"_1893":10865,"_1802":10866},{"_2571":11299},{"_1892":11300,"_1893":11301,"_1802":11136},"Conversely, the Code Mode proposed by Cloudflare focuses on drastically reducing latency and API costs. Previously, inefficient round trips were required to combine multiple tools, where the model communicated repeatedly and passed back values. In Code Mode, by utilizing MCP APIs provided by the client, the model writes TypeScript code that can be executed locally in one go and hands over control to execute it directly. While it has the advantage of resolving multiple network round trips with a single code generation, it carries the security burden of having to build a robust, isolated sandbox infrastructure to safely execute arbitrary code written by the model.","一方、Cloudflareが提唱するコードモードは、遅延とAPIコストを劇的に削減することに焦点を当てています。従来、複数のツールを組み合わせるには、モデルと毎回通信して結果を再送するという非効率な往復処理が必要でした。コードモードでは、クライアントが提供するMCP APIを活用してモデルがローカルで実行可能なTypeScriptコードを一括作成し、それを直接実行するよう制御を委譲します。何度もネットワークを往復する手間を一度のコード生成で解決できる利点がありますが、モデルが作成した任意のコードを安全に実行するために、分離された強力なサンドボックスインフラを構築する必要があるというセキュリティ上の負担が存在します。",{"_2571":11303},{"_1892":11304,"_1893":11305,"_1802":11120},"Architectural innovations are underway, moving beyond simple text responses to agents directly rendering UIs for users or executing code locally. Recent representative shifts in the agent ecosystem can be summarized by the MCP Apps pattern led by Vercel and the Code Mode pattern from Cloudflare.","単なるテキスト応答を超え、エージェントがユーザー画面に直接UIを描画したり、ローカルでコードを直接実行したりするアーキテクチャの革新が起きています。最近のエージェントエコシステムにおける代表的な変化は、Vercelが主導する「MCP Apps」パターンと、Cloudflareの「コードモード」パターンに集約されます。",{"_2571":11307},{"_1892":11308,"_1893":11309,"_1802":11310},"The newly released 2026-07-28 spec candidate introduces a stateless HTTP transport model to address these limitations. The key change is the complete removal of the complex initial handshake process and the session identifier, Mcp-Session-Id.","新たに公開された2026-07-28仕様候補では、この制限を解消するためにステートレスHTTPトランスポートモデルが導入されました。従来の複雑な初期ハンドシェイクプロセスと、セッション識別子であるMcp-Session-Idを完全に取り除いたのが核心です。","새롭게 공개된 2026-07-28 스펙 후보는 이러한 한계를 해결하기 위해 무상태 HTTP 전송 모델을 도입했습니다. 기존의 복잡한 초기 핸드셰이크 과정과 세션 식별자인 Mcp-Session-Id를 완전히 제거한 것이 핵심입니다.","![MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준](file:cms1b6m8b01g110pb98ifk7tv)\n\n# MCP v2와 무상태 HTTP — AI 에이전트 도구 연동의 새로운 표준\n\nAI 에이전트가 외부 도구나 데이터베이스와 연동하는 방식은 그동안 모델마다 달라 개발자들에게 큰 번거로움이었습니다. 모델 컨텍스트 프로토콜(MCP)은 이러한 파편화를 해결하는 표준 인터페이스로 빠르게 자리 잡고 있습니다. 특히 최근 공개된 무상태 HTTP 기반의 스펙 후보와 타입스크립트 SDK v2.0은 복잡한 세션 관리 부담을 완전히 걷어내며 가벼운 무상태 아키텍처로의 전환을 이끌고 있습니다. 이번 글에서는 풀스택 개발자가 지금 당장 주목해야 할 MCP 생태계의 변화와 실제 통합 패턴을 핵심만 살펴봅니다.\n\n## 무상태 HTTP로의 전환: 세션 관리의 종말과 무한 확장성\n\n기존 MCP 사양은 클라이언트와 서버가 연결을 계속 유지하는 세션 방식이었습니다. 이 때문에 로컬 개발 환경을 벗어나 실서비스에서 트래픽이 늘어날 때 여러 대의 서버로 수평 확장을 하기가 매우 까다로웠습니다.\n\n새롭게 공개된 2026-07-28 스펙 후보는 이러한 한계를 해결하기 위해 무상태 HTTP 전송 모델을 도입했습니다. 기존의 복잡한 초기 핸드셰이크 과정과 세션 식별자인 `Mcp-Session-Id`를 완전히 제거한 것이 핵심입니다.\n\n이제 MCP 서버는 상태를 기억할 필요 없이 표준 REST API처럼 독립적으로 동작합니다. 개발자는 라운드 로빈 로드 밸런서 뒤에 MCP 서버를 자유롭게 배치하여 트래픽에 맞춰 유연하게 확장할 수 있으며, 클라우드 네이티브 환경에서 AI 도구를 안정적인 서비스 레이어로 쉽게 운영할 수 있습니다.\n\n## TypeScript SDK v2.0과 Standard Schema v1.0의 통합\n\n새로운 공식 TypeScript SDK v2.0의 핵심 변화는 도구의 데이터 검증 레이어가 완전히 표준화되었다는 점입니다. 이전에는 JSON 스키마를 손수 작성하거나 전용 어댑터 패키지에 의존해야 했지만, 이제는 자바스크립트 생태계의 공통 검증 규격인 스탠다드 스키마(Standard Schema) v1.0을 모듈 내부에 통합했습니다.\n\n이 덕분에 프로젝트에서 이미 널리 쓰고 있는 조드(Zod)나 발리보, 아크타입(ArkType) 같은 도구로 스키마를 정의하기만 하면 SDK가 이를 알아서 런타임 검증과 정적 타입 추론 코드로 변환해 줍니다. 복잡한 유효성 검사 보일러플레이트 코드가 획기적으로 줄어들어 개발자 경험이 크게 향상되었습니다.\n\n다음은 `@modelcontextprotocol/server` 패키지를 사용해 Zod 스키마를 도구 설정 블록에 직접 전달하는 간단한 예시입니다.\n\n```typescript\nimport { McpServer } from \"@modelcontextprotocol/server\";\nimport { z } from \"zod\";\n\nconst server = new McpServer({\n name: \"weather-mcp-server\",\n version: \"2.0.0\",\n});\n\n// Standard Schema v1.0 지원으로 Zod 스키마가 직접 호환됩니다.\nserver.tool(\n \"get_weather\",\n {\n city: z.string().describe(\"날씨를 조회할 도시 이름\"),\n unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n },\n async ({ city, unit }) => {\n return {\n content: [{ type: \"text\", text: `${city}의 현재 온도는 24도(${unit})입니다.` }],\n };\n }\n);\n```\n\n이처럼 SDK v2.0에서는 스키마 라이브러리에 종속되지 않는 유연성을 확보했습니다. 개발자는 기존 런타임 유효성 검사 로직을 재작성할 필요 없이, 이미 익숙한 검증 라이브러리를 그대로 결합하여 안전한 MCP 도구 서버를 빠르게 구축할 수 있습니다.\n\n## Vercel AI SDK 및 LangChain.js의 클라이언트 연동\n\n자바스크립트 및 타입스크립트 생태계의 대표적인 AI 프레임워크인 Vercel AI SDK와 LangChain.js는 최신 MCP 사양을 일급 객체로 지원하며 클라이언트 연동의 복잡성을 획기적으로 낮췄습니다.\n\nVercel AI SDK의 경우, `@ai-sdk/mcp` 패키지가 제공하는 `createMCPClient`를 통해 이 과정을 극도로 단순화했습니다. 원격 HTTP 서버 URL을 지정하여 생성된 클라이언트는 복잡한 핸드셰이크 없이도 서버의 도구들을 표준 AI SDK 도구 형태로 동적으로 변환해 줍니다.\n\n다음은 Vercel AI SDK를 사용하여 원격 HTTP 기반 MCP 도구를 에이전트에 동적으로 주입하는 대표적인 연동 패턴입니다.\n\n```typescript\nimport { createMCPClient } from '@ai-sdk/mcp';\nimport { generateText } from 'ai';\n\nconst mcpClient = await createMCPClient({\n transport: { type: 'http', url: 'https://api.example.com/mcp' }\n});\n\nconst { text } = await generateText({\n model: myModel, // 사전 정의된 AI 모델 객체\n tools: await mcpClient.tools(),\n prompt: '사용 가능한 도구를 사용해 배송 상태를 조회해줘.'\n});\n```\n\n이 코드가 실행되면 SDK 내부적으로 원격 서버의 도구 명세를 동적으로 가져와 즉시 모델의 도구 호출 주기에 연결합니다.\n\nLangChain.js 진영 역시 `@langchain/mcp-adapters` 패키지를 도입하여 멀티 에이전트 흐름에서 유연성을 높였습니다. 이 경량 어댑터는 원격과 로컬의 MCP 도구 인터페이스를 네이티브 LangChain Tool 클래스로 실시간 변환해 줍니다. 덕분에 기존에 구축해 둔 복잡한 워크플로우나 상태 머신 구조를 변경하지 않고도, 외부 MCP 서버의 도구들을 즉시 주입해 활용할 수 있습니다.\n\n## UI 렌더링부터 로컬 실행까지: MCP Apps와 코드 모드\n\n단순한 텍스트 답변을 넘어 에이전트가 사용자 화면에 직접 UI를 그리거나 로컬에서 코드를 직접 실행하는 아키텍처 혁신이 일어나고 있습니다. 최근 에이전트 생태계의 대표적인 변화는 버셀이 주도하는 MCP Apps 패턴과 클라우드플레어의 코드 모드 패턴으로 요약할 수 있습니다.\n\n버셀의 MCP Apps는 에이전트 도구가 단순 텍스트 대신 샌드박스 처리된 HTML UI 리소스를 반환하는 방식입니다. 브라우저 내부의 아이프레임 환경에서 실시간으로 대화형 인터페이스를 렌더링하기 때문에 풍부한 시각적 사용자 경험을 즉시 제공할 수 있습니다. 다만 클라이언트 브라우저에서 외부 코드를 동적으로 렌더링해야 하는 만큼, 엄격한 아이프레임 보안 정책을 수반해야 한다는 개발상의 책임이 따릅니다.\n\n반면 클라우드플레어가 제시한 코드 모드는 지연 시간과 API 비용을 극적으로 줄이는 데 집중합니다. 기존에는 여러 도구를 결합하기 위해 모델과 매번 통신하며 결과값을 다시 전달하는 비효율적인 왕복 과정이 필요했습니다. 코드 모드에서는 클라이언트가 제공하는 MCP API들을 활용해 모델이 로컬에서 실행할 수 있는 타입스크립트 코드를 한 번에 작성하고, 이를 직접 수행하도록 제어권을 넘깁니다. 여러 번의 네트워크 왕복을 단 한 번의 코드 생성으로 해결하는 장점이 있지만, 모델이 작성한 임의의 코드를 안전하게 실행하기 위해 격리된 강력한 샌드박스 인프라를 직접 구축해야 하는 보안 부담이 존재합니다.\n\n## 정리하며: 가볍고 단순한 무상태 AI 인프라 구축하기\n\nMCP는 단순한 로컬 개발 도구를 넘어 대규모 클라우드 인프라에서 수평 확장이 가능한 무상태 에이전트의 표준 규격으로 자리 잡고 있습니다. 세션 유지의 번거로움을 걷어내고 표준 HTTP 사양과 타입스크립트 SDK v2.0으로 진화한 이번 변화는 확장 가능한 AI 애플리케이션을 고민하는 엔지니어들에게 명확한 이정표를 보여줍니다.\n\n풀스택 개발자라면 이제 프레임워크마다 제각각이었던 도구 연동 로직을 직접 구현하는 대신, 표준화된 MCP 레이어를 구축하는 데 집중하는 것이 좋습니다. 단순하면서도 견고한 무상태 아키텍처가 선사하는 높은 생산성과 안정성을 직접 경험해 보시길 바랍니다.\n\n---\n\n**참고 링크**\n\n- [GitHub - modelcontextprotocol/typescript-sdk & Developer Community — MCP 2026-07-28 Specification Candidate & TypeScript SDK v2.0](https://github.com/modelcontextprotocol/typescript-sdk)\n- [FastAPI Official Release Notes — FastAPI 0.139.2 Maintenance Update](https://fastapi.tiangolo.com/release-notes/)\n- [byteiota Technical Blog — Serialization Performance: msgspec vs Pydantic V2 (2026 Analysis)](https://byteiota.com/litestar-vs-fastapi-python-speed-test-2026-analysis/)","cd6f72641e14ac202b2e8d49f5e4f4691502a946d6f0d224cc4ae4d1edc59ab5",59,"2026-07-26T03:35:40.181Z","2026-07-26T17:27:36.692Z",[],[11318],{"_2802":2806,"_1881":7262},{"_950":11320,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":11321,"_1889":11328,"_2455":-5,"_2456":-5,"_2457":-5,"_9":11332,"_2450":11340,"_2458":11341,"_2460":-5,"_723":11342,"_1886":11343,"_332":11346,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":11347,"_2003":11348,"_2480":11349,"_2482":-5,"_2483":11350,"_2485":-5,"_2486":-5,"_2487":11351,"_1144":11361,"_2527":11374,"_2555":-5,"_2556":11396,"_2798":11789,"_266":11790},"cmrzxs2p7022r10n4noah58i6",{"_1801":1802,"_214":11322,"_2429":11323,"_2434":11325,"_2438":2439},3442,{"_1892":11324,"_1893":1997,"_1802":6258,"_2433":1997},1326,{"_1892":11326,"_1893":1997,"_1802":11327,"_2433":1997},0.3852411388727484,0.6147588611272516,{"_9":11329,"_2445":11333,"_2450":11337},{"_1892":11330,"_1893":11331,"_1802":11332},"Fastify 5 Architecture — Why Focus on Node.js Instead of the Edge?","Fastify 5アーキテクチャ — なぜEdgeではなくNode.jsに注力したのか","Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까",{"_1892":11334,"_1893":11335,"_1802":11336},"Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까\n\nFastify 5 Architecture — Why Focus on Node.js Instead of the Edge?\n\nUnlike the recent framework trend towards Edge or serverless runtimes, Fastify 5 has chosen a direct approach, focusing on its core value: high-performance Node.js backends. By strictly limiting support to Node.js 20 and above, it has boldly shed legacy deprecated APIs and architectural debt.\n\nInstead of chasing serverless lightness, it has taken a smart route that maximizes its powerful plugin isolation architecture and schema-based compilation performance. We explore why Fastify 5 remains the top choice for container environments handling high traffic, along with its underlying core structure and design philosophy.\n\nThe Secret to High Performance: Radix-Tree Router and Avvio Plugin Graph\n\nThe primary engine behind Fastify's ability to handle up to 3x higher throughput than conventional Node.js frameworks lies in its dedicated router and unique plugin architecture. The built-in routing library, find-my-way, uses a radix-tree algorithm to ensure extremely fast route lookups that converge to a constant time regardless of the number of registered routes.\n\nAnother key design element is the Avvio library, which manages asynchronous plugin initialization. Fastify controls plugin relationships and loading order using a Directed Acyclic Graph (DAG) to support perfect scope encapsulation. Since decorators or lifecycle hooks declared within a specific scope do not leak into parent or sibling scopes and are safely isolated within the subtree, it enables the design of side-effect-free microservices.\n\nThis is complemented by the fast-json-stringify engine, which pre-builds serialization code based on JSON schema specifications. By skipping the chronic runtime overhead of standard JSON.stringify calls, it bypasses performance bottlenecks and pushes hardware resources to their limit.\n\nType Provider: Real-time Schema Type Inference Without Build Steps\n\nFastify supports the Type Provider pattern, which maps JSON schemas directly to TypeScript types without extra build steps or schema code generation. When you use schema libraries like Zod or TypeBox to declare runtime validation rules, the compiler understands them and provides perfect static type inference at development time. This fundamentally prevents the chronic synchronization errors that occur when code and validation schemas drift apart.\n\nBy leveraging the widely used fastify-type-provider-zod, you can enjoy safe type inference directly in your route handlers right after initial setup.\n\nimport Fastify from 'fastify';\nimport { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\n\nconst server = Fastify().withTypeProvider();\nserver.setValidatorCompiler(validatorCompiler);\nserver.setSerializerCompiler(serializerCompiler);\n\nserver.post('/users', {\n schema: {\n body: z.object({\n name: z.string().min(2),\n email: z.string().email()\n })\n }\n}, async (req) => {\n const { name, email } = req.body; // 별도의 타입 단언 없이 자동 추론\n return { id: '1', name, email };\n});\n\nSchemas defined in this way not only handle runtime input validation but also integrate with OpenAPI specifications to maximize development productivity. It is a core pillar of high-performance design that combines powerful validation and documentation in real-time, all while bypassing additional build/compilation layers.\n\nFastify 5 Migration Friction and Key Changes\n\nThe most immediately noticeable breaking change when upgrading to Fastify 5 is the stricter schema definition specification. The jsonShorthand option, provided for convenience in previous versions, has been completely removed. You must now strictly adhere to the official JSON schema specification, declaring explicit object types and properties at the top level when writing validation schemas for query strings, request bodies, and responses.\n\nThe changes in schema writing methods based on the official Fastify migration guide are as follows.\n\n// Fastify 4 (이전): 암묵적인 객체 래핑 허용\nfastify.post('/user', {\n schema: {\n body: {\n name: { type: 'string' }\n }\n }\n}, handler);\n\n// Fastify 5 (이후): 명시적인 JSON 스키마 구조 필수\nfastify.post('/user', {\n schema: {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n }\n}, handler);\n\nChanges have also been made to APIs handling network and environment information to ensure compliance with standards. Previously, retrieving req.hostname would include the port number, but starting with Fastify 5, it returns only the domain name, excluding the port, in accordance with the standard Node.js URL object specification. If you need the host and port combination, you must explicitly combine req.host and req.port.\n\nAdditionally, the time format validation rules for the default validation engine, Ajv, have become stricter. Existing 'time' and 'date-time' formats now require standard timezone information to pass validation. For environments where timezone information is dynamic, migration to 'iso-time' or 'iso-date-time' formats is required.\n\nNode.js vs Edge Runtime: Fastify’s Clear Limitations and Target Market\n\nWhile modern frameworks like Hono dominate lightweight edge and serverless environments, Fastify has concentrated all its efforts solely on the Node.js runtime. This is not merely a matter of preference but stems from the fact that the core architecture Fastify adopted for ultra-high performance fundamentally conflicts with the constraints of edge environments.\n\nThe biggest hurdle is the JIT schema compiler design, which is essential for performance optimization. Fastify uses Ajv and fast-json-stringify to dynamically compile schemas at runtime using the eval function, boosting serialization speeds significantly over standard JSON. However, in V8 isolate-based environments like Cloudflare Workers or Vercel Edge, dynamic code evaluation is strictly forbidden for security reasons, resulting in EvalError during execution, making it impossible to run.\n\nFurthermore, the multi-threaded worker architecture utilized by Pino (Fastify's default logger) and its deep reliance on the node:http standard module also trigger malfunctions in highly constrained serverless environments. According to APIScout analysis, due to these technical characteristics, Fastify is best suited for traditional backend architectures where large-scale traffic is consistently handled in container-based microservices or dedicated virtual servers, rather than edge computing distributed across global networks.\n\nUltimately, instead of losing its identity by half-heartedly supporting every infrastructure platform, Fastify has chosen to stick to its principles—utilizing Node.js backend resources to the absolute limit—thereby successfully establishing a unique, high-performance segment.\n\nChoosing a Realistic Framework for Your Infrastructure Goals\n\nFastify 5 is a framework that hasn't been swept up by the edge computing trend, choosing instead to focus on the core value of building high-performance servers in Node.js environments. While lightweight frameworks like Hono might be the optimal choice for edge nodes or serverless environments, the criteria change when you need to reliably operate persistent backend services in container clusters or virtual server environments. In such performance-critical environments, the combination of Fastify 5's powerful type safety and overwhelming throughput is the most attractive solution for both development productivity and infrastructure efficiency.\n\nReference Links\n\nDeveloper Analysis & Official Docs — Architectural Foundation: Radix Routing, Plugin Encapsulation, and Diagnostics\nAPIScout Technical Analysis — Framework Comparison 2026: Fastify vs Hono vs Express 5\nFastify TypeScript Documentation — TypeScript End-to-End Type Safety and Type Providers","Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까\n\nFastify 5アーキテクチャ — なぜEdgeではなくNode.jsに注力したのか\n\nFastify 5は、エッジやサーバーレスランタイムへと向かう昨今のフレームワークのトレンドとは異なり、Node.jsバックエンドの高性能化という本来の価値に集中する正攻法を選択しました。サポートエンジンをNode.js 20バージョン以上に明確に制限することで、古い減価償却APIやアーキテクチャの負債を大胆に削減しました。\n\nサーバーレスの軽量さの代わりに、強力なプラグイン分離アーキテクチャとスキーマベースのコンパイル性能を最大化する賢い路線を選択した結果です。大規模なトラフィックを処理するコンテナ環境においてFastify 5が依然として最高の選択である理由と、それを貫く核心的な構造および設計哲学を解説します。\n\n高性能の秘密: radix-treeルーターとAvvioプラグイングラフ\n\nFastifyが既存のNode.jsフレームワークと比較して最大3倍高いスループットを誇る核心的な原動力は、専用ルーターと独自のプラグインアーキテクチャにあります。内蔵のルーティングライブラリ「find-my-way」は、ラディックスツリーアルゴリズムを活用しており、登録されたパスがどれだけ増えても、定数に収束する極めて高速なパス検索性能を保証します。\n\nもう一つの設計上の鍵は、非同期プラグインの実行を制御する「Avvio」ライブラリです。Fastifyは、非巡回有向グラフの形式でプラグインの関係と読み込み順序を制御し、完璧なスコープのカプセル化をサポートします。特定のスコープ内で宣言されたデコレーターやライフサイクル・フックが、上位や兄弟のスコープに漏れ出すことなく、サブツリー内部のみに安全に隔離されるため、副作用のないマイクロサービス設計が可能になります。\n\nさらに、JSONスキーマ仕様に基づいてシリアライズコードを事前ビルドする「fast-json-stringify」エンジンが加わります。標準のJSON.stringify呼び出し方式における宿命的なランタイム・オーバーヘッドを排除し、パフォーマンスのボトルネックを完全に回避することで、ハードウェアリソースを極限まで引き出します。\n\nType Provider: ビルドステップ不要のリアルタイム・スキーマ型推論\n\nFastifyは、別途のビルドステップやスキーマコードの生成なしに、JSONスキーマをTypeScript型へ直接マッピングする「Type Provider」パターンをサポートしています。ZodやTypeBoxのようなスキーマライブラリを使用してランタイムのバリデーションルールを宣言すれば、コンパイラがこれを理解し、開発時点で完璧な静的型としてリアルタイムに推論してくれます。おかげで、コードと検証スキーマが一致せずに発生する慢性的な同期エラーを根本から予防できます。\n\n最も広く使われている「fastify-type-provider-zod」を活用すれば、初期設定後、次のようにルートハンドラーで安全な型推論をすぐに享受できます。\n\nimport Fastify from 'fastify';\nimport { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\n\nconst server = Fastify().withTypeProvider();\nserver.setValidatorCompiler(validatorCompiler);\nserver.setSerializerCompiler(serializerCompiler);\n\nserver.post('/users', {\n schema: {\n body: z.object({\n name: z.string().min(2),\n email: z.string().email()\n })\n }\n}, async (req) => {\n const { name, email } = req.body; // 별도의 타입 단언 없이 자동 추론\n return { id: '1', name, email };\n});\n\nこのように定義されたスキーマは、ランタイムの入力値検証だけでなく、OpenAPIドキュメント仕様とも連動し、開発生産性を極限まで高めます。追加のビルド・コンパイルレイヤーを回避しながらも、強力な検証とドキュメント化のメリットをリアルタイムで統合できる、高性能設計の核心的な柱です。\n\nFastify 5のマイグレーションにおける摩擦と主な変更点\n\nFastify 5へメジャーバージョンを上げる際、最も先に実感する破壊的変更は、スキーマ定義仕様の厳格化です。以前のバージョンまで利便性のために提供されていた「jsonShorthand」オプションが完全に削除されました。今後は、クエリ文字列、リクエストボディ、レスポンスなどの検証スキーマを作成する際、最上位に明示的なオブジェクトタイプと属性を宣言する正式なJSONスキーマ仕様を必ず遵守する必要があります。\n\nFastify公式のマイグレーションガイドに基づく、スキーマ作成方式の変更点は以下の通りです。\n\n// Fastify 4 (이전): 암묵적인 객체 래핑 허용\nfastify.post('/user', {\n schema: {\n body: {\n name: { type: 'string' }\n }\n }\n}, handler);\n\n// Fastify 5 (이후): 명시적인 JSON 스키마 구조 필수\nfastify.post('/user', {\n schema: {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n }\n}, handler);\n\nネットワークや環境情報を扱うAPIにも、標準を遵守するための変更がありました。以前はreq.hostnameの照会時にポート番号が含まれて返されていましたが、Fastify 5からはNode.js標準のURLオブジェクト仕様に合わせて、ポートを除いたドメイン名のみが返されます。従来のホストとポートの組み合わせ情報が必要な場合は、req.hostやreq.portを明示的に組み合わせて使用する必要があります。\n\nまた、標準の検証エンジンであるAjvの時間フォーマット検証ルールもさらに厳格になりました。既存の「time」および「date-time」フォーマットは、必ず標準時間帯情報を含めないと検証を通過しなくなりました。時間帯情報が流動的な環境であれば、「iso-time」または「iso-date-time」フォーマットへ設定を切り替えるマイグレーション作業が必要です。\n\nNode.js vs Edgeランタイム: Fastifyの明確な限界とターゲット市場\n\nHonoのようなモダンなフレームワークが軽量エッジやサーバーレス環境を掌握する傍ら、FastifyはNode.jsランタイムのみに全力を注ぎました。これは単なる好みの違いではなく、Fastifyが超高速なパフォーマンスを出すために採用した核心的なアーキテクチャが、エッジ環境の制約条件と根本的に衝突するためです。\n\n最大の障害は、パフォーマンス最適化の核である「JITスキーマコンパイラ」の設計です。FastifyはAjvとfast-json-stringifyを活用し、ランタイムにeval関数でスキーマを動的コンパイルすることで、シリアライズ速度を通常のJSONと比べて数倍以上に引き上げます。しかし、Cloudflare WorkersやVercel EdgeのようなV8アイソレート環境では、セキュリティ上の理由から動的なコード評価が完全に禁止されているため、実行時にEvalErrorを吐き出し、動作自体が不可能です。\n\nまた、FastifyのデフォルトロガーであるPinoが活用するマルチスレッドワーカー・アーキテクチャと、node:http標準モジュールへの深い依存性も、コンテキストが極めて制限されたサーバーレス環境では誤動作を引き起こす要因となります。APIScoutの分析によると、こうした技術的特性のため、Fastifyは世界中のネットワークに分散デプロイされるエッジコンピューティングよりも、コンテナベースのマイクロサービスや独立した仮想サーバーで永続的に大規模トラフィックを処理する、従来のバックエンドアーキテクチャに最も適しています。\n\n結局、Fastifyはあらゆるインフラプラットフォームを中途半端にサポートして個性を失うのではなく、Node.jsバックエンドインフラが提供するリソースを極限まで活用する正攻法を選択し、独自で高性能なセグメントを構築することに成功しました。\n\nインフラ目的に適した現実的なフレームワーク選定\n\nFastify 5はエッジコンピューティングのトレンドに流されることなく、Node.js環境での高性能サーバー構築という核心的な価値に集中したフレームワークです。世界中に広がるネットワークのエッジノードや軽量なサーバーレス環境を目指すならHonoのような軽量フレームワークが最適な選択肢となりますが、コンテナクラスターや仮想サーバー環境で永続的なバックエンドサービスを安定して運用する必要がある場合、判断基準は異なります。このように大規模トラフィック処理が重要な永続サーバー環境では、強力な型安全性と圧倒的なスループットを共に保証するFastify 5とType Providerの組み合わせが、開発生産性とインフラ効率の観点から最も魅力的な答えとなるでしょう。\n\n参考リンク\n\nDeveloper Analysis & Official Docs — Architectural Foundation: Radix Routing, Plugin Encapsulation, and Diagnostics\nAPIScout Technical Analysis — Framework Comparison 2026: Fastify vs Hono vs Express 5\nFastify TypeScript Documentation — TypeScript End-to-End Type Safety and Type Providers","Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까\n\nFastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까\n\nFastify 5는 엣지나 서버리스 런타임으로 향하는 최근의 프레임워크 트렌드와 달리, Node.js 백엔드 고성능화라는 본연의 가치에 집중하는 정공법을 선택했습니다. 지원 엔진을 Node.js 20 버전 이상으로 명확히 제한하면서 오래된 감가상각 API와 아키텍처 부채를 과감하게 덜어냈습니다.\n\n서버리스의 가벼움 대신 강력한 플러그인 격리 아키텍처와 스키마 기반 컴파일 성능을 극대화하는 영리한 노선을 택한 결과입니다. 대규모 트래픽을 처리하는 컨테이너 환경에서 Fastify 5가 여전히 최고의 선택인 이유와, 이를 관통하는 핵심 구조 및 설계 철학을 톺아봅니다.\n\n고성능의 비밀: radix-tree 라우터와 Avvio 플러그인 그래프\n\nFastify가 기존 Node.js 프레임워크 대비 최대 3배 높은 처리량을 보여주는 핵심 동력은 전용 라우터와 독보적인 플러그인 아키텍처에 있습니다. 내장 라우팅 라이브러리인 find-my-way는 라딕스 트리 알고리즘을 활용해 등록된 경로가 아무리 많아져도 상수에 수렴하는 극도로 빠른 경로 검색 성능을 보장합니다.\n\n또 다른 설계적 핵심은 비동기 플러그인 구동을 제어하는 아비오(Avvio) 라이브러리입니다. Fastify는 비순환 지향 그래프 형태로 플러그인의 관계와 로딩 순서를 제어하여 완벽한 스코프 캡슐화를 지원합니다. 특정 스코프 안에서 선언한 데코레이터나 생명주기 훅이 상위나 형제 스코프로 새어 나가지 않고 오직 하위 트리 내부로만 안전하게 격리되므로 부수 효과 없는 마이크로서비스 설계가 가능해집니다.\n\n여기에 JSON 스키마 명세를 기반으로 직렬화 코드를 사전 빌드하는 fast-json-stringify 엔진이 더해집니다. 표준 JSON.stringify 호출 방식의 고질적인 런타임 오버헤드를 생략하고 성능 병목을 완전히 우회하여 하드웨어 자원을 극한까지 이끌어냅니다.\n\nType Provider: 빌드 단계 없는 실시간 스키마 타입 추론\n\nFastify는 별도의 빌드 단계나 스키마 코드 생성 없이 JSON 스키마를 TypeScript 타입으로 직접 매핑하는 Type Provider 패턴을 지원합니다. Zod나 TypeBox 같은 스키마 라이브러리를 사용해 런타임 유효성 검증 규칙을 선언하면, 컴파일러가 이를 이해하여 개발 시점에 완벽한 정적 타입으로 실시간 추론해 줍니다. 덕분에 코드와 검증 스키마가 일치하지 않아 발생하는 만성적인 동기화 오류를 근본적으로 예방할 수 있습니다.\n\n가장 널리 쓰이는 fastify-type-provider-zod를 활용하면 초기 설정 이후 다음과 같이 라우트 핸들러에서 안전한 타입 추론을 바로 누릴 수 있습니다.\n\nimport Fastify from 'fastify';\nimport { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\n\nconst server = Fastify().withTypeProvider();\nserver.setValidatorCompiler(validatorCompiler);\nserver.setSerializerCompiler(serializerCompiler);\n\nserver.post('/users', {\n schema: {\n body: z.object({\n name: z.string().min(2),\n email: z.string().email()\n })\n }\n}, async (req) => {\n const { name, email } = req.body; // 별도의 타입 단언 없이 자동 추론\n return { id: '1', name, email };\n});\n\n이렇게 정의된 스키마는 런타임 입력값 검증뿐만 아니라 OpenAPI 문서 규격으로도 연동되어 개발 생산성을 극대화합니다. 추가적인 빌드 컴파일 레이어를 우회하면서도 강력한 유효성 검증과 문서화 이점을 실시간으로 결합해 주는 고성능 설계의 핵심 축입니다.\n\nFastify 5 마이그레이션 마찰과 주요 변경점\n\nFastify 5로 메이저 버전을 올릴 때 가장 먼저 체감되는 파괴적 변경 사항은 스키마 정의 규격의 엄격화입니다. 이전 버전까지 편의를 위해 제공되던 jsonShorthand 옵션이 완전히 제거되었습니다. 이제 쿼리스트링, 요청 본문, 응답 등의 검증 스키마를 작성할 때 최상위에 명시적인 객체 타입과 속성을 선언하는 정식 JSON 스키마 규격을 반드시 준수해야 합니다.\n\nFastify 공식 마이그레이션 가이드에 따른 스키마 작성 방식의 변화는 다음과 같습니다.\n\n// Fastify 4 (이전): 암묵적인 객체 래핑 허용\nfastify.post('/user', {\n schema: {\n body: {\n name: { type: 'string' }\n }\n }\n}, handler);\n\n// Fastify 5 (이후): 명시적인 JSON 스키마 구조 필수\nfastify.post('/user', {\n schema: {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n }\n}, handler);\n\n네트워크 및 환경 정보를 다루는 API에도 표준을 준수하기 위한 변화가 생겼습니다. 기존에는 req.hostname 조회 시 포트 번호가 함께 포함되어 반환되었으나, Fastify 5부터는 Node.js 표준 URL 객체 규격에 맞춰 포트를 제외한 도메인명만 반환합니다. 기존의 호스트 및 포트 조합 정보가 필요하다면 req.host나 req.port를 명시적으로 조합해 사용해야 합니다.\n\n또한 기본 유효성 검증 엔진인 Ajv의 시간 포맷 검증 규칙도 한층 더 엄격해졌습니다. 기존 'time'과 'date-time' 포맷은 반드시 표준 시간대 정보를 포함해야 검증을 통과하므로, 시간대 정보가 유동적인 환경이라면 'iso-time' 또는 'iso-date-time' 포맷으로 설정을 전환하는 마이그레이션 작업이 요구됩니다.\n\nNode.js vs Edge 런타임: Fastify의 명확한 한계와 타겟 시장\n\nHono 같은 현대적인 프레임워크가 경량 엣지와 서버리스 환경을 장악하는 사이, Fastify는 오직 Node.js 런타임에 모든 역량을 집중했습니다. 이는 단순한 취향의 차이가 아니라, Fastify가 초고속 성능을 내기 위해 채택한 핵심 아키텍처가 엣지 환경의 제약 조건과 근본적으로 충돌하기 때문입니다.\n\n가장 큰 걸림돌은 성능 최적화의 핵심인 JIT 스키마 컴파일러 설계입니다. Fastify는 Ajv와 fast-json-stringify를 활용해 런타임에 eval 함수로 스키마를 동적 컴파일하여 직렬화 속도를 일반 JSON 대비 몇 배 이상 끌어올립니다. 하지만 Cloudflare Workers나 Vercel Edge 같은 V8 아이솔레이트 격리 환경에서는 보안을 위해 동적 코드 평가가 완전히 금지되어 있어 실행 시점에 EvalError를 뱉으며 구동 자체가 불가능합니다.\n\n또한 Fastify의 기본 로거인 Pino가 활용하는 멀티스레드 워커 아키텍처와 node:http 표준 모듈에 대한 깊은 의존성 역시 컨텍스트가 극도로 제한된 서버리스 환경에서는 오동작을 유발하는 요인이 됩니다. APIScout 분석에 따르면, 이러한 기술적 특성 때문에 Fastify는 전 세계 네트워크에 분산 배포되는 엣지 컴퓨팅보다는 컨테이너 기반 마이크로서비스나 독립 가상 서버에서 영속적으로 대규모 트래픽을 처리하는 전통적인 백엔드 아키텍처에 가장 적합합니다.\n\n결국 Fastify는 모든 인프라 플랫폼을 어설프게 지원하느라 개성을 잃는 대신, Node.js 백엔드 인프라가 제공하는 자원을 극한까지 활용하는 정공법을 선택하여 독보적인 고성능 세그먼트를 구축하는 데 성공했습니다.\n\n인프라 목적에 맞는 현실적인 프레임워크 선택\n\nFastify 5는 엣지 컴퓨팅 트렌드에 휩쓸리지 않고 Node.js 환경의 고성능 서버 구축이라는 핵심 가치에 집중한 프레임워크입니다. 전 세계 네트워크의 엣지 노드나 가벼운 서버리스 환경을 지향한다면 Hono와 같은 경량 프레임워크가 최적의 선택이 될 수 있지만, 컨테이너 클러스터나 가상 서버 환경에서 영속적인 백엔드 서비스를 안정적으로 운영해야 할 때는 판단 기준이 달라집니다. 이처럼 대규모 트래픽 처리가 중요한 영속 서버 환경에서는 강력한 타입 안정성과 압도적인 처리량을 모두 보장하는 Fastify 5와 Type Provider의 결합이 개발 생산성과 인프라 효율 측면에서 가장 매력적인 정답이 될 것입니다.\n\n참고 링크\n\nDeveloper Analysis & Official Docs — Architectural Foundation: Radix Routing, Plugin Encapsulation, and Diagnostics\nAPIScout Technical Analysis — Framework Comparison 2026: Fastify vs Hono vs Express 5\nFastify TypeScript Documentation — TypeScript End-to-End Type Safety and Type Providers",{"_1892":11338,"_1893":11339,"_1802":11340},"Fastify 5 Architecture — Why Focus on Node.js Instead of the Edge? Unlike the recent framework trend towards Edge or serverless runtimes, Fastify 5 has chosen a direct approach, focusing on its core value: high-performan…","Fastify 5アーキテクチャ — なぜEdgeではなくNode.jsに注力したのか Fastify 5は、エッジやサーバーレスランタイムへと向かう昨今のフレームワークのトレンドとは異なり、Node.jsバックエンドの高性能化という本来の価値に集中する正攻法を選択しました。サポートエンジンをNode.js 20バージョン以上に明確に制限することで、古い減価償却APIやアーキテクチャの負債を大胆に削減しました。サーバーレスの軽量さの代…","Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까 Fastify 5는 엣지나 서버리스 런타임으로 향하는 최근의 프레임워크 트렌드와 달리, Node.js 백엔드 고성능화라는 본연의 가치에 집중하는 정공법을 선택했습니다. 지원 엔진을 Node.js 20 버전 이상으로 명확히 제한하면서 오래된 감가상각 API와 아키텍처 부채를 과감하게 덜어냈습니다. 서버리스의 가벼움 대…","cms000gau001810pd7gbb9xki",[6733],[3124,3126,3125,11344,11345],"backend-api","architecture",[],"2026-07-25T21:20:26.127Z","2026-07-25T05:36:26.539Z","2026-07-26T03:38:12.922Z","2026-07-25T21:21:14.543Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":11352},{"_1901":11353},{"_1903":11354,"_1908":1909,"_1910":11355,"_1921":11356,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":11357,"_1928":11358,"_1933":11359,"_1938":11360},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":11362,"_1883":1884,"_1200":1204,"_1899":11365},{"_633":11363,"_11":11364},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":11366},{"_1903":11367,"_1908":1909,"_1910":11368,"_1921":11369,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":11370,"_1928":11371,"_1933":11372,"_1938":11373},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":11375},{"_1948":-5,"_1908":1909,"_1910":11376,"_1960":-5,"_1943":11382,"_1962":11383},{"_1912":11377,"_1914":11378,"_1952":11379,"_1810":2534,"_944":1992,"_1917":11380,"_1957":2536,"_1919":11381},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/763fb6dd-8d2d-4301-b297-c17e8b4891a5.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/763fb6dd-8d2d-4301-b297-c17e8b4891a5.jpg",408351,"L4AT+h~qD*DjS0-;nnM{009Y%f%M","#283838","2026-07-25T06:38:57.259Z",{"_1964":11384,"_1972":11388,"_1979":11392,"_1986":-5},{"_1912":11385,"_1914":11386,"_1952":11387,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/large.webp",24744,{"_1912":11389,"_1914":11390,"_1952":11391,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/small.webp",6510,{"_1912":11393,"_1914":11394,"_1952":11395,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cms000gau001810pd7gbb9xki/medium.webp",14066,{"_950":11397,"_2559":11320,"_2560":11398,"_2716":11679,"_2788":11785,"_2790":11786,"_2792":4226,"_2794":1997,"_2003":11787,"_2480":11788,"_2797":-5},"cmrzxs2pd022s10n4oa1rteev",{"_918":11399,"_1908":1909},[11400,11402,11405,11409,11412,11417,11420,11425,11428,11433,11436,11441,11444,11449,11452,11462,11465,11470,11473,11478,11481,11491,11494,11497,11500,11505,11508,11513,11516,11526,11529,11534,11537,11540,11543,11563,11566,11571,11574,11579,11582,11587,11590,11600,11603,11612,11615,11620,11623,11628,11631,11636,11639,11641,11644,11649,11652],{"_950":11401,"_2565":11332,"_2420":2566,"_2567":11341},"3dfdcc42-c6e8-4da9-bddf-0ab032e79b2d",{"_950":11403,"_2420":2570,"_2571":11404},"49237d92-b517-480d-a1fb-6887a2e96901",[],{"_950":11406,"_2420":2575,"_2576":1909,"_2571":11407},"c92bad51-0297-4890-a272-f1fad9ed3dda",[11408],{"_2579":11332,"_2420":2579},{"_950":11410,"_2420":2570,"_2571":11411},"c5a7ca8b-e26a-46b3-9838-4bb4474af469",[],{"_950":11413,"_2420":2570,"_2571":11414},"75e7ee6f-6aed-46a8-a31b-19b83a876aad",[11415],{"_2579":11416,"_2420":2579},"Fastify 5는 엣지나 서버리스 런타임으로 향하는 최근의 프레임워크 트렌드와 달리, Node.js 백엔드 고성능화라는 본연의 가치에 집중하는 정공법을 선택했습니다. 지원 엔진을 Node.js 20 버전 이상으로 명확히 제한하면서 오래된 감가상각 API와 아키텍처 부채를 과감하게 덜어냈습니다.",{"_950":11418,"_2420":2570,"_2571":11419},"60bc012c-0719-4099-a491-345d37d93516",[],{"_950":11421,"_2420":2570,"_2571":11422},"cb0bea29-e44d-4262-a828-4af5f24c9bfb",[11423],{"_2579":11424,"_2420":2579},"서버리스의 가벼움 대신 강력한 플러그인 격리 아키텍처와 스키마 기반 컴파일 성능을 극대화하는 영리한 노선을 택한 결과입니다. 대규모 트래픽을 처리하는 컨테이너 환경에서 Fastify 5가 여전히 최고의 선택인 이유와, 이를 관통하는 핵심 구조 및 설계 철학을 톺아봅니다.",{"_950":11426,"_2420":2570,"_2571":11427},"b35ad2d8-20b6-4c30-9fc9-15abccfe18ba",[],{"_950":11429,"_2420":2575,"_2576":2007,"_2571":11430},"dd12364f-929d-41eb-925e-0a14909c38f7",[11431],{"_2579":11432,"_2420":2579},"고성능의 비밀: radix-tree 라우터와 Avvio 플러그인 그래프",{"_950":11434,"_2420":2570,"_2571":11435},"c8f07275-fdc6-4417-818d-0400cc991c48",[],{"_950":11437,"_2420":2570,"_2571":11438},"9f445601-f2ce-41d6-a45b-0170feb35820",[11439],{"_2579":11440,"_2420":2579},"Fastify가 기존 Node.js 프레임워크 대비 최대 3배 높은 처리량을 보여주는 핵심 동력은 전용 라우터와 독보적인 플러그인 아키텍처에 있습니다. 내장 라우팅 라이브러리인 find-my-way는 라딕스 트리 알고리즘을 활용해 등록된 경로가 아무리 많아져도 상수에 수렴하는 극도로 빠른 경로 검색 성능을 보장합니다.",{"_950":11442,"_2420":2570,"_2571":11443},"93a62761-701a-4d05-9e1d-762947e6def4",[],{"_950":11445,"_2420":2570,"_2571":11446},"e3a3bee9-2d44-43b5-b589-4b90d2c5c3dd",[11447],{"_2579":11448,"_2420":2579},"또 다른 설계적 핵심은 비동기 플러그인 구동을 제어하는 아비오(Avvio) 라이브러리입니다. Fastify는 비순환 지향 그래프 형태로 플러그인의 관계와 로딩 순서를 제어하여 완벽한 스코프 캡슐화를 지원합니다. 특정 스코프 안에서 선언한 데코레이터나 생명주기 훅이 상위나 형제 스코프로 새어 나가지 않고 오직 하위 트리 내부로만 안전하게 격리되므로 부수 효과 없는 마이크로서비스 설계가 가능해집니다.",{"_950":11450,"_2420":2570,"_2571":11451},"ded11a39-aed6-4055-872c-02b2022240a6",[],{"_950":11453,"_2420":2570,"_2571":11454},"2ee7d166-b7d1-4ada-8641-1b13a0466a75",[11455,11457,11460],{"_2579":11456,"_2420":2579},"여기에 JSON 스키마 명세를 기반으로 직렬화 코드를 사전 빌드하는 fast-json-stringify 엔진이 더해집니다. 표준 ",{"_2579":11458,"_2420":2579,"_3365":11459},"JSON.stringify",{"_3351":3367},{"_2579":11461,"_2420":2579}," 호출 방식의 고질적인 런타임 오버헤드를 생략하고 성능 병목을 완전히 우회하여 하드웨어 자원을 극한까지 이끌어냅니다.",{"_950":11463,"_2420":2570,"_2571":11464},"0184d6f7-ab35-4dfd-9259-baa8eb087e7a",[],{"_950":11466,"_2420":2575,"_2576":2007,"_2571":11467},"91b0bda6-92b9-4ff9-9ed3-7fccbbe53b75",[11468],{"_2579":11469,"_2420":2579},"Type Provider: 빌드 단계 없는 실시간 스키마 타입 추론",{"_950":11471,"_2420":2570,"_2571":11472},"d5bec478-9652-4f50-ac8c-b360fe5b8991",[],{"_950":11474,"_2420":2570,"_2571":11475},"9e8c4561-4919-4879-943d-647b87207d1d",[11476],{"_2579":11477,"_2420":2579},"Fastify는 별도의 빌드 단계나 스키마 코드 생성 없이 JSON 스키마를 TypeScript 타입으로 직접 매핑하는 Type Provider 패턴을 지원합니다. Zod나 TypeBox 같은 스키마 라이브러리를 사용해 런타임 유효성 검증 규칙을 선언하면, 컴파일러가 이를 이해하여 개발 시점에 완벽한 정적 타입으로 실시간 추론해 줍니다. 덕분에 코드와 검증 스키마가 일치하지 않아 발생하는 만성적인 동기화 오류를 근본적으로 예방할 수 있습니다.",{"_950":11479,"_2420":2570,"_2571":11480},"fd4bc0e5-b3ce-4648-901f-581dd5053c32",[],{"_950":11482,"_2420":2570,"_2571":11483},"38195a88-767c-4801-a2f6-8212cb5a2b58",[11484,11486,11489],{"_2579":11485,"_2420":2579},"가장 널리 쓰이는 ",{"_2579":11487,"_2420":2579,"_3365":11488},"fastify-type-provider-zod",{"_3351":3367},{"_2579":11490,"_2420":2579},"를 활용하면 초기 설정 이후 다음과 같이 라우트 핸들러에서 안전한 타입 추론을 바로 누릴 수 있습니다.",{"_950":11492,"_2420":2570,"_2571":11493},"72d37d35-11ff-4d95-bbf2-0f721b6e775f",[],{"_950":11495,"_3351":11496,"_2420":3351,"_625":3125},"9bdf6931-f47c-4c62-9a0d-3c8187bf8cdf","import Fastify from 'fastify';\nimport { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\n\nconst server = Fastify().withTypeProvider();\nserver.setValidatorCompiler(validatorCompiler);\nserver.setSerializerCompiler(serializerCompiler);\n\nserver.post('/users', {\n schema: {\n body: z.object({\n name: z.string().min(2),\n email: z.string().email()\n })\n }\n}, async (req) => {\n const { name, email } = req.body; // 별도의 타입 단언 없이 자동 추론\n return { id: '1', name, email };\n});",{"_950":11498,"_2420":2570,"_2571":11499},"7c158f1f-13b9-4e6d-a049-be7c7548d3ef",[],{"_950":11501,"_2420":2570,"_2571":11502},"b87a6db6-ea91-415a-8d65-8abdb261f2fb",[11503],{"_2579":11504,"_2420":2579},"이렇게 정의된 스키마는 런타임 입력값 검증뿐만 아니라 OpenAPI 문서 규격으로도 연동되어 개발 생산성을 극대화합니다. 추가적인 빌드 컴파일 레이어를 우회하면서도 강력한 유효성 검증과 문서화 이점을 실시간으로 결합해 주는 고성능 설계의 핵심 축입니다.",{"_950":11506,"_2420":2570,"_2571":11507},"f41e776e-cc35-49c7-9d86-e6a601191b1b",[],{"_950":11509,"_2420":2575,"_2576":2007,"_2571":11510},"fd514ee3-810c-4f9a-ad7c-dbc55c7cca03",[11511],{"_2579":11512,"_2420":2579},"Fastify 5 마이그레이션 마찰과 주요 변경점",{"_950":11514,"_2420":2570,"_2571":11515},"a8d06284-bcd7-431f-beee-429ec9437584",[],{"_950":11517,"_2420":2570,"_2571":11518},"b59e3c9c-725f-4a54-bb4f-cac115f86f07",[11519,11521,11524],{"_2579":11520,"_2420":2579},"Fastify 5로 메이저 버전을 올릴 때 가장 먼저 체감되는 파괴적 변경 사항은 스키마 정의 규격의 엄격화입니다. 이전 버전까지 편의를 위해 제공되던 ",{"_2579":11522,"_2420":2579,"_3365":11523},"jsonShorthand",{"_3351":3367},{"_2579":11525,"_2420":2579}," 옵션이 완전히 제거되었습니다. 이제 쿼리스트링, 요청 본문, 응답 등의 검증 스키마를 작성할 때 최상위에 명시적인 객체 타입과 속성을 선언하는 정식 JSON 스키마 규격을 반드시 준수해야 합니다.",{"_950":11527,"_2420":2570,"_2571":11528},"d1e13307-758a-42b6-8292-0b3c8df47b7b",[],{"_950":11530,"_2420":2570,"_2571":11531},"27cd9bb5-c16d-4958-9753-cca2c3df1762",[11532],{"_2579":11533,"_2420":2579},"Fastify 공식 마이그레이션 가이드에 따른 스키마 작성 방식의 변화는 다음과 같습니다.",{"_950":11535,"_2420":2570,"_2571":11536},"879bbe50-f22f-43c5-82c2-fd4f51caaf37",[],{"_950":11538,"_3351":11539,"_2420":3351,"_625":7690},"c2de9aa2-30d8-4c28-a408-7eff2eea2305","// Fastify 4 (이전): 암묵적인 객체 래핑 허용\nfastify.post('/user', {\n schema: {\n body: {\n name: { type: 'string' }\n }\n }\n}, handler);\n\n// Fastify 5 (이후): 명시적인 JSON 스키마 구조 필수\nfastify.post('/user', {\n schema: {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n }\n}, handler);",{"_950":11541,"_2420":2570,"_2571":11542},"0ef8d8be-68d0-4c9a-82d7-4f7e73df3220",[],{"_950":11544,"_2420":2570,"_2571":11545},"44982673-9ced-4a0f-9fe8-64f9baf6534c",[11546,11548,11551,11553,11556,11558,11561],{"_2579":11547,"_2420":2579},"네트워크 및 환경 정보를 다루는 API에도 표준을 준수하기 위한 변화가 생겼습니다. 기존에는 ",{"_2579":11549,"_2420":2579,"_3365":11550},"req.hostname",{"_3351":3367},{"_2579":11552,"_2420":2579}," 조회 시 포트 번호가 함께 포함되어 반환되었으나, Fastify 5부터는 Node.js 표준 URL 객체 규격에 맞춰 포트를 제외한 도메인명만 반환합니다. 기존의 호스트 및 포트 조합 정보가 필요하다면 ",{"_2579":11554,"_2420":2579,"_3365":11555},"req.host",{"_3351":3367},{"_2579":11557,"_2420":2579},"나 ",{"_2579":11559,"_2420":2579,"_3365":11560},"req.port",{"_3351":3367},{"_2579":11562,"_2420":2579},"를 명시적으로 조합해 사용해야 합니다.",{"_950":11564,"_2420":2570,"_2571":11565},"84e46046-294f-44b1-bb2b-cd5e40f83777",[],{"_950":11567,"_2420":2570,"_2571":11568},"c677c4a4-2a67-4a46-afc1-2cf2126b240d",[11569],{"_2579":11570,"_2420":2579},"또한 기본 유효성 검증 엔진인 Ajv의 시간 포맷 검증 규칙도 한층 더 엄격해졌습니다. 기존 'time'과 'date-time' 포맷은 반드시 표준 시간대 정보를 포함해야 검증을 통과하므로, 시간대 정보가 유동적인 환경이라면 'iso-time' 또는 'iso-date-time' 포맷으로 설정을 전환하는 마이그레이션 작업이 요구됩니다.",{"_950":11572,"_2420":2570,"_2571":11573},"eb09edcb-210e-4bd3-9a3d-97a08cb6fdc2",[],{"_950":11575,"_2420":2575,"_2576":2007,"_2571":11576},"309220c7-a15d-41bf-8531-f1aa2cbf805b",[11577],{"_2579":11578,"_2420":2579},"Node.js vs Edge 런타임: Fastify의 명확한 한계와 타겟 시장",{"_950":11580,"_2420":2570,"_2571":11581},"f70d2641-0109-4c7f-8b6e-13b615fbb14a",[],{"_950":11583,"_2420":2570,"_2571":11584},"eebcb9c3-016a-4bed-827b-f740f9909188",[11585],{"_2579":11586,"_2420":2579},"Hono 같은 현대적인 프레임워크가 경량 엣지와 서버리스 환경을 장악하는 사이, Fastify는 오직 Node.js 런타임에 모든 역량을 집중했습니다. 이는 단순한 취향의 차이가 아니라, Fastify가 초고속 성능을 내기 위해 채택한 핵심 아키텍처가 엣지 환경의 제약 조건과 근본적으로 충돌하기 때문입니다.",{"_950":11588,"_2420":2570,"_2571":11589},"c761f070-c3e9-4b32-8936-e4e5148b35f2",[],{"_950":11591,"_2420":2570,"_2571":11592},"9922df92-d26e-4070-ac20-03b716c0639f",[11593,11595,11598],{"_2579":11594,"_2420":2579},"가장 큰 걸림돌은 성능 최적화의 핵심인 JIT 스키마 컴파일러 설계입니다. Fastify는 Ajv와 fast-json-stringify를 활용해 런타임에 eval 함수로 스키마를 동적 컴파일하여 직렬화 속도를 일반 JSON 대비 몇 배 이상 끌어올립니다. 하지만 Cloudflare Workers나 Vercel Edge 같은 V8 아이솔레이트 격리 환경에서는 보안을 위해 동적 코드 평가가 완전히 금지되어 있어 실행 시점에 ",{"_2579":11596,"_2420":2579,"_3365":11597},"EvalError",{"_3351":3367},{"_2579":11599,"_2420":2579},"를 뱉으며 구동 자체가 불가능합니다.",{"_950":11601,"_2420":2570,"_2571":11602},"215e1620-49a1-4673-b4d4-fefb9508e395",[],{"_950":11604,"_2420":2570,"_2571":11605},"a7295c7d-16fb-4a39-80c9-9ee5d4f125eb",[11606,11608,11610],{"_2579":11607,"_2420":2579},"또한 Fastify의 기본 로거인 Pino가 활용하는 멀티스레드 워커 아키텍처와 ",{"_2579":10584,"_2420":2579,"_3365":11609},{"_3351":3367},{"_2579":11611,"_2420":2579}," 표준 모듈에 대한 깊은 의존성 역시 컨텍스트가 극도로 제한된 서버리스 환경에서는 오동작을 유발하는 요인이 됩니다. APIScout 분석에 따르면, 이러한 기술적 특성 때문에 Fastify는 전 세계 네트워크에 분산 배포되는 엣지 컴퓨팅보다는 컨테이너 기반 마이크로서비스나 독립 가상 서버에서 영속적으로 대규모 트래픽을 처리하는 전통적인 백엔드 아키텍처에 가장 적합합니다.",{"_950":11613,"_2420":2570,"_2571":11614},"bbfbcf74-3253-4335-b5c8-efa6144fe53e",[],{"_950":11616,"_2420":2570,"_2571":11617},"1b51c62e-47da-484a-b2ae-e1f95ca2fbc3",[11618],{"_2579":11619,"_2420":2579},"결국 Fastify는 모든 인프라 플랫폼을 어설프게 지원하느라 개성을 잃는 대신, Node.js 백엔드 인프라가 제공하는 자원을 극한까지 활용하는 정공법을 선택하여 독보적인 고성능 세그먼트를 구축하는 데 성공했습니다.",{"_950":11621,"_2420":2570,"_2571":11622},"885f5911-9c71-449b-aecd-dac88df2bce1",[],{"_950":11624,"_2420":2575,"_2576":2007,"_2571":11625},"b0ef3651-94da-42e9-95cf-b6c41d3dd276",[11626],{"_2579":11627,"_2420":2579},"인프라 목적에 맞는 현실적인 프레임워크 선택",{"_950":11629,"_2420":2570,"_2571":11630},"9de037b0-91c0-4c14-b463-76e61db35cf7",[],{"_950":11632,"_2420":2570,"_2571":11633},"783a5e8c-8f4d-43bc-9e30-4ca95d2fbd0b",[11634],{"_2579":11635,"_2420":2579},"Fastify 5는 엣지 컴퓨팅 트렌드에 휩쓸리지 않고 Node.js 환경의 고성능 서버 구축이라는 핵심 가치에 집중한 프레임워크입니다. 전 세계 네트워크의 엣지 노드나 가벼운 서버리스 환경을 지향한다면 Hono와 같은 경량 프레임워크가 최적의 선택이 될 수 있지만, 컨테이너 클러스터나 가상 서버 환경에서 영속적인 백엔드 서비스를 안정적으로 운영해야 할 때는 판단 기준이 달라집니다. 이처럼 대규모 트래픽 처리가 중요한 영속 서버 환경에서는 강력한 타입 안정성과 압도적인 처리량을 모두 보장하는 Fastify 5와 Type Provider의 결합이 개발 생산성과 인프라 효율 측면에서 가장 매력적인 정답이 될 것입니다.",{"_950":11637,"_2420":2570,"_2571":11638},"2da05cb3-44ae-48ae-a2b9-b61bacd5cec6",[],{"_950":11640,"_2420":3473},"a4aee823-2563-4bf4-8d3f-7658db27a474",{"_950":11642,"_2420":2570,"_2571":11643},"e8676215-0474-4147-842e-abb5227369da",[],{"_950":11645,"_2420":2570,"_2571":11646},"648f985a-896d-4a3c-8693-9d13a2f1034d",[11647],{"_2579":3483,"_2420":2579,"_3365":11648},{"_3485":3367},{"_950":11650,"_2420":2570,"_2571":11651},"45c9da06-8326-4fe1-afd2-7dfe0840b93a",[],{"_950":11653,"_1881":3492,"_2420":3493,"_778":11654},"a808a44b-c61b-4d2d-8811-00a0e2232229",[11655,11663,11671],{"_950":11656,"_2571":11657},"f3c37d3d-4280-473b-91a4-4a5324b4936b",[11658],{"_3499":11659,"_2420":3501,"_3502":11660},"https://fastify.dev/docs/latest/Reference/Lifecycle/",[11661],{"_2579":11662,"_2420":2579},"Developer Analysis & Official Docs — Architectural Foundation: Radix Routing, Plugin Encapsulation, and Diagnostics",{"_950":11664,"_2571":11665},"4fcf7a96-0497-4294-a8a4-a93602921373",[11666],{"_3499":11667,"_2420":3501,"_3502":11668},"https://apiscout.com/blog/hono-vs-fastify-vs-express-2026",[11669],{"_2579":11670,"_2420":2579},"APIScout Technical Analysis — Framework Comparison 2026: Fastify vs Hono vs Express 5",{"_950":11672,"_2571":11673},"05c1ca31-2897-44ab-b8b6-15c35959a74e",[11674],{"_3499":11675,"_2420":3501,"_3502":11676},"https://fastify.dev/docs/latest/Reference/Type-Providers/",[11677],{"_2579":11678,"_2420":2579},"Fastify TypeScript Documentation — TypeScript End-to-End Type Safety and Type Providers",{"_11616":11680,"_11530":11684,"_11453":11688,"_11575":11693,"_11482":11697,"_11544":11702,"_11645":11707,"_11413":11709,"_11632":11713,"_11466":11717,"_11591":11721,"_11474":11726,"_11437":11730,"_11604":11734,"_11653":11739,"_11624":11746,"_11517":11750,"_11501":11755,"_11567":11759,"_11406":11763,"_11421":11765,"_11429":11769,"_11445":11773,"_11583":11777,"_11509":11781},{"_2571":11681},{"_1892":11682,"_1893":11683,"_1802":11619},"Ultimately, instead of losing its identity by half-heartedly supporting every infrastructure platform, Fastify has chosen to stick to its principles—utilizing Node.js backend resources to the absolute limit—thereby successfully establishing a unique, high-performance segment.","結局、Fastifyはあらゆるインフラプラットフォームを中途半端にサポートして個性を失うのではなく、Node.jsバックエンドインフラが提供するリソースを極限まで活用する正攻法を選択し、独自で高性能なセグメントを構築することに成功しました。",{"_2571":11685},{"_1892":11686,"_1893":11687,"_1802":11533},"The changes in schema writing methods based on the official Fastify migration guide are as follows.","Fastify公式のマイグレーションガイドに基づく、スキーマ作成方式の変更点は以下の通りです。",{"_2571":11689},{"_1892":11690,"_1893":11691,"_1802":11692},"This is complemented by the fast-json-stringify engine, which pre-builds serialization code based on JSON schema specifications. By skipping the chronic runtime overhead of standard JSON.stringify calls, it bypasses performance bottlenecks and pushes hardware resources to their limit.","さらに、JSONスキーマ仕様に基づいてシリアライズコードを事前ビルドする「fast-json-stringify」エンジンが加わります。標準のJSON.stringify呼び出し方式における宿命的なランタイム・オーバーヘッドを排除し、パフォーマンスのボトルネックを完全に回避することで、ハードウェアリソースを極限まで引き出します。","여기에 JSON 스키마 명세를 기반으로 직렬화 코드를 사전 빌드하는 fast-json-stringify 엔진이 더해집니다. 표준 JSON.stringify 호출 방식의 고질적인 런타임 오버헤드를 생략하고 성능 병목을 완전히 우회하여 하드웨어 자원을 극한까지 이끌어냅니다.",{"_2571":11694},{"_1892":11695,"_1893":11696,"_1802":11578},"Node.js vs Edge Runtime: Fastify’s Clear Limitations and Target Market","Node.js vs Edgeランタイム: Fastifyの明確な限界とターゲット市場",{"_2571":11698},{"_1892":11699,"_1893":11700,"_1802":11701},"By leveraging the widely used fastify-type-provider-zod, you can enjoy safe type inference directly in your route handlers right after initial setup.","最も広く使われている「fastify-type-provider-zod」を活用すれば、初期設定後、次のようにルートハンドラーで安全な型推論をすぐに享受できます。","가장 널리 쓰이는 fastify-type-provider-zod를 활용하면 초기 설정 이후 다음과 같이 라우트 핸들러에서 안전한 타입 추론을 바로 누릴 수 있습니다.",{"_2571":11703},{"_1892":11704,"_1893":11705,"_1802":11706},"Changes have also been made to APIs handling network and environment information to ensure compliance with standards. Previously, retrieving req.hostname would include the port number, but starting with Fastify 5, it returns only the domain name, excluding the port, in accordance with the standard Node.js URL object specification. If you need the host and port combination, you must explicitly combine req.host and req.port.","ネットワークや環境情報を扱うAPIにも、標準を遵守するための変更がありました。以前はreq.hostnameの照会時にポート番号が含まれて返されていましたが、Fastify 5からはNode.js標準のURLオブジェクト仕様に合わせて、ポートを除いたドメイン名のみが返されます。従来のホストとポートの組み合わせ情報が必要な場合は、req.hostやreq.portを明示的に組み合わせて使用する必要があります。","네트워크 및 환경 정보를 다루는 API에도 표준을 준수하기 위한 변화가 생겼습니다. 기존에는 req.hostname 조회 시 포트 번호가 함께 포함되어 반환되었으나, Fastify 5부터는 Node.js 표준 URL 객체 규격에 맞춰 포트를 제외한 도메인명만 반환합니다. 기존의 호스트 및 포트 조합 정보가 필요하다면 req.host나 req.port를 명시적으로 조합해 사용해야 합니다.",{"_2571":11708},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":11710},{"_1892":11711,"_1893":11712,"_1802":11416},"Unlike the recent framework trend towards Edge or serverless runtimes, Fastify 5 has chosen a direct approach, focusing on its core value: high-performance Node.js backends. By strictly limiting support to Node.js 20 and above, it has boldly shed legacy deprecated APIs and architectural debt.","Fastify 5は、エッジやサーバーレスランタイムへと向かう昨今のフレームワークのトレンドとは異なり、Node.jsバックエンドの高性能化という本来の価値に集中する正攻法を選択しました。サポートエンジンをNode.js 20バージョン以上に明確に制限することで、古い減価償却APIやアーキテクチャの負債を大胆に削減しました。",{"_2571":11714},{"_1892":11715,"_1893":11716,"_1802":11635},"Fastify 5 is a framework that hasn't been swept up by the edge computing trend, choosing instead to focus on the core value of building high-performance servers in Node.js environments. While lightweight frameworks like Hono might be the optimal choice for edge nodes or serverless environments, the criteria change when you need to reliably operate persistent backend services in container clusters or virtual server environments. In such performance-critical environments, the combination of Fastify 5's powerful type safety and overwhelming throughput is the most attractive solution for both development productivity and infrastructure efficiency.","Fastify 5はエッジコンピューティングのトレンドに流されることなく、Node.js環境での高性能サーバー構築という核心的な価値に集中したフレームワークです。世界中に広がるネットワークのエッジノードや軽量なサーバーレス環境を目指すならHonoのような軽量フレームワークが最適な選択肢となりますが、コンテナクラスターや仮想サーバー環境で永続的なバックエンドサービスを安定して運用する必要がある場合、判断基準は異なります。このように大規模トラフィック処理が重要な永続サーバー環境では、強力な型安全性と圧倒的なスループットを共に保証するFastify 5とType Providerの組み合わせが、開発生産性とインフラ効率の観点から最も魅力的な答えとなるでしょう。",{"_2571":11718},{"_1892":11719,"_1893":11720,"_1802":11469},"Type Provider: Real-time Schema Type Inference Without Build Steps","Type Provider: ビルドステップ不要のリアルタイム・スキーマ型推論",{"_2571":11722},{"_1892":11723,"_1893":11724,"_1802":11725},"The biggest hurdle is the JIT schema compiler design, which is essential for performance optimization. Fastify uses Ajv and fast-json-stringify to dynamically compile schemas at runtime using the eval function, boosting serialization speeds significantly over standard JSON. However, in V8 isolate-based environments like Cloudflare Workers or Vercel Edge, dynamic code evaluation is strictly forbidden for security reasons, resulting in EvalError during execution, making it impossible to run.","最大の障害は、パフォーマンス最適化の核である「JITスキーマコンパイラ」の設計です。FastifyはAjvとfast-json-stringifyを活用し、ランタイムにeval関数でスキーマを動的コンパイルすることで、シリアライズ速度を通常のJSONと比べて数倍以上に引き上げます。しかし、Cloudflare WorkersやVercel EdgeのようなV8アイソレート環境では、セキュリティ上の理由から動的なコード評価が完全に禁止されているため、実行時にEvalErrorを吐き出し、動作自体が不可能です。","가장 큰 걸림돌은 성능 최적화의 핵심인 JIT 스키마 컴파일러 설계입니다. Fastify는 Ajv와 fast-json-stringify를 활용해 런타임에 eval 함수로 스키마를 동적 컴파일하여 직렬화 속도를 일반 JSON 대비 몇 배 이상 끌어올립니다. 하지만 Cloudflare Workers나 Vercel Edge 같은 V8 아이솔레이트 격리 환경에서는 보안을 위해 동적 코드 평가가 완전히 금지되어 있어 실행 시점에 EvalError를 뱉으며 구동 자체가 불가능합니다.",{"_2571":11727},{"_1892":11728,"_1893":11729,"_1802":11477},"Fastify supports the Type Provider pattern, which maps JSON schemas directly to TypeScript types without extra build steps or schema code generation. When you use schema libraries like Zod or TypeBox to declare runtime validation rules, the compiler understands them and provides perfect static type inference at development time. This fundamentally prevents the chronic synchronization errors that occur when code and validation schemas drift apart.","Fastifyは、別途のビルドステップやスキーマコードの生成なしに、JSONスキーマをTypeScript型へ直接マッピングする「Type Provider」パターンをサポートしています。ZodやTypeBoxのようなスキーマライブラリを使用してランタイムのバリデーションルールを宣言すれば、コンパイラがこれを理解し、開発時点で完璧な静的型としてリアルタイムに推論してくれます。おかげで、コードと検証スキーマが一致せずに発生する慢性的な同期エラーを根本から予防できます。",{"_2571":11731},{"_1892":11732,"_1893":11733,"_1802":11440},"The primary engine behind Fastify's ability to handle up to 3x higher throughput than conventional Node.js frameworks lies in its dedicated router and unique plugin architecture. The built-in routing library, find-my-way, uses a radix-tree algorithm to ensure extremely fast route lookups that converge to a constant time regardless of the number of registered routes.","Fastifyが既存のNode.jsフレームワークと比較して最大3倍高いスループットを誇る核心的な原動力は、専用ルーターと独自のプラグインアーキテクチャにあります。内蔵のルーティングライブラリ「find-my-way」は、ラディックスツリーアルゴリズムを活用しており、登録されたパスがどれだけ増えても、定数に収束する極めて高速なパス検索性能を保証します。",{"_2571":11735},{"_1892":11736,"_1893":11737,"_1802":11738},"Furthermore, the multi-threaded worker architecture utilized by Pino (Fastify's default logger) and its deep reliance on the node:http standard module also trigger malfunctions in highly constrained serverless environments. According to APIScout analysis, due to these technical characteristics, Fastify is best suited for traditional backend architectures where large-scale traffic is consistently handled in container-based microservices or dedicated virtual servers, rather than edge computing distributed across global networks.","また、FastifyのデフォルトロガーであるPinoが活用するマルチスレッドワーカー・アーキテクチャと、node:http標準モジュールへの深い依存性も、コンテキストが極めて制限されたサーバーレス環境では誤動作を引き起こす要因となります。APIScoutの分析によると、こうした技術的特性のため、Fastifyは世界中のネットワークに分散デプロイされるエッジコンピューティングよりも、コンテナベースのマイクロサービスや独立した仮想サーバーで永続的に大規模トラフィックを処理する、従来のバックエンドアーキテクチャに最も適しています。","또한 Fastify의 기본 로거인 Pino가 활용하는 멀티스레드 워커 아키텍처와 node:http 표준 모듈에 대한 깊은 의존성 역시 컨텍스트가 극도로 제한된 서버리스 환경에서는 오동작을 유발하는 요인이 됩니다. APIScout 분석에 따르면, 이러한 기술적 특성 때문에 Fastify는 전 세계 네트워크에 분산 배포되는 엣지 컴퓨팅보다는 컨테이너 기반 마이크로서비스나 독립 가상 서버에서 영속적으로 대규모 트래픽을 처리하는 전통적인 백엔드 아키텍처에 가장 적합합니다.",{"_11740":11741,"_11742":11743,"_11744":11745},"item:05c1ca31-2897-44ab-b8b6-15c35959a74e",{"_1892":11678,"_1893":11678,"_1802":11678},"item:4fcf7a96-0497-4294-a8a4-a93602921373",{"_1892":11670,"_1893":11670,"_1802":11670},"item:f3c37d3d-4280-473b-91a4-4a5324b4936b",{"_1892":11662,"_1893":11662,"_1802":11662},{"_2571":11747},{"_1892":11748,"_1893":11749,"_1802":11627},"Choosing a Realistic Framework for Your Infrastructure Goals","インフラ目的に適した現実的なフレームワーク選定",{"_2571":11751},{"_1892":11752,"_1893":11753,"_1802":11754},"The most immediately noticeable breaking change when upgrading to Fastify 5 is the stricter schema definition specification. The jsonShorthand option, provided for convenience in previous versions, has been completely removed. You must now strictly adhere to the official JSON schema specification, declaring explicit object types and properties at the top level when writing validation schemas for query strings, request bodies, and responses.","Fastify 5へメジャーバージョンを上げる際、最も先に実感する破壊的変更は、スキーマ定義仕様の厳格化です。以前のバージョンまで利便性のために提供されていた「jsonShorthand」オプションが完全に削除されました。今後は、クエリ文字列、リクエストボディ、レスポンスなどの検証スキーマを作成する際、最上位に明示的なオブジェクトタイプと属性を宣言する正式なJSONスキーマ仕様を必ず遵守する必要があります。","Fastify 5로 메이저 버전을 올릴 때 가장 먼저 체감되는 파괴적 변경 사항은 스키마 정의 규격의 엄격화입니다. 이전 버전까지 편의를 위해 제공되던 jsonShorthand 옵션이 완전히 제거되었습니다. 이제 쿼리스트링, 요청 본문, 응답 등의 검증 스키마를 작성할 때 최상위에 명시적인 객체 타입과 속성을 선언하는 정식 JSON 스키마 규격을 반드시 준수해야 합니다.",{"_2571":11756},{"_1892":11757,"_1893":11758,"_1802":11504},"Schemas defined in this way not only handle runtime input validation but also integrate with OpenAPI specifications to maximize development productivity. It is a core pillar of high-performance design that combines powerful validation and documentation in real-time, all while bypassing additional build/compilation layers.","このように定義されたスキーマは、ランタイムの入力値検証だけでなく、OpenAPIドキュメント仕様とも連動し、開発生産性を極限まで高めます。追加のビルド・コンパイルレイヤーを回避しながらも、強力な検証とドキュメント化のメリットをリアルタイムで統合できる、高性能設計の核心的な柱です。",{"_2571":11760},{"_1892":11761,"_1893":11762,"_1802":11570},"Additionally, the time format validation rules for the default validation engine, Ajv, have become stricter. Existing 'time' and 'date-time' formats now require standard timezone information to pass validation. For environments where timezone information is dynamic, migration to 'iso-time' or 'iso-date-time' formats is required.","また、標準の検証エンジンであるAjvの時間フォーマット検証ルールもさらに厳格になりました。既存の「time」および「date-time」フォーマットは、必ず標準時間帯情報を含めないと検証を通過しなくなりました。時間帯情報が流動的な環境であれば、「iso-time」または「iso-date-time」フォーマットへ設定を切り替えるマイグレーション作業が必要です。",{"_2571":11764},{"_1892":11330,"_1893":11331,"_1802":11332},{"_2571":11766},{"_1892":11767,"_1893":11768,"_1802":11424},"Instead of chasing serverless lightness, it has taken a smart route that maximizes its powerful plugin isolation architecture and schema-based compilation performance. We explore why Fastify 5 remains the top choice for container environments handling high traffic, along with its underlying core structure and design philosophy.","サーバーレスの軽量さの代わりに、強力なプラグイン分離アーキテクチャとスキーマベースのコンパイル性能を最大化する賢い路線を選択した結果です。大規模なトラフィックを処理するコンテナ環境においてFastify 5が依然として最高の選択である理由と、それを貫く核心的な構造および設計哲学を解説します。",{"_2571":11770},{"_1892":11771,"_1893":11772,"_1802":11432},"The Secret to High Performance: Radix-Tree Router and Avvio Plugin Graph","高性能の秘密: radix-treeルーターとAvvioプラグイングラフ",{"_2571":11774},{"_1892":11775,"_1893":11776,"_1802":11448},"Another key design element is the Avvio library, which manages asynchronous plugin initialization. Fastify controls plugin relationships and loading order using a Directed Acyclic Graph (DAG) to support perfect scope encapsulation. Since decorators or lifecycle hooks declared within a specific scope do not leak into parent or sibling scopes and are safely isolated within the subtree, it enables the design of side-effect-free microservices.","もう一つの設計上の鍵は、非同期プラグインの実行を制御する「Avvio」ライブラリです。Fastifyは、非巡回有向グラフの形式でプラグインの関係と読み込み順序を制御し、完璧なスコープのカプセル化をサポートします。特定のスコープ内で宣言されたデコレーターやライフサイクル・フックが、上位や兄弟のスコープに漏れ出すことなく、サブツリー内部のみに安全に隔離されるため、副作用のないマイクロサービス設計が可能になります。",{"_2571":11778},{"_1892":11779,"_1893":11780,"_1802":11586},"While modern frameworks like Hono dominate lightweight edge and serverless environments, Fastify has concentrated all its efforts solely on the Node.js runtime. This is not merely a matter of preference but stems from the fact that the core architecture Fastify adopted for ultra-high performance fundamentally conflicts with the constraints of edge environments.","Honoのようなモダンなフレームワークが軽量エッジやサーバーレス環境を掌握する傍ら、FastifyはNode.jsランタイムのみに全力を注ぎました。これは単なる好みの違いではなく、Fastifyが超高速なパフォーマンスを出すために採用した核心的なアーキテクチャが、エッジ環境の制約条件と根本的に衝突するためです。",{"_2571":11782},{"_1892":11783,"_1893":11784,"_1802":11512},"Fastify 5 Migration Friction and Key Changes","Fastify 5のマイグレーションにおける摩擦と主な変更点","![Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까](file:cms000gau001810pd7gbb9xki)\n\n# Fastify 5 아키텍처 — 왜 Edge가 아닌 Node.js에 집중했을까\n\nFastify 5는 엣지나 서버리스 런타임으로 향하는 최근의 프레임워크 트렌드와 달리, Node.js 백엔드 고성능화라는 본연의 가치에 집중하는 정공법을 선택했습니다. 지원 엔진을 Node.js 20 버전 이상으로 명확히 제한하면서 오래된 감가상각 API와 아키텍처 부채를 과감하게 덜어냈습니다.\n\n서버리스의 가벼움 대신 강력한 플러그인 격리 아키텍처와 스키마 기반 컴파일 성능을 극대화하는 영리한 노선을 택한 결과입니다. 대규모 트래픽을 처리하는 컨테이너 환경에서 Fastify 5가 여전히 최고의 선택인 이유와, 이를 관통하는 핵심 구조 및 설계 철학을 톺아봅니다.\n\n## 고성능의 비밀: radix-tree 라우터와 Avvio 플러그인 그래프\n\nFastify가 기존 Node.js 프레임워크 대비 최대 3배 높은 처리량을 보여주는 핵심 동력은 전용 라우터와 독보적인 플러그인 아키텍처에 있습니다. 내장 라우팅 라이브러리인 find-my-way는 라딕스 트리 알고리즘을 활용해 등록된 경로가 아무리 많아져도 상수에 수렴하는 극도로 빠른 경로 검색 성능을 보장합니다.\n\n또 다른 설계적 핵심은 비동기 플러그인 구동을 제어하는 아비오(Avvio) 라이브러리입니다. Fastify는 비순환 지향 그래프 형태로 플러그인의 관계와 로딩 순서를 제어하여 완벽한 스코프 캡슐화를 지원합니다. 특정 스코프 안에서 선언한 데코레이터나 생명주기 훅이 상위나 형제 스코프로 새어 나가지 않고 오직 하위 트리 내부로만 안전하게 격리되므로 부수 효과 없는 마이크로서비스 설계가 가능해집니다.\n\n여기에 JSON 스키마 명세를 기반으로 직렬화 코드를 사전 빌드하는 fast-json-stringify 엔진이 더해집니다. 표준 `JSON.stringify` 호출 방식의 고질적인 런타임 오버헤드를 생략하고 성능 병목을 완전히 우회하여 하드웨어 자원을 극한까지 이끌어냅니다.\n\n## Type Provider: 빌드 단계 없는 실시간 스키마 타입 추론\n\nFastify는 별도의 빌드 단계나 스키마 코드 생성 없이 JSON 스키마를 TypeScript 타입으로 직접 매핑하는 Type Provider 패턴을 지원합니다. Zod나 TypeBox 같은 스키마 라이브러리를 사용해 런타임 유효성 검증 규칙을 선언하면, 컴파일러가 이를 이해하여 개발 시점에 완벽한 정적 타입으로 실시간 추론해 줍니다. 덕분에 코드와 검증 스키마가 일치하지 않아 발생하는 만성적인 동기화 오류를 근본적으로 예방할 수 있습니다.\n\n가장 널리 쓰이는 `fastify-type-provider-zod`를 활용하면 초기 설정 이후 다음과 같이 라우트 핸들러에서 안전한 타입 추론을 바로 누릴 수 있습니다.\n\n```typescript\nimport Fastify from 'fastify';\nimport { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\n\nconst server = Fastify().withTypeProvider();\nserver.setValidatorCompiler(validatorCompiler);\nserver.setSerializerCompiler(serializerCompiler);\n\nserver.post('/users', {\n schema: {\n body: z.object({\n name: z.string().min(2),\n email: z.string().email()\n })\n }\n}, async (req) => {\n const { name, email } = req.body; // 별도의 타입 단언 없이 자동 추론\n return { id: '1', name, email };\n});\n```\n\n이렇게 정의된 스키마는 런타임 입력값 검증뿐만 아니라 OpenAPI 문서 규격으로도 연동되어 개발 생산성을 극대화합니다. 추가적인 빌드 컴파일 레이어를 우회하면서도 강력한 유효성 검증과 문서화 이점을 실시간으로 결합해 주는 고성능 설계의 핵심 축입니다.\n\n## Fastify 5 마이그레이션 마찰과 주요 변경점\n\nFastify 5로 메이저 버전을 올릴 때 가장 먼저 체감되는 파괴적 변경 사항은 스키마 정의 규격의 엄격화입니다. 이전 버전까지 편의를 위해 제공되던 `jsonShorthand` 옵션이 완전히 제거되었습니다. 이제 쿼리스트링, 요청 본문, 응답 등의 검증 스키마를 작성할 때 최상위에 명시적인 객체 타입과 속성을 선언하는 정식 JSON 스키마 규격을 반드시 준수해야 합니다.\n\nFastify 공식 마이그레이션 가이드에 따른 스키마 작성 방식의 변화는 다음과 같습니다.\n\n```javascript\n// Fastify 4 (이전): 암묵적인 객체 래핑 허용\nfastify.post('/user', {\n schema: {\n body: {\n name: { type: 'string' }\n }\n }\n}, handler);\n\n// Fastify 5 (이후): 명시적인 JSON 스키마 구조 필수\nfastify.post('/user', {\n schema: {\n body: {\n type: 'object',\n properties: {\n name: { type: 'string' }\n },\n required: ['name']\n }\n }\n}, handler);\n```\n\n네트워크 및 환경 정보를 다루는 API에도 표준을 준수하기 위한 변화가 생겼습니다. 기존에는 `req.hostname` 조회 시 포트 번호가 함께 포함되어 반환되었으나, Fastify 5부터는 Node.js 표준 URL 객체 규격에 맞춰 포트를 제외한 도메인명만 반환합니다. 기존의 호스트 및 포트 조합 정보가 필요하다면 `req.host`나 `req.port`를 명시적으로 조합해 사용해야 합니다.\n\n또한 기본 유효성 검증 엔진인 Ajv의 시간 포맷 검증 규칙도 한층 더 엄격해졌습니다. 기존 'time'과 'date-time' 포맷은 반드시 표준 시간대 정보를 포함해야 검증을 통과하므로, 시간대 정보가 유동적인 환경이라면 'iso-time' 또는 'iso-date-time' 포맷으로 설정을 전환하는 마이그레이션 작업이 요구됩니다.\n\n## Node.js vs Edge 런타임: Fastify의 명확한 한계와 타겟 시장\n\nHono 같은 현대적인 프레임워크가 경량 엣지와 서버리스 환경을 장악하는 사이, Fastify는 오직 Node.js 런타임에 모든 역량을 집중했습니다. 이는 단순한 취향의 차이가 아니라, Fastify가 초고속 성능을 내기 위해 채택한 핵심 아키텍처가 엣지 환경의 제약 조건과 근본적으로 충돌하기 때문입니다.\n\n가장 큰 걸림돌은 성능 최적화의 핵심인 JIT 스키마 컴파일러 설계입니다. Fastify는 Ajv와 fast-json-stringify를 활용해 런타임에 eval 함수로 스키마를 동적 컴파일하여 직렬화 속도를 일반 JSON 대비 몇 배 이상 끌어올립니다. 하지만 Cloudflare Workers나 Vercel Edge 같은 V8 아이솔레이트 격리 환경에서는 보안을 위해 동적 코드 평가가 완전히 금지되어 있어 실행 시점에 `EvalError`를 뱉으며 구동 자체가 불가능합니다.\n\n또한 Fastify의 기본 로거인 Pino가 활용하는 멀티스레드 워커 아키텍처와 `node:http` 표준 모듈에 대한 깊은 의존성 역시 컨텍스트가 극도로 제한된 서버리스 환경에서는 오동작을 유발하는 요인이 됩니다. APIScout 분석에 따르면, 이러한 기술적 특성 때문에 Fastify는 전 세계 네트워크에 분산 배포되는 엣지 컴퓨팅보다는 컨테이너 기반 마이크로서비스나 독립 가상 서버에서 영속적으로 대규모 트래픽을 처리하는 전통적인 백엔드 아키텍처에 가장 적합합니다.\n\n결국 Fastify는 모든 인프라 플랫폼을 어설프게 지원하느라 개성을 잃는 대신, Node.js 백엔드 인프라가 제공하는 자원을 극한까지 활용하는 정공법을 선택하여 독보적인 고성능 세그먼트를 구축하는 데 성공했습니다.\n\n## 인프라 목적에 맞는 현실적인 프레임워크 선택\n\nFastify 5는 엣지 컴퓨팅 트렌드에 휩쓸리지 않고 Node.js 환경의 고성능 서버 구축이라는 핵심 가치에 집중한 프레임워크입니다. 전 세계 네트워크의 엣지 노드나 가벼운 서버리스 환경을 지향한다면 Hono와 같은 경량 프레임워크가 최적의 선택이 될 수 있지만, 컨테이너 클러스터나 가상 서버 환경에서 영속적인 백엔드 서비스를 안정적으로 운영해야 할 때는 판단 기준이 달라집니다. 이처럼 대규모 트래픽 처리가 중요한 영속 서버 환경에서는 강력한 타입 안정성과 압도적인 처리량을 모두 보장하는 Fastify 5와 Type Provider의 결합이 개발 생산성과 인프라 효율 측면에서 가장 매력적인 정답이 될 것입니다.\n\n---\n\n**참고 링크**\n\n- [Developer Analysis & Official Docs — Architectural Foundation: Radix Routing, Plugin Encapsulation, and Diagnostics](https://fastify.dev/docs/latest/Reference/Lifecycle/)\n- [APIScout Technical Analysis — Framework Comparison 2026: Fastify vs Hono vs Express 5](https://apiscout.com/blog/hono-vs-fastify-vs-express-2026)\n- [Fastify TypeScript Documentation — TypeScript End-to-End Type Safety and Type Providers](https://fastify.dev/docs/latest/Reference/Type-Providers/)","45e8d761ce76e51bfe015e15fc93487db6e8697fe7a4c00e8360b3e38dafb9b1","2026-07-25T05:36:26.545Z","2026-07-25T21:21:14.579Z",[],[11791],{"_2802":2809,"_1881":4759},{"_950":11793,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":3649,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":11794,"_1889":11801,"_2455":-5,"_2456":-5,"_2457":-5,"_9":11805,"_2450":11813,"_2458":-5,"_2460":-5,"_723":11814,"_1886":11815,"_332":11819,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":11820,"_2003":11821,"_2480":11822,"_2482":-5,"_2483":11823,"_2485":-5,"_2486":-5,"_2487":11824,"_1144":11834,"_2527":-5,"_2555":-5,"_2556":11847,"_2798":11907,"_266":11908},"cmryidnb806tu10mumjtztbaq",{"_1801":1802,"_214":11795,"_2429":11796,"_2434":11798,"_2438":2439},560,{"_1892":11797,"_1893":1997,"_1802":4924,"_2433":1997},104,{"_1892":11799,"_1893":1997,"_1802":11800,"_2433":1997},0.18571428571428572,0.8142857142857143,{"_9":11802,"_2445":11806,"_2450":11810},{"_1892":11803,"_1893":11804,"_1802":11805},"FastAPI vs. Litestar — Choosing a Python Backend in 2026","FastAPI vs Litestar — 2026年、Pythonバックエンドの選択肢は？","FastAPI vs Litestar — 2026년 파이썬 백엔드 선택은?",{"_1892":11807,"_1893":11808,"_1802":11809},"If you're weighing your options for a Python backend framework, the current trends are quite interesting. Recently, FastAPI and Litestar have been demonstrating their appeal in completely different directions.\n\nFirst, FastAPI feels like it's going all-in on convenience. The recently added app.frontend() feature is genuinely useful; it serves SPA build directories like React or Vue directly without needing a separate reverse proxy configuration. Furthermore, v0.139.2 resolved the race conditions that used to occur in multi-threaded environments or parallel testing during router builds, making it significantly more stable. It’s hard to beat for toy projects or rapid MVP development. haha\n\nOn the other hand, if you need a large-scale service or a structured architecture, you should keep an eye on Litestar v2.24.0. By adopting msgspec instead of Pydantic as its core serialization engine, it offers overwhelmingly faster speeds, with throughput performance up to 2x higher. Its ecosystem—featuring a dependency injection system useful for writing test code and plugins that assist with SQLAlchemy session management—is very robust, making Litestar a powerful choice for designing monoliths for large projects.\n\nIf you want to bundle your frontend and deploy quickly, FastAPI is the logical choice; if you are on a large team where performance is critical and a structured architecture is required, Litestar is the way to go. I'm planning to try out the new FastAPI features for my personal side project soon lol","Pythonのバックエンドフレームワーク選びに迷っているなら、最近の動向はかなり興味深いです。FastAPIとLitestarが、それぞれ全く異なる方向性で魅力を発揮していますから。\n\nまずFastAPIは、利便性に全振りしている印象です。最近追加されたapp.frontend()機能が非常に有用で、リバースプロキシを別途設定することなく、ReactやVueのようなSPAビルドディレクトリを直接配信できます。さらに、最近のv0.139.2では、ルーター構築時にマルチスレッド環境や並列テストで発生していたレースコンディションも解決され、安定性が格段に向上しました。個人開発やMVPのスピード開発には、これ以上ないほど便利ですね（笑）。\n\n一方で、大規模サービスや構造化されたアーキテクチャが必要な場合は、Litestar v2.24.0に注目すべきです。Pydanticの代わりにmsgspecをコアのシリアライゼーションエンジンとして採用しており、速度が圧倒的に速く、全体的なスループットも最大で2倍近く出ます。テストコード作成時に便利な依存関係注入システムや、SQLAlchemyのセッション管理を助けるプラグインエコシステムも充実しており、大規模プロジェクトのモノリスを設計する際には間違いなく強力な選択肢になります。\n\nフロントエンドまで含めて手軽かつ迅速にデプロイしたいならFastAPI、パフォーマンスが非常に重要で体系的なアーキテクチャが必要な大規模チームならLitestarを選ぶのが合理的でしょう。私は近いうちに、個人のサイドプロジェクトでFastAPIの新機能を試してみようと思っています。","파이썬 백엔드 프레임워크 고민 중이시라면 요즘 흐름이 꽤 흥미롭습니다. 최근에 FastAPI와 Litestar가 각각 완전히 다른 방향으로 매력을 보여주고 있거든요.\n\n먼저 FastAPI는 편의성에 올인한 느낌입니다. 최근 추가된 app.frontend() 기능이 진짜 유용한데, 별도의 역방향 프록시 설정 없이 리액트나 뷰 같은 SPA 빌드 디렉터리를 바로 서빙해 줍니다. 게다가 최근 v0.139.2에서는 라우터 빌드 시 멀티스레드 환경이나 병렬 테스트에서 발생하던 레이스 컨디션까지 해결해서 안정성이 훨씬 단단해졌네요. 토이 프로젝트나 빠른 MVP 개발할 때 이보다 편할 순 없을 듯합니다 ㅎㅎ\n\n반면 대규모 서비스나 구조화된 아키텍처가 필요하다면 Litestar v2.24.0 버전을 눈여겨보셔야 합니다. Pydantic 대신 msgspec을 코어 직렬화 엔진으로 채택해서 속도가 압도적으로 빠르고, 전체적인 처리량도 최대 2배까지 잘 나옵니다. 테스트 코드 짤 때 유용한 의존성 주입 시스템이나 SQLAlchemy 세션 관리를 도와주는 플러그인 생태계도 탄탄해서, 확실히 대형 프로젝트용 모놀리스를 설계할 때는 Litestar가 아주 강력한 선택지네요.\n\n가볍게 프론트엔드까지 묶어서 빠르게 배포하고 싶다면 FastAPI를, 성능이 정말 중요하고 체계적인 아키텍처가 필요한 대형 팀이라면 Litestar를 고르는 게 합리적인 선택이겠네요. 저는 조만간 개인 사이드 프로젝트에 FastAPI 신기능을 한번 얹어볼 생각입니다 ㅎㅎㅎ",{"_1892":11811,"_1893":11812,"_1802":11813},"If you're weighing your options for a Python backend framework, the current trends are quite interesting. Recently, FastAPI and Litestar have been demonstrating their appeal in completely different directions. First, Fas…","Pythonのバックエンドフレームワーク選びに迷っているなら、最近の動向はかなり興味深いです。FastAPIとLitestarが、それぞれ全く異なる方向性で魅力を発揮していますから。まずFastAPIは、利便性に全振りしている印象です。最近追加されたapp.frontend()機能が非常に有用で、リバースプロキシを別途設定することなく、ReactやVueのようなSPAビルドディレクトリを直接配信できます。さらに、最近のv0.139.2…","파이썬 백엔드 프레임워크 고민 중이시라면 요즘 흐름이 꽤 흥미롭습니다. 최근에 FastAPI와 Litestar가 각각 완전히 다른 방향으로 매력을 보여주고 있거든요. 먼저 FastAPI는 편의성에 올인한 느낌입니다. 최근 추가된 app.frontend() 기능이 진짜 유용한데, 별도의 역방향 프록시 설정 없이 리액트나 뷰 같은 SPA 빌드 디렉터리를 바로 서빙해 줍니다. 게다가 최근 v0.1…",[7576],[11816,11817,11818,3128,3129],"python","fastapi","litestar",[],"2026-07-24T05:37:33.274Z","2026-07-24T05:37:32.996Z","2026-07-24T05:38:36.823Z","2026-07-24T05:38:36.815Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":11825},{"_1901":11826},{"_1903":11827,"_1908":1909,"_1910":11828,"_1921":11829,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":11830,"_1928":11831,"_1933":11832,"_1938":11833},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":11835,"_1883":1884,"_1200":1204,"_1899":11838},{"_633":11836,"_11":11837},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":11839},{"_1903":11840,"_1908":1909,"_1910":11841,"_1921":11842,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":11843,"_1928":11844,"_1933":11845,"_1938":11846},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_950":11848,"_2559":11793,"_2560":11849,"_2716":11885,"_2788":11903,"_2790":11904,"_2792":4912,"_2794":1997,"_2003":11905,"_2480":11906,"_2797":-5},"cmryidnbc06tv10mu6t83w5xi",{"_918":11850,"_1908":1909},[11851,11856,11859,11869,11872,11877,11880],{"_950":11852,"_2420":2570,"_2571":11853},"3871c9aa-2353-435e-9931-0db52bc8a2be",[11854],{"_2579":11855,"_2420":2579},"파이썬 백엔드 프레임워크 고민 중이시라면 요즘 흐름이 꽤 흥미롭습니다. 최근에 FastAPI와 Litestar가 각각 완전히 다른 방향으로 매력을 보여주고 있거든요.",{"_950":11857,"_2420":2570,"_2571":11858},"38e5a149-8a7d-4869-9834-c28162acb736",[],{"_950":11860,"_2420":2570,"_2571":11861},"ede759e4-4449-467a-8353-78caf7d98350",[11862,11864,11867],{"_2579":11863,"_2420":2579},"먼저 FastAPI는 편의성에 올인한 느낌입니다. 최근 추가된 ",{"_2579":11865,"_2420":2579,"_3365":11866},"app.frontend()",{"_3351":3367},{"_2579":11868,"_2420":2579}," 기능이 진짜 유용한데, 별도의 역방향 프록시 설정 없이 리액트나 뷰 같은 SPA 빌드 디렉터리를 바로 서빙해 줍니다. 게다가 최근 v0.139.2에서는 라우터 빌드 시 멀티스레드 환경이나 병렬 테스트에서 발생하던 레이스 컨디션까지 해결해서 안정성이 훨씬 단단해졌네요. 토이 프로젝트나 빠른 MVP 개발할 때 이보다 편할 순 없을 듯합니다 ㅎㅎ",{"_950":11870,"_2420":2570,"_2571":11871},"46d33c07-5a8c-4e57-9c0a-a51404081b91",[],{"_950":11873,"_2420":2570,"_2571":11874},"3fb13c3b-12b8-42e9-8f56-5268966a7fe5",[11875],{"_2579":11876,"_2420":2579},"반면 대규모 서비스나 구조화된 아키텍처가 필요하다면 Litestar v2.24.0 버전을 눈여겨보셔야 합니다. Pydantic 대신 msgspec을 코어 직렬화 엔진으로 채택해서 속도가 압도적으로 빠르고, 전체적인 처리량도 최대 2배까지 잘 나옵니다. 테스트 코드 짤 때 유용한 의존성 주입 시스템이나 SQLAlchemy 세션 관리를 도와주는 플러그인 생태계도 탄탄해서, 확실히 대형 프로젝트용 모놀리스를 설계할 때는 Litestar가 아주 강력한 선택지네요.",{"_950":11878,"_2420":2570,"_2571":11879},"e97cf11a-91a2-4221-afa9-0ac38d674db7",[],{"_950":11881,"_2420":2570,"_2571":11882},"9f270ed0-29db-471f-af39-5eb62a0ae9ee",[11883],{"_2579":11884,"_2420":2579},"가볍게 프론트엔드까지 묶어서 빠르게 배포하고 싶다면 FastAPI를, 성능이 정말 중요하고 체계적인 아키텍처가 필요한 대형 팀이라면 Litestar를 고르는 게 합리적인 선택이겠네요. 저는 조만간 개인 사이드 프로젝트에 FastAPI 신기능을 한번 얹어볼 생각입니다 ㅎㅎㅎ",{"_11852":11886,"_11873":11890,"_11881":11894,"_11860":11898},{"_2571":11887},{"_1892":11888,"_1893":11889,"_1802":11855},"If you're weighing your options for a Python backend framework, the current trends are quite interesting. Recently, FastAPI and Litestar have been demonstrating their appeal in completely different directions.","Pythonのバックエンドフレームワーク選びに迷っているなら、最近の動向はかなり興味深いです。FastAPIとLitestarが、それぞれ全く異なる方向性で魅力を発揮していますから。",{"_2571":11891},{"_1892":11892,"_1893":11893,"_1802":11876},"On the other hand, if you need a large-scale service or a structured architecture, you should keep an eye on Litestar v2.24.0. By adopting msgspec instead of Pydantic as its core serialization engine, it offers overwhelmingly faster speeds, with throughput performance up to 2x higher. Its ecosystem—featuring a dependency injection system useful for writing test code and plugins that assist with SQLAlchemy session management—is very robust, making Litestar a powerful choice for designing monoliths for large projects.","一方で、大規模サービスや構造化されたアーキテクチャが必要な場合は、Litestar v2.24.0に注目すべきです。Pydanticの代わりにmsgspecをコアのシリアライゼーションエンジンとして採用しており、速度が圧倒的に速く、全体的なスループットも最大で2倍近く出ます。テストコード作成時に便利な依存関係注入システムや、SQLAlchemyのセッション管理を助けるプラグインエコシステムも充実しており、大規模プロジェクトのモノリスを設計する際には間違いなく強力な選択肢になります。",{"_2571":11895},{"_1892":11896,"_1893":11897,"_1802":11884},"If you want to bundle your frontend and deploy quickly, FastAPI is the logical choice; if you are on a large team where performance is critical and a structured architecture is required, Litestar is the way to go. I'm planning to try out the new FastAPI features for my personal side project soon lol","フロントエンドまで含めて手軽かつ迅速にデプロイしたいならFastAPI、パフォーマンスが非常に重要で体系的なアーキテクチャが必要な大規模チームならLitestarを選ぶのが合理的でしょう。私は近いうちに、個人のサイドプロジェクトでFastAPIの新機能を試してみようと思っています。",{"_2571":11899},{"_1892":11900,"_1893":11901,"_1802":11902},"First, FastAPI feels like it's going all-in on convenience. The recently added app.frontend() feature is genuinely useful; it serves SPA build directories like React or Vue directly without needing a separate reverse proxy configuration. Furthermore, v0.139.2 resolved the race conditions that used to occur in multi-threaded environments or parallel testing during router builds, making it significantly more stable. It’s hard to beat for toy projects or rapid MVP development. haha","まずFastAPIは、利便性に全振りしている印象です。最近追加されたapp.frontend()機能が非常に有用で、リバースプロキシを別途設定することなく、ReactやVueのようなSPAビルドディレクトリを直接配信できます。さらに、最近のv0.139.2では、ルーター構築時にマルチスレッド環境や並列テストで発生していたレースコンディションも解決され、安定性が格段に向上しました。個人開発やMVPのスピード開発には、これ以上ないほど便利ですね（笑）。","먼저 FastAPI는 편의성에 올인한 느낌입니다. 최근 추가된 app.frontend() 기능이 진짜 유용한데, 별도의 역방향 프록시 설정 없이 리액트나 뷰 같은 SPA 빌드 디렉터리를 바로 서빙해 줍니다. 게다가 최근 v0.139.2에서는 라우터 빌드 시 멀티스레드 환경이나 병렬 테스트에서 발생하던 레이스 컨디션까지 해결해서 안정성이 훨씬 단단해졌네요. 토이 프로젝트나 빠른 MVP 개발할 때 이보다 편할 순 없을 듯합니다 ㅎㅎ","파이썬 백엔드 프레임워크 고민 중이시라면 요즘 흐름이 꽤 흥미롭습니다. 최근에 FastAPI와 Litestar가 각각 완전히 다른 방향으로 매력을 보여주고 있거든요.\n\n먼저 FastAPI는 편의성에 올인한 느낌입니다. 최근 추가된 `app.frontend()` 기능이 진짜 유용한데, 별도의 역방향 프록시 설정 없이 리액트나 뷰 같은 SPA 빌드 디렉터리를 바로 서빙해 줍니다. 게다가 최근 v0.139.2에서는 라우터 빌드 시 멀티스레드 환경이나 병렬 테스트에서 발생하던 레이스 컨디션까지 해결해서 안정성이 훨씬 단단해졌네요. 토이 프로젝트나 빠른 MVP 개발할 때 이보다 편할 순 없을 듯합니다 ㅎㅎ\n\n반면 대규모 서비스나 구조화된 아키텍처가 필요하다면 Litestar v2.24.0 버전을 눈여겨보셔야 합니다. Pydantic 대신 msgspec을 코어 직렬화 엔진으로 채택해서 속도가 압도적으로 빠르고, 전체적인 처리량도 최대 2배까지 잘 나옵니다. 테스트 코드 짤 때 유용한 의존성 주입 시스템이나 SQLAlchemy 세션 관리를 도와주는 플러그인 생태계도 탄탄해서, 확실히 대형 프로젝트용 모놀리스를 설계할 때는 Litestar가 아주 강력한 선택지네요.\n\n가볍게 프론트엔드까지 묶어서 빠르게 배포하고 싶다면 FastAPI를, 성능이 정말 중요하고 체계적인 아키텍처가 필요한 대형 팀이라면 Litestar를 고르는 게 합리적인 선택이겠네요. 저는 조만간 개인 사이드 프로젝트에 FastAPI 신기능을 한번 얹어볼 생각입니다 ㅎㅎㅎ","305fe5ccdf040a6ad6b755ea27ba244eca45805d8182b15a9d78e516ee139646","2026-07-24T05:37:33.000Z","2026-07-24T05:38:36.826Z",[],[],{"_950":11910,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":3649,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":11911,"_1889":11919,"_2455":-5,"_2456":-5,"_2457":-5,"_9":11923,"_2450":11931,"_2458":-5,"_2460":-5,"_723":11932,"_1886":11933,"_332":11935,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":11936,"_2003":11937,"_2480":11938,"_2482":-5,"_2483":11939,"_2485":-5,"_2486":-5,"_2487":11940,"_1144":11950,"_2527":-5,"_2555":-5,"_2556":11963,"_2798":11998,"_266":11999},"cmryb93li06ji10muoi696oz1",{"_1801":1802,"_214":11912,"_2429":11913,"_2434":11916,"_2438":2439},435,{"_1892":11914,"_1893":1997,"_1802":11915,"_2433":1997},86,349,{"_1892":11917,"_1893":1997,"_1802":11918,"_2433":1997},0.19770114942528735,0.8022988505747126,{"_9":11920,"_2445":11924,"_2450":11928},{"_1892":11921,"_1893":11922,"_1802":11923},"FastAPI v0.139.2 Released — Now You Can Serve React Directly from Your Python Backend","FastAPI v0.139.2リリース — PythonバックエンドからReactを直接配信可能に","FastAPI v0.139.2 출시 — 이제 파이썬 백엔드에서 React 바로 띄운다",{"_1892":11925,"_1893":11926,"_1802":11927},"The recent developments in the Python backend ecosystem are quite exciting. Specifically, the FastAPI v0.139.2 release from last week includes a very welcome feature. Now, with just a single line, app.frontend(), you can natively host static folders built with React or Vite directly from your backend. It also includes built-in support for client-side routing fallbacks, allowing you to deploy both the frontend and backend as a single application without any extra web server configuration. This is going to save so much hassle when setting up toy projects or dashboards, haha.\n\nOn the other hand, the growth of Litestar in medium-to-large enterprise environments is impressive. While FastAPI is simple and flexible, Litestar prevents architectural decay with its built-in dependency injection and class-based controllers. Plus, with support for both msgspec and Pydantic, it clearly holds an edge in performance. It feels like the trend is solidifying: go with FastAPI for simple APIs or AI prototyping, and consider Litestar for serious microservices or backends with heavy business logic.","最近のPythonバックエンドエコシステムの動きが非常に興味深いです。特に先週リリースされたFastAPI v0.139.2には、待ち望んでいた機能が追加されました。app.frontend()と記述するだけで、ReactやViteでビルドした静的ファイルをバックエンドでネイティブにホスティングできるようになりました。クライアントサイドルーティングのフォールバックも標準でサポートされているため、Webサーバーの設定を別途用意することなく、フロントエンドまで含めた単一のアプリケーションとしてきれいにデプロイできます。個人プロジェクトやダッシュボード作成時の煩わしい設定が大幅に減りそうで嬉しいですね。\n\n一方で、中〜大規模なエンタープライズ環境ではLitestarの成長が目覚ましいです。FastAPIがシンプルで自由度が高いのに対し、Litestarは標準搭載の依存関係注入やクラスベースのコントローラーにより、アーキテクチャの崩壊を防ぐことができます。さらに、msgspecとPydanticの両方をサポートしており、パフォーマンス面でも確かな優位性を持っています。小規模なAPIやAIのプロトタイピングにはFastAPIを使い、本格的なマイクロサービスやビジネスロジックが複雑なバックエンドにはLitestarを検討する、という流れが定着しつつあるようです。","최근 파이썬 백엔드 생태계의 움직임이 아주 흥미롭네요. 특히 지난주에 릴리즈된 FastAPI v0.139.2에서 정말 반가운 기능이 들어왔습니다. 이제 app.frontend() 한 줄만 쓰면 React나 Vite로 빌드한 정적 폴더를 백엔드에서 네이티브하게 호스팅할 수 있게 되었어요. 클라이언트 사이드 라우팅 폴백도 기본 지원해서, 별도의 웹 서버 설정 없이 단일 애플리케이션으로 프론트엔드까지 깔끔하게 배포할 수 있습니다. 토이 프로젝트나 대시보드 만들 때 귀찮은 설정이 확 줄어들 것 같네요 ㅎㅎ\n\n한편으로 중대형 엔터프라이즈 환경에서는 Litestar의 성장세가 무섭습니다. FastAPI가 단순하고 자유로운 편이라면, Litestar는 내장된 의존성 주입이나 클래스 기반 컨트롤러 덕분에 아키텍처가 무너지는 걸 막아주거든요. 게다가 msgspec과 Pydantic을 동시에 지원해서 성능 면에서도 확실한 우위를 가져가고 있습니다. 간단한 API나 AI 프로토타이핑은 FastAPI로 가고, 본격적인 마이크로서비스나 비즈니스 로직이 무거운 백엔드는 Litestar를 고민해 보는 흐름이 점점 굳어지는 느낌입니다.",{"_1892":11929,"_1893":11930,"_1802":11931},"The recent developments in the Python backend ecosystem are quite exciting. Specifically, the FastAPI v0.139.2 release from last week includes a very welcome feature. Now, with just a single line, app.frontend(), you can…","最近のPythonバックエンドエコシステムの動きが非常に興味深いです。特に先週リリースされたFastAPI v0.139.2には、待ち望んでいた機能が追加されました。app.frontend()と記述するだけで、ReactやViteでビルドした静的ファイルをバックエンドでネイティブにホスティングできるようになりました。クライアントサイドルーティングのフォールバックも標準でサポートされているため、Webサーバーの設定を別途用意することなく…","최근 파이썬 백엔드 생태계의 움직임이 아주 흥미롭네요. 특히 지난주에 릴리즈된 FastAPI v0.139.2에서 정말 반가운 기능이 들어왔습니다. 이제 app.frontend() 한 줄만 쓰면 React나 Vite로 빌드한 정적 폴더를 백엔드에서 네이티브하게 호스팅할 수 있게 되었어요. 클라이언트 사이드 라우팅 폴백도 기본 지원해서, 별도의 웹 서버 설정 없이 단일 애플리케이션으로 프론트엔드…",[6733],[11816,11817,11818,11934,3128,3129],"spa",[],"2026-07-24T02:18:03.784Z","2026-07-24T02:18:03.510Z","2026-07-24T02:18:57.994Z","2026-07-24T02:18:57.987Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":11941},{"_1901":11942},{"_1903":11943,"_1908":1909,"_1910":11944,"_1921":11945,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":11946,"_1928":11947,"_1933":11948,"_1938":11949},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":11951,"_1883":1884,"_1200":1204,"_1899":11954},{"_633":11952,"_11":11953},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":11955},{"_1903":11956,"_1908":1909,"_1910":11957,"_1921":11958,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":11959,"_1928":11960,"_1933":11961,"_1938":11962},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_950":11964,"_2559":11910,"_2560":11965,"_2716":11984,"_2788":11994,"_2790":11995,"_2792":2142,"_2794":1997,"_2003":11996,"_2480":11997,"_2797":-5},"cmryb93lm06jj10mu9sp5qhbb",{"_918":11966,"_1908":1909},[11967,11976,11979],{"_950":11968,"_2420":2570,"_2571":11969},"647d4ef7-1a39-4152-ab38-c5512817689e",[11970,11972,11974],{"_2579":11971,"_2420":2579},"최근 파이썬 백엔드 생태계의 움직임이 아주 흥미롭네요. 특히 지난주에 릴리즈된 FastAPI v0.139.2에서 정말 반가운 기능이 들어왔습니다. 이제 ",{"_2579":11865,"_2420":2579,"_3365":11973},{"_3351":3367},{"_2579":11975,"_2420":2579}," 한 줄만 쓰면 React나 Vite로 빌드한 정적 폴더를 백엔드에서 네이티브하게 호스팅할 수 있게 되었어요. 클라이언트 사이드 라우팅 폴백도 기본 지원해서, 별도의 웹 서버 설정 없이 단일 애플리케이션으로 프론트엔드까지 깔끔하게 배포할 수 있습니다. 토이 프로젝트나 대시보드 만들 때 귀찮은 설정이 확 줄어들 것 같네요 ㅎㅎ",{"_950":11977,"_2420":2570,"_2571":11978},"e81023b0-eb86-4b07-aac4-2cac2200d027",[],{"_950":11980,"_2420":2570,"_2571":11981},"dccc1a07-9837-4b2a-80c1-ea7094e2ff93",[11982],{"_2579":11983,"_2420":2579},"한편으로 중대형 엔터프라이즈 환경에서는 Litestar의 성장세가 무섭습니다. FastAPI가 단순하고 자유로운 편이라면, Litestar는 내장된 의존성 주입이나 클래스 기반 컨트롤러 덕분에 아키텍처가 무너지는 걸 막아주거든요. 게다가 msgspec과 Pydantic을 동시에 지원해서 성능 면에서도 확실한 우위를 가져가고 있습니다. 간단한 API나 AI 프로토타이핑은 FastAPI로 가고, 본격적인 마이크로서비스나 비즈니스 로직이 무거운 백엔드는 Litestar를 고민해 보는 흐름이 점점 굳어지는 느낌입니다.",{"_11968":11985,"_11980":11990},{"_2571":11986},{"_1892":11987,"_1893":11988,"_1802":11989},"The recent developments in the Python backend ecosystem are quite exciting. Specifically, the FastAPI v0.139.2 release from last week includes a very welcome feature. Now, with just a single line, app.frontend(), you can natively host static folders built with React or Vite directly from your backend. It also includes built-in support for client-side routing fallbacks, allowing you to deploy both the frontend and backend as a single application without any extra web server configuration. This is going to save so much hassle when setting up toy projects or dashboards, haha.","最近のPythonバックエンドエコシステムの動きが非常に興味深いです。特に先週リリースされたFastAPI v0.139.2には、待ち望んでいた機能が追加されました。app.frontend()と記述するだけで、ReactやViteでビルドした静的ファイルをバックエンドでネイティブにホスティングできるようになりました。クライアントサイドルーティングのフォールバックも標準でサポートされているため、Webサーバーの設定を別途用意することなく、フロントエンドまで含めた単一のアプリケーションとしてきれいにデプロイできます。個人プロジェクトやダッシュボード作成時の煩わしい設定が大幅に減りそうで嬉しいですね。","최근 파이썬 백엔드 생태계의 움직임이 아주 흥미롭네요. 특히 지난주에 릴리즈된 FastAPI v0.139.2에서 정말 반가운 기능이 들어왔습니다. 이제 app.frontend() 한 줄만 쓰면 React나 Vite로 빌드한 정적 폴더를 백엔드에서 네이티브하게 호스팅할 수 있게 되었어요. 클라이언트 사이드 라우팅 폴백도 기본 지원해서, 별도의 웹 서버 설정 없이 단일 애플리케이션으로 프론트엔드까지 깔끔하게 배포할 수 있습니다. 토이 프로젝트나 대시보드 만들 때 귀찮은 설정이 확 줄어들 것 같네요 ㅎㅎ",{"_2571":11991},{"_1892":11992,"_1893":11993,"_1802":11983},"On the other hand, the growth of Litestar in medium-to-large enterprise environments is impressive. While FastAPI is simple and flexible, Litestar prevents architectural decay with its built-in dependency injection and class-based controllers. Plus, with support for both msgspec and Pydantic, it clearly holds an edge in performance. It feels like the trend is solidifying: go with FastAPI for simple APIs or AI prototyping, and consider Litestar for serious microservices or backends with heavy business logic.","一方で、中〜大規模なエンタープライズ環境ではLitestarの成長が目覚ましいです。FastAPIがシンプルで自由度が高いのに対し、Litestarは標準搭載の依存関係注入やクラスベースのコントローラーにより、アーキテクチャの崩壊を防ぐことができます。さらに、msgspecとPydanticの両方をサポートしており、パフォーマンス面でも確かな優位性を持っています。小規模なAPIやAIのプロトタイピングにはFastAPIを使い、本格的なマイクロサービスやビジネスロジックが複雑なバックエンドにはLitestarを検討する、という流れが定着しつつあるようです。","최근 파이썬 백엔드 생태계의 움직임이 아주 흥미롭네요. 특히 지난주에 릴리즈된 FastAPI v0.139.2에서 정말 반가운 기능이 들어왔습니다. 이제 `app.frontend()` 한 줄만 쓰면 React나 Vite로 빌드한 정적 폴더를 백엔드에서 네이티브하게 호스팅할 수 있게 되었어요. 클라이언트 사이드 라우팅 폴백도 기본 지원해서, 별도의 웹 서버 설정 없이 단일 애플리케이션으로 프론트엔드까지 깔끔하게 배포할 수 있습니다. 토이 프로젝트나 대시보드 만들 때 귀찮은 설정이 확 줄어들 것 같네요 ㅎㅎ\n\n한편으로 중대형 엔터프라이즈 환경에서는 Litestar의 성장세가 무섭습니다. FastAPI가 단순하고 자유로운 편이라면, Litestar는 내장된 의존성 주입이나 클래스 기반 컨트롤러 덕분에 아키텍처가 무너지는 걸 막아주거든요. 게다가 msgspec과 Pydantic을 동시에 지원해서 성능 면에서도 확실한 우위를 가져가고 있습니다. 간단한 API나 AI 프로토타이핑은 FastAPI로 가고, 본격적인 마이크로서비스나 비즈니스 로직이 무거운 백엔드는 Litestar를 고민해 보는 흐름이 점점 굳어지는 느낌입니다.","29cbc086f32b56f6ca590b4c5dd04ef993e0f60281ad93ff56d4e434055f1704","2026-07-24T02:18:03.514Z","2026-07-24T02:18:57.996Z",[],[],{"_950":12001,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":12002,"_1889":12010,"_2455":-5,"_2456":-5,"_2457":-5,"_9":12014,"_2450":12022,"_2458":12023,"_2460":-5,"_723":12024,"_1886":12025,"_332":12030,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1994,"_2477":12031,"_2003":12032,"_2480":12033,"_2482":-5,"_2483":12034,"_2485":-5,"_2486":-5,"_2487":12035,"_1144":12045,"_2527":12058,"_2555":-5,"_2556":12079,"_2798":12409,"_266":12410},"cmrxurdb705op10muq113nqlm",{"_1801":1802,"_214":12003,"_2429":12004,"_2434":12007,"_2438":2439},3201,{"_1892":12005,"_1893":1997,"_1802":12006,"_2433":1997},1096,2105,{"_1892":12008,"_1893":1997,"_1802":12009,"_2433":1997},0.3423930021868166,0.6576069978131833,{"_9":12011,"_2445":12015,"_2450":12019},{"_1892":12012,"_1893":12013,"_1802":12014},"Next.js 17 Roadmap — Web Architecture for AI Agent Invocation and Payments","Next.js 17ロードマップ — AIエージェントが呼び出し・決済を行うWebアーキテクチャ","Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처",{"_1892":12016,"_1893":12017,"_1802":12018},"Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처\n\nNext.js 17 Roadmap — Web Architecture for AI Agent Invocation and Payments\n\nThe role of web frameworks is evolving beyond rendering interfaces for human users into the realm of machine-to-machine interaction, where AI agents directly modify code and invoke APIs. Next.js 16.3 and the upcoming Next.js 17 roadmap reflect this shift, showing a move toward redesigning the framework itself as an agent-friendly runtime. From local documentation embedding to dedicated proxies that control network boundaries and machine-to-machine payment standards, we will analyze how the next generation of web architecture is building an agent-native ecosystem.\n\nAGENTS.md and MCP — Providing Optimal Navigation for AI Agents\n\nThe biggest challenge when deploying AI agents like Cursor or Claude Code for development is their reliance on outdated training data or incorrect external knowledge. To solve this, Next.js 16.3 embeds version-specific official markdown documentation directly into the project build at node_modules/next/dist/docs/ and provides custom guides for agents via an AGENTS.md file in the project root. According to Vercel's experimental data, relying on external searches or on-demand technical specifications resulted in a 56% agent failure rate, while including version-aligned local documentation within the project increased code generation success to 100%.\n\nThe AGENTS.md file acts as a compass, specifying which local documents an agent should read first to start its tasks.\n\n# AGENTS.md\n이 프로젝트는 Next.js 16.3을 사용합니다.\n코드를 작성하거나 수정하기 전에 아래 로컬 문서를 반드시 먼저 참조하세요.\n- 로컬 API 문서 경로: node_modules/next/dist/docs/\n\nFurthermore, Model Context Protocol (MCP) server integration completes the performance of autonomous debugging. The MCP server, running on the local /_next/mcp endpoint via the next-devtools-mcp tool, provides agents with a real-time interface containing active router structures, live browser and server logs, and compilation error stacks. Agents no longer need to perform heavy production builds; they can simply invoke the compile_route single-path validation tool to immediately diagnose modified code and perform autonomous debugging, resulting in an optimized development flow.\n\nproxy.ts and x402-next — Establishing a Control Plane for Machine-to-Machine Communication and Payments\n\nThe transition from traditional middleware to proxy.ts in Next.js 16 is more than a simple renaming. This change is intended to build a control plane for managing machine-to-machine communication between AI agents, rather than human users. In an environment where agents directly call APIs and conduct transactions without a browser interface, the importance of a proxy layer that governs network boundaries has become increasingly critical.\n\nA particularly notable feature is the integration of accountless cryptographic payments using the x402-next standard. With this protocol, when an AI agent attempts to access an API requiring payment, the system returns an HTTP 402 code to prompt on-chain settlement. The agent then generates an on-chain signature (e.g., for USDC) according to the provided specification, which the proxy layer verifies before granting immediate access to the data.\n\nThe implementation pattern for verifying machine-to-machine payment contracts by linking proxy.ts and x402-next in a Next.js 16+ environment is as follows:\n\nimport { NextResponse } from 'next/server';\nimport { verifyPaymentSignature } from 'x402-next';\n\nexport async function proxy(request: Request) {\n const url = new URL(request.url);\n\n if (url.pathname.startsWith('/api/premium')) {\n const signature = request.headers.get('x-payment-signature');\n const paymentReference = request.headers.get('x-payment-reference');\n\n if (!signature || !paymentReference) {\n return NextResponse.json(\n {\n status: 'Payment Required',\n amount: '0.1',\n currency: 'USDC',\n chain: 'base-sepolia',\n },\n { status: 402 }\n );\n }\n\n const isPaid = await verifyPaymentSignature({\n signature,\n reference: paymentReference,\n amount: '0.1',\n token: 'USDC',\n chain: 'base-sepolia'\n });\n\n if (!isPaid) {\n return NextResponse.json({ error: 'Payment Verification Failed' }, { status: 402 });\n }\n }\n\n return NextResponse.next();\n}\n\nBy adopting this architecture, developers can easily build autonomous machine-to-machine API transaction environments at the framework level, without needing complex user sign-ups or traditional payment gateway integrations. In this new business model where agents pay for and consume value themselves, proxy.ts serves as a secure and reliable payment gateway.\n\nInstant Navigation and Compiler Memory Optimization\n\nIn environments where AI agents write and modify code in real-time, the compilation load on the development server can become extreme. Next.js 16.3 addresses this by introducing a new memory reclamation policy for Turbopack. This method moves cold compiler data that has not been referenced for a long time from memory to disk cache. In fact, based on Vercel dashboard builds, memory usage of the development server was reduced from 21.5GB to 2GB—a decrease of up to 90%—ensuring that the development server remains stable even in demanding environments where agents and compilers operate simultaneously.\n\nAlongside this, Instant Navigation was introduced to achieve dramatic screen transition speeds while maintaining data consistency for React Server Components. By pre-fetching reusable dynamic shells on the client side, it realizes instant, lag-free page transitions similar to single-page applications while keeping a server-centric architecture. As a result, it provides a much faster feedback loop not only for human browsing but also for agents navigating through pages to analyze component states.\n\nNext.js 17 Roadmap — Agent-Aware Components and Scheduled Security Patches\n\nNext.js 17 focuses on transforming the user interface layer itself to be AI agent-friendly. Key changes include the introduction of Agent-Aware Components and a partial hydration system that directly exchanges data with LLM agent runtimes inside the client browser. This provides a dedicated interface that allows agents to precisely read and manipulate component states in the browser environment without having to simulate the screen.\n\nIn addition, release management policies have been strengthened to ensure stability in enterprise environments. Vercel has regularized its security patch distribution schedule to the third week of every month, increasing predictability in vulnerability response. Large-scale teams sensitive to security can use these schedules to safely evaluate and adopt the latest AI web architecture into their production infrastructure.\n\nConclusion — What Developers Need to Prepare for the Agent-Native Era\n\nThe roadmap from Next.js 16.3 to 17 is expanding the scope of web framework operations from humans to machines and agents. Developers need to consider an architecture that goes beyond merely rendering attractive screens, focusing instead on helping agents easily navigate web applications and reliably controlling machine-to-machine payment flows. It is recommended to apply the currently available local agent optimization specifications to small projects first to prepare in advance for the upcoming agent-native environment.\n\nReference Links\n\nVercel / Next.js Blog — Next.js 16.3 Preview: Deep AI Agent Tooling Integration\nVercel / Next.js Releases — Next.js 17 Preview: Agent-Aware Components and Scheduled Security\nGitHub / vercel/next-devtools-mcp — Next.js DevTools MCP (Model Context Protocol) Server","Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처\n\nNext.js 17ロードマップ — AIエージェントが呼び出し・決済を行うWebアーキテクチャ\n\nWebフレームワークの役割は、ユーザー向けの画面レンダリングを超え、AIエージェントが直接コードを修正しAPIを呼び出すという、機械同士の相互作用の領域へと拡大しています。Next.js 16.3と近日リリース予定のNext.js 17のロードマップは、こうした変化に合わせてフレームワーク自体をエージェントフレンドリーなランタイムへと再設計する流れを示しています。ローカルドキュメントの自動同梱から、ネットワーク境界を制御する専用プロキシ、そして機械間決済規格まで、次世代Webアーキテクチャがいかにしてエージェントネイティブなエコシステムを構築していくのかを分析します。\n\nAGENTS.mdとMCP — AIエージェントに最適なナビゲーションを\n\nCursorやClaude CodeのようなAIエージェントが開発に投入される際、最も大きな問題となるのは、古い学習データや誤った外部知識に依存してしまう点です。Next.js 16.3では、この問題を解決するためにプロジェクトビルド時にバージョンに合わせた公式Markdownドキュメントをnode_modules/next/dist/docs/パスにローカルバンドルとして直接同梱し、プロジェクトルートのAGENTS.mdファイルを通じてエージェント向けのカスタマイズされたガイドを提供します。Vercelの実験データによると、外部検索やオンデマンドの技術仕様に依存する方式ではエージェントの実行失敗率が56%に達していましたが、このようにバージョンに適したローカルドキュメントをプロジェクト内に同梱するだけで、コード生成成功率を100%まで引き上げることができました。\n\nAGENTS.mdファイルは、エージェントがどのローカルドキュメントを先に読み込んで作業を開始すべきかを明示するコンパスの役割を果たします。\n\n# AGENTS.md\n이 프로젝트는 Next.js 16.3을 사용합니다.\n코드를 작성하거나 수정하기 전에 아래 로컬 문서를 반드시 먼저 참조하세요.\n- 로컬 API 문서 경로: node_modules/next/dist/docs/\n\nさらにモデルコンテキストプロトコル（MCP）サーバーの統合により、自律的なデバッグ性能も完成しました。next-devtools-mcpツールを通じてローカルの /_next/mcp エンドポイントで動作するMCPサーバーは、エージェントに対してアクティブなルーター構造、リアルタイムのブラウザおよびサーバーログ、コンパイルエラーのスタックをリアルタイムのインターフェースとして提供します。エージェントは重いプロダクションビルドを再実行することなく、単一パス検証ツールである compile_route を呼び出して修正したコードを即座に診断し、自己デバッグを行う最適化された開発フローを完結できます。\n\nproxy.tsとx402-next — 機械間通信と決済コントロールプレーンの構築\n\nNext.js 16で従来のミドルウェアが proxy.ts に改編されたのは、単なる名称変更ではありません。この変化は、人間ではなくAIエージェント同士の「機械対機械（M2M）」通信を制御・管理するコントロールプレーンを構築するためです。エージェントがブラウザ画面なしでAPIを直接呼び出して取引を行う環境において、ネットワーク境界を制御するプロキシ層の重要性が一層高まっているためです。\n\n特に注目すべき機能は、x402-next規格を活用したアカウントレスの暗号資産決済連携です。このプロトコルを使用すると、AIエージェントが決済が必要なAPIにアクセスする際、HTTP 402コードを返してオンチェーン決済を促すことができます。エージェントは提供された仕様に従ってブロックチェーン上でUSDCなどのオンチェーン署名を生成し、プロキシ層がこれを検証して即座にデータを提供します。\n\nNext.js 16+環境で proxy.ts と x402-next を連携させ、機械間決済契約を検証する実装パターンは以下の通りです。\n\nimport { NextResponse } from 'next/server';\nimport { verifyPaymentSignature } from 'x402-next';\n\nexport async function proxy(request: Request) {\n const url = new URL(request.url);\n\n if (url.pathname.startsWith('/api/premium')) {\n const signature = request.headers.get('x-payment-signature');\n const paymentReference = request.headers.get('x-payment-reference');\n\n if (!signature || !paymentReference) {\n return NextResponse.json(\n {\n status: 'Payment Required',\n amount: '0.1',\n currency: 'USDC',\n chain: 'base-sepolia',\n },\n { status: 402 }\n );\n }\n\n const isPaid = await verifyPaymentSignature({\n signature,\n reference: paymentReference,\n amount: '0.1',\n token: 'USDC',\n chain: 'base-sepolia'\n });\n\n if (!isPaid) {\n return NextResponse.json({ error: 'Payment Verification Failed' }, { status: 402 });\n }\n }\n\n return NextResponse.next();\n}\n\nこのアーキテクチャを導入すれば、開発者は複雑な会員登録や既存の決済代行（PG）モジュールの連携なしでも、機械同士の自律的なAPI取引環境をフレームワークレベルで容易に構築できます。エージェントが自ら価値を支払い消費する新しいビジネスモデルにおいて、proxy.ts は安全で信頼できる決済ゲートウェイの役割を果たします。\n\nインスタントナビゲーションとコンパイラのメモリ最適化\n\nAIエージェントがコードをリアルタイムで作成・修正する環境では、開発サーバーのコンパイル負荷が極めて高くなります。Next.js 16.3はTurbopackに新しいメモリ回収ポリシーを導入し、この問題を解決しました。長期間参照されていない「コールド」状態のコンパイラデータをメモリではなくディスクキャッシュに移す手法です。実際にVercelダッシュボードのビルド基準では、開発サーバーのメモリ使用量が従来の21.5GBから2GBへと最大90%削減され、エージェントとコンパイラが同時に動作する厳しい環境でも開発サーバーが安定して維持されます。\n\nこれと併せて導入されたインスタントナビゲーションは、Reactサーバーコンポーネントのデータ整合性を守りながら、劇的な画面遷移速度を実現します。クライアント側で再利用可能な動的シェルを先行取得する動作を通じて、サーバー中心のアーキテクチャを維持しつつ、シングルページアプリケーション（SPA）のような遅延のない即時ページ遷移を実現しました。その結果、人間がWebを閲覧する時だけでなく、エージェントがページを行き来してコンポーネントの状態を分析する際にも、はるかに高速なフィードバックループを提供します。\n\nNext.js 17ロードマップ — エージェント認識コンポーネントと定期セキュリティパッチ\n\nNext.js 17は、ユーザーインターフェース層そのものをAIエージェントフレンドリーに転換することに焦点を当てています。核心的な変化は、クライアントブラウザ内のLLMエージェントランタイムと直接データをやり取りする「エージェント認識コンポーネント」および「部分ハイドレーションシステム」の導入です。エージェントが無理やり画面を模倣しなくても、ブラウザ環境でコンポーネントの状態を精密に読み取り、操作できる専用インターフェースが提供されます。\n\nこれに加え、エンタープライズ環境での安定性を保証するためのリリース管理ポリシーも強化されました。Vercelは毎月第3週にセキュリティパッチの配布日程を定例化し、脆弱性対応の予測可能性を高めました。セキュリティに敏感な大規模サービスチームも、このスケジュールを通じて最新のAI Webアーキテクチャを安全に検討し、実際のプロダクションインフラに導入できます。\n\n結論 — エージェントネイティブ時代に開発者が準備すべきこと\n\nNext.js 16.3から17へ続くロードマップは、Webフレームワークの動作対象を「人間」ではなく「機械やエージェント」へと拡張しています。開発者は単に画面を見栄え良く描画することを超え、エージェントがWebアプリケーションを容易に探索できるよう支援し、機械間の決済フローを安定的に制御するアーキテクチャを考える必要があります。現在提供されているローカルエージェント最適化仕様を小規模プロジェクトから適用し、到来するエージェントネイティブな環境に備えておくことをお勧めします。\n\n参考リンク\n\nVercel / Next.js Blog — Next.js 16.3 Preview: Deep AI Agent Tooling Integration\nVercel / Next.js Releases — Next.js 17 Preview: Agent-Aware Components and Scheduled Security\nGitHub / vercel/next-devtools-mcp — Next.js DevTools MCP (Model Context Protocol) Server","Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처\n\nNext.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처\n\n웹 프레임워크의 역할이 사용자를 위한 화면 렌더링을 넘어 AI 에이전트가 직접 코드를 수정하고 API를 호출하는 기계 간 상호작용의 영역으로 확장되고 있습니다. Next.js 16.3과 곧 출시될 Next.js 17 로드맵은 이러한 변화에 맞춰 프레임워크 자체를 에이전트 친화적인 런타임으로 재설계하는 흐름을 보여줍니다. 로컬 문서 자동 동봉부터 네트워크 경계를 제어하는 전용 프록시와 기계 간 결제 규격까지, 차세대 웹 아키텍처가 에이전트 네이티브 생태계를 어떻게 구축해 나가는지 분석해 보겠습니다.\n\nAGENTS.md와 MCP — AI 에이전트에게 최적의 내비게이션을 제공하다\n\nCursor나 Claude Code 같은 AI 에이전트가 개발에 투입될 때 발생하는 가장 큰 문제는 구버전 학습 데이터나 잘못된 외부 지식에 의존한다는 점입니다. Next.js 16.3은 이 문제를 해결하기 위해 프로젝트 빌드 시 버전에 맞는 공식 마크다운 문서를 node_modules/next/dist/docs/ 경로에 로컬 번들로 직접 동봉하고, 프로젝트 루트의 AGENTS.md 파일을 통해 에이전트용 맞춤 가이드를 제공합니다. Vercel의 실험 데이터에 따르면, 외부 검색이나 온디맨드 기술 스펙에 의존하는 방식은 에이전트 실행 실패율이 56%에 달했으나, 이처럼 버전에 맞춘 로컬 문서를 프로젝트 내에 동봉하는 것만으로 코드 생성 성공률을 100%까지 끌어올릴 수 있었습니다.\n\nAGENTS.md 파일은 에이전트가 어떤 로컬 문서를 먼저 읽고 작업을 시작해야 하는지 명시하는 나침반 역할을 수행합니다.\n\n# AGENTS.md\n이 프로젝트는 Next.js 16.3을 사용합니다.\n코드를 작성하거나 수정하기 전에 아래 로컬 문서를 반드시 먼저 참조하세요.\n- 로컬 API 문서 경로: node_modules/next/dist/docs/\n\n여기에 모델 컨텍스트 프로토콜(MCP) 서버 통합이 더해지면서 자율 디버깅의 성능도 완성됩니다. next-devtools-mcp 도구를 통해 로컬의 /_next/mcp 엔드포인트에서 작동하는 MCP 서버는 에이전트에게 활성화된 라우터 구조, 실시간 브라우저 및 서버 로그, 컴파일 에러 스택을 실시간 인터페이스로 제공합니다. 에이전트는 무겁게 프로덕션 빌드를 다시 돌릴 필요 없이, 단일 경로 검증 도구인 compile_route를 호출하여 수정한 코드를 즉시 진단하고 스스로 디버깅하는 최적화된 개발 흐름을 완성할 수 있습니다.\n\nproxy.ts와 x402-next — 기계 간 통신과 결제 통제 평면 구축\n\nNext.js 16에서 기존의 미들웨어가 proxy.ts로 개편된 것은 단순한 이름 변경이 아닙니다. 이 변화는 인간 사용자가 아닌 AI 에이전트 간의 기계 대 기계 통신을 제어하고 관리하는 통제 평면을 구축하기 위함입니다. 에이전트가 브라우저 화면 없이 API를 직접 호출하고 거래하는 환경에서, 네트워크 경계를 통제하는 프록시 레이어의 중요성이 더욱 커졌기 때문입니다.\n\n특히 주목할 기능은 x402-next 규격을 활용한 계정 없는 암호화 결제 연동입니다. 이 프로토콜을 사용하면 AI 에이전트가 결제가 필요한 API에 접근할 때 HTTP 402 코드를 반환하여 온체인 결제를 유도할 수 있습니다. 에이전트는 제공된 명세에 따라 블록체인 상에서 USDC 등의 온체인 서명을 생성하고, 프록시 레이어는 이를 검증하여 즉시 데이터를 제공합니다.\n\nNext.js 16+ 환경에서 proxy.ts와 x402-next를 연동하여 기계 간 결제 계약을 검증하는 구현 패턴은 다음과 같습니다.\n\nimport { NextResponse } from 'next/server';\nimport { verifyPaymentSignature } from 'x402-next';\n\nexport async function proxy(request: Request) {\n const url = new URL(request.url);\n\n if (url.pathname.startsWith('/api/premium')) {\n const signature = request.headers.get('x-payment-signature');\n const paymentReference = request.headers.get('x-payment-reference');\n\n if (!signature || !paymentReference) {\n return NextResponse.json(\n {\n status: 'Payment Required',\n amount: '0.1',\n currency: 'USDC',\n chain: 'base-sepolia',\n },\n { status: 402 }\n );\n }\n\n const isPaid = await verifyPaymentSignature({\n signature,\n reference: paymentReference,\n amount: '0.1',\n token: 'USDC',\n chain: 'base-sepolia'\n });\n\n if (!isPaid) {\n return NextResponse.json({ error: 'Payment Verification Failed' }, { status: 402 });\n }\n }\n\n return NextResponse.next();\n}\n\n이 아키텍처를 도입하면 개발자는 복잡한 회원가입이나 기존의 PG사 결제 모듈 연동 없이도, 기계 간의 자율적인 API 거래 환경을 프레임워크 수준에서 손쉽게 구축할 수 있습니다. 에이전트가 스스로 가치를 지불하고 소비하는 새로운 비즈니스 모델에서 proxy.ts는 안전하고 신뢰할 수 있는 결제 게이트웨이 역할을 수행합니다.\n\n인스턴트 내비게이션과 컴파일러 메모리 최적화\n\nAI 에이전트가 코드를 실시간으로 작성하고 수정하는 환경에서는 개발 서버의 컴파일 부하가 극심해집니다. Next.js 16.3은 터보팩에 새로운 메모리 회수 정책을 도입하여 이 문제를 해결했습니다. 오랫동안 참조되지 않은 차가운 상태의 컴파일러 데이터를 메모리 대신 디스크 캐시로 옮기는 방식입니다. 실제로 Vercel 대시보드 빌드 기준 개발 서버의 메모리 사용량이 기존 21.5GB에서 2GB로 최대 90%까지 감소하여, 에이전트와 컴파일러가 동시에 작동하는 가혹한 환경에서도 개발 서버가 안정적으로 유지됩니다.\n\n이와 함께 도입된 인스턴트 내비게이션은 React 서버 컴포넌트의 데이터 일관성을 지키면서 극적인 화면 전환 속도를 만들어냅니다. 클라이언트 측에서 재사용 가능한 동적 셸을 미리 가져오는 동작을 통해, 서버 중심 아키텍처를 유지하면서도 싱글 페이지 애플리케이션처럼 지연 없는 즉각적인 페이지 전환을 실현합니다. 결과적으로 사람이 웹을 탐색할 때뿐만 아니라, 에이전트가 페이지를 넘나들며 컴포넌트 상태를 분석할 때도 훨씬 빠른 피드백 루프를 제공합니다.\n\nNext.js 17 로드맵 — 에이전트 인식 컴포넌트와 정기 보안 패치\n\nNext.js 17은 사용자 인터페이스 레이어 자체를 AI 에이전트 친화적으로 전환하는 데 초점을 맞추고 있습니다. 핵심 변화는 클라이언트 브라우저 내부의 LLM 에이전트 런타임과 직접 데이터를 주고받는 에이전트 인식 컴포넌트와 부분 하이드레이션 시스템의 도입입니다. 에이전트가 억지로 화면을 모사하지 않고도 브라우저 환경에서 컴포넌트의 상태를 정밀하게 읽고 조작할 수 있는 전용 인터페이스가 제공됩니다.\n\n여기에 더해 엔터프라이즈 환경에서의 안정성을 보장하기 위한 릴리스 관리 정책도 강화되었습니다. Vercel은 매월 셋째 주로 보안 패치 배포 일정을 정례화하여 취약점 대응의 예측 가능성을 높였습니다. 보안에 민감한 대규모 서비스 팀도 이러한 일정을 통해 최신 AI 웹 아키텍처를 안전하게 검토하고 실제 프로덕션 인프라에 도입할 수 있습니다.\n\n결론 — 에이전트 네이티브 시대에 개발자가 준비해야 할 것\n\nNext.js 16.3에서 17로 이어지는 로드맵은 웹 프레임워크의 동작 대상을 사람이 아닌 기계와 에이전트로 확장하고 있습니다. 개발자는 단순히 화면을 보기 좋게 그리는 것을 넘어, 에이전트가 웹 애플리케이션을 쉽게 탐색할 수 있도록 돕고 기계 간 결제 흐름을 안정적으로 통제하는 아키텍처를 고민해야 합니다. 현재 제공되는 로컬 에이전트 최적화 명세를 소규모 프로젝트에 먼저 적용해 보며 다가오는 에이전트 네이티브 환경을 미리 준비하는 것이 좋습니다.\n\n참고 링크\n\nVercel / Next.js Blog — Next.js 16.3 Preview: Deep AI Agent Tooling Integration\nVercel / Next.js Releases — Next.js 17 Preview: Agent-Aware Components and Scheduled Security\nGitHub / vercel/next-devtools-mcp — Next.js DevTools MCP (Model Context Protocol) Server",{"_1892":12020,"_1893":12021,"_1802":12022},"Next.js 17 Roadmap — Web Architecture for AI Agent Invocation and Payments The role of web frameworks is evolving beyond rendering interfaces for human users into the realm of machine-to-machine interaction, where AI age…","Next.js 17ロードマップ — AIエージェントが呼び出し・決済を行うWebアーキテクチャ Webフレームワークの役割は、ユーザー向けの画面レンダリングを超え、AIエージェントが直接コードを修正しAPIを呼び出すという、機械同士の相互作用の領域へと拡大しています。Next.js 16.3と近日リリース予定のNext.js 17のロードマップは、こうした変化に合わせてフレームワーク自体をエージェントフレンドリーなランタイムへと再設計…","Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처 웹 프레임워크의 역할이 사용자를 위한 화면 렌더링을 넘어 AI 에이전트가 직접 코드를 수정하고 API를 호출하는 기계 간 상호작용의 영역으로 확장되고 있습니다. Next.js 16.3과 곧 출시될 Next.js 17 로드맵은 이러한 변화에 맞춰 프레임워크 자체를 에이전트 친화적인 런타임으로 재설계하는 흐름을 보여줍니…","cmrxvjsph05qr10mud0g4ywmq",[7576],[12026,12027,4943,12028,12029,1677],"nextjs","react","ai-agents","web-architecture",[],"2026-07-24T00:41:17.163Z","2026-07-23T18:36:22.435Z","2026-07-25T04:53:27.338Z","2026-07-24T00:41:38.123Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":12036},{"_1901":12037},{"_1903":12038,"_1908":1909,"_1910":12039,"_1921":12040,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":12041,"_1928":12042,"_1933":12043,"_1938":12044},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":12046,"_1883":1884,"_1200":1204,"_1899":12049},{"_633":12047,"_11":12048},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":12050},{"_1903":12051,"_1908":1909,"_1910":12052,"_1921":12053,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":12054,"_1928":12055,"_1933":12056,"_1938":12057},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":12059},{"_1948":-5,"_1908":1909,"_1910":12060,"_1960":-5,"_1943":12065,"_1962":12066},{"_1912":12061,"_1914":12062,"_1952":12063,"_1810":2534,"_944":1992,"_1917":12064,"_1957":2536,"_1919":5946},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/54f4cd66-895e-4977-bef3-9a7777bbd570.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/54f4cd66-895e-4977-bef3-9a7777bbd570.jpg",394784,"L57USH~pD$D%R~R$bEof004n%N%f","2026-07-23T18:58:29.304Z",{"_1964":12067,"_1972":12071,"_1979":12075,"_1986":-5},{"_1912":12068,"_1914":12069,"_1952":12070,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/large.webp",22234,{"_1912":12072,"_1914":12073,"_1952":12074,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/small.webp",6252,{"_1912":12076,"_1914":12077,"_1952":12078,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxvjsph05qr10mud0g4ywmq/medium.webp",12632,{"_950":12080,"_2559":12001,"_2560":12081,"_2716":12318,"_2788":12405,"_2790":12406,"_2792":7989,"_2794":1997,"_2003":12407,"_2480":12408,"_2797":-5},"cmrxurdbb05oq10mu3shqkbqc",{"_918":12082,"_1908":1909},[12083,12085,12088,12092,12095,12100,12103,12108,12111,12126,12129,12136,12139,12142,12145,12165,12168,12173,12176,12181,12184,12189,12192,12197,12200,12203,12206,12211,12214,12219,12222,12227,12230,12235,12238,12243,12246,12251,12254,12259,12262,12267,12270,12275,12278,12280,12283,12288,12291],{"_950":12084,"_2565":12014,"_2420":2566,"_2567":12023},"d9d7e43f-464f-4f2e-ab60-93e746c5b366",{"_950":12086,"_2420":2570,"_2571":12087},"ebbff670-66e7-4135-8455-5d130a27676f",[],{"_950":12089,"_2420":2575,"_2576":1909,"_2571":12090},"9675f85b-6b2c-42e2-b038-740cc8f64115",[12091],{"_2579":12014,"_2420":2579},{"_950":12093,"_2420":2570,"_2571":12094},"236010e8-223d-41bd-9f56-cad0969a70ed",[],{"_950":12096,"_2420":2570,"_2571":12097},"104d1f11-e04c-46aa-ac1c-c6a76ec4da39",[12098],{"_2579":12099,"_2420":2579},"웹 프레임워크의 역할이 사용자를 위한 화면 렌더링을 넘어 AI 에이전트가 직접 코드를 수정하고 API를 호출하는 기계 간 상호작용의 영역으로 확장되고 있습니다. Next.js 16.3과 곧 출시될 Next.js 17 로드맵은 이러한 변화에 맞춰 프레임워크 자체를 에이전트 친화적인 런타임으로 재설계하는 흐름을 보여줍니다. 로컬 문서 자동 동봉부터 네트워크 경계를 제어하는 전용 프록시와 기계 간 결제 규격까지, 차세대 웹 아키텍처가 에이전트 네이티브 생태계를 어떻게 구축해 나가는지 분석해 보겠습니다.",{"_950":12101,"_2420":2570,"_2571":12102},"10bdb5bf-e236-4516-b1c5-d3b3e5621950",[],{"_950":12104,"_2420":2575,"_2576":2007,"_2571":12105},"75d7935c-2a49-42de-affa-a5c1738fe3b4",[12106],{"_2579":12107,"_2420":2579},"AGENTS.md와 MCP — AI 에이전트에게 최적의 내비게이션을 제공하다",{"_950":12109,"_2420":2570,"_2571":12110},"1e58218a-71ae-46be-97fb-8d5481fac1d0",[],{"_950":12112,"_2420":2570,"_2571":12113},"176077a8-5fae-49d2-a4b9-8556e0ce8563",[12114,12116,12119,12121,12124],{"_2579":12115,"_2420":2579},"Cursor나 Claude Code 같은 AI 에이전트가 개발에 투입될 때 발생하는 가장 큰 문제는 구버전 학습 데이터나 잘못된 외부 지식에 의존한다는 점입니다. Next.js 16.3은 이 문제를 해결하기 위해 프로젝트 빌드 시 버전에 맞는 공식 마크다운 문서를 ",{"_2579":12117,"_2420":2579,"_3365":12118},"node_modules/next/dist/docs/",{"_3351":3367},{"_2579":12120,"_2420":2579}," 경로에 로컬 번들로 직접 동봉하고, 프로젝트 루트의 ",{"_2579":12122,"_2420":2579,"_3365":12123},"AGENTS.md",{"_3351":3367},{"_2579":12125,"_2420":2579}," 파일을 통해 에이전트용 맞춤 가이드를 제공합니다. Vercel의 실험 데이터에 따르면, 외부 검색이나 온디맨드 기술 스펙에 의존하는 방식은 에이전트 실행 실패율이 56%에 달했으나, 이처럼 버전에 맞춘 로컬 문서를 프로젝트 내에 동봉하는 것만으로 코드 생성 성공률을 100%까지 끌어올릴 수 있었습니다.",{"_950":12127,"_2420":2570,"_2571":12128},"33c628ab-7433-4a56-a759-9c65cb22cb9c",[],{"_950":12130,"_2420":2570,"_2571":12131},"09be7033-10a5-4805-8f1e-b16119e2b257",[12132,12134],{"_2579":12122,"_2420":2579,"_3365":12133},{"_3351":3367},{"_2579":12135,"_2420":2579}," 파일은 에이전트가 어떤 로컬 문서를 먼저 읽고 작업을 시작해야 하는지 명시하는 나침반 역할을 수행합니다.",{"_950":12137,"_2420":2570,"_2571":12138},"ada76344-b27f-435c-bd97-c3a4001c4801",[],{"_950":12140,"_3351":12141,"_2420":3351,"_625":2788},"ac78ec78-f9b1-4dbb-9ffd-b9eb44b51780","# AGENTS.md\n이 프로젝트는 Next.js 16.3을 사용합니다.\n코드를 작성하거나 수정하기 전에 아래 로컬 문서를 반드시 먼저 참조하세요.\n- 로컬 API 문서 경로: node_modules/next/dist/docs/",{"_950":12143,"_2420":2570,"_2571":12144},"e5da4b1f-5392-4d03-b22b-7425366957ef",[],{"_950":12146,"_2420":2570,"_2571":12147},"9808a2a2-25f2-446a-b98b-7f6407156dec",[12148,12150,12153,12155,12158,12160,12163],{"_2579":12149,"_2420":2579},"여기에 모델 컨텍스트 프로토콜(MCP) 서버 통합이 더해지면서 자율 디버깅의 성능도 완성됩니다. ",{"_2579":12151,"_2420":2579,"_3365":12152},"next-devtools-mcp",{"_3351":3367},{"_2579":12154,"_2420":2579}," 도구를 통해 로컬의 ",{"_2579":12156,"_2420":2579,"_3365":12157},"/_next/mcp",{"_3351":3367},{"_2579":12159,"_2420":2579}," 엔드포인트에서 작동하는 MCP 서버는 에이전트에게 활성화된 라우터 구조, 실시간 브라우저 및 서버 로그, 컴파일 에러 스택을 실시간 인터페이스로 제공합니다. 에이전트는 무겁게 프로덕션 빌드를 다시 돌릴 필요 없이, 단일 경로 검증 도구인 ",{"_2579":12161,"_2420":2579,"_3365":12162},"compile_route",{"_3351":3367},{"_2579":12164,"_2420":2579},"를 호출하여 수정한 코드를 즉시 진단하고 스스로 디버깅하는 최적화된 개발 흐름을 완성할 수 있습니다.",{"_950":12166,"_2420":2570,"_2571":12167},"29053dfd-42c4-4854-b3a1-513cb775734c",[],{"_950":12169,"_2420":2575,"_2576":2007,"_2571":12170},"93e57c5c-0d2b-4d36-a183-5af2becc44d9",[12171],{"_2579":12172,"_2420":2579},"proxy.ts와 x402-next — 기계 간 통신과 결제 통제 평면 구축",{"_950":12174,"_2420":2570,"_2571":12175},"c2994884-a9a3-48f7-a37e-67b23705f3d8",[],{"_950":12177,"_2420":2570,"_2571":12178},"1b16b5a6-127b-4b1b-aea7-bea4af9e469b",[12179],{"_2579":12180,"_2420":2579},"Next.js 16에서 기존의 미들웨어가 proxy.ts로 개편된 것은 단순한 이름 변경이 아닙니다. 이 변화는 인간 사용자가 아닌 AI 에이전트 간의 기계 대 기계 통신을 제어하고 관리하는 통제 평면을 구축하기 위함입니다. 에이전트가 브라우저 화면 없이 API를 직접 호출하고 거래하는 환경에서, 네트워크 경계를 통제하는 프록시 레이어의 중요성이 더욱 커졌기 때문입니다.",{"_950":12182,"_2420":2570,"_2571":12183},"08eb5dc6-fb84-4371-9f9f-277409869391",[],{"_950":12185,"_2420":2570,"_2571":12186},"89657f9c-c0e2-413a-b9e2-530cd21bc663",[12187],{"_2579":12188,"_2420":2579},"특히 주목할 기능은 x402-next 규격을 활용한 계정 없는 암호화 결제 연동입니다. 이 프로토콜을 사용하면 AI 에이전트가 결제가 필요한 API에 접근할 때 HTTP 402 코드를 반환하여 온체인 결제를 유도할 수 있습니다. 에이전트는 제공된 명세에 따라 블록체인 상에서 USDC 등의 온체인 서명을 생성하고, 프록시 레이어는 이를 검증하여 즉시 데이터를 제공합니다.",{"_950":12190,"_2420":2570,"_2571":12191},"1b169d17-e1ce-48f9-8e93-6f488d3b03d5",[],{"_950":12193,"_2420":2570,"_2571":12194},"bf28ae38-c4ef-46e5-80b0-38105c972ca3",[12195],{"_2579":12196,"_2420":2579},"Next.js 16+ 환경에서 proxy.ts와 x402-next를 연동하여 기계 간 결제 계약을 검증하는 구현 패턴은 다음과 같습니다.",{"_950":12198,"_2420":2570,"_2571":12199},"e2bcda1f-275d-4214-ad2a-759d3877e25b",[],{"_950":12201,"_3351":12202,"_2420":3351,"_625":3125},"0ec05b30-b77d-4d78-99b4-0c61332786d6","import { NextResponse } from 'next/server';\nimport { verifyPaymentSignature } from 'x402-next';\n\nexport async function proxy(request: Request) {\n const url = new URL(request.url);\n\n if (url.pathname.startsWith('/api/premium')) {\n const signature = request.headers.get('x-payment-signature');\n const paymentReference = request.headers.get('x-payment-reference');\n\n if (!signature || !paymentReference) {\n return NextResponse.json(\n {\n status: 'Payment Required',\n amount: '0.1',\n currency: 'USDC',\n chain: 'base-sepolia',\n },\n { status: 402 }\n );\n }\n\n const isPaid = await verifyPaymentSignature({\n signature,\n reference: paymentReference,\n amount: '0.1',\n token: 'USDC',\n chain: 'base-sepolia'\n });\n\n if (!isPaid) {\n return NextResponse.json({ error: 'Payment Verification Failed' }, { status: 402 });\n }\n }\n\n return NextResponse.next();\n}",{"_950":12204,"_2420":2570,"_2571":12205},"8b79f27f-32c4-4de4-b2e0-6e3061e1fd91",[],{"_950":12207,"_2420":2570,"_2571":12208},"b114d2a8-62ce-42d0-96de-cfc3f59adad3",[12209],{"_2579":12210,"_2420":2579},"이 아키텍처를 도입하면 개발자는 복잡한 회원가입이나 기존의 PG사 결제 모듈 연동 없이도, 기계 간의 자율적인 API 거래 환경을 프레임워크 수준에서 손쉽게 구축할 수 있습니다. 에이전트가 스스로 가치를 지불하고 소비하는 새로운 비즈니스 모델에서 proxy.ts는 안전하고 신뢰할 수 있는 결제 게이트웨이 역할을 수행합니다.",{"_950":12212,"_2420":2570,"_2571":12213},"fe8fafc3-1717-4292-ba14-4a29d01820de",[],{"_950":12215,"_2420":2575,"_2576":2007,"_2571":12216},"5fe88663-2cf7-421c-9884-7f63ccce75a8",[12217],{"_2579":12218,"_2420":2579},"인스턴트 내비게이션과 컴파일러 메모리 최적화",{"_950":12220,"_2420":2570,"_2571":12221},"17889465-395a-4c6b-8539-db0e125efbc7",[],{"_950":12223,"_2420":2570,"_2571":12224},"f4f3359f-12ed-45b2-afee-16b43074e767",[12225],{"_2579":12226,"_2420":2579},"AI 에이전트가 코드를 실시간으로 작성하고 수정하는 환경에서는 개발 서버의 컴파일 부하가 극심해집니다. Next.js 16.3은 터보팩에 새로운 메모리 회수 정책을 도입하여 이 문제를 해결했습니다. 오랫동안 참조되지 않은 차가운 상태의 컴파일러 데이터를 메모리 대신 디스크 캐시로 옮기는 방식입니다. 실제로 Vercel 대시보드 빌드 기준 개발 서버의 메모리 사용량이 기존 21.5GB에서 2GB로 최대 90%까지 감소하여, 에이전트와 컴파일러가 동시에 작동하는 가혹한 환경에서도 개발 서버가 안정적으로 유지됩니다.",{"_950":12228,"_2420":2570,"_2571":12229},"330f118f-4de7-4280-a8e7-9cddf6a2b450",[],{"_950":12231,"_2420":2570,"_2571":12232},"6dc0a916-ab53-47fb-8f47-743bb7bd195e",[12233],{"_2579":12234,"_2420":2579},"이와 함께 도입된 인스턴트 내비게이션은 React 서버 컴포넌트의 데이터 일관성을 지키면서 극적인 화면 전환 속도를 만들어냅니다. 클라이언트 측에서 재사용 가능한 동적 셸을 미리 가져오는 동작을 통해, 서버 중심 아키텍처를 유지하면서도 싱글 페이지 애플리케이션처럼 지연 없는 즉각적인 페이지 전환을 실현합니다. 결과적으로 사람이 웹을 탐색할 때뿐만 아니라, 에이전트가 페이지를 넘나들며 컴포넌트 상태를 분석할 때도 훨씬 빠른 피드백 루프를 제공합니다.",{"_950":12236,"_2420":2570,"_2571":12237},"e5b5f1bf-d62d-48bf-9d63-6b6129e1d3e5",[],{"_950":12239,"_2420":2575,"_2576":2007,"_2571":12240},"c7cc5198-0ead-4fcc-bb42-805980741b8e",[12241],{"_2579":12242,"_2420":2579},"Next.js 17 로드맵 — 에이전트 인식 컴포넌트와 정기 보안 패치",{"_950":12244,"_2420":2570,"_2571":12245},"61bc9fe8-0168-4b1d-872b-95a56e89ce86",[],{"_950":12247,"_2420":2570,"_2571":12248},"c25431e2-a8c5-4114-b803-3f85338afaa6",[12249],{"_2579":12250,"_2420":2579},"Next.js 17은 사용자 인터페이스 레이어 자체를 AI 에이전트 친화적으로 전환하는 데 초점을 맞추고 있습니다. 핵심 변화는 클라이언트 브라우저 내부의 LLM 에이전트 런타임과 직접 데이터를 주고받는 에이전트 인식 컴포넌트와 부분 하이드레이션 시스템의 도입입니다. 에이전트가 억지로 화면을 모사하지 않고도 브라우저 환경에서 컴포넌트의 상태를 정밀하게 읽고 조작할 수 있는 전용 인터페이스가 제공됩니다.",{"_950":12252,"_2420":2570,"_2571":12253},"a0778bb8-4642-4877-9364-7fb24cf479b7",[],{"_950":12255,"_2420":2570,"_2571":12256},"47115dd0-892c-4a70-9979-139407cc5bdc",[12257],{"_2579":12258,"_2420":2579},"여기에 더해 엔터프라이즈 환경에서의 안정성을 보장하기 위한 릴리스 관리 정책도 강화되었습니다. Vercel은 매월 셋째 주로 보안 패치 배포 일정을 정례화하여 취약점 대응의 예측 가능성을 높였습니다. 보안에 민감한 대규모 서비스 팀도 이러한 일정을 통해 최신 AI 웹 아키텍처를 안전하게 검토하고 실제 프로덕션 인프라에 도입할 수 있습니다.",{"_950":12260,"_2420":2570,"_2571":12261},"8a81b541-f6c7-4528-a7d3-475959b50331",[],{"_950":12263,"_2420":2575,"_2576":2007,"_2571":12264},"02a67591-55da-4823-9951-dc61fb921b0a",[12265],{"_2579":12266,"_2420":2579},"결론 — 에이전트 네이티브 시대에 개발자가 준비해야 할 것",{"_950":12268,"_2420":2570,"_2571":12269},"e2577424-5811-4443-93be-65b1147864f7",[],{"_950":12271,"_2420":2570,"_2571":12272},"23df9404-0290-49e8-b983-8c8bb50dca33",[12273],{"_2579":12274,"_2420":2579},"Next.js 16.3에서 17로 이어지는 로드맵은 웹 프레임워크의 동작 대상을 사람이 아닌 기계와 에이전트로 확장하고 있습니다. 개발자는 단순히 화면을 보기 좋게 그리는 것을 넘어, 에이전트가 웹 애플리케이션을 쉽게 탐색할 수 있도록 돕고 기계 간 결제 흐름을 안정적으로 통제하는 아키텍처를 고민해야 합니다. 현재 제공되는 로컬 에이전트 최적화 명세를 소규모 프로젝트에 먼저 적용해 보며 다가오는 에이전트 네이티브 환경을 미리 준비하는 것이 좋습니다.",{"_950":12276,"_2420":2570,"_2571":12277},"6691696e-0b8f-4b02-940a-2cf9e6bb9537",[],{"_950":12279,"_2420":3473},"d62470ea-563e-4646-9284-3ea01094da36",{"_950":12281,"_2420":2570,"_2571":12282},"f34a4ca9-c845-4464-9e30-e89685cd4a36",[],{"_950":12284,"_2420":2570,"_2571":12285},"f70ba5e3-7ed9-4f06-a818-cc5c900b3c88",[12286],{"_2579":3483,"_2420":2579,"_3365":12287},{"_3485":3367},{"_950":12289,"_2420":2570,"_2571":12290},"d5489aad-ab6e-4e0e-9fb6-e9d6180ecdd3",[],{"_950":12292,"_1881":3492,"_2420":3493,"_778":12293},"17d6c11c-7f5e-49fa-8e53-a932fb6ee534",[12294,12302,12310],{"_950":12295,"_2571":12296},"0c79bf43-b88f-4d10-baf1-f869ebad20b3",[12297],{"_3499":12298,"_2420":3501,"_3502":12299},"https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals",[12300],{"_2579":12301,"_2420":2579},"Vercel / Next.js Blog — Next.js 16.3 Preview: Deep AI Agent Tooling Integration",{"_950":12303,"_2571":12304},"7a388b9f-73af-4b28-b6be-cdefdb6ae1f9",[12305],{"_3499":12306,"_2420":3501,"_3502":12307},"https://nextjs.org/blog/nextjs-security-release-and-our-next-patch-release",[12308],{"_2579":12309,"_2420":2579},"Vercel / Next.js Releases — Next.js 17 Preview: Agent-Aware Components and Scheduled Security",{"_950":12311,"_2571":12312},"b74cba2d-e36a-4c9f-a7de-2dd7bf058c7c",[12313],{"_3499":12314,"_2420":3501,"_3502":12315},"https://github.com/vercel/next-devtools-mcp",[12316],{"_2579":12317,"_2420":2579},"GitHub / vercel/next-devtools-mcp — Next.js DevTools MCP (Model Context Protocol) Server",{"_12263":12319,"_12130":12323,"_12096":12328,"_12112":12332,"_12292":12337,"_12177":12344,"_12271":12348,"_12255":12352,"_12215":12356,"_12231":12360,"_12104":12364,"_12185":12368,"_12169":12372,"_12089":12376,"_12146":12378,"_12207":12383,"_12193":12387,"_12247":12391,"_12239":12395,"_12223":12399,"_12284":12403},{"_2571":12320},{"_1892":12321,"_1893":12322,"_1802":12266},"Conclusion — What Developers Need to Prepare for the Agent-Native Era","結論 — エージェントネイティブ時代に開発者が準備すべきこと",{"_2571":12324},{"_1892":12325,"_1893":12326,"_1802":12327},"The AGENTS.md file acts as a compass, specifying which local documents an agent should read first to start its tasks.","AGENTS.mdファイルは、エージェントがどのローカルドキュメントを先に読み込んで作業を開始すべきかを明示するコンパスの役割を果たします。","AGENTS.md 파일은 에이전트가 어떤 로컬 문서를 먼저 읽고 작업을 시작해야 하는지 명시하는 나침반 역할을 수행합니다.",{"_2571":12329},{"_1892":12330,"_1893":12331,"_1802":12099},"The role of web frameworks is evolving beyond rendering interfaces for human users into the realm of machine-to-machine interaction, where AI agents directly modify code and invoke APIs. Next.js 16.3 and the upcoming Next.js 17 roadmap reflect this shift, showing a move toward redesigning the framework itself as an agent-friendly runtime. From local documentation embedding to dedicated proxies that control network boundaries and machine-to-machine payment standards, we will analyze how the next generation of web architecture is building an agent-native ecosystem.","Webフレームワークの役割は、ユーザー向けの画面レンダリングを超え、AIエージェントが直接コードを修正しAPIを呼び出すという、機械同士の相互作用の領域へと拡大しています。Next.js 16.3と近日リリース予定のNext.js 17のロードマップは、こうした変化に合わせてフレームワーク自体をエージェントフレンドリーなランタイムへと再設計する流れを示しています。ローカルドキュメントの自動同梱から、ネットワーク境界を制御する専用プロキシ、そして機械間決済規格まで、次世代Webアーキテクチャがいかにしてエージェントネイティブなエコシステムを構築していくのかを分析します。",{"_2571":12333},{"_1892":12334,"_1893":12335,"_1802":12336},"The biggest challenge when deploying AI agents like Cursor or Claude Code for development is their reliance on outdated training data or incorrect external knowledge. To solve this, Next.js 16.3 embeds version-specific official markdown documentation directly into the project build at node_modules/next/dist/docs/ and provides custom guides for agents via an AGENTS.md file in the project root. According to Vercel's experimental data, relying on external searches or on-demand technical specifications resulted in a 56% agent failure rate, while including version-aligned local documentation within the project increased code generation success to 100%.","CursorやClaude CodeのようなAIエージェントが開発に投入される際、最も大きな問題となるのは、古い学習データや誤った外部知識に依存してしまう点です。Next.js 16.3では、この問題を解決するためにプロジェクトビルド時にバージョンに合わせた公式Markdownドキュメントをnode_modules/next/dist/docs/パスにローカルバンドルとして直接同梱し、プロジェクトルートのAGENTS.mdファイルを通じてエージェント向けのカスタマイズされたガイドを提供します。Vercelの実験データによると、外部検索やオンデマンドの技術仕様に依存する方式ではエージェントの実行失敗率が56%に達していましたが、このようにバージョンに適したローカルドキュメントをプロジェクト内に同梱するだけで、コード生成成功率を100%まで引き上げることができました。","Cursor나 Claude Code 같은 AI 에이전트가 개발에 투입될 때 발생하는 가장 큰 문제는 구버전 학습 데이터나 잘못된 외부 지식에 의존한다는 점입니다. Next.js 16.3은 이 문제를 해결하기 위해 프로젝트 빌드 시 버전에 맞는 공식 마크다운 문서를 node_modules/next/dist/docs/ 경로에 로컬 번들로 직접 동봉하고, 프로젝트 루트의 AGENTS.md 파일을 통해 에이전트용 맞춤 가이드를 제공합니다. Vercel의 실험 데이터에 따르면, 외부 검색이나 온디맨드 기술 스펙에 의존하는 방식은 에이전트 실행 실패율이 56%에 달했으나, 이처럼 버전에 맞춘 로컬 문서를 프로젝트 내에 동봉하는 것만으로 코드 생성 성공률을 100%까지 끌어올릴 수 있었습니다.",{"_12338":12339,"_12340":12341,"_12342":12343},"item:0c79bf43-b88f-4d10-baf1-f869ebad20b3",{"_1892":12301,"_1893":12301,"_1802":12301},"item:7a388b9f-73af-4b28-b6be-cdefdb6ae1f9",{"_1892":12309,"_1893":12309,"_1802":12309},"item:b74cba2d-e36a-4c9f-a7de-2dd7bf058c7c",{"_1892":12317,"_1893":12317,"_1802":12317},{"_2571":12345},{"_1892":12346,"_1893":12347,"_1802":12180},"The transition from traditional middleware to proxy.ts in Next.js 16 is more than a simple renaming. This change is intended to build a control plane for managing machine-to-machine communication between AI agents, rather than human users. In an environment where agents directly call APIs and conduct transactions without a browser interface, the importance of a proxy layer that governs network boundaries has become increasingly critical.","Next.js 16で従来のミドルウェアが proxy.ts に改編されたのは、単なる名称変更ではありません。この変化は、人間ではなくAIエージェント同士の「機械対機械（M2M）」通信を制御・管理するコントロールプレーンを構築するためです。エージェントがブラウザ画面なしでAPIを直接呼び出して取引を行う環境において、ネットワーク境界を制御するプロキシ層の重要性が一層高まっているためです。",{"_2571":12349},{"_1892":12350,"_1893":12351,"_1802":12274},"The roadmap from Next.js 16.3 to 17 is expanding the scope of web framework operations from humans to machines and agents. Developers need to consider an architecture that goes beyond merely rendering attractive screens, focusing instead on helping agents easily navigate web applications and reliably controlling machine-to-machine payment flows. It is recommended to apply the currently available local agent optimization specifications to small projects first to prepare in advance for the upcoming agent-native environment.","Next.js 16.3から17へ続くロードマップは、Webフレームワークの動作対象を「人間」ではなく「機械やエージェント」へと拡張しています。開発者は単に画面を見栄え良く描画することを超え、エージェントがWebアプリケーションを容易に探索できるよう支援し、機械間の決済フローを安定的に制御するアーキテクチャを考える必要があります。現在提供されているローカルエージェント最適化仕様を小規模プロジェクトから適用し、到来するエージェントネイティブな環境に備えておくことをお勧めします。",{"_2571":12353},{"_1892":12354,"_1893":12355,"_1802":12258},"In addition, release management policies have been strengthened to ensure stability in enterprise environments. Vercel has regularized its security patch distribution schedule to the third week of every month, increasing predictability in vulnerability response. Large-scale teams sensitive to security can use these schedules to safely evaluate and adopt the latest AI web architecture into their production infrastructure.","これに加え、エンタープライズ環境での安定性を保証するためのリリース管理ポリシーも強化されました。Vercelは毎月第3週にセキュリティパッチの配布日程を定例化し、脆弱性対応の予測可能性を高めました。セキュリティに敏感な大規模サービスチームも、このスケジュールを通じて最新のAI Webアーキテクチャを安全に検討し、実際のプロダクションインフラに導入できます。",{"_2571":12357},{"_1892":12358,"_1893":12359,"_1802":12218},"Instant Navigation and Compiler Memory Optimization","インスタントナビゲーションとコンパイラのメモリ最適化",{"_2571":12361},{"_1892":12362,"_1893":12363,"_1802":12234},"Alongside this, Instant Navigation was introduced to achieve dramatic screen transition speeds while maintaining data consistency for React Server Components. By pre-fetching reusable dynamic shells on the client side, it realizes instant, lag-free page transitions similar to single-page applications while keeping a server-centric architecture. As a result, it provides a much faster feedback loop not only for human browsing but also for agents navigating through pages to analyze component states.","これと併せて導入されたインスタントナビゲーションは、Reactサーバーコンポーネントのデータ整合性を守りながら、劇的な画面遷移速度を実現します。クライアント側で再利用可能な動的シェルを先行取得する動作を通じて、サーバー中心のアーキテクチャを維持しつつ、シングルページアプリケーション（SPA）のような遅延のない即時ページ遷移を実現しました。その結果、人間がWebを閲覧する時だけでなく、エージェントがページを行き来してコンポーネントの状態を分析する際にも、はるかに高速なフィードバックループを提供します。",{"_2571":12365},{"_1892":12366,"_1893":12367,"_1802":12107},"AGENTS.md and MCP — Providing Optimal Navigation for AI Agents","AGENTS.mdとMCP — AIエージェントに最適なナビゲーションを",{"_2571":12369},{"_1892":12370,"_1893":12371,"_1802":12188},"A particularly notable feature is the integration of accountless cryptographic payments using the x402-next standard. With this protocol, when an AI agent attempts to access an API requiring payment, the system returns an HTTP 402 code to prompt on-chain settlement. The agent then generates an on-chain signature (e.g., for USDC) according to the provided specification, which the proxy layer verifies before granting immediate access to the data.","特に注目すべき機能は、x402-next規格を活用したアカウントレスの暗号資産決済連携です。このプロトコルを使用すると、AIエージェントが決済が必要なAPIにアクセスする際、HTTP 402コードを返してオンチェーン決済を促すことができます。エージェントは提供された仕様に従ってブロックチェーン上でUSDCなどのオンチェーン署名を生成し、プロキシ層がこれを検証して即座にデータを提供します。",{"_2571":12373},{"_1892":12374,"_1893":12375,"_1802":12172},"proxy.ts and x402-next — Establishing a Control Plane for Machine-to-Machine Communication and Payments","proxy.tsとx402-next — 機械間通信と決済コントロールプレーンの構築",{"_2571":12377},{"_1892":12012,"_1893":12013,"_1802":12014},{"_2571":12379},{"_1892":12380,"_1893":12381,"_1802":12382},"Furthermore, Model Context Protocol (MCP) server integration completes the performance of autonomous debugging. The MCP server, running on the local /_next/mcp endpoint via the next-devtools-mcp tool, provides agents with a real-time interface containing active router structures, live browser and server logs, and compilation error stacks. Agents no longer need to perform heavy production builds; they can simply invoke the compile_route single-path validation tool to immediately diagnose modified code and perform autonomous debugging, resulting in an optimized development flow.","さらにモデルコンテキストプロトコル（MCP）サーバーの統合により、自律的なデバッグ性能も完成しました。next-devtools-mcpツールを通じてローカルの /_next/mcp エンドポイントで動作するMCPサーバーは、エージェントに対してアクティブなルーター構造、リアルタイムのブラウザおよびサーバーログ、コンパイルエラーのスタックをリアルタイムのインターフェースとして提供します。エージェントは重いプロダクションビルドを再実行することなく、単一パス検証ツールである compile_route を呼び出して修正したコードを即座に診断し、自己デバッグを行う最適化された開発フローを完結できます。","여기에 모델 컨텍스트 프로토콜(MCP) 서버 통합이 더해지면서 자율 디버깅의 성능도 완성됩니다. next-devtools-mcp 도구를 통해 로컬의 /_next/mcp 엔드포인트에서 작동하는 MCP 서버는 에이전트에게 활성화된 라우터 구조, 실시간 브라우저 및 서버 로그, 컴파일 에러 스택을 실시간 인터페이스로 제공합니다. 에이전트는 무겁게 프로덕션 빌드를 다시 돌릴 필요 없이, 단일 경로 검증 도구인 compile_route를 호출하여 수정한 코드를 즉시 진단하고 스스로 디버깅하는 최적화된 개발 흐름을 완성할 수 있습니다.",{"_2571":12384},{"_1892":12385,"_1893":12386,"_1802":12210},"By adopting this architecture, developers can easily build autonomous machine-to-machine API transaction environments at the framework level, without needing complex user sign-ups or traditional payment gateway integrations. In this new business model where agents pay for and consume value themselves, proxy.ts serves as a secure and reliable payment gateway.","このアーキテクチャを導入すれば、開発者は複雑な会員登録や既存の決済代行（PG）モジュールの連携なしでも、機械同士の自律的なAPI取引環境をフレームワークレベルで容易に構築できます。エージェントが自ら価値を支払い消費する新しいビジネスモデルにおいて、proxy.ts は安全で信頼できる決済ゲートウェイの役割を果たします。",{"_2571":12388},{"_1892":12389,"_1893":12390,"_1802":12196},"The implementation pattern for verifying machine-to-machine payment contracts by linking proxy.ts and x402-next in a Next.js 16+ environment is as follows:","Next.js 16+環境で proxy.ts と x402-next を連携させ、機械間決済契約を検証する実装パターンは以下の通りです。",{"_2571":12392},{"_1892":12393,"_1893":12394,"_1802":12250},"Next.js 17 focuses on transforming the user interface layer itself to be AI agent-friendly. Key changes include the introduction of Agent-Aware Components and a partial hydration system that directly exchanges data with LLM agent runtimes inside the client browser. This provides a dedicated interface that allows agents to precisely read and manipulate component states in the browser environment without having to simulate the screen.","Next.js 17は、ユーザーインターフェース層そのものをAIエージェントフレンドリーに転換することに焦点を当てています。核心的な変化は、クライアントブラウザ内のLLMエージェントランタイムと直接データをやり取りする「エージェント認識コンポーネント」および「部分ハイドレーションシステム」の導入です。エージェントが無理やり画面を模倣しなくても、ブラウザ環境でコンポーネントの状態を精密に読み取り、操作できる専用インターフェースが提供されます。",{"_2571":12396},{"_1892":12397,"_1893":12398,"_1802":12242},"Next.js 17 Roadmap — Agent-Aware Components and Scheduled Security Patches","Next.js 17ロードマップ — エージェント認識コンポーネントと定期セキュリティパッチ",{"_2571":12400},{"_1892":12401,"_1893":12402,"_1802":12226},"In environments where AI agents write and modify code in real-time, the compilation load on the development server can become extreme. Next.js 16.3 addresses this by introducing a new memory reclamation policy for Turbopack. This method moves cold compiler data that has not been referenced for a long time from memory to disk cache. In fact, based on Vercel dashboard builds, memory usage of the development server was reduced from 21.5GB to 2GB—a decrease of up to 90%—ensuring that the development server remains stable even in demanding environments where agents and compilers operate simultaneously.","AIエージェントがコードをリアルタイムで作成・修正する環境では、開発サーバーのコンパイル負荷が極めて高くなります。Next.js 16.3はTurbopackに新しいメモリ回収ポリシーを導入し、この問題を解決しました。長期間参照されていない「コールド」状態のコンパイラデータをメモリではなくディスクキャッシュに移す手法です。実際にVercelダッシュボードのビルド基準では、開発サーバーのメモリ使用量が従来の21.5GBから2GBへと最大90%削減され、エージェントとコンパイラが同時に動作する厳しい環境でも開発サーバーが安定して維持されます。",{"_2571":12404},{"_1892":3603,"_1893":3604,"_1802":3483},"![Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처](file:cmrxvjsph05qr10mud0g4ywmq)\n\n# Next.js 17 로드맵 — AI 에이전트가 호출하고 결제하는 웹 아키텍처\n\n웹 프레임워크의 역할이 사용자를 위한 화면 렌더링을 넘어 AI 에이전트가 직접 코드를 수정하고 API를 호출하는 기계 간 상호작용의 영역으로 확장되고 있습니다. Next.js 16.3과 곧 출시될 Next.js 17 로드맵은 이러한 변화에 맞춰 프레임워크 자체를 에이전트 친화적인 런타임으로 재설계하는 흐름을 보여줍니다. 로컬 문서 자동 동봉부터 네트워크 경계를 제어하는 전용 프록시와 기계 간 결제 규격까지, 차세대 웹 아키텍처가 에이전트 네이티브 생태계를 어떻게 구축해 나가는지 분석해 보겠습니다.\n\n## AGENTS.md와 MCP — AI 에이전트에게 최적의 내비게이션을 제공하다\n\nCursor나 Claude Code 같은 AI 에이전트가 개발에 투입될 때 발생하는 가장 큰 문제는 구버전 학습 데이터나 잘못된 외부 지식에 의존한다는 점입니다. Next.js 16.3은 이 문제를 해결하기 위해 프로젝트 빌드 시 버전에 맞는 공식 마크다운 문서를 `node\\_modules/next/dist/docs/` 경로에 로컬 번들로 직접 동봉하고, 프로젝트 루트의 `AGENTS.md` 파일을 통해 에이전트용 맞춤 가이드를 제공합니다. Vercel의 실험 데이터에 따르면, 외부 검색이나 온디맨드 기술 스펙에 의존하는 방식은 에이전트 실행 실패율이 56%에 달했으나, 이처럼 버전에 맞춘 로컬 문서를 프로젝트 내에 동봉하는 것만으로 코드 생성 성공률을 100%까지 끌어올릴 수 있었습니다.\n\n`AGENTS.md` 파일은 에이전트가 어떤 로컬 문서를 먼저 읽고 작업을 시작해야 하는지 명시하는 나침반 역할을 수행합니다.\n\n```markdown\n# AGENTS.md\n이 프로젝트는 Next.js 16.3을 사용합니다.\n코드를 작성하거나 수정하기 전에 아래 로컬 문서를 반드시 먼저 참조하세요.\n- 로컬 API 문서 경로: node_modules/next/dist/docs/\n```\n\n여기에 모델 컨텍스트 프로토콜(MCP) 서버 통합이 더해지면서 자율 디버깅의 성능도 완성됩니다. `next-devtools-mcp` 도구를 통해 로컬의 `/\\_next/mcp` 엔드포인트에서 작동하는 MCP 서버는 에이전트에게 활성화된 라우터 구조, 실시간 브라우저 및 서버 로그, 컴파일 에러 스택을 실시간 인터페이스로 제공합니다. 에이전트는 무겁게 프로덕션 빌드를 다시 돌릴 필요 없이, 단일 경로 검증 도구인 `compile\\_route`를 호출하여 수정한 코드를 즉시 진단하고 스스로 디버깅하는 최적화된 개발 흐름을 완성할 수 있습니다.\n\n## proxy.ts와 x402-next — 기계 간 통신과 결제 통제 평면 구축\n\nNext.js 16에서 기존의 미들웨어가 proxy.ts로 개편된 것은 단순한 이름 변경이 아닙니다. 이 변화는 인간 사용자가 아닌 AI 에이전트 간의 기계 대 기계 통신을 제어하고 관리하는 통제 평면을 구축하기 위함입니다. 에이전트가 브라우저 화면 없이 API를 직접 호출하고 거래하는 환경에서, 네트워크 경계를 통제하는 프록시 레이어의 중요성이 더욱 커졌기 때문입니다.\n\n특히 주목할 기능은 x402-next 규격을 활용한 계정 없는 암호화 결제 연동입니다. 이 프로토콜을 사용하면 AI 에이전트가 결제가 필요한 API에 접근할 때 HTTP 402 코드를 반환하여 온체인 결제를 유도할 수 있습니다. 에이전트는 제공된 명세에 따라 블록체인 상에서 USDC 등의 온체인 서명을 생성하고, 프록시 레이어는 이를 검증하여 즉시 데이터를 제공합니다.\n\nNext.js 16+ 환경에서 proxy.ts와 x402-next를 연동하여 기계 간 결제 계약을 검증하는 구현 패턴은 다음과 같습니다.\n\n```typescript\nimport { NextResponse } from 'next/server';\nimport { verifyPaymentSignature } from 'x402-next';\n\nexport async function proxy(request: Request) {\n const url = new URL(request.url);\n\n if (url.pathname.startsWith('/api/premium')) {\n const signature = request.headers.get('x-payment-signature');\n const paymentReference = request.headers.get('x-payment-reference');\n\n if (!signature || !paymentReference) {\n return NextResponse.json(\n {\n status: 'Payment Required',\n amount: '0.1',\n currency: 'USDC',\n chain: 'base-sepolia',\n },\n { status: 402 }\n );\n }\n\n const isPaid = await verifyPaymentSignature({\n signature,\n reference: paymentReference,\n amount: '0.1',\n token: 'USDC',\n chain: 'base-sepolia'\n });\n\n if (!isPaid) {\n return NextResponse.json({ error: 'Payment Verification Failed' }, { status: 402 });\n }\n }\n\n return NextResponse.next();\n}\n```\n\n이 아키텍처를 도입하면 개발자는 복잡한 회원가입이나 기존의 PG사 결제 모듈 연동 없이도, 기계 간의 자율적인 API 거래 환경을 프레임워크 수준에서 손쉽게 구축할 수 있습니다. 에이전트가 스스로 가치를 지불하고 소비하는 새로운 비즈니스 모델에서 proxy.ts는 안전하고 신뢰할 수 있는 결제 게이트웨이 역할을 수행합니다.\n\n## 인스턴트 내비게이션과 컴파일러 메모리 최적화\n\nAI 에이전트가 코드를 실시간으로 작성하고 수정하는 환경에서는 개발 서버의 컴파일 부하가 극심해집니다. Next.js 16.3은 터보팩에 새로운 메모리 회수 정책을 도입하여 이 문제를 해결했습니다. 오랫동안 참조되지 않은 차가운 상태의 컴파일러 데이터를 메모리 대신 디스크 캐시로 옮기는 방식입니다. 실제로 Vercel 대시보드 빌드 기준 개발 서버의 메모리 사용량이 기존 21.5GB에서 2GB로 최대 90%까지 감소하여, 에이전트와 컴파일러가 동시에 작동하는 가혹한 환경에서도 개발 서버가 안정적으로 유지됩니다.\n\n이와 함께 도입된 인스턴트 내비게이션은 React 서버 컴포넌트의 데이터 일관성을 지키면서 극적인 화면 전환 속도를 만들어냅니다. 클라이언트 측에서 재사용 가능한 동적 셸을 미리 가져오는 동작을 통해, 서버 중심 아키텍처를 유지하면서도 싱글 페이지 애플리케이션처럼 지연 없는 즉각적인 페이지 전환을 실현합니다. 결과적으로 사람이 웹을 탐색할 때뿐만 아니라, 에이전트가 페이지를 넘나들며 컴포넌트 상태를 분석할 때도 훨씬 빠른 피드백 루프를 제공합니다.\n\n## Next.js 17 로드맵 — 에이전트 인식 컴포넌트와 정기 보안 패치\n\nNext.js 17은 사용자 인터페이스 레이어 자체를 AI 에이전트 친화적으로 전환하는 데 초점을 맞추고 있습니다. 핵심 변화는 클라이언트 브라우저 내부의 LLM 에이전트 런타임과 직접 데이터를 주고받는 에이전트 인식 컴포넌트와 부분 하이드레이션 시스템의 도입입니다. 에이전트가 억지로 화면을 모사하지 않고도 브라우저 환경에서 컴포넌트의 상태를 정밀하게 읽고 조작할 수 있는 전용 인터페이스가 제공됩니다.\n\n여기에 더해 엔터프라이즈 환경에서의 안정성을 보장하기 위한 릴리스 관리 정책도 강화되었습니다. Vercel은 매월 셋째 주로 보안 패치 배포 일정을 정례화하여 취약점 대응의 예측 가능성을 높였습니다. 보안에 민감한 대규모 서비스 팀도 이러한 일정을 통해 최신 AI 웹 아키텍처를 안전하게 검토하고 실제 프로덕션 인프라에 도입할 수 있습니다.\n\n## 결론 — 에이전트 네이티브 시대에 개발자가 준비해야 할 것\n\nNext.js 16.3에서 17로 이어지는 로드맵은 웹 프레임워크의 동작 대상을 사람이 아닌 기계와 에이전트로 확장하고 있습니다. 개발자는 단순히 화면을 보기 좋게 그리는 것을 넘어, 에이전트가 웹 애플리케이션을 쉽게 탐색할 수 있도록 돕고 기계 간 결제 흐름을 안정적으로 통제하는 아키텍처를 고민해야 합니다. 현재 제공되는 로컬 에이전트 최적화 명세를 소규모 프로젝트에 먼저 적용해 보며 다가오는 에이전트 네이티브 환경을 미리 준비하는 것이 좋습니다.\n\n---\n\n**참고 링크**\n\n- [Vercel / Next.js Blog — Next.js 16.3 Preview: Deep AI Agent Tooling Integration](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals)\n- [Vercel / Next.js Releases — Next.js 17 Preview: Agent-Aware Components and Scheduled Security](https://nextjs.org/blog/nextjs-security-release-and-our-next-patch-release)\n- [GitHub / vercel/next-devtools-mcp — Next.js DevTools MCP (Model Context Protocol) Server](https://github.com/vercel/next-devtools-mcp)","53ce7ebade25e3ec2d6ba07117a1ce542ce4e263f5ad3055461adbe053e84d1c","2026-07-23T18:36:22.439Z","2026-07-24T00:41:38.159Z",[],[12411],{"_2802":12412,"_1881":2804},"cmq7enyxx001310mfgmelwda3",{"_950":12414,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":12415,"_1889":12423,"_2455":-5,"_2456":-5,"_2457":-5,"_9":12427,"_2450":12435,"_2458":12436,"_2460":-5,"_723":12437,"_1886":12438,"_332":12442,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":12443,"_2003":12444,"_2480":12445,"_2482":-5,"_2483":12446,"_2485":-5,"_2486":-5,"_2487":12447,"_1144":12457,"_2527":12470,"_2555":-5,"_2556":12491,"_2798":12970,"_266":12971},"cmrxf5xln052i10mujhzdl3wr",{"_1801":1802,"_214":12416,"_2429":12417,"_2434":12420,"_2438":2439},3517,{"_1892":12418,"_1893":1997,"_1802":12419,"_2433":1997},1346,2171,{"_1892":12421,"_1893":1997,"_1802":12422,"_2433":1997},0.3827125390958203,0.6172874609041797,{"_9":12424,"_2445":12428,"_2450":12432},{"_1892":12425,"_1893":12426,"_1802":12427},"NestJS 12 Preview — Ditching class-validator for Zod","NestJS 12プレビュー — class-validatorを廃止し、Zodへ完全移行","NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다",{"_1892":12429,"_1893":12430,"_1802":12431},"NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다\n\nNestJS 12 Preview — Ditching class-validator for Zod\n\nThe NestJS 12 preview is a major update that fundamentally addresses the legacy dependencies and complex build configurations that have hampered backend development. By supporting Standard Schema 1.0 at the core, it allows you to validate request data directly with Zod or Valibot, bypassing the need for class-validator, and the entire package is shifting to native ESM. In addition, the introduction of Rust-based high-performance toolchains like Rspack and Vitest significantly boosts developer productivity. From a backend developer’s perspective, let’s explore the problems this major update resolves and how to prepare for a safe migration.\n\nIntroducing Standard Schema 1.0: Saying Goodbye to class-validator\n\nOne of the biggest changes in NestJS 12 is the native integration of the Standard Schema 1.0 specification into the framework core. Now, you can pass schemas like Zod or Valibot directly as arguments to the @Body(), @Query(), and @Param() decorators in route handlers.\n\nIn the past, NestJS relied on class-validator and class-transformer to validate payloads. Since this approach inferred dynamic types based on decorators, it required enabling the emitDecoratorMetadata option in tsconfig.json. However, this option not only adds heavy computation at compile time but also clashes with high-speed Rust-based bundlers like Rspack, Vite, and esbuild, acting as a major bottleneck for adopting modern build tools.\n\nTo solve this, NestJS 12 introduces the StandardSchemaValidationPipe. Instead of relying on metadata reflection at runtime, it executes the standard validation method of the injected schema object directly within the pipe. This allows for a safe and fast validation pipeline without cumbersome compiler settings or runtime reflection overhead.\n\nComparing the existing class-validator approach with the new NestJS 12 Zod-based validation makes the benefits clear.\n\n// [기존 방식] class-validator 사용 (emitDecoratorMetadata 옵션 필수)\nimport { IsString, IsEmail } from 'class-validator';\n\nexport class CreateUserDto {\n @IsString()\n name!: string;\n\n @IsEmail()\n email!: string;\n}\n\n@Post()\ncreate(@Body() createUserDto: CreateUserDto) {}\n\n// [NestJS 12 방식] Standard Schema 사용 (Zod 스키마 직접 주입)\nimport { z } from 'zod';\n\nexport const CreateUserSchema = z.object({\n name: z.string(),\n email: z.string().email(),\n});\n\n@Post()\ncreate(@Body({ schema: CreateUserSchema }) body: z.infer) {}\n\nSimply passing the schema to the controller decorator allows the StandardSchemaValidationPipe to handle payload validation internally, and the StandardSchemaSerializerInterceptor can handle response serialization if needed. By using standard schema specifications without complex third-party integration libraries, both developer experience and build speeds are significantly improved.\n\nNative ESM Transition and Synchronous require(esm) Compatibility\n\nAll core NestJS 12 packages are shifting to native ESM. Until now, managing module import configurations between CommonJS and ESM has been a chronic issue consuming developer time. This update addresses that barrier by leveraging the synchronous require(esm) feature in modern Node.js environments.\n\nSynchronous require(esm) is a core feature officially supported in Node.js v20.19.0+ and v22.12.0+. This allows you to safely load NestJS 12 core packages—which are built as native ESM—into existing CommonJS-based applications without needing an immediate or total rewrite of your project configuration.\n\nCommunity benchmarks show that the difference in cold start times or idle memory usage (RSS) between NestJS 11 (CJS) and NestJS 12 (native ESM) is negligible. Ultimately, the true value of this ESM transition lies not in a sudden, dramatic performance boost, but in the improved developer experience of being able to integrate modern ESM-only libraries into your project without complex settings or custom wrappers.\n\nHigh-Speed Rust Toolchain: Rspack, Vitest, and oxlint\n\nNestJS 12 adopts a suite of modern Rust-based development tools to dramatically shorten the feedback loop. These new build and test systems are applied by default to new native ESM project templates generated via CLI. To maintain ecosystem stability, CJS-based templates will continue to use the existing Webpack, Jest, and ESLint configurations.\n\nThe most noticeable change is the replacement of Webpack, which served as the default bundler for a long time, with Rspack, an ultra-fast Rust-based bundler. Build performance is several times faster, drastically improving local dev server startup and production build times. Furthermore, the code analysis tool has switched from the heavy ESLint to oxlint, which is written in Rust and boasts overwhelming parsing speeds, minimizing waiting times during code analysis upon saving.\n\nThe testing environment has also undergone a major shift. Vitest replaces Jest as the new default test runner, as Jest was often heavy and difficult to configure in ESM environments. Vitest is equipped with the high-speed OXC parsing engine, which quickly processes NestJS's complex decorators. According to actual migration cases, total test execution time fell from 42 seconds to just 11 seconds, drastically reducing wait times for developers in local and CI/CD pipelines.\n\nPreparing for a Safe Migration\n\nTo migrate to NestJS 12 stably, you need to coordinate your runtime environment and TypeScript settings in advance.\n\nFirst, update the Node.js version running your server. To maintain compatibility with existing CommonJS projects even while core packages move to native ESM, you must ensure an environment of Node.js v20.19.0 or higher (or v22.12.0+) to officially support the synchronous require(esm) feature.\n\nNext, update your TypeScript compiler settings. In your tsconfig.json, update both the module and moduleResolution options to \"NodeNext\" to explicitly define ESM module resolution rules.\n\n{\n \"compilerOptions\": {\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"NodeNext\"\n }\n}\n\nApplying the NodeNext standard requires that you include the .js extension in all import statements that reference local files with relative paths. Since paths are interpreted based on the resulting JavaScript output rather than the .ts source files, it is recommended to review all imports and add the necessary extensions beforehand.\n\nConclusion: Should You Migrate Right Now?\n\nNestJS 12 is a significant update that clears away technical debt and drives modernization of the ecosystem. If you are starting a new project or already actively using Zod or ESM packages, it is definitely worth adopting, as you can immediately take advantage of the new Rust-based dev toolchain and the convenience of native ESM.\n\nHowever, there is no need to rush if you are maintaining an existing service. According to actual benchmarks, the ESM transition provides only minor improvements in runtime performance or memory usage. Therefore, rather than forcing an upgrade solely for performance gains, it is a wiser strategy to gradually shift from class-validator to standard schemas and evaluate the ESM support of your current libraries before moving forward.\n\nReference Links\n\nbyteiota — NestJS v12 Preview: ESM, Vitest, and the End of class-validator\nBoutlet Tech — NestJS 12 ESM Migration and Standard Schema Analysis\nTrilon Consulting & InfoQ — Native Standard Schema v1.0 Validation in NestJS 12","NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다\n\nNestJS 12プレビュー — class-validatorを廃止し、Zodへ完全移行\n\nNestJS 12プレビューは、バックエンド開発の負担となっていたレガシーな依存関係と複雑なビルド設定を大幅に改善するメジャーアップデートです。コアレベルでStandard Schema 1.0をサポートしたことで、class-validatorなしでZodやValibotによるリクエストデータの直接検証が可能になり、パッケージ全体もネイティブESMへ移行します。さらに、RspackやVitestといったRustベースの高性能ツールチェーンを標準採用し、開発生産性も劇的に向上しました。バックエンド開発者の視点から、今回のメジャーアップデートがどのような問題を解決し、安全なマイグレーションのために何を備えるべきか、一つずつ見ていきましょう。\n\nStandard Schema 1.0の導入：class-validatorとの決別\n\nNestJS 12の最大の変更点の一つは、Standard Schema 1.0仕様をフレームワークのコアにネイティブ導入したことです。これにより、ルートハンドラーの@Body()、@Query()、@Param()デコレーターに、ZodやValibotのようなスキーマを引数として直接渡せるようになりました。\n\nこれまでのNestJSでペイロードを検証するには、class-validatorとclass-transformerへの依存が不可欠でした。この方式はデコレーターベースで動的に型を推論するため、tsconfig.jsonでemitDecoratorMetadataオプションを有効にする必要がありました。しかし、このオプションはTypeScriptのコンパイル時に重い計算を要求するだけでなく、Rspack、Vite、esbuildといったRustベースの超高速バンドラーと互換性がないため、最新のビルドツール導入における最大の障壁となっていました。\n\nNestJS 12ではこの問題を解決するため、組み込みのStandardSchemaValidationPipeを提供します。実行時にメタデータのリフレクションに依存せず、デコレーターに直接注入されたスキーマオブジェクトの標準検証メソッドをパイプ内部で直接実行する仕組みです。おかげで、煩雑なコンパイラ設定や実行時のリフレクションオーバーヘッドなしに、安全かつ高速な検証パイプラインを構築できます。\n\n従来のclass-validator方式とNestJS 12のZodベースの検証方式を比較すると、その違いは明らかです。\n\n// [기존 방식] class-validator 사용 (emitDecoratorMetadata 옵션 필수)\nimport { IsString, IsEmail } from 'class-validator';\n\nexport class CreateUserDto {\n @IsString()\n name!: string;\n\n @IsEmail()\n email!: string;\n}\n\n@Post()\ncreate(@Body() createUserDto: CreateUserDto) {}\n\n// [NestJS 12 방식] Standard Schema 사용 (Zod 스키마 직접 주입)\nimport { z } from 'zod';\n\nexport const CreateUserSchema = z.object({\n name: z.string(),\n email: z.string().email(),\n});\n\n@Post()\ncreate(@Body({ schema: CreateUserSchema }) body: z.infer) {}\n\nこのように、スキーマをコントローラーのデコレーターに直接渡すだけで、内部的にStandardSchemaValidationPipeがペイロードを検証し、必要に応じてStandardSchemaSerializerInterceptorがレスポンスのシリアライズまで処理します。複雑な外部統合ライブラリなしで標準スキーマ仕様をそのまま使えるため、開発者体験とビルド速度の両方が大きく向上します。\n\nネイティブESMへの移行と同期的なrequire(esm)の互換性\n\nNestJS 12のすべてのコアパッケージはネイティブESMに移行します。これまでバックエンドエコシステムにおいて、CommonJSとESMの間のモジュールインポート設定は、開発者の時間を奪う根深い問題でした。今回のメジャーアップデートでは、この壁を打ち破るために最新のNode.js環境の同期的なrequire(esm)機能を積極的に活用します。\n\n同期的なrequire(esm)は、Node.js v20.19.0以降およびv22.12.0以降で正式サポートされる核心的な機能です。この機能のおかげで、既存のCommonJSベースで作成されたレガシーアプリケーション設定を直ちに変更せずとも、ネイティブESMでビルドされたNestJS 12コアパッケージを安全に読み込み、互換性を維持できます。\n\n実際のコミュニティのベンチマーク結果を見ても、NestJS 11ベースのCJS環境とNestJS 12のネイティブESM環境の間で、コールドスタート時間やアイドル時のメモリ占有率（RSS）の差はほとんどありません。結局のところ、今回のESM移行の真の価値は、当面の劇的なパフォーマンス向上というよりは、現代的なESM専用ライブラリを面倒な設定やラップなしでプロジェクトに即座に統合できる、開発体験の改善にあります。\n\nRspack、Vitest、oxlintを網羅する超高速Rustツールチェーン\n\nNestJS 12は開発フィードバックループを劇的に短縮するため、Rustベースの現代的な開発ツールを多数採用しました。この新しいビルドおよびテストシステムは、CLIコマンドで作成する新規ネイティブESMプロジェクトテンプレートにデフォルトで適用されます。既存のCommonJSプロジェクトとのエコシステムの安定性を考慮し、CJSベースのテンプレートは従来のWebpack、Jest、ESLint構成を維持します。\n\n最も目を引く変化は、長らく標準バンドラーとして活躍したWebpackが、Rustベースの超高速バンドラーであるRspackに置き換わった点です。ビルド性能が数倍以上速くなり、ローカル開発サーバーの起動とプロダクションビルドの速度が画期的に向上します。さらにコード分析ツールも、重いESLintの代わりにRustで書かれ圧倒的な解析速度を誇るoxlintを採用し、保存時のコード分析の待ち時間を最小化しました。\n\nテスト環境にも大きな変化があります。ESM環境では設定が煩雑で重かったJestに代わり、Vitestが新しい標準テストランナーとして導入されます。特にこのVitestは超高速構文解析エンジンOXCを搭載しており、NestJSの複雑なデコレーターを迅速に処理します。実際のマイグレーション事例によると、これまで42秒かかっていた全テスト実行時間がわずか11秒に短縮されるなど、開発者がローカルやCI/CDパイプラインで感じる待ち時間が劇的に減ります。\n\n安全なマイグレーションのために今準備すべきこと\n\nNestJS 12へのマイグレーションを安定して行うには、ランタイム環境とTypeScript設定をあらかじめ調整しておく必要があります。\n\nまずはサーバーが稼働するNode.jsのバージョンを更新する必要があります。コアパッケージがネイティブESMに移行しても既存のCommonJSプロジェクトとの互換性を崩さないためには、同期的なrequire(esm)機能を正式サポートするNode.js v20.19.0以降またはv22.12.0以降の環境を必ず確保してください。\n\n次の段階として、TypeScriptコンパイラの設定を変更します。tsconfig.jsonファイルでmoduleおよびmoduleResolutionオプションをいずれもNodeNextに更新し、ESMモジュールの探索規則を明確に定義します。\n\n{\n \"compilerOptions\": {\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"NodeNext\"\n }\n}\n\nNodeNext仕様を適用すると、ローカルファイルを相対パスで取得するすべてのimport文において、.js拡張子の記述が必須となります。実際のソースコードが.ts拡張子で書かれていても、ビルド後のJavaScriptファイルを基準にパスを解釈するため、事前にインポート文をすべて確認し、拡張子を追加しておくことをおすすめします。\n\n結論：マイグレーション、今すぐ適用すべきか\n\nNestJS 12は、フレームワークの足かせとなっていた古い技術的負債を整理し、エコシステムの現代化を牽引する重要なアップデートです。新規プロジェクトであったり、すでにZodやESMパッケージを積極的に活用しているなら、導入する価値は十分にあります。Rustベースの新しい開発ツールチェーンとネイティブESMの利便性をすぐに享受できるからです。\n\nただし、既存のサービスを運用中であれば、急ぐ必要はありません。実際のベンチマーク結果によると、ESM移行がもたらす劇的なランタイムの性能向上やメモリ削減効果はわずかなものです。そのため、性能改善を目的として無理にアップグレードを強行するよりも、class-validatorベースのコードを段階的に標準スキーマへ移行し、使用中のライブラリのESMサポート状況を確認しながら慎重に進めるのが賢明なマイグレーション戦略です。\n\n参考リンク\n\nbyteiota — NestJS v12 Preview: ESM, Vitest, and the End of class-validator\nBoutlet Tech — NestJS 12 ESM Migration and Standard Schema Analysis\nTrilon Consulting & InfoQ — Native Standard Schema v1.0 Validation in NestJS 12","NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다\n\nNestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다\n\nNestJS 12 프리뷰는 백엔드 개발을 번거롭게 만들던 레거시 의존성과 복잡한 빌드 설정을 대대적으로 개선하는 메이저 업데이트입니다. 코어 수준에서 Standard Schema 1.0을 지원해 class-validator 없이도 Zod나 Valibot으로 요청 데이터를 직접 검증할 수 있게 되었고, 전체 패키지가 네이티브 ESM으로 전환됩니다. 여기에 Rspack과 Vitest 같은 Rust 기반 고성능 툴체인을 기본으로 도입하면서 개발 생산성도 대폭 향상되었습니다. 백엔드 개발자의 관점에서 이번 메이저 업데이트가 어떤 문제를 해결하고 있으며, 안전하게 마이그레이션하기 위해 무엇을 준비해야 하는지 하나씩 짚어보겠습니다.\n\nStandard Schema 1.0 도입: class-validator와의 작별\n\nNestJS 12의 가장 큰 변화 중 하나는 Standard Schema 1.0 규격을 프레임워크 코어에 네이티브로 도입했다는 점입니다. 이제 라우트 핸들러의 @Body(), @Query(), @Param() 데코레이터에 Zod나 Valibot 같은 스키마를 직접 인자로 넘길 수 있습니다.\n\n과거 NestJS에서 페이로드를 검증하려면 class-validator와 class-transformer에 의존해야 했습니다. 이 방식은 데코레이터 기반으로 동적 타입을 추론하기 때문에 tsconfig.json에서 emitDecoratorMetadata 옵션을 반드시 활성화해야 했습니다. 하지만 이 옵션은 TypeScript 컴파일 타임에 무거운 연산을 요구할 뿐만 아니라 Rspack, Vite, esbuild 같은 러스트 기반 초고속 번들러들과 호환되지 않아 모던 빌드 도구 도입의 가장 큰 걸림돌이었습니다.\n\nNestJS 12는 이 문제를 해결하기 위해 내장된 StandardSchemaValidationPipe를 제공합니다. 런타임에 메타데이터 리플렉션에 의존하지 않고, 데코레이터에 직접 주입된 스키마 객체의 표준 검증 메서드를 파이프 내부에서 바로 실행하는 구조입니다. 덕분에 번거로운 컴파일러 옵션 설정이나 런타임 리플렉션 오버헤드 없이 안전하고 빠른 검증 파이프라인을 구축할 수 있습니다.\n\n기존 class-validator 방식과 NestJS 12의 Zod 기반 검증 방식을 비교하면 차이가 명확히 드러납니다.\n\n// [기존 방식] class-validator 사용 (emitDecoratorMetadata 옵션 필수)\nimport { IsString, IsEmail } from 'class-validator';\n\nexport class CreateUserDto {\n @IsString()\n name!: string;\n\n @IsEmail()\n email!: string;\n}\n\n@Post()\ncreate(@Body() createUserDto: CreateUserDto) {}\n\n// [NestJS 12 방식] Standard Schema 사용 (Zod 스키마 직접 주입)\nimport { z } from 'zod';\n\nexport const CreateUserSchema = z.object({\n name: z.string(),\n email: z.string().email(),\n});\n\n@Post()\ncreate(@Body({ schema: CreateUserSchema }) body: z.infer) {}\n\n이처럼 스키마를 컨트롤러 데코레이터에 직접 넘기기만 하면 내부적으로 StandardSchemaValidationPipe가 페이로드를 검증하고, 필요 시 StandardSchemaSerializerInterceptor가 응답 직렬화까지 처리합니다. 복잡한 외부 통합 라이브러리 없이 표준 스키마 사양을 그대로 사용할 수 있어 개발자 경험과 빌드 속도가 모두 크게 향상됩니다.\n\n네이티브 ESM 전환과 동기식 require(esm) 호환성\n\nNestJS 12의 모든 코어 패키지는 네이티브 ESM으로 전환됩니다. 그동안 백엔드 생태계에서 CommonJS와 ESM 사이의 모듈 임포트 설정은 개발자의 시간을 가장 많이 앗아가는 고질적인 문제였습니다. 이번 메이저 업데이트는 이 장벽을 허물기 위해 최신 Node.js 환경의 동기식 require(esm) 기능을 적극적으로 활용합니다.\n\n동기식 require(esm)은 Node.js v20.19.0 이상 및 v22.12.0 이상 버전에서 공식 지원되는 핵심 기능입니다. 이 기능 덕분에 기존에 CommonJS 기반으로 작성된 레거시 애플리케이션 설정을 당장 완전히 바꾸지 않고도, 네이티브 ESM으로 빌드된 NestJS 12 코어 패키지를 안전하게 불러와 호환성을 유지할 수 있습니다.\n\n실제 커뮤니티 벤치마크 결과를 살펴보면, NestJS 11 기반의 CJS 환경과 NestJS 12 네이티브 ESM 환경 사이에 콜드 스타트 시간이나 유휴 상태의 메모리 점유율(RSS) 차이는 거의 미미한 수준입니다. 결국 이번 ESM 전환의 진짜 가치는 당장의 드라마틱한 성능 향상보다는, 현대적인 ESM 전용 라이브러리들을 까다로운 설정이나 별도 래퍼 없이 즉시 프로젝트에 통합할 수 있는 개발 경험의 개선에 있습니다.\n\nRspack과 Vitest, oxlint를 아우르는 초고속 Rust 툴체인\n\nNestJS 12는 개발 피드백 루프를 극적으로 단축하기 위해 Rust 기반의 현대적인 개발 도구를 대거 채택했습니다. 이 새로운 빌드 및 테스트 시스템은 CLI 명령어로 생성하는 신규 네이티브 ESM 프로젝트 템플릿에 기본으로 적용됩니다. 기존 CommonJS 프로젝트와의 생태계 안정성을 고려하여, CJS 기반 템플릿은 기존 Webpack과 Jest, ESLint 구성을 그대로 유지합니다.\n\n가장 먼저 눈에 띄는 변화는 오랜 기간 기본 번들러로 활약한 Webpack이 Rust 기반의 초고속 번들러인 Rspack으로 대체되었다는 점입니다. 빌드 성능이 수배 이상 빨라져 로컬 개발 서버 기동과 프로덕션 빌드 속도가 획기적으로 개선됩니다. 여기에 코드 분석 도구 역시 무거운 ESLint 대신 Rust로 작성되어 압도적인 파싱 속도를 자랑하는 oxlint를 채택하여 저장 시 코드 분석 대기 시간을 최소화했습니다.\n\n테스트 환경에도 큰 변화가 있습니다. ESM 환경에서 설정이 까다롭고 무거웠던 Jest 대신 Vitest가 새로운 기본 테스트 러너로 들어옵니다. 특히 이 Vitest는 초고속 구문 분석 엔진인 OXC를 탑재하여 NestJS의 복잡한 데코레이터를 신속하게 처리합니다. 실제 마이그레이션 사례에 따르면 기존에 42초가 소요되던 전체 테스트 실행 시간이 단 11초로 감소하는 등, 개발자가 로컬과 CI/CD 파이프라인에서 느끼는 대기 시간이 압도적으로 줄어듭니다.\n\n안전한 마이그레이션을 위해 지금 준비해야 할 일\n\nNestJS 12 마이그레이션을 안정적으로 진행하려면 런타임 환경과 타입스크립트 설정을 미리 조율해 두어야 합니다.\n\n가장 먼저 서버가 구동되는 Node.js 버전을 업데이트해야 합니다. 코어 패키지가 네이티브 ESM으로 전환되더라도 기존 CommonJS 프로젝트와의 호환성을 무너뜨리지 않으려면, 동기식 require(esm) 기능을 정식 지원하는 Node.js v20.19.0 이상 또는 v22.12.0 이상 환경이 반드시 확보되어야 합니다.\n\n그 다음 단계로 타입스크립트 컴파일러 설정을 변경합니다. tsconfig.json 파일에서 module과 moduleResolution 옵션을 모두 NodeNext로 업데이트하여 ESM 모듈 탐색 규칙을 명확히 정의해야 합니다.\n\n{\n \"compilerOptions\": {\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"NodeNext\"\n }\n}\n\nNodeNext 규격을 적용하면 로컬 파일을 상대 경로로 가져오는 모든 import 구문에 .js 확장자를 필수적으로 명시해야 합니다. 실제 개발 소스 파일이 .ts 확장자로 작성되어 있더라도, 빌드 후 실행되는 자바스크립트 결과물을 기준으로 경로를 해석하기 때문에 사전에 임포트 구문을 전수 검토하고 확장자를 추가해 두는 것이 좋습니다.\n\n결론: 마이그레이션, 지금 바로 적용할 것인가\n\nNestJS 12는 프레임워크 발목을 잡던 오래된 기술 부채를 정리하고 생태계 현대화를 이끄는 중요한 업데이트입니다. 새로 시작하는 프로젝트이거나 이미 Zod나 ESM 패키지를 적극적으로 사용하고 있다면 도입할 가치가 충분합니다. Rust 기반의 새로운 개발 툴체인과 네이티브 ESM의 편리함을 즉시 누릴 수 있기 때문입니다.\n\n다만 기존 서비스를 운영 중이라면 서두를 필요는 없습니다. 실제 벤치마크 결과에 따르면 ESM 전환이 가져오는 극적인 런타임 성능 향상이나 메모리 절감 효과는 미미합니다. 따라서 성능 개선을 목적으로 무리하게 업그레이드를 감행하기보다는, class-validator 기반 코드를 점진적으로 표준 스키마로 전환하고 사용 중인 라이브러리의 ESM 지원 여부를 검토하며 차근차근 진행하는 것이 현명한 마이그레이션 전략입니다.\n\n참고 링크\n\nbyteiota — NestJS v12 Preview: ESM, Vitest, and the End of class-validator\nBoutlet Tech — NestJS 12 ESM Migration and Standard Schema Analysis\nTrilon Consulting & InfoQ — Native Standard Schema v1.0 Validation in NestJS 12",{"_1892":12433,"_1893":12434,"_1802":12435},"NestJS 12 Preview — Ditching class-validator for Zod The NestJS 12 preview is a major update that fundamentally addresses the legacy dependencies and complex build configurations that have hampered backend development. B…","NestJS 12プレビュー — class-validatorを廃止し、Zodへ完全移行 NestJS 12プレビューは、バックエンド開発の負担となっていたレガシーな依存関係と複雑なビルド設定を大幅に改善するメジャーアップデートです。コアレベルでStandard Schema 1.0をサポートしたことで、class-validatorなしでZodやValibotによるリクエストデータの直接検証が可能になり、パッケージ全体もネイティブE…","NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다 NestJS 12 프리뷰는 백엔드 개발을 번거롭게 만들던 레거시 의존성과 복잡한 빌드 설정을 대대적으로 개선하는 메이저 업데이트입니다. 코어 수준에서 Standard Schema 1.0을 지원해 class-validator 없이도 Zod나 Valibot으로 요청 데이터를 직접 검증할 수 있게 되었고, 전체 패키…","cmrxg2vuv053210mu2lz1l4m6",[6733],[7581,7578,8537,12439,12440,12441],"zod","rspack","vitest",[],"2026-07-23T16:57:12.072Z","2026-07-23T11:19:48.059Z","2026-07-23T16:58:04.795Z","2026-07-23T16:58:04.765Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":12448},{"_1901":12449},{"_1903":12450,"_1908":1909,"_1910":12451,"_1921":12452,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":12453,"_1928":12454,"_1933":12455,"_1938":12456},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":12458,"_1883":1884,"_1200":1204,"_1899":12461},{"_633":12459,"_11":12460},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":12462},{"_1903":12463,"_1908":1909,"_1910":12464,"_1921":12465,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":12466,"_1928":12467,"_1933":12468,"_1938":12469},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":12471},{"_1948":-5,"_1908":1909,"_1910":12472,"_1960":-5,"_1943":12477,"_1962":12478},{"_1912":12473,"_1914":12474,"_1952":12475,"_1810":2534,"_944":1992,"_1917":12476,"_1957":2536,"_1919":8573},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/80ab1058-f3b9-4ad8-82f4-e8c42edebae8.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/80ab1058-f3b9-4ad8-82f4-e8c42edebae8.jpg",606596,"LKQ,OAx[tQ-V-;a|ofju_N$*V@OW","2026-07-23T11:45:26.048Z",{"_1964":12479,"_1972":12483,"_1979":12487,"_1986":-5},{"_1912":12480,"_1914":12481,"_1952":12482,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/large.webp",23176,{"_1912":12484,"_1914":12485,"_1952":12486,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/small.webp",5752,{"_1912":12488,"_1914":12489,"_1952":12490,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrxg2vuv053210mu2lz1l4m6/medium.webp",12110,{"_950":12492,"_2559":12414,"_2560":12493,"_2716":12851,"_2788":12965,"_2790":12966,"_2792":12967,"_2794":1997,"_2003":12968,"_2480":12969,"_2797":-5},"cmrxf5xls052j10mu7mdg37wb",{"_918":12494,"_1908":1909},[12495,12497,12500,12504,12507,12512,12515,12520,12523,12541,12544,12567,12570,12580,12583,12592,12595,12598,12601,12604,12607,12621,12624,12629,12632,12641,12644,12663,12666,12671,12674,12679,12682,12687,12690,12695,12698,12703,12706,12711,12714,12719,12722,12731,12734,12754,12757,12760,12763,12784,12787,12792,12795,12800,12803,12808,12811,12813,12816,12821,12824],{"_950":12496,"_2565":12427,"_2420":2566,"_2567":12436},"3c9f63b3-3c74-4828-8875-42e7cc242fa4",{"_950":12498,"_2420":2570,"_2571":12499},"5320b4ff-17a9-4e60-9709-113e3e5b2c56",[],{"_950":12501,"_2420":2575,"_2576":1909,"_2571":12502},"2f423ece-4768-4815-9a81-9ed3eb1068b8",[12503],{"_2579":12427,"_2420":2579},{"_950":12505,"_2420":2570,"_2571":12506},"5443b660-eb83-49e1-9d99-ae233a14d70d",[],{"_950":12508,"_2420":2570,"_2571":12509},"43c3187c-da8a-4ecc-b5a2-3cd430600cf7",[12510],{"_2579":12511,"_2420":2579},"NestJS 12 프리뷰는 백엔드 개발을 번거롭게 만들던 레거시 의존성과 복잡한 빌드 설정을 대대적으로 개선하는 메이저 업데이트입니다. 코어 수준에서 Standard Schema 1.0을 지원해 class-validator 없이도 Zod나 Valibot으로 요청 데이터를 직접 검증할 수 있게 되었고, 전체 패키지가 네이티브 ESM으로 전환됩니다. 여기에 Rspack과 Vitest 같은 Rust 기반 고성능 툴체인을 기본으로 도입하면서 개발 생산성도 대폭 향상되었습니다. 백엔드 개발자의 관점에서 이번 메이저 업데이트가 어떤 문제를 해결하고 있으며, 안전하게 마이그레이션하기 위해 무엇을 준비해야 하는지 하나씩 짚어보겠습니다.",{"_950":12513,"_2420":2570,"_2571":12514},"8d47208e-b270-499e-89ad-fdd861aa6583",[],{"_950":12516,"_2420":2575,"_2576":2007,"_2571":12517},"6ebe064f-223a-48d5-a20e-9bc4abc87ab7",[12518],{"_2579":12519,"_2420":2579},"Standard Schema 1.0 도입: class-validator와의 작별",{"_950":12521,"_2420":2570,"_2571":12522},"222fd12e-97da-48c0-a7e0-af0245d433ad",[],{"_950":12524,"_2420":2570,"_2571":12525},"bade51d2-2c9a-43a5-9444-addccf520297",[12526,12528,12531,12532,12535,12536,12539],{"_2579":12527,"_2420":2579},"NestJS 12의 가장 큰 변화 중 하나는 Standard Schema 1.0 규격을 프레임워크 코어에 네이티브로 도입했다는 점입니다. 이제 라우트 핸들러의 ",{"_2579":12529,"_2420":2579,"_3365":12530},"@Body()",{"_3351":3367},{"_2579":10378,"_2420":2579},{"_2579":12533,"_2420":2579,"_3365":12534},"@Query()",{"_3351":3367},{"_2579":10378,"_2420":2579},{"_2579":12537,"_2420":2579,"_3365":12538},"@Param()",{"_3351":3367},{"_2579":12540,"_2420":2579}," 데코레이터에 Zod나 Valibot 같은 스키마를 직접 인자로 넘길 수 있습니다.",{"_950":12542,"_2420":2570,"_2571":12543},"7d9deb09-4e8a-4d31-bc23-4d20583b5c66",[],{"_950":12545,"_2420":2570,"_2571":12546},"f3b85e51-4519-4369-ac97-f7fcf76203a0",[12547,12549,12552,12553,12556,12558,12560,12562,12565],{"_2579":12548,"_2420":2579},"과거 NestJS에서 페이로드를 검증하려면 ",{"_2579":12550,"_2420":2579,"_3365":12551},"class-validator",{"_3351":3367},{"_2579":5185,"_2420":2579},{"_2579":12554,"_2420":2579,"_3365":12555},"class-transformer",{"_3351":3367},{"_2579":12557,"_2420":2579},"에 의존해야 했습니다. 이 방식은 데코레이터 기반으로 동적 타입을 추론하기 때문에 ",{"_2579":7777,"_2420":2579,"_3365":12559},{"_3351":3367},{"_2579":12561,"_2420":2579},"에서 ",{"_2579":12563,"_2420":2579,"_3365":12564},"emitDecoratorMetadata",{"_3351":3367},{"_2579":12566,"_2420":2579}," 옵션을 반드시 활성화해야 했습니다. 하지만 이 옵션은 TypeScript 컴파일 타임에 무거운 연산을 요구할 뿐만 아니라 Rspack, Vite, esbuild 같은 러스트 기반 초고속 번들러들과 호환되지 않아 모던 빌드 도구 도입의 가장 큰 걸림돌이었습니다.",{"_950":12568,"_2420":2570,"_2571":12569},"d0379e84-71e2-43ca-8e6e-4bcd0dfa46be",[],{"_950":12571,"_2420":2570,"_2571":12572},"548d84af-7689-423e-bb07-52dd8772943e",[12573,12575,12578],{"_2579":12574,"_2420":2579},"NestJS 12는 이 문제를 해결하기 위해 내장된 ",{"_2579":12576,"_2420":2579,"_3365":12577},"StandardSchemaValidationPipe",{"_3351":3367},{"_2579":12579,"_2420":2579},"를 제공합니다. 런타임에 메타데이터 리플렉션에 의존하지 않고, 데코레이터에 직접 주입된 스키마 객체의 표준 검증 메서드를 파이프 내부에서 바로 실행하는 구조입니다. 덕분에 번거로운 컴파일러 옵션 설정이나 런타임 리플렉션 오버헤드 없이 안전하고 빠른 검증 파이프라인을 구축할 수 있습니다.",{"_950":12581,"_2420":2570,"_2571":12582},"57fb6f96-9386-48ad-9d92-699af03455fe",[],{"_950":12584,"_2420":2570,"_2571":12585},"7d2a7f47-0e04-491a-a7b4-19139c85cc44",[12586,12588,12590],{"_2579":12587,"_2420":2579},"기존 ",{"_2579":12550,"_2420":2579,"_3365":12589},{"_3351":3367},{"_2579":12591,"_2420":2579}," 방식과 NestJS 12의 Zod 기반 검증 방식을 비교하면 차이가 명확히 드러납니다.",{"_950":12593,"_2420":2570,"_2571":12594},"a07906d0-6285-4853-ab0b-d6297a7eb4ec",[],{"_950":12596,"_3351":12597,"_2420":3351,"_625":3125},"94b82d2e-dcfb-4a63-b328-74169a0eff3e","// [기존 방식] class-validator 사용 (emitDecoratorMetadata 옵션 필수)\nimport { IsString, IsEmail } from 'class-validator';\n\nexport class CreateUserDto {\n @IsString()\n name!: string;\n\n @IsEmail()\n email!: string;\n}\n\n@Post()\ncreate(@Body() createUserDto: CreateUserDto) {}",{"_950":12599,"_2420":2570,"_2571":12600},"c8b68364-74ee-4789-a087-b4a241b7e43e",[],{"_950":12602,"_3351":12603,"_2420":3351,"_625":3125},"fbaa2965-3b85-4e1e-8538-e85a31f0dfec","// [NestJS 12 방식] Standard Schema 사용 (Zod 스키마 직접 주입)\nimport { z } from 'zod';\n\nexport const CreateUserSchema = z.object({\n name: z.string(),\n email: z.string().email(),\n});\n\n@Post()\ncreate(@Body({ schema: CreateUserSchema }) body: z.infer) {}",{"_950":12605,"_2420":2570,"_2571":12606},"95504cd7-9092-4d5c-81f0-5d5a46b7a045",[],{"_950":12608,"_2420":2570,"_2571":12609},"fba8c9a8-7a02-4b9b-b3bd-73f60e4e8c0f",[12610,12612,12614,12616,12619],{"_2579":12611,"_2420":2579},"이처럼 스키마를 컨트롤러 데코레이터에 직접 넘기기만 하면 내부적으로 ",{"_2579":12576,"_2420":2579,"_3365":12613},{"_3351":3367},{"_2579":12615,"_2420":2579},"가 페이로드를 검증하고, 필요 시 ",{"_2579":12617,"_2420":2579,"_3365":12618},"StandardSchemaSerializerInterceptor",{"_3351":3367},{"_2579":12620,"_2420":2579},"가 응답 직렬화까지 처리합니다. 복잡한 외부 통합 라이브러리 없이 표준 스키마 사양을 그대로 사용할 수 있어 개발자 경험과 빌드 속도가 모두 크게 향상됩니다.",{"_950":12622,"_2420":2570,"_2571":12623},"51ec6add-e5c6-4f2d-a05d-0de7cdaf29c8",[],{"_950":12625,"_2420":2575,"_2576":2007,"_2571":12626},"c3273301-0837-4641-9ed5-d08539f7eff7",[12627],{"_2579":12628,"_2420":2579},"네이티브 ESM 전환과 동기식 require(esm) 호환성",{"_950":12630,"_2420":2570,"_2571":12631},"1bb69efa-2421-4d3a-ba96-8301e070194c",[],{"_950":12633,"_2420":2570,"_2571":12634},"0c61e8a5-e542-4692-8e10-cc44687e9432",[12635,12637,12639],{"_2579":12636,"_2420":2579},"NestJS 12의 모든 코어 패키지는 네이티브 ESM으로 전환됩니다. 그동안 백엔드 생태계에서 CommonJS와 ESM 사이의 모듈 임포트 설정은 개발자의 시간을 가장 많이 앗아가는 고질적인 문제였습니다. 이번 메이저 업데이트는 이 장벽을 허물기 위해 최신 Node.js 환경의 동기식 ",{"_2579":7764,"_2420":2579,"_3365":12638},{"_3351":3367},{"_2579":12640,"_2420":2579}," 기능을 적극적으로 활용합니다.",{"_950":12642,"_2420":2570,"_2571":12643},"844f824d-3fe4-48e7-811b-978d9f1e9847",[],{"_950":12645,"_2420":2570,"_2571":12646},"a70ee646-c81c-430b-a439-8b81977232e3",[12647,12649,12651,12653,12656,12658,12661],{"_2579":12648,"_2420":2579},"동기식 ",{"_2579":7764,"_2420":2579,"_3365":12650},{"_3351":3367},{"_2579":12652,"_2420":2579},"은 ",{"_2579":12654,"_2420":2579,"_3365":12655},"Node.js v20.19.0 이상",{"_3485":3367},{"_2579":12657,"_2420":2579}," 및 ",{"_2579":12659,"_2420":2579,"_3365":12660},"v22.12.0 이상",{"_3485":3367},{"_2579":12662,"_2420":2579}," 버전에서 공식 지원되는 핵심 기능입니다. 이 기능 덕분에 기존에 CommonJS 기반으로 작성된 레거시 애플리케이션 설정을 당장 완전히 바꾸지 않고도, 네이티브 ESM으로 빌드된 NestJS 12 코어 패키지를 안전하게 불러와 호환성을 유지할 수 있습니다.",{"_950":12664,"_2420":2570,"_2571":12665},"51d08f51-d712-42d4-89fe-1f30431af975",[],{"_950":12667,"_2420":2570,"_2571":12668},"f6b879d7-9f4a-416a-b9d1-74fdc678e5a3",[12669],{"_2579":12670,"_2420":2579},"실제 커뮤니티 벤치마크 결과를 살펴보면, NestJS 11 기반의 CJS 환경과 NestJS 12 네이티브 ESM 환경 사이에 콜드 스타트 시간이나 유휴 상태의 메모리 점유율(RSS) 차이는 거의 미미한 수준입니다. 결국 이번 ESM 전환의 진짜 가치는 당장의 드라마틱한 성능 향상보다는, 현대적인 ESM 전용 라이브러리들을 까다로운 설정이나 별도 래퍼 없이 즉시 프로젝트에 통합할 수 있는 개발 경험의 개선에 있습니다.",{"_950":12672,"_2420":2570,"_2571":12673},"5efbc071-09c7-42a9-86dc-f31e4a521222",[],{"_950":12675,"_2420":2575,"_2576":2007,"_2571":12676},"a514a11c-acdc-4a24-a927-678102fc8b4f",[12677],{"_2579":12678,"_2420":2579},"Rspack과 Vitest, oxlint를 아우르는 초고속 Rust 툴체인",{"_950":12680,"_2420":2570,"_2571":12681},"dc0e292d-8928-45d2-9a18-0f873185492f",[],{"_950":12683,"_2420":2570,"_2571":12684},"2fe9ba62-914b-40cb-89c4-4103f8175426",[12685],{"_2579":12686,"_2420":2579},"NestJS 12는 개발 피드백 루프를 극적으로 단축하기 위해 Rust 기반의 현대적인 개발 도구를 대거 채택했습니다. 이 새로운 빌드 및 테스트 시스템은 CLI 명령어로 생성하는 신규 네이티브 ESM 프로젝트 템플릿에 기본으로 적용됩니다. 기존 CommonJS 프로젝트와의 생태계 안정성을 고려하여, CJS 기반 템플릿은 기존 Webpack과 Jest, ESLint 구성을 그대로 유지합니다.",{"_950":12688,"_2420":2570,"_2571":12689},"78888119-5024-4e6b-b7b0-4705b5e40f3d",[],{"_950":12691,"_2420":2570,"_2571":12692},"cd4dc46f-d963-4ffd-8ade-35986b0cd4b8",[12693],{"_2579":12694,"_2420":2579},"가장 먼저 눈에 띄는 변화는 오랜 기간 기본 번들러로 활약한 Webpack이 Rust 기반의 초고속 번들러인 Rspack으로 대체되었다는 점입니다. 빌드 성능이 수배 이상 빨라져 로컬 개발 서버 기동과 프로덕션 빌드 속도가 획기적으로 개선됩니다. 여기에 코드 분석 도구 역시 무거운 ESLint 대신 Rust로 작성되어 압도적인 파싱 속도를 자랑하는 oxlint를 채택하여 저장 시 코드 분석 대기 시간을 최소화했습니다.",{"_950":12696,"_2420":2570,"_2571":12697},"0171b8f7-78f5-4be4-b12b-f5b726a42904",[],{"_950":12699,"_2420":2570,"_2571":12700},"af5453a5-98c3-4c6d-a7d4-41153936c958",[12701],{"_2579":12702,"_2420":2579},"테스트 환경에도 큰 변화가 있습니다. ESM 환경에서 설정이 까다롭고 무거웠던 Jest 대신 Vitest가 새로운 기본 테스트 러너로 들어옵니다. 특히 이 Vitest는 초고속 구문 분석 엔진인 OXC를 탑재하여 NestJS의 복잡한 데코레이터를 신속하게 처리합니다. 실제 마이그레이션 사례에 따르면 기존에 42초가 소요되던 전체 테스트 실행 시간이 단 11초로 감소하는 등, 개발자가 로컬과 CI/CD 파이프라인에서 느끼는 대기 시간이 압도적으로 줄어듭니다.",{"_950":12704,"_2420":2570,"_2571":12705},"1271f32b-cae3-4e2f-b9c3-521179adc4da",[],{"_950":12707,"_2420":2575,"_2576":2007,"_2571":12708},"86cd17fd-a2b1-4bc5-a8f6-e9c9513eeb35",[12709],{"_2579":12710,"_2420":2579},"안전한 마이그레이션을 위해 지금 준비해야 할 일",{"_950":12712,"_2420":2570,"_2571":12713},"945af6b6-3e56-44c5-a5a6-c4d31cf27ded",[],{"_950":12715,"_2420":2570,"_2571":12716},"88fca624-7681-4f96-869c-4243ed580f34",[12717],{"_2579":12718,"_2420":2579},"NestJS 12 마이그레이션을 안정적으로 진행하려면 런타임 환경과 타입스크립트 설정을 미리 조율해 두어야 합니다.",{"_950":12720,"_2420":2570,"_2571":12721},"0764ffee-a9f0-4868-b7c5-5d8aab687152",[],{"_950":12723,"_2420":2570,"_2571":12724},"ba1c3c8e-d0d5-4a97-bd73-f65d997fb6fa",[12725,12727,12729],{"_2579":12726,"_2420":2579},"가장 먼저 서버가 구동되는 Node.js 버전을 업데이트해야 합니다. 코어 패키지가 네이티브 ESM으로 전환되더라도 기존 CommonJS 프로젝트와의 호환성을 무너뜨리지 않으려면, 동기식 ",{"_2579":7764,"_2420":2579,"_3365":12728},{"_3351":3367},{"_2579":12730,"_2420":2579}," 기능을 정식 지원하는 Node.js v20.19.0 이상 또는 v22.12.0 이상 환경이 반드시 확보되어야 합니다.",{"_950":12732,"_2420":2570,"_2571":12733},"04b8fd1c-8957-4401-839f-9bbe8a2291bd",[],{"_950":12735,"_2420":2570,"_2571":12736},"c1943147-3742-4421-9d33-78f678eddabd",[12737,12739,12741,12743,12745,12746,12748,12750,12752],{"_2579":12738,"_2420":2579},"그 다음 단계로 타입스크립트 컴파일러 설정을 변경합니다. ",{"_2579":7777,"_2420":2579,"_3365":12740},{"_3351":3367},{"_2579":12742,"_2420":2579}," 파일에서 ",{"_2579":7810,"_2420":2579,"_3365":12744},{"_3351":3367},{"_2579":7813,"_2420":2579},{"_2579":7815,"_2420":2579,"_3365":12747},{"_3351":3367},{"_2579":12749,"_2420":2579}," 옵션을 모두 ",{"_2579":7820,"_2420":2579,"_3365":12751},{"_3351":3367},{"_2579":12753,"_2420":2579},"로 업데이트하여 ESM 모듈 탐색 규칙을 명확히 정의해야 합니다.",{"_950":12755,"_2420":2570,"_2571":12756},"ccf1979e-c20d-4413-889b-8505d8a4174c",[],{"_950":12758,"_3351":12759,"_2420":3351,"_625":4704},"6c608a13-f3dd-41b2-9994-2cd982821a80","{\n \"compilerOptions\": {\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"NodeNext\"\n }\n}",{"_950":12761,"_2420":2570,"_2571":12762},"1379eec0-aaff-49d6-8243-f4652e24c0b8",[],{"_950":12764,"_2420":2570,"_2571":12765},"29d7c77a-4e6a-4046-af1a-2a762d48898e",[12766,12768,12770,12773,12775,12777,12779,12782],{"_2579":7820,"_2420":2579,"_3365":12767},{"_3351":3367},{"_2579":12769,"_2420":2579}," 규격을 적용하면 로컬 파일을 상대 경로로 가져오는 모든 ",{"_2579":12771,"_2420":2579,"_3365":12772},"import",{"_3351":3367},{"_2579":12774,"_2420":2579}," 구문에 ",{"_2579":7825,"_2420":2579,"_3365":12776},{"_3351":3367},{"_2579":12778,"_2420":2579}," 확장자를 필수적으로 명시해야 합니다. 실제 개발 소스 파일이 ",{"_2579":12780,"_2420":2579,"_3365":12781},".ts",{"_3351":3367},{"_2579":12783,"_2420":2579}," 확장자로 작성되어 있더라도, 빌드 후 실행되는 자바스크립트 결과물을 기준으로 경로를 해석하기 때문에 사전에 임포트 구문을 전수 검토하고 확장자를 추가해 두는 것이 좋습니다.",{"_950":12785,"_2420":2570,"_2571":12786},"a3796f09-a591-4d0c-b5b5-bd9414044f7b",[],{"_950":12788,"_2420":2575,"_2576":2007,"_2571":12789},"64ab3147-6d8d-4f8f-9869-d179679a070b",[12790],{"_2579":12791,"_2420":2579},"결론: 마이그레이션, 지금 바로 적용할 것인가",{"_950":12793,"_2420":2570,"_2571":12794},"75967edf-4875-4e05-8eb0-76387e31c135",[],{"_950":12796,"_2420":2570,"_2571":12797},"7e9da94a-41e9-4b97-b8ac-0c29a7468120",[12798],{"_2579":12799,"_2420":2579},"NestJS 12는 프레임워크 발목을 잡던 오래된 기술 부채를 정리하고 생태계 현대화를 이끄는 중요한 업데이트입니다. 새로 시작하는 프로젝트이거나 이미 Zod나 ESM 패키지를 적극적으로 사용하고 있다면 도입할 가치가 충분합니다. Rust 기반의 새로운 개발 툴체인과 네이티브 ESM의 편리함을 즉시 누릴 수 있기 때문입니다.",{"_950":12801,"_2420":2570,"_2571":12802},"058cc63c-8d42-4a2c-bffa-aa242517f671",[],{"_950":12804,"_2420":2570,"_2571":12805},"8a555fa0-2b98-499a-a783-8f3ed9102343",[12806],{"_2579":12807,"_2420":2579},"다만 기존 서비스를 운영 중이라면 서두를 필요는 없습니다. 실제 벤치마크 결과에 따르면 ESM 전환이 가져오는 극적인 런타임 성능 향상이나 메모리 절감 효과는 미미합니다. 따라서 성능 개선을 목적으로 무리하게 업그레이드를 감행하기보다는, class-validator 기반 코드를 점진적으로 표준 스키마로 전환하고 사용 중인 라이브러리의 ESM 지원 여부를 검토하며 차근차근 진행하는 것이 현명한 마이그레이션 전략입니다.",{"_950":12809,"_2420":2570,"_2571":12810},"de2b5254-687c-4cb8-91e1-1d9623d537a4",[],{"_950":12812,"_2420":3473},"a8b67a19-3acf-4573-841a-baaba99b5767",{"_950":12814,"_2420":2570,"_2571":12815},"43f5ace8-bbdd-49d1-9a76-65b011e2ea2c",[],{"_950":12817,"_2420":2570,"_2571":12818},"2da882b7-a6fd-4555-8795-02d2cc06cc70",[12819],{"_2579":3483,"_2420":2579,"_3365":12820},{"_3485":3367},{"_950":12822,"_2420":2570,"_2571":12823},"1391ecdc-8d84-4ed1-89a3-5c89b9eaa871",[],{"_950":12825,"_1881":3492,"_2420":3493,"_778":12826},"696b7618-c7fe-497b-87c0-9d303f5b9a14",[12827,12835,12843],{"_950":12828,"_2571":12829},"b1a309e5-f21c-438c-88a1-834621e001c7",[12830],{"_3499":12831,"_2420":3501,"_3502":12832},"https://byteiota.com/nestjs-v12-preview-esm-vitest-class-validator",[12833],{"_2579":12834,"_2420":2579},"byteiota — NestJS v12 Preview: ESM, Vitest, and the End of class-validator",{"_950":12836,"_2571":12837},"333411a6-39db-4f1d-b3ed-cb959cdf8b46",[12838],{"_3499":12839,"_2420":3501,"_3502":12840},"https://boutlet.com/nestjs-12-esm-standard-schema",[12841],{"_2579":12842,"_2420":2579},"Boutlet Tech — NestJS 12 ESM Migration and Standard Schema Analysis",{"_950":12844,"_2571":12845},"b5e0f7b4-0841-4356-9bfb-ad9bd909474f",[12846],{"_3499":12847,"_2420":3501,"_3502":12848},"https://www.infoq.com/news/2026/04/nestjs-v12-esm-migration/",[12849],{"_2579":12850,"_2420":2579},"Trilon Consulting & InfoQ — Native Standard Schema v1.0 Validation in NestJS 12",{"_12633":12852,"_12764":12857,"_12817":12862,"_12501":12864,"_12683":12866,"_12508":12870,"_12571":12874,"_12788":12879,"_12825":12883,"_12516":12890,"_12584":12894,"_12796":12899,"_12707":12903,"_12715":12907,"_12804":12911,"_12675":12915,"_12645":12919,"_12699":12924,"_12723":12928,"_12524":12933,"_12735":12938,"_12625":12943,"_12691":12947,"_12545":12951,"_12667":12956,"_12608":12960},{"_2571":12853},{"_1892":12854,"_1893":12855,"_1802":12856},"All core NestJS 12 packages are shifting to native ESM. Until now, managing module import configurations between CommonJS and ESM has been a chronic issue consuming developer time. This update addresses that barrier by leveraging the synchronous require(esm) feature in modern Node.js environments.","NestJS 12のすべてのコアパッケージはネイティブESMに移行します。これまでバックエンドエコシステムにおいて、CommonJSとESMの間のモジュールインポート設定は、開発者の時間を奪う根深い問題でした。今回のメジャーアップデートでは、この壁を打ち破るために最新のNode.js環境の同期的なrequire(esm)機能を積極的に活用します。","NestJS 12의 모든 코어 패키지는 네이티브 ESM으로 전환됩니다. 그동안 백엔드 생태계에서 CommonJS와 ESM 사이의 모듈 임포트 설정은 개발자의 시간을 가장 많이 앗아가는 고질적인 문제였습니다. 이번 메이저 업데이트는 이 장벽을 허물기 위해 최신 Node.js 환경의 동기식 require(esm) 기능을 적극적으로 활용합니다.",{"_2571":12858},{"_1892":12859,"_1893":12860,"_1802":12861},"Applying the NodeNext standard requires that you include the .js extension in all import statements that reference local files with relative paths. Since paths are interpreted based on the resulting JavaScript output rather than the .ts source files, it is recommended to review all imports and add the necessary extensions beforehand.","NodeNext仕様を適用すると、ローカルファイルを相対パスで取得するすべてのimport文において、.js拡張子の記述が必須となります。実際のソースコードが.ts拡張子で書かれていても、ビルド後のJavaScriptファイルを基準にパスを解釈するため、事前にインポート文をすべて確認し、拡張子を追加しておくことをおすすめします。","NodeNext 규격을 적용하면 로컬 파일을 상대 경로로 가져오는 모든 import 구문에 .js 확장자를 필수적으로 명시해야 합니다. 실제 개발 소스 파일이 .ts 확장자로 작성되어 있더라도, 빌드 후 실행되는 자바스크립트 결과물을 기준으로 경로를 해석하기 때문에 사전에 임포트 구문을 전수 검토하고 확장자를 추가해 두는 것이 좋습니다.",{"_2571":12863},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":12865},{"_1892":12425,"_1893":12426,"_1802":12427},{"_2571":12867},{"_1892":12868,"_1893":12869,"_1802":12686},"NestJS 12 adopts a suite of modern Rust-based development tools to dramatically shorten the feedback loop. These new build and test systems are applied by default to new native ESM project templates generated via CLI. To maintain ecosystem stability, CJS-based templates will continue to use the existing Webpack, Jest, and ESLint configurations.","NestJS 12は開発フィードバックループを劇的に短縮するため、Rustベースの現代的な開発ツールを多数採用しました。この新しいビルドおよびテストシステムは、CLIコマンドで作成する新規ネイティブESMプロジェクトテンプレートにデフォルトで適用されます。既存のCommonJSプロジェクトとのエコシステムの安定性を考慮し、CJSベースのテンプレートは従来のWebpack、Jest、ESLint構成を維持します。",{"_2571":12871},{"_1892":12872,"_1893":12873,"_1802":12511},"The NestJS 12 preview is a major update that fundamentally addresses the legacy dependencies and complex build configurations that have hampered backend development. By supporting Standard Schema 1.0 at the core, it allows you to validate request data directly with Zod or Valibot, bypassing the need for class-validator, and the entire package is shifting to native ESM. In addition, the introduction of Rust-based high-performance toolchains like Rspack and Vitest significantly boosts developer productivity. From a backend developer’s perspective, let’s explore the problems this major update resolves and how to prepare for a safe migration.","NestJS 12プレビューは、バックエンド開発の負担となっていたレガシーな依存関係と複雑なビルド設定を大幅に改善するメジャーアップデートです。コアレベルでStandard Schema 1.0をサポートしたことで、class-validatorなしでZodやValibotによるリクエストデータの直接検証が可能になり、パッケージ全体もネイティブESMへ移行します。さらに、RspackやVitestといったRustベースの高性能ツールチェーンを標準採用し、開発生産性も劇的に向上しました。バックエンド開発者の視点から、今回のメジャーアップデートがどのような問題を解決し、安全なマイグレーションのために何を備えるべきか、一つずつ見ていきましょう。",{"_2571":12875},{"_1892":12876,"_1893":12877,"_1802":12878},"To solve this, NestJS 12 introduces the StandardSchemaValidationPipe. Instead of relying on metadata reflection at runtime, it executes the standard validation method of the injected schema object directly within the pipe. This allows for a safe and fast validation pipeline without cumbersome compiler settings or runtime reflection overhead.","NestJS 12ではこの問題を解決するため、組み込みのStandardSchemaValidationPipeを提供します。実行時にメタデータのリフレクションに依存せず、デコレーターに直接注入されたスキーマオブジェクトの標準検証メソッドをパイプ内部で直接実行する仕組みです。おかげで、煩雑なコンパイラ設定や実行時のリフレクションオーバーヘッドなしに、安全かつ高速な検証パイプラインを構築できます。","NestJS 12는 이 문제를 해결하기 위해 내장된 StandardSchemaValidationPipe를 제공합니다. 런타임에 메타데이터 리플렉션에 의존하지 않고, 데코레이터에 직접 주입된 스키마 객체의 표준 검증 메서드를 파이프 내부에서 바로 실행하는 구조입니다. 덕분에 번거로운 컴파일러 옵션 설정이나 런타임 리플렉션 오버헤드 없이 안전하고 빠른 검증 파이프라인을 구축할 수 있습니다.",{"_2571":12880},{"_1892":12881,"_1893":12882,"_1802":12791},"Conclusion: Should You Migrate Right Now?","結論：マイグレーション、今すぐ適用すべきか",{"_12884":12885,"_12886":12887,"_12888":12889},"item:333411a6-39db-4f1d-b3ed-cb959cdf8b46",{"_1892":12842,"_1893":12842,"_1802":12842},"item:b1a309e5-f21c-438c-88a1-834621e001c7",{"_1892":12834,"_1893":12834,"_1802":12834},"item:b5e0f7b4-0841-4356-9bfb-ad9bd909474f",{"_1892":12850,"_1893":12850,"_1802":12850},{"_2571":12891},{"_1892":12892,"_1893":12893,"_1802":12519},"Introducing Standard Schema 1.0: Saying Goodbye to class-validator","Standard Schema 1.0の導入：class-validatorとの決別",{"_2571":12895},{"_1892":12896,"_1893":12897,"_1802":12898},"Comparing the existing class-validator approach with the new NestJS 12 Zod-based validation makes the benefits clear.","従来のclass-validator方式とNestJS 12のZodベースの検証方式を比較すると、その違いは明らかです。","기존 class-validator 방식과 NestJS 12의 Zod 기반 검증 방식을 비교하면 차이가 명확히 드러납니다.",{"_2571":12900},{"_1892":12901,"_1893":12902,"_1802":12799},"NestJS 12 is a significant update that clears away technical debt and drives modernization of the ecosystem. If you are starting a new project or already actively using Zod or ESM packages, it is definitely worth adopting, as you can immediately take advantage of the new Rust-based dev toolchain and the convenience of native ESM.","NestJS 12は、フレームワークの足かせとなっていた古い技術的負債を整理し、エコシステムの現代化を牽引する重要なアップデートです。新規プロジェクトであったり、すでにZodやESMパッケージを積極的に活用しているなら、導入する価値は十分にあります。Rustベースの新しい開発ツールチェーンとネイティブESMの利便性をすぐに享受できるからです。",{"_2571":12904},{"_1892":12905,"_1893":12906,"_1802":12710},"Preparing for a Safe Migration","安全なマイグレーションのために今準備すべきこと",{"_2571":12908},{"_1892":12909,"_1893":12910,"_1802":12718},"To migrate to NestJS 12 stably, you need to coordinate your runtime environment and TypeScript settings in advance.","NestJS 12へのマイグレーションを安定して行うには、ランタイム環境とTypeScript設定をあらかじめ調整しておく必要があります。",{"_2571":12912},{"_1892":12913,"_1893":12914,"_1802":12807},"However, there is no need to rush if you are maintaining an existing service. According to actual benchmarks, the ESM transition provides only minor improvements in runtime performance or memory usage. Therefore, rather than forcing an upgrade solely for performance gains, it is a wiser strategy to gradually shift from class-validator to standard schemas and evaluate the ESM support of your current libraries before moving forward.","ただし、既存のサービスを運用中であれば、急ぐ必要はありません。実際のベンチマーク結果によると、ESM移行がもたらす劇的なランタイムの性能向上やメモリ削減効果はわずかなものです。そのため、性能改善を目的として無理にアップグレードを強行するよりも、class-validatorベースのコードを段階的に標準スキーマへ移行し、使用中のライブラリのESMサポート状況を確認しながら慎重に進めるのが賢明なマイグレーション戦略です。",{"_2571":12916},{"_1892":12917,"_1893":12918,"_1802":12678},"High-Speed Rust Toolchain: Rspack, Vitest, and oxlint","Rspack、Vitest、oxlintを網羅する超高速Rustツールチェーン",{"_2571":12920},{"_1892":12921,"_1893":12922,"_1802":12923},"Synchronous require(esm) is a core feature officially supported in Node.js v20.19.0+ and v22.12.0+. This allows you to safely load NestJS 12 core packages—which are built as native ESM—into existing CommonJS-based applications without needing an immediate or total rewrite of your project configuration.","同期的なrequire(esm)は、Node.js v20.19.0以降およびv22.12.0以降で正式サポートされる核心的な機能です。この機能のおかげで、既存のCommonJSベースで作成されたレガシーアプリケーション設定を直ちに変更せずとも、ネイティブESMでビルドされたNestJS 12コアパッケージを安全に読み込み、互換性を維持できます。","동기식 require(esm)은 Node.js v20.19.0 이상 및 v22.12.0 이상 버전에서 공식 지원되는 핵심 기능입니다. 이 기능 덕분에 기존에 CommonJS 기반으로 작성된 레거시 애플리케이션 설정을 당장 완전히 바꾸지 않고도, 네이티브 ESM으로 빌드된 NestJS 12 코어 패키지를 안전하게 불러와 호환성을 유지할 수 있습니다.",{"_2571":12925},{"_1892":12926,"_1893":12927,"_1802":12702},"The testing environment has also undergone a major shift. Vitest replaces Jest as the new default test runner, as Jest was often heavy and difficult to configure in ESM environments. Vitest is equipped with the high-speed OXC parsing engine, which quickly processes NestJS's complex decorators. According to actual migration cases, total test execution time fell from 42 seconds to just 11 seconds, drastically reducing wait times for developers in local and CI/CD pipelines.","テスト環境にも大きな変化があります。ESM環境では設定が煩雑で重かったJestに代わり、Vitestが新しい標準テストランナーとして導入されます。特にこのVitestは超高速構文解析エンジンOXCを搭載しており、NestJSの複雑なデコレーターを迅速に処理します。実際のマイグレーション事例によると、これまで42秒かかっていた全テスト実行時間がわずか11秒に短縮されるなど、開発者がローカルやCI/CDパイプラインで感じる待ち時間が劇的に減ります。",{"_2571":12929},{"_1892":12930,"_1893":12931,"_1802":12932},"First, update the Node.js version running your server. To maintain compatibility with existing CommonJS projects even while core packages move to native ESM, you must ensure an environment of Node.js v20.19.0 or higher (or v22.12.0+) to officially support the synchronous require(esm) feature.","まずはサーバーが稼働するNode.jsのバージョンを更新する必要があります。コアパッケージがネイティブESMに移行しても既存のCommonJSプロジェクトとの互換性を崩さないためには、同期的なrequire(esm)機能を正式サポートするNode.js v20.19.0以降またはv22.12.0以降の環境を必ず確保してください。","가장 먼저 서버가 구동되는 Node.js 버전을 업데이트해야 합니다. 코어 패키지가 네이티브 ESM으로 전환되더라도 기존 CommonJS 프로젝트와의 호환성을 무너뜨리지 않으려면, 동기식 require(esm) 기능을 정식 지원하는 Node.js v20.19.0 이상 또는 v22.12.0 이상 환경이 반드시 확보되어야 합니다.",{"_2571":12934},{"_1892":12935,"_1893":12936,"_1802":12937},"One of the biggest changes in NestJS 12 is the native integration of the Standard Schema 1.0 specification into the framework core. Now, you can pass schemas like Zod or Valibot directly as arguments to the @Body(), @Query(), and @Param() decorators in route handlers.","NestJS 12の最大の変更点の一つは、Standard Schema 1.0仕様をフレームワークのコアにネイティブ導入したことです。これにより、ルートハンドラーの@Body()、@Query()、@Param()デコレーターに、ZodやValibotのようなスキーマを引数として直接渡せるようになりました。","NestJS 12의 가장 큰 변화 중 하나는 Standard Schema 1.0 규격을 프레임워크 코어에 네이티브로 도입했다는 점입니다. 이제 라우트 핸들러의 @Body(), @Query(), @Param() 데코레이터에 Zod나 Valibot 같은 스키마를 직접 인자로 넘길 수 있습니다.",{"_2571":12939},{"_1892":12940,"_1893":12941,"_1802":12942},"Next, update your TypeScript compiler settings. In your tsconfig.json, update both the module and moduleResolution options to \"NodeNext\" to explicitly define ESM module resolution rules.","次の段階として、TypeScriptコンパイラの設定を変更します。tsconfig.jsonファイルでmoduleおよびmoduleResolutionオプションをいずれもNodeNextに更新し、ESMモジュールの探索規則を明確に定義します。","그 다음 단계로 타입스크립트 컴파일러 설정을 변경합니다. tsconfig.json 파일에서 module과 moduleResolution 옵션을 모두 NodeNext로 업데이트하여 ESM 모듈 탐색 규칙을 명확히 정의해야 합니다.",{"_2571":12944},{"_1892":12945,"_1893":12946,"_1802":12628},"Native ESM Transition and Synchronous require(esm) Compatibility","ネイティブESMへの移行と同期的なrequire(esm)の互換性",{"_2571":12948},{"_1892":12949,"_1893":12950,"_1802":12694},"The most noticeable change is the replacement of Webpack, which served as the default bundler for a long time, with Rspack, an ultra-fast Rust-based bundler. Build performance is several times faster, drastically improving local dev server startup and production build times. Furthermore, the code analysis tool has switched from the heavy ESLint to oxlint, which is written in Rust and boasts overwhelming parsing speeds, minimizing waiting times during code analysis upon saving.","最も目を引く変化は、長らく標準バンドラーとして活躍したWebpackが、Rustベースの超高速バンドラーであるRspackに置き換わった点です。ビルド性能が数倍以上速くなり、ローカル開発サーバーの起動とプロダクションビルドの速度が画期的に向上します。さらにコード分析ツールも、重いESLintの代わりにRustで書かれ圧倒的な解析速度を誇るoxlintを採用し、保存時のコード分析の待ち時間を最小化しました。",{"_2571":12952},{"_1892":12953,"_1893":12954,"_1802":12955},"In the past, NestJS relied on class-validator and class-transformer to validate payloads. Since this approach inferred dynamic types based on decorators, it required enabling the emitDecoratorMetadata option in tsconfig.json. However, this option not only adds heavy computation at compile time but also clashes with high-speed Rust-based bundlers like Rspack, Vite, and esbuild, acting as a major bottleneck for adopting modern build tools.","これまでのNestJSでペイロードを検証するには、class-validatorとclass-transformerへの依存が不可欠でした。この方式はデコレーターベースで動的に型を推論するため、tsconfig.jsonでemitDecoratorMetadataオプションを有効にする必要がありました。しかし、このオプションはTypeScriptのコンパイル時に重い計算を要求するだけでなく、Rspack、Vite、esbuildといったRustベースの超高速バンドラーと互換性がないため、最新のビルドツール導入における最大の障壁となっていました。","과거 NestJS에서 페이로드를 검증하려면 class-validator와 class-transformer에 의존해야 했습니다. 이 방식은 데코레이터 기반으로 동적 타입을 추론하기 때문에 tsconfig.json에서 emitDecoratorMetadata 옵션을 반드시 활성화해야 했습니다. 하지만 이 옵션은 TypeScript 컴파일 타임에 무거운 연산을 요구할 뿐만 아니라 Rspack, Vite, esbuild 같은 러스트 기반 초고속 번들러들과 호환되지 않아 모던 빌드 도구 도입의 가장 큰 걸림돌이었습니다.",{"_2571":12957},{"_1892":12958,"_1893":12959,"_1802":12670},"Community benchmarks show that the difference in cold start times or idle memory usage (RSS) between NestJS 11 (CJS) and NestJS 12 (native ESM) is negligible. Ultimately, the true value of this ESM transition lies not in a sudden, dramatic performance boost, but in the improved developer experience of being able to integrate modern ESM-only libraries into your project without complex settings or custom wrappers.","実際のコミュニティのベンチマーク結果を見ても、NestJS 11ベースのCJS環境とNestJS 12のネイティブESM環境の間で、コールドスタート時間やアイドル時のメモリ占有率（RSS）の差はほとんどありません。結局のところ、今回のESM移行の真の価値は、当面の劇的なパフォーマンス向上というよりは、現代的なESM専用ライブラリを面倒な設定やラップなしでプロジェクトに即座に統合できる、開発体験の改善にあります。",{"_2571":12961},{"_1892":12962,"_1893":12963,"_1802":12964},"Simply passing the schema to the controller decorator allows the StandardSchemaValidationPipe to handle payload validation internally, and the StandardSchemaSerializerInterceptor can handle response serialization if needed. By using standard schema specifications without complex third-party integration libraries, both developer experience and build speeds are significantly improved.","このように、スキーマをコントローラーのデコレーターに直接渡すだけで、内部的にStandardSchemaValidationPipeがペイロードを検証し、必要に応じてStandardSchemaSerializerInterceptorがレスポンスのシリアライズまで処理します。複雑な外部統合ライブラリなしで標準スキーマ仕様をそのまま使えるため、開発者体験とビルド速度の両方が大きく向上します。","이처럼 스키마를 컨트롤러 데코레이터에 직접 넘기기만 하면 내부적으로 StandardSchemaValidationPipe가 페이로드를 검증하고, 필요 시 StandardSchemaSerializerInterceptor가 응답 직렬화까지 처리합니다. 복잡한 외부 통합 라이브러리 없이 표준 스키마 사양을 그대로 사용할 수 있어 개발자 경험과 빌드 속도가 모두 크게 향상됩니다.","![NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다](file:cmrxg2vuv053210mu2lz1l4m6)\n\n# NestJS 12 프리뷰 — class-validator 버리고 Zod 바로 쓴다\n\nNestJS 12 프리뷰는 백엔드 개발을 번거롭게 만들던 레거시 의존성과 복잡한 빌드 설정을 대대적으로 개선하는 메이저 업데이트입니다. 코어 수준에서 Standard Schema 1.0을 지원해 class-validator 없이도 Zod나 Valibot으로 요청 데이터를 직접 검증할 수 있게 되었고, 전체 패키지가 네이티브 ESM으로 전환됩니다. 여기에 Rspack과 Vitest 같은 Rust 기반 고성능 툴체인을 기본으로 도입하면서 개발 생산성도 대폭 향상되었습니다. 백엔드 개발자의 관점에서 이번 메이저 업데이트가 어떤 문제를 해결하고 있으며, 안전하게 마이그레이션하기 위해 무엇을 준비해야 하는지 하나씩 짚어보겠습니다.\n\n## Standard Schema 1.0 도입: class-validator와의 작별\n\nNestJS 12의 가장 큰 변화 중 하나는 Standard Schema 1.0 규격을 프레임워크 코어에 네이티브로 도입했다는 점입니다. 이제 라우트 핸들러의 `@Body()`, `@Query()`, `@Param()` 데코레이터에 Zod나 Valibot 같은 스키마를 직접 인자로 넘길 수 있습니다.\n\n과거 NestJS에서 페이로드를 검증하려면 `class-validator`와 `class-transformer`에 의존해야 했습니다. 이 방식은 데코레이터 기반으로 동적 타입을 추론하기 때문에 `tsconfig.json`에서 `emitDecoratorMetadata` 옵션을 반드시 활성화해야 했습니다. 하지만 이 옵션은 TypeScript 컴파일 타임에 무거운 연산을 요구할 뿐만 아니라 Rspack, Vite, esbuild 같은 러스트 기반 초고속 번들러들과 호환되지 않아 모던 빌드 도구 도입의 가장 큰 걸림돌이었습니다.\n\nNestJS 12는 이 문제를 해결하기 위해 내장된 `StandardSchemaValidationPipe`를 제공합니다. 런타임에 메타데이터 리플렉션에 의존하지 않고, 데코레이터에 직접 주입된 스키마 객체의 표준 검증 메서드를 파이프 내부에서 바로 실행하는 구조입니다. 덕분에 번거로운 컴파일러 옵션 설정이나 런타임 리플렉션 오버헤드 없이 안전하고 빠른 검증 파이프라인을 구축할 수 있습니다.\n\n기존 `class-validator` 방식과 NestJS 12의 Zod 기반 검증 방식을 비교하면 차이가 명확히 드러납니다.\n\n```typescript\n// [기존 방식] class-validator 사용 (emitDecoratorMetadata 옵션 필수)\nimport { IsString, IsEmail } from 'class-validator';\n\nexport class CreateUserDto {\n @IsString()\n name!: string;\n\n @IsEmail()\n email!: string;\n}\n\n@Post()\ncreate(@Body() createUserDto: CreateUserDto) {}\n```\n\n```typescript\n// [NestJS 12 방식] Standard Schema 사용 (Zod 스키마 직접 주입)\nimport { z } from 'zod';\n\nexport const CreateUserSchema = z.object({\n name: z.string(),\n email: z.string().email(),\n});\n\n@Post()\ncreate(@Body({ schema: CreateUserSchema }) body: z.infer) {}\n```\n\n이처럼 스키마를 컨트롤러 데코레이터에 직접 넘기기만 하면 내부적으로 `StandardSchemaValidationPipe`가 페이로드를 검증하고, 필요 시 `StandardSchemaSerializerInterceptor`가 응답 직렬화까지 처리합니다. 복잡한 외부 통합 라이브러리 없이 표준 스키마 사양을 그대로 사용할 수 있어 개발자 경험과 빌드 속도가 모두 크게 향상됩니다.\n\n## 네이티브 ESM 전환과 동기식 require(esm) 호환성\n\nNestJS 12의 모든 코어 패키지는 네이티브 ESM으로 전환됩니다. 그동안 백엔드 생태계에서 CommonJS와 ESM 사이의 모듈 임포트 설정은 개발자의 시간을 가장 많이 앗아가는 고질적인 문제였습니다. 이번 메이저 업데이트는 이 장벽을 허물기 위해 최신 Node.js 환경의 동기식 `require(esm)` 기능을 적극적으로 활용합니다.\n\n동기식 `require(esm)`은 **Node.js v20.19.0 이상** 및 **v22.12.0 이상** 버전에서 공식 지원되는 핵심 기능입니다. 이 기능 덕분에 기존에 CommonJS 기반으로 작성된 레거시 애플리케이션 설정을 당장 완전히 바꾸지 않고도, 네이티브 ESM으로 빌드된 NestJS 12 코어 패키지를 안전하게 불러와 호환성을 유지할 수 있습니다.\n\n실제 커뮤니티 벤치마크 결과를 살펴보면, NestJS 11 기반의 CJS 환경과 NestJS 12 네이티브 ESM 환경 사이에 콜드 스타트 시간이나 유휴 상태의 메모리 점유율(RSS) 차이는 거의 미미한 수준입니다. 결국 이번 ESM 전환의 진짜 가치는 당장의 드라마틱한 성능 향상보다는, 현대적인 ESM 전용 라이브러리들을 까다로운 설정이나 별도 래퍼 없이 즉시 프로젝트에 통합할 수 있는 개발 경험의 개선에 있습니다.\n\n## Rspack과 Vitest, oxlint를 아우르는 초고속 Rust 툴체인\n\nNestJS 12는 개발 피드백 루프를 극적으로 단축하기 위해 Rust 기반의 현대적인 개발 도구를 대거 채택했습니다. 이 새로운 빌드 및 테스트 시스템은 CLI 명령어로 생성하는 신규 네이티브 ESM 프로젝트 템플릿에 기본으로 적용됩니다. 기존 CommonJS 프로젝트와의 생태계 안정성을 고려하여, CJS 기반 템플릿은 기존 Webpack과 Jest, ESLint 구성을 그대로 유지합니다.\n\n가장 먼저 눈에 띄는 변화는 오랜 기간 기본 번들러로 활약한 Webpack이 Rust 기반의 초고속 번들러인 Rspack으로 대체되었다는 점입니다. 빌드 성능이 수배 이상 빨라져 로컬 개발 서버 기동과 프로덕션 빌드 속도가 획기적으로 개선됩니다. 여기에 코드 분석 도구 역시 무거운 ESLint 대신 Rust로 작성되어 압도적인 파싱 속도를 자랑하는 oxlint를 채택하여 저장 시 코드 분석 대기 시간을 최소화했습니다.\n\n테스트 환경에도 큰 변화가 있습니다. ESM 환경에서 설정이 까다롭고 무거웠던 Jest 대신 Vitest가 새로운 기본 테스트 러너로 들어옵니다. 특히 이 Vitest는 초고속 구문 분석 엔진인 OXC를 탑재하여 NestJS의 복잡한 데코레이터를 신속하게 처리합니다. 실제 마이그레이션 사례에 따르면 기존에 42초가 소요되던 전체 테스트 실행 시간이 단 11초로 감소하는 등, 개발자가 로컬과 CI/CD 파이프라인에서 느끼는 대기 시간이 압도적으로 줄어듭니다.\n\n## 안전한 마이그레이션을 위해 지금 준비해야 할 일\n\nNestJS 12 마이그레이션을 안정적으로 진행하려면 런타임 환경과 타입스크립트 설정을 미리 조율해 두어야 합니다.\n\n가장 먼저 서버가 구동되는 Node.js 버전을 업데이트해야 합니다. 코어 패키지가 네이티브 ESM으로 전환되더라도 기존 CommonJS 프로젝트와의 호환성을 무너뜨리지 않으려면, 동기식 `require(esm)` 기능을 정식 지원하는 Node.js v20.19.0 이상 또는 v22.12.0 이상 환경이 반드시 확보되어야 합니다.\n\n그 다음 단계로 타입스크립트 컴파일러 설정을 변경합니다. `tsconfig.json` 파일에서 `module`과 `moduleResolution` 옵션을 모두 `NodeNext`로 업데이트하여 ESM 모듈 탐색 규칙을 명확히 정의해야 합니다.\n\n```json\n{\n \"compilerOptions\": {\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"NodeNext\"\n }\n}\n```\n\n`NodeNext` 규격을 적용하면 로컬 파일을 상대 경로로 가져오는 모든 `import` 구문에 `.js` 확장자를 필수적으로 명시해야 합니다. 실제 개발 소스 파일이 `.ts` 확장자로 작성되어 있더라도, 빌드 후 실행되는 자바스크립트 결과물을 기준으로 경로를 해석하기 때문에 사전에 임포트 구문을 전수 검토하고 확장자를 추가해 두는 것이 좋습니다.\n\n## 결론: 마이그레이션, 지금 바로 적용할 것인가\n\nNestJS 12는 프레임워크 발목을 잡던 오래된 기술 부채를 정리하고 생태계 현대화를 이끄는 중요한 업데이트입니다. 새로 시작하는 프로젝트이거나 이미 Zod나 ESM 패키지를 적극적으로 사용하고 있다면 도입할 가치가 충분합니다. Rust 기반의 새로운 개발 툴체인과 네이티브 ESM의 편리함을 즉시 누릴 수 있기 때문입니다.\n\n다만 기존 서비스를 운영 중이라면 서두를 필요는 없습니다. 실제 벤치마크 결과에 따르면 ESM 전환이 가져오는 극적인 런타임 성능 향상이나 메모리 절감 효과는 미미합니다. 따라서 성능 개선을 목적으로 무리하게 업그레이드를 감행하기보다는, class-validator 기반 코드를 점진적으로 표준 스키마로 전환하고 사용 중인 라이브러리의 ESM 지원 여부를 검토하며 차근차근 진행하는 것이 현명한 마이그레이션 전략입니다.\n\n---\n\n**참고 링크**\n\n- [byteiota — NestJS v12 Preview: ESM, Vitest, and the End of class-validator](https://byteiota.com/nestjs-v12-preview-esm-vitest-class-validator)\n- [Boutlet Tech — NestJS 12 ESM Migration and Standard Schema Analysis](https://boutlet.com/nestjs-12-esm-standard-schema)\n- [Trilon Consulting & InfoQ — Native Standard Schema v1.0 Validation in NestJS 12](https://www.infoq.com/news/2026/04/nestjs-v12-esm-migration/)","27b7040d0c53da26f60c40e6d6e1383ca7f055d886830f60c56c6f745b0a9f21",61,"2026-07-23T11:19:48.064Z","2026-07-23T16:58:04.802Z",[],[],{"_950":12973,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":12974,"_1889":12982,"_2455":-5,"_2456":-5,"_2457":-5,"_9":12986,"_2450":12994,"_2458":12995,"_2460":-5,"_723":12996,"_1886":12997,"_332":13002,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":13003,"_2003":13004,"_2480":13005,"_2482":-5,"_2483":13006,"_2485":-5,"_2486":-5,"_2487":13007,"_1144":13017,"_2527":13030,"_2555":-5,"_2556":13051,"_2798":13574,"_266":13575},"cmrvup1mv02iz10muu8u7yct4",{"_1801":1802,"_214":12975,"_2429":12976,"_2434":12979,"_2438":2439},4007,{"_1892":12977,"_1893":1997,"_1802":12978,"_2433":1997},1668,2339,{"_1892":12980,"_1893":1997,"_1802":12981,"_2433":1997},0.4162715248315448,0.5837284751684552,{"_9":12983,"_2445":12987,"_2450":12991},{"_1892":12984,"_1893":12985,"_1802":12986},"NestJS 12 Rspack Migration — Boosting Monorepo Build Speed","NestJS 12 Rspack移行 — モノレポのビルド速度を高速化する","NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기",{"_1892":12988,"_1893":12989,"_1802":12990},"NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기\n\nNestJS 12 Rspack Migration — Boosting Monorepo Build Speed\n\nNestJS 12 is officially moving away from Webpack in its CLI, adopting the Rust-based, ultra-fast Rspack as its primary build tool. With build speed now a critical factor in the productivity of large-scale monorepos, the shift to Rspack is a highly welcome change. However, replacing your existing build system can often lead to tricky technical hurdles, such as missing SWC decorator metadata or issues with class-name mangling in production builds. I have compiled a practical, field-tested guide to help you smoothly navigate these migration challenges in your NestJS 12 monorepo and maximize the benefits of adopting Rspack.\n\nBenefits of Switching to Rspack: Why Replace Webpack?\n\nNestJS 12 has dropped support for Webpack, a long-time mainstay of its official CLI, and adopted the high-performance, Rust-based Rspack as its official build tool. In large monorepo environments, Webpack's slow compilation and heavy hot-reloading were major bottlenecks that hindered development flow. Rspack solves these issues by offering superior build performance while maintaining excellent compatibility with the Webpack architecture and configuration framework.\n\nAccording to the official announcement from Trilon Consulting, NestJS 12 introduces a modern, high-speed toolchain featuring native ESM support, Vitest, oxlint, and Rspack. This evolution allows developers to significantly reduce cold starts and wait times when modifying source code, even in large backend codebases. The primary reason for this migration is the ability to leverage the overwhelming performance of a Rust-based bundler while still utilizing most of the existing Webpack plugin ecosystem.\n\nKey Challenge 1: Restoring SWC Decorator Metadata\n\nTo maximize build speed, Rspack uses the built-in `builtin:swc-loader` instead of `tsc` to compile TypeScript code. While this drastically boosts performance, it hits a critical barrier in NestJS environments: runtime errors. This is because NestJS's core mechanism—Dependency Injection (DI)—relies on decorator metadata.\n\nSince SWC does not generate decorator metadata by default during compilation, dependency injection will fail completely without explicit configuration. To fix this, you must enable the `legacyDecorator` and `decoratorMetadata` options for the SWC loader in your Rspack configuration file.\n\nYou can restore metadata perfectly by customizing the loader settings in your `rspack.config.mjs` file as follows.\n\n// rspack.config.mjs\nexport default {\n module: {\n rules: [\n {\n test: /\\.ts$/,\n use: {\n loader: 'builtin:swc-loader',\n options: {\n jsc: {\n parser: { syntax: 'typescript', decorators: true },\n transform: { legacyDecorator: true, decoratorMetadata: true }\n }\n }\n }\n }\n ]\n }\n};\n\nIf this configuration is not applied, the application will encounter a runtime crash because it cannot identify dependencies during startup. Consequently, this is an essential checkpoint to verify immediately when starting your Rspack migration.\n\nKey Challenge 2: Preventing Class-Name Mangling in Production Builds\n\nThe biggest trap to watch out for when running production builds with Rspack is the mangling of class and function names. By default, Rspack's built-in minifier shortens internal identifiers to random characters to minimize file size. However, NestJS frequently uses actual class names and references as identifiers—for instance, when generating DI tokens or calling `context.getClass()` to query the execution context. If these names are mangled, the runtime fails to locate required guards or service instances, leading to abnormal routing blocks or dependency resolution errors.\n\nTo prevent this malfunction, you must ensure the build toolchain preserves the original names of classes and functions. You can achieve this by manually editing the `compress` and `mangle` rules in the optimization settings of `SwcJsMinimizerRspackPlugin` (Rspack's built-in JS minifier) to enable the `keep_classnames` and `keep_fnames` properties.\n\nHere is an optimization example that ensures production stability for NestJS applications via Rspack configuration.\n\n// rspack.config.mjs (Rspack 1.x 및 NestJS 12 기준)\nimport { rspack } from '@rspack/core';\n\nexport default {\n optimization: {\n minimizer: [\n new rspack.SwcJsMinimizerRspackPlugin({\n minimizerOptions: {\n compress: { keep_classnames: true, keep_fnames: true },\n mangle: { keep_classnames: true, keep_fnames: true }\n }\n })\n ]\n }\n};\n\nAdding this configuration ensures that the minifier keeps the original class name structure intact. This allows the NestJS engine's metadata mapping flow to maintain perfect consistency, even after production deployment.\n\nKey Challenge 3: HMR Socket Conflicts and EADDRINUSE Errors\n\nTo fully enjoy Rspack's overwhelming build speed in a development server, enabling Hot Module Replacement (HMR) is essential. However, applying this to a backend environment often leads to the pitfall of port occupancy errors. Because HMR replaces modules while keeping the process alive, it often fails to properly close the network socket used by the previous instance, resulting in `EADDRINUSE` errors.\n\nTo completely prevent this, you should use NestJS's application lifecycle management to explicitly terminate the existing instance before modules are swapped. If you have set up an HMR environment in Rspack by combining `@rspack/core/hot/poll?100` and `run-script-webpack-plugin`, you must insert lifecycle cleanup logic into your main entry point file, `main.ts`.\n\nHere is the `main.ts` configuration to safely reboot the backend instance without socket conflicts in a development environment.\n\n// main.ts (NestJS 12 / Rspack HMR 대응)\nimport { NestFactory } from '@nestjs/core';\nimport { AppModule } from './app.module';\n\ndeclare const module: any;\n\nasync function bootstrap() {\n const app = await NestFactory.create(AppModule);\n await app.listen(3000);\n\n if (module.hot) {\n module.hot.accept();\n module.hot.dispose(() => app.close());\n }\n}\nbootstrap();\n\nBy calling `app.close()` inside the `module.hot.dispose` callback, you ensure the active HTTP server socket is cleaned up before new code is applied, enabling a smooth and rapid HMR experience.\n\nConfiguring Custom Rspack Adapters in Nx Monorepos\n\nAutomated conversion tools provided in Nx monorepos, such as `@nx/rspack:convert-webpack`, often cause unexpected omissions when migrating Webpack configurations for Node.js backend applications. Unlike frontend builds, backend builds must account for Node runtime specifics like file system access and native module bindings. Therefore, it is much more reliable to configure custom settings manually rather than relying solely on automated conversion tools.\n\nThe key to manual configuration is specifying the build target as 'node' and preventing external dependencies from being bundled into the output. To achieve this, create an `rspack.config.mjs` file in the application root and apply `nodeExternals` to exclude packages in the `node_modules` folder from the bundling process.\n\nHere is an example of a custom Rspack configuration for NestJS operating in an Nx environment. This was written based on Nx 19 or higher.\n\nimport { composePlugins, withNx } from '@nx/rspack';\nimport nodeExternals from 'webpack-node-externals';\n\nexport default composePlugins(withNx(), (config) => {\n config.target = 'node';\n config.externalsPreset = { node: true };\n config.externals = [\n nodeExternals({\n allowlist: [/^@monorepo\\//] \n })\n ];\n return config;\n});\n\nConfiguring a custom adapter this way ensures that unnecessary third-party libraries are not included in the bundle. As a result, only the shared libraries within the monorepo are included in the compilation, which drastically improves build speed and significantly optimizes the size of your production images.\n\nHow to Prepare for the Rspack Adoption\n\nThe combination of NestJS 12 and Rspack is a breakthrough for development teams managing large-scale monorepos who are struggling with sluggish build speeds. I recommend reviewing your migration in advance using the available `@nestjs/cli@next` pre-release package and checking the decorator metadata and class-name preservation settings discussed above. By validating production build stability and the local development experience beforehand, you can enjoy dramatic build speed improvements without any confusion when the official release arrives.\n\nReference Links\n\nnrwl/nx GitHub Issues — Nx Monorepo Conversion Gaps\nRspack Documentation & GitHub Issues — Common Pitfall: TS Decorator Metadata and SWC Configuration\nweb-infra-dev/rspack GitHub Repository — Common Pitfall: Production Class-Name Mangling","NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기\n\nNestJS 12 Rspack移行 — モノレポのビルド速度を高速化する\n\nNestJS 12では、公式CLIにおける従来のWebpackサポートが終了し、Rustベースの超高速バンドラーであるRspackが公式ビルドツールとして採用されます。ビルド速度が大規模モノレポの開発生産性を左右する重要な要素となった今、Rspackへの移行は非常に歓迎すべき変化です。しかし、既存のビルド体系を入れ替える過程では、SWCデコレータメタデータの欠落や、本番ビルド時のクラス名難読化といった難しい技術的な壁に直面しがちです。NestJS 12ベースのモノレポ環境で、これらの現実的な移行課題をスムーズに解決し、Rspack導入の効果を最大化するための実務的なガイドをまとめました。\n\nRspack移行の利点：なぜWebpackを置き換えるのか\n\nNestJS 12では、長年公式CLIの中核を担ってきたWebpackのサポートを終了し、Rustベースの超高速バンドラー「Rspack」を公式ビルドツールとして採用しました。大規模モノレポ環境において、Webpackの遅いコンパイルと重いホットリロードは、開発フローを阻害する最大のボトルネックでした。Rspackは、Webpackのアーキテクチャや設定フレームワークとの高い互換性を維持しつつ、ビルドパフォーマンスを圧倒的に向上させることでこの問題を解決します。\n\nTrilon Consultingの公式発表によると、NestJS 12はネイティブESMへの移行とともに、Vitest、oxlint、そしてRspackへと続く現代的で超高速なツールチェーンを提供します。この変化のおかげで、開発者は重いバックエンドのコードベースであっても、コールドスタートやソースコード変更時の待ち時間を大幅に短縮できます。既存のWebpackプラグインエコシステムのほとんどを活用しながら、Rustバンドラーの圧倒的な性能を容易に確保できるという点が、移行の最大の理由です。\n\n核心的な壁1：SWCデコレータメタデータの復元\n\nRspackはビルド速度を最大化するため、デフォルトでtscの代わりに内蔵のSWCローダーである「builtin:swc-loader」を使用してTypeScriptコードをコンパイルします。この手法はビルド性能を劇的に向上させますが、NestJS環境ではランタイムエラーという致命的な壁にぶつかります。NestJSの中核メカニズムである依存性の注入（DI）が、デコレータメタデータに依存して動作しているためです。\n\nSWCはデフォルトの状態ではコンパイル時にデコレータメタデータを生成しないため、明示的な設定を追加しなければ依存性の注入は完全に失敗します。この問題を解決するには、Rspack設定ファイルでSWCローダーの「legacyDecorator」および「decoratorMetadata」オプションを必ず有効にする必要があります。\n\nrspack.config.mjsファイルで以下のようにローダー設定をカスタマイズすることで、メタデータを完全に復元できます。\n\n// rspack.config.mjs\nexport default {\n module: {\n rules: [\n {\n test: /\\.ts$/,\n use: {\n loader: 'builtin:swc-loader',\n options: {\n jsc: {\n parser: { syntax: 'typescript', decorators: true },\n transform: { legacyDecorator: true, decoratorMetadata: true }\n }\n }\n }\n }\n ]\n }\n};\n\nこの設定が適用されていないと、アプリケーション起動時に依存関係を識別できず、ランタイムクラッシュが発生します。そのため、Rspack移行を開始する際に、まず最初に正しく動作するか確認すべき必須のチェックポイントです。\n\n核心的な壁2：本番ビルド時のクラス名難読化防止\n\nRspackで本番ビルドを行う際に最も注意すべき落とし穴は、クラス名と関数名の難読化処理です。Rspackが提供するデフォルトのコード圧縮器は、ファイルサイズを最小化するために内部識別子をランダムな文字列に短縮します。しかし、NestJSは依存性の注入トークンを作成したり、実行コンテキストを照会するcontext.getClass()メソッドなどを実行したりする際に、クラスの実際の名前と参照を識別子として頻繁に活用します。クラス名が勝手に変更されると、ランタイムで必要なガードやサービスインスタンスを正常に見つけられず、異常なルーティング遮断や依存関係解決失敗のエラーに直面することになります。\n\nこの誤動作を根本的に防ぐには、ビルドツールチェーンがクラスと関数の元の名前を保持するように対策しなければなりません。Rspackの内蔵JavaScript圧縮プラグイン「SwcJsMinimizerRspackPlugin」の最適化設定において、compressとmangleルールを手動で編集し、「keep_classnames」および「keep_fnames」プロパティを有効にすれば解決します。\n\n以下は、Rspack設定を通じてNestJSアプリケーションの本番安定性を確保する最適化の例です。\n\n// rspack.config.mjs (Rspack 1.x 및 NestJS 12 기준)\nimport { rspack } from '@rspack/core';\n\nexport default {\n optimization: {\n minimizer: [\n new rspack.SwcJsMinimizerRspackPlugin({\n minimizerOptions: {\n compress: { keep_classnames: true, keep_fnames: true },\n mangle: { keep_classnames: true, keep_fnames: true }\n }\n })\n ]\n }\n};\n\nこの設定を追加すれば、コード圧縮を行うコンパイラが元のクラス名の構造を安全に維持します。これにより、本番環境へのデプロイ後もNestJSエンジンのメタデータマッピングの流れが途切れず、完璧に一貫性を保持できます。\n\n核心的な壁3：HMRソケット競合とEADDRINUSEエラー\n\nRspackの圧倒的なビルド速度を開発サーバーで完全に享受するにはホットリロード（HMR）の有効化が不可欠ですが、これをバックエンドに適用すると「ポート占有エラー」という伏兵に遭遇します。コードが変更されるたびにプロセスを維持したままモジュールだけを差し替えるHMRの特性上、以前のアプリケーションインスタンスが使用していたネットワークソケットが正常に閉じられず、EADDRINUSEエラーが発生する現象です。\n\nこれを完璧に防ぐには、NestJSのアプリケーションライフサイクル管理機能を利用して、モジュールが差し替えられる直前に既存のインスタンスを明示的に解放する必要があります。Rspack環境で@rspack/core/hot/poll?100とrun-script-webpack-pluginを組み合わせてHMR環境を構築した場合は、メインエントリーポイントであるmain.tsにライフサイクルクリーンアップロジックを必ず挿入してください。\n\n開発環境でソケット競合を起こさず、バックエンドインスタンスを安全に再起動するmain.tsの設定は以下の通りです。\n\n// main.ts (NestJS 12 / Rspack HMR 대응)\nimport { NestFactory } from '@nestjs/core';\nimport { AppModule } from './app.module';\n\ndeclare const module: any;\n\nasync function bootstrap() {\n const app = await NestFactory.create(AppModule);\n await app.listen(3000);\n\n if (module.hot) {\n module.hot.accept();\n module.hot.dispose(() => app.close());\n }\n}\nbootstrap();\n\nこのように、module.hot.disposeコールバック内でapp.close()を呼び出しておけば、新しいコードが反映される前に有効だったHTTPサーバーソケットが確実に解放され、スムーズで高速なホットリロード環境を完成させることができます。\n\nNxモノレポでのRspackカスタムアダプター構成\n\nNxモノレポ環境で提供される@nx/rspack:convert-webpackのような自動変換ツールは、バックエンドのNode.jsアプリケーションのWebpack設定を移行する際に、予期せぬ設定漏れを頻繁に起こします。フロントエンドのビルドとは異なり、バックエンドビルドはファイルシステムアクセスやネイティブモジュールのバインディングなど、Node.jsランタイムの特性を考慮する必要があるため、自動変換ツールだけに依存せず、手動でカスタム設定を構築する方がはるかに安定しています。\n\n手動設定の要点は、ビルド対象プラットフォームをnodeに明示し、外部依存関係がバンドル結果に丸ごと含まれてしまう問題を防止することです。このため、アプリケーションルートにrspack.config.mjsファイルを作成し、nodeExternalsを適用してnode_modulesフォルダーのパッケージをバンドル対象から除外する必要があります。\n\nNx環境で動作するNestJS用カスタムRspack設定の例です。Nx 19以上のバージョンを基準に作成されています。\n\nimport { composePlugins, withNx } from '@nx/rspack';\nimport nodeExternals from 'webpack-node-externals';\n\nexport default composePlugins(withNx(), (config) => {\n config.target = 'node';\n config.externalsPreset = { node: true };\n config.externals = [\n nodeExternals({\n allowlist: [/^@monorepo\\//] \n })\n ];\n return config;\n});\n\nこのようにカスタムアダプターを構成すれば、不要なサードパーティライブラリがバンドルに含まれる問題を確実に防ぐことができます。結果として、モノレポ内部の共有ライブラリのみが安全にコンパイルに含まれるため、ビルド速度が劇的に改善され、本番環境のイメージ容量も大幅に最適化されます。\n\nRspack導入、どう準備するか\n\nNestJS 12とRspackの組み合わせは、大規模モノレポを運用する開発チームにとって、ビルド速度の停滞を解消する確実な突破口となります。現在提供されている@nestjs/cli@nextのプレリリースパッケージを通じてあらかじめ移行を検討し、先述したデコレータメタデータとクラス名保持の設定を確認しておくことを推奨します。本番ビルドの安定性とローカル開発体験を事前に検証しておけば、今後の正式リリース時に大きな混乱なく、圧倒的なビルド速度の向上を享受できるでしょう。\n\n参考リンク\n\nnrwl/nx GitHub Issues — Nx Monorepo Conversion Gaps\nRspack Documentation & GitHub Issues — Common Pitfall: TS Decorator Metadata and SWC Configuration\nweb-infra-dev/rspack GitHub Repository — Common Pitfall: Production Class-Name Mangling","NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기\n\nNestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기\n\nNestJS 12가 공식 CLI에서 기존 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 도입합니다. 빌드 속도가 대규모 모노레포의 개발 생산성을 결정짓는 핵심 요소가 된 지금, Rspack으로의 전환은 대단히 반가운 변화입니다. 하지만 기존 빌드 체계를 교체하는 과정에서 SWC 데코레이터 메타데이터 누락이나 프로덕션 빌드의 클래스명 난독화 같은 까다로운 기술 장벽에 부딪히기 쉽습니다. NestJS 12 기반 모노레포 환경에서 이러한 현실적인 마이그레이션 문제를 매끄럽게 해결하고, Rspack 도입 효과를 극대화할 수 있는 실무 실전 가이드를 정리했습니다.\n\nRspack 전환의 이점: 왜 Webpack을 대체하는가\n\nNestJS 12는 오랫동안 공식 CLI의 중심을 지켰던 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 채택했습니다. 대규모 모노레포 환경에서 웹팩의 느린 컴파일과 무거운 핫 리로드는 개발 흐름을 끊는 가장 큰 병목이었습니다. Rspack은 웹팩 아키텍처 및 설정 프레임워크와 뛰어난 호환성을 유지하면서도 빌드 성능을 압도적으로 끌어올려 이 문제를 해결합니다.\n\nTrilon Consulting의 공식 발표에 따르면 NestJS 12는 네이티브 ESM 전환과 함께 Vitest, oxlint, 그리고 Rspack으로 이어지는 현대적인 초고속 도구 체인을 제공합니다. 이 변화 덕분에 개발자는 무거운 백엔드 코드베이스에서도 콜드 스타트와 소스 코드 변경 시 발생하는 대기 시간을 대폭 줄일 수 있습니다. 기존 웹팩 플러그인 생태계를 대부분 그대로 활용하면서 Rust 번들러의 압도적인 성능을 손쉽게 확보할 수 있다는 점이 마이그레이션의 가장 큰 이유입니다.\n\n핵심 장벽 1: SWC 데코레이터 메타데이터 복원\n\nRspack은 빌드 속도를 극대화하기 위해 기본적으로 tsc 대신 내장된 SWC 로더인 builtin:swc-loader를 사용하여 TypeScript 코드를 컴파일합니다. 이 방식은 빌드 성능을 비약적으로 끌어올리지만, NestJS 환경에서는 런타임 오류라는 치명적인 장벽을 만나게 됩니다. NestJS의 핵심 메커니즘인 의존성 주입이 데코레이터 메타데이터를 기반으로 동작하기 때문입니다.\n\nSWC는 기본 상태에서 컴파일 시점에 데코레이터 메타데이터를 생성하지 않으므로, 명시적인 설정을 추가하지 않으면 의존성 주입이 완전히 실패합니다. 이 문제를 해결하려면 Rspack 설정 파일에서 SWC 로더의 legacyDecorator와 decoratorMetadata 옵션을 반드시 활성화해야 합니다.\n\nrspack.config.mjs 파일에서 다음과 같이 로더 설정을 커스텀하여 메타데이터를 완벽하게 복원할 수 있습니다.\n\n// rspack.config.mjs\nexport default {\n module: {\n rules: [\n {\n test: /\\.ts$/,\n use: {\n loader: 'builtin:swc-loader',\n options: {\n jsc: {\n parser: { syntax: 'typescript', decorators: true },\n transform: { legacyDecorator: true, decoratorMetadata: true }\n }\n }\n }\n }\n ]\n }\n};\n\n해당 설정이 적용되지 않으면 애플리케이션 구동 시 의존성을 식별하지 못해 런타임 크래시가 발생합니다. 따라서 Rspack 마이그레이션을 시작할 때 가장 먼저 올바르게 작동하는지 확인해야 할 필수 체크포인트입니다.\n\n핵심 장벽 2: 프로덕션 빌드의 클래스명 난독화 방지\n\nRspack으로 프로덕션 빌드를 수행할 때 가장 주의해야 할 함정은 클래스명과 함수명의 난독화 처리입니다. Rspack이 제공하는 기본 코드 압축기는 파일 크기를 최소화하기 위해 내부 식별자를 무작위 문자로 축소합니다. 하지만 NestJS는 의존성 주입 토큰을 생성하거나, 실행 컨텍스트를 조회하는 context.getClass() 메서드 등을 실행할 때 클래스의 실제 이름과 참조를 식별자로 자주 활용합니다. 클래스명이 임의로 변경되면 런타임에서 필요한 가드나 서비스 인스턴스를 정상적으로 찾아내지 못해 비정상적인 라우팅 차단이나 의존성 해결 실패 오류를 직면하게 됩니다.\n\n이 오동작을 원천적으로 막기 위해서는 빌드 도구 체인이 클래스와 함수의 원본 이름을 보존하도록 조치해야 합니다. Rspack의 내장 자바스크립트 압축 플러그인인 SwcJsMinimizerRspackPlugin의 최적화 설정에서 compress와 mangle 규칙을 수동으로 편집하여 keep_classnames 및 keep_fnames 속성을 활성화해 주면 됩니다.\n\n다음은 Rspack 설정을 통해 NestJS 애플리케이션의 프로덕션 안정성을 확보하는 최적화 예시입니다.\n\n// rspack.config.mjs (Rspack 1.x 및 NestJS 12 기준)\nimport { rspack } from '@rspack/core';\n\nexport default {\n optimization: {\n minimizer: [\n new rspack.SwcJsMinimizerRspackPlugin({\n minimizerOptions: {\n compress: { keep_classnames: true, keep_fnames: true },\n mangle: { keep_classnames: true, keep_fnames: true }\n }\n })\n ]\n }\n};\n\n이 설정을 추가하면 코드 압축을 진행하는 컴파일러가 원본 클래스명 구조를 안전하게 유지합니다. 이를 통해 프로덕션 배포 후에도 NestJS 엔진의 메타데이터 매핑 흐름이 깨지지 않고 완벽하게 일관성을 유지할 수 있습니다.\n\n핵심 장벽 3: HMR 소켓 충돌과 EADDRINUSE 오류\n\nRspack의 압도적인 빌드 속도를 개발 서버에서 온전히 누리려면 핫 리로드 활성화가 필수적이지만, 이를 백엔드에 적용하면 포트 점유 오류라는 복병을 만나게 됩니다. 코드가 변경될 때마다 프로세스는 유지된 채 모듈만 교체되는 HMR 특성상, 이전 애플리케이션 인스턴스가 사용하던 네트워크 소켓이 정상적으로 닫히지 않아 EADDRINUSE 오류를 뿜어내는 현상입니다.\n\n이를 완벽히 방지하려면 NestJS의 애플리케이션 수명 주기 관리 기능을 활용해, 모듈이 교체되기 직전 기존 인스턴스를 명시적으로 해제해야 합니다. Rspack 환경에서 @rspack/core/hot/poll?100과 run-script-webpack-plugin을 결합하여 HMR 환경을 구축했다면, 메인 엔트리포인트 파일인 main.ts에 수명 주기 클린업 로직을 반드시 삽입해야 합니다.\n\n개발 환경에서 소켓 충돌 없이 백엔드 인스턴스를 안전하게 재부팅하는 main.ts 설정은 다음과 같습니다.\n\n// main.ts (NestJS 12 / Rspack HMR 대응)\nimport { NestFactory } from '@nestjs/core';\nimport { AppModule } from './app.module';\n\ndeclare const module: any;\n\nasync function bootstrap() {\n const app = await NestFactory.create(AppModule);\n await app.listen(3000);\n\n if (module.hot) {\n module.hot.accept();\n module.hot.dispose(() => app.close());\n }\n}\nbootstrap();\n\n이처럼 module.hot.dispose 콜백 내부에서 app.close()를 호출해 두면, 새로운 코드가 반영되기 전에 활성화되어 있던 HTTP 서버 소켓이 확실하게 정리되어 매끄럽고 빠른 핫 리로드 환경을 완성할 수 있습니다.\n\nNx 모노레포에서의 Rspack 커스텀 어댑터 구성\n\nNx 모노레포 환경에서 제공하는 @nx/rspack:convert-webpack 같은 자동 전환 도구는 백엔드 노드 애플리케이션의 웹팩 설정을 마이그레이션할 때 예기치 못한 누락을 자주 일으킵니다. 프론트엔드 빌드와 달리 백엔드 빌드는 파일 시스템 접근이나 네이티브 모듈 바인딩 등 노드 런타임의 특성을 고려해야 하므로 자동 변환 도구에만 의존하기보다 수동으로 커스텀 설정을 구성하는 편이 훨씬 안정적입니다.\n\n수동 설정의 핵심은 빌드 대상 플랫폼을 노드로 명시하고 외부 의존성이 번들 결과물에 통째로 묶이는 문제를 방지하는 것입니다. 이를 위해 애플리케이션 루트에 rspack.config.mjs 파일을 생성하고 nodeExternals를 적용하여 node_modules 폴더의 패키지들을 번들링 대상에서 제외해야 합니다.\n\nNx 환경에서 동작하는 NestJS용 커스텀 Rspack 설정 예시입니다. Nx 19 이상 버전을 기준으로 작성되었습니다.\n\nimport { composePlugins, withNx } from '@nx/rspack';\nimport nodeExternals from 'webpack-node-externals';\n\nexport default composePlugins(withNx(), (config) => {\n config.target = 'node';\n config.externalsPreset = { node: true };\n config.externals = [\n nodeExternals({\n allowlist: [/^@monorepo\\//] \n })\n ];\n return config;\n});\n\n이와 같이 커스텀 어댑터를 구성하면 불필요한 서드파티 라이브러리가 번들에 포함되는 문제를 확실하게 차단할 수 있습니다. 결과적으로 모노레포 내부의 공유 라이브러리만 안전하게 컴파일에 포함되므로 빌드 속도가 획기적으로 개선되고 프로덕션 환경의 이미지 용량도 크게 최적화됩니다.\n\nRspack 도입, 어떻게 준비할 것인가\n\nNestJS 12와 Rspack의 결합은 대규모 모노레포를 운영하는 개발팀에게 빌드 속도 정체를 해결해 줄 확실한 돌파구입니다. 현재 제공되는 @nestjs/cli@next 프리릴리즈 패키지를 통해 미리 마이그레이션을 검토하고, 앞서 다룬 데코레이터 메타데이터와 클래스명 유지 설정을 점검해 보시길 권장합니다. 프로덕션 빌드의 안정성과 로컬 개발 경험을 미리 검증해 둔다면, 다가오는 공식 릴리즈 시점에 별다른 혼선 없이 압도적인 빌드 속도 개선을 누릴 수 있습니다.\n\n참고 링크\n\nnrwl/nx GitHub Issues — Nx Monorepo Conversion Gaps\nRspack Documentation & GitHub Issues — Common Pitfall: TS Decorator Metadata and SWC Configuration\nweb-infra-dev/rspack GitHub Repository — Common Pitfall: Production Class-Name Mangling",{"_1892":12992,"_1893":12993,"_1802":12994},"NestJS 12 Rspack Migration — Boosting Monorepo Build Speed NestJS 12 is officially moving away from Webpack in its CLI, adopting the Rust-based, ultra-fast Rspack as its primary build tool. With build speed now a critica…","NestJS 12 Rspack移行 — モノレポのビルド速度を高速化する NestJS 12では、公式CLIにおける従来のWebpackサポートが終了し、Rustベースの超高速バンドラーであるRspackが公式ビルドツールとして採用されます。ビルド速度が大規模モノレポの開発生産性を左右する重要な要素となった今、Rspackへの移行は非常に歓迎すべき変化です。しかし、既存のビルド体系を入れ替える過程では、SWCデコレータメタデータの欠落…","NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기 NestJS 12가 공식 CLI에서 기존 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 도입합니다. 빌드 속도가 대규모 모노레포의 개발 생산성을 결정짓는 핵심 요소가 된 지금, Rspack으로의 전환은 대단히 반가운 변화입니다. 하지만 기존 빌드 체계를 교체하는 과정에서 SWC 데…","cmrvvjk3w02jw10munggbd5c9",[6733],[7581,12440,12998,12999,13000,13001],"monorepo","swc","build-performance","migration",[],"2026-07-22T15:18:56.144Z","2026-07-22T08:59:01.639Z","2026-07-22T15:20:04.789Z","2026-07-22T15:20:04.757Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":13008},{"_1901":13009},{"_1903":13010,"_1908":1909,"_1910":13011,"_1921":13012,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":13013,"_1928":13014,"_1933":13015,"_1938":13016},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":13018,"_1883":1884,"_1200":1204,"_1899":13021},{"_633":13019,"_11":13020},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":13022},{"_1903":13023,"_1908":1909,"_1910":13024,"_1921":13025,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":13026,"_1928":13027,"_1933":13028,"_1938":13029},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":13031},{"_1948":-5,"_1908":1909,"_1910":13032,"_1960":-5,"_1943":13037,"_1962":13038},{"_1912":13033,"_1914":13034,"_1952":13035,"_1810":2534,"_944":1992,"_1917":13036,"_1957":2536,"_1919":1920},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/411e2530-23ae-4061-abfc-183dc74d5e67.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/411e2530-23ae-4061-abfc-183dc74d5e67.jpg",380907,"L98NkR.TM{Mws:kDofjZ4,ibofkq","2026-07-22T09:22:45.830Z",{"_1964":13039,"_1972":13043,"_1979":13047,"_1986":-5},{"_1912":13040,"_1914":13041,"_1952":13042,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/large.webp",26570,{"_1912":13044,"_1914":13045,"_1952":13046,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/small.webp",7332,{"_1912":13048,"_1914":13049,"_1952":13050,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrvvjk3w02jw10munggbd5c9/medium.webp",15206,{"_950":13052,"_2559":12973,"_2560":13053,"_2716":13441,"_2788":13569,"_2790":13570,"_2792":13571,"_2794":1997,"_2003":13572,"_2480":13573,"_2797":-5},"cmrvup1mz02j010mu2sfoyfw1",{"_918":13054,"_1908":1909},[13055,13057,13060,13064,13067,13072,13075,13080,13083,13088,13091,13096,13099,13104,13107,13117,13120,13134,13137,13145,13148,13151,13154,13159,13162,13167,13170,13180,13183,13211,13214,13219,13222,13225,13228,13233,13236,13241,13244,13254,13257,13276,13279,13288,13291,13294,13297,13312,13315,13320,13323,13333,13336,13355,13358,13363,13366,13369,13372,13377,13380,13385,13388,13398,13401,13403,13406,13411,13414],{"_950":13056,"_2565":12986,"_2420":2566,"_2567":12995},"4a61caa0-c732-49f4-a579-22b2e2b0ad38",{"_950":13058,"_2420":2570,"_2571":13059},"5d6ba33e-68a4-4091-ae83-7a63c3ef90d3",[],{"_950":13061,"_2420":2575,"_2576":1909,"_2571":13062},"171909af-0428-45bf-8e8f-4a5ded4c5c12",[13063],{"_2579":12986,"_2420":2579},{"_950":13065,"_2420":2570,"_2571":13066},"f994e210-a748-403b-b1e7-135712d5e574",[],{"_950":13068,"_2420":2570,"_2571":13069},"bd28280a-dbb6-41d4-9fe9-f265e7d40ecb",[13070],{"_2579":13071,"_2420":2579},"NestJS 12가 공식 CLI에서 기존 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 도입합니다. 빌드 속도가 대규모 모노레포의 개발 생산성을 결정짓는 핵심 요소가 된 지금, Rspack으로의 전환은 대단히 반가운 변화입니다. 하지만 기존 빌드 체계를 교체하는 과정에서 SWC 데코레이터 메타데이터 누락이나 프로덕션 빌드의 클래스명 난독화 같은 까다로운 기술 장벽에 부딪히기 쉽습니다. NestJS 12 기반 모노레포 환경에서 이러한 현실적인 마이그레이션 문제를 매끄럽게 해결하고, Rspack 도입 효과를 극대화할 수 있는 실무 실전 가이드를 정리했습니다.",{"_950":13073,"_2420":2570,"_2571":13074},"ea95d458-7873-4ee6-8683-b717bbe41ec3",[],{"_950":13076,"_2420":2575,"_2576":2007,"_2571":13077},"c201a977-9a8b-4a6c-ac48-7d66a3dc0b34",[13078],{"_2579":13079,"_2420":2579},"Rspack 전환의 이점: 왜 Webpack을 대체하는가",{"_950":13081,"_2420":2570,"_2571":13082},"16f41130-f316-4cc4-8221-712785f7fc98",[],{"_950":13084,"_2420":2570,"_2571":13085},"f476ba7d-11dd-4a9f-917f-7ff324337253",[13086],{"_2579":13087,"_2420":2579},"NestJS 12는 오랫동안 공식 CLI의 중심을 지켰던 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 채택했습니다. 대규모 모노레포 환경에서 웹팩의 느린 컴파일과 무거운 핫 리로드는 개발 흐름을 끊는 가장 큰 병목이었습니다. Rspack은 웹팩 아키텍처 및 설정 프레임워크와 뛰어난 호환성을 유지하면서도 빌드 성능을 압도적으로 끌어올려 이 문제를 해결합니다.",{"_950":13089,"_2420":2570,"_2571":13090},"97d61fbf-6210-481f-beeb-1c63c147c2b2",[],{"_950":13092,"_2420":2570,"_2571":13093},"7f8fe285-be9e-4bbc-b58a-cccd140fd815",[13094],{"_2579":13095,"_2420":2579},"Trilon Consulting의 공식 발표에 따르면 NestJS 12는 네이티브 ESM 전환과 함께 Vitest, oxlint, 그리고 Rspack으로 이어지는 현대적인 초고속 도구 체인을 제공합니다. 이 변화 덕분에 개발자는 무거운 백엔드 코드베이스에서도 콜드 스타트와 소스 코드 변경 시 발생하는 대기 시간을 대폭 줄일 수 있습니다. 기존 웹팩 플러그인 생태계를 대부분 그대로 활용하면서 Rust 번들러의 압도적인 성능을 손쉽게 확보할 수 있다는 점이 마이그레이션의 가장 큰 이유입니다.",{"_950":13097,"_2420":2570,"_2571":13098},"eb1c82c5-561b-4c7c-9e03-1b9f9aaffcf0",[],{"_950":13100,"_2420":2575,"_2576":2007,"_2571":13101},"b04682c0-be45-49f8-bd7b-3541bc5e5b24",[13102],{"_2579":13103,"_2420":2579},"핵심 장벽 1: SWC 데코레이터 메타데이터 복원",{"_950":13105,"_2420":2570,"_2571":13106},"32a11085-d5d8-4bbf-a4dc-c2e4f1a45199",[],{"_950":13108,"_2420":2570,"_2571":13109},"dce129a6-e390-43c9-a2c0-338b36be8598",[13110,13112,13115],{"_2579":13111,"_2420":2579},"Rspack은 빌드 속도를 극대화하기 위해 기본적으로 tsc 대신 내장된 SWC 로더인 ",{"_2579":13113,"_2420":2579,"_3365":13114},"builtin:swc-loader",{"_3351":3367},{"_2579":13116,"_2420":2579},"를 사용하여 TypeScript 코드를 컴파일합니다. 이 방식은 빌드 성능을 비약적으로 끌어올리지만, NestJS 환경에서는 런타임 오류라는 치명적인 장벽을 만나게 됩니다. NestJS의 핵심 메커니즘인 의존성 주입이 데코레이터 메타데이터를 기반으로 동작하기 때문입니다.",{"_950":13118,"_2420":2570,"_2571":13119},"42911d14-8c58-47ad-8f10-99c397f1da36",[],{"_950":13121,"_2420":2570,"_2571":13122},"2f396372-18bd-4837-a56f-6d9f51dfac76",[13123,13125,13128,13129,13132],{"_2579":13124,"_2420":2579},"SWC는 기본 상태에서 컴파일 시점에 데코레이터 메타데이터를 생성하지 않으므로, 명시적인 설정을 추가하지 않으면 의존성 주입이 완전히 실패합니다. 이 문제를 해결하려면 Rspack 설정 파일에서 SWC 로더의 ",{"_2579":13126,"_2420":2579,"_3365":13127},"legacyDecorator",{"_3351":3367},{"_2579":5185,"_2420":2579},{"_2579":13130,"_2420":2579,"_3365":13131},"decoratorMetadata",{"_3351":3367},{"_2579":13133,"_2420":2579}," 옵션을 반드시 활성화해야 합니다.",{"_950":13135,"_2420":2570,"_2571":13136},"1f6dd894-208d-496f-a99b-8f723b58726e",[],{"_950":13138,"_2420":2570,"_2571":13139},"594f8830-bc97-40ca-b7eb-75947d40c2e3",[13140,13143],{"_2579":13141,"_2420":2579,"_3365":13142},"rspack.config.mjs",{"_3351":3367},{"_2579":13144,"_2420":2579}," 파일에서 다음과 같이 로더 설정을 커스텀하여 메타데이터를 완벽하게 복원할 수 있습니다.",{"_950":13146,"_2420":2570,"_2571":13147},"978f711b-a2c4-4d12-8ab3-c28f82e8ffdf",[],{"_950":13149,"_3351":13150,"_2420":3351,"_625":7690},"bc1a5022-c678-4d72-9adc-f384b285bb6d","// rspack.config.mjs\nexport default {\n module: {\n rules: [\n {\n test: /\\.ts$/,\n use: {\n loader: 'builtin:swc-loader',\n options: {\n jsc: {\n parser: { syntax: 'typescript', decorators: true },\n transform: { legacyDecorator: true, decoratorMetadata: true }\n }\n }\n }\n }\n ]\n }\n};",{"_950":13152,"_2420":2570,"_2571":13153},"b0854121-cedd-42e3-8187-065b98829bfa",[],{"_950":13155,"_2420":2570,"_2571":13156},"5568343b-b6c1-4af9-a7f3-47a0c98f950a",[13157],{"_2579":13158,"_2420":2579},"해당 설정이 적용되지 않으면 애플리케이션 구동 시 의존성을 식별하지 못해 런타임 크래시가 발생합니다. 따라서 Rspack 마이그레이션을 시작할 때 가장 먼저 올바르게 작동하는지 확인해야 할 필수 체크포인트입니다.",{"_950":13160,"_2420":2570,"_2571":13161},"f212b596-be6a-478b-b15f-49af773a677b",[],{"_950":13163,"_2420":2575,"_2576":2007,"_2571":13164},"83346084-8326-4e5b-8717-f39505a01f70",[13165],{"_2579":13166,"_2420":2579},"핵심 장벽 2: 프로덕션 빌드의 클래스명 난독화 방지",{"_950":13168,"_2420":2570,"_2571":13169},"b3cdefb0-2d60-4b9c-9347-badbccdff215",[],{"_950":13171,"_2420":2570,"_2571":13172},"b2c6a0f3-d6c0-4dcb-96b7-581bc9af2ef0",[13173,13175,13178],{"_2579":13174,"_2420":2579},"Rspack으로 프로덕션 빌드를 수행할 때 가장 주의해야 할 함정은 클래스명과 함수명의 난독화 처리입니다. Rspack이 제공하는 기본 코드 압축기는 파일 크기를 최소화하기 위해 내부 식별자를 무작위 문자로 축소합니다. 하지만 NestJS는 의존성 주입 토큰을 생성하거나, 실행 컨텍스트를 조회하는 ",{"_2579":13176,"_2420":2579,"_3365":13177},"context.getClass()",{"_3351":3367},{"_2579":13179,"_2420":2579}," 메서드 등을 실행할 때 클래스의 실제 이름과 참조를 식별자로 자주 활용합니다. 클래스명이 임의로 변경되면 런타임에서 필요한 가드나 서비스 인스턴스를 정상적으로 찾아내지 못해 비정상적인 라우팅 차단이나 의존성 해결 실패 오류를 직면하게 됩니다.",{"_950":13181,"_2420":2570,"_2571":13182},"8920e190-6603-482d-8ecd-88f337cfad3f",[],{"_950":13184,"_2420":2570,"_2571":13185},"aa3348f2-a4a6-4521-8bd4-04e29621828a",[13186,13188,13191,13193,13196,13197,13200,13202,13205,13206,13209],{"_2579":13187,"_2420":2579},"이 오동작을 원천적으로 막기 위해서는 빌드 도구 체인이 클래스와 함수의 원본 이름을 보존하도록 조치해야 합니다. Rspack의 내장 자바스크립트 압축 플러그인인 ",{"_2579":13189,"_2420":2579,"_3365":13190},"SwcJsMinimizerRspackPlugin",{"_3351":3367},{"_2579":13192,"_2420":2579},"의 최적화 설정에서 ",{"_2579":13194,"_2420":2579,"_3365":13195},"compress",{"_3351":3367},{"_2579":5185,"_2420":2579},{"_2579":13198,"_2420":2579,"_3365":13199},"mangle",{"_3351":3367},{"_2579":13201,"_2420":2579}," 규칙을 수동으로 편집하여 ",{"_2579":13203,"_2420":2579,"_3365":13204},"keep_classnames",{"_3351":3367},{"_2579":12657,"_2420":2579},{"_2579":13207,"_2420":2579,"_3365":13208},"keep_fnames",{"_3351":3367},{"_2579":13210,"_2420":2579}," 속성을 활성화해 주면 됩니다.",{"_950":13212,"_2420":2570,"_2571":13213},"13d4f816-8f8a-48ee-9042-9ebe971f07d3",[],{"_950":13215,"_2420":2570,"_2571":13216},"36520899-6352-4341-846a-0d8fc1c58ad8",[13217],{"_2579":13218,"_2420":2579},"다음은 Rspack 설정을 통해 NestJS 애플리케이션의 프로덕션 안정성을 확보하는 최적화 예시입니다.",{"_950":13220,"_2420":2570,"_2571":13221},"602aff1c-175b-4bbe-86fa-0235053bbd0f",[],{"_950":13223,"_3351":13224,"_2420":3351,"_625":7690},"e56faae7-667a-49ac-8677-2d543a1c29c3","// rspack.config.mjs (Rspack 1.x 및 NestJS 12 기준)\nimport { rspack } from '@rspack/core';\n\nexport default {\n optimization: {\n minimizer: [\n new rspack.SwcJsMinimizerRspackPlugin({\n minimizerOptions: {\n compress: { keep_classnames: true, keep_fnames: true },\n mangle: { keep_classnames: true, keep_fnames: true }\n }\n })\n ]\n }\n};",{"_950":13226,"_2420":2570,"_2571":13227},"fe095f87-23fe-4ceb-957d-c2dc3f9a1691",[],{"_950":13229,"_2420":2570,"_2571":13230},"9620b424-e7fb-4eb1-8854-2cb6c39dc1ae",[13231],{"_2579":13232,"_2420":2579},"이 설정을 추가하면 코드 압축을 진행하는 컴파일러가 원본 클래스명 구조를 안전하게 유지합니다. 이를 통해 프로덕션 배포 후에도 NestJS 엔진의 메타데이터 매핑 흐름이 깨지지 않고 완벽하게 일관성을 유지할 수 있습니다.",{"_950":13234,"_2420":2570,"_2571":13235},"0483068b-7894-4fee-9056-3407eb2ddac1",[],{"_950":13237,"_2420":2575,"_2576":2007,"_2571":13238},"3cb51247-9234-479d-87db-4daaf0f1d2ec",[13239],{"_2579":13240,"_2420":2579},"핵심 장벽 3: HMR 소켓 충돌과 EADDRINUSE 오류",{"_950":13242,"_2420":2570,"_2571":13243},"4afafb87-12c8-4bb8-bf62-146b8e54e853",[],{"_950":13245,"_2420":2570,"_2571":13246},"acc79481-6d22-4a8d-8d4f-bdc4e454b413",[13247,13249,13252],{"_2579":13248,"_2420":2579},"Rspack의 압도적인 빌드 속도를 개발 서버에서 온전히 누리려면 핫 리로드 활성화가 필수적이지만, 이를 백엔드에 적용하면 포트 점유 오류라는 복병을 만나게 됩니다. 코드가 변경될 때마다 프로세스는 유지된 채 모듈만 교체되는 HMR 특성상, 이전 애플리케이션 인스턴스가 사용하던 네트워크 소켓이 정상적으로 닫히지 않아 ",{"_2579":13250,"_2420":2579,"_3365":13251},"EADDRINUSE",{"_3351":3367},{"_2579":13253,"_2420":2579}," 오류를 뿜어내는 현상입니다.",{"_950":13255,"_2420":2570,"_2571":13256},"0f29a5c8-85c7-472a-9a81-726487511a19",[],{"_950":13258,"_2420":2570,"_2571":13259},"f94a0da0-5b03-420f-9430-9f19fe343fa5",[13260,13262,13265,13266,13269,13271,13274],{"_2579":13261,"_2420":2579},"이를 완벽히 방지하려면 NestJS의 애플리케이션 수명 주기 관리 기능을 활용해, 모듈이 교체되기 직전 기존 인스턴스를 명시적으로 해제해야 합니다. Rspack 환경에서 ",{"_2579":13263,"_2420":2579,"_3365":13264},"@rspack/core/hot/poll?100",{"_3351":3367},{"_2579":7813,"_2420":2579},{"_2579":13267,"_2420":2579,"_3365":13268},"run-script-webpack-plugin",{"_3351":3367},{"_2579":13270,"_2420":2579},"을 결합하여 HMR 환경을 구축했다면, 메인 엔트리포인트 파일인 ",{"_2579":13272,"_2420":2579,"_3365":13273},"main.ts",{"_3351":3367},{"_2579":13275,"_2420":2579},"에 수명 주기 클린업 로직을 반드시 삽입해야 합니다.",{"_950":13277,"_2420":2570,"_2571":13278},"527747ef-e08f-4c5f-af0f-8a6c019707e4",[],{"_950":13280,"_2420":2570,"_2571":13281},"80a48352-41f7-407f-a938-ab5d16b1ab2f",[13282,13284,13286],{"_2579":13283,"_2420":2579},"개발 환경에서 소켓 충돌 없이 백엔드 인스턴스를 안전하게 재부팅하는 ",{"_2579":13272,"_2420":2579,"_3365":13285},{"_3351":3367},{"_2579":13287,"_2420":2579}," 설정은 다음과 같습니다.",{"_950":13289,"_2420":2570,"_2571":13290},"7c4dce14-a5a9-4b1b-bed7-4cfd623da1fc",[],{"_950":13292,"_3351":13293,"_2420":3351,"_625":3125},"e8f0be8e-b19d-4cd0-8763-4b6d41e6ab6c","// main.ts (NestJS 12 / Rspack HMR 대응)\nimport { NestFactory } from '@nestjs/core';\nimport { AppModule } from './app.module';\n\ndeclare const module: any;\n\nasync function bootstrap() {\n const app = await NestFactory.create(AppModule);\n await app.listen(3000);\n\n if (module.hot) {\n module.hot.accept();\n module.hot.dispose(() => app.close());\n }\n}\nbootstrap();",{"_950":13295,"_2420":2570,"_2571":13296},"1110c04d-7a67-4058-af70-3d2ba4076719",[],{"_950":13298,"_2420":2570,"_2571":13299},"bae8638f-74a1-4c2b-8964-926cd4b5f83a",[13300,13302,13305,13307,13310],{"_2579":13301,"_2420":2579},"이처럼 ",{"_2579":13303,"_2420":2579,"_3365":13304},"module.hot.dispose",{"_3351":3367},{"_2579":13306,"_2420":2579}," 콜백 내부에서 ",{"_2579":13308,"_2420":2579,"_3365":13309},"app.close()",{"_3351":3367},{"_2579":13311,"_2420":2579},"를 호출해 두면, 새로운 코드가 반영되기 전에 활성화되어 있던 HTTP 서버 소켓이 확실하게 정리되어 매끄럽고 빠른 핫 리로드 환경을 완성할 수 있습니다.",{"_950":13313,"_2420":2570,"_2571":13314},"e4276e9f-93a7-4231-9d67-7a0555df0058",[],{"_950":13316,"_2420":2575,"_2576":2007,"_2571":13317},"c3efd109-06ff-45b0-9e4f-50f063ab2ae2",[13318],{"_2579":13319,"_2420":2579},"Nx 모노레포에서의 Rspack 커스텀 어댑터 구성",{"_950":13321,"_2420":2570,"_2571":13322},"b8da32da-56be-4b56-a965-365b9ce03fe8",[],{"_950":13324,"_2420":2570,"_2571":13325},"d78a14ab-e464-4782-9ed5-45e85b2015ef",[13326,13328,13331],{"_2579":13327,"_2420":2579},"Nx 모노레포 환경에서 제공하는 ",{"_2579":13329,"_2420":2579,"_3365":13330},"@nx/rspack:convert-webpack",{"_3351":3367},{"_2579":13332,"_2420":2579}," 같은 자동 전환 도구는 백엔드 노드 애플리케이션의 웹팩 설정을 마이그레이션할 때 예기치 못한 누락을 자주 일으킵니다. 프론트엔드 빌드와 달리 백엔드 빌드는 파일 시스템 접근이나 네이티브 모듈 바인딩 등 노드 런타임의 특성을 고려해야 하므로 자동 변환 도구에만 의존하기보다 수동으로 커스텀 설정을 구성하는 편이 훨씬 안정적입니다.",{"_950":13334,"_2420":2570,"_2571":13335},"1c4a8956-4e98-4a47-88b4-a58bdf50a1e4",[],{"_950":13337,"_2420":2570,"_2571":13338},"1005e881-0999-47f8-b295-c2cbdcf5ed51",[13339,13341,13343,13345,13348,13350,13353],{"_2579":13340,"_2420":2579},"수동 설정의 핵심은 빌드 대상 플랫폼을 노드로 명시하고 외부 의존성이 번들 결과물에 통째로 묶이는 문제를 방지하는 것입니다. 이를 위해 애플리케이션 루트에 ",{"_2579":13141,"_2420":2579,"_3365":13342},{"_3351":3367},{"_2579":13344,"_2420":2579}," 파일을 생성하고 ",{"_2579":13346,"_2420":2579,"_3365":13347},"nodeExternals",{"_3351":3367},{"_2579":13349,"_2420":2579},"를 적용하여 ",{"_2579":13351,"_2420":2579,"_3365":13352},"node_modules",{"_3351":3367},{"_2579":13354,"_2420":2579}," 폴더의 패키지들을 번들링 대상에서 제외해야 합니다.",{"_950":13356,"_2420":2570,"_2571":13357},"8e282eba-5c00-4f53-90d5-06a8b311fdce",[],{"_950":13359,"_2420":2570,"_2571":13360},"09aa7f09-cdb3-46bc-a14f-f02a8f03c630",[13361],{"_2579":13362,"_2420":2579},"Nx 환경에서 동작하는 NestJS용 커스텀 Rspack 설정 예시입니다. Nx 19 이상 버전을 기준으로 작성되었습니다.",{"_950":13364,"_2420":2570,"_2571":13365},"30e52cda-ce80-4b53-b18a-b04a7502dce3",[],{"_950":13367,"_3351":13368,"_2420":3351,"_625":7690},"69a589ac-ec2a-4aa8-a0fa-1632e8b4cdd3","import { composePlugins, withNx } from '@nx/rspack';\nimport nodeExternals from 'webpack-node-externals';\n\nexport default composePlugins(withNx(), (config) => {\n config.target = 'node';\n config.externalsPreset = { node: true };\n config.externals = [\n nodeExternals({\n allowlist: [/^@monorepo\\//] \n })\n ];\n return config;\n});",{"_950":13370,"_2420":2570,"_2571":13371},"7732ef0d-ab2d-4c38-ad1c-897e3003a48d",[],{"_950":13373,"_2420":2570,"_2571":13374},"333e60b2-be02-4a4f-be61-9d680577b97a",[13375],{"_2579":13376,"_2420":2579},"이와 같이 커스텀 어댑터를 구성하면 불필요한 서드파티 라이브러리가 번들에 포함되는 문제를 확실하게 차단할 수 있습니다. 결과적으로 모노레포 내부의 공유 라이브러리만 안전하게 컴파일에 포함되므로 빌드 속도가 획기적으로 개선되고 프로덕션 환경의 이미지 용량도 크게 최적화됩니다.",{"_950":13378,"_2420":2570,"_2571":13379},"a0572cbe-6368-44cf-81df-b32163e348cd",[],{"_950":13381,"_2420":2575,"_2576":2007,"_2571":13382},"68fb9bba-ce95-4f65-9c30-4add89a1a54e",[13383],{"_2579":13384,"_2420":2579},"Rspack 도입, 어떻게 준비할 것인가",{"_950":13386,"_2420":2570,"_2571":13387},"0ca5e06e-a305-4909-ba85-dafc6a6d5173",[],{"_950":13389,"_2420":2570,"_2571":13390},"0959b1e0-2c47-4153-a2e6-c58e116557cf",[13391,13393,13396],{"_2579":13392,"_2420":2579},"NestJS 12와 Rspack의 결합은 대규모 모노레포를 운영하는 개발팀에게 빌드 속도 정체를 해결해 줄 확실한 돌파구입니다. 현재 제공되는 ",{"_2579":13394,"_2420":2579,"_3365":13395},"@nestjs/cli@next",{"_3351":3367},{"_2579":13397,"_2420":2579}," 프리릴리즈 패키지를 통해 미리 마이그레이션을 검토하고, 앞서 다룬 데코레이터 메타데이터와 클래스명 유지 설정을 점검해 보시길 권장합니다. 프로덕션 빌드의 안정성과 로컬 개발 경험을 미리 검증해 둔다면, 다가오는 공식 릴리즈 시점에 별다른 혼선 없이 압도적인 빌드 속도 개선을 누릴 수 있습니다.",{"_950":13399,"_2420":2570,"_2571":13400},"1b5b3283-abc4-4671-bbfe-88665739aa51",[],{"_950":13402,"_2420":3473},"0a1ff500-3e17-45cb-a3f3-fad92cf3cc8f",{"_950":13404,"_2420":2570,"_2571":13405},"337f0bd5-832b-4660-9b94-78a3d4413522",[],{"_950":13407,"_2420":2570,"_2571":13408},"4e61c996-27cd-4544-8311-fd3395473e56",[13409],{"_2579":3483,"_2420":2579,"_3365":13410},{"_3485":3367},{"_950":13412,"_2420":2570,"_2571":13413},"6ea66631-61d4-4faf-baa0-d1431f2415d3",[],{"_950":13415,"_1881":3492,"_2420":3493,"_778":13416},"8ee1eb47-882e-4543-9a84-f4936d95d88a",[13417,13425,13433],{"_950":13418,"_2571":13419},"23711f11-b6fd-440d-98c2-cbbf1c9b77e4",[13420],{"_3499":13421,"_2420":3501,"_3502":13422},"https://github.com/nrwl/nx/issues/30292",[13423],{"_2579":13424,"_2420":2579},"nrwl/nx GitHub Issues — Nx Monorepo Conversion Gaps",{"_950":13426,"_2571":13427},"e515a8e7-37f2-413f-9427-d6d7fd3bd4a2",[13428],{"_3499":13429,"_2420":3501,"_3502":13430},"https://rspack.dev/guide/tech/nestjs",[13431],{"_2579":13432,"_2420":2579},"Rspack Documentation & GitHub Issues — Common Pitfall: TS Decorator Metadata and SWC Configuration",{"_950":13434,"_2571":13435},"e49ec2b1-39dd-4981-92f5-d5c51af31f0d",[13436],{"_3499":13437,"_2420":3501,"_3502":13438},"https://github.com/web-infra-dev/rspack/issues/10393",[13439],{"_2579":13440,"_2420":2579},"web-infra-dev/rspack GitHub Repository — Common Pitfall: Production Class-Name Mangling",{"_13389":13442,"_13359":13447,"_13337":13451,"_13061":13456,"_13121":13458,"_13373":13463,"_13215":13467,"_13237":13471,"_13407":13475,"_13155":13477,"_13138":13481,"_13381":13486,"_13092":13490,"_13280":13494,"_13163":13499,"_13415":13503,"_13229":13510,"_13184":13514,"_13245":13519,"_13100":13524,"_13171":13528,"_13298":13533,"_13068":13538,"_13076":13542,"_13316":13546,"_13324":13550,"_13108":13555,"_13084":13560,"_13258":13564},{"_2571":13443},{"_1892":13444,"_1893":13445,"_1802":13446},"The combination of NestJS 12 and Rspack is a breakthrough for development teams managing large-scale monorepos who are struggling with sluggish build speeds. I recommend reviewing your migration in advance using the available `@nestjs/cli@next` pre-release package and checking the decorator metadata and class-name preservation settings discussed above. By validating production build stability and the local development experience beforehand, you can enjoy dramatic build speed improvements without any confusion when the official release arrives.","NestJS 12とRspackの組み合わせは、大規模モノレポを運用する開発チームにとって、ビルド速度の停滞を解消する確実な突破口となります。現在提供されている@nestjs/cli@nextのプレリリースパッケージを通じてあらかじめ移行を検討し、先述したデコレータメタデータとクラス名保持の設定を確認しておくことを推奨します。本番ビルドの安定性とローカル開発体験を事前に検証しておけば、今後の正式リリース時に大きな混乱なく、圧倒的なビルド速度の向上を享受できるでしょう。","NestJS 12와 Rspack의 결합은 대규모 모노레포를 운영하는 개발팀에게 빌드 속도 정체를 해결해 줄 확실한 돌파구입니다. 현재 제공되는 @nestjs/cli@next 프리릴리즈 패키지를 통해 미리 마이그레이션을 검토하고, 앞서 다룬 데코레이터 메타데이터와 클래스명 유지 설정을 점검해 보시길 권장합니다. 프로덕션 빌드의 안정성과 로컬 개발 경험을 미리 검증해 둔다면, 다가오는 공식 릴리즈 시점에 별다른 혼선 없이 압도적인 빌드 속도 개선을 누릴 수 있습니다.",{"_2571":13448},{"_1892":13449,"_1893":13450,"_1802":13362},"Here is an example of a custom Rspack configuration for NestJS operating in an Nx environment. This was written based on Nx 19 or higher.","Nx環境で動作するNestJS用カスタムRspack設定の例です。Nx 19以上のバージョンを基準に作成されています。",{"_2571":13452},{"_1892":13453,"_1893":13454,"_1802":13455},"The key to manual configuration is specifying the build target as 'node' and preventing external dependencies from being bundled into the output. To achieve this, create an `rspack.config.mjs` file in the application root and apply `nodeExternals` to exclude packages in the `node_modules` folder from the bundling process.","手動設定の要点は、ビルド対象プラットフォームをnodeに明示し、外部依存関係がバンドル結果に丸ごと含まれてしまう問題を防止することです。このため、アプリケーションルートにrspack.config.mjsファイルを作成し、nodeExternalsを適用してnode_modulesフォルダーのパッケージをバンドル対象から除外する必要があります。","수동 설정의 핵심은 빌드 대상 플랫폼을 노드로 명시하고 외부 의존성이 번들 결과물에 통째로 묶이는 문제를 방지하는 것입니다. 이를 위해 애플리케이션 루트에 rspack.config.mjs 파일을 생성하고 nodeExternals를 적용하여 node_modules 폴더의 패키지들을 번들링 대상에서 제외해야 합니다.",{"_2571":13457},{"_1892":12984,"_1893":12985,"_1802":12986},{"_2571":13459},{"_1892":13460,"_1893":13461,"_1802":13462},"Since SWC does not generate decorator metadata by default during compilation, dependency injection will fail completely without explicit configuration. To fix this, you must enable the `legacyDecorator` and `decoratorMetadata` options for the SWC loader in your Rspack configuration file.","SWCはデフォルトの状態ではコンパイル時にデコレータメタデータを生成しないため、明示的な設定を追加しなければ依存性の注入は完全に失敗します。この問題を解決するには、Rspack設定ファイルでSWCローダーの「legacyDecorator」および「decoratorMetadata」オプションを必ず有効にする必要があります。","SWC는 기본 상태에서 컴파일 시점에 데코레이터 메타데이터를 생성하지 않으므로, 명시적인 설정을 추가하지 않으면 의존성 주입이 완전히 실패합니다. 이 문제를 해결하려면 Rspack 설정 파일에서 SWC 로더의 legacyDecorator와 decoratorMetadata 옵션을 반드시 활성화해야 합니다.",{"_2571":13464},{"_1892":13465,"_1893":13466,"_1802":13376},"Configuring a custom adapter this way ensures that unnecessary third-party libraries are not included in the bundle. As a result, only the shared libraries within the monorepo are included in the compilation, which drastically improves build speed and significantly optimizes the size of your production images.","このようにカスタムアダプターを構成すれば、不要なサードパーティライブラリがバンドルに含まれる問題を確実に防ぐことができます。結果として、モノレポ内部の共有ライブラリのみが安全にコンパイルに含まれるため、ビルド速度が劇的に改善され、本番環境のイメージ容量も大幅に最適化されます。",{"_2571":13468},{"_1892":13469,"_1893":13470,"_1802":13218},"Here is an optimization example that ensures production stability for NestJS applications via Rspack configuration.","以下は、Rspack設定を通じてNestJSアプリケーションの本番安定性を確保する最適化の例です。",{"_2571":13472},{"_1892":13473,"_1893":13474,"_1802":13240},"Key Challenge 3: HMR Socket Conflicts and EADDRINUSE Errors","核心的な壁3：HMRソケット競合とEADDRINUSEエラー",{"_2571":13476},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":13478},{"_1892":13479,"_1893":13480,"_1802":13158},"If this configuration is not applied, the application will encounter a runtime crash because it cannot identify dependencies during startup. Consequently, this is an essential checkpoint to verify immediately when starting your Rspack migration.","この設定が適用されていないと、アプリケーション起動時に依存関係を識別できず、ランタイムクラッシュが発生します。そのため、Rspack移行を開始する際に、まず最初に正しく動作するか確認すべき必須のチェックポイントです。",{"_2571":13482},{"_1892":13483,"_1893":13484,"_1802":13485},"You can restore metadata perfectly by customizing the loader settings in your `rspack.config.mjs` file as follows.","rspack.config.mjsファイルで以下のようにローダー設定をカスタマイズすることで、メタデータを完全に復元できます。","rspack.config.mjs 파일에서 다음과 같이 로더 설정을 커스텀하여 메타데이터를 완벽하게 복원할 수 있습니다.",{"_2571":13487},{"_1892":13488,"_1893":13489,"_1802":13384},"How to Prepare for the Rspack Adoption","Rspack導入、どう準備するか",{"_2571":13491},{"_1892":13492,"_1893":13493,"_1802":13095},"According to the official announcement from Trilon Consulting, NestJS 12 introduces a modern, high-speed toolchain featuring native ESM support, Vitest, oxlint, and Rspack. This evolution allows developers to significantly reduce cold starts and wait times when modifying source code, even in large backend codebases. The primary reason for this migration is the ability to leverage the overwhelming performance of a Rust-based bundler while still utilizing most of the existing Webpack plugin ecosystem.","Trilon Consultingの公式発表によると、NestJS 12はネイティブESMへの移行とともに、Vitest、oxlint、そしてRspackへと続く現代的で超高速なツールチェーンを提供します。この変化のおかげで、開発者は重いバックエンドのコードベースであっても、コールドスタートやソースコード変更時の待ち時間を大幅に短縮できます。既存のWebpackプラグインエコシステムのほとんどを活用しながら、Rustバンドラーの圧倒的な性能を容易に確保できるという点が、移行の最大の理由です。",{"_2571":13495},{"_1892":13496,"_1893":13497,"_1802":13498},"Here is the `main.ts` configuration to safely reboot the backend instance without socket conflicts in a development environment.","開発環境でソケット競合を起こさず、バックエンドインスタンスを安全に再起動するmain.tsの設定は以下の通りです。","개발 환경에서 소켓 충돌 없이 백엔드 인스턴스를 안전하게 재부팅하는 main.ts 설정은 다음과 같습니다.",{"_2571":13500},{"_1892":13501,"_1893":13502,"_1802":13166},"Key Challenge 2: Preventing Class-Name Mangling in Production Builds","核心的な壁2：本番ビルド時のクラス名難読化防止",{"_13504":13505,"_13506":13507,"_13508":13509},"item:23711f11-b6fd-440d-98c2-cbbf1c9b77e4",{"_1892":13424,"_1893":13424,"_1802":13424},"item:e49ec2b1-39dd-4981-92f5-d5c51af31f0d",{"_1892":13440,"_1893":13440,"_1802":13440},"item:e515a8e7-37f2-413f-9427-d6d7fd3bd4a2",{"_1892":13432,"_1893":13432,"_1802":13432},{"_2571":13511},{"_1892":13512,"_1893":13513,"_1802":13232},"Adding this configuration ensures that the minifier keeps the original class name structure intact. This allows the NestJS engine's metadata mapping flow to maintain perfect consistency, even after production deployment.","この設定を追加すれば、コード圧縮を行うコンパイラが元のクラス名の構造を安全に維持します。これにより、本番環境へのデプロイ後もNestJSエンジンのメタデータマッピングの流れが途切れず、完璧に一貫性を保持できます。",{"_2571":13515},{"_1892":13516,"_1893":13517,"_1802":13518},"To prevent this malfunction, you must ensure the build toolchain preserves the original names of classes and functions. You can achieve this by manually editing the `compress` and `mangle` rules in the optimization settings of `SwcJsMinimizerRspackPlugin` (Rspack's built-in JS minifier) to enable the `keep_classnames` and `keep_fnames` properties.","この誤動作を根本的に防ぐには、ビルドツールチェーンがクラスと関数の元の名前を保持するように対策しなければなりません。Rspackの内蔵JavaScript圧縮プラグイン「SwcJsMinimizerRspackPlugin」の最適化設定において、compressとmangleルールを手動で編集し、「keep_classnames」および「keep_fnames」プロパティを有効にすれば解決します。","이 오동작을 원천적으로 막기 위해서는 빌드 도구 체인이 클래스와 함수의 원본 이름을 보존하도록 조치해야 합니다. Rspack의 내장 자바스크립트 압축 플러그인인 SwcJsMinimizerRspackPlugin의 최적화 설정에서 compress와 mangle 규칙을 수동으로 편집하여 keep_classnames 및 keep_fnames 속성을 활성화해 주면 됩니다.",{"_2571":13520},{"_1892":13521,"_1893":13522,"_1802":13523},"To fully enjoy Rspack's overwhelming build speed in a development server, enabling Hot Module Replacement (HMR) is essential. However, applying this to a backend environment often leads to the pitfall of port occupancy errors. Because HMR replaces modules while keeping the process alive, it often fails to properly close the network socket used by the previous instance, resulting in `EADDRINUSE` errors.","Rspackの圧倒的なビルド速度を開発サーバーで完全に享受するにはホットリロード（HMR）の有効化が不可欠ですが、これをバックエンドに適用すると「ポート占有エラー」という伏兵に遭遇します。コードが変更されるたびにプロセスを維持したままモジュールだけを差し替えるHMRの特性上、以前のアプリケーションインスタンスが使用していたネットワークソケットが正常に閉じられず、EADDRINUSEエラーが発生する現象です。","Rspack의 압도적인 빌드 속도를 개발 서버에서 온전히 누리려면 핫 리로드 활성화가 필수적이지만, 이를 백엔드에 적용하면 포트 점유 오류라는 복병을 만나게 됩니다. 코드가 변경될 때마다 프로세스는 유지된 채 모듈만 교체되는 HMR 특성상, 이전 애플리케이션 인스턴스가 사용하던 네트워크 소켓이 정상적으로 닫히지 않아 EADDRINUSE 오류를 뿜어내는 현상입니다.",{"_2571":13525},{"_1892":13526,"_1893":13527,"_1802":13103},"Key Challenge 1: Restoring SWC Decorator Metadata","核心的な壁1：SWCデコレータメタデータの復元",{"_2571":13529},{"_1892":13530,"_1893":13531,"_1802":13532},"The biggest trap to watch out for when running production builds with Rspack is the mangling of class and function names. By default, Rspack's built-in minifier shortens internal identifiers to random characters to minimize file size. However, NestJS frequently uses actual class names and references as identifiers—for instance, when generating DI tokens or calling `context.getClass()` to query the execution context. If these names are mangled, the runtime fails to locate required guards or service instances, leading to abnormal routing blocks or dependency resolution errors.","Rspackで本番ビルドを行う際に最も注意すべき落とし穴は、クラス名と関数名の難読化処理です。Rspackが提供するデフォルトのコード圧縮器は、ファイルサイズを最小化するために内部識別子をランダムな文字列に短縮します。しかし、NestJSは依存性の注入トークンを作成したり、実行コンテキストを照会するcontext.getClass()メソッドなどを実行したりする際に、クラスの実際の名前と参照を識別子として頻繁に活用します。クラス名が勝手に変更されると、ランタイムで必要なガードやサービスインスタンスを正常に見つけられず、異常なルーティング遮断や依存関係解決失敗のエラーに直面することになります。","Rspack으로 프로덕션 빌드를 수행할 때 가장 주의해야 할 함정은 클래스명과 함수명의 난독화 처리입니다. Rspack이 제공하는 기본 코드 압축기는 파일 크기를 최소화하기 위해 내부 식별자를 무작위 문자로 축소합니다. 하지만 NestJS는 의존성 주입 토큰을 생성하거나, 실행 컨텍스트를 조회하는 context.getClass() 메서드 등을 실행할 때 클래스의 실제 이름과 참조를 식별자로 자주 활용합니다. 클래스명이 임의로 변경되면 런타임에서 필요한 가드나 서비스 인스턴스를 정상적으로 찾아내지 못해 비정상적인 라우팅 차단이나 의존성 해결 실패 오류를 직면하게 됩니다.",{"_2571":13534},{"_1892":13535,"_1893":13536,"_1802":13537},"By calling `app.close()` inside the `module.hot.dispose` callback, you ensure the active HTTP server socket is cleaned up before new code is applied, enabling a smooth and rapid HMR experience.","このように、module.hot.disposeコールバック内でapp.close()を呼び出しておけば、新しいコードが反映される前に有効だったHTTPサーバーソケットが確実に解放され、スムーズで高速なホットリロード環境を完成させることができます。","이처럼 module.hot.dispose 콜백 내부에서 app.close()를 호출해 두면, 새로운 코드가 반영되기 전에 활성화되어 있던 HTTP 서버 소켓이 확실하게 정리되어 매끄럽고 빠른 핫 리로드 환경을 완성할 수 있습니다.",{"_2571":13539},{"_1892":13540,"_1893":13541,"_1802":13071},"NestJS 12 is officially moving away from Webpack in its CLI, adopting the Rust-based, ultra-fast Rspack as its primary build tool. With build speed now a critical factor in the productivity of large-scale monorepos, the shift to Rspack is a highly welcome change. However, replacing your existing build system can often lead to tricky technical hurdles, such as missing SWC decorator metadata or issues with class-name mangling in production builds. I have compiled a practical, field-tested guide to help you smoothly navigate these migration challenges in your NestJS 12 monorepo and maximize the benefits of adopting Rspack.","NestJS 12では、公式CLIにおける従来のWebpackサポートが終了し、Rustベースの超高速バンドラーであるRspackが公式ビルドツールとして採用されます。ビルド速度が大規模モノレポの開発生産性を左右する重要な要素となった今、Rspackへの移行は非常に歓迎すべき変化です。しかし、既存のビルド体系を入れ替える過程では、SWCデコレータメタデータの欠落や、本番ビルド時のクラス名難読化といった難しい技術的な壁に直面しがちです。NestJS 12ベースのモノレポ環境で、これらの現実的な移行課題をスムーズに解決し、Rspack導入の効果を最大化するための実務的なガイドをまとめました。",{"_2571":13543},{"_1892":13544,"_1893":13545,"_1802":13079},"Benefits of Switching to Rspack: Why Replace Webpack?","Rspack移行の利点：なぜWebpackを置き換えるのか",{"_2571":13547},{"_1892":13548,"_1893":13549,"_1802":13319},"Configuring Custom Rspack Adapters in Nx Monorepos","NxモノレポでのRspackカスタムアダプター構成",{"_2571":13551},{"_1892":13552,"_1893":13553,"_1802":13554},"Automated conversion tools provided in Nx monorepos, such as `@nx/rspack:convert-webpack`, often cause unexpected omissions when migrating Webpack configurations for Node.js backend applications. Unlike frontend builds, backend builds must account for Node runtime specifics like file system access and native module bindings. Therefore, it is much more reliable to configure custom settings manually rather than relying solely on automated conversion tools.","Nxモノレポ環境で提供される@nx/rspack:convert-webpackのような自動変換ツールは、バックエンドのNode.jsアプリケーションのWebpack設定を移行する際に、予期せぬ設定漏れを頻繁に起こします。フロントエンドのビルドとは異なり、バックエンドビルドはファイルシステムアクセスやネイティブモジュールのバインディングなど、Node.jsランタイムの特性を考慮する必要があるため、自動変換ツールだけに依存せず、手動でカスタム設定を構築する方がはるかに安定しています。","Nx 모노레포 환경에서 제공하는 @nx/rspack:convert-webpack 같은 자동 전환 도구는 백엔드 노드 애플리케이션의 웹팩 설정을 마이그레이션할 때 예기치 못한 누락을 자주 일으킵니다. 프론트엔드 빌드와 달리 백엔드 빌드는 파일 시스템 접근이나 네이티브 모듈 바인딩 등 노드 런타임의 특성을 고려해야 하므로 자동 변환 도구에만 의존하기보다 수동으로 커스텀 설정을 구성하는 편이 훨씬 안정적입니다.",{"_2571":13556},{"_1892":13557,"_1893":13558,"_1802":13559},"To maximize build speed, Rspack uses the built-in `builtin:swc-loader` instead of `tsc` to compile TypeScript code. While this drastically boosts performance, it hits a critical barrier in NestJS environments: runtime errors. This is because NestJS's core mechanism—Dependency Injection (DI)—relies on decorator metadata.","Rspackはビルド速度を最大化するため、デフォルトでtscの代わりに内蔵のSWCローダーである「builtin:swc-loader」を使用してTypeScriptコードをコンパイルします。この手法はビルド性能を劇的に向上させますが、NestJS環境ではランタイムエラーという致命的な壁にぶつかります。NestJSの中核メカニズムである依存性の注入（DI）が、デコレータメタデータに依存して動作しているためです。","Rspack은 빌드 속도를 극대화하기 위해 기본적으로 tsc 대신 내장된 SWC 로더인 builtin:swc-loader를 사용하여 TypeScript 코드를 컴파일합니다. 이 방식은 빌드 성능을 비약적으로 끌어올리지만, NestJS 환경에서는 런타임 오류라는 치명적인 장벽을 만나게 됩니다. NestJS의 핵심 메커니즘인 의존성 주입이 데코레이터 메타데이터를 기반으로 동작하기 때문입니다.",{"_2571":13561},{"_1892":13562,"_1893":13563,"_1802":13087},"NestJS 12 has dropped support for Webpack, a long-time mainstay of its official CLI, and adopted the high-performance, Rust-based Rspack as its official build tool. In large monorepo environments, Webpack's slow compilation and heavy hot-reloading were major bottlenecks that hindered development flow. Rspack solves these issues by offering superior build performance while maintaining excellent compatibility with the Webpack architecture and configuration framework.","NestJS 12では、長年公式CLIの中核を担ってきたWebpackのサポートを終了し、Rustベースの超高速バンドラー「Rspack」を公式ビルドツールとして採用しました。大規模モノレポ環境において、Webpackの遅いコンパイルと重いホットリロードは、開発フローを阻害する最大のボトルネックでした。Rspackは、Webpackのアーキテクチャや設定フレームワークとの高い互換性を維持しつつ、ビルドパフォーマンスを圧倒的に向上させることでこの問題を解決します。",{"_2571":13565},{"_1892":13566,"_1893":13567,"_1802":13568},"To completely prevent this, you should use NestJS's application lifecycle management to explicitly terminate the existing instance before modules are swapped. If you have set up an HMR environment in Rspack by combining `@rspack/core/hot/poll?100` and `run-script-webpack-plugin`, you must insert lifecycle cleanup logic into your main entry point file, `main.ts`.","これを完璧に防ぐには、NestJSのアプリケーションライフサイクル管理機能を利用して、モジュールが差し替えられる直前に既存のインスタンスを明示的に解放する必要があります。Rspack環境で@rspack/core/hot/poll?100とrun-script-webpack-pluginを組み合わせてHMR環境を構築した場合は、メインエントリーポイントであるmain.tsにライフサイクルクリーンアップロジックを必ず挿入してください。","이를 완벽히 방지하려면 NestJS의 애플리케이션 수명 주기 관리 기능을 활용해, 모듈이 교체되기 직전 기존 인스턴스를 명시적으로 해제해야 합니다. Rspack 환경에서 @rspack/core/hot/poll?100과 run-script-webpack-plugin을 결합하여 HMR 환경을 구축했다면, 메인 엔트리포인트 파일인 main.ts에 수명 주기 클린업 로직을 반드시 삽입해야 합니다.","![NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기](file:cmrvvjk3w02jw10munggbd5c9)\n\n# NestJS 12 Rspack 마이그레이션 — 모노레포 빌드 속도 올리기\n\nNestJS 12가 공식 CLI에서 기존 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 도입합니다. 빌드 속도가 대규모 모노레포의 개발 생산성을 결정짓는 핵심 요소가 된 지금, Rspack으로의 전환은 대단히 반가운 변화입니다. 하지만 기존 빌드 체계를 교체하는 과정에서 SWC 데코레이터 메타데이터 누락이나 프로덕션 빌드의 클래스명 난독화 같은 까다로운 기술 장벽에 부딪히기 쉽습니다. NestJS 12 기반 모노레포 환경에서 이러한 현실적인 마이그레이션 문제를 매끄럽게 해결하고, Rspack 도입 효과를 극대화할 수 있는 실무 실전 가이드를 정리했습니다.\n\n## Rspack 전환의 이점: 왜 Webpack을 대체하는가\n\nNestJS 12는 오랫동안 공식 CLI의 중심을 지켰던 웹팩 지원을 중단하고 Rust 기반의 초고속 번들러인 Rspack을 공식 빌드 도구로 채택했습니다. 대규모 모노레포 환경에서 웹팩의 느린 컴파일과 무거운 핫 리로드는 개발 흐름을 끊는 가장 큰 병목이었습니다. Rspack은 웹팩 아키텍처 및 설정 프레임워크와 뛰어난 호환성을 유지하면서도 빌드 성능을 압도적으로 끌어올려 이 문제를 해결합니다.\n\nTrilon Consulting의 공식 발표에 따르면 NestJS 12는 네이티브 ESM 전환과 함께 Vitest, oxlint, 그리고 Rspack으로 이어지는 현대적인 초고속 도구 체인을 제공합니다. 이 변화 덕분에 개발자는 무거운 백엔드 코드베이스에서도 콜드 스타트와 소스 코드 변경 시 발생하는 대기 시간을 대폭 줄일 수 있습니다. 기존 웹팩 플러그인 생태계를 대부분 그대로 활용하면서 Rust 번들러의 압도적인 성능을 손쉽게 확보할 수 있다는 점이 마이그레이션의 가장 큰 이유입니다.\n\n## 핵심 장벽 1: SWC 데코레이터 메타데이터 복원\n\nRspack은 빌드 속도를 극대화하기 위해 기본적으로 tsc 대신 내장된 SWC 로더인 `builtin:swc-loader`를 사용하여 TypeScript 코드를 컴파일합니다. 이 방식은 빌드 성능을 비약적으로 끌어올리지만, NestJS 환경에서는 런타임 오류라는 치명적인 장벽을 만나게 됩니다. NestJS의 핵심 메커니즘인 의존성 주입이 데코레이터 메타데이터를 기반으로 동작하기 때문입니다.\n\nSWC는 기본 상태에서 컴파일 시점에 데코레이터 메타데이터를 생성하지 않으므로, 명시적인 설정을 추가하지 않으면 의존성 주입이 완전히 실패합니다. 이 문제를 해결하려면 Rspack 설정 파일에서 SWC 로더의 `legacyDecorator`와 `decoratorMetadata` 옵션을 반드시 활성화해야 합니다.\n\n`rspack.config.mjs` 파일에서 다음과 같이 로더 설정을 커스텀하여 메타데이터를 완벽하게 복원할 수 있습니다.\n\n```javascript\n// rspack.config.mjs\nexport default {\n module: {\n rules: [\n {\n test: /\\.ts$/,\n use: {\n loader: 'builtin:swc-loader',\n options: {\n jsc: {\n parser: { syntax: 'typescript', decorators: true },\n transform: { legacyDecorator: true, decoratorMetadata: true }\n }\n }\n }\n }\n ]\n }\n};\n```\n\n해당 설정이 적용되지 않으면 애플리케이션 구동 시 의존성을 식별하지 못해 런타임 크래시가 발생합니다. 따라서 Rspack 마이그레이션을 시작할 때 가장 먼저 올바르게 작동하는지 확인해야 할 필수 체크포인트입니다.\n\n## 핵심 장벽 2: 프로덕션 빌드의 클래스명 난독화 방지\n\nRspack으로 프로덕션 빌드를 수행할 때 가장 주의해야 할 함정은 클래스명과 함수명의 난독화 처리입니다. Rspack이 제공하는 기본 코드 압축기는 파일 크기를 최소화하기 위해 내부 식별자를 무작위 문자로 축소합니다. 하지만 NestJS는 의존성 주입 토큰을 생성하거나, 실행 컨텍스트를 조회하는 `context.getClass()` 메서드 등을 실행할 때 클래스의 실제 이름과 참조를 식별자로 자주 활용합니다. 클래스명이 임의로 변경되면 런타임에서 필요한 가드나 서비스 인스턴스를 정상적으로 찾아내지 못해 비정상적인 라우팅 차단이나 의존성 해결 실패 오류를 직면하게 됩니다.\n\n이 오동작을 원천적으로 막기 위해서는 빌드 도구 체인이 클래스와 함수의 원본 이름을 보존하도록 조치해야 합니다. Rspack의 내장 자바스크립트 압축 플러그인인 `SwcJsMinimizerRspackPlugin`의 최적화 설정에서 `compress`와 `mangle` 규칙을 수동으로 편집하여 `keep\\_classnames` 및 `keep\\_fnames` 속성을 활성화해 주면 됩니다.\n\n다음은 Rspack 설정을 통해 NestJS 애플리케이션의 프로덕션 안정성을 확보하는 최적화 예시입니다.\n\n```javascript\n// rspack.config.mjs (Rspack 1.x 및 NestJS 12 기준)\nimport { rspack } from '@rspack/core';\n\nexport default {\n optimization: {\n minimizer: [\n new rspack.SwcJsMinimizerRspackPlugin({\n minimizerOptions: {\n compress: { keep_classnames: true, keep_fnames: true },\n mangle: { keep_classnames: true, keep_fnames: true }\n }\n })\n ]\n }\n};\n```\n\n이 설정을 추가하면 코드 압축을 진행하는 컴파일러가 원본 클래스명 구조를 안전하게 유지합니다. 이를 통해 프로덕션 배포 후에도 NestJS 엔진의 메타데이터 매핑 흐름이 깨지지 않고 완벽하게 일관성을 유지할 수 있습니다.\n\n## 핵심 장벽 3: HMR 소켓 충돌과 EADDRINUSE 오류\n\nRspack의 압도적인 빌드 속도를 개발 서버에서 온전히 누리려면 핫 리로드 활성화가 필수적이지만, 이를 백엔드에 적용하면 포트 점유 오류라는 복병을 만나게 됩니다. 코드가 변경될 때마다 프로세스는 유지된 채 모듈만 교체되는 HMR 특성상, 이전 애플리케이션 인스턴스가 사용하던 네트워크 소켓이 정상적으로 닫히지 않아 `EADDRINUSE` 오류를 뿜어내는 현상입니다.\n\n이를 완벽히 방지하려면 NestJS의 애플리케이션 수명 주기 관리 기능을 활용해, 모듈이 교체되기 직전 기존 인스턴스를 명시적으로 해제해야 합니다. Rspack 환경에서 `@rspack/core/hot/poll?100`과 `run-script-webpack-plugin`을 결합하여 HMR 환경을 구축했다면, 메인 엔트리포인트 파일인 `main.ts`에 수명 주기 클린업 로직을 반드시 삽입해야 합니다.\n\n개발 환경에서 소켓 충돌 없이 백엔드 인스턴스를 안전하게 재부팅하는 `main.ts` 설정은 다음과 같습니다.\n\n```typescript\n// main.ts (NestJS 12 / Rspack HMR 대응)\nimport { NestFactory } from '@nestjs/core';\nimport { AppModule } from './app.module';\n\ndeclare const module: any;\n\nasync function bootstrap() {\n const app = await NestFactory.create(AppModule);\n await app.listen(3000);\n\n if (module.hot) {\n module.hot.accept();\n module.hot.dispose(() => app.close());\n }\n}\nbootstrap();\n```\n\n이처럼 `module.hot.dispose` 콜백 내부에서 `app.close()`를 호출해 두면, 새로운 코드가 반영되기 전에 활성화되어 있던 HTTP 서버 소켓이 확실하게 정리되어 매끄럽고 빠른 핫 리로드 환경을 완성할 수 있습니다.\n\n## Nx 모노레포에서의 Rspack 커스텀 어댑터 구성\n\nNx 모노레포 환경에서 제공하는 `@nx/rspack:convert-webpack` 같은 자동 전환 도구는 백엔드 노드 애플리케이션의 웹팩 설정을 마이그레이션할 때 예기치 못한 누락을 자주 일으킵니다. 프론트엔드 빌드와 달리 백엔드 빌드는 파일 시스템 접근이나 네이티브 모듈 바인딩 등 노드 런타임의 특성을 고려해야 하므로 자동 변환 도구에만 의존하기보다 수동으로 커스텀 설정을 구성하는 편이 훨씬 안정적입니다.\n\n수동 설정의 핵심은 빌드 대상 플랫폼을 노드로 명시하고 외부 의존성이 번들 결과물에 통째로 묶이는 문제를 방지하는 것입니다. 이를 위해 애플리케이션 루트에 `rspack.config.mjs` 파일을 생성하고 `nodeExternals`를 적용하여 `node\\_modules` 폴더의 패키지들을 번들링 대상에서 제외해야 합니다.\n\nNx 환경에서 동작하는 NestJS용 커스텀 Rspack 설정 예시입니다. Nx 19 이상 버전을 기준으로 작성되었습니다.\n\n```javascript\nimport { composePlugins, withNx } from '@nx/rspack';\nimport nodeExternals from 'webpack-node-externals';\n\nexport default composePlugins(withNx(), (config) => {\n config.target = 'node';\n config.externalsPreset = { node: true };\n config.externals = [\n nodeExternals({\n allowlist: [/^@monorepo\\//] \n })\n ];\n return config;\n});\n```\n\n이와 같이 커스텀 어댑터를 구성하면 불필요한 서드파티 라이브러리가 번들에 포함되는 문제를 확실하게 차단할 수 있습니다. 결과적으로 모노레포 내부의 공유 라이브러리만 안전하게 컴파일에 포함되므로 빌드 속도가 획기적으로 개선되고 프로덕션 환경의 이미지 용량도 크게 최적화됩니다.\n\n## Rspack 도입, 어떻게 준비할 것인가\n\nNestJS 12와 Rspack의 결합은 대규모 모노레포를 운영하는 개발팀에게 빌드 속도 정체를 해결해 줄 확실한 돌파구입니다. 현재 제공되는 `@nestjs/cli@next` 프리릴리즈 패키지를 통해 미리 마이그레이션을 검토하고, 앞서 다룬 데코레이터 메타데이터와 클래스명 유지 설정을 점검해 보시길 권장합니다. 프로덕션 빌드의 안정성과 로컬 개발 경험을 미리 검증해 둔다면, 다가오는 공식 릴리즈 시점에 별다른 혼선 없이 압도적인 빌드 속도 개선을 누릴 수 있습니다.\n\n---\n\n**참고 링크**\n\n- [nrwl/nx GitHub Issues — Nx Monorepo Conversion Gaps](https://github.com/nrwl/nx/issues/30292)\n- [Rspack Documentation & GitHub Issues — Common Pitfall: TS Decorator Metadata and SWC Configuration](https://rspack.dev/guide/tech/nestjs)\n- [web-infra-dev/rspack GitHub Repository — Common Pitfall: Production Class-Name Mangling](https://github.com/web-infra-dev/rspack/issues/10393)","9972500a5022673f44a2f653f4b5d89572593c585960b448972b81f39cbced76",69,"2026-07-22T08:59:01.643Z","2026-07-22T15:20:04.796Z",[],[],{"_950":13577,"_2416":3098,"_2418":2803,"_2419":2080,"_2420":3649,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":13578,"_1889":13586,"_2455":-5,"_2456":-5,"_2457":-5,"_9":13590,"_2450":13598,"_2458":-5,"_2460":-5,"_723":13599,"_1886":13601,"_332":13605,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":13606,"_2003":13607,"_2480":13608,"_2482":13609,"_2483":13610,"_2485":-5,"_2486":-5,"_2487":13611,"_1144":13621,"_2527":-5,"_2555":-5,"_2556":13634,"_2798":13698,"_266":13699},"cmrvqeoxm02e910muke2j0quj",{"_1801":1802,"_214":13579,"_2429":13580,"_2434":13583,"_2438":2439},646,{"_1892":13581,"_1893":1997,"_1802":13582,"_2433":1997},197,449,{"_1892":13584,"_1893":1997,"_1802":13585,"_2433":1997},0.30495356037151705,0.695046439628483,{"_9":13587,"_2445":13591,"_2450":13595},{"_1892":13588,"_1893":13589,"_1802":13590},"NestJS 12 · OpenTelemetry — Monitoring AI Agents, All at Once Without Callbacks","NestJS 12 · OpenTelemetry — AIエージェント監視をコールバックなしで一元化","NestJS 12 · OpenTelemetry — AI 에이전트 모니터링, 콜백 없이 한 번에",{"_1892":13592,"_1893":13593,"_1802":13594},"Building a monitoring environment to track which tools AI agents call internally and what prompts they use is proving to be quite a headache these days. The old way of manually adding custom callbacks for every single library makes the code messy and creates a real maintenance nightmare.\n\nHowever, with the combination of NestJS 12's native ESM architecture and the OpenTelemetry standard, we can solve this problem very cleanly. Tools like Langfuse v3+ or the Vercel AI SDK now support native OTel interfaces based on a global TracerProvider, rather than relying on their own SDK callbacks.\n\nThanks to this, in a NestJS 12 environment, you just need to register a single global span processor without any complex middleware. You can send the same trace data to Sentry or Datadog for application performance analysis while simultaneously routing it to Langfuse for LLM prompt and token analysis. Since there is no need to inject redundant instrumentation code, server overhead is significantly reduced.\n\nOne thing to note is that during asynchronous context propagation, you might experience breaks in trace connection when an agent executes tools in background tasks or multi-threaded processes. You will need to compensate for this by explicitly passing the OTel context headers. I'll summarize and share the code for this agent monitoring pattern soon, haha.","最近、AIエージェントの開発において、エージェントが内部でどのツールを呼び出し、どんなプロンプトを使用したかを追跡する監視環境の構築は、想像以上に厄介です。従来のようにライブラリごとにカスタムコールバックをいちいち埋め込む方法は、コードが汚れる上にメンテナンスも非常に大変です。\n\nしかし、NestJS 12のネイティブESMアーキテクチャとOpenTelemetry標準が組み合わさることで、この問題を非常にスマートに解決できるようになりました。Langfuse v3以上やVercel AI SDKなどのツールが、独自のSDKコールバックではなく、グローバルなTracerProviderベースのネイティブOTelインターフェースをサポートするようになったからです。\n\nおかげでNestJS 12環境では、複雑なミドルウェアなしでグローバルなSpanプロセッサを1つ登録するだけで完了します。同一のトレースデータをアプリケーションのパフォーマンス分析用にSentryやDatadogへ送信しつつ、LLMプロンプトやトークン分析用にLangfuseへも同時に送ることができます。重複して計測コードを埋め込む必要がないため、サーバーのオーバーヘッドも確実に軽減されます。\n\nただし、非同期コンテキスト伝搬の過程で、エージェントがバックグラウンドタスクやマルチスレッドでツールを実行する際にトレースの接続が切れる現象が発生することもあります。この部分はOTelコンテキストヘッダーを明示的に伝搬させる形で補完する必要があるため、注意してください。近々、このパターンを活用したエージェント監視コードをまとめて共有しますね。","요즘 AI 에이전트 개발할 때 에이전트가 내부적으로 어떤 도구를 호출하고 어떤 프롬프트를 썼는지 추적하는 모니터링 환경을 구축하는 게 생각보다 골치 아픈데요. 예전처럼 라이브러리마다 일일이 커스텀 콜백을 넣는 방식은 코드도 지저분해지고 유지보수하기도 정말 빡셉니다.\n\n하지만 NestJS 12의 네이티브 ESM 아키텍처와 OpenTelemetry 표준이 맞물리면서 이 문제를 아주 깔끔하게 해결할 수 있게 되었습니다. Langfuse v3 이상이나 Vercel AI SDK 같은 도구들이 이제 자체 SDK 콜백 대신 글로벌 TracerProvider 기반의 네이티브 OTel 인터페이스를 지원하거든요.\n\n덕분에 NestJS 12 환경에서는 복잡한 미들웨어 없이 전역 Span 프로세서 하나만 등록해 두면 끝납니다. 같은 트레이스 데이터를 애플리케이션 성능 분석을 위한 Sentry나 Datadog으로 보내는 동시에, LLM 프롬프트와 토큰 분석을 위해 Langfuse로도 한 번에 보낼 수 있는 거죠. 중복으로 계측 코드를 심을 필요가 없어서 서버 오버헤드도 확실히 줄어듭니다.\n\n다만 비동기 컨텍스트 전파 과정에서 에이전트가 백그라운드 태스크나 멀티 스레드로 도구를 실행할 때 트레이스 연결이 끊기는 현상이 생기기도 합니다. 이 부분은 OTel 컨텍스트 헤더를 명시적으로 전달해 주는 식으로 보완해야 하니 참고해 주세요. 조만간 이 패턴을 활용한 에이전트 모니터링 코드를 정리해서 공유해 드릴게요 ㅎㅎ",{"_1892":13596,"_1893":13597,"_1802":13598},"Building a monitoring environment to track which tools AI agents call internally and what prompts they use is proving to be quite a headache these days. The old way of manually adding custom callbacks for every single li…","最近、AIエージェントの開発において、エージェントが内部でどのツールを呼び出し、どんなプロンプトを使用したかを追跡する監視環境の構築は、想像以上に厄介です。従来のようにライブラリごとにカスタムコールバックをいちいち埋め込む方法は、コードが汚れる上にメンテナンスも非常に大変です。しかし、NestJS 12のネイティブESMアーキテクチャとOpenTelemetry標準が組み合わさることで、この問題を非常にスマートに解決できるようになりま…","요즘 AI 에이전트 개발할 때 에이전트가 내부적으로 어떤 도구를 호출하고 어떤 프롬프트를 썼는지 추적하는 모니터링 환경을 구축하는 게 생각보다 골치 아픈데요. 예전처럼 라이브러리마다 일일이 커스텀 콜백을 넣는 방식은 코드도 지저분해지고 유지보수하기도 정말 빡셉니다. 하지만 NestJS 12의 네이티브 ESM 아키텍처와 OpenTelemetry 표준이 맞물리면서 이 문제를 아주 깔끔하게 해결할…",[13600],"devtool-insight",[7581,13602,13603,10878,12028,7578,13604],"opentelemetry","langfuse","observability",[],"2026-07-22T06:59:00.445Z","2026-07-22T06:59:00.154Z","2026-07-22T22:30:44.463Z","2026-07-22T06:59:29.963Z","2026-07-22T22:30:44.457Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":13612},{"_1901":13613},{"_1903":13614,"_1908":1909,"_1910":13615,"_1921":13616,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":13617,"_1928":13618,"_1933":13619,"_1938":13620},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":13622,"_1883":1884,"_1200":1204,"_1899":13625},{"_633":13623,"_11":13624},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":13626},{"_1903":13627,"_1908":1909,"_1910":13628,"_1921":13629,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":13630,"_1928":13631,"_1933":13632,"_1938":13633},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_950":13635,"_2559":13577,"_2560":13636,"_2716":13678,"_2788":13594,"_2790":13695,"_2792":2399,"_2794":1997,"_2003":13696,"_2480":13697,"_2797":-5},"cmrvqeoxs02ea10mu41hkhsr8",{"_918":13637,"_1908":1909},[13638,13644,13648,13654,13658,13664,13668,13674],{"_950":13639,"_2420":2570,"_3203":13640,"_2571":13641},"0e1ca8f8-c4d1-4f50-bfbe-585eacb76a8a",{"_3205":591},[13642],{"_2579":13643,"_2420":2579},"요즘 AI 에이전트 개발할 때 에이전트가 내부적으로 어떤 도구를 호출하고 어떤 프롬프트를 썼는지 추적하는 모니터링 환경을 구축하는 게 생각보다 골치 아픈데요. 예전처럼 라이브러리마다 일일이 커스텀 콜백을 넣는 방식은 코드도 지저분해지고 유지보수하기도 정말 빡셉니다.",{"_950":13645,"_2420":2570,"_3203":13646,"_2571":13647},"a58d2cf8-4f7a-4a59-9658-9b4153171100",{"_3205":591},[],{"_950":13649,"_2420":2570,"_3203":13650,"_2571":13651},"cb930e7c-c7e7-47eb-bff0-a5e2cae83fca",{"_3205":591},[13652],{"_2579":13653,"_2420":2579},"하지만 NestJS 12의 네이티브 ESM 아키텍처와 OpenTelemetry 표준이 맞물리면서 이 문제를 아주 깔끔하게 해결할 수 있게 되었습니다. Langfuse v3 이상이나 Vercel AI SDK 같은 도구들이 이제 자체 SDK 콜백 대신 글로벌 TracerProvider 기반의 네이티브 OTel 인터페이스를 지원하거든요.",{"_950":13655,"_2420":2570,"_3203":13656,"_2571":13657},"9eb572c6-08a9-4d22-a5d0-96d4d1137682",{"_3205":591},[],{"_950":13659,"_2420":2570,"_3203":13660,"_2571":13661},"209cd30d-2181-416e-9882-09756416e4f1",{"_3205":591},[13662],{"_2579":13663,"_2420":2579},"덕분에 NestJS 12 환경에서는 복잡한 미들웨어 없이 전역 Span 프로세서 하나만 등록해 두면 끝납니다. 같은 트레이스 데이터를 애플리케이션 성능 분석을 위한 Sentry나 Datadog으로 보내는 동시에, LLM 프롬프트와 토큰 분석을 위해 Langfuse로도 한 번에 보낼 수 있는 거죠. 중복으로 계측 코드를 심을 필요가 없어서 서버 오버헤드도 확실히 줄어듭니다.",{"_950":13665,"_2420":2570,"_3203":13666,"_2571":13667},"96fd4dcb-9ec8-4342-95e7-8ee26ef60326",{"_3205":591},[],{"_950":13669,"_2420":2570,"_3203":13670,"_2571":13671},"14308d93-e70c-4a99-9eb5-b9bb541b8d9e",{"_3205":591},[13672],{"_2579":13673,"_2420":2579},"다만 비동기 컨텍스트 전파 과정에서 에이전트가 백그라운드 태스크나 멀티 스레드로 도구를 실행할 때 트레이스 연결이 끊기는 현상이 생기기도 합니다. 이 부분은 OTel 컨텍스트 헤더를 명시적으로 전달해 주는 식으로 보완해야 하니 참고해 주세요. 조만간 이 패턴을 활용한 에이전트 모니터링 코드를 정리해서 공유해 드릴게요 ㅎㅎ",{"_950":13675,"_2420":2570,"_3203":13676,"_2571":13677},"488fe896-f28e-4a44-b62b-8da157635df7",{"_3205":591},[],{"_13639":13679,"_13669":13683,"_13659":13687,"_13649":13691},{"_2571":13680},{"_1892":13681,"_1893":13682,"_1802":13643},"Building a monitoring environment to track which tools AI agents call internally and what prompts they use is proving to be quite a headache these days. The old way of manually adding custom callbacks for every single library makes the code messy and creates a real maintenance nightmare.","最近、AIエージェントの開発において、エージェントが内部でどのツールを呼び出し、どんなプロンプトを使用したかを追跡する監視環境の構築は、想像以上に厄介です。従来のようにライブラリごとにカスタムコールバックをいちいち埋め込む方法は、コードが汚れる上にメンテナンスも非常に大変です。",{"_2571":13684},{"_1892":13685,"_1893":13686,"_1802":13673},"One thing to note is that during asynchronous context propagation, you might experience breaks in trace connection when an agent executes tools in background tasks or multi-threaded processes. You will need to compensate for this by explicitly passing the OTel context headers. I'll summarize and share the code for this agent monitoring pattern soon, haha.","ただし、非同期コンテキスト伝搬の過程で、エージェントがバックグラウンドタスクやマルチスレッドでツールを実行する際にトレースの接続が切れる現象が発生することもあります。この部分はOTelコンテキストヘッダーを明示的に伝搬させる形で補完する必要があるため、注意してください。近々、このパターンを活用したエージェント監視コードをまとめて共有しますね。",{"_2571":13688},{"_1892":13689,"_1893":13690,"_1802":13663},"Thanks to this, in a NestJS 12 environment, you just need to register a single global span processor without any complex middleware. You can send the same trace data to Sentry or Datadog for application performance analysis while simultaneously routing it to Langfuse for LLM prompt and token analysis. Since there is no need to inject redundant instrumentation code, server overhead is significantly reduced.","おかげでNestJS 12環境では、複雑なミドルウェアなしでグローバルなSpanプロセッサを1つ登録するだけで完了します。同一のトレースデータをアプリケーションのパフォーマンス分析用にSentryやDatadogへ送信しつつ、LLMプロンプトやトークン分析用にLangfuseへも同時に送ることができます。重複して計測コードを埋め込む必要がないため、サーバーのオーバーヘッドも確実に軽減されます。",{"_2571":13692},{"_1892":13693,"_1893":13694,"_1802":13653},"However, with the combination of NestJS 12's native ESM architecture and the OpenTelemetry standard, we can solve this problem very cleanly. Tools like Langfuse v3+ or the Vercel AI SDK now support native OTel interfaces based on a global TracerProvider, rather than relying on their own SDK callbacks.","しかし、NestJS 12のネイティブESMアーキテクチャとOpenTelemetry標準が組み合わさることで、この問題を非常にスマートに解決できるようになりました。Langfuse v3以上やVercel AI SDKなどのツールが、独自のSDKコールバックではなく、グローバルなTracerProviderベースのネイティブOTelインターフェースをサポートするようになったからです。","e8fdc3ec8c09fbf545e35c5a4b7bc7428b7fc64481f26346752e20639f733821","2026-07-22T06:59:00.160Z","2026-07-22T22:30:44.465Z",[],[],{"_950":13701,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":13702,"_1889":13710,"_2455":-5,"_2456":-5,"_2457":-5,"_9":13714,"_2450":13722,"_2458":13723,"_2460":-5,"_723":13724,"_1886":13725,"_332":13729,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":13730,"_2003":13731,"_2480":13732,"_2482":-5,"_2483":13733,"_2485":-5,"_2486":-5,"_2487":13734,"_1144":13744,"_2527":13757,"_2555":-5,"_2556":13778,"_2798":14093,"_266":14094},"cmrv5m2kw01mb10mum4jfmoco",{"_1801":1802,"_214":13703,"_2429":13704,"_2434":13707,"_2438":2439},3020,{"_1892":13705,"_1893":1997,"_1802":13706,"_2433":1997},666,2354,{"_1892":13708,"_1893":1997,"_1802":13709,"_2433":1997},0.2205298013245033,0.7794701986754967,{"_9":13711,"_2445":13715,"_2450":13719},{"_1892":13712,"_1893":13713,"_1802":13714},"MCP v2 and the CLI Trend — The Paradigm Shift in AI-Native Development Tools","MCP v2とCLIのトレンド — AIネイティブ開発ツールの地殻変動","MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동",{"_1892":13716,"_1893":13717,"_1802":13718},"MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동\n\nMCP v2 and the CLI Trend — The Paradigm Shift in AI-Native Development Tools\n\nBy mid-2026, the AI-native development tool ecosystem is rapidly restructuring away from complex abstractions and toward practicality. The core of this shift lies in the Model Context Protocol (MCP) making a leap toward a stateless architecture for enterprise scalability, and the rise of terminal-based tools that demonstrate overwhelming efficiency in local environments. As we move away from maximizing agent overhead toward simplicity and stability, we explore the essential technology trends that every developer should keep an eye on.\n\nMCP v2: The Core Protocol Transitioning to Fully Stateless\n\nThe key change in the Model Context Protocol (MCP) specification, finalized on July 28, 2026, is the shift to a completely stateless architecture at the protocol layer. The existing v1 specification relied on a stateful architecture dependent on initial handshakes and session-identifying headers. This created technical limitations in horizontally scaling multi-agent interfaces within serverless backends or cloud load-balancing environments.\n\nThe v2 specification eliminates these session handshake mechanisms entirely, adopting a communication paradigm based on standard HTTP and Server-Sent Events (SSE). Developers can now freely scale out by placing remote MCP servers behind standard reverse proxies without the burden of complex connection maintenance or synchronization overhead. Note, however, that backward compatibility with v1 tools that relied on session information is broken, so a migration review for currently operational infrastructure is required.\n\nDeveloper interfaces are also being significantly enhanced alongside this update. New features include 'MCP Apps,' which leverage secure, isolated iframe environments to render interactive UIs directly within chat windows, and 'MCP Triggers' for real-time data pushing via webhooks. Anthropic is supporting this major shift by simultaneously updating its TypeScript and Python SDKs to v2, reinforcing backend integration productivity.\n\nThe Terminal Regression: Why CLI-Native Tools are Competing with MCP Servers\n\nIn contrast to the trend of stateless agent infrastructure expansion, simple Unix CLI-based tools are proving to be more efficient in local development environments. According to the 'terminal-first' critique raised in recent talks at the Barcelona Supercomputing Center and analyses by OpenClaw maintainers, executing standard CLI commands directly is far more effective for AI agents running locally than using the complex JSON-RPC specification of MCP servers. Since large language models have already been trained on decades of accumulated Unix shell data, they process feedback more smoothly and accurately through terminal commands than by traversing formal API schemas.\n\nThe power of this CLI-native approach is clearly evident in token savings and reduced latency. Examining actual metrics for Anthropic's terminal tool, Claude Code, reveals that the verbose tool specification schemas exchanged to register and maintain local MCP servers waste a significant amount of tokens during agent invocation. In contrast, CLI-native tools significantly reduce context window strain by invoking --help commands dynamically only when necessary. Consequently, a clear paradigm split is occurring: stateless-based MCP is becoming the standard for complex remote enterprise integrations, while terminal shell binding is emerging as the mainstream for local development loops.\n\nStandardizing AGENTS.md and Completing the Local LLM Pipeline\n\nThe 'AGENTS.md' specification is rapidly becoming established as a static context file that helps development agents consistently understand a project's build rules, testing methods, and architectural guides. Standardized by the Agentic AI Foundation under the Linux Foundation, this spec replaces previously fragmented configuration files. Agents read this file first when entering a repository to grasp the project's unique rules.\n\nAGENTS.md is written in a highly readable Markdown format, as follows:\n\n# AGENTS\n\n## Standards\n- Use TypeScript for backend services.\n- Always write unit tests using Vitest.\n\n## Build & Test\n- Build: `npm run build`\n- Test: `npm run test`\n\nThese static guidelines, combined with powerful local models and execution tools, extend to offline development environments. Models like Google's Gemma 4, which runs on 16GB of memory, and Qwen3.6, which specializes in local multi-token prediction, are executed lightly on local machines via Ollama.\n\nBy linking this with 'mcphost'—a Go-based local client bridge—developers can organically connect local models with MCP servers for file system control. As a result, developers can complete private agent pipelines that carry no cost or security concerns, utilizing only local resources without external API calls.\n\nEnterprise Security Management and Establishing Machine Transactions\n\nMicrosoft's Entra Agent ID has established itself as a core security solution for controlling AI agent permissions in large enterprise environments. This system provides a three-tier hierarchical model consisting of Blueprints, Blueprint Principals, and Agent Identity. Developers can enforce infrastructure-wide security policies via global blueprints while reliably implementing granular permission management tailored to specific tenants or individual agent roles.\n\nMeanwhile, in the field of machine transactions where agents independently pay for API or infrastructure usage, micro-payment models via the x402 protocol are being actively discussed. This protocol is based on the standard HTTP 402 spec and uses three dedicated headers to finalize stablecoin payments within a single request-response cycle. However, the existing x402 method had limitations, with significant verification latency ranging from 500ms up to 1100ms per request due to EIP-712 and EIP-3009 cryptographic parsing during signature verification, as well as communication with external payment providers.\n\nTo overcome these latency issues, the A402 protocol based on Trusted Execution Environments (TEE) is emerging as an alternative. By combining accelerated adapter signatures with off-chain Atomic Service Channel (ASC) technology, the A402 protocol bypasses on-chain verification costs and has innovatively reduced end-to-end latency to approximately 350ms. As a result, it is now possible to establish rapid infrastructure transactions without payment bottlenecks, even in time-sensitive, real-time multi-agent environments.\n\nSecurity Risks and How to Prepare for Coming Changes\n\nThe popularization of AI agent technology is shadowed by new security threats. In particular, techniques such as injecting malicious AGENTS.md files into subdirectories of a monorepo to make local agents execute unauthorized remote code, or the 'blast radius' risk of Entra Agent ID's top-level blueprint permissions being compromised—causing a domino-effect infection of subordinate agents—are critical. Therefore, when introducing agents into a professional workflow, sandbox isolation policies that strictly limit command execution permissions and multi-layered defense mechanisms must be established.\n\nReference Links\n\nOllama & r/LocalLLaMA Community — Local Execution in 2026: Gemma 4, Qwen3.6 MTP, and Ollama MCP Pipelines\nBarcelona Supercomputing Center (BSC) Lecture Series — The Terminal-First Critique: Why CLI-Native Tools are Rivaling Local MCP Servers\nMicrosoft DevBlogs — Microsoft Agent Framework 1.0: AutoGen and Semantic Kernel Consolidation","MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동\n\nMCP v2とCLIのトレンド — AIネイティブ開発ツールの地殻変動\n\n2026年半ば、AIネイティブ開発ツールのエコシステムは複雑な抽象化を削ぎ落とし、実用性重視へと急速に再編されています。その核心にあるのは、エンタープライズでの拡張性を見据えてステートレス構造へ転換する「モデルコンテキストプロトコル（MCP）」の飛躍と、ローカル環境で圧倒的な効率を発揮するターミナルベースツールの台頭です。エージェントのオーバーヘッドを最大化するのではなく、シンプルさと安定性を求める今、開発者が必ず注目すべき技術トレンドを一緒に見ていきましょう。\n\nMCP v2：完全ステートレスへと転換するコアプロトコル\n\n2026年7月28日に確定するModel Context Protocol (MCP) 規格の主要な変更点は、プロトコル層の完全なステートレス構造への転換です。従来のv1規格は、初回接続時の初期化ハンドシェイクとセッション識別用ヘッダーに依存するステートフルなアーキテクチャでした。そのため、サーバーレスバックエンドやクラウドの負荷分散環境において、マルチエージェントインターフェースを水平的に拡張する際に技術的な制約がありました。\n\nv2規格では、こうしたセッションハンドシェイクのメカニズムを全面的に廃止し、標準のHTTPとサーバー送信イベント（SSE）に基づく通信パラダイムを採用しました。これにより開発者は、複雑な接続維持のコストや同期の負担なしに、一般的なリバースプロキシの背後にリモートMCPサーバーを配置して自由にスケールアウトできるようになります。ただし、セッション情報に依存していた従来のv1ツールとは下位互換性が断たれるため、運用中のインフラの移行検討が必要です。\n\n今回の改定に合わせて開発者インターフェースも大幅に強化されます。セキュリティで隔離されたiframe環境を介してチャットウィンドウにインタラクティブなUIを直接レンダリングする「MCPアプリ」機能や、Webhook方式でデータをリアルタイムにプッシュする「MCPトリガー」などが新たに追加されます。Anthropicはこの大幅な変更に合わせてTypeScriptおよびPython向けのSDK v2を同時サポートしており、バックエンド連携の生産性を支えています。\n\nターミナル回帰：なぜCLIネイティブツールはMCPサーバーと競合するのか\n\nエージェントインフラがステートレスに拡張される流れとは対照的に、ローカル開発環境ではUNIX CLIベースのシンプルなツールの方が高い効率を発揮しています。近年のバルセロナ・スーパーコンピューティング・センターでの講演やOpenClawメンテナーによる分析で提起された「ターミナルファースト」の批判によれば、ローカル環境で動作するAIエージェントにとって、複雑なJSON-RPC仕様を使うMCPサーバーよりも、標準CLIコマンドを直接実行する方式の方がはるかに効果的です。大規模言語モデルはすでに何十年も蓄積されたUNIXシェルのデータを学習しているため、定型化されたAPIスキーマを介するよりも、ターミナルコマンドを通じて直接フィードバックをやり取りする作業の方が、よりスムーズかつ正確に処理できます。\n\nこうしたCLIネイティブ方式の大きな利点は、トークン削減効果とレイテンシの短縮に如実に表れています。Anthropicのターミナルツール「Claude Code」の実際の指標を見ると、ローカルMCPサーバーを登録して常時連携するためにやり取りされる冗長なツール定義スキーマは、エージェントの呼び出しプロセスにおいて相当量のトークンを浪費させています。一方、CLIネイティブツールは必要な瞬間にのみ「--help」コマンドを呼び出して使い方を動的に把握する方式のため、コンテキストウィンドウへの負荷を大幅に軽減します。結果として、複雑なリモートエンタープライズ統合にはステートレスベースのMCPが標準として定着する一方、ローカル開発ループではターミナルシェルバインディングが主流になるという明確なパラダイムの分離が起きています。\n\nAGENTS.mdの標準化とローカルLLMパイプラインの完成\n\n開発エージェントがプロジェクトのビルドルール、テスト方法、アーキテクチャガイドを一貫して理解できるよう支援する静的コンテキストファイルとして、「AGENTS.md」という規格が急速に定着しつつあります。Linux Foundation傘下のAgentic AI Foundationが標準化したこの規格は、これまで断片化されていた設定ファイルを置き換えるものです。エージェントはリポジトリにアクセスする際、このファイルを最初に読み込んでプロジェクト独自のルールを把握します。\n\nAGENTS.mdは、以下のように可読性の高いMarkdown形式で記述されます。\n\n# AGENTS\n\n## Standards\n- Use TypeScript for backend services.\n- Always write unit tests using Vitest.\n\n## Build & Test\n- Build: `npm run build`\n- Test: `npm run test`\n\nこのような静的ガイドラインは強力なローカルモデルや実行ツールと組み合わさり、オフライン開発環境へと広がっています。16GBのメモリでも動作するGoogleの「Gemma 4」や、ローカルマルチトークン予測に特化した「Qwen3.6」といったモデルが、Ollamaを通じてローカル環境で軽量に実行されています。\n\nここにGo言語ベースのローカルクライアントブリッジ「mcphost」を連携させれば、ローカルモデルとファイルシステム制御用MCPサーバーを有機的に接続できます。結果として開発者は、外部APIを呼び出すことなく、ローカルリソースのみを使用してコストやセキュリティの懸念がないプライベートなエージェントパイプラインを完成させることができます。\n\nエンタープライズのセキュリティ管理とマシン取引の確立\n\nMicrosoftがリリースした「Entra Agent ID」は、大規模エンタープライズ環境でAIエージェントの権限を制御するための核心的なセキュリティソリューションとして定着しました。このシステムは、ブループリント、ブループリントプリンシパル、エージェントアイデンティティで構成される3段階の階層モデルを提供します。開発者はインフラ全体のセキュリティポリシーをグローバルなブループリントとして強制しつつ、特定のテナントや各エージェントの役割に合わせた細かい権限管理を安定して実装できます。\n\n一方、エージェントが独自にAPIやインフラ使用料を支払うマシン取引の分野では、x402プロトコルを通じた少額決済モデルが活発に議論されています。このプロトコルは標準のHTTP 402規格に基づいており、3つの専用ヘッダーを使用して、わずか1回の要求と応答のサイクルの中でステーブルコインによる決済を完了させます。しかし、従来のx402方式には、署名検証プロセスにおけるEIP-712やEIP-3009の暗号パース、および外部決済会社との通信により、リクエストごとに500msから最大1100msに及ぶ大幅な遅延が発生するという限界がありました。\n\nこの遅延の問題を克服するため、TEE（信頼実行環境）ベースの「A402」プロトコルが代替手段として浮上しています。A402プロトコルは、加速アダプター署名とオフチェーン形式のアトミックサービスチャネル（ASC）技術を組み合わせることで、オンチェーン検証コストを回避し、エンドツーエンドのレイテンシを約350msまで画期的に短縮しました。これにより、秒を争うリアルタイムのマルチエージェント環境でも、決済のボトルネックなしに迅速なインフラ取引が確立できるようになりました。\n\nセキュリティリスクと今後の変化への備え方\n\nAIエージェント技術の普及の裏には、新たなセキュリティの脅威が存在します。特にモノレポのサブディレクトリに悪意のあるAGENTS.mdファイルを埋め込んでローカルエージェントに不正なコード実行を行わせる手法や、Entra Agent IDの最上位のブループリント権限が乗っ取られて下位のエージェント全体が連鎖的に汚染される「ブラスト・ラディアス」のリスクは非常に致命的です。そのため、エージェントを実務に導入する際は、コマンド実行権限を厳格に制限するサンドボックス隔離ポリシーと多重防御メカニズムを必ず確立しなければなりません。\n\n参考リンク\n\nOllama & r/LocalLLaMA Community — 2026年のローカル実行環境: Gemma 4, Qwen3.6 MTP, そしてOllama MCPパイプライン\nBarcelona Supercomputing Center (BSC) 講義シリーズ — ターミナルファーストの批判: CLIネイティブツールがローカルMCPサーバーと競合する理由\nMicrosoft DevBlogs — Microsoft Agent Framework 1.0: AutoGenとSemantic Kernelの統合","MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동\n\nMCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동\n\n2026년 중반, AI 네이티브 개발 도구 생태계는 복잡한 추상화를 걷어내고 실용성 중심으로 빠르게 재편되고 있습니다. 엔터프라이즈 확장성을 겨냥해 무상태 구조로 전환하는 모델 컨텍스트 프로토콜(MCP)의 도약과, 로컬 환경에서 압도적인 효율을 보여주는 터미널 기반 도구의 부상이 그 핵심입니다. 에이전트 오버헤드를 극대화하는 대신 단순함과 안정성을 쥐려는 지금, 개발자가 반드시 주목해야 할 기술 트렌드를 함께 살펴봅니다.\n\nMCP v2: 완전히 무상태로 전환되는 코어 프로토콜\n\n2026년 7월 28일 확정되는 Model Context Protocol(MCP) 규격의 핵심 변화는 프로토콜 레이어의 완전한 무상태 구조로의 전환입니다. 기존 v1 규격은 첫 연결 시 진행하는 초기화 핸드셰이크와 세션 식별용 헤더에 의존하는 상태 유지형 아키텍처였습니다. 이 때문에 서버리스 백엔드나 클라우드 부하 분산 환경에서 멀티 에이전트 인터페이스를 수평적으로 확장하는 데 기술적 한계가 있었습니다.\n\nv2 규격은 이러한 세션 핸드셰이크 메커니즘을 전면 제거하고 표준 HTTP와 서버 전송 이벤트(SSE) 기반의 통신 패러다임을 채택했습니다. 이제 개발자들은 복잡한 커넥션 유지 비용이나 동기화 부담 없이 일반적인 역방향 프록시 뒤에 원격 MCP 서버를 배치하여 자유롭게 스케일아웃할 수 있습니다. 다만 세션 정보에 의존하던 기존 v1 도구들과는 하위 호환성이 단절되므로 운영 중인 인프라의 마이그레이션 검토가 필요합니다.\n\n이번 개편과 함께 개발자 인터페이스도 대폭 강화됩니다. 보안 격리된 iframe 환경을 빌려 채팅 창에 대화형 UI를 직접 렌더링하는 'MCP 앱' 기능과 웹훅 방식으로 데이터를 실시간 푸시하는 'MCP 트리거' 등이 새롭게 통합됩니다. 앤트로픽은 이러한 대대적인 변화에 맞춰 타입스크립트와 파이썬용 SDK v2 업데이트를 동시 지원하며 백엔드 연동 생산성을 뒷받침하고 있습니다.\n\n터미널 회귀: 왜 CLI 네이티브 도구가 MCP 서버와 경쟁하는가\n\n에이전트 인프라가 무상태로 확장되는 흐름과 달리, 로컬 개발 환경에서는 유닉스 CLI 기반의 단순한 도구가 오히려 더 높은 효율을 증명하고 있습니다. 최근 바르셀로나 슈퍼컴퓨팅 센터 강연과 오픈클로(OpenClaw) 메인테이너들의 분석에서 제기된 '터미널 퍼스트' 비판에 따르면, 로컬 환경에서 구동되는 인공지능 에이전트에게는 복잡한 JSON-RPC 규격을 사용하는 모델 컨텍스트 프로토콜(MCP) 서버보다 표준 CLI 명령어를 직접 실행하는 방식이 훨씬 효과적입니다. 대규모 언어 모델은 이미 수십 년간 축적된 유닉스 쉘 데이터를 학습했기 때문에, 정형화된 API 스키마를 거치는 것보다 터미널 명령어를 통해 직접 피드백을 주고받는 작업을 더 매끄럽고 정확하게 처리합니다.\n\n이러한 CLI 네이티브 방식의 강력한 장점은 토큰 절감 효과와 레이턴시 단축에서 명확히 드러납니다. 앤트로픽(Anthropic)의 터미널 도구인 클로드 코드(Claude Code)의 실제 지표를 살펴보면, 로컬 MCP 서버를 등록하고 상시 연동하기 위해 주고받는 장황한 도구 명세 스키마는 에이전트의 호출 과정에서 상당한 양의 토큰을 낭비하게 만듭니다. 반면 CLI 네이티브 도구는 필요한 순간에만 --help 명령어를 호출해 사용법을 동적으로 파악하는 방식으로 컨텍스트 윈도우 부담을 크게 줄입니다. 결과적으로 복잡한 원격 엔터프라이즈 통합에는 무상태 기반의 MCP가 표준으로 자리 잡는 반면, 로컬 개발 루프에서는 터미널 쉘 바인딩이 주류를 이루는 명확한 패러다임 분리가 일어나고 있습니다.\n\nAGENTS.md 표준화와 로컬 LLM 파이프라인의 완성\n\n개발 에이전트가 프로젝트의 빌드 규칙, 테스트 방법, 아키텍처 가이드를 일관되게 이해하도록 돕는 정적 컨텍스트 파일로 'AGENTS.md' 규격이 빠르게 정착하고 있습니다. 리눅스 재단 산하의 에이전틱 AI 재단(Agentic AI Foundation)이 표준화한 이 규격은 기존에 파편화되어 있던 설정 파일들을 대체합니다. 에이전트는 리포지토리에 진입할 때 이 파일을 먼저 읽고 프로젝트의 고유한 규칙을 파악합니다.\n\nAGENTS.md는 다음과 같이 가독성이 높은 마크다운 형식으로 작성됩니다.\n\n# AGENTS\n\n## Standards\n- Use TypeScript for backend services.\n- Always write unit tests using Vitest.\n\n## Build & Test\n- Build: `npm run build`\n- Test: `npm run test`\n\n이러한 정적 가이드라인은 강력한 로컬 모델 및 실행 도구들과 결합해 오프라인 개발 환경으로 확장됩니다. 16GB 메모리에서도 구동되는 구글의 젬마 4(Gemma 4)나 로컬 멀티 토큰 예측에 특화된 Qwen3.6 같은 모델들이 올라마(Ollama)를 통해 로컬에서 가볍게 실행됩니다.\n\n여기에 Go 언어 기반의 로컬 클라이언트 브리지인 mcphost를 연동하면 로컬 모델과 파일 시스템 제어용 MCP 서버를 유기적으로 연결할 수 있습니다. 결과적으로 개발자는 외부 API 호출 없이 로컬 자원만 사용하여 비용과 보안 우려가 없는 프라이빗 에이전트 파이프라인을 완성하게 됩니다.\n\n엔터프라이즈의 보안 관리와 머신 트랜잭션 수립\n\n마이크로소프트가 출시한 엔트라 에이전트 ID(Entra Agent ID)는 대규모 엔터프라이즈 환경에서 AI 에이전트의 권한을 통제하는 핵심 보안 솔루션으로 자리 잡았습니다. 이 시스템은 블루프린트, 블루프린트 프린시펄, 에이전트 아이덴티티로 이루어진 3단계 계층 모델을 제공합니다. 개발자는 전체 인프라 수준의 보안 정책을 전역 블루프린트로 강제하면서도, 특정 테넌트나 개별 에이전트 역할에 맞춘 미세 권한 관리를 안정적으로 구현할 수 있습니다.\n\n한편, 에이전트가 독자적으로 API나 인프라 사용 비용을 지불하는 머신 트랜잭션 분야에서는 x402 프로토콜을 통한 소액 결제 모델이 활발하게 논의되고 있습니다. 이 프로토콜은 표준 HTTP 402 규격을 기반으로 하며, 세 가지 전용 헤더를 사용하여 단 한 번의 요청과 응답 주기 속에서 스테이블코인 결제를 완결합니다. 하지만 기존 x402 방식은 서명 검증 과정에서 EIP-712 및 EIP-3009 암호화 파싱과 외부 결제사 통신으로 인해 요청당 500ms에서 최대 1100ms에 이르는 극심한 검증 지연이 발생하는 한계가 있었습니다.\n\n이러한 지연 문제를 극복하기 위해 신뢰 실행 환경(TEE) 기반의 A402 프로토콜이 대안으로 부상하고 있습니다. A402 프로토콜은 가속 어댑터 서명과 오프체인 형태의 원자적 서비스 채널(ASC) 기술을 결합하여, 온체인 검증 비용을 우회하고 엔드투엔드 레이턴시를 약 350ms 수준까지 혁신적으로 단축했습니다. 덕분에 분초를 다투는 실시간 멀티 에이전트 환경에서도 결제 병목 없이 신속한 인프라 트랜잭션을 수립할 수 있게 되었습니다.\n\n보안 리스크와 다가올 변화에 대비하는 방법\n\nAI 에이전트 기술의 대중화 뒤에는 새로운 보안 위협이 자리 잡고 있습니다. 특히 모노레포의 하위 디렉터리에 악성 AGENTS.md 파일을 삽입하여 로컬 에이전트가 원격 코드 실행 명령을 무단으로 수행하게 만드는 기법이나, 엔트라 에이전트 ID의 최상위 블루프린트 권한이 탈취되어 하위 에이전트 전체가 도미노식으로 오염되는 블래스트 레이디어스 위험은 매우 치명적입니다. 따라서 에이전트를 실무에 도입할 때는 명령어 실행 권한을 엄격하게 제한하는 샌드박스 격리 정책과 다중 방어 메커니즘을 반드시 수립해야 합니다.\n\n참고 링크\n\nOllama & r/LocalLLaMA Community — Local Execution in 2026: Gemma 4, Qwen3.6 MTP, and Ollama MCP Pipelines\nBarcelona Supercomputing Center (BSC) Lecture Series — The Terminal-First Critique: Why CLI-Native Tools are Rivaling Local MCP Servers\nMicrosoft DevBlogs — Microsoft Agent Framework 1.0: AutoGen and Semantic Kernel Consolidation",{"_1892":13720,"_1893":13721,"_1802":13722},"MCP v2 and the CLI Trend — The Paradigm Shift in AI-Native Development Tools By mid-2026, the AI-native development tool ecosystem is rapidly restructuring away from complex abstractions and toward practicality. The core…","MCP v2とCLIのトレンド — AIネイティブ開発ツールの地殻変動 2026年半ば、AIネイティブ開発ツールのエコシステムは複雑な抽象化を削ぎ落とし、実用性重視へと急速に再編されています。その核心にあるのは、エンタープライズでの拡張性を見据えてステートレス構造へ転換する「モデルコンテキストプロトコル（MCP）」の飛躍と、ローカル環境で圧倒的な効率を発揮するターミナルベースツールの台頭です。エージェントのオーバーヘッドを最大化するので…","MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동 2026년 중반, AI 네이티브 개발 도구 생태계는 복잡한 추상화를 걷어내고 실용성 중심으로 빠르게 재편되고 있습니다. 엔터프라이즈 확장성을 겨냥해 무상태 구조로 전환하는 모델 컨텍스트 프로토콜(MCP)의 도약과, 로컬 환경에서 압도적인 효율을 보여주는 터미널 기반 도구의 부상이 그 핵심입니다. 에이전트 오버헤드를 극대화하는…","cmrv6eizm01my10mug9rw9bh1",[7576],[5909,12028,13726,13727,13728],"agents-md","ollama","developer-experience",[],"2026-07-22T03:08:31.914Z","2026-07-21T21:16:52.496Z","2026-07-22T12:07:10.490Z","2026-07-22T03:09:48.032Z",{"_950":3098,"_1881":1324,"_1675":-5,"_2489":3137,"_1780":3138,"_1899":13735},{"_1901":13736},{"_1903":13737,"_1908":1909,"_1910":13738,"_1921":13739,"_1943":3160},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":3143,"_1914":3144,"_1810":1916,"_944":1916,"_1917":3145,"_1919":3146},{"_1923":13740,"_1928":13741,"_1933":13742,"_1938":13743},{"_1912":3149,"_1914":3150,"_1810":1927,"_944":1927},{"_1912":3152,"_1914":3153,"_1810":1932,"_944":1932},{"_1912":3155,"_1914":3156,"_1810":1937,"_944":1937},{"_1912":3158,"_1914":3159,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":13745,"_1883":1884,"_1200":1204,"_1899":13748},{"_633":13746,"_11":13747},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":13749},{"_1903":13750,"_1908":1909,"_1910":13751,"_1921":13752,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":13753,"_1928":13754,"_1933":13755,"_1938":13756},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":13758},{"_1948":-5,"_1908":1909,"_1910":13759,"_1960":-5,"_1943":13764,"_1962":13765},{"_1912":13760,"_1914":13761,"_1952":13762,"_1810":2534,"_944":1992,"_1917":13763,"_1957":2536,"_1919":10303},"users/cmqyu4juj0000kwcgw89h5ts4/images/originals/b6d9c418-717a-476b-8dba-19f43769aa34.jpg","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/originals/b6d9c418-717a-476b-8dba-19f43769aa34.jpg",381530,"L28g?7^CtR?w~l$^IcN2009.RjD$","2026-07-21T21:39:00.699Z",{"_1964":13766,"_1972":13770,"_1979":13774,"_1986":-5},{"_1912":13767,"_1914":13768,"_1952":13769,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/large.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/large.webp",19092,{"_1912":13771,"_1914":13772,"_1952":13773,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/small.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/small.webp",5362,{"_1912":13775,"_1914":13776,"_1952":13777,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/medium.webp","https://cdn.boutlet.io/users/cmqyu4juj0000kwcgw89h5ts4/images/derivatives/cmrv6eizm01my10mug9rw9bh1/medium.webp",10508,{"_950":13779,"_2559":13701,"_2560":13780,"_2716":13997,"_2788":14089,"_2790":14090,"_2792":7989,"_2794":1997,"_2003":14091,"_2480":14092,"_2797":-5},"cmrv5m2l101mc10mu7tqwzkdx",{"_918":13781,"_1908":1909},[13782,13784,13787,13791,13794,13799,13802,13807,13810,13815,13818,13823,13826,13831,13834,13839,13842,13847,13850,13860,13863,13868,13871,13876,13879,13884,13887,13890,13893,13898,13901,13906,13909,13914,13917,13922,13925,13930,13933,13938,13941,13946,13949,13954,13957,13959,13962,13967,13970],{"_950":13783,"_2565":13714,"_2420":2566,"_2567":13723},"52b17e8e-f413-42ec-8565-c9e61d1e1411",{"_950":13785,"_2420":2570,"_2571":13786},"6ca8fbac-90f9-4461-8500-e34946c2fec2",[],{"_950":13788,"_2420":2575,"_2576":1909,"_2571":13789},"df29181b-87e6-4598-be1f-6fa98b534610",[13790],{"_2579":13714,"_2420":2579},{"_950":13792,"_2420":2570,"_2571":13793},"90927567-232e-442c-90f4-e397db5fbb13",[],{"_950":13795,"_2420":2570,"_2571":13796},"164e09be-b3f9-4053-aaa5-de8f52e8015a",[13797],{"_2579":13798,"_2420":2579},"2026년 중반, AI 네이티브 개발 도구 생태계는 복잡한 추상화를 걷어내고 실용성 중심으로 빠르게 재편되고 있습니다. 엔터프라이즈 확장성을 겨냥해 무상태 구조로 전환하는 모델 컨텍스트 프로토콜(MCP)의 도약과, 로컬 환경에서 압도적인 효율을 보여주는 터미널 기반 도구의 부상이 그 핵심입니다. 에이전트 오버헤드를 극대화하는 대신 단순함과 안정성을 쥐려는 지금, 개발자가 반드시 주목해야 할 기술 트렌드를 함께 살펴봅니다.",{"_950":13800,"_2420":2570,"_2571":13801},"9af1a214-9262-4ee5-944f-08bf5fe40c23",[],{"_950":13803,"_2420":2575,"_2576":2007,"_2571":13804},"1b6cbd4f-c2cc-4229-9b1b-3d03652860c4",[13805],{"_2579":13806,"_2420":2579},"MCP v2: 완전히 무상태로 전환되는 코어 프로토콜",{"_950":13808,"_2420":2570,"_2571":13809},"f9a7a339-6c3a-4f19-a743-f4bc5389069f",[],{"_950":13811,"_2420":2570,"_2571":13812},"51c50901-911a-4120-8e79-6e8323ee4a4d",[13813],{"_2579":13814,"_2420":2579},"2026년 7월 28일 확정되는 Model Context Protocol(MCP) 규격의 핵심 변화는 프로토콜 레이어의 완전한 무상태 구조로의 전환입니다. 기존 v1 규격은 첫 연결 시 진행하는 초기화 핸드셰이크와 세션 식별용 헤더에 의존하는 상태 유지형 아키텍처였습니다. 이 때문에 서버리스 백엔드나 클라우드 부하 분산 환경에서 멀티 에이전트 인터페이스를 수평적으로 확장하는 데 기술적 한계가 있었습니다.",{"_950":13816,"_2420":2570,"_2571":13817},"b5b861ff-1f09-4083-a1ed-027d2d90a383",[],{"_950":13819,"_2420":2570,"_2571":13820},"05510217-6e9d-49f2-915b-2f455800da5b",[13821],{"_2579":13822,"_2420":2579},"v2 규격은 이러한 세션 핸드셰이크 메커니즘을 전면 제거하고 표준 HTTP와 서버 전송 이벤트(SSE) 기반의 통신 패러다임을 채택했습니다. 이제 개발자들은 복잡한 커넥션 유지 비용이나 동기화 부담 없이 일반적인 역방향 프록시 뒤에 원격 MCP 서버를 배치하여 자유롭게 스케일아웃할 수 있습니다. 다만 세션 정보에 의존하던 기존 v1 도구들과는 하위 호환성이 단절되므로 운영 중인 인프라의 마이그레이션 검토가 필요합니다.",{"_950":13824,"_2420":2570,"_2571":13825},"9f5a8296-7cd4-438b-8efc-45df5c889105",[],{"_950":13827,"_2420":2570,"_2571":13828},"6733f920-2bbd-4a5d-b61e-4febe614ba6e",[13829],{"_2579":13830,"_2420":2579},"이번 개편과 함께 개발자 인터페이스도 대폭 강화됩니다. 보안 격리된 iframe 환경을 빌려 채팅 창에 대화형 UI를 직접 렌더링하는 'MCP 앱' 기능과 웹훅 방식으로 데이터를 실시간 푸시하는 'MCP 트리거' 등이 새롭게 통합됩니다. 앤트로픽은 이러한 대대적인 변화에 맞춰 타입스크립트와 파이썬용 SDK v2 업데이트를 동시 지원하며 백엔드 연동 생산성을 뒷받침하고 있습니다.",{"_950":13832,"_2420":2570,"_2571":13833},"f8f61877-ba72-47a2-b555-d739c6051309",[],{"_950":13835,"_2420":2575,"_2576":2007,"_2571":13836},"572de6ed-cc64-4646-9ccc-ed1805ea0620",[13837],{"_2579":13838,"_2420":2579},"터미널 회귀: 왜 CLI 네이티브 도구가 MCP 서버와 경쟁하는가",{"_950":13840,"_2420":2570,"_2571":13841},"2a65132e-b85b-4e3c-b37d-b15e73349e26",[],{"_950":13843,"_2420":2570,"_2571":13844},"067e188a-74d2-4857-b538-1527ef978fd7",[13845],{"_2579":13846,"_2420":2579},"에이전트 인프라가 무상태로 확장되는 흐름과 달리, 로컬 개발 환경에서는 유닉스 CLI 기반의 단순한 도구가 오히려 더 높은 효율을 증명하고 있습니다. 최근 바르셀로나 슈퍼컴퓨팅 센터 강연과 오픈클로(OpenClaw) 메인테이너들의 분석에서 제기된 '터미널 퍼스트' 비판에 따르면, 로컬 환경에서 구동되는 인공지능 에이전트에게는 복잡한 JSON-RPC 규격을 사용하는 모델 컨텍스트 프로토콜(MCP) 서버보다 표준 CLI 명령어를 직접 실행하는 방식이 훨씬 효과적입니다. 대규모 언어 모델은 이미 수십 년간 축적된 유닉스 쉘 데이터를 학습했기 때문에, 정형화된 API 스키마를 거치는 것보다 터미널 명령어를 통해 직접 피드백을 주고받는 작업을 더 매끄럽고 정확하게 처리합니다.",{"_950":13848,"_2420":2570,"_2571":13849},"f7531278-6a37-4897-adbc-318f1f88b5c9",[],{"_950":13851,"_2420":2570,"_2571":13852},"6cbfe948-5600-4bc2-880c-ff564e5e5671",[13853,13855,13858],{"_2579":13854,"_2420":2579},"이러한 CLI 네이티브 방식의 강력한 장점은 토큰 절감 효과와 레이턴시 단축에서 명확히 드러납니다. 앤트로픽(Anthropic)의 터미널 도구인 클로드 코드(Claude Code)의 실제 지표를 살펴보면, 로컬 MCP 서버를 등록하고 상시 연동하기 위해 주고받는 장황한 도구 명세 스키마는 에이전트의 호출 과정에서 상당한 양의 토큰을 낭비하게 만듭니다. 반면 CLI 네이티브 도구는 필요한 순간에만 ",{"_2579":13856,"_2420":2579,"_3365":13857},"--help",{"_3351":3367},{"_2579":13859,"_2420":2579}," 명령어를 호출해 사용법을 동적으로 파악하는 방식으로 컨텍스트 윈도우 부담을 크게 줄입니다. 결과적으로 복잡한 원격 엔터프라이즈 통합에는 무상태 기반의 MCP가 표준으로 자리 잡는 반면, 로컬 개발 루프에서는 터미널 쉘 바인딩이 주류를 이루는 명확한 패러다임 분리가 일어나고 있습니다.",{"_950":13861,"_2420":2570,"_2571":13862},"c117ef31-0b9d-476a-a5e1-cf164b1b95fa",[],{"_950":13864,"_2420":2575,"_2576":2007,"_2571":13865},"ffd2a7a4-889a-452c-ad27-d8a15f3a9d06",[13866],{"_2579":13867,"_2420":2579},"AGENTS.md 표준화와 로컬 LLM 파이프라인의 완성",{"_950":13869,"_2420":2570,"_2571":13870},"a5104599-7341-4156-8494-2c2a76ffa424",[],{"_950":13872,"_2420":2570,"_2571":13873},"01f91f65-e3ef-432b-a207-a86a5c7dac42",[13874],{"_2579":13875,"_2420":2579},"개발 에이전트가 프로젝트의 빌드 규칙, 테스트 방법, 아키텍처 가이드를 일관되게 이해하도록 돕는 정적 컨텍스트 파일로 'AGENTS.md' 규격이 빠르게 정착하고 있습니다. 리눅스 재단 산하의 에이전틱 AI 재단(Agentic AI Foundation)이 표준화한 이 규격은 기존에 파편화되어 있던 설정 파일들을 대체합니다. 에이전트는 리포지토리에 진입할 때 이 파일을 먼저 읽고 프로젝트의 고유한 규칙을 파악합니다.",{"_950":13877,"_2420":2570,"_2571":13878},"352941c2-9079-4d9b-9ae7-1d3f5f6abb1b",[],{"_950":13880,"_2420":2570,"_2571":13881},"688b2e16-0b94-4701-a29e-60f45fbf0371",[13882],{"_2579":13883,"_2420":2579},"AGENTS.md는 다음과 같이 가독성이 높은 마크다운 형식으로 작성됩니다.",{"_950":13885,"_2420":2570,"_2571":13886},"3f2b2e54-f201-405c-9b2c-5cec0b8dcbee",[],{"_950":13888,"_3351":13889,"_2420":3351,"_625":2788},"91f434ac-aa22-45b9-b71e-02868c5b9c59","# AGENTS\n\n## Standards\n- Use TypeScript for backend services.\n- Always write unit tests using Vitest.\n\n## Build & Test\n- Build: `npm run build`\n- Test: `npm run test`",{"_950":13891,"_2420":2570,"_2571":13892},"5fbc2d1d-e80f-42a5-936b-f16ee832e808",[],{"_950":13894,"_2420":2570,"_2571":13895},"14147942-ff50-400d-be0d-af5e33b9c64f",[13896],{"_2579":13897,"_2420":2579},"이러한 정적 가이드라인은 강력한 로컬 모델 및 실행 도구들과 결합해 오프라인 개발 환경으로 확장됩니다. 16GB 메모리에서도 구동되는 구글의 젬마 4(Gemma 4)나 로컬 멀티 토큰 예측에 특화된 Qwen3.6 같은 모델들이 올라마(Ollama)를 통해 로컬에서 가볍게 실행됩니다.",{"_950":13899,"_2420":2570,"_2571":13900},"a178df35-a549-4cd0-92d5-c532f0091596",[],{"_950":13902,"_2420":2570,"_2571":13903},"632c7a64-180d-4548-a350-698cdc7a93b0",[13904],{"_2579":13905,"_2420":2579},"여기에 Go 언어 기반의 로컬 클라이언트 브리지인 mcphost를 연동하면 로컬 모델과 파일 시스템 제어용 MCP 서버를 유기적으로 연결할 수 있습니다. 결과적으로 개발자는 외부 API 호출 없이 로컬 자원만 사용하여 비용과 보안 우려가 없는 프라이빗 에이전트 파이프라인을 완성하게 됩니다.",{"_950":13907,"_2420":2570,"_2571":13908},"f253f321-ded9-4446-a708-3561ef9bdbd1",[],{"_950":13910,"_2420":2575,"_2576":2007,"_2571":13911},"c87fc6ad-b596-4c61-8116-4961a7c6e081",[13912],{"_2579":13913,"_2420":2579},"엔터프라이즈의 보안 관리와 머신 트랜잭션 수립",{"_950":13915,"_2420":2570,"_2571":13916},"7ccca74e-cf82-4c05-a306-f280cd705e79",[],{"_950":13918,"_2420":2570,"_2571":13919},"83f9f646-522f-4ea2-9df6-0147a81f4417",[13920],{"_2579":13921,"_2420":2579},"마이크로소프트가 출시한 엔트라 에이전트 ID(Entra Agent ID)는 대규모 엔터프라이즈 환경에서 AI 에이전트의 권한을 통제하는 핵심 보안 솔루션으로 자리 잡았습니다. 이 시스템은 블루프린트, 블루프린트 프린시펄, 에이전트 아이덴티티로 이루어진 3단계 계층 모델을 제공합니다. 개발자는 전체 인프라 수준의 보안 정책을 전역 블루프린트로 강제하면서도, 특정 테넌트나 개별 에이전트 역할에 맞춘 미세 권한 관리를 안정적으로 구현할 수 있습니다.",{"_950":13923,"_2420":2570,"_2571":13924},"9d990151-f8ed-471e-aaed-ea136b60ca51",[],{"_950":13926,"_2420":2570,"_2571":13927},"5a6de574-810a-4c59-a58f-e8692bb347f3",[13928],{"_2579":13929,"_2420":2579},"한편, 에이전트가 독자적으로 API나 인프라 사용 비용을 지불하는 머신 트랜잭션 분야에서는 x402 프로토콜을 통한 소액 결제 모델이 활발하게 논의되고 있습니다. 이 프로토콜은 표준 HTTP 402 규격을 기반으로 하며, 세 가지 전용 헤더를 사용하여 단 한 번의 요청과 응답 주기 속에서 스테이블코인 결제를 완결합니다. 하지만 기존 x402 방식은 서명 검증 과정에서 EIP-712 및 EIP-3009 암호화 파싱과 외부 결제사 통신으로 인해 요청당 500ms에서 최대 1100ms에 이르는 극심한 검증 지연이 발생하는 한계가 있었습니다.",{"_950":13931,"_2420":2570,"_2571":13932},"b4aa9138-ec5f-4e1f-b3e5-7726715ff124",[],{"_950":13934,"_2420":2570,"_2571":13935},"7679c9d6-64a7-4836-9b47-eee4692e971c",[13936],{"_2579":13937,"_2420":2579},"이러한 지연 문제를 극복하기 위해 신뢰 실행 환경(TEE) 기반의 A402 프로토콜이 대안으로 부상하고 있습니다. A402 프로토콜은 가속 어댑터 서명과 오프체인 형태의 원자적 서비스 채널(ASC) 기술을 결합하여, 온체인 검증 비용을 우회하고 엔드투엔드 레이턴시를 약 350ms 수준까지 혁신적으로 단축했습니다. 덕분에 분초를 다투는 실시간 멀티 에이전트 환경에서도 결제 병목 없이 신속한 인프라 트랜잭션을 수립할 수 있게 되었습니다.",{"_950":13939,"_2420":2570,"_2571":13940},"1905eea2-2c57-4113-9988-96d8692dda6a",[],{"_950":13942,"_2420":2575,"_2576":2007,"_2571":13943},"5b894a91-119a-4ae8-b11c-634372cb71fa",[13944],{"_2579":13945,"_2420":2579},"보안 리스크와 다가올 변화에 대비하는 방법",{"_950":13947,"_2420":2570,"_2571":13948},"754e50cf-d57f-47af-bc62-d61f331969ac",[],{"_950":13950,"_2420":2570,"_2571":13951},"abf7952a-5e59-4ff1-ac02-713cfd43a23d",[13952],{"_2579":13953,"_2420":2579},"AI 에이전트 기술의 대중화 뒤에는 새로운 보안 위협이 자리 잡고 있습니다. 특히 모노레포의 하위 디렉터리에 악성 AGENTS.md 파일을 삽입하여 로컬 에이전트가 원격 코드 실행 명령을 무단으로 수행하게 만드는 기법이나, 엔트라 에이전트 ID의 최상위 블루프린트 권한이 탈취되어 하위 에이전트 전체가 도미노식으로 오염되는 블래스트 레이디어스 위험은 매우 치명적입니다. 따라서 에이전트를 실무에 도입할 때는 명령어 실행 권한을 엄격하게 제한하는 샌드박스 격리 정책과 다중 방어 메커니즘을 반드시 수립해야 합니다.",{"_950":13955,"_2420":2570,"_2571":13956},"f998da81-494e-4b81-9f0b-1d8953321554",[],{"_950":13958,"_2420":3473},"fa2ea424-a685-498e-8d23-db3c65865cea",{"_950":13960,"_2420":2570,"_2571":13961},"c2137a74-aa15-4a4c-9e5e-9d0cd2c6afbc",[],{"_950":13963,"_2420":2570,"_2571":13964},"541331ee-4a62-4b99-b2f2-8a79a055285d",[13965],{"_2579":3483,"_2420":2579,"_3365":13966},{"_3485":3367},{"_950":13968,"_2420":2570,"_2571":13969},"551107c3-fd02-48d6-9d32-3f9aa62d9b91",[],{"_950":13971,"_1881":3492,"_2420":3493,"_778":13972},"56384c5d-a796-4bab-bcb5-c577aa6ca202",[13973,13981,13989],{"_950":13974,"_2571":13975},"e5aa7a1c-9e5c-4ed6-a521-87a0554abb15",[13976],{"_3499":13977,"_2420":3501,"_3502":13978},"https://github.com/mark3labs/mcphost",[13979],{"_2579":13980,"_2420":2579},"Ollama & r/LocalLLaMA Community — Local Execution in 2026: Gemma 4, Qwen3.6 MTP, and Ollama MCP Pipelines",{"_950":13982,"_2571":13983},"68fe1bed-2e5a-4356-aa59-6741283f80e6",[13984],{"_3499":13985,"_2420":3501,"_3502":13986},"https://github.com/granludo/ludo-engsoft/tree/main/week-03/demos",[13987],{"_2579":13988,"_2420":2579},"Barcelona Supercomputing Center (BSC) Lecture Series — The Terminal-First Critique: Why CLI-Native Tools are Rivaling Local MCP Servers",{"_950":13990,"_2571":13991},"64b18702-bd1c-4dd2-bd57-44a8b95397fe",[13992],{"_3499":13993,"_2420":3501,"_3502":13994},"https://github.com/microsoft/semantic-kernel",[13995],{"_2579":13996,"_2420":2579},"Microsoft DevBlogs — Microsoft Agent Framework 1.0: AutoGen and Semantic Kernel Consolidation",{"_13872":13998,"_13819":14002,"_13843":14006,"_13894":14010,"_13795":14014,"_13803":14018,"_13811":14022,"_13963":14026,"_13971":14028,"_13835":14038,"_13926":14042,"_13942":14046,"_13902":14050,"_13827":14054,"_13880":14058,"_13851":14062,"_13934":14067,"_13918":14071,"_13950":14075,"_13910":14079,"_13788":14083,"_13864":14085},{"_2571":13999},{"_1892":14000,"_1893":14001,"_1802":13875},"The 'AGENTS.md' specification is rapidly becoming established as a static context file that helps development agents consistently understand a project's build rules, testing methods, and architectural guides. Standardized by the Agentic AI Foundation under the Linux Foundation, this spec replaces previously fragmented configuration files. Agents read this file first when entering a repository to grasp the project's unique rules.","開発エージェントがプロジェクトのビルドルール、テスト方法、アーキテクチャガイドを一貫して理解できるよう支援する静的コンテキストファイルとして、「AGENTS.md」という規格が急速に定着しつつあります。Linux Foundation傘下のAgentic AI Foundationが標準化したこの規格は、これまで断片化されていた設定ファイルを置き換えるものです。エージェントはリポジトリにアクセスする際、このファイルを最初に読み込んでプロジェクト独自のルールを把握します。",{"_2571":14003},{"_1892":14004,"_1893":14005,"_1802":13822},"The v2 specification eliminates these session handshake mechanisms entirely, adopting a communication paradigm based on standard HTTP and Server-Sent Events (SSE). Developers can now freely scale out by placing remote MCP servers behind standard reverse proxies without the burden of complex connection maintenance or synchronization overhead. Note, however, that backward compatibility with v1 tools that relied on session information is broken, so a migration review for currently operational infrastructure is required.","v2規格では、こうしたセッションハンドシェイクのメカニズムを全面的に廃止し、標準のHTTPとサーバー送信イベント（SSE）に基づく通信パラダイムを採用しました。これにより開発者は、複雑な接続維持のコストや同期の負担なしに、一般的なリバースプロキシの背後にリモートMCPサーバーを配置して自由にスケールアウトできるようになります。ただし、セッション情報に依存していた従来のv1ツールとは下位互換性が断たれるため、運用中のインフラの移行検討が必要です。",{"_2571":14007},{"_1892":14008,"_1893":14009,"_1802":13846},"In contrast to the trend of stateless agent infrastructure expansion, simple Unix CLI-based tools are proving to be more efficient in local development environments. According to the 'terminal-first' critique raised in recent talks at the Barcelona Supercomputing Center and analyses by OpenClaw maintainers, executing standard CLI commands directly is far more effective for AI agents running locally than using the complex JSON-RPC specification of MCP servers. Since large language models have already been trained on decades of accumulated Unix shell data, they process feedback more smoothly and accurately through terminal commands than by traversing formal API schemas.","エージェントインフラがステートレスに拡張される流れとは対照的に、ローカル開発環境ではUNIX CLIベースのシンプルなツールの方が高い効率を発揮しています。近年のバルセロナ・スーパーコンピューティング・センターでの講演やOpenClawメンテナーによる分析で提起された「ターミナルファースト」の批判によれば、ローカル環境で動作するAIエージェントにとって、複雑なJSON-RPC仕様を使うMCPサーバーよりも、標準CLIコマンドを直接実行する方式の方がはるかに効果的です。大規模言語モデルはすでに何十年も蓄積されたUNIXシェルのデータを学習しているため、定型化されたAPIスキーマを介するよりも、ターミナルコマンドを通じて直接フィードバックをやり取りする作業の方が、よりスムーズかつ正確に処理できます。",{"_2571":14011},{"_1892":14012,"_1893":14013,"_1802":13897},"These static guidelines, combined with powerful local models and execution tools, extend to offline development environments. Models like Google's Gemma 4, which runs on 16GB of memory, and Qwen3.6, which specializes in local multi-token prediction, are executed lightly on local machines via Ollama.","このような静的ガイドラインは強力なローカルモデルや実行ツールと組み合わさり、オフライン開発環境へと広がっています。16GBのメモリでも動作するGoogleの「Gemma 4」や、ローカルマルチトークン予測に特化した「Qwen3.6」といったモデルが、Ollamaを通じてローカル環境で軽量に実行されています。",{"_2571":14015},{"_1892":14016,"_1893":14017,"_1802":13798},"By mid-2026, the AI-native development tool ecosystem is rapidly restructuring away from complex abstractions and toward practicality. The core of this shift lies in the Model Context Protocol (MCP) making a leap toward a stateless architecture for enterprise scalability, and the rise of terminal-based tools that demonstrate overwhelming efficiency in local environments. As we move away from maximizing agent overhead toward simplicity and stability, we explore the essential technology trends that every developer should keep an eye on.","2026年半ば、AIネイティブ開発ツールのエコシステムは複雑な抽象化を削ぎ落とし、実用性重視へと急速に再編されています。その核心にあるのは、エンタープライズでの拡張性を見据えてステートレス構造へ転換する「モデルコンテキストプロトコル（MCP）」の飛躍と、ローカル環境で圧倒的な効率を発揮するターミナルベースツールの台頭です。エージェントのオーバーヘッドを最大化するのではなく、シンプルさと安定性を求める今、開発者が必ず注目すべき技術トレンドを一緒に見ていきましょう。",{"_2571":14019},{"_1892":14020,"_1893":14021,"_1802":13806},"MCP v2: The Core Protocol Transitioning to Fully Stateless","MCP v2：完全ステートレスへと転換するコアプロトコル",{"_2571":14023},{"_1892":14024,"_1893":14025,"_1802":13814},"The key change in the Model Context Protocol (MCP) specification, finalized on July 28, 2026, is the shift to a completely stateless architecture at the protocol layer. The existing v1 specification relied on a stateful architecture dependent on initial handshakes and session-identifying headers. This created technical limitations in horizontally scaling multi-agent interfaces within serverless backends or cloud load-balancing environments.","2026年7月28日に確定するModel Context Protocol (MCP) 規格の主要な変更点は、プロトコル層の完全なステートレス構造への転換です。従来のv1規格は、初回接続時の初期化ハンドシェイクとセッション識別用ヘッダーに依存するステートフルなアーキテクチャでした。そのため、サーバーレスバックエンドやクラウドの負荷分散環境において、マルチエージェントインターフェースを水平的に拡張する際に技術的な制約がありました。",{"_2571":14027},{"_1892":3603,"_1893":3604,"_1802":3483},{"_14029":14030,"_14032":14033,"_14035":14036},"item:64b18702-bd1c-4dd2-bd57-44a8b95397fe",{"_1892":13996,"_1893":14031,"_1802":13996},"Microsoft DevBlogs — Microsoft Agent Framework 1.0: AutoGenとSemantic Kernelの統合","item:68fe1bed-2e5a-4356-aa59-6741283f80e6",{"_1892":13988,"_1893":14034,"_1802":13988},"Barcelona Supercomputing Center (BSC) 講義シリーズ — ターミナルファーストの批判: CLIネイティブツールがローカルMCPサーバーと競合する理由","item:e5aa7a1c-9e5c-4ed6-a521-87a0554abb15",{"_1892":13980,"_1893":14037,"_1802":13980},"Ollama & r/LocalLLaMA Community — 2026年のローカル実行環境: Gemma 4, Qwen3.6 MTP, そしてOllama MCPパイプライン",{"_2571":14039},{"_1892":14040,"_1893":14041,"_1802":13838},"The Terminal Regression: Why CLI-Native Tools are Competing with MCP Servers","ターミナル回帰：なぜCLIネイティブツールはMCPサーバーと競合するのか",{"_2571":14043},{"_1892":14044,"_1893":14045,"_1802":13929},"Meanwhile, in the field of machine transactions where agents independently pay for API or infrastructure usage, micro-payment models via the x402 protocol are being actively discussed. This protocol is based on the standard HTTP 402 spec and uses three dedicated headers to finalize stablecoin payments within a single request-response cycle. However, the existing x402 method had limitations, with significant verification latency ranging from 500ms up to 1100ms per request due to EIP-712 and EIP-3009 cryptographic parsing during signature verification, as well as communication with external payment providers.","一方、エージェントが独自にAPIやインフラ使用料を支払うマシン取引の分野では、x402プロトコルを通じた少額決済モデルが活発に議論されています。このプロトコルは標準のHTTP 402規格に基づいており、3つの専用ヘッダーを使用して、わずか1回の要求と応答のサイクルの中でステーブルコインによる決済を完了させます。しかし、従来のx402方式には、署名検証プロセスにおけるEIP-712やEIP-3009の暗号パース、および外部決済会社との通信により、リクエストごとに500msから最大1100msに及ぶ大幅な遅延が発生するという限界がありました。",{"_2571":14047},{"_1892":14048,"_1893":14049,"_1802":13945},"Security Risks and How to Prepare for Coming Changes","セキュリティリスクと今後の変化への備え方",{"_2571":14051},{"_1892":14052,"_1893":14053,"_1802":13905},"By linking this with 'mcphost'—a Go-based local client bridge—developers can organically connect local models with MCP servers for file system control. As a result, developers can complete private agent pipelines that carry no cost or security concerns, utilizing only local resources without external API calls.","ここにGo言語ベースのローカルクライアントブリッジ「mcphost」を連携させれば、ローカルモデルとファイルシステム制御用MCPサーバーを有機的に接続できます。結果として開発者は、外部APIを呼び出すことなく、ローカルリソースのみを使用してコストやセキュリティの懸念がないプライベートなエージェントパイプラインを完成させることができます。",{"_2571":14055},{"_1892":14056,"_1893":14057,"_1802":13830},"Developer interfaces are also being significantly enhanced alongside this update. New features include 'MCP Apps,' which leverage secure, isolated iframe environments to render interactive UIs directly within chat windows, and 'MCP Triggers' for real-time data pushing via webhooks. Anthropic is supporting this major shift by simultaneously updating its TypeScript and Python SDKs to v2, reinforcing backend integration productivity.","今回の改定に合わせて開発者インターフェースも大幅に強化されます。セキュリティで隔離されたiframe環境を介してチャットウィンドウにインタラクティブなUIを直接レンダリングする「MCPアプリ」機能や、Webhook方式でデータをリアルタイムにプッシュする「MCPトリガー」などが新たに追加されます。Anthropicはこの大幅な変更に合わせてTypeScriptおよびPython向けのSDK v2を同時サポートしており、バックエンド連携の生産性を支えています。",{"_2571":14059},{"_1892":14060,"_1893":14061,"_1802":13883},"AGENTS.md is written in a highly readable Markdown format, as follows:","AGENTS.mdは、以下のように可読性の高いMarkdown形式で記述されます。",{"_2571":14063},{"_1892":14064,"_1893":14065,"_1802":14066},"The power of this CLI-native approach is clearly evident in token savings and reduced latency. Examining actual metrics for Anthropic's terminal tool, Claude Code, reveals that the verbose tool specification schemas exchanged to register and maintain local MCP servers waste a significant amount of tokens during agent invocation. In contrast, CLI-native tools significantly reduce context window strain by invoking --help commands dynamically only when necessary. Consequently, a clear paradigm split is occurring: stateless-based MCP is becoming the standard for complex remote enterprise integrations, while terminal shell binding is emerging as the mainstream for local development loops.","こうしたCLIネイティブ方式の大きな利点は、トークン削減効果とレイテンシの短縮に如実に表れています。Anthropicのターミナルツール「Claude Code」の実際の指標を見ると、ローカルMCPサーバーを登録して常時連携するためにやり取りされる冗長なツール定義スキーマは、エージェントの呼び出しプロセスにおいて相当量のトークンを浪費させています。一方、CLIネイティブツールは必要な瞬間にのみ「--help」コマンドを呼び出して使い方を動的に把握する方式のため、コンテキストウィンドウへの負荷を大幅に軽減します。結果として、複雑なリモートエンタープライズ統合にはステートレスベースのMCPが標準として定着する一方、ローカル開発ループではターミナルシェルバインディングが主流になるという明確なパラダイムの分離が起きています。","이러한 CLI 네이티브 방식의 강력한 장점은 토큰 절감 효과와 레이턴시 단축에서 명확히 드러납니다. 앤트로픽(Anthropic)의 터미널 도구인 클로드 코드(Claude Code)의 실제 지표를 살펴보면, 로컬 MCP 서버를 등록하고 상시 연동하기 위해 주고받는 장황한 도구 명세 스키마는 에이전트의 호출 과정에서 상당한 양의 토큰을 낭비하게 만듭니다. 반면 CLI 네이티브 도구는 필요한 순간에만 --help 명령어를 호출해 사용법을 동적으로 파악하는 방식으로 컨텍스트 윈도우 부담을 크게 줄입니다. 결과적으로 복잡한 원격 엔터프라이즈 통합에는 무상태 기반의 MCP가 표준으로 자리 잡는 반면, 로컬 개발 루프에서는 터미널 쉘 바인딩이 주류를 이루는 명확한 패러다임 분리가 일어나고 있습니다.",{"_2571":14068},{"_1892":14069,"_1893":14070,"_1802":13937},"To overcome these latency issues, the A402 protocol based on Trusted Execution Environments (TEE) is emerging as an alternative. By combining accelerated adapter signatures with off-chain Atomic Service Channel (ASC) technology, the A402 protocol bypasses on-chain verification costs and has innovatively reduced end-to-end latency to approximately 350ms. As a result, it is now possible to establish rapid infrastructure transactions without payment bottlenecks, even in time-sensitive, real-time multi-agent environments.","この遅延の問題を克服するため、TEE（信頼実行環境）ベースの「A402」プロトコルが代替手段として浮上しています。A402プロトコルは、加速アダプター署名とオフチェーン形式のアトミックサービスチャネル（ASC）技術を組み合わせることで、オンチェーン検証コストを回避し、エンドツーエンドのレイテンシを約350msまで画期的に短縮しました。これにより、秒を争うリアルタイムのマルチエージェント環境でも、決済のボトルネックなしに迅速なインフラ取引が確立できるようになりました。",{"_2571":14072},{"_1892":14073,"_1893":14074,"_1802":13921},"Microsoft's Entra Agent ID has established itself as a core security solution for controlling AI agent permissions in large enterprise environments. This system provides a three-tier hierarchical model consisting of Blueprints, Blueprint Principals, and Agent Identity. Developers can enforce infrastructure-wide security policies via global blueprints while reliably implementing granular permission management tailored to specific tenants or individual agent roles.","Microsoftがリリースした「Entra Agent ID」は、大規模エンタープライズ環境でAIエージェントの権限を制御するための核心的なセキュリティソリューションとして定着しました。このシステムは、ブループリント、ブループリントプリンシパル、エージェントアイデンティティで構成される3段階の階層モデルを提供します。開発者はインフラ全体のセキュリティポリシーをグローバルなブループリントとして強制しつつ、特定のテナントや各エージェントの役割に合わせた細かい権限管理を安定して実装できます。",{"_2571":14076},{"_1892":14077,"_1893":14078,"_1802":13953},"The popularization of AI agent technology is shadowed by new security threats. In particular, techniques such as injecting malicious AGENTS.md files into subdirectories of a monorepo to make local agents execute unauthorized remote code, or the 'blast radius' risk of Entra Agent ID's top-level blueprint permissions being compromised—causing a domino-effect infection of subordinate agents—are critical. Therefore, when introducing agents into a professional workflow, sandbox isolation policies that strictly limit command execution permissions and multi-layered defense mechanisms must be established.","AIエージェント技術の普及の裏には、新たなセキュリティの脅威が存在します。特にモノレポのサブディレクトリに悪意のあるAGENTS.mdファイルを埋め込んでローカルエージェントに不正なコード実行を行わせる手法や、Entra Agent IDの最上位のブループリント権限が乗っ取られて下位のエージェント全体が連鎖的に汚染される「ブラスト・ラディアス」のリスクは非常に致命的です。そのため、エージェントを実務に導入する際は、コマンド実行権限を厳格に制限するサンドボックス隔離ポリシーと多重防御メカニズムを必ず確立しなければなりません。",{"_2571":14080},{"_1892":14081,"_1893":14082,"_1802":13913},"Enterprise Security Management and Establishing Machine Transactions","エンタープライズのセキュリティ管理とマシン取引の確立",{"_2571":14084},{"_1892":13712,"_1893":13713,"_1802":13714},{"_2571":14086},{"_1892":14087,"_1893":14088,"_1802":13867},"Standardizing AGENTS.md and Completing the Local LLM Pipeline","AGENTS.mdの標準化とローカルLLMパイプラインの完成","![MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동](file:cmrv6eizm01my10mug9rw9bh1)\n\n# MCP v2와 CLI 트렌드 — AI 네이티브 개발 도구의 지각변동\n\n2026년 중반, AI 네이티브 개발 도구 생태계는 복잡한 추상화를 걷어내고 실용성 중심으로 빠르게 재편되고 있습니다. 엔터프라이즈 확장성을 겨냥해 무상태 구조로 전환하는 모델 컨텍스트 프로토콜(MCP)의 도약과, 로컬 환경에서 압도적인 효율을 보여주는 터미널 기반 도구의 부상이 그 핵심입니다. 에이전트 오버헤드를 극대화하는 대신 단순함과 안정성을 쥐려는 지금, 개발자가 반드시 주목해야 할 기술 트렌드를 함께 살펴봅니다.\n\n## MCP v2: 완전히 무상태로 전환되는 코어 프로토콜\n\n2026년 7월 28일 확정되는 Model Context Protocol(MCP) 규격의 핵심 변화는 프로토콜 레이어의 완전한 무상태 구조로의 전환입니다. 기존 v1 규격은 첫 연결 시 진행하는 초기화 핸드셰이크와 세션 식별용 헤더에 의존하는 상태 유지형 아키텍처였습니다. 이 때문에 서버리스 백엔드나 클라우드 부하 분산 환경에서 멀티 에이전트 인터페이스를 수평적으로 확장하는 데 기술적 한계가 있었습니다.\n\nv2 규격은 이러한 세션 핸드셰이크 메커니즘을 전면 제거하고 표준 HTTP와 서버 전송 이벤트(SSE) 기반의 통신 패러다임을 채택했습니다. 이제 개발자들은 복잡한 커넥션 유지 비용이나 동기화 부담 없이 일반적인 역방향 프록시 뒤에 원격 MCP 서버를 배치하여 자유롭게 스케일아웃할 수 있습니다. 다만 세션 정보에 의존하던 기존 v1 도구들과는 하위 호환성이 단절되므로 운영 중인 인프라의 마이그레이션 검토가 필요합니다.\n\n이번 개편과 함께 개발자 인터페이스도 대폭 강화됩니다. 보안 격리된 iframe 환경을 빌려 채팅 창에 대화형 UI를 직접 렌더링하는 'MCP 앱' 기능과 웹훅 방식으로 데이터를 실시간 푸시하는 'MCP 트리거' 등이 새롭게 통합됩니다. 앤트로픽은 이러한 대대적인 변화에 맞춰 타입스크립트와 파이썬용 SDK v2 업데이트를 동시 지원하며 백엔드 연동 생산성을 뒷받침하고 있습니다.\n\n## 터미널 회귀: 왜 CLI 네이티브 도구가 MCP 서버와 경쟁하는가\n\n에이전트 인프라가 무상태로 확장되는 흐름과 달리, 로컬 개발 환경에서는 유닉스 CLI 기반의 단순한 도구가 오히려 더 높은 효율을 증명하고 있습니다. 최근 바르셀로나 슈퍼컴퓨팅 센터 강연과 오픈클로(OpenClaw) 메인테이너들의 분석에서 제기된 '터미널 퍼스트' 비판에 따르면, 로컬 환경에서 구동되는 인공지능 에이전트에게는 복잡한 JSON-RPC 규격을 사용하는 모델 컨텍스트 프로토콜(MCP) 서버보다 표준 CLI 명령어를 직접 실행하는 방식이 훨씬 효과적입니다. 대규모 언어 모델은 이미 수십 년간 축적된 유닉스 쉘 데이터를 학습했기 때문에, 정형화된 API 스키마를 거치는 것보다 터미널 명령어를 통해 직접 피드백을 주고받는 작업을 더 매끄럽고 정확하게 처리합니다.\n\n이러한 CLI 네이티브 방식의 강력한 장점은 토큰 절감 효과와 레이턴시 단축에서 명확히 드러납니다. 앤트로픽(Anthropic)의 터미널 도구인 클로드 코드(Claude Code)의 실제 지표를 살펴보면, 로컬 MCP 서버를 등록하고 상시 연동하기 위해 주고받는 장황한 도구 명세 스키마는 에이전트의 호출 과정에서 상당한 양의 토큰을 낭비하게 만듭니다. 반면 CLI 네이티브 도구는 필요한 순간에만 `--help` 명령어를 호출해 사용법을 동적으로 파악하는 방식으로 컨텍스트 윈도우 부담을 크게 줄입니다. 결과적으로 복잡한 원격 엔터프라이즈 통합에는 무상태 기반의 MCP가 표준으로 자리 잡는 반면, 로컬 개발 루프에서는 터미널 쉘 바인딩이 주류를 이루는 명확한 패러다임 분리가 일어나고 있습니다.\n\n## AGENTS.md 표준화와 로컬 LLM 파이프라인의 완성\n\n개발 에이전트가 프로젝트의 빌드 규칙, 테스트 방법, 아키텍처 가이드를 일관되게 이해하도록 돕는 정적 컨텍스트 파일로 'AGENTS.md' 규격이 빠르게 정착하고 있습니다. 리눅스 재단 산하의 에이전틱 AI 재단(Agentic AI Foundation)이 표준화한 이 규격은 기존에 파편화되어 있던 설정 파일들을 대체합니다. 에이전트는 리포지토리에 진입할 때 이 파일을 먼저 읽고 프로젝트의 고유한 규칙을 파악합니다.\n\nAGENTS.md는 다음과 같이 가독성이 높은 마크다운 형식으로 작성됩니다.\n\n```markdown\n# AGENTS\n\n## Standards\n- Use TypeScript for backend services.\n- Always write unit tests using Vitest.\n\n## Build & Test\n- Build: `npm run build`\n- Test: `npm run test`\n```\n\n이러한 정적 가이드라인은 강력한 로컬 모델 및 실행 도구들과 결합해 오프라인 개발 환경으로 확장됩니다. 16GB 메모리에서도 구동되는 구글의 젬마 4(Gemma 4)나 로컬 멀티 토큰 예측에 특화된 Qwen3.6 같은 모델들이 올라마(Ollama)를 통해 로컬에서 가볍게 실행됩니다.\n\n여기에 Go 언어 기반의 로컬 클라이언트 브리지인 mcphost를 연동하면 로컬 모델과 파일 시스템 제어용 MCP 서버를 유기적으로 연결할 수 있습니다. 결과적으로 개발자는 외부 API 호출 없이 로컬 자원만 사용하여 비용과 보안 우려가 없는 프라이빗 에이전트 파이프라인을 완성하게 됩니다.\n\n## 엔터프라이즈의 보안 관리와 머신 트랜잭션 수립\n\n마이크로소프트가 출시한 엔트라 에이전트 ID(Entra Agent ID)는 대규모 엔터프라이즈 환경에서 AI 에이전트의 권한을 통제하는 핵심 보안 솔루션으로 자리 잡았습니다. 이 시스템은 블루프린트, 블루프린트 프린시펄, 에이전트 아이덴티티로 이루어진 3단계 계층 모델을 제공합니다. 개발자는 전체 인프라 수준의 보안 정책을 전역 블루프린트로 강제하면서도, 특정 테넌트나 개별 에이전트 역할에 맞춘 미세 권한 관리를 안정적으로 구현할 수 있습니다.\n\n한편, 에이전트가 독자적으로 API나 인프라 사용 비용을 지불하는 머신 트랜잭션 분야에서는 x402 프로토콜을 통한 소액 결제 모델이 활발하게 논의되고 있습니다. 이 프로토콜은 표준 HTTP 402 규격을 기반으로 하며, 세 가지 전용 헤더를 사용하여 단 한 번의 요청과 응답 주기 속에서 스테이블코인 결제를 완결합니다. 하지만 기존 x402 방식은 서명 검증 과정에서 EIP-712 및 EIP-3009 암호화 파싱과 외부 결제사 통신으로 인해 요청당 500ms에서 최대 1100ms에 이르는 극심한 검증 지연이 발생하는 한계가 있었습니다.\n\n이러한 지연 문제를 극복하기 위해 신뢰 실행 환경(TEE) 기반의 A402 프로토콜이 대안으로 부상하고 있습니다. A402 프로토콜은 가속 어댑터 서명과 오프체인 형태의 원자적 서비스 채널(ASC) 기술을 결합하여, 온체인 검증 비용을 우회하고 엔드투엔드 레이턴시를 약 350ms 수준까지 혁신적으로 단축했습니다. 덕분에 분초를 다투는 실시간 멀티 에이전트 환경에서도 결제 병목 없이 신속한 인프라 트랜잭션을 수립할 수 있게 되었습니다.\n\n## 보안 리스크와 다가올 변화에 대비하는 방법\n\nAI 에이전트 기술의 대중화 뒤에는 새로운 보안 위협이 자리 잡고 있습니다. 특히 모노레포의 하위 디렉터리에 악성 AGENTS.md 파일을 삽입하여 로컬 에이전트가 원격 코드 실행 명령을 무단으로 수행하게 만드는 기법이나, 엔트라 에이전트 ID의 최상위 블루프린트 권한이 탈취되어 하위 에이전트 전체가 도미노식으로 오염되는 블래스트 레이디어스 위험은 매우 치명적입니다. 따라서 에이전트를 실무에 도입할 때는 명령어 실행 권한을 엄격하게 제한하는 샌드박스 격리 정책과 다중 방어 메커니즘을 반드시 수립해야 합니다.\n\n---\n\n**참고 링크**\n\n- [Ollama & r/LocalLLaMA Community — Local Execution in 2026: Gemma 4, Qwen3.6 MTP, and Ollama MCP Pipelines](https://github.com/mark3labs/mcphost)\n- [Barcelona Supercomputing Center (BSC) Lecture Series — The Terminal-First Critique: Why CLI-Native Tools are Rivaling Local MCP Servers](https://github.com/granludo/ludo-engsoft/tree/main/week-03/demos)\n- [Microsoft DevBlogs — Microsoft Agent Framework 1.0: AutoGen and Semantic Kernel Consolidation](https://github.com/microsoft/semantic-kernel)","ead1fdc748cf231010e7e0b2062a868f1677dae4e8c53ca618464fa78b35b072","2026-07-21T21:16:52.501Z","2026-07-22T03:09:48.070Z",[],[14095],{"_2802":2809,"_1881":4232},{"_950":14097,"_2416":6709,"_2418":6709,"_2419":2080,"_2420":3649,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":14098,"_1889":14106,"_2455":-5,"_2456":-5,"_2457":-5,"_9":14110,"_2450":14118,"_2458":-5,"_2460":-5,"_723":14119,"_1886":14120,"_332":14122,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":14123,"_2003":14124,"_2480":14125,"_2482":-5,"_2483":14126,"_2485":-5,"_2486":-5,"_2487":14127,"_1144":14137,"_2527":-5,"_2555":-5,"_2556":14150,"_2798":14191,"_266":14192},"cmrv8jpq601ox10mu4pys4vul",{"_1801":1802,"_214":14099,"_2429":14100,"_2434":14103,"_2438":2439},386,{"_1892":14101,"_1893":1997,"_1802":14102,"_2433":1997},21,365,{"_1892":14104,"_1893":1997,"_1802":14105,"_2433":1997},0.054404145077720206,0.9455958549222798,{"_9":14107,"_2445":14111,"_2450":14115},{"_1892":14108,"_1893":14109,"_1802":14110},"EIP-8130 Native AA — Verifying with 21,000 Gas Without a Bundler","EIP-8130 ネイティブAA — バンドラーなしで21,000ガスで検証する","EIP-8130 네이티브 AA — 번들러 없이 21,000 가스로 검증하기",{"_1892":14112,"_1893":14113,"_1802":14114},"This is a look at the implementation of EIP-8130 Native Account Abstraction, which I've been finding interesting from a gas cost and architectural perspective. The existing ERC-4337 approach requires running arbitrary code during the smart contract verification phase, necessitating heavy infrastructure like separate mempools or bundlers. In contrast, EIP-8130 introduces a new transaction type, 0x79, to internalize the verification process at the protocol level.\n\nThe core of this is the change at the client level. In the execution pipeline of Reth V2, instead of going through EVM execution, signatures are verified directly at the engine-native layer using pre-registered stateless authenticators. As a result, smart account verification is possible with just 21,000 gas—the same level as standard EOA transactions. Since the bundler simulation process is skipped, gas estimation time is also reduced to the millisecond range.\n\nWith the addition of EIP-8140, even token gas sponsorship can be handled directly by the client without calling a Paymaster contract. This approach of offloading smart contract-level complexity to the execution engine layer seems like a practical solution to lower actual infrastructure costs.","最近、ガス代とアーキテクチャの観点から興味深く見ている、EIP-8130ネイティブアカウント抽象化の実装についての話です。従来のERC-4337方式は、スマートコントラクトの検証段階で任意のコードを実行する必要があり、分離されたメンプールやバンドラーのような重厚なインフラが必要でした。一方、EIP-8130は0x79という新しいトランザクションタイプを導入し、検証プロセスをプロトコルレベルで内蔵しました。\n\n核心はクライアント側の変化です。Reth V2の実行パイプラインにおいて、EVM実行を経由せず、事前に登録されたステートレス・オーセンティケーターを通じてエンジンネイティブレベルで直接署名を検証します。これにより、通常の既存ユーザーアカウントと同水準である21,000ガスのみでスマートアカウントの検証が可能になります。バンドラーのシミュレーション過程が省略されるため、ガス推定の速度もミリ秒単位にまで短縮されます。\n\nEIP-8140まで加われば、トークンのガス代負担もペイマスターコントラクトの呼び出しなしに、クライアントが直接処理できるようになります。スマートコントラクトレベルの複雑さを実行エンジン領域へと移管するこの手法は、実際のインフラコストを下げる実務的な解決策になりそうですね。","최근 가스비와 아키텍처 관점에서 흥미롭게 보고 있는 EIP-8130 네이티브 계정 추상화 구현 이야기입니다. 기존 ERC-4337 방식은 스마트 컨트랙트 검증 단계에서 임의의 코드를 실행해야 해서 분리된 멤풀이나 번들러 같은 무거운 인프라가 필요했습니다. 반면 EIP-8130은 0x79라는 새로운 트랜잭션 유형을 도입해 검증 과정을 프로토콜 레벨로 내재화했습니다.\n\n핵심은 클라이언트단의 변화입니다. Reth V2의 실행 파이프라인에서 EVM 실행을 거치지 않고, 미리 등록된 무상태 어센티케이터를 통해 엔진 네이티브 단에서 서명을 바로 검증합니다. 덕분에 일반 기존 사용자 계정과 동일한 수준인 21,000 가스만으로 스마트 계정 검증이 가능해집니다. 번들러 시뮬레이션 과정이 생략되니 가스 추정 속도도 밀리초 단위로 줄어듭니다.\n\nEIP-8140까지 더해지면 토큰 가스비 대납도 페이마스터 컨트랙트 호출 없이 클라이언트가 직접 처리합니다. 스마트 컨트랙트 레벨의 복잡성을 실행 엔진 영역으로 이관하는 이 방식이 실제 인프라 비용을 낮추는 실무적인 해결책이 될 것 같네요.",{"_1892":14116,"_1893":14117,"_1802":14118},"This is a look at the implementation of EIP-8130 Native Account Abstraction, which I've been finding interesting from a gas cost and architectural perspective. The existing ERC-4337 approach requires running arbitrary co…","最近、ガス代とアーキテクチャの観点から興味深く見ている、EIP-8130ネイティブアカウント抽象化の実装についての話です。従来のERC-4337方式は、スマートコントラクトの検証段階で任意のコードを実行する必要があり、分離されたメンプールやバンドラーのような重厚なインフラが必要でした。一方、EIP-8130は0x79という新しいトランザクションタイプを導入し、検証プロセスをプロトコルレベルで内蔵しました。核心はクライアント側の変化です…","최근 가스비와 아키텍처 관점에서 흥미롭게 보고 있는 EIP-8130 네이티브 계정 추상화 구현 이야기입니다. 기존 ERC-4337 방식은 스마트 컨트랙트 검증 단계에서 임의의 코드를 실행해야 해서 분리된 멤풀이나 번들러 같은 무거운 인프라가 필요했습니다. 반면 EIP-8130은 0x79라는 새로운 트랜잭션 유형을 도입해 검증 과정을 프로토콜 레벨로 내재화했습니다. 핵심은 클라이언트단의 변화입…",[9520],[14121,9524,9523,55,51],"eip",[],"2026-07-21T22:39:01.662Z","2026-07-21T22:39:01.374Z","2026-07-22T22:17:01.308Z","2026-07-21T22:39:12.163Z",{"_950":6709,"_1881":1324,"_1675":-5,"_2489":6748,"_1780":6749,"_1899":14128},{"_1901":14129},{"_1903":14130,"_1908":1909,"_1910":14131,"_1921":14132,"_1943":6771},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":6754,"_1914":6755,"_1810":1916,"_944":1916,"_1917":6756,"_1919":6757},{"_1923":14133,"_1928":14134,"_1933":14135,"_1938":14136},{"_1912":6760,"_1914":6761,"_1810":1927,"_944":1927},{"_1912":6763,"_1914":6764,"_1810":1932,"_944":1932},{"_1912":6766,"_1914":6767,"_1810":1937,"_944":1937},{"_1912":6769,"_1914":6770,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":14138,"_1883":1884,"_1200":1204,"_1899":14141},{"_633":14139,"_11":14140},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":14142},{"_1903":14143,"_1908":1909,"_1910":14144,"_1921":14145,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":14146,"_1928":14147,"_1933":14148,"_1938":14149},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_950":14151,"_2559":14097,"_2560":14152,"_2716":14175,"_2788":14114,"_2790":14188,"_2792":3761,"_2794":1997,"_2003":14189,"_2480":14190,"_2797":-5},"cmrv8jpqb01oy10mu65qv9xzu",{"_918":14153,"_1908":1909},[14154,14159,14162,14167,14170],{"_950":14155,"_2420":2570,"_2571":14156},"cd2a928b-9047-496e-b469-ce794ea6869b",[14157],{"_2579":14158,"_2420":2579},"최근 가스비와 아키텍처 관점에서 흥미롭게 보고 있는 EIP-8130 네이티브 계정 추상화 구현 이야기입니다. 기존 ERC-4337 방식은 스마트 컨트랙트 검증 단계에서 임의의 코드를 실행해야 해서 분리된 멤풀이나 번들러 같은 무거운 인프라가 필요했습니다. 반면 EIP-8130은 0x79라는 새로운 트랜잭션 유형을 도입해 검증 과정을 프로토콜 레벨로 내재화했습니다.",{"_950":14160,"_2420":2570,"_2571":14161},"04d7fab9-990e-4217-b95e-e903a371171a",[],{"_950":14163,"_2420":2570,"_2571":14164},"35142ba7-2a79-40c4-a7b2-f279c54e47c5",[14165],{"_2579":14166,"_2420":2579},"핵심은 클라이언트단의 변화입니다. Reth V2의 실행 파이프라인에서 EVM 실행을 거치지 않고, 미리 등록된 무상태 어센티케이터를 통해 엔진 네이티브 단에서 서명을 바로 검증합니다. 덕분에 일반 기존 사용자 계정과 동일한 수준인 21,000 가스만으로 스마트 계정 검증이 가능해집니다. 번들러 시뮬레이션 과정이 생략되니 가스 추정 속도도 밀리초 단위로 줄어듭니다.",{"_950":14168,"_2420":2570,"_2571":14169},"c7f70712-cabe-4e50-97a9-d45956cc17ca",[],{"_950":14171,"_2420":2570,"_2571":14172},"6b9a1a8e-13ba-4a71-aa38-0d61c1ef5ac5",[14173],{"_2579":14174,"_2420":2579},"EIP-8140까지 더해지면 토큰 가스비 대납도 페이마스터 컨트랙트 호출 없이 클라이언트가 직접 처리합니다. 스마트 컨트랙트 레벨의 복잡성을 실행 엔진 영역으로 이관하는 이 방식이 실제 인프라 비용을 낮추는 실무적인 해결책이 될 것 같네요.",{"_14163":14176,"_14171":14180,"_14155":14184},{"_2571":14177},{"_1892":14178,"_1893":14179,"_1802":14166},"The core of this is the change at the client level. In the execution pipeline of Reth V2, instead of going through EVM execution, signatures are verified directly at the engine-native layer using pre-registered stateless authenticators. As a result, smart account verification is possible with just 21,000 gas—the same level as standard EOA transactions. Since the bundler simulation process is skipped, gas estimation time is also reduced to the millisecond range.","核心はクライアント側の変化です。Reth V2の実行パイプラインにおいて、EVM実行を経由せず、事前に登録されたステートレス・オーセンティケーターを通じてエンジンネイティブレベルで直接署名を検証します。これにより、通常の既存ユーザーアカウントと同水準である21,000ガスのみでスマートアカウントの検証が可能になります。バンドラーのシミュレーション過程が省略されるため、ガス推定の速度もミリ秒単位にまで短縮されます。",{"_2571":14181},{"_1892":14182,"_1893":14183,"_1802":14174},"With the addition of EIP-8140, even token gas sponsorship can be handled directly by the client without calling a Paymaster contract. This approach of offloading smart contract-level complexity to the execution engine layer seems like a practical solution to lower actual infrastructure costs.","EIP-8140まで加われば、トークンのガス代負担もペイマスターコントラクトの呼び出しなしに、クライアントが直接処理できるようになります。スマートコントラクトレベルの複雑さを実行エンジン領域へと移管するこの手法は、実際のインフラコストを下げる実務的な解決策になりそうですね。",{"_2571":14185},{"_1892":14186,"_1893":14187,"_1802":14158},"This is a look at the implementation of EIP-8130 Native Account Abstraction, which I've been finding interesting from a gas cost and architectural perspective. The existing ERC-4337 approach requires running arbitrary code during the smart contract verification phase, necessitating heavy infrastructure like separate mempools or bundlers. In contrast, EIP-8130 introduces a new transaction type, 0x79, to internalize the verification process at the protocol level.","最近、ガス代とアーキテクチャの観点から興味深く見ている、EIP-8130ネイティブアカウント抽象化の実装についての話です。従来のERC-4337方式は、スマートコントラクトの検証段階で任意のコードを実行する必要があり、分離されたメンプールやバンドラーのような重厚なインフラが必要でした。一方、EIP-8130は0x79という新しいトランザクションタイプを導入し、検証プロセスをプロトコルレベルで内蔵しました。","80ee4ddd2fe2543b1a5d41ab10e3119845a33e598850e1188805c97e6c0e5c47","2026-07-21T22:39:01.379Z","2026-07-21T22:39:12.175Z",[],[],{"_950":14194,"_2416":6709,"_2418":2803,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":14195,"_1889":14202,"_2455":-5,"_2456":-5,"_2457":-5,"_9":14206,"_2450":14214,"_2458":14215,"_2460":-5,"_723":14216,"_1886":14217,"_332":14219,"_2473":1909,"_2474":1997,"_2475":1997,"_2476":1997,"_2477":14220,"_2003":14221,"_2480":14222,"_2482":14223,"_2483":14224,"_2485":-5,"_2486":-5,"_2487":14225,"_1144":14235,"_2527":14248,"_2555":-5,"_2556":14269,"_2798":14736,"_266":14737},"cmruq8c9s00u510mu5d54hac8",{"_1801":1802,"_214":14196,"_2429":14197,"_2434":14199,"_2438":2439},3093,{"_1892":14198,"_1893":1997,"_1802":12419,"_2433":1997},922,{"_1892":14200,"_1893":1997,"_1802":14201,"_2433":1997},0.2980924668606531,0.701907533139347,{"_9":14203,"_2445":14207,"_2450":14211},{"_1892":14204,"_1893":14205,"_1802":14206},"Base Cobalt vs. GIWA Chain — Where Should L2 Developers Look in 2026?","Base Cobalt vs GIWA Chain — 2026年、L2開発者はどこへ向かうべきか","Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까",{"_1892":14208,"_1893":14209,"_1802":14210},"Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까\n\nBase Cobalt vs. GIWA Chain — Where Should L2 Developers Look in 2026?\n\nThe 2026 Ethereum Layer 2 (L2) ecosystem is no longer just about gas savings or raw speed. L2s are now entering an architectural arms race, embedding specialized primitives for builders directly at the node client and virtual machine level. At the center of this are 'Base Cobalt,' which targets global services and AI agent commerce with native integration of account abstraction (AA) at the client level, and Dunamu's 'GIWA Chain,' which comes with built-in identity verification and privacy engines tailored for the strict regulatory environment in Korea. In this post, we will compare the different technical directions of these two chains from a builder's perspective and provide clear criteria for choosing the right infrastructure for your project.\n\nBase Cobalt — Native Account Abstraction Without Bundlers\n\nThe Base Cobalt upgrade removes the existing ERC-4337 middleware layer entirely and integrates account abstraction directly into Reth V2, the execution client. The key lies in the native combination of EIP-8130, which handles account configuration at the execution layer, and EIP-8140, which guarantees token gas fee payments.\n\nThe greatest weapon in this architecture is the complete omission of off-chain bundlers or complex entry point contract calls within the EVM. When a node receives the new 0x79 transaction type, it completes O(1) complexity signature verification deterministically at the execution engine level without VM simulation. As a result, the verification overhead of a smart wallet drops significantly to 21,000 gas, which is on par with standard EOAs.\n\nThis innovation in cost and speed provides a massive breakthrough for AI agent commerce environments that need to execute hundreds of automated payments per millisecond. The example below shows a real-world implementation pattern using the experimental module of the viem library to define a new smart account, register a session key (Actor) with limited permissions for an agent, and process atomic execution using 0x79 type transactions.\n\n(Based on viem v2.x experimental/eip8130 API)\nimport { key, newSmartAccount8130, authorizeActor, actorScope, sendCalls8130 } from \"viem/experimental/eip8130\";\n\n// 1) EIP-8130 스마트 계정 및 에이전트용 세션 키(P-256) 정의\nconst account = newSmartAccount8130({ signer: key.k1(\"0xOwnerKey...\") });\nconst agentSigner = key.p256({ x: \"0x...\", y: \"0x...\" });\n\n// 2) 트랜잭션 전송 권한(sender) 및 유효 기한을 가진 Actor 변경 내역 생성\nconst authorizeChange = authorizeActor(agentSigner, {\n scope: actorScope.sender,\n expiry: 1900000000n\n});\n\n// 3) 0x79 트랜잭션으로 스마트 계정 배포와 Actor 변경 내역을 단일 배치로 원자적 전송\nconst hash = await sendCalls8130(client, {\n account,\n accountChanges: [account.createChange, authorizeChange],\n calls: [{ to: \"0xRecipient...\", value: parseEther(\"0.001\") }]\n});\n\nUsing this approach, developers no longer need to operate complex, high-maintenance bundler infrastructure or perform heavy binary search simulations to calculate gas limits. Because the verification path is securely standardized at the consensus layer, it fundamentally controls threats like denial-of-service (DoS) attacks on the mempool.\n\nGIWA Chain — Identity and Privacy Engines for the Korean Market\n\nLaunched in collaboration with the Optimism Foundation, GIWA Chain is an open L2 chain that adopts Optimism Enterprise's Self-Managed tier. While it uses the globally standardized OP Stack, it is characterized by an architecture that features vertically integrated identity verification and regulatory compliance layers specifically for the domestic market. It is designed to achieve a 1-second block time with a target gas fee of approximately 1 KRW.\n\nFrom a developer's perspective, the most powerful tool is the on-chain implementation of 'Dojang,' an on-chain identity verification service. Dojang is built on the Ethereum Attestation Service (EAS) protocol, allowing users to prove that their wallet address has completed Know Your Customer (KYC) verification without exposing personal information. The core addresses and configuration values for Dojang deployed on the GIWA Sepolia testnet are as follows.\n\nEAS Main Contract: 0x4200000000000000000000000000000000000021\nSchema Registry: 0x4200000000000000000000000000000000000020\nUpbit Official Attester: 0x09B170CA2A006081042992bCE7379B85a02149C6\nAttestation Address Schema UID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\n\nDevelopers can use this on-chain schema information to control interactions so that only verified users are permitted at the smart contract level, eliminating the need to build a complex off-chain real-name authentication infrastructure from scratch.\n\nThis is combined with 'Bojagi,' a financial privacy layer that incorporates Zero-Knowledge Proof (ZKP) technology. While maintaining the transparency of the blockchain, Bojagi provides the transaction confidentiality required for large-scale B2B transactions or financial institution transfers in real-time. It is already performing stable technology verification for deposit token transfers and payments with commercial banks, expanding its potential as an L2 specialized for the regulated sector.\n\nWhere Should You Develop? — Comparing Architectures and Ecosystems\n\nThe choice of architecture depends entirely on the core requirements of the service you intend to build. If you are building a high-performance AI agent or a high-speed smart account service targeting the global market, look forward to the Base Cobalt upgrade. It significantly lowers build difficulty and gas overhead because it allows transactions to be sent directly to the standard mempool without needing to operate a complex off-chain bundler infrastructure.\n\nConversely, if you are designing a payment service that requires integration with domestic financial systems, verified identity, and privacy, GIWA Chain is an excellent alternative. GIWA Chain offers up to $100,000 in developer grants through its accelerated builder support program and provides an integrated address identification service called UP.ID based on Soulbound Tokens, with a built-in identity layer necessary for local regulatory compliance and collaboration with financial institutions.\n\nPractical Checklist for 2026 L2 Builders\n\nWhen choosing new L2 infrastructure, do not mistake the temporary performance of a testnet for the security and maturity of a mainnet. You must coldly compare the technical milestones of these two chains, both scheduled for mainnet deployment in the second half of 2026, and decide on an architecture that aligns with your project's goals.\n\nThe EIP-8130 and EIP-8140 features of Base Cobalt can be verified in advance on the VibeNet testnet. However, the load and security of a native verification structure without an off-chain bundler when processing large-scale transactions in a real mainnet environment will require further validation after the official launch, scheduled for September 2026.\n\nIn the case of GIWA Chain, you can immediately test the Dojang and EAS integration contracts on the GIWA Sepolia testnet using chain ID 91342. Builders should closely monitor the private mainnet operational progress targeted for Q3 2026, as well as the schedule for open-sourcing the zero-knowledge verification contracts of Bojagi, GIWA's privacy engine.\n\nUltimately, the choice of Layer 2 in 2026 comes down to what unique primitives you can offer your application, rather than a simple speed competition. If you are building global-scale smart accounts and AI agents, Base Cobalt will be your answer; if your objective is strong domestic regulatory compliance and privacy-preserving financial solutions, GIWA Chain will be the clear choice.\n\nReference Links\n\nL2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (Mid-2026)\nOptimism Foundation & Dunamu — Dunamu's GIWA Chain Launches Testnet and Partners on OP Enterprise Self-Managed Tier\nOptimism Foundation & Dunamu — Upbit Operator Dunamu and Optimism Partner on GIWA Chain","Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까\n\nBase Cobalt vs GIWA Chain — 2026年、L2開発者はどこへ向かうべきか\n\n2026年のイーサリアムレイヤー2（L2）エコシステムにおける焦点は、単なるガス代の削減や処理速度の競争ではありません。今やL2は、ノードクライアントと仮想マシンレベルでビルダー専用のプリミティブを内蔵する、アーキテクチャ競争のフェーズに突入しました。クライアントレベルでのアカウント抽象化（AA）をネイティブ統合し、グローバルサービスとAIエージェントコマースをターゲットにする「Base Cobalt」、そして国内の強力なコンプライアンス環境に合わせて本人確認とプライバシーエンジンを組み込んだ、ドゥナム（Dunamu）の「GIWA Chain」がその中心にあります。本稿では、ビルダーの視点からこれら2つのチェーンの異なる技術的志向を比較し、実際の開発過程でどのようなインフラを選択すべきか、明確な基準を提示します。\n\nBase Cobalt — バンドラー不要のネイティブ・アカウント抽象化\n\nBase Cobaltのアップグレードは、既存のERC-4337のミドルウェア層を完全に排除し、実行クライアントであるReth V2内部に直接アカウント抽象化を統合します。核心となるのは、実行レイヤーレベルでアカウント設定を処理するEIP-8130と、トークンによるガス代支払いを保証するEIP-8140のネイティブ結合です。\n\nこのアーキテクチャの最大の武器は、オフチェーンのバンドラーやEVM内部での複雑なエントリーポイント契約の呼び出しを全面的に省略できる点です。ノードが新しい0x79トランザクションタイプを受信すると、仮想マシンのシミュレーションなしで実行エンジン側で決定論的なO(1)複雑度の署名検証を直接完了します。これにより、スマートウォレットの検証オーバーヘッドが、従来のEOAと完全に同等の21,000ガスまで激減します。\n\nこうしたコストと速度の革新は、ミリ秒単位で数百もの自動決済を実行する必要があるAIエージェントコマース環境において、圧倒的な突破口を提供します。以下の例は、viemライブラリの実験的モジュールを活用して新しいスマートアカウントを定義し、限定的な権限のみを持つエージェント用セッションキー（Actor）を登録して、0x79タイプトランザクションによるアトミックな実行を処理する実戦的な実装パターンです。\n\n（viem v2.x experimental/eip8130 API準拠）\nimport { key, newSmartAccount8130, authorizeActor, actorScope, sendCalls8130 } from \"viem/experimental/eip8130\";\n\n// 1) EIP-8130 스마트 계정 및 에이전트용 세션 키(P-256) 정의\nconst account = newSmartAccount8130({ signer: key.k1(\"0xOwnerKey...\") });\nconst agentSigner = key.p256({ x: \"0x...\", y: \"0x...\" });\n\n// 2) 트랜잭션 전송 권한(sender) 및 유효 기한을 가진 Actor 변경 내역 생성\nconst authorizeChange = authorizeActor(agentSigner, {\n scope: actorScope.sender,\n expiry: 1900000000n\n});\n\n// 3) 0x79 트랜잭션으로 스마트 계정 배포와 Actor 변경 내역을 단일 배치로 원자적 전송\nconst hash = await sendCalls8130(client, {\n account,\n accountChanges: [account.createChange, authorizeChange],\n calls: [{ to: \"0xRecipient...\", value: parseEther(\"0.001\") }]\n});\n\nこの手法を活用すれば、開発者はもはや複雑で維持費のかかるバンドラーインフラを運用したり、ガス代の上限を計算するために重い二分探索シミュレーションを行う必要はありません。合意形成レイヤーレベルで検証経路が安全に規格化されているため、メンプールのDoS攻撃のリスクまで根本から制御できるからです。\n\nGIWA Chain — 韓国市場をターゲットにした本人確認とプライバシーエンジン\n\nドゥナムがOptimism財団と協力して発表したGIWA Chainは、Optimism Enterpriseのセルフマネージド（Self-Managed）ティアを採用したオープンなL2チェーンです。グローバル標準技術であるOPスタックを使用しながらも、国内環境に特化した本人確認およびコンプライアンス層を垂直統合（Vertical Integration）の形式で内蔵しているアーキテクチャが特徴です。1秒のブロックタイムを実現し、ガス代は約1ウォン水準を目指して設計されました。\n\n開発者にとっての最強の武器は、オンチェーン本人確認サービスである「Dojang（印鑑）」の実装です。DojangはEthereum Attestation Service（EAS）プロトコルに基づいて設計されており、個人情報を露呈させることなく、ウォレットアドレスの本人確認（KYC）完了の事実のみを証明します。GIWA SepoliaテストネットにデプロイされたDojangのコアアドレスおよび設定値は以下の通りです。\n\nEASメインコントラクト: 0x4200000000000000000000000000000000000021\nスキーマレジストリ（Schema Registry）: 0x4200000000000000000000000000000000000020\nUpbit公認アテスター（Attester）: 0x09B170CA2A006081042992bCE7379B85a02149C6\n認証アドレススキーマUID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\n\n開発者はこのオンチェーン・スキーマ情報を利用することで、複雑なオフチェーン実名認証インフラを直接構築することなく、スマートコントラクトレベルで認証済みのユーザーのみをフィルタリングしてやり取りを制御できます。\n\nさらに、ゼロ知識証明（ZKP）技術を加えた金融プライバシーレイヤー「Bojagi（包み）」が統合されます。Bojagiはブロックチェーンの透明性を維持しつつも、企業間の大規模な取引や金融機関の送金時に必要な取引の機密性をリアルタイムで確保します。すでに市中の銀行との預金トークン送金および決済技術の検証を安定的に遂行しており、制度圏特化型L2としての可能性を広げています。\n\nどこで開発すべきか — アーキテクチャとエコシステムの比較\n\n開発したいサービスの核心的な要件によって、アーキテクチャの選択は全く異なります。グローバル市場をターゲットに高性能なAIエージェントや超高速なスマートアカウントサービスを構築するなら、Base Cobaltのアップグレードが期待できます。複雑なバンドラー・オフチェーンインフラを直接運用する必要がなく、標準メンプールへトランザクションを直接送信できるため、ビルドの難易度とガスオーバーヘッドが劇的に低下します。\n\n一方、国内の金融システムとの連携、確実な本人確認、そしてプライバシーが必要な決済サービスを設計するなら、GIWA Chainが優れた代替案となります。GIWA Chainは「アクセラレーテッド・ビルダー支援プログラム」を通じて最大10万ドル相当の開発者助成金を提供しており、ソウルバウンドトークンベースのアドレス識別サービスであるUP.IDを統合提供しています。これにより、ローカルの規制環境と金融機関との協業に必要なIDレイヤーを基本搭載しています。\n\n2026年、L2ビルダーのための実戦チェックリスト\n\n新しいL2インフラを選択する際、テストネットの一時的な性能をメインネットのセキュリティや成熟度と勘違いしてはいけません。2026年後半のメインネット配備を控えた両チェーンの技術マイルストーンを冷静に比較し、プロジェクトの志向に合わせてアーキテクチャを決定する必要があります。\n\nBase CobaltのEIP-8130およびEIP-8140機能は、現在VibeNetテストネットで事前に検証可能です。ただし、オフチェーンバンドラーがないネイティブ検証構造が、実際のメインネット環境で大規模なトランザクションを処理する際にノードにかける負荷やセキュリティについては、2026年9月に予定されている正式リリース後、さらなる検証を経る必要があります。\n\nGIWA Chainの場合、チェーンID 91342を使用するGIWA Sepoliaテストネットで、DojangおよびEAS統合コントラクトを即時テスト可能な状態です。ビルダーは、2026年第3四半期を目標とするプライベートメインネットの運用推移と共に、GIWAのプライバシーエンジン「Bojagi」のゼロ知識検証コントラクトのオープンソース化日程を密接に注視する必要があります。\n\n結局、2026年のレイヤー2選択は、単なる速度競争ではなく、アプリケーションにどのような独自のプリミティブを提供できるかどうかにかかっています。グローバル規模のスマートアカウントとAIエージェントをビルドするならBase Cobaltが、強力な国内コンプライアンスとプライバシー金融ソリューションが目的であればGIWA Chainが、明確な答えとなるでしょう。\n\n参考リンク\n\nL2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (2026年中期)\nOptimism Foundation & Dunamu — Dunamu's GIWA Chain Launches Testnet and Partners on OP Enterprise Self-Managed Tier\nOptimism Foundation & Dunamu — Upbit Operator Dunamu and Optimism Partner on GIWA Chain","Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까\n\nBase Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까\n\n2026년 이더리움 레이어 2(L2) 생태계의 화두는 단순한 가스비 절감이나 처리 속도 경쟁이 아닙니다. 이제 L2들은 노드 클라이언트와 가상머신 수준에서 빌더를 위한 전용 프리미티브를 내장하는 아키텍처 경쟁에 돌입했습니다. 클라이언트 레벨에서 계정 추상화(AA)를 네이티브로 통합하여 글로벌 서비스와 AI 에이전트 커머스를 정조준하는 '베이스 코발트(Base Cobalt)', 그리고 국내 강력한 규제 준수 환경에 맞춰 신원인증과 프라이버시 엔진을 내장한 두나무의 '기와 체인(GIWA Chain)'이 그 중심에 있습니다. 이번 글에서는 빌더의 눈높이에서 두 체인의 상이한 기술적 지향점을 비교하고, 실제 개발 과정에서 어떤 인프라를 선택해야 할지 명확한 기준을 짚어보겠습니다.\n\nBase Cobalt — 번들러 없는 네이티브 계정 추상화\n\n베이스 코발트(Base Cobalt) 업그레이드는 기존 ERC-4337의 미들웨어 계층을 완전히 제거하고, 실행 클라이언트인 Reth V2 내부에 직접 계정 추상화를 통합합니다. 핵심은 실행 레이어 수준에서 계정 설정을 처리하는 EIP-8130과 토큰 가스 수수료 지불을 보장하는 EIP-8140의 네이티브 결합입니다.\n\n이 아키텍처의 가장 큰 무기는 오프체인 번들러나 EVM 내부의 복잡한 엔트리포인트 계약 호출이 전면 생략된다는 점입니다. 노드가 새로운 0x79 트랜잭션 타입을 수신하면, 가상머신 시뮬레이션 없이 실행 엔진 단에서 결정론적인 O(1) 복잡도의 서명 검증을 직접 완료합니다. 이 덕분에 스마트 지갑의 검증 오버헤드가 기존 EOA와 완전히 대등한 수준인 21,000 가스로 급감합니다.\n\n이러한 비용 및 속도 혁신은 밀리초 단위로 수백 개의 자동화 결제를 실행해야 하는 AI 에이전트 커머스 환경에 압도적인 돌파구를 제시합니다. 아래 예시는 viem 라이브러리의 실험적 모듈을 활용해 새로운 스마트 계정을 정의하고, 제한된 권한만 지닌 에이전트용 세션 키(Actor)를 등록하여 0x79 타입 트랜잭션으로 원자적 실행을 처리하는 실전 구현 패턴입니다.\n\n(viem v2.x experimental/eip8130 API 기준)\nimport { key, newSmartAccount8130, authorizeActor, actorScope, sendCalls8130 } from \"viem/experimental/eip8130\";\n\n// 1) EIP-8130 스마트 계정 및 에이전트용 세션 키(P-256) 정의\nconst account = newSmartAccount8130({ signer: key.k1(\"0xOwnerKey...\") });\nconst agentSigner = key.p256({ x: \"0x...\", y: \"0x...\" });\n\n// 2) 트랜잭션 전송 권한(sender) 및 유효 기한을 가진 Actor 변경 내역 생성\nconst authorizeChange = authorizeActor(agentSigner, {\n scope: actorScope.sender,\n expiry: 1900000000n\n});\n\n// 3) 0x79 트랜잭션으로 스마트 계정 배포와 Actor 변경 내역을 단일 배치로 원자적 전송\nconst hash = await sendCalls8130(client, {\n account,\n accountChanges: [account.createChange, authorizeChange],\n calls: [{ to: \"0xRecipient...\", value: parseEther(\"0.001\") }]\n});\n\n이 방식을 활용하면 개발자는 더 이상 복잡하고 유지비가 큰 번들러 인프라를 운영하거나 가스비 한도를 계산하기 위해 무거운 바이너리 서치 시뮬레이션을 수행할 필요가 없습니다. 합의 레이어 수준에서 검증 경로가 안전하게 규격화되어 멤풀의 서비스 거부 공격 위협까지 근본적으로 제어하기 때문입니다.\n\nGIWA Chain — 한국 시장을 겨냥한 신원과 프라이버시 엔진\n\n두나무가 옵티미즘 재단과 협력하여 선보인 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 오픈 L2 체인입니다. 글로벌 표준 기술인 OP 스택을 사용하면서도, 국내 환경에 특화된 신원 인증 및 규제 준수 레이어를 세로형 통합(Vertical Integration) 형태로 내장한 아키텍처가 특징입니다. 1초의 블록 타임을 구현하며 가스비는 약 1원 수준을 목표로 설계되었습니다.\n\n개발자 입장에서 가장 강력한 무기는 온체인 신원 인증 서비스인 '도장(Dojang)'의 실제 온체인 구현체입니다. 도장은 이더리움 증명 서비스(EAS) 프로토콜을 기반으로 설계되어, 개인정보 노출 없이 지갑 주소의 본인인증(KYC) 완료 여부만을 증명합니다. 기와 세폴리아(GIWA Sepolia) 테스트넷에 배포된 도장 핵심 주소 및 설정값은 다음과 같습니다.\n\nEAS 메인 컨트랙트: 0x4200000000000000000000000000000000000021\n스키마 레지스트리(Schema Registry): 0x4200000000000000000000000000000000000020\n업비트 공인 인증자(Attester): 0x09B170CA2A006081042992bCE7379B85a02149C6\n인증 주소 스키마 UID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08\n\n개발자는 이 온체인 스키마 정보를 활용해 복잡한 오프체인 실명인증 인프라를 직접 구축할 필요 없이, 스마트 컨트랙트 수준에서 인증된 사용자만 필터링하여 상호작용하도록 제어할 수 있습니다.\n\n여기에 영지식 증명(ZKP) 기술을 가미한 금융 프라이버시 레이어 '보자기(Bojagi)'가 결합합니다. 보자기는 블록체인의 투명성을 유지하면서도 기업 간 대형 거래나 금융 기관 송금 시 필요한 거래 기밀성을 실시간으로 확보해 줍니다. 이미 시중 은행과의 예금 토큰 송금 및 결제 기술 검증을 안정적으로 수행하며 제도권 특화 L2로서의 가능성을 넓혀가고 있습니다.\n\n어디서 개발해야 할까 — 아키텍처와 생태계 비교\n\n개발하려는 서비스의 핵심 요구사항에 따라 아키텍처 선택은 완전히 달라집니다. 글로벌 시장을 타깃으로 고성능 AI 에이전트나 초고속 스마트 어카운트 서비스를 구축한다면 베이스 코발트 업그레이드를 기대해볼 수 있습니다. 복잡한 번들러 오프체인 인프라를 직접 운영할 필요 없이 표준 멤풀로 트랜잭션을 바로 전송하므로 빌드 난이도와 가스 오버헤드가 획기적으로 낮아집니다.\n\n반면 국내 금융 시스템과의 연동, 확실한 신원인증, 프라이버시가 필요한 결제 서비스를 설계한다면 기와 체인이 우수한 대안이 됩니다. 기와 체인은 가속 빌더 지원 프로그램을 통해 최대 10만 달러 상당의 개발자 그랜트를 지원하며, 소울바운드 토큰 기반의 주소 식별 서비스인 UP.ID를 통합 제공하여 로컬 규제 환경과 금융권 협업에 필요한 신원 레이어를 기본 탑재하고 있습니다.\n\n2026년 L2 빌더를 위한 실전 체크리스트\n\n새로운 L2 인프라를 선택할 때 테스트넷의 일시적인 성능을 메인넷의 보안성과 성숙도로 오인해서는 안 됩니다. 2026년 하반기 메인넷 배포를 앞둔 두 체인의 기술 마일스톤을 냉정하게 비교하고 프로젝트의 지향점에 맞추어 아키텍처를 결정해야 합니다.\n\n베이스 코발트의 EIP-8130 및 EIP-8140 기능은 현재 바이브넷 테스트넷에서 미리 검증해 볼 수 있습니다. 다만 오프체인 번들러가 없는 네이티브 검증 구조가 실제 메인넷 환경에서 대규모 트랜잭션을 처리할 때 노드에 가하는 부하와 보안성은 2026년 9월로 예정된 정식 출시 이후 한 단계 더 검증을 거쳐야 합니다.\n\n기와 체인의 경우 체인 ID 91342를 사용하는 기와 세폴리아 테스트넷에서 도장과 EAS 통합 컨트랙트를 즉시 테스트할 수 있는 상태입니다. 빌더들은 2026년 3분기 목표인 프라이빗 메인넷 운영 추이와 함께, 기와의 프라이버시 엔진인 보자기의 영지식 검증 컨트랙트 오픈소스화 일정을 긴밀히 주시해야 합니다.\n\n결국 2026년의 레이어 2 선택은 단순한 속도 경쟁이 아닌 애플리케이션에 어떠한 고유 프리미티브를 제공할 수 있느냐에 달렸습니다. 글로벌 스케일의 스마트 어카운트와 AI 에이전트를 빌드한다면 베이스 코발트가, 강력한 국내 규제 준수와 프라이버시 금융 솔루션이 목적이라면 기와 체인이 명확한 해답이 될 것입니다.\n\n참고 링크\n\nL2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (Mid-2026)\nOptimism Foundation & Dunamu — Dunamu's GIWA Chain Launches Testnet and Partners on OP Enterprise Self-Managed Tier\nOptimism Foundation & Dunamu — Upbit Operator Dunamu and Optimism Partner on GIWA Chain",{"_1892":14212,"_1893":14213,"_1802":14214},"Base Cobalt vs. GIWA Chain — Where Should L2 Developers Look in 2026? The 2026 Ethereum Layer 2 (L2) ecosystem is no longer just about gas savings or raw speed. L2s are now entering an architectural arms race, embedding…","Base Cobalt vs GIWA Chain — 2026年、L2開発者はどこへ向かうべきか 2026年のイーサリアムレイヤー2（L2）エコシステムにおける焦点は、単なるガス代の削減や処理速度の競争ではありません。今やL2は、ノードクライアントと仮想マシンレベルでビルダー専用のプリミティブを内蔵する、アーキテクチャ競争のフェーズに突入しました。クライアントレベルでのアカウント抽象化（AA）をネイティブ統合し、グローバルサービスとA…","Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까 2026년 이더리움 레이어 2(L2) 생태계의 화두는 단순한 가스비 절감이나 처리 속도 경쟁이 아닙니다. 이제 L2들은 노드 클라이언트와 가상머신 수준에서 빌더를 위한 전용 프리미티브를 내장하는 아키텍처 경쟁에 돌입했습니다. 클라이언트 레벨에서 계정 추상화(AA)를 네이티브로 통합하여 글로벌 서비스와…","cmrur77qf00vz10mu2p6etcxi",[3122],[6737,14218,6735,9524,14121,6738],"base-cobalt",[],"2026-07-21T20:16:18.820Z","2026-07-21T14:06:17.632Z","2026-07-22T23:20:29.488Z","2026-07-21T22:53:57.875Z","2026-07-22T23:20:29.458Z",{"_950":6709,"_1881":1324,"_1675":-5,"_2489":6748,"_1780":6749,"_1899":14226},{"_1901":14227},{"_1903":14228,"_1908":1909,"_1910":14229,"_1921":14230,"_1943":6771},{"_1677":1997,"_1906":1997,"_1810":1916,"_944":1916},{"_1912":6754,"_1914":6755,"_1810":1916,"_944":1916,"_1917":6756,"_1919":6757},{"_1923":14231,"_1928":14232,"_1933":14233,"_1938":14234},{"_1912":6760,"_1914":6761,"_1810":1927,"_944":1927},{"_1912":6763,"_1914":6764,"_1810":1932,"_944":1932},{"_1912":6766,"_1914":6767,"_1810":1937,"_944":1937},{"_1912":6769,"_1914":6770,"_1810":1942,"_944":1942},{"_950":2080,"_1876":1800,"_633":2081,"_1801":1888,"_1889":14236,"_1883":1884,"_1200":1204,"_1899":14239},{"_633":14237,"_11":14238},{"_1892":2081,"_1893":2087,"_1802":2088},{"_1892":2082,"_1893":2090,"_1802":2091},{"_1901":14240},{"_1903":14241,"_1908":1909,"_1910":14242,"_1921":14243,"_1943":2115},{"_1677":2095,"_1906":2095,"_1810":2096,"_944":2096},{"_1912":2098,"_1914":2099,"_1810":1916,"_944":1916,"_1917":2100,"_1919":2101},{"_1923":14244,"_1928":14245,"_1933":14246,"_1938":14247},{"_1912":2104,"_1914":2105,"_1810":1927,"_944":1927},{"_1912":2107,"_1914":2108,"_1810":1932,"_944":1932},{"_1912":2110,"_1914":2111,"_1810":1937,"_944":1937},{"_1912":2113,"_1914":2114,"_1810":1942,"_944":1942},{"_1901":14249},{"_1948":-5,"_1908":1909,"_1910":14250,"_1960":-5,"_1943":14255,"_1962":14256},{"_1912":14251,"_1914":14252,"_1952":14253,"_1810":2534,"_944":1992,"_1917":14254,"_1957":2536,"_1919":5946},"users/cmqx0mggs00004jcg8uoj3tmt/images/originals/8a3c939f-caa0-44ad-9bfc-657e4f0d33f7.jpg","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/originals/8a3c939f-caa0-44ad-9bfc-657e4f0d33f7.jpg",649987,"L14{J8ZKRfXZ^kt+Rp.9ujKDIqri","2026-07-21T14:33:25.346Z",{"_1964":14257,"_1972":14261,"_1979":14265,"_1986":-5},{"_1912":14258,"_1914":14259,"_1952":14260,"_1810":1969,"_944":2544,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/large.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/large.webp",55458,{"_1912":14262,"_1914":14263,"_1952":14264,"_1810":1977,"_944":2549,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/small.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/small.webp",11226,{"_1912":14266,"_1914":14267,"_1952":14268,"_1810":1984,"_944":2554,"_1957":1971},"users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/medium.webp","https://cdn.boutlet.io/users/cmqx0mggs00004jcg8uoj3tmt/images/derivatives/cmrur77qf00vz10mu2p6etcxi/medium.webp",28944,{"_950":14270,"_2559":14194,"_2560":14271,"_2716":14600,"_2788":14732,"_2790":14733,"_2792":8939,"_2794":1997,"_2003":14734,"_2480":14735,"_2797":-5},"cmruq8c9w00u610mu67hqq2nj",{"_918":14272,"_1908":1909},[14273,14276,14280,14285,14289,14295,14299,14305,14309,14315,14319,14330,14334,14349,14353,14361,14364,14368,14374,14378,14384,14388,14394,14398,14404,14408,14449,14453,14459,14463,14469,14473,14479,14483,14489,14493,14499,14503,14509,14513,14519,14523,14529,14533,14539,14543,14549,14553,14555,14559,14565,14569,14596],{"_950":14274,"_2565":14206,"_2420":2566,"_3202":591,"_3203":14275,"_2567":14215},"7340e7aa-b7fc-43cb-8bcb-7caa20abc61a",{"_3205":591},{"_950":14277,"_2420":2570,"_3203":14278,"_2571":14279},"3d10163c-3d65-4277-bab2-1e2b5c4fb159",{"_3205":591},[],{"_950":14281,"_2420":2575,"_2576":1909,"_3203":14282,"_2571":14283},"3024591b-7e12-4675-897a-818652a61ec3",{"_3205":591},[14284],{"_2579":14206,"_2420":2579},{"_950":14286,"_2420":2570,"_3203":14287,"_2571":14288},"75371271-62e6-4a00-88a6-7129d9c1930e",{"_3205":591},[],{"_950":14290,"_2420":2570,"_3203":14291,"_2571":14292},"26ff45bb-017a-41b6-bc68-f4a663f9a54f",{"_3205":591},[14293],{"_2579":14294,"_2420":2579},"2026년 이더리움 레이어 2(L2) 생태계의 화두는 단순한 가스비 절감이나 처리 속도 경쟁이 아닙니다. 이제 L2들은 노드 클라이언트와 가상머신 수준에서 빌더를 위한 전용 프리미티브를 내장하는 아키텍처 경쟁에 돌입했습니다. 클라이언트 레벨에서 계정 추상화(AA)를 네이티브로 통합하여 글로벌 서비스와 AI 에이전트 커머스를 정조준하는 '베이스 코발트(Base Cobalt)', 그리고 국내 강력한 규제 준수 환경에 맞춰 신원인증과 프라이버시 엔진을 내장한 두나무의 '기와 체인(GIWA Chain)'이 그 중심에 있습니다. 이번 글에서는 빌더의 눈높이에서 두 체인의 상이한 기술적 지향점을 비교하고, 실제 개발 과정에서 어떤 인프라를 선택해야 할지 명확한 기준을 짚어보겠습니다.",{"_950":14296,"_2420":2570,"_3203":14297,"_2571":14298},"b0d886e8-c5d4-47fc-9525-6b16984c7534",{"_3205":591},[],{"_950":14300,"_2420":2575,"_2576":2007,"_3203":14301,"_2571":14302},"722b2094-b1fd-4996-baf4-48aeefa2ead7",{"_3205":591},[14303],{"_2579":14304,"_2420":2579},"Base Cobalt — 번들러 없는 네이티브 계정 추상화",{"_950":14306,"_2420":2570,"_3203":14307,"_2571":14308},"ce884a3a-63f2-487e-8de1-d377cbe5ac87",{"_3205":591},[],{"_950":14310,"_2420":2570,"_3203":14311,"_2571":14312},"dc2cc958-23d0-4487-a5e7-4d3cf511e715",{"_3205":591},[14313],{"_2579":14314,"_2420":2579},"베이스 코발트(Base Cobalt) 업그레이드는 기존 ERC-4337의 미들웨어 계층을 완전히 제거하고, 실행 클라이언트인 Reth V2 내부에 직접 계정 추상화를 통합합니다. 핵심은 실행 레이어 수준에서 계정 설정을 처리하는 EIP-8130과 토큰 가스 수수료 지불을 보장하는 EIP-8140의 네이티브 결합입니다.",{"_950":14316,"_2420":2570,"_3203":14317,"_2571":14318},"eba8c349-6b6d-4a6e-a586-6bab4c85acee",{"_3205":591},[],{"_950":14320,"_2420":2570,"_3203":14321,"_2571":14322},"9fa96b51-f7cd-4391-921a-b136e840e52e",{"_3205":591},[14323,14325,14328],{"_2579":14324,"_2420":2579},"이 아키텍처의 가장 큰 무기는 오프체인 번들러나 EVM 내부의 복잡한 엔트리포인트 계약 호출이 전면 생략된다는 점입니다. 노드가 새로운 ",{"_2579":14326,"_2420":2579,"_3365":14327},"0x79",{"_3351":3367},{"_2579":14329,"_2420":2579}," 트랜잭션 타입을 수신하면, 가상머신 시뮬레이션 없이 실행 엔진 단에서 결정론적인 O(1) 복잡도의 서명 검증을 직접 완료합니다. 이 덕분에 스마트 지갑의 검증 오버헤드가 기존 EOA와 완전히 대등한 수준인 21,000 가스로 급감합니다.",{"_950":14331,"_2420":2570,"_3203":14332,"_2571":14333},"231486e6-7827-4f9f-a047-92f2c91c5159",{"_3205":591},[],{"_950":14335,"_2420":2570,"_3203":14336,"_2571":14337},"4782ce93-2995-4556-927d-2030225d6106",{"_3205":591},[14338,14340,14343,14345,14347],{"_2579":14339,"_2420":2579},"이러한 비용 및 속도 혁신은 밀리초 단위로 수백 개의 자동화 결제를 실행해야 하는 AI 에이전트 커머스 환경에 압도적인 돌파구를 제시합니다. 아래 예시는 ",{"_2579":14341,"_2420":2579,"_3365":14342},"viem",{"_3351":3367},{"_2579":14344,"_2420":2579}," 라이브러리의 실험적 모듈을 활용해 새로운 스마트 계정을 정의하고, 제한된 권한만 지닌 에이전트용 세션 키(Actor)를 등록하여 ",{"_2579":14326,"_2420":2579,"_3365":14346},{"_3351":3367},{"_2579":14348,"_2420":2579}," 타입 트랜잭션으로 원자적 실행을 처리하는 실전 구현 패턴입니다.",{"_950":14350,"_2420":2570,"_3203":14351,"_2571":14352},"e6b442b4-52d0-453e-8097-ec9e2f17ae95",{"_3205":591},[],{"_950":14354,"_2420":2570,"_3203":14355,"_2571":14356},"80d61dcc-9606-4d22-94f4-8092a597905d",{"_3205":591},[14357],{"_2579":14358,"_2420":2579,"_3365":14359},"(viem v2.x experimental/eip8130 API 기준)",{"_14360":3367},"italic",{"_950":14362,"_3351":14363,"_2420":3351,"_625":3125},"19cb301c-2fd1-4f6b-8c53-2c4e6bfbe1db","import { key, newSmartAccount8130, authorizeActor, actorScope, sendCalls8130 } from \"viem/experimental/eip8130\";\n\n// 1) EIP-8130 스마트 계정 및 에이전트용 세션 키(P-256) 정의\nconst account = newSmartAccount8130({ signer: key.k1(\"0xOwnerKey...\") });\nconst agentSigner = key.p256({ x: \"0x...\", y: \"0x...\" });\n\n// 2) 트랜잭션 전송 권한(sender) 및 유효 기한을 가진 Actor 변경 내역 생성\nconst authorizeChange = authorizeActor(agentSigner, {\n scope: actorScope.sender,\n expiry: 1900000000n\n});\n\n// 3) 0x79 트랜잭션으로 스마트 계정 배포와 Actor 변경 내역을 단일 배치로 원자적 전송\nconst hash = await sendCalls8130(client, {\n account,\n accountChanges: [account.createChange, authorizeChange],\n calls: [{ to: \"0xRecipient...\", value: parseEther(\"0.001\") }]\n});",{"_950":14365,"_2420":2570,"_3203":14366,"_2571":14367},"dc974b91-7333-41c9-a82b-370b37aa7528",{"_3205":591},[],{"_950":14369,"_2420":2570,"_3203":14370,"_2571":14371},"dc51e619-648b-4055-9c0e-10499fa888a7",{"_3205":591},[14372],{"_2579":14373,"_2420":2579},"이 방식을 활용하면 개발자는 더 이상 복잡하고 유지비가 큰 번들러 인프라를 운영하거나 가스비 한도를 계산하기 위해 무거운 바이너리 서치 시뮬레이션을 수행할 필요가 없습니다. 합의 레이어 수준에서 검증 경로가 안전하게 규격화되어 멤풀의 서비스 거부 공격 위협까지 근본적으로 제어하기 때문입니다.",{"_950":14375,"_2420":2570,"_3203":14376,"_2571":14377},"473a4423-a15e-4a06-8551-7bf89ba255af",{"_3205":591},[],{"_950":14379,"_2420":2575,"_2576":2007,"_3203":14380,"_2571":14381},"df30d55a-91ca-4006-91b7-76f76c80af9a",{"_3205":591},[14382],{"_2579":14383,"_2420":2579},"GIWA Chain — 한국 시장을 겨냥한 신원과 프라이버시 엔진",{"_950":14385,"_2420":2570,"_3203":14386,"_2571":14387},"43a8195a-2cec-4f7d-9fee-fcf032457697",{"_3205":591},[],{"_950":14389,"_2420":2570,"_3203":14390,"_2571":14391},"00cd54e8-80cd-48f5-9d70-24e6ceccd0cb",{"_3205":591},[14392],{"_2579":14393,"_2420":2579},"두나무가 옵티미즘 재단과 협력하여 선보인 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 오픈 L2 체인입니다. 글로벌 표준 기술인 OP 스택을 사용하면서도, 국내 환경에 특화된 신원 인증 및 규제 준수 레이어를 세로형 통합(Vertical Integration) 형태로 내장한 아키텍처가 특징입니다. 1초의 블록 타임을 구현하며 가스비는 약 1원 수준을 목표로 설계되었습니다.",{"_950":14395,"_2420":2570,"_3203":14396,"_2571":14397},"ce9dfa54-eee8-433c-b76a-610b80ee3210",{"_3205":591},[],{"_950":14399,"_2420":2570,"_3203":14400,"_2571":14401},"a590369b-19d8-4716-93e1-0ad6e4a4bba9",{"_3205":591},[14402],{"_2579":14403,"_2420":2579},"개발자 입장에서 가장 강력한 무기는 온체인 신원 인증 서비스인 '도장(Dojang)'의 실제 온체인 구현체입니다. 도장은 이더리움 증명 서비스(EAS) 프로토콜을 기반으로 설계되어, 개인정보 노출 없이 지갑 주소의 본인인증(KYC) 완료 여부만을 증명합니다. 기와 세폴리아(GIWA Sepolia) 테스트넷에 배포된 도장 핵심 주소 및 설정값은 다음과 같습니다.",{"_950":14405,"_2420":2570,"_3203":14406,"_2571":14407},"50f00541-43e5-4396-992a-c8a8df2d1f05",{"_3205":591},[],{"_950":14409,"_1881":3492,"_2420":3493,"_778":14410},"cf3567c2-34f8-4adc-be9b-6fbd488935f5",[14411,14421,14430,14440],{"_950":14412,"_2571":14413},"70973f48-32cd-4791-b297-8018552a9429",[14414,14417,14419],{"_2579":14415,"_2420":2579,"_3365":14416},"EAS 메인 컨트랙트:",{"_3485":3367},{"_2579":14418,"_2420":2579}," ",{"_2579":6969,"_2420":2579,"_3365":14420},{"_3351":3367},{"_950":14422,"_2571":14423},"47ed12fc-e080-42d6-b048-3f990ede19a0",[14424,14427,14428],{"_2579":14425,"_2420":2579,"_3365":14426},"스키마 레지스트리(Schema Registry):",{"_3485":3367},{"_2579":14418,"_2420":2579},{"_2579":6974,"_2420":2579,"_3365":14429},{"_3351":3367},{"_950":14431,"_2571":14432},"edecd210-0349-4d6e-b77e-7eb6bca17fd7",[14433,14436,14437],{"_2579":14434,"_2420":2579,"_3365":14435},"업비트 공인 인증자(Attester):",{"_3485":3367},{"_2579":14418,"_2420":2579},{"_2579":14438,"_2420":2579,"_3365":14439},"0x09B170CA2A006081042992bCE7379B85a02149C6",{"_3351":3367},{"_950":14441,"_2571":14442},"ee810840-0fe5-4f94-8487-5c6fb42660b6",[14443,14446,14447],{"_2579":14444,"_2420":2579,"_3365":14445},"인증 주소 스키마 UID:",{"_3485":3367},{"_2579":14418,"_2420":2579},{"_2579":6979,"_2420":2579,"_3365":14448},{"_3351":3367},{"_950":14450,"_2420":2570,"_3203":14451,"_2571":14452},"759a8157-80d3-4395-928c-d54537f1b502",{"_3205":591},[],{"_950":14454,"_2420":2570,"_3203":14455,"_2571":14456},"a0de225d-8224-49c5-a8f2-13018e8adf51",{"_3205":591},[14457],{"_2579":14458,"_2420":2579},"개발자는 이 온체인 스키마 정보를 활용해 복잡한 오프체인 실명인증 인프라를 직접 구축할 필요 없이, 스마트 컨트랙트 수준에서 인증된 사용자만 필터링하여 상호작용하도록 제어할 수 있습니다.",{"_950":14460,"_2420":2570,"_3203":14461,"_2571":14462},"753a64d8-e781-41df-97d6-36985444f79e",{"_3205":591},[],{"_950":14464,"_2420":2570,"_3203":14465,"_2571":14466},"9c2db79a-94f2-432a-9637-196480d76a45",{"_3205":591},[14467],{"_2579":14468,"_2420":2579},"여기에 영지식 증명(ZKP) 기술을 가미한 금융 프라이버시 레이어 '보자기(Bojagi)'가 결합합니다. 보자기는 블록체인의 투명성을 유지하면서도 기업 간 대형 거래나 금융 기관 송금 시 필요한 거래 기밀성을 실시간으로 확보해 줍니다. 이미 시중 은행과의 예금 토큰 송금 및 결제 기술 검증을 안정적으로 수행하며 제도권 특화 L2로서의 가능성을 넓혀가고 있습니다.",{"_950":14470,"_2420":2570,"_3203":14471,"_2571":14472},"702d806b-1f61-42f9-b4d2-ca7d89ce88c3",{"_3205":591},[],{"_950":14474,"_2420":2575,"_2576":2007,"_3203":14475,"_2571":14476},"296969fa-74d5-46ad-bd21-a493e47fe002",{"_3205":591},[14477],{"_2579":14478,"_2420":2579},"어디서 개발해야 할까 — 아키텍처와 생태계 비교",{"_950":14480,"_2420":2570,"_3203":14481,"_2571":14482},"b1b2cf2a-6506-4354-a9b6-57da9e8f3e96",{"_3205":591},[],{"_950":14484,"_2420":2570,"_3203":14485,"_2571":14486},"b31e8ab2-8b90-4f68-bfef-116c7e1dc351",{"_3205":591},[14487],{"_2579":14488,"_2420":2579},"개발하려는 서비스의 핵심 요구사항에 따라 아키텍처 선택은 완전히 달라집니다. 글로벌 시장을 타깃으로 고성능 AI 에이전트나 초고속 스마트 어카운트 서비스를 구축한다면 베이스 코발트 업그레이드를 기대해볼 수 있습니다. 복잡한 번들러 오프체인 인프라를 직접 운영할 필요 없이 표준 멤풀로 트랜잭션을 바로 전송하므로 빌드 난이도와 가스 오버헤드가 획기적으로 낮아집니다.",{"_950":14490,"_2420":2570,"_3203":14491,"_2571":14492},"90388d93-4caf-444d-9ab5-9db004348741",{"_3205":591},[],{"_950":14494,"_2420":2570,"_3203":14495,"_2571":14496},"9983497c-6d63-419d-91f9-8a2ef1bcd8d3",{"_3205":591},[14497],{"_2579":14498,"_2420":2579},"반면 국내 금융 시스템과의 연동, 확실한 신원인증, 프라이버시가 필요한 결제 서비스를 설계한다면 기와 체인이 우수한 대안이 됩니다. 기와 체인은 가속 빌더 지원 프로그램을 통해 최대 10만 달러 상당의 개발자 그랜트를 지원하며, 소울바운드 토큰 기반의 주소 식별 서비스인 UP.ID를 통합 제공하여 로컬 규제 환경과 금융권 협업에 필요한 신원 레이어를 기본 탑재하고 있습니다.",{"_950":14500,"_2420":2570,"_3203":14501,"_2571":14502},"f87531e6-80f5-4976-9444-8a12f1d286f0",{"_3205":591},[],{"_950":14504,"_2420":2575,"_2576":2007,"_3203":14505,"_2571":14506},"db73ca59-5f14-46ef-9e3b-32df146b9810",{"_3205":591},[14507],{"_2579":14508,"_2420":2579},"2026년 L2 빌더를 위한 실전 체크리스트",{"_950":14510,"_2420":2570,"_3203":14511,"_2571":14512},"6384e183-a995-4c4d-8667-60f66d090de8",{"_3205":591},[],{"_950":14514,"_2420":2570,"_3203":14515,"_2571":14516},"ec507a48-87c0-4f37-9b1d-21d2a80890aa",{"_3205":591},[14517],{"_2579":14518,"_2420":2579},"새로운 L2 인프라를 선택할 때 테스트넷의 일시적인 성능을 메인넷의 보안성과 성숙도로 오인해서는 안 됩니다. 2026년 하반기 메인넷 배포를 앞둔 두 체인의 기술 마일스톤을 냉정하게 비교하고 프로젝트의 지향점에 맞추어 아키텍처를 결정해야 합니다.",{"_950":14520,"_2420":2570,"_3203":14521,"_2571":14522},"c67b2a82-c7ee-48fb-93a7-11406d737bb8",{"_3205":591},[],{"_950":14524,"_2420":2570,"_3203":14525,"_2571":14526},"b08aab91-6e03-4894-905d-28056c92f112",{"_3205":591},[14527],{"_2579":14528,"_2420":2579},"베이스 코발트의 EIP-8130 및 EIP-8140 기능은 현재 바이브넷 테스트넷에서 미리 검증해 볼 수 있습니다. 다만 오프체인 번들러가 없는 네이티브 검증 구조가 실제 메인넷 환경에서 대규모 트랜잭션을 처리할 때 노드에 가하는 부하와 보안성은 2026년 9월로 예정된 정식 출시 이후 한 단계 더 검증을 거쳐야 합니다.",{"_950":14530,"_2420":2570,"_3203":14531,"_2571":14532},"65d6cebf-7853-4eb9-b4cb-a38b9d0fdfa8",{"_3205":591},[],{"_950":14534,"_2420":2570,"_3203":14535,"_2571":14536},"b9e2a3ea-f435-4534-a2aa-7c061098ab82",{"_3205":591},[14537],{"_2579":14538,"_2420":2579},"기와 체인의 경우 체인 ID 91342를 사용하는 기와 세폴리아 테스트넷에서 도장과 EAS 통합 컨트랙트를 즉시 테스트할 수 있는 상태입니다. 빌더들은 2026년 3분기 목표인 프라이빗 메인넷 운영 추이와 함께, 기와의 프라이버시 엔진인 보자기의 영지식 검증 컨트랙트 오픈소스화 일정을 긴밀히 주시해야 합니다.",{"_950":14540,"_2420":2570,"_3203":14541,"_2571":14542},"9a93cb5f-4ffd-4d45-a8da-a7ff943b6221",{"_3205":591},[],{"_950":14544,"_2420":2570,"_3203":14545,"_2571":14546},"e072f878-003a-4623-8f79-5e4a979e7a44",{"_3205":591},[14547],{"_2579":14548,"_2420":2579},"결국 2026년의 레이어 2 선택은 단순한 속도 경쟁이 아닌 애플리케이션에 어떠한 고유 프리미티브를 제공할 수 있느냐에 달렸습니다. 글로벌 스케일의 스마트 어카운트와 AI 에이전트를 빌드한다면 베이스 코발트가, 강력한 국내 규제 준수와 프라이버시 금융 솔루션이 목적이라면 기와 체인이 명확한 해답이 될 것입니다.",{"_950":14550,"_2420":2570,"_3203":14551,"_2571":14552},"ef12ca0e-d9a5-49a8-a0be-3ea1d9ad7d4c",{"_3205":591},[],{"_950":14554,"_2420":3473},"4ffacbf6-fcf1-4a85-8c4e-4f8005a37853",{"_950":14556,"_2420":2570,"_3203":14557,"_2571":14558},"878093b8-2b13-4cb1-a5ce-f04a1b9e9a67",{"_3205":591},[],{"_950":14560,"_2420":2570,"_3203":14561,"_2571":14562},"76d84385-c46c-4091-982d-a0e832568e0c",{"_3205":591},[14563],{"_2579":3483,"_2420":2579,"_3365":14564},{"_3485":3367},{"_950":14566,"_2420":2570,"_3203":14567,"_2571":14568},"342b05ce-2cd2-4847-a16f-360794cd2477",{"_3205":591},[],{"_950":14570,"_1881":3492,"_2420":3493,"_778":14571},"ea58b987-10f7-43b8-b648-f8d98c6254a6",[14572,14580,14588],{"_950":14573,"_2571":14574},"baab29e9-7da6-47a6-80d7-44b0f06bd470",[14575],{"_3499":14576,"_2420":3501,"_3502":14577},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFBs6McoFkMbAk7WPfFCZr0VD4E9P4B9js516U3DRUuXmiiYak1pp1Eqk9B7GBbhpMAa361gOwZXdMkNWcknwk54IFiOJRsgodMba-sFDS1cX7ksrP4kdps",[14578],{"_2579":14579,"_2420":2579},"L2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (Mid-2026)",{"_950":14581,"_2571":14582},"f43d815a-41e1-4bfe-bf00-e4c9534774d9",[14583],{"_3499":14584,"_2420":3501,"_3502":14585},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQEizrlfPz-dhIzRPn3L9cOIO8q1FHkT2z1NnfRPBkVrmDahXRYdJm9IyAoi7fgsVeC7h_Xi1Flgqx67hs3ZOpTiU40mKQh8AhkQW5iwXcztHZ9q5NaNCOvCSvV9ceSCO5XTiXzGqo4T4xWl6tal0xxAtY-U18V3pKcM9zl3fZTJbuJU5iydg45VoC6r1VjCBq2lLEzlzYSqbJ5zYyfrQnzR0uqvQP9K_ShOvId47GuS3uKhP_k=",[14586],{"_2579":14587,"_2420":2579},"Optimism Foundation & Dunamu — Dunamu's GIWA Chain Launches Testnet and Partners on OP Enterprise Self-Managed Tier",{"_950":14589,"_2571":14590},"60f350e9-cd37-4a87-844d-23d1e0361469",[14591],{"_3499":14592,"_2420":3501,"_3502":14593},"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQELu62mSOBoeDBCMZHAXoFXovUNnUSgIhsUwwlmuSWJJwLKW2Qrs-cPvmUC-6j7tJsQVxOVzqHKaTWMZp1UXm8xDFZKTSm0sptTV3_UUkkbHmGlEqznQCkUW93hUyygZDqMzr8pon__tolDBRYfYv3a_WNup-0W0wtNbLOX-2HscubRUy_nApAiawdaRwxj7qGyegpNNTcVdSDU7Jy_JYqn8op70APyvLpNy0_sys6UWLoSYgI=",[14594],{"_2579":14595,"_2420":2579},"Optimism Foundation & Dunamu — Upbit Operator Dunamu and Optimism Partner on GIWA Chain",{"_950":14597,"_2420":2570,"_3203":14598,"_2571":14599},"5fad8097-4dd5-432e-8420-68019f8956af",{"_3205":591},[],{"_14389":14601,"_14290":14605,"_14474":14609,"_14281":14613,"_14615":14616,"_14335":14637,"_14300":14642,"_14646":14647,"_14560":14654,"_14354":14656,"_14494":14660,"_14464":14664,"_14320":14668,"_14454":14673,"_14399":14677,"_14524":14681,"_14484":14685,"_14534":14689,"_14409":14693,"_14504":14703,"_14310":14707,"_14369":14711,"_14379":14715,"_14544":14719,"_14570":14723,"_14514":14728},{"_2571":14602},{"_1892":14603,"_1893":14604,"_1802":14393},"Launched in collaboration with the Optimism Foundation, GIWA Chain is an open L2 chain that adopts Optimism Enterprise's Self-Managed tier. While it uses the globally standardized OP Stack, it is characterized by an architecture that features vertically integrated identity verification and regulatory compliance layers specifically for the domestic market. It is designed to achieve a 1-second block time with a target gas fee of approximately 1 KRW.","ドゥナムがOptimism財団と協力して発表したGIWA Chainは、Optimism Enterpriseのセルフマネージド（Self-Managed）ティアを採用したオープンなL2チェーンです。グローバル標準技術であるOPスタックを使用しながらも、国内環境に特化した本人確認およびコンプライアンス層を垂直統合（Vertical Integration）の形式で内蔵しているアーキテクチャが特徴です。1秒のブロックタイムを実現し、ガス代は約1ウォン水準を目指して設計されました。",{"_2571":14606},{"_1892":14607,"_1893":14608,"_1802":14294},"The 2026 Ethereum Layer 2 (L2) ecosystem is no longer just about gas savings or raw speed. L2s are now entering an architectural arms race, embedding specialized primitives for builders directly at the node client and virtual machine level. At the center of this are 'Base Cobalt,' which targets global services and AI agent commerce with native integration of account abstraction (AA) at the client level, and Dunamu's 'GIWA Chain,' which comes with built-in identity verification and privacy engines tailored for the strict regulatory environment in Korea. In this post, we will compare the different technical directions of these two chains from a builder's perspective and provide clear criteria for choosing the right infrastructure for your project.","2026年のイーサリアムレイヤー2（L2）エコシステムにおける焦点は、単なるガス代の削減や処理速度の競争ではありません。今やL2は、ノードクライアントと仮想マシンレベルでビルダー専用のプリミティブを内蔵する、アーキテクチャ競争のフェーズに突入しました。クライアントレベルでのアカウント抽象化（AA）をネイティブ統合し、グローバルサービスとAIエージェントコマースをターゲットにする「Base Cobalt」、そして国内の強力なコンプライアンス環境に合わせて本人確認とプライバシーエンジンを組み込んだ、ドゥナム（Dunamu）の「GIWA Chain」がその中心にあります。本稿では、ビルダーの視点からこれら2つのチェーンの異なる技術的志向を比較し、実際の開発過程でどのようなインフラを選択すべきか、明確な基準を提示します。",{"_2571":14610},{"_1892":14611,"_1893":14612,"_1802":14478},"Where Should You Develop? — Comparing Architectures and Ecosystems","どこで開発すべきか — アーキテクチャとエコシステムの比較",{"_2571":14614},{"_1892":14204,"_1893":14205,"_1802":14206},"41f8903f-6f86-47d7-a6f9-48a5d8ac8827",{"_14617":14618,"_14622":14623,"_14627":14628,"_14632":14633},"item:47ed12fc-e080-42d6-b048-3f990ede19a0",{"_1892":14619,"_1893":14620,"_1802":14621},"Schema Registry: 0x4200000000000000000000000000000000000020","スキーマレジストリ (Schema Registry): 0x4200000000000000000000000000000000000020","스키마 레지스트리(Schema Registry): 0x4200000000000000000000000000000000000020","item:70973f48-32cd-4791-b297-8018552a9429",{"_1892":14624,"_1893":14625,"_1802":14626},"EAS Main Contract: 0x4200000000000000000000000000000000000021","EASメインコントラクト: 0x4200000000000000000000000000000000000021","EAS 메인 컨트랙트: 0x4200000000000000000000000000000000000021","item:edecd210-0349-4d6e-b77e-7eb6bca17fd7",{"_1892":14629,"_1893":14630,"_1802":14631},"Upbit Attester: 0x4097bF3Cb731AEB3E501b910B33B2aF9Fa68E388","Upbit公認認証者 (Attester): 0x4097bF3Cb731AEB3E501b910B33B2aF9Fa68E388","업비트 공인 인증자(Attester): 0x4097bF3Cb731AEB3E501b910B33B2aF9Fa68E388","item:ee810840-0fe5-4f94-8487-5c6fb42660b6",{"_1892":14634,"_1893":14635,"_1802":14636},"Verification Address Schema UID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08","認証アドレススキーマUID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08","인증 주소 스키마 UID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08",{"_2571":14638},{"_1892":14639,"_1893":14640,"_1802":14641},"This innovation in cost and speed provides a massive breakthrough for AI agent commerce environments that need to execute hundreds of automated payments per millisecond. The example below shows a real-world implementation pattern using the experimental module of the viem library to define a new smart account, register a session key (Actor) with limited permissions for an agent, and process atomic execution using 0x79 type transactions.","こうしたコストと速度の革新は、ミリ秒単位で数百もの自動決済を実行する必要があるAIエージェントコマース環境において、圧倒的な突破口を提供します。以下の例は、viemライブラリの実験的モジュールを活用して新しいスマートアカウントを定義し、限定的な権限のみを持つエージェント用セッションキー（Actor）を登録して、0x79タイプトランザクションによるアトミックな実行を処理する実戦的な実装パターンです。","이러한 비용 및 속도 혁신은 밀리초 단위로 수백 개의 자동화 결제를 실행해야 하는 AI 에이전트 커머스 환경에 압도적인 돌파구를 제시합니다. 아래 예시는 viem 라이브러리의 실험적 모듈을 활용해 새로운 스마트 계정을 정의하고, 제한된 권한만 지닌 에이전트용 세션 키(Actor)를 등록하여 0x79 타입 트랜잭션으로 원자적 실행을 처리하는 실전 구현 패턴입니다.",{"_2571":14643},{"_1892":14644,"_1893":14645,"_1802":14304},"Base Cobalt — Native Account Abstraction Without Bundlers","Base Cobalt — バンドラー不要のネイティブ・アカウント抽象化","74d1ad09-eda4-4cf5-9cf8-3d3adec7da59",{"_14648":14649,"_14650":14651,"_14652":14653},"item:60f350e9-cd37-4a87-844d-23d1e0361469",{"_1892":14595,"_1893":14595,"_1802":14595},"item:baab29e9-7da6-47a6-80d7-44b0f06bd470",{"_1892":14579,"_1893":14579,"_1802":14579},"item:f43d815a-41e1-4bfe-bf00-e4c9534774d9",{"_1892":14587,"_1893":14587,"_1802":14587},{"_2571":14655},{"_1892":3603,"_1893":3604,"_1802":3483},{"_2571":14657},{"_1892":14658,"_1893":14659,"_1802":14358},"(Based on viem v2.x experimental/eip8130 API)","（viem v2.x experimental/eip8130 API準拠）",{"_2571":14661},{"_1892":14662,"_1893":14663,"_1802":14498},"Conversely, if you are designing a payment service that requires integration with domestic financial systems, verified identity, and privacy, GIWA Chain is an excellent alternative. GIWA Chain offers up to $100,000 in developer grants through its accelerated builder support program and provides an integrated address identification service called UP.ID based on Soulbound Tokens, with a built-in identity layer necessary for local regulatory compliance and collaboration with financial institutions.","一方、国内の金融システムとの連携、確実な本人確認、そしてプライバシーが必要な決済サービスを設計するなら、GIWA Chainが優れた代替案となります。GIWA Chainは「アクセラレーテッド・ビルダー支援プログラム」を通じて最大10万ドル相当の開発者助成金を提供しており、ソウルバウンドトークンベースのアドレス識別サービスであるUP.IDを統合提供しています。これにより、ローカルの規制環境と金融機関との協業に必要なIDレイヤーを基本搭載しています。",{"_2571":14665},{"_1892":14666,"_1893":14667,"_1802":14468},"This is combined with 'Bojagi,' a financial privacy layer that incorporates Zero-Knowledge Proof (ZKP) technology. While maintaining the transparency of the blockchain, Bojagi provides the transaction confidentiality required for large-scale B2B transactions or financial institution transfers in real-time. It is already performing stable technology verification for deposit token transfers and payments with commercial banks, expanding its potential as an L2 specialized for the regulated sector.","さらに、ゼロ知識証明（ZKP）技術を加えた金融プライバシーレイヤー「Bojagi（包み）」が統合されます。Bojagiはブロックチェーンの透明性を維持しつつも、企業間の大規模な取引や金融機関の送金時に必要な取引の機密性をリアルタイムで確保します。すでに市中の銀行との預金トークン送金および決済技術の検証を安定的に遂行しており、制度圏特化型L2としての可能性を広げています。",{"_2571":14669},{"_1892":14670,"_1893":14671,"_1802":14672},"The greatest weapon in this architecture is the complete omission of off-chain bundlers or complex entry point contract calls within the EVM. When a node receives the new 0x79 transaction type, it completes O(1) complexity signature verification deterministically at the execution engine level without VM simulation. As a result, the verification overhead of a smart wallet drops significantly to 21,000 gas, which is on par with standard EOAs.","このアーキテクチャの最大の武器は、オフチェーンのバンドラーやEVM内部での複雑なエントリーポイント契約の呼び出しを全面的に省略できる点です。ノードが新しい0x79トランザクションタイプを受信すると、仮想マシンのシミュレーションなしで実行エンジン側で決定論的なO(1)複雑度の署名検証を直接完了します。これにより、スマートウォレットの検証オーバーヘッドが、従来のEOAと完全に同等の21,000ガスまで激減します。","이 아키텍처의 가장 큰 무기는 오프체인 번들러나 EVM 내부의 복잡한 엔트리포인트 계약 호출이 전면 생략된다는 점입니다. 노드가 새로운 0x79 트랜잭션 타입을 수신하면, 가상머신 시뮬레이션 없이 실행 엔진 단에서 결정론적인 O(1) 복잡도의 서명 검증을 직접 완료합니다. 이 덕분에 스마트 지갑의 검증 오버헤드가 기존 EOA와 완전히 대등한 수준인 21,000 가스로 급감합니다.",{"_2571":14674},{"_1892":14675,"_1893":14676,"_1802":14458},"Developers can use this on-chain schema information to control interactions so that only verified users are permitted at the smart contract level, eliminating the need to build a complex off-chain real-name authentication infrastructure from scratch.","開発者はこのオンチェーン・スキーマ情報を利用することで、複雑なオフチェーン実名認証インフラを直接構築することなく、スマートコントラクトレベルで認証済みのユーザーのみをフィルタリングしてやり取りを制御できます。",{"_2571":14678},{"_1892":14679,"_1893":14680,"_1802":14403},"From a developer's perspective, the most powerful tool is the on-chain implementation of 'Dojang,' an on-chain identity verification service. Dojang is built on the Ethereum Attestation Service (EAS) protocol, allowing users to prove that their wallet address has completed Know Your Customer (KYC) verification without exposing personal information. The core addresses and configuration values for Dojang deployed on the GIWA Sepolia testnet are as follows.","開発者にとっての最強の武器は、オンチェーン本人確認サービスである「Dojang（印鑑）」の実装です。DojangはEthereum Attestation Service（EAS）プロトコルに基づいて設計されており、個人情報を露呈させることなく、ウォレットアドレスの本人確認（KYC）完了の事実のみを証明します。GIWA SepoliaテストネットにデプロイされたDojangのコアアドレスおよび設定値は以下の通りです。",{"_2571":14682},{"_1892":14683,"_1893":14684,"_1802":14528},"The EIP-8130 and EIP-8140 features of Base Cobalt can be verified in advance on the VibeNet testnet. However, the load and security of a native verification structure without an off-chain bundler when processing large-scale transactions in a real mainnet environment will require further validation after the official launch, scheduled for September 2026.","Base CobaltのEIP-8130およびEIP-8140機能は、現在VibeNetテストネットで事前に検証可能です。ただし、オフチェーンバンドラーがないネイティブ検証構造が、実際のメインネット環境で大規模なトランザクションを処理する際にノードにかける負荷やセキュリティについては、2026年9月に予定されている正式リリース後、さらなる検証を経る必要があります。",{"_2571":14686},{"_1892":14687,"_1893":14688,"_1802":14488},"The choice of architecture depends entirely on the core requirements of the service you intend to build. If you are building a high-performance AI agent or a high-speed smart account service targeting the global market, look forward to the Base Cobalt upgrade. It significantly lowers build difficulty and gas overhead because it allows transactions to be sent directly to the standard mempool without needing to operate a complex off-chain bundler infrastructure.","開発したいサービスの核心的な要件によって、アーキテクチャの選択は全く異なります。グローバル市場をターゲットに高性能なAIエージェントや超高速なスマートアカウントサービスを構築するなら、Base Cobaltのアップグレードが期待できます。複雑なバンドラー・オフチェーンインフラを直接運用する必要がなく、標準メンプールへトランザクションを直接送信できるため、ビルドの難易度とガスオーバーヘッドが劇的に低下します。",{"_2571":14690},{"_1892":14691,"_1893":14692,"_1802":14538},"In the case of GIWA Chain, you can immediately test the Dojang and EAS integration contracts on the GIWA Sepolia testnet using chain ID 91342. Builders should closely monitor the private mainnet operational progress targeted for Q3 2026, as well as the schedule for open-sourcing the zero-knowledge verification contracts of Bojagi, GIWA's privacy engine.","GIWA Chainの場合、チェーンID 91342を使用するGIWA Sepoliaテストネットで、DojangおよびEAS統合コントラクトを即時テスト可能な状態です。ビルダーは、2026年第3四半期を目標とするプライベートメインネットの運用推移と共に、GIWAのプライバシーエンジン「Bojagi」のゼロ知識検証コントラクトのオープンソース化日程を密接に注視する必要があります。",{"_14617":14694,"_14622":14696,"_14627":14697,"_14632":14701},{"_1892":14619,"_1893":14695,"_1802":14621},"スキーマレジストリ（Schema Registry）: 0x4200000000000000000000000000000000000020",{"_1892":14624,"_1893":14625,"_1802":14626},{"_1892":14698,"_1893":14699,"_1802":14700},"Upbit Official Attester: 0x09B170CA2A006081042992bCE7379B85a02149C6","Upbit公認アテスター（Attester）: 0x09B170CA2A006081042992bCE7379B85a02149C6","업비트 공인 인증자(Attester): 0x09B170CA2A006081042992bCE7379B85a02149C6",{"_1892":14702,"_1893":14635,"_1802":14636},"Attestation Address Schema UID: 0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08",{"_2571":14704},{"_1892":14705,"_1893":14706,"_1802":14508},"Practical Checklist for 2026 L2 Builders","2026年、L2ビルダーのための実戦チェックリスト",{"_2571":14708},{"_1892":14709,"_1893":14710,"_1802":14314},"The Base Cobalt upgrade removes the existing ERC-4337 middleware layer entirely and integrates account abstraction directly into Reth V2, the execution client. The key lies in the native combination of EIP-8130, which handles account configuration at the execution layer, and EIP-8140, which guarantees token gas fee payments.","Base Cobaltのアップグレードは、既存のERC-4337のミドルウェア層を完全に排除し、実行クライアントであるReth V2内部に直接アカウント抽象化を統合します。核心となるのは、実行レイヤーレベルでアカウント設定を処理するEIP-8130と、トークンによるガス代支払いを保証するEIP-8140のネイティブ結合です。",{"_2571":14712},{"_1892":14713,"_1893":14714,"_1802":14373},"Using this approach, developers no longer need to operate complex, high-maintenance bundler infrastructure or perform heavy binary search simulations to calculate gas limits. Because the verification path is securely standardized at the consensus layer, it fundamentally controls threats like denial-of-service (DoS) attacks on the mempool.","この手法を活用すれば、開発者はもはや複雑で維持費のかかるバンドラーインフラを運用したり、ガス代の上限を計算するために重い二分探索シミュレーションを行う必要はありません。合意形成レイヤーレベルで検証経路が安全に規格化されているため、メンプールのDoS攻撃のリスクまで根本から制御できるからです。",{"_2571":14716},{"_1892":14717,"_1893":14718,"_1802":14383},"GIWA Chain — Identity and Privacy Engines for the Korean Market","GIWA Chain — 韓国市場をターゲットにした本人確認とプライバシーエンジン",{"_2571":14720},{"_1892":14721,"_1893":14722,"_1802":14548},"Ultimately, the choice of Layer 2 in 2026 comes down to what unique primitives you can offer your application, rather than a simple speed competition. If you are building global-scale smart accounts and AI agents, Base Cobalt will be your answer; if your objective is strong domestic regulatory compliance and privacy-preserving financial solutions, GIWA Chain will be the clear choice.","結局、2026年のレイヤー2選択は、単なる速度競争ではなく、アプリケーションにどのような独自のプリミティブを提供できるかどうかにかかっています。グローバル規模のスマートアカウントとAIエージェントをビルドするならBase Cobaltが、強力な国内コンプライアンスとプライバシー金融ソリューションが目的であればGIWA Chainが、明確な答えとなるでしょう。",{"_14648":14724,"_14650":14725,"_14652":14727},{"_1892":14595,"_1893":14595,"_1802":14595},{"_1892":14579,"_1893":14726,"_1802":14579},"L2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (2026年中期)",{"_1892":14587,"_1893":14587,"_1802":14587},{"_2571":14729},{"_1892":14730,"_1893":14731,"_1802":14518},"When choosing new L2 infrastructure, do not mistake the temporary performance of a testnet for the security and maturity of a mainnet. You must coldly compare the technical milestones of these two chains, both scheduled for mainnet deployment in the second half of 2026, and decide on an architecture that aligns with your project's goals.","新しいL2インフラを選択する際、テストネットの一時的な性能をメインネットのセキュリティや成熟度と勘違いしてはいけません。2026年後半のメインネット配備を控えた両チェーンの技術マイルストーンを冷静に比較し、プロジェクトの志向に合わせてアーキテクチャを決定する必要があります。","![Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까](file:cmrur77qf00vz10mu2p6etcxi)\n\n# Base Cobalt vs GIWA Chain — 2026년 L2 개발자는 어디로 가야 할까\n\n2026년 이더리움 레이어 2(L2) 생태계의 화두는 단순한 가스비 절감이나 처리 속도 경쟁이 아닙니다. 이제 L2들은 노드 클라이언트와 가상머신 수준에서 빌더를 위한 전용 프리미티브를 내장하는 아키텍처 경쟁에 돌입했습니다. 클라이언트 레벨에서 계정 추상화(AA)를 네이티브로 통합하여 글로벌 서비스와 AI 에이전트 커머스를 정조준하는 '베이스 코발트(Base Cobalt)', 그리고 국내 강력한 규제 준수 환경에 맞춰 신원인증과 프라이버시 엔진을 내장한 두나무의 '기와 체인(GIWA Chain)'이 그 중심에 있습니다. 이번 글에서는 빌더의 눈높이에서 두 체인의 상이한 기술적 지향점을 비교하고, 실제 개발 과정에서 어떤 인프라를 선택해야 할지 명확한 기준을 짚어보겠습니다.\n\n## Base Cobalt — 번들러 없는 네이티브 계정 추상화\n\n베이스 코발트(Base Cobalt) 업그레이드는 기존 ERC-4337의 미들웨어 계층을 완전히 제거하고, 실행 클라이언트인 Reth V2 내부에 직접 계정 추상화를 통합합니다. 핵심은 실행 레이어 수준에서 계정 설정을 처리하는 EIP-8130과 토큰 가스 수수료 지불을 보장하는 EIP-8140의 네이티브 결합입니다.\n\n이 아키텍처의 가장 큰 무기는 오프체인 번들러나 EVM 내부의 복잡한 엔트리포인트 계약 호출이 전면 생략된다는 점입니다. 노드가 새로운 `0x79` 트랜잭션 타입을 수신하면, 가상머신 시뮬레이션 없이 실행 엔진 단에서 결정론적인 O(1) 복잡도의 서명 검증을 직접 완료합니다. 이 덕분에 스마트 지갑의 검증 오버헤드가 기존 EOA와 완전히 대등한 수준인 21,000 가스로 급감합니다.\n\n이러한 비용 및 속도 혁신은 밀리초 단위로 수백 개의 자동화 결제를 실행해야 하는 AI 에이전트 커머스 환경에 압도적인 돌파구를 제시합니다. 아래 예시는 `viem` 라이브러리의 실험적 모듈을 활용해 새로운 스마트 계정을 정의하고, 제한된 권한만 지닌 에이전트용 세션 키(Actor)를 등록하여 `0x79` 타입 트랜잭션으로 원자적 실행을 처리하는 실전 구현 패턴입니다.\n\n*(viem v2.x experimental/eip8130 API 기준)*\n\n```typescript\nimport { key, newSmartAccount8130, authorizeActor, actorScope, sendCalls8130 } from \"viem/experimental/eip8130\";\n\n// 1) EIP-8130 스마트 계정 및 에이전트용 세션 키(P-256) 정의\nconst account = newSmartAccount8130({ signer: key.k1(\"0xOwnerKey...\") });\nconst agentSigner = key.p256({ x: \"0x...\", y: \"0x...\" });\n\n// 2) 트랜잭션 전송 권한(sender) 및 유효 기한을 가진 Actor 변경 내역 생성\nconst authorizeChange = authorizeActor(agentSigner, {\n scope: actorScope.sender,\n expiry: 1900000000n\n});\n\n// 3) 0x79 트랜잭션으로 스마트 계정 배포와 Actor 변경 내역을 단일 배치로 원자적 전송\nconst hash = await sendCalls8130(client, {\n account,\n accountChanges: [account.createChange, authorizeChange],\n calls: [{ to: \"0xRecipient...\", value: parseEther(\"0.001\") }]\n});\n```\n\n이 방식을 활용하면 개발자는 더 이상 복잡하고 유지비가 큰 번들러 인프라를 운영하거나 가스비 한도를 계산하기 위해 무거운 바이너리 서치 시뮬레이션을 수행할 필요가 없습니다. 합의 레이어 수준에서 검증 경로가 안전하게 규격화되어 멤풀의 서비스 거부 공격 위협까지 근본적으로 제어하기 때문입니다.\n\n## GIWA Chain — 한국 시장을 겨냥한 신원과 프라이버시 엔진\n\n두나무가 옵티미즘 재단과 협력하여 선보인 기와 체인(GIWA Chain)은 옵티미즘 엔터프라이즈의 자체 관리(Self-Managed) 티어를 채택한 오픈 L2 체인입니다. 글로벌 표준 기술인 OP 스택을 사용하면서도, 국내 환경에 특화된 신원 인증 및 규제 준수 레이어를 세로형 통합(Vertical Integration) 형태로 내장한 아키텍처가 특징입니다. 1초의 블록 타임을 구현하며 가스비는 약 1원 수준을 목표로 설계되었습니다.\n\n개발자 입장에서 가장 강력한 무기는 온체인 신원 인증 서비스인 '도장(Dojang)'의 실제 온체인 구현체입니다. 도장은 이더리움 증명 서비스(EAS) 프로토콜을 기반으로 설계되어, 개인정보 노출 없이 지갑 주소의 본인인증(KYC) 완료 여부만을 증명합니다. 기와 세폴리아(GIWA Sepolia) 테스트넷에 배포된 도장 핵심 주소 및 설정값은 다음과 같습니다.\n\n- **EAS 메인 컨트랙트:** `0x4200000000000000000000000000000000000021`\n- **스키마 레지스트리(Schema Registry):** `0x4200000000000000000000000000000000000020`\n- **업비트 공인 인증자(Attester):** `0x09B170CA2A006081042992bCE7379B85a02149C6`\n- **인증 주소 스키마 UID:** `0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08`\n\n개발자는 이 온체인 스키마 정보를 활용해 복잡한 오프체인 실명인증 인프라를 직접 구축할 필요 없이, 스마트 컨트랙트 수준에서 인증된 사용자만 필터링하여 상호작용하도록 제어할 수 있습니다.\n\n여기에 영지식 증명(ZKP) 기술을 가미한 금융 프라이버시 레이어 '보자기(Bojagi)'가 결합합니다. 보자기는 블록체인의 투명성을 유지하면서도 기업 간 대형 거래나 금융 기관 송금 시 필요한 거래 기밀성을 실시간으로 확보해 줍니다. 이미 시중 은행과의 예금 토큰 송금 및 결제 기술 검증을 안정적으로 수행하며 제도권 특화 L2로서의 가능성을 넓혀가고 있습니다.\n\n## 어디서 개발해야 할까 — 아키텍처와 생태계 비교\n\n개발하려는 서비스의 핵심 요구사항에 따라 아키텍처 선택은 완전히 달라집니다. 글로벌 시장을 타깃으로 고성능 AI 에이전트나 초고속 스마트 어카운트 서비스를 구축한다면 베이스 코발트 업그레이드를 기대해볼 수 있습니다. 복잡한 번들러 오프체인 인프라를 직접 운영할 필요 없이 표준 멤풀로 트랜잭션을 바로 전송하므로 빌드 난이도와 가스 오버헤드가 획기적으로 낮아집니다.\n\n반면 국내 금융 시스템과의 연동, 확실한 신원인증, 프라이버시가 필요한 결제 서비스를 설계한다면 기와 체인이 우수한 대안이 됩니다. 기와 체인은 가속 빌더 지원 프로그램을 통해 최대 10만 달러 상당의 개발자 그랜트를 지원하며, 소울바운드 토큰 기반의 주소 식별 서비스인 UP.ID를 통합 제공하여 로컬 규제 환경과 금융권 협업에 필요한 신원 레이어를 기본 탑재하고 있습니다.\n\n## 2026년 L2 빌더를 위한 실전 체크리스트\n\n새로운 L2 인프라를 선택할 때 테스트넷의 일시적인 성능을 메인넷의 보안성과 성숙도로 오인해서는 안 됩니다. 2026년 하반기 메인넷 배포를 앞둔 두 체인의 기술 마일스톤을 냉정하게 비교하고 프로젝트의 지향점에 맞추어 아키텍처를 결정해야 합니다.\n\n베이스 코발트의 EIP-8130 및 EIP-8140 기능은 현재 바이브넷 테스트넷에서 미리 검증해 볼 수 있습니다. 다만 오프체인 번들러가 없는 네이티브 검증 구조가 실제 메인넷 환경에서 대규모 트랜잭션을 처리할 때 노드에 가하는 부하와 보안성은 2026년 9월로 예정된 정식 출시 이후 한 단계 더 검증을 거쳐야 합니다.\n\n기와 체인의 경우 체인 ID 91342를 사용하는 기와 세폴리아 테스트넷에서 도장과 EAS 통합 컨트랙트를 즉시 테스트할 수 있는 상태입니다. 빌더들은 2026년 3분기 목표인 프라이빗 메인넷 운영 추이와 함께, 기와의 프라이버시 엔진인 보자기의 영지식 검증 컨트랙트 오픈소스화 일정을 긴밀히 주시해야 합니다.\n\n결국 2026년의 레이어 2 선택은 단순한 속도 경쟁이 아닌 애플리케이션에 어떠한 고유 프리미티브를 제공할 수 있느냐에 달렸습니다. 글로벌 스케일의 스마트 어카운트와 AI 에이전트를 빌드한다면 베이스 코발트가, 강력한 국내 규제 준수와 프라이버시 금융 솔루션이 목적이라면 기와 체인이 명확한 해답이 될 것입니다.\n\n---\n\n**참고 링크**\n\n- [L2BEAT & Developer Ecosystem Analysis — Ethereum L2 Market Metrics and Structural Trade-offs (Mid-2026)](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQFBs6McoFkMbAk7WPfFCZr0VD4E9P4B9js516U3DRUuXmiiYak1pp1Eqk9B7GBbhpMAa361gOwZXdMkNWcknwk54IFiOJRsgodMba-sFDS1cX7ksrP4kdps)\n- [Optimism Foundation & Dunamu — Dunamu's GIWA Chain Launches Testnet and Partners on OP Enterprise Self-Managed Tier](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQEizrlfPz-dhIzRPn3L9cOIO8q1FHkT2z1NnfRPBkVrmDahXRYdJm9IyAoi7fgsVeC7h_Xi1Flgqx67hs3ZOpTiU40mKQh8AhkQW5iwXcztHZ9q5NaNCOvCSvV9ceSCO5XTiXzGqo4T4xWl6tal0xxAtY-U18V3pKcM9zl3fZTJbuJU5iydg45VoC6r1VjCBq2lLEzlzYSqbJ5zYyfrQnzR0uqvQP9K_ShOvId47GuS3uKhP_k=)\n- [Optimism Foundation & Dunamu — Upbit Operator Dunamu and Optimism Partner on GIWA Chain](https://vertexaisearch.cloud.google.com/grounding-api-redirect/AUZIYQELu62mSOBoeDBCMZHAXoFXovUNnUSgIhsUwwlmuSWJJwLKW2Qrs-cPvmUC-6j7tJsQVxOVzqHKaTWMZp1UXm8xDFZKTSm0sptTV3_UUkkbHmGlEqznQCkUW93hUyygZDqMzr8pon__tolDBRYfYv3a_WNup-0W0wtNbLOX-2HscubRUy_nApAiawdaRwxj7qGyegpNNTcVdSDU7Jy_JYqn8op70APyvLpNy0_sys6UWLoSYgI=)","94692f78d0b280d378659b6dc227f49df290223e02eaa1c7dc32981b16c7d967","2026-07-21T14:06:17.636Z","2026-07-22T23:20:29.495Z",[],[14738],{"_2802":2803,"_1881":7262},{"_950":14740,"_2416":3098,"_2418":3098,"_2419":2080,"_2420":2421,"_1883":2422,"_2423":2424,"_1200":1204,"_1801":2425,"_2426":14741,"_1889":14749,"_2455":-5,"_2456":-5,"_2457":-5,"_9":14753,"_2450":14761,"_2458":14762,"_2460":-5,"_723":14763,"_1886":14764,"_332":14770,"_2473":1997,"_2474":1997,"_2475":1997,"_2476":2007,"_2477":14771,"_2003":14772,"_2480":14773,"_2482":-5,"_2483":14774,"_2485":-5,"_2486":-5,"_2487":14775,"_1144":14785,"_2527":14798,"_2555":-5,"_2556":14819,"_2798":15221,"_266":15222},"cmrupxmpu00tm10muoyotpkch",{"_1801":1802,"_214":14742,"_2429":14743,"_2434":14746,"_2438":2439},4699,{"_1892":14744,"_1893":1997,"_1802":14745,"_2433":1997},2184,2515,{"_1892":14747,"_1893":1997,"_1802":14748,"_2433":1997},0.46477974037029157,0.5352202596297084,{"_9":14750,"_2445":14754,"_2450":14758},{"_1892":14751,"_1893":14752,"_1802":14753},"NestJS AI Agents — State Persistence with Mastra and LangGraph","NestJS AIエージェント — MastraとLangGraphで実装する状態永続化","NestJS AI 에이전트 — Mastra와 LangGraph로 구현하는 상태 영속화",{"_1892":14755,"_1893":14756,"_1802":14757},"NestJS AI 에이전트 — Mastra와 LangGraph로 구현하는 상태 영속화\n\nNestJS AI Agents — State Persistence with Mastra and LangGraph\n\nAs AI agents move beyond simple one-off sessions and are integrated into production environments, state management for reliably maintaining interaction context has become a critical challenge. To robustly handle complex business logic and long-running Large Language Model (LLM) calls, integration with a reliable backend framework is essential. We will explore how to design a resilient, fault-tolerant AI agent state persistence architecture by combining NestJS with Mastra, LangGraph, and Inngest.\n\nStandardizing State Persistence: Mastra and LangGraph\n\nProduction AI agent architectures are evolving from in-memory management to standardized, database-backed persistence adapters. Losing an agent's conversational context or execution state compromises the integrity of business transactions. Especially as agent autonomous loops become longer, a highly reliable persistence layer—where state is granularly partitioned and safely isolated on disk—has become fundamental infrastructure.\n\nIn this context, two leading frameworks, LangGraph and Mastra, implement database persistence in different ways. LangGraph provides a \"checkpointer\" interface that allows for precise state snapshots to be recorded immediately after the execution of each node in complex directed graphs, with official support for PostgresSaver for PostgreSQL backends. Conversely, Mastra adopts a data architecture that breaks down state scopes into categories like memory, workflows, and threads, mapping them directly to modular PostgreSQL storage adapters.\n\nIn a NestJS architecture, rather than declaring these components individually, it is more efficient to integrate them into a dynamic module that manages a singleton database connection pool. The following code demonstrates a dynamic module implementation that securely creates and initializes the PostgresSaver from the @langchain/langgraph-checkpoint-postgres package within the NestJS dependency injection ecosystem.\n\nimport { DynamicModule, Module, Global, OnModuleDestroy } from '@nestjs/common';\nimport { PostgresSaver } from '@langchain/langgraph-checkpoint-postgres';\nimport { Pool } from 'pg';\n\n@Global()\n@Module({})\nexport class AgentPersistenceModule implements OnModuleDestroy {\n private static pool: Pool;\n\n static register(connectionString: string): DynamicModule {\n const poolProvider = {\n provide: 'PG_POOL',\n useFactory: () => {\n if (!this.pool) {\n this.pool = new Pool({\n connectionString,\n

Samsung Wallet 스테이블코인 — 진짜 언제 쓸 수 있을까

해시드·솔라나 정책연구소 — 스테이블코인 '임시 라이선스' 제안한 이유

Fastify 5.10 실전 가이드 — TypeBox 검증과 플러그인 캡슐화

SOL 상대적 강세 — 단순 반등일까 구조적 차별화일까

Fastify v5와 MCP v2.0 — 무상태 AI 백엔드 보안 구현하기