@spirobel/monero-wallet-api 0.2.0 → 0.3.1

package/dist/node-interaction/binaryEndpoints.d.ts

@@ -1,11 +1,17 @@
+import type { ScanResult } from "../scanning-syncing/scanresult/scanResult";
 import type { WasmProcessor } from "../wasm-processing/wasmProcessor";
 export type GetBlocksBinRequest = {
-    requested_info?: "BLOCKS_ONLY" | "BLOCKS_AND_POOL" | "POOL_ONLY";
-    start_height: number;
+    requested_info?: "BLOCKS_ONLY" | "BLOCKS_AND_POOL" | "POOL_ONLY" | number;
+    block_ids?: string[];
+    start_height?: number;
     prune?: boolean;
     no_miner_tx?: boolean;
     pool_info_since?: number;
 };
+/**
+ * array of output indices to fetch
+ */
+export type GetOutsBinRequest = number[];
 export type PoolInfo = {};
 export type Transaction = {};
 export type Block = {
@@ -32,41 +38,80 @@ export type GetBlocksBinResponse = {
     pool_info: "None" | PoolInfo;
     new_height: number;
 };
+export type GetOutsBinResponse = {
+    status: "OK";
+    untrusted: boolean;
+    credits: number;
+    top_hash: string;
+    outs: Array<{
+        key: number[];
+        mask: number[];
+        unlocked: boolean;
+        height: number;
+        txid: number[];
+    }>;
+};
 export type Status = "OK" | "BUSY" | "NOT MINING" | "PAYMENT REQUIRED" | "Failed." | string;
 export type GetBlocksResultMeta = {
     new_height: number;
     daemon_height: number;
     status: Status;
     primary_address: "parsing-monerod-response-without-wallet" | "error-address-not-set" | string;
+    block_infos: BlockInfo[];
+};
+export type BlockInfo = {
+    block_timestamp: number;
+    block_height: number;
+    block_hash: string;
 };
 export type Output = {
-    amount: number;
+    amount: bigint;
     block_height: number;
+    block_timestamp: number;
     index_in_transaction: number;
     index_on_blockchain: number;
     payment_id: number;
     stealth_address: string;
     tx_hash: string;
+    is_miner_tx: boolean;
     primary_address: string;
-};
-export type ScanResult = {
-    outputs: Output[];
-    new_height: number;
-    primary_address: string;
+    subaddress_index: number | null;
+    serialized: string;
+    spent_relative_index?: number;
+    spent_in_tx_hash?: string;
+    spent_block_height?: number;
+    spent_block_timestamp?: number;
+    burned?: number;
 };
 export type ErrorResponse = {
     error: string;
 };
+interface HasNodeUrl {
+    node_url: string;
+}
 export type GetBlocksBinMetaCallback = (meta: GetBlocksResultMeta) => void;
+export declare const MAINNET_GENESIS_BLOCK_HASH = "418015bb9ae982a1975da7d79277c2705727a56894ba0fb246adaabb1f4632e3";
+export declare const STAGENET_GENESIS_BLOCK_HASH = "76ee3cc98646292206cd3e86f74d88b4dcc1d937088645e9b0cbca84b7ce74eb";
 /**
  *  This function creates a binary request to the get_blocks.bin endpoint of the Monerod node.
  * @param processor it uses the wasm module to build the request and parse the response.
  * @param params params that will be turned into epee (moner lib that does binary serialization)
  * @returns a Uint8Array that can be used to make a fetch request to the get_blocks.bin endpoint.
  */
-export declare function getBlocksBinMakeRequest<T extends WasmProcessor>(processor: T, params: GetBlocksBinRequest): Uint8Array;
-export declare function getBlocksBinExecuteRequest<T extends WasmProcessor>(processor: T, params: GetBlocksBinRequest): Promise<Uint8Array>;
-export declare function getBlocksBinScanResponse<T extends WasmProcessor>(processor: T, getBlocksBinResponseBuffer: Uint8Array, metaCallBack?: GetBlocksBinMetaCallback): Promise<ScanResult | ErrorResponse>;
-export declare function getBlocksBinScan<T extends WasmProcessor>(processor: T, params: GetBlocksBinRequest, metaCallBack?: GetBlocksBinMetaCallback): Promise<ScanResult | ErrorResponse>;
-export declare function getBlocksBinJson<T extends WasmProcessor>(processor: T, params: GetBlocksBinRequest): Promise<GetBlocksBinResponse | ErrorResponse>;
-export declare function binaryFetchRequest(url: string, body: Uint8Array): Promise<Uint8Array>;
+export declare function getBlocksBinMakeRequest<T extends WasmProcessor>(processor: T, params: GetBlocksBinRequest): Uint8Array<ArrayBufferLike>;
+export declare function getBlocksBinExecuteRequest<T extends WasmProcessor & HasNodeUrl>(processor: T, params: GetBlocksBinRequest, stopSync?: AbortSignal): Promise<Uint8Array<ArrayBufferLike>>;
+export declare function getBlocksBinScanResponse<T extends WasmProcessor>(processor: T, getBlocksBinResponseBuffer: Uint8Array, metaCallBack?: GetBlocksBinMetaCallback): Promise<ScanResult | ErrorResponse | undefined>;
+export declare function getBlocksBinScan<T extends WasmProcessor & HasNodeUrl>(processor: T, params: GetBlocksBinRequest, metaCallBack?: GetBlocksBinMetaCallback, stopSync?: AbortSignal): Promise<ScanResult | ErrorResponse | undefined>;
+export declare function getBlocksBinJson<T extends WasmProcessor & HasNodeUrl>(processor: T, params: GetBlocksBinRequest): Promise<GetBlocksBinResponse | ErrorResponse>;
+/**
+ * throws error on failure to create request
+ * @param processor wasmprocessor
+ * @param getouts_request_indices output indices to request
+ * @returns array with epee serialized get_outs.bin request arguments
+ */
+export declare function getOutsBinMakeRequest<T extends WasmProcessor>(processor: T, getouts_request_indices: GetOutsBinRequest): Uint8Array;
+export type GetOutsResponseBuffer = Uint8Array;
+export declare function getOutsBinExecuteRequest<T extends WasmProcessor & HasNodeUrl>(processor: T, params: GetOutsBinRequest): Promise<GetOutsResponseBuffer>;
+export declare function getOutsBinJson<T extends WasmProcessor & HasNodeUrl>(processor: T, params: GetOutsBinRequest): Promise<GetOutsBinResponse>;
+export declare function binaryFetchRequest(url: string, body: Uint8Array, stopSync?: AbortSignal): Promise<Uint8Array>;
+export {};

package/dist/node-interaction/binaryEndpoints.js

@@ -1,3 +1,5 @@
+export const MAINNET_GENESIS_BLOCK_HASH = "418015bb9ae982a1975da7d79277c2705727a56894ba0fb246adaabb1f4632e3";
+export const STAGENET_GENESIS_BLOCK_HASH = "76ee3cc98646292206cd3e86f74d88b4dcc1d937088645e9b0cbca84b7ce74eb";
 /**
  *  This function creates a binary request to the get_blocks.bin endpoint of the Monerod node.
  * @param processor it uses the wasm module to build the request and parse the response.
@@ -12,33 +14,40 @@ export function getBlocksBinMakeRequest(processor, params) {
     //     BLOCKS_AND_POOL = 1,
     //     POOL_ONLY = 2
     //   };
-    let requested_info = 0;
     if (params.requested_info === "BLOCKS_AND_POOL") {
-        requested_info = 1;
+        params.requested_info = 1;
     }
     else if (params.requested_info === "POOL_ONLY") {
-        requested_info = 2;
+        params.requested_info = 2;
     }
-    let prune_num = 1;
-    if (params.prune === false) {
-        prune_num = 0;
-    }
-    let no_miner_tx_num = 0;
-    if (params.no_miner_tx) {
-        no_miner_tx_num = 1;
+    else {
+        params.requested_info = 0;
     }
+    if (params.prune === undefined)
+        params.prune = true; // prune default true, our scan function expects pruned transactions
+    const json_params = JSON.stringify(params);
     let getBlocksRequestArray;
+    processor.writeToWasmMemory = (ptr, len) => {
+        processor.writeString(ptr, len, json_params);
+    };
     processor.readFromWasmMemory = (ptr, len) => {
         getBlocksRequestArray = processor.readArray(ptr, len);
     };
+    let error = null;
+    processor.readErrorFromWasmMemory = (ptr, len) => {
+        error = JSON.parse(processor.readString(ptr, len));
+    };
     //@ts-ignore
-    processor.tinywasi.instance.exports.build_getblocksbin_request(requested_info, BigInt(params.start_height), prune_num, no_miner_tx_num, BigInt(params.pool_info_since || 0));
-    return getBlocksRequestArray; // written in build_getblocksbin_request call to readFromWasmMemory
+    processor.tinywasi.instance.exports.build_getblocksbin_request(json_params.length);
+    if (!getBlocksRequestArray)
+        // written in build_getblocksbin_request call to readFromWasmMemory
+        throw error || new Error("failed to build get_blocks.bin request");
+    return getBlocksRequestArray;
 }
-export async function getBlocksBinExecuteRequest(processor, params) {
+export async function getBlocksBinExecuteRequest(processor, params, stopSync) {
     const getBlocksRequestArray = getBlocksBinMakeRequest(processor, params);
-    const getBlocksBinResponseBuffer = await binaryFetchRequest(processor.node_url + "/getblocks.bin", getBlocksRequestArray // written in build_getblocksbin_request call to readFromWasmMemory
-    );
+    const getBlocksBinResponseBuffer = await binaryFetchRequest(processor.node_url + "/getblocks.bin", getBlocksRequestArray, // written in build_getblocksbin_request call to readFromWasmMemory
+    stopSync);
     return getBlocksBinResponseBuffer;
 }
 export async function getBlocksBinScanResponse(processor, getBlocksBinResponseBuffer, metaCallBack) {
@@ -52,10 +61,16 @@ export async function getBlocksBinScanResponse(processor, getBlocksBinResponseBu
         if (metaCallBack)
             metaCallBack(resultMeta);
         processor.readFromWasmMemory = (ptr, len) => {
-            result = JSON.parse(processor.readString(ptr, len));
+            result = JSON.parse(processor.readString(ptr, len), (key, value) => {
+                if (key === "amount")
+                    return BigInt(value);
+                return value;
+            });
             if (!("error" in result)) {
                 result.new_height = resultMeta.new_height;
                 result.primary_address = resultMeta.primary_address;
+                result.block_infos = resultMeta.block_infos;
+                result.daemon_height = resultMeta.daemon_height;
             }
         };
     };
@@ -63,41 +78,13 @@ export async function getBlocksBinScanResponse(processor, getBlocksBinResponseBu
     processor.tinywasi.instance.exports.scan_blocks_with_get_blocks_bin(getBlocksBinResponseBuffer.length);
     return result; //result written in scan_blocks_with_get_blocks_bin
 }
-export async function getBlocksBinScan(processor, params, metaCallBack) {
-    const getBlocksBinResponseBuffer = await getBlocksBinExecuteRequest(processor, params);
+export async function getBlocksBinScan(processor, params, metaCallBack, stopSync) {
+    const getBlocksBinResponseBuffer = await getBlocksBinExecuteRequest(processor, params, stopSync);
     return getBlocksBinScanResponse(processor, getBlocksBinResponseBuffer, metaCallBack);
 }
 export async function getBlocksBinJson(processor, params) {
-    // https://github.com/monero-project/monero/blob/941ecefab21db382e88065c16659864cb8e763ae/src/rpc/core_rpc_server_commands_defs.h#L178
-    //    enum REQUESTED_INFO
-    //   {
-    //     BLOCKS_ONLY = 0,
-    //     BLOCKS_AND_POOL = 1,
-    //     POOL_ONLY = 2
-    //   };
-    let requested_info = 0;
-    if (params.requested_info === "BLOCKS_AND_POOL") {
-        requested_info = 1;
-    }
-    else if (params.requested_info === "POOL_ONLY") {
-        requested_info = 2;
-    }
-    let prune_num = 1;
-    if (params.prune === false) {
-        prune_num = 0;
-    }
-    let no_miner_tx_num = 0;
-    if (params.no_miner_tx) {
-        no_miner_tx_num = 1;
-    }
-    let getBlocksArray;
-    processor.readFromWasmMemory = (ptr, len) => {
-        getBlocksArray = processor.readArray(ptr, len);
-    };
-    //@ts-ignore
-    processor.tinywasi.instance.exports.build_getblocksbin_request(requested_info, BigInt(params.start_height), prune_num, no_miner_tx_num, BigInt(params.pool_info_since || 0));
-    const getBlocksBinResponseBuffer = await binaryFetchRequest(processor.node_url + "/getblocks.bin", getBlocksArray // written in build_getblocksbin_request call to readFromWasmMemory
-    );
+    const getBlocksRequestArray = getBlocksBinMakeRequest(processor, params);
+    const getBlocksBinResponseBuffer = await binaryFetchRequest(processor.node_url + "/getblocks.bin", getBlocksRequestArray);
     processor.writeToWasmMemory = (ptr, len) => {
         processor.writeArray(ptr, len, getBlocksBinResponseBuffer);
     };
@@ -116,12 +103,81 @@ export async function getBlocksBinJson(processor, params) {
     processor.tinywasi.instance.exports.convert_get_blocks_bin_response_to_json(getBlocksBinResponseBuffer.length);
     return result; //result written in convert_get_blocks_bin_response_to_json
 }
-export async function binaryFetchRequest(url, body) {
+/**
+ * throws error on failure to create request
+ * @param processor wasmprocessor
+ * @param getouts_request_indices output indices to request
+ * @returns array with epee serialized get_outs.bin request arguments
+ */
+export function getOutsBinMakeRequest(processor, getouts_request_indices) {
+    let getOutsArray = undefined; // return value
+    const getouts_json = JSON.stringify(getouts_request_indices); // argument
+    processor.readFromWasmMemory = (ptr, len) => {
+        // read result
+        getOutsArray = processor.readArray(ptr, len);
+    };
+    processor.writeToWasmMemory = (ptr, len) => {
+        // write argument
+        processor.writeString(ptr, len, getouts_json);
+    };
+    //@ts-ignore
+    processor.tinywasi.instance.exports.build_getoutsbin_request(getouts_json.length);
+    if (!getOutsArray) {
+        throw new Error("Failed to build get_outs.bin request");
+    }
+    return getOutsArray; // written in build_getblocksbin_request call to readFromWasmMemory
+}
+export async function getOutsBinExecuteRequest(processor, params) {
+    const getOutsRequestArray = getOutsBinMakeRequest(processor, params);
+    const getOutsBinResponseBuffer = await binaryFetchRequest(processor.node_url + "/get_outs.bin", getOutsRequestArray);
+    return getOutsBinResponseBuffer;
+}
+export async function getOutsBinJson(processor, params) {
+    const getOutsBinResponseBuffer = await getOutsBinExecuteRequest(processor, params);
+    processor.writeToWasmMemory = (ptr, len) => {
+        processor.writeArray(ptr, len, getOutsBinResponseBuffer);
+    };
+    let result;
+    processor.readFromWasmMemory = (ptr, len) => {
+        result = JSON.parse(processor.readString(ptr, len));
+    };
+    //@ts-ignore
+    processor.tinywasi.instance.exports.convert_get_outs_bin_response_to_json(getOutsBinResponseBuffer.length);
+    if (!result) {
+        throw new Error("Failed to parse get_outs.bin response");
+    }
+    return result;
+}
+export async function binaryFetchRequest(url, body, stopSync) {
     const response = await fetch(url, {
-        body,
+        body: body,
         method: "POST",
-    })
-        .then((result) => result.blob())
-        .then((blob) => blob.arrayBuffer());
-    return new Uint8Array(response);
+        signal: stopSync,
+    });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    const reader = response.body.getReader();
+    const chunks = [];
+    let totalBytes = 0;
+    const MAX_SIZE = 125829120; // 120MB
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            totalBytes += value.length;
+            if (totalBytes > MAX_SIZE)
+                throw new Error(`Response exceeds 120MB (${totalBytes} bytes)`);
+            chunks.push(value);
+        }
+    }
+    catch (readError) {
+        console.error("Reader error:", readError, "Partial bytes:", totalBytes);
+        // Eat the error - continue to return partial data
+    }
+    finally {
+        reader.releaseLock();
+    }
+    // Always return what we got (even if partial)
+    return Uint8Array.from(chunks.reduce((acc, chunk) => [...acc, ...chunk], []));
 }