Initial commit

Author: PaulRBerg

.env.example

@@ -0,0 +1,4 @@
+# APIs
+COINGECKO_API_KEY_1=""
+COINGECKO_API_KEY_2=""
+CURRENCY_FREAKS_API_KEY=""

.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: "CI"
+
+concurrency:
+  cancel-in-progress: true
+  group: ${{ github.ref }}
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v5
+
+      - name: Set up devkit
+        uses: sablier-labs/devkit/actions/setup@main
+        with:
+          package-manager: bun
+
+      - uses: cargo-bins/cargo-binstall@main
+      - run: cargo binstall --no-confirm qsv
+
+      - name: Run code checks
+        run: |
+          just full-check
+          just tsv-check
+
+      - name: Add summary
+        run: | #shell
+          echo "## CI result" >> $GITHUB_STEP_SUMMARY
+          echo "✅ Passed" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -0,0 +1,11 @@
+# Directories
+.serena
+node_modules
+
+# Files
+*.log
+*.tsbuildinfo
+.claude/settings.local.json
+.env
+.env.*
+!.env.example

.prettierrc.js

@@ -0,0 +1,9 @@
+const baseConfig = require("@sablier/devkit/prettier");
+
+/**
+ * @see https://prettier.io/docs/configuration
+ * @type {import("prettier").Config}
+ */
+const config = baseConfig;
+
+module.exports = config;

.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "biome.enabled": true,
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  },
+  "rainbow_csv.comment_prefix": "#",
+  "[css][javascript][javascriptreact][json][jsonc][graphql][typescript][typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[md][yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Common Changelog](https://common-changelog.org/), and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+[1.0.0-beta.0]: https://github.com/sablier-labs/price-data/releases/tag/v1.0.0-beta.0
+
+## [1.0.0-beta.0] - 2025-10-11
+
+### Added
+
+- Initial beta release with centralized price data repository
+- CLI tools for fetching cryptocurrency prices from CoinGecko
+- CLI tools for fetching forex rates from CurrencyFreaks
+- TSV data format with schema validation
+- Support for 10+ cryptocurrencies (ETH, BTC, USDC, USDT, DAI, WBTC, WETH, ARB, OP, STRK)
+- GBP/USD forex exchange rate data

CLAUDE.md

