trustbase-seller-backend 0.1.5

package/mcp/interfaces.d.ts

@@ -0,0 +1,1058 @@
+/**
+ * TrustCoin MCP Server - Abstract Interfaces
+ * 抽象接口定义，方便插件、软件、服务等开发使用
+ *
+ * 所有接口都经过精心设计，确保：
+ * 1. 类型安全（TypeScript）
+ * 2. 易于扩展
+ * 3. 文档清晰
+ * 4. 向后兼容
+ */
+/**
+ * 钱包地址类型
+ * 格式：trust1...
+ */
+export type Address = string;
+/**
+ * 交易哈希类型
+ */
+export type TxHash = string;
+/**
+ * SKU ID 类型
+ */
+export type SKU = string;
+/**
+ * 时间戳类型（ISO 8601）
+ */
+export type Timestamp = string;
+/**
+ * 金额类型（最小单位）
+ */
+export type Amount = bigint;
+/**
+ * 评分类型（0-100）
+ */
+export type Rating = number;
+/**
+ * 经纬度坐标
+ */
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * 设备绑定接口
+ * 用于管理设备与账户的绑定关系
+ */
+export interface IDeviceBinding {
+    /**
+     * 验证设备是否已绑定账户
+     * @param deviceId 设备指纹 ID
+     * @param userAddress 用户钱包地址
+     * @param ipAddress 用户 IP 地址
+     * @param userAgent 用户浏览器信息（可选）
+     * @returns 设备绑定状态
+     */
+    verifyBinding(deviceId: string, userAddress: Address, ipAddress: string, userAgent?: string): Promise<DeviceBindingResult>;
+    /**
+     * 绑定设备到账户
+     * @param deviceId 设备指纹 ID
+     * @param userAddress 用户钱包地址
+     * @param ipAddress 用户 IP 地址
+     * @param userAgent 用户浏览器信息（可选）
+     */
+    bindDevice(deviceId: string, userAddress: Address, ipAddress: string, userAgent?: string): Promise<void>;
+    /**
+     * 解绑设备
+     * @param deviceId 设备指纹 ID
+     * @param userAddress 用户钱包地址
+     */
+    unbindDevice(deviceId: string, userAddress: Address): Promise<void>;
+}
+/**
+ * 设备绑定结果
+ */
+export interface DeviceBindingResult {
+    /** 绑定状态 */
+    status: 'unbound' | 'bound_to_self' | 'bound_to_other';
+    /** 是否可以绑定 */
+    canBind: boolean;
+    /** 提示信息 */
+    message: string;
+    /** 已绑定的地址（如果已绑定） */
+    boundAddress?: Address;
+    /** 绑定时间 */
+    boundAt?: Timestamp;
+}
+/**
+ * 2FA 双因素认证接口
+ */
+export interface ITwoFactorAuth {
+    /**
+     * 检查 2FA 状态
+     * @param address 用户钱包地址
+     * @returns 2FA 配置信息
+     */
+    checkStatus(address: Address): Promise<TwoFAStatus>;
+    /**
+     * 启用 2FA
+     * @param address 用户钱包地址
+     * @param method 2FA 方法
+     * @returns 2FA 配置信息（包含密钥、二维码等）
+     */
+    enable(address: Address, method: 'totp'): Promise<TwoFASetup>;
+    /**
+     * 验证 2FA 代码
+     * @param address 用户钱包地址
+     * @param code 验证码
+     * @returns 验证结果
+     */
+    verify(address: Address, code: string): Promise<boolean>;
+    /**
+     * 禁用 2FA
+     * @param address 用户钱包地址
+     * @param code 验证码（用于确认）
+     */
+    disable(address: Address, code: string): Promise<void>;
+}
+/**
+ * 2FA 状态
+ */
+export interface TwoFAStatus {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 2FA 方法 */
+    method?: 'totp';
+    /** 设置时间 */
+    setupAt?: Timestamp;
+    /** 最后使用时间 */
+    lastUsedAt?: Timestamp;
+    /** 剩余备用码数量 */
+    backupCodesRemaining?: number;
+}
+/**
+ * 2FA 设置信息
+ */
+export interface TwoFASetup {
+    /** 密钥 */
+    secret: string;
+    /** 二维码 URL */
+    qrCodeUrl: string;
+    /** 备用恢复码 */
+    backupCodes: string[];
+}
+/**
+ * 登录管理接口
+ */
+export interface ILoginManager {
+    /**
+     * 记录登录尝试
+     * @param address 用户钱包地址
+     * @param success 是否成功
+     * @param ipAddress IP 地址
+     * @param deviceId 设备 ID
+     * @param failureReason 失败原因（可选）
+     * @returns 登录尝试结果
+     */
+    recordAttempt(address: Address, success: boolean, ipAddress: string, deviceId: string, failureReason?: string): Promise<LoginAttemptResult>;
+    /**
+     * 锁定账户
+     * @param address 用户钱包地址
+     * @param durationMinutes 锁定时长（分钟）
+     * @param reason 锁定原因
+     */
+    lockAccount(address: Address, durationMinutes: number, reason: string): Promise<void>;
+    /**
+     * 检查账户锁定状态
+     * @param address 用户钱包地址
+     * @returns 锁定状态
+     */
+    checkLock(address: Address): Promise<AccountLockStatus>;
+}
+/**
+ * 登录尝试结果
+ */
+export interface LoginAttemptResult {
+    /** 是否记录成功 */
+    recorded: boolean;
+    /** 登录是否成功 */
+    success: boolean;
+    /** 失败次数 */
+    failureCount?: number;
+    /** 最大失败次数 */
+    maxFailures: number;
+    /** 剩余尝试次数 */
+    remainingAttempts?: number;
+    /** 警告信息 */
+    warning?: string;
+}
+/**
+ * 账户锁定状态
+ */
+export interface AccountLockStatus {
+    /** 是否锁定 */
+    locked: boolean;
+    /** 锁定截止时间 */
+    lockedUntil?: Timestamp;
+    /** 锁定原因 */
+    reason?: string;
+    /** 锁定时间 */
+    lockedAt?: Timestamp;
+    /** 剩余分钟数 */
+    remainingMinutes?: number;
+    /** 提示信息 */
+    message: string;
+}
+/**
+ * 商品基础接口
+ */
+export interface IProduct {
+    /** SKU ID */
+    skuId: SKU;
+    /** 商品标题 */
+    title: string;
+    /** 商品描述 */
+    description: string;
+    /** 商品类型 */
+    type: 'physical' | 'digital' | 'saas' | 'service';
+    /** 价格 */
+    price: number;
+    /** 货币单位 */
+    currency: 'tct' | 'cny' | 'usd';
+    /** 卖家地址 */
+    seller: Address;
+    /** 评分 */
+    rating: Rating;
+    /** 销量 */
+    sales: number;
+    /** 创建时间 */
+    createdAt: Timestamp;
+    /** 更新时间 */
+    updatedAt: Timestamp;
+}
+/**
+ * 实体物品接口
+ */
+export interface IPhysicalProduct extends IProduct {
+    type: 'physical';
+    /** 库存 */
+    stock: number;
+    /** 重量 */
+    weight?: number;
+    /** 尺寸 */
+    dimensions?: string;
+    /** 运费 */
+    shippingFee?: number;
+    /** 图片列表 */
+    images: string[];
+    /** 分类 */
+    category: string;
+}
+/**
+ * 数字产品接口（插件、软件）
+ */
+export interface IDigitalProduct extends IProduct {
+    type: 'digital';
+    /** 版本号 */
+    version: string;
+    /** 下载链接 */
+    downloadUrl: string;
+    /** 演示链接 */
+    demoUrl?: string;
+    /** 文档链接 */
+    documentationUrl?: string;
+    /** 支持邮箱 */
+    supportEmail?: string;
+    /** 截图列表 */
+    screenshots: string[];
+    /** 插件类型 */
+    pluginType?: 'payment' | 'shipping' | 'order' | 'erp' | 'crm' | 'marketing' | 'other';
+    /** 功能列表 */
+    features: string[];
+    /** 系统要求 */
+    requirements: Record<string, string>;
+    /** 下载次数 */
+    downloads: number;
+    /** 安装次数 */
+    installCount: number;
+}
+/**
+ * SaaS 服务接口
+ */
+export interface ISaaSProduct extends IProduct {
+    type: 'saas';
+    /** 定价模式 */
+    pricingModel: 'subscription' | 'pay_as_you_go';
+    /** 套餐列表 */
+    plans: ISaaSPlan[];
+    /** API 文档链接 */
+    apiDocumentation?: string;
+    /** SDK 下载列表 */
+    sdkDownloads: string[];
+    /** SLA 正常运行时间 */
+    uptimeSla?: string;
+    /** 支持信息 */
+    support?: string;
+    /** 订阅者数量 */
+    subscribers: number;
+}
+/**
+ * SaaS 套餐
+ */
+export interface ISaaSPlan {
+    /** 套餐名称 */
+    name: string;
+    /** 价格 */
+    price: number;
+    /** 配额 */
+    quota: string;
+    /** 功能列表 */
+    features: string[];
+}
+/**
+ * 虚拟服务接口
+ */
+export interface IServiceProduct extends IProduct {
+    type: 'service';
+    /** 服务时长 */
+    duration?: string;
+    /** 可用时间 */
+    availability?: string;
+    /** 是否需要预约 */
+    bookingRequired?: boolean;
+    /** 服务提供者地址 */
+    provider: Address;
+    /** 作品集 */
+    portfolio?: string[];
+}
+/**
+ * 商品搜索接口
+ */
+export interface IProductSearch {
+    /**
+     * 搜索商品
+     * @param query 搜索参数
+     * @returns 搜索结果
+     */
+    search(query: ProductSearchQuery): Promise<ProductSearchResult>;
+    /**
+     * 获取商品详情
+     * @param skuId 商品 SKU ID
+     * @returns 商品详情
+     */
+    getDetails(skuId: SKU): Promise<IProduct>;
+    /**
+     * 搜索插件
+     * @param query 插件搜索参数
+     * @returns 插件列表
+     */
+    searchPlugins(query: PluginSearchQuery): Promise<IDigitalProduct[]>;
+    /**
+     * 搜索 SaaS 服务
+     * @param query SaaS 搜索参数
+     * @returns SaaS 列表
+     */
+    searchSaaS(query: SaaSSearchQuery): Promise<ISaaSProduct[]>;
+}
+/**
+ * 商品搜索参数
+ */
+export interface ProductSearchQuery {
+    /** 关键词 */
+    keyword?: string;
+    /** 分类 */
+    category?: string;
+    /** 最低价格 */
+    minPrice?: number;
+    /** 最高价格 */
+    maxPrice?: number;
+    /** 最低评分 */
+    minRating?: Rating;
+    /** 商品类型 */
+    type?: 'physical' | 'digital' | 'saas' | 'service';
+    /** 每页数量 */
+    pageSize?: number;
+    /** 页码 */
+    page?: number;
+    /** 排序方式 */
+    sortBy?: 'price' | 'rating' | 'sales' | 'created_at';
+    /** 排序顺序 */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * 商品搜索结果
+ */
+export interface ProductSearchResult {
+    /** 商品列表 */
+    products: IProduct[];
+    /** 总数 */
+    total: number;
+    /** 当前页 */
+    page: number;
+    /** 查询耗时（毫秒） */
+    queryTimeMs: number;
+}
+/**
+ * 插件搜索参数
+ */
+export interface PluginSearchQuery {
+    /** 关键词 */
+    keyword?: string;
+    /** 插件类型 */
+    pluginType?: 'payment' | 'shipping' | 'order' | 'erp' | 'crm' | 'marketing' | 'other';
+    /** 最低评分 */
+    minRating?: number;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 页码 */
+    page?: number;
+}
+/**
+ * SaaS 搜索参数
+ */
+export interface SaaSSearchQuery {
+    /** 关键词 */
+    keyword?: string;
+    /** SaaS 类型 */
+    saasType?: 'api' | 'tool' | 'cloud' | 'other';
+    /** 定价模式 */
+    pricingModel?: 'subscription' | 'pay_as_you_go';
+    /** 每页数量 */
+    pageSize?: number;
+    /** 页码 */
+    page?: number;
+}
+/**
+ * 卖家接口
+ */
+export interface ISeller {
+    /** 卖家地址 */
+    address: Address;
+    /** 昵称 */
+    moniker?: string;
+    /** 信誉评分 */
+    reputation: Rating;
+    /** 总质押量 */
+    totalStake: Amount;
+    /** 活跃订单数 */
+    activeOrders: number;
+    /** 完成订单数 */
+    completedOrders: number;
+    /** 纠纷率 */
+    disputeRate: number;
+    /** 创建时间 */
+    createdAt: Timestamp;
+}
+/**
+ * 卖家查询接口
+ */
+export interface ISellerQuery {
+    /**
+     * 获取卖家详情
+     * @param address 卖家地址
+     * @returns 卖家信息
+     */
+    getDetails(address: Address): Promise<ISeller>;
+    /**
+     * 获取卖家所有商品
+     * @param address 卖家地址
+     * @param query 查询参数
+     * @returns 商品列表
+     */
+    getProducts(address: Address, query?: SellerProductsQuery): Promise<SellerProductsResult>;
+    /**
+     * 生成卖家二维码
+     * @param address 卖家地址
+     * @param options 二维码选项
+     * @returns 二维码信息
+     */
+    generateQRCode(address: Address, options?: QRCodeOptions): Promise<QRCodeResult>;
+    /**
+     * 扫描卖家二维码
+     * @param qrCodeData 二维码数据
+     * @param options 扫描选项
+     * @returns 卖家信息
+     */
+    scanQRCode(qrCodeData: string, options?: ScanQRCodeOptions): Promise<ISeller>;
+}
+/**
+ * 卖家商品查询参数
+ */
+export interface SellerProductsQuery {
+    /** 商品类型 */
+    type?: 'all' | 'physical' | 'digital' | 'saas' | 'service';
+    /** 每页数量 */
+    pageSize?: number;
+    /** 页码 */
+    page?: number;
+    /** 排序方式 */
+    sortBy?: 'created_at' | 'price' | 'rating' | 'sales';
+    /** 排序顺序 */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * 卖家商品结果
+ */
+export interface SellerProductsResult {
+    /** 卖家地址 */
+    sellerAddress: Address;
+    /** 商品列表 */
+    products: IProduct[];
+    /** 各类型商品数量 */
+    productTypes: {
+        physical: number;
+        digital: number;
+        saas: number;
+        service: number;
+    };
+    /** 总数 */
+    total: number;
+    /** 当前页 */
+    page: number;
+}
+/**
+ * 二维码选项
+ */
+export interface QRCodeOptions {
+    /** 格式 */
+    format?: 'svg' | 'png' | 'base64';
+    /** 尺寸（像素） */
+    size?: number;
+    /** 是否包含 Logo */
+    includeLogo?: boolean;
+}
+/**
+ * 二维码结果
+ */
+export interface QRCodeResult {
+    /** 卖家地址 */
+    sellerAddress: Address;
+    /** 二维码 URL */
+    qrCodeUrl: string;
+    /** 格式 */
+    format: string;
+    /** 尺寸 */
+    size: number;
+    /** 扫描 URL */
+    scanUrl: string;
+}
+/**
+ * 扫描二维码选项
+ */
+export interface ScanQRCodeOptions {
+    /** 是否包含商品列表 */
+    includeProducts?: boolean;
+    /** 商品数量限制 */
+    productLimit?: number;
+}
+/**
+ * 插件信息
+ */
+export interface IPlugin {
+    /** 插件 ID */
+    pluginId: string;
+    /** 插件名称 */
+    name: string;
+    /** 版本 */
+    version: string;
+    /** 插件类型 */
+    type: 'payment' | 'listing' | 'chat' | 'order' | 'shipping' | 'erp' | 'crm' | 'marketing' | 'analytics' | 'other';
+    /** 是否排他性 */
+    exclusivity: 'exclusive' | 'multiple';
+    /** 作者 */
+    author: string;
+    /** 描述 */
+    description: string;
+    /** 状态 */
+    status: 'active' | 'inactive';
+}
+/**
+ * 插件管理接口
+ */
+export interface IPluginManager {
+    /**
+     * 安装插件
+     * @param sellerAddress 卖家地址
+     * @param pluginId 插件 ID
+     * @param config 插件配置
+     * @returns 安装结果
+     */
+    install(sellerAddress: Address, pluginId: string, config?: Record<string, any>): Promise<PluginInstallResult>;
+    /**
+     * 配置插件
+     * @param installId 安装 ID
+     * @param sellerAddress 卖家地址
+     * @param config 插件配置
+     */
+    configure(installId: string, sellerAddress: Address, config: Record<string, any>): Promise<void>;
+    /**
+     * 启用插件
+     * @param installId 安装 ID
+     * @param sellerAddress 卖家地址
+     */
+    enable(installId: string, sellerAddress: Address): Promise<void>;
+    /**
+     * 禁用插件
+     * @param installId 安装 ID
+     * @param sellerAddress 卖家地址
+     */
+    disable(installId: string, sellerAddress: Address): Promise<void>;
+    /**
+     * 卸载插件
+     * @param installId 安装 ID
+     * @param sellerAddress 卖家地址
+     */
+    uninstall(installId: string, sellerAddress: Address): Promise<void>;
+    /**
+     * 注册插件端口
+     * @param pluginId 插件 ID
+     * @param sellerAddress 卖家地址
+     * @param port 端口号
+     * @param options 端口选项
+     * @returns 端口注册结果
+     */
+    registerPort(pluginId: string, sellerAddress: Address, port: number, options: PluginPortOptions): Promise<PluginPortResult>;
+}
+/**
+ * 插件安装结果
+ */
+export interface PluginInstallResult {
+    /** 安装 ID */
+    installId: string;
+    /** 插件 ID */
+    pluginId: string;
+    /** 插件名称 */
+    pluginName: string;
+    /** 版本 */
+    version: string;
+    /** 安装时间 */
+    installedAt: Timestamp;
+}
+/**
+ * 插件端口选项
+ */
+export interface PluginPortOptions {
+    /** 协议 */
+    protocol: 'http' | 'https' | 'ws' | 'wss' | 'tcp' | 'udp';
+    /** 访问权限 */
+    accessPermission: 'public' | 'private' | 'restricted' | 'paid' | 'subscription';
+    /** 访问范围 */
+    accessScope?: {
+        public?: boolean;
+        private?: boolean;
+        restricted?: Address[];
+        paid?: boolean;
+        subscription?: boolean;
+    };
+    /** 访问费用 */
+    accessFee?: {
+        price: number;
+        currency: 'tct' | 'cny' | 'usd';
+        duration?: 'once' | 'hour' | 'day' | 'month' | 'year';
+    };
+}
+/**
+ * 插件端口结果
+ */
+export interface PluginPortResult {
+    /** 注册 ID */
+    registryId: string;
+    /** 插件 ID */
+    pluginId: string;
+    /** 端口号 */
+    port: number;
+    /** 协议 */
+    protocol: string;
+    /** 访问 URL */
+    accessUrl: string;
+    /** 访问权限 */
+    accessPermission: string;
+    /** 注册时间 */
+    registeredAt: Timestamp;
+}
+/**
+ * AI 模型信息
+ */
+export interface IAIModel {
+    /** 模型 ID */
+    modelId: string;
+    /** 模型名称 */
+    modelName: string;
+    /** 模型类型 */
+    modelType: 'text_generation' | 'image_generation' | 'image_recognition' | 'speech_recognition' | 'speech_synthesis' | 'translation' | 'embedding' | 'content_moderation' | 'sentiment_analysis' | 'other';
+    /** 提供商 */
+    provider: 'openai' | 'anthropic' | 'google' | 'azure' | 'zhipu' | 'baidu' | 'alibaba' | 'tencent' | 'custom';
+    /** 状态 */
+    status: 'active' | 'inactive' | 'error' | 'suspended';
+}
+/**
+ * AI 功能接口
+ */
+export interface IAIManager {
+    /**
+     * 配置 AI 模型
+     * @param model 模型配置
+     */
+    configureModel(model: AIModelConfig): Promise<void>;
+    /**
+     * 调用 AI 模型
+     * @param modelId 模型 ID
+     * @param action 操作类型
+     * @param request 请求数据
+     * @param parameters 可选参数
+     * @returns 调用结果
+     */
+    call(modelId: string, action: AIAction, request: any, parameters?: Record<string, any>): Promise<AIResult>;
+    /**
+     * 配置 AI 场景
+     * @param scenario 场景配置
+     */
+    configureScenario(scenario: AIScenarioConfig): Promise<void>;
+    /**
+     * 获取使用统计
+     * @param query 查询参数
+     * @returns 使用统计
+     */
+    getUsageStats(query: AIUsageQuery): Promise<AIUsageStats>;
+}
+/**
+ * AI 模型配置
+ */
+export interface AIModelConfig {
+    /** 模型 ID */
+    modelId: string;
+    /** 模型名称 */
+    modelName: string;
+    /** 模型类型 */
+    modelType: IAIModel['modelType'];
+    /** 提供商 */
+    provider: IAIModel['provider'];
+    /** API 配置 */
+    apiConfig: {
+        endpoint: string;
+        apiKey: string;
+        version?: string;
+        timeout?: number;
+        maxRetries?: number;
+    };
+    /** 模型参数 */
+    parameters?: {
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        stop?: string[];
+    };
+    /** 使用限制 */
+    limits?: {
+        dailyLimit?: number;
+        monthlyLimit?: number;
+        costPerCall?: number;
+        costUnit?: 'tct' | 'cny' | 'usd';
+    };
+}
+/**
+ * AI 操作类型
+ */
+export type AIAction = 'generate_text' | 'generate_image' | 'recognize_image' | 'recognize_speech' | 'synthesize_speech' | 'translate' | 'moderate_content' | 'analyze_sentiment';
+/**
+ * AI 调用结果
+ */
+export interface AIResult {
+    /** 调用 ID */
+    callId: string;
+    /** 模型 ID */
+    modelId: string;
+    /** 操作类型 */
+    action: AIAction;
+    /** 结果数据 */
+    result: any;
+    /** 使用量 */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** 费用 */
+    cost?: number;
+    /** 费用单位 */
+    costUnit?: string;
+    /** 调用时间 */
+    calledAt: Timestamp;
+}
+/**
+ * AI 场景配置
+ */
+export interface AIScenarioConfig {
+    /** 场景 ID */
+    scenarioId: string;
+    /** 场景名称 */
+    scenarioName: string;
+    /** 场景类型 */
+    scenarioType: 'product_description' | 'product_title' | 'product_tags' | 'image_recognition' | 'smart_customer_service' | 'content_moderation' | 'price_recommendation' | 'translation' | 'speech_recognition' | 'smart_recommendation';
+    /** 使用的模型 ID */
+    modelId: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 是否自动触发 */
+    autoTrigger: boolean;
+    /** 触发条件 */
+    triggerConditions?: {
+        event?: string;
+        condition?: string;
+    };
+    /** 提示词模板 */
+    promptTemplate?: string;
+    /** 费用承担方 */
+    costBearer: 'seller' | 'buyer' | 'platform';
+}
+/**
+ * AI 使用查询
+ */
+export interface AIUsageQuery {
+    /** 模型 ID（可选） */
+    modelId?: string;
+    /** 开始日期 */
+    startDate?: string;
+    /** 结束日期 */
+    endDate?: string;
+    /** 分组方式 */
+    groupBy?: 'day' | 'week' | 'month';
+}
+/**
+ * AI 使用统计
+ */
+export interface AIUsageStats {
+    /** 模型 ID */
+    modelId?: string;
+    /** 开始日期 */
+    startDate?: string;
+    /** 结束日期 */
+    endDate?: string;
+    /** 分组方式 */
+    groupBy: string;
+    /** 统计数据 */
+    stats: Array<{
+        modelId: string;
+        date: string;
+        totalCalls: number;
+        textCalls: number;
+        imageCalls: number;
+        translationCalls: number;
+    }>;
+    /** 总调用次数 */
+    totalCalls: number;
+}
+/**
+ * 服务订阅接口
+ */
+export interface IServiceSubscription {
+    /**
+     * 订阅服务
+     * @param subscription 订阅信息
+     * @returns 订阅结果
+     */
+    subscribe(subscription: SubscriptionConfig): Promise<SubscriptionResult>;
+    /**
+     * 取消订阅
+     * @param subscriptionId 订阅 ID
+     * @param subscriberAddress 订阅者地址
+     */
+    unsubscribe(subscriptionId: string, subscriberAddress: Address): Promise<void>;
+}
+/**
+ * 订阅配置
+ */
+export interface SubscriptionConfig {
+    /** 订阅者地址 */
+    subscriberAddress: Address;
+    /** 被订阅者地址 */
+    targetAddress: Address;
+    /** 订阅类型 */
+    subscriptionType: 'delivery' | 'taxi' | 'housekeeping' | 'repair' | 'pickup';
+    /** 订阅范围 */
+    scope: {
+        maxDistance?: number;
+        district?: string;
+        serviceTypes?: string[];
+        minAmount?: number;
+        maxAmount?: number;
+    };
+    /** 接单条件 */
+    conditions: {
+        autoApply: boolean;
+        maxConcurrentOrders: number;
+        workingHours: {
+            start: string;
+            end: string;
+        };
+        minRating?: number;
+        minDeposit?: number;
+    };
+}
+/**
+ * 订阅结果
+ */
+export interface SubscriptionResult {
+    /** 订阅 ID */
+    subscriptionId: string;
+    /** 订阅者地址 */
+    subscriberAddress: Address;
+    /** 被订阅者地址 */
+    targetAddress: Address;
+    /** 订阅类型 */
+    subscriptionType: string;
+    /** 状态 */
+    status: 'active' | 'inactive';
+    /** 订阅时间 */
+    subscribedAt: Timestamp;
+}
+/**
+ * 自动派单接口
+ */
+export interface IAutoDispatch {
+    /**
+     * 自动申请接单
+     * @param application 申请信息
+     * @returns 申请结果
+     */
+    applyOrder(application: OrderApplication): Promise<ApplicationResult>;
+    /**
+     * 获取订单申请列表
+     * @param orderId 订单 ID
+     * @param query 查询参数
+     * @returns 申请列表
+     */
+    getApplications(orderId: string, query?: ApplicationQuery): Promise<ApplicationList>;
+    /**
+     * 派单决策
+     * @param orderId 订单 ID
+     * @param selectedApplicant 选中的申请人
+     * @param reason 选择原因
+     * @returns 派单结果
+     */
+    dispatch(orderId: string, selectedApplicant: Address, reason?: string): Promise<DispatchResult>;
+    /**
+     * 自动派单
+     * @param orderId 订单 ID
+     * @param rule 派单规则
+     * @returns 派单结果
+     */
+    autoDispatch(orderId: string, rule: DispatchRule): Promise<DispatchResult>;
+}
+/**
+ * 订单申请
+ */
+export interface OrderApplication {
+    /** 订单 ID */
+    orderId: string;
+    /** 申请人地址 */
+    applicantAddress: Address;
+    /** 预计到达时间（分钟） */
+    estimatedArrival: number;
+    /** 距离（公里） */
+    distance: number;
+    /** 自我介绍 */
+    message?: string;
+    /** 报价 */
+    bid?: {
+        deliveryFee: number;
+        estimatedTime: number;
+    };
+}
+/**
+ * 申请结果
+ */
+export interface ApplicationResult {
+    /** 申请 ID */
+    applicationId: string;
+    /** 订单 ID */
+    orderId: string;
+    /** 申请人地址 */
+    applicantAddress: Address;
+    /** 优先级分数 */
+    priorityScore: number;
+    /** 预计到达时间 */
+    estimatedArrival: number;
+    /** 距离 */
+    distance: number;
+    /** 状态 */
+    status: 'pending' | 'accepted' | 'rejected';
+    /** 申请时间 */
+    appliedAt: Timestamp;
+}
+/**
+ * 申请查询
+ */
+export interface ApplicationQuery {
+    /** 排序方式 */
+    sortBy?: 'priority' | 'distance' | 'rating' | 'arrival_time';
+    /** 返回数量 */
+    limit?: number;
+}
+/**
+ * 申请列表
+ */
+export interface ApplicationList {
+    /** 订单 ID */
+    orderId: string;
+    /** 申请列表 */
+    applications: Array<{
+        applicationId: string;
+        applicantAddress: Address;
+        applicantMoniker?: string;
+        rating: Rating;
+        distance: number;
+        estimatedArrival: number;
+        priorityScore: number;
+        completedOrders: number;
+        message?: string;
+        appliedAt: Timestamp;
+    }>;
+    /** 总数 */
+    total: number;
+    /** 排序方式 */
+    sortBy: string;
+}
+/**
+ * 派单规则
+ */
+export type DispatchRule = 'highest_priority' | 'nearest' | 'highest_rating' | 'fastest_arrival' | 'custom';
+/**
+ * 派单结果
+ */
+export interface DispatchResult {
+    /** 订单 ID */
+    orderId: string;
+    /** 选中的申请人 */
+    selectedApplicant: Address;
+    /** 派单规则 */
+    rule?: DispatchRule;
+    /** 优先级分数 */
+    priorityScore?: number;
+    /** 状态 */
+    status: 'assigned';
+    /** 派单时间 */
+    assignedAt: Timestamp;
+}
+export interface ITrustCoinAPI {
+    /** 安全认证 */
+    security: {
+        device: IDeviceBinding;
+        twoFA: ITwoFactorAuth;
+        login: ILoginManager;
+    };
+    /** 商品管理 */
+    product: IProductSearch;
+    /** 卖家查询 */
+    seller: ISellerQuery;
+    /** 插件管理 */
+    plugin: IPluginManager;
+    /** AI 功能 */
+    ai: IAIManager;
+    /** 自动派单 */
+    dispatch: {
+        subscription: IServiceSubscription;
+        autoDispatch: IAutoDispatch;
+    };
+}
+//# sourceMappingURL=interfaces.d.ts.map