@biochain/dweb-compat 0.1.0

package/.turbo/turbo-typecheck$colon$run.log

@@ -0,0 +1,4 @@
+
+> @biochain/dweb-compat@0.1.0 typecheck:run /Users/kzf/Dev/bioforestChain/KeyApp/packages/dweb-compat
+> tsc --noEmit
+

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@biochain/dweb-compat",
+  "version": "0.1.0",
+  "description": "dweb-plaoc 到 KeyApp bio provider 的兼容适配器",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./is-dweb": {
+      "types": "./src/is-dweb.ts",
+      "import": "./src/is-dweb.ts"
+    },
+    "./plugins-stub": {
+      "types": "./src/plugins-stub.ts",
+      "import": "./src/plugins-stub.ts"
+    }
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "typecheck:run": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:storybook": "echo 'SDK has no storybook'"
+  }
+}

package/src/address.ts

@@ -0,0 +1,79 @@
+/**
+ * 地址授权适配
+ * 
+ * 将 dweb 的 getWalleterAddresss 转换为 KeyApp 的 bio_requestAccounts
+ */
+
+import { bioRequest } from './bridge'
+import type { $WalletGetAddressResponse, $CHAIN_NAME } from './types'
+
+/** KeyApp bio_accounts 返回的账户信息 */
+interface BioAccountInfo {
+    address: string
+    chain: string
+    publicKey?: string
+}
+
+/**
+ * 获取钱包地址授权
+ * 
+ * 对应 dweb 的 getWalleterAddresss(mmid)
+ * 转换为 KeyApp 的 bio_requestAccounts + bio_accounts
+ */
+export async function getWalleterAddresss(
+    _mmid: `${string}.dweb`
+): Promise<$WalletGetAddressResponse | null> {
+    try {
+        // 1. 请求账户授权
+        const addresses = await bioRequest<string[]>('bio_requestAccounts')
+
+        if (!addresses || addresses.length === 0) {
+            return null
+        }
+
+        // 2. 获取完整账户信息
+        let accounts: BioAccountInfo[]
+        try {
+            accounts = await bioRequest<BioAccountInfo[]>('bio_accounts')
+        } catch {
+            // 如果 bio_accounts 失败，使用地址构造基本信息
+            accounts = addresses.map(addr => ({ address: addr, chain: 'BFMeta' }))
+        }
+
+        // 3. 转换为 dweb 格式
+        return accounts.map(acc => ({
+            name: '',
+            chainName: acc.chain as $CHAIN_NAME,
+            address: acc.address,
+            main: acc.address, // KeyApp 中 main 等于 address
+            publicKey: acc.publicKey || '',
+            privateKey: '', // 不暴露私钥
+            magic: '',
+            signMessage: '',
+        }))
+    } catch (error) {
+        console.error('[dweb-compat] getWalleterAddresss error:', error)
+        return null
+    }
+}
+
+/**
+ * 验证地址导入
+ * 
+ * 对应 dweb 的 verifyAddressImport
+ */
+export async function verifyAddressImport(
+    _mmid: `${string}.dweb`,
+    opts: { address: string; message: string; chainName: $CHAIN_NAME }
+): Promise<boolean> {
+    try {
+        const signature = await bioRequest<string>('bio_signMessage', {
+            address: opts.address,
+            message: opts.message,
+            chain: opts.chainName,
+        })
+        return typeof signature === 'string' && signature.length > 0
+    } catch {
+        return false
+    }
+}

package/src/bridge.ts

