Skip to content

Specification

Jump to bottom
Kha N. Do edited this page Dec 22, 2018 · 15 revisions

Đặc tả hệ thống

Một khối (block) có thể bao gồm nhiều giao dịch (transaction), khối do các nút xác thực (validator node) tạo ra và đưa và chuỗi khối. Cấu trúc của một giao dịch (tham khảo (vstruct)[https://github.com/varstruct/varstruct] phiên bản 1:

Giao dịch

const Transaction = vstruct([
  { name: 'version', type: vstruct.UInt8 },
  { name: 'account', type: vstruct.Buffer(35) },
  { name: 'sequence', type: vstruct.UInt64BE },
  { name: 'memo', type: vstruct.VarBuffer(vstruct.UInt8) },
  { name: 'operation', type: vstruct.UInt8 },
  { name: 'params', type: vstruct.VarBuffer(vstruct.UInt16BE) },
  { name: 'signature', type: vstruct.Buffer(64) },
]);
  • version: Phiên bản đặc tả giao dịch (hiện tại là 1)
  • account: Địa chỉ (address)/Khóa công khai (public key) của tài khoản
  • sequence: Thứ tự giao dịch của tài khoản, bắt đầu từ 1 và PHẢI tăng dần sau mỗi giao dịch thực hiện thành công
  • memo: Ghi chú giao dịch (tùy chọn), nếu bỏ qua thì điền Buffer.alloc(0)
  • operation: Thao tác thực hiện
    • 1: Tạo tài khoản
    • 2: Chuyển khoản
    • 3: Đăng nội dung
    • 4: Cập nhật tài khoản
  • params: Tham số tùy vào thao tác
  • signature: Chữ ký

Tài khoản

Tài khoản trong hệ thống được định danh bằng khóa công khai hoặc địa chỉ. Sử dụng thuật toán ed25519 và thư viện stellar-base. Để tạo ra một cặp khóa sử dụng lệnh:

const { Keypair } = require('stellar-base');

const key = Keypair.random();
console.log(key.secret());
console.log(key.publicKey());

Một cặp khóa được tạo ra cần được tạo một tài khoản tương ứng bởi một tài khoản đã có sẵn trên hệ thống. Các thành viên cung cấp địa chỉ (không được cung cấp khóa bí mật) để được tạo tài khoản và chuyển tiền sử dụng để phát triển đồ án.

Chữ ký

Sử dụng hàm sign của Keypair trên SHA256 của giao dịch (đã loại trừ chữ ký, điền 64 byte 0):

tx.signature = Buffer.alloc(64, 0);
const data = Transaction.encode(tx);
const unsignedHash = crypto
  .createHash('sha256')
  .update(data)
  .digest();
tx.signature = key.sign(data);

Mã giao dịch

Một giao dịch được định danh bằng mã giao dịch là 20 bytes SHA256 của giao dịch:

const hash = crypto.createHash('sha256')
  .update(Transaction.encode(tx))
  .digest()
  .slice(0, 20)
  .toString('hex')
  .toUpperCase();

Giao dịch của thể tìm thấy bằng cách sử dụng API host/tx?hash=0x[hash]

Thao tác

Lưu ý: Tham số thao tác cần được chuyển đổi thành Buffer trước khi đưa vào giao dịch.

Tạo tài khoản

const CreateAccountParams = vstruct([
  { name: 'address', type: vstruct.Buffer(35) },
]);

Thanh toán

const PaymentParams = vstruct([
  { name: 'address', type: vstruct.Buffer(35) },
  { name: 'amount', type: vstruct.UInt64BE },
]);

Đăng nội dung

const PostParams = vstruct([
  { name: 'content', type: vstruct.VarBuffer(vstruct.UInt16BE) },
  { name: 'keys', type: vstruct.VarArray(vstruct.UInt8, vstruct.Buffer(42)) },
]);

content được tổ chức theo cấu trúc như sau. Hiện tại type là 1 tương ứng với nội dung text đơn giản:

const PlainTextContent = vstruct([
  { name: 'type', type: vstruct.UInt8 },
  { name: 'text', type: vstruct.VarString(vstruct.UInt16BE) },
]);

Cho keys = [] để đăng bài viết chế độ công khai (không mã hóa).

Ví dụ: https://forest.network/transactions/1B170AE893B1FA37AAF347780F59FE274B1CE2DE4DFE8B5D4115FD69ABE4B937

Cập nhật tài khoản

const UpdateAccountParams = vstruct([
  { name: 'key', type: vstruct.VarString(vstruct.UInt8) },
  { name: 'value', type: vstruct.VarBuffer(vstruct.UInt16BE) },
]);

Các thông tin của tài khoản có thể được cập nhật theo thời gian, value sau sẽ thay thế cho value trước đó nếu cùng key. Lưu ý: KHÔNG CÓ chức năng cập nhật khóa công khai/bí mật của tài khoản do không thể thay đổi.

Các key chuẩn:

const Followings = vstruct([
  { name: 'addresses', type: vstruct.VarArray(vstruct.UInt16BE, vstruct.Buffer(35)) },
]);

Dùng base32 để chuyển về địa chỉ/khóa công khai của tài khoản được người dùng.

Tương tác

const InteractParams = vstruct([
  { name: 'object', type: vstruct.Buffer(32) },
  { name: 'content', type: vstruct.VarBuffer(vstruct.UInt16BE) },
]);

Object là mã giao dịch của hoạt động (giao dịch/bài viết) được tương tác. Hiện tại có 2 loại nội dung tương tác:

  • PlainTextContent (tham khảo phần đăng nội dung): type bằng 1, bình luận trên hoạt động

  • ReactContent: type bằng 2, phản ứng hoạt động, nếu trước đó đã có phản ứng thì phản ứng sau sẽ THAY THẾ phản ứng trước

const ReactContent = vstruct([
  { name: 'type', type: vstruct.UInt8 },
  { name: 'reaction', type: vstruct.UInt8 },
]);
  • reaction = 0: Không phản ứng (hủy bỏ phản ứng trước đó)
  • reaction = 1: Like
  • reaction = 2: Love
  • reaction = 3: Haha
  • reaction = 4: Wow
  • reaction = 5: Sad
  • reaction = 6: Angry

Gợi ý: Tạo struct Content chỉ với thuộc tính type để biết loại của nội dung hoặc try... catch từng loại (tham khảo các dò phiên bản giao dịch ở máy chủ)

Clone this wiki locally