@aibtc/mcp-server 1.40.0 → 1.41.0

package/dist/tools/souldinals.tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Souldinals tools
+ *
+ * MCP tools for managing Souldinals — soul.md files inscribed as child ordinal
+ * inscriptions on Bitcoin L1. Provides:
+ *
+ * - souldinals_inscribe_soul: Step 1 — Broadcast commit tx for a soul child inscription
+ * - souldinals_reveal_soul: Step 2 — Broadcast reveal tx after commit confirms
+ * - souldinals_list_souls: List soul inscriptions (text/markdown) owned by a Taproot address
+ * - souldinals_load_soul: Load the oldest soul inscription content from a Taproot address
+ * - souldinals_display_soul: Fetch and parse soul traits from a specific inscription
+ *
+ * Uses child inscription builders for on-chain provenance (parent-child relationship)
+ * and Unisat Ordinals API for listing/loading inscriptions.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSouldinalsTools(server: McpServer): void;
+//# sourceMappingURL=souldinals.tools.d.ts.map

package/dist/tools/souldinals.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"souldinals.tools.d.ts","sourceRoot":"","sources":["../../src/tools/souldinals.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2QpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkf/D"}

package/dist/tools/souldinals.tools.js

@@ -0,0 +1,551 @@
+/**
+ * Souldinals tools
+ *
+ * MCP tools for managing Souldinals — soul.md files inscribed as child ordinal
+ * inscriptions on Bitcoin L1. Provides:
+ *
+ * - souldinals_inscribe_soul: Step 1 — Broadcast commit tx for a soul child inscription
+ * - souldinals_reveal_soul: Step 2 — Broadcast reveal tx after commit confirms
+ * - souldinals_list_souls: List soul inscriptions (text/markdown) owned by a Taproot address
+ * - souldinals_load_soul: Load the oldest soul inscription content from a Taproot address
+ * - souldinals_display_soul: Fetch and parse soul traits from a specific inscription
+ *
+ * Uses child inscription builders for on-chain provenance (parent-child relationship)
+ * and Unisat Ordinals API for listing/loading inscriptions.
+ */
+import { z } from "zod";
+import { NETWORK } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+import { MempoolApi, getMempoolTxUrl } from "../services/mempool-api.js";
+import { getWalletManager } from "../services/wallet-manager.js";
+import { signBtcTransaction } from "../transactions/bitcoin-builder.js";
+import { buildChildCommitTransaction, buildChildRevealTransaction, deriveChildRevealScript, lookupParentInscription, } from "../transactions/child-inscription-builder.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SOUL_CONTENT_TYPE = "text/markdown";
+const UNISAT_API_BASE = "https://open-api.unisat.io";
+// ---------------------------------------------------------------------------
+// Unisat API helpers
+// ---------------------------------------------------------------------------
+function unisatHeaders() {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (process.env.UNISAT_API_KEY) {
+        headers["Authorization"] = `Bearer ${process.env.UNISAT_API_KEY}`;
+    }
+    return headers;
+}
+/**
+ * Fetch soul inscriptions (text/markdown) for a Taproot address from Unisat.
+ */
+async function fetchSoulInscriptions(address) {
+    const url = `${UNISAT_API_BASE}/v1/indexer/address/${address}/inscription-data?cursor=0&size=60`;
+    const response = await fetch(url, { headers: unisatHeaders() });
+    if (!response.ok) {
+        throw new Error(`Unisat API error ${response.status}: ${await response.text()}`);
+    }
+    const data = (await response.json());
+    const items = data.data?.inscription ?? [];
+    return items
+        .filter((item) => item.contentType === SOUL_CONTENT_TYPE)
+        .map((item) => ({
+        id: item.inscriptionId,
+        number: item.inscriptionNumber,
+        contentType: item.contentType,
+        contentLength: item.contentLength,
+        timestamp: new Date(item.timestamp * 1000).toISOString(),
+        genesisBlockHeight: item.genesisBlockHeight,
+    }));
+}
+/**
+ * Fetch raw inscription content from Unisat.
+ */
+async function fetchInscriptionContent(inscriptionId) {
+    const url = `${UNISAT_API_BASE}/v1/indexer/inscription/content/${encodeURIComponent(inscriptionId)}`;
+    const response = await fetch(url, { headers: unisatHeaders() });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch inscription content (${response.status}): ${await response.text()}`);
+    }
+    return await response.text();
+}
+/**
+ * Fetch inscription metadata from Unisat.
+ */
+async function fetchInscriptionMetadata(inscriptionId) {
+    const url = `${UNISAT_API_BASE}/v1/indexer/inscription/info/${encodeURIComponent(inscriptionId)}`;
+    const response = await fetch(url, { headers: unisatHeaders() });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch inscription metadata (${response.status}): ${await response.text()}`);
+    }
+    const data = (await response.json());
+    const item = data.data;
+    return {
+        contentType: item.contentType,
+        contentLength: item.contentLength,
+        timestamp: new Date(item.timestamp * 1000).toISOString(),
+        genesisBlockHeight: item.genesisBlockHeight,
+    };
+}
+/**
+ * Parse soul traits from Markdown content.
+ * Extracts name (first H1), description (first paragraph after H1),
+ * values (list items under "Values" or "Core Values" heading),
+ * focus areas (list items under "Focus" or "Focus Areas" heading),
+ * and all named sections.
+ */
+function parseSoulTraits(markdown) {
+    const lines = markdown.split("\n");
+    let name;
+    let description;
+    const sections = {};
+    const values = [];
+    const focusAreas = [];
+    let currentSection = null;
+    let sectionLines = [];
+    let afterFirstH1 = false;
+    const descriptionLines = [];
+    let inDescriptionBlock = false;
+    for (const line of lines) {
+        // H1 heading — treat as name
+        if (line.startsWith("# ")) {
+            if (currentSection !== null) {
+                sections[currentSection] = sectionLines.join("\n").trim();
+                sectionLines = [];
+            }
+            if (!name) {
+                name = line.replace(/^# /, "").trim();
+                afterFirstH1 = true;
+                inDescriptionBlock = true;
+            }
+            else {
+                currentSection = line.replace(/^# /, "").trim();
+            }
+            continue;
+        }
+        // H2/H3 headings — section boundaries
+        if (line.startsWith("## ") || line.startsWith("### ")) {
+            if (currentSection !== null) {
+                sections[currentSection] = sectionLines.join("\n").trim();
+            }
+            currentSection = line.replace(/^#{2,3} /, "").trim();
+            sectionLines = [];
+            inDescriptionBlock = false;
+            continue;
+        }
+        // Capture description (non-empty lines immediately after H1, before any heading)
+        if (afterFirstH1 && inDescriptionBlock && line.trim()) {
+            descriptionLines.push(line.trim());
+        }
+        else if (afterFirstH1 &&
+            inDescriptionBlock &&
+            !line.trim() &&
+            descriptionLines.length > 0) {
+            inDescriptionBlock = false;
+        }
+        // Accumulate section content
+        if (currentSection !== null) {
+            sectionLines.push(line);
+            const listMatch = line.match(/^[-*]\s+(.+)/);
+            if (listMatch) {
+                const item = listMatch[1].trim();
+                const sectionLower = currentSection.toLowerCase();
+                if (sectionLower.includes("value")) {
+                    values.push(item);
+                }
+                else if (sectionLower.includes("focus")) {
+                    focusAreas.push(item);
+                }
+            }
+        }
+    }
+    // Flush last section
+    if (currentSection !== null) {
+        sections[currentSection] = sectionLines.join("\n").trim();
+    }
+    if (descriptionLines.length > 0) {
+        description = descriptionLines.join(" ");
+    }
+    return { name, description, values, focusAreas, sections };
+}
+// ---------------------------------------------------------------------------
+// Fee rate resolver
+// ---------------------------------------------------------------------------
+async function resolveFeeRate(feeRate, mempoolApi) {
+    if (typeof feeRate === "number")
+        return feeRate;
+    const fees = await mempoolApi.getFeeEstimates();
+    switch (feeRate) {
+        case "fast":
+            return fees.fastestFee;
+        case "slow":
+            return fees.hourFee;
+        default:
+            return fees.halfHourFee;
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerSouldinalsTools(server) {
+    // --------------------------------------------------------------------------
+    // souldinals_inscribe_soul — Step 1: Broadcast commit tx
+    // --------------------------------------------------------------------------
+    server.registerTool("souldinals_inscribe_soul", {
+        description: "Inscribe a soul.md as a child inscription - STEP 1: Broadcast commit transaction.\n\n" +
+            "Creates a child inscription linked to a parent genesis inscription, establishing " +
+            "on-chain provenance per the Ordinals provenance spec. Content type is always text/markdown.\n\n" +
+            "You must own the parent inscription (it must be at your wallet's Taproot address).\n\n" +
+            "This broadcasts the commit tx and returns immediately. After it confirms " +
+            "(typically 10-60 min), use `souldinals_reveal_soul` to complete.\n\n" +
+            "Returns: commitTxid, revealAmount, contentBase64 (save all for souldinals_reveal_soul)",
+        inputSchema: {
+            parentInscriptionId: z
+                .string()
+                .describe("Genesis parent inscription ID (format: {txid}i{index}). You must own this inscription."),
+            soulContent: z
+                .string()
+                .describe("The soul.md content as a string (Markdown text). Will be inscribed as text/markdown."),
+            feeRate: z
+                .union([z.enum(["fast", "medium", "slow"]), z.number().positive()])
+                .optional()
+                .describe("Fee rate: 'fast' (~10 min), 'medium' (~30 min), 'slow' (~1 hr), or number in sat/vB (default: medium)"),
+        },
+    }, async ({ parentInscriptionId, soulContent, feeRate }) => {
+        try {
+            const walletManager = getWalletManager();
+            const sessionInfo = walletManager.getSessionInfo();
+            if (!sessionInfo) {
+                return createErrorResponse(new Error("Wallet not unlocked. Use wallet_unlock first."));
+            }
+            if (!sessionInfo.btcAddress || !sessionInfo.taprootAddress) {
+                return createErrorResponse(new Error("Wallet doesn't have Bitcoin addresses. Use a managed wallet."));
+            }
+            const account = walletManager.getAccount();
+            if (!account ||
+                !account.btcPrivateKey ||
+                !account.btcPublicKey ||
+                !account.taprootPrivateKey ||
+                !account.taprootPublicKey) {
+                return createErrorResponse(new Error("Bitcoin and Taproot keys not available. Wallet may not be unlocked."));
+            }
+            if (!soulContent.trim()) {
+                return createErrorResponse(new Error("Soul content cannot be empty."));
+            }
+            // Look up parent inscription and validate ownership
+            const parentInfo = await lookupParentInscription(parentInscriptionId);
+            if (parentInfo.address !== sessionInfo.taprootAddress) {
+                return createErrorResponse(new Error(`Parent inscription is owned by ${parentInfo.address}, but your Taproot address is ${sessionInfo.taprootAddress}. You must own the parent inscription.`));
+            }
+            // Encode soul content
+            const body = Buffer.from(soulContent, "utf-8");
+            const contentBase64 = body.toString("base64");
+            const inscription = {
+                contentType: SOUL_CONTENT_TYPE,
+                body,
+            };
+            const mempoolApi = new MempoolApi(NETWORK);
+            const actualFeeRate = await resolveFeeRate(feeRate, mempoolApi);
+            // Get UTXOs for funding
+            const utxos = await mempoolApi.getUtxos(sessionInfo.btcAddress);
+            if (utxos.length === 0) {
+                return createErrorResponse(new Error(`No UTXOs available for address ${sessionInfo.btcAddress}. Send some BTC first.`));
+            }
+            // Build and broadcast commit transaction
+            const commitResult = buildChildCommitTransaction({
+                utxos,
+                inscription,
+                parentInscriptionId,
+                feeRate: actualFeeRate,
+                senderPubKey: account.btcPublicKey,
+                senderAddress: sessionInfo.btcAddress,
+                network: NETWORK,
+            });
+            const commitSigned = signBtcTransaction(commitResult.tx, account.btcPrivateKey);
+            const commitTxid = await mempoolApi.broadcastTransaction(commitSigned.txHex);
+            const commitExplorerUrl = getMempoolTxUrl(commitTxid, NETWORK);
+            return createJsonResponse({
+                status: "commit_broadcast",
+                message: "Soul commit transaction broadcast successfully. " +
+                    "Wait for confirmation (typically 10-60 min), then call souldinals_reveal_soul to complete.",
+                commitTxid,
+                commitExplorerUrl,
+                revealAddress: commitResult.revealAddress,
+                revealAmount: commitResult.revealAmount,
+                commitFee: commitResult.fee,
+                feeRate: actualFeeRate,
+                parentInscriptionId,
+                parentUtxo: {
+                    txid: parentInfo.txid,
+                    vout: parentInfo.vout,
+                    value: parentInfo.value,
+                },
+                contentType: SOUL_CONTENT_TYPE,
+                contentSize: body.length,
+                contentBase64,
+                nextStep: "After commit confirms, call souldinals_reveal_soul with commitTxid, revealAmount, " +
+                    "contentBase64, and parentInscriptionId from this response.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // --------------------------------------------------------------------------
+    // souldinals_reveal_soul — Step 2: Broadcast reveal tx
+    // --------------------------------------------------------------------------
+    server.registerTool("souldinals_reveal_soul", {
+        description: "Complete a soul inscription - STEP 2: Broadcast reveal transaction.\n\n" +
+            "Call this AFTER the commit transaction from `souldinals_inscribe_soul` has confirmed.\n" +
+            "Provide the commitTxid, revealAmount, contentBase64, and parentInscriptionId " +
+            "from the commit step response.\n\n" +
+            "The reveal tx spends both the commit output and the parent inscription UTXO, " +
+            "returning the parent to your address and creating the child soul inscription.\n\n" +
+            "Returns: inscriptionId ({revealTxid}i0) on success",
+        inputSchema: {
+            commitTxid: z
+                .string()
+                .length(64)
+                .describe("Transaction ID of the confirmed commit transaction (from souldinals_inscribe_soul)"),
+            revealAmount: z
+                .number()
+                .positive()
+                .describe("Amount in the commit output (from souldinals_inscribe_soul response)"),
+            contentBase64: z
+                .string()
+                .describe("Base64-encoded soul.md content (from souldinals_inscribe_soul response)"),
+            parentInscriptionId: z
+                .string()
+                .describe("Parent inscription ID (must match the commit step)"),
+            feeRate: z
+                .union([z.enum(["fast", "medium", "slow"]), z.number().positive()])
+                .optional()
+                .describe("Fee rate for reveal tx (default: medium)"),
+        },
+    }, async ({ commitTxid, revealAmount, contentBase64, parentInscriptionId, feeRate, }) => {
+        try {
+            const walletManager = getWalletManager();
+            const sessionInfo = walletManager.getSessionInfo();
+            if (!sessionInfo) {
+                return createErrorResponse(new Error("Wallet not unlocked. Use wallet_unlock first."));
+            }
+            if (!sessionInfo.taprootAddress) {
+                return createErrorResponse(new Error("Wallet doesn't have Taproot address. Use a managed wallet."));
+            }
+            const account = walletManager.getAccount();
+            if (!account ||
+                !account.btcPrivateKey ||
+                !account.btcPublicKey ||
+                !account.taprootPrivateKey ||
+                !account.taprootPublicKey) {
+                return createErrorResponse(new Error("Bitcoin and Taproot keys not available. Wallet may not be unlocked."));
+            }
+            // Verify parent ownership
+            const parentInfo = await lookupParentInscription(parentInscriptionId);
+            if (parentInfo.address !== sessionInfo.taprootAddress) {
+                return createErrorResponse(new Error(`Parent inscription is no longer owned by your wallet. Current owner: ${parentInfo.address}`));
+            }
+            // Reconstruct the inscription
+            const body = Buffer.from(contentBase64, "base64");
+            const inscription = {
+                contentType: SOUL_CONTENT_TYPE,
+                body,
+            };
+            const mempoolApi = new MempoolApi(NETWORK);
+            const actualFeeRate = await resolveFeeRate(feeRate, mempoolApi);
+            // Derive the child reveal script deterministically
+            const p2trReveal = deriveChildRevealScript({
+                inscription,
+                parentInscriptionId,
+                senderPubKey: account.btcPublicKey,
+                network: NETWORK,
+            });
+            // Build child reveal transaction
+            const revealResult = buildChildRevealTransaction({
+                commitTxid,
+                commitVout: 0,
+                commitAmount: revealAmount,
+                revealScript: p2trReveal,
+                parentUtxo: {
+                    txid: parentInfo.txid,
+                    vout: parentInfo.vout,
+                    value: parentInfo.value,
+                },
+                parentOwnerTaprootInternalPubKey: account.taprootPublicKey,
+                recipientAddress: sessionInfo.taprootAddress,
+                feeRate: actualFeeRate,
+                network: NETWORK,
+            });
+            // Sign both inputs
+            revealResult.tx.sign(account.btcPrivateKey);
+            revealResult.tx.sign(account.taprootPrivateKey);
+            revealResult.tx.finalize();
+            const revealTxHex = revealResult.tx.hex;
+            const revealTxid = await mempoolApi.broadcastTransaction(revealTxHex);
+            const inscriptionId = `${revealTxid}i0`;
+            const revealExplorerUrl = getMempoolTxUrl(revealTxid, NETWORK);
+            const commitExplorerUrl = getMempoolTxUrl(commitTxid, NETWORK);
+            return createJsonResponse({
+                status: "success",
+                message: "Soul inscription created successfully!",
+                inscriptionId,
+                parentInscriptionId,
+                contentType: SOUL_CONTENT_TYPE,
+                contentSize: body.length,
+                commit: {
+                    txid: commitTxid,
+                    explorerUrl: commitExplorerUrl,
+                },
+                reveal: {
+                    txid: revealTxid,
+                    fee: revealResult.fee,
+                    explorerUrl: revealExplorerUrl,
+                },
+                recipientAddress: sessionInfo.taprootAddress,
+                note: "Soul inscription will appear at the recipient address once the reveal transaction confirms. The parent inscription has been returned to your address.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // --------------------------------------------------------------------------
+    // souldinals_list_souls — List soul inscriptions for an address
+    // --------------------------------------------------------------------------
+    server.registerTool("souldinals_list_souls", {
+        description: "List all soul inscriptions (text/markdown) owned by a Taproot address.\n\n" +
+            "Queries the Unisat Ordinals API for inscriptions with content type text/markdown.\n" +
+            "If no address is provided, uses the current wallet's Taproot address.\n\n" +
+            "Returns: array of soul inscriptions with id, number, content type, size, and timestamp.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Taproot (bc1p...) address to query. Omit to use the current wallet's Taproot address."),
+        },
+    }, async ({ address }) => {
+        try {
+            let taprootAddress = address;
+            if (!taprootAddress) {
+                const walletManager = getWalletManager();
+                const sessionInfo = walletManager.getSessionInfo();
+                if (!sessionInfo?.taprootAddress) {
+                    return createErrorResponse(new Error("Wallet not unlocked or doesn't have a Taproot address. " +
+                        "Provide an address parameter or use wallet_unlock first."));
+                }
+                taprootAddress = sessionInfo.taprootAddress;
+            }
+            const inscriptions = await fetchSoulInscriptions(taprootAddress);
+            const souls = inscriptions.map((ins) => ({
+                id: ins.id,
+                number: ins.number,
+                contentType: ins.contentType,
+                contentLength: ins.contentLength,
+                timestamp: ins.timestamp,
+                genesisBlockHeight: ins.genesisBlockHeight,
+            }));
+            return createJsonResponse({
+                address: taprootAddress,
+                count: souls.length,
+                souls,
+                message: souls.length === 0
+                    ? "No soul inscriptions found. Use souldinals_inscribe_soul to create one."
+                    : `Found ${souls.length} soul inscription(s).`,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // --------------------------------------------------------------------------
+    // souldinals_load_soul — Load oldest soul inscription content
+    // --------------------------------------------------------------------------
+    server.registerTool("souldinals_load_soul", {
+        description: "Load and display the full content of the oldest soul inscription from a Taproot address.\n\n" +
+            "Fetches the list of soul inscriptions (text/markdown) and returns the content of the " +
+            "oldest one. If no address is provided, uses the current wallet's Taproot address.\n\n" +
+            "Returns: inscription metadata and full Markdown content.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Taproot (bc1p...) address to query. Omit to use the current wallet's Taproot address."),
+        },
+    }, async ({ address }) => {
+        try {
+            let taprootAddress = address;
+            if (!taprootAddress) {
+                const walletManager = getWalletManager();
+                const sessionInfo = walletManager.getSessionInfo();
+                if (!sessionInfo?.taprootAddress) {
+                    return createErrorResponse(new Error("Wallet not unlocked or doesn't have a Taproot address. " +
+                        "Provide an address parameter or use wallet_unlock first."));
+                }
+                taprootAddress = sessionInfo.taprootAddress;
+            }
+            const inscriptions = await fetchSoulInscriptions(taprootAddress);
+            if (inscriptions.length === 0) {
+                return createJsonResponse({
+                    address: taprootAddress,
+                    found: false,
+                    message: "No soul inscriptions found. Use souldinals_inscribe_soul to create one.",
+                });
+            }
+            // Oldest is first (sorted by genesis_block_height asc)
+            const oldest = inscriptions[0];
+            const content = await fetchInscriptionContent(oldest.id);
+            return createJsonResponse({
+                inscriptionId: oldest.id,
+                contentType: oldest.contentType,
+                contentSize: oldest.contentLength,
+                timestamp: oldest.timestamp,
+                genesisBlockHeight: oldest.genesisBlockHeight,
+                content,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // --------------------------------------------------------------------------
+    // souldinals_display_soul — Parse and display soul traits
+    // --------------------------------------------------------------------------
+    server.registerTool("souldinals_display_soul", {
+        description: "Parse and display soul traits from a specific inscription.\n\n" +
+            "Fetches the inscription content from Unisat and extracts structured soul traits:\n" +
+            "- name: first H1 heading\n" +
+            "- description: first paragraph after H1\n" +
+            "- values: list items under 'Values' or 'Core Values' sections\n" +
+            "- focusAreas: list items under 'Focus' or 'Focus Areas' sections\n" +
+            "- sections: all named H2/H3 sections\n\n" +
+            "Also returns raw Markdown content.",
+        inputSchema: {
+            inscriptionId: z
+                .string()
+                .describe("Inscription ID (format: {txid}i{index})"),
+        },
+    }, async ({ inscriptionId }) => {
+        try {
+            // Fetch metadata and content in parallel
+            const [metadata, content] = await Promise.all([
+                fetchInscriptionMetadata(inscriptionId),
+                fetchInscriptionContent(inscriptionId),
+            ]);
+            const traits = parseSoulTraits(content);
+            return createJsonResponse({
+                inscriptionId,
+                contentType: metadata.contentType,
+                contentLength: metadata.contentLength,
+                timestamp: metadata.timestamp,
+                genesisBlockHeight: metadata.genesisBlockHeight,
+                traits,
+                rawContent: content,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=souldinals.tools.js.map

package/dist/tools/souldinals.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"souldinals.tools.js","sourceRoot":"","sources":["../../src/tools/souldinals.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AAEtD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAS,aAAa;IACpB,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IACF,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAWD;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAe;IAWf,MAAM,GAAG,GAAG,GAAG,eAAe,uBAAuB,OAAO,oCAAoC,CAAC;IACjG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oBAAoB,QAAQ,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;IAE3C,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,iBAAiB,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,EAAE,EAAE,IAAI,CAAC,aAAa;QACtB,MAAM,EAAE,IAAI,CAAC,iBAAiB;QAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACxD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;KAC5C,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CACpC,aAAqB;IAErB,MAAM,GAAG,GAAG,GAAG,eAAe,mCAAmC,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;IACrG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,CAAC,MAAM,MAAM,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CACrC,aAAqB;IAOrB,MAAM,GAAG,GAAG,GAAG,eAAe,gCAAgC,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;IAClG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,MAAM,MAAM,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAEvB,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACxD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;KAC5C,CAAC;AACJ,CAAC;AAcD;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,IAAwB,CAAC;IAC7B,IAAI,WAA+B,CAAC;IACpC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,6BAA6B;QAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtC,YAAY,GAAG,IAAI,CAAC;gBACpB,kBAAkB,GAAG,IAAI,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,CAAC;YACD,SAAS;QACX,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5D,CAAC;YACD,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,YAAY,GAAG,EAAE,CAAC;YAClB,kBAAkB,GAAG,KAAK,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,iFAAiF;QACjF,IAAI,YAAY,IAAI,kBAAkB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC;aAAM,IACL,YAAY;YACZ,kBAAkB;YAClB,CAAC,IAAI,CAAC,IAAI,EAAE;YACZ,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAC3B,CAAC;YACD,kBAAkB,GAAG,KAAK,CAAC;QAC7B,CAAC;QAED,6BAA6B;QAC7B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAExB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC7C,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACjC,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;gBAClD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;qBAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,KAAK,UAAU,cAAc,CAC3B,OAAoC,EACpC,UAAsB;IAEtB,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEhD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,eAAe,EAAE,CAAC;IAChD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB;YACE,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,6EAA6E;IAC7E,yDAAyD;IACzD,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,WAAW,EACT,uFAAuF;YACvF,mFAAmF;YACnF,iGAAiG;YACjG,wFAAwF;YACxF,2EAA2E;YAC3E,sEAAsE;YACtE,wFAAwF;QAC1F,WAAW,EAAE;YACX,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,QAAQ,CACP,wFAAwF,CACzF;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CACP,sFAAsF,CACvF;YACH,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;iBAClE,QAAQ,EAAE;iBACV,QAAQ,CACP,uGAAuG,CACxG;SACJ;KACF,EACD,KAAK,EAAE,EAAE,mBAAmB,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;YAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,mBAAmB,CACxB,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAC3D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBAC3D,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,8DAA8D,CAC/D,CACF,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;YAC3C,IACE,CAAC,OAAO;gBACR,CAAC,OAAO,CAAC,aAAa;gBACtB,CAAC,OAAO,CAAC,YAAY;gBACrB,CAAC,OAAO,CAAC,iBAAiB;gBAC1B,CAAC,OAAO,CAAC,gBAAgB,EACzB,CAAC;gBACD,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,qEAAqE,CACtE,CACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBACxB,OAAO,mBAAmB,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACzE,CAAC;YAED,oDAAoD;YACpD,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;YAEtE,IAAI,UAAU,CAAC,OAAO,KAAK,WAAW,CAAC,cAAc,EAAE,CAAC;gBACtD,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,kCAAkC,UAAU,CAAC,OAAO,iCAAiC,WAAW,CAAC,cAAc,wCAAwC,CACxJ,CACF,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAoB;gBACnC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI;aACL,CAAC;YAEF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEhE,wBAAwB;YACxB,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,kCAAkC,WAAW,CAAC,UAAU,wBAAwB,CACjF,CACF,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,MAAM,YAAY,GAAG,2BAA2B,CAAC;gBAC/C,KAAK;gBACL,WAAW;gBACX,mBAAmB;gBACnB,OAAO,EAAE,aAAa;gBACtB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,aAAa,EAAE,WAAW,CAAC,UAAU;gBACrC,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,kBAAkB,CACrC,YAAY,CAAC,EAAE,EACf,OAAO,CAAC,aAAa,CACtB,CAAC;YACF,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,oBAAoB,CACtD,YAAY,CAAC,KAAK,CACnB,CAAC;YACF,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAE/D,OAAO,kBAAkB,CAAC;gBACxB,MAAM,EAAE,kBAAkB;gBAC1B,OAAO,EACL,kDAAkD;oBAClD,4FAA4F;gBAC9F,UAAU;gBACV,iBAAiB;gBACjB,aAAa,EAAE,YAAY,CAAC,aAAa;gBACzC,YAAY,EAAE,YAAY,CAAC,YAAY;gBACvC,SAAS,EAAE,YAAY,CAAC,GAAG;gBAC3B,OAAO,EAAE,aAAa;gBACtB,mBAAmB;gBACnB,UAAU,EAAE;oBACV,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,KAAK,EAAE,UAAU,CAAC,KAAK;iBACxB;gBACD,WAAW,EAAE,iBAAiB;gBAC9B,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,aAAa;gBACb,QAAQ,EACN,oFAAoF;oBACpF,4DAA4D;aAC/D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6EAA6E;IAC7E,uDAAuD;IACvD,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,yEAAyE;YACzE,yFAAyF;YACzF,+EAA+E;YAC/E,oCAAoC;YACpC,+EAA+E;YAC/E,mFAAmF;YACnF,oDAAoD;QACtD,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,MAAM,CAAC,EAAE,CAAC;iBACV,QAAQ,CACP,oFAAoF,CACrF;YACH,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,sEAAsE,CACvE;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CACP,yEAAyE,CAC1E;YACH,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,QAAQ,CACP,oDAAoD,CACrD;YACH,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;iBAClE,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;SACxD;KACF,EACD,KAAK,EAAE,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,OAAO,GACR,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;YAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,mBAAmB,CACxB,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAC3D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBAChC,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,4DAA4D,CAC7D,CACF,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;YAC3C,IACE,CAAC,OAAO;gBACR,CAAC,OAAO,CAAC,aAAa;gBACtB,CAAC,OAAO,CAAC,YAAY;gBACrB,CAAC,OAAO,CAAC,iBAAiB;gBAC1B,CAAC,OAAO,CAAC,gBAAgB,EACzB,CAAC;gBACD,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,qEAAqE,CACtE,CACF,CAAC;YACJ,CAAC;YAED,0BAA0B;YAC1B,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;YAEtE,IAAI,UAAU,CAAC,OAAO,KAAK,WAAW,CAAC,cAAc,EAAE,CAAC;gBACtD,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,wEAAwE,UAAU,CAAC,OAAO,EAAE,CAC7F,CACF,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAClD,MAAM,WAAW,GAAoB;gBACnC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI;aACL,CAAC;YAEF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEhE,mDAAmD;YACnD,MAAM,UAAU,GAAG,uBAAuB,CAAC;gBACzC,WAAW;gBACX,mBAAmB;gBACnB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YAEH,iCAAiC;YACjC,MAAM,YAAY,GAAG,2BAA2B,CAAC;gBAC/C,UAAU;gBACV,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,YAAY;gBAC1B,YAAY,EAAE,UAAU;gBACxB,UAAU,EAAE;oBACV,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,KAAK,EAAE,UAAU,CAAC,KAAK;iBACxB;gBACD,gCAAgC,EAAE,OAAO,CAAC,gBAAgB;gBAC1D,gBAAgB,EAAE,WAAW,CAAC,cAAc;gBAC5C,OAAO,EAAE,aAAa;gBACtB,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YAEH,mBAAmB;YACnB,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC5C,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAChD,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;YAE3B,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAEtE,MAAM,aAAa,GAAG,GAAG,UAAU,IAAI,CAAC;YACxC,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAE/D,OAAO,kBAAkB,CAAC;gBACxB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,wCAAwC;gBACjD,aAAa;gBACb,mBAAmB;gBACnB,WAAW,EAAE,iBAAiB;gBAC9B,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU;oBAChB,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU;oBAChB,GAAG,EAAE,YAAY,CAAC,GAAG;oBACrB,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,gBAAgB,EAAE,WAAW,CAAC,cAAc;gBAC5C,IAAI,EAAE,uJAAuJ;aAC9J,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6EAA6E;IAC7E,gEAAgE;IAChE,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,4EAA4E;YAC5E,qFAAqF;YACrF,2EAA2E;YAC3E,yFAAyF;QAC3F,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,uFAAuF,CACxF;SACJ;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,IAAI,cAAc,GAAG,OAAO,CAAC;YAE7B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;gBAEnD,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,yDAAyD;wBACvD,0DAA0D,CAC7D,CACF,CAAC;gBACJ,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC;YAC9C,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,cAAc,CAAC,CAAC;YAEjE,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvC,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;gBAChC,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;aAC3C,CAAC,CAAC,CAAC;YAEJ,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,cAAc;gBACvB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,KAAK;gBACL,OAAO,EACL,KAAK,CAAC,MAAM,KAAK,CAAC;oBAChB,CAAC,CAAC,yEAAyE;oBAC3E,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,uBAAuB;aACnD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6EAA6E;IAC7E,8DAA8D;IAC9D,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,8FAA8F;YAC9F,uFAAuF;YACvF,uFAAuF;YACvF,0DAA0D;QAC5D,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,uFAAuF,CACxF;SACJ;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,IAAI,cAAc,GAAG,OAAO,CAAC;YAE7B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;gBAEnD,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,mBAAmB,CACxB,IAAI,KAAK,CACP,yDAAyD;wBACvD,0DAA0D,CAC7D,CACF,CAAC;gBACJ,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC;YAC9C,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,cAAc,CAAC,CAAC;YAEjE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,kBAAkB,CAAC;oBACxB,OAAO,EAAE,cAAc;oBACvB,KAAK,EAAE,KAAK;oBACZ,OAAO,EACL,yEAAyE;iBAC5E,CAAC,CAAC;YACL,CAAC;YAED,uDAAuD;YACvD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEzD,OAAO,kBAAkB,CAAC;gBACxB,aAAa,EAAE,MAAM,CAAC,EAAE;gBACxB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,aAAa;gBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6EAA6E;IAC7E,0DAA0D;IAC1D,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,gEAAgE;YAChE,oFAAoF;YACpF,4BAA4B;YAC5B,2CAA2C;YAC3C,iEAAiE;YACjE,oEAAoE;YACpE,0CAA0C;YAC1C,oCAAoC;QACtC,WAAW,EAAE;YACX,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CAAC,yCAAyC,CAAC;SACvD;KACF,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,yCAAyC;YACzC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC5C,wBAAwB,CAAC,aAAa,CAAC;gBACvC,uBAAuB,CAAC,aAAa,CAAC;aACvC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,OAAO,kBAAkB,CAAC;gBACxB,aAAa;gBACb,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;gBAC/C,MAAM;gBACN,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stacking-lottery.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stacking-lottery.tools.d.ts","sourceRoot":"","sources":["../../src/tools/stacking-lottery.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+GpE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8ZpE"}
+{"version":3,"file":"stacking-lottery.tools.d.ts","sourceRoot":"","sources":["../../src/tools/stacking-lottery.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+GpE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiapE"}

package/dist/tools/stacking-lottery.tools.js

@@ -348,8 +348,10 @@ Note: Stackspot is only available on mainnet.`,
                 contractName: parsed.contractName,
                 functionName: "claim-pot-reward",
                 functionArgs: [],
-                // TODO: tighten to PostConditionMode.Deny once post-conditions are
-                // defined; kept as Allow to match the upstream stackspot skill for now.
+                // PostConditionMode.Allow is intentional: the pot contract transfers
+                // STX back to each participant and sBTC to the winner. The exact amounts
+                // are not known client-side until the contract executes, so strict
+                // post-conditions cannot be set without an additional read-only query.
                 postConditionMode: PostConditionMode.Allow,
             });
             return createJsonResponse({
@@ -400,8 +402,9 @@ Note: Stackspot is only available on mainnet.`,
                 contractName: parsed.contractName,
                 functionName: "cancel-pot",
                 functionArgs: [],
-                // TODO: tighten to PostConditionMode.Deny once post-conditions are
-                // defined; kept as Allow to match the upstream stackspot skill for now.
+                // PostConditionMode.Allow is intentional: the pot contract returns STX
+                // to contributors on cancel. The amount is not known client-side without
+                // an additional read-only query, so strict post-conditions are deferred.
                 postConditionMode: PostConditionMode.Allow,
             });
             return createJsonResponse({