@openzeppelin/relayer-plugin-channels 0.5.0 → 0.6.0

package/dist/plugin/constants.d.ts

@@ -39,8 +39,6 @@ export declare const POLLING: {
     readonly TIMEOUT_MS: 25000;
 };
 export declare const FEE: {
-    readonly MIN_BASE_FEE: 205;
-    readonly MAX_BASE_FEE: 605;
     readonly NON_SOROBAN_FEE: 100000;
 };
 //# sourceMappingURL=constants.d.ts.map

package/dist/plugin/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/plugin/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAGX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAGX,eAAO,MAAM,IAAI;;;;;CAOP,CAAC;AAGX,eAAO,MAAM,IAAI;;CAEP,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAGX,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAEX,eAAO,MAAM,GAAG;;;;CAKN,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/plugin/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAGX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAGX,eAAO,MAAM,IAAI;;;;;CAOP,CAAC;AAGX,eAAO,MAAM,IAAI;;CAEP,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAGX,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAEX,eAAO,MAAM,GAAG;;CAGN,CAAC"}

package/dist/plugin/constants.js

@@ -50,8 +50,6 @@ exports.POLLING = {
     TIMEOUT_MS: 25000,
 };
 exports.FEE = {
-    MIN_BASE_FEE: 205,
-    MAX_BASE_FEE: 605,
     // For non-Soroban txs: 100,000 stroops (0.01 XLM) per Stellar best practice
     NON_SOROBAN_FEE: 100000,
 };

package/dist/plugin/fee.d.ts

@@ -1,10 +1,14 @@
 /**
  * fee.ts
  *
- * Dynamic fee calculation for fee bump submissions.
- * - For Soroban transactions: use resourceFee + random inclusion fee
- * - For non-Soroban: use NON_SOROBAN_FEE
+ * Static fee calculation for fee bump submissions matching launchtube.
+ * - For Soroban transactions: use resourceFee + inclusion fee (BASE_FEE * 2 + 3)
+ * - For non-Soroban: use NON_SOROBAN_FEE + inclusion fee
+ * - KALE contract gets reduced fee (BASE_FEE * 2 + 1)
  */
 import { Transaction } from "@stellar/stellar-sdk";
+export declare const KALE_CONTRACT = "CDL74RF5BLYR2YBLCCI7F5FB6TPSCLKEJUBSD2RSVWZ4YHF3VMFAIGWA";
+export declare const INCLUSION_FEE_DEFAULT: number;
+export declare const INCLUSION_FEE_KALE: number;
 export declare function calculateMaxFee(transaction: Transaction): number;
 //# sourceMappingURL=fee.d.ts.map

