@bitgo/public-types 6.63.0 → 6.64.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitgo/public-types",
-  "version": "6.63.0",
+  "version": "6.64.0",
   "description": "Collection of types exposed externally as part of the BitGo public API",
   "license": "UNLICENSED",
   "author": "",

package/src/schema/transactionRequest/intents/adaCancelIntent.ts

@@ -0,0 +1,26 @@
+import * as t from "io-ts";
+import { BaseStakeIntent } from "./baseStakeIntent";
+import { intentTypes } from "./intentType";
+
+/**
+ * @title ADA RealFi sUSDr Cancel Intent
+ *
+ * @description Cancel a pending RealFi order (`intentType: cancel`, `stakingType: REALFI_SUSDR`).
+ * Lives in this coin-level file so a native ADA cancel can be added later.
+ *
+ * @param {string} orderTxHash Order output transaction hash
+ * @param {number} orderOutputIndex Order UTxO output index
+ * @param {string} destinationAddress Address that receives reclaimed funds
+ */
+export const AdaRealFiCancelIntent = t.intersection([
+  BaseStakeIntent,
+  t.type({
+    intentType: intentTypes.cancel,
+    stakingType: t.literal("REALFI_SUSDR"),
+    orderTxHash: t.string,
+    orderOutputIndex: t.number,
+    destinationAddress: t.string,
+  }),
+]);
+
+export type AdaRealFiCancelIntent = t.TypeOf<typeof AdaRealFiCancelIntent>;

package/src/schema/transactionRequest/intents/adaStakeIntent.ts

@@ -2,11 +2,13 @@ import * as t from "io-ts";
 import { StakeIntent } from "./stakeIntent";
 import { Amount } from "./amount";
 import { Optional } from "../../../utils";
+import { AdaStakingType } from "./adaStakingType";
+import { BaseIntentWithAmount } from "./baseIntent";
 
 /**
  * @title ADA Stake Intent
  *
- * @description The intent to stake ADA
+ * @description The intent to stake ADA. Omit `stakingType` or set `NATIVE` for pool + dRep.
  *
  * @param {string} poolKeyHash The key hash for the staking pool
  * @param {string} dRepId The identifier for a DRep
@@ -20,7 +22,32 @@ export const AdaStakeIntent = t.intersection([
   }),
   t.partial({
     amount: Optional(Amount),
+    stakingType: Optional(AdaStakingType),
   }),
 ]);
 
 export type AdaStakeIntent = t.TypeOf<typeof AdaStakeIntent>;
+
+/**
+ * @title ADA RealFi sUSDr Stake Intent
+ *
+ * @description Stake USDr into RealFi sUSDr (`intentType: stake`, `stakingType: REALFI_SUSDR`).
+ * Extends `StakeIntent` (not `AdaStakeIntent`) — RealFi has no `poolKeyHash` / `dRepId`.
+ *
+ * @param {Amount} amount USDr amount (`ada:usdr`)
+ * @param {string} destinationAddress Order output address
+ * @param {number} slippageToleranceBps Optional; staking-service default 50
+ */
+export const AdaRealFiStakeIntent = t.intersection([
+  StakeIntent,
+  BaseIntentWithAmount,
+  t.type({
+    stakingType: t.literal("REALFI_SUSDR"),
+    destinationAddress: t.string,
+  }),
+  t.partial({
+    slippageToleranceBps: Optional(t.number),
+  }),
+]);
+
+export type AdaRealFiStakeIntent = t.TypeOf<typeof AdaRealFiStakeIntent>;

package/src/schema/transactionRequest/intents/adaStakingType.ts

@@ -0,0 +1,11 @@
+import * as t from "io-ts";
+
+/** Cardano staking provider. Omit/`NATIVE` = pool + dRep; `REALFI_SUSDR` = RealFi sUSDr. */
+export enum AdaStakingTypeEnum {
+  NATIVE = "NATIVE",
+  REALFI_SUSDR = "REALFI_SUSDR",
+}
+
+export const AdaStakingType = t.keyof(AdaStakingTypeEnum);
+
+export type AdaStakingType = t.TypeOf<typeof AdaStakingType>;

package/src/schema/transactionRequest/intents/adaUnstakeIntent.ts

@@ -2,9 +2,13 @@ import * as t from "io-ts";
 import { Amount } from "./amount";
 import { Optional } from "../../../utils";
 import { UnstakeIntent } from "./unstakeIntent";
