1. GateChain钱包简介

本文档涉及的版本为测试版,后继开发工作在持续进行,测试阶段可能出现多次网络重置操作 测试币可能在重置中清空,再次获取新的测试币即可。

GateChain生态针对个人、专业用户和企业用户的差异化需求,提供了类型丰富的钱包应用。

  • 在测试网阶段,GateChain提供基于Windows、Mac OS平台的桌面版钱包。专业用户也可以通过RPC方式访问和测试。

  • 在主网阶段,GateChain将提供多种针对个人、专业用户和企业用户的钱包应用。包括:命令行钱包、基于Android和iOS的手机版钱包、Web钱包、多签钱包、硬件钱包等。

2. 规范说明

2.1 GateChain地址类型

GateChain的账户分普通账户(Normal Account)和保险账户(Vault Account)两类。不同账户类型,对应于不同的地址前缀标识:

  • 普通账户(Normal Account):以“gt”作为前缀标识。其中,“gt1”表示普通单签账户,“gt2”表示普通多签账户。
  • 保险账户(Vault Account):以“vault”作为前缀标识。其中,“vault1”表示保险单签账户,“vault2”表示保险多签账户。

使用GateChain定义的地址前缀标识机制,收款账户易于识别付款账户的类型。由此,对于保险账户发送的付款交易,用户可注意到并根据自身需求确认收款,在可撤回时间之后安全确认。

2.2 GateChain交易类型

GateChain具有多种转账交易类型。为便于用户有效识别不同的转账类型,GateChain创新地提出了转账交易类型标识。

下面列出不同转账类型的前缀标识:

  • 不可撤回交易支付(Irrevocable Pay):“IRREVOCABLEPAY-”
  • 可撤回交易支付(Revocable Pay):“REVOCABLEPAY-”
  • 修改账户属性(Account Set): “ACCOUNTSET-”
  • 创建保险账户(Vault Create):“VAULTCREATE-”
  • 撤回交易(Revoke): “REVOKE-”
  • 清算保险账户(Vault Clear):“VAULTCLEAR-”
  • 其他未命名交易类型(Untitled): “BASIC-”

2.3 其他定义

  • 找回账户:保险账户的预设安全关联账户,当保险账户的转账操作被撤回后,资金将被转移到这一账户。

  • 可撤回时间:是在可撤回交易执行后允许进行交易撤回操作的有效时间,也就是在当前交易发出后,系统出块数量达到预设值之前可以进行交易撤回操作。

  • 清算块高:是未来的某个时间,也就是未来这个区块链高度的时间,到达这个清算高度以后,账户中的资金将允许被清算。

在GateChain中所有时间设定均使用区块高度计算,目前系统出块速度约为1秒,设置上述时间请据此作为参考。

3. 下载安装

4. 快速使用

4.1 密码和安全

  • GateChain提供得钱包是本地钱包,所以不需要注册登陆账户,但在首次运行时,需要设置登陆密码,此密码除用于登录本地钱包以外也作为进行钱包各项操作时的“解锁密码”,十分重要!如果丢失可能会造成您的财产损失,所以请尽量设置较为复杂的密码,并妥善保管。

  • 由于GateChain独创的可撤回交易,为了防止这一安全措施被滥用,GateChain使用了醒目的交易头标识。用户在接收到一笔交易时,可以通过以下特征来判断交易是否可撤回,进行识别后再进行收款确认等后继操作。

    1. 普通账户以“gt”作为前缀,使用“gt”前缀的地址作为转账来源的交易是不可撤回的。
    2. 不可撤回的转账交易id前缀是 IRREVOCABLEPAY- ,这种前缀的转账交易是不可撤回的。
    3. 保险账户以“vault”作为前缀,使用“vault”前缀的地址作为转账来源的交易是可以被撤回的。
    4. 可撤回的转账交易id前缀是 REVOCABLEPAY- ,这种前缀的转账交易是可撤回的。

