AuthiChain

AuthiChain Unified

AuthiChain の物理世界における信頼レイヤーの標準実装です。

AuthiChain は、物理的な製品や資産に検証可能なデジタル ID を付与します。標準に準拠した識別子から署名済みのクレームを解決し、ポリシーと来歴データを評価したうえで、独立した検証者が監査可能な結果を返します。

このリポジトリは、以下の標準的なビルド／デプロイ環境です。

• AuthiChain — 検証、証明、製品 ID、API、請求
• QRON — 美しくプログラム可能な検証エクスペリエンスと QR スタジオ
• GovChain — 政府機関／請負業者向けの信頼ワークフローとシール
• StrainChain — 規制対象の物理的な製品の来歴と検証
• AgentZ / MCP — エージェント型オーケストレーションと、同じ信頼プリミティブへのマシン向けアクセス

中核となる考え方： 1 つの検証プロトコルを、多様な商用サービスに展開します。各業界向け製品が信頼モデルを分岐させるべきではありません。

アーキテクチャの概要

                    PHYSICAL WORLD
                          │
                 product / asset / unit
                          │
                          ▼
                 GS1 Digital Link
              GTIN + serial / lot / qualifiers
                          │
                          ▼
                  ┌───────────────┐
                  │   RESOLUTION  │
                  │ identifier →  │
                  │ representation│
                  └───────┬───────┘
                          │
                          ▼
              ┌──────────────────────┐
              │ AUTHICHAIN VERIFY    │
              │ signed claims        │
              │ issuer / JWKS         │
              │ status / revocation   │
              │ provenance / policy   │
              │ scan-risk signals     │
              └──────────┬──────────┘
                         │
              ┌──────────┼──────────┐
              ▼          ▼          ▼
           Humans      Agents     Enterprise
           /verify     MCP/API    integrations
              │          │          │
              └──────────┼──────────┘
                         ▼
              QRON · GovChain · StrainChain
                         │
                         ▼
                billing / onboarding /
                audit / operational data

信頼境界

解決は検証ではありません。 リゾルバーは、どの識別子／リソースが指定されているかに答えます。AuthiChain の検証では、署名済みクレームが有効で、最新であり、出所を特定でき、検証者が利用できる証拠と整合しているかを評価します。

したがって、肯定的なステータスは、評価対象となる証拠とポリシーの範囲に限定されます。たとえば、製品識別子が登録されているだけでは製造品質の証明にはならず、識別子が見つからないだけでは偽造品の証明にはなりません。

リポジトリの構成

