@spirobel/monero-wallet-api 0.5.5 → 0.6.1

package/dist/tools/runtimeMessages.d.ts

@@ -0,0 +1,4 @@
+export declare const CORE_MESSAGE_KINDS: readonly ["toolCall", "execute", "dismiss", "dismissNotice", "openSidebar", "actionLogChanged", "walletCacheChanged", "worker.setNodeUrl", "worker.setStartHeight", "worker.changeNodeUrlAndStartHeight", "worker.buildWallets", "worker.wipeWorkers"];
+export type CoreMessageKind = (typeof CORE_MESSAGE_KINDS)[number];
+export declare const CONTENT_MESSAGE_KINDS: readonly ["toolCall", "openSidebar"];
+export type ContentMessageKind = (typeof CONTENT_MESSAGE_KINDS)[number];

package/dist/tools/runtimeMessages.js

@@ -0,0 +1,18 @@
+export const CORE_MESSAGE_KINDS = [
+    "toolCall",
+    "execute",
+    "dismiss",
+    "dismissNotice",
+    "openSidebar",
+    "actionLogChanged",
+    "walletCacheChanged",
+    "worker.setNodeUrl",
+    "worker.setStartHeight",
+    "worker.changeNodeUrlAndStartHeight",
+    "worker.buildWallets",
+    "worker.wipeWorkers",
+];
+export const CONTENT_MESSAGE_KINDS = [
+    "toolCall",
+    "openSidebar",
+];

package/dist/tools/toolActionLogContext.d.ts

@@ -0,0 +1,33 @@
+import type { ActionLogEvent, ActionLogOpened } from "../actionlog/actionLogOpened";
+import type { ToolPermission } from "../actionlog/types";
+/** durable plate notice — title/message are tool-owned STE text */
+export type ToolNotice = {
+    id: string;
+    permission: ToolPermission;
+    /** short STE title for the notice plate hole */
+    title: string;
+    /** full STE body for the notice plate hole */
+    message: string;
+    context_domain?: string;
+    context_href?: string;
+    wallet_slot?: number;
+    timestamp?: number | string;
+};
+/** static STE strings for open-invocation plate holes */
+export type ToolUiCopy = {
+    openTitle: string;
+    acceptLabel?: string;
+    dismissLabel?: string;
+};
+/** passed into per-tool actionlog writers — no wallet host types */
+export type ToolActionLogContext = {
+    log: ActionLogOpened;
+    getWallets?: () => unknown;
+    /** host reopens wallets after tool changes scan settings */
+    reloadWallets?: () => void | Promise<void>;
+    getPort: (invocationId: string) => {
+        postMessage: (msg: unknown) => void;
+    } | undefined;
+    postToPort: (invocationId: string, msg: unknown) => void;
+    broadcast: (events: ActionLogEvent[]) => void;
+};

package/dist/tools/toolActionLogContext.js

@@ -0,0 +1 @@
+export {};

package/dist/tools/toolArm.d.ts

@@ -0,0 +1,47 @@
+import type { ToolActionLogContext } from "../actionlog/types";
+import type { ToolInvocationValidity, ToolNotice, ToolPermission, ToolUiCopy } from "./globals";
+export type ToolInvocationForValidate = {
+    tool: {
+        tool_id: string;
+        payload: unknown;
+    };
+    destination_domain: string;
+    context_domain: string;
+    found_in: "link" | "linkText";
+    link: string;
+    linkText: string;
+    timestamp: number;
+    invocation_id: string;
+    context_href: string;
+    valid: ToolInvocationValidity;
+};
+export type ToolContentZone<TPayload = unknown> = {
+    parse: (args: string[]) => {
+        tool_id: string;
+        payload: TPayload;
+    } | null;
+    validate?: (invo: ToolInvocationForValidate) => Promise<ToolInvocationValidity> | ToolInvocationValidity;
+    afterValidate?: (invo: ToolInvocationForValidate) => void;
+};
+export type ToolWorkerZone = Record<string, unknown>;
+export type ToolCounterpartyZone<TPayload = unknown, TExtra extends object = {}> = {
+    make: (payload: TPayload) => string;
+} & TExtra;
+export type ToolActionLogZone = {
+    onToolCall?: (ctx: ToolActionLogContext, invo: ToolInvocationForValidate) => Promise<void>;
+    onExecute?: (ctx: ToolActionLogContext, invocationId: string, args: Record<string, unknown>) => Promise<void>;
+    onDismiss?: (ctx: ToolActionLogContext, invocationId: string) => Promise<void>;
+    onPortDisconnect?: (ctx: ToolActionLogContext, invocationId: string) => Promise<void>;
+    getNotices?: (ctx: ToolActionLogContext) => Promise<ToolNotice[]>;
+    clearNotice?: (ctx: ToolActionLogContext, noticeId: string) => Promise<void>;
+    messageKinds?: Record<string, (ctx: ToolActionLogContext, payload: any) => Promise<void>>;
+    [key: string]: unknown;
+};
+export type ToolArm<TPayload = unknown, TCounterpartyExtra extends object = {}> = {
+    permissions: readonly ToolPermission[];
+    ui: ToolUiCopy;
+    content: ToolContentZone<TPayload>;
+    worker: ToolWorkerZone;
+    counterparty: ToolCounterpartyZone<TPayload, TCounterpartyExtra>;
+    actionlog: ToolActionLogZone;
+};

