@1sat/actions 0.0.197 → 0.0.199

package/dist/utils/stampBsv21OutputCi.js

@@ -0,0 +1,90 @@
+/**
+ * Authoritative BSV-21 CI stamp — shared by local apply and module embellish.
+ *
+ * For each output that already has CI and a BSV-21 locking script:
+ * - Start from caller CI (keep derivation / extras)
+ * - Overwrite load-bearing fields from script + spent-input carry
+ * - Preserve encryption state: plaintext in → plaintext out; ciphertext in →
+ *   peel → merge → re-encrypt (WPM encrypts before module onRequest)
+ */
+import { BSV21_BASKET, parseInputAssetLabels } from '@1sat/types';
+import { BSV21 } from '@1sat/templates';
+import { Script, } from '@bsv/sdk';
+import { bsv21FieldsFromOutput, overwriteBsv21CiFields, } from './bsv21Remittance';
+import { loadBasketOutput } from './loadBasketOutput';
+import { encryptWalletMetadataCi, ensurePlaintextCi, looksLikeJson, } from './walletMetadataCi';
+async function carryFieldsFromInputs(wallet, labels) {
+    const out = new Map();
+    const refs = parseInputAssetLabels(labels ?? []).filter((r) => r.basket === BSV21_BASKET);
+    for (const ref of refs) {
+        const loaded = await loadBasketOutput(wallet, BSV21_BASKET, ref.id);
+        if ('error' in loaded)
+            continue;
+        const f = bsv21FieldsFromOutput({
+            tags: loaded.output.tags,
+            customInstructions: loaded.output.customInstructions,
+            outpoint: loaded.output.outpoint,
+        });
+        if (!f.tokenId)
+            continue;
+        out.set(f.tokenId, {
+            ...(f.tokenId && { id: f.tokenId }),
+            ...(f.sym && { sym: f.sym }),
+            ...(f.dec && { dec: f.dec }),
+            ...(f.icon && { icon: f.icon }),
+        });
+    }
+    return out;
+}
+/**
+ * Overwrite BSV-21 token fields on output CI from script + input carry.
+ * Call from {@link applyP1SatCreateAction} so local and module paths share it.
+ */
+export async function stampBsv21OutputCustomInstructions(wallet, args) {
+    const outputs = args.outputs;
+    if (!outputs?.length)
+        return;
+    const carry = await carryFieldsFromInputs(wallet, args.labels);
+    for (const out of outputs) {
+        const raw = out.customInstructions;
+        if (!raw || !out.lockingScript)
+            continue;
+        let script;
+        try {
+            script = Script.fromHex(out.lockingScript);
+        }
+        catch {
+            continue;
+        }
+        const decoded = BSV21.decode(script);
+        if (!decoded)
+            continue;
+        const td = decoded.tokenData;
+        const tokenId = typeof td.id === 'string' ? td.id : undefined;
+        const fromInput = tokenId ? carry.get(tokenId) : undefined;
+        const auth = {
+            ...(tokenId && { id: tokenId }),
+            ...(td.amt != null && td.amt !== '' && { amt: String(td.amt) }),
+            ...(td.op && { op: td.op }),
+            ...(td.sym && { sym: td.sym }),
+            ...(td.dec !== undefined && td.dec !== null && { dec: td.dec }),
+            ...(td.icon && { icon: td.icon }),
+        };
+        if (!auth.sym && fromInput?.sym)
+            auth.sym = fromInput.sym;
+        if (auth.dec === undefined && fromInput?.dec !== undefined) {
+            auth.dec = fromInput.dec;
+        }
+        if (!auth.icon && fromInput?.icon)
+            auth.icon = fromInput.icon;
+        const wasEncrypted = !looksLikeJson(raw);
+        const plain = await ensurePlaintextCi(wallet, raw);
+        if (!plain || !looksLikeJson(plain))
+            continue;
+        const merged = overwriteBsv21CiFields(plain, auth);
+        out.customInstructions = wasEncrypted
+            ? await encryptWalletMetadataCi(wallet, merged)
+            : merged;
+    }
+}
+//# sourceMappingURL=stampBsv21OutputCi.js.map

