EMPORION — business facts from public registers

🔄 モノレポから同期されていますが、履歴は継続しています。 emporion は正規の AI-Factory モノレポをミラーリングしています。履歴は追記のみです（強制プッシュはありません）。 プルリクエストを歓迎します — マージされたプルリクエストはモノレポに取り込まれ、ここに再同期されるため、あなたの貢献が正規のものになります。 💬 Issue · プルリクエスト をどちらも歓迎します。

EMPORION — 取引を行うエージェントのための公開記録上の事実

🌐 英語 · Русский · Español · Français · 中文

購入、販売、または支払いを行うエージェントには、どのモデルも作り出せない事実が必要です。この VAT 番号は有効か、この会社はどのような会社か、その日のユーロ為替レートはいくらだったか、このウォレットは制裁リストに載っているか、そしてこの文書が昨日存在していたことを証明できるか。EMPORION は、欧州委員会、GLEIF、ECB、米国財務省、EU、英国、Bitcoin などの公開記録からそれぞれの問いに答えます。また、すべての回答に、情報源、取得時刻、情報源から返された内容の SHA-256を添えて署名します。

Emporion（ἐμπόριον）：商人たちが集い、取引を決済した、古代ギリシャの都市にあった交易所。

0.2.0 以降は、その次に生じる問いにも答えます。この会社は自国の登記簿に登録されているか、EORI 番号は税関手続きで有効か、店舗を運営するドメインはどれくらい前から存在するか、バイエルン州または TARGET2 で第 5 営業日にあたるのはいつか。また、どのモデルにも備わっていない 2 つのツール、証拠として保存されたウェブページ（Bitcoin にアンカーされています）と、デッドマンスイッチを含むタイマーもエージェントに提供します。タイマーは署名済みのイベントとともにエージェントを呼び戻します。

機能

機能	価格	回答できる内容	ソース
emporion.vat.check@v1	$0.002	このEU VAT番号は今日有効ですか？名称、住所、照会時刻に加え、照会者としてご自身のVAT番号を指定した場合は、VIESの照会番号も取得できます。これはご本人名義での照会を示す公式な証明です	EU VIES
emporion.lei.lookup@v1	$0.001	この法人は何者ですか？LEI（チェックディジットはローカルで検証）または名称（候補を順位付け）で検索し、正式名称、管轄区域、法的形態、ステータス、住所、更新日、直接および最終親会社を取得できます	GLEIF（CC0）
emporion.fx.rate@v1	$0.001	1999年以降の任意の日付における任意の通貨ペアのユーロ基準レート、適用されるECBの営業日、ユーロ経由のクロスレート（Decimal形式）、通貨の最小単位に丸めた金額を取得できます	ECB
emporion.sanctions.screen@v1	$0.002	このウォレットアドレスまたは名称は公開制裁リストに掲載されていますか？OFAC SDN（約1,050件のデジタル通貨アドレスを含む）、EUおよび英国のリスト（各リスト経由の国連指定を含み、該当結果ごとに国連番号を付記）を照合し、各リストの日付とSHA-256を取得できます	OFAC · EU · UK
emporion.timestamp.stamp@v1	$0.001	OpenTimestampsのカレンダーを通じてSHA-256ダイジェストをBitcoinに記録し、標準的な.ots証明を返します	OpenTimestamps
emporion.timestamp.verify@v1	$0.001	証明を更新して検証します。EMPORIONがBitcoinネットワークから直接取得したBitcoinブロックヘッダーのMerkleルートと結果が一致すれば、確認済みとなります（各ヘッダーのプルーフ・オブ・ワークを検証し、2つのノードが合意したチェーンを使用）	Bitcoin
emporion.web.capture@v1	$0.003	証拠としてウェブページを記録します。最終URL、すべてのリダイレクト、IP、ステータス、主要なヘッダー、TLS証明書、本文のSHA-256（本文は最大512 KB）を取得できます。記録のSHA-256はBitcoinに記録されます	ページ自体 · OpenTimestamps
emporion.domain.rdap@v1	$0.001	このドメインの登録者と登録時期を確認できます。作成日、有効期限、日数で表した経過期間、レジストラ、ステータス、ネームサーバー、DNSSECを取得できます。未登録の場合はregistered: falseを返します	IANAブートストラップ → TLDのレジストリ
emporion.company.lookup@v1	$0.001	この会社は実在し、現在も活動していますか？番号または名称で検索し、名称、ステータス、法的形態、設立日、住所、VAT番号、登記簿独自のフィールドを取得できます	Brønnøysund（NO） · SIRENE/RNE（FR） · ARES（CZ） · PRH（FI） · Companies House（GB、運営者のキーを使用）
emporion.eori.check@v1	$0.002	このEORI番号はEUの税関で有効ですか？一度に最大10件を照合できます。運営者が同意した場合は名称と住所も取得できます	欧州委員会（EOS）
emporion.calendar.check@v1	$0.001	約250か国・地域、または市場（TARGET2、NYSE、LSE…）の営業日を確認できます。祝日、次または前の営業日、日付からN営業日後の日付、期間内の日数、1年分の祝日を取得できます	python-holidays（オフライン）
emporion.timer.set@v1	$0.002	指定した時刻にHTTPSコールバックへ署名付きPOSTを送信するか、N秒ごとにチェックインしない場合に作動するデッドマンスイッチを設定できます	—
emporion.timer.checkin@v1 · .cancel@v1 · .status@v1	無料	デッドマンスイッチを継続させる、タイマーをキャンセルする、状態を確認する（タイマーのトークンを使用）	—
emporion.sources@v1	無料	各ソースのライセンスと帰属表示、現在保持している制裁リスト、最新のECB営業日を確認できます	—

