基于 MixinNetwork 开发一个小助理

最新推荐文章于 2024-10-08 15:08:44 发布
最新推荐文章于 2024-10-08 15:08:44 发布
阅读量242 收藏
点赞数
分类专栏： Mixin 文章标签： node.js 区块链
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_41884153/article/details/120570817
版权
本文档详细介绍了如何开发一个Mixin小助手，包括与用户通过user_id和identity_number交互，查询资产信息，实现签到、打赏功能，以及处理/donate和/claim命令。教程涵盖项目搭建、WebSocket连接、用户和资产查询逻辑，以及消息回复的实现。通过此教程，开发者可以熟悉Mixin Messenger的API和交互流程。
摘要由CSDN通过智能技术生成

Mixin 小助理开发

github仓库请点击

视频教程请点击

本仓库旨在为学习 mixin messenger 的开发。
学习完，将会熟悉

  • 通过机器人与 mixin messenger 的用户进行消息通信
  • 根据 user_id/identity_number 获取用户详情
  • 根据 asset_id/symbol 查询 mixin network 的资产详情
  • 根据 日期、机器人id、用户id，构建唯一的转账 id
  • 通过机器人跟用户转账
  • 将 url 构建成二维码，然后上传到 mixin 服务器，并发送给用户
  • 文章消息/文本消息/图片消息/联系人消息/按钮消息 的发送
  • 通过按钮组来让用户选择输入。

1. 小助理介绍

（小助理机器人ID： 7000101422）主要是提供消息触发的服务机制。支持如下功能：

  • 用户相关：发送 user_id 或 identity_number 回复指定用户的卡片及相关信息
  • 资产相关：发送 asset_id 或者 symbol 回复指定资产相关信息

2. 课程大纲

  1. 项目搭建与初始化 sdk
  2. 完成用户相关逻辑
  3. 完成资产相关逻辑
  4. 完成签到相关逻辑
  5. 完成打赏相关逻辑
  6. 完成帮助相关逻辑
  7. 组装上述逻辑

3. 正式开始开发

3.1 项目搭建 与 websocket sdk引入
  1. 项目搭建与初始化

打开终端初始化项目

mkdir mixin-course-assistant
cd mixin-course-assistant
npm init -y
npm install mixin-node-sdk
  1. 在根目录下添加环境变量 config.json
    /config.json
{
  "pin": "",
  "client_id": "",
  "session_id": "",
  "pin_token": "",
  "private_key": ""
}

  1. 在根目录下创建 index.js

  2. 由于是消息服务，所以我们得连接 Mixin 的 websocket 用于接受消息

const { BlazeClient } = require('mixin-node-sdk')
const config = require('./config.json')

// 这里的 parse:true 是sdk来解析 base64 的消息
// 这里的 syncAck:true 是sdk来帮我们 ack 消息
const client = new BlazeClient(config, { parse: true, syncAck: true })

client.loopBlaze({
  onMessage(msg) {
    console.log(msg)
  },
  // 我们不处理 ack 的消息，所以放一个空函数，这样就不会走到 onMessage 的逻辑里
  onAckReceipt() {
  }
})
  1. 测试消息服务
    打开终端
node index.js

打开手机跟自己的机器人发一条消息。看终端是否能打印出发送的消息。如果能，说明 websocket 连接成功。

2. 编写 user_id 和 identity_number 的用户查询
  1. 逻辑分析
    • 用户给机器人发送 user_id 或 identity_number
    • 机器人收到消息后，进行查询。
    • 如果没查到，说明用户的输入错误，结束。
    • 如果查到了，则给用户发送卡片、转账button、转账二维码。
    • 如果确认用户输入的是 identity_number ，则再多给用户发送一条 user_id
  2. 代码实现
const QRCode = require('qrcode')
/**
 * 处理 identity_number 或者 user_id
 * 1. 联系人卡片 2. transfer btn 3. transfer qrcode 4. identity_number -> user_id
 * @returns {boolean} 如果判断成功，那么回复消息并返回 true，否则返回 false
 * @param {{data: '', user_id: ''}} msg 
 */