package/dist/utils/stampBsv21OutputCi.js.map

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

package/dist/utils/stampOrdinalOutputCi.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Authoritative ordinal/OpNS CI stamp — shared by local apply and module.
+ *
+ * For basketed outs with CI on `1sat` / `opns`:
+ * - Start from caller CI (keep derivation)
+ * - Overwrite origin/content/app/collection/name from output tags + spent inputs
+ * - Preserve encryption state (plaintext vs WPM ciphertext)
+ */
+import type { CreateActionArgs, WalletInterface } from '@bsv/sdk';
+/**
+ * Overwrite ordinal/OpNS remittance on output CI from tags + input carry.
+ * Call from {@link applyP1SatCreateAction}.
+ */
+export declare function stampOrdinalOutputCustomInstructions(wallet: WalletInterface, args: CreateActionArgs): Promise<void>;
+//# sourceMappingURL=stampOrdinalOutputCi.d.ts.map

package/dist/utils/stampOrdinalOutputCi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stampOrdinalOutputCi.d.ts","sourceRoot":"","sources":["../../src/utils/stampOrdinalOutputCi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAyEjE;;;GAGG;AACH,wBAAsB,oCAAoC,CACzD,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/utils/stampOrdinalOutputCi.js

@@ -0,0 +1,103 @@
+/**
+ * Authoritative ordinal/OpNS CI stamp — shared by local apply and module.
+ *
+ * For basketed outs with CI on `1sat` / `opns`:
+ * - Start from caller CI (keep derivation)
+ * - Overwrite origin/content/app/collection/name from output tags + spent inputs
+ * - Preserve encryption state (plaintext vs WPM ciphertext)
+ */
+import { ONESAT_BASKET, OPNS_BASKET, ORDINALS_BASKET, parseInputAssetLabels, } from '@1sat/types';
+import { loadBasketOutput } from './loadBasketOutput';
+import { overwriteOrdinalCiFields, remittanceFromOrdinalTags, } from './ordinalRemittance';
+import { encryptWalletMetadataCi, ensurePlaintextCi, looksLikeJson, } from './walletMetadataCi';
+const COLLECTABLE_BASKETS = new Set([
+    ONESAT_BASKET,
+    ORDINALS_BASKET,
+    OPNS_BASKET,
+]);
+async function carryFromInputs(wallet, labels) {
+    const out = new Map();
+    const refs = parseInputAssetLabels(labels ?? []).filter((r) => COLLECTABLE_BASKETS.has(r.basket));
+    for (const ref of refs) {
+        const loaded = await loadBasketOutput(wallet, ref.basket, ref.id);
+        if ('error' in loaded)
+            continue;
+        const fromTags = remittanceFromOrdinalTags(loaded.output.tags);
+        let fromCi = {};
+        const ci = loaded.output.customInstructions;
+        if (ci && looksLikeJson(ci)) {
+            try {
+                const o = JSON.parse(ci);
+                fromCi = {
+                    ...(typeof o.origin === 'string' && { origin: o.origin }),
+                    ...(typeof o.content === 'string' && { content: o.content }),
+                    ...(typeof o.app === 'string' && { app: o.app }),
+                    ...(typeof o.collection === 'string' && {
+                        collection: o.collection,
+                    }),
+                    ...(typeof o.name === 'string' && { name: o.name }),
+                };
+            }
+            catch {
+                // ignore
+            }
+        }
+        // CI preferred, tags fill gaps (same as BSV-21 read order).
+        out.set(`${ref.basket}:${ref.id}`, {
+            ...fromTags,
+            ...fromCi,
+        });
+    }
+    return out;
+}
+function mergeAuth(fromTags, fromInputs) {
+    const auth = { ...fromTags };
+    for (const inp of fromInputs) {
+        if (!auth.origin && inp.origin)
+            auth.origin = inp.origin;
+        if (!auth.content && inp.content)
+            auth.content = inp.content;
+        if (!auth.app && inp.app)
+            auth.app = inp.app;
+        if (!auth.collection && inp.collection)
+            auth.collection = inp.collection;
+        if (!auth.name && inp.name)
+            auth.name = inp.name;
+    }
+    return auth;
+}
+/**
+ * Overwrite ordinal/OpNS remittance on output CI from tags + input carry.
+ * Call from {@link applyP1SatCreateAction}.
+ */
+export async function stampOrdinalOutputCustomInstructions(wallet, args) {
+    const outputs = args.outputs;
+    if (!outputs?.length)
+        return;
+    const carry = await carryFromInputs(wallet, args.labels);
+    const carried = [...carry.values()];
+    for (const out of outputs) {
+        const raw = out.customInstructions;
+        const basket = out.basket?.trim().toLowerCase();
+        if (!raw || !basket || !COLLECTABLE_BASKETS.has(basket))
+            continue;
+        const fromTags = remittanceFromOrdinalTags(out.tags);
+        const auth = mergeAuth(fromTags, carried);
+        if (!auth.origin &&
+            !auth.content &&
+            !auth.app &&
+            !auth.collection &&
+            !auth.name) {
+            continue;
+        }
+        const wasEncrypted = !looksLikeJson(raw);
+        const plain = await ensurePlaintextCi(wallet, raw);
+        if (!plain || !looksLikeJson(plain))
+            continue;
+        const merged = overwriteOrdinalCiFields(plain, auth);
+        out.customInstructions = wasEncrypted
+            ? await encryptWalletMetadataCi(wallet, merged)
+            : merged;
+    }
+}
+//# sourceMappingURL=stampOrdinalOutputCi.js.map

