Skip to content

Thomas-YHS.md

Latest commit

 

History

History
427 lines (242 loc) · 12.7 KB

Thomas-YHS.md

File metadata and controls

427 lines (242 loc) · 12.7 KB
timezone UTC+8

Thomas

GitHub ID: Thomas-YHS

Telegram: @Thomas_YHS

Self-introduction

LXDAO成员，智能合约开发者，AI Agent开发者，参与了 ZetaChain 中文文档翻译，希望这次共学黑客松可以学习进步。

Notes

2025-12-06

打个卡，正在写项目

2025-12-05

Universal EVM

ZetaChain is a Proof of Stake (PoS) blockchain built with the Cosmos SDK, the CometBFT consensus engine, and Cosmos EVM.

ZetaChain 不是 EVM L2 或 rollup，它是 Cosmos 链。但它内置 **Cosmos EVM，**咱们写的EVM直接在这上面运行。

Full EVM compatibility: with Cosmos EVM, enabling Ethereum smart contracts to run natively on ZetaChain without modification.

这句话表明，ZetaChain 完全兼容 EVM 环境，可以实现原生 solidity 智能合约。

ZetaChain acts as a universal connector between blockchains, offering fast ~4-second blocks, instant finality, and throughput up to hundreds of transactions per second, all on infrastructure purpose-built for secure, seamless cross-chain interactions.

架构

ZetaChain 采用了中心-辐射的架构，一切的跨链请求都需要经过 ZetaChain ，不能越过 ZetaChain 进行两条链的互通。所有跨链消息和交易都通过ZetaChain进行，确保一致的处理、新链的更容易集成，以及单一的安全和验证规则执行点。

Validator

ZetaChain 中的 Validator 主要有两个角色：

类型 负责
Core Validator 负责出块
Observer-Signer Validator 负责跨链监听和签名
模块 做什么 你需要做什么
CrossChain 处理跨链交易生命周期 用 onCall() 接收处理后的事件
Observer 监听外部链 + 投票共识 不需要写 listener / 不需要做多签
Fungible 管理 ZRC20 用 ZRC20 记账和转账
Emissions 分发奖励给网络节点 不影响 Vault 逻辑
Authority 管理权限和升级 未来可能用，现在不用

Protocol Contracts

ZetaChain 上的合约：

Contract 用途
GatewayZEVM 跨链发钱的唯一入口
ZRC-20 映射外部链资产
ContractRegistry 查合约地址

2025-12-04

今天参加了workshop，顺便打个卡

2025-12-02

My First ZETA

🆕

第一个 ZETA 链上的程序，同时也是 ZETA Chain 使用的详细流程指南

⚠️

前置准备任务

1. 安装 Node.js（>= v21）

ZetaChain 的脚本与 CLI 依赖 Node.js 运行环境。

检查版本：

node -v

2. 安装 jq（JSON 解析工具）

例如：

cat output.json | jq .

3. 安装 git

用于源码管理和拉取示例代码。

4. 安装包管理器（npm 或 yarn）

用于安装 CLI 或项目依赖

5. 安装 Foundry（EVM 合约开发工具链）

视频说明 Foundry 用于构建合约，并且 Localnet 依赖 Foundry。

安装地址：

curl -L <https://getfoundry.sh> | bash

验证安装：

forge --version

6. 安装 ZetaChain CLI（zchain CLI）

ZetaChain 的主要网络交互工具，如查询链、交易、余额等。

安装命令：

npm install -g zetachain

检查版本：

zetachain --version

7. 启动 Localnet（可选但强烈推荐）

Localnet 会自动部署：

  • ZetaChain 本地节点

  • EVM链

  • 以及协议合约

这样就不需要依赖公链 testnet 就能本地测试。

启动：

zetachain localnet start

Localnet 默认包含：

  • ZetaChain

  • EVM Chain

  • 可扩展到 Sui、Solana、TON（如果安装对应 CLI）

image.png

Hello Project

根据Hello模版创建一个，示例代码：

npx zetachain@latest new --project hello
cd hello
yarn
forge soldeer update

foundry soldeer update 会同步并更新由 Foundry 的 Soldeer 管理的 Solidity 依赖项，确保你的合约是针对外部库的最新兼容版本进行构建的。

// SPDX-License-Identifier: MIT
pragma solidity 0.8.26;

import "@zetachain/protocol-contracts/contracts/zevm/interfaces/UniversalContract.sol";

contract Universal is UniversalContract {
    event HelloEvent(string, string);
		// 一个 Universal Contract 必须实现OnCall函数，当合约通过网关从连接的链接收调用时，该函数会被触发。
    function onCall(
        MessageContext calldata context,
        address zrc20,
        uint256 amount,
        bytes calldata message
    ) external override onlyGateway {
        string memory name = abi.decode(message, (string));
        emit HelloEvent("Hello: ", name);
    }
}

一个 Universal Contract 必须实现OnCall函数，当合约通过网关从连接的链接收调用时，该函数会被触发。 其必须包含MessageContext 结构体：context（包括 ChainID 和 Sender）， zrc20 address：zrc20地址。

amount : 转移的代币数量。

message : 编码的有效载荷数据。

所有的 Universal contract 必须重写 onlyGateway 方法，因为 gateway 是防止被其他地址恶意调用。

代码完成后开始部署：

  1. forge 编译环境 forge build

  2. 获取 local network 上的私钥：

PRIVATE_KEY=$(jq -r '.private_keys[0]' ~/.zetachain/localnet/anvil.json) && echo $PRIVATE_KEY
  1. 部署通用合约：