flowchart LR
    A[Agent] -->|invoke + payment| H[AIMarket hub]
    H -->|X-Provider-Signature required| E[EMPORION]
    E --> N{allowlist<br/>per source}
    N --> V[VIES]
    N --> G[GLEIF]
    N --> C[ECB]
    N --> S[OFAC · EU · UK lists<br/>refreshed every 6 h]
    N --> O[OpenTimestamps calendars]
    E --> X[Bitcoin P2P network<br/>headers · proof of work checked]
    E -->|answer + evidence:<br/>url · fetched_at · sha256| H
    H -->|signed receipt| A

信頼性の概要

• すべての回答に根拠を添付 — ソース URL、取得時刻、返されたバイト列の SHA-256 に加え、ソースのライセンスと帰属表示。
• 2つの署名 — ゲートウェイの署名付きレシート（oracle-core、Ed25519、ORACLE_PQC=1 の場合はハイブリッド ML-DSA）と、ハブが検証するリクエストに紐づいた X-Provider-Signature。
• 回答できないソースに費用はかかりません — 回答は ok:false となり、ハブは ok:false に対して何も差し引きません。加盟国の VAT 登録簿が停止中の場合、制裁リストが読み込まれていない、または 48 時間を超えて古い場合、タイムスタンプカレンダーが2つ未満の場合、ヘッダーチェーンがまだ到達していないブロックの場合が該当します。
• 送信リクエストはソースごとに許可リストで制限されます。リダイレクトは手動で追跡し、そのソース自身のホストに限られます。本文にはサイズ上限があります。
• 呼び出し元が指定した URL にアクセスする2つの機能（ウェブキャプチャーとタイマーコールバック）が接続できるのは、パブリックアドレスのみです。http(s) のポート 80/443 に限られ、名前に対応するすべてのアドレスが検査されます（ループバック、プライベート、リンクローカル、CGNAT、メタデータの各範囲は除外）。接続先は検査済みのアドレスに固定され、リダイレクトもすべて再検査されます。また、1つのホストに対するキャプチャーは1分あたり最大20回です。