@@ -0,0 +1,68 @@
+/**
+ * PostMessage Bridge - 与 KeyApp Bio Provider 通信
+ */
+
+let requestId = 0
+
+export interface BioResponse<T = unknown> {
+    success: boolean
+    result?: T
+    error?: { code: number; message: string }
+}
+
+/**
+ * 发送 bio_request 到 KeyApp 宿主
+ */
+export function bioRequest<T>(method: string, params?: unknown): Promise<T> {
+    return new Promise((resolve, reject) => {
+        const id = `dweb_compat_${++requestId}_${Date.now()}`
+
+        const handler = (event: MessageEvent) => {
+            const data = event.data
+            if (data?.type === 'bio_response' && data.id === id) {
+                window.removeEventListener('message', handler)
+                if (data.success) {
+                    resolve(data.result as T)
+                } else {
+                    const error = new Error(data.error?.message || 'Unknown error')
+                        ; (error as Error & { code?: number }).code = data.error?.code
+                    reject(error)
+                }
+            }
+        }
+
+        window.addEventListener('message', handler)
+
+        // 发送请求到父窗口 (KeyApp)
+        const message = {
+            type: 'bio_request',
+            id,
+            method,
+            params: params !== undefined ? [params] : [],
+        }
+
+        // 优先发送到 parent (iframe 模式)，否则通过 self (web worker 或独立模式)
+        const target = window.parent !== window ? window.parent : window
+        target.postMessage(message, '*')
+
+        // 超时处理 (60 秒)
+        setTimeout(() => {
+            window.removeEventListener('message', handler)
+            reject(new Error(`Request timeout: ${method}`))
+        }, 60000)
+    })
+}
+
+/**
+ * 监听来自 KeyApp 的事件
+ */
+export function onBioEvent(event: string, callback: (...args: unknown[]) => void): () => void {
+    const handler = (e: MessageEvent) => {
+        if (e.data?.type === 'bio_event' && e.data.event === event) {
+            callback(...(e.data.args || []))
+        }
+    }
+
+    window.addEventListener('message', handler)
+    return () => window.removeEventListener('message', handler)
+}

package/src/crypto-token.ts