UNIVERSAL=$(forge create Universal \\
  --rpc-url <http://localhost:8545> \\
  --private-key $PRIVATE_KEY \\
  --evm-version paris \\
  --broadcast \\
  --json | jq -r .deployedTo) && echo $UNIVERSAL

部署完成后调用通用应用：

从连接的链调用部署在 ZetaChain 上的通用应用，向连接的 EVM 链上的网关合约发送交易。

  1. 获取已连接链的网关地址：
GATEWAY_EVM=$(jq -r '.["11155112"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_EVM
  1. 在连接的链的网关上执行 call 方法，向部署在 ZetaChain 上的通用合约发送消息。
npx zetachain evm call \\
  --rpc <http://localhost:8545> \\
  --gateway $GATEWAY_EVM \\
  --receiver $UNIVERSAL \\
  --private-key $PRIVATE_KEY \\
  --types string \\
  --values hello

image.png

合约部分完成后进入前端交互部分：

  1. 安装依赖：

2025-12-01

打卡一下

2025-11-29

image.png

2025-11-28

今天整理了笔记，之后看了昨天workspace的回放，先打个卡，之后今天有了一个AI金库的想法，先打个卡免得被淘汰，正在想可行性。

ZetaChain 介绍

Universal Blockchain

ZetaChain 是一个 跨链互操作性（Interoperability）平台，它的目标是成为 “Universal Blockchain（通用区块链）” —— 一个能够原生连接所有区块链、让资产和数据在任何链之间自由流动的基础设施。

**ZetaChain 是一个能够让所有区块链互相通信、互相调用智能合约、互相转账的“跨链操作系统”。**它让 Bitcoin → Ethereum、Solana → BNB Chain、Sui → Polygon 等跨链交互像在同一条链上一样简单。

Universal PoS

ZetaChain 采用了PoS 的质押模式，基于Cosmos SDK + CometBFT 来构建的公链。

Universal EVM allows smart contracts to read/write to other chains.

Universal EVM

Universal EVM allows smart contracts to read/write to other chains.

  • 一个智能合约控制多个链的钱包

  • 在 ZetaChain 上写一个合约 = 控制所有链上的合约/资产

  • 开发者用 EVM 语言（Solidity）就能写多链应用

Universal Smart Contract

  • 跨链 orchestrate（编排）复杂动作

  • 一次交易十链联动

  • 从任意链读写数据

  • 访问任何链的原生资产

  • 不需要跨链桥

我觉得 ZetaChain 在 Defi 方面厉害的点是不需要跨链桥就可以完成跨链操作，如果大面积使用的话会减少跨链 Defi 产品的成本，增强资金的流动性。

为什么选用 ZetaChain ？

Chain Orchestrate（跨链协调能力）

One of the standout features of ZetaChain is its ability to orchestrate complex transactions across multiple blockchains from a single smart contract. Universal apps built on ZetaChain can manage incoming token transfers and contract calls from different blockchains and initiate outgoing transactions to connected networks—all within a unified framework.

跨链编排能力可以允许你只维护有限的代码，就可以实现复杂的跨链操作。你不需要再为不同的代码仓库发愁，只需要管ZetaChain的一个代码仓库即可。

Forward Compatibility（自动兼容未来所有链）

When you deploy an app on ZetaChain, it automatically connects to all networks in the ZetaChain ecosystem. As new blockchains are added, your universal app gains compatibility with these networks without any additional effort or modifications to your contract's source code. This forward compatibility is a significant advantage, as it future-proofs your application. You don't have to anticipate which blockchains might become popular or widely adopted in the future; your app will be ready to interact with them as soon as they are integrated into ZetaChain. This not only saves development time but also ensures that your app remains relevant and accessible to users across different blockchain networks.

当未来有新链发布，你想要接入新链，不需要更改代码自动接入新链。

Transfer Native Tokens

For example, users can send native USDC from Ethereum directly to Polygon, or swap native BTC from the Bitcoin network for PEPE tokens on Ethereum. This cross-chain token transfer functionality enhances liquidity and provides a seamless experience, eliminating the need for intermediaries or complex token wrapping mechanisms.

To facilitate these transfers, universal apps have access to unified liquidity pools on ZetaChain. These pools aggregate liquidity from all connected chains, containing tokens that have been transferred to ZetaChain from their respective networks.

Adding liquidity to these unified pools involves transferring tokens to the custody of ZetaChain validators on the connected chains. For instance, ZetaChain validators hold custody of ETH, USDC, and other tokens on Ethereum. This custody mechanism is secured through robust consensus protocols and validator incentives, ensuring the safety of the assets.

This system allows users to send tokens to and from universal apps, as well as directly between connected chains, without the need for centralized exchanges or third-party bridges. It streamlines the user experience and reduces the risks associated with cross-chain transactions, such as double-spending or transaction failures.

By using native tokens, users benefit from the inherent properties of those assets, including their security features, consensus mechanisms, and existing network effects. This enhances trust and reliability in cross-chain operations conducted through ZetaChain-powered universal apps.

支持从不同的链转移原生代币到 ZetaChain ，增加了资金安全性，降低了跨链桥的风险。同时 ZetaChain 维护跨链流动池，并由验证者管理原生资产的托管，安全级别类似于 Tendermint+BFT 的验证者模型。

2025-11-27

今天先打个卡，刚到家，准备一会写一个ZRC-20合约，本地部署一下

2025-11-26

今天主要看了ZetaChain的文档，搭建了ZetaChain cli 测试网节点

2025-11-24

打卡第一天