> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablenet.network/llms.txt
> Use this file to discover all available pages before exploring further.

# 온체인 데이터 읽기

> 표준 JSON-RPC를 사용해 StableNet의 블록, 트랜잭션, 로그, 컨트랙트 상태를 조회하세요.

> StableNet은 이더리움 툴링과 호환되는 표준 JSON-RPC API를 제공합니다. ethers.js, viem 또는 직접 RPC 호출로 과거 로그를 조회하고 실시간 이벤트를 구독하며 컨트랙트 상태를 읽을 수 있습니다.

트랜잭션 전송은 [스테이블코인 전송](/ko/v0.3/build/use-cases/stablecoin-transfers)을 참고하세요. 전체 RPC 메서드 목록은 [RPC API 레퍼런스](/ko/v0.3/reference/rpc-api)를 참고하세요.

## 빠른 시작

<CardGroup cols={2}>
  <Card title="컨트랙트 이벤트 구독하기" icon="bell" href="/ko/v0.3/build/tutorials/listen-to-events">
    **Beginner**. ethers.js와 WebSocket으로 컨트랙트 이벤트를 구독하세요.
  </Card>

  <Card title="StableNet 연결하기" icon="plug" href="/ko/v0.3/build/quickstart/connect-to-stablenet">
    **Beginner**. RPC 프로바이더를 설정하세요.
  </Card>
</CardGroup>

## StableNet에서 온체인 데이터를 읽는 이유

<AccordionGroup>
  <Accordion title="표준 이더리움 JSON-RPC">
    StableNet은 표준 `eth_` 네임스페이스를 구현합니다 — `eth_getLogs`, `eth_getBlock`, `eth_call`, `eth_getTransactionReceipt` 등. 이더리움 JSON-RPC를 지원하는 모든 라이브러리와 툴이 수정 없이 작동합니다. 전체 메서드 목록은 [RPC API 레퍼런스](/ko/v0.3/reference/rpc-api)를 참고하세요.
  </Accordion>

  <Accordion title="WebSocket 구독">
    `eth_subscribe`를 통한 실시간 이벤트 구독을 WebSocket으로 지원합니다. `newHeads`, `logs`, `newPendingTransactions`를 구독할 수 있습니다. Bloom 필터 최적화로 넓은 블록 범위의 대용량 로그 조회 오버헤드를 줄입니다.
  </Accordion>

  <Accordion title="빠른 인덱싱을 위한 1초 블록">
    약 1초 블록 타임으로 인덱서나 이벤트 리스너가 거의 실시간으로 새 데이터를 받습니다. 확정 보장이 있어 재구성을 처리할 필요가 없으며 모든 확정 블록이 최종 상태입니다.
  </Accordion>

  <Accordion title="HTTP 클라이언트를 위한 폴링 방식">
    WebSocket을 지원하지 않는 환경에서는 폴링 기반 필터(`eth_newFilter`, `eth_getFilterChanges`)를 사용할 수 있습니다. 필터는 5분 비활성 후 자동으로 만료되어 리소스 누수를 방지합니다.
  </Accordion>
</AccordionGroup>