@xandeum/web3.js 0.5.0 → 0.8.0

package/docs/markdown/functions/poke.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **poke**(`fsid`, `path`, `position`, `wallet`, `dataKey`): `Promise`\<`Transaction`\>
 
-Defined in: [poke.ts:19](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/poke.ts#L19)
+Defined in: [poke.ts:19](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/poke.ts#L19)
 
 Constructs a Solana transaction to perform a poke\operation, which writes data
 to a file at the specified path and byte position.

package/docs/markdown/functions/removeDirectory.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **removeDirectory**(`fsid`, `path`, `wallet`): `Promise`\<`Transaction`\>
 
-Defined in: [removeDirectory.ts:17](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/removeDirectory.ts#L17)
+Defined in: [removeDirectory.ts:17](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/removeDirectory.ts#L17)
 
 Constructs a Solana transaction to perform a "remove directory" operation
 in a  file system, identified by a file system ID (`fsid`).

package/docs/markdown/functions/removeFile.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **removeFile**(`fsid`, `path`, `wallet`): `Promise`\<`Transaction`\>
 
-Defined in: [removeFile.ts:17](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/removeFile.ts#L17)
+Defined in: [removeFile.ts:17](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/removeFile.ts#L17)
 
 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.

package/docs/markdown/functions/renamePath.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **renamePath**(`fsid`, `oldPath`, `name`, `wallet`): `Promise`\<`Transaction`\>
 
-Defined in: [renamePath.ts:18](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/renamePath.ts#L18)
+Defined in: [renamePath.ts:18](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/renamePath.ts#L18)
 
 Constructs a Solana transaction to rename (or move) a file or directory
 within a file system, based on a provided file system ID (`fsid`).

package/docs/markdown/functions/subscribeResult.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **subscribeResult**(`connection`, `tx`, `onResult`, `onError?`, `onClose?`): `void`
 
-Defined in: [webSocket.ts:40](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/webSocket.ts#L40)
+Defined in: [webSocket.ts:40](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/webSocket.ts#L40)
 
 Opens a WebSocket connection and subscribes to the result of a transaction
 via the custom `xandeumResultSubscribe` method.

package/docs/markdown/functions/unsubscribeResult.md

@@ -1,4 +1,4 @@
-[**Xandeum Web3 Library v0.5.0**](../README.md)
+[**Xandeum Web3 Library v0.8.0**](../README.md)
 
 ***
 
@@ -8,7 +8,7 @@
 
 > **unsubscribeResult**(`connection`, `subscriptionId`): `void`
 
-Defined in: [webSocket.ts:103](https://github.com/Xandeum/xandeum-web3.js/blob/ingolstadt/src/webSocket.ts#L103)
+Defined in: [webSocket.ts:103](https://github.com/Xandeum/xandeum-web3.js/blob/master/src/webSocket.ts#L103)
 
 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).

package/docs/markdown/globals.md

@@ -1,8 +1,8 @@
-[**Xandeum Web3 Library v0.5.0**](README.md)
+[**Xandeum Web3 Library v0.8.0**](README.md)
 
 ***
 
-# Xandeum Web3 Library v0.5.0
+# Xandeum Web3 Library v0.8.0
 
 ## Functions
 
@@ -13,6 +13,7 @@
 - [createDirectory](functions/createDirectory.md)
 - [createFile](functions/createFile.md)
 - [exists](functions/exists.md)
+- [find](functions/find.md)
 - [getMetadata](functions/getMetadata.md)
 - [getXandeumResult](functions/getXandeumResult.md)
 - [listDirectoryEntry](functions/listDirectoryEntry.md)

package/docs/markdown/summary.md

@@ -0,0 +1,49 @@
+# Summary
+
+## Getting Started
+
+* [Introduction](README.md)
+* [Globals](globals.md)
+
+## Core Functions
+
+### File System Management
+
+* [bigbang](functions/bigbang.md)
+* [armageddon](functions/armageddon.md)
+
+### File Operations
+
+* [createFile](functions/createFile.md)
+* [removeFile](functions/removeFile.md)
+* [copyPath](functions/copyPath.md)
+* [renamePath](functions/renamePath.md)
+* [move](functions/move.md)
+
+### Directory Operations
+
+* [createDirectory](functions/createDirectory.md)
+* [removeDirectory](functions/removeDirectory.md)
+* [listDirectoryEntry](functions/listDirectoryEntry.md)
+
+### File Content Operations
+
+* [peek](functions/peek.md)
+* [poke](functions/poke.md)
+
+### Search & Query
+
+* [find](functions/find.md)
+
+### Metadata & Utilities
+
+* [exists](functions/exists.md)
+* [getMetadata](functions/getMetadata.md)
+* [getXandeumResult](functions/getXandeumResult.md)
+* [assignCoowner](functions/assignCoowner.md)
+
+### WebSocket Functions
+
+* [subscribeResult](functions/subscribeResult.md)
+* [unsubscribeResult](functions/unsubscribeResult.md)
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xandeum/web3.js",
-  "version": "0.5.0",
+  "version": "0.8.0",
   "description": "Xandeum javascript api",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/bigbang.ts

@@ -1,15 +1,18 @@
 import { Transaction, TransactionInstruction, PublicKey } from '@solana/web3.js'
+import BN from 'bn.js'
 import { programId } from './const'
 
 /**
  * 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.
  * @returns A Promise that resolves to a Solana `Transaction` object containing the bigbang instruction.
  */
-export async function bigbang (wallet: PublicKey): Promise<Transaction> {
+export async function bigbang(replica_count:string,wallet: PublicKey): Promise<Transaction> {
   const instructionData = Buffer.concat([
     Buffer.from(Int8Array.from([0]).buffer),
+    Buffer.from(Uint8Array.of(...new BN(replica_count).toArray('le', 8)))
   ])
 
   const instruction = new TransactionInstruction({

package/src/find.ts

@@ -0,0 +1,53 @@
+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 async function find (
+  connection: Connection,
+  path: string,
+  query: string,
+): Promise<any> {
+  const url = connection.rpcEndpoint;
+  const requestBody: RpcRequest = {
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'find',
+    params: [path,query]
+  }
+
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify(requestBody)
+  })
+
+  if (!response.ok) {
+    const errorText = await response.text(); 
+    return Error(`error! status: ${response.status}, message: ${errorText}`);
+  }
+
+  const data = await response.json()
+  return data
+}

package/src/index.ts

@@ -15,3 +15,4 @@ export * from "./assignCoowner";
 export {exists } from "./exists";
 export {listDirectoryEntry} from "./listDirectoryEntery";
 export {getMetadata} from "./getMetadata";
+export {find} from "./find";

package/typedoc.json

@@ -15,7 +15,7 @@
     "excludeInternal": true,
     "excludeNotDocumented": false,
     "gitRemote": "origin",
-    "gitRevision": "ingolstadt",
+    "gitRevision": "master",
     "sourceLinkTemplate": "https://github.com/Xandeum/xandeum-web3.js/blob/{gitRevision}/{path}#L{line}",
     "visibilityFilters": {
       "protected": false,