@1sat/actions 0.0.230 → 0.0.232

package/dist/metanet/receive.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Collect BRC-169 payments from the wallet's `metanet_inbox`.
+ *
+ * For each message listed (BRC-231 over BRC-104) the shared inbox steps
+ * decode the §7.3 DAG-CBOR envelope, verify its §7.2 signature against
+ * `sender.identityKey`, decrypt the BRC-78 `content`, check `contentHash`
+ * and parse the MIME entity (see `processInbox`). Then:
+ *
+ * - `payment` set (BRC-169 §6.1): internalize its Atomic BEEF as a BRC-29
+ *   `wallet payment` of output 0, remittance `{ derivationPrefix,
+ *   derivationSuffix, senderIdentityKey: sender.identityKey }`, label
+ *   `metanet payment`, the memo in the description when `content` is
+ *   `text/plain`;
+ * - `payment` null and `content` a BRC-232 transaction delivery: processed as
+ *   `syncMandalaInbox` processes it.
+ *
+ * A message is acknowledged only after its internalize succeeds. Anything
+ * else (JSON envelopes, a bad signature or hash, a payment protocol other
+ * than BRC-29, a payment whose content is a transaction delivery, a message
+ * with nothing to internalize) is left unacknowledged and reported.
+ */
+import type { Action } from '../types.js';
+import { type InboxSkip } from './inbox.js';
+/** Label on internalized handle payments */
+export declare const METANET_PAYMENT_LABEL = "metanet payment";
+export interface SyncMetanetInboxInput {
+    /** MessageBox server URL (default: "https://messagebox.1sat.app") */
+    messageboxUrl?: string;
+}
+/** A message internalized and acknowledged. */
+export interface MetanetInboxReceipt {
+    messageId: string;
+    txid: string;
+    /** Sender identity key, hex */
+    sender: string;
+    /** `payment.satoshis` as the envelope states it (payments only) */
+    satoshis?: number;
+    /** The `text/plain` content (payments only) */
+    memo?: string;
+    /** Mandala tokens received (BRC-232 deliveries only) */
+    tokenIds: string[];
+}
+export interface SyncMetanetInboxResult {
+    received: MetanetInboxReceipt[];
+    /** Messages left unacknowledged */
+    skipped: InboxSkip[];
+    error?: string;
+}
+export declare const syncMetanetInbox: Action<SyncMetanetInboxInput, SyncMetanetInboxResult>;
+//# sourceMappingURL=receive.d.ts.map

package/dist/metanet/receive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive.d.ts","sourceRoot":"","sources":["../../src/metanet/receive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,YAAY,CAAA;AAEzE,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,oBAAoB,CAAA;AAEtD,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,mCAAmC;IACnC,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAqDD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACpC,qBAAqB,EACrB,sBAAsB,CAiEtB,CAAA"}

package/dist/metanet/receive.js