package/dist/tools/toolArm.js

@@ -0,0 +1 @@
+export {};

package/dist/tools/ui.d.ts

@@ -0,0 +1,2 @@
+export type { ToolUiCopy, ToolNotice } from "./globals";
+export { tools, TOOL_IDS, type ToolId } from "./monero-tools";

package/dist/tools/ui.js

@@ -0,0 +1 @@
+export { tools, TOOL_IDS } from "./monero-tools";

package/dist/tools/worker.d.ts

@@ -0,0 +1 @@
+export { tools, TOOL_IDS, type ToolId } from "./monero-tools";

package/dist/tools/worker.js

@@ -0,0 +1 @@
+export { tools, TOOL_IDS } from "./monero-tools";

package/dist/viewpair/ViewPair.d.ts

@@ -6,7 +6,7 @@ import { type ScanCache } from "../scanning-syncing/scanresult/scanCache";
 import { type MakeTransactionParams, type UnsignedTransaction } from "../send-functionality/transactionBuilding";
 import { WasmProcessor } from "../wasm-processing/wasmProcessor";
 import { type NETWORKS } from "../node-interaction/nodeUrl";
-import { type GetBlockHeadersRangeParams } from "../api";
+import { type GetBlockHeadersRangeParams } from "../xmr3";
 /**
  * This class is useful to interact with Moneros DaemonRpc binary requests in a convenient way.
  * (similar to how you would interact with a REST api that gives you json back.)
@@ -66,7 +66,7 @@ export declare class ViewPair extends WasmProcessor {
      * @param getBlocksBinResponseBuffer the raw binary response from the get_blocks.bin endpoint
      * @returns metadata about the loaded blocks (new_height, daemon_height, status, block_infos)
      */
-    loadGetBlocksBinResponse(getBlocksBinResponseBuffer: Uint8Array): Promise<import("../api").GetBlocksResultMeta>;
+    loadGetBlocksBinResponse(getBlocksBinResponseBuffer: Uint8Array): Promise<import("../xmr3").GetBlocksResultMeta>;
     /**
      * scan one block from a getblocks.bin response that was loaded into wasm memory.
      * call loadGetBlocksBinResponse first to populate the response in the wasm module.
@@ -134,7 +134,7 @@ export declare class ViewPair extends WasmProcessor {
      * @param params The parameters including start_height, end_height, and optional fill_pow_hash.
      * @returns The result object with headers, status, etc. Throws if the range is invalid:(end_height > daemonheight)
      */