@@ -0,0 +1,196 @@
+/**
+ * Crypto Token API 封装
+ * 
+ * 提供 Token 授权和加密操作的便捷函数
+ */
+
+import { bioRequest } from './bridge'
+
+// ==================== 类型定义 ====================
+
+export type CryptoAction = 'asymmetricEncrypt' | 'sign'
+export type TokenDuration = '5min' | '15min' | '1hour' | '1day'
+
+export interface RequestCryptoTokenParams {
+    actions: CryptoAction[]
+    duration: TokenDuration
+    address: string
+}
+
+export interface RequestCryptoTokenResponse {
+    tokenId: string
+    sessionSecret: string
+    expiresAt: number
+    grantedActions: CryptoAction[]
+}
+
+export interface AsymmetricEncryptParams {
+    data: string
+    recipientPublicKey: string
+}
+
+export interface SignParams {
+    data: string
+}
+
+export interface CryptoExecuteResponse {
+    result: string
+    publicKey: string
+}
+
+// ==================== Token 操作 ====================
+
+/**
+ * 请求加密操作授权
+ * 
+ * 用户需要输入手势密码确认授权
+ * 
+ * @param actions 需要的操作权限
+ * @param duration 授权时长
+ * @param address 使用的地址
+ * @param chainId 链 ID（可选，用于 UI 显示）
+ */
+export async function requestCryptoToken(
+    actions: CryptoAction[],
+    duration: TokenDuration,
+    address: string,
+    chainId?: string
+): Promise<RequestCryptoTokenResponse> {
+    return bioRequest<RequestCryptoTokenResponse>('bio_requestCryptoToken', {
+        actions,
+        duration,
+        address,
+        chainId,
+    })
+}
+
+/**
+ * 使用 Token 执行非对称加密
+ */
+export async function asymmetricEncrypt(
+    tokenId: string,
+    sessionSecret: string,
+    data: string,
+    recipientPublicKey: string
+): Promise<CryptoExecuteResponse> {
+    return bioRequest<CryptoExecuteResponse>('bio_cryptoExecute', {
+        tokenId,
+        sessionSecret,
+        action: 'asymmetricEncrypt',
+        params: { data, recipientPublicKey },
+    })
+}
+
+/**
+ * 使用 Token 执行签名
+ */
+export async function signData(
+    tokenId: string,
+    sessionSecret: string,
+    data: string
+): Promise<CryptoExecuteResponse> {
+    return bioRequest<CryptoExecuteResponse>('bio_cryptoExecute', {
+        tokenId,
+        sessionSecret,
+        action: 'sign',
+        params: { data },
+    })
+}
+
+// ==================== RWA 登录便捷函数 ====================
+
+export interface RwaLoginResult {
+    /** 钱包地址 */
+    address: string
+    /** 用户公钥 (Buffer) */
+    publicKey: Buffer
+    /** 加密的 signcode (Buffer) */
+    signcode: Buffer
+}
+
+/**
+ * 将各种格式的公钥转换为 hex 字符串
+ */
+function normalizeToHex(input: unknown): string {
+    if (typeof input === 'string') {
+        return input
+    }
+    // { type: 'Buffer', data: [...] } 格式
+    if (input && typeof input === 'object' && 'type' in input && 'data' in input) {
+        const bufferLike = input as { type: string; data: number[] }
+        if (bufferLike.type === 'Buffer' && Array.isArray(bufferLike.data)) {
+            return Buffer.from(bufferLike.data).toString('hex')
+        }
+    }
+    // Uint8Array 或 number[]
+    if (Array.isArray(input) || input instanceof Uint8Array) {
+        return Buffer.from(input as ArrayLike<number>).toString('hex')
+    }
+    // Buffer
+    if (Buffer.isBuffer(input)) {
+        return input.toString('hex')
+    }
+    throw new Error(`Invalid input format: ${typeof input}`)
+}
+
+/**
+ * RWA Hub 登录
+ * 
+ * 封装了完整的 RWA 登录流程：
+ * 1. 获取钱包地址
+ * 2. 请求加密授权
+ * 3. 执行非对称加密生成 signcode
+ * 
+ * @param systemPublicKey 系统公钥，支持 hex 字符串、Buffer 对象或字节数组
+ */
+export async function rwaLogin(
+    systemPublicKey: unknown
+): Promise<RwaLoginResult> {
+    const systemPubKeyHex = normalizeToHex(systemPublicKey)
+    // BFMeta 相关链的所有可能名称
+    const BFMETA_CHAINS = ['bfmeta', 'bfchainv2', 'bioforest', 'bfmchain', 'bfchain']
+
+    // 1. 获取钱包地址（指定 BFMeta 链）
+    const accounts = await bioRequest<Array<{ address: string; chain: string; publicKey?: string }>>(
+        'bio_requestAccounts',
+        { chain: 'bfmeta' }  // RWA Hub 需要 BFMeta 链
+    )
+
+    if (!accounts || accounts.length === 0) {
+        throw new Error('No accounts available')
+    }
+
+    // 找到 BFMeta 系列链的地址
+    const account = accounts.find(a => {
+        const chain = a.chain.toLowerCase()
+        return BFMETA_CHAINS.includes(chain)
+    })
+    if (!account) {
+        const chains = accounts.map(a => a.chain).join(', ')
+        throw new Error(`BFMeta account not found. Available chains: ${chains}`)
+    }
+
+    // 2. 请求加密授权（用户输入手势密码）- 使用实际选中的链 ID
+    const { tokenId, sessionSecret } = await requestCryptoToken(
+        ['asymmetricEncrypt'],
+        '5min',
+        account.address,
+        account.chain  // 使用账户实际的链 ID
+    )
+
+    // 3. 执行非对称加密生成 signcode
+    const timestamp = Date.now().toString()
+    const { result, publicKey } = await asymmetricEncrypt(
+        tokenId,
+        sessionSecret,
+        timestamp,
+        systemPubKeyHex
+    )
+
+    // 返回 Buffer 格式，与 RWA 后端期望一致
+    return {
+        address: account.address,
+        publicKey: Buffer.from(publicKey, 'hex'),
+        signcode: Buffer.from(result, 'hex'),
+    }
+}

package/src/index.ts