4.2 创建普通账户

  • 1 )点击主界面“创建账户”,选择“单签账户 ”-->>“普通账户。

  • 2 )输入账户名称,点击“创建”。

  • 3 )输入解锁密码,点击“确认”。

  • 4 )账户创建成功,注意识别单签普通账户,普通账户地址以“gt”作为前缀。

4.3 账户导入

除了创建账户以外,也可以使用“导入账户”功能来导入一个之前已经创建的账户,具体操作步骤如下:

  • 1 ) 点击主界面“导入账户”,选择单签账户。

  • 2 )进入账户导入界面,依次填写账户名称(不必与原账户名相同),账户备份文件(Keystore文件)以及Keystore文件的解密密码(导出账户文件时输入的密码),点击“导入”按钮。

  • 3 )输入当前解锁密码,点击“确认”按钮,完成账户导入。

4.4 获得测试币

  • 通过钱包获得测试币:

    • 钱包账户概览界面有 “获得测试币 (Give me GT) 图标”,点击后会自动向测试链提交申请拨发测试币,几分钟后测试币就显示在钱包余额里面了。

  • 通过网站获得测试币:

    • 访问网站: https://explorer.gatechain.io/faucet
    • 输入要获取测试币的账户地址,点击添加申请,几分钟后测试币就显示在钱包余额里面了。

每个账户在24小时内只能申请一次测试币,每次通过钱包申请测试币将获得以下提示。

4.5 创建保险账户

  • 1 )点击主界面“创建账户”,选择“单签账户 ”-->>“保险账户

  • 2 )输入账户名称,点击“创建”

  • 3 )输入解锁密码解锁,点击“确认”

  • 4 )账户创建成功,提示需要激活,点击“激活”按钮

  • 5 )选择手续费付款账户,输入一个自己的备用账户作为“找回账 号”,选择交易可撤回时间(比如 48 小时),清算块高(比如 5 年),点击“下一步”

  • 6 )确认保险账户激活参数后,点击“确定”,输入解锁密码后激活保险账户。



亦可以通过其他普通账户激活保险账户

  • 进入用于激活保险账户的其他账户概览界面,点击右侧“激活其他账户”

  • 进入激活保险账户页面。
  • 激活流程同上。

    注:当前用于激活保险账户的普通账户地址将被自动填写入“找回账户”栏内。希望使用其他账户作为找回账户的用户请注意修改。

4.6 保险账户清算时间可以进行修改

具体步骤如下:

  • 1 )进入需要修改清算时间的保险账户,点击“清算块高”右侧修改按钮。

  • 2 )进入修改页面,设置新的清算块高。

  • 3 )核对信息并输入解锁密码

  • 4 )修改交易发起成功。

4.7 设置保险账户告警通知

GateChain为保险账户提供了邮件和短信两种告警通知方式。

  • 1 )进入区块链浏览器监控页面
    • 可以点击保险账户地址右侧图标链接进入账户监控设置页面。

    • 或者直接访问测试网区块浏览器 点击“监控”进入账户监控设置页面。

  • 2 ) 填写需要监控的账户地址以及用于接收预警信息的手机、邮箱信息。

4.8 使用普通账户转账(不可撤回)

  • 1 )从钱包账户列表中选择需要进行转出操作的账户,点击进入账户概要。

  • 2 ) 选择“转账”按钮。

  • 3 ) 进入转账页面,填写接收账户地址以及需要转账金额,确认后点击“发送”按钮。

  • 4 ) 对转账信息进行核对后点击“确认” 按钮

  • 5 ) 输入解锁密码,并点击“确认”

  • 6 ) 获取交易发起成功反馈

注意:

  1. 普通账户以“gt”作为前缀,使用“gt”前缀的地址作为转账来源的交易是不可撤回的。
  2. 不可撤回的转账交易id前缀是 IRREVOCABLEPAY- ,这种前缀的转账交易是不可撤回的。

此类转账交易是即时生效并且不可撤回的,收到交易后可以放心确认和使用

  • 7 ) 在账户概览“转账记录”中查询本账户的转账记录

4.9 使用保险账户转账(可撤回)

