Các thành phần máy chủ và tác nhân cho ứng dụng web3

tác nhân

máy chủ

ngoài chuỗi

Người mới bắt đầu

Ori Pomerantz

15 tháng 7, 2024

11 số phút đọc

Giới thiệu

Trong hầu hết các trường hợp, một ứng dụng phi tập trung sử dụng một máy chủ để phân phối phần mềm, nhưng tất cả các tương tác thực tế xảy ra giữa máy khách (thường là trình duyệt web) và chuỗi khối.

Tuy nhiên, có một số trường hợp một ứng dụng sẽ được hưởng lợi từ việc có một thành phần máy chủ chạy độc lập. Một máy chủ như vậy sẽ có thể phản hồi các sự kiện và các yêu cầu đến từ các nguồn khác, chẳng hạn như API, bằng cách phát hành các giao dịch.

Có một số nhiệm vụ khả thi mà một máy chủ như vậy có thể thực hiện.

Người nắm giữ trạng thái bí mật. Trong trò chơi, việc không cung cấp tất cả thông tin mà trò chơi biết cho người chơi thường rất hữu ích. Tuy nhiên, không có bí mật nào trên chuỗi khối, bất kỳ thông tin nào trên chuỗi khối đều dễ dàng cho bất kỳ ai tìm ra. Do đó, nếu một phần trạng thái của trò chơi cần được giữ bí mật, nó phải được lưu trữ ở nơi khác (và có thể có các tác động của trạng thái đó được xác minh bằng cách sử dụng bằng chứng không kiến thức).
Oracle tập trung. Nếu rủi ro đủ thấp, một máy chủ bên ngoài đọc một số thông tin trực tuyến và sau đó đăng nó lên chuỗi có thể đủ tốt để sử dụng như một oracle.
Tác nhân. Không có gì xảy ra trên chuỗi khối nếu không có giao dịch để kích hoạt nó. Một máy chủ có thể thay mặt người dùng thực hiện các hành động như kinh doanh chênh lệch giá khi có cơ hội.

Chương trình mẫu

Bạn có thể xem một máy chủ mẫu trên github (opens in a new tab). Máy chủ này lắng nghe các sự kiện đến từ hợp đồng này (opens in a new tab), một phiên bản sửa đổi của Greeter của Hardhat. Khi lời chào được thay đổi, nó sẽ thay đổi lại.

Để chạy nó:

Sao chép kho lưu trữ.

1git clone https://github.com/qbzzt/20240715-server-component.git
2cd 20240715-server-component

Cài đặt các gói cần thiết. Nếu bạn chưa có, hãy cài đặt Node trước (opens in a new tab).
```
1npm install
```
Chỉnh sửa .env để chỉ định khóa riêng tư của một tài khoản có ETH trên mạng thử nghiệm Holesky. Nếu bạn không có ETH trên Holesky, bạn có thể sử dụng vòi này (opens in a new tab).
```
1PRIVATE_KEY=0x <private key goes here>
```
Khởi động máy chủ.
```
1npm start
```
Đi tới một trình khám phá khối (opens in a new tab), và sử dụng một địa chỉ khác với địa chỉ có khóa riêng tư để sửa đổi lời chào. Xem lời chào được tự động sửa đổi lại.

Nó hoạt động như thế nào?

Cách dễ nhất để hiểu cách viết một thành phần máy chủ là xem qua mẫu từng dòng một.

`src/app.ts`

Phần lớn chương trình được chứa trong src/app.ts (opens in a new tab).

Tạo các đối tượng tiên quyết

1import {
2  createPublicClient,
3  createWalletClient,
4  getContract,
5  http,
6  Address,
7} from "viem"

Đây là các thực thể Viem (opens in a new tab) mà chúng ta cần, các hàm và kiểu Address (opens in a new tab). Máy chủ này được viết bằng TypeScript (opens in a new tab), là một phần mở rộng của JavaScript giúp nó định kiểu mạnh (opens in a new tab).

1import { privateKeyToAccount } from "viem/accounts"

Hàm này (opens in a new tab) cho phép chúng ta tạo thông tin ví, bao gồm địa chỉ, tương ứng với một khóa riêng tư.

1import { holesky } from "viem/chains"

Để sử dụng chuỗi khối trong Viem, bạn cần nhập định nghĩa của nó. Trong trường hợp này, chúng ta muốn kết nối với chuỗi khối thử nghiệm Holesky (opens in a new tab).

1// Đây là cách chúng tôi thêm các định nghĩa trong .env vào process.env.
2import * as dotenv from "dotenv"
3dotenv.config()

Đây là cách chúng ta đọc .env vào môi trường. Chúng ta cần nó cho khóa riêng tư (xem phần sau).