@@ -0,0 +1,63 @@
+/**
+ * @biochain/dweb-compat
+ * 
+ * dweb-plaoc 到 KeyApp bio provider 的兼容适配器
+ * 
+ * 提供与 @nilai/dweb-plaoc 相同的 API 接口，
+ * 底层通过 postMessage 调用 KeyApp Bio Provider
+ */
+
+// 核心功能
+export { getWalleterAddresss, verifyAddressImport } from './address'
+export { getExternalAppData } from './signature'
+
+// Crypto Token API
+export {
+    requestCryptoToken,
+    asymmetricEncrypt,
+    signData,
+    rwaLogin,
+} from './crypto-token'
+export type {
+    CryptoAction,
+    TokenDuration,
+    RequestCryptoTokenParams,
+    RequestCryptoTokenResponse,
+    AsymmetricEncryptParams,
+    SignParams,
+    CryptoExecuteResponse,
+    RwaLoginResult,
+} from './crypto-token'
+
+// 类型和常量
+export {
+    $WALLET_PLAOC_PATH,
+    $WALLET_SIGNATURE_TYPE,
+    $WALLET_AUTHORIZE_ADDRESS_TYPE,
+} from './types'
+export type {
+    $CHAIN_NAME,
+    $WALLET_SIGNATURE_TRANSFER,
+    $WALLET_SIGNATURE_MESSAGE,
+    $WALLET_SIGNATURE_JSON,
+    $WALLET_SIGNATURE_DESTORY_ASSET,
+    $WALLET_SIGNATURE_PARAMETER,
+    $WalletGetAddressResponse,
+    $WalletSignatureResponse,
+    DwebAppConfig,
+} from './types'
+
+// 空操作函数
+export {
+    canOpenUrl,
+    focusWindow,
+    appMaximize,
+    appVersionUpdate,
+    browserOpen,
+    restart,
+    getDwebAppDownUrl,
+    gotoDwebAppMarketDownLoad,
+    CorrecDwebAppLang,
+    listenerBackButton,
+    dwebAppConfig,
+} from './noop'

package/src/is-dweb.ts

@@ -0,0 +1,33 @@
+/**
+ * @plaoc/is-dweb 兼容层
+ * 
+ * 在 miniapp 模式下返回 false
+ */
+
+/**
+ * 判断是否在 dweb 环境
+ */
+export function isDweb(): boolean {
+    return false
+}
+
+/**
+ * 获取 dweb 大版本
+ */
+export function dwebTarget(): number {
+    return 0
+}
+
+/**
+ * 判断是否移动端
+ */
+export function isMobile(): boolean {
+    const nav = navigator as Navigator & { userAgentData?: { mobile: boolean } }
+    if (typeof navigator !== 'undefined' && nav.userAgentData) {
+        return !!nav.userAgentData.mobile
+    }
+    // 降级到 UA 检测
+    return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(
+        navigator.userAgent
+    )
+}

package/src/noop.ts

