钱包 wallet | GateChain Doc

# 钱包 wallet

本文档涉及的版本为正式版，新功能开发工作在持续进行。

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

在测试网阶段，GateChain提供基于Windows、Mac OS平台的桌面版钱包。专业用户也可以通过RPC方式访问和测试。
在主网阶段，GateChain将提供多种针对个人、专业用户和企业用户的钱包应用。包括：命令行钱包、基于Android和iOS的APP钱包、Web钱包、多签钱包、硬件钱包等。

# 规范说明

# 1.1 GateChain地址类型

GateChain的账户分普通账户（Normal Account）和保险账户（Vault Account）两类。不同账户类型，对应于不同的地址前缀标识：

普通账户（Normal Account）：以“gt”作为前缀标识。其中，“gt1”表示普通单签账户，“gt2”表示普通多签账户。
保险账户（Vault Account）：以“vault”作为前缀标识。其中，“vault1”表示保险单签账户，“vault2”表示保险多签账户。

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

# 1.2 GateChain交易类型

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

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

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

# 1.3 其他定义

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

普通账户以“gt”作为前缀，使用“gt”前缀的地址作为转账来源的交易是不可撤回的。

不可撤回的转账交易id前缀是 IRREVOCABLEPAY- ，这种前缀的转账交易是不可撤回的。

保险账户以“vault”作为前缀，使用“vault”前缀的地址作为转账来源的交易是可以被撤回的。

可撤回的转账交易id前缀是 REVOCABLEPAY- ，这种前缀的转账交易是可撤回的。

找回账户：保险账户的预设安全关联账户，当保险账户的转账操作被撤回后，资金将被转移到这一账户。
可撤回时间：是在可撤回交易执行后允许进行交易撤回操作的有效时间，也就是在当前交易发出后，系统出块数量达到预设值之前可以进行交易撤回操作。
清算块高：是未来的某个时间，也就是未来这个区块链高度的时间，到达这个清算高度以后，账户中的资金将允许被清算。

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

# 下载安装

# 2.1 桌面版钱包

进入GateChain的官网点击进入，点击上方的“钱包下载”，下载系统对应的版本。
也可以直接访问点击进入，下载PC版钱包。

目前支持Windows 和 Mac OS 系统。

# 2.2 APP钱包和Web钱包

APP钱包下载方式：进入wallet.io的官网wallet.io，根据手机系统选择Android版或iOS版
Web钱包打开方式：进入wallet.io的官网wallet.io，点击右上角的产品--个人钱包。

# 桌面版钱包

桌面版钱包可以自由配置连接MainNet、TestNet、DevNet，以及任何用户自己搭建的网络。TestNet和DevNet中的测试币可能在重置中清空，再次获取新的测试币即可。

# 3.1 密码和安全

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

# 3.2 创建普通账户

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

2 ）输入账户名称，点击“创建”。

3 ）输入解锁密码，点击“确认”。

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

# 3.3 账户导入

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

1 ) 点击主界面“导入账户”，选择单签账户。
2 ）进入账户导入界面，依次填写账户名称（不必与原账户名相同），账户备份文件（Keystore文件）以及Keystore文件的解密密码（导出账户文件时输入的密码），点击“导入”按钮。
3 ）输入当前解锁密码，点击“确认”按钮，完成账户导入。

# 3.4 获得测试币

通过钱包获得测试币：
- 钱包账户概览界面有 “获得测试币 (Give me GT) 图标”，点击后会自动向测试链提交申请拨发测试币，几分钟后测试币就显示在钱包余额里面了。
通过网站获得测试币：
- 访问网站：点击进入
- 输入要获取测试币的账户地址，点击添加申请，几分钟后测试币就显示在钱包余额里面了。

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

# 3.5 创建保险账户

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

2 ）输入账户名称，点击“创建”

3 ）输入解锁密码解锁，点击“确认”

4 ）账户创建成功，提示需要激活，点击“激活”按钮

5 ）选择手续费付款账户，输入一个自己的备用账户作为“找回账号”，选择交易可撤回时间（比如 48 小时），清算块高（比如 5 年）,点击“下一步”
6 ）确认保险账户激活参数后，点击“确定”，输入解锁密码后激活保险账户。

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

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

进入激活保险账户页面。

激活流程同上。

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

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

具体步骤如下:

1 ）进入需要修改清算时间的保险账户，点击“清算块高”右侧修改按钮。
2 ）进入修改页面，设置新的清算块高。
3 ）核对信息并输入解锁密码
4 ）修改交易发起成功。

