@dynamic-labs-sdk/tempo 1.41.0 → 1.42.0

package/dist/waas/sendTempoTransaction/sendTempoTransaction.d.ts

@@ -22,6 +22,7 @@ type SendTempoTransactionResult = {
  * @param [client] - The Dynamic client instance. Only required when using multiple clients.
  * @returns The transaction hash.
  * @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+ * @throws {TempoTransactionValidationError} If `awaitingFeePayer` is set, because a transaction that awaits a fee payer cannot be broadcast.
  * @example
  * ```ts
  * const { transactionHash } = await sendTempoTransaction({
@@ -34,6 +35,7 @@ type SendTempoTransactionResult = {
  * });
  * ```
  * @see sendTip20Transaction
+ * @see signTempoTransaction
  * @see getTempoPublicClient
  * @notInstrumented
  */

package/dist/waas/sendTempoTransaction/sendTempoTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sendTempoTransaction.d.ts","sourceRoot":"","sources":["../../../src/waas/sendTempoTransaction/sendTempoTransaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQ9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAE3F,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CACzE,GAAG;IACF,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,oBAAoB,sCACI,0BAA0B,gEAE5D,OAAO,CAAC,0BAA0B,CAgCpC,CAAC"}
+{"version":3,"file":"sendTempoTransaction.d.ts","sourceRoot":"","sources":["../../../src/waas/sendTempoTransaction/sendTempoTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAO9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAG3F,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CACzE,GAAG;IACF,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,sCACI,0BAA0B,gEAE5D,OAAO,CAAC,0BAA0B,CAmBpC,CAAC"}

package/dist/waas/signTempoTransaction/index.d.ts

@@ -0,0 +1,2 @@
+export { signTempoTransaction } from './signTempoTransaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/waas/signTempoTransaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/waas/signTempoTransaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/waas/signTempoTransaction/signTempoTransaction.d.ts

@@ -0,0 +1,41 @@
+import type { WalletAccount } from '@dynamic-labs-sdk/client';
+import type { TempoTransactionRequest } from '../utils/assertValidTempoTransactionRequest';
+type SignTempoTransactionParams = Pick<TempoTransactionRequest, 'awaitingFeePayer' | 'calls' | 'feeToken' | 'gas' | 'nonceKey' | 'validAfter' | 'validBefore'> & {
+    walletAccount: WalletAccount;
+};
+type SignTempoTransactionResult = {
+    signedTransaction: string;
+};
+/**
+ * Signs a Tempo transaction with a Tempo embedded wallet without broadcasting
+ * it. Set `awaitingFeePayer` to sign a transaction whose fee a sponsor pays:
+ * the sender signs first, and the sponsor signs the returned transaction
+ * afterwards and broadcasts it.
+ *
+ * @param params.walletAccount - The Tempo embedded wallet account that signs.
+ * @param [params.awaitingFeePayer] - Leaves the fee to a sponsor who signs afterwards. Cannot be combined with `feeToken`.
+ * @param [params.calls] - The calls the transaction executes atomically.
+ * @param [params.feeToken] - TIP-20 token address used to pay the fee.
+ * @param [params.gas] - Gas limit. Defaults to a buffered estimate.
+ * @param [params.nonceKey] - Nonce key selecting a parallel nonce lane.
+ * @param [params.validAfter] - Unix timestamp after which the transaction is valid.
+ * @param [params.validBefore] - Unix timestamp after which the transaction expires.
+ * @param [client] - The Dynamic client instance. Only required when using multiple clients.
+ * @returns The serialized signed transaction.
+ * @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+ * @throws {TempoTransactionValidationError} If a field is malformed or inconsistent.
+ * @example
+ * ```ts
+ * const { signedTransaction } = await signTempoTransaction({
+ *   awaitingFeePayer: true,
+ *   calls: [{ data: transferData, to: tokenAddress }],
+ *   walletAccount,
+ * });
+ * ```
+ * @see sendTempoTransaction
+ * @see getTempoPublicClient
+ * @notInstrumented
+ */
+export declare const signTempoTransaction: ({ walletAccount, ...transaction }: SignTempoTransactionParams, client?: import("@dynamic-labs-sdk/client").DynamicClient) => Promise<SignTempoTransactionResult>;
+export {};
+//# sourceMappingURL=signTempoTransaction.d.ts.map

package/dist/waas/signTempoTransaction/signTempoTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signTempoTransaction.d.ts","sourceRoot":"","sources":["../../../src/waas/signTempoTransaction/signTempoTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAO9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAE3F,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACrB,kBAAkB,GAClB,OAAO,GACP,UAAU,GACV,KAAK,GACL,UAAU,GACV,YAAY,GACZ,aAAa,CAChB,GAAG;IACF,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,oBAAoB,sCACI,0BAA0B,gEAE5D,OAAO,CAAC,0BAA0B,CAapC,CAAC"}

package/dist/waas/utils/assertTransactionCanBeBroadcast/assertTransactionCanBeBroadcast.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Rejects a transaction that awaits a fee payer, because broadcasting it
+ * before the sponsor signs would fail on the network.
+ *
+ * @param transaction - The transaction about to be broadcast.
+ * @returns Nothing. Throws when the transaction awaits a fee payer.
+ * @throws {TempoTransactionValidationError} If `awaitingFeePayer` is set.
+ * @example
+ * ```ts
+ * assertTransactionCanBeBroadcast({ calls: [{ to: '0xabc' }] });
+ * ```
+ * @see signTempoTransaction
+ * @see sendTempoTransaction
+ * @notInstrumented
+ */
+export declare const assertTransactionCanBeBroadcast: (transaction: unknown) => void;
+//# sourceMappingURL=assertTransactionCanBeBroadcast.d.ts.map

package/dist/waas/utils/assertTransactionCanBeBroadcast/assertTransactionCanBeBroadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertTransactionCanBeBroadcast.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertTransactionCanBeBroadcast/assertTransactionCanBeBroadcast.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,+BAA+B,gBAAiB,OAAO,KAAG,IAWtE,CAAC"}

package/dist/waas/utils/assertTransactionCanBeBroadcast/index.d.ts

@@ -0,0 +1,2 @@
+export { assertTransactionCanBeBroadcast } from './assertTransactionCanBeBroadcast';
+//# sourceMappingURL=index.d.ts.map

package/dist/waas/utils/assertTransactionCanBeBroadcast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertTransactionCanBeBroadcast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/waas/utils/assertValidTempoFeePayerFields/assertValidTempoFeePayerFields.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Rejects an inconsistent fee payer setup before it reaches the signer. A
+ * transaction that awaits a fee payer leaves the fee token to the sponsor, so
+ * it cannot name one.
+ *
+ * @param params.awaitingFeePayer - Whether a sponsor signs the transaction afterwards.
+ * @param [params.feeToken] - The TIP-20 token address that pays the fee.
+ * @returns Nothing. Throws on an inconsistent setup.
+ * @throws {TempoTransactionValidationError} If `awaitingFeePayer` is not true or is combined with `feeToken`.
+ * @example
+ * ```ts
+ * assertValidTempoFeePayerFields({ awaitingFeePayer: true });
+ * ```
+ * @see assertValidTempoTransactionRequest
+ * @see signTempoTransaction
+ * @notInstrumented
+ */
+export declare const assertValidTempoFeePayerFields: ({ awaitingFeePayer, feeToken, }: {
+    awaitingFeePayer?: true;
+    feeToken?: string;
+}) => void;
+//# sourceMappingURL=assertValidTempoFeePayerFields.d.ts.map

package/dist/waas/utils/assertValidTempoFeePayerFields/assertValidTempoFeePayerFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertValidTempoFeePayerFields.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoFeePayerFields/assertValidTempoFeePayerFields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,8BAA8B,oCAGxC;IACD,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,IAUH,CAAC"}

package/dist/waas/utils/assertValidTempoFeePayerFields/index.d.ts

@@ -0,0 +1,2 @@
+export { assertValidTempoFeePayerFields } from './assertValidTempoFeePayerFields';
+//# sourceMappingURL=index.d.ts.map

package/dist/waas/utils/assertValidTempoFeePayerFields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoFeePayerFields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/waas/utils/assertValidTempoTransactionRequest/assertValidTempoTransactionRequest.d.ts

@@ -2,8 +2,9 @@ import type { Hex, TransactionSerializable } from 'viem';
 import type { TempoTransactionCall } from '../serializeTempoTransactionForWaas';
 /**
  * A Tempo transaction request. Extends the standard viem transaction with the
- * Tempo fields: batched `calls`, `feeToken`, `nonceKey` (2D nonce) and
- * `validAfter` / `validBefore` expirations.
+ * Tempo fields: batched `calls`, `feeToken`, `nonceKey` (2D nonce),
+ * `validAfter` / `validBefore` expirations and `awaitingFeePayer`, which leaves
+ * the fee to be paid by a sponsor who signs the transaction afterwards.
  *
  * @example
  * ```ts
@@ -14,6 +15,7 @@ import type { TempoTransactionCall } from '../serializeTempoTransactionForWaas';
  * ```
  */
 export type TempoTransactionRequest = TransactionSerializable & {
+    awaitingFeePayer?: true;
     calls?: readonly TempoTransactionCall[];
     feeToken?: Hex;
     nonceKey?: bigint;

package/dist/waas/utils/assertValidTempoTransactionRequest/assertValidTempoTransactionRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertValidTempoTransactionRequest.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoTransactionRequest/assertValidTempoTransactionRequest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,uBAAuB,EAAE,MAAM,MAAM,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAAG;IAC9D,KAAK,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kCAAkC,8BAG5C;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,uBAAuB,CAAC;CACtC,KAAG,IA8CH,CAAC"}
+{"version":3,"file":"assertValidTempoTransactionRequest.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoTransactionRequest/assertValidTempoTransactionRequest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,uBAAuB,EAAE,MAAM,MAAM,CAAC;AAKzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAAG;IAC9D,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kCAAkC,8BAG5C;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,uBAAuB,CAAC;CACtC,KAAG,IAgCH,CAAC"}

package/dist/waas/utils/assertValidTempoValidityWindow/assertValidTempoValidityWindow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Rejects a malformed validity window before it reaches the signer. Both
+ * bounds are non-negative integer Unix timestamps in seconds, and the window
+ * must open before it closes.
+ *
+ * @param params.validAfter - Unix timestamp after which the transaction is valid.
+ * @param params.validBefore - Unix timestamp after which the transaction expires.
+ * @returns Nothing. Throws on a malformed window.
+ * @throws {TempoTransactionValidationError} If a bound is not a non-negative integer or `validAfter` is not before `validBefore`.
+ * @example
+ * ```ts
+ * assertValidTempoValidityWindow({ validAfter: 100, validBefore: 200 });
+ * ```
+ * @see assertValidTempoTransactionRequest
+ * @see sendTempoTransaction
+ * @notInstrumented
+ */
+export declare const assertValidTempoValidityWindow: ({ validAfter, validBefore, }: {
+    validAfter?: number;
+    validBefore?: number;
+}) => void;
+//# sourceMappingURL=assertValidTempoValidityWindow.d.ts.map

package/dist/waas/utils/assertValidTempoValidityWindow/assertValidTempoValidityWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertValidTempoValidityWindow.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoValidityWindow/assertValidTempoValidityWindow.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,8BAA8B,iCAGxC;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,IAmBH,CAAC"}

package/dist/waas/utils/assertValidTempoValidityWindow/index.d.ts

@@ -0,0 +1,2 @@
+export { assertValidTempoValidityWindow } from './assertValidTempoValidityWindow';
+//# sourceMappingURL=index.d.ts.map

package/dist/waas/utils/assertValidTempoValidityWindow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/assertValidTempoValidityWindow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/waas/utils/createViemWalletClientForWaasTempo/createViemWalletClientForWaasTempo.d.ts

@@ -11,7 +11,8 @@ type CreateViemWalletClientForWaasTempoParams = {
  * Creates a viem wallet client for a Tempo embedded wallet account.
  *
  * Transactions are signed as Tempo transactions: batched `calls`, `feeToken`,
- * `nonceKey` and `validAfter` / `validBefore` pass through to the signer. Gas
+ * `nonceKey`, `validAfter` / `validBefore` and `awaitingFeePayer` pass through
+ * to the signer. Gas
  * is the larger of the caller's value and a 30% buffered estimate with a 300k
  * floor, fees are at least the network gas price, and the nonce is the next
  * one on the requested nonce lane.

package/dist/waas/utils/createViemWalletClientForWaasTempo/createViemWalletClientForWaasTempo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createViemWalletClientForWaasTempo.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/createViemWalletClientForWaasTempo/createViemWalletClientForWaasTempo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EAEL,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,kBAAkB,EACnB,MAAM,MAAM,CAAC;AAiDd,KAAK,wCAAwC,GAAG;IAC9C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,sBAAsB,CAAC,EAAE,IAAI,CAC3B,kBAAkB,EAClB,SAAS,GAAG,OAAO,GAAG,WAAW,CAClC,CAAC;IACF,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,eAAO,MAAM,kCAAkC,kFAM1C,wCAAwC,iBAC5B,aAAa,KAC3B,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAmLjD,CAAC"}
+{"version":3,"file":"createViemWalletClientForWaasTempo.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/createViemWalletClientForWaasTempo/createViemWalletClientForWaasTempo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EAEL,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,kBAAkB,EACnB,MAAM,MAAM,CAAC;AAkDd,KAAK,wCAAwC,GAAG;IAC9C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,sBAAsB,CAAC,EAAE,IAAI,CAC3B,kBAAkB,EAClB,SAAS,GAAG,OAAO,GAAG,WAAW,CAClC,CAAC;IACF,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,eAAO,MAAM,kCAAkC,kFAM1C,wCAAwC,iBAC5B,aAAa,KAC3B,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CA8LjD,CAAC"}

package/dist/waas/utils/getTempoWalletClient/getTempoWalletClient.d.ts

@@ -0,0 +1,21 @@
+import type { DynamicClient, WalletAccount } from '@dynamic-labs-sdk/client';
+import type { Account, Chain, Transport, WalletClient } from 'viem';
+/**
+ * Creates the viem wallet client of a Tempo embedded wallet account.
+ *
+ * @param params.walletAccount - The Tempo embedded wallet account.
+ * @param client - The Dynamic client instance.
+ * @returns A viem wallet client bound to the Tempo account.
+ * @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+ * @example
+ * ```ts
+ * const walletClient = await getTempoWalletClient({ walletAccount }, client);
+ * ```
+ * @see sendTempoTransaction
+ * @see signTempoTransaction
+ * @notInstrumented
+ */
+export declare const getTempoWalletClient: ({ walletAccount }: {
+    walletAccount: WalletAccount;
+}, client: DynamicClient) => Promise<WalletClient<Transport, Chain, Account>>;
+//# sourceMappingURL=getTempoWalletClient.d.ts.map

package/dist/waas/utils/getTempoWalletClient/getTempoWalletClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTempoWalletClient.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/getTempoWalletClient/getTempoWalletClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK7E,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,sBACZ;IAAE,aAAa,EAAE,aAAa,CAAA;CAAE,UAC3C,aAAa,KACpB,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAejD,CAAC"}

package/dist/waas/utils/getTempoWalletClient/index.d.ts

@@ -0,0 +1,2 @@
+export { getTempoWalletClient } from './getTempoWalletClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/waas/utils/getTempoWalletClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/getTempoWalletClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/waas/utils/serializeTempoTransactionForWaas/serializeTempoTransactionForWaas.d.ts

@@ -16,6 +16,8 @@ export type TempoTransactionCall = {
     value?: bigint;
 };
 export type SerializeTempoTransactionForWaasParams = {
+    /** Leaves the fee to a sponsor who signs the transaction after the sender. */
+    awaitingFeePayer?: boolean;
     /** Calls executed atomically by the transaction, one entry per batched call. */
     calls: readonly TempoTransactionCall[];
     chainId: number;
@@ -53,5 +55,5 @@ export type SerializeTempoTransactionForWaasParams = {
  * @see createWalletProviderForWaasTempo
  * @notInstrumented
  */
-export declare const serializeTempoTransactionForWaas: ({ calls, chainId, feeToken, gas, maxFeePerGas, maxPriorityFeePerGas, nonce, nonceKey, validAfter, validBefore, }: SerializeTempoTransactionForWaasParams) => string;
+export declare const serializeTempoTransactionForWaas: ({ awaitingFeePayer, calls, chainId, feeToken, gas, maxFeePerGas, maxPriorityFeePerGas, nonce, nonceKey, validAfter, validBefore, }: SerializeTempoTransactionForWaasParams) => string;
 //# sourceMappingURL=serializeTempoTransactionForWaas.d.ts.map

package/dist/waas/utils/serializeTempoTransactionForWaas/serializeTempoTransactionForWaas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializeTempoTransactionForWaas.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/serializeTempoTransactionForWaas/serializeTempoTransactionForWaas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,gFAAgF;IAChF,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gCAAgC,qHAW1C,sCAAsC,KAAG,MAgBzC,CAAC"}
+{"version":3,"file":"serializeTempoTransactionForWaas.d.ts","sourceRoot":"","sources":["../../../../src/waas/utils/serializeTempoTransactionForWaas/serializeTempoTransactionForWaas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gCAAgC,uIAY1C,sCAAsC,KAAG,MAiBzC,CAAC"}

package/dist/waas.cjs

@@ -1,4 +1,4 @@
-const require_tempoChainIds = require('./tempoChainIds-Ce9YCriF.cjs');
+const require_tempoChainIds = require('./tempoChainIds-BLY1kZtw.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
@@ -7,6 +7,77 @@ let _dynamic_labs_sdk_client_waas_core = require("@dynamic-labs-sdk/client/waas/
 let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 let viem_accounts = require("viem/accounts");
 
+//#region src/errors/TempoTransactionValidationError/TempoTransactionValidationError.ts
+/**
+* Thrown when a Tempo transaction fails validation before signing, for
+* example because of a malformed address or non-hex call data.
+*
+* @example
+* ```ts
+* throw new TempoTransactionValidationError({ reason: 'malformed call data' });
+* ```
+*
+* @see createWalletProviderForWaasTempo
+* @see addWaasTempoExtension
+*/
+var TempoTransactionValidationError = class extends _dynamic_labs_sdk_client.BaseError {
+	constructor({ reason }) {
+		super({
+			cause: null,
+			code: "tempo_transaction_validation_error",
+			docsUrl: null,
+			name: "TempoTransactionValidationError",
+			shortMessage: `Invalid Tempo transaction: ${reason}`
+		});
+	}
+};
+
+//#endregion
+//#region src/waas/utils/assertTransactionCanBeBroadcast/assertTransactionCanBeBroadcast.ts
+/**
+* Rejects a transaction that awaits a fee payer, because broadcasting it
+* before the sponsor signs would fail on the network.
+*
+* @param transaction - The transaction about to be broadcast.
+* @returns Nothing. Throws when the transaction awaits a fee payer.
+* @throws {TempoTransactionValidationError} If `awaitingFeePayer` is set.
+* @example
+* ```ts
+* assertTransactionCanBeBroadcast({ calls: [{ to: '0xabc' }] });
+* ```
+* @see signTempoTransaction
+* @see sendTempoTransaction
+* @notInstrumented
+*/
+const assertTransactionCanBeBroadcast = (transaction) => {
+	if (typeof transaction === "object" && transaction !== null && "awaitingFeePayer" in transaction && transaction.awaitingFeePayer) throw new TempoTransactionValidationError({ reason: "awaitingFeePayer transactions cannot be broadcast, use signTempoTransaction" });
+};
+
+//#endregion
+//#region src/waas/utils/getTempoWalletClient/getTempoWalletClient.ts
+/**
+* Creates the viem wallet client of a Tempo embedded wallet account.
+*
+* @param params.walletAccount - The Tempo embedded wallet account.
+* @param client - The Dynamic client instance.
+* @returns A viem wallet client bound to the Tempo account.
+* @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+* @example
+* ```ts
+* const walletClient = await getTempoWalletClient({ walletAccount }, client);
+* ```
+* @see sendTempoTransaction
+* @see signTempoTransaction
+* @notInstrumented
+*/
+const getTempoWalletClient = async ({ walletAccount }, client) => {
+	const walletProvider = (0, _dynamic_labs_sdk_client_core.getWalletProviderFromWalletAccount)({ walletAccount }, client);
+	if (!require_tempoChainIds.isTempoWalletProvider(walletProvider)) throw new _dynamic_labs_sdk_client.InvalidParamError("Wallet account is not a Tempo wallet account");
+	(0, _dynamic_labs_sdk_client_core.assertDefined)(walletProvider.createViemWalletClient, "Tempo wallet provider cannot create a wallet client");
+	return await walletProvider.createViemWalletClient({ walletAccount });
+};
+
+//#endregion
 //#region src/waas/sendTempoTransaction/sendTempoTransaction.ts
 /**
 * Sends a Tempo transaction from a Tempo embedded wallet, including the
@@ -24,6 +95,7 @@ let viem_accounts = require("viem/accounts");
 * @param [client] - The Dynamic client instance. Only required when using multiple clients.
 * @returns The transaction hash.
 * @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+* @throws {TempoTransactionValidationError} If `awaitingFeePayer` is set, because a transaction that awaits a fee payer cannot be broadcast.
 * @example
 * ```ts
 * const { transactionHash } = await sendTempoTransaction({
@@ -36,19 +108,56 @@ let viem_accounts = require("viem/accounts");
 * });
 * ```
 * @see sendTip20Transaction
+* @see signTempoTransaction
 * @see getTempoPublicClient
 * @notInstrumented
 */
 const sendTempoTransaction = async ({ walletAccount, ...transaction }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
-	const walletProvider = (0, _dynamic_labs_sdk_client_core.getWalletProviderFromWalletAccount)({ walletAccount }, client);
-	if (!require_tempoChainIds.isTempoWalletProvider(walletProvider)) throw new _dynamic_labs_sdk_client.InvalidParamError("Wallet account is not a Tempo wallet account");
-	(0, _dynamic_labs_sdk_client_core.assertDefined)(walletProvider.createViemWalletClient, "Tempo wallet provider cannot create a wallet client");
-	const walletClient = await walletProvider.createViemWalletClient({ walletAccount });
+	assertTransactionCanBeBroadcast(transaction);
+	const walletClient = await getTempoWalletClient({ walletAccount }, client);
 	(0, _dynamic_labs_sdk_client_core.assertDefined)(walletClient.account.signTransaction, "Tempo account cannot sign transactions");
 	const serializedTransaction = await walletClient.account.signTransaction(transaction);
 	return { transactionHash: await walletClient.sendRawTransaction({ serializedTransaction }) };
 };
 
+//#endregion
+//#region src/waas/signTempoTransaction/signTempoTransaction.ts
+/**
+* Signs a Tempo transaction with a Tempo embedded wallet without broadcasting
+* it. Set `awaitingFeePayer` to sign a transaction whose fee a sponsor pays:
+* the sender signs first, and the sponsor signs the returned transaction
+* afterwards and broadcasts it.
+*
+* @param params.walletAccount - The Tempo embedded wallet account that signs.
+* @param [params.awaitingFeePayer] - Leaves the fee to a sponsor who signs afterwards. Cannot be combined with `feeToken`.
+* @param [params.calls] - The calls the transaction executes atomically.
+* @param [params.feeToken] - TIP-20 token address used to pay the fee.
+* @param [params.gas] - Gas limit. Defaults to a buffered estimate.
+* @param [params.nonceKey] - Nonce key selecting a parallel nonce lane.
+* @param [params.validAfter] - Unix timestamp after which the transaction is valid.
+* @param [params.validBefore] - Unix timestamp after which the transaction expires.
+* @param [client] - The Dynamic client instance. Only required when using multiple clients.
+* @returns The serialized signed transaction.
+* @throws {InvalidParamError} If the wallet account is not a Tempo wallet account.
+* @throws {TempoTransactionValidationError} If a field is malformed or inconsistent.
+* @example
+* ```ts
+* const { signedTransaction } = await signTempoTransaction({
+*   awaitingFeePayer: true,
+*   calls: [{ data: transferData, to: tokenAddress }],
+*   walletAccount,
+* });
+* ```
+* @see sendTempoTransaction
+* @see getTempoPublicClient
+* @notInstrumented
+*/
+const signTempoTransaction = async ({ walletAccount, ...transaction }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
+	const walletClient = await getTempoWalletClient({ walletAccount }, client);
+	(0, _dynamic_labs_sdk_client_core.assertDefined)(walletClient.account.signTransaction, "Tempo account cannot sign transactions");
+	return { signedTransaction: await walletClient.account.signTransaction(transaction) };
+};
+
 //#endregion
 //#region src/constants.ts
 /**
@@ -200,32 +309,6 @@ var TempoRawMessageNotUtf8Error = class extends _dynamic_labs_sdk_client.BaseErr
 	}
 };
 
-//#endregion
-//#region src/errors/TempoTransactionValidationError/TempoTransactionValidationError.ts
-/**
-* Thrown when a Tempo transaction fails validation before signing, for
-* example because of a malformed address or non-hex call data.
-*
-* @example
-* ```ts
-* throw new TempoTransactionValidationError({ reason: 'malformed call data' });
-* ```
-*
-* @see createWalletProviderForWaasTempo
-* @see addWaasTempoExtension
-*/
-var TempoTransactionValidationError = class extends _dynamic_labs_sdk_client.BaseError {
-	constructor({ reason }) {
-		super({
-			cause: null,
-			code: "tempo_transaction_validation_error",
-			docsUrl: null,
-			name: "TempoTransactionValidationError",
-			shortMessage: `Invalid Tempo transaction: ${reason}`
-		});
-	}
-};
-
 //#endregion
 //#region src/errors/TempoTypedDataNotSupportedError/TempoTypedDataNotSupportedError.ts
 /**
@@ -276,6 +359,54 @@ const assertValidTempoTransactionCalls = ({ calls }) => {
 	}
 };
 
+//#endregion
+//#region src/waas/utils/assertValidTempoFeePayerFields/assertValidTempoFeePayerFields.ts
+/**
+* Rejects an inconsistent fee payer setup before it reaches the signer. A
+* transaction that awaits a fee payer leaves the fee token to the sponsor, so
+* it cannot name one.
+*
+* @param params.awaitingFeePayer - Whether a sponsor signs the transaction afterwards.
+* @param [params.feeToken] - The TIP-20 token address that pays the fee.
+* @returns Nothing. Throws on an inconsistent setup.
+* @throws {TempoTransactionValidationError} If `awaitingFeePayer` is not true or is combined with `feeToken`.
+* @example
+* ```ts
+* assertValidTempoFeePayerFields({ awaitingFeePayer: true });
+* ```
+* @see assertValidTempoTransactionRequest
+* @see signTempoTransaction
+* @notInstrumented
+*/
+const assertValidTempoFeePayerFields = ({ awaitingFeePayer, feeToken }) => {
+	if (awaitingFeePayer !== void 0 && awaitingFeePayer !== true) throw new TempoTransactionValidationError({ reason: "awaitingFeePayer must be true" });
+	if (awaitingFeePayer && feeToken !== void 0) throw new TempoTransactionValidationError({ reason: "awaitingFeePayer cannot be combined with feeToken" });
+};
+
+//#endregion
+//#region src/waas/utils/assertValidTempoValidityWindow/assertValidTempoValidityWindow.ts
+/**
+* Rejects a malformed validity window before it reaches the signer. Both
+* bounds are non-negative integer Unix timestamps in seconds, and the window
+* must open before it closes.
+*
+* @param params.validAfter - Unix timestamp after which the transaction is valid.
+* @param params.validBefore - Unix timestamp after which the transaction expires.
+* @returns Nothing. Throws on a malformed window.
+* @throws {TempoTransactionValidationError} If a bound is not a non-negative integer or `validAfter` is not before `validBefore`.
+* @example
+* ```ts
+* assertValidTempoValidityWindow({ validAfter: 100, validBefore: 200 });
+* ```
+* @see assertValidTempoTransactionRequest
+* @see sendTempoTransaction
+* @notInstrumented
+*/
+const assertValidTempoValidityWindow = ({ validAfter, validBefore }) => {
+	for (const [field, value] of [["validAfter", validAfter], ["validBefore", validBefore]]) if (value !== void 0 && (!Number.isInteger(value) || value < 0)) throw new TempoTransactionValidationError({ reason: `${field} must be a non-negative integer timestamp` });
+	if (validAfter !== void 0 && validBefore !== void 0 && validAfter >= validBefore) throw new TempoTransactionValidationError({ reason: "validAfter must be before validBefore" });
+};
+
 //#endregion
 //#region src/waas/utils/assertValidTempoTransactionRequest/assertValidTempoTransactionRequest.ts
 /**
@@ -294,14 +425,11 @@ const assertValidTempoTransactionCalls = ({ calls }) => {
 */
 const assertValidTempoTransactionRequest = ({ transaction, chainId }) => {
 	if (transaction.feeToken !== void 0 && !(0, viem.isAddress)(transaction.feeToken)) throw new TempoTransactionValidationError({ reason: "malformed feeToken address" });
+	assertValidTempoFeePayerFields(transaction);
 	if (transaction.calls !== void 0 && (transaction.to !== void 0 || transaction.data !== void 0 || transaction.value !== void 0)) throw new TempoTransactionValidationError({ reason: "calls cannot be combined with top-level to, data or value" });
 	if (transaction.chainId !== void 0 && transaction.chainId !== chainId) throw new TempoTransactionValidationError({ reason: "chainId does not match the active Tempo network" });
 	if (transaction.nonceKey !== void 0 && (typeof transaction.nonceKey !== "bigint" || transaction.nonceKey < 0n)) throw new TempoTransactionValidationError({ reason: "nonceKey must be a non-negative bigint" });
-	for (const field of ["validAfter", "validBefore"]) {
-		const value = transaction[field];
-		if (value !== void 0 && (!Number.isInteger(value) || value < 0)) throw new TempoTransactionValidationError({ reason: `${field} must be a non-negative integer timestamp` });
-	}
-	if (transaction.validAfter !== void 0 && transaction.validBefore !== void 0 && transaction.validAfter >= transaction.validBefore) throw new TempoTransactionValidationError({ reason: "validAfter must be before validBefore" });
+	assertValidTempoValidityWindow(transaction);
 };
 
 //#endregion
@@ -347,13 +475,14 @@ const isBusinessAccountWalletAccount = (walletAccount) => "businessAccountId" in
 * @see createWalletProviderForWaasTempo
 * @notInstrumented
 */
-const serializeTempoTransactionForWaas = ({ calls, chainId, feeToken, gas, maxFeePerGas, maxPriorityFeePerGas, nonce, nonceKey, validAfter, validBefore }) => JSON.stringify({
+const serializeTempoTransactionForWaas = ({ awaitingFeePayer, calls, chainId, feeToken, gas, maxFeePerGas, maxPriorityFeePerGas, nonce, nonceKey, validAfter, validBefore }) => JSON.stringify({
 	calls: calls.map(({ data, to, value }) => ({
 		data,
 		to,
 		value
 	})),
 	chainId,
+	feePayer: awaitingFeePayer ? true : void 0,
 	feeToken,
 	gas,
 	maxFeePerGas,
@@ -438,7 +567,8 @@ const TEMPO_NONCE_MANAGER_ABI = [{
 * Creates a viem wallet client for a Tempo embedded wallet account.
 *
 * Transactions are signed as Tempo transactions: batched `calls`, `feeToken`,
-* `nonceKey` and `validAfter` / `validBefore` pass through to the signer. Gas
+* `nonceKey`, `validAfter` / `validBefore` and `awaitingFeePayer` pass through
+* to the signer. Gas
 * is the larger of the caller's value and a 30% buffered estimate with a 300k
 * floor, fees are at least the network gas price, and the nonce is the next
 * one on the requested nonce lane.
@@ -497,7 +627,7 @@ const createViemWalletClientForWaasTempo = async ({ waasProvider, walletAccount,
 			functionName: "getNonce"
 		}));
 	};
-	return (0, viem.createWalletClient)({
+	const walletClient = (0, viem.createWalletClient)({
 		account: (0, viem_accounts.toAccount)({
 			address: walletAccount.address,
 			signMessage: async ({ message }) => {
@@ -542,6 +672,7 @@ const createViemWalletClientForWaasTempo = async ({ waasProvider, walletAccount,
 				const maxPriorityFeePerGas = requestedMaxPriorityFeePerGas !== void 0 && requestedMaxPriorityFeePerGas > priorityGasPrice ? requestedMaxPriorityFeePerGas : priorityGasPrice;
 				if (maxPriorityFeePerGas > maxFeePerGas) throw new TempoTransactionValidationError({ reason: "maxPriorityFeePerGas must not exceed maxFeePerGas" });
 				const serializedTransaction = serializeTempoTransactionForWaas({
+					awaitingFeePayer: transaction.awaitingFeePayer,
 					calls,
 					chainId: chain.id,
 					feeToken: transaction.feeToken,
@@ -567,6 +698,11 @@ const createViemWalletClientForWaasTempo = async ({ waasProvider, walletAccount,
 		transport,
 		...viemWalletClientConfig
 	});
+	const { sendTransaction } = walletClient;
+	return Object.assign(walletClient, { sendTransaction: (async (transaction) => {
+		assertTransactionCanBeBroadcast(transaction);
+		return await sendTransaction(transaction);
+	}) });
 };
 
 //#endregion
@@ -755,4 +891,5 @@ exports.TempoTransactionValidationError = TempoTransactionValidationError;
 exports.TempoTypedDataNotSupportedError = TempoTypedDataNotSupportedError;
 exports.addWaasTempoExtension = addWaasTempoExtension;
 exports.sendTempoTransaction = sendTempoTransaction;
+exports.signTempoTransaction = signTempoTransaction;
 //# sourceMappingURL=waas.cjs.map