レイヤー	場所	担当
Web／顧客向けサービス	client/、workers/	公開ドメインにおける QRON および各業界向けのユーザーエクスペリエンス
検証プロトコル	protocol/	オープンソースのプロトコル／リファレンス実装
エージェント型オペレーション	agentz/	ワークフローのオーケストレーション、パイロット、運用の自動化
マシンインターフェイス	mcp/	AuthiChain の機能への MCP アクセス
エッジ／API	workers/*	Cloudflare Workers、ルーティング、検証、インテグレーション
永続化	Supabase/Postgres + D1	運用状態、証明、イベント、アプリケーションデータ
アーキテクチャドキュメント	docs/ESTATE.md、docs/NETWORK.md	システム一覧とデプロイトポロジー

公開サービス

• authichain.com — プロトコル、検証、証明書、API、請求
• qron.space — QRON の作成とプログラム可能なエクスペリエンス
• govchain.us — 政府機関／請負業者向けの信頼ワークフロー
• strainchain.io — 来歴と製品検証のワークフロー

これらのドメインは、同じ基盤となる信頼アーキテクチャ上に構築された商用サービスおよびプレゼンテーション用のサービスです。標準的な顧客向け導線は /onboard、/dapp、/verify です。

標準と検証フロー

1. 識別 — 物理的な個体を安定した識別子で表します。該当する場合は、/01/{gtin}/21/{serial} などの GS1 Digital Link 構文を使用します。
2. 解決 — 識別子から適切な表現またはリンクセットを解決します。
3. 証明 — 発行者が識別対象についてのクレームに署名します。
4. 検証 — 検証者が署名、発行者のキー、ステータス／失効状況、適用されるポリシーを確認します。
5. 解釈 — 登録と物理検査を混同せず、証拠に裏付けられた状態とリスクシグナルを報告します。
6. 活用 — 人間、エージェント、エンタープライズシステムが、Web、API、MCP インターフェイスを通じて結果を利用します。

デプロイモデル

Cloudflare を第一に採用しています。 本番環境のエッジは Cloudflare Workers と、リポジトリのワーカーのデプロイ設定です。互換性や移行を支えるレガシーなフレームワークのコードがリポジトリに残っている場合がありますが、アーキテクチャの中心ではありません。

• エッジ／ランタイム：Cloudflare Workers + Wrangler
• Web：Vite + React
• データ：Supabase/Postgres と Cloudflare D1
• ORM：Drizzle
• パッケージマネージャー：pnpm
• エージェントのランタイム：Python / AgentZ
• プロトコル／API コンポーネント：TypeScript、Hono、標準的な暗号ライブラリ

デプロイのトポロジーについては docs/NETWORK.md を、システムのインベントリについては docs/ESTATE.md を参照してください。

はじめに

cp .env.example .env
pnpm install
pnpm dev

GitHub Codespaces

簡略化した Codespaces 設定は .devcontainer/ にあります。デフォルトの対象範囲は core です（pnpm のインストールを固定し、ブラウザーのバイナリと husky は含みません）。手法と展開ルールについては .devcontainer/CONDENSING.md を参照してください。

データベースを使用するスクリプトでは、認証情報をソースコードに記述しないでください。ローカル環境またはデプロイ用シークレットストアに DATABASE_URL を設定してください。

例：

export DATABASE_URL='postgresql://USER:PASSWORD@HOST:5432/DATABASE?sslmode=require'

AgentZ

python -m agentz.cli list
python -m agentz.cli run authichain_pilot_deploy --mode dry-run

パイロットの準備状況

正式な準備確認の手順は次のとおりです。

install → typecheck → lint → tests → production build → deploy smoke test → real product scan

以下を参照してください。

• docs/operations/PILOT-READY-BASELINE.md
• docs/attestation/v0.1.md
• docs/ESTATE.md
• docs/NETWORK.md

セキュリティ

デプロイの不変条件

ドキュメントのみのコミットを含め、main へのプッシュでは deploy-cloudflare.yml と deploy-edge-worker.yml が実行されます。paths や paths-ignore を追加しないでください。

シークレットスキャン（gitleaks 8.28.0、--no-git）が最初に実行され、必ずフェイルクローズでなければなりません。デプロイ権限は contents: read のままにしてください。トークンの値を Git に含めないでください。

Wrangler のデプロイが成功したことは、そのコミットのバンドルが公開されたことを意味します。SOC 2、FedRAMP、FDA、政府機関、または大麻の COA 認証を取得したことを意味するものではありません。検証の合格とは、このチェックアウトで実行されたチェックの合格です。

authichain-consensus-engine は ID の衝突です。廃止する前に Cloudflare で確認してください。このファイルはこれを廃止するものではありません。

セキュリティはプロトコルの提示に不可欠な要素であり、後付けするものではありません。

• Git に認証情報を含めないでください。 ランタイムシークレットは環境またはデプロイ用シークレットストアに保存してください。
• 例に有効なシークレットを含めないでください。 sk_live_…、whsec_…、postgresql://USER:PASSWORD@HOST/DB などのプレースホルダーを使用してください。
• 漏えいした認証情報は直ちにローテーションしてください。 現在のツリーからシークレットを削除しても、Git の履歴、キャッシュ、ログにすでに残っている可能性のある認証情報は無効になりません。
• リリース前に検証してください。 マージ前にシークレットスキャンを実行し、既存のセキュリティチェックを有効なままにしてください。
• 最小権限を適用してください。 広範なアカウントトークンよりも、スコープを絞った認証情報とサービスバインディングを優先してください。

認証情報が一度でもコミットされた場合、プロバイダーがローテーションまたは失効を確認するまでは、漏えいしたものとして扱ってください。

プロジェクトの原則

AuthiChain は、本質的にブロックチェーンの UI ではありません。長期にわたって価値を提供する製品は検証レイヤーです。標準化された ID → 解決 → 署名付き証明 → 独立した検証 → 証拠に基づく判断、という流れを実現します。

ブロックチェーンへのアンカリング、NFT、QR アート、AI エージェント、業界別アプリケーションはこのレイヤーを拡張できますが、信頼境界を再定義するものであってはなりません。

ライセンス

docs/project/LICENSE.md を参照してください。