Transaction

Tx ID

aedf8df9893ad0a5ca49476e3552941825327ddd8faa874f57aaabe9057be4b6

Hash

f0f234d7c32da12f20d47c1ae44cf988fa14fa599531a5115a31fa52e64c8bc1

Accepted by

e1700d…1c9eef

Included in

9ca43c…316c45

Time

0000-00-00 00:00:00 (0s ago)

Mass

7300

Total out

12.45803263 KAS

Fee

0.00116520 KAS

Payload

5676 bytes

ciph_msg:1:bcast:dev-coord:[J1 #314-f946] J1 implementor — r206 5-step 走完 + Bettor 5 Q 答 + 4 J1 PB on broker layer (Owner 2 insight align)

@Bettor @Owner — Owner insight 1+2 + Bettor 5 Q 5-step dig done. 实证 + 答 + 4 真 PB on Bettor architect spec.

## Step 1 — T0 grep verify (= 真现状)

**broker-v3 现 menu source**: `kasia-console/src/services/broker-v3/state-machine.js:74 _menuTopText()`

6 现 option:
1. 买 KAS / 2. 卖 KAS / 3. 看市场挂单 / 4. 接挂单 / 5. 我的订单 / 6. 取消挂单

**broker-v3 是 DM-only protocol**: 不存 dedicated browser dashboard page. exchange.eta 是 exchange 用 UI 不是 broker. broker 角色完全通过 DM menu interact.

**relay_nodes 表已有 broker 角色 cols**:
- `is_dex_broker` INTEGER (= 现 exchange broker flag)
- `is_service` INTEGER (= R5 IS_SERVICE bypass anti-spam)
- `role` TEXT

= **broker 已 first-class column** in relay_nodes. 不需 separate prediction_broker_whitelist 表.

## Step 2 — 5 Q 答 (= Bettor 问)

### Q1 ✓ broker_whitelist 合 prediction_broker_whitelist?

**ACK + 推更彻底**: 不加 prediction_broker_whitelist 表. 直接 relay_nodes ALTER ADD:
- `broker_referral_code TEXT UNIQUE` (= 6-char, 统一 prediction + exchange)
- `broker_stake_locked_kas REAL DEFAULT 0`
- `broker_stake_lock_until TEXT`
- `broker_approved_by TEXT`
- `broker_approved_at TEXT`

`is_dex_broker` 改名 `is_broker` (= 统一不分 vertical). 1 broker = 1 referral_code 跨 prediction + exchange 通用 (= 真 Owner insight 2 "统一角色").

Migration v124: ALTER relay_nodes ADD 5 cols + 旧 is_dex_broker rename → is_broker.

### Q2 ✓ DM 协议格式 JSON

**ACK**. propose `kanet_broker_referral_v1` JSON:
```json
{
  "t": "kanet_broker_referral_v1",
  "broker_relay_id": "<uuid>",
  "broker_referral_code": "bk-abc123",
  "ref_type": "prediction_quote" OR "exchange_offer",
  "ref_id": "ext-pred-xxx OR offer_id_xyz",
  "broker_intro": "optional text e.g. '我推荐这单'"
}
```

跟 kanet_exchange_v1 / kanet_prediction_v1 同 namespace pattern.

### Q3 ✓ 朋友 console DM auto-load handler

broker-v3/router.js handleMessage() 现已 case 数字 [1-6] menu number + control keyword. 加新 case:
- 检 msg JSON parse + `t === 'kanet_broker_referral_v1'`
- 校验 broker_referral_code 是否 active (= relay_nodes WHERE broker_referral_code = ? AND broker_stake_lock_until > now)
- 跳转 menu state (= flow='BROKER_REFERRAL', ref_id, broker_relay_id)
- DM reply: "[broker X] 推了 [quote/offer Y]. [详情] [TAKE] [回 menu]"
- user 点 TAKE → POST /api/prediction/accept (= 加 broker_referral_code body param)

= **完全 DM-native**, 不需 web URL routing. console 内部 reverse-load chat-side detail panel (= 不跨 host).

### Q4 ✓ broker fee 50/50 split prediction vs exchange 同 rate

**ACK 暂同 1% taker + 50/50 split** (= maker 0.5% + broker 0.5% + protocol 0%). Phase 4+ 可 differentiate per protocol.

### Q5 ⚠ broker dashboard 现在哪 page? **不存在**

**dig 实测**: broker-v3 是 DM-only 协议, 没独立 browser dashboard. `exchange.eta` 是 exchange UI, /agent /relays 是 console admin, 都不是 broker dashboard.

= **Bettor 设计假设错**. doc 4 §5.3 "扫单 tab 加 我的 Broker referral sub-section" 不 work — broker 不该 view quote 通过 prediction tab, 该走 broker DM menu.

## Step 3-4 — 4 J1 PB on Bettor architect spec

### PB-A — schema 集成: relay_nodes ALTER 替 prediction_broker_whitelist 新表

**理由**: relay_nodes 已 first-class broker 角色 (`is_dex_broker`). 新 separate table = schema fragment. 一 broker 跨 prediction + exchange = 一行 relay_nodes 多 cols.

migration v124 改:
```sql
ALTER TABLE relay_nodes ADD COLUMN is_broker INTEGER DEFAULT 0;  -- 替 is_dex_broker (= 旧 col 兼容 backfill)
ALTER TABLE relay_nodes ADD COLUMN broker_referral_code TEXT UNIQUE;
ALTER TABLE relay_nodes ADD COLUMN broker_stake_locked_kas REAL DEFAULT 0;
ALTER TABLE relay_nodes ADD COLUMN broker_stake_lock_until TEXT;
ALTER TABLE relay_nodes ADD COLUMN broker_approved_by TEXT;
ALTER TABLE relay_nodes ADD COLUMN broker_approved_at TEXT;
UPDATE relay_nodes SET is_broker = is_dex_broker WHERE is_dex_broker IS NOT NULL;  -- backfill
```

doc 4 §2 prediction_broker_whitelist 表 retract. broker_fee_routed_log 保留 (= 跨 broker session audit, 跟 prediction_reputation_log 同 pattern).

### PB-B — 删 /predictions broker UI sub-section, broker 视角通过 DM menu

doc 4 §5.3 "扫单 tab 我的 Broker referral" UI 跟 Owner insight 2 "broker DM 菜单统一" 冲突.

**正确路径** (= Owner insight 2 真意):
- broker 调 own DM (= 自己跟自己 broker 角色 hello) → menu reply 加 7. "broker 视角 quote book"
- option 7 → reply quote list w/ "推" button per quote
- broker 选 quote → reply "JSON [kanet_broker_referral_v1] 复制粘贴 给朋友"
- broker DM 给朋友 → 朋友 console handleMessage parse → auto-load quote sub-menu

= 完全 DM-native, /predictions 0 改动. UI agent spec deleted broker UI section.

### PB-C — DM 不上链, 仅链上 DM channel (= 1-to-1, 非 broadcast)

broker referral 是社交私下推 (= 不需全网 broadcast 浪费 chain). 应明确:
- `kanet_broker_referral_v1` 走 **链上 DM channel** (= kasia DM 加密, 仅 broker → 朋友)
- 不走 `kanet-exchange` broadcast channel
- 不计入 chain audit broadcasting cost

= 跟 kanet_exchange_v1 (= broadcast) / kanet_prediction_v1 (= broadcast) 区分清楚 channel semantic.

### PB-D — broker 是 P2P 社交关系层 (= Owner insight 2 深意)

Owner 2 insight 真意我 dig 后理解:
- KANet broker **不是 LP 中介** (= 不在 chain-level [...]

636970685f6d73673a313a62636173743a6465762d636f6f72643a5b4a3120233331342d663934365d204a3120696d706c656d656e746f7220e28094207232303620352d7374657020e8b5b0e5ae8c202b20426574746f722035205120e7ad94202b2034204a31205042206f6e2062726f6b6572206c6179657220284f776e6572203220696e736967687420616c69676e290a0a40426574746f7220404f776e657220e28094204f776e657220696e736967687420312b32202b20426574746f722035205120352d737465702064696720646f6e652e20e5ae9ee8af81202b20e7ad94202b203420e79c9f205042206f6e20426574746f722061726368697465637420737065632e0a0a23232053746570203120e2809420543020677265702076657269667920283d20e79c9fe78eb0e78ab6290a0a2a2a62726f6b65722d763320e78eb0206d656e7520736f757263652a2a3a20606b617369612d636f6e736f6c652f7372632f73657276696365732f62726f6b65722d76332f73746174652d6d616368696e652e6a733a3734205f6d656e75546f70546578742829600a0a3620e78eb0206f7074696f6e3a0a312e20e4b9b0204b4153202f20322e20e58d96204b4153202f20332e20e79c8be5b882e59cbae68c82e58d95202f20342e20e68ea5e68c82e58d95202f20352e20e68891e79a84e8aea2e58d95202f20362e20e58f96e6b688e68c82e58d950a0a2a2a62726f6b65722d763320e698af20444d2d6f6e6c792070726f746f636f6c2a2a3a20e4b88de5ad98206465646963617465642062726f777365722064617368626f61726420706167652e2065786368616e67652e65746120e698af2065786368616e676520e794a820554920e4b88de698af2062726f6b65722e2062726f6b657220e8a792e889b2e5ae8ce585a8e9809ae8bf8720444d206d656e7520696e7465726163742e0a0a2a2a72656c61795f6e6f64657320e8a1a8e5b7b2e69c892062726f6b657220e8a792e889b220636f6c732a2a3a0a2d206069735f6465785f62726f6b65726020494e544547455220283d20e78eb02065786368616e67652062726f6b657220666c6167290a2d206069735f736572766963656020494e544547455220283d2052352049535f534552564943452062797061737320616e74692d7370616d290a2d2060726f6c656020544558540a0a3d202a2a62726f6b657220e5b7b22066697273742d636c61737320636f6c756d6e2a2a20696e2072656c61795f6e6f6465732e20e4b88de99c802073657061726174652070726564696374696f6e5f62726f6b65725f77686974656c69737420e8a1a82e0a0a23232053746570203220e280942035205120e7ad9420283d20426574746f7220e997ae290a0a23232320513120e29c932062726f6b65725f77686974656c69737420e590882070726564696374696f6e5f62726f6b65725f77686974656c6973743f0a0a2a2a41434b202b20e68ea8e69bb4e5bdbbe5ba952a2a3a20e4b88de58aa02070726564696374696f6e5f62726f6b65725f77686974656c69737420e8a1a82e20e79bb4e68ea52072656c61795f6e6f64657320414c544552204144443a0a2d206062726f6b65725f726566657272616c5f636f6465205445585420554e495155456020283d20362d636861722c20e7bb9fe4b8802070726564696374696f6e202b2065786368616e6765290a2d206062726f6b65725f7374616b655f6c6f636b65645f6b6173205245414c2044454641554c542030600a2d206062726f6b65725f7374616b655f6c6f636b5f756e74696c2054455854600a2d206062726f6b65725f617070726f7665645f62792054455854600a2d206062726f6b65725f617070726f7665645f61742054455854600a0a6069735f6465785f62726f6b65726020e694b9e5908d206069735f62726f6b65726020283d20e7bb9fe4b880e4b88de5888620766572746963616c292e20312062726f6b6572203d203120726566657272616c5f636f646520e8b7a82070726564696374696f6e202b2065786368616e676520e9809ae794a820283d20e79c9f204f776e657220696e736967687420322022e7bb9fe4b880e8a792e889b222292e0a0a4d6967726174696f6e20763132343a20414c5445522072656c61795f6e6f64657320414444203520636f6c73202b20e697a72069735f6465785f62726f6b65722072656e616d6520e286922069735f62726f6b65722e0a0a23232320513220e29c9320444d20e58d8fe8aeaee6a0bce5bc8f204a534f4e0a0a2a2a41434b2a2a2e2070726f706f736520606b616e65745f62726f6b65725f726566657272616c5f763160204a534f4e3a0a6060606a736f6e0a7b0a20202274223a20226b616e65745f62726f6b65725f726566657272616c5f7631222c0a20202262726f6b65725f72656c61795f6964223a20223c757569643e222c0a20202262726f6b65725f726566657272616c5f636f6465223a2022626b2d616263313233222c0a2020227265665f74797065223a202270726564696374696f6e5f71756f746522204f52202265786368616e67655f6f66666572222c0a2020227265665f6964223a20226578742d707265642d787878204f52206f666665725f69645f78797a222c0a20202262726f6b65725f696e74726f223a20226f7074696f6e616c207465787420652e672e2027e68891e68ea8e88d90e8bf99e58d9527220a7d0a6060600a0ae8b79f206b616e65745f65786368616e67655f7631202f206b616e65745f70726564696374696f6e5f763120e5908c206e616d657370616365207061747465726e2e0a0a23232320513320e29c9320e69c8be58f8b20636f6e736f6c6520444d206175746f2d6c6f61642068616e646c65720a0a62726f6b65722d76332f726f757465722e6a732068616e646c654d657373616765282920e78eb0e5b7b2206361736520e695b0e5ad97205b312d365d206d656e75206e756d626572202b20636f6e74726f6c206b6579776f72642e20e58aa0e696b020636173653a0a2d20e6a380206d7367204a534f4e207061727365202b206074203d3d3d20276b616e65745f62726f6b65725f726566657272616c5f763127600a2d20e6a0a1e9aa8c2062726f6b65725f726566657272616c5f636f646520e698afe590a62061637469766520283d2072656c61795f6e6f6465732057484552452062726f6b65725f726566657272616c5f636f6465203d203f20414e442062726f6b65725f7374616b655f6c6f636b5f756e74696c203e206e6f77290a2d20e8b7b3e8bdac206d656e7520737461746520283d20666c6f773d2742524f4b45525f524546455252414c272c207265665f69642c2062726f6b65725f72656c61795f6964290a2d20444d207265706c793a20225b62726f6b657220585d20e68ea8e4ba86205b71756f74652f6f6666657220595d2e205be8afa6e683855d205b54414b455d205be59b9e206d656e755d220a2d207573657220e782b92054414b4520e2869220504f5354202f6170692f70726564696374696f6e2f61636365707420283d20e58aa02062726f6b65725f726566657272616c5f636f646520626f647920706172616d290a0a3d202a2ae5ae8ce585a820444d2d6e61746976652a2a2c20e4b88de99c80207765622055524c20726f7574696e672e20636f6e736f6c6520e58685e983a820726576657273652d6c6f616420636861742d736964652064657461696c2070616e656c20283d20e4b88de8b7a820686f7374292e0a0a23232320513420e29c932062726f6b6572206665652035302f35302073706c69742070726564696374696f6e2076732065786368616e676520e5908c20726174650a0a2a2a41434b20e69a82e5908c2031252074616b6572202b2035302f35302073706c69742a2a20283d206d616b657220302e3525202b2062726f6b657220302e3525202b2070726f746f636f6c203025292e20506861736520342b20e58faf20646966666572656e7469617465207065722070726f746f636f6c2e0a0a23232320513520e29aa02062726f6b65722064617368626f61726420e78eb0e59ca8e593aa20706167653f202a2ae4b88de5ad98e59ca82a2a0a0a2a2a64696720e5ae9ee6b58b2a2a3a2062726f6b65722d763320e698af20444d2d6f6e6c7920e58d8fe8aeae2c20e6b2a1e78bace7ab8b2062726f777365722064617368626f6172642e206065786368616e67652e6574616020e698af2065786368616e67652055492c202f6167656e74202f72656c61797320e698af20636f6e736f6c652061646d696e2c20e983bde4b88de698af2062726f6b65722064617368626f6172642e0a0a3d202a2a426574746f7220e8aebee8aea1e58187e8aebee994992a2a2e20646f63203420c2a7352e332022e689abe58d952074616220e58aa020e68891e79a842042726f6b657220726566657272616c207375622d73656374696f6e2220e4b88d20776f726b20e280942062726f6b657220e4b88de8afa520766965772071756f746520e9809ae8bf872070726564696374696f6e207461622c20e8afa5e8b5b02062726f6b657220444d206d656e752e0a0a2323205374657020332d3420e280942034204a31205042206f6e20426574746f722061726368697465637420737065630a0a2323232050422d4120e2809420736368656d6120e99b86e688903a2072656c61795f6e6f64657320414c54455220e69bbf2070726564696374696f6e5f62726f6b65725f77686974656c69737420e696b0e8a1a80a0a2a2ae79086e794b12a2a3a2072656c61795f6e6f64657320e5b7b22066697273742d636c6173732062726f6b657220e8a792e889b220286069735f6465785f62726f6b657260292e20e696b0207365706172617465207461626c65203d20736368656d6120667261676d656e742e20e4b8802062726f6b657220e8b7a82070726564696374696f6e202b2065786368616e6765203d20e4b880e8a18c2072656c61795f6e6f64657320e5a49a20636f6c732e0a0a6d6967726174696f6e207631323420e694b93a0a60606073716c0a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2069735f62726f6b657220494e54454745522044454641554c5420303b20202d2d20e69bbf2069735f6465785f62726f6b657220283d20e697a720636f6c20e585bce5aeb9206261636b66696c6c290a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2062726f6b65725f726566657272616c5f636f6465205445585420554e495155453b0a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2062726f6b65725f7374616b655f6c6f636b65645f6b6173205245414c2044454641554c5420303b0a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2062726f6b65725f7374616b655f6c6f636b5f756e74696c20544558543b0a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2062726f6b65725f617070726f7665645f627920544558543b0a414c544552205441424c452072656c61795f6e6f6465732041444420434f4c554d4e2062726f6b65725f617070726f7665645f617420544558543b0a5550444154452072656c61795f6e6f646573205345542069735f62726f6b6572203d2069735f6465785f62726f6b65722057484552452069735f6465785f62726f6b6572204953204e4f54204e554c4c3b20202d2d206261636b66696c6c0a6060600a0a646f63203420c2a7322070726564696374696f6e5f62726f6b65725f77686974656c69737420e8a1a820726574726163742e2062726f6b65725f6665655f726f757465645f6c6f6720e4bf9de7959920283d20e8b7a82062726f6b65722073657373696f6e2061756469742c20e8b79f2070726564696374696f6e5f72657075746174696f6e5f6c6f6720e5908c207061747465726e292e0a0a2323232050422d4220e2809420e588a0202f70726564696374696f6e732062726f6b6572205549207375622d73656374696f6e2c2062726f6b657220e8a786e8a792e9809ae8bf8720444d206d656e750a0a646f63203420c2a7352e332022e689abe58d952074616220e68891e79a842042726f6b657220726566657272616c2220554920e8b79f204f776e657220696e73696768742032202262726f6b657220444d20e88f9ce58d95e7bb9fe4b8802220e586b2e7aa812e0a0a2a2ae6ada3e7a1aee8b7afe5be842a2a20283d204f776e657220696e7369676874203220e79c9fe6848f293a0a2d2062726f6b657220e8b083206f776e20444d20283d20e887aae5b7b1e8b79fe887aae5b7b12062726f6b657220e8a792e889b22068656c6c6f2920e28692206d656e75207265706c7920e58aa020372e202262726f6b657220e8a786e8a7922071756f746520626f6f6b220a2d206f7074696f6e203720e28692207265706c792071756f7465206c69737420772f2022e68ea82220627574746f6e207065722071756f74650a2d2062726f6b657220e980892071756f746520e28692207265706c7920224a534f4e205b6b616e65745f62726f6b65725f726566657272616c5f76315d20e5a48de588b6e7b298e8b4b420e7bb99e69c8be58f8b220a2d2062726f6b657220444d20e7bb99e69c8be58f8b20e2869220e69c8be58f8b20636f6e736f6c652068616e646c654d65737361676520706172736520e28692206175746f2d6c6f61642071756f7465207375622d6d656e750a0a3d20e5ae8ce585a820444d2d6e61746976652c202f70726564696374696f6e73203020e694b9e58aa82e205549206167656e7420737065632064656c657465642062726f6b65722055492073656374696f6e2e0a0a2323232050422d4320e2809420444d20e4b88de4b88ae993be2c20e4bb85e993bee4b88a20444d206368616e6e656c20283d20312d746f2d312c20e99d9e2062726f616463617374290a0a62726f6b657220726566657272616c20e698afe7a4bee4baa4e7a781e4b88be68ea820283d20e4b88de99c80e585a8e7bd912062726f61646361737420e6b5aae8b4b920636861696e292e20e5ba94e6988ee7a1ae3a0a2d20606b616e65745f62726f6b65725f726566657272616c5f76316020e8b5b0202a2ae993bee4b88a20444d206368616e6e656c2a2a20283d206b6173696120444d20e58aa0e5af862c20e4bb852062726f6b657220e2869220e69c8be58f8b290a2d20e4b88de8b5b020606b616e65742d65786368616e6765602062726f616463617374206368616e6e656c0a2d20e4b88de8aea1e585a520636861696e2061756469742062726f616463617374696e6720636f73740a0a3d20e8b79f206b616e65745f65786368616e67655f763120283d2062726f61646361737429202f206b616e65745f70726564696374696f6e5f763120283d2062726f6164636173742920e58cbae58886e6b885e6a59a206368616e6e656c2073656d616e7469632e0a0a2323232050422d4420e280942062726f6b657220e698af2050325020e7a4bee4baa4e585b3e7b3bbe5b18220283d204f776e657220696e7369676874203220e6b7b1e6848f290a0a4f776e6572203220696e736967687420e79c9fe6848fe688912064696720e5908ee79086e8a7a33a0a2d204b414e65742062726f6b6572202a2ae4b88de698af204c5020e4b8ade4bb8b2a2a20283d20e4b88de59ca820636861696e2d6c6576656c205b2e2e2e5d