테스트넷에서 운영 중이 사이트는 어떤 자산의 입금도 요구하지 않습니다
온체인웨더

데이터·API

검증 가능한 한국 날씨 데이터

컨트랙트 주소, 인증 스키마, 조회 예제를 공개합니다. 체인에는 요약값(머클 루트)과 판정 결과만 있고, 원문은 이 사이트의 API 로 내려받아 대조합니다.

네트워크

네트워크
GIWA Sepolia
체인 ID
91342
RPC
https://sepolia-rpc.giwa.io
발행자 주소

GIWA 는 OP Stack 기반 이더리움 레이어2 입니다. 공개 네트워크는 테스트넷(GIWA Sepolia, 체인 ID 91342)이며 메인넷은 아직 출시되지 않았습니다.

컨트랙트

컨트랙트역할주소
StationRegistry관측 지점 등록 (지점 ID, 좌표, 장비 정보 해시, 운영 상태)0xD19bc61475906e9160b3f900aD6c8006c5faF333
WeatherAnchor스냅샷별 Weather Root, 실행 ID, 시각 기록. 머클 증명 검증0x00e7352b9dC6763CCE432337781300DD75f69662
WeatherAttester도장(EAS) 인증 발급과 판정 결과 제공0xEe4f8fac9889D08D459d6ba3684A2B26Ca496d2A
ForecastCommitAI 예측의 사전 기록과 채점 결과0x21cf5D6FEAfFd17d2C5DE57F62989C8936BB7231
SnowPrediction참여 기록, 마감, 판정 도장 기반 결과 확정0x9cc298e886ac0e9c2f2E9fa83BE18699929AD9A9
LoveTemperature일 최저기온 도장 확인, 기부 약정 기록, 영수증 등록0xCFa78777Af4095b7aeC15831B23411A1C8aFEBA9
WeatherNFTNFT 4종 발행. 나눔 증표는 양도 불가0x110C520F3422b92E816107082c19806c5c8152EE

도장 인증 스키마

도장(Dojang)은 EAS 기반 인증 서비스입니다. 날씨 인증 네 가지는 같은 EAS 에 스키마를 등록해 발급하며, 케이웨더가 도장 공식 발행자로 등록되면 스키마를 그대로 둔 채 옮깁니다. Weather Root 는 도장의 Balance Root 와 같은 구조로, 전체 값을 머클 트리로 요약해 루트 하나만 인증합니다.

Weather Root
전국 관측값 묶음의 요약 인증
bytes32 runId,uint8 kind,uint64 observedAt,uint32 leafCount,bytes32 root,bytes32 contentHash
Schema UID
Verified Weather
특정 지점·기간의 판정 결과 인증
bytes32 determinationId,bytes32 stationId,uint64 windowStart,uint64 windowEnd,bytes32 metric,int32 value,uint8 outcome,bytes32 runId
Schema UID
Forecast Commit
AI 예측의 사전 기록 인증
bytes32 forecastId,uint64 targetTime,bytes32 inputRoot,bytes32 modelHash,bytes32 forecastHash
Schema UID
Donation Receipt
기부 집행 확인
bytes32 periodId,uint256 amountKrw,bytes32 receiptHash
Schema UID

참여자 확인에는 도장의 기존 Verified Address 를 그대로 씁니다 (발행자: 업비트). DojangScroll

조회 예제 (viem)

import { createPublicClient, http, keccak256, toHex } from "viem";
import { giwaSepolia } from "viem/chains";

const client = createPublicClient({ chain: giwaSepolia, transport: http("https://sepolia-rpc.giwa.io") });
const anchor = "0x00e7352b9dC6763CCE432337781300DD75f69662";
const abi = [
  { type: "function", name: "latestByKind", stateMutability: "view", inputs: [{ type: "uint8" }], outputs: [{ type: "bytes32" }] },
  { type: "function", name: "verifyValue", stateMutability: "view",
    inputs: [{ type: "bytes32" }, { type: "bytes32" }, { type: "bytes32" }, { type: "int256" }, { type: "bytes32[]" }],
    outputs: [{ type: "bool" }] },
];

// 1) 최신 실황 스냅샷의 실행 ID
const runId = await client.readContract({ address: anchor, abi, functionName: "latestByKind", args: [1] });

// 2) 서울의 값과 머클 증명을 받아 온체인에서 확인
const obs = await fetch("https://onchainweather.io/api/stations/seoul/observations").then((r) => r.json());
const temp = obs.values.find((v) => v.metric === "temp_c_x100");
const ok = await client.readContract({
  address: anchor, abi, functionName: "verifyValue",
  args: [runId, obs.station.id, temp.metricId, BigInt(temp.value), temp.proof],
});
console.log(Number(temp.value) / 100, "°C", ok); // true

컨트랙트에서 판정 읽기

interface IWeatherAttester {
    struct Determination {
        uint8 outcome;      // 1 충족, 2 미충족, 3 보류
        int32 value;
        bytes32 stationId;
        uint64 windowStart;
        uint64 windowEnd;
        bytes32 metric;
        bytes32 runId;
        bytes32 uid;        // 도장 번호
        uint64 issuedAt;
    }
    function getDetermination(bytes32 id) external view returns (Determination memory);
}

// 판정 도장을 조건으로 쓰는 예
IWeatherAttester.Determination memory d = attester.getDetermination(determinationId);
require(d.outcome != 0, "no determination yet");
if (d.outcome == 1) { /* 조건 충족 시 처리 */ }

공개 API

경로내용상태
GET /api/snapshots최근 스냅샷 목록 (해시, 트랜잭션, 도장 번호)제공 중
GET /api/snapshots/{runKey}스냅샷 원문과 발행자 서명제공 중
GET /api/stations/{id}/observations지점별 관측값과 머클 증명 (?run= 으로 시각 지정)제공 중
GET /api/forecasts/{snow|tmin|key}예측값, 기록 시각, 채점 결과제공 중
GET /api/verify?run=해시 대조 결과제공 중
GET /api/nft/{tokenId}NFT 메타데이터제공 중
POST /determinations조건형 판정 요청 (지점, 항목, 임계값, 시각)2단계 예정

지금은 키 없이 조회할 수 있습니다. API 키 발급, 호출당 결제(AI 에이전트용 HTTP 402), 조건형 판정 요청은 2단계 이후에 엽니다.

스냅샷 원문 형식

  • •실행 ID, 관측 시각, 생성 시각, 산출 규칙 버전
  • •지점별 관측값과 품질 표시 (정상, 보정, 모델, 보류)
  • •사용한 소스 목록과 소스별 값
  • •합의지수와 제외된 이상치, 제외 사유
  • •머클 잎 목록과 루트
  • •발행자 주소와 서명

원문 해시는 snapshot 객체를 키 정렬 JSON 으로 만든 뒤 SHA-256 으로 계산합니다. 머클 잎은 keccak256(keccak256(abi.encode(stationId, observedAt, keccak256(metric), value))) 이고, 쌍을 정렬해 해시합니다(오픈제플린 MerkleProof 와 같은 규칙).