@@ -0,0 +1,107 @@
+/**
+ * Collect BRC-169 payments from the wallet's `metanet_inbox`.
+ *
+ * For each message listed (BRC-231 over BRC-104) the shared inbox steps
+ * decode the §7.3 DAG-CBOR envelope, verify its §7.2 signature against
+ * `sender.identityKey`, decrypt the BRC-78 `content`, check `contentHash`
+ * and parse the MIME entity (see `processInbox`). Then:
+ *
+ * - `payment` set (BRC-169 §6.1): internalize its Atomic BEEF as a BRC-29
+ *   `wallet payment` of output 0, remittance `{ derivationPrefix,
+ *   derivationSuffix, senderIdentityKey: sender.identityKey }`, label
+ *   `metanet payment`, the memo in the description when `content` is
+ *   `text/plain`;
+ * - `payment` null and `content` a BRC-232 transaction delivery: processed as
+ *   `syncMandalaInbox` processes it.
+ *
+ * A message is acknowledged only after its internalize succeeds. Anything
+ * else (JSON envelopes, a bad signature or hash, a payment protocol other
+ * than BRC-29, a payment whose content is a transaction delivery, a message
+ * with nothing to internalize) is left unacknowledged and reported.
+ */
+import { BRC29_PROTOCOL_ID, METANET_INBOX } from '@1sat/types';
+import { TRANSACTION_CBOR_CONTENT_TYPE, mediaType } from '@1sat/utils';
+import { Beef, Utils } from '@bsv/sdk';
+import { internalizeTransactionDelivery } from '../mandala/receive.js';
+import { InboxSkipError, processInbox } from './inbox.js';
+/** Label on internalized handle payments */
+export const METANET_PAYMENT_LABEL = 'metanet payment';
+const BRC29_PROTOCOL = BRC29_PROTOCOL_ID[1];
+/** Internalize a §7.3 `payment` as a BRC-29 wallet payment of output 0. */
+async function internalizeEnvelopePayment(wallet, payment, sender, memo) {
+    if (!(payment.protocol instanceof Uint8Array) ||
+        Utils.toUTF8(Array.from(payment.protocol)) !== BRC29_PROTOCOL) {
+        throw new InboxSkipError('payment protocol is not BRC-29');
+    }
+    if (!(payment.derivationPrefix instanceof Uint8Array) ||
+        !(payment.derivationSuffix instanceof Uint8Array) ||
+        !(payment.beef instanceof Uint8Array)) {
+        throw new InboxSkipError('malformed payment');
+    }
+    const beef = Beef.fromBinary(Array.from(payment.beef));
+    const txid = beef.atomicTxid ?? beef.txs[beef.txs.length - 1]?.tx?.id('hex');
+    if (!txid)
+        throw new InboxSkipError('payment beef has no transaction');
+    await wallet.internalizeAction({
+        tx: beef.toBinaryAtomic(txid),
+        outputs: [
+            {
+                outputIndex: 0,
+                protocol: 'wallet payment',
+                paymentRemittance: {
+                    derivationPrefix: Utils.toBase64(Array.from(payment.derivationPrefix)),
+                    derivationSuffix: Utils.toBase64(Array.from(payment.derivationSuffix)),
+                    senderIdentityKey: sender,
+                },
+            },
+        ],
+        labels: [METANET_PAYMENT_LABEL],
+        description: (memo ? `Metanet payment: ${memo}` : 'Metanet payment').slice(0, 50),
+    });
+    return txid;
+}
+export const syncMetanetInbox = {
+    meta: {
+        name: 'syncMetanetInbox',
+        description: 'Collect BRC-169 handle payments (and BRC-232 deliveries) from the metanet_inbox message box and internalize them',
+        category: 'sync',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                messageboxUrl: {
+                    type: 'string',
+                    description: 'MessageBox server URL (default: "https://messagebox.1sat.app")',
+                },
+            },
+        },
+        requiresServices: false,
+    },
+    async execute(ctx, input) {
+        return processInbox(ctx.wallet, input.messageboxUrl, METANET_INBOX, async ({ env, sender, entity }, msg) => {
+            const type = mediaType(entity.contentType);
+            if (env.payment) {
+                if (type === TRANSACTION_CBOR_CONTENT_TYPE) {
+                    throw new InboxSkipError('a payment with transaction-delivery content is not supported');
+                }
+                const memo = type === 'text/plain'
+                    ? Utils.toUTF8(Array.from(entity.body))
+                    : undefined;
+                const txid = await internalizeEnvelopePayment(ctx.wallet, env.payment, sender, memo);
+                return {
+                    messageId: msg.messageId,
+                    txid,
+                    sender,
+                    satoshis: env.payment.satoshis,
+                    memo,
+                    tokenIds: [],
+                };
+            }
+            if (type === TRANSACTION_CBOR_CONTENT_TYPE) {
+                const { txid, tokenIds } = await internalizeTransactionDelivery(ctx.wallet, entity.body);
+                return { messageId: msg.messageId, txid, sender, tokenIds };
+            }
+            throw new InboxSkipError(`nothing to internalize: no payment, content type ${entity.contentType}`);
+        });
+    },
+};
+//# sourceMappingURL=receive.js.map

package/dist/metanet/receive.js.map

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

package/dist/metanet/relay.d.ts

