@1sat/wallet-toolbox 0.0.8 → 0.0.10

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

@@ -0,0 +1,50 @@
+/**
+ * Balance Module
+ *
+ * Skills for querying wallet balance and payment UTXOs.
+ */
+import type { Skill } from "../skills/types";
+export interface Balance {
+    /** Balance in satoshis */
+    satoshis: number;
+    /** Balance in BSV */
+    bsv: number;
+    /** Balance in USD cents */
+    usdInCents: number;
+}
+export interface PaymentUtxo {
+    txid: string;
+    vout: number;
+    satoshis: number;
+    script: string;
+}
+/** Input for getBalance skill (no required params) */
+export type GetBalanceInput = Record<string, never>;
+/**
+ * Get wallet balance with USD conversion.
+ */
+export declare const getBalance: Skill<GetBalanceInput, Balance>;
+/** Input for getPaymentUtxos skill (no required params) */
+export type GetPaymentUtxosInput = Record<string, never>;
+/**
+ * Get payment UTXOs for external use.
+ */
+export declare const getPaymentUtxos: Skill<GetPaymentUtxosInput, PaymentUtxo[]>;
+/** Input for getExchangeRate skill (no required params) */
+export type GetExchangeRateInput = Record<string, never>;
+/**
+ * Get current BSV/USD exchange rate.
+ */
+export declare const getExchangeRate: Skill<GetExchangeRateInput, number>;
+/** Input for getChainInfo skill (no required params) */
+export type GetChainInfoInput = Record<string, never>;
+/** Output for getChainInfo skill */
+export interface ChainInfo {
+    blocks: number;
+}
+/**
+ * Get chain info from WhatsOnChain.
+ */
+export declare const getChainInfo: Skill<GetChainInfoInput, ChainInfo | null>;
+/** All balance skills for registry */
+export declare const balanceSkills: (Skill<GetBalanceInput, Balance> | Skill<GetPaymentUtxosInput, PaymentUtxo[]> | Skill<GetExchangeRateInput, number> | Skill<GetChainInfoInput, ChainInfo | null>)[];

package/dist/api/balance/index.js