package/dist/utils/stampOrdinalOutputCi.js.map

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

package/dist/utils/walletMetadataCi.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Single codec for WPM `encryptWalletMetadata` customInstructions.
+ *
+ * Contract for the actions layer:
+ * - Storage may hold base64 ciphertext (base wallet list) or plaintext JSON
+ *   (after WPM list decrypt, or encrypt off).
+ * - Every read path normalizes to plaintext JSON via {@link ensurePlaintextCi}.
+ * - Write paths hand plaintext to WPM createAction/internalize (WPM encrypts),
+ *   except module onRequest which runs *after* WPM encrypt and must
+ *   re-encrypt via {@link encryptWalletMetadataCi} when it mutates CI.
+ */
+import { type WalletInterface } from '@bsv/sdk';
+/** Same protocol WPM uses for description/CI encryption. */
+export declare const METADATA_ENCRYPTION_PROTOCOL: [2, string];
+export declare function looksLikeJson(value: string): boolean;
+/**
+ * Normalize CI to plaintext JSON when possible.
+ * Peels WPM layers (including legacy double-encrypt) until JSON or give up.
+ */
+export declare function ensurePlaintextCi(wallet: WalletInterface, value: string | undefined): Promise<string | undefined>;
+/** Encrypt plaintext CI the way WPM does at rest. */
+export declare function encryptWalletMetadataCi(wallet: WalletInterface, plaintext: string): Promise<string>;
+//# sourceMappingURL=walletMetadataCi.d.ts.map

package/dist/utils/walletMetadataCi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletMetadataCi.d.ts","sourceRoot":"","sources":["../../src/utils/walletMetadataCi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAEtD,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,EAAE,MAAM,CAGpD,CAAA;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOpD;AAmBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,qDAAqD;AACrD,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/dist/utils/walletMetadataCi.js

