@iqlabs-official/solana-sdk 0.1.7 → 0.1.8

package/README.md

@@ -408,7 +408,41 @@ myFiles.forEach(tx => {
 ```typescript
 import iqlabs from '@iqlabs-official/solana-sdk';
 
-iqlabs.utils.setRpcUrl('https://your-rpc.example.com');
+iqlabs.setRpcUrl('https://your-rpc.example.com');
+```
+
+### `getRpcUrl()`
+
+Returns the currently configured RPC URL.
+
+| Parameter | Type | Description |
+|---|---|---|
+| **Returns** | `string` | The current RPC URL |
+
+**Example:**
+```typescript
+const url = iqlabs.getRpcUrl();
+console.log(url); // https://api.mainnet-beta.solana.com
+```
+
+---
+
+### User Metadata
+
+#### `updateUserMetadata()`
+
+| **Parameters** | `connection`: Solana RPC Connection<br>`signer`: Signer<br>`dbRootId`: database ID (Uint8Array or string)<br>`meta`: metadata to store (Uint8Array or string) |
+|----------|--------------------------|
+| **Returns** | Transaction signature (string) |
+
+**Example:**
+```typescript
+import iqlabs from '@iqlabs-official/solana-sdk';
+
+await iqlabs.writer.updateUserMetadata(
+  connection, signer, 'my-db',
+  JSON.stringify({ name: 'Alice', bio: 'gm' })
+);
 ```
 
 ---

package/dist/sdk/writer/index.d.ts

@@ -1,2 +1,2 @@
 export { codeIn } from "./code_in";
-export { writeRow, writeConnectionRow, manageRowData, requestConnection, } from "./iqdb";
+export { writeRow, writeConnectionRow, manageRowData, requestConnection, updateUserMetadata, } from "./iqdb";

package/dist/sdk/writer/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requestConnection = exports.manageRowData = exports.writeConnectionRow = exports.writeRow = exports.codeIn = void 0;
+exports.updateUserMetadata = exports.requestConnection = exports.manageRowData = exports.writeConnectionRow = exports.writeRow = exports.codeIn = void 0;
 // writer: high-level flows only
 var code_in_1 = require("./code_in");
 Object.defineProperty(exports, "codeIn", { enumerable: true, get: function () { return code_in_1.codeIn; } });
@@ -9,3 +9,4 @@ Object.defineProperty(exports, "writeRow", { enumerable: true, get: function ()
 Object.defineProperty(exports, "writeConnectionRow", { enumerable: true, get: function () { return iqdb_1.writeConnectionRow; } });
 Object.defineProperty(exports, "manageRowData", { enumerable: true, get: function () { return iqdb_1.manageRowData; } });
 Object.defineProperty(exports, "requestConnection", { enumerable: true, get: function () { return iqdb_1.requestConnection; } });
+Object.defineProperty(exports, "updateUserMetadata", { enumerable: true, get: function () { return iqdb_1.updateUserMetadata; } });

package/dist/sdk/writer/iqdb.d.ts

@@ -9,4 +9,5 @@ export declare function resolveSignerAta(connection: Connection, signer: Signer,
 export declare function writeRow(connection: Connection, signer: Signer, dbRootId: Uint8Array | string, tableSeed: Uint8Array | string, rowJson: string, skipConfirmation?: boolean): Promise<string>;
 export declare function writeConnectionRow(connection: Connection, signer: Signer, dbRootId: Uint8Array | string, connectionSeed: Uint8Array | string, rowJson: string): Promise<string>;
 export declare function manageRowData(connection: Connection, signer: Signer, dbRootId: Uint8Array | string, seed: Uint8Array | string, rowJson: string, tableName?: string | Uint8Array, targetTx?: string | Uint8Array): Promise<string>;
+export declare function updateUserMetadata(connection: Connection, signer: Signer, dbRootId: Uint8Array | string, meta: Uint8Array | string): Promise<string>;
 export declare function requestConnection(connection: Connection, signer: Signer, dbRootId: Uint8Array | string, partyA: string, partyB: string, tableName: string | Uint8Array, columns: Array<string | Uint8Array>, idCol: string | Uint8Array, extKeys: Array<string | Uint8Array>): Promise<string>;

package/dist/sdk/writer/iqdb.js

@@ -5,6 +5,7 @@ exports.resolveSignerAta = resolveSignerAta;
 exports.writeRow = writeRow;
 exports.writeConnectionRow = writeConnectionRow;
 exports.manageRowData = manageRowData;
+exports.updateUserMetadata = updateUserMetadata;
 exports.requestConnection = requestConnection;
 const web3_js_1 = require("@solana/web3.js");
 const contract_1 = require("../../contract");
@@ -203,6 +204,24 @@ async function manageRowData(connection, signer, dbRootId, seed, rowJson, tableN
     }
     throw new Error("table/connection not found");
 }
+async function updateUserMetadata(connection, signer, dbRootId, meta) {
+    const programId = contract_1.PROGRAM_ID;
+    const builder = (0, contract_1.createInstructionBuilder)(IDL, programId);
+    const dbRootSeed = (0, seed_1.toSeedBytes)(dbRootId);
+    const dbRoot = (0, contract_1.getDbRootPda)(dbRootSeed, programId);
+    const user = (0, contract_1.getUserPda)(signer.publicKey, programId);
+    const metaBytes = typeof meta === "string" ? Buffer.from(meta, "utf8") : meta;
+    const ix = (0, contract_1.updateUserMetadataInstruction)(builder, {
+        user,
+        db_root: dbRoot,
+        signer: signer.publicKey,
+        system_program: web3_js_1.SystemProgram.programId,
+    }, {
+        db_root_id: dbRootSeed,
+        meta: metaBytes,
+    });
+    return (0, writer_utils_1.sendTx)(connection, signer, ix);
+}
 async function requestConnection(connection, signer, dbRootId, partyA, partyB, tableName, columns, idCol, extKeys) {
     // Validate requester
     const programId = contract_1.PROGRAM_ID;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iqlabs-official/solana-sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": ["dist", "idl"],