1. Testnet Data Availability Scope
Nodit Web3 Data API의 Testnet 환경에서는 현재 최근 90일(3개월) 이내의 데이터만 제공됩니다. 이 정책은 Mainnet이 함께 지원되는 체인의 Testnet에 적용되며, Testnet-only 체인에는 적용되지 않습니다.
조회 시점이나 범위를 지정하지 않고 현재 상태만을 반환하는 데이터는 제공 기간의 제한을 받지 않습니다. 예를 들어 주소 또는 계정의 현재 상태, 토큰 홀더 정보, 컨트랙트 메타데이터와 같은 데이터는 특정 블록이나 과거 시점을 기준으로 조회되지 않으므로 Testnet 환경에서도 기간 제한 없이 제공됩니다.
누적 집계 형태의 데이터는 전체 기간을 기준으로 계산되지 않으며, 현재 제공 가능한 기간인 최근 90일 이내의 데이터만을 기준으로 계산된 결과가 제공됩니다.
Affected Testnet Networks
아래 Testnet 네트워크는 본 Testnet 데이터 제공 정책의 적용 대상입니다.
| Chain | Testnet | Retention Policy |
|---|---|---|
| Arbitrum | Sepolia | 90 days |
| Base | Sepolia | 90 days |
| Ethereum | Sepolia, Hoodi | 90 days |
| Kaia | Kairos | 90 days |
| Optimism | Sepolia | 90 days |
| Polygon | Amoy | 90 days |
다음 Testnet 네트워크는 Mainnet이 제공되지 않는 Testnet-only 체인으로 분류되며, 본 정책의 적용 대상이 아닙니다.
| Chain | Testnet | Retention Policy |
|---|---|---|
| GIWA | Sepolia | No Limit |
2. How the Policy Affects API Responses
2.1 Range-based Queries
Block/Ledger 또는 Date 범위를 지정하여 데이터를 조회하는 경우, 요청 범위에 현재 제공 범위를 벗어난 구간이 포함되더라도 요청은 오류로 처리되지 않습니다. 이 경우 API는 요청된 범위 전체를 평가한 뒤, 그중 Testnet에서 현재 제공 가능한 기간에 해당하는 데이터만을 선별하여 응답에 포함합니다. 제공 범위를 벗어난 구간에 대해서는 데이터가 반환되지 않으며, 해당 구간이 포함되었다는 이유만으로 오류가 발생하지는 않습니다.
2.2 Multi-item Queries
여러 리소스를 한 번에 조회하는 다건 조회 API의 경우, 요청에 포함된 각 항목은 개별적으로 제공 가능 여부가 판단됩니다. 요청한 항목 중 Testnet에서 현재 제공 가능한 기간에 해당하는 항목만 응답 결과에 포함되며, 제공 범위를 벗어난 항목은 오류를 발생시키지 않고 결과에서 제외됩니다.
2.3 Single-item Queries
단일 리소스를 명시적으로 지정하여 조회하는 API의 경우, 요청 대상이 Testnet에서 현재 제공 범위를 벗어난 데이터라면 API는 해당 리소스를 제공할 수 없으며 404 Not Found 에러를 반환합니다. 이는 요청 형식이 잘못되었음을 의미하지 않으며, Testnet 환경에서 해당 리소스가 현재 제공되지 않는다는 정책적 제한을 나타냅니다.
{
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found: { RESOURCE_NAME = RESOURCE_VALUE }. Testnet only retains data from the past 3 months. To access older data, please use a Node API."
}2.4 Aggregated or Accumulated Data
누적 집계 또는 통계 형태의 데이터를 반환하는 API의 경우, 응답에 포함되는 값은 전체 기간에 대한 누적 결과가 아니라 Testnet에서 현재 제공 가능한 기간인 최근 90일 이내의 데이터만을 기준으로 계산됩니다. 이로 인해 동일한 요청이라도 Mainnet 환경과 비교했을 때 다른 값이 반환될 수 있으며, 이는 데이터 제공 범위의 차이에 따른 정상적인 결과입니다.