@flashbacktech/flashbackclient 0.2.69 → 0.2.70

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

@@ -21,6 +21,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 +44,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 = void 0;
 const timing_1 = require("../utils/timing");
 // Polyfill for BigInt JSON serialization
 BigInt.prototype.toJSON = function () {
@@ -72,6 +72,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 +257,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.70",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"