@bitgo/public-types 6.28.0 → 6.29.0

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

@@ -7844,6 +7844,7 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
         memo: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"deactivate">;
+    }>, t.PartialC<{
         stakingAddresses: t.UnionC<[t.Type<string[], string[], unknown>, t.UndefinedC]>;
         stakingAddress: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
     }>]>, t.IntersectionC<[t.IntersectionC<[t.TypeC<{
@@ -7926,9 +7927,10 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"delegate">;
         validatorAddress: t.StringC;
+    }>, t.PartialC<{
         stakingAddresses: t.UnionC<[t.Type<string[], string[], unknown>, t.UndefinedC]>;
         stakingAddress: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
-    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -8001,8 +8003,6 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
-    }>]>, t.TypeC<{
-        goStakingRequestId: t.StringC;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"goUnstake">;
         recipients: t.ArrayC<t.IntersectionC<[t.TypeC<{
@@ -8025,7 +8025,9 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
     }>, t.TypeC<{
         memo: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
-    }>]>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.PartialC<{
+        goStakingRequestId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -8909,7 +8911,7 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"customTx">;
         rawTx: t.StringC;
-    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -8982,8 +8984,6 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
-    }>]>, t.TypeC<{
-        goStakingRequestId: t.StringC;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"goUnstake">;
         recipients: t.ArrayC<t.IntersectionC<[t.TypeC<{
@@ -9075,6 +9075,81 @@ export declare const TransactionRequestLite: t.IntersectionC<[t.IntersectionC<[t
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
+    }>]>, t.TypeC<{
+        goStakingRequestId: t.StringC;
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+        intentType: t.KeyofC<{
+            payment: t.LiteralC<"payment">;
+            transferToken: t.LiteralC<"transferToken">;
+            consolidate: t.LiteralC<"consolidate">;
+            consolidateToken: t.LiteralC<"consolidateToken">;
+            fanout: t.LiteralC<"fanout">;
+            stake: t.LiteralC<"stake">;
+            unstake: t.LiteralC<"unstake">;
+            delegate: t.LiteralC<"delegate">;
+            undelegate: t.LiteralC<"undelegate">;
+            switchValidator: t.LiteralC<"switchValidator">;
+            claim: t.LiteralC<"claim">;
+            stakeClaimRewards: t.LiteralC<"stakeClaimRewards">;
+            pledge: t.LiteralC<"pledge">;
+            voteDelegation: t.LiteralC<"voteDelegation">;
+            vote: t.LiteralC<"vote">;
+            createAccount: t.LiteralC<"createAccount">;
+            updateAccount: t.LiteralC<"updateAccount">;
+            addTrustLine: t.LiteralC<"addTrustLine">;
+            removeTrustLine: t.LiteralC<"removeTrustLine">;
+            signMessage: t.LiteralC<"signMessage">;
+            signTypedStructuredData: t.LiteralC<"signTypedStructuredData">;
+            enableToken: t.LiteralC<"enableToken">;
+            authorize: t.LiteralC<"authorize">;
+            acceleration: t.LiteralC<"acceleration">;
+            fillNonce: t.LiteralC<"fillNonce">;
+            walletRecovery: t.LiteralC<"walletRecovery">;
+            contractCall: t.LiteralC<"contractCall">;
+            deactivate: t.LiteralC<"deactivate">;
+            customTx: t.LiteralC<"customTx">;
+            closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
+            stakeWithCallData: t.LiteralC<"stakeWithCallData">;
+            unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;
+            switchValidatorWithCallData: t.LiteralC<"switchValidatorWithCallData">;
+            feeAddressTransfer: t.LiteralC<"feeAddressTransfer">;
+            tokenApproval: t.LiteralC<"tokenApproval">;
+            transferStake: t.LiteralC<"transferStake">;
+            validatorRegistration: t.LiteralC<"validatorRegistration">;
+            increaseStake: t.LiteralC<"increaseStake">;
+            decreaseStake: t.LiteralC<"decreaseStake">;
+            signalExit: t.LiteralC<"signalExit">;
+            withdrawStake: t.LiteralC<"withdrawStake">;
+            spotTransfer: t.LiteralC<"spotTransfer">;
+            bridgeFunds: t.LiteralC<"bridgeFunds">;
+            enableBridging: t.LiteralC<"enableBridging">;
+            goUnstake: t.LiteralC<"goUnstake">;
+            createBtcDelegation: t.LiteralC<"createBtcDelegation">;
+            transferAccept: t.LiteralC<"transferAccept">;
+            transferReject: t.LiteralC<"transferReject">;
+            transferAcknowledge: t.LiteralC<"transferAcknowledge">;
+            transferOfferWithdrawn: t.LiteralC<"transferOfferWithdrawn">;
+            cosignDelegationProposal: t.LiteralC<"cosignDelegationProposal">;
+            cosignDelegationAccept: t.LiteralC<"cosignDelegationAccept">;
+            allocationRequest: t.LiteralC<"allocationRequest">;
+            cantonCommand: t.LiteralC<"cantonCommand">;
+            allocationAllocate: t.LiteralC<"allocationAllocate">;
+            cantonEndInvestorOnboardingOffer: t.LiteralC<"cantonEndInvestorOnboardingOffer">;
+            cantonEndInvestorOnboardingAccept: t.LiteralC<"cantonEndInvestorOnboardingAccept">;
+            cantonEndInvestorOnboardingReject: t.LiteralC<"cantonEndInvestorOnboardingReject">;
+            "defi-deposit": t.LiteralC<"defi-deposit">;
+            "defi-redeem": t.LiteralC<"defi-redeem">;
+            "defi-approve": t.LiteralC<"defi-approve">;
+            delegateResource: t.LiteralC<"delegateResource">;
+            undelegateResource: t.LiteralC<"undelegateResource">;
+            export: t.LiteralC<"export">;
+            import: t.LiteralC<"import">;
+            importtoc: t.LiteralC<"importtoc">;
+        }>;
+    }>, t.PartialC<{
+        sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+        comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+        nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
     }>]>, t.TypeC<{
         feeOptions: t.TypeC<{
             gasLimit: t.NumberC;
@@ -22073,6 +22148,7 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
         memo: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"deactivate">;
+    }>, t.PartialC<{
         stakingAddresses: t.UnionC<[t.Type<string[], string[], unknown>, t.UndefinedC]>;
         stakingAddress: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
     }>]>, t.IntersectionC<[t.IntersectionC<[t.TypeC<{
@@ -22155,9 +22231,10 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"delegate">;
         validatorAddress: t.StringC;
+    }>, t.PartialC<{
         stakingAddresses: t.UnionC<[t.Type<string[], string[], unknown>, t.UndefinedC]>;
         stakingAddress: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
-    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -22230,8 +22307,6 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
-    }>]>, t.TypeC<{
-        goStakingRequestId: t.StringC;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"goUnstake">;
         recipients: t.ArrayC<t.IntersectionC<[t.TypeC<{
@@ -22254,7 +22329,9 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
     }>, t.TypeC<{
         memo: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
-    }>]>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.PartialC<{
+        goStakingRequestId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -23138,7 +23215,7 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"customTx">;
         rawTx: t.StringC;
-    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.IntersectionC<[t.TypeC<{
         intentType: t.KeyofC<{
             payment: t.LiteralC<"payment">;
             transferToken: t.LiteralC<"transferToken">;
@@ -23211,8 +23288,6 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
-    }>]>, t.TypeC<{
-        goStakingRequestId: t.StringC;
     }>]>, t.TypeC<{
         intentType: t.LiteralC<"goUnstake">;
         recipients: t.ArrayC<t.IntersectionC<[t.TypeC<{
@@ -23304,6 +23379,81 @@ export declare const TransactionRequest: t.UnionC<[t.IntersectionC<[t.Intersecti
         sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
         nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
+    }>]>, t.TypeC<{
+        goStakingRequestId: t.StringC;
+    }>]>, t.IntersectionC<[t.IntersectionC<[t.TypeC<{
+        intentType: t.KeyofC<{
+            payment: t.LiteralC<"payment">;
+            transferToken: t.LiteralC<"transferToken">;
+            consolidate: t.LiteralC<"consolidate">;
+            consolidateToken: t.LiteralC<"consolidateToken">;
+            fanout: t.LiteralC<"fanout">;
+            stake: t.LiteralC<"stake">;
+            unstake: t.LiteralC<"unstake">;
+            delegate: t.LiteralC<"delegate">;
+            undelegate: t.LiteralC<"undelegate">;
+            switchValidator: t.LiteralC<"switchValidator">;
+            claim: t.LiteralC<"claim">;
+            stakeClaimRewards: t.LiteralC<"stakeClaimRewards">;
+            pledge: t.LiteralC<"pledge">;
+            voteDelegation: t.LiteralC<"voteDelegation">;
+            vote: t.LiteralC<"vote">;
+            createAccount: t.LiteralC<"createAccount">;
+            updateAccount: t.LiteralC<"updateAccount">;
+            addTrustLine: t.LiteralC<"addTrustLine">;
+            removeTrustLine: t.LiteralC<"removeTrustLine">;
+            signMessage: t.LiteralC<"signMessage">;
+            signTypedStructuredData: t.LiteralC<"signTypedStructuredData">;
+            enableToken: t.LiteralC<"enableToken">;
+            authorize: t.LiteralC<"authorize">;
+            acceleration: t.LiteralC<"acceleration">;
+            fillNonce: t.LiteralC<"fillNonce">;
+            walletRecovery: t.LiteralC<"walletRecovery">;
+            contractCall: t.LiteralC<"contractCall">;
+            deactivate: t.LiteralC<"deactivate">;
+            customTx: t.LiteralC<"customTx">;
+            closeAssociatedTokenAccount: t.LiteralC<"closeAssociatedTokenAccount">;
+            stakeWithCallData: t.LiteralC<"stakeWithCallData">;
+            unstakeWithCallData: t.LiteralC<"unstakeWithCallData">;
+            switchValidatorWithCallData: t.LiteralC<"switchValidatorWithCallData">;
+            feeAddressTransfer: t.LiteralC<"feeAddressTransfer">;
+            tokenApproval: t.LiteralC<"tokenApproval">;
+            transferStake: t.LiteralC<"transferStake">;
+            validatorRegistration: t.LiteralC<"validatorRegistration">;
+            increaseStake: t.LiteralC<"increaseStake">;
+            decreaseStake: t.LiteralC<"decreaseStake">;
+            signalExit: t.LiteralC<"signalExit">;
+            withdrawStake: t.LiteralC<"withdrawStake">;
+            spotTransfer: t.LiteralC<"spotTransfer">;
+            bridgeFunds: t.LiteralC<"bridgeFunds">;
+            enableBridging: t.LiteralC<"enableBridging">;
+            goUnstake: t.LiteralC<"goUnstake">;
+            createBtcDelegation: t.LiteralC<"createBtcDelegation">;
+            transferAccept: t.LiteralC<"transferAccept">;
+            transferReject: t.LiteralC<"transferReject">;
+            transferAcknowledge: t.LiteralC<"transferAcknowledge">;
+            transferOfferWithdrawn: t.LiteralC<"transferOfferWithdrawn">;
+            cosignDelegationProposal: t.LiteralC<"cosignDelegationProposal">;
+            cosignDelegationAccept: t.LiteralC<"cosignDelegationAccept">;
+            allocationRequest: t.LiteralC<"allocationRequest">;
+            cantonCommand: t.LiteralC<"cantonCommand">;
+            allocationAllocate: t.LiteralC<"allocationAllocate">;
+            cantonEndInvestorOnboardingOffer: t.LiteralC<"cantonEndInvestorOnboardingOffer">;
+            cantonEndInvestorOnboardingAccept: t.LiteralC<"cantonEndInvestorOnboardingAccept">;
+            cantonEndInvestorOnboardingReject: t.LiteralC<"cantonEndInvestorOnboardingReject">;
+            "defi-deposit": t.LiteralC<"defi-deposit">;
+            "defi-redeem": t.LiteralC<"defi-redeem">;
+            "defi-approve": t.LiteralC<"defi-approve">;
+            delegateResource: t.LiteralC<"delegateResource">;
+            undelegateResource: t.LiteralC<"undelegateResource">;
+            export: t.LiteralC<"export">;
+            import: t.LiteralC<"import">;
+            importtoc: t.LiteralC<"importtoc">;
+        }>;
+    }>, t.PartialC<{
+        sequenceId: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+        comment: t.UnionC<[t.Type<string, string, unknown>, t.UndefinedC]>;
+        nonce: t.UnionC<[t.Type<string | number, string | number, unknown>, t.UndefinedC]>;
     }>]>, t.TypeC<{
         feeOptions: t.TypeC<{
             gasLimit: t.NumberC;

package/package.json

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

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

@@ -2,16 +2,15 @@ import * as t from "io-ts";
 import { BaseIntent } from "./baseIntent";
 
 /**
- * @title BaseGoStakeIntent
- *
- * @description base interface for Go staking intents.
- *
- * @param {string} goStakingRequestId - The unique identifier for the Go staking request.
+ * Base interface for GO wallet staking intents that require a GO staking
+ * request identifier (e.g. admin/internal go-unstake flows such as Sui).
  *
+ * @title BaseGoStakeIntent
  */
 export const BaseGoStakeIntent = t.intersection([
   BaseIntent,
   t.type({
+    /** Internal coordination identifier for the GO staking request. */
     goStakingRequestId: t.string,
   }),
 ]);

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

@@ -6,7 +6,9 @@ import { TokenEnablement } from "./tokenEnablement";
 export const EnableTokenIntent = t.intersection([
   BaseIntent,
   t.type({
+    /** Must be "enableToken". */
     intentType: intentTypes.enableToken,
+    /** One or more token entries specifying which tokens to enable. */
     enableTokens: t.array(TokenEnablement),
   }),
 ]);

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

@@ -1,20 +1,21 @@
 import * as t from "io-ts";
 import { RecipientEntry } from "./recipientEntry";
 import { intentTypes } from "./intentType";
-import { BaseGoStakeIntent } from "./baseGoStakeIntent";
+import { BaseIntent } from "./baseIntent";
 
 /**
- * @title GoUnstakeIntent
- *
- * @description interface for Go unstake intents.
- *
- * @param {RecipientEntry[]} recipients - An array of recipient entries, for the address and amount.
+ * Base intent for GO wallet unstaking operations. Chain-specific go-unstake
+ * intents (e.g. Sol, Sui) compose this and declare `goStakingRequestId`
+ * according to their own requirements (optional for Sol, required for Sui).
  *
+ * @title GoUnstakeIntent
  */
 export const GoUnstakeIntent = t.intersection([
-  BaseGoStakeIntent,
+  BaseIntent,
   t.type({
+    /** Must be "goUnstake". */
     intentType: intentTypes.goUnstake,
+    /** The recipients to send unstaked funds to. */
     recipients: t.array(RecipientEntry),
   }),
 ]);

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

@@ -4,20 +4,31 @@ import { BaseIntent } from "./baseIntent";
 import { intentTypes } from "./intentType";
 
 /**
+ * Transfer the withdrawal and lockup authority of a SOL stake account to new public keys on Solana. The transactionMessage must be a pre-signed serialized transaction validated by the platform against all provided address fields. Spending policy is not evaluated for this intent. Requires the solStakingAuthorize enterprise feature flag.
+ *
  * @title SOL Authorize Intent
  */
 export const SolAuthorizeIntent = t.intersection([
   BaseIntent,
   SolBuildOptions,
   t.type({
+    /** Must be "authorize". */
     intentType: intentTypes.authorize,
+    /** The pre-signed serialized transaction message, validated by the platform against the provided address fields. */
     transactionMessage: t.string,
+    /** The on-chain stake account whose authority is being transferred. */
     stakeAccount: t.string,
+    /** The current withdrawal authority public key. */
     oldWithdrawPublicKey: t.string,
+    /** The new withdrawal authority public key. */
     newWithdrawPublicKey: t.string,
+    /** The lockup authority public key. */
     lockupPublicKey: t.string,
+    /** The durable nonce account used for this transaction. */
     nonceAccount: t.string,
+    /** The authority of the nonce account. */
     nonceAuthority: t.string,
+    /** The recent blockhash used in the transaction message. */
     blockhash: t.string,
   }),
 ]);

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

@@ -19,6 +19,7 @@ import { AccountBaseBuildOptions } from "./accountBaseBuildOptions";
 export const SolBuildOptions = t.intersection([
   AccountBaseBuildOptions,
   t.type({
+    /** Memo string for the transaction. The key must be present; pass an empty string (or omit the value) if unused. */
     memo: optionalString,
   }),
 ]);

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

@@ -4,6 +4,8 @@ import { WithdrawIntent } from "./withdrawIntent";
 import { BaseIntentWithAmount } from "./baseIntent";
 
 /**
+ * Withdraw the balance from a deactivated SOL stake account back to the wallet on Solana. The stake account must have been deactivated (unstaked) before claiming. Spending policy is not evaluated for this intent.
+ *
  * @title SOL Claim Intent
  */
 export const SolClaimIntent = t.intersection([
@@ -11,6 +13,7 @@ export const SolClaimIntent = t.intersection([
   SolBuildOptions,
   BaseIntentWithAmount,
   t.type({
+    /** The on-chain stake account address to withdraw from. */
     stakingAddress: t.string,
   }),
 ]);

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

@@ -117,6 +117,8 @@ const solCloseAssociatedTokenAccountRecipients = t.brand(
 );
 
 /**
+ * Close one or more zero-balance SPL Associated Token Accounts (ATAs) on Solana and recover their rent lamports to the wallet root address. All ATAs must have a zero token balance (consolidate tokens first), share the same on-chain owner, and be owned by this wallet. Maximum 27 distinct ATAs per transaction. Spending policy is not evaluated for this intent.
+ *
  * @title SOL Close Associated Token Account Intent
  *
  * After `decode`, prefer annotating or threading values as the exported
@@ -129,7 +131,9 @@ export const SolCloseAssociatedTokenAccountIntent = t.intersection([
   BaseIntent,
   SolBuildOptions,
   t.type({
+    /** Must be "closeAssociatedTokenAccount". */
     intentType: intentTypes.closeAssociatedTokenAccount,
+    /** One or more zero-balance ATAs to close. Each entry must have amount.value === "0", must not carry tokenName or tokenData, and all entries must share the same on-chain owner. Maximum 27 ATAs per transaction. */
     recipients: solCloseAssociatedTokenAccountRecipients,
   }),
 ]);

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

@@ -2,6 +2,8 @@ import * as t from "io-ts";
 import { AccountBaseConsolidateIntent } from "./accountBaseConsolidateIntent";
 
 /**
+ * Sweep native SOL and SPL token balances from a receive address into the wallet's root address on Solana. The platform automatically calculates transferable amounts, reserving rent-exempt minimums and transaction fees.
+ *
  * @title SOL Consolidate Intent
  */
 export const SolConsolidateIntent = AccountBaseConsolidateIntent;

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

@@ -3,6 +3,8 @@ import { SolBuildOptions } from "./solBuildOptions";
 import { EnableTokenIntent } from "./enableTokenIntent";
 
 /**
+ * Initialize one or more Associated Token Accounts (ATAs) on Solana so the wallet can receive SPL tokens. All entries in enableTokens must target the same wallet address. Spending policy is not evaluated for this intent.
+ *
  * @title SOL Create Associated Token Account Intent
  */
 export const SolCreateAssociatedTokenAccountIntent = t.intersection([

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

@@ -4,23 +4,33 @@ import { BaseIntent } from "./baseIntent";
 import { intentTypes } from "./intentType";
 
 /**
+ * Submit a custom Solana transaction using raw legacy program instructions. Use this intent for legacy (non-versioned) transactions; for versioned transactions (address lookup tables, v0 messages) use the customTx intent with solVersionedTransactionData instead. Wallets without the enableSolCustomTx flag require a second admin approval before the transaction is processed.
+ *
  * @title SOL Custom Transaction Intent
  */
 export const SolCustomTxIntent = t.intersection([
   BaseIntent,
   SolBuildOptions,
   t.type({
+    /** Must be "customTx". For legacy (non-versioned) transactions only; use SolVersionedCustomTxIntent for versioned transactions. */
     intentType: intentTypes.customTx,
+    /** Array of raw Solana program instructions to include in the transaction. Use for legacy (non-versioned) transactions only. */
     solInstructions: t.array(
       t.type({
+        /** The program ID to invoke. */
         programId: t.string,
+        /** Account keys referenced by this instruction. */
         keys: t.array(
           t.type({
+            /** The account public key. */
             pubkey: t.string,
+            /** Whether this account is a signer. */
             isSigner: t.boolean,
+            /** Whether this account is writable. */
             isWritable: t.boolean,
           }),
         ),
+        /** Instruction data encoded as base58 or hex. */
         data: t.string,
       }),
     ),

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

@@ -5,14 +5,21 @@ import { intentTypes } from "./intentType";
 import { optionalString, optionalStringArray } from "../../../utils";
 
 /**
+ * Deactivate one or more SOL stake accounts on Solana to begin the cooldown period before funds can be claimed. No value is transferred. Provide either stakingAddress (single account) or stakingAddresses (batch). After cooldown completes, use the claim intent to withdraw. Spending policy is not evaluated for this intent. Requires the solStakingAuthorize enterprise feature flag.
+ *
  * @title SOL Deactivate Intent
  */
 export const SolDeactivateIntent = t.intersection([
   BaseIntent,
   SolBuildOptions,
   t.type({
+    /** Must be "deactivate". */
     intentType: intentTypes.deactivate,
+  }),
+  t.partial({
+    /** Batch of stake account addresses to deactivate. Provide either this or stakingAddress. */
     stakingAddresses: optionalStringArray,
+    /** A single stake account address to deactivate. Provide either this or stakingAddresses. */
     stakingAddress: optionalString,
   }),
 ]);

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

@@ -5,15 +5,23 @@ import { intentTypes } from "./intentType";
 import { optionalString, optionalStringArray } from "../../../utils";
 
 /**
+ * Delegate one or more deactivated SOL stake accounts to a validator on Solana. No value is transferred; this intent re-activates an existing stake account under a new or the same validator. Provide either stakingAddress (single account) or stakingAddresses (batch). Spending policy is not evaluated for this intent. Requires the solStakingAuthorize enterprise feature flag.
+ *
  * @title SOL Delegate Intent
  */
 export const SolDelegateIntent = t.intersection([
   BaseIntent,
   SolBuildOptions,
   t.type({
+    /** Must be "delegate". */
     intentType: intentTypes.delegate,
+    /** The validator vote account address to delegate to. */
     validatorAddress: t.string,
+  }),
+  t.partial({
+    /** Batch of stake account addresses to delegate. Provide either this or stakingAddress. */
     stakingAddresses: optionalStringArray,
+    /** A single stake account address to delegate. Provide either this or stakingAddresses. */
     stakingAddress: optionalString,
   }),
 ]);

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

@@ -1,16 +1,20 @@
 import * as t from "io-ts";
 import { SolBuildOptions } from "./solBuildOptions";
 import { GoUnstakeIntent } from "./goUnstakeIntent";
+import { optionalString } from "../../../utils";
 
 /**
- * @title SolGoUnstakeIntent
- *
- * @description Unstake intent for GO wallets for the Solana blockchain.
+ * Unstake SOL via the GO wallet program on Solana and transfer the proceeds to the specified recipients. This intent uses the same transfer path as the payment intent.
  *
+ * @title SOL Go Unstake Intent
  */
 export const SolGoUnstakeIntent = t.intersection([
   GoUnstakeIntent,
   SolBuildOptions,
+  t.partial({
+    /** Internal coordination identifier for the GO staking request. Accepted by the schema but only processed on admin/internal routes — external API consumers should omit this field. */
+    goStakingRequestId: optionalString,
+  }),
 ]);
 
 export type SolGoUnstakeIntent = t.TypeOf<typeof SolGoUnstakeIntent>;

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

@@ -2,6 +2,11 @@ import * as t from "io-ts";
 import { PaymentIntent } from "./paymentIntent";
 import { SolBuildOptions } from "./solBuildOptions";
 
+/**
+ * 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.
+ *
+ * @title SOL Payment Intent
+ */
 export const SolPaymentIntent = t.intersection([
   PaymentIntent,
   SolBuildOptions,

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

@@ -6,6 +6,8 @@ import { Optional } from "../../../utils";
 import { SolStakingType } from "./solStakingType";
 
 /**
+ * Stake SOL to a validator on Solana by creating a new stake account. The platform generates an ephemeral keypair for the stake account and whitelists it on the wallet. Requires the enterprise to have staking permissions. Supports native, Marinade liquid, and Jito staking via the stakingType field.
+ *
  * @title SOL Stake Intent
  */
 export const SolStakeIntent = t.intersection([
@@ -13,14 +15,13 @@ export const SolStakeIntent = t.intersection([
   SolBuildOptions,
   BaseIntentWithAmount,
   t.type({
+    /** The validator vote account address to stake SOL with. */
     validatorAddress: t.string,
     /**
      * @deprecated Use `stakingType` instead.
      */
     isMarinade: Optional(t.boolean),
-    /**
-     * @todo Remove Optional once staking-service is updated.
-     */
+    /** The staking provider type. Accepted values: "NATIVE", "MARINADE", "JITO". Supersedes the deprecated isMarinade field. */
     stakingType: Optional(SolStakingType),
   }),
 ]);

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

@@ -7,25 +7,29 @@ import { RecipientEntry } from "./recipientEntry";
 import { SolStakingType } from "./solStakingType";
 
 /**
+ * Begin deactivating a SOL stake account on Solana. For native staking, the stake account enters a cooldown period before funds can be claimed. For partial unstakes, provide both amount and remainingStakingAmount to split the stake account. Supports native, Marinade liquid, and Jito staking via the stakingType field. Requires the enterprise to have staking permissions.
+ *
  * @title SOL Unstake Intent
  */
 export const SolUnstakeIntent = t.intersection([
   UnstakeIntent,
   SolBuildOptions,
   t.type({
+    /** The stake account address to deactivate. */
     stakingAddress: t.string,
   }),
   t.partial({
+    /** For partial unstake: the amount to remove from the stake account. Must be provided together with remainingStakingAmount. */
     amount: Optional(Amount),
+    /** For partial unstake: the amount to keep in the existing stake account after the split. Must be provided together with amount. */
     remainingStakingAmount: Optional(Amount),
     /**
      * @deprecated Use `stakingType` instead.
      */
     isMarinade: Optional(t.boolean),
-    /**
-     * @todo Remove Optional once staking-service is updated.
-     */
+    /** The staking provider type. Accepted values: "NATIVE", "MARINADE", "JITO". Supersedes the deprecated isMarinade field. */
     stakingType: Optional(SolStakingType),
+    /** Required for Marinade unstaking: the recipient address to receive the unstaked SOL. */
     recipients: Optional(t.array(RecipientEntry)),
   }),
 ]);