@bolloon/bolloon-agent 0.5.1 → 0.5.3

package/dist/efficode/packet.js

@@ -0,0 +1,271 @@
+/**
+ * efficode/packet - 包封装 (帧结构 + CRC32 尾段 + 严格解析)
+ *
+ * 布局 (照规范):
+ *   [Header 2B] | [DID 验证段 32B] | [指令段 动态] | [数据块 动态] | [CRC32 4B]
+ *
+ * Header 2B:
+ *   byte0: version(高 4 位) | mode(低 4 位)      mode: 0=compact · 1=text
+ *   byte1: flags                                bit0=有 DID 段 · bit1=有指令段 · bit2=有数据块
+ *                                               bit3=数据块已压缩 · bit4..7=保留 (必须 0)
+ *
+ * 指令段: [varint opLen][opBytes]        opBytes 见 ops.ts 的逐条形状
+ * 数据块: [varint dataLen][dataBytes]    dataBytes[0] = 压缩算法 id (见 compress.ts)
+ *
+ * 两条硬纪律 (变异 M1/M2 就是拆这两条, 门必须变红):
+ *   ① 解析必须**逐段自描述**: 长度对不上就报截断, 不许"能解多少解多少";
+ *   ② 尾段 CRC32 覆盖 CRC 之前的**全部**字节, 对不上就报 CRC_MISMATCH,
+ *      绝不放行"内容看着像就收下"。
+ *
+ * 诚实边界:
+ *   - "DID 段 32B" 在规范里是固定段; 参考实现允许省略 (省 32B), 省略时 flags 如实写 0,
+ *     解码端按 flags 解, **不假设**段存在;
+ *   - CRC32 只防传输损坏, **不是**防篡改 (无密钥)。防篡改要真签名 —— 规范中, 见 did.ts 注释。
+ */
+import { crc32Bytes, readCrc32Bytes, crc32 } from './crc32.js';
+import { DID_SEGMENT_BYTES, EfficodeError, EFFICODE_VERSION, CRC_BYTES, MIN_PACKET_BYTES } from './types.js';
+import { compressBlock, decompressBlock, pickAlgo } from './compress.js';
+import { decodeDidSegment, didDigestString, encodeDidSegment } from './did.js';
+import { instructionsToSymbolic, opByCode, opBySymbol, symbolicToInstructions } from './ops.js';
+const MODE_TO_NUM = { compact: 0, text: 1 };
+const NUM_TO_MODE = { 0: 'compact', 1: 'text' };
+const F_HAS_DID = 1 << 0;
+const F_HAS_OP = 1 << 1;
+const F_HAS_DATA = 1 << 2;
+const F_COMPRESSED = 1 << 3;
+const FLAG_RESERVED = 0xf0;
+function writeVarint(out, n) {
+    let v = n >>> 0;
+    while (v >= 0x80) {
+        out.push((v & 0x7f) | 0x80);
+        v >>>= 7;
+    }
+    out.push(v & 0xff);
+}
+function readVarint(buf, pos) {
+    let value = 0;
+    let shift = 0;
+    let i = pos;
+    for (;;) {
+        if (i >= buf.length)
+            throw new EfficodeError('EFFICODE_TRUNCATED', 'varint 未读完就到底', i);
+        const b = buf[i++];
+        value |= (b & 0x7f) << shift;
+        if ((b & 0x80) === 0)
+            break;
+        shift += 7;
+        if (shift > 28)
+            throw new EfficodeError('EFFICODE_TRUNCATED', 'varint 超过 32 位上限', i);
+    }
+    return { value: value >>> 0, next: i };
+}
+/** 指令序列 → 指令段字节 (不含外层 varint 长度) */
+function encodeInstructions(instructions) {
+    const out = [];
+    for (const ins of instructions) {
+        const def = opBySymbol(ins.op);
+        out.push(def.code);
+        const payload = def.hasPayload ? Buffer.from(String(ins.value ?? ''), 'utf-8') : Buffer.alloc(0);
+        if (!def.hasPayload && (ins.value ?? '') !== '') {
+            throw new EfficodeError('EFFICODE_UNKNOWN_OPCODE', `控制指令 ${def.symbol} 不接受载荷`);
+        }
+        writeVarint(out, payload.length);
+        for (const b of payload)
+            out.push(b);
+    }
+    return Uint8Array.from(out);
+}
+/** 指令段字节 → 指令序列 (严格: 未知 opcode / 截断都抛) */
+function decodeInstructions(buf) {
+    const out = [];
+    let pos = 0;
+    while (pos < buf.length) {
+        const code = buf[pos];
+        const def = opByCode(code, pos); // 未知 opcode → 抛 (变异 M1 拆掉这里 → 门变红)
+        pos += 1;
+        const len = readVarint(buf, pos);
+        pos = len.next;
+        if (def.hasPayload) {
+            if (pos + len.value > buf.length) {
+                throw new EfficodeError('EFFICODE_TRUNCATED', `指令 ${def.symbol} 声明 ${len.value}B 载荷但只剩 ${buf.length - pos}B`, pos);
+            }
+            out.push({ op: def.symbol, value: Buffer.from(buf.subarray(pos, pos + len.value)).toString('utf-8') });
+            pos += len.value;
+        }
+        else {
+            if (len.value !== 0) {
+                throw new EfficodeError('EFFICODE_UNKNOWN_OPCODE', `控制指令 ${def.symbol} 声明了 ${len.value}B 载荷`, pos);
+            }
+            out.push({ op: def.symbol });
+        }
+    }
+    return out;
+}
+/** 打包 (总是产出二进制; mode 记在 header 里) */
+export function buildPacket(msg) {
+    const mode = msg.mode ?? 'compact';
+    if (!(mode in MODE_TO_NUM)) {
+        // 语音/声波模式等未实现模式 = 显式拒绝, 不静默降级
+        throw new EfficodeError('EFFICODE_MODE_NOT_IMPLEMENTED', `模式 ${String(mode)} 未实现 (只有 compact/text)`);
+    }
+    const instructions = msg.instructions ?? [];
+    if (!instructions.length)
+        throw new EfficodeError('EFFICODE_BAD_FLAGS', '指令段不能为空 (至少一条指令)');
+    const hasDid = typeof msg.from === 'string' && msg.from.length > 0;
+    const didSeg = hasDid ? encodeDidSegment(msg.from) : null;
+    if (didSeg && didSeg.length !== DID_SEGMENT_BYTES) {
+        throw new EfficodeError('EFFICODE_DID_SEGMENT_BAD', `DID 段长度异常 ${didSeg.length}B`);
+    }
+    const opBytes = encodeInstructions(instructions);
+    const rawData = Buffer.from(msg.data ?? '', 'utf-8');
+    const algo = msg.compression ?? pickAlgo(new Uint8Array(rawData));
+    const dataBlock = rawData.length > 0 ? compressBlock(new Uint8Array(rawData), algo) : new Uint8Array(0);
+    let flags = F_HAS_OP;
+    if (didSeg)
+        flags |= F_HAS_DID;
+    if (dataBlock.length > 0)
+        flags |= F_HAS_DATA;
+    if (dataBlock.length > 0 && algo !== 'none')
+        flags |= F_COMPRESSED;
+    const out = [];
+    out.push(((EFFICODE_VERSION & 0xf) << 4) | (MODE_TO_NUM[mode] & 0xf));
+    out.push(flags);
+    if (didSeg)
+        for (const b of didSeg)
+            out.push(b);
+    writeVarint(out, opBytes.length);
+    for (const b of opBytes)
+        out.push(b);
+    if (dataBlock.length > 0) {
+        writeVarint(out, dataBlock.length);
+        for (const b of dataBlock)
+            out.push(b);
+    }
+    const head = Uint8Array.from(out);
+    const crc = crc32Bytes(head);
+    const packet = new Uint8Array(head.length + CRC_BYTES);
+    packet.set(head, 0);
+    packet.set(crc, head.length);
+    return packet;
+}
+/** 编码成要上网的形态: text 模式 → Base64 串; compact 模式 → 二进制 */
+export function encodePacket(msg) {
+    const packet = buildPacket(msg);
+    const mode = msg.mode ?? 'compact';
+    return mode === 'text' ? Buffer.from(packet).toString('base64') : packet;
+}
+/** 解析 (严格)。入参可以是二进制包或 text 模式的 Base64 串 */
+export function parsePacket(input) {
+    let mode;
+    let buf;
+    if (typeof input === 'string') {
+        mode = 'text';
+        const cleaned = input.trim();
+        if (!/^[A-Za-z0-9+/]+={0,2}$/.test(cleaned) || cleaned.length % 4 !== 0) {
+            throw new EfficodeError('EFFICODE_BAD_BASE64', '文本模式载荷不是合法 Base64');
+        }
+        buf = new Uint8Array(Buffer.from(cleaned, 'base64'));
+        if (buf.length === 0)
+            throw new EfficodeError('EFFICODE_BAD_BASE64', 'Base64 解出 0 字节');
+    }
+    else {
+        mode = 'compact';
+        buf = input;
+    }
+    if (buf.length < MIN_PACKET_BYTES) {
+        throw new EfficodeError('EFFICODE_TOO_SHORT', `包 ${buf.length}B < 最短合法 ${MIN_PACKET_BYTES}B`);
+    }
+    const version = (buf[0] >> 4) & 0xf;
+    if (version !== EFFICODE_VERSION) {
+        throw new EfficodeError('EFFICODE_BAD_VERSION', `包版本 ${version} 不被支持 (本实现只认 ${EFFICODE_VERSION})`, 0);
+    }
+    const modeNum = buf[0] & 0xf;
+    const declaredMode = NUM_TO_MODE[modeNum];
+    if (!declaredMode)
+        throw new EfficodeError('EFFICODE_BAD_MODE', `未知模式 id=${modeNum}`, 0);
+    if (declaredMode !== mode) {
+        throw new EfficodeError('EFFICODE_BAD_MODE', `传输形态(${mode})与包头声明(${declaredMode})不一致`, 0);
+    }
+    const flags = buf[1];
+    if ((flags & FLAG_RESERVED) !== 0) {
+        throw new EfficodeError('EFFICODE_BAD_FLAGS', `flags 保留位被置位: 0x${flags.toString(16)}`, 1);
+    }
+    let pos = 2;
+    let didDigest = null;
+    let didSegmentHex = null;
+    if (flags & F_HAS_DID) {
+        if (pos + DID_SEGMENT_BYTES > buf.length) {
+            throw new EfficodeError('EFFICODE_TRUNCATED', `声明有 DID 段但只剩 ${buf.length - pos}B`, pos);
+        }
+        const seg = buf.subarray(pos, pos + DID_SEGMENT_BYTES);
+        const parsed = decodeDidSegment(seg); // algo 未知 → 抛
+        didDigest = didDigestString(parsed);
+        didSegmentHex = Buffer.from(seg).toString('hex');
+        pos += DID_SEGMENT_BYTES;
+    }
+    let instructions = [];
+    if (flags & F_HAS_OP) {
+        const opLen = readVarint(buf, pos);
+        pos = opLen.next;
+        if (pos + opLen.value > buf.length) {
+            throw new EfficodeError('EFFICODE_TRUNCATED', `指令段声明 ${opLen.value}B 但只剩 ${buf.length - pos}B`, pos);
+        }
+        instructions = decodeInstructions(buf.subarray(pos, pos + opLen.value));
+        pos += opLen.value;
+    }
+    else {
+        throw new EfficodeError('EFFICODE_BAD_FLAGS', 'flags 声明无指令段 —— 本实现不接受无指令的包', 1);
+    }
+    let data = '';
+    let compression = 'none';
+    let rawDataBytes = 0;
+    if (flags & F_HAS_DATA) {
+        const dataLen = readVarint(buf, pos);
+        pos = dataLen.next;
+        if (pos + dataLen.value > buf.length) {
+            throw new EfficodeError('EFFICODE_TRUNCATED', `数据块声明 ${dataLen.value}B 但只剩 ${buf.length - pos}B`, pos);
+        }
+        const block = buf.subarray(pos, pos + dataLen.value);
+        const un = decompressBlock(block);
+        compression = un.algo;
+        rawDataBytes = un.data.length;
+        data = Buffer.from(un.data).toString('utf-8');
+        pos += dataLen.value;
+    }
+    const expectCrcAt = buf.length - CRC_BYTES;
+    if (pos !== expectCrcAt) {
+        throw new EfficodeError('EFFICODE_TRAILING_BYTES', `解析在 ${pos}B 结束, 但 CRC 段在 ${expectCrcAt}B —— 中间有 ${expectCrcAt - pos}B 垃圾`, pos);
+    }
+    const head = buf.subarray(0, expectCrcAt);
+    const want = readCrc32Bytes(buf, expectCrcAt);
+    const got = crc32(head);
+    if (want !== got) {
+        throw new EfficodeError('EFFICODE_CRC_MISMATCH', `CRC32 不符: 包内 0x${want.toString(16)}, 实算 0x${got.toString(16)}`, expectCrcAt);
+    }
+    return {
+        mode: declaredMode,
+        didDigest,
+        didSegmentHex,
+        instructions,
+        data,
+        compression,
+        bytes: buf.length,
+        rawDataBytes,
+    };
+}
+/** 便捷: 包 → 语义消息 (保留符号化形态, 供文本模式/调试面读取) */
+export function packetToMessage(input) {
+    const p = parsePacket(input);
+    return {
+        instructions: p.instructions,
+        data: p.data || undefined,
+        mode: p.mode,
+        compression: p.compression,
+        bytes: p.bytes,
+        symbolic: instructionsToSymbolic(p.instructions),
+    };
+}
+/** 从符号化文本造一条消息 (调试/文本模式入口) */
+export function messageFromSymbolic(text, data) {
+    return { instructions: symbolicToInstructions(text), data, mode: 'compact' };
+}