1const greeterAddress : Address = "0xB8f6460Dc30c44401Be26B0d6eD250873d8a50A6"
2const greeterABI = [
3    {
4        "inputs": [
5            {
6                "internalType": "string",
7                "name": "_greeting",
8                "type": "string"
9            }
10        ],
11        "stateMutability": "nonpayable",
12        "type": "constructor"
13    },
14         .
15         .
16         .
17    {
18        "inputs": [
19            {
20                "internalType": "string",
21                "name": "_greeting",
22                "type": "string"
23            }
24        ],
25        "name": "setGreeting",
26        "outputs": [],
27        "stateMutability": "nonpayable",
28        "type": "function"
29    }
30] as const
Hiện tất cả

Để sử dụng một hợp đồng, chúng ta cần địa chỉ và của nó. Chúng tôi cung cấp cả hai ở đây.

Trong JavaScript (và do đó là TypeScript), bạn không thể gán một giá trị mới cho một hằng số, nhưng bạn có thể sửa đổi đối tượng được lưu trữ trong đó. Bằng cách sử dụng hậu tố as const, chúng ta đang nói với TypeScript rằng chính danh sách đó là hằng số và không thể thay đổi.

1const publicClient = createPublicClient({
2  chain: holesky,
3  transport: http(),
4})

Tạo một máy khách công khai (opens in a new tab) của Viem. Các máy khách công khai không có khóa riêng tư đính kèm, và do đó không thể gửi các giao dịch. Chúng có thể gọi các hàm view (opens in a new tab), đọc số dư tài khoản, v.v.

1const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

Các biến môi trường có sẵn trong process.env (opens in a new tab). Tuy nhiên, TypeScript được định kiểu mạnh. Một biến môi trường có thể là bất kỳ chuỗi nào, hoặc trống, vì vậy kiểu của một biến môi trường là string | undefined. Tuy nhiên, một khóa được định nghĩa trong Viem là 0x${string} (0x theo sau là một chuỗi). Ở đây chúng ta nói với TypeScript rằng biến môi trường PRIVATE_KEY sẽ thuộc loại đó. Nếu không, chúng ta sẽ nhận được một lỗi thời gian chạy.

Hàm privateKeyToAccount (opens in a new tab) sau đó sử dụng khóa riêng tư này để tạo một đối tượng tài khoản đầy đủ.

1const walletClient = createWalletClient({
2  account,
3  chain: holesky,
4  transport: http(),
5})

Tiếp theo, chúng ta sử dụng đối tượng tài khoản để tạo một máy khách ví (opens in a new tab). Máy khách này có một khóa riêng tư và một địa chỉ, vì vậy nó có thể được sử dụng để gửi các giao dịch.

1const greeter = getContract({
2  address: greeterAddress,
3  abi: greeterABI,
4  client: { public: publicClient, wallet: walletClient },
5})

Bây giờ chúng ta đã có tất cả các điều kiện tiên quyết, cuối cùng chúng ta có thể tạo một thể hiện hợp đồng (opens in a new tab). Chúng ta sẽ sử dụng thể hiện hợp đồng này để giao tiếp với hợp đồng trên chuỗi.

Đọc từ chuỗi khối

1console.log(`Current greeting:`, await greeter.read.greet())

Các hàm hợp đồng chỉ đọc (view (opens in a new tab) và pure (opens in a new tab)) có sẵn trong read. Trong trường hợp này, chúng ta sử dụng nó để truy cập hàm greet (opens in a new tab), hàm này trả về lời chào.

JavaScript là đơn luồng, vì vậy khi chúng ta khởi động một tiến trình chạy dài, chúng ta cần chỉ định rằng chúng ta thực hiện nó một cách bất đồng bộ (opens in a new tab). Việc gọi chuỗi khối, ngay cả đối với một hoạt động chỉ đọc, đòi hỏi một tương tác hai chiều giữa máy tính và một nút chuỗi khối. Đó là lý do tại sao ở đây chúng ta chỉ định mã cần await kết quả.

Nếu bạn quan tâm đến cách hoạt động của nó, bạn có thể đọc về nó ở đây (opens in a new tab), nhưng về mặt thực tế, tất cả những gì bạn cần biết là bạn await kết quả nếu bạn bắt đầu một hoạt động mất nhiều thời gian, và bất kỳ hàm nào làm điều này đều phải được khai báo là async.

Phát hành giao dịch

1const setGreeting = async (greeting: string): Promise<any> => {

Đây là hàm bạn gọi để phát hành một giao dịch thay đổi lời chào. Vì đây là một hoạt động dài, hàm được khai báo là async. Do cách triển khai nội bộ, bất kỳ hàm async nào cũng cần trả về một đối tượng Promise. Trong trường hợp này, Promise<any> có nghĩa là chúng ta không chỉ định chính xác những gì sẽ được trả về trong Promise.

1const txHash = await greeter.write.setGreeting([greeting])

Trường write của thể hiện hợp đồng có tất cả các hàm ghi vào trạng thái chuỗi khối (những hàm yêu cầu gửi một giao dịch), chẳng hạn như setGreeting (opens in a new tab). Các tham số, nếu có, được cung cấp dưới dạng một danh sách, và hàm trả về hàm băm của giao dịch.

1    console.log(`Working on a fix, see https://eth-holesky.blockscout.com/tx/${txHash}`)
2
3    return txHash
4}

