@bolloon/bolloon-agent 0.4.19 → 0.4.20

package/dist/agents/pi-sdk-tools.js

@@ -2083,6 +2083,261 @@ export function registerBuiltinTools(ctx) {
         }
     });
     // ============================================================
+    // 数字资源资产化 (Stage 1-4): 注册→运营(发现/匹配)→交易(x402)→清算(信誉)
+    // ============================================================
+    ctx.tools.set('resource_register', {
+        name: 'resource_register',
+        description: '注册一个数字资源 (A 轻版: 内容CID寻址 + 元数据同步网络 registry; 预留 chain=evm 可升级 tokenURI). type: data|art_product|product_image|tx_link; 内容寻址存 content, 定价/授权/交易链接/收款钱包进资源记录, 供网络内智能体 resource_discover/match/purchase 发现并交易.',
+        parameters: {
+            type: 'data | art_product | product_image | tx_link',
+            title: '资源标题',
+            content: '资源内容 (文本/JSON; 图片 base64 dataURL)',
+            wallet: '可选收款钱包地址 (Stage 3 交易用)',
+            price: '可选 {amount,currency:USDC|token,token?,per?} 字符串或JSON',
+            license: '可选授权 (personal/commercial)',
+            txLink: '可选交易链接',
+            chain: '可选 none|evm (预留升级)',
+            tokenUriTemplate: '可选 evm 时 tokenURI 模板, 如 {base}/{id}',
+        },
+        execute: async (args) => {
+            try {
+                const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+                const db = getCIDDatabase();
+                const cidd = {
+                    save: async (t) => (await db.save({ agentId: String(ctx.agentId || ''), type: 'knowledge', content: t })).id,
+                    load: async (c) => { const rec = await db.load(c); return rec ? String(rec.content ?? '') : null; },
+                };
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { registerResource } = await import('./resource-store.js');
+                let price;
+                if (args.price) {
+                    try {
+                        price = typeof args.price === 'string' ? JSON.parse(args.price) : args.price;
+                    }
+                    catch {
+                        price = undefined;
+                    }
+                }
+                const { loadOrCreateWallet } = await import('./resource-wallet.js');
+                const nw = await loadOrCreateWallet().catch(() => null);
+                const walletAddr = nw?.address || '';
+                const r = await registerResource({
+                    ownerDid: String(ctx.agentId || ''),
+                    type: String(args.type || ''),
+                    title: String(args.title || ''),
+                    content: String(args.content || ''),
+                    wallet: args.wallet ? String(args.wallet) : walletAddr || undefined,
+                    price,
+                    license: args.license ? String(args.license) : undefined,
+                    txLink: args.txLink ? String(args.txLink) : undefined,
+                    chain: args.chain,
+                    tokenUriTemplate: args.tokenUriTemplate ? String(args.tokenUriTemplate) : undefined,
+                }, { cid: cidd, registry: getAgentRegistry() });
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                const res = r.resource;
+                return { success: true, output: `✅ 资源已注册 (A 轻版上链): ${res.resourceId}\n  ${res.title} · ${res.type} · CID: ${res.contentCid}${res.wallet ? ` · 钱包 ${res.wallet}` : ''}${res.price ? ` · 价格 ${res.price.amount} ${res.price.currency}${res.price.token ? `(${res.price.token})` : ''}` : ''}${res.license ? ` · ${res.license}` : ''}${res.txLink ? ` · 交易:${res.txLink}` : ''}${res.chain === 'evm' ? ` · ${res.chain}` : ''}\n已同步网络 registry: 智能体可用 resource_discover/match 找到, resource_purchase 交易/访问。` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_register 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_discover', {
+        name: 'resource_discover',
+        description: '发现数字资源 (本机 + 网络 registry): 按 type 或 owner 列出 (谁注册了什么, 定价/授权/交易链接), 供分配/交易决策.',
+        parameters: { type: '可选过滤 type', owner: '可选过滤 owner DID' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { listResources } = await import('./resource-store.js');
+                const list = await listResources({
+                    type: args.type ? String(args.type) : undefined,
+                    owner: args.owner ? String(args.owner) : undefined,
+                }, { registry: getAgentRegistry() });
+                if (!list.length)
+                    return { success: true, output: '暂无资源 (用 resource_register 注册)' };
+                return { success: true, output: list.map((r) => `${r.resourceId} · ${r.title} · ${r.type}${r.price ? ` · ${r.price.amount} ${r.price.currency}${r.price.token ? `(${r.price.token})` : ''}${r.price.per ? `/${r.price.per}` : ''}` : ''}${r.license ? ` · ${r.license}` : ''}${r.txLink ? ` · 🔗${r.txLink}` : ''}${r.wallet ? ` · 钱包 ${String(r.wallet).slice(0, 10)}…` : ''}${r.chain === 'evm' ? ' · evm' : ''}`).join('\n') + '\n（resource_purchase <id> 交易/访问）' };
+            }
+            catch (e) {
+                return { success: false, error: `resource_discover 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_match', {
+        name: 'resource_match',
+        description: '自动分配匹配: 按需求关键词对资源打分 (标题/类型/授权 + 提供者信誉加权), 返回推荐排序. 用于智能体自动分配资源.',
+        parameters: { query: '需求关键词' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const { matchResources } = await import('./resource-store.js');
+                const repQuery = async (owner, type) => {
+                    try {
+                        const q = await queryReputation(owner, type, registry);
+                        const e = q.entries?.[0];
+                        return { score: e?.reputation?.score ?? 0, tasks: e?.reputation?.tasks ?? 0, success: e?.reputation?.success ?? 0, failed: e?.reputation?.failed ?? 0 };
+                    }
+                    catch {
+                        return { score: 0, tasks: 0, success: 0, failed: 0 };
+                    }
+                };
+                const scored = await matchResources(String(args.query || ''), { registry, repQuery });
+                if (!scored.length)
+                    return { success: true, output: '无匹配资源' };
+                return { success: true, output: scored.map((s) => `${s.resource.resourceId} · ${s.resource.title} · ${s.resource.type} · 得分 ${Math.round(s.score * 10) / 10}${s.resource.license ? ` · ${s.resource.license}` : ''}`).join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `resource_match 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_purchase', {
+        name: 'resource_purchase',
+        description: '交易/访问资源: 付费资源走 x402 支付后解锁内容 (结算更新提供者信誉), 免费资源直接取回内容.',
+        parameters: { resourceId: '资源 id' },
+        execute: async (args) => {
+            try {
+                const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+                const db = getCIDDatabase();
+                const cidd = {
+                    save: async (t) => (await db.save({ agentId: String(ctx.agentId || ''), type: 'knowledge', content: t })).id,
+                    load: async (c) => { const rec = await db.load(c); return rec ? String(rec.content ?? '') : null; },
+                };
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const { purchaseResource } = await import('./resource-store.js');
+                const pay = async (spec) => {
+                    try {
+                        const { x402Pay } = await import('./x402/x402Pay.js');
+                        const { loadOrCreateWallet } = await import('./resource-wallet.js');
+                        const w = await loadOrCreateWallet().catch(() => null);
+                        if (!w?.privateKey)
+                            return { success: false, error: '需自动生成 x402 钱包 (~/.bolloon/wallet.json) 才能购买付费资源' };
+                        const r = await x402Pay({ privateKey: w.privateKey, amount: String(spec.amount), to: spec.recipient, currency: spec.currency === 'USDC' ? 'USDC' : 'ETH', memo: spec.memo });
+                        return { success: r.success, txHash: r.txHash, error: r.error };
+                    }
+                    catch (e) {
+                        return { success: false, error: `x402 支付失败: ${String(e?.message || e).slice(0, 120)}` };
+                    }
+                };
+                const repQuery = async (owner, type) => {
+                    try {
+                        const q = await queryReputation(owner, type, registry);
+                        const e = q.entries?.[0];
+                        return { score: e?.reputation?.score ?? 0, tasks: e?.reputation?.tasks ?? 0, success: e?.reputation?.success ?? 0, failed: e?.reputation?.failed ?? 0 };
+                    }
+                    catch {
+                        return { score: 0, tasks: 0, success: 0, failed: 0 };
+                    }
+                };
+                const onSettle = (outcome, resource) => {
+                    void import('./agent-reputation.js').then((m) => m.recordServiceOutcome(resource.ownerDid, `resource:${resource.type}`, outcome, registry)).catch(() => { });
+                };
+                const r = await purchaseResource(String(args.resourceId || ''), { cid: cidd, pay, repQuery, onSettle });
+                if (!r.ok)
+                    return { success: false, error: r.error || (r.needPay ? '需要支付' : '失败') };
+                return { success: true, output: `${r.txHash ? `💰 已支付 (tx ${String(r.txHash).slice(0, 16)}…) · ` : ''}📄 ${r.resource.title} (${r.resource.type})\n${String(r.content || '').slice(0, 3000)}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_purchase 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_reputation', {
+        name: 'resource_reputation',
+        description: '清算/信誉: 查资源提供者信誉 (成交记录+score), 供自动分配加权决策.',
+        parameters: { owner: 'owner DID (缺省=本机)' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const owner = String(args.owner || ctx.agentId || '');
+                const q = await queryReputation(owner, undefined, registry);
+                if (!q.entries?.length)
+                    return { success: true, output: `${owner.slice(0, 16)}… 暂无信誉记录` };
+                return { success: true, output: q.entries.map((e) => `  ${e.service} · ${e.reputation.score} (${e.reputation.success}/${e.reputation.tasks} 成交)`).join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `resource_reputation 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    // ── Stage 1-B: EVM 资产合约 (ERC-721, CID 作 tokenURI) 铸造/流转/查询 ──
+    ctx.tools.set('resource_mint', {
+        name: 'resource_mint',
+        description: '把已注册数字资源铸成 ERC-721 token (内容 CID 作 tokenURI, 不可变随 token 流转). 需配置 EVM executor (部署 contracts/ResourceERC721.sol + 设 __bolloonEvmExecutor 或用 ethers/viem).',
+        parameters: { resourceId: '资源 id' },
+        execute: async (args) => {
+            try {
+                const { getResource } = await import('./resource-store.js');
+                const { mintResourceToken } = await import('./resource-token.js');
+                const r = await getResource(String(args.resourceId || ''));
+                if (!r)
+                    return { success: false, error: '资源不存在' };
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor) 才能铸造. 部署 contracts/ResourceERC721.sol + 配置 ~/.bolloon/evm-config.json / ethers.' };
+                const { walletAddress } = await import('./resource-wallet.js');
+                const naddr = await walletAddress().catch(() => '');
+                const to = r.wallet || naddr;
+                if (!to)
+                    return { success: false, error: '无收款钱包 (部署后设 __bolloonEvmExecutor + 资源 wallet)' };
+                const m = await mintResourceToken({ resourceId: r.resourceId, ownerDid: r.ownerDid, contentCid: r.contentCid, wallet: to, title: r.title }, { evm });
+                if (!m.ok)
+                    return { success: false, error: m.error || (m.needConfig ? '需配置 EVM' : '铸造失败') };
+                return { success: true, output: `✅ 已铸造 tokenId=${m.tokenId} · tokenURI=ipfs://${r.contentCid} · 资源 ${r.resourceId}\n(resource_transfer <tokenId> <to> 流转 · resource_token <tokenId> 查询)` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_mint 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_transfer', {
+        name: 'resource_transfer',
+        description: '流转 ERC-721 token 所有权 (safeTransferFrom) 到新地址.',
+        parameters: { tokenId: 'token id', to: '接收 EVM 地址' },
+        execute: async (args) => {
+            try {
+                const { transferResourceToken } = await import('./resource-token.js');
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor)' };
+                const r = await transferResourceToken(String(args.tokenId || ''), String(args.to || ''), { evm });
+                if (!r.ok)
+                    return { success: false, error: r.error || '流转失败' };
+                return { success: true, output: `✅ 已流转 token ${r.tokenId} → ${args.to}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_transfer 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_token', {
+        name: 'resource_token',
+        description: '查询 ERC-721 token: owner + tokenURI (内容 CID).',
+        parameters: { tokenId: 'token id' },
+        execute: async (args) => {
+            try {
+                const { queryResourceToken } = await import('./resource-token.js');
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor)' };
+                const r = await queryResourceToken(String(args.tokenId || ''), { evm });
+                if (!r.ok)
+                    return { success: false, error: r.error || '查询失败' };
+                return { success: true, output: `🔎 token ${args.tokenId}\n  owner: ${r.owner || 'n/a'}\n  tokenURI: ${r.tokenUri || 'n/a'}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_token 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    // ============================================================
     // MCP 工具 (2026-08-03) — 外部 MCP server 接入 agent 工具系统
     // 配置: ~/.mcp.json (mcpServers), 启动时 initializeMcpAdapter 自动握手发现工具
     // mcp_list_tools: 列出已发现的 MCP 工具

package/dist/agents/resource-store.js

@@ -0,0 +1,168 @@
+// ─── 数字资源资产化 (Stage 1-4) ────────────────────────────────────────────
+//   经济循环: 注册资源 → 运营(发现/自动分配) → 交易(x402 付费) → 清算(信誉).
+//   A 轻版: content 内容寻址(CID) + 元数据(可同步网络 registry) + DID 签名身份;
+//   预留 B: chain='evm' + tokenUriTemplate → 元数据可升级为 tokenURI.
+//   四类统一 schema: data | art_product | product_image | tx_link.
+//   复用现有件: cid_database(内容寻址) / agent-registry(跨机发现/定价/信誉) / x402(交易) / reputation(清算).
+function memStore() {
+    let m = [];
+    return { get: () => m, set: (x) => { m = x; } };
+}
+/** Stage2: 把资源元数据同步成网络 registry 可发现条目 (AgentService 包装) */
+export function serializeForRegistry(r) {
+    return {
+        agentId: r.ownerDid,
+        name: r.title,
+        wallet: r.wallet || '0x0',
+        service: {
+            name: `resource:${r.type}`,
+            description: `数字资源 ${r.type} — ${r.title} (CID ${r.contentCid})`,
+            price: r.price ? { amount: r.price.amount, currency: r.price.currency, per: r.price.per || 'access' } : { amount: '0', currency: 'USDC', per: 'access' },
+        },
+        capabilities: [`resource:${r.type}`, r.resourceId],
+    };
+}
+/** Stage2: 跨机可见 — 注册资源时同步到网络 registry (尽力而为) */
+export async function syncResourceToRegistry(r, deps) {
+    if (!deps.registry)
+        return;
+    try {
+        await deps.registry.register(serializeForRegistry(r));
+    }
+    catch { /* 同步失败不致命 */ }
+}
+export async function registerResource(opts, deps = {}) {
+    if (!opts.ownerDid || !opts.type || !opts.title || !opts.content)
+        return { ok: false, error: 'ownerDid/type/title/content 必填' };
+    const VALID = ['data', 'art_product', 'product_image', 'tx_link'];
+    if (!VALID.includes(opts.type))
+        return { ok: false, error: `type 必须是 ${VALID.join('|')}` };
+    try {
+        const cid = deps.cid;
+        if (!cid)
+            return { ok: false, error: '缺 cid 依赖 (内容寻址不可用)' };
+        const contentCid = await cid.save(opts.content);
+        const now = deps.now ? deps.now() : new Date().toISOString();
+        const rid = deps.rid ? deps.rid() : `res_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+        const resource = {
+            resourceId: rid, ownerDid: opts.ownerDid, type: opts.type, title: opts.title, contentCid,
+            wallet: opts.wallet, price: opts.price, license: opts.license, txLink: opts.txLink, meta: opts.meta,
+            chain: opts.chain || 'none', tokenUriTemplate: opts.chain === 'evm' ? opts.tokenUriTemplate : undefined,
+            createdAt: now, updatedAt: now,
+        };
+        (deps.store || memStore()).set([...(deps.store || memStore()).get(), resource]);
+        deps.onRegister?.(resource);
+        await syncResourceToRegistry(resource, deps); // Stage2 跨机可见
+        return { ok: true, resource };
+    }
+    catch (e) {
+        return { ok: false, error: `注册失败: ${String(e?.message || e).slice(0, 140)}` };
+    }
+}
+/** Stage2 运营: 按 type/owner 过滤 (本机索引 + 网络 registry 合并) */
+export async function listResources(filter = {}, deps = {}) {
+    const local = (deps.store || memStore()).get()
+        .filter((r) => (!filter.type || r.type === filter.type) && (!filter.owner || r.ownerDid === filter.owner));
+    // 合并网络 registry (跨机资源), 按 resourceId 去重
+    if (deps.registry) {
+        try {
+            const remote = await deps.registry.discover(filter.type ? `resource:${filter.type}` : 'resource:');
+            const known = new Set(local.map((r) => r.resourceId));
+            for (const r of remote) {
+                const rid = r?.capabilities?.find((c) => String(c).startsWith('res_'));
+                if (!rid || known.has(rid))
+                    continue;
+                const price = r?.service?.price;
+                local.push({
+                    resourceId: rid, ownerDid: r?.agentId || 'unknown', type: String(r?.service?.name).replace('resource:', '') || 'data',
+                    title: r?.name || rid, contentCid: '', wallet: r?.wallet, price: price ? { amount: String(price.amount), currency: price.currency || 'USDC', per: price.per } : undefined,
+                    chain: 'none', meta: { remote: true },
+                });
+            }
+        }
+        catch { /* 网络合并失败忽略 */ }
+    }
+    return local;
+}
+export async function getResource(resourceId, deps = {}) {
+    return (deps.store || memStore()).get().find((r) => r.resourceId === resourceId) ?? null;
+}
+/** 免费/预览访问: 直接按 contentCid 取回内容 (付费资源应走 purchaseResource) */
+export async function accessResource(resourceId, deps = {}) {
+    const r = await getResource(resourceId, deps);
+    if (!r)
+        return { ok: false, error: `资源不存在: ${resourceId}` };
+    if (!deps.cid)
+        return { ok: false, error: '缺 cid 依赖', resource: r };
+    const content = await deps.cid.load(r.contentCid);
+    if (content === null)
+        return { ok: false, error: '内容拉取失败 (CID 不可达)', resource: r };
+    return { ok: true, content, resource: r };
+}
+/** Stage2 自动分配匹配器: 关键词打分 + 信誉加权, 返回排序资源 */
+export async function matchResources(query, deps = {}) {
+    const all = await listResources({}, deps);
+    const q = String(query || '').trim().toLowerCase();
+    const scored = [];
+    for (const r of all) {
+        let s = 0;
+        if (q) {
+            if (r.title?.toLowerCase().includes(q))
+                s += 3;
+            if (r.type.toLowerCase().includes(q))
+                s += 2;
+            if (r.license?.toLowerCase().includes(q))
+                s += 1;
+            if (String(r.ownerDid).toLowerCase().includes(q))
+                s += 1;
+        }
+        else
+            s = 1;
+        if (deps.repQuery) {
+            try {
+                const rep = await deps.repQuery(r.ownerDid, r.type);
+                s += rep.score * 5;
+            }
+            catch { /* 无信誉 */ }
+        }
+        scored.push({ resource: r, score: s });
+    }
+    return scored.filter((x) => x.score > 0).sort((a, b) => b.score - a.score);
+}
+/** Stage3 交易 + Stage4 清算: 付费档走注入 pay(x402), 免费直接 access; 结果 onSettle(reputation) */
+export async function purchaseResource(resourceId, deps = {}) {
+    const r = await getResource(resourceId, deps);
+    if (!r)
+        return { ok: false, error: `资源不存在: ${resourceId}` };
+    const amount = r.price ? Number(r.price.amount) : 0;
+    if (amount > 0) {
+        if (!deps.pay)
+            return { ok: false, needPay: true, error: '付费资源需要注入 pay (x402)', resource: r };
+        if (!r.wallet)
+            return { ok: false, needPay: true, error: '资源缺收款钱包 (wallet)', resource: r };
+        const p = await deps.pay({ recipient: r.wallet, amount: String(amount), currency: r.price.currency, token: r.price.token, memo: `purchase ${r.resourceId}` });
+        if (!p.success) {
+            deps.onSettle?.('failed', r);
+            return { ok: false, needPay: true, error: p.error || '支付失败', resource: r };
+        }
+        deps.onSettle?.('success', r);
+        // 付费后解锁访问 (内容寻址)
+        const content = deps.cid ? await deps.cid.load(r.contentCid) : null;
+        return { ok: true, content: content ?? undefined, txHash: p.txHash, resource: r };
+    }
+    // 免费资源直接访问
+    const content = deps.cid ? await deps.cid.load(r.contentCid) : null;
+    return { ok: true, content: content ?? undefined, resource: r };
+}
+/** Stage4 清算: 查资源提供者信誉 */
+export async function resourceReputation(ownerDid, deps = {}) {
+    if (!deps.repQuery)
+        return { ok: false, error: '缺 repQuery 依赖' };
+    try {
+        const rep = await deps.repQuery(ownerDid);
+        return { ok: true, reputation: rep };
+    }
+    catch (e) {
+        return { ok: false, error: String(e?.message || e).slice(0, 120) };
+    }
+}

package/dist/agents/resource-token.js

@@ -0,0 +1,77 @@
+// ─── 数字资源资产化 Stage 1-B: EVM 资产合约 (ERC-721) 铸造/流转/查询 ─────────
+//   合约: contracts/ResourceERC721.sol (mint(to,id,tokenUri), safeTransferFrom).
+//   内容寻址 CID 作 tokenURI (不可变, 随 token 流转); 铸造/转移/查询全部走注入的
+//   EVM executor (默认接 ethers/viem 或节点; 未配置明确提示), 单测用 fake.
+//   复用: cid_database(内容寻址) / agent-registry(注册) / gateway(跨机可见) — Stage1 已有.
+function memStore() {
+    let m = [];
+    return { get: () => m, set: (x) => { m = x; } };
+}
+/** 从 ~/.bolloon/evm-config.json 或 env 读 EVM 配置 (合约地址/RPC/chainId). */
+export async function loadEvmConfig(src) {
+    try {
+        if (src)
+            return JSON.parse(src);
+        const home = globalThis.process?.env?.HOME || '';
+        const { readFile } = await import('fs/promises');
+        const raw = await readFile(`${home}/.bolloon/evm-config.json`, 'utf-8').catch(() => null);
+        if (raw)
+            return JSON.parse(raw);
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 铸造: 内容 CID 作 tokenURI 铸 ERC-721, 记 token 账本 */
+export async function mintResourceToken(resource, deps = {}) {
+    if (!deps.evm)
+        return { ok: false, needConfig: true, error: '需配置 EVM executor (ethers/viem 或注入) 才能铸造' };
+    if (!resource.wallet)
+        return { ok: false, needConfig: true, error: '资源缺收款钱包地址 (EVM 接收地址)' };
+    if (!resource.contentCid)
+        return { ok: false, error: '资源缺 contentCid (内容寻址)' };
+    try {
+        const tokenUri = `ipfs://${resource.contentCid}`; // CID 作 tokenURI (内容寻址, 不可变)
+        const r = await deps.evm.mint(resource.wallet, tokenUri, `mint ${resource.resourceId}`);
+        const now = deps.now ? deps.now() : new Date().toISOString();
+        const record = { tokenId: r.tokenId, resourceId: resource.resourceId, ownerDid: resource.ownerDid, contract: deps.config?.contractAddress || '', mintedAt: now };
+        const st = deps.store || memStore();
+        st.set([...st.get(), record]);
+        return { ok: true, tokenId: r.tokenId, record };
+    }
+    catch (e) {
+        return { ok: false, error: `铸造失败: ${String(e?.message || e).slice(0, 140)}` };
+    }
+}
+/** 流转: safeTransferFrom 转移所有权 */
+export async function transferResourceToken(tokenId, to, deps = {}) {
+    if (!deps.evm)
+        return { ok: false, needConfig: true, error: '需配置 EVM executor 才能流转' };
+    try {
+        const r = await deps.evm.transfer(tokenId, to);
+        if (r.error)
+            return { ok: false, error: r.error };
+        return { ok: true, tokenId };
+    }
+    catch (e) {
+        return { ok: false, error: `流转失败: ${String(e?.message || e).slice(0, 140)}` };
+    }
+}
+/** 查询: owner + tokenURI */
+export async function queryResourceToken(tokenId, deps = {}) {
+    if (!deps.evm)
+        return { ok: false, error: '需配置 EVM executor 才能查询' };
+    try {
+        const owner = await deps.evm.ownerOf(tokenId);
+        const uri = await deps.evm.tokenURI(tokenId);
+        return { ok: true, owner: owner ?? undefined, tokenUri: uri ?? undefined };
+    }
+    catch (e) {
+        return { ok: false, error: `查询失败: ${String(e?.message || e).slice(0, 140)}` };
+    }
+}
+/** 列出本机已铸 token */
+export function listResourceTokens(deps = {}) {
+    return (deps.store || memStore()).get();
+}

package/dist/agents/resource-wallet.js

@@ -0,0 +1,46 @@
+// ─── 资源级 x402 钱包自动配置 ─────────────────────────────────────────────
+//   首次调用自动生成一个 EVM 钱包 (viem/accounts, 私钥+地址), 持久化到
+//   ~/.bolloon/wallet.json (mode 0600). 之后幂等加载同一钱包.
+//   资源自动绑定到它: 卖家收款地址(resource.wallet) / 铸造接收地址 / 购买付款签名.
+//   x402 支付复用该私钥签名; 资金由用户向 address 充值 (自动配置=密钥/绑定, 不代发币).
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+async function defaultRead() {
+    try {
+        const { readFile } = await import('fs/promises');
+        const home = globalThis.process?.env?.HOME || '';
+        return await readFile(`${home}/.bolloon/wallet.json`, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultWrite(payload) {
+    const { writeFile, mkdir } = await import('fs/promises');
+    const home = globalThis.process?.env?.HOME || '';
+    await mkdir(`${home}/.bolloon`, { recursive: true });
+    await writeFile(`${home}/.bolloon/wallet.json`, payload, { mode: 0o600 });
+}
+/** 加载或创建钱包 (幂等): 有则返回, 无则 viem 生成 + 落盘 0600. */
+export async function loadOrCreateWallet(deps = {}) {
+    const read = deps.read ?? defaultRead;
+    const write = deps.write ?? defaultWrite;
+    const existing = await read();
+    if (existing) {
+        try {
+            const w = JSON.parse(existing);
+            if (w && w.privateKey && w.address)
+                return { privateKey: String(w.privateKey), address: String(w.address) };
+        }
+        catch { /* corrupted → regenerate */ }
+    }
+    const privateKey = generatePrivateKey();
+    const account = privateKeyToAccount(privateKey);
+    const rec = { privateKey, address: account.address };
+    await write(JSON.stringify(rec));
+    return rec;
+}
+/** 便捷: 只取地址 (绑定资源/铸造接收). */
+export async function walletAddress(deps = {}) {
+    const w = await loadOrCreateWallet(deps);
+    return w.address;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.4.19",
+  "version": "0.4.20",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",
@@ -44,6 +44,7 @@
     "app:bundle": "node scripts/build-app-bundle.cjs",
     "app:bundle:open": "node scripts/build-app-bundle.cjs && open \"release/mac-arm64/Bolloon Agent.app\"",
     "smoke:esm": "node scripts/smoke-esm.mjs",
+    "check:token": "node scripts/solc-compile.mjs",
     "prepublishOnly": "npm run build:all && npm run smoke:esm",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -114,6 +115,7 @@
     "fake-indexeddb": "^6.2.5",
     "lefthook": "^2.1.12",
     "playwright": "^1.63.0",
+    "solc": "^0.8.20",
     "tsx": "^4.23.13",
     "typescript": "^7.0.2",
     "vite": "^8.2.2",