@opreturnsocial/protocol 0.1.0

package/dist/decode.d.ts

@@ -0,0 +1,33 @@
+import { ParsedOrsResult } from "./types.js";
+/**
+ * Parse an ORS OP_RETURN payload.
+ * Format: magic(3) + version(1) + pubkey(32) + sig(64) + kind(1) + kind-specific data
+ * Minimum length: 102 bytes (101-byte header + 1 byte minimum data)
+ */
+export declare function parseORSPayload(data: Buffer): ParsedOrsResult;
+export interface V1ChunkInfo {
+    chunkNum: number;
+    totalChunks?: number;
+    bodySlice: Buffer;
+}
+/**
+ * Parse a v1 chunk from raw OP_RETURN payload bytes (magic already detected).
+ *
+ * Chunk 0: ORS(3) + 0x01(1) + 0x00(1) + totalChunks(1) + bodySlice
+ * Chunk N: ORS(3) + 0x01(1) + N(1) + bodySlice
+ */
+export declare function parseV1Chunk(data: Buffer): V1ChunkInfo | null;
+/**
+ * Concatenate ordered body slices and parse the assembled body.
+ *
+ * body = pubkey(32) + sig(64) + kind(1) + kind_data
+ *
+ * Returns null if the assembled data is too short to be valid.
+ */
+export declare function assembleV1Body(slices: Buffer[]): {
+    pubkey: Buffer;
+    sig: Buffer;
+    kind: number;
+    kindData: Buffer;
+} | null;
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EA0BL,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA0F7D;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAoB7D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAWP"}

