본문으로 건너뛰기

명령 형식

모든 PiNS 연산은 레지스트라의 프로토콜 주소로 보내는 차폐 PIVX 트랜잭션이며, 금액이 곧 결제이고 메모가 곧 서명된 명령입니다. 둘은 같은 노트 안에서 함께 이동하므로 의도와 결제가 원자적으로 묶입니다 — 따로 대조해야 할 참조번호나 청구서가 없습니다.

이 페이지는 정확한 전송 형식을 설명합니다. 이에 맞춰 만든 명령은 레지스트라와 영지식 회로 양쪽 모두가 받아들입니다.

구조​

모든 명령은 콜론으로 구분된 ASCII이며, 프로토콜 마커와 버전으로 시작합니다:

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

그 사이의 필드는 연산에 따라 달라집니다:

연산메모 구조지불 금액
REG 등록PiNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig}이름 길이에 따른 등록 요금
UPD 주소 변경PiNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig}변경 요금
CHG 소유자 이전PiNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig}변경 요금
LST 판매 등록PiNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig}변경 요금
ULT 등록 해제PiNS:1:ULT:{name}:{pubkey}:{nonce}:{sig}변경 요금
BUY 구매PiNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig}정확히 등록 가격

CHG에서 {new_pubkey}는 받는 쪽 소유자의 키이며, 서명은 넘기는 쪽 소유자가 만듭니다 — 이전을 승인하는 주체는 현재 소유자입니다.

서명 대상 메시지​

서명은 끝의 :{signature}를 제외한 명령을 대상으로 합니다. 즉 마커부터 nonce까지(포함) 전부입니다:

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

규칙은 엄격하며, 클라이언트가 이 중 하나라도 어기면 회로가 거부하는 서명이 만들어집니다:

  • pubkey는 소문자 16진수, 64자입니다.
  • price는 LST에서만 나타납니다.
  • address는 REG, UPD, BUY에서만 나타납니다.
  • price와 nonce는 10진수이며, 선행 0·부호·패딩이 없어야 합니다.
  • 서명은 바로 그 바이트열에 대한 Ed25519 서명이며, 16진수로 인코딩된 128자입니다.

검증은 엄격합니다. 정규형이 아닌 서명과 작은 위수 키는 거부됩니다.

필드 규칙​

이름​

규칙값
문자a-z, 0-9, 하이픈
길이영역을 포함해 1~64자
대소문자소문자만 — 이름은 소문자로 저장되고 해시됩니다
하이픈맨 앞 불가, 맨 뒤 불가, 연속 불가
영역.pivx, .private, .secure, .safe

점은 라벨과 영역을 나누는 정확히 하나만 허용됩니다.

대상 주소​

이름이 해석되는 주소는 메인넷의 PIVX Sapling 차폐 지급 주소여야 합니다 — bech32, 사람이 읽을 수 있는 접두사 ps, 정확히 78자입니다. 투명 주소를 비롯한 그 밖의 모든 형식은 거부됩니다.

이 길이는 임의로 정해진 것이 아닙니다. Sapling 지급 주소는 43바이트 페이로드 — 11바이트 다양화 값과 32바이트 pk_d — 이며, bech32는 이를 69자의 데이터와 6자의 체크섬으로 인코딩합니다. 따라서 ps + 구분자 + 69 + 6 = 78입니다.

이 규칙은 프로토콜 자체의 규칙입니다. 인덱서와 회로는 이를 똑같이 적용하며, 주소를 소문자로 쓸 것도 요구합니다. Bech32 체크섬은 대소문자를 구분하지 않으므로, 그렇지 않으면 한 주소의 두 가지 표기가 트리에서 서로 다른 두 리프가 됩니다. 레지스트라의 지급 방식에서 나온 규칙이 아닙니다. 환불과 판매 대금은 이름이 가리키는 주소로 가지 않고, Ed25519 키의 내부 잔액에 적립되며 키 소유자가 거기서 인출합니다.

팁

최신 bech32 형식만 허용됩니다

예전 테스트넷 형식인 ptestsapling…(88자)은 두 네트워크 모두에서 거부되며, 회로도 레지스트라와 똑같은 규칙을 강제합니다. 최신 PIVX 지갑은 메인넷에서 ps… 형식을 생성합니다.

Nonce​

nonce는 서명하는 시점의 초 단위 Unix 타임스탬프입니다.

  • 해당 이름에 현재 기록된 nonce보다 엄격히 커야 합니다. 이것이 예전에 서명된 명령의 재사용을 막아줍니다.
  • 자신을 담고 있는 블록보다 300초 넘게 앞설 수 없습니다. 이 여유는 통상적인 시계 오차는 흡수하면서도 nonce를 먼 미래에 세워두지는 못하게 합니다.