package/dist/efficode/types.js

@@ -0,0 +1,45 @@
+/**
+ * efficode/types - Efficode 参考实现的公共类型
+ *
+ * 设计口径 (照 leo 给的规范, 不自行发明新协议):
+ *   - 符号化指令集 + 前缀表达式: @DID: 身份 · #DATA: 数据 · #REQ: 请求 · !ACK/!SEND/!END 控制
+ *   - 两种模式: 文本模式 (调试/低带宽, 可 Base64) 与 二进制模式 (默认, 高密度)
+ *   - 自解压数据块: 数据块自带轻量解码规则 (压缩算法 id + 原始长度), 接收方按规则直接展开
+ *   - 包结构: [Header 2B] | [DID 验证段 32B] | [指令段 动态] | [数据块 动态] | [CRC32 4B]
+ *
+ * 诚实标注 (都写进 docs/wiki/efficode.md, 不在这里当已验证结论):
+ *   - 本文件是**参考实现**: 能真编真解、逐字节回环、畸形包报错;
+ *   - 语音/声波模式 (ggwave 类) **未实现** —— 只留 `mode` 枚举里的保留位, 编码时显式拒绝;
+ *   - 链上签名验证 / ECC 临时会话密钥 **规范中** —— 本实现只做 DID 摘要段, 不做签名;
+ *   - 压缩率/信息密度这类宣传数字一律按**实测**写, 见 scripts/verify-efficode.ts 的真测输出。
+ */
+export const COMPRESSION_IDS = {
+    none: 0,
+    lz77: 1,
+    deflate: 2,
+};
+export const COMPRESSION_BY_ID = {
+    0: 'none',
+    1: 'lz77',
+    2: 'deflate',
+};
+/** 包版本 (Header 高 4 位) */
+export const EFFICODE_VERSION = 1;
+/** DID 段固定长度 (字节) —— 照规范: 32B */
+export const DID_SEGMENT_BYTES = 32;
+/** CRC32 尾段固定长度 (字节) */
+export const CRC_BYTES = 4;
+/** 最短合法包 = Header 2 + 无 DID 段 + 指令段最少 (varint 长度 1 + 一条控制指令 2) + 无数据块 + CRC 4 = 9B
+ *  (DID 段 32B 是**可选**省略的, 所以不放进来; 带 DID 的包应 ≥ 41B, 由 flags 驱动逐段校验而不是靠这个下限) */
+export const MIN_PACKET_BYTES = 2 + 1 + 2 + CRC_BYTES;
+export class EfficodeError extends Error {
+    code;
+    /** 出错位置 (字节偏移); 拿不到时为 -1 */
+    offset;
+    constructor(code, message, offset = -1) {
+        super(`${code}: ${message}${offset >= 0 ? ` (offset=${offset})` : ''}`);
+        this.name = 'EfficodeError';
+        this.code = code;
+        this.offset = offset;
+    }
+}

