@xandeum/web3.js 1.2.0 → 1.3.1

package/dist/getXandeumResult.js

@@ -0,0 +1,115 @@
+"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.getXandeumResult = getXandeumResult;
+function sleep(ms) {
+    return new Promise(function (resolve) { return setTimeout(resolve, ms); });
+}
+/**
+ * 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.
+ */
+function getXandeumResult(connection, signature) {
+    return __awaiter(this, void 0, void 0, function () {
+        var url, maxAttempts, delayMs, attempt, response, text, data;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    url = connection.rpcEndpoint;
+                    maxAttempts = 3;
+                    delayMs = 5000;
+                    attempt = 1;
+                    _a.label = 1;
+                case 1:
+                    if (!(attempt <= maxAttempts)) return [3 /*break*/, 8];
+                    // Wait before every attempt (including the first one)
+                    return [4 /*yield*/, sleep(delayMs)];
+                case 2:
+                    // Wait before every attempt (including the first one)
+                    _a.sent();
+                    return [4 /*yield*/, fetch(url, {
+                            method: "POST",
+                            headers: { "Content-Type": "application/json" },
+                            body: JSON.stringify({
+                                jsonrpc: "2.0",
+                                id: 1,
+                                method: "getXandeumResult",
+                                params: [signature],
+                            }),
+                        })];
+                case 3:
+                    response = _a.sent();
+                    if (!!response.ok) return [3 /*break*/, 5];
+                    return [4 /*yield*/, response.text()];
+                case 4:
+                    text = _a.sent();
+                    console.error("Attempt ".concat(attempt, "/").concat(maxAttempts, " failed: ").concat(response.status, " ").concat(text));
+                    if (attempt === maxAttempts) {
+                        return [2 /*return*/, { result: null, error: "HTTP ".concat(response.status) }];
+                    }
+                    return [3 /*break*/, 7];
+                case 5: return [4 /*yield*/, response.json()];
+                case 6:
+                    data = _a.sent();
+                    // Change this condition if Xandeum uses a different "not ready" value
+                    if ((data === null || data === void 0 ? void 0 : data.result) != null && data.result !== "pending") {
+                        console.log("Got result on attempt ".concat(attempt));
+                        return [2 /*return*/, data]; // Success — return immediately
+                    }
+                    console.log("Attempt ".concat(attempt, "/").concat(maxAttempts, ": still pending..."));
+                    _a.label = 7;
+                case 7:
+                    attempt++;
+                    return [3 /*break*/, 1];
+                case 8:
+                    // All 3 attempts done, still no result
+                    console.log("Max attempts reached — result still not available");
+                    return [2 /*return*/, { result: null, error: "Result not ready after 3 attempts" }];
+            }
+        });
+    });
+}

package/dist/helpers.d.ts

@@ -0,0 +1,56 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Seed used for deriving the fee distributor PDA
+ */
+export declare const FEE_DISTRIBUTOR_SEED = "fee_distributor";
+/**
+ * Duration of one pulse in seconds
+ */
+export declare const PULSE_DURATION_SECONDS = 15;
+/**
+ * Number of pulses in one yuga
+ */
+export declare const PULSES_PER_YUGA = 16384;
+/**
+ * Duration of one yuga in seconds (16384 * 15 = 245,760 seconds ≈ 2.84 days)
+ */
+export declare const YUGA_DURATION_SECONDS: number;
+/**
+ * Unix timestamp (in seconds) when the first yuga started
+ */
+export declare const YUGA_START_TIMESTAMP = 1768898445;
+/**
+ * Calculates the yuga number from a given unix timestamp.
+ *
+ * @param unixTimestamp - Unix timestamp in seconds
+ * @returns The yuga number for the given timestamp
+ */
+export declare function getYugaFromTimestamp(unixTimestamp: number): number;
+/**
+ * Gets the current yuga value.
+ * Yuga represents an epoch or era in the Xandeum system.
+ * Each yuga lasts 245,760 seconds (approximately 2.84 days).
+ *
+ * @returns The current yuga number
+ */
+export declare function getCurrentYuga(): number;
+/**
+ * Derives the Program Derived Address (PDA) for the fee distributor account.
+ *
+ * The PDA is derived using:
+ * - The fee distributor seed
+ * - The current yuga (epoch) as little-endian bytes
+ *
+ * @returns An object containing the PDA public key and bump seed
+ *
+ * @example
+ * ```typescript
+ * const { pda, bump } = getFeeDistributorPda()
+ * console.log('Fee Distributor PDA:', pda.toBase58())
+ * console.log('Bump seed:', bump)
+ * ```
+ */
+export declare function getFeeDistributorPda(): {
+    pda: PublicKey;
+    bump: number;
+};