첫 등록이라면 현재 시각의 타임스탬프면 무엇이든 괜찮습니다.

nonce가 기록된 값보다 크지 않은 명령은 거부되며, 그 지불액은 내부 잔액으로 환불됩니다. 내부 잔액에서 출금할 때마다 5%의 서비스 수수료가 공제됩니다. 시계가 늦게 가거나, 한 이름에 대한 두 명령이 같은 1초 안에 서명되면 이런 일이 생깁니다. 따라서 현재 시각과 이름의 최신 nonce에 1초를 더한 값 중 더 큰 값을 사용하세요. 최신 nonce는 이름 해석이 반환하는 nonce와, 아직 처리를 기다리는 해당 이름에 대한 여러분의 명령의 nonce 중 더 늦은 것입니다.

가격​

가격을 담는 것은 LST뿐입니다. 정수 satoshi(1 PIVX = 100,000,000 satoshi)이며 0보다 커야 합니다.

이미 등록된 이름을 새 가격으로 다시 올리는 것은 허용됩니다 — LST를 한 번 더 보내면 됩니다. 가장 최근 것이 적용됩니다.

크기 제한​

PIVX 메모는 정확히 512바이트이며, 명령 전체가 그 안에 들어가야 합니다. 고정 부분이 차지하는 양은 예측 가능합니다:

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

Sapling 주소는 항상 정확히 78자이므로, 길이가 가변인 주소 형식과 달리 예산을 따지기 쉽습니다. 이름에는 약 218바이트가 남는데, 이는 이름이 쓸 수 있는 최대 64자보다 훨씬 넉넉합니다. 실제로 명령은 언제나 들어갑니다. 그래도 클라이언트는 예산을 가정하지 말고 계산해야 합니다. 그래야 앞으로 추가될 필드가 메모를 조용히 넘치게 만드는 일이 없습니다.

결제​

유효성은 메모만큼이나 금액이 좌우합니다:

  • REG는 이름 길이에 해당하는 등록 요금을 정확히 지불해야 합니다.
  • UPD, CHG, LST, ULT는 변경 요금을 정확히 지불해야 합니다.
  • BUY는 등록 가격을 정확히 지불해야 합니다.

길이는 영역을 제외한 라벨 기준으로 셉니다: ab.pivx는 2자짜리 이름입니다.

금액이 모자라거나 넘치는 명령은 처리되지 않으며, 형식 검사나 서명 검사를 통과하지 못한 메모도 마찬가지입니다. 둘 다 0.01 PIVX 이상을 지불했고 PiNS:1: 머리말, 알려진 연산, 유효한 공개 키(CHG라면 존재하는 이름)까지 읽을 수 있다면 내부 잔액으로 환불됩니다. CHG는 서명자가 아니라 새 소유자를 지정하므로 그 환불은 서명한 이름 소유자에게 가며, 어떤 소유자도 서명하지 않은 CHG는 환불되지 않습니다. 환불은 120회 확인 후에 적립되며 그 뒤에 출금할 수 있습니다 — 질문과 답변을 참조하세요.

메모에 출력 가능한 ASCII 밖의 문자가 하나라도 들어간 결제는 금액과 관계없이 자동으로 환불되지 않으며, 0.01 PIVX 미만의 결제도 마찬가지입니다. 이러한 결제는 PIVX Name 팀에 보고됩니다 — 질문과 답변을 참조하세요.

순서​

명령은 PIVX가 만들어 낸 순서대로 처리됩니다. 블록 높이, 그다음 블록 내 트랜잭션 인덱스 순입니다. 레지스트라는 순서를 고르지 않으며, 모든 독립 인덱서가 다른 루트를 계산하게 만들지 않고는 순서를 바꿀 수도 없습니다.

트랜잭션 하나는 명령 하나를 담습니다. 레지스트라 주소로 가는 출력 가운데 출력 인덱스 순으로 메모가 올바른 형식의 명령인 첫 번째 출력이 그것입니다. 같은 트랜잭션에서 레지스트라로 가는 다른 출력은 처리되지도, 자동으로 환불되지도 않으니 명령은 각각 별도의 트랜잭션으로 보내세요.

경합하는 연산 — 같은 이름에 대한 두 개의 REG, 또는 같은 등록에 대한 두 개의 BUY — 에서는 그 순서상 가장 앞선 것이 이기고, 나머지 금액은 내부 잔액으로 환불됩니다.

예시로 따라가기​

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.

결제가 40회 확인(약 40분)을 얻으면 명령은 다음 배치에 들어가고, 배치는 약 10분 뒤에 닫힌 다음 증명되고 앵커링됩니다. 그때부터 richard.pivx는 어떤 인덱서를 통해서든 해석되며, 당신이 직접 검증할 수 있는 머클 증명이 함께 따라옵니다.