@xandeum/web3.js 0.4.0

package/dist/copyPath.js

@@ -0,0 +1,86 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyPath = copyPath;
+var web3_js_1 = require("@solana/web3.js");
+var bn_js_1 = __importDefault(require("bn.js"));
+var const_1 = require("./const");
+var sanitizePath_1 = require("./sanitizePath");
+/**
+ * Constructs a Solana transaction to copy a file or directory from one  path to another.
+ *
+ * @param fsid - The unique numeric identifier representing the target file system.
+ * @param srcPath - The source path to copy from (e.g., `/documents/report.txt`).
+ * @param destPath - The destination path to copy to (e.g., `/archive/report.txt`).
+ * @param wallet - The wallet public key used to sign and authorize the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the copyPath instruction.
+ * @throws Will throw an error if `srcPath` or `destPath` contains invalid characters.
+ *
+ */
+function copyPath(fsid, srcPath, destPath, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var rest, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            // Validate path: only letters, numbers, and /
+            (0, sanitizePath_1.sanitizePath)(srcPath);
+            (0, sanitizePath_1.sanitizePath)(destPath);
+            rest = Buffer.from("".concat(srcPath, "\0").concat(destPath), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([9]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                rest
+            ]);
+            instruction = new web3_js_1.TransactionInstruction({
+                keys: [
+                    {
+                        pubkey: wallet,
+                        isSigner: true,
+                        isWritable: true
+                    }
+                ],
+                programId: new web3_js_1.PublicKey(const_1.programId),
+                data: instructionData
+            });
+            tx = new web3_js_1.Transaction().add(instruction);
+            return [2 /*return*/, tx];
+        });
+    });
+}

package/dist/createDirectory.d.ts

@@ -0,0 +1,12 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to create a new directory within a  file system.
+ *
+ * @param fsid - A numeric filesystem identifier used to scope the directory creation.
+ * @param path - The parent path where the directory should be created (e.g., `/documents`).
+ * @param name - The name of the new directory (e.g., `reports`).
+ * @param wallet - The signer’s public key that authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the createDirectory instruction.
+ * @throws Will throw an error if `path` or `name` contains invalid characters.@throws Will throw if the combined path is invalid (non-alphanumeric or unsupported characters).
+ */
+export declare function createDirectory(fsid: string, path: string, name: string, wallet: PublicKey): Promise<Transaction>;

package/dist/createDirectory.js

@@ -0,0 +1,84 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDirectory = createDirectory;
+var web3_js_1 = require("@solana/web3.js");
+var bn_js_1 = __importDefault(require("bn.js"));
+var const_1 = require("./const");
+var sanitizePath_1 = require("./sanitizePath");
+/**
+ * Constructs a Solana transaction to create a new directory within a  file system.
+ *
+ * @param fsid - A numeric filesystem identifier used to scope the directory creation.
+ * @param path - The parent path where the directory should be created (e.g., `/documents`).
+ * @param name - The name of the new directory (e.g., `reports`).
+ * @param wallet - The signer’s public key that authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the createDirectory instruction.
+ * @throws Will throw an error if `path` or `name` contains invalid characters.@throws Will throw if the combined path is invalid (non-alphanumeric or unsupported characters).
+ */
+function createDirectory(fsid, path, name, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var combinedPath, rest, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            combinedPath = path.endsWith('/') ? "".concat(path).concat(name) : "".concat(path, "/").concat(name);
+            (0, sanitizePath_1.sanitizePath)(combinedPath);
+            rest = Buffer.from("".concat(path, "\0").concat(name), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([6]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                rest
+            ]);
+            instruction = new web3_js_1.TransactionInstruction({
+                keys: [
+                    {
+                        pubkey: wallet,
+                        isSigner: true,
+                        isWritable: true
+                    }
+                ],
+                programId: new web3_js_1.PublicKey(const_1.programId),
+                data: instructionData
+            });
+            tx = new web3_js_1.Transaction().add(instruction);
+            return [2 /*return*/, tx];
+        });
+    });
+}

package/dist/createFile.d.ts

@@ -0,0 +1,13 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to create a new file
+ * within a file system, identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the file is to be created.
+ * @param path - The absolute or relative path within the file system where the file should be created.
+ * @param name - The name of the new file or directory to be created.
+ * @param wallet - The public key of the wallet that will sign and authorize the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the createFile instruction.
+ * @throws Will throw an error if `path` or `name` contains invalid characters.
+ */
+export declare function createFile(fsid: string, path: string, name: string, wallet: PublicKey): Promise<Transaction>;

