1. 区块链与 Kaia 概述
1.1. 什么是区块链?
区块链是一个分布式且不可篡改的数字账本,用于记录网络中发生的所有交易。链上的每个区块都包含加密数量的交易,当创建新区块时,它会与前一个区块紧密相连,形成一个连续的链条,任何未经检测的篡改都无法实现。这确保了高度的透明性和安全性,因为未经网络共识,信息无法被轻易更改或删除,这使区块链成为货币、电子产品和智能合约等应用的基础技术。
1.2. Kaia 共识机制
共识机制:Kaia 采用伊斯坦布尔 BFT(Istanbul BFT)算法,这是针对区块链网络进行优化的 PBFT(实用拜占庭容错)的改进版本。
目标:
- 具备每秒处理 4,000 笔交易的能力。
- 具备即时完成交易的能力。
- 区块生成时间为 1 秒。
- 支持 50 多个共识节点参与该过程。
节点类型:
- CN(共识节点):由 CCO(核心单元运营商)管理,负责创建区块。
- PN(代理节点):提供连接到网络的接口。
- EN(端点节点):为终端用户提供服务。
共识过程:
当交易从 PN 发送至 CN(理事会)时, VRF(可验证随机函数) 函数会被用于随机选择 1 个 委员会 由 4 个 CN 组成的委员会。随后将继续随机选择 1 个 CN 来创建 区块 ,并结合其他 3 个 CN 的观测结果。当创建 区块 时, 理事会 中的 2/3 的 CN 必须对该 区块 进行签名以达成共识。
1.3 KLVM
KLVM,即 Kaia 虚拟机是在 Kaia 区块链网络上运行的去中心化虚拟机环境。 KLVM 支持执行智能合约。智能合约是根据预设代码条件自动执行交易或特定操作的程序。智能合约通常使用 Solidity 等编程语言编写,然后编译成 字节码 KLVM 可以理解和执行的字节码。 KLVM 兼容以太坊的 EVM,因此全面支持现有的开发工具、 操作码以及源代码。
1.4 什么是智能合约?
一个 智能合约 是一种旨在根据预编程条款自动执行、控制或确认事件与操作的计算机程序。它们存在并运行于 Kaia上,由于部署后无法修改,因此可确保高度的透明度与安全性。 智能合约 有助于自动化流程、减少对中间商的需求,并最大程度地降低欺诈或错误风险。它们具有极高的通用性,可广泛应用于从金融、保险到供应链管理和房地产等各个领域。 智能合约 的发展开启了我们互动和进行数字交易的新时代,为用户带来了更高的效率、透明度和自主性。
1.5. 交易与如何对交易进行签名
在 Kaia 网络中,“交易”或转账是指用户将 KLAY(Kaia 原生代币)或基于 Kaia 的代币从一个地址转移到另一个地址,或者与智能合约进行交互的操作。每笔交易都包含源地址、目标地址、转账金额、gas(交易费用)以及与智能合约交互时的可选数据等信息。
在 Kaia 上进行交易时,使用 MetaMask 等加密钱包对交易进行签名是确保安全性的重要一步。具体而言,该过程如下:
- 创建交易:用户输入交易所需的必要信息,例如接收地址、要转账的
KLAY或代币数量以及 gas。以 MetaMask 为例,用户可以调整 gas 级别以加快交易处理速度。 - 交易签名:输入交易信息后,钱包会生成一个使用用户私钥签署的数字交易。签署此交易证明了用户有权使用发送交易的地址,且不会泄露其私钥。
- 发送交易:随后,已签名的交易将通过 Kaikas 或 MetaMask 等钱包发送至 Kaia network。网络将确认并执行该交易,按要求转移资金或与智能合约进行交互。
- 交易确认:最后,交易将获得网络确认,相关信息将记录在区块链上。用户可以通过 Etherscan 等在线工具追踪交易状态。
得益于区块链的透明性和不可篡改性,这一过程不仅有助于确保交易安全执行,还能防止交易被篡改或未经授权地修改。
2. Solidity 文件结构
2.1. SPDX 许可证标识符
所有 Solidity 合约的第一行都应包含许可证声明。
// SPDX-License-Identifier: MITSPDX 仓库中的许可证列表:https://spdx.org/licenses/
2.2. Pragma 指令
pragma 是用于声明 Solidity 编译器版本的关键字。 pragma 仅适用于当前本地文件,因此必须将 pragma 添加到项目目录中的所有文件。
// SPDX-License-Identifier: MIT
pragma solidity 0.8.20;您可以使用 ^ 符号或比较运算符 <, <=, >, >= 与编译器声明结合使用。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20; // 使用 0.8.20 及以上版本的编译器// SPDX-License-Identifier: MIT
pragma solidity >=0.4.22 <0.9.0; // use compiler version bigger or equal to 0.4.22 and less than 0.9.02.3. 从其他来源导入文件
导入整个文件
import "FileName"导入全部内容并指定别名
import * as symbolName from "FileName";按名导入
按名导入 意味着你需要指定从另一个文件导入的对象的名称。建议使用此选项的原因是它能让你的代码更加清晰。
import {ContractOne as alias, ContractTwo} from "FileName";2.4. 注释
要添加注释,你可以使用 // 以及 /* */
// 单行注释。
/*
多行
注释
*/此外还有 NatSpec 注释,配合 /// 或 /** **/
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.16 <0.9.0;
/// @author The Project Team
/// @title A simple storage example
contract SimpleStorage {
uint storedData;
/// Store `x`.
/// @param x the new value to store
/// @dev stores the number in the state variable `storedData`
function set(uint x) public {
storedData = x;
}
/// Return the stored value.
/// @dev retrieves the value of the state variable `storedData`
/// @return the stored value
function get() public view returns (uint) {
return storedData;
}
}3. 合约结构
3.1. 状态变量
状态变量 是在合约开头声明的变量,位于以下作用域之外: 局部变量 声明于 函数.
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract SimpleStorage {
uint storedData; // State variable
// ...
}3.2. 函数
函数 是用于执行计算、更改变量值等操作的函数。以下是一个 函数 示例。
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.7.1 <0.9.0;
contract SimpleAuction {
function bid() public payable { // Function
// ...
}
}
// Helper function defined outside of a contract
function helper(uint x) pure returns (uint) {
return x * 2;
}3.3. 函数修饰器
函数修饰器 是用于 函数 为执行该操作的动作创建条件的声明 函数.
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.22 <0.9.0;
contract Purchase {
address public seller;
modifier onlySeller() { // Modifier
require(
msg.sender == seller,
"Only seller can call this."
);
_;
}
function abort() public view onlySeller { // Modifier usage
// ...
}
}3.4. 事件
事件 是用于记录智能合约活动的功能。 事件 通常用于构建与智能合约交互的用户界面(UI)。
// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.22;
event HighestBidIncreased(address bidder, uint amount); // Event
contract SimpleAuction {
function bid() public payable {
// ...
emit HighestBidIncreased(msg.sender, msg.value); // Triggering event
}
}3.5. 错误
错误 用于向用户告知操作失败的原因,并且 错误 具有较低的 gas 成本,优于返回 string.
// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.4;
/// Not enough funds for transfer. Requested `requested`,
/// but only `available` available.
error NotEnoughFunds(uint requested, uint available);
contract Token {
mapping(address => uint) balances;
function transfer(address to, uint amount) public {
uint balance = balances[msg.sender];
if (balance < amount)
revert NotEnoughFunds(amount, balance);
balances[msg.sender] -= amount;
balances[to] += amount;
// ...
}
}3.6. 结构体类型
struct 用于声明一个 类型 的 对象.
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract Ballot {
struct Voter { // Struct
uint weight;
bool voted;
address delegate;
uint vote;
}
}3.7. 枚举类型
enum 用于声明一个 类型 其值为 constant.
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract Purchase {
enum State { Created, Locked, Inactive } // Enum
}