@msafe/sui3-sdk 1.0.22 → 1.0.24

package/dist/index.d.cts

@@ -334,6 +334,8 @@ declare class InvitationSDK {
     updateMSafeStatus(msafeAddress: string, status: UserMSafeStatus): Promise<void>;
 }
 
+/** Protocol cap: a transaction may smash at most this many gas payment objects. */
+declare const MAX_GAS_PAYMENT_OBJECTS = 256;
 type GasFundingMode = 'classic' | 'addressBalance' | 'mixedTopUp';
 interface GasFundingResult {
     mode: GasFundingMode;
@@ -352,6 +354,19 @@ declare class InsufficientGasFundsError extends Error {
  * storageRebate is refunded after execution and must not reduce the budget.
  */
 declare function computeGasBudget(gasUsed: Pick<SuiClientTypes.GasCostSummary, 'computationCost' | 'storageCost'>, gasPrice: bigint): bigint;
+type PaymentCoinRef = {
+    objectId: string;
+    version: string;
+    digest: string;
+    balance: bigint;
+};
+/**
+ * Pick the fewest large SUI coins that cover `cover`, capped at 256.
+ * Never attach every owned coin — accounts with hundreds of SUI objects
+ * exceed max_gas_payment_objects and trip gasless estimate
+ * ("gas_budget must be 0 for gasless transactions").
+ */
+declare function pickGasPaymentCoins(coins: PaymentCoinRef[], cover: bigint): PaymentCoinRef[];
 /** Object IDs a built payload already pins (inputs + gas payment). */
 declare function collectPayloadObjectIds(payload: string | Uint8Array): string[];
 /**
@@ -643,4 +658,4 @@ declare function getIntentionContent(intention: unknown): unknown;
  */
 declare function transactionFromContent(content: unknown): Transaction;
 
-export { AddressBookSDK, COIN_RESERVATION_MAGIC, COIN_TYPE_ARG_REGEX, Coin, CoinHelper, CreateHelper, type CreateMSafeInfo, DEV_API_URL, DEV_SYNCING_URL, ENV_CONFIGS, Formatter, type FutureIntention, type GasFundingMode, type GasFundingResult, type GasObjectReference, HexToUint8Array, type HistorySendTx, type HistoryVote, type IWallet, InfoTypeEnabledDto, InfoTypeKey, InsufficientGasFundsError, LOCAL_API_URL, LOCAL_SYNCING_URL, MAINNET_RPC_URL, MSafeAccount, MSafeClient, type MSafeConfig, type MSafeConfigOptions, MSafeEnabledDto, MSafeEnv, MSafeGlobals, type NotificationData, type NotificationInfo, NotificationSubscribeDto, NotificationUpdateDto, PREV_API_URL, PROD_API_URL, type Pagination, type PendingTx, type PendingVote, type ProposeIntention, type ReceiveTransaction, SUI_COIN, SignatureVerifier, type SimulateDryRunResponse, type SimulationFailedResult, type SimulationOption, type SimulationResult, type SimulationSuccessResult, TESTNET_RPC_URL, Uint8ArrayToHex, addPrefix, collectPayloadObjectIds, collectQueueExcludeObjectIds, computeGasBudget, createCoinReservationRef, estimateGasBudget, getAllCoins, getIntentionContent, getMSafeConfig, getPublicKeyFromChain, httpUrlToGrpcBaseUrl, isCoinReservationDigest, msafeChainToSuiNetwork, parkedPayloadHex, preferClassicGasPayment, prepareGasFunding, selectGasFunding, stringToBuffer, toSuiTransaction, transactionFromContent };
+export { AddressBookSDK, COIN_RESERVATION_MAGIC, COIN_TYPE_ARG_REGEX, Coin, CoinHelper, CreateHelper, type CreateMSafeInfo, DEV_API_URL, DEV_SYNCING_URL, ENV_CONFIGS, Formatter, type FutureIntention, type GasFundingMode, type GasFundingResult, type GasObjectReference, HexToUint8Array, type HistorySendTx, type HistoryVote, type IWallet, InfoTypeEnabledDto, InfoTypeKey, InsufficientGasFundsError, LOCAL_API_URL, LOCAL_SYNCING_URL, MAINNET_RPC_URL, MAX_GAS_PAYMENT_OBJECTS, MSafeAccount, MSafeClient, type MSafeConfig, type MSafeConfigOptions, MSafeEnabledDto, MSafeEnv, MSafeGlobals, type NotificationData, type NotificationInfo, NotificationSubscribeDto, NotificationUpdateDto, PREV_API_URL, PROD_API_URL, type Pagination, type PaymentCoinRef, type PendingTx, type PendingVote, type ProposeIntention, type ReceiveTransaction, SUI_COIN, SignatureVerifier, type SimulateDryRunResponse, type SimulationFailedResult, type SimulationOption, type SimulationResult, type SimulationSuccessResult, TESTNET_RPC_URL, Uint8ArrayToHex, addPrefix, collectPayloadObjectIds, collectQueueExcludeObjectIds, computeGasBudget, createCoinReservationRef, estimateGasBudget, getAllCoins, getIntentionContent, getMSafeConfig, getPublicKeyFromChain, httpUrlToGrpcBaseUrl, isCoinReservationDigest, msafeChainToSuiNetwork, parkedPayloadHex, pickGasPaymentCoins, preferClassicGasPayment, prepareGasFunding, selectGasFunding, stringToBuffer, toSuiTransaction, transactionFromContent };

package/dist/index.d.ts

@@ -334,6 +334,8 @@ declare class InvitationSDK {
     updateMSafeStatus(msafeAddress: string, status: UserMSafeStatus): Promise<void>;
 }
 
+/** Protocol cap: a transaction may smash at most this many gas payment objects. */
+declare const MAX_GAS_PAYMENT_OBJECTS = 256;
 type GasFundingMode = 'classic' | 'addressBalance' | 'mixedTopUp';
 interface GasFundingResult {
     mode: GasFundingMode;
@@ -352,6 +354,19 @@ declare class InsufficientGasFundsError extends Error {
  * storageRebate is refunded after execution and must not reduce the budget.
  */
 declare function computeGasBudget(gasUsed: Pick<SuiClientTypes.GasCostSummary, 'computationCost' | 'storageCost'>, gasPrice: bigint): bigint;
+type PaymentCoinRef = {
+    objectId: string;
+    version: string;
+    digest: string;
+    balance: bigint;
+};
+/**
+ * Pick the fewest large SUI coins that cover `cover`, capped at 256.
+ * Never attach every owned coin — accounts with hundreds of SUI objects
+ * exceed max_gas_payment_objects and trip gasless estimate
+ * ("gas_budget must be 0 for gasless transactions").
+ */
+declare function pickGasPaymentCoins(coins: PaymentCoinRef[], cover: bigint): PaymentCoinRef[];
 /** Object IDs a built payload already pins (inputs + gas payment). */
 declare function collectPayloadObjectIds(payload: string | Uint8Array): string[];
 /**
@@ -643,4 +658,4 @@ declare function getIntentionContent(intention: unknown): unknown;
  */
 declare function transactionFromContent(content: unknown): Transaction;
 
-export { AddressBookSDK, COIN_RESERVATION_MAGIC, COIN_TYPE_ARG_REGEX, Coin, CoinHelper, CreateHelper, type CreateMSafeInfo, DEV_API_URL, DEV_SYNCING_URL, ENV_CONFIGS, Formatter, type FutureIntention, type GasFundingMode, type GasFundingResult, type GasObjectReference, HexToUint8Array, type HistorySendTx, type HistoryVote, type IWallet, InfoTypeEnabledDto, InfoTypeKey, InsufficientGasFundsError, LOCAL_API_URL, LOCAL_SYNCING_URL, MAINNET_RPC_URL, MSafeAccount, MSafeClient, type MSafeConfig, type MSafeConfigOptions, MSafeEnabledDto, MSafeEnv, MSafeGlobals, type NotificationData, type NotificationInfo, NotificationSubscribeDto, NotificationUpdateDto, PREV_API_URL, PROD_API_URL, type Pagination, type PendingTx, type PendingVote, type ProposeIntention, type ReceiveTransaction, SUI_COIN, SignatureVerifier, type SimulateDryRunResponse, type SimulationFailedResult, type SimulationOption, type SimulationResult, type SimulationSuccessResult, TESTNET_RPC_URL, Uint8ArrayToHex, addPrefix, collectPayloadObjectIds, collectQueueExcludeObjectIds, computeGasBudget, createCoinReservationRef, estimateGasBudget, getAllCoins, getIntentionContent, getMSafeConfig, getPublicKeyFromChain, httpUrlToGrpcBaseUrl, isCoinReservationDigest, msafeChainToSuiNetwork, parkedPayloadHex, preferClassicGasPayment, prepareGasFunding, selectGasFunding, stringToBuffer, toSuiTransaction, transactionFromContent };
+export { AddressBookSDK, COIN_RESERVATION_MAGIC, COIN_TYPE_ARG_REGEX, Coin, CoinHelper, CreateHelper, type CreateMSafeInfo, DEV_API_URL, DEV_SYNCING_URL, ENV_CONFIGS, Formatter, type FutureIntention, type GasFundingMode, type GasFundingResult, type GasObjectReference, HexToUint8Array, type HistorySendTx, type HistoryVote, type IWallet, InfoTypeEnabledDto, InfoTypeKey, InsufficientGasFundsError, LOCAL_API_URL, LOCAL_SYNCING_URL, MAINNET_RPC_URL, MAX_GAS_PAYMENT_OBJECTS, MSafeAccount, MSafeClient, type MSafeConfig, type MSafeConfigOptions, MSafeEnabledDto, MSafeEnv, MSafeGlobals, type NotificationData, type NotificationInfo, NotificationSubscribeDto, NotificationUpdateDto, PREV_API_URL, PROD_API_URL, type Pagination, type PaymentCoinRef, type PendingTx, type PendingVote, type ProposeIntention, type ReceiveTransaction, SUI_COIN, SignatureVerifier, type SimulateDryRunResponse, type SimulationFailedResult, type SimulationOption, type SimulationResult, type SimulationSuccessResult, TESTNET_RPC_URL, Uint8ArrayToHex, addPrefix, collectPayloadObjectIds, collectQueueExcludeObjectIds, computeGasBudget, createCoinReservationRef, estimateGasBudget, getAllCoins, getIntentionContent, getMSafeConfig, getPublicKeyFromChain, httpUrlToGrpcBaseUrl, isCoinReservationDigest, msafeChainToSuiNetwork, parkedPayloadHex, pickGasPaymentCoins, preferClassicGasPayment, prepareGasFunding, selectGasFunding, stringToBuffer, toSuiTransaction, transactionFromContent };

package/dist/index.js

@@ -416,6 +416,8 @@ async function getAllCoins(input) {
 
 // src/utils/gasFunding.ts
 var GAS_SAFE_OVERHEAD = 1000n;
+var MAX_GAS_PAYMENT_OBJECTS = 256;
+var ESTIMATE_GAS_COVER = 1000000000n;
 var InsufficientGasFundsError = class extends Error {
   gasBudget;
   coinBalance;
@@ -436,6 +438,25 @@ function computeGasBudget(gasUsed, gasPrice) {
   const safeOverhead = GAS_SAFE_OVERHEAD * gasPrice;
   return BigInt(computationCost) + BigInt(storageCost) + safeOverhead;
 }
+function pickGasPaymentCoins(coins, cover) {
+  if (cover <= 0n) {
+    return [];
+  }
+  const sorted = [...coins].filter((coin) => coin.balance > 0n).sort((a, b) => a.balance === b.balance ? 0 : a.balance < b.balance ? 1 : -1);
+  const selected = [];
+  let sum = 0n;
+  for (const coin of sorted) {
+    if (selected.length >= MAX_GAS_PAYMENT_OBJECTS) {
+      break;
+    }
+    selected.push(coin);
+    sum += coin.balance;
+    if (sum >= cover) {
+      break;
+    }
+  }
+  return selected;
+}
 function collectUsedObjectIds(tx) {
   const used = tx.getData().inputs.reduce((acc, input) => {
     const immOrOwned = input.Object?.ImmOrOwnedObject?.objectId;
@@ -580,7 +601,7 @@ async function selectGasFunding(input) {
     throw new InsufficientGasFundsError(gasBudget, coinBalance, addressBalance);
   }
   if (paymentCoins.length > 0 && coinBalance >= gasBudget) {
-    tx.setGasPayment(toObjectRefs(paymentCoins));
+    tx.setGasPayment(toObjectRefs(pickGasPaymentCoins(paymentCoins, gasBudget)));
     return { mode: "classic", gasBudget, coinBalance, addressBalance };
   }
   if (paymentCoins.length > 0 && total >= gasBudget) {
@@ -589,7 +610,7 @@ async function selectGasFunding(input) {
       tx,
       suiClient,
       owner,
-      paymentCoins,
+      paymentCoins: pickGasPaymentCoins(paymentCoins, 1n),
       topUpAmount
     });
     return { mode: "mixedTopUp", gasBudget, coinBalance, addressBalance };
@@ -635,7 +656,7 @@ async function estimateGasBudget(input) {
   probe.setSender(owner);
   probe.setGasPrice(gasPrice);
   if (funding.paymentCoins.length > 0) {
-    probe.setGasPayment(toObjectRefs(funding.paymentCoins));
+    probe.setGasPayment(toObjectRefs(pickGasPaymentCoins(funding.paymentCoins, ESTIMATE_GAS_COVER)));
   }
   let built;
   try {
@@ -710,7 +731,7 @@ async function preferClassicGasPayment(input) {
   if (funding.paymentCoins.length === 0) {
     return false;
   }
-  tx.setGasPayment(toObjectRefs(funding.paymentCoins));
+  tx.setGasPayment(toObjectRefs(pickGasPaymentCoins(funding.paymentCoins, ESTIMATE_GAS_COVER)));
   return true;
 }
 
@@ -720,7 +741,7 @@ function formatExecutionError(error) {
 }
 function gasObjectToReference(gas) {
   if (!gas?.objectId) {
-    throw new Error("Gas object missing from simulation effects");
+    return { objectId: "0x0", version: "0", digest: "" };
   }
   const version = gas.outputVersion ?? gas.inputVersion ?? "0";
   const digest = gas.outputDigest ?? gas.inputDigest ?? "";
@@ -2107,6 +2128,7 @@ export {
   LOCAL_API_URL,
   LOCAL_SYNCING_URL,
   MAINNET_RPC_URL,
+  MAX_GAS_PAYMENT_OBJECTS,
   MSafeAccount,
   MSafeClient,
   MSafeEnabledDto,
@@ -2134,6 +2156,7 @@ export {
   isCoinReservationDigest,
   msafeChainToSuiNetwork,
   parkedPayloadHex,
+  pickGasPaymentCoins,
   preferClassicGasPayment,
   prepareGasFunding,
   selectGasFunding,