package/dist/createFile.js

@@ -0,0 +1,85 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFile = createFile;
+var web3_js_1 = require("@solana/web3.js");
+var bn_js_1 = __importDefault(require("bn.js"));
+var const_1 = require("./const");
+var sanitizePath_1 = require("./sanitizePath");
+/**
+ * Constructs a Solana transaction to create a new file
+ * within a file system, identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the file is to be created.
+ * @param path - The absolute or relative path within the file system where the file should be created.
+ * @param name - The name of the new file or directory to be created.
+ * @param wallet - The public key of the wallet that will sign and authorize the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the createFile instruction.
+ * @throws Will throw an error if `path` or `name` contains invalid characters.
+ */
+function createFile(fsid, path, name, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var combinedPath, rest, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            combinedPath = path.endsWith('/') ? "".concat(path).concat(name) : "".concat(path, "/").concat(name);
+            (0, sanitizePath_1.sanitizePath)(combinedPath);
+            rest = Buffer.from("".concat(path, "\0").concat(name), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([2]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                rest
+            ]);
+            instruction = new web3_js_1.TransactionInstruction({
+                keys: [
+                    {
+                        pubkey: wallet,
+                        isSigner: true,
+                        isWritable: true
+                    }
+                ],
+                programId: new web3_js_1.PublicKey(const_1.programId),
+                data: instructionData
+            });
+            tx = new web3_js_1.Transaction().add(instruction);
+            return [2 /*return*/, tx];
+        });
+    });
+}

package/dist/exists.d.ts

@@ -0,0 +1,20 @@
+import { Connection } from "@solana/web3.js";
+export interface RpcRequest {
+    jsonrpc: string;
+    id: number;
+    method: string;
+    params: any[];
+}
+/**
+ * Sends a JSON-RPC request to the Xandeum RPC endpoint to check if a file or directory exists.
+ *
+ * This function calls the custom RPC method `isExist`, which should be implemented
+ * by the backend to validate the existence of metadata (files/directories) at a given path.
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param path - The filesystem path to check (e.g., `/documents/myfile.txt`).
+ *
+ * @returns A `Promise<any>` resolving to the RPC response JSON, typically including a `result` field
+ *          indicating existence (e.g., `true` or `false`), or `null` if not found.
+ *
+ */
+export declare function exists(connection: Connection, path: string): Promise<any>;

package/dist/exists.js

@@ -0,0 +1,86 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exists = exists;
+/**
+ * Sends a JSON-RPC request to the Xandeum RPC endpoint to check if a file or directory exists.
+ *
+ * This function calls the custom RPC method `isExist`, which should be implemented
+ * by the backend to validate the existence of metadata (files/directories) at a given path.
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param path - The filesystem path to check (e.g., `/documents/myfile.txt`).
+ *
+ * @returns A `Promise<any>` resolving to the RPC response JSON, typically including a `result` field
+ *          indicating existence (e.g., `true` or `false`), or `null` if not found.
+ *
+ */
+function exists(connection, path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var url, requestBody, response, errorText, data;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    url = connection.rpcEndpoint;
+                    requestBody = {
+                        jsonrpc: '2.0',
+                        id: 1,
+                        method: 'isExist',
+                        params: [path]
+                    };
+                    return [4 /*yield*/, fetch(url, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify(requestBody)
+                        })];
+                case 1:
+                    response = _a.sent();
+                    if (!!response.ok) return [3 /*break*/, 3];
+                    return [4 /*yield*/, response.text()];
+                case 2:
+                    errorText = _a.sent();
+                    return [2 /*return*/, Error("error! status: ".concat(response.status, ", message: ").concat(errorText))];
+                case 3: return [4 /*yield*/, response.json()];
+                case 4:
+                    data = _a.sent();
+                    return [2 /*return*/, data];
+            }
+        });
+    });
+}

package/dist/find.d.ts

@@ -0,0 +1,22 @@
+import { Connection } from "@solana/web3.js";
+export interface RpcRequest {
+    jsonrpc: string;
+    id: number;
+    method: string;
+    params: any[];
+}
+/**
+ * Sends a JSON-RPC request to the Xandeum RPC endpoint to search for a file or directory
+ * within a specified path.
+ *
+ * This function calls the custom RPC method `find`, which is  return an array of
+ * directory entry metadata — names, types etc.
+ *
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param path - The  filesystem path where the search will be performed (e.g., `/documents`).
+ * @param query - The query to search for (e.g., `'myfile.txt'`).
+ *
+ * @returns A `Promise<any>` resolving to the parsed JSON response from the RPC server,
+ *          typically including a `result` array containing directory entry objects.
+ */
+export declare function listDirectoryEntry(connection: Connection, path: string, query: string): Promise<any>;