Báo cáo hàm băm của giao dịch (như một phần của URL đến trình khám phá khối để xem nó) và trả về nó.

Phản hồi sự kiện

1greeter.watchEvent.SetGreeting({

Hàm watchEvent (opens in a new tab) cho phép bạn chỉ định một hàm sẽ chạy khi một sự kiện được phát ra. Nếu bạn chỉ quan tâm đến một loại sự kiện (trong trường hợp này là SetGreeting), bạn có thể sử dụng cú pháp này để giới hạn mình trong loại sự kiện đó.

1    onLogs: logs => {

Hàm onLogs được gọi khi có các mục nhật ký. Trong Ethereum, "nhật ký" và "sự kiện" thường có thể thay thế cho nhau.

1console.log(
2  `Address ${logs[0].args.sender} changed the greeting to ${logs[0].args.greeting}`
3)

Có thể có nhiều sự kiện, nhưng để đơn giản, chúng ta chỉ quan tâm đến sự kiện đầu tiên. logs[0].args là các đối số của sự kiện, trong trường hợp này là sender và greeting.

1        if (logs[0].args.sender != account.address)
2            setGreeting(`${account.address} insists on it being Hello!`)
3    }
4})

Nếu người gửi không phải là máy chủ này, hãy sử dụng setGreeting để thay đổi lời chào.

`package.json`

Tệp này (opens in a new tab) kiểm soát cấu hình Node.js (opens in a new tab). Bài viết này chỉ giải thích các định nghĩa quan trọng.

1{
2  "main": "dist/index.js",

Định nghĩa này chỉ định tệp JavaScript nào sẽ chạy.

1  "scripts": {
2    "start": "tsc && node dist/app.js",
3  },

Các tập lệnh là các hành động ứng dụng khác nhau. Trong trường hợp này, cái duy nhất chúng ta có là start, nó biên dịch và sau đó chạy máy chủ. Lệnh tsc là một phần của gói typescript và biên dịch TypeScript thành JavaScript. Nếu bạn muốn chạy nó theo cách thủ công, nó nằm trong node_modules/.bin. Lệnh thứ hai chạy máy chủ.

1  "type": "module",

Có nhiều loại ứng dụng node JavaScript. Loại module cho phép chúng ta có await trong mã cấp cao nhất, điều này quan trọng khi bạn thực hiện các hoạt động chậm (và do đó là bất đồng bộ).

1  "devDependencies": {
2    "@types/node": "^20.14.2",
3    "typescript": "^5.4.5"
4  },

Đây là những gói chỉ cần thiết cho việc phát triển. Ở đây chúng ta cần typescript và vì chúng ta đang sử dụng nó với Node.js, chúng ta cũng đang nhận được các kiểu cho các biến và đối tượng của node, chẳng hạn như process. Ký hiệu ^<version> (opens in a new tab) có nghĩa là phiên bản đó hoặc một phiên bản cao hơn không có các thay đổi đột phá. Xem ở đây (opens in a new tab) để biết thêm thông tin về ý nghĩa của các số phiên bản.

1  "dependencies": {
2    "dotenv": "^16.4.5",
3    "viem": "2.14.1"
4  }
5}

Đây là những gói được yêu cầu tại thời gian chạy, khi chạy dist/app.js.

Kết luận

Máy chủ tập trung mà chúng tôi đã tạo ở đây thực hiện công việc của nó, đó là hoạt động như một tác nhân cho một người dùng. Bất kỳ ai khác muốn dapp tiếp tục hoạt động và sẵn sàng chi trả gas đều có thể chạy một phiên bản mới của máy chủ với địa chỉ của riêng họ.

Tuy nhiên, điều này chỉ hoạt động khi các hành động của máy chủ tập trung có thể được xác minh dễ dàng. Nếu máy chủ tập trung có bất kỳ thông tin trạng thái bí mật nào, hoặc chạy các phép tính khó, nó là một thực thể tập trung mà bạn cần tin tưởng để sử dụng ứng dụng, điều mà các chuỗi khối cố gắng tránh. Trong một bài viết trong tương lai, tôi dự định sẽ chỉ ra cách sử dụng bằng chứng không kiến thức để giải quyết vấn đề này.

Xem thêm công việc của tôi tại đây (opens in a new tab).

Lần cập nhật trang lần cuối: 25 tháng 2, 2026