Đị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ác | Bố cục memo | Số 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ữu | PiNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig} | phí thay đổi |
LST rao bán | PiNS: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 mua | PiNS: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:
pubkeylà hex chữ thường, 64 ký tự.pricechỉ xuất hiện vớiLST.addresschỉ xuất hiện vớiREG,UPDvàBUY.pricevà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ắc | Giá trị |
|---|---|
| Ký tự | a-z, 0-9, dấu gạch nối |
| Độ dài | 1–64 ký tự tính cả vùng |
| Chữ hoa/thường | chỉ chữ thường — tên được lưu và băm ở dạng chữ thường |
| Dấu gạch nối | khô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.
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:
REGphải trả đúng phí đăng ký tương ứng độ dài tên.UPD,CHG,LST,ULTphải trả đúng phí thay đổi.BUYphả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.