package/dist/find.js

@@ -0,0 +1,88 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDirectoryEntry = listDirectoryEntry;
+/**
+ * Sends a JSON-RPC request to the Xandeum RPC endpoint to search for a file or directory
+ * within a specified path.
+ *
+ * This function calls the custom RPC method `find`, which is  return an array of
+ * directory entry metadata — names, types etc.
+ *
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param path - The  filesystem path where the search will be performed (e.g., `/documents`).
+ * @param query - The query to search for (e.g., `'myfile.txt'`).
+ *
+ * @returns A `Promise<any>` resolving to the parsed JSON response from the RPC server,
+ *          typically including a `result` array containing directory entry objects.
+ */
+function listDirectoryEntry(connection, path, query) {
+    return __awaiter(this, void 0, void 0, function () {
+        var url, requestBody, response, errorText, data;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    url = connection.rpcEndpoint;
+                    requestBody = {
+                        jsonrpc: '2.0',
+                        id: 1,
+                        method: 'find',
+                        params: [path, query]
+                    };
+                    return [4 /*yield*/, fetch(url, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify(requestBody)
+                        })];
+                case 1:
+                    response = _a.sent();
+                    if (!!response.ok) return [3 /*break*/, 3];
+                    return [4 /*yield*/, response.text()];
+                case 2:
+                    errorText = _a.sent();
+                    return [2 /*return*/, Error("error! status: ".concat(response.status, ", message: ").concat(errorText))];
+                case 3: return [4 /*yield*/, response.json()];
+                case 4:
+                    data = _a.sent();
+                    return [2 /*return*/, data];
+            }
+        });
+    });
+}

package/dist/getInfo.d.ts

@@ -0,0 +1,12 @@
+export interface RpcRequest {
+    jsonrpc: string;
+    id: number;
+    method: string;
+    params: any[];
+}
+/**
+ * Calls Solana RPC method `getMetadata` for the file and direcories with the given path. (parent_path, depth,type)
+ * @param path The metadata path (e.g., account or key)
+ * @param url The Xandeum RPC URL
+ */
+export declare function getInfo(path: string, url: string): Promise<any>;

package/dist/getInfo.js

@@ -0,0 +1,77 @@
+"use strict";
+// const url = 'https://api.devnet.solana.com';
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInfo = getInfo;
+/**
+ * Calls Solana RPC method `getMetadata` for the file and direcories with the given path. (parent_path, depth,type)
+ * @param path The metadata path (e.g., account or key)
+ * @param url The Xandeum RPC URL
+ */
+function getInfo(path, url) {
+    return __awaiter(this, void 0, void 0, function () {
+        var requestBody, response, data;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    requestBody = {
+                        jsonrpc: '2.0',
+                        id: 1,
+                        method: 'getInfo',
+                        params: [path],
+                    };
+                    return [4 /*yield*/, fetch(url, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                            },
+                            body: JSON.stringify(requestBody),
+                        })];
+                case 1:
+                    response = _a.sent();
+                    if (!response.ok) {
+                        throw new Error("HTTP error! Status: ".concat(response.status));
+                    }
+                    return [4 /*yield*/, response.json()];
+                case 2:
+                    data = _a.sent();
+                    return [2 /*return*/, data];
+            }
+        });
+    });
+}

package/dist/getMetadata.d.ts

@@ -0,0 +1,23 @@
+import { Connection } from "@solana/web3.js";
+export interface RpcRequest {
+    jsonrpc: string;
+    id: number;
+    method: string;
+    params: any[];
+}
+/**
+ * Sends a JSON-RPC request to the Xandeum RPC endpoint to retrieve metadata
+ * about a file or directory at the given path.
+ *
+ * This function calls the custom RPC method `getMetadata`, which is implemented
+ * by the backend to return metadata such as type (file or directory), size,
+ * timestamps etc.
+ *
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param path - The filesystem path to query metadata for (e.g., `/documents/myfile.txt`).
+ *
+ * @returns A `Promise<any>` resolving to the parsed JSON response from the RPC server,
+ *          typically containing a `result` object with metadata fields.
+ *
+ */
+export declare function getMetadata(connection: Connection, path: string): Promise<any>;