@1sat/wallet-toolbox 0.0.25 → 0.0.27

package/dist/api/inscriptions/index.js

@@ -61,6 +61,11 @@ export const inscribe = {
             });
             const address = PublicKey.fromString(publicKey).toAddress();
             const lockingScript = buildInscriptionScript(address, input.base64Content, input.contentType);
+            // Build tags - type is always included, name from MAP if provided
+            const tags = [`type:${input.contentType}`];
+            if (input.map?.name) {
+                tags.push(`name:${input.map.name}`);
+            }
             const result = await ctx.wallet.createAction({
                 description: "Create inscription",
                 outputs: [
@@ -69,10 +74,11 @@ export const inscribe = {
                         satoshis: 1,
                         outputDescription: "Inscription",
                         basket: ORDINALS_BASKET,
-                        tags: [`type:${input.contentType}`],
+                        tags,
                         customInstructions: JSON.stringify({
                             protocolID: ONESAT_PROTOCOL,
                             keyID,
+                            ...(input.map?.name && { name: input.map.name.slice(0, 64) }),
                         }),
                     },
                 ],

package/dist/api/ordinals/index.d.ts

@@ -36,6 +36,8 @@ export interface PurchaseOrdinalRequest {
     contentType?: string;
     /** Optional origin outpoint - looked up from ordfs API if not provided */
     origin?: string;
+    /** Optional name from MAP metadata - looked up from ordfs API if not provided */
+    name?: string;
 }
 export interface OrdinalOperationResponse {
     txid?: string;

package/dist/api/ordinals/index.js

@@ -8,6 +8,20 @@ import { BigNumber, Hash, LockingScript, OP, P2PKH, PublicKey, Script, Transacti
 import { OrdLock } from "@bopen-io/templates";
 import { ORDINALS_BASKET, ORDLOCK_PREFIX, ORDLOCK_SUFFIX, ONESAT_PROTOCOL } from "../constants";
 // ============================================================================
+// Helpers
+// ============================================================================
+function extractName(customInstructions) {
+    if (!customInstructions)
+        return undefined;
+    try {
+        const parsed = JSON.parse(customInstructions);
+        return parsed.name;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ============================================================================
 // Internal helpers
 // ============================================================================
 async function deriveCancelAddressInternal(ctx, outpoint) {
@@ -107,12 +121,23 @@ export async function buildTransferOrdinal(ctx, request) {
     }
     const result = await ctx.wallet.listOutputs({
         basket: ORDINALS_BASKET,
+        includeTags: true,
+        includeCustomInstructions: true,
         include: "locking scripts",
         limit: 10000,
     });
-    if (!result.outputs.find((o) => o.outpoint === outpoint)) {
+    const sourceOutput = result.outputs.find((o) => o.outpoint === outpoint);
+    if (!sourceOutput) {
         return { error: "ordinal-not-found" };
     }
+    // Preserve important tags from source output
+    const tags = [];
+    for (const tag of sourceOutput.tags ?? []) {
+        if (tag.startsWith("type:") || tag.startsWith("origin:") || tag.startsWith("name:")) {
+            tags.push(tag);
+        }
+    }
+    const sourceName = extractName(sourceOutput.customInstructions);
     return {
         description: "Transfer ordinal",
         inputs: [{ outpoint, inputDescription: "Ordinal to transfer" }],
@@ -121,6 +146,13 @@ export async function buildTransferOrdinal(ctx, request) {
                 lockingScript: new P2PKH().lock(recipientAddress).toHex(),
                 satoshis: 1,
                 outputDescription: "Ordinal transfer",
+                basket: ORDINALS_BASKET,
+                tags,
+                customInstructions: JSON.stringify({
+                    protocolID: ONESAT_PROTOCOL,
+                    keyID: outpoint,
+                    ...(sourceName && { name: sourceName }),
+                }),
             },
         ],
     };
@@ -138,6 +170,7 @@ export async function buildListOrdinal(ctx, request) {
     const result = await ctx.wallet.listOutputs({
         basket: ORDINALS_BASKET,
         includeTags: true,
+        includeCustomInstructions: true,
         include: "locking scripts",
         limit: 10000,
     });
@@ -147,12 +180,16 @@ export async function buildListOrdinal(ctx, request) {
     }
     const typeTag = sourceOutput.tags?.find((t) => t.startsWith("type:"));
     const originTag = sourceOutput.tags?.find((t) => t.startsWith("origin:"));
+    const nameTag = sourceOutput.tags?.find((t) => t.startsWith("name:"));
     const originOutpoint = originTag ? originTag.slice(7) : outpoint;
+    const sourceName = extractName(sourceOutput.customInstructions);
     const cancelAddress = await deriveCancelAddressInternal(ctx, outpoint);
     const lockingScript = buildOrdLockScript(cancelAddress, payAddress, price);
     const tags = ["ordlock", `origin:${originOutpoint}`, `price:${price}`];
     if (typeTag)
         tags.push(typeTag);
+    if (nameTag)
+        tags.push(nameTag);
     return {
         description: `List ordinal for ${price} sats`,
         inputs: [{ outpoint, inputDescription: "Ordinal to list" }],
@@ -166,6 +203,7 @@ export async function buildListOrdinal(ctx, request) {
                 customInstructions: JSON.stringify({
                     protocolID: ONESAT_PROTOCOL,
                     keyID: outpoint,
+                    ...(sourceName && { name: sourceName }),
                 }),
             },
         ],
@@ -328,15 +366,18 @@ export const cancelListing = {
             if (!listing.customInstructions) {
                 return { error: "missing-custom-instructions" };
             }
-            const { protocolID, keyID } = JSON.parse(listing.customInstructions);
+            const { protocolID, keyID, name: listingName } = JSON.parse(listing.customInstructions);
             const typeTag = listing.tags?.find((t) => t.startsWith("type:"));
             const originTag = listing.tags?.find((t) => t.startsWith("origin:"));
+            const nameTag = listing.tags?.find((t) => t.startsWith("name:"));
             const cancelAddress = await deriveCancelAddressInternal(ctx, keyID);
             const tags = [];
             if (typeTag)
                 tags.push(typeTag);
             if (originTag)
                 tags.push(originTag);
+            if (nameTag)
+                tags.push(nameTag);
             const createResult = await ctx.wallet.createAction({
                 description: "Cancel ordinal listing",
                 inputs: [
@@ -353,7 +394,7 @@ export const cancelListing = {
                         outputDescription: "Cancelled listing",
                         basket: ORDINALS_BASKET,
                         tags,
-                        customInstructions: JSON.stringify({ protocolID, keyID }),
+                        customInstructions: JSON.stringify({ protocolID, keyID, ...(listingName && { name: listingName }) }),
                     },
                 ],
                 options: { signAndProcess: false, randomizeOutputs: false },
@@ -454,11 +495,18 @@ export const purchaseOrdinal = {
             }
             const [txid, voutStr] = parts;
             const vout = Number.parseInt(voutStr, 10);
-            let { contentType, origin } = input;
-            if (!contentType || !origin) {
+            let { contentType, origin, name } = input;
+            if (!contentType || !origin || name === undefined) {
                 const metadata = await ctx.services.ordfs.getMetadata(outpoint);
                 contentType = contentType ?? metadata.contentType;
                 origin = origin ?? metadata.origin ?? outpoint;
+                // Extract name from map.name or map.subTypeData.name
+                if (name === undefined && metadata.map) {
+                    const mapName = metadata.map.name;
+                    const subTypeData = metadata.map.subTypeData;
+                    name = (typeof mapName === "string" ? mapName : undefined) ??
+                        (typeof subTypeData?.name === "string" ? subTypeData.name : undefined);
+                }
             }
             const beef = await ctx.services.getBeefForTxid(txid);
             const listingBeefTx = beef.findTxid(txid);
@@ -482,15 +530,19 @@ export const purchaseOrdinal = {
             const ourOrdAddress = PublicKey.fromString(publicKey).toAddress();
             const outputs = [];
             const p2pkh = new P2PKH();
+            const purchaseTags = [`type:${contentType}`, `origin:${origin}`];
+            if (name)
+                purchaseTags.push(`name:${name}`);
             outputs.push({
                 lockingScript: p2pkh.lock(ourOrdAddress).toHex(),
                 satoshis: 1,
                 outputDescription: "Purchased ordinal",
                 basket: ORDINALS_BASKET,
-                tags: [`type:${contentType}`, `origin:${origin}`],
+                tags: purchaseTags,
                 customInstructions: JSON.stringify({
                     protocolID: ONESAT_PROTOCOL,
                     keyID: outpoint,
+                    ...(name && { name: name.slice(0, 64) }),
                 }),
             });
             const payoutReader = new Utils.Reader(ordLockData.payout);

package/dist/api/sweep/index.js

@@ -244,6 +244,7 @@ export const sweepOrdinals = {
                             lockingScript: { type: "string", description: "Locking script hex" },
                             contentType: { type: "string", description: "Content type from metadata" },
                             origin: { type: "string", description: "Origin outpoint" },
+                            name: { type: "string", description: "Name from MAP metadata" },
                         },
                         required: ["outpoint", "satoshis", "lockingScript"],
                     },
@@ -316,6 +317,7 @@ export const sweepOrdinals = {
                     customInstructions: JSON.stringify({
                         protocolID: ONESAT_PROTOCOL,
                         keyID: input.outpoint,
+                        ...(input.name && { name: input.name.slice(0, 64) }),
                     }),
                 });
             }

package/dist/api/sweep/types.d.ts

@@ -34,6 +34,8 @@ export interface SweepOrdinalInput extends SweepInput {
     contentType?: string;
     /** Origin outpoint for tracking */
     origin?: string;
+    /** Name from MAP metadata */
+    name?: string;
 }
 /** Request to sweep ordinals */
 export interface SweepOrdinalsRequest {

package/dist/sync/SyncManager.js

@@ -352,17 +352,18 @@ export class SyncProcessor {
             // These outputs need custom unlock scripts when spent
             const basket = txo.basket || "custom";
             const tags = this.collectTags(txo);
+            const nameTag = tags.find((t) => t.startsWith("name:"));
             return {
                 outputIndex: vout,
                 protocol: "basket insertion",
                 insertionRemittance: {
                     basket,
                     tags,
-                    // Store derivation info for future signing
                     customInstructions: JSON.stringify({
                         derivationPrefix: derivation.derivationPrefix,
                         derivationSuffix: derivation.derivationSuffix,
                         senderIdentityKey: derivation.senderIdentityKey,
+                        ...(nameTag && { name: nameTag.slice(5).slice(0, 64) }),
                     }),
                 },
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1sat/wallet-toolbox",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "BSV wallet library extending @bsv/wallet-toolbox with 1Sat Ordinals protocol support",
   "author": "1Sat Team",
   "license": "MIT",