@@ -0,0 +1,135 @@
+/**
+ * Balance Module
+ *
+ * Skills for querying wallet balance and payment UTXOs.
+ */
+import { FUNDING_BASKET, WOC_MAINNET_URL, WOC_TESTNET_URL, EXCHANGE_RATE_CACHE_TTL } from "../constants";
+// Module-level cache for exchange rate
+let exchangeRateCache = null;
+// ============================================================================
+// Internal helpers
+// ============================================================================
+async function fetchExchangeRate(chain, wocApiKey) {
+    if (exchangeRateCache && Date.now() - exchangeRateCache.timestamp < EXCHANGE_RATE_CACHE_TTL) {
+        return exchangeRateCache.rate;
+    }
+    const baseUrl = chain === "main" ? WOC_MAINNET_URL : WOC_TESTNET_URL;
+    const headers = {};
+    if (wocApiKey)
+        headers["woc-api-key"] = wocApiKey;
+    try {
+        const response = await fetch(`${baseUrl}/exchangerate`, { headers });
+        if (!response.ok)
+            throw new Error(`Failed to fetch: ${response.statusText}`);
+        const data = await response.json();
+        const rate = Number(data.rate.toFixed(2));
+        exchangeRateCache = { rate, timestamp: Date.now() };
+        return rate;
+    }
+    catch {
+        return exchangeRateCache?.rate ?? 0;
+    }
+}
+/**
+ * Get wallet balance with USD conversion.
+ */
+export const getBalance = {
+    meta: {
+        name: "getBalance",
+        description: "Get wallet balance in satoshis, BSV, and USD cents",
+        category: "balance",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    async execute(ctx) {
+        const exchangeRate = await fetchExchangeRate(ctx.chain, ctx.wocApiKey);
+        const result = await ctx.wallet.listOutputs({ basket: FUNDING_BASKET, limit: 10000 });
+        const satoshis = result.outputs.reduce((sum, o) => sum + o.satoshis, 0);
+        const bsv = satoshis / 100_000_000;
+        const usdInCents = Math.round(bsv * exchangeRate * 100);
+        return { satoshis, bsv, usdInCents };
+    },
+};
+/**
+ * Get payment UTXOs for external use.
+ */
+export const getPaymentUtxos = {
+    meta: {
+        name: "getPaymentUtxos",
+        description: "Get payment UTXOs from the wallet for external use",
+        category: "balance",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    async execute(ctx) {
+        const result = await ctx.wallet.listOutputs({
+            basket: FUNDING_BASKET,
+            include: "locking scripts",
+            limit: 10000,
+        });
+        return result.outputs.map((o) => {
+            const [txid, voutStr] = o.outpoint.split(".");
+            return {
+                txid,
+                vout: Number.parseInt(voutStr, 10),
+                satoshis: o.satoshis,
+                script: o.lockingScript || "",
+            };
+        });
+    },
+};
+/**
+ * Get current BSV/USD exchange rate.
+ */
+export const getExchangeRate = {
+    meta: {
+        name: "getExchangeRate",
+        description: "Get current BSV/USD exchange rate from WhatsOnChain",
+        category: "balance",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    async execute(ctx) {
+        return fetchExchangeRate(ctx.chain, ctx.wocApiKey);
+    },
+};
+/**
+ * Get chain info from WhatsOnChain.
+ */
+export const getChainInfo = {
+    meta: {
+        name: "getChainInfo",
+        description: "Get current chain info (block height) from WhatsOnChain",
+        category: "balance",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    async execute(ctx) {
+        const baseUrl = ctx.chain === "main" ? WOC_MAINNET_URL : WOC_TESTNET_URL;
+        const headers = {};
+        if (ctx.wocApiKey)
+            headers["woc-api-key"] = ctx.wocApiKey;
+        try {
+            const response = await fetch(`${baseUrl}/chain/info`, { headers });
+            if (!response.ok)
+                return null;
+            return await response.json();
+        }
+        catch {
+            return null;
+        }
+    },
+};
+// ============================================================================
+// Module exports
+// ============================================================================
+/** All balance skills for registry */
+export const balanceSkills = [getBalance, getPaymentUtxos, getExchangeRate, getChainInfo];

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

@@ -0,0 +1,24 @@
+/**
+ * Broadcast Module
+ *
+ * Skills for broadcasting transactions.
+ */
+import type { Skill } from "../skills/types";
+export interface BroadcastRequest {
+    /** Raw transaction hex */
+    rawtx: string;
+    /** Transaction format */
+    format?: "tx" | "beef" | "ef";
+    /** Description for wallet records */
+    description?: string;
+}
+export interface BroadcastResponse {
+    txid?: string;
+    error?: string;
+}
+/**
+ * Broadcast a transaction and internalize it into the wallet.
+ */
+export declare const broadcast: Skill<BroadcastRequest, BroadcastResponse>;
+/** All broadcast skills for registry */
+export declare const broadcastSkills: Skill<BroadcastRequest, BroadcastResponse>[];

package/dist/api/broadcast/index.js

@@ -0,0 +1,73 @@
+/**
+ * Broadcast Module
+ *
+ * Skills for broadcasting transactions.
+ */
+import { Beef, Transaction } from "@bsv/sdk";
+// ============================================================================
+// Skills
+// ============================================================================
+/**
+ * Broadcast a transaction and internalize it into the wallet.
+ */
+export const broadcast = {
+    meta: {
+        name: "broadcast",
+        description: "Broadcast a transaction and internalize it into the wallet",
+        category: "broadcast",
+        inputSchema: {
+            type: "object",
+            properties: {
+                rawtx: { type: "string", description: "Raw transaction hex" },
+                format: {
+                    type: "string",
+                    description: "Transaction format (tx, beef, ef)",
+                    enum: ["tx", "beef", "ef"],
+                },
+                description: { type: "string", description: "Description for wallet records" },
+            },
+            required: ["rawtx"],
+        },
+    },
+    async execute(ctx, input) {
+        try {
+            let tx;
+            switch (input.format) {
+                case "beef":
+                    tx = Transaction.fromHexBEEF(input.rawtx);
+                    break;
+                case "ef":
+                    tx = Transaction.fromHexEF(input.rawtx);
+                    break;
+                default:
+                    tx = Transaction.fromHex(input.rawtx);
+            }
+            const txid = tx.id("hex");
+            const beef = new Beef();
+            beef.mergeTransaction(tx);
+            const outputs = tx.outputs.map((_, index) => ({
+                outputIndex: index,
+                protocol: "wallet payment",
+                paymentRemittance: {
+                    derivationPrefix: "default",
+                    derivationSuffix: `${txid}.${index}`,
+                    senderIdentityKey: "",
+                },
+            }));
+            await ctx.wallet.internalizeAction({
+                tx: Array.from(beef.toBinary()),
+                outputs,
+                description: input.description || "Broadcast transaction",
+            });
+            return { txid };
+        }
+        catch (error) {
+            return { error: error instanceof Error ? error.message : "Unknown error" };
+        }
+    },
+};
+// ============================================================================
+// Module exports
+// ============================================================================
+/** All broadcast skills for registry */
+export const broadcastSkills = [broadcast];

package/dist/api/constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * API Constants
+ */
+export declare const FUNDING_BASKET = "default";
+export declare const ORDINALS_BASKET = "1sat";
+export declare const BSV21_BASKET = "bsv21";
+export declare const LOCK_BASKET = "lock";
+export declare const WOC_MAINNET_URL = "https://api.whatsonchain.com/v1/bsv/main";
+export declare const WOC_TESTNET_URL = "https://api.whatsonchain.com/v1/bsv/test";
+export declare const ONESAT_MAINNET_URL = "https://1sat.shruggr.cloud";
+export declare const ONESAT_TESTNET_URL = "https://testnet.api.1sat.app";
+export declare const ONESAT_MAINNET_CONTENT_URL = "https://1sat.shruggr.cloud/content";
+export declare const ONESAT_TESTNET_CONTENT_URL = "https://testnet.api.1sat.app/content";
+export declare const ORDLOCK_PREFIX = "2097dfd76851bf465e8f715593b217714858bbe9570ff3bd5e33840a34e20ff0262102ba79df5f8ae7604a9830f03c7933028186aede0675a16f025dc4f8be8eec0382201008ce7480da41702918d1ec8e6849ba32b4d65b1e40dc669c31a1e6306b266c0000";
+export declare const ORDLOCK_SUFFIX = "615179547a75537a537a537a0079537a75527a527a7575615579008763567901c161517957795779210ac407f0e4bd44bfc207355a778b046225a7068fc59ee7eda43ad905aadbffc800206c266b30e6a1319c66dc401e5bd6b432ba49688eecd118297041da8074ce081059795679615679aa0079610079517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e01007e81517a75615779567956795679567961537956795479577995939521414136d08c5ed2bf3ba048afe6dcaebafeffffffffffffffffffffffffffffff00517951796151795179970079009f63007952799367007968517a75517a75517a7561527a75517a517951795296a0630079527994527a75517a6853798277527982775379012080517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e01205279947f7754537993527993013051797e527e54797e58797e527e53797e52797e57797e0079517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a756100795779ac517a75517a75517a75517a75517a75517a75517a75517a75517a7561517a75517a756169587951797e58797eaa577961007982775179517958947f7551790128947f77517a75517a75618777777777777777777767557951876351795779a9876957795779ac777777777777777767006868";
+export declare const LOCK_PREFIX = "20d37f4de0d1c735b4d51a5572df0f3d9104d1d9e99db8694fdd1b1a92e1f0dce1757601687f76a9";
+export declare const LOCK_SUFFIX = "88ac7e7601207f75a9011488";
+export declare const MESSAGE_SIGNING_PROTOCOL: [0 | 1 | 2, string];
+export declare const MAX_INSCRIPTION_BYTES = 100000;
+export declare const MIN_UNLOCK_SATS = 1500;
+export declare const EXCHANGE_RATE_CACHE_TTL: number;

package/dist/api/constants.js

@@ -0,0 +1,29 @@
+/**
+ * API Constants
+ */
+// Basket names
+export const FUNDING_BASKET = "default";
+export const ORDINALS_BASKET = "1sat";
+export const BSV21_BASKET = "bsv21";
+export const LOCK_BASKET = "lock";
+// WhatsOnChain API URLs
+export const WOC_MAINNET_URL = "https://api.whatsonchain.com/v1/bsv/main";
+export const WOC_TESTNET_URL = "https://api.whatsonchain.com/v1/bsv/test";
+// 1Sat API base URLs
+export const ONESAT_MAINNET_URL = "https://1sat.shruggr.cloud";
+export const ONESAT_TESTNET_URL = "https://testnet.api.1sat.app";
+// 1Sat API content URLs (at root, not under /1sat/)
+export const ONESAT_MAINNET_CONTENT_URL = "https://1sat.shruggr.cloud/content";
+export const ONESAT_TESTNET_CONTENT_URL = "https://testnet.api.1sat.app/content";
+// OrdLock contract constants
+export const ORDLOCK_PREFIX = "2097dfd76851bf465e8f715593b217714858bbe9570ff3bd5e33840a34e20ff0262102ba79df5f8ae7604a9830f03c7933028186aede0675a16f025dc4f8be8eec0382201008ce7480da41702918d1ec8e6849ba32b4d65b1e40dc669c31a1e6306b266c0000";
+export const ORDLOCK_SUFFIX = "615179547a75537a537a537a0079537a75527a527a7575615579008763567901c161517957795779210ac407f0e4bd44bfc207355a778b046225a7068fc59ee7eda43ad905aadbffc800206c266b30e6a1319c66dc401e5bd6b432ba49688eecd118297041da8074ce081059795679615679aa0079610079517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e01007e81517a75615779567956795679567961537956795479577995939521414136d08c5ed2bf3ba048afe6dcaebafeffffffffffffffffffffffffffffff00517951796151795179970079009f63007952799367007968517a75517a75517a7561527a75517a517951795296a0630079527994527a75517a6853798277527982775379012080517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f517f7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e7c7e01205279947f7754537993527993013051797e527e54797e58797e527e53797e52797e57797e0079517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a75517a756100795779ac517a75517a75517a75517a75517a75517a75517a75517a75517a7561517a75517a756169587951797e58797eaa577961007982775179517958947f7551790128947f77517a75517a75618777777777777777777767557951876351795779a9876957795779ac777777777777777767006868";
+// Lock template constants
+export const LOCK_PREFIX = "20d37f4de0d1c735b4d51a5572df0f3d9104d1d9e99db8694fdd1b1a92e1f0dce1757601687f76a9";
+export const LOCK_SUFFIX = "88ac7e7601207f75a9011488";
+// Message signing protocol
+export const MESSAGE_SIGNING_PROTOCOL = [1, "message signing"];
+// Constants
+export const MAX_INSCRIPTION_BYTES = 100_000;
+export const MIN_UNLOCK_SATS = 1500;
+export const EXCHANGE_RATE_CACHE_TTL = 5 * 60 * 1000; // 5 minutes

package/dist/api/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 1Sat Wallet Toolbox API Layer
+ *
+ * This module provides skills (self-describing actions) for interacting with the 1Sat ecosystem.
+ * All skills work with any BRC-100 compatible wallet interface via OneSatContext.
+ *
+ * Usage:
+ * ```typescript
+ * import { createContext, transferOrdinal, skillRegistry } from '@1sat/wallet-toolbox/api';
+ *
+ * // Create context with a BRC-100 compatible wallet
+ * const ctx = createContext(wallet, { services, chain: 'main' });
+ *
+ * // Execute skills directly
+ * const result = await transferOrdinal.execute(ctx, { outpoint: '...', address: '...' });
+ *
+ * // Or via registry (useful for AI agents)
+ * const skill = skillRegistry.get('transferOrdinal');
+ * const result = await skill.execute(ctx, { outpoint: '...', address: '...' });
+ *
+ * // Get MCP-compatible tool list
+ * const tools = skillRegistry.toMcpTools();
+ * ```
+ */
+export { type OneSatContext, type Skill, type SkillMetadata, type SkillCategory, type JsonSchemaProperty, createContext, } from "./skills/types";
+export { SkillRegistry, skillRegistry, type McpTool } from "./skills/registry";
+export * from "./constants";
+export * from "./balance";
+export * from "./payments";
+export * from "./ordinals";
+export * from "./tokens";
+export * from "./inscriptions";
+export * from "./locks";
+export * from "./signing";
+export * from "./broadcast";
+export type { WalletInterface, WalletOutput, CreateActionArgs, CreateActionResult, CreateActionOutput, CreateActionInput, ListOutputsResult, ListOutputsArgs, } from "@bsv/sdk";

package/dist/api/index.js

@@ -0,0 +1,59 @@
+/**
+ * 1Sat Wallet Toolbox API Layer
+ *
+ * This module provides skills (self-describing actions) for interacting with the 1Sat ecosystem.
+ * All skills work with any BRC-100 compatible wallet interface via OneSatContext.
+ *
+ * Usage:
+ * ```typescript
+ * import { createContext, transferOrdinal, skillRegistry } from '@1sat/wallet-toolbox/api';
+ *
+ * // Create context with a BRC-100 compatible wallet
+ * const ctx = createContext(wallet, { services, chain: 'main' });
+ *
+ * // Execute skills directly
+ * const result = await transferOrdinal.execute(ctx, { outpoint: '...', address: '...' });
+ *
+ * // Or via registry (useful for AI agents)
+ * const skill = skillRegistry.get('transferOrdinal');
+ * const result = await skill.execute(ctx, { outpoint: '...', address: '...' });
+ *
+ * // Get MCP-compatible tool list
+ * const tools = skillRegistry.toMcpTools();
+ * ```
+ */
+// Export skill types and helpers
+export { createContext, } from "./skills/types";
+// Export skill registry
+export { SkillRegistry, skillRegistry } from "./skills/registry";
+// Export constants
+export * from "./constants";
+// Export module skills and types
+export * from "./balance";
+export * from "./payments";
+export * from "./ordinals";
+export * from "./tokens";
+export * from "./inscriptions";
+export * from "./locks";
+export * from "./signing";
+export * from "./broadcast";
+// Register all skills with the global registry
+import { skillRegistry } from "./skills/registry";
+import { balanceSkills } from "./balance";
+import { paymentsSkills } from "./payments";
+import { ordinalsSkills } from "./ordinals";
+import { tokensSkills } from "./tokens";
+import { inscriptionsSkills } from "./inscriptions";
+import { locksSkills } from "./locks";
+import { signingSkills } from "./signing";
+import { broadcastSkills } from "./broadcast";
+skillRegistry.registerAll([
+    ...balanceSkills,
+    ...paymentsSkills,
+    ...ordinalsSkills,
+    ...tokensSkills,
+    ...inscriptionsSkills,
+    ...locksSkills,
+    ...signingSkills,
+    ...broadcastSkills,
+]);

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

@@ -0,0 +1,25 @@
+/**
+ * Inscriptions Module
+ *
+ * Skills for creating inscriptions.
+ */
+import type { Skill } from "../skills/types";
+export interface InscribeRequest {
+    /** Base64 encoded content */
+    base64Content: string;
+    /** Content type (MIME type) */
+    contentType: string;
+    /** Optional MAP metadata */
+    map?: Record<string, string>;
+}
+export interface InscribeResponse {
+    txid?: string;
+    rawtx?: string;
+    error?: string;
+}
+/**
+ * Create an inscription.
+ */
+export declare const inscribe: Skill<InscribeRequest, InscribeResponse>;
+/** All inscription skills for registry */
+export declare const inscriptionsSkills: Skill<InscribeRequest, InscribeResponse>[];

package/dist/api/inscriptions/index.js

@@ -0,0 +1,98 @@
+/**
+ * Inscriptions Module
+ *
+ * Skills for creating inscriptions.
+ */
+import { P2PKH, PublicKey, Script, Utils } from "@bsv/sdk";
+import { Inscription } from "@bopen-io/templates";
+import { MAX_INSCRIPTION_BYTES, ORDINALS_BASKET } from "../constants";
+// ============================================================================
+// Constants
+// ============================================================================
+const ORDINAL_PROTOCOL = [1, "ordinal"];
+// ============================================================================
+// Internal helpers
+// ============================================================================
+function buildInscriptionScript(address, base64Content, contentType) {
+    const content = Utils.toArray(base64Content, "base64");
+    const inscription = Inscription.create(new Uint8Array(content), contentType);
+    const inscriptionScript = inscription.lock();
+    const p2pkhScript = new P2PKH().lock(address);
+    const combined = new Script();
+    for (const chunk of inscriptionScript.chunks)
+        combined.chunks.push(chunk);
+    for (const chunk of p2pkhScript.chunks)
+        combined.chunks.push(chunk);
+    return combined;
+}
+// ============================================================================
+// Skills
+// ============================================================================
+/**
+ * Create an inscription.
+ */
+export const inscribe = {
+    meta: {
+        name: "inscribe",
+        description: "Create a new inscription with the given content and type",
+        category: "inscriptions",
+        inputSchema: {
+            type: "object",
+            properties: {
+                base64Content: { type: "string", description: "Base64 encoded content" },
+                contentType: { type: "string", description: "Content type (MIME type)" },
+                map: {
+                    type: "object",
+                    description: "Optional MAP metadata",
+                    properties: {},
+                },
+            },
+            required: ["base64Content", "contentType"],
+        },
+    },
+    async execute(ctx, input) {
+        try {
+            const decoded = Utils.toArray(input.base64Content, "base64");
+            if (decoded.length > MAX_INSCRIPTION_BYTES) {
+                return { error: `Inscription data too large: ${decoded.length} bytes (max ${MAX_INSCRIPTION_BYTES})` };
+            }
+            const keyID = Date.now().toString();
+            const { publicKey } = await ctx.wallet.getPublicKey({
+                protocolID: ORDINAL_PROTOCOL,
+                keyID,
+                counterparty: "self",
+                forSelf: true,
+            });
+            const address = PublicKey.fromString(publicKey).toAddress();
+            const lockingScript = buildInscriptionScript(address, input.base64Content, input.contentType);
+            const result = await ctx.wallet.createAction({
+                description: "Create inscription",
+                outputs: [
+                    {
+                        lockingScript: lockingScript.toHex(),
+                        satoshis: 1,
+                        outputDescription: "Inscription",
+                        basket: ORDINALS_BASKET,
+                        tags: [`type:${input.contentType}`],
+                        customInstructions: JSON.stringify({
+                            protocolID: ORDINAL_PROTOCOL,
+                            keyID,
+                        }),
+                    },
+                ],
+            });
+            if (!result.txid) {
+                return { error: "no-txid-returned" };
+            }
+            return { txid: result.txid, rawtx: result.tx ? Utils.toHex(result.tx) : undefined };
+        }
+        catch (error) {
+            return { error: error instanceof Error ? error.message : "unknown-error" };
+        }
+    },
+};
+// ============================================================================
+// Module exports
+// ============================================================================
+/** All inscription skills for registry */
+export const inscriptionsSkills = [inscribe];

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

@@ -0,0 +1,47 @@
+/**
+ * Locks Module
+ *
+ * Skills for time-locking BSV.
+ */
+import type { Skill } from "../skills/types";
+export interface LockBsvRequest {
+    /** Amount in satoshis to lock */
+    satoshis: number;
+    /** Block height until which to lock */
+    until: number;
+}
+export interface LockData {
+    /** Total locked satoshis */
+    totalLocked: number;
+    /** Unlockable satoshis (matured locks) */
+    unlockable: number;
+    /** Next unlock block height */
+    nextUnlock: number;
+}
+export interface LockOperationResponse {
+    txid?: string;
+    rawtx?: string;
+    error?: string;
+}
+/** Input for getLockData skill (no required params) */
+export type GetLockDataInput = Record<string, never>;
+/**
+ * Get lock data summary.
+ */
+export declare const getLockData: Skill<GetLockDataInput, LockData>;
+/** Input for lockBsv skill */
+export interface LockBsvInput {
+    requests: LockBsvRequest[];
+}
+/**
+ * Lock BSV until a block height.
+ */
+export declare const lockBsv: Skill<LockBsvInput, LockOperationResponse>;
+/** Input for unlockBsv skill (no required params) */
+export type UnlockBsvInput = Record<string, never>;
+/**
+ * Unlock matured BSV locks.
+ */
+export declare const unlockBsv: Skill<UnlockBsvInput, LockOperationResponse>;
+/** All lock skills for registry */
+export declare const locksSkills: (Skill<GetLockDataInput, LockData> | Skill<LockBsvInput, LockOperationResponse> | Skill<UnlockBsvInput, LockOperationResponse>)[];