@bitgo/public-types 6.84.0 → 6.86.0

package/dist/src/schema/transactionRequest/intents/unstakeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const UnstakeIntent: t.IntersectionC<[t.IntersectionC<[t.Intersec
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/unwrapNativeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const UnwrapNativeIntent: t.IntersectionC<[t.IntersectionC<[t.Typ
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/validatorRegistrationIntent.d.ts

@@ -32,6 +32,7 @@ export declare const ValidatorRegistrationIntent: t.IntersectionC<[t.Intersectio
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetDecreaseStakeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetDecreaseStakeIntent: t.IntersectionC<[t.IntersectionC<[t
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetDelegateIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetDelegateIntent: t.IntersectionC<[t.IntersectionC<[t.Inte
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetIncreaseStakeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetIncreaseStakeIntent: t.IntersectionC<[t.IntersectionC<[t
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetSignalExitIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetSignalExitIntent: t.IntersectionC<[t.IntersectionC<[t.In
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetStakeClaimRewardsIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetStakeClaimRewardsIntent: t.IntersectionC<[t.Intersection
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetStakingIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetStakingIntent: t.IntersectionC<[t.IntersectionC<[t.Inter
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetUnstakingIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetExitDelegationIntent: t.IntersectionC<[t.IntersectionC<[
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;
@@ -129,6 +130,7 @@ export declare const VetBurnNFTIntent: t.IntersectionC<[t.IntersectionC<[t.Inter
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetValidatorRegistrationIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetValidatorRegistrationIntent: t.IntersectionC<[t.Intersec
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/vetWithdrawStakeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VetWithdrawStakeIntent: t.IntersectionC<[t.IntersectionC<[t
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/voteDelegationIntent.d.ts

@@ -32,6 +32,7 @@ export declare const VoteDelegationIntent: t.IntersectionC<[t.IntersectionC<[t.I
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/walletRecoveryIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WalletRecoveryIntent: t.IntersectionC<[t.IntersectionC<[t.T
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/walrusStakingIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WalrusStakingIntent: t.IntersectionC<[t.IntersectionC<[t.In
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/walrusUndelegateIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WalrusUndelegateIntent: t.IntersectionC<[t.IntersectionC<[t
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/walrusWithdrawIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WalrusWithdrawIntent: t.IntersectionC<[t.IntersectionC<[t.I
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/withdrawIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WithdrawIntent: t.IntersectionC<[t.IntersectionC<[t.Interse
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/withdrawIntent.js.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawIntent.js","sourceRoot":"","sources":["../../../../../src/schema/transactionRequest/intents/withdrawIntent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA2B;AAC3B,uDAAoD;AACpD,6CAA2C;AAC3C,qCAAkC;AAClC,0CAA0C;AAE7B,QAAA,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3C,iCAAe;IACf,CAAC,CAAC,IAAI,CAAC;QAEL,UAAU,EAAE,wBAAW,CAAC,KAAK;KAC9B,CAAC;IACF,CAAC,CAAC,OAAO,CAAC;QACR,MAAM,EAAE,IAAA,gBAAQ,EAAC,eAAM,CAAC;KACzB,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"withdrawIntent.js","sourceRoot":"","sources":["../../../../../src/schema/transactionRequest/intents/withdrawIntent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA2B;AAC3B,uDAAoD;AACpD,6CAA2C;AAC3C,qCAAkC;AAClC,0CAA0C;AAE7B,QAAA,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3C,iCAAe;IACf,CAAC,CAAC,IAAI,CAAC;QAEL,UAAU,EAAE,wBAAW,CAAC,KAAK;KAC9B,CAAC;IACF,CAAC,CAAC,OAAO,CAAC;QAKR,MAAM,EAAE,IAAA,gBAAQ,EAAC,eAAM,CAAC;KACzB,CAAC;CACH,CAAC,CAAC"}

package/dist/src/schema/transactionRequest/intents/wrapApproveIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WrapApproveIntent: t.IntersectionC<[t.IntersectionC<[t.Type
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/wrapNativeIntent.d.ts

@@ -32,6 +32,7 @@ export declare const WrapNativeIntent: t.IntersectionC<[t.IntersectionC<[t.TypeC
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/xdcStakingIntent.d.ts

@@ -32,6 +32,7 @@ export declare const XdcUploadKycIntent: t.IntersectionC<[t.IntersectionC<[t.Int
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;
@@ -128,6 +129,7 @@ export declare const XdcProposeIntent: t.IntersectionC<[t.IntersectionC<[t.Inter
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/dist/src/schema/transactionRequest/intents/xdcUnstakingIntent.d.ts

@@ -32,6 +32,7 @@ export declare const XdcResignIntent: t.IntersectionC<[t.IntersectionC<[t.Inters
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;
@@ -128,6 +129,7 @@ export declare const XdcWithdrawIntent: t.IntersectionC<[t.IntersectionC<[t.Inte
         contractCall: t.LiteralC<"contractCall">;
         deactivate: t.LiteralC<"deactivate">;
         customTx: t.LiteralC<"customTx">;
+        confidentialTransfer: t.LiteralC<"confidentialTransfer">;
         closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
         stakeWithCallData: t.LiteralC<"stakeWithCallData">;
         unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;

package/package.json

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

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

@@ -134,6 +134,7 @@ export * from "./recipientEntry";
 export * from "./signMessageIntent";
 export * from "./solAuthorizeIntent";
 export * from "./solBuildOptions";
+export * from "./solConfidentialTransferIntent";
 export * from "./solClaimIntent";
 export * from "./solCloseAssociatedTokenAccountIntent";
 export * from "./solConsolidateIntent";
@@ -142,11 +143,13 @@ export * from "./solCustomTxIntent";
 export * from "./solDeactivateIntent";
 export * from "./solDelegateIntent";
 export * from "./solGoUnstakeIntent";
+export * from "./solVersionMarker";
 export * from "./solPaymentIntent";
 export * from "./solStakeIntent";
 export * from "./solStakingType";
 export * from "./solUnstakeIntent";
 export * from "./solVersionedCustomTxIntent";
+export * from "./solVersionedTransactionData";
 export * from "./stacksRegisterForBondIntent";
 export * from "./stakeClaimRewardsIntent";
 export * from "./stakeIntent";

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

@@ -37,6 +37,7 @@ export const intentTypes = {
   contractCall: t.literal("contractCall"),
   deactivate: t.literal("deactivate"),
   customTx: t.literal("customTx"),
+  confidentialTransfer: t.literal("confidentialTransfer"),
   closeAssociatedTokenAccount: t.literal("closeAssociatedTokenAccount"),
   stakeWithCallData: t.literal("stakeWithCallData"),
   unstakeWithCallData: t.literal("unstakeWithCallData"),

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

@@ -0,0 +1,42 @@
+import * as t from "io-ts";
+import { BaseIntent } from "./baseIntent";
+import { SolBuildOptions } from "./solBuildOptions";
+import { SolVersionedTransactionData } from "./solVersionedTransactionData";
+import { intentTypes } from "./intentType";
+
+/**
+ * Structured Solana Token-2022 confidential-transfer intent (Phase 1a).
+ *
+ * Clients supply structured fields (tokenId, recipient, amount); the platform
+ * validates the SDK-built envelope against those fields before signing (interim
+ * carrier while server-side proof generation is wired) and will construct the
+ * instructions server-side once that integration lands.
+ *
+ * @title SOL Confidential Transfer Intent
+ */
+export const SolConfidentialTransferIntent = t.intersection([
+  BaseIntent,
+  SolBuildOptions,
+  t.type({
+    /** Must be "confidentialTransfer". */
+    intentType: intentTypes.confidentialTransfer,
+    solConfidentialTransferData: t.intersection([
+      t.type({
+        /** The Token-2022 mint (confidential token) to transfer. */
+        tokenId: t.string,
+        /** The recipient address (ATA of the recipient for the token). */
+        recipient: t.string,
+        /** The amount to transfer, as a decimal string in the token's base units. */
+        amount: t.string,
+      }),
+      t.partial({
+        /** SDK-built confidential-transfer envelope (interim carrier; server-validated). */
+        solVersionedTransactionData: SolVersionedTransactionData,
+      }),
+    ]),
+  }),
+]);
+
+export type SolConfidentialTransferIntent = t.TypeOf<
+  typeof SolConfidentialTransferIntent
+>;

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

@@ -1,6 +1,7 @@
 import * as t from "io-ts";
 import { PaymentIntent } from "./paymentIntent";
 import { SolBuildOptions } from "./solBuildOptions";
+import { SolVersionMarker } from "./solVersionMarker";
 
 /**
  * Transfer native SOL or SPL tokens to one or more recipients on Solana. For token transfers, the recipient amount symbol must use the "sol:tokenName" format (e.g. "sol:usdc"). Native SOL recipients must not be Associated Token Account (ATA) addresses.
@@ -10,6 +11,7 @@ import { SolBuildOptions } from "./solBuildOptions";
 export const SolPaymentIntent = t.intersection([
   PaymentIntent,
   SolBuildOptions,
+  SolVersionMarker,
 ]);
 
 export type SolPaymentIntent = t.TypeOf<typeof SolPaymentIntent>;

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

@@ -0,0 +1,15 @@
+import * as t from "io-ts";
+
+/**
+ * Optional wire-version marker (0 = v0, 1 = v1 SIMD-0296/0385) for structured Solana intents.
+ *
+ * When `version: 1`, the platform builds the transaction SERVER-SIDE from the
+ * structured intent fields via the SDK v1 serializer — clients supply fields
+ * (recipients, amounts), never instructions. `version: 0` (or absent) selects
+ * the v0 path. Absent-by-default keeps existing clients backward compatible.
+ */
+export const SolVersionMarker = t.partial({
+  version: t.union([t.literal(0), t.literal(1)]),
+});
+
+export type SolVersionMarker = t.TypeOf<typeof SolVersionMarker>;

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

@@ -1,5 +1,6 @@
 import * as t from "io-ts";
 import { SolBuildOptions } from "./solBuildOptions";
+import { SolVersionedTransactionData } from "./solVersionedTransactionData";
 import { BaseIntent } from "./baseIntent";
 import { intentTypes } from "./intentType";
 
@@ -15,47 +16,7 @@ export const SolVersionedCustomTxIntent = t.intersection([
     /** Must be "customTx". Presence of solVersionedTransactionData distinguishes this from legacy SolCustomTxIntent at runtime. */
     intentType: intentTypes.customTx,
     /** Versioned transaction data in Solana v0 message format. Presence of this field indicates a versioned transaction. */
-    solVersionedTransactionData: t.intersection([
-      t.type({
-        /** The program instructions for this versioned transaction. */
-        versionedInstructions: t.array(
-          t.type({
-            /** Index into the staticAccountKeys array identifying the program to invoke. */
-            programIdIndex: t.number,
-            /** Indexes into the combined account keys (static + lookup) for this instruction. */
-            accountKeyIndexes: t.array(t.number),
-            /** Instruction data encoded as base58 or hex. */
-            data: t.string,
-          }),
-        ),
-        /** Address lookup tables to extend the number of accounts beyond the static limit. Required when using account lookup tables in a v0 transaction. */
-        addressLookupTables: t.array(
-          t.type({
-            /** The on-chain address of the lookup table account. */
-            accountKey: t.string,
-            /** Indexes of writable accounts in the lookup table. */
-            writableIndexes: t.array(t.number),
-            /** Indexes of read-only accounts in the lookup table. */
-            readonlyIndexes: t.array(t.number),
-          }),
-        ),
-        /** The static account keys referenced by this transaction. */
-        staticAccountKeys: t.array(t.string),
-        /** Solana message header specifying the number of required signers and read-only accounts. */
-        messageHeader: t.type({
-          /** Number of signatures required for this transaction. */
-          numRequiredSignatures: t.number,
-          /** Number of read-only accounts that require signatures. */
-          numReadonlySignedAccounts: t.number,
-          /** Number of read-only accounts that do not require signatures. */
-          numReadonlyUnsignedAccounts: t.number,
-        }),
-      }),
-      t.partial({
-        /** Optional recent blockhash; when provided the platform uses it instead of fetching a durable nonce. */
-        recentBlockhash: t.string,
-      }),
-    ]),
+    solVersionedTransactionData: SolVersionedTransactionData,
   }),
 ]);
 

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

@@ -0,0 +1,55 @@
+import * as t from "io-ts";
+
+/**
+ * Solana versioned-transaction envelope carried by versioned custom intents and
+ * (as an interim, server-validated carrier) structured confidential-transfer
+ * intents. Client-supplied for customTx; for structured v1 intents the platform
+ * builds the envelope server-side and the client never supplies instructions.
+ */
+export const SolVersionedTransactionData = t.intersection([
+  t.type({
+    /** The program instructions for this versioned transaction. */
+    versionedInstructions: t.array(
+      t.type({
+        /** Index into the staticAccountKeys array identifying the program to invoke. */
+        programIdIndex: t.number,
+        /** Indexes into the combined account keys (static + lookup) for this instruction. */
+        accountKeyIndexes: t.array(t.number),
+        /** Instruction data encoded as base58 or hex. */
+        data: t.string,
+      }),
+    ),
+    /** Address lookup tables to extend the number of accounts beyond the static limit. Required when using account lookup tables in a v0 transaction. */
+    addressLookupTables: t.array(
+      t.type({
+        /** The on-chain address of the lookup table account. */
+        accountKey: t.string,
+        /** Indexes of writable accounts in the lookup table. */
+        writableIndexes: t.array(t.number),
+        /** Indexes of read-only accounts in the lookup table. */
+        readonlyIndexes: t.array(t.number),
+      }),
+    ),
+    /** The static account keys referenced by this transaction. */
+    staticAccountKeys: t.array(t.string),
+    /** Solana message header specifying the number of required signers and read-only accounts. */
+    messageHeader: t.type({
+      /** Number of signatures required for this transaction. */
+      numRequiredSignatures: t.number,
+      /** Number of read-only accounts that require signatures. */
+      numReadonlySignedAccounts: t.number,
+      /** Number of read-only accounts that do not require signatures. */
+      numReadonlyUnsignedAccounts: t.number,
+    }),
+  }),
+  t.partial({
+    /** Optional recent blockhash; when provided the platform uses it instead of fetching a durable nonce. */
+    recentBlockhash: t.string,
+    /** Wire version: 0 (v0) or 1 (v1, SIMD-0296/0385). Absent means v0. */
+    version: t.union([t.literal(0), t.literal(1)]),
+  }),
+]);
+
+export type SolVersionedTransactionData = t.TypeOf<
+  typeof SolVersionedTransactionData
+>;

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

@@ -15,8 +15,17 @@ export const TaoClaimRootIntent = t.intersection([
   BaseStakeIntent,
   SubstrateAccountBaseBuildOptions,
   t.type({
+    /** Must be "stakeClaimRewards". */
     intentType: intentTypes.stakeClaimRewards,
+    /**
+     * SS58-encoded public key of the hotkey whose accrued root-network basket
+     * rewards are being claimed.
+     */
     hotkey: t.string,
+    /**
+     * Must be "0" — the root network identifier. The underlying
+     * claimRootWithHotkey extrinsic only exists for the root network.
+     */
     netuid: t.string,
   }),
 ]);

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

@@ -3,12 +3,18 @@ import { StakeIntent } from "./stakeIntent";
 import { TaoStakingBaseIntent } from "./taoStakingBaseIntent";
 
 /**
+ * Stake TAO from the wallet's root address (coldkey) to a hotkey (validator)
+ * on a specified Bittensor subnet. Corresponds to the on-chain `add_stake`
+ * extrinsic. Requires a staking request ID from the BitGo staking service,
+ * and requires the enterprise to have staking permissions.
+ *
  * @title Tao Stake Intent
  */
 export const TaoStakeIntent = t.intersection([
   StakeIntent,
   TaoStakingBaseIntent,
   t.type({
+    /** Amount to stake, in base units (RAO for native TAO). */
     amountStaked: t.string,
   }),
 ]);

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

@@ -3,13 +3,25 @@ import { BaseStakeIntent } from "./baseStakeIntent";
 import { SubstrateAccountBaseBuildOptions } from "./substrateAccountBaseBuildOptions";
 
 /**
+ * Base fields shared by the TAO staking intents (`stake` and `claim`): the
+ * hotkey (validator) and Bittensor subnet to operate on. All TAO staking
+ * operations are submitted by the wallet's root address (coldkey).
+ *
  * @title Tao Staking Base Intent
  */
 export const TaoStakingBaseIntent = t.intersection([
   BaseStakeIntent,
   SubstrateAccountBaseBuildOptions,
   t.type({
+    /**
+     * SS58-encoded public key of the hotkey (validator) to stake to or
+     * remove stake from on the specified subnet.
+     */
     hotkey: t.string,
+    /**
+     * Numeric identifier of the Bittensor subnet to stake on or remove stake
+     * from, as a string. Use "0" for the root network.
+     */
     netuid: t.string,
   }),
 ]);

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

@@ -4,17 +4,42 @@ import { SubstrateAccountBaseBuildOptions } from "./substrateAccountBaseBuildOpt
 import { intentTypes } from "./intentType";
 
 /**
+ * Move staked alpha tokens from one hotkey (validator) or subnet to another
+ * within the same wallet coldkey — no unstaking and re-staking required.
+ * Corresponds to the on-chain `move_stake` extrinsic.
+ *
  * @title Tao Switch Validator Intent
  */
 export const TaoSwitchValidatorIntent = t.intersection([
   BaseStakeIntent,
   SubstrateAccountBaseBuildOptions,
   t.type({
+    /** Must be "switchValidator". */
     intentType: intentTypes.switchValidator,
+    /**
+     * SS58-encoded public key of the source hotkey (validator) currently
+     * holding the stake.
+     */
     originHotkey: t.string,
+    /**
+     * SS58-encoded public key of the target hotkey (validator) to move the
+     * stake to.
+     */
     destinationHotkey: t.string,
+    /**
+     * Numeric identifier of the source subnet where the stake currently
+     * resides, as a string.
+     */
     originNetuid: t.string,
+    /**
+     * Numeric identifier of the destination subnet to move the stake to,
+     * as a string. May equal originNetuid when changing hotkeys only.
+     */
     destinationNetuid: t.string,
+    /**
+     * Amount of alpha tokens to move, in raw alpha units. Must not exceed
+     * the staked balance for originHotkey on originNetuid.
+     */
     alphaAmount: t.string,
   }),
 ]);

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

@@ -5,18 +5,51 @@ import { intentTypes } from "./intentType";
 import { optionalString } from "../../../utils";
 
 /**
+ * Transfer staked alpha tokens from this wallet's coldkey to another coldkey
+ * on a specified subnet. This cross-coldkey operation transfers ownership of
+ * the stake without unstaking; it is distinct from switchValidator, which
+ * moves stake within the same coldkey. Corresponds to the on-chain
+ * `transfer_stake` extrinsic.
+ *
  * @title Tao Transfer Stake Intent
  */
 export const TaoTransferStakeIntent = t.intersection([
   BaseStakeIntent,
   SubstrateAccountBaseBuildOptions,
   t.type({
+    /** Must be "transferStake". */
     intentType: intentTypes.transferStake,
+    /**
+     * Optional SS58-encoded coldkey address within this wallet to send the
+     * stake from. Defaults to the wallet's root address when omitted. Must
+     * be a wallet-owned address; otherwise the request fails with an
+     * AddressNotFound error.
+     */
     originColdkey: optionalString,
+    /**
+     * SS58-encoded coldkey address of the recipient who will own the stake
+     * after the transfer. May belong to any wallet.
+     */
     destinationColdkey: t.string,
+    /**
+     * SS58-encoded public key of the hotkey (validator) whose stake position
+     * is being transferred. Must have an active stake on originNetuid.
+     */
     hotkey: t.string,
+    /**
+     * Numeric identifier of the source subnet where the stake currently
+     * resides, as a string.
+     */
     originNetuid: t.string,
+    /**
+     * Numeric identifier of the destination subnet where the transferred
+     * stake will be registered, as a string. May differ from originNetuid.
+     */
     destinationNetuid: t.string,
+    /**
+     * Amount of alpha tokens to transfer, in raw alpha units. Must not
+     * exceed the staked alpha balance for hotkey on originNetuid.
+     */
     alphaAmount: t.string,
   }),
 ]);