> For the complete documentation index, see [llms.txt](https://docs.giwa.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giwa.io/notices/giwa-chain/upgrade-19.md).

# Upgrade 19 Karst 하드포크

> 공지일자: 2026년 7월 2일
>
> 적용 네트워크: GIWA 테스트넷 (Sepolia)

## 개요

GIWA Chain은 OP Stack의 Karst 하드포크(Upgrade 19 프로토콜 업데이트)를 적용합니다. 이번 업그레이드는 L2 실행 환경 업데이트(Osaka EVM 기능), Fault Proof 시스템 개선, L2 컨트랙트 관리 구조(L2CM) 도입 등 네트워크 기능 확장과 보안 강화를 위한 변경이 포함되어 있어요.

{% hint style="warning" %}
이번 업그레이드는 하드포크이기 때문에 네트워크 프로토콜 수준의 변경이 포함되어 있어 노드 운영자는 반드시 최신 버전으로 업데이트해야 합니다.
{% endhint %}

{% hint style="info" %}
Karst 하드포크부터 실행 클라이언트는 op-reth, Fault Proof 프로그램은 kona-client만 지원됩니다. op-geth와 op-program은 Karst를 지원하지 않아요. 자세한 내용은 op-geth 지원 종료 및 op-reth 전환 공지를 참고해 주세요.
{% endhint %}

## 일정

* 테스트넷 (Sepolia): *2026년 7월 6일 오후 3시 00분 00초 KST (Unix timestamp: `1783317600`)*

{% hint style="info" %}
체인의 상태나 블록 타이밍에 따라 실제 적용 시점은 다소 변동될 수 있습니다.
{% endhint %}

## 주요 변경사항

* **Osaka EVM 적용**: L2 실행 환경에 이더리움 Osaka 기능이 도입돼요. 트랜잭션 가스 한도 상한 도입, 일부 precompile(`P256VERIFY`, `MODEXP`)의 가스 비용 조정, 신규 opcode 추가 등이 포함됩니다.
* **Fault Proof — 정식 게임 타입 변경**: Dispute Game의 정식(respected) 타입이 기존 `CANNON`에서 `CANNON_KONA`(타입 8)로 변경돼요. GIWA는 현재 permissioned 방식으로 Fault Proof를 운영하고 있어, 이 변경은 운영 레벨에서 반영되며 일반 사용자나 개발자가 직접 조치할 사항은 없어요.
* **BN256 페어링 입력 상한 축소**: `ecPairing`(`0x08`) precompile의 입력이 최대 300 pairs로 축소돼요(기존 427). 향후 Glamsterdam(EIP-7904)에 대비한 선제적 조정입니다.
* **L2CM(L2 Contract Manager) 도입**: 네트워크 업그레이드 시 L2 predeploy 컨트랙트를 업그레이드할 수 있는 메커니즘으로, 향후 interop을 위한 선결 조건이에요.
* **OPCMv2 적용**: 재설계된 OP Contracts Manager가 처음 적용됩니다.

## 개발자 영향

* **precompile 가스 비용 변경**: `P256VERIFY`, `MODEXP` 등 precompile의 가스 비용이 상향돼요. 이 값들을 하드코딩해 사용하는 컨트랙트나 앱이 있다면 점검이 필요합니다. 특히 secp256r1(P-256) 기반 서명 검증(모바일 보안칩 기반 AA 등)을 사용하는 경우 가스 상향(6,900 gas) 영향을 확인해 주세요.
* **트랜잭션 가스 한도**: 단일 트랜잭션의 가스 한도가 16,777,216으로 제한돼요. 이보다 큰 가스를 요구하는 트랜잭션은 실패할 수 있습니다. (Deposit 트랜잭션은 예외)
* **BN256 페어링**: `ecPairing`(`0x08`)을 300 pairs를 초과해 호출하는 앱은 실패할 수 있어요. 일반적인 Groth16 증명 검증에는 영향이 없습니다.

## 노드 운영자 영향

* 예정된 Karst 하드포크 시간 전에 반드시 노드를 최신 버전으로 업데이트해야 합니다.
* **op-geth는 Karst를 지원하지 않습니다.** 아직 op-reth로 전환하지 않았다면 하드포크 이전에 반드시 op-reth로 전환해 주세요. Fault Proof 프로그램도 op-program에서 kona-client로 전환됩니다.
* op-reth 기반 노드 구성과 최신 릴리즈는 [giwa-io/node](https://github.com/giwa-io/node/releases) 저장소를 참고해 주세요.

## 더 알아보기

Upgrade 19 (Karst)에 대해 더 알아보고 싶나요? [OP Stack 문서](https://docs.optimism.io/notices/upgrade-19)를 확인해보세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.giwa.io/notices/giwa-chain/upgrade-19.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.