package/dist/decode.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseORSPayload = parseORSPayload;
+exports.parseV1Chunk = parseV1Chunk;
+exports.assembleV1Body = assembleV1Body;
+const types_js_1 = require("./types.js");
+/**
+ * Parse an ORS OP_RETURN payload.
+ * Format: magic(3) + version(1) + pubkey(32) + sig(64) + kind(1) + kind-specific data
+ * Minimum length: 102 bytes (101-byte header + 1 byte minimum data)
+ */
+function parseORSPayload(data) {
+    // Check minimum length: header(101) + at least 1 byte data
+    if (data.length < types_js_1.DATA_OFFSET + 1) {
+        return { supported: false, reason: "Too short" };
+    }
+    // Check magic
+    if (!data.subarray(0, 3).equals(types_js_1.ORS_MAGIC)) {
+        return { supported: false, reason: "Wrong magic bytes" };
+    }
+    // Check version
+    const version = data[3];
+    if (version !== types_js_1.ORS_VERSION) {
+        return { supported: false, reason: `Unsupported version: ${version}` };
+    }
+    // Extract fixed-length header fields
+    const pubkey = data.subarray(types_js_1.PUBKEY_OFFSET, types_js_1.SIG_OFFSET).toString("hex");
+    const sig = data.subarray(types_js_1.SIG_OFFSET, types_js_1.KIND_OFFSET).toString("hex");
+    // Read kind byte at offset 100
+    const kind = data[types_js_1.KIND_OFFSET];
+    if (kind === types_js_1.KIND_PROFILE_UPDATE) {
+        // PROFILE_UPDATE: propertyKind at 101, value from 102
+        if (data.length < types_js_1.PROFILE_VALUE_OFFSET) {
+            return { supported: false, reason: "Too short for PROFILE_UPDATE" };
+        }
+        const propertyKind = data[types_js_1.PROPERTY_KIND_OFFSET];
+        const valueBytes = data.subarray(types_js_1.PROFILE_VALUE_OFFSET);
+        let content;
+        if (propertyKind === types_js_1.PROPERTY_BOT) {
+            content = valueBytes[0] === 0x01 ? "true" : "false";
+        }
+        else {
+            content = valueBytes.toString("utf8");
+        }
+        const post = { kind: 0x02, propertyKind, content, pubkey, sig };
+        return { supported: true, post };
+    }
+    if (kind === types_js_1.KIND_TEXT_REPLY) {
+        // TEXT_REPLY: parentTxid(32) at 101, content from 133
+        if (data.length < types_js_1.REPLY_CONTENT_OFFSET + 1) {
+            return { supported: false, reason: "Too short for TEXT_REPLY" };
+        }
+        const parentTxid = data.subarray(types_js_1.PARENT_TXID_OFFSET, types_js_1.REPLY_CONTENT_OFFSET).toString("hex");
+        const content = data.subarray(types_js_1.REPLY_CONTENT_OFFSET).toString("utf8");
+        const post = { kind: 0x03, parentTxid, content, pubkey, sig };
+        return { supported: true, post };
+    }
+    if (kind === types_js_1.KIND_REPOST) {
+        // REPOST: referencedTxid(32) at 101-132, no content
+        if (data.length < types_js_1.REPLY_CONTENT_OFFSET) {
+            return { supported: false, reason: "Too short for REPOST" };
+        }
+        const referencedTxid = data.subarray(types_js_1.PARENT_TXID_OFFSET, types_js_1.REPLY_CONTENT_OFFSET).toString("hex");
+        const post = { kind: 0x04, referencedTxid, pubkey, sig };
+        return { supported: true, post };
+    }
+    if (kind === types_js_1.KIND_QUOTE_REPOST) {
+        // QUOTE_REPOST: referencedTxid(32) at 101-132, content from 133
+        if (data.length < types_js_1.REPLY_CONTENT_OFFSET + 1) {
+            return { supported: false, reason: "Too short for QUOTE_REPOST" };
+        }
+        const referencedTxid = data.subarray(types_js_1.PARENT_TXID_OFFSET, types_js_1.REPLY_CONTENT_OFFSET).toString("hex");
+        const content = data.subarray(types_js_1.REPLY_CONTENT_OFFSET).toString("utf8");
+        const post = { kind: 0x05, referencedTxid, content, pubkey, sig };
+        return { supported: true, post };
+    }
+    if (kind === types_js_1.KIND_FOLLOW) {
+        // FOLLOW: targetPubkey(32) at 101, isFollow(1) at 133
+        if (data.length < types_js_1.DATA_OFFSET + types_js_1.PUBKEY_BYTES + 1) {
+            return { supported: false, reason: "Too short for FOLLOW" };
+        }
+        const targetPubkey = data.subarray(types_js_1.DATA_OFFSET, types_js_1.DATA_OFFSET + types_js_1.PUBKEY_BYTES).toString("hex");
+        const isFollow = data[types_js_1.DATA_OFFSET + types_js_1.PUBKEY_BYTES] === 0x01;
+        const post = { kind: 0x06, targetPubkey, isFollow, pubkey, sig };
+        return { supported: true, post };
+    }
+    // TEXT_NOTE and other kinds: content is raw UTF-8 from offset 101
+    const content = data.subarray(types_js_1.DATA_OFFSET).toString("utf8");
+    const post = { kind, content, pubkey, sig };
+    return { supported: true, post };
+}
+/**
+ * Parse a v1 chunk from raw OP_RETURN payload bytes (magic already detected).
+ *
+ * Chunk 0: ORS(3) + 0x01(1) + 0x00(1) + totalChunks(1) + bodySlice
+ * Chunk N: ORS(3) + 0x01(1) + N(1) + bodySlice
+ */
+function parseV1Chunk(data) {
+    if (data.length < 5)
+        return null;
+    if (!data.subarray(0, 3).equals(types_js_1.ORS_MAGIC))
+        return null;
+    if (data[3] !== types_js_1.ORS_VERSION_V1)
+        return null;
+    const chunkNum = data[4];
+    if (chunkNum === 0) {
+        // Root chunk requires at least 1 body byte after the 6-byte header
+        if (data.length < 7)
+            return null;
+        const totalChunks = data[5];
+        if (totalChunks < 2)
+            return null; // degenerate
+        const bodySlice = Buffer.from(data.subarray(6));
+        return { chunkNum: 0, totalChunks, bodySlice };
+    }
+    // Non-root chunk requires at least 1 body byte after the 5-byte header
+    if (data.length < 6)
+        return null;
+    const bodySlice = Buffer.from(data.subarray(5));
+    return { chunkNum, bodySlice };
+}
+/**
+ * Concatenate ordered body slices and parse the assembled body.
+ *
+ * body = pubkey(32) + sig(64) + kind(1) + kind_data
+ *
+ * Returns null if the assembled data is too short to be valid.
+ */
+function assembleV1Body(slices) {
+    const body = Buffer.concat(slices);
+    // Minimum: pubkey(32) + sig(64) + kind(1) = 97 bytes
+    if (body.length < types_js_1.PUBKEY_BYTES + types_js_1.SIG_BYTES + 1)
+        return null;
+    const pubkey = Buffer.from(body.subarray(0, types_js_1.PUBKEY_BYTES));
+    const sig = Buffer.from(body.subarray(types_js_1.PUBKEY_BYTES, types_js_1.PUBKEY_BYTES + types_js_1.SIG_BYTES));
+    const kind = body[types_js_1.PUBKEY_BYTES + types_js_1.SIG_BYTES];
+    const kindData = Buffer.from(body.subarray(types_js_1.PUBKEY_BYTES + types_js_1.SIG_BYTES + 1));
+    return { pubkey, sig, kind, kindData };
+}
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

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