async function handleUser({ data, user_id }) {
  const user = await client.readUser(data) // 根据用户的输入来查询 user
  if (user && user.user_id) { // 走到这里说明 user 已经查询到了。
    const transferAction = `mixin://transfer/${user.user_id}` // 定义一个 transfer 的 schema 后边要用，
    // 这里同时发送3-4条消息所以使用 promise.all
    Promise.all([
      client.sendContactMsg( // 给用户发送联系人卡片
        user_id,
        { user_id: user.user_id }
      ),
      client.sendAppButtonMsg( // 给用户发送转账的 button
        user_id,
        [
          {
            label: `Transfer to ${user.full_name}`,
            action: transferAction,
            color: '#000'
          }
        ]
      ),
      new Promise(resolve => { // 给用户发送转账的二维码
        QRCode.toBuffer( // 将 transferAction -> jpeg 的 buf
          transferAction,
          async (err, buf) => {
            const { attachment_id } = await client.uploadFile(buf) // 上传 buf
            await client.sendImageMsg(user_id, { // 发送图片消息
              attachment_id, // 资源id
              mime_type: "image/jpeg", 
              width: 300,
              height: 300,
              size: buf.length,
              thumbnail: Buffer.from(buf).toString('base64'), // 封面， buf 的base64
            })
            resolve()
          })
      }),
      new Promise(async resolve => { // 如果用户查询的是 identity_number 的话，则给用户发送 user_id
        if (String(data) === user.identity_number)
          await client.sendTextMsg(user_id, user.user_id)
        resolve()
      })
    ])
    return true
  }
  return false
}
  1. 测试
//...
client.loopBlaze({
  onMessage(msg) {
    // 改造一下这里
    handleUser(msg)
  },
  onAckReceipt() {
  }
})
//...
  1. 使用 mixin 移动端给机器人发送 30265 ，看机器人是否会返回 4 条消息。
  2. 再把返回的 user_id 发送给机器人，看机器人是否会返回跟第一步相同的 3 条消息。
  3. 如果是则说明测试通过。
3. 编写 asset_id 和 symbol 的资产查询
  1. 逻辑分析
    • 用户给机器人发送 asset_id 或 symbol
    • 机器人收到消息后，进行查询。
    • 如果没查到，说明用户的输入错误，结束。
    • 如果查到了，则给用户发送查询到的 文章 消息，
    • 如果确认用户输入的是 symbol ，则再多给用户发送一条 asset_id(查到的第1个资产第asset_id)
  2. 代码实现
const { validate: isUUID } = require('uuid') // mixin-node-sdk 包里有 uuid 了，所以可以直接引入
/**
 * 处理 asset_id 或者 symbol
 * 1. 资产相关的文章消息 2. symbol -> [0].asset_id
 * @returns {boolean} 如果判断成功，那么回复消息并返回 true，否则返回 false
 * @param {{data: '', user_id: ''}} msg 
 */
async function handleAsset({ data, user_id }) {
  if (isUUID(data)) {
    // 说明有可能是 asset_id
    const asset = await readNetworkAsset(data)
    if (asset && asset.asset_id) {
      // 说明是 asset_id，且已经查询到了
      await client.sendPostMsg(user_id, '```json\n' +
        JSON.stringify(asset, null, 2) +
        '\n```')// 发送 json 格式的 markdown
      return true
    }
  } else {
    // 说明有可能是 symbol
    const assets = await searchNetworkAsset(data)
    if (assets.length > 0) {
      // 说明是 symbol，且已经查询到了
      await Promise.all([
        client.sendPostMsg(user_id, '```json\n' +
          JSON.stringify(assets, null, 2) +
          '\n```'), // 返回 json 格式的 markdown
        client.sendTextMsg(user_id, assets[0].asset_id) // 返回 查询到的第一个 asset_id
      ])
      return true
    }
  }
  return false
}
  1. 测试