使用例

H=https://emporion.modelmarket.dev
inv() { curl -s -X POST $H/ai-market/v2/invoke -H 'Content-Type: application/json' -d "$1"; }

inv '{"capability_id":"emporion.vat.check@v1","input":{"vat":"NL004495445B01","requester_vat":"DE811569869"}}'
inv '{"capability_id":"emporion.lei.lookup@v1","input":{"name":"Deutsche Bank"}}'
inv '{"capability_id":"emporion.fx.rate@v1","input":{"base":"USD","quote":"JPY","date":"2026-10-11","amount":"100"}}'
inv '{"capability_id":"emporion.sanctions.screen@v1","input":{"address":"0x…"}}'
inv '{"capability_id":"emporion.timestamp.stamp@v1","input":{"digest":"'"$(sha256sum contract.pdf | cut -d' ' -f1)"'"}}'
inv '{"capability_id":"emporion.web.capture@v1","input":{"url":"https://shop.example/terms"}}'
inv '{"capability_id":"emporion.domain.rdap@v1","input":{"domain":"shop.example"}}'
inv '{"capability_id":"emporion.company.lookup@v1","input":{"country":"FR","number":"552032534"}}'
inv '{"capability_id":"emporion.eori.check@v1","input":{"eori":"CZ00177041"}}'
inv '{"capability_id":"emporion.calendar.check@v1","input":{"market":"XECB","add_business_days":5}}'
inv '{"capability_id":"emporion.timer.set@v1","input":{"callback":"https://agent.example/hook","deadman_seconds":3600,"payload":{"release":"escrow-7"}}}'

ハブ経由では、同じ呼び出しに料金が発生し、レシートが発行されます。"product_id":"emporion" を指定して POST https://modelmarket.dev/ai-market/v2/invoke を実行します。

VAT：照会番号

VIES が照会番号を発行するのは、申請者として指定された有効な EU VAT 番号に対してのみです。照会番号は申請者の証明として申請者が保管します。requester_vat にご自身の番号を渡すと、回答に含まれる照会番号は、checked_at 時点で取引相手を確認したことを、ご自身の名義で証明します。番号がなくても確認は実行され、回答には番号の取得方法が示されます。

FX：対象日

ある日付「時点」のレートとは、その日付以前に ECB が公表した最新のレートです。回答にはその日付（ecb_date）が記載されます。日曜日は金曜日のレートが適用され、そのことも明示されます。ECB が公表を停止した通貨（2022年3月以降の RUB）については、何年も前のレートで回答せず、リクエストを拒否します。

制裁：照合であり、判定ではありません

ウォレットは完全一致で照合されます（EVM および bech32 アドレスでは大文字と小文字を区別しません）。名前は単語の集合として照合されます。語順、大文字と小文字、アクセント、法的組織形態は無視されます（「DOE, John」は「John Doe」として扱われます）。誤字を含む単語は一致度 0.9 として扱われ、同じ名前とはみなされません。また、尋ねたすべての単語がより長い名前（父称やミドルネームなど）に含まれていれば、照合されます。デフォルトのしきい値は 0.85 です。各ヒットには、照合した名前とスコアが示されます。

ヒットがあれば詳しく確認してください。ヒットしなくても、制裁対象ではないと確認されたことにはなりません。 名前の重複や別名の欠落があるためです。各回答にはこの注意事項が記載され、使用したリストの名前、公表日、SHA-256 も示されます。リストが古い場合は使用せず、リクエストを拒否します。

国連の指定は英国と EU のリストを通じて反映されます。 国連安全保障理事会が公開するファイルには再利用ライセンスがないため、EMPORION は読み込みません。UK Sanctions List（Open Government Licence v3.0）では、英国が実施するすべての国連指定に UN 参照番号が付与されています。EU のファイルにも一部の指定について同様の番号があります。ヒットには un_ref が含まれ、lists: ["UN"] では、UN 参照番号のある英国と EU の項目のみが照合されます。2026-10-17 時点で、3つのリストには国連の指定項目が合計1010件収録されていました（991件は英国のリストに UN 番号で収録され、残りは EU と OFAC のリストに名前で収録されています）。新しい国連の決定が各リストに反映されるまでには、英国と EU が実施するのに要する遅れがあり、通常は数日です。