package/dist/helpers.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YUGA_START_TIMESTAMP = exports.YUGA_DURATION_SECONDS = exports.PULSES_PER_YUGA = exports.PULSE_DURATION_SECONDS = exports.FEE_DISTRIBUTOR_SEED = void 0;
+exports.getYugaFromTimestamp = getYugaFromTimestamp;
+exports.getCurrentYuga = getCurrentYuga;
+exports.getFeeDistributorPda = getFeeDistributorPda;
+var web3_js_1 = require("@solana/web3.js");
+var const_1 = require("./const");
+var bn_js_1 = __importDefault(require("bn.js"));
+/**
+ * Seed used for deriving the fee distributor PDA
+ */
+exports.FEE_DISTRIBUTOR_SEED = 'fee_distributor';
+/**
+ * Duration of one pulse in seconds
+ */
+exports.PULSE_DURATION_SECONDS = 15;
+/**
+ * Number of pulses in one yuga
+ */
+exports.PULSES_PER_YUGA = 16384;
+/**
+ * Duration of one yuga in seconds (16384 * 15 = 245,760 seconds ≈ 2.84 days)
+ */
+exports.YUGA_DURATION_SECONDS = exports.PULSES_PER_YUGA * exports.PULSE_DURATION_SECONDS;
+/**
+ * Unix timestamp (in seconds) when the first yuga started
+ */
+exports.YUGA_START_TIMESTAMP = 1768898445;
+/**
+ * Calculates the yuga number from a given unix timestamp.
+ *
+ * @param unixTimestamp - Unix timestamp in seconds
+ * @returns The yuga number for the given timestamp
+ */
+function getYugaFromTimestamp(unixTimestamp) {
+    if (unixTimestamp < exports.YUGA_START_TIMESTAMP) {
+        return 0;
+    }
+    return Math.floor((unixTimestamp - exports.YUGA_START_TIMESTAMP) / exports.YUGA_DURATION_SECONDS);
+}
+/**
+ * Gets the current yuga value.
+ * Yuga represents an epoch or era in the Xandeum system.
+ * Each yuga lasts 245,760 seconds (approximately 2.84 days).
+ *
+ * @returns The current yuga number
+ */
+function getCurrentYuga() {
+    var currentTime = Math.floor(Date.now() / 1000);
+    return getYugaFromTimestamp(currentTime);
+}
+/**
+ * Derives the Program Derived Address (PDA) for the fee distributor account.
+ *
+ * The PDA is derived using:
+ * - The fee distributor seed
+ * - The current yuga (epoch) as little-endian bytes
+ *
+ * @returns An object containing the PDA public key and bump seed
+ *
+ * @example
+ * ```typescript
+ * const { pda, bump } = getFeeDistributorPda()
+ * console.log('Fee Distributor PDA:', pda.toBase58())
+ * console.log('Bump seed:', bump)
+ * ```
+ */
+function getFeeDistributorPda() {
+    var yuga = getCurrentYuga();
+    var yugaBuffer = Buffer.from(new bn_js_1.default(yuga).toArray('le', 8));
+    var _a = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from(exports.FEE_DISTRIBUTOR_SEED, 'utf-8'),
+        yugaBuffer
+    ], new web3_js_1.PublicKey(const_1.stoincProgramId)), pda = _a[0], bump = _a[1];
+    return { pda: pda, bump: bump };
+}

package/dist/index.d.ts

@@ -9,6 +9,11 @@ export * from "./peek";
 export * from "./poke";
 export * from "./removeDirectory";
 export * from "./copyPath";
+export * from "./move";
+export * from "./getXandeumResult";
+export * from "./assignCoowner";
 export { exists } from "./exists";
 export { listDirectoryEntry } from "./listDirectoryEntery";
 export { getMetadata } from "./getMetadata";
+export { find } from "./find";
+export * from "./helpers";

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMetadata = exports.listDirectoryEntry = exports.exists = exports.bigbang = void 0;
+exports.find = exports.getMetadata = exports.listDirectoryEntry = exports.exists = exports.bigbang = void 0;
 var bigbang_1 = require("./bigbang");
 Object.defineProperty(exports, "bigbang", { enumerable: true, get: function () { return bigbang_1.bigbang; } });
 __exportStar(require("./webSocket"), exports);
@@ -27,9 +27,15 @@ __exportStar(require("./peek"), exports);
 __exportStar(require("./poke"), exports);
 __exportStar(require("./removeDirectory"), exports);
 __exportStar(require("./copyPath"), exports);
+__exportStar(require("./move"), exports);
+__exportStar(require("./getXandeumResult"), exports);
+__exportStar(require("./assignCoowner"), exports);
 var exists_1 = require("./exists");
 Object.defineProperty(exports, "exists", { enumerable: true, get: function () { return exists_1.exists; } });
 var listDirectoryEntery_1 = require("./listDirectoryEntery");
 Object.defineProperty(exports, "listDirectoryEntry", { enumerable: true, get: function () { return listDirectoryEntery_1.listDirectoryEntry; } });
 var getMetadata_1 = require("./getMetadata");
 Object.defineProperty(exports, "getMetadata", { enumerable: true, get: function () { return getMetadata_1.getMetadata; } });
