Wallet: asset-first market, current docs and cross-platform builds

.github/workflows/entity-wallet-desktop.yml

@@ -0,0 +1,122 @@
+name: ENTITY Wallet Cross-Platform Builds
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+      - wallet-native-asset-ingest-20261003
+    paths:
+      - "src/31_Profiles/exchange_protocol.py"
+      - "src/33_Economic_Participation/**"
+      - "src/38_Global_Passports/**"
+      - "src/39_Implementation_Packages/**"
+      - "src/42_ENTITY_Wallet/**"
+      - "src/43_DCO_Factory/**"
+      - "src/45_ENTITY_Market/**"
+      - "sdk/global_passport_sdk/**"
+      - "protocol/profiles/**"
+      - "protocol/v3/ENTITY_ECONOMIC_MARKET_PROTOCOL.md"
+      - "tools/entity_wallet_desktop.py"
+      - "tools/build_entity_wallet_desktop.py"
+      - "ios/ENTITYWalletIOS/**"
+      - ".github/workflows/entity-wallet-desktop.yml"
+  pull_request:
+    paths:
+      - "src/31_Profiles/exchange_protocol.py"
+      - "src/33_Economic_Participation/**"
+      - "src/38_Global_Passports/**"
+      - "src/39_Implementation_Packages/**"
+      - "src/42_ENTITY_Wallet/**"
+      - "src/43_DCO_Factory/**"
+      - "src/45_ENTITY_Market/**"
+      - "sdk/global_passport_sdk/**"
+      - "protocol/profiles/**"
+      - "tools/entity_wallet_desktop.py"
+      - "tools/build_entity_wallet_desktop.py"
+      - "ios/ENTITYWalletIOS/**"
+      - ".github/workflows/entity-wallet-desktop.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  desktop:
+    name: Desktop · ${{ matrix.label }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            label: Windows
+            artifact: ENTITY-Wallet-Windows
+          - os: ubuntu-latest
+            label: Linux
+            artifact: ENTITY-Wallet-Linux
+          - os: macos-latest
+            label: macOS
+            artifact: ENTITY-Wallet-macOS
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install pytest pyinstaller cryptography PySide6
+      - name: Wallet qualification
+        run: >-
+          python -m pytest
+          tests/test_wallet_onboarding.py
+          tests/test_entity_market_registry.py
+          tests/test_economic_intelligence.py
+          tests/test_exchange_lifecycle.py
+          tests/test_v3_economic_participation.py
+          tests/test_prelaunch_economic_withdrawal.py
+          tests/test_entity_wallet.py
+          tests/test_wallet_asset_ingest.py
+          tests/test_wallet_lineage_resolution.py
+          tests/test_v3_protocol_origin_lineage.py
+          tests/test_v3_global_passports.py
+          -q
+      - name: Build desktop wallet
+        run: python tools/build_entity_wallet_desktop.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          if-no-files-found: error
+          path: |
+            dist/ENTITY-Wallet/**
+            dist/ENTITY-Wallet.app/**
+
+  ios-simulator:
+    name: iOS · Simulator client
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install XcodeGen
+        run: brew install xcodegen
+      - name: Generate Xcode project
+        working-directory: ios/ENTITYWalletIOS
+        run: xcodegen generate
+      - name: Build iOS Simulator app
+        run: |
+          xcodebuild \
+            -project ios/ENTITYWalletIOS/ENTITYWalletIOS.xcodeproj \
+            -scheme ENTITYWalletIOS \
+            -configuration Release \
+            -sdk iphonesimulator \
+            -derivedDataPath build/ios \
+            CODE_SIGNING_ALLOWED=NO \
+            build
+      - name: Package iOS Simulator app
+        run: |
+          mkdir -p dist
+          APP="build/ios/Build/Products/Release-iphonesimulator/ENTITYWalletIOS.app"
+          test -d "$APP"
+          ditto -c -k --sequesterRsrc --keepParent "$APP" dist/ENTITY-Wallet-iOS-Simulator.zip
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ENTITY-Wallet-iOS-Simulator
+          if-no-files-found: error
+          path: dist/ENTITY-Wallet-iOS-Simulator.zip

ENTITY_CURRENT_RELEASE_ORIGIN.json

@@ -0,0 +1,29 @@
+{
+  "body": {
+    "asset_provenance_is_separate_from_protocol_origin": true,
+    "automatic_protocol_royalty_bps": 0,
+    "created_at_ms": 1791032742763,
+    "economic_participation_requires_explicit_terms": true,
+    "historical_release_is_immutable_target": true,
+    "origin_lineage_id": "entity-origin:shawn-btg-entity@1.0",
+    "origin_lineage_sha256": "9d3bdc0ef2e6a27de5368541f6bc014fdec93b2c7af9770d163c804521b9efff",
+    "protocol_entity_id": "ent2-m3nofxtv3zwldhwuonw3h67hqjh2zambrhj4kaaulncpt4amkcua",
+    "release_commit_sha1": "528b70aabd05b1e930b77e4933f157731e47274f",
+    "release_ref": "entity-release:v3.4.3",
+    "release_tag": "v3.4.3",
+    "release_tree_sha1": "f13e42f515dcc4cd985e9b832e0ecfec416ce423",
+    "root_originator_entity_id": "ent2-6eoiiztjyhmyh2tbr5psmofcduwvjledubhoiqwo6mjfoqkn6ica",
+    "schema": "entity-protocol-release-origin-v1",
+    "steward_entity_id": "ent2-kkov66eoh23h3zgr4pe4njsbkayn2kxad6vfyirqvuqrty52clpa"
+  },
+  "body_sha256": "150c4e02671b2175a45df921fcf6761119a6c587001c9b8fa039dd01ffe0e494",
+  "signature": {
+    "entity_id": "ent2-m3nofxtv3zwldhwuonw3h67hqjh2zambrhj4kaaulncpt4amkcua",
+    "key_id": "sig-a31ded371cfb5019",
+    "payload_sha256": "150c4e02671b2175a45df921fcf6761119a6c587001c9b8fa039dd01ffe0e494",
+    "signature": "cWSubQ8c3pJiZQArSlffOAZMlMfSkn6lb3lNDpWSv2Ol05zDY9Z0do7FoLu6GoBwf1xOZDIV6ekh6IHAhInsBg",
+    "signature_schema": "entity-signature-record-v2",
+    "signed_at_ms": 1791032742806,
+    "suite": "ENTITY-SIG-ED25519-v1"
+  }
+}

ENTITY_CURRENT_RELEASE_ORIGIN.json.sha256

@@ -0,0 +1 @@
+aa4d7b32778bda263c097a8a46a3f654070b0ae48f3142664bfe485e6ce04c17  ENTITY_CURRENT_RELEASE_ORIGIN.json

ENTITY_V3_EEP_CONFORMANCE_MANIFEST.json

@@ -1,106 +1,106 @@
-{
-  "based_on_local_commit": "68179328a2b87408af93a5caa1c64312e70247be",
-  "claim_boundaries": [
-    "development conformance evidence is not a released protocol qualification",
-    "signature cryptography remains governed by the ENTITY identity layer",
-    "stateful market authorization and signature verification are tested by executable campaigns in addition to schema vectors",
-    "external independent EEP clean-room interoperability remains pending"
-  ],
-  "conformance": {
-    "complete_active_tree": {
-      "passed": 90,
-      "total": 90
-    },
-    "json_schema_draft": "2020-12",
-    "record_definitions": 13,
-    "reference_mirror_convergence_tests": {
-      "passed": 16,
-      "total": 16
-    },
-    "schema_and_vector_tests": {
-      "passed": 4,
-      "total": 4
-    },
-    "signed_wire_schemas": 11,
-    "validator_chain": [
-      "JSON_SCHEMA_DRAFT_2020_12",
-      "ENTITY_CANONICAL_SIGNED_WIRE_RULES"
-    ],
-    "vectors_expected_invalid": 14,
-    "vectors_expected_valid": 13,
-    "vectors_total": 27
-  },
-  "created_date": "2026-09-23",
-  "files": [
-    {
-      "path": "src/31_Profiles/exchange_protocol.py",
-      "sha256": "53761f15c7ae58726ce8cd01a28164d3a14ae29aac38a89859c408fc3c76b14a"
-    },
-    {
-      "path": "src/32_V3_Hardening/exchange_protocol.py",
-      "sha256": "767e2a83a7ab5a71256c4f9535b75d91e7d33c97aaa7b7cefc617ffa7874bf41"
-    },
-    {
-      "path": "protocol/v3/ENTITY_EXCHANGE_PROTOCOL_DRAFT.md",
-      "sha256": "1733dcf2055a4353abd611344582438a04cbae08b358451290885697c665dbd7"
-    },
-    {
-      "path": "protocol/v3/ENTITY_EXCHANGE_PROTOCOL.schema.json",
-      "sha256": "146932a4598797e295ad7d86ac3ee3ee80261fc1675b1bfb4724df0e05fa3218"
-    },
-    {
-      "path": "protocol/v3/eep_vectors/VECTOR_MANIFEST.json",
-      "sha256": "08fe381309dc122e0efb8544490e23287e53b3d37cea868b5cd359cc736c4b53"
-    },
-    {
-      "path": "protocol/v3/eep_vectors/SHA256SUMS.txt",
-      "sha256": "68989a573a74046e55d6b2713f9fdee8304d8b709d22dd5ccd17f32791d927b7"
-    },
-    {
-      "path": "protocol/v3/eep_vectors/README.md",
-      "sha256": "ff734344b2be9e523109c677b4aa746b19eb7e505bd4ba01be8f11ef44ca030e"
-    },
-    {
-      "path": "tests/test_v3_eep_conformance.py",
-      "sha256": "d832cc585662a8722bb3ac95763c6f487285983818794a314826792a6c11390f"
-    },
-    {
-      "path": "tests/test_v3_exchange_convergence.py",
-      "sha256": "079767d481e2dd09582bbf8b5e97a0ea4334d3fe06acbcc32e99c03caddf29fd"
-    },
-    {
-      "path": "tests/test_v3_hardening_exchange.py",
-      "sha256": "f7a7ecf9fa7d748d3953eb68c426945273c42fcf3a952048f21f0def773ecd17"
-    },
-    {
-      "path": "requirements.txt",
-      "sha256": "ba36584e5af40e46435d63315f94fb6d600e3d18af53d123e321763f98f22668"
-    },
-    {
-      "path": "tools/run_v3_regression.ps1",
-      "sha256": "0bc9f4acc6d1fb8b6b274c305bd89750b78e68ad5568887ee46a577385d5f5f9"
-    }
-  ],
-  "invariants": [
-    "signed wire values are not silently normalized after signature verification",
-    "JSON integer fields reject numeric strings and booleans",
-    "enumerated tokens and usage actions are canonical uppercase",
-    "SHA-256 values are canonical lowercase hexadecimal",
-    "rights action lists are non-empty, unique, and lexicographically sorted",
-    "revenue allocations do not exceed 10000 basis points",
-    "RFQ and quote expiry follows signed creation time",
-    "entitlement expiry semantics converge across reference and qualification mirror",
-    "executed but unsettled sell quantities remain reserved until clearing completes",
-    "trade revenue allocation is bound at execution and is not changed by later rule-set mutation",
-    "sell admission rechecks unreserved entitlement atomically under concurrent submissions",
-    "concurrent matchers cannot create duplicate trades from the same executable orders",
-    "concurrent settlement attempts commit at most one entitlement transfer",
-    "revenue-event persistence is atomic with hardening-profile settlement state",
-    "RFQ executions preserve a deterministic venue-signed source binding to signed RFQ, quote and acceptance records"
-  ],
-  "schema": "entity-v3-eep-conformance-manifest-v1",
-  "snapshot_sha256": "65224aa97bde5456c4079097a37284ce6e023f3e1c635f25456683c74e3df91a",
-  "status": "BTG_INTERNAL_QUALIFIED_RELEASE_COMPONENT",
-  "version": "3.0.0",
-  "working_tree_snapshot": false
-}
+{
+  "based_on_local_commit": "dedd47eb032b5a95d88f092cf3346298ca3011eb",
+  "claim_boundaries": [
+    "development conformance evidence is not a released protocol qualification",
+    "signature cryptography remains governed by the ENTITY identity layer",
+    "stateful market authorization and signature verification are tested by executable campaigns in addition to schema vectors",
+    "external independent EEP clean-room interoperability remains pending"
+  ],
+  "conformance": {
+    "complete_active_tree": {
+      "passed": 90,
+      "total": 90
+    },
+    "json_schema_draft": "2020-12",
+    "record_definitions": 13,
+    "reference_mirror_convergence_tests": {
+      "passed": 16,
+      "total": 16
+    },
+    "schema_and_vector_tests": {
+      "passed": 4,
+      "total": 4
+    },
+    "signed_wire_schemas": 11,
+    "validator_chain": [
+      "JSON_SCHEMA_DRAFT_2020_12",
+      "ENTITY_CANONICAL_SIGNED_WIRE_RULES"
+    ],
+    "vectors_expected_invalid": 14,
+    "vectors_expected_valid": 13,
+    "vectors_total": 27
+  },
+  "created_date": "2026-09-23",
+  "files": [
+    {
+      "path": "src/31_Profiles/exchange_protocol.py",
+      "sha256": "fa3c040b31d9cfd7ab37daddeb2c904f52f03a4fc110d77bdd8067fa1b9d547b"
+    },
+    {
+      "path": "src/32_V3_Hardening/exchange_protocol.py",
+      "sha256": "767e2a83a7ab5a71256c4f9535b75d91e7d33c97aaa7b7cefc617ffa7874bf41"
+    },
+    {
+      "path": "protocol/v3/ENTITY_EXCHANGE_PROTOCOL_DRAFT.md",
+      "sha256": "1733dcf2055a4353abd611344582438a04cbae08b358451290885697c665dbd7"
+    },
+    {
+      "path": "protocol/v3/ENTITY_EXCHANGE_PROTOCOL.schema.json",
+      "sha256": "146932a4598797e295ad7d86ac3ee3ee80261fc1675b1bfb4724df0e05fa3218"
+    },
+    {
+      "path": "protocol/v3/eep_vectors/VECTOR_MANIFEST.json",
+      "sha256": "08fe381309dc122e0efb8544490e23287e53b3d37cea868b5cd359cc736c4b53"
+    },
+    {
+      "path": "protocol/v3/eep_vectors/SHA256SUMS.txt",
+      "sha256": "68989a573a74046e55d6b2713f9fdee8304d8b709d22dd5ccd17f32791d927b7"
+    },
+    {
+      "path": "protocol/v3/eep_vectors/README.md",
+      "sha256": "ff734344b2be9e523109c677b4aa746b19eb7e505bd4ba01be8f11ef44ca030e"
+    },
+    {
+      "path": "tests/test_v3_eep_conformance.py",
+      "sha256": "d832cc585662a8722bb3ac95763c6f487285983818794a314826792a6c11390f"
+    },
+    {
+      "path": "tests/test_v3_exchange_convergence.py",
+      "sha256": "079767d481e2dd09582bbf8b5e97a0ea4334d3fe06acbcc32e99c03caddf29fd"
+    },
+    {
+      "path": "tests/test_v3_hardening_exchange.py",
+      "sha256": "f7a7ecf9fa7d748d3953eb68c426945273c42fcf3a952048f21f0def773ecd17"
+    },
+    {
+      "path": "requirements.txt",
+      "sha256": "ba36584e5af40e46435d63315f94fb6d600e3d18af53d123e321763f98f22668"
+    },
+    {
+      "path": "tools/run_v3_regression.ps1",
+      "sha256": "0bc9f4acc6d1fb8b6b274c305bd89750b78e68ad5568887ee46a577385d5f5f9"
+    }
+  ],
+  "invariants": [
+    "signed wire values are not silently normalized after signature verification",
+    "JSON integer fields reject numeric strings and booleans",
+    "enumerated tokens and usage actions are canonical uppercase",
+    "SHA-256 values are canonical lowercase hexadecimal",
+    "rights action lists are non-empty, unique, and lexicographically sorted",
+    "revenue allocations do not exceed 10000 basis points",
+    "RFQ and quote expiry follows signed creation time",
+    "entitlement expiry semantics converge across reference and qualification mirror",
+    "executed but unsettled sell quantities remain reserved until clearing completes",
+    "trade revenue allocation is bound at execution and is not changed by later rule-set mutation",
+    "sell admission rechecks unreserved entitlement atomically under concurrent submissions",
+    "concurrent matchers cannot create duplicate trades from the same executable orders",
+    "concurrent settlement attempts commit at most one entitlement transfer",
+    "revenue-event persistence is atomic with hardening-profile settlement state",
+    "RFQ executions preserve a deterministic venue-signed source binding to signed RFQ, quote and acceptance records"
+  ],
+  "schema": "entity-v3-eep-conformance-manifest-v1",
+  "snapshot_sha256": "5d9ad374f4bfdce3181166a057d18b8bcca0ad966a1518f461967ad2a23ef18f",
+  "status": "BTG_INTERNAL_QUALIFIED_RELEASE_COMPONENT",
+  "version": "3.0.0",
+  "working_tree_snapshot": false
+}