# 3.7 设置保险账户告警通知

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

1 ）进入区块链浏览器监控页面
- 可以点击保险账户地址右侧图标链接进入账户监控设置页面。
- 或者直接访问区块浏览器点击“监控”进入账户监控设置页面。
2 ) 填写需要监控的账户地址以及用于接收预警信息的手机、邮箱信息。

# 3.8 使用普通账户转账（不可撤回）

1 ）从钱包账户列表中选择需要进行转出操作的账户，点击进入账户概要。
2 ) 选择“转账”按钮。
3 ) 进入转账页面，填写接收账户地址以及需要转账金额，确认后点击“发送”按钮。
4 ) 对转账信息进行核对后点击“确认” 按钮
5 ) 输入解锁密码，并点击“确认”
6 ) 获取交易发起成功反馈

注意：

普通账户以“gt”作为前缀，使用“gt”前缀的地址作为转账来源的交易是不可撤回的。

不可撤回的转账交易id前缀是 IRREVOCABLEPAY- ，这种前缀的转账交易是不可撤回的。

使用此功能，可将gt地址余额转账到以太坊0x...地址余额中，以进行后续的合约部署及交互。

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

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

# 3.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 ）本次撤回交易转入对应找回账户中

注意:

保险账户以“vault”作为前缀，使用“vault”前缀的地址作为转账来源的交易是可以被撤回的。

可撤回的转账交易id前缀是 REVOCABLEPAY- ，这种前缀的转账交易是可撤回的。

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

# 3.10 委托代币

GateChain的用户有两种方式参与POS挖矿：

1、搭建GateChain全节点，成为共识账户。

2、委托GT给其他共识账户。

钱包提供第二种委托给其他共识账户，来获得挖矿收益，具体操作步骤如下：

1 ）进入账户主页，点击“委托”按钮。
2 ）委托页面，在页面右上角点击“发起委托”按钮。
3 ）填写要委托的共识账户、委托金额，或者可以在委托账户处点击“查看所有共识账户”按钮，跳转到浏览器选择需要委托的共识账户。
4 ）确认委托信息，点击“确认”按钮。
5 ）回到委托页面，在我的委托列表显示委托记录。
6 ）委托页面，在我的委托列表右侧有“再次委托”按钮，可对此共识账户再次委托。
7 ）委托页面，在我的委托列表右侧有“转移委托”按钮。
8 ）点击“转移委托”按钮后，填写需要转移到共识账户地址、转移代币数量。
9 ）确认转移委托信息，点击“确认”按钮
10 ）回到委托页面，在我的委托列表显示转移委托记录。
11 ）委托页面，在我的委托列表右侧有“解除委托”按钮。
12 ）点击“解除委托”按钮后，填写需要解绑的代币数量。
13 ）确认解除委托信息，点击“确认”按钮。
14 ）回到委托页面，在我的委托列表中“解除委托中的代币数量”处，显示目前正在解绑的代币数，解除委托锁定时间为21天。
15 ）委托页面，在我的委托列表右侧有“提取收益”按钮。
16 ）点击“提取收益”按钮后，点击“发送”按钮，并确认提取收益信息。
17 ）回到委托页面，在我的委托列表“总收益”显示处，收益清零，提取的收益直接进入账户余额。
18 ）委托页面有委托历史列表，里面显示具体的委托、转移委托、解除委托、提取收益的交易信息。

# 3.11 进阶功能

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

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

选择需要进行操作的账户，点击进入账户概览。
点击右上角，进入账户详情。
查看账户详情

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

# 3.11.1 账户导出

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

# 3.11.2 查看私钥

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

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

# 3.11.3 删除账户

进入账户详情后点击右上方“删除账户”按钮
输入解锁密码后点击“确认”按钮，相关账户即被删除。

# 3.12 多签账户

# 3.12.1 创建多签账户

1 ）点击主界面“创建账户”，选择“多签账户 ”-->>“普通账户。
2 ）依次填写“账户名称”，选择“团队总人数”(2-7人数可选)，“最小签名数”以及“成员公钥”（可以使用钱包内已创建的账户公钥或填写其他非本地公钥），点击“下一步”。
3 ）进入确认页面，点击“创建”按钮，完成多签账户创建。
4 ) 按照提示将多签账户发布到链上。
5 ）发布公钥需要产生手续费，选择付款账户，并点击下一步。
6 ）确认信息后，输入解锁密码，获得交易发起成功反馈。