package/dist/plugin/fee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/plugin/fee.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAO,MAAM,sBAAsB,CAAC;AAGxD,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAsBhE"}
+{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/plugin/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,WAAW,EAIZ,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,aAAa,6DACkC,CAAC;AAC7D,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AA8B3D,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAsBhE"}

package/dist/plugin/fee.js

@@ -2,14 +2,41 @@
 /**
  * fee.ts
  *
- * Dynamic fee calculation for fee bump submissions.
- * - For Soroban transactions: use resourceFee + random inclusion fee
- * - For non-Soroban: use NON_SOROBAN_FEE
+ * Static fee calculation for fee bump submissions matching launchtube.
+ * - For Soroban transactions: use resourceFee + inclusion fee (BASE_FEE * 2 + 3)
+ * - For non-Soroban: use NON_SOROBAN_FEE + inclusion fee
+ * - KALE contract gets reduced fee (BASE_FEE * 2 + 1)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.INCLUSION_FEE_KALE = exports.INCLUSION_FEE_DEFAULT = exports.KALE_CONTRACT = void 0;
 exports.calculateMaxFee = calculateMaxFee;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const constants_1 = require("./constants");
+exports.KALE_CONTRACT = "CDL74RF5BLYR2YBLCCI7F5FB6TPSCLKEJUBSD2RSVWZ4YHF3VMFAIGWA";
+exports.INCLUSION_FEE_DEFAULT = Number(stellar_sdk_1.BASE_FEE) * 2 + 3;
+exports.INCLUSION_FEE_KALE = Number(stellar_sdk_1.BASE_FEE) * 2 + 1;
+function getInclusionFee(transaction) {
+    try {
+        if (transaction.operations.length !== 1)
+            return exports.INCLUSION_FEE_DEFAULT;
+        const op = transaction.operations[0];
+        if (op.type !== "invokeHostFunction")
+            return exports.INCLUSION_FEE_DEFAULT;
+        const invokeOp = op;
+        if (invokeOp.func.switch() !==
+            stellar_sdk_1.xdr.HostFunctionType.hostFunctionTypeInvokeContract()) {
+            return exports.INCLUSION_FEE_DEFAULT;
+        }
+        const invokeContract = invokeOp.func.invokeContract();
+        const contract = stellar_sdk_1.StrKey.encodeContract(invokeContract.contractAddress().contractId());
+        return contract === exports.KALE_CONTRACT
+            ? exports.INCLUSION_FEE_KALE
+            : exports.INCLUSION_FEE_DEFAULT;
+    }
+    catch {
+        return exports.INCLUSION_FEE_DEFAULT;
+    }
+}
 function calculateMaxFee(transaction) {
     const envelope = transaction.toEnvelope();
     let resourceFee = 0n;
@@ -19,15 +46,10 @@ function calculateMaxFee(transaction) {
             resourceFee = sorobanData.resourceFee().toBigInt();
         }
     }
-    const baseInclusion = getRandomInt(constants_1.FEE.MIN_BASE_FEE, constants_1.FEE.MAX_BASE_FEE);
+    const inclusionFee = getInclusionFee(transaction);
     const fee = resourceFee > 0n
-        ? resourceFee + BigInt(baseInclusion)
-        : BigInt(constants_1.FEE.NON_SOROBAN_FEE + baseInclusion);
-    console.debug(`[channels] Calculated max_fee: ${Number(fee)} stroops (resourceFee: ${resourceFee}, baseInclusion: ${baseInclusion})`);
+        ? resourceFee + BigInt(inclusionFee)
+        : BigInt(constants_1.FEE.NON_SOROBAN_FEE + inclusionFee);
+    console.debug(`[channels] Calculated max_fee: ${Number(fee)} stroops (resourceFee: ${resourceFee}, inclusionFee: ${inclusionFee})`);
     return Number(fee);
 }
-function getRandomInt(min, max) {
-    const mn = Math.ceil(min);
-    const mx = Math.floor(max);
-    return Math.floor(Math.random() * (mx - mn + 1)) + mn;
-}

package/dist/plugin/handler.d.ts

@@ -5,6 +5,15 @@
  * Orchestrates the transaction processing pipeline using channel accounts with fee bumping.
  */
 import { PluginContext } from "@openzeppelin/relayer-sdk";
+import { Transaction, xdr } from "@stellar/stellar-sdk";
+/**
+ * Extracts func and auth from an unsigned Soroban transaction.
+ * Returns null if the transaction is not a single invokeHostFunction operation.
+ */
+export declare function extractFuncAuthFromUnsignedXdr(tx: Transaction): {
+    func: xdr.HostFunction;
+    auth: xdr.SorobanAuthorizationEntry[];
+} | null;
 /**
  * Main plugin handler exported for OpenZeppelin Relayer
  */

package/dist/plugin/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/plugin/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAqNvE;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAGlE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/plugin/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AASvE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAcxD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,WAAW,GACd;IAAE,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,yBAAyB,EAAE,CAAA;CAAE,GAAG,IAAI,CAkB1E;AAiOD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAElE"}

package/dist/plugin/handler.js

@@ -6,6 +6,7 @@
  * Orchestrates the transaction processing pipeline using channel accounts with fee bumping.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFuncAuthFromUnsignedXdr = extractFuncAuthFromUnsignedXdr;
 exports.handler = handler;
 const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const pool_1 = require("./pool");
@@ -23,8 +24,44 @@ function getApiKey(headers, headerName) {
     const values = headers[headerName];
     return values?.[0]?.trim() || undefined;
 }
-async function handleXdrSubmit(xdrStr, fundRelayer, network, networkPassphrase, api, tracker) {
+/**
+ * Extracts func and auth from an unsigned Soroban transaction.
+ * Returns null if the transaction is not a single invokeHostFunction operation.
+ */
+function extractFuncAuthFromUnsignedXdr(tx) {
+    const ops = tx.operations;
+    if (ops.length !== 1) {
+        return null;
+    }
+    const envelope = tx.toEnvelope();
+    const rawOp = envelope.v1().tx().operations()[0].body();
+    if (rawOp.switch() !== stellar_sdk_1.xdr.OperationType.invokeHostFunction()) {
+        return null;
+    }
+    const invokeHostFn = rawOp.invokeHostFunctionOp();
+    return {
+        func: invokeHostFn.hostFunction(),
+        auth: invokeHostFn.auth(),
+    };
+}
+async function handleXdrSubmit(xdrStr, fundRelayer, fundAddress, network, networkPassphrase, api, pool, tracker) {
     const tx = new stellar_sdk_1.Transaction(xdrStr, networkPassphrase);
+    // Unsigned XDR: extract func+auth and route through channel path
+    if (tx.signatures.length === 0) {
+        const extracted = extractFuncAuthFromUnsignedXdr(tx);
+        if (!extracted) {
+            throw (0, relayer_sdk_1.pluginError)("Unsigned XDR must contain exactly one invokeHostFunction operation", {
+                code: "INVALID_UNSIGNED_XDR",
+                status: constants_1.HTTP_STATUS.BAD_REQUEST,
+                details: {
+                    operationCount: tx.operations.length,
+                    operationType: tx.operations[0]?.type,
+                },
+            });
+        }
+        console.log(`[channels] Unsigned XDR detected, extracting func+auth and routing through channel path`);
+        return handleFuncAuthSubmit(extracted.func, extracted.auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, tracker);
+    }
     const validated = (0, tx_1.validateExistingTransactionForSubmitOnly)(tx);
     const maxFee = (0, fee_1.calculateMaxFee)(validated);
     await tracker?.checkBudget(maxFee);
@@ -97,47 +134,40 @@ async function channelAccounts(context) {
             resetPeriodMs: config.feeResetPeriodMs,
         });
     }
-    try {
-        // 1. Validate and parse request (xdr OR func+auth)
-        const request = (0, validation_1.validateAndParseRequest)(params);
-        console.debug(`[channels] Request type: ${request.type}, auth entries: ${request.type === "func-auth" ? request.auth.length : "N/A"}`);
-        // 2. Get fund relayer
-        const fundRelayer = api.useRelayer(config.fundRelayerId);
-        const fundInfo = await fundRelayer.getRelayer();
-        if (!fundInfo || !fundInfo.address) {
-            throw (0, relayer_sdk_1.pluginError)("Fund relayer not found", {
-                code: "RELAYER_UNAVAILABLE",
-                status: constants_1.HTTP_STATUS.BAD_GATEWAY,
-                details: { relayerId: config.fundRelayerId },
-            });
-        }
-        const fundStatus = await fundRelayer.getRelayerStatus();
-        if (fundStatus.network_type !== "stellar") {
-            throw (0, relayer_sdk_1.pluginError)("Fund relayer network type must be stellar", {
-                code: "UNSUPPORTED_NETWORK",
-                status: constants_1.HTTP_STATUS.BAD_REQUEST,
-                details: {
-                    network_type: fundStatus.network_type,
-                    relayerId: config.fundRelayerId,
-                },
-            });
-        }
-        // 3. Branch by request type
-        if (request.type === "xdr") {
-            console.log(`[channels] Flow: XDR submit-only`);
-            return await handleXdrSubmit(request.xdr, fundRelayer, config.network, networkPassphrase, api, tracker);
-        }
-        console.log(`[channels] Flow: func+auth with channel account`);
-        return await handleFuncAuthSubmit(request.func, request.auth, api, pool, fundRelayer, fundInfo.address, config.network, networkPassphrase, tracker);
+    // 1. Validate and parse request (xdr OR func+auth)
+    const request = (0, validation_1.validateAndParseRequest)(params);
+    console.debug(`[channels] Request type: ${request.type}, auth entries: ${request.type === "func-auth" ? request.auth.length : "N/A"}`);
+    // 2. Get fund relayer
+    const fundRelayer = api.useRelayer(config.fundRelayerId);
+    const fundInfo = await fundRelayer.getRelayer();
+    if (!fundInfo || !fundInfo.address) {
+        throw (0, relayer_sdk_1.pluginError)("Fund relayer not found", {
+            code: "RELAYER_UNAVAILABLE",
+            status: constants_1.HTTP_STATUS.BAD_GATEWAY,
+            details: { relayerId: config.fundRelayerId },
+        });
     }
-    finally {
-        // Nothing to cleanup here; func-auth path releases locks internally
+    if (fundInfo.network_type !== "stellar") {
+        throw (0, relayer_sdk_1.pluginError)("Fund relayer network type must be stellar", {
+            code: "UNSUPPORTED_NETWORK",
+            status: constants_1.HTTP_STATUS.BAD_REQUEST,
+            details: {
+                network_type: fundInfo.network_type,
+                relayerId: config.fundRelayerId,
+            },
+        });
+    }
+    // 3. Branch by request type
+    if (request.type === "xdr") {
+        console.log(`[channels] Flow: XDR submit-only`);
+        return await handleXdrSubmit(request.xdr, fundRelayer, fundInfo.address, config.network, networkPassphrase, api, pool, tracker);
     }
+    console.log(`[channels] Flow: func+auth with channel account`);
+    return await handleFuncAuthSubmit(request.func, request.auth, api, pool, fundRelayer, fundInfo.address, config.network, networkPassphrase, tracker);
 }
 /**
  * Main plugin handler exported for OpenZeppelin Relayer
  */
 async function handler(context) {
-    const result = await channelAccounts(context);
-    return result;
+    return channelAccounts(context);
 }

package/dist/plugin/simulation.d.ts

@@ -12,4 +12,6 @@ export interface ChannelAccount {
     sequence: string;
 }
 export declare function simulateAndBuildWithChannel(func: xdr.HostFunction, auth: xdr.SorobanAuthorizationEntry[] | undefined, channel: ChannelAccount, _fundAddress: string, relayer: Relayer, networkPassphrase: string): Promise<Transaction>;
+/** Extract human-readable message + error type from simulation error diagnostic events */
+export declare function parseSimulationError(error: string): string;
 //# sourceMappingURL=simulation.d.ts.map

package/dist/plugin/simulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/plugin/simulation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,WAAW,EAEX,GAAG,EACJ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,OAAO,EACR,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,GAAG,CAAC,YAAY,EACtB,IAAI,EAAE,GAAG,CAAC,yBAAyB,EAAE,GAAG,SAAS,EACjD,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC,CA8FtB"}
+{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/plugin/simulation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,WAAW,EAEX,GAAG,EACJ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,OAAO,EACR,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,GAAG,CAAC,YAAY,EACtB,IAAI,EAAE,GAAG,CAAC,yBAAyB,EAAE,GAAG,SAAS,EACjD,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC,CAoGtB;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe1D"}

package/dist/plugin/simulation.js

@@ -8,6 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simulateAndBuildWithChannel = simulateAndBuildWithChannel;
+exports.parseSimulationError = parseSimulationError;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const constants_1 = require("./constants");
@@ -51,23 +52,26 @@ async function simulateAndBuildWithChannel(func, auth, channel, _fundAddress, re
     }
     if (rpcResponse.error) {
         const { code, message, description, data } = rpcResponse.error;
-        throw (0, relayer_sdk_1.pluginError)("Simulation RPC execution failed", {
+        console.error(`[channels] RPC error: code=${code}, message=${message}, detail=${description || data}`);
+        throw (0, relayer_sdk_1.pluginError)("Simulation RPC failed", {
             code: "SIMULATION_RPC_FAILURE",
+            status: constants_1.HTTP_STATUS.BAD_GATEWAY,
+            details: { message: "RPC provider error" },
+        });
+    }
+    const simResult = {
+        id: String(rpcResponse.id ?? "1"),
+        ...rpcResponse.result,
+    };
+    if ("error" in simResult && simResult.error) {
+        console.error(`[channels] Simulation error: ${simResult.error}`);
+        throw (0, relayer_sdk_1.pluginError)("Simulation failed", {
+            code: "SIMULATION_FAILED",
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
-            details: {
-                rpcCode: code,
-                message,
-                description: description || data,
-            },
+            details: { error: parseSimulationError(simResult.error) },
         });
     }
     try {
-        // Format simulation result for SDK's assembleTransaction
-        const simResult = {
-            id: String(rpcResponse.id ?? "1"),
-            ...rpcResponse.result,
-        };
-        console.debug(`[channels] Simulation result:`, JSON.stringify(simResult, null, 2));
         // Use SDK's assembleTransaction to apply simulation results
         const prepared = stellar_sdk_1.rpc
             .assembleTransaction(transaction, simResult)
@@ -83,7 +87,8 @@ async function simulateAndBuildWithChannel(func, auth, channel, _fundAddress, re
         return prepared;
     }
     catch (err) {
-        throw (0, relayer_sdk_1.pluginError)("Simulation result processing failed", {
+        console.error(`[channels] Assembly error: ${err instanceof Error ? err.message : String(err)}`);
+        throw (0, relayer_sdk_1.pluginError)("Simulation failed", {
             code: "SIMULATION_FAILED",
             status: constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
             details: {
@@ -92,3 +97,17 @@ async function simulateAndBuildWithChannel(func, auth, channel, _fundAddress, re
         });
     }
 }
+/** Extract human-readable message + error type from simulation error diagnostic events */
+function parseSimulationError(error) {
+    const firstLine = error.split("\n")[0]?.trim() || "Simulation failed";
+    const errorType = firstLine.match(/Error\(([^)]+)\)/)?.[1];
+    const arrayMatch = error.match(/data:\s*\["((?:[^"\\]|\\.)*)"/);
+    if (arrayMatch?.[1] && arrayMatch[1].length > 3) {
+        return errorType ? `${arrayMatch[1]} (${errorType})` : arrayMatch[1];
+    }
+    const stringMatch = error.match(/data:\s*"((?:[^"\\]|\\.)*)"/);
+    if (stringMatch?.[1] && stringMatch[1].length > 3) {
+        return errorType ? `${stringMatch[1]} (${errorType})` : stringMatch[1];
+    }
+    return firstLine;
+}

package/dist/plugin/submit.d.ts

@@ -18,4 +18,6 @@ export declare function signWithChannelAndFund(transaction: Transaction, channel
  * Submit transaction with fee bump and wait for confirmation
  */
 export declare function submitWithFeeBumpAndWait(fundRelayer: Relayer, signedXdr: string, network: "testnet" | "mainnet", maxFee: number, api: PluginAPI, tracker?: FeeTracker): Promise<ChannelAccountsResponse>;
+/** Strip provider wrapper text, extract last segment (e.g., "TxInsufficientBalance") */
+export declare function sanitizeReason(reason: string): string;
 //# sourceMappingURL=submit.d.ts.map

package/dist/plugin/submit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/plugin/submit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAEL,OAAO,EAGP,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC,CA2BtB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAiElC"}
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/plugin/submit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAEL,OAAO,EAGP,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC,CA2BtB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAoElC;AAgBD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/plugin/submit.js

@@ -7,6 +7,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.signWithChannelAndFund = signWithChannelAndFund;
 exports.submitWithFeeBumpAndWait = submitWithFeeBumpAndWait;
+exports.sanitizeReason = sanitizeReason;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const constants_1 = require("./constants");
@@ -62,12 +63,15 @@ async function submitWithFeeBumpAndWait(fundRelayer, signedXdr, network, maxFee,
             if (tracker) {
                 await tracker.recordUsage(maxFee);
             }
-            throw (0, relayer_sdk_1.pluginError)(final.status_reason || "Transaction failed", {
+            const rawReason = final.status_reason || "Transaction failed";
+            console.error(`[channels] Transaction failed: ${rawReason}`);
+            const reason = sanitizeReason(rawReason);
+            throw (0, relayer_sdk_1.pluginError)(reason, {
                 code: "ONCHAIN_FAILED",
                 status: constants_1.HTTP_STATUS.BAD_REQUEST,
                 details: {
                     status: String(final.status),
-                    reason: final.status_reason ?? null,
+                    reason,
                     id: final.id,
                     hash: final.hash ?? null,
                 },
@@ -108,3 +112,12 @@ function isSignTransactionResponseStellar(data) {
         "signature" in data &&
         "signedXdr" in data);
 }
+/** Strip provider wrapper text, extract last segment (e.g., "TxInsufficientBalance") */
+function sanitizeReason(reason) {
+    const segments = reason.split(/:\s*/);
+    const last = segments[segments.length - 1]?.trim();
+    if (last && last.length > 2 && !last.toLowerCase().includes("provider")) {
+        return last;
+    }
+    return reason.length > 100 ? reason.slice(0, 100) + "..." : reason;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/relayer-plugin-channels",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "OpenZeppelin Relayer Plugin for Stellar Channel Accounts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",