//...
client.loopBlaze({
  onMessage(msg) {
    // 改造一下这里
    handleAsset(msg)
  },
  onAckReceipt() {
  }
})
//...
  1. 使用 mixin 移动端给机器人发送 btc ，看机器人是否会返回 2 条消息。
  2. 再把返回的 asset_id 发送给机器人，看机器人是否会返回 1 条 btc 的资产相关消息。
  3. 如果是则说明测试通过。
4. 编写 /claim 向机器人签到并领取 1 CNB
  1. 逻辑分析
    • 用户给机器人发送 /claim
    • 机器人收到消息后，进行查询该用户是否领取。
    • 如果已领取，则发送 您今日已领取，请明日再来。
    • 如果没领取，则向该用户转账 1cnb
  2. 代码实现
const cnb_asset_id = '965e5c6e-434c-3fa9-b780-c50f43cd955c' // 预先查询到了 cnb 的 asset_id 备用。
/**
 * 处理 /claim 的消息
 * 1. 给用户转账 1 cnb
 * @returns {boolean} 如果判断成功，那么回复消息并返回 true，否则返回 false
 * @param {{data: '', user_id: ''}} msg 
 */
async function handleClaim({data, user_id}) {
  const trace_id = client.uniqueConversationID(
    user_id + client.keystore.client_id,
    new Date().toDateString()
  ) // 用户这个用户今天唯一的 trace_id
  const transfer = await client.readTransfer(trace_id) // 查询今天是否领取过
  if (transfer && transfer.snapshot_id) {
    // 已经领取
    await client.sendMessageText(
      user_id,
      '您今日已领取，请明日再来。'
    )
  } else {
    // 否则的话给用户转 1 cnb
    await client.transfer({
      trace_id, 
      asset_id: cnb_asset_id,
      amount: '1',
      opponent_id: user_id,
    })
  }
}
  1. 测试
//...
client.loopBlaze({
  onMessage(msg) {
    // 改造一下这里
    handleClaim(msg)
  },
  onAckReceipt() {
  }
})
//...
  1. 使用 mixin 移动端给机器人发送 /claim ，看机器人是否转账 1 cnb
  2. 再发送一次 /claim ，看机器人是否回复 您今日已领取，请明日再来。
  3. 如果是则说明测试通过。
5. 编写 /donate 向机器人获取机器人转账地址
  1. 逻辑分析
    • 用户给机器人发送 /donate
    • 机器人收到消息后，给用户发送自己的转账按钮
    • 若用户成功转账，则向用户回复 “打赏的 {amount}{symbol} 已收到，感谢您的支持。”
  2. 代码实现
// 1. 直接回复 donate 的按钮
async function handleDonate({user_id}) {
  client.sendAppButtonMsg( // 给用户发送 donate 的 button
    user_id,
    [
      {
        label: `点击向我捐赠`,
        action: `mixin://transfer/${client.keystore.client_id}`,
        color: '#000'
      }
    ]
  )
}

// 2. 在 loopBlaze 的地方，需要监听收到转账的消息。
client.loopBlaze({
  ...,
  async onTransfer({ data, user_id }) {
    const { amount, asset_id } = data
    const { symbol } = await client.readAsset(asset_id)
    client.sendMessageText(user_id, `打赏的 ${amount} ${symbol} 已收到，感谢您的支持。`)
  }
})
6. 帮助信息 + 2 个交互按钮
const helpMsg = `
1. 支持用户查询，请发送 user_id | identity_number
2. 支持资产查询，请发送 asset_id | symbol
3. 支持每日领取 1cnb，请发送 /claim 或点击签到
4. 支持打赏，请发送 /donate 或点击打赏
`
async function sendHelpMsgWithInfo(user_id, info) { // 发送帮助消息
  await Promise.all([
    client.sendTextMsg(user_id, info + helpMsg),
    client.sendAppButtonMsg(user_id, [
      { label: "签到", action: "input:/claim", color: "#000" },
      { label: "打赏", action: "input:/donate", color: "#000" }
    ])
  ])
  return true
}
7. 组装逻辑
  1. 逻辑分析
  • 如果用户输入的是 非文本消息，直接结束
  • 如果用户输入的是 /claim 则直接走 handleClaim，然后直接结束
  • 如果用户输入的是 /donate 则直接走 handleDonate，然后直接结束
  • 如果用户输入的是 uuid 则同时查询 user 和 asset，然后结束
  • 如果用户输入的是 数字 则只查询 user，然后结束
  • 如果用户输入的是 非数字 则只查询 asset，然后结束
  • 结束后判断，如果是 false，则返回帮助信息 + 2个 button
  1. 代码实现