+import { AdaStakingType } from "./adaStakingType";
+import { BaseIntentWithAmount } from "./baseIntent";
 
 /**
  * @title ADA Unstake Intent
+ *
+ * @description Native ADA unstake. Omit `stakingType` or set `NATIVE`.
  */
 export const AdaUnstakeIntent = t.intersection([
   UnstakeIntent,
@@ -13,7 +17,30 @@ export const AdaUnstakeIntent = t.intersection([
   }),
   t.partial({
     amount: Optional(Amount),
+    stakingType: Optional(AdaStakingType),
   }),
 ]);
 
 export type AdaUnstakeIntent = t.TypeOf<typeof AdaUnstakeIntent>;
+
+/**
+ * @title ADA RealFi sUSDr Unstake Intent
+ *
+ * @description Unstake sUSDr (`intentType: unstake`, `stakingType: REALFI_SUSDR`).
+ * Extends `UnstakeIntent` (not `AdaUnstakeIntent`) — RealFi has no `poolKeyHash`.
+ *
+ * @param {Amount} amount sUSDr amount (`ada:susdr`)
+ * @param {string} destinationAddress Wallet address that receives funds
+ * @param {string} unlockSlot Slot after which funds can be claimed (decimal string; WP/SDK use bigint)
+ */
+export const AdaRealFiUnstakeIntent = t.intersection([
+  UnstakeIntent,
+  BaseIntentWithAmount,
+  t.type({
+    stakingType: t.literal("REALFI_SUSDR"),
+    destinationAddress: t.string,
+    unlockSlot: t.string,
+  }),
+]);
+
+export type AdaRealFiUnstakeIntent = t.TypeOf<typeof AdaRealFiUnstakeIntent>;

package/src/schema/transactionRequest/intents/index.ts

@@ -3,11 +3,13 @@ export * from "./accountBaseBuildOptions";
 export * from "./accountBaseConsolidateIntent";
 export * from "./accountBaseCreateAccountIntent";
 export * from "./accountBaseUpdateAccountIntent";
+export * from "./adaCancelIntent";
 export * from "./adaConsolidateIntent";
 export * from "./adaPaymentIntent";
 export * from "./adaPledgeIntent";
 export * from "./adaStakeClaimRewardsIntent";
 export * from "./adaStakeIntent";
+export * from "./adaStakingType";
 export * from "./adaUnstakeIntent";
 export * from "./adaVoteDelegationIntent";
 export * from "./address";

package/src/schema/transactionRequest/intents/intent.ts

@@ -1,7 +1,8 @@
 import * as t from "io-ts";
 import { AdaConsolidateIntent } from "./adaConsolidateIntent";
 import { AdaPaymentIntent } from "./adaPaymentIntent";
-import { AdaStakeIntent } from "./adaStakeIntent";
+import { AdaRealFiStakeIntent, AdaStakeIntent } from "./adaStakeIntent";
+import { AdaRealFiCancelIntent } from "./adaCancelIntent";
 import { AdaVoteDelegationIntent } from "./adaVoteDelegationIntent";
 import { AptCustomTxIntent } from "./aptCustomTxIntent";
 import { AtomPaymentIntent } from "./atomPaymentIntent";
@@ -88,7 +89,7 @@ import { WalletRecoveryIntent } from "./walletRecoveryIntent";
 import { SolConsolidateIntent } from "./solConsolidateIntent";
 import { TonConsolidateIntent } from "./tonConsolidateIntent";
 import { AdaStakeClaimRewardsIntent } from "./adaStakeClaimRewardsIntent";
-import { AdaUnstakeIntent } from "./adaUnstakeIntent";
+import { AdaRealFiUnstakeIntent, AdaUnstakeIntent } from "./adaUnstakeIntent";
 import { SuiPaymentIntent } from "./suiPaymentIntent";
 import { SuiConsolidateIntent } from "./suiConsolidateIntent";
 import { MmiSignTransactionIntent } from "./mmiSignTransactionIntent";
@@ -159,8 +160,11 @@ export const TransactionIntent = t.union([
   AdaConsolidateIntent,
   AdaPaymentIntent,
   AdaStakeClaimRewardsIntent,
+  AdaRealFiStakeIntent,
   AdaStakeIntent,
+  AdaRealFiUnstakeIntent,
   AdaUnstakeIntent,
+  AdaRealFiCancelIntent,
   AdaVoteDelegationIntent,
   AptCustomTxIntent,
   AtomPaymentIntent,

package/src/schema/transactionRequest/intents/intentType.ts

@@ -8,6 +8,8 @@ export const intentTypes = {
   fanout: t.literal("fanout"),
   stake: t.literal("stake"),
   unstake: t.literal("unstake"),
+  /** Cancel a pending staking order; pair with stakingType (e.g. REALFI_SUSDR). */
+  cancel: t.literal("cancel"),
   delegate: t.literal("delegate"),
   undelegate: t.literal("undelegate"),
   switchValidator: t.literal("switchValidator"),