@flashbacktech/flashbackclient 0.2.69 → 0.2.71

package/dist/stellarv2/client/deal.js

@@ -136,11 +136,17 @@ class DealOps {
          * @returns Promise resolving to the payment result
          */
         this.payPendingConsumption = (0, decorator_1.withSignature)(async (provider_id, consumer_id, deal_id) => {
-            await (0, transaction_1.executeWalletTransaction)(this.context, '', "pay_pending_consumption", [
+            const args = [
                 { value: provider_id, type: 'address' },
                 { value: consumer_id, type: 'address' },
                 { value: deal_id, type: 'u32' }
-            ]);
+            ];
+            if (this.context.serverSourceAddress) {
+                await (0, transaction_1.executeServerTransaction)(this.context, this.context.serverSourceAddress, "pay_pending_consumption", args);
+            }
+            else {
+                await (0, transaction_1.executeWalletTransaction)(this.context, '', "pay_pending_consumption", args);
+            }
         });
         /**
          * Updates deal consumption metrics (owner only)
@@ -151,13 +157,19 @@ class DealOps {
          * @returns Promise resolving to the update result
          */
         this.updateDealConsumption = (0, decorator_1.withSignature)(async (provider_id, consumer_id, deal_id, params) => {
-            await (0, transaction_1.executeWalletTransaction)(this.context, '', "update_deal_consumption", [
+            const args = [
                 { value: provider_id, type: 'address' },
                 { value: consumer_id, type: 'address' },
                 { value: deal_id, type: 'u32' },
                 { value: params.storage_mb, type: 'u64' },
                 { value: params.egress_mb, type: 'u64' }
-            ]);
+            ];
+            if (this.context.serverSourceAddress) {
+                await (0, transaction_1.executeServerTransaction)(this.context, this.context.serverSourceAddress, "update_deal_consumption", args);
+            }
+            else {
+                await (0, transaction_1.executeWalletTransaction)(this.context, '', "update_deal_consumption", args);
+            }
         });
         /**
          * Updates deal SLA metrics (owner only)
@@ -168,13 +180,19 @@ class DealOps {
          * @returns Promise resolving to the update result
          */
         this.updateDealSLA = (0, decorator_1.withSignature)(async (provider_id, consumer_id, deal_id, params) => {
-            await (0, transaction_1.executeWalletTransaction)(this.context, '', "update_deal_sla", [
+            const args = [
                 { value: provider_id, type: 'address' },
                 { value: consumer_id, type: 'address' },
                 { value: deal_id, type: 'u32' },
                 { value: params.sla_avg_latency_ms, type: 'u32' },
                 { value: params.sla_avg_uptime_pct, type: 'u32' }
-            ]);
+            ];
+            if (this.context.serverSourceAddress) {
+                await (0, transaction_1.executeServerTransaction)(this.context, this.context.serverSourceAddress, "update_deal_sla", args);
+            }
+            else {
+                await (0, transaction_1.executeWalletTransaction)(this.context, '', "update_deal_sla", args);
+            }
         });
         this.context = context;
     }

package/dist/stellarv2/client/index.d.ts

