@1sat/actions 0.0.21 → 0.0.23

package/dist/types.d.ts

@@ -16,6 +16,30 @@ export interface OneSatContext {
     chain: 'main' | 'test';
     /** Optional WhatsOnChain API key */
     wocApiKey?: string;
+    /** Enable debug logging of derivation info for fund recovery */
+    debug?: boolean;
+    /** Structured log callback — receives derivation details for each action execution */
+    log?: (entry: ActionLogEntry) => void;
+}
+/**
+ * Structured log entry emitted by actions when debug mode is enabled.
+ * Captures derivation details needed for fund recovery.
+ */
+export interface ActionLogEntry {
+    timestamp: string;
+    action: string;
+    input: unknown;
+    txid?: string;
+    rawtx?: string;
+    outputs?: Array<{
+        index: number;
+        protocolID?: unknown;
+        keyID?: string;
+        basket?: string;
+        customInstructions?: string;
+        satoshis: number;
+    }>;
+    error?: string;
 }
 /**
  * JSON Schema property definition for action input schemas.
@@ -32,7 +56,7 @@ export interface JsonSchemaProperty {
 /**
  * Action category for grouping related operations.
  */
-export type ActionCategory = 'balance' | 'payments' | 'ordinals' | 'tokens' | 'inscriptions' | 'locks' | 'signing' | 'sweep' | 'opns';
+export type ActionCategory = 'addresses' | 'balance' | 'payments' | 'ordinals' | 'tokens' | 'inscriptions' | 'locks' | 'signing' | 'sweep' | 'opns';
 /**
  * Metadata describing an action for AI agents and tooling.
  */
@@ -68,5 +92,7 @@ export declare function createContext(wallet: WalletInterface, options?: {
     services?: OneSatServices;
     chain?: 'main' | 'test';
     wocApiKey?: string;
+    debug?: boolean;
+    log?: (entry: ActionLogEntry) => void;
 }): OneSatContext;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,0CAA0C;IAC1C,MAAM,EAAE,eAAe,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,SAAS,GACT,UAAU,GACV,UAAU,GACV,QAAQ,GACR,cAAc,GACd,OAAO,GACP,SAAS,GACT,OAAO,GACP,MAAM,CAAA;AAET;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAChD,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,cAAc,CAAA;IACxB,4DAA4D;IAC5D,WAAW,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;QAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IACD,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC1D,qCAAqC;IACrC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,gDAAgD;IAChD,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE;IACT,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,GACC,aAAa,CAOf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -10,6 +10,8 @@ export function createContext(wallet, options) {
         services: options?.services,
         chain: options?.chain ?? 'main',
         wocApiKey: options?.wocApiKey,
+        debug: options?.debug,
+        log: options?.log,
     };
 }
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6EH;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAuB,EACvB,OAIC;IAED,OAAO;QACN,MAAM;QACN,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM;QAC/B,SAAS,EAAE,OAAO,EAAE,SAAS;KAC7B,CAAA;AACF,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuGH;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAuB,EACvB,OAMC;IAED,OAAO;QACN,MAAM;QACN,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM;QAC/B,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,GAAG,EAAE,OAAO,EAAE,GAAG;KACjB,CAAA;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@1sat/actions",
-	"version": "0.0.21",
+	"version": "0.0.23",
 	"description": "Action definitions for the 1Sat SDK",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -15,13 +15,14 @@
 	"scripts": {
 		"build": "tsc",
 		"dev": "tsc --watch",
-		"clean": "rm -rf dist"
+		"clean": "rm -rf dist",
+		"test": "bun test"
 	},
 	"keywords": ["1sat", "bsv", "actions", "wallet", "ordinals"],
 	"license": "MIT",
 	"dependencies": {
 		"@1sat/client": "^0.0.8",
-		"@1sat/types": "^0.0.9",
+		"@1sat/types": "^0.0.10",
 		"@1sat/utils": "^0.0.8",
 		"@bopen-io/templates": "^1.1.9"
 	},