+var find_1 = require("./find");
+Object.defineProperty(exports, "find", { enumerable: true, get: function () { return find_1.find; } });
+__exportStar(require("./helpers"), exports);

package/dist/listDirectoryEntery.js

@@ -52,7 +52,7 @@ exports.listDirectoryEntry = listDirectoryEntry;
  */
 function listDirectoryEntry(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:
@@ -72,11 +72,13 @@ function listDirectoryEntry(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/move.d.ts

@@ -0,0 +1,14 @@
+import { Transaction, PublicKey } from '@solana/web3.js';
+/**
+ * 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`).
+ * @param destPath - The destination path to copy to (e.g., `/archive`).
+ * @param name - The name of the new file or directory at the destination (e.g., `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.
+ *
+ */
+export declare function move(fsid: string, srcPath: string, destPath: string, name: string, wallet: PublicKey): Promise<Transaction>;

package/dist/move.js

@@ -0,0 +1,96 @@
+"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.move = move;
+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_1 = require("./helpers");
+/**
+ * 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`).
+ * @param destPath - The destination path to copy to (e.g., `/archive`).
+ * @param name - The name of the new file or directory at the destination (e.g., `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 move(fsid, srcPath, destPath, name, wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        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);
+            (0, sanitizePath_1.sanitizePath)(name);
+            rest = Buffer.from("".concat(srcPath, "\0").concat(destPath, "\0").concat(name), 'utf-8');
+            instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([0]).buffer),
+                Buffer.from(Int8Array.from([13]).buffer),
+                Buffer.from(Uint8Array.of.apply(Uint8Array, new bn_js_1.default(fsid).toArray('le', 8))),
+                rest
+            ]);
+            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),
+                data: instructionData
+            });
+            tx = new web3_js_1.Transaction().add(instruction);
+            return [2 /*return*/, tx];
+        });
+    });
+}

package/dist/pdaHelpers.d.ts

@@ -0,0 +1,57 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Seed used for deriving the fee distributor PDA
+ */
+export declare const FEE_DISTRIBUTOR_SEED = "fee_distributor";
+/**
+ * Duration of one pulse in seconds
+ */
+export declare const PULSE_DURATION_SECONDS = 15;
+/**
+ * Number of pulses in one yuga
+ */
+export declare const PULSES_PER_YUGA = 16384;
+/**
+ * Duration of one yuga in seconds (16384 * 15 = 245,760 seconds ≈ 2.84 days)
+ */
+export declare const YUGA_DURATION_SECONDS: number;
+/**
+ * Unix timestamp (in seconds) when the first yuga started
+ * TODO: Update this with your actual genesis timestamp
+ */
+export declare const YUGA_START_TIMESTAMP = 1640995200;
+/**
+ * Calculates the yuga number from a given unix timestamp.
+ *
+ * @param unixTimestamp - Unix timestamp in seconds
+ * @returns The yuga number for the given timestamp
+ */
+export declare function getYugaFromTimestamp(unixTimestamp: number): number;
+/**
+ * Gets the current yuga value.
+ * Yuga represents an epoch or era in the Xandeum system.
+ * Each yuga lasts 245,760 seconds (approximately 2.84 days).
+ *
+ * @returns The current yuga number
+ */
+export declare function getCurrentYuga(): number;
+/**
+ * Derives the Program Derived Address (PDA) for the fee distributor account.
+ *
+ * The PDA is derived using:
+ * - The fee distributor seed
+ * - The current yuga (epoch) as little-endian bytes
+ *
+ * @returns An object containing the PDA public key and bump seed
+ *
+ * @example
+ * ```typescript
+ * const { pda, bump } = getFeeDistributorPda()
+ * console.log('Fee Distributor PDA:', pda.toBase58())
+ * console.log('Bump seed:', bump)
+ * ```
+ */
+export declare function getFeeDistributorPda(): {
+    pda: PublicKey;
+    bump: number;
+};