package/dist/encode.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Build the unsigned payload for a TEXT_NOTE — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1) + content_bytes  (no sig)
+ */
+export declare function buildUnsignedPayload(content: string, pubkey: Buffer): Buffer;
+/**
+ * Build the unsigned payload for a PROFILE_UPDATE — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x02) + propertyKind(1) + value_bytes  (no sig)
+ */
+export declare function buildProfileUpdateUnsignedPayload(propertyKind: number, value: string | Buffer, pubkey: Buffer): Buffer;
+/**
+ * Build the unsigned payload for a TEXT_REPLY — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x03) + parentTxid(32) + content_bytes  (no sig)
+ */
+export declare function buildReplyUnsignedPayload(content: string, pubkey: Buffer, parentTxidBytes: Buffer): Buffer;
+/**
+ * Build a complete ORS OP_RETURN payload for a TEXT_REPLY.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x03) + parentTxid(32) + content_bytes
+ */
+export declare function buildReplyPayload(content: string, pubkey: Buffer, sig: Buffer, parentTxidBytes: Buffer): Buffer;
+/**
+ * Build the unsigned payload for a REPOST.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x04) + referencedTxid(32)  (no sig)
+ */
+export declare function buildRepostUnsignedPayload(pubkey: Buffer, referencedTxidBytes: Buffer): Buffer;
+/**
+ * Build a complete ORS OP_RETURN payload for a REPOST.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x04) + referencedTxid(32)
+ */
+export declare function buildRepostPayload(pubkey: Buffer, sig: Buffer, referencedTxidBytes: Buffer): Buffer;
+/**
+ * Build the unsigned payload for a QUOTE_REPOST.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x05) + referencedTxid(32) + content_bytes  (no sig)
+ */
+export declare function buildQuoteRepostUnsignedPayload(content: string, pubkey: Buffer, referencedTxidBytes: Buffer): Buffer;
+/**
+ * Build a complete ORS OP_RETURN payload for a QUOTE_REPOST.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x05) + referencedTxid(32) + content_bytes
+ */
+export declare function buildQuoteRepostPayload(content: string, pubkey: Buffer, sig: Buffer, referencedTxidBytes: Buffer): Buffer;
+/**
+ * Build the unsigned payload for a FOLLOW.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x06) + targetPubkey(32) + action(1)
+ */
+export declare function buildFollowUnsignedPayload(targetPubkey: Buffer, isFollow: boolean, pubkey: Buffer): Buffer;
+/**
+ * Build a complete ORS OP_RETURN payload for a FOLLOW.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x06) + targetPubkey(32) + action(1)
+ */
+export declare function buildFollowPayload(targetPubkey: Buffer, isFollow: boolean, pubkey: Buffer, sig: Buffer): Buffer;
+/**
+ * Extract the unsigned bytes from a full on-chain payload (for verification).
+ * Removes the 64-byte sig at offset SIG_OFFSET..KIND_OFFSET.
+ */
+export declare function getUnsignedBytes(fullPayload: Buffer): Buffer;
+/**
+ * Build a complete ORS OP_RETURN payload for a TEXT_NOTE.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1) + content_bytes
+ */
+export declare function buildORSPayload(content: string, pubkey: Buffer, sig: Buffer): Buffer;
+/**
+ * Build the v1 signing body: pubkey(32) + kind(1) + kind_data.
+ * This is what gets sha256-hashed and Schnorr-signed for v1 posts.
+ * No magic or version prefix — saves bytes in the signing scope.
+ */
+export declare function buildV1SigningBody(pubkey: Buffer, kind: number, kindData: Buffer): Buffer;
+/**
+ * Split a v1 body across 80-byte OP_RETURN chunks.
+ *
+ * body = pubkey(32) + sig(64) + kind(1) + kind_data
+ *
+ * Chunk 0: ORS(3) | 0x01(1) | 0x00(1) | totalChunks(1) | body[0:74]   — 80 bytes max
+ * Chunk N: ORS(3) | 0x01(1) | N(1)    | body[74+(N-1)*75:74+N*75]     — 80 bytes max
+ *
+ * Returns an array of OP_RETURN payloads (without OP_RETURN opcode), each <= 80 bytes.
+ */
+export declare function buildV1Chunks(pubkey: Buffer, sig: Buffer, kind: number, kindData: Buffer): Buffer[];
+/**
+ * Build a complete ORS OP_RETURN payload for a PROFILE_UPDATE.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x02) + propertyKind(1) + value_bytes
+ */
+export declare function buildProfileUpdatePayload(propertyKind: number, value: string | Buffer, pubkey: Buffer, sig: Buffer): Buffer;
+//# sourceMappingURL=encode.d.ts.map

