@1sat/actions 0.0.229 → 0.0.231

package/dist/mandala/receive.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Collect BRC-232 transaction deliveries from the wallet's `mandala_inbox`.
+ *
+ * For each message listed (BRC-231 over BRC-104): decode the BRC-169 §7.3
+ * DAG-CBOR envelope, verify its §7.2 signature against `sender.identityKey`,
+ * decrypt the BRC-78 `content` with `wallet.decrypt`, check `contentHash`,
+ * parse the MIME entity, require `application/vnd.metanet.transaction+cbor`,
+ * decode the DAG-CBOR body and internalize its outputs:
+ *
+ * - `wallet payment` → `paymentRemittance { derivationPrefix,
+ *   derivationSuffix, senderIdentityKey }`;
+ * - `basket insertion` under a `mandala <txid> <vout>` protocol → basket
+ *   `mandala <txid> <vout>`, customInstructions = the derivation triple as given,
+ *   labels `mandala` and `mandala <txid> <vout>`, after checking that the output's
+ *   script names that token.
+ *
+ * A message is internalized whole or not at all, and acknowledged only after
+ * its internalize succeeds. Anything else (an unknown content type or
+ * protocolID, a token id mismatch, a bad signature, …) leaves the message
+ * unacknowledged and is reported. SPV is `internalizeAction`'s.
+ */
+import type { Action } from '../types.js';
+export interface SyncMandalaInboxInput {
+    /** MessageBox server URL (default: "https://messagebox.1sat.app") */
+    messageboxUrl?: string;
+}
+/** A message left in the box, and why. */
+export interface MandalaInboxSkip {
+    messageId: string;
+    reason: string;
+}
+/** A message internalized and acknowledged. */
+export interface MandalaInboxReceipt {
+    messageId: string;
+    txid: string;
+    /** Tokens (BRC-36 deploy outpoints `<txid>.<vout>`) of the Mandala outputs received */
+    tokenIds: string[];
+}
+export interface SyncMandalaInboxResult {
+    received: MandalaInboxReceipt[];
+    /** Messages left unacknowledged */
+    skipped: MandalaInboxSkip[];
+    error?: string;
+}
+export declare const syncMandalaInbox: Action<SyncMandalaInboxInput, SyncMandalaInboxResult>;
+//# sourceMappingURL=receive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receive.d.ts","sourceRoot":"","sources":["../../src/mandala/receive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuBH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAMzC,MAAM,WAAW,qBAAqB;IACrC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACd;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,mCAAmC;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAkID,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACpC,qBAAqB,EACrB,sBAAsB,CA0GtB,CAAA"}

package/dist/mandala/receive.js

