Chuyển tới nội dung chính

Định dạng lệnh

Mọi thao tác PiNS đều là một giao dịch PIVX được che chắn gửi tới địa chỉ giao thức của nhà đăng ký, trong đó số tiền là khoản thanh toán còn memo là lệnh đã ký. Cả hai cùng đi trong một ghi chú, nên ý định và thanh toán gắn chặt không tách rời — không có mã tham chiếu hay hóa đơn riêng nào phải đối chiếu.

Trang này mô tả đúng định dạng truyền. Một lệnh dựng theo nó sẽ được cả nhà đăng ký lẫn mạch không tiết lộ tri thức chấp nhận.

Cấu trúc​

Mọi lệnh đều là ASCII phân tách bằng dấu hai chấm, bắt đầu bằng dấu hiệu giao thức và phiên bản:

PiNS:1:{OP}:{name}:…:{ed25519_pubkey_hex}:…:{nonce}:{signature_hex}

Các trường ở giữa phụ thuộc vào thao tác:

Thao tácBố cục memoSố tiền phải trả
REG đăng kýPiNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig}phí đăng ký theo độ dài tên
UPD đổi địa chỉPiNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig}phí thay đổi
CHG chuyển chủ sở hữuPiNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig}phí thay đổi
LST rao bánPiNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig}phí thay đổi
ULT gỡ khỏi chợPiNS:1:ULT:{name}:{pubkey}:{nonce}:{sig}phí thay đổi
BUY muaPiNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig}đúng giá niêm yết

Với CHG, {new_pubkey} là khóa của chủ sở hữu tiếp nhận, còn chữ ký do chủ sở hữu chuyển giao tạo ra — chính chủ sở hữu hiện tại cho phép việc chuyển giao.

Thông điệp được ký​

Chữ ký bao trùm lệnh không gồm phần :{signature} ở cuối — tức là mọi thứ từ dấu hiệu giao thức cho tới hết nonce:

PiNS:1:REG:richard.pivx:ps1f84lvgj…:0101…0101:1780000001

Các quy tắc rất chặt, và một ứng dụng khách sai bất kỳ điều nào cũng sẽ tạo ra chữ ký bị mạch từ chối:

  • pubkey là hex chữ thường, 64 ký tự.
  • price chỉ xuất hiện với LST.
  • address chỉ xuất hiện với REG, UPD và BUY.
  • price và nonce ở hệ thập phân, không có số 0 dẫn đầu, không dấu và không đệm.
  • Chữ ký là Ed25519 trên đúng những byte đó, mã hóa hex, 128 ký tự.

Việc kiểm chứng là nghiêm ngặt: chữ ký không chuẩn tắc và khóa bậc nhỏ đều bị từ chối.

Quy tắc các trường​

Tên​

Quy tắcGiá trị
Ký tựa-z, 0-9, dấu gạch nối
Độ dài1–64 ký tự tính cả vùng
Chữ hoa/thườngchỉ chữ thường — tên được lưu và băm ở dạng chữ thường
Dấu gạch nốikhông ở đầu, không ở cuối, không bao giờ đôi
Vùng.pivx, .private, .secure, .safe

Chỉ cho phép đúng một dấu chấm, ngăn nhãn với vùng.

Địa chỉ đích​

Địa chỉ mà một tên phân giải tới phải là địa chỉ thanh toán được che chắn PIVX Sapling trên mainnet — bech32, tiền tố dễ đọc ps, đúng 78 ký tự. Địa chỉ minh bạch và mọi thứ khác đều bị từ chối.

Độ dài không tùy tiện. Một địa chỉ thanh toán Sapling là tải trọng 43 byte — bộ đa dạng hóa 11 byte cộng pk_d 32 byte — được bech32 mã hóa thành 69 ký tự dữ liệu cộng 6 ký tự tổng kiểm tra, tức ps + dấu phân tách + 69 + 6 = 78.

Quy tắc này thuộc về chính giao thức: trình lập chỉ mục và mạch áp dụng nó như nhau, và còn yêu cầu địa chỉ viết thường — tổng kiểm tra Bech32 không phân biệt hoa thường, nên nếu không, hai cách viết của cùng một địa chỉ sẽ cho ra hai lá khác nhau trên cây. Nó không xuất phát từ cách nhà đăng ký trả tiền: tiền hoàn và doanh thu bán tên không bao giờ được gửi tới địa chỉ mà tên trỏ tới, mà được ghi vào số dư nội bộ của một khóa Ed25519, nơi chủ khóa rút chúng ra.

mẹo

Chỉ chấp nhận dạng bech32 hiện đại

Dạng testnet cũ ptestsapling… (88 ký tự) bị từ chối trên cả hai mạng, và mạch áp dụng đúng quy tắc như nhà đăng ký. Mọi ví PIVX hiện nay đều tạo ra dạng ps… trên mainnet.

Nonce​

Nonce là dấu thời gian Unix tính bằng giây tại thời điểm bạn ký.

  • Nó phải lớn hơn nghiêm ngặt so với nonce đang được ghi cho tên đó. Đây chính là thứ ngăn việc phát lại một lệnh đã ký từ trước.
  • Nó không được vượt trước khối chứa nó quá 300 giây; khoảng đệm này hấp thụ sai lệch đồng hồ thông thường mà không cho phép đặt một nonce ở quá xa trong tương lai.

Với lần đăng ký đầu tiên, bất kỳ dấu thời gian hiện tại nào cũng được.