タイムスタンプ

sequenceDiagram
    autonumber
    participant A as Agent
    participant E as EMPORION
    participant C as OpenTimestamps calendars
    participant B as Bitcoin nodes (P2P, ×2)
    A->>E: stamp {digest}
    E->>E: sha256(digest ‖ 16 random bytes) — calendars never see the digest
    E->>C: submit to all four, at least two must accept
    C-->>E: pending attestations
    E-->>A: .ots proof (pending)
    Note over C: a few hours later the calendars' aggregate<br/>transaction is mined in a Bitcoin block
    A->>E: verify {digest, proof}
    E->>C: upgrade at each calendar the proof names (allowlisted only)
    C-->>E: path to the block
    E->>B: getheaders — the whole chain, kept and refreshed
    B-->>E: every header's proof of work and difficulty checked, a second node agrees
    E->>E: proof result == header Merkle root
    E-->>A: confirmed · existed no later than the block time · upgraded proof

証明は標準の OpenTimestamps ファイルです。EMPORION を使わずに、任意の OpenTimestamps クライアントで検証できます。参照例（hello-world.txt）は、2015-05-28 のブロック 358 391 まで検証されます。

Web キャプチャ：ページに書かれていた内容

EMPORION はブラウザーと同じようにページを一度取得し、record を返します。内容は、要求された URL、最終 URL、ステータスと IP を含むすべてのリダイレクト、時刻、ステータス、ページの内容を示すヘッダー（コンテンツタイプ、長さ、Last-Modified、ETag、Date、Server…）、サーバーが提示した TLS 証明書（サブジェクト、発行者、有効期間、名前、証明書の SHA-256）、ページタイトル、body_sha256 です。本文は 512 KB 以下の場合に body_b64 として返されます（ページの上限は 5 MB です）。record_sha256 は、キーをソートして区切り文字を詰めた JSON としてのレコードの SHA-256 であり、OpenTimestamps を通じて Bitcoin にアンカーされています。後から emporion.timestamp.verify@v1 で検証できます。404 はキャプチャとして扱われます（ページにそう書かれていたということです）。到達できないホストや、証明書の検証に失敗した場合は料金がかかりません。

タイマーとデッドマンスイッチ

sequenceDiagram
    autonumber
    participant A as Agent
    participant E as EMPORION
    participant C as Agent callback (https)
    A->>E: timer.set {callback, deadman_seconds: 3600, payload}
    E-->>A: timer_id + token (once)
    loop while the agent is alive
        A->>E: timer.checkin {timer_id, token}
        E-->>A: due_at moved 3600 s ahead
    end
    Note over A: the agent stops
    E->>C: POST {event, signature} — Ed25519 (+ ML-DSA) over the event
    C-->>E: 2xx (else retried after 1, 5, 30 min)

at（タイムゾーン付き ISO 時刻）または after_seconds を指定すると、代わりに一度限りの呼び出しが設定されます。イベントには、タイマー ID、種類、予定時刻と発火時刻、試行回数、ペイロード（最大 4 KB）が含まれます。署名は EMPORION の署名付きマニフェストに記載されたキーを使い、キーをソートして区切り文字を詰めた JSON としてのイベントを対象にしています。トークンは SHA-256 のみが保存されます。タイマーの有効期間は最大 90 日で、EMPORION のデータボリューム内にある 1 つの SQLite ファイルに保存されます。

会社登記簿、EORI、ドメイン、営業日

