@openzeppelin/relayer-plugin-channels 0.6.0 → 0.8.0

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/plugin/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAwDD;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAkBlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/plugin/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAoFD;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAoBlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAE3E"}

package/dist/plugin/config.js

@@ -12,9 +12,9 @@ const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const constants_1 = require("./constants");
 function requireEnv(name) {
     const v = process.env[name];
-    if (!v || v.trim() === "") {
+    if (!v || v.trim() === '') {
         throw (0, relayer_sdk_1.pluginError)(`Missing required environment variable: ${name}`, {
-            code: "CONFIG_MISSING",
+            code: 'CONFIG_MISSING',
             status: constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
             details: { name },
         });
@@ -33,9 +33,7 @@ function parseLockTtl() {
     if (!raw)
         return constants_1.CONFIG.DEFAULT_LOCK_TTL_SECONDS;
     const n = Number(raw);
-    if (!Number.isFinite(n) ||
-        n < constants_1.CONFIG.MIN_LOCK_TTL_SECONDS ||
-        n > constants_1.CONFIG.MAX_LOCK_TTL_SECONDS) {
+    if (!Number.isFinite(n) || n < constants_1.CONFIG.MIN_LOCK_TTL_SECONDS || n > constants_1.CONFIG.MAX_LOCK_TTL_SECONDS) {
         return constants_1.CONFIG.DEFAULT_LOCK_TTL_SECONDS;
     }
     return Math.floor(n);
@@ -57,34 +55,66 @@ function parseFeeResetPeriod() {
 function parseApiKeyHeader() {
     const raw = process.env.API_KEY_HEADER;
     if (!raw)
-        return "x-api-key";
+        return 'x-api-key';
     const trimmed = raw.trim().toLowerCase();
-    return trimmed.length > 0 ? trimmed : "x-api-key";
+    return trimmed.length > 0 ? trimmed : 'x-api-key';
+}
+function parseLimitedContracts() {
+    const raw = process.env.LIMITED_CONTRACTS;
+    if (!raw)
+        return new Set();
+    const contracts = raw
+        .split(',')
+        .map((s) => s.trim().toUpperCase())
+        .filter((s) => s.length > 0);
+    // Validate each contract address
+    for (const contract of contracts) {
+        if (!stellar_sdk_1.StrKey.isValidContract(contract)) {
+            throw (0, relayer_sdk_1.pluginError)(`Invalid contract address in LIMITED_CONTRACTS: ${contract}`, {
+                code: 'CONFIG_INVALID',
+                status: constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
+                details: { contract },
+            });
+        }
+    }
+    return new Set(contracts);
+}
+function parseContractCapacityRatio() {
+    const raw = process.env.CONTRACT_CAPACITY_RATIO;
+    if (!raw)
+        return constants_1.CONFIG.DEFAULT_CONTRACT_CAPACITY_RATIO;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0 || n > 1) {
+        return constants_1.CONFIG.DEFAULT_CONTRACT_CAPACITY_RATIO;
+    }
+    return n;
 }
 /**
  * Load configuration from environment variables
  */
 function loadConfig() {
-    const networkRaw = requireEnv("STELLAR_NETWORK").toLowerCase();
-    if (networkRaw !== "testnet" && networkRaw !== "mainnet") {
+    const networkRaw = requireEnv('STELLAR_NETWORK').toLowerCase();
+    if (networkRaw !== 'testnet' && networkRaw !== 'mainnet') {
         throw (0, relayer_sdk_1.pluginError)('STELLAR_NETWORK must be "testnet" or "mainnet"', {
-            code: "UNSUPPORTED_NETWORK",
+            code: 'UNSUPPORTED_NETWORK',
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
         });
     }
     return {
-        fundRelayerId: requireEnv("FUND_RELAYER_ID"),
+        fundRelayerId: requireEnv('FUND_RELAYER_ID'),
         network: networkRaw,
         lockTtlSeconds: parseLockTtl(),
-        adminSecret: parseOptionalString("PLUGIN_ADMIN_SECRET"),
+        adminSecret: parseOptionalString('PLUGIN_ADMIN_SECRET'),
         feeLimit: parseFeeLimit(),
         feeResetPeriodMs: parseFeeResetPeriod(),
         apiKeyHeader: parseApiKeyHeader(),
+        limitedContracts: parseLimitedContracts(),
+        contractCapacityRatio: parseContractCapacityRatio(),
     };
 }
 /**
  * Get the network passphrase based on the configuration
  */
 function getNetworkPassphrase(network) {
-    return network === "mainnet" ? stellar_sdk_1.Networks.PUBLIC : stellar_sdk_1.Networks.TESTNET;
+    return network === 'mainnet' ? stellar_sdk_1.Networks.PUBLIC : stellar_sdk_1.Networks.TESTNET;
 }

package/dist/plugin/constants.d.ts

@@ -18,6 +18,7 @@ export declare const CONFIG: {
     readonly DEFAULT_LOCK_TTL_SECONDS: 30;
     readonly MIN_LOCK_TTL_SECONDS: 3;
     readonly MAX_LOCK_TTL_SECONDS: 30;
+    readonly DEFAULT_CONTRACT_CAPACITY_RATIO: 0.8;
 };
 export declare const POOL: {
     readonly MUTEX_TTL_SECONDS: 1;

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;;CAGN,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;;;;;CAKT,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

@@ -23,6 +23,7 @@ exports.CONFIG = {
     DEFAULT_LOCK_TTL_SECONDS: 30,
     MIN_LOCK_TTL_SECONDS: 3,
     MAX_LOCK_TTL_SECONDS: 30,
+    DEFAULT_CONTRACT_CAPACITY_RATIO: 0.8,
 };
 // Pool Constants
 exports.POOL = {
@@ -39,7 +40,7 @@ exports.TIME = {
 };
 // Simulation-related defaults
 exports.SIMULATION = {
-    DEFAULT_FEE: "100",
+    DEFAULT_FEE: '100',
     MIN_TIME_BOUND: 0,
     MAX_TIME_BOUND_OFFSET_SECONDS: 30,
     MAX_FUTURE_TIME_BOUND_SECONDS: 30,

package/dist/plugin/fee-tracking.d.ts

@@ -5,7 +5,7 @@
  * Supports custom per-key limits with fallback to default.
  * Supports periodic reset of consumption.
  */
-import { PluginKVStore } from "@openzeppelin/relayer-sdk";
+import { PluginKVStore } from '@openzeppelin/relayer-sdk';
 /** KV data structure for fee consumption */
 export interface FeeData {
     consumed: number;
@@ -22,7 +22,7 @@ export interface UsageInfo {
 /** Configuration for FeeTracker */
 export interface FeeTrackerConfig {
     kv: PluginKVStore;
-    network: "testnet" | "mainnet";
+    network: 'testnet' | 'mainnet';
     apiKey: string;
     defaultLimit?: number;
     resetPeriodMs?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"fee-tracking.d.ts","sourceRoot":"","sources":["../../src/plugin/fee-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAGvE,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,aAAa,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,gBAAgB;IAUpC;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAqBxC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;;OAGG;YACW,WAAW;IASzB;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,OAAO,GAElB;CACF"}
+{"version":3,"file":"fee-tracking.d.ts","sourceRoot":"","sources":["../../src/plugin/fee-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAGvE,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,aAAa,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,gBAAgB;IAUpC;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAexC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;;OAGG;YACW,WAAW;IASzB;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,OAAO,GAElB;CACF"}

package/dist/plugin/fee-tracking.js

@@ -31,7 +31,7 @@ class FeeTracker {
         if (consumed + fee > limit) {
             const remaining = limit - consumed;
             throw (0, relayer_sdk_1.pluginError)(`Transaction fee (${fee} stroops) exceeds remaining budget (${remaining} stroops). Consumed: ${consumed}/${limit} stroops.`, {
-                code: "FEE_LIMIT_EXCEEDED",
+                code: 'FEE_LIMIT_EXCEEDED',
                 status: constants_1.HTTP_STATUS.TOO_MANY_REQUESTS,
                 details: { consumed, fee, remaining, limit },
             });
@@ -54,7 +54,7 @@ class FeeTracker {
                         periodStart: state.periodStart ?? now,
                     });
                     return true;
-                }, { ttlSec: 5, onBusy: "skip" });
+                }, { ttlSec: 5, onBusy: 'skip' });
                 if (result !== null)
                     return;
                 // Lock busy, retry with jitter
@@ -71,17 +71,12 @@ class FeeTracker {
      * Get complete usage info for management API.
      */
     async getUsageInfo() {
-        const [state, limit] = await Promise.all([
-            this.getFeeState(),
-            this.getEffectiveLimit(),
-        ]);
+        const [state, limit] = await Promise.all([this.getFeeState(), this.getEffectiveLimit()]);
         return {
             consumed: state.consumed,
             limit,
             remaining: limit !== undefined ? Math.max(0, limit - state.consumed) : undefined,
-            periodStartAt: state.periodStart
-                ? new Date(state.periodStart).toISOString()
-                : undefined,
+            periodStartAt: state.periodStart ? new Date(state.periodStart).toISOString() : undefined,
             periodEndsAt: state.periodStart && this.resetPeriodMs
                 ? new Date(state.periodStart + this.resetPeriodMs).toISOString()
                 : undefined,

package/dist/plugin/fee.d.ts

@@ -4,11 +4,18 @@
  * 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)
+ * - Limited contracts (from LIMITED_CONTRACTS env) get reduced fee (BASE_FEE * 2 + 1)
  */
-import { Transaction } from "@stellar/stellar-sdk";
-export declare const KALE_CONTRACT = "CDL74RF5BLYR2YBLCCI7F5FB6TPSCLKEJUBSD2RSVWZ4YHF3VMFAIGWA";
+import { Transaction, xdr } from '@stellar/stellar-sdk';
 export declare const INCLUSION_FEE_DEFAULT: number;
-export declare const INCLUSION_FEE_KALE: number;
-export declare function calculateMaxFee(transaction: Transaction): number;
+export declare const INCLUSION_FEE_LIMITED: number;
+/**
+ * Extract contract ID from a HostFunction (for func+auth flow)
+ */
+export declare function getContractIdFromFunc(func: xdr.HostFunction): string | undefined;
+/**
+ * Extract contract ID from a Transaction (for XDR flow)
+ */
+export declare function getContractIdFromTransaction(transaction: Transaction): string | undefined;
+export declare function calculateMaxFee(transaction: Transaction, limitedContracts?: Set<string>): 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;;;;;;;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"}
+{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/plugin/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,WAAW,EAAE,GAAG,EAAqB,MAAM,sBAAsB,CAAC;AAGrF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAC9D,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAE9D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAUhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAYzF;AASD,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAoB3G"}

package/dist/plugin/fee.js

@@ -5,39 +5,56 @@
  * 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)
+ * - Limited contracts (from LIMITED_CONTRACTS env) get 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.INCLUSION_FEE_LIMITED = exports.INCLUSION_FEE_DEFAULT = void 0;
+exports.getContractIdFromFunc = getContractIdFromFunc;
+exports.getContractIdFromTransaction = getContractIdFromTransaction;
 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) {
+exports.INCLUSION_FEE_LIMITED = Number(stellar_sdk_1.BASE_FEE) * 2 + 1;
+/**
+ * Extract contract ID from a HostFunction (for func+auth flow)
+ */
+function getContractIdFromFunc(func) {
+    try {
+        if (func.switch() !== stellar_sdk_1.xdr.HostFunctionType.hostFunctionTypeInvokeContract()) {
+            return undefined;
+        }
+        const invokeContract = func.invokeContract();
+        return stellar_sdk_1.StrKey.encodeContract(invokeContract.contractAddress().contractId());
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extract contract ID from a Transaction (for XDR flow)
+ */
+function getContractIdFromTransaction(transaction) {
     try {
         if (transaction.operations.length !== 1)
-            return exports.INCLUSION_FEE_DEFAULT;
+            return undefined;
         const op = transaction.operations[0];
-        if (op.type !== "invokeHostFunction")
-            return exports.INCLUSION_FEE_DEFAULT;
+        if (op.type !== 'invokeHostFunction')
+            return undefined;
         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;
+        return getContractIdFromFunc(invokeOp.func);
     }
     catch {
-        return exports.INCLUSION_FEE_DEFAULT;
+        return undefined;
+    }
+}
+function getInclusionFee(contractId, limitedContracts) {
+    if (contractId && limitedContracts.has(contractId)) {
+        return exports.INCLUSION_FEE_LIMITED;
     }
+    return exports.INCLUSION_FEE_DEFAULT;
 }
-function calculateMaxFee(transaction) {
+function calculateMaxFee(transaction, limitedContracts = new Set()) {
     const envelope = transaction.toEnvelope();
     let resourceFee = 0n;
     if (envelope.switch() === stellar_sdk_1.xdr.EnvelopeType.envelopeTypeTx()) {
@@ -46,10 +63,9 @@ function calculateMaxFee(transaction) {
             resourceFee = sorobanData.resourceFee().toBigInt();
         }
     }
-    const inclusionFee = getInclusionFee(transaction);
-    const fee = resourceFee > 0n
-        ? resourceFee + BigInt(inclusionFee)
-        : BigInt(constants_1.FEE.NON_SOROBAN_FEE + inclusionFee);
+    const contractId = getContractIdFromTransaction(transaction);
+    const inclusionFee = getInclusionFee(contractId, limitedContracts);
+    const fee = resourceFee > 0n ? 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);
 }

package/dist/plugin/handler.d.ts

@@ -4,8 +4,8 @@
  * Main handler for the channel accounts plugin.
  * Orchestrates the transaction processing pipeline using channel accounts with fee bumping.
  */
-import { PluginContext } from "@openzeppelin/relayer-sdk";
-import { Transaction, xdr } from "@stellar/stellar-sdk";
+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.

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;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"}
+{"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;AAWxD;;;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;AAsOD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAElE"}

package/dist/plugin/handler.js

@@ -44,14 +44,14 @@ function extractFuncAuthFromUnsignedXdr(tx) {
         auth: invokeHostFn.auth(),
     };
 }
-async function handleXdrSubmit(xdrStr, fundRelayer, fundAddress, network, networkPassphrase, api, pool, tracker) {
+async function handleXdrSubmit(xdrStr, fundRelayer, fundAddress, network, networkPassphrase, api, pool, acquireOptions, 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",
+            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,
@@ -60,41 +60,54 @@ async function handleXdrSubmit(xdrStr, fundRelayer, fundAddress, network, networ
             });
         }
         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);
+        // Update acquireOptions with contractId from extracted func
+        const contractId = (0, fee_1.getContractIdFromFunc)(extracted.func);
+        const updatedOptions = { ...acquireOptions, contractId };
+        return handleFuncAuthSubmit(extracted.func, extracted.auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, updatedOptions, tracker);
     }
     const validated = (0, tx_1.validateExistingTransactionForSubmitOnly)(tx);
-    const maxFee = (0, fee_1.calculateMaxFee)(validated);
+    const maxFee = (0, fee_1.calculateMaxFee)(validated, acquireOptions.limitedContracts);
     await tracker?.checkBudget(maxFee);
     return (0, submit_1.submitWithFeeBumpAndWait)(fundRelayer, validated.toXDR(), network, maxFee, api, tracker);
 }
-async function handleFuncAuthSubmit(func, auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, tracker) {
+async function handleFuncAuthSubmit(func, auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, acquireOptions, tracker) {
+    // Simulate once — used for both read-only detection and transaction assembly
+    const simulation = await (0, simulation_1.simulateTransaction)(func, auth, fundAddress, fundRelayer, networkPassphrase);
+    if (simulation.isReadOnly) {
+        console.log(`[channels] Read-only call detected, returning simulation result`);
+        return {
+            transactionId: null,
+            status: 'readonly',
+            hash: null,
+            returnValue: simulation.returnValue,
+            latestLedger: simulation.latestLedger,
+        };
+    }
     let poolLock;
     try {
-        poolLock = await pool.acquire();
+        poolLock = await pool.acquire(acquireOptions);
         const channelRelayer = api.useRelayer(poolLock.relayerId);
         const channelInfo = await channelRelayer.getRelayer();
         console.log(`[channels] Acquired channel: ${poolLock.relayerId}`);
         if (!channelInfo || !channelInfo.address) {
-            throw (0, relayer_sdk_1.pluginError)("Channel relayer not found", {
-                code: "RELAYER_UNAVAILABLE",
+            throw (0, relayer_sdk_1.pluginError)('Channel relayer not found', {
+                code: 'RELAYER_UNAVAILABLE',
                 status: constants_1.HTTP_STATUS.BAD_GATEWAY,
                 details: { relayerId: poolLock.relayerId },
             });
         }
         const channelStatus = await channelRelayer.getRelayerStatus();
-        if (channelStatus.network_type !== "stellar") {
-            throw (0, relayer_sdk_1.pluginError)("Channel relayer network type must be stellar", {
-                code: "UNSUPPORTED_NETWORK",
+        if (channelStatus.network_type !== 'stellar') {
+            throw (0, relayer_sdk_1.pluginError)('Channel relayer network type must be stellar', {
+                code: 'UNSUPPORTED_NETWORK',
                 status: constants_1.HTTP_STATUS.BAD_REQUEST,
-                details: {
-                    network_type: channelStatus.network_type,
-                    relayerId: poolLock.relayerId,
-                },
+                details: { network_type: channelStatus.network_type, relayerId: poolLock.relayerId },
             });
         }
-        const built = await (0, simulation_1.simulateAndBuildWithChannel)(func, auth, { address: channelInfo.address, sequence: channelStatus.sequence_number }, fundAddress, fundRelayer, networkPassphrase);
+        // Assemble the transaction using the cached simulation result — no second RPC call
+        const built = (0, simulation_1.buildWithChannel)(func, auth, { address: channelInfo.address, sequence: channelStatus.sequence_number }, networkPassphrase, simulation.rawSimResult);
         const signedTx = await (0, submit_1.signWithChannelAndFund)(built, channelRelayer, fundRelayer, channelInfo.address, fundAddress, networkPassphrase);
-        const maxFee = (0, fee_1.calculateMaxFee)(signedTx);
+        const maxFee = (0, fee_1.calculateMaxFee)(signedTx, acquireOptions.limitedContracts);
         await tracker?.checkBudget(maxFee);
         return await (0, submit_1.submitWithFeeBumpAndWait)(fundRelayer, signedTx.toXDR(), network, maxFee, api, tracker);
     }
@@ -119,8 +132,8 @@ async function channelAccounts(context) {
     const apiKey = getApiKey(headers, config.apiKeyHeader);
     // If default limit is set, require API key
     if (config.feeLimit !== undefined && !apiKey) {
-        throw (0, relayer_sdk_1.pluginError)("API key required", {
-            code: "API_KEY_REQUIRED",
+        throw (0, relayer_sdk_1.pluginError)('API key required', {
+            code: 'API_KEY_REQUIRED',
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
         });
     }
@@ -136,34 +149,39 @@ async function channelAccounts(context) {
     }
     // 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"}`);
+    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",
+        throw (0, relayer_sdk_1.pluginError)('Fund relayer not found', {
+            code: 'RELAYER_UNAVAILABLE',
             status: constants_1.HTTP_STATUS.BAD_GATEWAY,
             details: { relayerId: config.fundRelayerId },
         });
     }
-    if (fundInfo.network_type !== "stellar") {
-        throw (0, relayer_sdk_1.pluginError)("Fund relayer network type must be stellar", {
-            code: "UNSUPPORTED_NETWORK",
+    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,
-            },
+            details: { network_type: fundInfo.network_type, relayerId: config.fundRelayerId },
         });
     }
-    // 3. Branch by request type
-    if (request.type === "xdr") {
+    // 3. Build acquire options for contract capacity limits
+    const acquireOptions = {
+        limitedContracts: config.limitedContracts,
+        capacityRatio: config.contractCapacityRatio,
+    };
+    // 4. 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);
+        return await handleXdrSubmit(request.xdr, fundRelayer, fundInfo.address, config.network, networkPassphrase, api, pool, acquireOptions, tracker);
     }
+    // Extract contractId for func+auth flow
+    const contractId = (0, fee_1.getContractIdFromFunc)(request.func);
+    const funcAcquireOptions = { ...acquireOptions, contractId };
     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);
+    return await handleFuncAuthSubmit(request.func, request.auth, api, pool, fundRelayer, fundInfo.address, config.network, networkPassphrase, funcAcquireOptions, tracker);
 }
 /**
  * Main plugin handler exported for OpenZeppelin Relayer

package/dist/plugin/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Exports the main handler function for the Channels plugin
  */
-export { handler } from "./handler";
+export { handler } from './handler';
 //# sourceMappingURL=index.d.ts.map

package/dist/plugin/management.d.ts

@@ -9,7 +9,7 @@
  * - setFeeLimit: sets custom limit for an API key
  * - deleteFeeLimit: removes custom limit for an API key
  */
-import type { PluginContext } from "@openzeppelin/relayer-sdk";
+import type { PluginContext } from '@openzeppelin/relayer-sdk';
 export declare function isManagementRequest(params: any): boolean;
 export declare function handleManagement(context: PluginContext): Promise<any>;
 //# sourceMappingURL=management.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/plugin/management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,2BAA2B,CAAC;AAM9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAOxD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CA8C3E"}
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/plugin/management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,2BAA2B,CAAC;AAM9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAIxD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAkC3E"}