@@ -0,0 +1,218 @@
+/**
+ * Collect BRC-232 transaction deliveries from the wallet's `mandala_inbox`.
+ *
+ * For each message listed (BRC-231 over BRC-104): decode the BRC-169 §7.3
+ * DAG-CBOR envelope, verify its §7.2 signature against `sender.identityKey`,
+ * decrypt the BRC-78 `content` with `wallet.decrypt`, check `contentHash`,
+ * parse the MIME entity, require `application/vnd.metanet.transaction+cbor`,
+ * decode the DAG-CBOR body and internalize its outputs:
+ *
+ * - `wallet payment` → `paymentRemittance { derivationPrefix,
+ *   derivationSuffix, senderIdentityKey }`;
+ * - `basket insertion` under a `mandala <txid> <vout>` protocol → basket
+ *   `mandala <txid> <vout>`, customInstructions = the derivation triple as given,
+ *   labels `mandala` and `mandala <txid> <vout>`, after checking that the output's
+ *   script names that token.
+ *
+ * A message is internalized whole or not at all, and acknowledged only after
+ * its internalize succeeds. Anything else (an unknown content type or
+ * protocolID, a token id mismatch, a bad signature, …) leaves the message
+ * unacknowledged and is reported. SPV is `internalizeAction`'s.
+ */
+import { Mandala } from '@1sat/templates';
+import { MANDALA_INBOX, MANDALA_LABEL, mandalaTokenBasket, mandalaTokenLabel, parseMandalaName, } from '@1sat/types';
+import { TRANSACTION_CBOR_CONTENT_TYPE, mediaType, parseMimeEntity, } from '@1sat/utils';
+import { Beef, Hash, Utils, } from '@bsv/sdk';
+import { decode as dagCborDecode } from '@ipld/dag-cbor';
+import { decryptBrc78 } from './brc78.js';
+import { decodeEnvelope, verifyEnvelope } from './envelope.js';
+import { messageRelay } from './relay.js';
+import { mandalaTokenOf } from './tokenId.js';
+const MANDALA_PREFIX = 'mandala ';
+class Skip extends Error {
+}
+function bytesHex(b, length, what) {
+    if (!(b instanceof Uint8Array) || b.length !== length) {
+        throw new Skip(`${what} must be ${length} bytes`);
+    }
+    return Utils.toHex(Array.from(b));
+}
+/** Build the internalize outputs and labels for one delivery, or throw Skip. */
+function planInternalize(body) {
+    const txid = bytesHex(body.txid, 32, 'txid');
+    if (!(body.beef instanceof Uint8Array))
+        throw new Skip('beef must be bytes');
+    if (!Array.isArray(body.outputs) || body.outputs.length === 0) {
+        throw new Skip('outputs must be a non-empty array');
+    }
+    const beef = Beef.fromBinary(Array.from(body.beef));
+    const subject = beef.findTxid(txid)?.tx;
+    if (!subject)
+        throw new Skip(`beef does not contain ${txid}`);
+    const outputs = [];
+    const tokenIds = [];
+    const seen = new Set();
+    for (const entry of body.outputs) {
+        const outputIndex = entry.outputIndex;
+        if (typeof outputIndex !== 'number' ||
+            !subject.outputs[outputIndex] ||
+            seen.has(outputIndex)) {
+            throw new Skip(`bad outputIndex ${String(outputIndex)}`);
+        }
+        seen.add(outputIndex);
+        if (entry.protocol === 'wallet payment') {
+            if (typeof entry.derivationPrefix !== 'string' ||
+                typeof entry.derivationSuffix !== 'string') {
+                throw new Skip(`output ${outputIndex}: bad payment remittance`);
+            }
+            outputs.push({
+                outputIndex,
+                protocol: 'wallet payment',
+                paymentRemittance: {
+                    derivationPrefix: entry.derivationPrefix,
+                    derivationSuffix: entry.derivationSuffix,
+                    senderIdentityKey: bytesHex(entry.senderIdentityKey, 33, 'senderIdentityKey'),
+                },
+            });
+            continue;
+        }
+        if (entry.protocol !== 'basket insertion') {
+            throw new Skip(`output ${outputIndex}: unknown protocol ${String(entry.protocol)}`);
+        }
+        const protocolID = entry.protocolID;
+        const name = Array.isArray(protocolID) ? protocolID[1] : undefined;
+        if (typeof name !== 'string' || !name.startsWith(MANDALA_PREFIX)) {
+            throw new Skip(`output ${outputIndex}: unknown protocolID ${JSON.stringify(protocolID)}`);
+        }
+        if (typeof entry.keyID !== 'string') {
+            throw new Skip(`output ${outputIndex}: keyID must be a string`);
+        }
+        const counterparty = bytesHex(entry.counterparty, 33, 'counterparty');
+        // The protocol names the token by its deploy outpoint; the script's
+        // BRC-162 id must name the same outpoint.
+        const named = parseMandalaName(name);
+        if (!named) {
+            throw new Skip(`output ${outputIndex}: malformed Mandala protocol ${name}`);
+        }
+        const tokenId = `${named.txid}.${named.vout}`;
+        const token = Mandala.decode(subject.outputs[outputIndex].lockingScript);
+        const scriptTokenId = token
+            ? mandalaTokenOf(token, txid, outputIndex)
+            : undefined;
+        if (scriptTokenId === undefined || scriptTokenId !== tokenId) {
+            throw new Skip(`output ${outputIndex}: token mismatch (protocolID ${tokenId}, script ${scriptTokenId ?? 'none'})`);
+        }
+        outputs.push({
+            outputIndex,
+            protocol: 'basket insertion',
+            insertionRemittance: {
+                basket: mandalaTokenBasket(tokenId),
+                customInstructions: JSON.stringify({
+                    protocolID,
+                    keyID: entry.keyID,
+                    counterparty,
+                }),
+            },
+        });
+        if (!tokenIds.includes(tokenId))
+            tokenIds.push(tokenId);
+    }
+    const labels = tokenIds.length
+        ? [MANDALA_LABEL, ...tokenIds.map(mandalaTokenLabel)]
+        : [];
+    return { txid, tx: beef.toBinaryAtomic(txid), outputs, labels, tokenIds };
+}
+export const syncMandalaInbox = {
+    meta: {
+        name: 'syncMandalaInbox',
+        description: 'Collect BRC-232 transaction deliveries (Mandala tokens, BRC-29 payments) from the mandala_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) {
+        const messagebox = input.messageboxUrl?.replace(/\/+$/, '') || 'https://messagebox.1sat.app';
+        const received = [];
+        const skipped = [];
+        const acknowledged = [];
+        let messages;
+        try {
+            messages = await messageRelay.listCborMessages(ctx.wallet, messagebox, MANDALA_INBOX);
+        }
+        catch (error) {
+            return {
+                received,
+                skipped,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        for (const msg of messages) {
+            try {
+                let env;
+                try {
+                    env = decodeEnvelope(msg.body);
+                }
+                catch {
+                    throw new Skip('not a DAG-CBOR BRC-169 envelope');
+                }
+                if (!(await verifyEnvelope(env))) {
+                    throw new Skip('envelope signature does not verify');
+                }
+                const sender = bytesHex(env.sender.identityKey, 33, 'sender');
+                const plaintext = await decryptBrc78(ctx.wallet, env.content, sender);
+                if (env.contentHash !== undefined &&
+                    Utils.toHex(Hash.sha256(plaintext)) !==
+                        Utils.toHex(Array.from(env.contentHash))) {
+                    throw new Skip('contentHash does not match the content');
+                }
+                const entity = parseMimeEntity(plaintext);
+                if (mediaType(entity.contentType) !== TRANSACTION_CBOR_CONTENT_TYPE) {
+                    throw new Skip(`unsupported content type ${entity.contentType}`);
+                }
+                const plan = planInternalize(dagCborDecode(entity.body));
+                await ctx.wallet.internalizeAction({
+                    tx: plan.tx,
+                    outputs: plan.outputs,
+                    ...(plan.labels.length && { labels: plan.labels }),
+                    description: plan.tokenIds.length
+                        ? 'Receive Mandala tokens'
+                        : 'Receive delivered outputs',
+                });
+                acknowledged.push(msg.messageId);
+                received.push({
+                    messageId: msg.messageId,
+                    txid: plan.txid,
+                    tokenIds: plan.tokenIds,
+                });
+            }
+            catch (error) {
+                skipped.push({
+                    messageId: msg.messageId,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        if (acknowledged.length > 0) {
+            try {
+                await messageRelay.acknowledgeCborMessages(ctx.wallet, messagebox, acknowledged);
+            }
+            catch (error) {
+                return {
+                    received,
+                    skipped,
+                    error: `acknowledge-failed: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        return { received, skipped };
+    },
+};
+//# sourceMappingURL=receive.js.map

package/dist/mandala/receive.js.map

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

package/dist/mandala/relay.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 Mandala actions make, 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/mandala/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/mandala/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;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;CAIxB,CAAA"}

package/dist/mandala/relay.js

@@ -0,0 +1,50 @@
+/**
+ * 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 Mandala actions make, 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/mandala/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../src/mandala/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;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,eAAe;IACf,gBAAgB;IAChB,uBAAuB;CACvB,CAAA"}

package/dist/mandala/send.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Mandala (BRC-162) send to a BRC-169 handle, delivered per BRC-232.
+ *
+ * 1. Resolve the handle (`resolveHandle`): identity key + messagebox.
+ * 2. When no single token output in `mandala <txid> <vout>` holds exactly `amount`,
+ *    split first: an ordinary, broadcast action spending token outputs into
+ *    an exact-`amount` output and a remainder, both back to the wallet under
+ *    `mandalaProtocol(tokenId)` in the token's basket.
+ * 3. The protected send: one `createAction` spending only the exact output,
+ *    with one output, the recipient's token output, locked to the key
+ *    derived under `mandalaProtocol(tokenId)` with keyID
+ *    `<derivationPrefix> <derivationSuffix>` (fresh random base64) and
+ *    counterparty = the recipient. `noSend`, labels `mandala`,
+ *    `mandala <txid> <vout>` and `p nosend expiry seconds <n>` (BRC-177; the wallet
+ *    funds it). It is not broadcast: the recipient broadcasts by
+ *    internalizing (BRC-169 §6.1, BRC-232 rule 4).
+ * 4. Delivery: a signed BRC-169 §7.3 envelope (DAG-CBOR, BRC-231 body over
+ *    BRC-104) to the resolved messagebox, box `mandala_inbox`, `payment:
+ *    null`. `content` is BRC-78 encryption (via `wallet.encrypt`) of a MIME
+ *    entity of type `application/vnd.metanet.transaction+cbor` whose DAG-CBOR
+ *    body is the BRC-232 delivery `{ txid, beef, outputs: [ basket insertion
+ *    ] }`; `contentHash` is the SHA-256 of the MIME bytes.
+ *
+ * When delivery fails the result carries the error with `txid` and `tx`, so
+ * the caller can retry delivery or `abortAction` the send.
+ */
+import { type WalletProtocol } from '@bsv/sdk';
+import type { Action } from '../types.js';
+export interface SendMandalaInput {
+    /** Token: the deploy outpoint, BRC-36 `<txid>.<vout>` (`<txid>_<vout>` accepted) */
+    tokenId: string;
+    /** Amount in raw units */
+    amount: bigint | string;
+    /** BRC-169 handle: `@handle@domain` or `handle@domain` */
+    destination: {
+        handle: string;
+    };
+    /**
+     * BRC-177 `nosend expiry seconds` for the protected send (default
+     * {@link MANDALA_SEND_EXPIRY_SECONDS}, one year).
+     */
+    expirySeconds?: number;
+    /** Optional free text carried as the BRC-232 `memo` */
+    memo?: string;
+}
+export interface SendMandalaResult {
+    txid?: string;
+    /** Atomic BEEF of the send */
+    tx?: number[];
+    /** `envelope`: BRC-169 envelope to the handle's messagebox, not broadcast */
+    delivered?: 'envelope';
+    /** Messagebox message id */
+    messageId?: string;
+    error?: string;
+}
+/** A BRC-232 `basket insertion` output entry. */
+export interface MandalaDeliveryOutput {
+    outputIndex: number;
+    protocol: 'basket insertion';
+    protocolID: WalletProtocol;
+    keyID: string;
+    /** bstr(33): the key the recipient derives against (the sender's identity) */
+    counterparty: Uint8Array;
+}
+/** The BRC-232 DAG-CBOR body a Mandala send delivers. */
+export interface MandalaDeliveryBody {
+    memo?: string;
+    /** bstr(32), display byte order (as in the BRC-95 Atomic BEEF header) */
+    txid: Uint8Array;
+    beef: Uint8Array;
+    outputs: MandalaDeliveryOutput[];
+}
+export declare const sendMandala: Action<SendMandalaInput, SendMandalaResult>;
+//# sourceMappingURL=send.d.ts.map

package/dist/mandala/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/mandala/send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAaH,OAAO,EAQN,KAAK,cAAc,EACnB,MAAM,UAAU,CAAA;AAEjB,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAA;AAYxD,MAAM,WAAW,gBAAgB;IAChC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,0DAA0D;IAC1D,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,6EAA6E;IAC7E,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,UAAU,EAAE,cAAc,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,YAAY,EAAE,UAAU,CAAA;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAmMD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAgLnE,CAAA"}