• 会社登記簿は登記簿そのものから回答します。ノルウェーの Brønnøysund Register Centre（NLOD 2.0）、フランスの SIRENE と国の登記簿（政府のオープン API 経由、Licence Ouverte 2.0）、チェコの ARES、フィンランドの PRH（CC BY 4.0）、および運営者が無料キーの COMPANIES_HOUSE_API_KEY を設定している場合は英国の Companies House（OGL v3.0）です。キーがない場合、GB は利用できません。番号は最初にローカルで検証されます（ノルウェー、チェコ、フィンランドのチェックディジット。フランスの SIRET は SIREN に短縮）。ステータスは、活動中、営業停止／解散／削除、破産、清算中、再編中です。
• EORI は欧州委員会の EOS サービスから取得します。「有効ではない」も回答のひとつです。
• RDAP は、IANA のブートストラップファイルで TLD に指定されているサーバーにのみ照会されます（https のみ）。サブドメインや URL は、レジストリに照会して登録名に変換されます。一部の国別コード（.de、.ru など）は、まだ RDAP サービスを公開していません。その場合は拒否され、料金はかかりません。
• RDAP の利用上の注意。 レジストリの利用規約では、大量の自動照会や再配布は禁止されています。そのため EMPORION は、1 つのレジストリへの照会を最大で毎分 30 回とし、各回答を 24 時間（「未登録」の場合は 1 時間）保持します。キャッシュされた回答には cached: true が設定され、元の取得時刻が保持されます。また、利用規約を含むレジストリ独自の通知を registry_terms としてそのまま渡します。
• 個人データ。 登記簿には個人事業主も記載されており、登記簿のライセンスにかかわらず、その情報は個人データです。すべての企業情報の回答には personal_data が含まれます。ここには、目的（取引相手の確認）、法的根拠（正当な利益、GDPR 第 6 条 1 項（f））、保持期間（EMPORION はコピーを保持せず、呼び出しログには入力のハッシュのみを記録）が記載されます。
• 営業日は、EMPORION に組み込まれた python-holidays から取得します。ネットワークを使わないため、停止するものはありません。回答にはライブラリのバージョンが記載されます。そのリリース後に制定された祝日は含まれないためです。

正直な制約

• VIES が返すのは、その時点で各加盟国の登録機関が回答する内容です。一部の国では、名称も住所も返されません。EMPORION は何も保存しません。
• GLEIF が対象とするのは LEI を持つ事業体です。LEI を持たない小規模企業は多数あります。
• 参照レートは情報提供用であり、取引には使用できません。
• 制裁対象のスクリーニングは、3 つの公開リストを検索するものであり、法的助言でもコンプライアンスプログラムでもありません。他の法域のリストは含まれていません。
• タイムスタンプが証明するのは、ブロックの時刻までに存在していたことだけであり、作成者ではありません。
• ウェブのキャプチャに表示されるのは、その時点でサーバーが EMPORION に返した内容です。別の訪問者、国、または Cookie には別のページが表示される場合があります。内容が真実であることを示すものではありません。
• 公開される情報は登録機関によって異なります。これまでに4か国の登録機関（英国キーを含めると5か国）が対象です。試した時点では、ポーランドの KRS API から回答がありませんでした。
• コールバックが4回の試行以内に 2xx を返した場合、タイマーは少なくとも1回配信されます。受信側は、同じ timer_id と同じ due_at の組み合わせを同一のイベントとして扱う必要があります。

実行方法

# from this repository
docker build -f Dockerfile.standalone -t emporion .
docker run -d --name emporion -p 127.0.0.1:9351:9351 -v emporion-data:/data \
  -e EMPORION_PUBLIC_URL=http://127.0.0.1:9351 emporion
curl -s http://127.0.0.1:9351/health

aicom モノレポでは、ルートから docker compose -f emporion/docker-compose.yml up -d --build を実行しても同じように起動します。EMPORION_PUBLIC_URL は購入者がアクセスするアドレスで、署名済みマニフェストに書き込まれます。

