@xandeum/web3.js 1.2.0 → 1.3.1

package/README.md

@@ -38,7 +38,8 @@ import {
 import {
   Connection,
   sendAndConfirmTransaction,
-  Keypair
+  Keypair,
+  PublicKey
 } from '@solana/web3.js'
 
 const connection = new Connection('https://apis.devnet.xandeum.com)
@@ -51,15 +52,17 @@ async function main() {
   await sendAndConfirmTransaction(connection, tx1, [signer])
 
   // Create a file
-  const tx2 = await createFile('1', '/1','hello.txt', wallet)
+  const tx2 = await createFile('1', '/','hello.txt', wallet)
   await sendAndConfirmTransaction(connection, tx2, [signer])
 
+  const dataAccount = new PublicKey("FBM4G63KPUneqyLwQy6zVu81AsMqmkQjsdxNGBKq3dkv");
+  
   // Write data
-  const tx3 = await poke('1', '/1/hello.txt', 0, Buffer.from('Hello Xandeum!'), wallet)
+  const tx3 = await poke('1', '/hello.txt', 0, Buffer.from('Hello Xandeum!'), wallet)
   await sendAndConfirmTransaction(connection, tx3, [signer])
 
   // Read data
-  const tx4 = await peek('1', '/1/hello.txt', 0, 14, wallet)
+  const tx4 = await peek('1', '/hello.txt', 0, 14, wallet)
   await sendAndConfirmTransaction(connection, tx4, [signer])
 }
 ```
@@ -140,7 +143,7 @@ const signer = Keypair.generate()
 const wallet = signer.publicKey
 
 async function main() {
-  const tx = await createFile('1', '/1/hello.txt', wallet)
+  const tx = await createFile('1', '/hello.txt', wallet)
   const txSignature = await sendAndConfirmTransaction(connection, tx, [signer])
 
   subscribeResult(
@@ -155,7 +158,7 @@ async function main() {
 }
 ```
 
-MIT © Xandeum
+Apache-2.0 © Xandeum
 
 👤 Author
 

package/archbee.yaml

@@ -0,0 +1,55 @@
+# Archbee Configuration for Xandeum Pod Documentation
+# This file must be in the root of your repository
+# Reference: https://www.archbee.com/docs/set-up-the-repository
+
+# Define where the markdown docs are located
+# This tells Archbee where to find your markdown files
+root: docs/markdown
+
+# Structure configuration
+structure:
+  # summary.md defines the document tree navigation in Archbee
+  summary: summary.md
+  # Assets folder relative to docspath
+  assets: assets
+
+# Auto-publish to production after each commit
+publishspace: true
+
+# Document tree options (for OpenAPI/Swagger if needed)
+doctreeoptions:
+  openapitryit: true
+  showdownloadopenapifile: true
+  shouldcreateschemacategory: true
+  shouldcreateintro: true
+  openapilanguageexamples:
+    - value: bash
+      label: Bash
+    - value: javascript
+      label: JavaScript
+    - value: python
+      label: Python
+
+# Custom CSS (optional - add your brand styling)
+customcss: |
+  :root {
+    --primary-color: #your-brand-color;
+    --accent-color: #your-accent-color;
+  }
+
+# Custom JavaScript (optional)
+customjs: ""
+
+# Footer template (optional)
+footertemplate: |
+  <div style="text-align: center; padding: 20px;">
+    <p>Made with ❤️ by the Xandeum Team</p>
+    <p>
+      <a href="https://github.com/xandeum" target="_blank">GitHub</a> | 
+      <a href="https://twitter.com/xandeum" target="_blank">Twitter</a>
+    </p>
+  </div>
+
+# Header includes (optional - for analytics, etc.)
+headerincludes: ""
+

package/dist/armageddon.js

@@ -43,6 +43,7 @@ exports.armageddon = armageddon;
 var web3_js_1 = require("@solana/web3.js");
 var bn_js_1 = __importDefault(require("bn.js"));
 var const_js_1 = require("./const.js");
+var helpers_js_1 = require("./helpers.js");
 /**
  * Constructs a Solana transaction that triggers the "armageddon" instruction
  * on the specified file system (fsid).
@@ -53,18 +54,25 @@ var const_js_1 = require("./const.js");
  */
 function armageddon(fsid, wallet) {
     return __awaiter(this, void 0, void 0, function () {
-        var instructionData, instruction, tx;
+        var instructionData, feeDistributorPda, instruction, tx;
         return __generator(this, function (_a) {
             instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([0]).buffer),
                 Buffer.from(Int8Array.from([1]).buffer),
                 Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8)))
             ]);
+            feeDistributorPda = (0, helpers_js_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
                         pubkey: wallet,
                         isSigner: true,
                         isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_js_1.programId),

package/dist/assignCoowner.d.ts

@@ -0,0 +1,12 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to assign a co-owner to a file or directory
+ * identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the co-owner is to be assigned.
+ * @param path - The path within the file system.
+ * @param coowner - The public key of the co-owner to be assigned.
+ * @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 assignCoowner instruction.
+ */
+export declare function assignCoowner(fsid: string, path: string, coowner: PublicKey, wallet: PublicKey): Promise<Transaction>;

package/dist/assignCoowner.js

@@ -0,0 +1,89 @@
+"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.assignCoowner = assignCoowner;
+var web3_js_1 = require("@solana/web3.js");
+var const_1 = require("./const");
+var bn_js_1 = __importDefault(require("bn.js"));
+var helpers_js_1 = require("./helpers.js");
+/**
+ * Constructs a Solana transaction to assign a co-owner to a file or directory
+ * identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the co-owner is to be assigned.
+ * @param path - The path within the file system.
+ * @param coowner - The public key of the co-owner to be assigned.
+ * @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 assignCoowner instruction.
+ */
+function assignCoowner(fsid, path, coowner, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var rest, instructionData, feeDistributorPda, instruction, tx;
+        return __generator(this, function (_a) {
+            rest = Buffer.from("".concat(path, "\0").concat(coowner.toString()), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([0]).buffer),
+                Buffer.from(Int8Array.from([14]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                rest
+            ]);
+            feeDistributorPda = (0, helpers_js_1.getFeeDistributorPda)();
+            instruction = new web3_js_1.TransactionInstruction({
+                keys: [
+                    {
+                        pubkey: wallet,
+                        isSigner: true,
+                        isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        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/bigbang.d.ts

@@ -3,6 +3,7 @@ import { Transaction, PublicKey } from '@solana/web3.js';
  * Constructs a Solana transaction that triggers the "bigbang" instruction and create new file system.
  *
  * @param wallet - The public key of the wallet that will sign and authorize the transaction.
+ * @param replica_count - A stringified integer representing the number of replicas for the new file system. Must be 2 or greater. The total number of copies will be replica_count + 1 (one original plus the replicas).
  * @returns A Promise that resolves to a Solana `Transaction` object containing the bigbang instruction.
  */
-export declare function bigbang(wallet: PublicKey): Promise<Transaction>;
+export declare function bigbang(replica_count: string, wallet: PublicKey): Promise<Transaction>;

package/dist/bigbang.js

@@ -35,29 +35,43 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         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.bigbang = bigbang;
 var web3_js_1 = require("@solana/web3.js");
+var bn_js_1 = __importDefault(require("bn.js"));
 var const_1 = require("./const");
+var helpers_1 = require("./helpers");
 /**
  * Constructs a Solana transaction that triggers the "bigbang" instruction and create new file system.
  *
  * @param wallet - The public key of the wallet that will sign and authorize the transaction.
+ * @param replica_count - A stringified integer representing the number of replicas for the new file system. Must be 2 or greater. The total number of copies will be replica_count + 1 (one original plus the replicas).
  * @returns A Promise that resolves to a Solana `Transaction` object containing the bigbang instruction.
  */
-function bigbang(wallet) {
+function bigbang(replica_count, wallet) {
     return __awaiter(this, void 0, void 0, function () {
-        var instructionData, instruction, tx;
+        var instructionData, feeDistributorPda, instruction, tx;
         return __generator(this, function (_a) {
             instructionData = Buffer.concat([
-                Buffer.from(Int8Array.from([0]).buffer)
+                Buffer.from(Int8Array.from([0]).buffer),
+                Buffer.from(Int8Array.from([0]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(replica_count).toArray('le', 8)))
             ]);
+            feeDistributorPda = (0, helpers_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
                         pubkey: wallet,
                         isSigner: true,
                         isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_1.programId),

package/dist/const.d.ts

@@ -1 +1,2 @@
 export declare const programId = "xSHLJPXU8QW3A9kGiRoL94bksJ7ZZPY4dUwJPAT8CVK";
+export declare const stoincProgramId = "EaLDF7m76kzvrpeADHVHPLfk5qpPaPxYUYqYApByLp1S";

package/dist/const.js

@@ -1,4 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.programId = void 0;
+exports.stoincProgramId = exports.programId = void 0;
 exports.programId = "xSHLJPXU8QW3A9kGiRoL94bksJ7ZZPY4dUwJPAT8CVK";
+exports.stoincProgramId = "EaLDF7m76kzvrpeADHVHPLfk5qpPaPxYUYqYApByLp1S";

package/dist/copyPath.js

@@ -44,6 +44,7 @@ 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");
+var helpers_js_1 = require("./helpers.js");
 /**
  * Constructs a Solana transaction to copy a file or directory from one  path to another.
  *
@@ -57,23 +58,30 @@ var sanitizePath_1 = require("./sanitizePath");
  */
 function copyPath(fsid, srcPath, destPath, wallet) {
     return __awaiter(this, void 0, void 0, function () {
-        var rest, instructionData, instruction, tx;
+        var rest, instructionData, feeDistributorPda, 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([0]).buffer),
                 Buffer.from(Int8Array.from([9]).buffer),
                 Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
                 rest
             ]);
+            feeDistributorPda = (0, helpers_js_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
                         pubkey: wallet,
                         isSigner: true,
                         isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_1.programId),

package/dist/createDirectory.js

@@ -44,6 +44,7 @@ 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");
+var helpers_js_1 = require("./helpers.js");
 /**
  * Constructs a Solana transaction to create a new directory within a  file system.
  *
@@ -56,22 +57,29 @@ var sanitizePath_1 = require("./sanitizePath");
  */
 function createDirectory(fsid, path, name, wallet) {
     return __awaiter(this, void 0, void 0, function () {
-        var combinedPath, rest, instructionData, instruction, tx;
+        var combinedPath, rest, instructionData, feeDistributorPda, instruction, tx;
         return __generator(this, function (_a) {
-            combinedPath = path + '/' + name;
+            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([0]).buffer),
                 Buffer.from(Int8Array.from([6]).buffer),
                 Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
                 rest
             ]);
+            feeDistributorPda = (0, helpers_js_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
                         pubkey: wallet,
                         isSigner: true,
                         isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_1.programId),

package/dist/createFile.js

@@ -44,6 +44,7 @@ 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");
+var helpers_js_1 = require("./helpers.js");
 /**
  * Constructs a Solana transaction to create a new file
  * within a file system, identified by a file system ID (`fsid`).
@@ -57,22 +58,29 @@ var sanitizePath_1 = require("./sanitizePath");
  */
 function createFile(fsid, path, name, wallet) {
     return __awaiter(this, void 0, void 0, function () {
-        var combinedPath, rest, instructionData, instruction, tx;
+        var combinedPath, rest, instructionData, feeDistributorPda, instruction, tx;
         return __generator(this, function (_a) {
-            combinedPath = path + '/' + name;
+            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([0]).buffer),
                 Buffer.from(Int8Array.from([2]).buffer),
                 Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
                 rest
             ]);
+            feeDistributorPda = (0, helpers_js_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
                         pubkey: wallet,
                         isSigner: true,
                         isWritable: true
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_1.programId),

package/dist/exists.js

@@ -51,7 +51,7 @@ exports.exists = exists;
  */
 function exists(connection, path) {
     return __awaiter(this, void 0, void 0, function () {
-        var url, requestBody, response, data;
+        var url, requestBody, response, errorText, data;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -71,11 +71,13 @@ function exists(connection, path) {
                         })];
                 case 1:
                     response = _a.sent();
-                    if (!response.ok) {
-                        throw new Error("HTTP error! Status: ".concat(response.status));
-                    }
-                    return [4 /*yield*/, response.json()];
+                    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 find(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.find = find;
+/**
+ * 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 find(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/getMetadata.js

@@ -54,7 +54,7 @@ exports.getMetadata = getMetadata;
  */
 function getMetadata(connection, path) {
     return __awaiter(this, void 0, void 0, function () {
-        var url, requestBody, response, data;
+        var url, requestBody, response, errorText, data;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -74,11 +74,13 @@ function getMetadata(connection, path) {
                         })];
                 case 1:
                     response = _a.sent();
-                    if (!response.ok) {
-                        throw new Error("HTTP error! Status: ".concat(response.status));
-                    }
-                    return [4 /*yield*/, response.json()];
+                    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/getXandeumResult.d.ts

@@ -0,0 +1,15 @@
+import { Connection } from "@solana/web3.js";
+/**
+ * Sends a JSON-RPC request to the Xandeum-compatible endpoint to retrieve
+ * the result of a transaction previously submitted with a specific signature.
+ *
+ * This function calls the custom RPC method `getXandeumResult`, which returns
+ * the result associated with the given transaction signature.
+ *
+ * @param connection - The Solana web3 connection object pointing to a Xandeum-compatible RPC endpoint.
+ * @param signature - The transaction signature string whose result should be queried.
+ *
+ * @returns A `Promise<any>` resolving to the parsed JSON response from the RPC server,
+ *          which includes the result of the transaction if available.
+ */
+export declare function getXandeumResult(connection: Connection, signature: string): Promise<any>;