{"id":51046655,"url":"https://github.com/diadata-org/dia-cardano-oracle","last_synced_at":"2026-06-22T14:30:52.960Z","repository":{"id":354116260,"uuid":"1222224613","full_name":"diadata-org/dia-cardano-oracle","owner":"diadata-org","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-18T14:25:09.000Z","size":69841,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T15:10:11.999Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/diadata-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security/security-notes.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-27T06:52:50.000Z","updated_at":"2026-06-18T14:26:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/diadata-org/dia-cardano-oracle","commit_stats":null,"previous_names":["protofire/dia-cardano-oracle","diadata-org/dia-cardano-oracle"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/diadata-org/dia-cardano-oracle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diadata-org%2Fdia-cardano-oracle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diadata-org%2Fdia-cardano-oracle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diadata-org%2Fdia-cardano-oracle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diadata-org%2Fdia-cardano-oracle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/diadata-org","download_url":"https://codeload.github.com/diadata-org/dia-cardano-oracle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diadata-org%2Fdia-cardano-oracle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34653712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-22T14:30:51.796Z","updated_at":"2026-06-22T14:30:52.952Z","avatar_url":"https://github.com/diadata-org.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DIA Cardano Oracle\n\nImplementation repository for the DIA oracle integration on Cardano.\n\n## Contents\n\n- [DIA Cardano Oracle](#dia-cardano-oracle)\n  - [Contents](#contents)\n  - [Repository Scope](#repository-scope)\n  - [Prerequisites](#prerequisites)\n  - [Quick Start](#quick-start)\n  - [Operator Workflow](#operator-workflow)\n\nThe source-of-truth architecture is:\n\n- [Cardano Oracle Architecture](docs/architecture/cardano-oracle-architecture.md)\n\nProject and delivery documents:\n\n- [Final Cardano Milestones](docs/milestones/final-cardano-milestones.md)\n- ([Project Catalyst](https://milestones.projectcatalyst.io/projects/1400073))\n- [Milestone 1 Proof of Achievement](docs/milestones/milestone-1-poa.md) — Catalyst submission document (links to all M1 evidence)\n- [Milestone 2 Proof of Achievement](docs/milestones/milestone-2-poa.md) — Catalyst submission document (links to all M2 evidence)\n- [Requirements](docs/requirements/cardano-integration-requirement-pf.md)\n\nComponent docs:\n\n- [On-chain contracts (Aiken)](contracts/aiken/README.md)\n- [Off-chain CLI runbook](offchain/cli/README.md) — protocol bootstrap, client onboarding, maintenance txs (settle, withdraw, pair lifecycle).\n- [Feeder daemon](offchain/feeder/README.md) — long-running service that consumes DIA Lasernet `OracleIntent` events and submits Cardano oracle updates (M2 deliverable).\n- [Grafana dashboards guide](docs/architecture/grafana-dashboards.md) — the three monitoring dashboards panel-by-panel (what each chart shows, how to read it, when to worry) + the alert cheat sheet.\n\n## Repository Scope\n\n- `contracts/`: on-chain Aiken implementation.\n- `offchain/cli/`: admin CLI — protocol/client bootstrap, treasury ops, lifecycle txs.\n- `offchain/feeder/`: long-running feeder daemon — DIA → Cardano pipeline, HTTP API, Prometheus metrics, cron-based liveness.\n- `offchain/Makefile`: operator shortcuts wrapping the unified `dia-cardano-feeder` Docker image (CLI + feeder in one image; profiles `sqlite`, `postgres`, `cli`, `monitoring`).\n- `docs/`: architecture, milestones, requirements, plans, references.\n\n## Prerequisites\n\n- **Node.js 20+** with `npm`, for the off-chain CLI.\n- **Aiken `v1.1.21`** (Plutus V3), only needed to modify or rebuild the\n  on-chain contracts. See the\n  [official installation instructions](https://aiken-lang.org/installation-instructions).\n  The compiled blueprint `contracts/aiken/plutus.json` is committed, so a fresh\n  clone can run the CLI runbook without Aiken installed.\n- A **Blockfrost** project id (or a Koios endpoint) for Cardano Preview, and\n  a funded Preview wallet seed. Setup details are in the CLI runbook.\n\n## Quick Start\n\nFor a fresh clone, the recommended order is:\n\n1. (Optional) Build and test the on-chain contracts —\n   see [`contracts/aiken/README.md`](contracts/aiken/README.md). Skip this if\n   you have not changed the contracts; the committed `plutus.json` is what the\n   CLI consumes.\n2. Install and configure the off-chain CLI — see\n   [`offchain/cli/README.md`](offchain/cli/README.md).\n3. Follow the CLI runbook end-to-end on Preview.\n\n## Operator Workflow\n\nTwo complementary surfaces, each with its own full manual:\n\n- **CLI (admin, one-shot ops)** — protocol/client bootstrap and maintenance\n  transactions (settle, withdraws, min-UTxO updates, pair burn,\n  reference-script reclaim). Phase-by-phase runbook in\n  [`offchain/cli/README.md`](offchain/cli/README.md).\n- **Feeder daemon (long-running)** — consumes DIA Lasernet `OracleIntent`\n  events, routes and batches them, submits Cardano update txs, and exposes\n  `/health`, `/metrics`, and `/api/v1/prices` over HTTP. Pipeline steps and the\n  optional Prometheus + Grafana monitoring profile are in\n  [`offchain/feeder/README.md`](offchain/feeder/README.md).\n\nThe fastest path to a working deployment is the unified Docker image:\n\n```sh\ncd offchain\nmake build               # builds the dia-cardano-feeder image (feeder + CLI)\nmake up                  # starts the feeder daemon (sqlite profile)\nmake up MONITORING=1     # feeder + Prometheus + Grafana (toggle on any start target)\nmake cli CMD=\"protocol\"  # one-shot CLI command in the same image\n```\n\nFor the protocol design behind each phase — datums, redeemers, cross-script\ninvariants, fee flow, batch validation algorithm, trust model — see the\n[architecture document](docs/architecture/cardano-oracle-architecture.md)\nand [security notes](docs/security/security-notes.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiadata-org%2Fdia-cardano-oracle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiadata-org%2Fdia-cardano-oracle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiadata-org%2Fdia-cardano-oracle/lists"}