@@ -0,0 +1,37 @@
+/**
+ * BRC-33 message relay in the BRC-231 binary encoding, over BRC-104
+ * (AuthFetch): requests and responses are DAG-CBOR, the message body and
+ * identity keys are byte strings.
+ *
+ * - `POST /sendMessage` `{ message: { recipient: bstr(33), messageBox, body: bstr } }`
+ *   → `{ status, messageId }`
+ * - `POST /listMessages` `{ messageBox }`
+ *   → `{ status, messages: [ { messageId, body: bstr, sender: bstr(33) } ] }`
+ * - `POST /acknowledgeMessage` `{ messageIds }` → `{ status }`
+ */
+import { type WalletInterface } from '@bsv/sdk';
+/** A listed BRC-231 message. */
+export interface CborMessage {
+    messageId: string;
+    body: Uint8Array;
+    sender: Uint8Array;
+}
+export declare function sendCborMessage(wallet: WalletInterface, messagebox: string, recipient: string, messageBox: string, body: Uint8Array): Promise<{
+    status: string;
+    messageId: string;
+}>;
+export declare function listCborMessages(wallet: WalletInterface, messagebox: string, messageBox: string): Promise<CborMessage[]>;
+export declare function acknowledgeCborMessages(wallet: WalletInterface, messagebox: string, messageIds: string[]): Promise<{
+    status: string;
+}>;
+/**
+ * The relay calls the BRC-169 envelope actions make (Mandala sends, handle
+ * payments, inbox syncs), gathered in one object so a host or a test can
+ * substitute the transport.
+ */
+export declare const messageRelay: {
+    sendCborMessage: typeof sendCborMessage;
+    listCborMessages: typeof listCborMessages;
+    acknowledgeCborMessages: typeof acknowledgeCborMessages;
+};
+//# sourceMappingURL=relay.d.ts.map

package/dist/metanet/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/metanet/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAMjE,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,UAAU,CAAA;CAClB;AAsBD,wBAAsB,eAAe,CACpC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhD;AAED,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB;AAED,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7B;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;CAIxB,CAAA"}

package/dist/metanet/relay.js

