Wiki · Zikaron

上手

从安装到第一条存证上链,约需十分钟,其中一半用于抄写助记词。

安装

0.1.0 提供 Apple 芯片 Mac 的两种安装包,在下载页取得:

.dmg
打开后把 ZIKARON.app 拖进「应用程序」。命令行 zikaron 在应用包内的 ZIKARON.app/Contents/MacOS/zikaron。
.pkg
安装程序,把应用装进 /Applications,把命令行装到 /usr/local/bin/zikaron。

应用用 Kaptonia 的自签证书签名,在 Apple 公证之外发出。从浏览器下载的文件带着 macOS 的隔离标记,系统会拒绝打开;在较新的 macOS 上,「系统设置 › 隐私与安全性」里的「仍要打开」时常失灵。稳妥的做法是先核对文件,再在「终端」里去掉隔离标记:

  1. 核对 SHA-256。结果应与下载页列出的一致:
    shasum -a 256 ~/Downloads/ZIKARON-0.1.0-macos-arm64.dmg
  2. 用 dmg:打开 dmg 之前先运行下面这条,再打开 dmg,把 ZIKARON.app 拖进「应用程序」:
    xattr -d com.apple.quarantine ~/Downloads/ZIKARON-0.1.0-macos-arm64.dmg
    已经拖进去了的,改为运行:
    xattr -dr com.apple.quarantine /Applications/ZIKARON.app
  3. 用 pkg:先运行下面这条,再双击安装:
    xattr -d com.apple.quarantine ~/Downloads/ZIKARON-0.1.0-macos-arm64.pkg

命令里的路径按你实际下载的位置改。

首次启动

第一次打开时,向导自动弹出,左边竖列六步,右边是当前这一步。每一步是否完成,按实际状态判断。

  1. 设置口令。8 位字母或数字,区分大小写,输入两遍。过于简单的口令当场退回:八位全同,或纯数字成连号、像日期。口令排在建身份之前,因为密钥要放进由口令开启的密钥库。
  2. 创建身份。三选一:生成 12 个助记词,抄在纸上,再填回随机抽的三个词;导入已有密钥;从整机备份恢复。这台机器上建成的第一个身份就是主身份。
  3. 网络。「以太坊主网」已默认选中;也可以选「自定义」,自己填链号、登记合约与节点。在主网上锚定要花真实的 ETH 付 gas。
  4. 创建账本。写一句账本说明(可留空),按「创建账本」,在确认卡上再按一次。这一步免费,只写入本地。
  5. 充值 gas。页面显示密钥地址和付款二维码。从你的钱包转入少量 ETH,按「我已转账」;向导读一次链上余额,大于零即完成。可以「以后再说」。
  6. 整机备份。导出一个带密码的备份文件,一个文件恢复全部。可以「以后再做」,宜尽早完成。

设好口令和身份之后,竖列底部的「退出向导」或 Esc 回到原来的页面,做完的步骤照旧算完。其余步骤,可从「设置 › 关于」的「重新运行向导」接着做。

助记词抄在纸上,存放在只有你能取到的地方。助记词找回的是密钥;本机的账本、收到的授权与设置,靠整机备份找回;原文件请自己保留。

记录者的一条完整走法

左栏顶上选「记录者」。

  1. 存证。把作品文件拖进首页的拖放区,写「记录名称」,按「加入账本」,在确认卡上再按「加入账本」。
  2. 上链。点首页的「待上链」卡,或到「记录存证」的「待上链」分段按「全部上链」,在「上链」卡上按「确认上链」。几分钟后状态变为「已确认」。
  3. 授权。到「授权」按「新建授权」:填被授权方地址,选一件已上链的记录,拖入条款文件,选有效期,按「加入账本」并在确认卡上再按一次,再像第 2 步一样上链。
  4. 交付。在授权详情里按「复制授权码」,或「导出授权文件…」,发给对方。授权文件带着你的账本,对方能做完整核验。
  5. 日常。看「提醒」页;需要时在授权详情里按「撤销授权…」。

存证一经写入即成定稿,需要补充时追加注记。原文件请妥善保管:日后举证,要出示与指纹逐字节一致的原件。

使用方的一条完整走法

  1. 在左栏顶上切到「使用方」。使用方的账本只在转授权时才需要,到时在转授权页按「开账…」即可。
  2. 在首页「核验一份授权」卡里贴入对方发来的授权码,按「开始核验」,看结果。
  3. 到「我的授权」按「添加授权」,贴授权码或拖入授权文件,按「核验并添加」,把它收进库里。
  4. 收到作品文件后,到「核验 › 核验授权」,把授权、文件和条款文件一起放进去,按一次「核验」,三件一起核对。
  5. 看「提醒」页:授权快到期、被撤销、签发者账本被移交,都会在这里出现。

窗口

左边是左栏,右边是页面。左栏从上到下:身份牌(当前身份的名字与种类,点开可切换或新建身份)、角色切换「记录者」|「使用方」、这一种角色的页面列表,底部是「设置」「锁定」和状态行。状态行右端的小图标是「同步」,点它在后台读一次链。

记录者使用方
首页首页
记录:记录存证、授权授权:我的授权
查看:核验、账本、提醒查看:核验、提醒

凡是写入账本或上链的动作,都先出一张确认卡,逐行写出要写什么、写到哪里、费用多少;在卡上按红色实心键才真正写入,按「取消」或 Esc 即作罢。快捷键与其余设置见提醒与设置。