@xandeum/web3.js 1.1.0

package/dist/peek.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 };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.peek = peek;
+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 perform a "peek" operation on a file within a file system.
+ *
+ * The peek operation reads data between two byte offsets within a specified file path.
+ *
+ * @param fsid - A stringified integer representing the file system ID in which the file resides.
+ * @param path - The path to the file to be peeked.
+ * @param startPosition - The starting byte offset (inclusive) to begin reading from.
+ * @param endPosition - The ending byte offset (exclusive) to stop reading at.
+ * @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 peek instruction.
+ * @throws Will throw an error if the `path` contains invalid characters.
+ */
+function peek(fsid, path, startPosition, endPosition, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var rest, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            (0, sanitizePath_1.sanitizePath)(path);
+            rest = Buffer.from("".concat(path), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([3]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(startPosition).toArray('le', 8))),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(endPosition).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/poke.d.ts

@@ -0,0 +1,14 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to perform a poke\operation, which writes data
+ * to a file at the specified path and byte position.
+ *
+ * @param fsid - A stringified integer representing the file system ID where the file resides.
+ * @param path - The path to the file to be written to.
+ * @param position - The byte offset in the file where data should be written.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @param dataKey - A public key of a data account that holds the content to be written to the file.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the poke instruction.
+ * @throws Will throw an error if the `path` contains invalid characters.
+ */
+export declare function poke(fsid: string, path: string, position: number, wallet: PublicKey, dataKey: PublicKey): Promise<Transaction>;

package/dist/poke.js

@@ -0,0 +1,93 @@
+"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.poke = poke;
+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 perform a poke\operation, which writes data
+ * to a file at the specified path and byte position.
+ *
+ * @param fsid - A stringified integer representing the file system ID where the file resides.
+ * @param path - The path to the file to be written to.
+ * @param position - The byte offset in the file where data should be written.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @param dataKey - A public key of a data account that holds the content to be written to the file.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the poke instruction.
+ * @throws Will throw an error if the `path` contains invalid characters.
+ */
+function poke(fsid, path, position, wallet, dataKey) {
+    return __awaiter(this, void 0, void 0, function () {
+        var pathBuffer, pathLengthBuffer, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            (0, sanitizePath_1.sanitizePath)(path);
+            pathBuffer = Buffer.from(path, 'utf-8');
+            pathLengthBuffer = Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(pathBuffer.length).toArray('le', 8)));
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([4]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(position).toArray('le', 8))),
+                pathLengthBuffer,
+                pathBuffer
+            ]);
+            instruction = new web3_js_1.TransactionInstruction({
+                keys: [
+                    {
+                        pubkey: wallet,
+                        isSigner: true,
+                        isWritable: true
+                    },
+                    {
+                        pubkey: dataKey,
+                        isSigner: false,
+                        isWritable: false
+                    }
+                ],
+                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/removeDirectory.d.ts

@@ -0,0 +1,12 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to perform a "remove directory" operation
+ * in a  file system, identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID containing the directory.
+ * @param path - The full path to the directory that should be removed.
+ * @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 remove directory instruction.
+ * @throws May throw an error if the `path` fails validation in `sanitizePath`.
+ */
+export declare function removeDirectory(fsid: string, path: string, wallet: PublicKey): Promise<Transaction>;

package/dist/removeDirectory.js

@@ -0,0 +1,82 @@
+"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.removeDirectory = removeDirectory;
+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 perform a "remove directory" operation
+ * in a  file system, identified by a file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID containing the directory.
+ * @param path - The full path to the directory that should be removed.
+ * @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 remove directory instruction.
+ * @throws May throw an error if the `path` fails validation in `sanitizePath`.
+ */
+function removeDirectory(fsid, path, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            (0, sanitizePath_1.sanitizePath)(path);
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([7]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                Buffer.from("".concat(path), 'utf-8')
+            ]);
+            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/removeFile.d.ts

@@ -0,0 +1,12 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to remove a file from a  file system,
+ * identified by a file system ID (`fsid`) and a UTF-8 encoded file path.
+ *
+ * @param fsid - A stringified integer representing the file system ID in which the file resides.
+ * @param path - The full path to the file to be deleted.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the remove file instruction.
+ * @throws May throw an error if `path` is invalid per `sanitizePath`.
+ */
+export declare function removeFile(fsid: string, path: string, wallet: PublicKey): Promise<Transaction>;

package/dist/removeFile.js

@@ -0,0 +1,82 @@
+"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.removeFile = removeFile;
+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 remove a file from a  file system,
+ * identified by a file system ID (`fsid`) and a UTF-8 encoded file path.
+ *
+ * @param fsid - A stringified integer representing the file system ID in which the file resides.
+ * @param path - The full path to the file to be deleted.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the remove file instruction.
+ * @throws May throw an error if `path` is invalid per `sanitizePath`.
+ */
+function removeFile(fsid, path, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            (0, sanitizePath_1.sanitizePath)(path);
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([5]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                Buffer.from("".concat(path), 'utf-8')
+            ]);
+            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/renamePath.d.ts

@@ -0,0 +1,13 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * Constructs a Solana transaction to rename (or move) a file or directory
+ * within a file system, based on a provided file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the path exists.
+ * @param oldPath - The current path of the file or directory to be renamed or moved.
+ * @param name - The new name to assign to the file or directory.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the rename path instruction.
+ * @throws May throw an error if either `oldPath` or `newPath` is invalid per `sanitizePath`.
+ */
+export declare function renamePath(fsid: string, oldPath: string, name: string, wallet: PublicKey): Promise<Transaction>;

package/dist/renamePath.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.renamePath = renamePath;
+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 rename (or move) a file or directory
+ * within a file system, based on a provided file system ID (`fsid`).
+ *
+ * @param fsid - A stringified integer representing the file system ID where the path exists.
+ * @param oldPath - The current path of the file or directory to be renamed or moved.
+ * @param name - The new name to assign to the file or directory.
+ * @param wallet - The public key of the wallet that signs and authorizes the transaction.
+ * @returns A Promise that resolves to a Solana `Transaction` object containing the rename path instruction.
+ * @throws May throw an error if either `oldPath` or `newPath` is invalid per `sanitizePath`.
+ */
+function renamePath(fsid, oldPath, name, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var rest, instructionData, instruction, tx;
+        return __generator(this, function (_a) {
+            (0, sanitizePath_1.sanitizePath)(oldPath);
+            (0, sanitizePath_1.sanitizePath)(name);
+            rest = Buffer.from("".concat(oldPath, "\0").concat(name), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([8]).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/sanitizePath.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Sanitizes file path for validate path.
+ * Ensures the path contains only allowed characters, prevents path traversal,
+ * and normalizes the path to start with a single slash.
+ *
+ * Allowed characters: alphanumeric, '/', '_', '-', '.'
+ * Disallowed: consecutive slashes (//), path traversal (..), control characters,
+ *             invalid filesystem characters (<, >, :, ", \, |, ?, *),
+ *             empty or whitespace-only paths.
+ *
+ * @param path - The file path to sanitize.
+ * @throws Error if the path is invalid.
+ */
+export declare function sanitizePath(path: string): void;

package/dist/sanitizePath.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizePath = sanitizePath;
+/**
+ * Sanitizes file path for validate path.
+ * Ensures the path contains only allowed characters, prevents path traversal,
+ * and normalizes the path to start with a single slash.
+ *
+ * Allowed characters: alphanumeric, '/', '_', '-', '.'
+ * Disallowed: consecutive slashes (//), path traversal (..), control characters,
+ *             invalid filesystem characters (<, >, :, ", \, |, ?, *),
+ *             empty or whitespace-only paths.
+ *
+ * @param path - The file path to sanitize.
+ * @throws Error if the path is invalid.
+ */
+function sanitizePath(path) {
+    // Check for empty or whitespace-only paths
+    if (!path || path.trim() === "") {
+        throw new Error("Path cannot be empty or whitespace-only");
+    }
+    // Check for consecutive slashes (// or more)
+    if (/\/\/+/.test(path)) {
+        throw new Error("Consecutive slashes (//) are not allowed");
+    }
+    // Check for path traversal sequences (..)
+    if (path.includes("..")) {
+        throw new Error("Path traversal sequences (..) are not allowed");
+    }
+    // Check for control characters (ASCII 0-31 and 127)
+    for (var i = 0; i < path.length; i++) {
+        var code = path.charCodeAt(i);
+        if (code <= 31 || code === 127) {
+            throw new Error("Control characters are not allowed in paths");
+        }
+    }
+    // Check for allowed characters: alphanumeric, /, _, -, .
+    if (!/^[a-zA-Z0-9\/_\-\.]*$/.test(path)) {
+        throw new Error("Path must contain only alphanumeric characters, single slashes, underscores (_), hyphens (-), or periods (.)");
+    }
+    // Check for invalid filesystem characters
+    var invalidChars = ["<", ">", ":", '"', "\\", "|", "?", "*"];
+    for (var i = 0; i < path.length; i++) {
+        if (invalidChars.includes(path[i])) {
+            throw new Error('Path contains invalid filesystem characters (<, >, :, ", \\, |, ?, *)');
+        }
+    }
+    // Check path component length (max 255 bytes)
+    var components = path.split("/").filter(function (c) { return c.length > 0; });
+    for (var _i = 0, components_1 = components; _i < components_1.length; _i++) {
+        var component = components_1[_i];
+        if (new TextEncoder().encode(component).length > 255) {
+            throw new Error("Path component exceeds 255 bytes");
+        }
+    }
+    // Check total path length (max 4096 bytes)
+    if (new TextEncoder().encode(path).length > 4096) {
+        throw new Error("Total path length exceeds 4096 bytes");
+    }
+}

package/dist/webSocket.d.ts

@@ -0,0 +1,47 @@
+import { Connection } from "@solana/web3.js";
+/**
+ * Represents the structure of result data received from a WebSocket subscription.
+ *
+ * - `fsid` (optional): The file system ID returned from the result.
+ * - `status` (optional): The status of the transaction or operation.
+ * - `data` (optional): Any custom payload or message associated with the result.
+ * - `subscription` (optional): The ID of the WebSocket subscription.
+ */
+type ResultValue = {
+    fsid?: string;
+    status?: string;
+    data?: any;
+    subscription?: string;
+};
+/**
+ * Opens a WebSocket connection and subscribes to the result of a transaction
+ * via the custom `xandeumResultSubscribe` method.
+ *
+ * This is useful for receiving asynchronous results tied to an on-chain operation,
+ * such as file creation, modification, or deletion.
+ *
+ * The subscription sends a JSON-RPC request with:
+ * - `method`: "xandeumResultSubscribe"
+ * - `params`: [txId, { commitment: "finalized" }]
+ *
+ * The WebSocket listens for result messages and invokes the `onResult` callback
+ * if a valid result with `fsid`, `status`, or `data` is received.
+ *
+ * @param tx - The transaction ID you want to listen for results from.
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ * @param onResult - Callback to handle incoming result messages. Triggered when a valid response is received.
+ * @param onError - (Optional) Callback triggered if a WebSocket error occurs.
+ * @param onClose - (Optional) Callback triggered when the WebSocket connection closes.
+ */
+export declare function subscribeResult(connection: Connection, tx: string, onResult: (value: ResultValue) => void, onError?: (err: any) => void, onClose?: () => void): void;
+/**
+ * Sends a WebSocket JSON-RPC message to unsubscribe from a previously subscribed transaction result
+ * using the `xandeumResultUnsubscribed` method (note: custom method, ensure server-side implementation matches).
+ *
+ * This function automatically closes the WebSocket connection after sending the unsubscribe request.
+ *
+ * @param subscriptionId - The ID of the active subscription you want to cancel.
+ * @param connection - The solana web3 connection with Xandeum-compatible JSON-RPC endpoint (e.g., `'https://api.devnet.solana.com'`).
+ */
+export declare function unsubscribeResult(connection: Connection, subscriptionId: string): void;
+export {};