/**
 * 处理消息，如果处理成功则返回 true，否则返回 false
 * @param {{data: String, user_id: String}} msg 
 * @returns {boolean}
 */
async function handleMsg(msg) {
  const { data, category, user_id } = msg
  if (category !== 'PLAIN_TEXT')
    return sendHelpMsgWithInfo(user_id, "仅支持文本消息。")
  if (data === '/claim') return handleClaim(msg) // 处理 /claim 消息
  if (data === '/donate') return handleDonate(msg) // 处理 /donate 消息
  if (isUUID(data)) { // 处理 uuid 消息
    const res = await Promise.all([
      handleUser(msg),
      handleAsset(msg)
    ])
    return res.some(v => v)
  }
  if (isNaN(Number(data))) return handleAsset(msg) // 处理 symbol -> assets 的消息
  else return handleUser(msg) // 处理 identity_number -> user 的消息
}
  1. 在 onMessage 中调用。
//...
client.loopBlaze({
  // 改造一下这里
  async onMessage(msg) {
    const isHandle = await handleMsg(msg)
    if(!isHandle) return sendHelpMsgWithInfo(msg.user_id, "指令输入不正确。")
  },
  onAckReceipt() {
  },
  onTransfer() { // 这里可以再忽略一下转账消息
  }
})
//...
  1. 测试

可以把上述的测试全部再走一遍。
全部通过，说明测试成功。

