React中使用Run:Network与Bitcoin SV时扩展Run.Jig遇断言错误

1. 确认版本兼容性 #

Run SDK与bsv库的版本匹配是关键，不同版本的类继承逻辑存在差异：

• 执行命令查看当前安装版本：

  npm list run-sdk bsv
  

• 建议锁定稳定兼容版本，比如run-sdk@0.13.1搭配bsv@1.5.6，这组版本在React环境下的Jig继承逻辑更可靠。

2. 调整Jig子类的创建方式 #

React模块系统可能干扰Run SDK的原生类继承，改用官方推荐的extend方法创建子类：

import Run from 'run-sdk'

// 用Run.Jig.extend替代class继承
const SimpleStore = Run.Jig.extend({
  init() {
    this.data = {}
  },
  set(key, value) {
    this.data[key] = value
    this.sync()
  }
})

// 实例化时必须关联Run环境
const run = new Run({ network: 'test' })
const store = new SimpleStore(null, { run })
store.set('testKey', 'testValue')

3. 修复打包工具的代码篡改问题 #

React的Webpack/Vite打包可能破坏Run SDK的类结构，添加配置排除相关库的优化：

• Webpack（webpack.config.js）：

  module.exports = {
    resolve: {
      alias: {
        'run-sdk': require.resolve('run-sdk'),
        'bsv': require.resolve('bsv')
      }
    }
  }
  

• Vite（vite.config.js）：

  export default {
    optimizeDeps: {
      exclude: ['run-sdk', 'bsv']
    }
  }
  

4. 定位断言错误的具体原因 #

如果以上步骤无效，捕获错误栈信息排查问题：

try {
  const run = new Run({ network: 'test' })
  const store = new SimpleStore(null, { run })
  store.set('key', 'val')
} catch (e) {
  console.error('断言错误详情:', e)
  console.error('错误栈:', e.stack)
}

多数断言错误源于Jig实例未正确关联Run环境，或原型链被打包工具篡改。

内容的提问来源于stack exchange，提问作者Milos