@riocrypto/common 1.0.2594 → 1.0.2595

package/build/types/fx-trade.d.ts

@@ -15,8 +15,22 @@ export interface FXTrade {
     price: number;
     provider: FXProvider;
     partiallyFilledOrderTTL: number;
+    /**
+     * Operative settlement (what the trade is *hedged* at upstream).
+     * Equals the underlying settlement unless the matched FX trading
+     * policy band carries a `tradeAsTwoWaySettlementDateOffset` override
+     * (or a cosigner-alternative approval swapped the tenor).
+     */
     twoWaySettlementDateOffset: number;
     twoWaySettlementDate: Date;
+    /**
+     * Customer-facing settlement derived from the underlying order(s).
+     * Optional for backwards-compat with trades created before this
+     * field existed; readers fall back to `twoWaySettlementDate*` when
+     * missing.
+     */
+    underlyingTwoWaySettlementDateOffset?: number;
+    underlyingTwoWaySettlementDate?: Date;
     executedTrades: {
         status: ExternalTradeStatus;
         amount: number;

package/build/types/fx-trading-policy.d.ts

@@ -15,12 +15,28 @@ import { Side } from "./side";
  * approval workflow (Emarkets, Transnetwork, StoneX). For Matching / Other
  * the runtime always treats this band as automatic regardless of the
  * stored value.
+ *
+ * `tradeAsTwoWaySettlementDateOffset` is an optional hedge-tenor override.
+ * When set, the band declares "match this band by the order's own offset,
+ * but place the hedge as if it were this offset instead" - useful when ops
+ * wants to hedge T+0 orders as T+1 (or vice versa) for liquidity reasons.
+ * It affects:
+ *   - the offset / value-date sent to the upstream provider at placement;
+ *   - provider eligibility (`isProviderEligible` is checked against the
+ *     effective offset, so a T+0 band that overrides to T+1 can use StoneX
+ *     even though StoneX refuses T+0).
+ * It does NOT touch the customer-facing `twoWaySettlementDate` /
+ * `twoWaySettlementDateOffset` on the order or the FX trade - those
+ * always reflect what the customer was promised. Only allowed for
+ * Emarkets / Transnetwork / StoneX (Matching / Other have no upstream
+ * tenor to override).
  */
 export interface FXTradingPolicyAmountRange {
     minAmount: number;
     maxAmount: number;
     provider: FXProvider;
     automatic: boolean;
+    tradeAsTwoWaySettlementDateOffset?: number;
 }
 /**
  * One time-of-day window within a (fiat, settlement offset, side) policy.
@@ -101,10 +117,17 @@ export type FXTradingPolicies = {
  * the next FX-trade status (e.g. cosigner-notification, alternative
  * approval) build a synthetic `ResolvedFXProvider` because the
  * threshold is irrelevant to that decision.
+ *
+ * `tradeAsTwoWaySettlementDateOffset` mirrors the field on the matched
+ * `FXTradingPolicyAmountRange`. When present the caller must persist
+ * it onto the FX trade and use it at placement time in place of the
+ * trade's `twoWaySettlementDateOffset`. Absent means "place at the
+ * trade's own tenor", which is the existing behavior.
  */
 export interface ResolvedFXProvider {
     provider: FXProvider;
     automatic: boolean;
+    tradeAsTwoWaySettlementDateOffset?: number;
 }
 /**
  * Full output of `resolveFXProviderForAmount`. Adds the time-window's

package/build/types/rio-settings.d.ts

@@ -1,11 +1,9 @@
 import { Country } from "./country";
 import { DeferredPaymentType } from "./deferred-payment-type";
-import { EmarketsSettlementType } from "./emarkets-settlement-type";
 import { Fiat } from "./fiat";
 import { FXProvider } from "./fx-provider";
 import { FXTradingPolicies } from "./fx-trading-policy";
 import { Processor } from "./processor";
-import { TransnetworkSettlementType } from "./transnetwork-settlement-type";
 import { Side } from "./side";
 import { TVFXDataProvider } from "./TV-FX-data-provider";
 export interface RioSettings {
@@ -48,10 +46,6 @@ export interface RioSettings {
     fxProviders: {
         [key in FXProvider]: {
             enabled: boolean;
-            defaultSettlementType?: {
-                buy: EmarketsSettlementType | TransnetworkSettlementType;
-                sell: EmarketsSettlementType | TransnetworkSettlementType;
-            };
         };
     };
     /**

package/build/types/user-attribute.d.ts

@@ -17,8 +17,6 @@ export declare enum UserAttribute {
     DisburseMorningSellOrdersWithoutCosigner = "disburseMorningSellOrdersWithoutCosigner",
     DisburseEveningBuyOrdersWithoutCosigner = "disburseEveningBuyOrdersWithoutCosigner",
     DisburseEveningSellOrdersWithoutCosigner = "disburseEveningSellOrdersWithoutCosigner",
-    PlaceBuyOrderAutoFXWithoutCosigner = "placeBuyOrderAutoFXWithoutCosigner",
-    PlaceSellOrderAutoFXWithoutCosigner = "placeSellOrderAutoFXWithoutCosigner",
     UseFireblocksOvernightAndWeekendVault = "useFireblocksOvernightAndWeekendVault",
     SkipPeriodicWalletComplianceCheck = "skipPeriodicWalletComplianceCheck",
     UseSTPForMXNWithdrawals = "useSTPForMXNWithdrawals",

package/build/types/user-attribute.js

@@ -21,8 +21,6 @@ var UserAttribute;
     UserAttribute["DisburseMorningSellOrdersWithoutCosigner"] = "disburseMorningSellOrdersWithoutCosigner";
     UserAttribute["DisburseEveningBuyOrdersWithoutCosigner"] = "disburseEveningBuyOrdersWithoutCosigner";
     UserAttribute["DisburseEveningSellOrdersWithoutCosigner"] = "disburseEveningSellOrdersWithoutCosigner";
-    UserAttribute["PlaceBuyOrderAutoFXWithoutCosigner"] = "placeBuyOrderAutoFXWithoutCosigner";
-    UserAttribute["PlaceSellOrderAutoFXWithoutCosigner"] = "placeSellOrderAutoFXWithoutCosigner";
     UserAttribute["UseFireblocksOvernightAndWeekendVault"] = "useFireblocksOvernightAndWeekendVault";
     UserAttribute["SkipPeriodicWalletComplianceCheck"] = "skipPeriodicWalletComplianceCheck";
     UserAttribute["UseSTPForMXNWithdrawals"] = "useSTPForMXNWithdrawals";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riocrypto/common",
-  "version": "1.0.2594",
+  "version": "1.0.2595",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",