package/dist/electron-build/agents/agent-manifest-protocol.js

@@ -104,6 +104,10 @@ function setLocalManifest(m) {
         localManifest.exportments = [];
     if (!('sciences' in m))
         localManifest.sciences = [];
+    // 2026-09-28: 交流语言声明同规矩 —— 不给就显式清空, 免得旧的 efficode 声明在对端已经不支持时还留着.
+    // (老 manifest 语义不变: 没有 supportedLangs = 没声明 = 自然语言)
+    if (!('supportedLangs' in m))
+        localManifest.supportedLangs = [];
     // 2026-09-18: 网络脉冲 (只记公开统计; 不落 DID/正文; 统计失败绝不影响主路径)
     try {
         const did = String(localManifest.ownerPublicKey || '');

package/dist/electron-build/agents/agent-manifest-protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-manifest-protocol.js","sourceRoot":"","sources":["../../../src/agents/agent-manifest-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-manifest-protocol.js","sourceRoot":"","sources":["../../../src/agents/agent-manifest-protocol.ts"],"names":[],"mappings":"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"}

package/dist/electron-build/agents/chain/transfer-classify.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * transfer-classify.ts — 转账索引的**纯**部分 (类型 + 分类 + 折算 + 汇总)
+ * =========================================================================
+ * 为什么单独一个文件: 这两半的**加载代价**完全不同 ——
+ *   · 本文件: 零依赖 (不 import ethers / 不发 RPC / 不读盘) ⇒ 公开页/快照构建可以**静态**引入;
+ *   · `transfer-index.ts`: 要 JSON-RPC provider (ethers) 与文件系统 ⇒ 只在**同步**路径上加载。
+ * 把纯函数放在这里, network-pulse 才不必为了 `formatUnits` 把 ethers 拖进网页进程。
+ *
+ * 分类口径 (leo 2026-09-29 实测拍板; **不许**只按"USDC 转到该地址"计数):
+ *   · `escrow_settlement`  from == escrow 合约 → 「escrow 退款/释放」(实测块 51685757 / 51686009
+ *                          两笔 +0.001 与那两笔 Disputed→Refunded **逐块对应**) —— 钱退回, **不是收入**;
+ *   · `self_transfer`      from ∈ 自己地址集 (可配 ownAddresses) → 「转入(非销售)」;
+ *   · `external_payment`   其余 → 「外部付款」(与卖方端点台账对上的加标「经 x402 流程」);
+ *   · `outbound`           关注地址**付出** → 不进「链上转入」计数。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFER_ADDRESS_RE = exports.USDC_BY_CHAIN = exports.ERC20_TRANSFER_TOPIC = exports.TRANSFER_INDEX_SCHEMA_VERSION = void 0;
+exports.formatUnits = formatUnits;
+exports.classifyTransfer = classifyTransfer;
+exports.summarizeTransfers = summarizeTransfers;
+exports.TRANSFER_INDEX_SCHEMA_VERSION = 1;
+/** Transfer(address indexed from, address indexed to, uint256 value) 的 topic0 */
+exports.ERC20_TRANSFER_TOPIC = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
+/** Base 主网 USDC (缺省 token; 也可由 chain.json 的 tokenAddress / env 覆盖) */
+exports.USDC_BY_CHAIN = {
+    8453: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+    84532: '0x036cbd53842c5426634e7929541ec2318f3dcf7e',
+};
+/** 0x + 40 位十六进制 (地址形状; 与 explorer.ts 的同一套尺子) */
+exports.TRANSFER_ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+/** 原子单位 → 十进制字符串 (纯整数运算, 不经过浮点; 去掉末尾多余的 0) */
+function formatUnits(atomic, decimals) {
+    const v = BigInt(typeof atomic === 'bigint' ? atomic : (String(atomic || '0').trim() || '0'));
+    const neg = v < 0n;
+    const abs = neg ? -v : v;
+    const d = Math.max(0, Math.floor(decimals));
+    const base = 10n ** BigInt(d);
+    const whole = (abs / base).toString();
+    const frac = (abs % base).toString().padStart(d, '0').replace(/0+$/, '');
+    const out = frac ? `${whole}.${frac}` : whole;
+    return neg ? `-${out}` : out;
+}
+/**
+ * 一条转账的**分类** (纯函数: 输入事实 + 配置, 输出分类)。
+ * 为什么在**读**的时候算而不是写索引时算: 分类规则 / 自己地址集是会变的
+ * (把 0xb4cb8009… 认成"自己钱包"之前, 它只是一个外部地址) ⇒ 历史行必须能被重新分类,
+ * 而不是把当时的判断固化进索引。索引里只存**链上事实** (from/to/value/块号)。
+ */
+function classifyTransfer(e, cfg) {
+    const from = String(e.from || '').toLowerCase();
+    const to = String(e.to || '').toLowerCase();
+    const watch = new Set((cfg.watchAddresses || []).map((a) => String(a).toLowerCase()));
+    if (e.direction === 'out' || (watch.has(from) && !watch.has(to)))
+        return 'outbound';
+    const escrow = String(cfg.escrowAddress || '').toLowerCase();
+    if (escrow && from === escrow)
+        return 'escrow_settlement';
+    if ((cfg.ownAddresses || []).map((a) => String(a).toLowerCase()).includes(from))
+        return 'self_transfer';
+    return 'external_payment';
+}
+/** 已落盘转账索引 → 汇总 (纯函数; 不发网络、不读配置以外的东西) */
+function summarizeTransfers(state, cfg) {
+    const live = (state.entries || []).filter((e) => !e.suspect);
+    const by_class = { escrow_settlement: 0, self_transfer: 0, external_payment: 0 };
+    const by_class_atomic = { escrow_settlement: '0', self_transfer: '0', external_payment: '0' };
+    let inbound = 0, inboundAtomic = 0n, outbound = 0, outboundAtomic = 0n, pending = 0;
+    for (const e of live) {
+        if (e.finality === 'observed')
+            pending++;
+        const v = BigInt(e.value || '0');
+        if (e.direction === 'out') {
+            outbound++;
+            outboundAtomic += v;
+            continue;
+        }
+        inbound++;
+        inboundAtomic += v;
+        const c = classifyTransfer(e, cfg);
+        if (c !== 'outbound') {
+            by_class[c]++;
+            by_class_atomic[c] = (BigInt(by_class_atomic[c]) + v).toString();
+        }
+    }
+    const decimals = Number.isInteger(state.tokenDecimals) ? state.tokenDecimals : (cfg.tokenDecimals ?? 6);
+    return {
+        configured: cfg.enabled !== false && !!((state.watchAddresses || cfg.watchAddresses || []).length),
+        reason: cfg.reason || '',
+        entries: live.length,
+        suspects: (state.entries || []).length - live.length,
+        inbound, inbound_atomic: inboundAtomic.toString(), inbound_display: formatUnits(inboundAtomic, decimals),
+        by_class, by_class_atomic,
+        outbound, outbound_atomic: outboundAtomic.toString(),
+        token_symbol: state.tokenSymbol || cfg.tokenSymbol || '',
+        token_decimals: decimals,
+        watch_addresses_count: (state.watchAddresses || cfg.watchAddresses || []).length,
+        own_addresses_count: (cfg.ownAddresses || []).length,
+        from_block: state.fromBlock,
+        last_synced_block: state.lastSyncedBlock,
+        last_synced_at: state.lastSyncedAt,
+        head_block: state.headBlock,
+        pending_observation: pending,
+    };
+}
+//# sourceMappingURL=transfer-classify.js.map

package/dist/electron-build/agents/chain/transfer-classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-classify.js","sourceRoot":"","sources":["../../../../src/agents/chain/transfer-classify.ts"],"names":[],"mappings":"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"}