@1sat/wallet-toolbox 0.0.9 → 0.0.10

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

@@ -1,10 +1,11 @@
 /**
  * Tokens Module
  *
- * Functions for managing BSV21 tokens.
+ * Skills for managing BSV21 tokens.
  */
-import { type WalletInterface, type WalletOutput } from "@bsv/sdk";
-import type { OneSatServices } from "../../services/OneSatServices";
+import { type WalletOutput } from "@bsv/sdk";
+import type { Skill } from "../skills/types";
+type PubKeyHex = string;
 export interface Bsv21Balance {
     /** Token protocol (bsv-20) */
     p: string;
@@ -32,57 +33,55 @@ export interface Bsv21Balance {
 export interface SendBsv21Request {
     /** Token ID (txid_vout format) */
     tokenId: string;
-    /** Destination address */
-    address: string;
     /** Amount to send (as bigint or string) */
     amount: bigint | string;
+    /** Recipient's identity public key (preferred) */
+    counterparty?: PubKeyHex;
+    /** Legacy: raw P2PKH address */
+    address?: string;
+    /** Paymail address */
+    paymail?: string;
+}
+export interface PurchaseBsv21Request {
+    /** Token ID (txid_vout format of the deploy transaction) */
+    tokenId: string;
+    /** Outpoint of listed token UTXO (OrdLock containing BSV21) */
+    outpoint: string;
+    /** Amount of tokens in the listing */
+    amount: bigint | string;
+    /** Optional marketplace fee address */
+    marketplaceAddress?: string;
+    /** Optional marketplace fee rate (0-1) */
+    marketplaceRate?: number;
 }
 export interface TokenOperationResponse {
     txid?: string;
     rawtx?: string;
     error?: string;
 }
+/** Input for listTokens skill */
+export interface ListTokensInput {
+    /** Max number of tokens to return */
+    limit?: number;
+}
 /**
- * List BSV21 token outputs from the bsv21 basket.
- * Returns WalletOutput[] directly - use tags for metadata.
+ * List BSV21 token outputs from the wallet.
  */
-export declare function listTokens(cwi: WalletInterface, limit?: number): Promise<WalletOutput[]>;
+export declare const listTokens: Skill<ListTokensInput, WalletOutput[]>;
+/** Input for getBsv21Balances skill (no required params) */
+export type GetBsv21BalancesInput = Record<string, never>;
 /**
  * Get aggregated BSV21 token balances.
- * Groups outputs by token ID and sums amounts.
  */
-export declare function getBsv21Balances(cwi: WalletInterface): Promise<Bsv21Balance[]>;
+export declare const getBsv21Balances: Skill<GetBsv21BalancesInput, Bsv21Balance[]>;
 /**
  * Send BSV21 tokens to an address.
- *
- * Flow:
- * 1. Get token UTXOs from basket
- * 2. Validate each with BSV21 service
- * 3. Select UTXOs until we have enough tokens
- * 4. Build transfer inscription outputs
- * 5. Create and sign transaction
  */
-export declare function sendBsv21(cwi: WalletInterface, request: SendBsv21Request, services?: OneSatServices): Promise<TokenOperationResponse>;
-export interface PurchaseBsv21Request {
-    /** Token ID (txid_vout format of the deploy transaction) */
-    tokenId: string;
-    /** Outpoint of listed token UTXO (OrdLock containing BSV21) */
-    outpoint: string;
-    /** Amount of tokens in the listing */
-    amount: bigint | string;
-    /** Optional marketplace fee address */
-    marketplaceAddress?: string;
-    /** Optional marketplace fee rate (0-1) */
-    marketplaceRate?: number;
-}
+export declare const sendBsv21: Skill<SendBsv21Request, TokenOperationResponse>;
 /**
  * Purchase BSV21 tokens from marketplace.
- *
- * Flow:
- * 1. Fetch listing BEEF to get the locking script
- * 2. Decode OrdLock to get price and payout
- * 3. Build BSV21 transfer output for buyer
- * 4. Build payment output for seller
- * 5. Build custom OrdLock purchase unlock (preimage only, no signature)
  */
-export declare function purchaseBsv21(cwi: WalletInterface, request: PurchaseBsv21Request, services?: OneSatServices): Promise<TokenOperationResponse>;
+export declare const purchaseBsv21: Skill<PurchaseBsv21Request, TokenOperationResponse>;
+/** All token skills for registry */
+export declare const tokensSkills: (Skill<ListTokensInput, WalletOutput[]> | Skill<GetBsv21BalancesInput, Bsv21Balance[]> | Skill<SendBsv21Request, TokenOperationResponse> | Skill<PurchaseBsv21Request, TokenOperationResponse>)[];
+export {};