Lệnh có nonce không lớn hơn nonce đã ghi sẽ bị từ chối, và khoản thanh toán của nó được hoàn vào số dư nội bộ của bạn, nơi mỗi lần rút chịu phí dịch vụ 5%. Điều này có thể xảy ra khi đồng hồ chạy chậm, hoặc khi hai lệnh cho cùng một tên được ký trong cùng một giây. Vì vậy, hãy lấy giá trị lớn hơn giữa thời gian hiện tại và nonce mới nhất của tên cộng một giây; nonce mới nhất đó là nonce mà phân giải tên trả về, hoặc nonce của một lệnh của chính bạn cho tên đó vẫn đang chờ xử lý, tùy cái nào muộn hơn.

Giá​

Chỉ LST mang giá. Đó là một số nguyên satoshi (1 PIVX = 100.000.000 satoshi) và phải lớn hơn 0.

Được phép rao bán lại một tên đã niêm yết ở mức giá mới — hãy gửi thêm một lệnh LST. Lệnh gần nhất sẽ thắng.

Giới hạn kích thước​

Một memo PIVX chiếm đúng 512 byte, và toàn bộ lệnh phải vừa trong đó. Các phần cố định tiêu tốn một lượng dự đoán được:

PiNS:1:{OP}: … marker, version, operation 11 bytes
{pubkey} 64 hex characters 65 bytes with separator
{nonce} 10 digits today 11 bytes with separator
{signature} 128 hex characters 128 bytes
{address} 78 characters 79 bytes with separator

Địa chỉ Sapling luôn cố định 78 ký tự, nên khác với một định dạng địa chỉ có độ dài thay đổi, ngân sách rất dễ tính: còn khoảng 218 byte cho tên, nhiều hơn hẳn mức tối đa 64 ký tự mà một tên có thể dùng. Trên thực tế một lệnh luôn vừa. Dù vậy, ứng dụng khách vẫn nên tính ngân sách thay vì mặc định, để một trường trong tương lai không bao giờ làm tràn memo một cách âm thầm.

Thanh toán​

Số tiền quyết định tính hợp lệ không kém gì memo:

  • REG phải trả đúng phí đăng ký tương ứng độ dài tên.
  • UPD, CHG, LST, ULT phải trả đúng phí thay đổi.
  • BUY phải trả đúng giá niêm yết.

Độ dài được đo trên nhãn, không tính vùng: ab.pivx là tên 2 ký tự.

Lệnh trả thiếu hoặc trả thừa sẽ không được xử lý, và một memo không qua được bước kiểm tra định dạng hoặc chữ ký cũng vậy. Cả hai đều được hoàn vào số dư nội bộ của bạn nếu khoản thanh toán ít nhất 0.01 PIVX và vẫn đọc được đến mức: phần đầu PiNS:1:, một thao tác đã biết và một khóa công khai hợp lệ — với CHG là một tên đang tồn tại. CHG ghi chủ sở hữu mới chứ không ghi người ký, nên khoản hoàn của nó về tay chủ sở hữu tên đã ký nó, còn CHG không có chủ sở hữu nào ký thì không được hoàn. Khoản hoàn được ghi có sau 120 xác nhận và sau đó có thể rút — xem Hỏi & Đáp.

Khoản thanh toán có memo chứa dù chỉ một ký tự nằm ngoài ASCII in được sẽ không được hoàn tự động, bất kể số tiền, khoản thanh toán dưới 0.01 PIVX cũng vậy: những khoản đó được báo cho đội ngũ PIVX Name — xem Hỏi & Đáp.

Thứ tự​

Các lệnh được xử lý theo thứ tự mà PIVX tạo ra chúng: chiều cao khối, rồi chỉ số giao dịch trong khối. Nhà đăng ký không chọn thứ tự và không thể đảo thứ tự mà không khiến mọi trình lập chỉ mục độc lập tính ra một gốc khác.

Mỗi giao dịch mang một lệnh: đầu ra đầu tiên tới địa chỉ nhà đăng ký, theo chỉ số đầu ra, có memo là một lệnh đúng định dạng. Mọi đầu ra khác tới nhà đăng ký trong cùng giao dịch đó đều không được xử lý và cũng không được hoàn tự động, vì vậy hãy gửi mỗi lệnh trong một giao dịch riêng.

Với các thao tác tranh chấp — hai lệnh REG cho cùng một tên, hoặc hai lệnh BUY cho cùng một niêm yết — lệnh đầu tiên theo thứ tự đó thắng, số tiền của những lệnh còn lại được hoàn về số dư nội bộ.

Ví dụ có lời giải​

Đăng ký richard.pivx:

1. Generate an Ed25519 keypair. The public key is your identity across all your names.

2. Build the message to sign (note: no trailing signature field):

PiNS:1:REG:richard.pivx:ps1f84lvgj0awz…:3757ee1a…a53:1780000001

3. Sign it with the private key; hex-encode the 64-byte signature.

4. Append it to form the memo:

PiNS:1:REG:richard.pivx:ps1f84lvgj0awz…:3757ee1a…a53:1780000001:cfec7a58…04

5. Send a shielded transaction to the registrar address, with that memo, paying the
registration fee for a 7-character name.

Khi khoản thanh toán đạt 40 xác nhận — khoảng 40 phút — lệnh vào lô kế tiếp; lô đóng lại khoảng mười phút sau, rồi được chứng minh và neo lại. Từ đó trở đi, richard.pivx phân giải được qua bất kỳ trình lập chỉ mục nào, kèm một bằng chứng Merkle mà bạn tự kiểm chứng được.