package/dist/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA+B5E;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,MAAM,CAkCR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,GACtB,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAuBR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAkCR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAyBR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAcR;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAmCnG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAiBR"}

package/dist/encode.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUnsignedPayload = buildUnsignedPayload;
+exports.buildProfileUpdateUnsignedPayload = buildProfileUpdateUnsignedPayload;
+exports.buildReplyUnsignedPayload = buildReplyUnsignedPayload;
+exports.buildReplyPayload = buildReplyPayload;
+exports.buildRepostUnsignedPayload = buildRepostUnsignedPayload;
+exports.buildRepostPayload = buildRepostPayload;
+exports.buildQuoteRepostUnsignedPayload = buildQuoteRepostUnsignedPayload;
+exports.buildQuoteRepostPayload = buildQuoteRepostPayload;
+exports.buildFollowUnsignedPayload = buildFollowUnsignedPayload;
+exports.buildFollowPayload = buildFollowPayload;
+exports.getUnsignedBytes = getUnsignedBytes;
+exports.buildORSPayload = buildORSPayload;
+exports.buildV1SigningBody = buildV1SigningBody;
+exports.buildV1Chunks = buildV1Chunks;
+exports.buildProfileUpdatePayload = buildProfileUpdatePayload;
+const types_js_1 = require("./types.js");
+/**
+ * Build the unsigned payload for a TEXT_NOTE — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1) + content_bytes  (no sig)
+ */
+function buildUnsignedPayload(content, pubkey) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    const contentBytes = Buffer.from(content, "utf8");
+    if (contentBytes.length > types_js_1.MAX_CONTENT_BYTES) {
+        throw new Error(`Content too long: ${contentBytes.length} bytes (max ${types_js_1.MAX_CONTENT_BYTES})`);
+    }
+    // SIG_OFFSET (36) = magic(3) + version(1) + pubkey(32)
+    // kind: 1 byte
+    // content: raw bytes
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + contentBytes.length);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    // kind byte at offset 36 of unsigned (= offset 100 of full payload)
+    buf[pos++] = types_js_1.KIND_TEXT_NOTE;
+    contentBytes.copy(buf, pos);
+    return buf;
+}
+/**
+ * Build the unsigned payload for a PROFILE_UPDATE — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x02) + propertyKind(1) + value_bytes  (no sig)
+ */
+function buildProfileUpdateUnsignedPayload(propertyKind, value, pubkey) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    const valueBytes = Buffer.isBuffer(value)
+        ? value
+        : Buffer.from(value, "utf8");
+    // SIG_OFFSET (36) = magic(3) + version(1) + pubkey(32)
+    // kind: 1 byte
+    // propertyKind: 1 byte
+    // value: raw bytes
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + 1 + valueBytes.length);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    // kind byte at offset 36 of unsigned (= offset 100 of full payload)
+    buf[pos++] = types_js_1.KIND_PROFILE_UPDATE;
+    buf[pos++] = propertyKind;
+    valueBytes.copy(buf, pos);
+    return buf;
+}
+/**
+ * Build the unsigned payload for a TEXT_REPLY — everything that gets hashed and signed.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x03) + parentTxid(32) + content_bytes  (no sig)
+ */
+function buildReplyUnsignedPayload(content, pubkey, parentTxidBytes) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    if (parentTxidBytes.length !== types_js_1.PARENT_TXID_BYTES) {
+        throw new Error(`parentTxid must be ${types_js_1.PARENT_TXID_BYTES} bytes`);
+    }
+    const contentBytes = Buffer.from(content, "utf8");
+    if (contentBytes.length > types_js_1.MAX_CONTENT_BYTES) {
+        throw new Error(`Content too long: ${contentBytes.length} bytes (max ${types_js_1.MAX_CONTENT_BYTES})`);
+    }
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + types_js_1.PARENT_TXID_BYTES + contentBytes.length);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    buf[pos++] = types_js_1.KIND_TEXT_REPLY;
+    parentTxidBytes.copy(buf, pos);
+    pos += types_js_1.PARENT_TXID_BYTES;
+    contentBytes.copy(buf, pos);
+    return buf;
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a TEXT_REPLY.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x03) + parentTxid(32) + content_bytes
+ */
+function buildReplyPayload(content, pubkey, sig, parentTxidBytes) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildReplyUnsignedPayload(content, pubkey, parentTxidBytes);
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+/**
+ * Build the unsigned payload for a REPOST.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x04) + referencedTxid(32)  (no sig)
+ */
+function buildRepostUnsignedPayload(pubkey, referencedTxidBytes) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    if (referencedTxidBytes.length !== types_js_1.PARENT_TXID_BYTES) {
+        throw new Error(`referencedTxid must be ${types_js_1.PARENT_TXID_BYTES} bytes`);
+    }
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + types_js_1.PARENT_TXID_BYTES);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    buf[pos++] = types_js_1.KIND_REPOST;
+    referencedTxidBytes.copy(buf, pos);
+    return buf;
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a REPOST.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x04) + referencedTxid(32)
+ */
+function buildRepostPayload(pubkey, sig, referencedTxidBytes) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildRepostUnsignedPayload(pubkey, referencedTxidBytes);
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+/**
+ * Build the unsigned payload for a QUOTE_REPOST.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x05) + referencedTxid(32) + content_bytes  (no sig)
+ */
+function buildQuoteRepostUnsignedPayload(content, pubkey, referencedTxidBytes) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    if (referencedTxidBytes.length !== types_js_1.PARENT_TXID_BYTES) {
+        throw new Error(`referencedTxid must be ${types_js_1.PARENT_TXID_BYTES} bytes`);
+    }
+    const contentBytes = Buffer.from(content, "utf8");
+    if (contentBytes.length > types_js_1.MAX_CONTENT_BYTES) {
+        throw new Error(`Content too long: ${contentBytes.length} bytes (max ${types_js_1.MAX_CONTENT_BYTES})`);
+    }
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + types_js_1.PARENT_TXID_BYTES + contentBytes.length);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    buf[pos++] = types_js_1.KIND_QUOTE_REPOST;
+    referencedTxidBytes.copy(buf, pos);
+    pos += types_js_1.PARENT_TXID_BYTES;
+    contentBytes.copy(buf, pos);
+    return buf;
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a QUOTE_REPOST.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x05) + referencedTxid(32) + content_bytes
+ */
+function buildQuoteRepostPayload(content, pubkey, sig, referencedTxidBytes) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildQuoteRepostUnsignedPayload(content, pubkey, referencedTxidBytes);
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+/**
+ * Build the unsigned payload for a FOLLOW.
+ * Format: ORS\x00 + pubkey(32) + kind(1=0x06) + targetPubkey(32) + action(1)
+ */
+function buildFollowUnsignedPayload(targetPubkey, isFollow, pubkey) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    if (targetPubkey.length !== types_js_1.PUBKEY_BYTES) {
+        throw new Error(`targetPubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    }
+    const buf = Buffer.alloc(types_js_1.SIG_OFFSET + 1 + types_js_1.PUBKEY_BYTES + 1);
+    let pos = 0;
+    types_js_1.ORS_MAGIC.copy(buf, pos);
+    pos += 3;
+    buf[pos++] = types_js_1.ORS_VERSION;
+    pubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    buf[pos++] = types_js_1.KIND_FOLLOW;
+    targetPubkey.copy(buf, pos);
+    pos += types_js_1.PUBKEY_BYTES;
+    buf[pos] = isFollow ? 0x01 : 0x00;
+    return buf;
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a FOLLOW.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x06) + targetPubkey(32) + action(1)
+ */
+function buildFollowPayload(targetPubkey, isFollow, pubkey, sig) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildFollowUnsignedPayload(targetPubkey, isFollow, pubkey);
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+/**
+ * Extract the unsigned bytes from a full on-chain payload (for verification).
+ * Removes the 64-byte sig at offset SIG_OFFSET..KIND_OFFSET.
+ */
+function getUnsignedBytes(fullPayload) {
+    return Buffer.concat([
+        fullPayload.subarray(0, types_js_1.SIG_OFFSET),
+        fullPayload.subarray(types_js_1.KIND_OFFSET),
+    ]);
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a TEXT_NOTE.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1) + content_bytes
+ */
+function buildORSPayload(content, pubkey, sig) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildUnsignedPayload(content, pubkey);
+    // Insert sig between header (SIG_OFFSET) and kind+data
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+// ─── v1 (chunked 80-byte OP_RETURN) ─────────────────────────────────────────
+/**
+ * Build the v1 signing body: pubkey(32) + kind(1) + kind_data.
+ * This is what gets sha256-hashed and Schnorr-signed for v1 posts.
+ * No magic or version prefix — saves bytes in the signing scope.
+ */
+function buildV1SigningBody(pubkey, kind, kindData) {
+    const buf = Buffer.alloc(types_js_1.PUBKEY_BYTES + 1 + kindData.length);
+    pubkey.copy(buf, 0);
+    buf[types_js_1.PUBKEY_BYTES] = kind;
+    kindData.copy(buf, types_js_1.PUBKEY_BYTES + 1);
+    return buf;
+}
+/**
+ * Split a v1 body across 80-byte OP_RETURN chunks.
+ *
+ * body = pubkey(32) + sig(64) + kind(1) + kind_data
+ *
+ * Chunk 0: ORS(3) | 0x01(1) | 0x00(1) | totalChunks(1) | body[0:74]   — 80 bytes max
+ * Chunk N: ORS(3) | 0x01(1) | N(1)    | body[74+(N-1)*75:74+N*75]     — 80 bytes max
+ *
+ * Returns an array of OP_RETURN payloads (without OP_RETURN opcode), each <= 80 bytes.
+ */
+function buildV1Chunks(pubkey, sig, kind, kindData) {
+    if (pubkey.length !== types_js_1.PUBKEY_BYTES)
+        throw new Error(`pubkey must be ${types_js_1.PUBKEY_BYTES} bytes`);
+    if (sig.length !== types_js_1.SIG_BYTES)
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    const body = Buffer.concat([pubkey, sig, Buffer.from([kind]), kindData]);
+    const numNonRootChunks = Math.ceil(Math.max(0, body.length - types_js_1.V1_CHUNK0_DATA) / types_js_1.V1_CHUNKN_DATA);
+    const totalChunks = 1 + numNonRootChunks;
+    const chunks = [];
+    // Chunk 0
+    const chunk0Body = body.subarray(0, types_js_1.V1_CHUNK0_DATA);
+    const chunk0 = Buffer.alloc(6 + chunk0Body.length);
+    types_js_1.ORS_MAGIC.copy(chunk0, 0);
+    chunk0[3] = types_js_1.ORS_VERSION_V1;
+    chunk0[4] = 0x00;
+    chunk0[5] = totalChunks;
+    chunk0Body.copy(chunk0, 6);
+    chunks.push(chunk0);
+    // Chunks 1..N
+    for (let n = 1; n < totalChunks; n++) {
+        const start = types_js_1.V1_CHUNK0_DATA + (n - 1) * types_js_1.V1_CHUNKN_DATA;
+        const end = Math.min(start + types_js_1.V1_CHUNKN_DATA, body.length);
+        const slice = body.subarray(start, end);
+        const chunk = Buffer.alloc(5 + slice.length);
+        types_js_1.ORS_MAGIC.copy(chunk, 0);
+        chunk[3] = types_js_1.ORS_VERSION_V1;
+        chunk[4] = n;
+        slice.copy(chunk, 5);
+        chunks.push(chunk);
+    }
+    return chunks;
+}
+/**
+ * Build a complete ORS OP_RETURN payload for a PROFILE_UPDATE.
+ * Format: ORS\x00 + pubkey(32) + sig(64) + kind(1=0x02) + propertyKind(1) + value_bytes
+ */
+function buildProfileUpdatePayload(propertyKind, value, pubkey, sig) {
+    if (sig.length !== types_js_1.SIG_BYTES) {
+        throw new Error(`sig must be ${types_js_1.SIG_BYTES} bytes`);
+    }
+    const unsigned = buildProfileUpdateUnsignedPayload(propertyKind, value, pubkey);
+    const buf = Buffer.alloc(unsigned.length + types_js_1.SIG_BYTES);
+    unsigned.subarray(0, types_js_1.SIG_OFFSET).copy(buf, 0);
+    sig.copy(buf, types_js_1.SIG_OFFSET);
+    unsigned.subarray(types_js_1.SIG_OFFSET).copy(buf, types_js_1.KIND_OFFSET);
+    return buf;
+}
+//# sourceMappingURL=encode.js.map

package/dist/encode.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./encode.js";
+export * from "./decode.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./encode.js"), exports);
+__exportStar(require("./decode.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+export declare const ORS_MAGIC: Buffer<ArrayBuffer>;
+export declare const ORS_VERSION = 0;
+export declare const ORS_VERSION_V1 = 1;
+export declare const V1_CHUNK0_HEADER = 6;
+export declare const V1_CHUNKN_HEADER = 5;
+export declare const V1_CHUNK0_DATA = 74;
+export declare const V1_CHUNKN_DATA = 75;
+export declare const KIND_TEXT_NOTE = 1;
+export declare const KIND_PROFILE_UPDATE = 2;
+export declare const KIND_TEXT_REPLY = 3;
+export declare const KIND_REPOST = 4;
+export declare const KIND_QUOTE_REPOST = 5;
+export declare const KIND_FOLLOW = 6;
+export declare const PUBKEY_OFFSET = 4;
+export declare const SIG_OFFSET = 36;
+export declare const KIND_OFFSET = 100;
+export declare const DATA_OFFSET = 101;
+export declare const PROPERTY_KIND_OFFSET = 101;
+export declare const PROFILE_VALUE_OFFSET = 102;
+export declare const PUBKEY_BYTES = 32;
+export declare const SIG_BYTES = 64;
+export declare const PARENT_TXID_BYTES = 32;
+export declare const PARENT_TXID_OFFSET = 101;
+export declare const REPLY_CONTENT_OFFSET = 133;
+export declare const MAX_CONTENT_BYTES = 277;
+export declare const PROPERTY_NAME = 0;
+export declare const PROPERTY_AVATAR_URL = 1;
+export declare const PROPERTY_BIO = 2;
+export declare const PROPERTY_BANNER_URL = 3;
+export declare const PROPERTY_BOT = 4;
+export declare const PROPERTY_WEBSITE_URL = 5;
+export interface OrsPost {
+    kind: number;
+    content: string;
+    pubkey: string;
+    sig: string;
+}
+export interface OrsProfileUpdate {
+    kind: 0x02;
+    propertyKind: number;
+    content: string;
+    pubkey: string;
+    sig: string;
+}
+export interface OrsTextReply {
+    kind: 0x03;
+    parentTxid: string;
+    content: string;
+    pubkey: string;
+    sig: string;
+}
+export interface OrsRepost {
+    kind: 0x04;
+    referencedTxid: string;
+    pubkey: string;
+    sig: string;
+}
+export interface OrsQuoteRepost {
+    kind: 0x05;
+    referencedTxid: string;
+    content: string;
+    pubkey: string;
+    sig: string;
+}
+export interface OrsFollow {
+    kind: 0x06;
+    targetPubkey: string;
+    isFollow: boolean;
+    pubkey: string;
+    sig: string;
+}
+export type ParsedOrsResult = {
+    supported: true;
+    post: OrsPost | OrsProfileUpdate | OrsTextReply | OrsRepost | OrsQuoteRepost | OrsFollow;
+} | {
+    supported: false;
+    reason: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROPERTY_WEBSITE_URL = exports.PROPERTY_BOT = exports.PROPERTY_BANNER_URL = exports.PROPERTY_BIO = exports.PROPERTY_AVATAR_URL = exports.PROPERTY_NAME = exports.MAX_CONTENT_BYTES = exports.REPLY_CONTENT_OFFSET = exports.PARENT_TXID_OFFSET = exports.PARENT_TXID_BYTES = exports.SIG_BYTES = exports.PUBKEY_BYTES = exports.PROFILE_VALUE_OFFSET = exports.PROPERTY_KIND_OFFSET = exports.DATA_OFFSET = exports.KIND_OFFSET = exports.SIG_OFFSET = exports.PUBKEY_OFFSET = exports.KIND_FOLLOW = exports.KIND_QUOTE_REPOST = exports.KIND_REPOST = exports.KIND_TEXT_REPLY = exports.KIND_PROFILE_UPDATE = exports.KIND_TEXT_NOTE = exports.V1_CHUNKN_DATA = exports.V1_CHUNK0_DATA = exports.V1_CHUNKN_HEADER = exports.V1_CHUNK0_HEADER = exports.ORS_VERSION_V1 = exports.ORS_VERSION = exports.ORS_MAGIC = void 0;
+exports.ORS_MAGIC = Buffer.from([0x4f, 0x52, 0x53]); // "ORS"
+exports.ORS_VERSION = 0x00;
+exports.ORS_VERSION_V1 = 0x01;
+// v1 chunk header sizes
+exports.V1_CHUNK0_HEADER = 6; // ORS(3)+ver(1)+chunkNum(1)+totalChunks(1)
+exports.V1_CHUNKN_HEADER = 5; // ORS(3)+ver(1)+chunkNum(1)
+// v1 body bytes per chunk slot
+exports.V1_CHUNK0_DATA = 74; // body bytes in chunk 0
+exports.V1_CHUNKN_DATA = 75; // body bytes in chunk N (N>=1)
+exports.KIND_TEXT_NOTE = 0x01;
+exports.KIND_PROFILE_UPDATE = 0x02;
+exports.KIND_TEXT_REPLY = 0x03;
+exports.KIND_REPOST = 0x04;
+exports.KIND_QUOTE_REPOST = 0x05;
+exports.KIND_FOLLOW = 0x06;
+// Header layout: magic(3) + version(1) + pubkey(32) + sig(64) + kind(1) = 101 bytes
+exports.PUBKEY_OFFSET = 4;
+exports.SIG_OFFSET = 36;
+exports.KIND_OFFSET = 100;
+exports.DATA_OFFSET = 101;
+exports.PROPERTY_KIND_OFFSET = 101;
+exports.PROFILE_VALUE_OFFSET = 102;
+exports.PUBKEY_BYTES = 32;
+exports.SIG_BYTES = 64;
+// TEXT_REPLY layout: ...header(101) + parentTxid(32) + content
+exports.PARENT_TXID_BYTES = 32;
+exports.PARENT_TXID_OFFSET = 101;
+exports.REPLY_CONTENT_OFFSET = 133;
+exports.MAX_CONTENT_BYTES = 277;
+// Profile property kind values
+exports.PROPERTY_NAME = 0x00;
+exports.PROPERTY_AVATAR_URL = 0x01;
+exports.PROPERTY_BIO = 0x02;
+exports.PROPERTY_BANNER_URL = 0x03;
+exports.PROPERTY_BOT = 0x04;
+exports.PROPERTY_WEBSITE_URL = 0x05;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAa,QAAA,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ;AACrD,QAAA,WAAW,GAAG,IAAI,CAAC;AACnB,QAAA,cAAc,GAAG,IAAI,CAAC;AAEnC,wBAAwB;AACX,QAAA,gBAAgB,GAAG,CAAC,CAAC,CAAE,2CAA2C;AAClE,QAAA,gBAAgB,GAAG,CAAC,CAAC,CAAE,4BAA4B;AAChE,+BAA+B;AAClB,QAAA,cAAc,GAAG,EAAE,CAAC,CAAG,wBAAwB;AAC/C,QAAA,cAAc,GAAG,EAAE,CAAC,CAAG,+BAA+B;AAEtD,QAAA,cAAc,GAAG,IAAI,CAAC;AACtB,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAC3B,QAAA,eAAe,GAAG,IAAI,CAAC;AACvB,QAAA,WAAW,GAAG,IAAI,CAAC;AACnB,QAAA,iBAAiB,GAAG,IAAI,CAAC;AACzB,QAAA,WAAW,GAAG,IAAI,CAAC;AAEhC,oFAAoF;AACvE,QAAA,aAAa,GAAG,CAAC,CAAC;AAClB,QAAA,UAAU,GAAG,EAAE,CAAC;AAChB,QAAA,WAAW,GAAG,GAAG,CAAC;AAClB,QAAA,WAAW,GAAG,GAAG,CAAC;AAClB,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAC3B,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAC3B,QAAA,YAAY,GAAG,EAAE,CAAC;AAClB,QAAA,SAAS,GAAG,EAAE,CAAC;AAE5B,+DAA+D;AAClD,QAAA,iBAAiB,GAAG,EAAE,CAAC;AACvB,QAAA,kBAAkB,GAAG,GAAG,CAAC;AACzB,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAE3B,QAAA,iBAAiB,GAAG,GAAG,CAAC;AAErC,+BAA+B;AAClB,QAAA,aAAa,GAAG,IAAI,CAAC;AACrB,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAC3B,QAAA,YAAY,GAAG,IAAI,CAAC;AACpB,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAC3B,QAAA,YAAY,GAAG,IAAI,CAAC;AACpB,QAAA,oBAAoB,GAAG,IAAI,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@opreturnsocial/protocol",
+  "version": "0.1.0",
+  "description": "Zero-dependency TLV encoding/decoding library for the opreturn.social bitcoin social protocol",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opreturnsocial/opreturn.social.git",
+    "directory": "packages/protocol"
+  },
+  "homepage": "https://opreturn.social",
+  "keywords": ["bitcoin", "op_return", "social", "protocol", "nostr", "lightning"],
+  "files": [
+    "dist/**/*"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}