Specification

Đặ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).

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 public key của tài khoản, public key/private key của tài khoản gắn liền với 1 tài khoản và không thể thay đổi.

Các key chuẩn:

• 'name': value.toString('utf-8') là tên hiển thị của tài khoản trên mạng xã hội

• 'picture': value là dạng nhị phân của hình ảnh JPEG. Hiện tại các tài khoản bị giới hạn bandwidth ~ 21kB/24 tiếng, do đó chỉ cập nhật được hình ảnh tối đa ~20kB, phải resize kích thước hợp lý => sẽ bổ sung tiền cho các account

• 'followings': Giá trị của key là , value có cấu trúc như sau

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