【p2p、分布式，区块链笔记 Torrent】WebTorrent的add和seed函数

• 在【p2p、分布式，区块链笔记 Torrent】WebTorrent的上传和下载界面的示例中，主要通过WebTorrent类的add和seed函数实现相关功能。这两个函数都返回一个Torrent类对象的实例。

seed函数

import createTorrent, { parseInput } from 'create-torrent' // "create-torrent": "^6.0.18"

  /**
   * Start seeding a new file/folder.
   * @param  {string|File|FileList|Buffer|Array.<string|File|Buffer>} input
   * @param  {Object=} opts
   * @param  {function=} onseed called when torrent is seeding
   */
  seed (input, opts, onseed) {
    if (this.destroyed) throw new Error('client is destroyed')
    if (typeof opts === 'function') [opts, onseed] = [{}, opts]

    this._debug('seed')
    opts = opts ? Object.assign({}, opts) : {}

    // no need to verify the hashes we create
    opts.skipVerify = true

    const isFilePath = typeof input === 'string'

    // When seeding from fs path, initialize store from that path to avoid a copy
    if (isFilePath) opts.path = path.dirname(input)
    if (!opts.createdBy) opts.createdBy = `WebTorrent/${VERSION_STR}`

    const onTorrent = torrent => {
      const tasks = [
        cb => {
          // when a filesystem path is specified or the store is preloaded, files are already in the FS store
          if (isFilePath || opts.preloadedStore) return cb()
          torrent.load(streams, cb)
        }
      ]
      if (this.dht) {
        tasks.push(cb => {
          torrent.once('dhtAnnounce', cb)
        })
      }
      parallel(tasks, err => {
        if (this.destroyed) return
        if (err) return torrent._destroy(err)
        _onseed(torrent)
      })
    }

    const _onseed = torrent => {
      this._debug('on seed')
      if (typeof onseed === 'function') onseed(torrent)
      torrent.emit('seed')
      this.emit('seed', torrent)
    }

    const torrent = this.add(null, opts, onTorrent)
    let streams

    if (isFileList(input)) input = Array.from(input)
    else if (!Array.isArray(input)) input = [input]

    parallel(input.map(item => async cb => {
      if (!opts.preloadedStore && isReadable(item)) {
        const chunks = []
        try {
          for await (const chunk of item) {
            chunks.push(chunk)
          }
        } catch (err) {
          return cb(err)
        }
        const buf = concat(chunks)
        buf.name = item.name
        cb(null, buf)
      } else {
        cb(null, item)
      }
    }), (err, input) => {
      if (this.destroyed) return
      if (err) return torrent._destroy(err)

      parseInput(input, opts, (err, files) => {
        if (this.destroyed) return
        if (err) return torrent._destroy(err)

        streams = files.map(file => file.getStream)

        createTorrent(input, opts, async (err, torrentBuf) => {
          if (this.destroyed) return
          if (err) return torrent._destroy(err)

          const existingTorrent = await this.get(torrentBuf)
          if (existingTorrent) {
            console.warn('A torrent with the same id is already being seeded')
            torrent._destroy()
            if (typeof onseed === 'function') onseed(existingTorrent)
          } else {
            torrent._onTorrentId(torrentBuf)
          }
        })
      })
    })

    return torrent
  }

• 代码中的关键一句是：

const torrent = this.add(null, opts, onTorrent)

• 函数最终返回生成的 torrent 对象，其由add函数创建（第一个参数为null），代表正在进行 seeding 的种子。
• 这句代码实际上启动了种子（torrent）的创建和处理过程。它调用了 this.add() 方法，将 opts 和 onTorrent 回调传递进去，这些回调负责在种子完成处理时执行进一步的操作。
• 另一个关键的一句是

createTorrent(input, opts, async (err, torrentBuf) => {……})

• 调用 createTorrent 生成种子文件，并通过 onTorrent 处理后续操作（如 DHT 发布广播等）

• DHT 广播的过程发生在 onTorrent 回调中的这段代码部分：

if (this.dht) {// DHT 是否启用
  tasks.push(cb => { // 将一个任务推送到任务队列tasks 中
    torrent.once('dhtAnnounce', cb) // 监听torrent对象的dhtAnnounce事件。once意味着该事件处理器仅会触发一次，当dhtAnnounce事件发生时，执行回调 `cb`。
  })
}

