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 等加密钱包对交易进行签名是确保安全性的重要一步。具体而言,该过程如下:

  1. 创建交易:用户输入交易所需的必要信息,例如接收地址、要转账的 KLAY 或代币数量以及 gas。以 MetaMask 为例,用户可以调整 gas 级别以加快交易处理速度。
  2. 交易签名:输入交易信息后,钱包会生成一个使用用户私钥签署的数字交易。签署此交易证明了用户有权使用发送交易的地址,且不会泄露其私钥。
  3. 发送交易:随后,已签名的交易将通过 Kaikas 或 MetaMask 等钱包发送至 Kaia network。网络将确认并执行该交易,按要求转移资金或与智能合约进行交互。
  4. 交易确认:最后,交易将获得网络确认,相关信息将记录在区块链上。用户可以通过 Etherscan 等在线工具追踪交易状态。

得益于区块链的透明性和不可篡改性,这一过程不仅有助于确保交易安全执行,还能防止交易被篡改或未经授权地修改。

2. Solidity 文件结构

2.1. SPDX 许可证标识符

所有 Solidity 合约的第一行都应包含许可证声明。

// SPDX-License-Identifier: MIT

SPDX 仓库中的许可证列表: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.0

2.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
}