本番環境では、aicom モノレポから ./scripts/deploy_emporion.sh --remote <host> を実行すると、既存の nginx の背後で https://modelmarket.dev/providers/emporion/ に配信されます（スニペットを1つ追加してバックアップし、再読み込み前に nginx -t を実行します）。稼働中のイメージは emporion:prev として保持され、ビルドのヘルスチェックに失敗した場合はロールバックされます。通常時のメモリ使用量は約 200 MB、コンテナーの上限は 768 MB です。uid 10001 で実行されます。 専用アドレスは https://emporion.modelmarket.dev/ です。/ は利用者向けのランディングページで、それ以外のパスではどこからでもエージェント向けに同じ API を提供します（deploy/nginx/emporion.modelmarket.dev.conf）。ハブがフェデレーションに使用するアドレスは、引き続き /providers/emporion/ のパスです。

変数	デフォルト値	意味
EMPORION_PUBLIC_URL	https://modelmarket.dev/providers/emporion	マニフェスト内のベース URL
EMPORION_PORT	9351	リッスンポート
EMPORION_RATE_LIMIT	120	クライアントごとの1分あたりの呼び出し回数
EMPORION_CORS_ORIGINS	空（ブラウザーオリジンなし）	CORS 許可リスト
COMPANIES_HOUSE_API_KEY	空（GB は提供されません）	オペレーターが取得する無料の Companies House API キー
EMPORION_TIMERS_DB	署名キーと同じディレクトリーにある timers.sqlite	タイマーの保存先
ORACLE_PQC	compose では 1	ハイブリッド ML-DSA-65 署名

テスト：pip install -e "vendor/oracle-core[pqc]" -e '.[dev]' && pytest（モノレポ内では -e ../oracles/core）。実際の回答から抜粋したデータを使う160件のテストで、ライブソースにアクセスするものはありません。モノレポでは、署名済みの canonical もハブ独自の関数とバイト単位で照合されます。

データソースとライセンス

データソース	ライセンス	回答に記載される帰属表示
EU VIES	欧州委員会の再利用方針（決定 2011/833/EU）	European Commission, VIES
GLEIF	CC0 1.0	Global Legal Entity Identifier Foundation (GLEIF), CC0
ECB	出典の明記を条件とする複製	出典：European Central Bank
OFAC SDN	米国政府の著作物（パブリックドメイン）	U.S. Department of the Treasury, OFAC
EU Financial Sanctions Files	欧州委員会の再利用方針	European Commission, FSF
UK Sanctions List (FCDO)	Open Government Licence v3.0	Open Government Licence v3.0 に基づきライセンスされた公共部門情報が含まれます（UK Sanctions List, FCDO）
OpenTimestamps	無料の公開カレンダー	OpenTimestamps (opentimestamps.org)
Bitcoin block headers	ピアツーピアで取得した公開チェーンデータ	Bitcoin network
EU EORI (EOS)	欧州委員会の再利用方針	European Commission, EORI validation (EOS)
Brønnøysund Register Centre	NLOD 2.0	Brønnøysundregistrene, Enhetsregisteret (NLOD 2.0)
API Recherche d'entreprises	Licence Ouverte 2.0 (Etalab)	DINUM, API Recherche d'entreprises (INSEE SIRENE, INPI RNE)
ARES	チェコの行政機関のオープンデータ	Ministerstvo financí ČR, ARES
PRH / YTJ	CC BY 4.0	Finnish Patent and Registration Office (PRH), YTJ open data
Companies House（キーが必要）	Open Government Licence v3.0	Companies House の公共部門情報が含まれます。OGL v3.0
RDAP	公開登録データ（RFC 9083）	IANA RDAP bootstrap and the TLD registry
python-holidays	MIT	python-holidays (vacanza/holidays)

コードのライセンスは MIT です。詳しくは LICENSE をご覧ください。使用している OpenTimestamps のリファレンスライブラリは LGPL-3.0 です。