4H Four Hearts

4H のはじめ方

Four Hearts (4H) は仕様駆動の Java FIX エンジンです。90 日評価パッケージ（4h-eval）をダウンロードした前提です。

パッケージ構成

展開後の主なディレクトリ:

  • 4h-license.properties — 社名紐付けの評価ライセンス（90 日・非本番）
  • examplebank-demo/ — 架空 ExampleBank ESP 向け TCP イニシエータ／アクセプタ
  • examples/ — ROE、Lucid サンプル、参考資料
  • lib/ — 4H エンジン JAR と依存関係

4h-license.properties はパッケージ直下に置いてください。デモスクリプトは -D4h.license.required=true を自動付与します。

前提

  • Java 21 以上
  • パッケージ直下の 4h-license.properties

動作確認

cd 4h-eval-*/
cd examplebank-demo
./build.sh
./run-server.sh

別ターミナル:

cd 4h-eval-*/
cd examplebank-demo
./run-client.sh

両方のログに Logon、ハートビート、クォート／トレードのメッセージが出れば成功です。

トラブルシュート

症状 想定原因
起動時のライセンスエラー 4h-license.properties が無い、またはカレントから読めない
Connection refused サーバー未起動、またはクライアントの host/port 不一致
シーケンスリセットのループ 前回実行で seqnum がずれた — サーバーとクライアントをきれいに再起動

次のステップ