@@ -0,0 +1,70 @@
+/**
+ * Single codec for WPM `encryptWalletMetadata` customInstructions.
+ *
+ * Contract for the actions layer:
+ * - Storage may hold base64 ciphertext (base wallet list) or plaintext JSON
+ *   (after WPM list decrypt, or encrypt off).
+ * - Every read path normalizes to plaintext JSON via {@link ensurePlaintextCi}.
+ * - Write paths hand plaintext to WPM createAction/internalize (WPM encrypts),
+ *   except module onRequest which runs *after* WPM encrypt and must
+ *   re-encrypt via {@link encryptWalletMetadataCi} when it mutates CI.
+ */
+import { Utils } from '@bsv/sdk';
+/** Same protocol WPM uses for description/CI encryption. */
+export const METADATA_ENCRYPTION_PROTOCOL = [
+    2,
+    'admin metadata encryption',
+];
+const MAX_PEEL = 3;
+export function looksLikeJson(value) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function tryDecryptOnce(wallet, value) {
+    try {
+        const { plaintext } = await wallet.decrypt({
+            ciphertext: Utils.toArray(value, 'base64'),
+            protocolID: METADATA_ENCRYPTION_PROTOCOL,
+            keyID: '1',
+            counterparty: 'self',
+        });
+        return Utils.toUTF8(plaintext);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Normalize CI to plaintext JSON when possible.
+ * Peels WPM layers (including legacy double-encrypt) until JSON or give up.
+ */
+export async function ensurePlaintextCi(wallet, value) {
+    if (value == null || value === '')
+        return undefined;
+    let cur = value;
+    for (let i = 0; i < MAX_PEEL; i++) {
+        if (looksLikeJson(cur))
+            return cur;
+        const next = await tryDecryptOnce(wallet, cur);
+        if (next == null || next === cur)
+            return cur;
+        cur = next;
+    }
+    return cur;
+}
+/** Encrypt plaintext CI the way WPM does at rest. */
+export async function encryptWalletMetadataCi(wallet, plaintext) {
+    const { ciphertext } = await wallet.encrypt({
+        plaintext: Utils.toArray(plaintext, 'utf8'),
+        protocolID: METADATA_ENCRYPTION_PROTOCOL,
+        keyID: '1',
+        counterparty: 'self',
+    });
+    return Utils.toBase64(ciphertext);
+}
+//# sourceMappingURL=walletMetadataCi.js.map

package/dist/utils/walletMetadataCi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletMetadataCi.js","sourceRoot":"","sources":["../../src/utils/walletMetadataCi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAwB,MAAM,UAAU,CAAA;AAEtD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAgB;IACxD,CAAC;IACD,2BAA2B;CAC3B,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,CAAA;AAElB,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,IAAI,CAAC;QACJ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,KAAK,UAAU,cAAc,CAC5B,MAAuB,EACvB,KAAa;IAEb,IAAI,CAAC;QACJ,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAC1C,UAAU,EAAE,4BAA4B;YACxC,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,MAAM;SACpB,CAAC,CAAA;QACF,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAA;IACjB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,MAAuB,EACvB,KAAyB;IAEzB,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IACnD,IAAI,GAAG,GAAG,KAAK,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAA;QAClC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAC9C,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,GAAG,CAAA;QAC5C,GAAG,GAAG,IAAI,CAAA;IACX,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAuB,EACvB,SAAiB;IAEjB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3C,UAAU,EAAE,4BAA4B;QACxC,KAAK,EAAE,GAAG;QACV,YAAY,EAAE,MAAM;KACpB,CAAC,CAAA;IACF,OAAO,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1sat/actions",
-  "version": "0.0.197",
+  "version": "0.0.199",
   "description": "Action definitions for the 1Sat SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,11 +29,11 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@1sat/client": "0.0.49",
-    "@1sat/types": "0.0.39",
-    "@1sat/utils": "0.0.32",
-    "@1sat/wallet": "0.0.103",
-    "@1sat/templates": "0.0.30",
+    "@1sat/client": "0.0.50",
+    "@1sat/types": "0.0.40",
+    "@1sat/utils": "0.0.33",
+    "@1sat/wallet": "0.0.104",
+    "@1sat/templates": "0.0.31",
     "@bsv/message-box-client": "^2.2.1"
   },
   "peerDependencies": {
@@ -42,6 +42,6 @@
   "devDependencies": {
     "@bsv/sdk": "^2.1.9",
     "typescript": "^5.9.3",
-    "@1sat/wallet-remote": "0.0.60"
+    "@1sat/wallet-remote": "0.0.61"
   }
 }