@@ -0,0 +1,30 @@
+# Sablier Price Data
+
+This document contains instructions for AI agents working on the Sablier Price Data repository.
+
+## Context
+
+This repo provides centralized cryptocurrency and forex exchange rate data used across Sablier projects. The data is
+stored in TSV format and sourced from [CoinGecko](https://coingecko.com/api) (crypto prices) and
+[CurrencyFreaks](https://currencyfreaks.com/) (forex rates).
+
+## Development
+
+**WORKFLOW**: After code changes → `just full-check` → `just full-write` (if errors) → fix remaining issues manually
+
+**COMMON COMMANDS**:
+
+- `just tsc-check` - TypeScript type checking only
+- `just tsv-check` - Validate TSV files against schema
+- `ni <package>` - Install dependency (`ni -D` for dev dependency)
+- `just fetch-crypto <currency>` - Fetch crypto prices from CoinGecko
+- `just fetch-forex` - Fetch GBP/USD rates from CurrencyFreaks
+
+## TSV Format
+
+**REQUIREMENT**: All data files use tab-separated values (TSV) format.
+
+- **Date format**: ISO 8601 (`YYYY-MM-DD`) wrapped in double quotes
+- **Price format**: Decimal number (high precision), no quotes
+- **Structure**: `id` (date) and `output` (price) columns
+- **Validation**: Use `just tsv-check` to validate TSV files

LICENSE.md

@@ -0,0 +1,16 @@
+MIT License
+
+Copyright (c) 2025 Sablier Labs Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,127 @@
+# Sablier Price Data
+
+Centralized repository for cryptocurrency and forex exchange rate data used across Sablier projects.
+
+## Overview
+
+This repository serves as a single source of truth for price data shared between multiple Sablier repositories:
+
+- **Indexers** ([sablier-labs/indexers](https://github.com/sablier-labs/indexers)) - Real-time blockchain data indexing
+- **Accounting** ([sablier-labs/business](https://github.com/sablier-labs/business)) - Financial reporting and
+  accounting
+
+By centralizing the data here, we avoid duplication and ensure consistency across projects.
+
+## Data Sources
+
+All price data is sourced from industry-standard APIs:
+
+- **Cryptocurrency Prices**: [CoinGecko API](https://www.coingecko.com/api) - Daily historical prices in USD
+- **Forex Exchange Rates**: [CurrencyFreaks API](https://currencyfreaks.com/) - Daily GBP/USD exchange rates
+
+## Data Structure
+
+Price data is organized in `data/crypto/` (cryptocurrency prices in USD) and `data/forex/` (foreign exchange rates).
+
+### TSV Format
+
+All files use tab-separated values (TSV) format with the following structure:
+
+```tsv
+id	output
+"2025-02-01"	3296.390634843652
+"2025-02-02"	3125.0386801320924
+```
+
+We use this data structure to make it easier to use the files in our
+[Envio indexers](https://github.com/sablier-labs/indexers).
+
+**Columns:**
+
+- `id`: Date in ISO 8601 format (`YYYY-MM-DD`), wrapped in double quotes
+- `output`: USD price as a decimal number (high precision)
+
+**Notes:**
+
+- Dates are in UTC timezone
+- Dates are sorted chronologically
+- No duplicate dates within a file
+- Prices are daily closing prices (00:00 UTC)
+
+## Installation
+
+Install the package via npm:
+
+```bash
+npm install @sablier/price-data
+```
+
+Or using Bun:
+
+```bash
+bun add @sablier/price-data
+```
+
+## Usage
+
+### Package Import
+
+Once installed, you can access the TSV data files from `node_modules/@sablier/price-data/data/`:
+
+```typescript
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// Read ETH prices
+const dataPath = join(process.cwd(), "node_modules", "@sablier/price-data", "data/crypto/ETH_USD.tsv");
+const ethPrices = readFileSync(dataPath, "utf-8");
+
+// Parse TSV (skip header)
+const lines = ethPrices.split("\n").slice(1);
+const prices = lines.map((line) => {
+  const [dateQuoted, price] = line.split("\t");
+  return {
+    date: dateQuoted.replace(/"/g, ""), // Remove quotes
+    price: parseFloat(price),
+  };
+});
+```
+
+### Direct File Access
+
+Alternatively, you can read the TSV files directly from this repository without installing the package.
+
+**Example: curl:**
+
+```bash
+curl -s https://raw.githubusercontent.com/sablier-labs/price-data/main/data/crypto/ETH_USD.tsv | head -n 10
+```
+
+**Example (fetch with Node.js):**
+
+```typescript
+const response = await fetch("https://raw.githubusercontent.com/sablier-labs/price-data/main/data/crypto/ETH_USD.tsv");
+const ethPrices = await response.text();
+
+// Parse TSV (skip header)
+const lines = ethPrices.split("\n").slice(1);
+const prices = lines.map((line) => {
+  const [dateQuoted, price] = line.split("\t");
+  return {
+    date: dateQuoted.replace(/"/g, ""), // Remove quotes
+    price: parseFloat(price),
+  };
+});
+```
+
+### Git Submodule
+
+For projects that need version-locked data, add this repository as a Git submodule:
+
+```bash
+git submodule add https://github.com/sablier-labs/price-data.git
+```
+
+## Updating Data
+
+TODO

biome.jsonc

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "extends": ["@sablier/devkit/biome"],
+  "files": {
+    "includes": ["**/*.{css,js,jsx,json,jsonc,ts,tsx}"]
+  },
+  "formatter": {
+    "lineWidth": 100
+  }
+}