@seasonkoh/webaz 0.1.5 → 0.1.7

package/dist/layer1-agent/L1-1-mcp-server/server.js

@@ -227,7 +227,7 @@ action 说明：
 ruling 裁定选项（arbitrate 时使用）：
 - refund_buyer：全额退款给买家，扣押卖家部分保证金
 - release_seller：资金释放给卖家（卖家胜诉）
-- partial_refund：部分退款（需指定 refund_amount）`,
+- partial_refund：部分退款（需指定 refund_amount）；若责任在第三方（如物流），同时指定 liable_party（责任方 user_id），此时卖家全额结算，赔偿金从责任方扣除`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -247,6 +247,7 @@ ruling 裁定选项（arbitrate 时使用）：
                     description: '裁定结果（arbitrate 时必填）',
                 },
                 refund_amount: { type: 'number', description: '部分退款金额，仅 ruling=partial_refund 时使用' },
+                liable_party: { type: 'string', description: '第三方责任方 user_id（partial_refund 时可选）：指定后赔偿金从该方扣除，卖家全额结算' },
                 ruling_reason: { type: 'string', description: '裁定理由（arbitrate 时必填，将永久记录在链上）' },
             },
             required: ['api_key', 'action'],
@@ -590,23 +591,24 @@ function handleUpdateOrder(args) {
     const notes = args.notes ?? '';
     const evidenceDesc = args.evidence_description ?? '';
     // 验证订单存在且该用户是参与方
-    const order = db
+    let order = db
         .prepare('SELECT * FROM orders WHERE id = ?')
         .get(orderId);
     if (!order)
         return { error: `订单不存在：${orderId}` };
+    // 物流首次操作：先绑定再做参与方检查
+    if ((action === 'pickup' || action === 'transit') &&
+        !order.logistics_id &&
+        user.role === 'logistics') {
+        db.prepare('UPDATE orders SET logistics_id = ? WHERE id = ?').run(user.id, orderId);
+        order = db.prepare('SELECT * FROM orders WHERE id = ?').get(orderId);
+    }
     const isParticipant = order.buyer_id === user.id ||
         order.seller_id === user.id ||
         order.logistics_id === user.id;
     if (!isParticipant && user.role !== 'arbitrator') {
         return { error: '你不是这笔订单的参与方，无法操作' };
     }
-    // 如果是物流首次操作，绑定物流方
-    if ((action === 'pickup' || action === 'transit') &&
-        order.logistics_id === null &&
-        user.role === 'logistics') {
-        db.prepare('UPDATE orders SET logistics_id = ? WHERE id = ?').run(user.id, orderId);
-    }
     // action → 状态映射
     const actionMap = {
         accept: 'accepted',
@@ -865,7 +867,7 @@ function handleDispute(args) {
         if (args.ruling === 'partial_refund' && !args.refund_amount) {
             return { error: 'partial_refund 需要提供 refund_amount' };
         }
-        const result = arbitrateDispute(db, args.dispute_id, user.id, args.ruling, args.ruling_reason, args.refund_amount);
+        const result = arbitrateDispute(db, args.dispute_id, user.id, args.ruling, args.ruling_reason, args.refund_amount, undefined, args.liable_party);
         // L4-3 争议声誉：裁定完成后更新声誉
         if (result.success) {
             const dispute = getDisputeDetails(db, args.dispute_id);

package/dist/layer3-trust/L3-1-dispute-engine/dispute-engine.js

@@ -143,7 +143,8 @@ export function respondToDispute(db, disputeId, responderId, notes, evidenceIds)
         message: '反驳证据已提交，争议进入仲裁阶段。仲裁员将在 72 小时内做出裁定。',
     };
 }
-export function arbitrateDispute(db, disputeId, arbitratorId, ruling, reason, refundAmount, liabilityParties) {
+export function arbitrateDispute(db, disputeId, arbitratorId, ruling, reason, refundAmount, liabilityParties, liablePartyId // 指定责任方 user_id（用于 partial_refund 第三方责任场景）
+) {
     const dispute = db.prepare('SELECT * FROM disputes WHERE id = ?').get(disputeId);
     if (!dispute)
         return { success: false, error: `争议不存在：${disputeId}` };
@@ -159,10 +160,10 @@ export function arbitrateDispute(db, disputeId, arbitratorId, ruling, reason, re
     // 执行资金处置
     const settlement = ruling === 'liability_split' && liabilityParties
         ? executeLiabilitySplit(db, dispute.order_id, liabilityParties, refundAmount)
-        : executeSettlement(db, dispute.order_id, ruling, refundAmount);
+        : executeSettlement(db, dispute.order_id, ruling, refundAmount, liablePartyId);
     if (!settlement.success)
         return { success: false, error: settlement.error };
-    // 收取仲裁费（败诉方付 1%，最低 1 WAZ）
+    // 收取仲裁费（败诉/责任方付 1%，最低 1 WAZ）
     const order = db.prepare('SELECT total_amount, buyer_id, seller_id FROM orders WHERE id = ?')
         .get(dispute.order_id);
     const sysUser = db.prepare("SELECT id FROM users WHERE id = 'sys_protocol'").get();
@@ -170,29 +171,35 @@ export function arbitrateDispute(db, disputeId, arbitratorId, ruling, reason, re
     if (order) {
         const amt = order.total_amount;
         if (ruling === 'refund_buyer') {
-            // 卖家败诉
             const f = chargeArbitrationFee(db, order.seller_id, amt, arbitratorId, sysUser.id);
             if (f.fee > 0)
                 arbFees[order.seller_id] = f.fee;
         }
         else if (ruling === 'release_seller') {
-            // 买家败诉
             const f = chargeArbitrationFee(db, order.buyer_id, amt, arbitratorId, sysUser.id);
             if (f.fee > 0)
                 arbFees[order.buyer_id] = f.fee;
         }
         else if (ruling === 'partial_refund') {
-            // 折中：双方各付 0.5%（最低各 0.5 WAZ，实际按 chargeArbitrationFee 的 min 逻辑）
-            const halfAmt = amt * 0.5;
-            const fb = chargeArbitrationFee(db, order.buyer_id, halfAmt, arbitratorId, sysUser.id);
-            const fs = chargeArbitrationFee(db, order.seller_id, halfAmt, arbitratorId, sysUser.id);
-            if (fb.fee > 0)
-                arbFees[order.buyer_id] = fb.fee;
-            if (fs.fee > 0)
-                arbFees[order.seller_id] = fs.fee;
+            // 有指定责任方：仲裁费全由责任方承担
+            // 无责任方：买卖双方各付 0.5%
+            const payerId = liablePartyId ?? null;
+            if (payerId) {
+                const f = chargeArbitrationFee(db, payerId, amt, arbitratorId, sysUser.id);
+                if (f.fee > 0)
+                    arbFees[payerId] = f.fee;
+            }
+            else {
+                const halfAmt = amt * 0.5;
+                const fb = chargeArbitrationFee(db, order.buyer_id, halfAmt, arbitratorId, sysUser.id);
+                const fs = chargeArbitrationFee(db, order.seller_id, halfAmt, arbitratorId, sysUser.id);
+                if (fb.fee > 0)
+                    arbFees[order.buyer_id] = fb.fee;
+                if (fs.fee > 0)
+                    arbFees[order.seller_id] = fs.fee;
+            }
         }
         else if (ruling === 'liability_split' && liabilityParties) {
-            // 各责任方按比例分担
             const totalLiability = liabilityParties.reduce((s, p) => s + p.amount, 0) || amt;
             for (const p of liabilityParties) {
                 const share = (p.amount / totalLiability) * amt;
@@ -378,7 +385,7 @@ function chargeArbitrationFee(db, loserId, orderAmount, arbitratorId, sysUserId)
     }
     return { fee: actualFee, arbitratorShare, protocolShare };
 }
-function executeSettlement(db, orderId, ruling, refundAmount) {
+function executeSettlement(db, orderId, ruling, refundAmount, liablePartyId) {
     const order = db.prepare('SELECT * FROM orders WHERE id = ?').get(orderId);
     if (!order)
         return { success: false, error: '订单不存在' };
@@ -447,35 +454,88 @@ function executeSettlement(db, orderId, ruling, refundAmount) {
         };
     }
     else if (ruling === 'partial_refund') {
-        // ── 折中处理：部分退款 ────────────────────────────────────────
         const refund = refundAmount ?? Math.round(totalAmount * 0.5 * 100) / 100;
         if (refund > totalAmount)
             return { success: false, error: `退款金额 ${refund} 超出订单总额 ${totalAmount}` };
-        const sellerGet = Math.round((totalAmount - refund) * 100) / 100;
-        const stakeReturn = Math.round(stakeAmount * 0.5 * 100) / 100; // 质押返一半
-        db.transaction(() => {
-            db.prepare('UPDATE wallets SET escrowed = escrowed - ? WHERE user_id = ?').run(totalAmount, buyerId);
-            if (refund > 0) {
-                db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(refund, buyerId);
-            }
-            if (sellerGet > 0) {
-                db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(sellerGet, sellerId);
-            }
-            if (stakeAmount > 0) {
-                db.prepare('UPDATE wallets SET staked = staked - ?, balance = balance + ? WHERE user_id = ?')
-                    .run(stakeAmount, stakeReturn, sellerId);
-            }
-            transition(db, orderId, 'cancelled', sysUser.id, [], `争议裁定：部分退款 ${refund} WAZ`);
-        })();
-        return {
-            success: true,
-            detail: {
-                ruling: 'partial_refund',
-                buyer_refund: refund,
-                seller_received: sellerGet,
-                seller_stake_returned: stakeReturn,
-            }
-        };
+        if (liablePartyId) {
+            // ── 第三方责任 partial_refund ────────────────────────────────
+            // 卖家全额结算（正常收款），买家赔偿由责任方钱包直接支付
+            const protocolFee = Math.round(totalAmount * 0.02 * 100) / 100;
+            const logisticsFee = order.logistics_id ? Math.round(totalAmount * 0.05 * 100) / 100 : 0;
+            const sellerAmount = totalAmount - protocolFee - logisticsFee;
+            // 检查责任方余额是否足够
+            const liableWallet = db.prepare('SELECT balance, staked FROM wallets WHERE user_id = ?')
+                .get(liablePartyId);
+            const liableAvailable = (liableWallet?.balance ?? 0) + (liableWallet?.staked ?? 0);
+            const actualRefund = Math.min(refund, liableAvailable);
+            db.transaction(() => {
+                // 1. 释放托管 → 正常结算给卖家
+                db.prepare('UPDATE wallets SET escrowed = escrowed - ? WHERE user_id = ?').run(totalAmount, buyerId);
+                db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(sellerAmount, sellerId);
+                if (order.logistics_id && logisticsFee > 0) {
+                    db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(logisticsFee, order.logistics_id);
+                }
+                // 2. 返还卖家质押
+                if (stakeAmount > 0) {
+                    db.prepare('UPDATE wallets SET staked = staked - ?, balance = balance + ? WHERE user_id = ?')
+                        .run(stakeAmount, stakeAmount, sellerId);
+                }
+                // 3. 从责任方钱包扣除赔偿（先质押后余额）
+                if (actualRefund > 0) {
+                    const liableStaked = liableWallet?.staked ?? 0;
+                    if (liableStaked >= actualRefund) {
+                        db.prepare('UPDATE wallets SET staked = staked - ? WHERE user_id = ?').run(actualRefund, liablePartyId);
+                    }
+                    else {
+                        const fromBalance = actualRefund - liableStaked;
+                        db.prepare('UPDATE wallets SET staked = 0, balance = balance - ? WHERE user_id = ?').run(fromBalance, liablePartyId);
+                    }
+                    // 4. 赔偿金给买家
+                    db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(actualRefund, buyerId);
+                }
+                transition(db, orderId, 'completed', sysUser.id, [], `争议裁定：第三方责任赔偿 ${actualRefund} WAZ，卖家全额结算`);
+            })();
+            return {
+                success: true,
+                detail: {
+                    ruling: 'partial_refund',
+                    liable_party: liablePartyId,
+                    buyer_compensation: actualRefund,
+                    seller_received: sellerAmount,
+                    logistics_fee: logisticsFee,
+                    protocol_fee: protocolFee,
+                    seller_stake_returned: stakeAmount,
+                }
+            };
+        }
+        else {
+            // ── 买卖双方协商 partial_refund（原逻辑）───────────────────────
+            const sellerGet = Math.round((totalAmount - refund) * 100) / 100;
+            const stakeReturn = Math.round(stakeAmount * 0.5 * 100) / 100; // 质押返一半
+            db.transaction(() => {
+                db.prepare('UPDATE wallets SET escrowed = escrowed - ? WHERE user_id = ?').run(totalAmount, buyerId);
+                if (refund > 0) {
+                    db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(refund, buyerId);
+                }
+                if (sellerGet > 0) {
+                    db.prepare('UPDATE wallets SET balance = balance + ? WHERE user_id = ?').run(sellerGet, sellerId);
+                }
+                if (stakeAmount > 0) {
+                    db.prepare('UPDATE wallets SET staked = staked - ?, balance = balance + ? WHERE user_id = ?')
+                        .run(stakeAmount, stakeReturn, sellerId);
+                }
+                transition(db, orderId, 'cancelled', sysUser.id, [], `争议裁定：部分退款 ${refund} WAZ`);
+            })();
+            return {
+                success: true,
+                detail: {
+                    ruling: 'partial_refund',
+                    buyer_refund: refund,
+                    seller_received: sellerGet,
+                    seller_stake_returned: stakeReturn,
+                }
+            };
+        }
     }
     return { success: false, error: `未知裁定类型：${ruling}` };
 }

package/dist/pwa/server.js

@@ -208,7 +208,9 @@ app.get('/api/orders/:id', (req, res) => {
     if (!statusInfo)
         return void res.status(404).json({ error: '订单不存在' });
     const order = statusInfo.order;
-    if (order.buyer_id !== user.id && order.seller_id !== user.id && order.logistics_id !== user.id && user.role !== 'arbitrator') {
+    const isLogisticsPickup = user.role === 'logistics' &&
+        !order.logistics_id && order.status === 'shipped';
+    if (order.buyer_id !== user.id && order.seller_id !== user.id && order.logistics_id !== user.id && user.role !== 'arbitrator' && !isLogisticsPickup) {
         return void res.status(403).json({ error: '无权查看此订单' });
     }
     const product = db.prepare('SELECT title, price, images FROM products WHERE id = ?').get(order.product_id);
@@ -652,7 +654,7 @@ app.post('/api/disputes/:id/arbitrate', (req, res) => {
         return;
     if (user.role !== 'arbitrator')
         return void res.status(403).json({ error: '仅限仲裁员' });
-    const { ruling, reason, refund_amount, liability_parties } = req.body;
+    const { ruling, reason, refund_amount, liable_party_id, liability_parties } = req.body;
     if (!ruling || !reason)
         return void res.json({ error: '请提供裁定结果（ruling）和理由（reason）' });
     const validRulings = ['refund_buyer', 'release_seller', 'partial_refund', 'liability_split'];
@@ -672,7 +674,7 @@ app.post('/api/disputes/:id/arbitrate', (req, res) => {
     const dispute = getDisputeDetails(db, req.params.id);
     if (!dispute)
         return void res.status(404).json({ error: '争议不存在' });
-    const result = arbitrateDispute(db, req.params.id, user.id, ruling, reason, refund_amount ? Number(refund_amount) : undefined, liability_parties);
+    const result = arbitrateDispute(db, req.params.id, user.id, ruling, reason, refund_amount ? Number(refund_amount) : undefined, liability_parties, liable_party_id);
     if (!result.success)
         return void res.json({ error: result.error });
     // 争议声誉更新（责任分配时以主要责任方为败诉方）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seasonkoh/webaz",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Agent-native decentralized commerce protocol. Humans and AI agents trade on the same protocol via MCP tools.",
   "main": "dist/mcp.js",
   "bin": {