@bsv/dpp-core 0.3.0-beta.1

package/dist/codec.js

@@ -0,0 +1,459 @@
+import { LockingScript, OP, PublicKey, Utils } from '@bsv/sdk';
+import { DPP_OPS, DPP_OPS_V2, FIELD_COUNT, FIELD_COUNT_V2, MAX_ACTOR_KEY_ID_BYTES, MAX_EVENT_DATA_BYTES_V2, MAX_PASSPORT_ID_BYTES, MAX_PAYLOAD_PUBLIC_BYTES_V2, NO_EVENT_OPS, OUTPOINT_FIELD_BYTES, PROTOCOL_MARKER, STANDARD_VERSION, STANDARD_VERSION_V2, } from './constants.js';
+/** Thrown when a script does not carry a well-formed DPP output of a version this reader decodes. */
+export class DppFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DppFormatError';
+    }
+}
+/**
+ * Minimal-push encoding, verbatim from @bsv/sdk's PushDrop template (it is
+ * module-local there and not exported). Produces scripts byte-identical to
+ * PushDrop.lock() so connected-path wallets and explorers see the same shape.
+ */
+function minimalChunk(data) {
+    if (data.length === 0)
+        return { op: 0 };
+    if (data.length === 1 && data[0] === 0)
+        return { op: 0 };
+    if (data.length === 1 && data[0] > 0 && data[0] <= 16)
+        return { op: 0x50 + data[0] };
+    if (data.length === 1 && data[0] === 0x81)
+        return { op: 0x4f };
+    if (data.length <= 75)
+        return { op: data.length, data };
+    if (data.length <= 255)
+        return { op: 0x4c, data };
+    if (data.length <= 65535)
+        return { op: 0x4d, data };
+    return { op: 0x4e, data };
+}
+/**
+ * Inverse of minimal-push encoding for a single chunk. Unlike the SDK's
+ * PushDrop.decode, OP_0 maps to the EMPTY field (not [0x00]) - the standard's
+ * value domain has zero-length fields but never a lone 0x00 byte.
+ * Non-minimal pushes are accepted (tolerant read; field bytes, and therefore
+ * signature preimages, are unaffected by push encoding).
+ */
+function chunkToField(chunk) {
+    if (chunk.data != null && chunk.data.length > 0) {
+        return chunk.op >= 1 && chunk.op <= 0x4e ? chunk.data : null;
+    }
+    if (chunk.op === 0)
+        return [];
+    if (chunk.op >= 0x51 && chunk.op <= 0x60)
+        return [chunk.op - 0x50];
+    if (chunk.op === 0x4f)
+        return [0x81];
+    return null;
+}
+/** Whether signable content, of either version, is version 2. */
+export function isV2Data(d) {
+    return d.version === STANDARD_VERSION_V2;
+}
+/** Fields 1–12 (the signable content) of a version 1 state as raw wire bytes, in standard order. */
+export function dataFields(d) {
+    return [
+        Utils.toArray(PROTOCOL_MARKER, 'utf8'),
+        Utils.toArray(STANDARD_VERSION, 'utf8'),
+        Utils.toArray(d.passportId, 'utf8'),
+        Utils.toArray(d.op, 'utf8'),
+        Utils.toArray(d.timestamp, 'utf8'),
+        Utils.toArray(d.ownerIdentityKey, 'hex'),
+        Utils.toArray(d.actorIdentityKey, 'hex'),
+        Utils.toArray(d.actorKeyId, 'utf8'),
+        Utils.toArray(d.eventData, 'utf8'),
+        Utils.toArray(d.payloadPublic, 'utf8'),
+        Utils.toArray(d.payloadOwnerHash, 'hex'),
+        Utils.toArray(d.previousTxid, 'hex'),
+    ];
+}
+/** An outpoint as the version 2 fields 12 and 13 carry it: 32 txid bytes in display order, then a big-endian uint32 index. */
+export function outpointFieldBytes(outpoint) {
+    if (outpoint == null)
+        return [];
+    const txid = Utils.toArray(outpoint.txid, 'hex');
+    if (txid.length !== 32)
+        throw new DppFormatError('an outpoint txid must be 32 bytes');
+    const index = outpoint.outputIndex;
+    if (!Number.isInteger(index) || index < 0 || index > 0xffffffff) {
+        throw new DppFormatError('an outpoint output index must be an unsigned 32-bit integer');
+    }
+    return [...txid, (index >>> 24) & 0xff, (index >>> 16) & 0xff, (index >>> 8) & 0xff, index & 0xff];
+}
+/** Fields 1–15 (the signable content) of a version 2 state as raw wire bytes, in standard order. */
+export function dataFieldsV2(d) {
+    const predecessor = d.previousTxid === '' ? null : { txid: d.previousTxid, outputIndex: d.previousOutputIndex ?? -1 };
+    return [
+        Utils.toArray(PROTOCOL_MARKER, 'utf8'),
+        Utils.toArray(STANDARD_VERSION_V2, 'utf8'),
+        Utils.toArray(d.passportId, 'utf8'),
+        Utils.toArray(d.op, 'utf8'),
+        Utils.toArray(d.timestamp, 'utf8'),
+        Utils.toArray(d.ownerIdentityKey, 'hex'),
+        Utils.toArray(d.actorIdentityKey, 'hex'),
+        Utils.toArray(d.actorKeyId, 'utf8'),
+        Utils.toArray(d.eventData, 'utf8'),
+        Utils.toArray(d.payloadPublic, 'utf8'),
+        Utils.toArray(d.payloadOwnerHash, 'hex'),
+        outpointFieldBytes(d.lineageGenesis),
+        outpointFieldBytes(predecessor),
+        Utils.toArray(d.controlLinkage, 'hex'),
+        Utils.toArray(d.authorisationCommitment, 'hex'),
+    ];
+}
+/** All fields of a state as raw wire bytes: 14 for version 1, 17 for version 2. */
+export function stateToFields(s) {
+    const data = s.version === STANDARD_VERSION_V2 ? dataFieldsV2(s) : dataFields(s);
+    return [...data, [...s.userSignature], [...s.serverSignature]];
+}
+/**
+ * Build the DPP locking script: <33-byte key> OP_CHECKSIG <fields> drops.
+ * Custody-neutral (`spec/record-model.md` §2): the locking key may be treasury-derived or user-held.
+ * The drop tail is one OP_2DROP per pair of fields and one OP_DROP for an odd
+ * field left over: seven OP_2DROP for version 1, eight and an OP_DROP for version 2.
+ */
+export function buildLockingScript(state, lockingPublicKey) {
+    const pub = typeof lockingPublicKey === 'string'
+        ? PublicKey.fromString(lockingPublicKey)
+        : lockingPublicKey;
+    const pubBytes = pub.encode(true);
+    const fields = stateToFields(state);
+    const chunks = [
+        { op: pubBytes.length, data: pubBytes },
+        { op: OP.OP_CHECKSIG },
+        ...fields.map(minimalChunk),
+    ];
+    let undropped = fields.length;
+    while (undropped > 1) {
+        chunks.push({ op: OP.OP_2DROP });
+        undropped -= 2;
+    }
+    if (undropped !== 0)
+        chunks.push({ op: OP.OP_DROP });
+    return new LockingScript(chunks);
+}
+const ISO_8601 = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+/**
+ * Date.parse refuses most out-of-range components (month 13, hour 25,
+ * minute 60) but rolls overflow days forward (2026-02-30 parses as 2 March)
+ * and accepts the legacy 24:00 spelling of midnight. The spec demands a real
+ * calendar instant: the digits must BE the date they claim.
+ */
+function isRealInstant(match) {
+    const [year, month, day, hour] = [match[1], match[2], match[3], match[4]].map(Number);
+    if (hour > 23)
+        return false;
+    const cal = new Date(0);
+    cal.setUTCFullYear(year, month - 1, day);
+    return (cal.getUTCFullYear() === year &&
+        cal.getUTCMonth() === month - 1 &&
+        cal.getUTCDate() === day);
+}
+/**
+ * Decode a UTF-8 declared field strictly: the bytes must decode and re-encode
+ * to themselves. Utils.toUTF8 is lossy (invalid sequences become U+FFFD), so
+ * without this check a mangled field slips through decode and only dies at
+ * signature verification - and §2 says encoding violations refuse at decode.
+ * The round trip is also what lets the signature preimages be recomputed from
+ * decoded fields: for accepted states, decoded text and wire bytes are one.
+ */
+function utf8Field(bytes, name) {
+    const text = Utils.toUTF8(bytes);
+    const roundTrip = Utils.toArray(text, 'utf8');
+    if (roundTrip.length !== bytes.length ||
+        roundTrip.some((b, i) => b !== bytes[i])) {
+        throw new DppFormatError(`${name} must be valid UTF-8`);
+    }
+    return text;
+}
+function identityKeyHex(bytes, name) {
+    if (bytes.length !== 33) {
+        throw new DppFormatError(`${name} must be a 33-byte compressed public key`);
+    }
+    const hex = Utils.toHex(bytes);
+    let parsed;
+    try {
+        parsed = PublicKey.fromString(hex);
+    }
+    catch {
+        throw new DppFormatError(`${name} is not a valid public key`);
+    }
+    // The SDK accepts x >= p by reducing it mod p. Require the canonical SEC1
+    // encoding so on-chain bytes are the unique representation of the key.
+    if (parsed.toString() !== hex) {
+        throw new DppFormatError(`${name} is not a canonical compressed public key`);
+    }
+    return hex;
+}
+function digestHex(bytes, name) {
+    if (bytes.length === 0)
+        return '';
+    if (bytes.length !== 32) {
+        throw new DppFormatError(`${name} must be empty or 32 bytes`);
+    }
+    return Utils.toHex(bytes);
+}
+/** A version 2 outpoint field: empty, or exactly 36 bytes. */
+function outpointField(bytes, name) {
+    if (bytes.length === 0)
+        return null;
+    if (bytes.length !== OUTPOINT_FIELD_BYTES) {
+        throw new DppFormatError(`${name} must be empty or ${OUTPOINT_FIELD_BYTES} bytes`);
+    }
+    const txid = Utils.toHex(bytes.slice(0, 32));
+    const outputIndex = ((bytes[32] << 24) >>> 0) + (bytes[33] << 16) + (bytes[34] << 8) + bytes[35];
+    return { txid, outputIndex };
+}
+function requireJson(text, name) {
+    try {
+        JSON.parse(text);
+    }
+    catch {
+        throw new DppFormatError(`${name} must be valid JSON`);
+    }
+}
+function timestampField(bytes) {
+    const timestamp = Utils.toUTF8(bytes);
+    const isoMatch = ISO_8601.exec(timestamp);
+    if (isoMatch == null || Number.isNaN(Date.parse(timestamp))) {
+        throw new DppFormatError('timestamp must be ISO 8601');
+    }
+    if (!isRealInstant(isoMatch)) {
+        throw new DppFormatError('timestamp must name a real calendar instant');
+    }
+    return timestamp;
+}
+/** No field of either version may be the single byte 0x00 (`spec/record-model.md` §2). */
+function refuseLoneNul(fields) {
+    // Minimal writing encodes it as OP_0, which reads back as the empty field,
+    // so it can only arrive by a non-minimal push; admitting it would give one
+    // value two spellings.
+    fields.forEach((f, i) => {
+        if (f.length === 1 && f[0] === 0) {
+            throw new DppFormatError(`field ${i + 1} is the single byte 0x00`);
+        }
+    });
+}
+function passportIdField(bytes) {
+    // Bounded in bytes, before decoding: the field is the server signature's
+    // BRC-42 key identifier and a wallet refuses one above 800 characters (§3).
+    if (bytes.length > MAX_PASSPORT_ID_BYTES) {
+        throw new DppFormatError(`passport_id exceeds ${MAX_PASSPORT_ID_BYTES} bytes`);
+    }
+    const passportId = utf8Field(bytes, 'passport_id');
+    if (passportId.length === 0)
+        throw new DppFormatError('passport_id must be non-empty');
+    return passportId;
+}
+function actorKeyIdField(bytes) {
+    // Same reason as passport_id: the user signature's BRC-42 key identifier.
+    if (bytes.length > MAX_ACTOR_KEY_ID_BYTES) {
+        throw new DppFormatError(`actor_keyID exceeds ${MAX_ACTOR_KEY_ID_BYTES} bytes`);
+    }
+    const actorKeyId = utf8Field(bytes, 'actor_keyID');
+    if (actorKeyId.length === 0)
+        throw new DppFormatError('actor_keyID must be non-empty');
+    return actorKeyId;
+}
+/** Validate and type raw version 1 fields per `spec/record-model.md` §2-§3. Throws DppFormatError. */
+export function fieldsToState(fields) {
+    if (fields.length !== FIELD_COUNT) {
+        throw new DppFormatError(`expected ${FIELD_COUNT} fields, found ${fields.length}`);
+    }
+    refuseLoneNul(fields);
+    const marker = Utils.toUTF8(fields[0]);
+    if (marker !== PROTOCOL_MARKER) {
+        throw new DppFormatError(`protocol_marker must be "${PROTOCOL_MARKER}"`);
+    }
+    const version = Utils.toUTF8(fields[1]);
+    if (version !== STANDARD_VERSION) {
+        throw new DppFormatError(version === STANDARD_VERSION_V2
+            ? `version "${STANDARD_VERSION_V2}" is carried by the ${FIELD_COUNT_V2}-field layout, not the ${FIELD_COUNT}-field one`
+            : `unsupported standard version "${version}"`);
+    }
+    const passportId = passportIdField(fields[2]);
+    const op = Utils.toUTF8(fields[3]);
+    if (!DPP_OPS.includes(op)) {
+        throw new DppFormatError(`unknown op "${op}"`);
+    }
+    const timestamp = timestampField(fields[4]);
+    const ownerIdentityKey = identityKeyHex(fields[5], 'owner_identity_key');
+    const actorIdentityKey = identityKeyHex(fields[6], 'actor_identity_key');
+    const actorKeyId = actorKeyIdField(fields[7]);
+    const eventData = utf8Field(fields[8], 'event_data');
+    if (NO_EVENT_OPS.includes(op)) {
+        if (eventData !== '') {
+            throw new DppFormatError(`event_data must be empty on ${op}`);
+        }
+    }
+    else if (eventData !== '') {
+        requireJson(eventData, 'event_data');
+    }
+    const payloadPublic = utf8Field(fields[9], 'payload_public');
+    if (payloadPublic.length === 0) {
+        throw new DppFormatError('payload_public must be present on every state (T2)');
+    }
+    requireJson(payloadPublic, 'payload_public');
+    const payloadOwnerHash = digestHex(fields[10], 'payload_owner_hash');
+    const previousTxid = digestHex(fields[11], 'previous_txid');
+    const userSignature = fields[12];
+    if (userSignature.length === 0)
+        throw new DppFormatError('user_signature must be present');
+    const serverSignature = fields[13];
+    if (serverSignature.length === 0) {
+        throw new DppFormatError('server_signature must be present (§3 field 14)');
+    }
+    return {
+        protocolMarker: marker,
+        version: '1',
+        passportId,
+        op,
+        timestamp,
+        ownerIdentityKey,
+        actorIdentityKey,
+        actorKeyId,
+        eventData,
+        payloadPublic,
+        payloadOwnerHash,
+        previousTxid,
+        userSignature,
+        serverSignature,
+    };
+}
+/** Validate and type raw version 2 fields per `spec/record-model-v2.md` §2-§3. Throws DppFormatError. */
+export function fieldsToStateV2(fields) {
+    if (fields.length !== FIELD_COUNT_V2) {
+        throw new DppFormatError(`expected ${FIELD_COUNT_V2} fields, found ${fields.length}`);
+    }
+    refuseLoneNul(fields);
+    const marker = Utils.toUTF8(fields[0]);
+    if (marker !== PROTOCOL_MARKER) {
+        throw new DppFormatError(`protocol_marker must be "${PROTOCOL_MARKER}"`);
+    }
+    const version = Utils.toUTF8(fields[1]);
+    if (version !== STANDARD_VERSION_V2) {
+        throw new DppFormatError(version === STANDARD_VERSION
+            ? `version "${STANDARD_VERSION}" is carried by the ${FIELD_COUNT}-field layout, not the ${FIELD_COUNT_V2}-field one`
+            : `unsupported standard version "${version}"`);
+    }
+    const passportId = passportIdField(fields[2]);
+    const op = Utils.toUTF8(fields[3]);
+    if (!DPP_OPS_V2.includes(op)) {
+        throw new DppFormatError(`unknown op "${op}"`);
+    }
+    const timestamp = timestampField(fields[4]);
+    const ownerIdentityKey = identityKeyHex(fields[5], 'controller_key');
+    const actorIdentityKey = identityKeyHex(fields[6], 'actor_identity_key');
+    const actorKeyId = actorKeyIdField(fields[7]);
+    if (fields[8].length > MAX_EVENT_DATA_BYTES_V2) {
+        throw new DppFormatError(`event_data exceeds ${MAX_EVENT_DATA_BYTES_V2} bytes`);
+    }
+    const eventData = utf8Field(fields[8], 'event_data');
+    if (eventData !== '')
+        requireJson(eventData, 'event_data');
+    if (fields[9].length > MAX_PAYLOAD_PUBLIC_BYTES_V2) {
+        throw new DppFormatError(`payload_public exceeds ${MAX_PAYLOAD_PUBLIC_BYTES_V2} bytes`);
+    }
+    const payloadPublic = utf8Field(fields[9], 'payload_public');
+    if (payloadPublic.length === 0) {
+        throw new DppFormatError('payload_public must be present on every state');
+    }
+    requireJson(payloadPublic, 'payload_public');
+    const payloadOwnerHash = digestHex(fields[10], 'payload_owner_hash');
+    const lineageGenesis = outpointField(fields[11], 'lineage_genesis');
+    const predecessor = outpointField(fields[12], 'previous_outpoint');
+    const controlLinkage = digestHex(fields[13], 'control_linkage');
+    if (op === 'ISSUE' && controlLinkage !== '') {
+        throw new DppFormatError('control_linkage must be empty on ISSUE');
+    }
+    const authorisationCommitment = digestHex(fields[14], 'authorisation_commitment');
+    const userSignature = fields[15];
+    if (userSignature.length === 0)
+        throw new DppFormatError('actor_signature must be present');
+    const serverSignature = fields[16];
+    if (serverSignature.length === 0)
+        throw new DppFormatError('publisher_signature must be present');
+    return {
+        protocolMarker: marker,
+        version: '2',
+        passportId,
+        op,
+        timestamp,
+        ownerIdentityKey,
+        actorIdentityKey,
+        actorKeyId,
+        eventData,
+        payloadPublic,
+        payloadOwnerHash,
+        previousTxid: predecessor?.txid ?? '',
+        previousOutputIndex: predecessor?.outputIndex ?? null,
+        lineageGenesis,
+        controlLinkage,
+        authorisationCommitment,
+        userSignature,
+        serverSignature,
+    };
+}
+/**
+ * Parse a DPP output script of either version. Throws DppFormatError when the
+ * script is not a well-formed DPP output: the field count selects the version's
+ * rules (fourteen fields for version 1, seventeen for version 2), the version
+ * field must agree with the count, and any other count or version is refused by
+ * name so an older reader meeting a newer state fails clearly rather than
+ * guessing.
+ */
+export function parseDppOutput(script) {
+    const chunks = script.chunks;
+    if (chunks.length < 2 || chunks[0].data == null || chunks[0].data.length !== 33) {
+        throw new DppFormatError('not a DPP output: missing 33-byte locking key push');
+    }
+    if (chunks[1].op !== OP.OP_CHECKSIG) {
+        throw new DppFormatError('not a DPP output: missing OP_CHECKSIG');
+    }
+    const fields = [];
+    let i = 2;
+    for (; i < chunks.length; i++) {
+        const op = chunks[i].op;
+        if (op === OP.OP_2DROP || op === OP.OP_DROP)
+            break;
+        const field = chunkToField(chunks[i]);
+        if (field == null) {
+            throw new DppFormatError(`not a DPP output: non-push chunk at index ${i}`);
+        }
+        fields.push(field);
+    }
+    if (fields.length !== FIELD_COUNT && fields.length !== FIELD_COUNT_V2) {
+        throw new DppFormatError(`expected ${FIELD_COUNT} or ${FIELD_COUNT_V2} fields, found ${fields.length}`);
+    }
+    const tail = chunks.slice(i);
+    const twoDrops = Math.floor(fields.length / 2);
+    const oneDrop = fields.length % 2;
+    const tailValid = tail.length === twoDrops + oneDrop &&
+        tail.slice(0, twoDrops).every((c) => c.op === OP.OP_2DROP && c.data === undefined) &&
+        (oneDrop === 0 || (tail[twoDrops].op === OP.OP_DROP && tail[twoDrops].data === undefined));
+    if (!tailValid) {
+        throw new DppFormatError('not a DPP output: malformed drop tail');
+    }
+    let lockingPublicKey;
+    try {
+        lockingPublicKey = PublicKey.fromString(Utils.toHex(chunks[0].data));
+    }
+    catch {
+        // Keep the documented contract: every refusal is a DppFormatError.
+        throw new DppFormatError('not a DPP output: locking key is not a valid public key');
+    }
+    const state = fields.length === FIELD_COUNT_V2 ? fieldsToStateV2(fields) : fieldsToState(fields);
+    return { state, lockingPublicKey };
+}
+/** Non-throwing variant of parseDppOutput, for scanning arbitrary outputs. */
+export function tryParseDppOutput(script) {
+    try {
+        return parseDppOutput(script);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,150 @@
+import type { WalletProtocol } from '@bsv/sdk';
+/**
+ * DPP Token Standard v1 - constants (`spec/record-model.md` §2-§3).
+ *
+ * Encoding decisions pinned by this reference implementation (the standard
+ * fixes field order and semantics; byte encodings are pinned here):
+ * - protocol_marker: UTF-8 "dpp"
+ * - version: UTF-8 "1"
+ * - passport_id, op, timestamp, actor_keyID, event_data, payload_public: UTF-8
+ * - owner_identity_key, actor_identity_key: 33-byte compressed public key (raw)
+ * - payload_owner_hash: 32-byte SHA-256 digest (raw). Zero-length when absent
+ * - previous_txid: 32-byte txid, big-endian display order (raw). Zero-length at genesis
+ * - user_signature, server_signature: DER-encoded ECDSA signature
+ *
+ * Zero-length fields are encoded as OP_0. Within the standard's value domain
+ * this is unambiguous: no field may legitimately be the single byte 0x00.
+ */
+export declare const PROTOCOL_MARKER = "dpp";
+export declare const STANDARD_VERSION = "1";
+/**
+ * BRC-43 protocol ID under which both token signatures are created, always
+ * with counterparty 'anyone' so any third party can derive the verification
+ * key from on-chain data alone (§3 fields 7/8, §5).
+ * - user_signature:   actor identity key + keyID = actor_keyID (field 8)
+ * - server_signature: service identity key + keyID = passport_id (field 3)
+ */
+export declare const DPP_PROTOCOL_ID: WalletProtocol;
+/**
+ * BRC-43 protocol ID of the owner key (`spec/custody.md` §2, `spec/record-model.md`
+ * §3 field 6): field 6 SHOULD be the owner's root derived under this protocol
+ * with keyID = passport_id and counterparty 'self', one level, so a BRC-100
+ * wallet produces it with getPublicKey and spends a tip locked to it with the
+ * PushDrop unlock (`spec/custody.md` §3). 'self' is what makes holdings
+ * unlinkable: nobody but the root can compute or confirm the child.
+ */
+export declare const OWNER_PROTOCOL_ID: WalletProtocol;
+/**
+ * The event_data property a TRANSFER carries to prove, under the optional
+ * owner-signed transfer invariant (`spec/custody.md` §4), that the actor's root
+ * derived the previous owner key: the BRC-69 specific key linkage, 64 lower-case
+ * hex characters. Reserved on TRANSFER; meaningless elsewhere.
+ */
+export declare const OWNER_LINKAGE_KEY = "owner_linkage";
+/** The one accepted spelling of the linkage scalar: one value, one spelling. */
+export declare const OWNER_LINKAGE_HEX: RegExp;
+/**
+ * What a BRC-100 wallet encrypts the linkage under when it reveals it
+ * (revealSpecificKeyLinkage: `[2, 'specific linkage revelation <level> <name>']`
+ * of the target protocol, keyID = the target keyID, counterparty = the
+ * verifier). The verifier decrypts with the prover as counterparty.
+ */
+export declare const OWNER_LINKAGE_REVELATION_PROTOCOL_ID: WalletProtocol;
+/**
+ * Upper bounds on the two fields that are also BRC-42 key identifiers
+ * (`spec/record-model.md` §3, §5): passport_id keys the server signature,
+ * actor_keyID keys the user signature. A conforming wallet refuses a key
+ * identifier above 800 characters, so an unbounded field would be a valid
+ * record no wallet can sign; the standard bounds them tighter, in bytes of
+ * UTF-8, and matches the anchor's subject bound for passport_id.
+ */
+export declare const MAX_PASSPORT_ID_BYTES = 512;
+export declare const MAX_ACTOR_KEY_ID_BYTES = 256;
+/** Total PushDrop fields per state (`spec/record-model.md` §3). */
+export declare const FIELD_COUNT = 14;
+/** Zero-based indices into the 14-field layout. */
+export declare const Field: {
+    readonly protocolMarker: 0;
+    readonly version: 1;
+    readonly passportId: 2;
+    readonly op: 3;
+    readonly timestamp: 4;
+    readonly ownerIdentityKey: 5;
+    readonly actorIdentityKey: 6;
+    readonly actorKeyId: 7;
+    readonly eventData: 8;
+    readonly payloadPublic: 9;
+    readonly payloadOwnerHash: 10;
+    readonly previousTxid: 11;
+    readonly userSignature: 12;
+    readonly serverSignature: 13;
+};
+export declare const DPP_OPS: readonly ["ACTIVATE", "SOLD", "RESOLD", "REPAIRED", "RECYCLED", "EDIT", "TRANSFER"];
+/** Ops that may change payload_public / payload_owner_hash (§6 invariant 7). */
+export declare const PAYLOAD_CHANGE_OPS: readonly string[];
+/** Ops on which event_data must be the empty string (§3 field 9). */
+export declare const NO_EVENT_OPS: readonly string[];
+/**
+ * JSON property inside payload_public carrying the data-carrier reference
+ * (chip UID). The lookup service indexes it alongside passport_id, as the
+ * `uid` query key in `contracts/overlay.yaml`.
+ */
+export declare const PAYLOAD_DATA_CARRIER_KEY = "dataCarrier";
+export declare const STANDARD_VERSION_V2 = "2";
+/** The record versions a reader of this release decodes; any other value is refused by name. */
+export declare const SUPPORTED_VERSIONS: readonly ["1", "2"];
+export type DppVersion = (typeof SUPPORTED_VERSIONS)[number];
+/**
+ * BRC-43 protocol ID of both version 2 record signatures, counterparty
+ * 'anyone' as in version 1. Distinct from `DPP_PROTOCOL_ID` so a key derived
+ * for one version signs nothing under the other.
+ */
+export declare const DPP_PROTOCOL_ID_V2: WalletProtocol;
+/** Total PushDrop fields per version 2 state. */
+export declare const FIELD_COUNT_V2 = 17;
+/** Zero-based indices into the seventeen-field layout. */
+export declare const FieldV2: {
+    readonly protocolMarker: 0;
+    readonly version: 1;
+    readonly passportId: 2;
+    readonly op: 3;
+    readonly timestamp: 4;
+    readonly controllerKey: 5;
+    readonly actorIdentityKey: 6;
+    readonly actorKeyId: 7;
+    readonly eventData: 8;
+    readonly payloadPublic: 9;
+    readonly payloadOwnerHash: 10;
+    readonly lineageGenesis: 11;
+    readonly previousOutpoint: 12;
+    readonly controlLinkage: 13;
+    readonly authorisationCommitment: 14;
+    readonly actorSignature: 15;
+    readonly publisherSignature: 16;
+};
+export declare const DPP_OPS_V2: readonly ["ISSUE", "UPDATE", "TRANSFER", "RETIRE"];
+/** Version 2 ops that may change payload_public / payload_owner_hash. RETIRE changes neither. */
+export declare const PAYLOAD_CHANGE_OPS_V2: readonly string[];
+/** Version 2 ops whose actor must prove control of the predecessor. */
+export declare const CONTROL_PROOF_OPS_V2: readonly string[];
+/**
+ * The domain tags that open the two version 2 preimages. Each preimage is the
+ * tag, then every signed field, each as a Bitcoin VarInt length followed by
+ * its bytes (`spec/record-model-v2.md` §5), so the actor preimage and the
+ * publisher preimage of one state, and the preimages of any two states,
+ * never share bytes by accident.
+ */
+export declare const RECORD_V2_ACTOR_TAG = "dpp-record-v2/actor-signature";
+export declare const RECORD_V2_PUBLISHER_TAG = "dpp-record-v2/publisher-signature";
+/**
+ * Byte bounds on the two JSON fields, in UTF-8 bytes (§3). Version 1 left
+ * them unbounded; version 2 keeps on-chain data intentional. A profile may
+ * bound them tighter, never wider.
+ */
+export declare const MAX_EVENT_DATA_BYTES_V2 = 4096;
+export declare const MAX_PAYLOAD_PUBLIC_BYTES_V2 = 65535;
+/** An outpoint field: the 32-byte txid in display order, then the output index as four big-endian bytes. */
+export declare const OUTPOINT_FIELD_BYTES = 36;
+/** The custody profile Part B delivers: managed custody with explicit recipient acceptance (`spec/managed-custody.md`). */
+export declare const MANAGED_CUSTODY_PROFILE = "managed-custody@1";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,eAAe,QAAQ,CAAA;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,cAAoC,CAAA;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAAoC,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAEhD,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,QAAmB,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,EAAE,cAGlD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AACxC,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,mEAAmE;AACnE,eAAO,MAAM,WAAW,KAAK,CAAA;AAE7B,mDAAmD;AACnD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;CAeR,CAAA;AAEV,eAAO,MAAM,OAAO,qFAQV,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAqC,CAAA;AAErF,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAyB,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gBAAgB,CAAA;AAuBrD,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,gGAAgG;AAChG,eAAO,MAAM,kBAAkB,qBAAsB,CAAA;AACrD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAoC,CAAA;AAErE,iDAAiD;AACjD,eAAO,MAAM,cAAc,KAAK,CAAA;AAEhC,0DAA0D;AAC1D,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;CAkBV,CAAA;AAEV,eAAO,MAAM,UAAU,oDAAqD,CAAA;AAE5E,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAoC,CAAA;AAEvF,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAqC,CAAA;AAEvF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,kCAAkC,CAAA;AAClE,eAAO,MAAM,uBAAuB,sCAAsC,CAAA;AAE1E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAC3C,eAAO,MAAM,2BAA2B,QAAQ,CAAA;AAEhD,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC,2HAA2H;AAC3H,eAAO,MAAM,uBAAuB,sBAAsB,CAAA"}