• 当种子（torrent）开始上传并与其他节点建立连接时，WebTorrent 会尝试将种子信息通过 DHT 广播出去，允许其他客户端在没有 Tracker 的情况下发现这个种子。
• torrent.once('dhtAnnounce', cb) 监听的是这个广播完成后的通知，当种子成功通过 DHT 被宣布时，cb 被执行，表示广播成功。

parallel(tasks, err => {
  if (this.destroyed) return
  if (err) return torrent._destroy(err)
  _onseed(torrent)
})

• parallel(tasks, cb) 用来并行执行所有任务，确保所有操作（如文件加载、DHT 广播等）都执行完毕后再继续。
• 如果没有错误发生，_onseed(torrent) 会被调用，表示种子已经开始上传，并且相关事件会被触发。

add函数

/**
   * Start downloading a new torrent. Aliased as `client.download`.
   * @param {string|Buffer|Object} torrentId
   * @param {Object} opts torrent-specific options
   * @param {function=} ontorrent called when the torrent is ready (has metadata)
   */
  add (torrentId, opts = {}, ontorrent = () => {}) {
    if (this.destroyed) throw new Error('client is destroyed')
    if (typeof opts === 'function') [opts, ontorrent] = [{}, opts]

    const onInfoHash = () => {
      if (this.destroyed) return
      for (const t of this.torrents) {
        if (t.infoHash === torrent.infoHash && t !== torrent) {
          torrent._destroy(new Error(`Cannot add duplicate torrent ${torrent.infoHash}`))
          ontorrent(t)
          return
        }
      }
    }

    const onReady = () => {
      if (this.destroyed) return
      ontorrent(torrent)
      this.emit('torrent', torrent)
    }

    function onClose () {
      torrent.removeListener('_infoHash', onInfoHash)
      torrent.removeListener('ready', onReady)
      torrent.removeListener('close', onClose)
    }

    this._debug('add')
    opts = opts ? Object.assign({}, opts) : {}

    const torrent = new Torrent(torrentId, this, opts)  // Create a new Torrent instance using the provided torrentId, current client (`this`), and options (`opts`).
    this.torrents.push(torrent) //Add the new torrent to the list of active torrents.

    torrent.once('_infoHash', onInfoHash)  //监听 _infoHash 事件来检查是否存在重复的种子。
    torrent.once('ready', onReady)  // 监听 ready 事件，当种子准备好时执行回调。
    torrent.once('close', onClose)  // 监听 close 事件，清理资源和事件监听器。

    this.emit('add', torrent)
    return torrent
  }

• 关键一句是：

const torrent = new Torrent(torrentId, this, opts)

• 这行代码负责创建一个新的 Torrent 实例，并将其添加到当前 WebTorrent 客户端中，开始处理指定的种子。Torrent类定义在 lib\torrent.js中。相关接口与功能可见docs\api.md的Torrent部分
• 以下是对 torrent 方法的简单总结，使用表格呈现：

torrent & wire

• torrent.on(‘wire’, function (wire) {}) 是在 WebTorrent 客户端中，当一个新的对等体（peer）连接时，触发的事件。当这个事件被触发时，wire 会作为参数传递给回调函数。wire 是一个 bittorrent-protocol 的实例，这是一个用于实现 BitTorrent 协议的 duplex 流（双向流），允许客户端与远程对等体（peer）进行数据交换。

• 以下是一个示例：

import MyExtension from './my-extension'

torrent1.on('wire', (wire, addr) => {
  console.log('connected to peer with address ' + addr)
  wire.use(MyExtension)
})

• 实际上torrent中管理者相关的链接对象，如以下代码所示：

client.add(opts.magnetURI,torrent => {
				const wire = torrent.wires[0];
				wire.use(MyExtension());
				wire.MyExtension.on('hack_message', func);
			    })

client.seed(buf, torrent => {
	torrent.on('wire', (wire, addr) => {
	wire.use(MyExtension());
	wire.MyExtension.on('hack_message', func);
	}
})

• wires 是一个数组，包含与该种子相关的所有 wire 对象。每个 wire 代表与一个对等体（peer）之间的连接。torrent.wires[0] 代表与第一个对等体（peer）建立的连接（wire）。