From b9a5abf207c5b2046d0b2a0acc5606b182c665ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9Ccaneryy=E2=80=9D?= Date: Wed, 26 Aug 2026 17:19:18 +0300 Subject: [PATCH 1/2] chore: add copyright headers to repository scripts --- scripts/check-deploy-docs.mjs | 1 + scripts/check-deploy-docs.test.mjs | 1 + scripts/check-fixture-sizes.mjs | 1 + scripts/check-fixture-sizes.test.mjs | 1 + scripts/check-links.js | 1 + scripts/check-snapshots.mjs | 1 + scripts/check-threat-model-anchors.mjs | 1 + scripts/check-threat-model-anchors.test.mjs | 1 + 8 files changed, 8 insertions(+) diff --git a/scripts/check-deploy-docs.mjs b/scripts/check-deploy-docs.mjs index be9681a..1afebc0 100644 --- a/scripts/check-deploy-docs.mjs +++ b/scripts/check-deploy-docs.mjs @@ -1,4 +1,5 @@ #!/usr/bin/env node +// Copyright (c) 2026 Sub Rosa contributors // scripts/check-deploy-docs.mjs // // Lightweight text-based smoke test that keeps docs/DEPLOY.md copy-pasteable. diff --git a/scripts/check-deploy-docs.test.mjs b/scripts/check-deploy-docs.test.mjs index 88f4322..86628e0 100644 --- a/scripts/check-deploy-docs.test.mjs +++ b/scripts/check-deploy-docs.test.mjs @@ -1,3 +1,4 @@ +// Copyright (c) 2026 Sub Rosa contributors import { execFileSync } from "node:child_process"; import { mkdirSync, mkdtempSync, copyFileSync, writeFileSync, rmSync } from "node:fs"; import { tmpdir } from "node:os"; diff --git a/scripts/check-fixture-sizes.mjs b/scripts/check-fixture-sizes.mjs index 9e2b3bc..ffbf62f 100644 --- a/scripts/check-fixture-sizes.mjs +++ b/scripts/check-fixture-sizes.mjs @@ -1,3 +1,4 @@ +// Copyright (c) 2026 Sub Rosa contributors import { readdirSync, statSync } from "node:fs"; import { join, relative } from "node:path"; diff --git a/scripts/check-fixture-sizes.test.mjs b/scripts/check-fixture-sizes.test.mjs index ddcc84f..6242ae3 100644 --- a/scripts/check-fixture-sizes.test.mjs +++ b/scripts/check-fixture-sizes.test.mjs @@ -1,3 +1,4 @@ +// Copyright (c) 2026 Sub Rosa contributors import { execFileSync } from "node:child_process"; import { describe, it } from "node:test"; import assert from "node:assert/strict"; diff --git a/scripts/check-links.js b/scripts/check-links.js index 08ab2ad..3d4d7e9 100644 --- a/scripts/check-links.js +++ b/scripts/check-links.js @@ -1,4 +1,5 @@ #!/usr/bin/env node +// Copyright (c) 2026 Sub Rosa contributors 'use strict'; const fs = require('fs'); diff --git a/scripts/check-snapshots.mjs b/scripts/check-snapshots.mjs index 3ad1470..6d3a446 100644 --- a/scripts/check-snapshots.mjs +++ b/scripts/check-snapshots.mjs @@ -1,4 +1,5 @@ #!/usr/bin/env node +// Copyright (c) 2026 Sub Rosa contributors // check-snapshots.mjs // // CI guard for Issue #120 — contract snapshot inventory check. diff --git a/scripts/check-threat-model-anchors.mjs b/scripts/check-threat-model-anchors.mjs index 23462a5..7ec7dec 100644 --- a/scripts/check-threat-model-anchors.mjs +++ b/scripts/check-threat-model-anchors.mjs @@ -1,4 +1,5 @@ #!/usr/bin/env node +// Copyright (c) 2026 Sub Rosa contributors /** * Check that docs/THREAT_MODEL.md still covers the core sealed-round risk * topics used by SCF / Wave diligence. diff --git a/scripts/check-threat-model-anchors.test.mjs b/scripts/check-threat-model-anchors.test.mjs index 859f1c2..016eff6 100644 --- a/scripts/check-threat-model-anchors.test.mjs +++ b/scripts/check-threat-model-anchors.test.mjs @@ -1,3 +1,4 @@ +// Copyright (c) 2026 Sub Rosa contributors import { execFileSync } from "node:child_process"; import { copyFileSync, mkdtempSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; From f4e96edb747a7d17af31bbbcd383cf9038eac835 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9Ccaneryy=E2=80=9D?= Date: Wed, 26 Aug 2026 17:33:36 +0300 Subject: [PATCH 2/2] chore: add SPDX headers to documentation --- ARCHITECTURE.md | 1 + README.md | 1 + TASKS.md | 1 + contracts/round/ERRORS.md | 1 + contracts/round/README.md | 1 + docs/CV_LABS_APPLICATION.md | 1 + docs/DEMO_SCRIPT.md | 1 + docs/DEPLOY.md | 1 + docs/ECOSYSTEM.md | 1 + docs/INTEGRATION.md | 1 + docs/LIMITATIONS.md | 1 + docs/PILOT_PLAYBOOK.md | 1 + docs/RECEIPTS.md | 1 + docs/SCF_TRANCHE_PLAN.md | 1 + docs/TECH_DESIGN.md | 1 + docs/THREAT_MODEL.md | 1 + docs/TRACK_ANSWERS.md | 1 + packages/round-bindings/README.md | 1 + packages/round-bindings/SNAPSHOT_TESTS.md | 1 + services/appraisal-api/README.md | 1 + services/keeper/README.md | 1 + 21 files changed, 21 insertions(+) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index e74cee9..352fce4 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -1,3 +1,4 @@ + # Sub Rosa — Architecture High-level map of the monorepo: components, trust boundaries, round lifecycle, and where each proof runs. For crypto and settlement detail see [docs/TECH_DESIGN.md](./docs/TECH_DESIGN.md). diff --git a/README.md b/README.md index 596c015..4143757 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ + > [!NOTE] > This repository is the ecosystem contribution workspace for Sub Rosa, > created specifically for participation in the Stellar Wave program. The main diff --git a/TASKS.md b/TASKS.md index fee6239..62f0107 100644 --- a/TASKS.md +++ b/TASKS.md @@ -1,3 +1,4 @@ + # Task List: Issue #114 Receipt Schema Version Rejection - [ ] Phase 1: Locate offline receipt verifier and inspect current error handling diff --git a/contracts/round/ERRORS.md b/contracts/round/ERRORS.md index 83b5095..529c9c5 100644 --- a/contracts/round/ERRORS.md +++ b/contracts/round/ERRORS.md @@ -1,3 +1,4 @@ + # Sub Rosa Round — Contract Error Codes Every failure mode from the Sub Rosa round contract has a defined code. There diff --git a/contracts/round/README.md b/contracts/round/README.md index 5bf47d3..7ae604f 100644 --- a/contracts/round/README.md +++ b/contracts/round/README.md @@ -1,3 +1,4 @@ + # Sub Rosa Round Contract Soroban primitive that runs a sealed commit → verifiable-reveal → diff --git a/docs/CV_LABS_APPLICATION.md b/docs/CV_LABS_APPLICATION.md index dc4f193..503308f 100644 --- a/docs/CV_LABS_APPLICATION.md +++ b/docs/CV_LABS_APPLICATION.md @@ -1,3 +1,4 @@ + # Stellar x CV Labs Accelerator Application Working draft for the 2026 Stellar x CV Labs Accelerator application. diff --git a/docs/DEMO_SCRIPT.md b/docs/DEMO_SCRIPT.md index d8e5859..21a1242 100644 --- a/docs/DEMO_SCRIPT.md +++ b/docs/DEMO_SCRIPT.md @@ -1,3 +1,4 @@ + # Demo Script (~5 Minutes) Walkthrough for `pnpm web:dev` (default http://localhost:5173). diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 65ce850..819854b 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -1,3 +1,4 @@ + # Deploy & environment variables Sub Rosa **does not require a committed `.env` file**. Secrets stay out of git; you inject them where each layer runs. diff --git a/docs/ECOSYSTEM.md b/docs/ECOSYSTEM.md index c97e316..b3debc7 100644 --- a/docs/ECOSYSTEM.md +++ b/docs/ECOSYSTEM.md @@ -1,3 +1,4 @@ + # Ecosystem Integration — Passkey, Relayer, Scaffold Sub Rosa's live path uses **Ed25519 session keys + signed mandates** and **direct Soroban RPC**. It also ships optional ecosystem adapters that do not change the core protocol: Passkey-Kit in the web wallet panel, and OpenZeppelin Relayer Channels as an SDK submitter. diff --git a/docs/INTEGRATION.md b/docs/INTEGRATION.md index 45a1dcb..c99cfe2 100644 --- a/docs/INTEGRATION.md +++ b/docs/INTEGRATION.md @@ -1,3 +1,4 @@ + # Integrating Sub Rosa Sub Rosa does not require users to come to the Sub Rosa demo app. The demo app diff --git a/docs/LIMITATIONS.md b/docs/LIMITATIONS.md index 7b24cf2..ca72aa3 100644 --- a/docs/LIMITATIONS.md +++ b/docs/LIMITATIONS.md @@ -1,3 +1,4 @@ + # Known Limitations Honest boundaries for the current prototype and submission materials. No hidden diff --git a/docs/PILOT_PLAYBOOK.md b/docs/PILOT_PLAYBOOK.md index ad148b1..5772068 100644 --- a/docs/PILOT_PLAYBOOK.md +++ b/docs/PILOT_PLAYBOOK.md @@ -1,3 +1,4 @@ + # Sub Rosa Pilot Playbook ## Positioning diff --git a/docs/RECEIPTS.md b/docs/RECEIPTS.md index f87f4de..7124511 100644 --- a/docs/RECEIPTS.md +++ b/docs/RECEIPTS.md @@ -1,3 +1,4 @@ + # Round Receipts A **round receipt** is a portable JSON document that captures the final state of a Sub Rosa auction round. Receipts can be exported from any live contract and verified offline — no RPC, no secrets, no Stellar dependency. diff --git a/docs/SCF_TRANCHE_PLAN.md b/docs/SCF_TRANCHE_PLAN.md index b6f71df..c082c9b 100644 --- a/docs/SCF_TRANCHE_PLAN.md +++ b/docs/SCF_TRANCHE_PLAN.md @@ -1,3 +1,4 @@ + # Sub Rosa — SCF Tranche Plan This document defines a focused three-tranche plan for Sub Rosa's SCF Build Award, diff --git a/docs/TECH_DESIGN.md b/docs/TECH_DESIGN.md index 4611cad..1c1ad9b 100644 --- a/docs/TECH_DESIGN.md +++ b/docs/TECH_DESIGN.md @@ -1,3 +1,4 @@ + # Sub Rosa — Technical Design ## Architecture diff --git a/docs/THREAT_MODEL.md b/docs/THREAT_MODEL.md index 0364c01..1f9f5c9 100644 --- a/docs/THREAT_MODEL.md +++ b/docs/THREAT_MODEL.md @@ -1,3 +1,4 @@ + # Sub Rosa — Threat Model ## Assets diff --git a/docs/TRACK_ANSWERS.md b/docs/TRACK_ANSWERS.md index e1f2883..6b948f8 100644 --- a/docs/TRACK_ANSWERS.md +++ b/docs/TRACK_ANSWERS.md @@ -1,3 +1,4 @@ + # Track Answers — Build On Stellar / IBW 2026 Sub Rosa won **1st Place in the Hack Privacy Track**. The multi-agent/x402, diff --git a/packages/round-bindings/README.md b/packages/round-bindings/README.md index c7fff44..c6db109 100644 --- a/packages/round-bindings/README.md +++ b/packages/round-bindings/README.md @@ -1,3 +1,4 @@ + # round-bindings JS JS library for interacting with [Soroban](https://soroban.stellar.org/) smart contract `round-bindings` via Soroban RPC. diff --git a/packages/round-bindings/SNAPSHOT_TESTS.md b/packages/round-bindings/SNAPSHOT_TESTS.md index 65bc52f..8fa374a 100644 --- a/packages/round-bindings/SNAPSHOT_TESTS.md +++ b/packages/round-bindings/SNAPSHOT_TESTS.md @@ -1,3 +1,4 @@ + # Round contract event snapshot tests The Round contract emits seven **on-chain events** via diff --git a/services/appraisal-api/README.md b/services/appraisal-api/README.md index 855654c..9ad02d3 100644 --- a/services/appraisal-api/README.md +++ b/services/appraisal-api/README.md @@ -1,3 +1,4 @@ + # `@sub-rosa/appraisal-api` x402-gated appraisal API. Agents pay per call in **USDC (SEP-41)** over Soroban; diff --git a/services/keeper/README.md b/services/keeper/README.md index 992c142..fde6d52 100644 --- a/services/keeper/README.md +++ b/services/keeper/README.md @@ -1,3 +1,4 @@ + # Keeper Service The Sub Rosa keeper service is a permissionless TypeScript node application that can run single-shot lifecycle operations or run in watch mode to automatically monitor and drive in-flight rounds to completion. A built-in status HTTP API exposes keeper-observed round state for pilots and dashboards.