刘泽美
关注
专栏目录
qos 流控功能_浅谈流媒体中的流控与QoS
weixin_39663593的博客
12-21 1158
在流媒体传输中，流控和QoS是无法避免的话题之一。然而，在不同的应用场景和需求下，流控和QoS的策略一方面有很大的差异，另一方面在本质上又有很多的共性。本人在北大读博时的课题即为流媒体传输优化，工作后也一直从事流媒体传输相关的工作，本文仅浅谈自己对流媒体传输中的流控和QoS的理解和看法，抛砖引玉。流控即网络流量控制(Network trafficcontrol)，百度百科的解释为：一种利用软件或硬...
Mixin 开发简明教程 1：写个机器人
m0_37236246的博客
11-29 677
我是 @lyric，本教程应 Mixin COO @薄荷 邀约而写，旨在向区块链领域以外的工程师们介绍如何以依托 Mixin Network，用最简单的方式开发自己的区块链应用程序。 本文是系列教程的第一篇，如果对本文感兴趣，你可以： 订阅我的博客 lyric.im 订阅我的 PRESS.one 专栏 关注我的公众号，搜索iamlyricw 或在文末给赞赏一些数字货币 方便获取后续更新。...
Mixin Network Whitepaper
JoiT
01-15 1326
[译] Mixin Network（网络） 看到了李笑来老师牵头的 Mixin， 也仔细查看了 Mixin 白皮书 ，决定翻译过来 单击此处查看原文 构造一个最大的，并且对开发者友好的移动区块链网络，连接现有的所有区块链，不限吞吐量。 Contents（目录 ） 动机 设计 End-to-End 加密信息 基于移动端和PIN的身份标识 XIN - Token 结论
Mixin Network第一届开发者大赛作品介绍- dodice, diceos和Fox.one luckycoin
weixin_33895657的博客
01-18 273
Mixin Network 开发者大赛已经圆满结束。评奖结果已经揭晓。来自3个国家的开发者，使用了总计5种编程语言：Javascript，Ruby，Go，Python, PHP，输出了9个获奖作品，并已经全部开源。 今天来介绍三个作品 dodice：基于go语言的多人对战石头剪刀布游戏。代码 diceos：从现在允许的最大投注量的变化看来似乎已经在赚钱了。代码 微信数字货币红包：基...
Mixin Network 新增API 可以查询当前网络的整体资产情况
weixin_33834137的博客
12-13 235
获取当前整个网络TOP100资产列表 developers.mixin.one/api/alpha-m… 查询当前整个网络单项资产详情 developers.mixin.one/api/alpha-m… 开发者大赛 mixin开发者大赛正在进行中，javascript, python, ruby, php, go程序员都可以来赢30万大奖。 大赛地址活动地址 mixin.one/events/ha...
mixin机器人java开发_Mixin 开发简明教程 1：写个机器人
weixin_42365604的博客
02-27 386
作者：Lyric 编辑：比特汪 本文已通过PRESSone合约购买个人授权许可(非排他性)，可以点击阅读原文查看。我是 @lyric，本教程应 Mixin COO @薄荷 邀约而写，旨在向区块链领域以外的工程师们介绍如何以依托 Mixin Network，用最简单的方式开发自己的区块链应用程序。本文是系列教程的第一篇，如果对本文感兴趣，你可以：关注我的公众号，搜索iamlyricw或在文末给赞赏...
developers.mixin.one:开发人员门户
04-27
此存储库是的源代码，其中包括： ...Golang SDK： https ： //github.com/MixinNetwork/bot-api-go-client Mixin Messager Android https://github.com/MixinNetwork/android-app Mixin Messager iOS
desktop-app::laptop:适用于Windows，macOS和Linux的Mixin Messenger桌面应用程序
04-29
Mixin桌面应用程序 由和支持的适用于macOS，Windows和Linux的 ，信号协议是...git clone https://github.com/MixinNetwork/desktop-app.git cd desktop-app yarn install yarn electron:serve 执照 根据许可证发布。
【经验分享】git clone 时出现三种报错及解决方案
热门推荐
Sunnyside_
06-30 2万+
【经验分享】git clone 时出现三种报错及解决方案   最近在使用 git 进行 git clone 时，经常报错，经过查询找到了一种解决方案，分享给大家。 文章目录【经验分享】git clone 时出现三种报错及解决方案一、第一种报错二、第二种报错三、第三种报错四、解决方案 一、第一种报错   执行git clone提示 “fatal: The remote end hung up unexpectedly” [cos@VM-0-14-centos git_cos]$ git clone http
Node.js 中使用 bcrypt 对密码进行哈希处理
每天都要努力学习哦~~
10-02 1178
无论您是一位经验丰富的 Node.js 开发者，希望加强您的身份验证实践，还是一位初学者，希望学习安全密码管理的最佳技术，本文都将对您有所帮助。bcrypt 的强大算法，结合自适应哈希处理和盐生成，提供了可靠的防御机制，以应对常见的基于密码的漏洞。通过遵循这些最佳实践，并警惕不断演变的威胁，我们可以创建一个安全的认证系统，让用户信心倍增，并维护应用程序的完整性。首先，在使用 npm 安装 bcrypt 包后，确保将其导入到您的 Node.js 应用程序的 index.js 文件中，以有效地利用其功能。
金融市场的衍生品交易及其风险管理探讨
最新发布
2405_87249521的博客
10-08 676
通过合理的风险管理策略，如止损、对冲和分散投资，投资者可以在享受衍生品带来的收益的同时，有效控制其风险。本文将探讨金融衍生品交易的关键特点，并深入分析如何通过有效的风险管理策略来应对衍生品交易中的潜在风险。例如，在期权或期货交易中，投资者可以根据自己的风险承受能力设定固定的止损价格，当市场价格触及该水平时自动止损。企业可以通过期权、期货等工具对冲原材料价格波动的风险，投资者也可以利用衍生品管理股票投资组合中的市场风险。例如，持有大量股票的投资者可以购买股指期货的空头头寸，以对冲股票价格下跌的风险。
市场中的新兴力量与未来发展
QQ3957533237的博客
10-02 465
全球化的市场视野大粤期货不仅专注于国内市场，还积极参与国际期货交易，帮助客户开拓全球金融市场。通过其强大的全球网络，投资者可以轻松参与包括大宗商品、股指期货、外汇期货等在内的国际市场投资，享受更多元化的投资机会。灵活的交易工具与创新技术大粤期货依托现代化的技术，提供高度自动化的交易平台和个性化的交易工具。投资者不仅可以随时获取实时市场数据，还可以利用先进的技术分析工具进行深入的市场研判，帮助他们快速响应市场波动，做出及时的交易决策。高效的风险管理体系在期货交易中，风险管理尤为重要。
盲拍合约：让竞拍更公平与神秘的创新解决方案
yoona333的博客
10-04 1443
盲拍合约通过其独特的机制，实现了透明与隐私的平衡，推动了更公平的市场环境。合约的设计允许参与者在不泄露个人信息的情况下进行出价，有效防止了心理战和价格操控。在现代数字经济中，盲拍合约的应用潜力巨大，为各种交易场景提供了新方式，有助于提高交易的信任度和效率，促进了公平竞争。
Mythical Beings：Web3游戏如何平衡创造内容、关注度与实现盈利的不可能三角
区块链蓝海
10-08 300
Web3游戏自其诞生以来，以去中心化和独特的代币经济体系迅速引起关注。然而，如何在创造内容、吸引用户和实现盈利之间达到平衡，始终是Web3游戏面临的核心挑战。Mythical Beings作为一款Web3卡牌游戏，通过创新设计和独特机制，展示了如何在这一“不可能三角”中实现相对平衡。本文将探讨Mythical Beings是如何在内容、用户和盈利三者之间找到最佳平衡的。
Chapter 2 - 3. Understanding Congestion in Fibre Channel Fabrics
mounter625的专栏
10-05 1011
在某些情况下，帧的损坏方式可能使接收器甚至无法识别入口比特是否属于一个帧，因此接收器认为它从未收到过该帧，因而不会返回信元。信元为零时停止发送帧，避免邻居的缓冲区超限。使用另一种方法也能实现同样的目标，即跟踪邻居已消耗的缓冲区。如前所述，它并不意味着帧被完整接收，也不意味着帧真的到达了最终目的地。只是表示帧接收器有一个缓冲区，可以再接收一个帧。交换机执行的是剩余信元方法，而不是已消耗信元方法。它不会增加链路利用率，因为它是代替帧间填充字传输的。帧发送器向帧接收器发送帧，而帧接收器向帧发送器发送。
如何通过资产配置优化投资组合——金融市场中的长期策略
QQ3957533237的博客
10-01 701
总的来说，通过科学合理的资产配置，投资者能够在金融市场中更好地应对风险，实现稳健的长期回报。明确投资目标、定期调整投资组合、平衡风险与收益，并充分利用复利效应，都是提升投资绩效的重要策略。无论市场如何变化，资产配置始终是投资者在金融市场中不可或缺的一项关键策略。
股票自动交易软件究竟可不可靠，正规软件与风险规避
股票量化交易自动交易程序化交易接口
10-04 957
股票自动交易软件通过预设算法和规则执行买卖指令。其可靠性受软件来源、策略、优势局限、费用等多种因素影响，需谨慎评估选择。
[Day 83] 區塊鏈與人工智能的聯動應用：理論、技術與實踐
2401_83208854的博客
10-02 1159
區塊鏈技術與物聯網（IoT）結合，為許多領域提供了強大的解決方案。傳統的IoT架構常面臨數據隱私和安全問題，而區塊鏈的去中心化和加密技術則能有效增強IoT系統的安全性、透明性和效率。本文將探討區塊鏈如何在物聯網中應用，並附上相關代碼實例與詳細解釋。物聯網是一個由數百萬設備、傳感器和網絡組成的系統，能夠進行自動化的數據收集與傳輸。然而，由於這些設備之間頻繁的數據傳輸，安全性、數據完整性和隱私問題成為了IoT系統中的主要挑戰。區塊鏈的去中心化結構和分布式賬本技術能夠提供透明、不可篡改和可靠的數據管理方式，有效解
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值