데이터·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 |
| ForecastCommit | AI 예측의 사전 기록과 채점 결과 | 0x21cf5D6FEAfFd17d2C5DE57F62989C8936BB7231 |
| SnowPrediction | 참여 기록, 마감, 판정 도장 기반 결과 확정 | 0x9cc298e886ac0e9c2f2E9fa83BE18699929AD9A9 |
| LoveTemperature | 일 최저기온 도장 확인, 기부 약정 기록, 영수증 등록 | 0xCFa78777Af4095b7aeC15831B23411A1C8aFEBA9 |
| WeatherNFT | NFT 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 와 같은 규칙).