保险交易转账都是延时生效的转账交易,因此在使用保险账户进行转账时相较于普通转账需要填写额外内容。具体步骤如下:

  • 1 )使用保险账户发起对外转账( Send Revocable Payment from Vault Account)

  • 2 )填写接收账户地址,转出金额等信息,点击“发送”按钮

  • 3 )确认转账信息,点击“确认” 按钮

  • 4 )输入钱包登陆密码后即可获得“可撤回交易发起成功的通知

收款账户在收款记录中可以看到该笔交易,点击具体交易获取交易详细信息(交易状态,预计确认时间,金额等)

  • 5 )如已经对相关账户设置过接收预警消息,在转账后将立即获得告警通知 (Receive alarm of vault account out going payment)

  • 6 )发起撤回交易将资金撤回 (Revoke the undesired vault account payment),在账户概览页面点击转账记录,查询可撤回转账交易记录,点击右侧“撤回交易”按钮。

  • 7 )确认待撤回交易信息后点击“下一步”

  • 8 )再次确认撤回交易细节,并输入钱包登陆密码

  • 9 )撤回交易发起成功

  • 10 )本次撤回交易转入对应找回账户中

注意:

  1. 保险账户以“vault”作为前缀,使用“vault”前缀的地址作为转账来源的交易是可以被撤回的。
  2. 可撤回的转账交易id前缀是 REVOCABLEPAY- ,这种前缀的转账交易是可撤回的。

此类转账只有在超过可撤回期限后还未被撤回的情况下才算成功接收。


5. 进阶功能

本部分内容涉及账户操作,请谨慎使用,避免因误操作造成资产损失。

钱包支持对本地钱包账户列表中的账户进行包括账户导出、账户删除和查看账户私钥在内的各项操作。

  • 选择需要进行操作的账户,点击进入账户概览。

  • 点击右上角,进入账户详情。

  • 查看账户详情

普通账户只显示“账户信息”,保险账户将额外显示相关的“保险设置”信息。

5.1 账户导出

  • 单签账户导出
    • 单签账户可以导出到文件进行备份,进入账户详情。
    • 点击“Keystore”右侧“下载”按钮,输入解锁密码后进行账户备份。

5.2 查看私钥

  • 进入账户详情后点击“私钥”右侧“查看”按钮,输入解锁密码后查看账户私钥。

所显示私钥请不要使用截图,复制等方式保存在可联网电脑中,以避免资产风险。

5.3 删除账户

  • 进入账户详情后点击右上方“删除账户”按钮

  • 输入解锁密码后点击“确认”按钮,相关账户即被删除。

5.4 多签账户

5.4.1 创建多签账户

  • 1 )点击主界面“创建账户”,选择“多签账户 ”-->>“普通账户。

  • 2 )依次填写“账户名称”,选择“团队总人数”(2-7人数可选),“最小签名数”以及“成员公钥”(可以使用钱包内已创建的账户公钥或填写其他非本地公钥),点击“下一步”。

  • 3 )进入确认页面,点击“创建”按钮,完成多签账户创建。

  • 4 ) 按照提示将多签账户发布到链上。

  • 5 )发布公钥需要产生手续费,选择付款账户,并点击下一步。

  • 6 )确认信息后,输入解锁密码,获得交易发起成功反馈。

保险多签账户创建流程与普通多签账户一致,激活过程与普通保险账户激活过程一致

5.4.2 导出多签账户

  • 1 )在账户列表选择需要导出的多签账户,进入账户详情。

  • 2 ) 选择“导出多签账户”按钮,输入解锁密码后生产多签账户文件。

5.4.3 多签转账交易

  • 发起多签账户转账交易首先和普通交易类似,填写收款账户、金额等数据,点击“发送”。

  • 对交易信息进行确认后,进入“签名&广播流程”页面。

  • 因不同多签账户的参与成员数量的不同,请按照“签名&广播流程”页面给出的提示完成“收集签名”以及“广播交易”操作。

示例:




6. 区块浏览器

7. 开发文档