package/dist/pdaHelpers.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YUGA_START_TIMESTAMP = exports.YUGA_DURATION_SECONDS = exports.PULSES_PER_YUGA = exports.PULSE_DURATION_SECONDS = exports.FEE_DISTRIBUTOR_SEED = void 0;
+exports.getYugaFromTimestamp = getYugaFromTimestamp;
+exports.getCurrentYuga = getCurrentYuga;
+exports.getFeeDistributorPda = getFeeDistributorPda;
+var web3_js_1 = require("@solana/web3.js");
+var const_1 = require("./const");
+var bn_js_1 = __importDefault(require("bn.js"));
+/**
+ * Seed used for deriving the fee distributor PDA
+ */
+exports.FEE_DISTRIBUTOR_SEED = 'fee_distributor';
+/**
+ * Duration of one pulse in seconds
+ */
+exports.PULSE_DURATION_SECONDS = 15;
+/**
+ * Number of pulses in one yuga
+ */
+exports.PULSES_PER_YUGA = 16384;
+/**
+ * Duration of one yuga in seconds (16384 * 15 = 245,760 seconds ≈ 2.84 days)
+ */
+exports.YUGA_DURATION_SECONDS = exports.PULSES_PER_YUGA * exports.PULSE_DURATION_SECONDS;
+/**
+ * Unix timestamp (in seconds) when the first yuga started
+ * TODO: Update this with your actual genesis timestamp
+ */
+exports.YUGA_START_TIMESTAMP = 1640995200; // Placeholder - update as needed
+/**
+ * Calculates the yuga number from a given unix timestamp.
+ *
+ * @param unixTimestamp - Unix timestamp in seconds
+ * @returns The yuga number for the given timestamp
+ */
+function getYugaFromTimestamp(unixTimestamp) {
+    if (unixTimestamp < exports.YUGA_START_TIMESTAMP) {
+        return 0;
+    }
+    return Math.floor((unixTimestamp - exports.YUGA_START_TIMESTAMP) / exports.YUGA_DURATION_SECONDS);
+}
+/**
+ * Gets the current yuga value.
+ * Yuga represents an epoch or era in the Xandeum system.
+ * Each yuga lasts 245,760 seconds (approximately 2.84 days).
+ *
+ * @returns The current yuga number
+ */
+function getCurrentYuga() {
+    var currentTime = Math.floor(Date.now() / 1000); // Convert milliseconds to seconds
+    return getYugaFromTimestamp(currentTime);
+}
+/**
+ * Derives the Program Derived Address (PDA) for the fee distributor account.
+ *
+ * The PDA is derived using:
+ * - The fee distributor seed
+ * - The current yuga (epoch) as little-endian bytes
+ *
+ * @returns An object containing the PDA public key and bump seed
+ *
+ * @example
+ * ```typescript
+ * const { pda, bump } = getFeeDistributorPda()
+ * console.log('Fee Distributor PDA:', pda.toBase58())
+ * console.log('Bump seed:', bump)
+ * ```
+ */
+function getFeeDistributorPda() {
+    var yuga = getCurrentYuga();
+    // Convert yuga to little-endian 8-byte array
+    var yugaBuffer = Buffer.from(new bn_js_1.default(yuga).toArray('le', 8));
+    // Find the PDA using the seed and yuga bytes
+    var _a = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from(exports.FEE_DISTRIBUTOR_SEED, 'utf-8'),
+        yugaBuffer
+    ], new web3_js_1.PublicKey(const_1.programId)), pda = _a[0], bump = _a[1];
+    return { pda: pda, bump: bump };
+}

package/dist/peek.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_1 = require("./helpers");
 /**
  * Constructs a Solana transaction to perform a "peek" operation on a file within a file system.
  *
@@ -59,23 +60,30 @@ var sanitizePath_1 = require("./sanitizePath");
  */
 function peek(fsid, path, startPosition, endPosition, 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) {
             (0, sanitizePath_1.sanitizePath)(path);
             rest = Buffer.from("".concat(path), 'utf-8');
             instructionData = Buffer.concat([
+                Buffer.from(Int8Array.from([0]).buffer),
                 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
             ]);
+            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/poke.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_1 = require("./helpers");
 /**
  * Constructs a Solana transaction to perform a poke\operation, which writes data
  * to a file at the specified path and byte position.
@@ -58,18 +59,20 @@ var sanitizePath_1 = require("./sanitizePath");
  */
 function poke(fsid, path, position, wallet, dataKey) {
     return __awaiter(this, void 0, void 0, function () {
-        var pathBuffer, pathLengthBuffer, instructionData, instruction, tx;
+        var pathBuffer, pathLengthBuffer, instructionData, feeDistributorPda, 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([0]).buffer),
                 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
             ]);
+            feeDistributorPda = (0, helpers_1.getFeeDistributorPda)();
             instruction = new web3_js_1.TransactionInstruction({
                 keys: [
                     {
@@ -81,6 +84,11 @@ function poke(fsid, path, position, wallet, dataKey) {
                         pubkey: dataKey,
                         isSigner: false,
                         isWritable: false
+                    },
+                    {
+                        pubkey: feeDistributorPda.pda,
+                        isSigner: false,
+                        isWritable: true
                     }
                 ],
                 programId: new web3_js_1.PublicKey(const_1.programId),