@mysten/sui 2.30.0 → 2.31.0

package/src/graphql/generated/schema.graphql

@@ -94,14 +94,15 @@ type Address implements Node & IAddressable {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	Returns `None` when no checkpoint is set in scope (e.g. execution scope).
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -131,10 +132,9 @@ type Address implements Node & IAddressable {
 	"""
 	id: ID!
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	Returns `None` when no checkpoint is set in scope (e.g. execution scope).
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -279,15 +279,17 @@ type AvailableRange {
 }
 
 """
-The total balance for a particular coin type.
+The balance of a particular coin type held by an address.
+
+Balances can be held in coin objects, in the address's balance accumulator, or both.
 """
 type Balance {
 	"""
-	The balance as tracked by the accumulator object for the address.
+	The balance held in the address's balance accumulator.
 	"""
 	addressBalance: BigInt
 	"""
-	Total balance across all owned coin objects of the coin type.
+	The balance held in coin objects owned by the address.
 	"""
 	coinBalance: BigInt
 	"""
@@ -295,7 +297,7 @@ type Balance {
 	"""
 	coinType: MoveType
 	"""
-	The sum total of the accumulator balance and individual coin balances owned by the address.
+	The sum of `coinBalance` and `addressBalance`.
 	"""
 	totalBalance: BigInt
 }
@@ -376,10 +378,32 @@ type BalanceEdge {
 	node: Balance!
 }
 
+"""
+Identifies the balance for one coin type owned by an address.
+"""
+input BalanceKey {
+	"""
+	The address that owns the balance.
+	"""
+	address: SuiAddress!
+	"""
+	The coin type of the balance.
+	"""
+	coinType: String!
+}
+
 """
 Input for withdrawing funds from an accumulator.
 """
 type BalanceWithdraw {
+	"""
+	The allowance authorizing the withdrawal, if `withdrawFrom` is `SENDER_ALLOWANCE`. Use `asTransactionObject` to see it as this transaction referenced it.
+	"""
+	allowance: Address
+	"""
+	The account whose funds are withdrawn, if `withdrawFrom` is `SENDER_ALLOWANCE`.
+	"""
+	funder: Address
 	"""
 	How much to withdraw from the accumulator.
 	"""
@@ -637,13 +661,15 @@ type CoinMetadata implements IAddressable & IMoveObject & IObject {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -703,9 +729,9 @@ type CoinMetadata implements IAddressable & IMoveObject & IObject {
 	"""
 	moveObjectBcs: Base64
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -1016,13 +1042,15 @@ type DynamicField implements Node & IAddressable & IMoveObject & IObject {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -1070,9 +1098,9 @@ type DynamicField implements Node & IAddressable & IMoveObject & IObject {
 	"""
 	moveObjectBcs: Base64
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -1691,13 +1719,15 @@ interface IAddressable {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -1705,9 +1735,9 @@ interface IAddressable {
 	"""
 	defaultNameRecord: NameRecord
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	Returns `null` when no checkpoint is set in scope (e.g. execution scope). If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -2335,13 +2365,15 @@ type MoveObject implements Node & IAddressable & IMoveObject & IObject {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -2389,9 +2421,9 @@ type MoveObject implements Node & IAddressable & IMoveObject & IObject {
 	"""
 	moveObjectBcs: Base64
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -2504,13 +2536,15 @@ type MovePackage implements Node & IAddressable & IObject {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -2542,9 +2576,9 @@ type MovePackage implements Node & IAddressable & IObject {
 	"""
 	modules(first: Int, after: String, last: Int, before: String): MoveModuleConnection
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -3035,13 +3069,15 @@ type Object implements Node & IAddressable & IObject {
 	"""
 	asTransactionObject(transactionDigest: String): TransactionObject
 	"""
-	Fetch the total balance for coins with marker type `coinType` (e.g. `0x2::sui::SUI`), owned by this address.
+	Fetch the balance for `coinType` (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	If the address does not own any coins of that type, a balance of zero is returned.
+	The result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. If this address has no balance of that type, all three values are zero.
 	"""
 	balance(coinType: String!): Balance
 	"""
-	Total balance across coins owned by this address, grouped by coin type.
+	Balances held by this address, grouped by coin type.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator.
 	"""
 	balances(first: Int, after: String, last: Int, before: String): BalanceConnection
 	"""
@@ -3073,10 +3109,9 @@ type Object implements Node & IAddressable & IObject {
 	"""
 	id: ID!
 	"""
-	Fetch the total balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
+	Fetch balances keyed by coin types (e.g. `0x2::sui::SUI`) owned by this address.
 	
-	Returns `None` when no checkpoint is set in scope (e.g. execution scope).
-	If the address does not own any coins of a given type, a balance of zero is returned for that type.
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns `null` when no checkpoint is set in scope (e.g. execution scope). If this address has no balance of a given type, all three values are zero for that type.
 	"""
 	multiGetBalances(keys: [String!]!): [Balance!]
 	"""
@@ -3618,6 +3653,12 @@ type Query {
 	"""
 	multiGetAddresses(keys: [AddressKey!]!): [Address]!
 	"""
+	Fetch balances by their addresses and coin types.
+	
+	Each result includes the total balance, the balance held in coin objects, and the balance held in the address's balance accumulator. Returns a list that is guaranteed to be the same length as `keys`. If an address has no balance of a given type, all three values are zero for that key.
+	"""
+	multiGetBalances(keys: [BalanceKey!]!): [Balance!]!
+	"""
 	Fetch checkpoints by their sequence numbers.
 	
 	Returns a list of checkpoints that is guaranteed to be the same length as `keys`. If a checkpoint in `keys` could not be found in the store, its corresponding entry in the result will be `null`. This could be because the checkpoint does not exist yet, or because it was pruned.
@@ -4638,6 +4679,10 @@ enum WithdrawFrom {
 	The funds are withdrawn from the sponsor's account.
 	"""
 	SPONSOR
+	"""
+	The funds are withdrawn from the account of an allowance's funder, under an allowance granted to the transaction sender. See `BalanceWithdraw.funder` and `BalanceWithdraw.allowance`.
+	"""
+	SENDER_ALLOWANCE
 }
 
 type WithdrawMaxAmountU64 {

package/src/graphql/generated/tada-env.ts

@@ -1100,10 +1100,55 @@ const introspection = {
         ],
         "interfaces": []
       },
+      {
+        "kind": "INPUT_OBJECT",
+        "name": "BalanceKey",
+        "inputFields": [
+          {
+            "name": "address",
+            "type": {
+              "kind": "NON_NULL",
+              "ofType": {
+                "kind": "SCALAR",
+                "name": "SuiAddress"
+              }
+            }
+          },
+          {
+            "name": "coinType",
+            "type": {
+              "kind": "NON_NULL",
+              "ofType": {
+                "kind": "SCALAR",
+                "name": "String"
+              }
+            }
+          }
+        ],
+        "isOneOf": false
+      },
       {
         "kind": "OBJECT",
         "name": "BalanceWithdraw",
         "fields": [
+          {
+            "name": "allowance",
+            "type": {
+              "kind": "OBJECT",
+              "name": "Address"
+            },
+            "args": [],
+            "isDeprecated": false
+          },
+          {
+            "name": "funder",
+            "type": {
+              "kind": "OBJECT",
+              "name": "Address"
+            },
+            "args": [],
+            "isDeprecated": false
+          },
           {
             "name": "reservation",
             "type": {
@@ -10922,6 +10967,41 @@ const introspection = {
             ],
             "isDeprecated": false
           },
+          {
+            "name": "multiGetBalances",
+            "type": {
+              "kind": "NON_NULL",
+              "ofType": {
+                "kind": "LIST",
+                "ofType": {
+                  "kind": "NON_NULL",
+                  "ofType": {
+                    "kind": "OBJECT",
+                    "name": "Balance"
+                  }
+                }
+              }
+            },
+            "args": [
+              {
+                "name": "keys",
+                "type": {
+                  "kind": "NON_NULL",
+                  "ofType": {
+                    "kind": "LIST",
+                    "ofType": {
+                      "kind": "NON_NULL",
+                      "ofType": {
+                        "kind": "INPUT_OBJECT",
+                        "name": "BalanceKey"
+                      }
+                    }
+                  }
+                }
+              }
+            ],
+            "isDeprecated": false
+          },
           {
             "name": "multiGetCheckpoints",
             "type": {
@@ -13773,6 +13853,10 @@ const introspection = {
           {
             "name": "SPONSOR",
             "isDeprecated": false
+          },
+          {
+            "name": "SENDER_ALLOWANCE",
+            "isDeprecated": false
           }
         ]
       },

package/src/grpc/proto/sui/rpc/v2/input.ts

@@ -161,6 +161,19 @@ export interface FundsWithdrawal {
 	 * @generated from protobuf field: optional sui.rpc.v2.FundsWithdrawal.Source source = 3;
 	 */
 	source?: FundsWithdrawal_Source;
+	/**
+	 * The address whose balance is debited if `source` is `SENDER_ALLOWANCE`.
+	 *
+	 * @generated from protobuf field: optional string funder = 4;
+	 */
+	funder?: string;
+	/**
+	 * `ObjectId` of the allowance object authorizing the withdrawal if `source`
+	 * is `SENDER_ALLOWANCE`.
+	 *
+	 * @generated from protobuf field: optional string allowance = 5;
+	 */
+	allowance?: string;
 }
 /**
  * @generated from protobuf enum sui.rpc.v2.FundsWithdrawal.Source
@@ -178,6 +191,13 @@ export enum FundsWithdrawal_Source {
 	 * @generated from protobuf enum value: SPONSOR = 2;
 	 */
 	SPONSOR = 2,
+	/**
+	 * Withdraw from `funder`'s balance under the `allowance` object, granted
+	 * to the sender of the transaction.
+	 *
+	 * @generated from protobuf enum value: SENDER_ALLOWANCE = 3;
+	 */
+	SENDER_ALLOWANCE = 3,
 }
 // @generated message type with reflection information, may provide speed optimized methods
 class Input$Type extends MessageType<Input> {
@@ -238,6 +258,8 @@ class FundsWithdrawal$Type extends MessageType<FundsWithdrawal> {
 				opt: true,
 				T: () => ['sui.rpc.v2.FundsWithdrawal.Source', FundsWithdrawal_Source],
 			},
+			{ no: 4, name: 'funder', kind: 'scalar', opt: true, T: 9 /*ScalarType.STRING*/ },
+			{ no: 5, name: 'allowance', kind: 'scalar', opt: true, T: 9 /*ScalarType.STRING*/ },
 		]);
 	}
 }

package/src/jsonRpc/core.ts

@@ -1187,10 +1187,9 @@ function parseTransaction<Include extends SuiClientTypes.TransactionInclude = {}
 
 	if (transaction.rawTransaction) {
 		const parsedTx = bcs.SenderSignedData.parse(fromBase64(transaction.rawTransaction))[0];
-		// The genesis transaction's raw data carries a placeholder signature that
-		// other transports do not report
-		signatures =
-			parsedTx.intentMessage.value.V1.kind.$kind === 'Genesis' ? [] : parsedTx.txSignatures;
+		// System transactions, including genesis, carry a placeholder signature that gRPC and
+		// GraphQL report as-is.
+		signatures = parsedTx.txSignatures;
 
 		if (include?.transaction || include?.bcs) {
 			const bytes = bcs.TransactionData.serialize(parsedTx.intentMessage.value).toBytes();

package/src/transactions/Transaction.ts

@@ -31,12 +31,20 @@ import { createPure } from './pure.js';
 import { TransactionDataBuilder } from './TransactionData.js';
 import { getIdFromCallArg } from './utils.js';
 import { namedPackagesPlugin } from './plugins/NamedPackagesPlugin.js';
-import {
-	COIN_WITH_BALANCE,
-	resolveCoinBalance,
-	coinWithBalance,
-	createBalance,
-} from './intents/CoinWithBalance.js';
+import { ALLOWANCE_BALANCE, allowanceBalance } from './intents/AllowanceBalance.js';
+import { resolveBalances } from './intents/ResolveBalances.js';
+import type { BalanceOptions } from './intents/BalanceOptions.js';
+import { normalizeBalance } from './intents/BalanceOptions.js';
+import { COIN_WITH_BALANCE, coinWithBalance, createBalance } from './intents/CoinWithBalance.js';
+
+export type WithdrawalOptions = {
+	amount: number | bigint | string;
+	type?: string | null;
+} & (
+	| { from?: 'sender'; allowance?: never; funder?: never }
+	| { from: 'sponsor'; allowance?: never; funder?: never }
+	| { from: 'allowance'; allowance: string; funder: string }
+);
 
 export type TransactionObjectArgument =
 	| Exclude<InferInput<typeof ArgumentSchema>, { Input: unknown; type?: 'pure' }>
@@ -214,7 +222,8 @@ export class Transaction {
 		// Built-in intents are resolvable by default. Caller-supplied resolvers cover custom intents,
 		// and take precedence so a built-in resolver can be overridden if needed.
 		const intentResolvers = new Map<string, TransactionPlugin>([
-			[COIN_WITH_BALANCE, resolveCoinBalance],
+			[COIN_WITH_BALANCE, resolveBalances],
+			[ALLOWANCE_BALANCE, resolveBalances],
 			...Object.entries(options.intentResolvers ?? {}),
 		]);
 
@@ -342,35 +351,33 @@ export class Transaction {
 	}
 
 	/**
-	 * Creates a coin of the specified type and balance.
+	 * Creates a Coin<T> of the specified type and amount (defaults to SUI).
 	 * Sourced from address balance when available, falling back to owned coins.
+	 * With `allowance`, spends only from the funder's address balance under that allowance.
+	 * Allowance IDs are resolved using the build client; app-bound allowances also require an app type and SpendPermit.
 	 */
-	coin({
-		type,
-		balance,
-		useGasCoin,
-	}: {
-		balance: bigint | number;
-		type?: string;
-		useGasCoin?: boolean;
-	}): TransactionResult {
-		return this.add(coinWithBalance({ type, balance, useGasCoin }));
+	coin(options: BalanceOptions): TransactionResult {
+		const amount = normalizeBalance(options);
+		return this.add(
+			options.allowance !== undefined
+				? allowanceBalance({ ...options, amount, outputKind: 'coin' })
+				: coinWithBalance({ ...options, balance: amount }),
+		);
 	}
 
 	/**
-	 * Creates a Balance object of the specified type and balance.
+	 * Creates a Balance<T> of the specified type and amount (defaults to SUI).
 	 * Sourced from address balance when available, falling back to owned coins.
+	 * With `allowance`, spends only from the funder's address balance under that allowance.
+	 * Allowance IDs are resolved using the build client; app-bound allowances also require an app type and SpendPermit.
 	 */
-	balance({
-		type,
-		balance,
-		useGasCoin,
-	}: {
-		balance: bigint | number;
-		type?: string;
-		useGasCoin?: boolean;
-	}): TransactionResult {
-		return this.add(createBalance({ type, balance, useGasCoin }));
+	balance(options: BalanceOptions): TransactionResult {
+		const amount = normalizeBalance(options);
+		return this.add(
+			options.allowance !== undefined
+				? allowanceBalance({ ...options, amount, outputKind: 'balance' })
+				: createBalance({ ...options, balance: amount }),
+		);
 	}
 
 	/**
@@ -677,13 +684,15 @@ export class Transaction {
 	}
 
 	/**
-	 * Create a FundsWithdrawal input for withdrawing Balance<T> from an address balance accumulator.
-	 * This is used for gas payments from address balances.
+	 * Creates a FundsWithdrawal input for withdrawing Balance<T> from an address balance.
 	 *
-	 * @param options.amount - The Amount to withdraw (u64).
-	 * @param options.type - The balance type (e.g., "0x2::sui::SUI"). Defaults to SUI.
+	 * @param options.amount - The amount to withdraw (u64).
+	 * @param options.type - The coin type T (e.g., "0x2::sui::SUI"), not Balance<T>. Defaults to SUI.
+	 * @param options.from - The withdrawal source. Defaults to the transaction sender.
+	 * @param options.allowance - The allowance ID, required when from is 'allowance'.
+	 * @param options.funder - The funder's address, required when from is 'allowance'.
 	 */
-	withdrawal({ amount, type }: { amount: number | bigint | string; type?: string | null }): {
+	withdrawal(options: WithdrawalOptions): {
 		$kind: 'Input';
 		Input: number;
 		type?: 'object';
@@ -692,13 +701,20 @@ export class Transaction {
 			$kind: 'FundsWithdrawal',
 			FundsWithdrawal: {
 				// TODO: support entire balance withdrawals once supported
-				reservation: { $kind: 'MaxAmountU64', MaxAmountU64: String(amount) },
-				typeArg: { $kind: 'Balance', Balance: type ?? '0x2::sui::SUI' },
+				reservation: { $kind: 'MaxAmountU64', MaxAmountU64: String(options.amount) },
+				typeArg: { $kind: 'Balance', Balance: options.type ?? '0x2::sui::SUI' },
 				withdrawFrom:
-					// fromSponsor === true
-					// 	? { $kind: 'Sponsor', Sponsor: true } :
-					// TODO: currently only supporting withdrawals from sender
-					{ $kind: 'Sender', Sender: true },
+					options.from === 'allowance'
+						? {
+								$kind: 'SenderAllowance',
+								SenderAllowance: {
+									funder: normalizeSuiAddress(options.funder),
+									allowance: normalizeSuiAddress(options.allowance),
+								},
+							}
+						: options.from === 'sponsor'
+							? { $kind: 'Sponsor', Sponsor: true }
+							: { $kind: 'Sender', Sender: true },
 			},
 		};
 
@@ -964,16 +980,21 @@ export class Transaction {
 
 		const steps = [...this.#serializationPlugins];
 
+		// A resolver may handle several intent names; run it once with its assigned intents.
+		const resolverIntents = new Map<TransactionPlugin, string[]>();
 		for (const intent of intents) {
-			if (options.supportedIntents?.includes(intent)) {
-				continue;
-			}
-
-			if (!this.#intentResolvers.has(intent)) {
-				throw new Error(`Missing intent resolver for ${intent}`);
-			}
-
-			steps.push(this.#intentResolvers.get(intent)!);
+			if (options.supportedIntents?.includes(intent)) continue;
+			const resolver = this.#intentResolvers.get(intent);
+			if (!resolver) throw new Error(`Missing intent resolver for ${intent}`);
+			const names = resolverIntents.get(resolver) ?? [];
+			names.push(intent);
+			resolverIntents.set(resolver, names);
+		}
+		for (const [resolver, intentNames] of resolverIntents) {
+			steps.push((data, buildOptions, next) => {
+				const resolverOptions = { ...buildOptions, intentNames };
+				return resolver(data, resolverOptions, next);
+			});
 		}
 
 		steps.push(namedPackagesPlugin());

package/src/transactions/data/internal.ts

@@ -294,6 +294,10 @@ export type WithdrawalTypeArg = InferOutput<typeof WithdrawalTypeArgSchema>;
 export const WithdrawFromSchema = safeEnum({
 	Sender: literal(true),
 	Sponsor: literal(true),
+	SenderAllowance: object({
+		funder: SuiAddress,
+		allowance: ObjectID,
+	}),
 });
 export type WithdrawFrom = InferOutput<typeof WithdrawFromSchema>;