@@ -18,6 +18,13 @@ export interface FlashOnStellarClientConfigV2 {
     signTransaction?: (xdrToSign: string) => Promise<string>;
     /** Network configuration for Stellar (testnet/public) */
     network: StellarNetwork;
+    /**
+     * Stellar public key used as the source account for owner-only
+     * server-side operations (e.g. oracle worker calls).
+     * When set, owner-only methods use executeServerTransaction
+     * which does NOT prepend this address to the contract args.
+     */
+    serverSourceAddress?: string;
 }
 export type ClientContext = FlashOnStellarClientConfigV2;
 /**

package/dist/stellarv2/wallet/transaction.d.ts

@@ -7,6 +7,12 @@ export interface StellarNetwork {
 }
 declare const getNetwork: (network: string) => StellarNetwork;
 declare const getPublicKeyFromPrivateKey: (privateKey: string) => string;
+/**
+ * Set a custom Soroban RPC server URL for a network.
+ * Use this to point the client at a different RPC endpoint (e.g. your own node).
+ * Pass `undefined` as url to clear the override and revert to the default for that network.
+ */
+export declare const setServer: (network: string, url: string | undefined) => void;
 declare const getServer: (network: StellarNetwork) => rpc.Server;
 interface ContractMethodCall {
     method: string;
@@ -21,6 +27,16 @@ export interface ContractMethodResponse {
     result: string | unknown;
 }
 export declare const getHorizonServer: (network: string) => Horizon.Server;
+/**
+ * Executes a contract call using a server-side source account.
+ * Unlike executeWalletTransaction, this does NOT prepend the source address
+ * to the contract args — the args are passed as-is to the contract method.
+ * Used for owner-only operations invoked from backend workers.
+ */
+export declare const executeServerTransaction: (context: ClientContext, sourceAddress: string, method: string, args?: Array<{
+    value: string | number | bigint | boolean | null | Array<unknown> | undefined;
+    type: "string" | "symbol" | "address" | "u32" | "i32" | "u64" | "i64" | "u128" | "i128" | "bool" | "vec";
+}>) => Promise<ContractMethodResponse>;
 export declare const executeWalletTransaction: (context: ClientContext, wallet_address: string, method: string, additionalArgs?: Array<{
     value: string | number | bigint | boolean | null | Array<unknown> | undefined;
     type: "string" | "symbol" | "address" | "u32" | "i32" | "u64" | "i64" | "u128" | "i128" | "bool" | "vec";
@@ -34,5 +50,10 @@ export declare const executeMultiWalletTransactions: (context: ClientContext, wa
 }>, extraOperations?: xdr.Operation[]) => Promise<ContractMethodResponse>;
 declare const prepareTransaction: (context: ClientContext, address: string, contractCalls: ContractMethodCall | ContractMethodCall[], extraOperations?: xdr.Operation[]) => Promise<ContractMethodResponse>;
 declare const signTransaction: (context: ClientContext, xdrToSign: string, privateKey: string) => Promise<Transaction<Memo<MemoType>, Operation[]> | FeeBumpTransaction>;
+/**
+ * Creates a signTransaction callback that signs with a private key.
+ * Use this for server-side / backend workers where there is no browser wallet.
+ */
+export declare const createPrivateKeySigner: (secretKey: string, networkPassphrase: string) => ((xdrToSign: string) => Promise<string>);
 declare const sendTransaction: (context: ClientContext, signedTransactionXDR: string, bDebug?: boolean) => Promise<any>;
 export { prepareTransaction, sendTransaction, signTransaction, getNetwork, getPublicKeyFromPrivateKey, getServer, };

package/dist/stellarv2/wallet/transaction.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getServer = exports.getPublicKeyFromPrivateKey = exports.getNetwork = exports.signTransaction = exports.sendTransaction = exports.prepareTransaction = exports.executeMultiWalletTransactions = exports.executeWalletTransaction = exports.getHorizonServer = void 0;
+exports.getServer = exports.getPublicKeyFromPrivateKey = exports.getNetwork = exports.signTransaction = exports.sendTransaction = exports.prepareTransaction = exports.createPrivateKeySigner = exports.executeMultiWalletTransactions = exports.executeWalletTransaction = exports.executeServerTransaction = exports.getHorizonServer = exports.setServer = void 0;
 const timing_1 = require("../utils/timing");
 // Polyfill for BigInt JSON serialization
 BigInt.prototype.toJSON = function () {
@@ -32,30 +32,37 @@ const getPublicKeyFromPrivateKey = (privateKey) => {
     return keypair.publicKey();
 };
 exports.getPublicKeyFromPrivateKey = getPublicKeyFromPrivateKey;
+const DEFAULT_RPC_URLS = {
+    TESTNET: "https://soroban-testnet.stellar.org",
+    PUBLIC: "https://soroban-rpc.creit.tech",
+};
+const customRpcUrls = {};
+/**
+ * Set a custom Soroban RPC server URL for a network.
+ * Use this to point the client at a different RPC endpoint (e.g. your own node).
+ * Pass `undefined` as url to clear the override and revert to the default for that network.
+ */
+const setServer = (network, url) => {
+    if (url === undefined) {
+        delete customRpcUrls[network];
+    }
+    else {
+        customRpcUrls[network] = url;
+    }
+};
+exports.setServer = setServer;
 const getServer = (network) => {
-    let serverUrl = "";
-    switch (network.network) {
-        case "TESTNET":
-            serverUrl = "https://soroban-testnet.stellar.org";
-            break;
-        case "PUBLIC":
-            //serverUrl = "https://rpc.stellar.org";
-            //serverUrl = "https://stellar-soroban-public.nodies.app";
-            serverUrl = "https://soroban-rpc.mainnet.stellar.gateway.fm";
-            break;
+    const serverUrl = customRpcUrls[network.network] ?? DEFAULT_RPC_URLS[network.network] ?? "";
+    if (!serverUrl) {
+        throw new Error(`No RPC URL configured for network "${network.network}". Use setServer(network, url) or ensure the network is one of: TESTNET, PUBLIC.`);
     }
-    // For Stellar SDK v13+, we need to handle the allowHttp issue
-    let server;
-    // Approach 1: Try with allowHttp option
     try {
-        server = new stellar_sdk_2.rpc.Server(serverUrl, { allowHttp: true });
-        return server;
+        return new stellar_sdk_2.rpc.Server(serverUrl, { allowHttp: true });
     }
     catch (error) {
         console.log(`Failed with allowHttp: true:`, error instanceof Error ? error.message : String(error));
+        throw new Error(`Failed to create Soroban RPC server for ${network.network} at ${serverUrl}. All configuration attempts failed.`);
     }
-    // If all approaches fail, throw a comprehensive error
-    throw new Error(`Failed to create Soroban RPC server for ${network.network} at ${serverUrl}. All configuration attempts failed.`);
 };
 exports.getServer = getServer;
 const TIMEOUT_TRANSACTION = 60;
@@ -72,6 +79,38 @@ const getHorizonServer = (network) => {
     }
 };
 exports.getHorizonServer = getHorizonServer;
+/**
+ * Executes a contract call using a server-side source account.
+ * Unlike executeWalletTransaction, this does NOT prepend the source address
+ * to the contract args — the args are passed as-is to the contract method.
+ * Used for owner-only operations invoked from backend workers.
+ */
+const executeServerTransaction = async (context, sourceAddress, method, args = []) => {
+    try {
+        const response = await prepareTransaction(context, sourceAddress, {
+            method,
+            args,
+        });
+        if (response.isSuccess) {
+            if (response.isReadOnly) {
+                return response;
+            }
+            const signedTxXDR = await context.signTransaction(response.result);
+            const sendResponse = await sendTransaction(context, signedTxXDR);
+            return {
+                isSuccess: true,
+                isReadOnly: false,
+                result: sendResponse,
+            };
+        }
+        return response;
+    }
+    catch (error) {
+        console.error('executeServerTransaction: Error occurred:', error);
+        throw error;
+    }
+};
+exports.executeServerTransaction = executeServerTransaction;
 const executeWalletTransaction = async (context, wallet_address, method, additionalArgs = []) => {
     try {
         const response = await prepareTransaction(context, wallet_address, {
@@ -225,6 +264,19 @@ const signTransaction = async (context, xdrToSign, privateKey) => {
     return preparedTransaction;
 };
 exports.signTransaction = signTransaction;
+/**
+ * Creates a signTransaction callback that signs with a private key.
+ * Use this for server-side / backend workers where there is no browser wallet.
+ */
+const createPrivateKeySigner = (secretKey, networkPassphrase) => {
+    return async (xdrToSign) => {
+        const keypair = stellar_sdk_1.Keypair.fromSecret(secretKey);
+        const tx = stellar_sdk_1.TransactionBuilder.fromXDR(xdrToSign, networkPassphrase);
+        tx.sign(keypair);
+        return tx.toXDR();
+    };
+};
+exports.createPrivateKeySigner = createPrivateKeySigner;
 const sendTransaction = async (context, signedTransactionXDR, bDebug = false) => {
     try {
         const server = getServer(context.network);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flashbacktech/flashbackclient",
-  "version": "0.2.69",
+  "version": "0.2.71",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"