@@ -0,0 +1,145 @@
+/**
+ * 空操作函数
+ * 
+ * 这些函数在 dweb 环境中有实际功能，但在 miniapp 中不需要
+ */
+
+import type { DwebAppConfig } from './types'
+
+/**
+ * 检查应用是否可打开
+ * 
+ * 在 miniapp 模式下总是返回 true，因为钱包功能由宿主提供
+ */
+export function canOpenUrl(_mmid: `${string}.dweb`): Promise<{ success: boolean }> {
+    return Promise.resolve({ success: true })
+}
+
+/**
+ * 聚焦窗口
+ * 
+ * 在 miniapp 模式下不需要此操作
+ */
+export function focusWindow(): Promise<Response> {
+    return Promise.resolve(new Response())
+}
+
+/**
+ * 窗口最大化
+ * 
+ * 在 miniapp 模式下不需要此操作
+ */
+export function appMaximize(): Promise<Response> {
+    return Promise.resolve(new Response())
+}
+
+/**
+ * 版本更新
+ * 
+ * 在 miniapp 模式下不支持
+ */
+export function appVersionUpdate(_metadataUrl: string): Window | null {
+    console.warn('[dweb-compat] appVersionUpdate is not supported in miniapp mode')
+    return null
+}
+
+/**
+ * 打开浏览器
+ * 
+ * 在 miniapp 模式下使用 window.open
+ */
+export function browserOpen(url: string, target?: string): Promise<Window | null> {
+    return Promise.resolve(window.open(url, target || '_blank'))
+}
+
+/**
+ * 重启应用
+ * 
+ * 在 miniapp 模式下刷新页面
+ */
+export function restart(): Promise<boolean> {
+    window.location.reload()
+    return Promise.resolve(true)
+}
+
+/**
+ * 获取 Dweb App 下载地址
+ * 
+ * 在 miniapp 模式下不需要下载钱包
+ */
+export function getDwebAppDownUrl(_info: {
+    marketUrl: string
+    name: string
+    applistJson: string
+}): Promise<{ downloadUrl?: string; marketUrl?: string }> {
+    return Promise.resolve({})
+}
+
+/**
+ * 跳转到应用商城下载
+ * 
+ * 在 miniapp 模式下不需要
+ */
+export function gotoDwebAppMarketDownLoad(_info: {
+    downloadUrl?: string
+    marketUrl?: string
+}): Promise<Window | null> {
+    console.warn('[dweb-compat] gotoDwebAppMarketDownLoad is not supported in miniapp mode')
+    return Promise.resolve(null)
+}
+
+/**
+ * 矫正语言
+ */
+export function CorrecDwebAppLang(lang?: string): Promise<string> {
+    return Promise.resolve(lang || navigator.language)
+}
+
+/**
+ * 监听硬件返回按钮
+ * 
+ * 在 miniapp 模式下使用浏览器历史 API
+ */
+export function listenerBackButton(callback: () => void): void {
+    window.addEventListener('popstate', callback)
+}
+
+/**
+ * DwebApp 配置
+ * 
+ * 在 miniapp 模式下返回空配置
+ */
+export const dwebAppConfig = {
+    XPay(_alpha = false): DwebAppConfig {
+        return {
+            mmid: 'pay.nikola-x.com.dweb',
+            name: 'X Pay',
+            marketUrl: '',
+            applistJson: '',
+        }
+    },
+    BIWMeta(_alpha = false): DwebAppConfig {
+        return {
+            mmid: 'biw-meta.com.dweb',
+            name: 'BIWMeta',
+            marketUrl: '',
+            applistJson: '',
+        }
+    },
+    BFMPay(_alpha = false): DwebAppConfig {
+        return {
+            mmid: 'pay.bfmeta.info.dweb',
+            name: 'BFM Pay',
+            marketUrl: '',
+            applistJson: '',
+        }
+    },
+    NiLai(_alpha = false): DwebAppConfig {
+        return {
+            mmid: 'www.ni-lai.com.dweb',
+            name: 'NiLai',
+            marketUrl: '',
+            applistJson: '',
+        }
+    },
+}

package/src/plugins-stub.ts

@@ -0,0 +1,36 @@
+/**
+ * @plaoc/plugins 存根
+ * 
+ * 在 miniapp 模式下提供空实现
+ */
+
+// 导出空的 dwebServiceWorker
+export const dwebServiceWorker = {
+    fetch: () => Promise.reject(new Error('dwebServiceWorker is not available in miniapp mode')),
+    has: () => Promise.resolve(false),
+    close: () => Promise.resolve(false),
+    restart: () => Promise.resolve(false),
+    clearCache: () => Promise.resolve(),
+}
+
+// 导出空的 windowPlugin
+export const windowPlugin = {
+    maximize: () => Promise.resolve(new Response()),
+    focusWindow: () => Promise.resolve(new Response()),
+}
+
+// 导出空的 configPlugin
+export const configPlugin = {
+    getLang: () => Promise.resolve(navigator.language),
+    setLang: () => Promise.resolve(true),
+}
+
+// 为了兼容性导出类型
+export class WebSocketIpcBuilder {
+    constructor(_url: URL, _config: unknown) { }
+    get ipc() {
+        return {
+            request: () => Promise.reject(new Error('WebSocketIpc is not available in miniapp mode')),
+        }
+    }
+}

package/src/signature.ts