@@ -0,0 +1,51 @@
+/**
+ * BRC-33 message relay in the BRC-231 binary encoding, over BRC-104
+ * (AuthFetch): requests and responses are DAG-CBOR, the message body and
+ * identity keys are byte strings.
+ *
+ * - `POST /sendMessage` `{ message: { recipient: bstr(33), messageBox, body: bstr } }`
+ *   → `{ status, messageId }`
+ * - `POST /listMessages` `{ messageBox }`
+ *   → `{ status, messages: [ { messageId, body: bstr, sender: bstr(33) } ] }`
+ * - `POST /acknowledgeMessage` `{ messageIds }` → `{ status }`
+ */
+import { AuthFetch, Utils } from '@bsv/sdk';
+import { decode as dagCborDecode, encode as dagCborEncode, } from '@ipld/dag-cbor';
+async function postCbor(wallet, messagebox, path, request) {
+    const res = await new AuthFetch(wallet).fetch(`${messagebox.replace(/\/+$/, '')}${path}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/cbor' },
+        body: dagCborEncode(request),
+    });
+    if (!res.ok) {
+        throw new Error(`${path.slice(1)} ${res.status}`);
+    }
+    return dagCborDecode(new Uint8Array(await res.arrayBuffer()));
+}
+export async function sendCborMessage(wallet, messagebox, recipient, messageBox, body) {
+    return postCbor(wallet, messagebox, '/sendMessage', {
+        message: {
+            recipient: Uint8Array.from(Utils.toArray(recipient, 'hex')),
+            messageBox,
+            body,
+        },
+    });
+}
+export async function listCborMessages(wallet, messagebox, messageBox) {
+    const res = await postCbor(wallet, messagebox, '/listMessages', { messageBox });
+    return res.messages ?? [];
+}
+export async function acknowledgeCborMessages(wallet, messagebox, messageIds) {
+    return postCbor(wallet, messagebox, '/acknowledgeMessage', { messageIds });
+}
+/**
+ * The relay calls the BRC-169 envelope actions make (Mandala sends, handle
+ * payments, inbox syncs), gathered in one object so a host or a test can
+ * substitute the transport.
+ */
+export const messageRelay = {
+    sendCborMessage,
+    listCborMessages,
+    acknowledgeCborMessages,
+};
+//# sourceMappingURL=relay.js.map

package/dist/metanet/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../src/metanet/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAwB,MAAM,UAAU,CAAA;AACjE,OAAO,EACN,MAAM,IAAI,aAAa,EACvB,MAAM,IAAI,aAAa,GACvB,MAAM,gBAAgB,CAAA;AASvB,KAAK,UAAU,QAAQ,CACtB,MAAuB,EACvB,UAAkB,EAClB,IAAY,EACZ,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAC5C,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,EAC1C;QACC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC;KAC5B,CACD,CAAA;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IAClD,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAM,CAAA;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,MAAuB,EACvB,UAAkB,EAClB,SAAiB,EACjB,UAAkB,EAClB,IAAgB;IAEhB,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE;QACnD,OAAO,EAAE;YACR,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC3D,UAAU;YACV,IAAI;SACJ;KACD,CAAC,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAuB,EACvB,UAAkB,EAClB,UAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,QAAQ,CACzB,MAAM,EACN,UAAU,EACV,eAAe,EACf,EAAE,UAAU,EAAE,CACd,CAAA;IACD,OAAO,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAuB,EACvB,UAAkB,EAClB,UAAoB;IAEpB,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,qBAAqB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,eAAe;IACf,gBAAgB;IAChB,uBAAuB;CACvB,CAAA"}

package/dist/opns/index.d.ts

@@ -20,15 +20,39 @@ export interface OpnsIdInput extends ActionOptions {
     /** Tracking id of the OpNS UTXO in the OPNS basket */
     id: string;
 }
-export interface RegisterOpnsRequest extends OpnsIdInput {
+/** Inscription carried on the name coin after the PushDrop fields. */
+export interface OpnsInscription {
+    contentType: string;
+    content: number[] | Uint8Array;
+}
+/**
+ * The `profile` written on the name — same members as the on-chain DAG-CBOR
+ * map; `avatar` is given as an outpoint and stored as its 36 bytes.
+ */
+export interface OpnsProfile {
     /**
-     * Display name returned by the paymail public-profile capability.
-     * Presentation only — the OpNS name is the unique, owned value.
+     * BRC-169 ecosystem domain the identity is reached at (e.g. `1sat.name`).
+     * Written exactly as given — not validated; fix a typo by republishing.
+     * Readers go `https://<domain>/manifest.json`.
      */
-    profileName?: string;
+    domain: string;
+    /**
+     * Presentation name (served by paymail public-profile). The OpNS name is
+     * the unique value; this is decoration.
+     */
+    name?: string;
     /** Origin outpoint (`txid_vout`) of an on-chain image ordinal */
     avatar?: string;
 }
+export interface RegisterOpnsRequest extends OpnsIdInput {
+    profile: OpnsProfile;
+    /**
+     * Optional inscription envelope appended after the PushDrop lock. ORDFS
+     * records it as a new rev of the name's origin (`/<origin>:-1`). The
+     * action does not interpret the content type.
+     */
+    inscription?: OpnsInscription;
+}
 export type DeregisterOpnsRequest = OpnsIdInput;
 export interface SellOpnsRequest extends OpnsIdInput {
     price: number;
@@ -75,6 +99,43 @@ export interface InternalizeOpnsResult {
 }
 export declare const listOpns: Action<ListOpnsInput, ListOpnsResult>;
 export declare const internalizeOpns: Action<InternalizeOpnsInput, InternalizeOpnsResult>;
+/**
+ * Publish an OpNS name: lock the name coin in a signed PushDrop (the plain
+ * template) whose fields are key/value pairs
+ * `["identity", <identity key>, "profile", <dag-cbor {domain, name?, avatar?}>, <sig>]`.
+ * The field codecs are in `@1sat/utils`; this action owns the layout (see
+ * `docs/protocols/opns-paymail-bind.md`).
+ *
+ * With `inscription`, the output script is that PushDrop lock followed by a
+ * standard 1-sat inscription envelope, so ORDFS serves the content as the
+ * name's latest rev (`/<origin>:-1`). The action is ignorant of the content
+ * type. Publishing a release or state is an `ordfs/dir` whose `"."` entry is
+ * the root outpoint:
+ *
+ * ```ts
+ * import { DIR_CONTENT_TYPE, DIR_VERSION, dirEncode } from '@1sat/actions'
+ * await registerOpns.execute(ctx, {
+ *   id,
+ *   profile: { domain: '1sat.name' },
+ *   inscription: {
+ *     contentType: DIR_CONTENT_TYPE, // 'ordfs/dir'
+ *     content: dirEncode({
+ *       version: DIR_VERSION,
+ *       entries: [{
+ *         name: new TextEncoder().encode('.'),
+ *         isDir: true,
+ *         ref: { kind: 'outpoint', txid: rootTxid, vout: 0 },
+ *       }],
+ *     }),
+ *   },
+ * })
+ * ```
+ *
+ * Two phases: the action emits the complete script with a zeroed signature
+ * field (and the envelope already appended); `applyOpnsRegister` finds that
+ * placeholder push and replaces it with the real signature. Nothing else in
+ * the script changes, so the envelope simply stays where it is.
+ */
 export declare const registerOpns: Action<RegisterOpnsRequest, OpnsOperationResponse>;
 export declare const deregisterOpns: Action<DeregisterOpnsRequest, OpnsOperationResponse>;
 export declare const sellOpns: Action<SellOpnsRequest, OpnsOperationResponse>;

package/dist/opns/index.d.ts.map

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

package/dist/opns/index.js

@@ -5,8 +5,9 @@
  * Self-moves: id → one loadBasketOutputBeef → ordinalSeedTags + domain tags.
  * Ingress (internalizeOpns / buyOpns) stamps full tags including id:.
  */
-import { OpNS, OrdLockV2, outpointToBytes } from '@1sat/templates';
-import { OPNS_BASKET, OPNS_PUBLISHED_TAG, OPNS_REGISTER_COUNTERPARTY, OPNS_REGISTER_SIG_PLACEHOLDER_LEN, ORDLOCK_V2_TAG, P1SAT_PROTOCOL, buildInputAssetLabel, formatOrdinalOutpoint, opnsRegisterKeyId, readAssetIdTag, } from '@1sat/types';
+import { Inscription, OpNS, OrdLockV2, outpointToBytes } from '@1sat/templates';
+import { IDENTITY_FIELD, OPNS_BASKET, OPNS_PUBLISHED_TAG, OPNS_REGISTER_COUNTERPARTY, OPNS_REGISTER_SIG_PLACEHOLDER_LEN, ORDLOCK_V2_TAG, P1SAT_PROTOCOL, PROFILE_FIELD, buildInputAssetLabel, formatOrdinalOutpoint, opnsRegisterKeyId, readAssetIdTag, } from '@1sat/types';
+import { encodeProfile } from '@1sat/utils';
 import { P2PKH, PublicKey, PushDrop, Transaction, Utils, } from '@bsv/sdk';
 import { prepareP1SatArgs } from '../apply/index.js';
 import { buildOrdLockScript, buildOrdinalTransferDelivery, buyOrdinal, defaultPayAddress, deriveCancelAddressInternal, } from '../ordinals/index.js';
@@ -17,24 +18,6 @@ import { ordinalSeedTags } from '../utils/ordinalSeedTags.js';
 import { ordLockCancelUnlockLength } from '../utils/ordlockCancelLength.js';
 import { unlockingScriptLengthForInstructions } from '../utils/signOrdinalInput.js';
 const OPNS_CONTENT_TYPE = 'application/op-ns';
-/**
- * Presentation slots published after the identity key: slot 1 display name
- * (utf8), slot 2 avatar origin outpoint (36 bytes). Slot 1 is an empty push
- * when only an avatar is set; trailing unset slots are omitted.
- */
-function profileFields(profileName, avatar) {
-    const displayName = profileName?.trim() ?? '';
-    const origin = avatar?.trim() ?? '';
-    if (!displayName && !origin)
-        return [];
-    const nameField = displayName ? Utils.toArray(displayName, 'utf8') : [];
-    if (!origin)
-        return [nameField];
-    const avatarField = outpointToBytes(formatOrdinalOutpoint(origin));
-    if (!avatarField)
-        throw new Error(`invalid avatar outpoint: ${origin}`);
-    return [nameField, avatarField];
-}
 export { opnsRegisterKeyId } from '@1sat/types';
 // ============================================================================
 // Helpers
@@ -217,25 +200,82 @@ export const internalizeOpns = {
 // ============================================================================
 // register / deregister
 // ============================================================================
+/**
+ * Publish an OpNS name: lock the name coin in a signed PushDrop (the plain
+ * template) whose fields are key/value pairs
+ * `["identity", <identity key>, "profile", <dag-cbor {domain, name?, avatar?}>, <sig>]`.
+ * The field codecs are in `@1sat/utils`; this action owns the layout (see
+ * `docs/protocols/opns-paymail-bind.md`).
+ *
+ * With `inscription`, the output script is that PushDrop lock followed by a
+ * standard 1-sat inscription envelope, so ORDFS serves the content as the
+ * name's latest rev (`/<origin>:-1`). The action is ignorant of the content
+ * type. Publishing a release or state is an `ordfs/dir` whose `"."` entry is
+ * the root outpoint:
+ *
+ * ```ts
+ * import { DIR_CONTENT_TYPE, DIR_VERSION, dirEncode } from '@1sat/actions'
+ * await registerOpns.execute(ctx, {
+ *   id,
+ *   profile: { domain: '1sat.name' },
+ *   inscription: {
+ *     contentType: DIR_CONTENT_TYPE, // 'ordfs/dir'
+ *     content: dirEncode({
+ *       version: DIR_VERSION,
+ *       entries: [{
+ *         name: new TextEncoder().encode('.'),
+ *         isDir: true,
+ *         ref: { kind: 'outpoint', txid: rootTxid, vout: 0 },
+ *       }],
+ *     }),
+ *   },
+ * })
+ * ```
+ *
+ * Two phases: the action emits the complete script with a zeroed signature
+ * field (and the envelope already appended); `applyOpnsRegister` finds that
+ * placeholder push and replaces it with the real signature. Nothing else in
+ * the script changes, so the envelope simply stays where it is.
+ */
 export const registerOpns = {
     meta: {
         name: 'registerOpns',
-        description: 'Bind BRC-100 identity key to an OpNS name via signed PushDrop',
+        description: 'Bind BRC-100 identity key to an OpNS name via signed PushDrop identity + profile fields, optionally with an inscription',
         category: 'opns',
         inputSchema: {
             type: 'object',
             properties: {
                 id: { type: 'string', description: 'OPNS basket tracking id' },
-                profileName: {
-                    type: 'string',
-                    description: 'Display name for paymail public-profile',
+                profile: {
+                    type: 'object',
+                    description: 'Profile written on the name',
+                    properties: {
+                        domain: {
+                            type: 'string',
+                            description: 'BRC-169 ecosystem domain, written as given (e.g. 1sat.name)',
+                        },
+                        name: {
+                            type: 'string',
+                            description: 'Presentation name for paymail public-profile',
+                        },
+                        avatar: {
+                            type: 'string',
+                            description: 'Origin outpoint (txid_vout) of an on-chain image ordinal',
+                        },
+                    },
+                    required: ['domain'],
                 },
-                avatar: {
-                    type: 'string',
-                    description: 'Origin outpoint (txid_vout) of an on-chain image ordinal',
+                inscription: {
+                    type: 'object',
+                    description: 'Optional inscription appended after the PushDrop (any content type)',
+                    properties: {
+                        contentType: { type: 'string' },
+                        content: { type: 'array', items: { type: 'integer' } },
+                    },
+                    required: ['contentType', 'content'],
                 },
             },
-            required: ['id'],
+            required: ['id', 'profile'],
         },
     },
     async execute(ctx, input) {
@@ -248,16 +288,35 @@ export const registerOpns = {
                 return { error: 'missing-custom-instructions' };
             }
             const keyID = opnsRegisterKeyId(output.outpoint);
-            const { publicKey: identityPubKey } = await ctx.wallet.getPublicKey({
+            const { publicKey: identityKey } = await ctx.wallet.getPublicKey({
                 identityKey: true,
             });
+            const avatarOutpoint = input.profile?.avatar;
+            let avatar;
+            if (avatarOutpoint?.trim()) {
+                const bytes = outpointToBytes(formatOrdinalOutpoint(avatarOutpoint));
+                if (!bytes)
+                    throw new Error(`invalid avatar outpoint: ${avatarOutpoint}`);
+                avatar = bytes;
+            }
+            // Key/value fields on the plain PushDrop template; this action owns
+            // the layout.
+            const fields = [
+                Utils.toArray(IDENTITY_FIELD, 'utf8'),
+                Utils.toArray(identityKey, 'hex'),
+                Utils.toArray(PROFILE_FIELD, 'utf8'),
+                encodeProfile({
+                    domain: input.profile?.domain ?? '',
+                    name: input.profile?.name,
+                    avatar,
+                }),
+            ];
             // Complete script, signature field zeroed — apply swaps in the real
             // signature, so the size here is the size on chain.
-            const unsealedLock = await new PushDrop(ctx.wallet).lock([
-                Utils.toArray(identityPubKey, 'hex'),
-                ...profileFields(input.profileName, input.avatar),
-                new Array(OPNS_REGISTER_SIG_PLACEHOLDER_LEN).fill(0),
-            ], P1SAT_PROTOCOL, keyID, OPNS_REGISTER_COUNTERPARTY, true, false);
+            const pushDropLock = await new PushDrop(ctx.wallet).lock([...fields, new Array(OPNS_REGISTER_SIG_PLACEHOLDER_LEN).fill(0)], P1SAT_PROTOCOL, keyID, OPNS_REGISTER_COUNTERPARTY, true, false);
+            const unsealedLock = input.inscription
+                ? Inscription.create(Uint8Array.from(input.inscription.content), input.inscription.contentType, { scriptPrefix: pushDropLock }).lock()
+                : pushDropLock;
             const name = nameFromOutput(output);
             const tags = opnsFileTags(output, [OPNS_PUBLISHED_TAG]);
             const inputId = readAssetIdTag(output.tags);