-    getBlockHeadersRange(params: GetBlockHeadersRangeParams): Promise<import("../api").GetBlockHeadersRange>;
+    getBlockHeadersRange(params: GetBlockHeadersRangeParams): Promise<import("../xmr3").GetBlockHeadersRange>;
     /**
      * Fetch general information about the Monero daemon.
      * @link https://docs.getmonero.org/rpc-library/monerod-rpc/#get_info

package/dist/viewpair/ViewPair.js

@@ -7,8 +7,8 @@ import { makeSweepTransaction, makeTransaction, } from "../send-functionality/tr
 import { monero_wallet_api_wasm } from "../wasm-processing/wasmFile";
 import { WasmProcessor } from "../wasm-processing/wasmProcessor";
 import { LOCAL_NODE_DEFAULT_URL, } from "../node-interaction/nodeUrl";
-import { get_block_headers_range, get_info, } from "../api";
-import { readWalletFromScanSettings } from "../api";
+import { get_block_headers_range, get_info, } from "../xmr3";
+import { readWalletFromScanSettings } from "../xmr3";
 import { sleep } from "../io/sleep";
 /**
  * This class is useful to interact with Moneros DaemonRpc binary requests in a convenient way.

package/dist/wasm-processing/wasmFile.js

@@ -8,6 +8,6 @@ var frost_dkg_wasm = new Uint8Array(atob(dkg_source).split("").map(function(c) {
   return c.charCodeAt(0);
 }));
 export {
-  monero_wallet_api_wasm,
-  frost_dkg_wasm
+  frost_dkg_wasm,
+  monero_wallet_api_wasm
 };

package/dist/{api.d.ts → xmr3.d.ts}

@@ -8,6 +8,7 @@ export * from "./node-interaction/jsonEndpoints";
 export * from "./io/readDir";
 export * from "./io/atomicWrite";
 export * from "./io/sleep";
+export { LOGGING_FUNCTIONS, type PossibleLogs, type LogSetting, } from "./io/logging";
 export { signTransaction, parseAddress, type ParsedAddress, type ParseAddressError, } from "./send-functionality/transactionBuilding";
 export { computeKeyImage } from "./scanning-syncing/scanresult/computeKeyImage";
 export * from "./multisig/multisig";
@@ -21,6 +22,7 @@ export * from "./scanning-syncing/blocksbuffer/blocksBufferFetchLoop";
 export * from "./scanning-syncing/blocksbuffer/blocksbufferCoordination";
 export * from "./scanning-syncing/connectionStatus";
 export { ConnectionStatusOpened } from "./scanning-syncing/connectionStatusOpened";
+export { ActionLogOpened, type ActionLogOpenedCreateOptions, type ActionLogBackendKind, type ActionLogEvent, type ActionLogEventType, type ActionLogStage, Invocation, type InvocationDisplayStatus, type InvocationState, type ToolPermission, type ToolNotice, type ToolUiCopy, type ToolWorkerContext, } from "./actionlog/actionLogOpened";
 export * from "./scansettings/scanSettings";
 export { ScanSettingsOpened } from "./scansettings/scanSettingsOpened";
 export * from "./scanning-syncing/scanresult/scanResult";
@@ -33,3 +35,5 @@ export * from "./keypairs-seeds/keypairs";
 export * from "./send-functionality/conversion";
 export * from "./send-functionality/inputSelection";
 export * from "./tools/monero-tools";
+export type { ToolArm, ToolContentZone, ToolCounterpartyZone, ToolWorkerZone, ToolInvocationForValidate, } from "./tools/globals";
+export { sendToBackground } from "./tools/globals";

package/dist/{api.js → xmr3.js}

@@ -7,6 +7,7 @@ export * from "./node-interaction/jsonEndpoints";
 export * from "./io/readDir";
 export * from "./io/atomicWrite";
 export * from "./io/sleep";
+export { LOGGING_FUNCTIONS, } from "./io/logging";
 export { signTransaction, parseAddress, } from "./send-functionality/transactionBuilding";
 export { computeKeyImage } from "./scanning-syncing/scanresult/computeKeyImage";
 export * from "./multisig/multisig";
@@ -20,6 +21,7 @@ export * from "./scanning-syncing/blocksbuffer/blocksBufferFetchLoop";
 export * from "./scanning-syncing/blocksbuffer/blocksbufferCoordination";
 export * from "./scanning-syncing/connectionStatus";
 export { ConnectionStatusOpened } from "./scanning-syncing/connectionStatusOpened";
+export { ActionLogOpened, Invocation, } from "./actionlog/actionLogOpened";
 export * from "./scansettings/scanSettings";
 export { ScanSettingsOpened } from "./scansettings/scanSettingsOpened";
 export * from "./scanning-syncing/scanresult/scanResult";
@@ -32,3 +34,4 @@ export * from "./keypairs-seeds/keypairs";
 export * from "./send-functionality/conversion";
 export * from "./send-functionality/inputSelection";
 export * from "./tools/monero-tools";
+export { sendToBackground } from "./tools/globals";

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@spirobel/monero-wallet-api",
-  "version": "0.5.5",
-  "main": "dist/api.js",
-  "module": "dist/api.js",
+  "version": "0.6.1",
+  "main": "dist/xmr3.js",
+  "module": "dist/xmr3.js",
   "devDependencies": {
     "@types/bun": "latest"
   },
@@ -11,14 +11,21 @@
   },
   "exports": {
     ".": {
-      "types": "./dist/api.d.ts",
-      "import": "./dist/api.js"
+      "types": "./dist/xmr3.d.ts",
+      "import": "./dist/xmr3.js"
     },
     "./tools": {
       "types": "./dist/tools/monero-tools.d.ts",
       "import": "./dist/tools/monero-tools.js"
+    },
+    "./tools/content": {
+      "types": "./dist/tools/content.d.ts",
+      "import": "./dist/tools/content.js"
     }
   },
+  "browser": {
+    "./dist/actionlog/backend/sqliteBackend.js": false
+  },
   "files": ["dist"],
   "license": "MIT",
   "publishConfig": {
@@ -47,7 +54,7 @@
     "clean": "rm -rf ./dist"
   },
   "type": "module",
-  "types": "dist/api.d.ts",
+  "types": "dist/xmr3.d.ts",
   "dependencies": {
     "@noble/curves": "2.2.0",
     "@noble/hashes": "2.2.0"