@@ -0,0 +1,195 @@
+/**
+ * 签名适配
+ * 
+ * 将 dweb 的 getExternalAppData(signature, [...]) 转换为 KeyApp 的 bio_* 方法
+ */
+
+import { bioRequest } from './bridge'
+import {
+    $WALLET_PLAOC_PATH,
+    $WALLET_SIGNATURE_TYPE,
+    type $WALLET_SIGNATURE_PARAMETER,
+    type $WALLET_PLAOC_PATH_RESPONSE,
+} from './types'
+
+/** 转账响应 */
+interface TransferResponse {
+    txId: string
+    transaction: string | object
+}
+
+/**
+ * 调用外部 App 获取数据
+ * 
+ * 对应 dweb 的 getExternalAppData(mmid, pathname, search)
+ */
+export function getExternalAppData<T extends keyof $WALLET_PLAOC_PATH_RESPONSE>(
+    _mmid: `${string}.dweb`,
+    pathname: T,
+    params?: unknown
+) {
+    const dataPromise = executeRequest<$WALLET_PLAOC_PATH_RESPONSE[T]>(pathname, params)
+
+    return {
+        getData: (): Promise<$WALLET_PLAOC_PATH_RESPONSE[T]> => dataPromise,
+        abort: (): void => {
+            // postMessage 请求不支持中止，这里只是兼容接口
+            console.warn('[dweb-compat] abort is not supported in miniapp mode')
+        },
+    }
+}
+
+async function executeRequest<T>(pathname: string, params: unknown): Promise<T> {
+    switch (pathname) {
+        case $WALLET_PLAOC_PATH.signature:
+            if (Array.isArray(params)) {
+                const results = await Promise.all(params.map(handleSignatureParam))
+                return results as T
+            }
+            throw new Error('Invalid signature params: expected array')
+
+        case $WALLET_PLAOC_PATH.getAddress:
+            // 地址请求走 address.ts 的 getWalleterAddresss
+            throw new Error('Use getWalleterAddresss for address requests')
+
+        case $WALLET_PLAOC_PATH.stakeAsset:
+            // 锻造功能暂不支持
+            throw new Error('stakeAsset is not supported in miniapp mode')
+
+        default:
+            throw new Error(`Unknown pathname: ${pathname}`)
+    }
+}
+
+async function handleSignatureParam(
+    param: $WALLET_SIGNATURE_PARAMETER
+): Promise<TransferResponse | string | object | null> {
+    switch (param.type) {
+        case $WALLET_SIGNATURE_TYPE.transfer:
+            return handleTransfer(param)
+
+        case $WALLET_SIGNATURE_TYPE.message:
+            return handleMessage(param)
+
+        case $WALLET_SIGNATURE_TYPE.json:
+            return handleJsonSign(param)
+
+        case $WALLET_SIGNATURE_TYPE.destory:
+            return handleDestroy(param)
+
+        case $WALLET_SIGNATURE_TYPE.assetTypeBalance:
+            return handleGetBalance(param)
+
+        case $WALLET_SIGNATURE_TYPE.contract:
+            return handleContract(param)
+
+        default:
+            console.error('[dweb-compat] Unsupported signature type:', (param as { type: number }).type)
+            return { error: true, message: `Unsupported signature type: ${(param as { type: number }).type}` }
+    }
+}
+
+async function handleTransfer(param: {
+    chainName: string
+    senderAddress: string
+    receiveAddress: string
+    balance: string
+    assetType?: string
+    contractInfo?: { contractAddress: string; assetType: string; decimals: number | string }
+}): Promise<TransferResponse> {
+    const result = await bioRequest<{ txHash: string; transaction?: object }>('bio_sendTransaction', {
+        from: param.senderAddress,
+        to: param.receiveAddress,
+        amount: param.balance,
+        chain: param.chainName,
+        asset: param.assetType,
+        contractInfo: param.contractInfo,
+    })
+
+    return {
+        txId: result.txHash,
+        transaction: result.transaction || result.txHash,
+    }
+}
+
+async function handleMessage(param: {
+    chainName: string
+    senderAddress: string
+    message: string
+}): Promise<string> {
+    const signature = await bioRequest<string>('bio_signMessage', {
+        address: param.senderAddress,
+        message: param.message,
+        chain: param.chainName,
+    })
+    return signature
+}
+
+async function handleJsonSign(param: {
+    chainName: string
+    senderAddress: string
+    json: object
+    jsonInterpolation?: Array<{ path: string; index: 0 | 1 }>
+}): Promise<TransferResponse> {
+    const result = await bioRequest<{ txId: string; transaction: object }>('bio_signTypedData', {
+        address: param.senderAddress,
+        data: param.json,
+        chain: param.chainName,
+        interpolation: param.jsonInterpolation,
+    })
+    return result
+}
+
+async function handleDestroy(param: {
+    chainName: string
+    senderAddress: string
+    assetType: string
+    destoryAmount: string
+}): Promise<TransferResponse> {
+    const result = await bioRequest<{ txId: string; transaction: object }>('bio_destroyAsset', {
+        address: param.senderAddress,
+        chain: param.chainName,
+        assetType: param.assetType,
+        amount: param.destoryAmount,
+    })
+    return result
+}
+
+async function handleGetBalance(param: {
+    chainName: string
+    senderAddress: string
+    assetTypes: Array<{ assetType: string; contractAddress?: string }>
+}): Promise<Record<string, { assetType: string; decimals: number; balance: string }>> {
+    const result = await bioRequest<Record<string, { assetType: string; decimals: number; balance: string }>>(
+        'bio_getBalance',
+        {
+            address: param.senderAddress,
+            chain: param.chainName,
+            assets: param.assetTypes,
+        }
+    )
+    return result
+}
+
+async function handleContract(param: {
+    chainName: string
+    senderAddress: string
+    receiveAddress: string
+    methods: string
+    params: unknown[]
+    data: string
+    amount?: string
+}): Promise<TransferResponse> {
+    // 合约调用通过 bio_signTransaction
+    const result = await bioRequest<{ txId: string; signedTx: object }>('bio_signTransaction', {
+        from: param.senderAddress,
+        to: param.receiveAddress,
+        chain: param.chainName,
+        data: param.data,
+        value: param.amount || '0',
+    })
+    return {
+        txId: result.txId,
+        transaction: result.signedTx,
+    }
+}

package/src/tauri-stub.ts

@@ -0,0 +1,12 @@
+/**
+ * Tauri Plugin Opener Stub
+ * 
+ * 在 miniapp 模式下替代 @tauri-apps/plugin-opener
+ */
+
+/**
+ * 在浏览器中打开 URL
+ */
+export async function openUrl(url: string): Promise<void> {
+    window.open(url, '_blank')
+}

package/src/types.ts

@@ -0,0 +1,187 @@
+/**
+ * dweb-plaoc 类型定义
+ * 
+ * 从 @nilai/dweb-plaoc/types.ts 复制并简化
+ */
+
+/** 链名称类型 */
+export type $CHAIN_NAME =
+    | 'BFMeta'
+    | 'BFMetaV2'
+    | 'BIWMeta'
+    | 'Ethereum'
+    | 'Binance'
+    | 'Tron'
+
+/** API 路径 */
+export enum $WALLET_PLAOC_PATH {
+    /** 获取地址 */
+    getAddress = '/wallet/authorize/address',
+    /** 签名 */
+    signature = '/wallet/authorize/signature',
+    /** 锻造 */
+    stakeAsset = '/wallet/staking',
+}
+
+/** 地址授权类型 */
+export enum $WALLET_AUTHORIZE_ADDRESS_TYPE {
+    main = 'main',
+    network = 'network',
+    all = 'all',
+}
+
+/** 签名类型 */
+export enum $WALLET_SIGNATURE_TYPE {
+    /** 消息签名 */
+    message = 0,
+    /** 转账 */
+    transfer = 1,
+    /** 内链：凭证资产转移 */
+    bioforestChainCertificateTransfer = 2,
+    /** JSON 签名 */
+    json = 3,
+    /** 内链：同质化(非同质化)交易 */
+    ENTITY = 4,
+    /** 获取币种余额 */
+    assetTypeBalance = 5,
+    /** 调用智能合约 */
+    contract = 6,
+    /** 内链销毁 */
+    destory = 7,
+}
+
+/** 消息签名参数 */
+export interface $WALLET_SIGNATURE_MESSAGE {
+    type: typeof $WALLET_SIGNATURE_TYPE.message
+    chainName: $CHAIN_NAME
+    senderAddress: string
+    message: string
+}
+
+/** 转账签名参数 */
+export interface $WALLET_SIGNATURE_TRANSFER {
+    type: typeof $WALLET_SIGNATURE_TYPE.transfer
+    chainName: $CHAIN_NAME
+    assetType?: string
+    senderAddress: string
+    receiveAddress: string
+    privateKey?: string
+    balance: string
+    fee?: string
+    contractInfo?: {
+        contractAddress: string
+        assetType: string
+        decimals: number | string
+    }
+    remark?: Record<string, string>
+}
+
+/** JSON 签名参数 */
+export interface $WALLET_SIGNATURE_JSON {
+    type: typeof $WALLET_SIGNATURE_TYPE.json
+    chainName: $CHAIN_NAME
+    senderAddress: string
+    json: object
+    jsonInterpolation?: Array<{
+        path: string
+        index: 0 | 1
+    }>
+}
+
+/** 销毁资产参数 */
+export interface $WALLET_SIGNATURE_DESTORY_ASSET {
+    type: typeof $WALLET_SIGNATURE_TYPE.destory
+    chainName: $CHAIN_NAME
+    assetType: string
+    fee?: string
+    senderAddress: string
+    destoryAddress?: string
+    destoryAmount: string
+    remark?: Record<string, string>
+}
+
+/** 获取余额参数 */
+export interface $WALLET_ASSETTYPE_BALANCE {
+    type: typeof $WALLET_SIGNATURE_TYPE.assetTypeBalance
+    chainName: $CHAIN_NAME
+    senderAddress: string
+    assetTypes: Array<{
+        assetType: string
+        contractAddress?: string
+    }>
+}
+
+/** 合约调用参数 */
+export interface $WALLET_SIGNATURE_CONTRACT {
+    type: typeof $WALLET_SIGNATURE_TYPE.contract
+    chainName: $CHAIN_NAME
+    amount?: string
+    methods: string
+    params: unknown[]
+    senderAddress: string
+    receiveAddress: string
+    data: string
+    fee?: string
+    binanceGasInfo?: {
+        gasLimit: number | string
+        gasPrice: number | string
+    }
+    boradcast?: boolean
+    waitTrsInBlock?: boolean
+    waitTime?: number
+}
+
+/** 签名参数联合类型 */
+export type $WALLET_SIGNATURE_PARAMETER =
+    | $WALLET_SIGNATURE_MESSAGE
+    | $WALLET_SIGNATURE_DESTORY_ASSET
+    | $WALLET_SIGNATURE_TRANSFER
+    | $WALLET_SIGNATURE_JSON
+    | $WALLET_ASSETTYPE_BALANCE
+    | $WALLET_SIGNATURE_CONTRACT
+
+/** 地址响应 */
+export type $WalletGetAddressResponse = Array<{
+    name: string
+    chainName: $CHAIN_NAME
+    address: string
+    main: string
+    publicKey: string
+    privateKey: string
+    magic: string
+    signMessage?: string
+}>
+
+/** 签名响应 */
+export type $WalletSignatureResponse = Array<
+    | string
+    | object
+    | { txId: string; transaction: string | object }
+    | { [assetType: string]: { assetType: string; decimals: number; balance: string; contracts?: string } }
+    | null
+    | { error: boolean; message: string }
+>
+
+/** API 响应类型映射 */
+export type $WALLET_PLAOC_PATH_RESPONSE = {
+    [$WALLET_PLAOC_PATH.getAddress]: $WalletGetAddressResponse | null
+    [$WALLET_PLAOC_PATH.signature]: $WalletSignatureResponse | null
+    [$WALLET_PLAOC_PATH.stakeAsset]: {
+        address: string
+        orderId: string
+        stakeAssetType: string
+        stakeChainName: $CHAIN_NAME
+        stakeAmount: string
+        mintAssetType: string
+        mintChainName: $CHAIN_NAME
+        mintAmount: string
+    } | null
+}
+
+/** DwebApp 配置 */
+export interface DwebAppConfig {
+    mmid: `${string}.dweb`
+    name: string
+    marketUrl: string
+    applistJson: string
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../../tsconfig.app.json",
+    "compilerOptions": {
+        "rootDir": "./src",
+        "outDir": "./dist"
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": []
+}