Improve Tempo Zone SDK helpers

.changeset/tempo-zone-sdk-helpers.md

@@ -0,0 +1,9 @@
+---
+'viem': patch
+---
+
+`viem/tempo`: Added Zone helpers for preparing encrypted deposit recipients, waiting for processed deposits, and preparing withdrawals without broadcasting.
+
+`viem/tempo`: Deposit helpers now accept an explicit `portalAddress` for zones outside viem's built-in registry. Prepared encrypted deposits now honor their `portalAddress` when building calls (previously the portal was always re-derived from the registry).
+
+`viem/tempo`: Zone withdrawal helpers now use `callbackGas` for the callback gas limit, leaving `gas` for transaction gas overrides. `zone.getWithdrawalFee` keeps a deprecated `gas` alias.

site/pages/tempo/actions/index.mdx

@@ -135,8 +135,10 @@
 | [`zone.encryptedDeposit`](/tempo/actions/zone.encryptedDeposit) | Deposits tokens into a zone with encrypted recipient and memo |
 | [`zone.getAuthorizationTokenInfo`](/tempo/actions/zone.getAuthorizationTokenInfo) | Gets the authenticated account and expiry from the current authorization token |
 | [`zone.getDepositStatus`](/tempo/actions/zone.getDepositStatus) | Gets deposit processing status for a given Tempo block number |
-| [`zone.getWithdrawalFee`](/tempo/actions/zone.getWithdrawalFee) | Gets the withdrawal fee for a given gas limit |
+| [`zone.getWithdrawalFee`](/tempo/actions/zone.getWithdrawalFee) | Gets the withdrawal fee for a given callback gas limit |
 | [`zone.getZoneInfo`](/tempo/actions/zone.getZoneInfo) | Gets metadata about the current zone |
+| [`zone.prepareWithdrawal`](/tempo/actions/zone.prepareWithdrawal) | Prepares withdrawal calls and fee details without broadcasting |
 | [`zone.requestVerifiableWithdrawal`](/tempo/actions/zone.requestVerifiableWithdrawal) | Requests a verifiable withdrawal from a zone to the parent Tempo chain |
 | [`zone.requestWithdrawal`](/tempo/actions/zone.requestWithdrawal) | Requests a withdrawal from a zone to the parent Tempo chain |
 | [`zone.signAuthorizationToken`](/tempo/actions/zone.signAuthorizationToken) | Signs a zone authorization token for authenticating zone RPC requests |
+| [`zone.waitForDepositProcessed`](/tempo/actions/zone.waitForDepositProcessed) | Waits for a Tempo block's deposits to be processed by the zone |

site/pages/tempo/actions/zone.deposit.mdx

@@ -77,6 +77,14 @@ Token address or ID to deposit.
 
 Zone ID to deposit into (e.g. `7`).
 
+### portalAddress (optional)
+
+- **Type:** `Address`
+- **Default:** viem's zone registry
+
+Zone portal address on the parent Tempo chain. Pass this for hosted or custom zones that are not in
+viem's built-in registry.
+
 ### memo (optional)
 
 - **Type:** `Hex`

site/pages/tempo/actions/zone.encryptedDeposit.mdx

@@ -80,6 +80,21 @@ export const broadcaster = client
 
 :::
 
+## Recipient-Only Usage
+
+`zone.encryptedDeposit.prepare` returns a complete deposit intent with `token`, `amount`, and the
+encrypted recipient instructions. Use `zone.encryptedDeposit.prepareRecipient` when you only need the
+recipient-encryption piece because another contract or service controls the token movement.
+
+```ts twoslash
+import { client } from './viem.config'
+
+const preparedRecipient = await client.zone.encryptedDeposit.prepareRecipient({
+  recipient: '0x0000000000000000000000000000000000000001',
+  zoneId: 7,
+})
+```
+
 ## Return Type
 
 ```ts
@@ -109,6 +124,14 @@ Token address or ID to deposit.
 
 Zone ID to deposit into (e.g. `7`).
 
+### portalAddress (optional)
+
+- **Type:** `Address`
+- **Default:** viem's zone registry
+
+Zone portal address on the parent Tempo chain. Pass this for hosted or custom zones that are not in
+viem's built-in registry.
+
 ### memo (optional)
 
 - **Type:** `Hex`

site/pages/tempo/actions/zone.getWithdrawalFee.mdx

@@ -23,14 +23,14 @@ console.log('Fee:', fee)
 
 :::
 
-### Custom Gas Limit
+### Custom Callback Gas Limit
 
 ```ts twoslash
 // @twoslash-cache: {"v":2,"hash":"400184268ea2cd3a6cf88917d013ceefa81ebc1cd0cdb11c0add9fe278d3be2b","data":"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="}
 import { client } from './zones.config'
 
 const fee = await client.zone.getWithdrawalFee({
-  gas: 100_000n,
+  callbackGas: 100_000n,
 })
 ```
 
@@ -44,7 +44,7 @@ The withdrawal fee as a bigint.
 
 ## Parameters
 
-### gas (optional)
+### callbackGas (optional)
 
 - **Type:** `bigint`
 - **Default:** `0n`

site/pages/tempo/actions/zone.prepareWithdrawal.mdx

@@ -0,0 +1,73 @@
+# `zone.prepareWithdrawal`
+
+Prepares a zone withdrawal without broadcasting it.
+
+Use this to inspect the ZoneOutbox calls and fee details before submitting a withdrawal. The helper
+returns the same approve/request calls used by
+[`zone.requestWithdrawal`](/tempo/actions/zone.requestWithdrawal), the protocol withdrawal fee, and
+optionally an estimated zone transaction fee.
+
+## Usage
+
+:::code-group
+
+```ts twoslash [example.ts]
+import { client } from './zones.config'
+
+const prepared = await client.zone.prepareWithdrawal({
+  token: '0x20c0000000000000000000000000000000000001',
+  amount: 1_000_000n,
+  to: '0x0000000000000000000000000000000000000001',
+  estimateTransactionFee: true,
+  transactionFeeScale: 1_000_000_000_000n,
+})
+
+console.log('Total fee:', prepared.totalFee)
+```
+
+```ts twoslash [zones.config.ts] filename="zones.config.ts"
+// [!include ~/snippets/tempo/zones.config.ts:setup]
+```
+
+:::
+
+## Return Type
+
+```ts
+type ReturnType = {
+  amount: bigint
+  callbackGas: bigint
+  calls: unknown[]
+  data: Hex
+  estimatedGas?: bigint
+  fallbackRecipient: Address
+  gasPrice?: bigint
+  memo: Hex
+  to: Address
+  token: TokenIdOrAddress
+  totalFee: bigint
+  transactionFee?: bigint
+  withdrawalFee: bigint
+}
+```
+
+## Parameters
+
+Accepts the same withdrawal parameters as [`zone.requestWithdrawal`](/tempo/actions/zone.requestWithdrawal),
+plus the options below.
+
+### estimateTransactionFee (optional)
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Whether to estimate the zone transaction gas fee and include it in `transactionFee` and `totalFee`.
+Requires `transactionFeeScale`.
+
+### transactionFeeScale
+
+- **Type:** `bigint`
+
+Divisor used to convert `estimatedGas * gasPrice` (18-decimal units) into the fee token's base
+units: `10 ** (18 - decimals)`. For a 6-decimal fee token, pass `1_000_000_000_000n`. Required when
+`estimateTransactionFee` is `true`; omit it otherwise.

site/pages/tempo/actions/zone.requestVerifiableWithdrawal.mdx

@@ -108,7 +108,7 @@ Optional callback data for the recipient.
 
 Fallback address if callback fails.
 
-### gas (optional)
+### callbackGas (optional)
 
 - **Type:** `bigint`
 - **Default:** `0n`

site/pages/tempo/actions/zone.requestWithdrawal.mdx

@@ -90,7 +90,7 @@ Optional callback data for the recipient.
 
 Fallback address if callback fails.
 
-### gas (optional)
+### callbackGas (optional)
 
 - **Type:** `bigint`
 - **Default:** `0n`

site/pages/tempo/actions/zone.waitForDepositProcessed.mdx

@@ -0,0 +1,59 @@
+# `zone.waitForDepositProcessed`
+
+Waits until deposits for a given Tempo block number have been processed by the zone.
+
+Use this after a parent-chain deposit transaction has been included and you want to wait for the
+corresponding zone balance to be available.
+
+## Usage
+
+:::code-group
+
+```ts twoslash [example.ts]
+import { client } from './zones.config'
+
+const status = await client.zone.waitForDepositProcessed({
+  tempoBlockNumber: 123456n,
+})
+
+console.log('Processed:', status.processed)
+```
+
+```ts twoslash [zones.config.ts] filename="zones.config.ts"
+// [!include ~/snippets/tempo/zones.config.ts:setup]
+```
+
+:::
+
+## Return Type
+
+```ts
+type ReturnType = {
+  deposits: Deposit[]
+  processed: boolean
+  tempoBlockNumber: bigint
+  zoneProcessedThrough: bigint
+}
+```
+
+## Parameters
+
+### tempoBlockNumber
+
+- **Type:** `bigint`
+
+The Tempo L1 block number to wait for.
+
+### pollingInterval (optional)
+
+- **Type:** `number`
+- **Default:** `client.pollingInterval`
+
+Polling frequency, in milliseconds.
+
+### timeout (optional)
+
+- **Type:** `number`
+- **Default:** `60_000`
+
+Maximum time to wait, in milliseconds. Set to `0` to disable the timeout.

site/pages/tempo/guides/zones/deposit.mdx

@@ -78,19 +78,19 @@ const { receipt } = await client.zone.encryptedDepositSync({
 
 :::
 
-### Check Deposit Status
+### Wait for Zone Processing
 
-After depositing, confirm the funds have landed inside the zone with
-[`zone.getDepositStatus`](/tempo/actions/zone.getDepositStatus), querying by the Mainnet block number
-of your deposit. This call runs against the zone client.
+After depositing, wait for the funds to land inside the zone with
+[`zone.waitForDepositProcessed`](/tempo/actions/zone.waitForDepositProcessed), querying by the Mainnet
+block number of your deposit. This call runs against the zone client.
 
 :::code-group
 
 ```ts twoslash [example.ts]
 // @twoslash-cache: {"v":2,"hash":"1291cbf697bb60877644df577f40983e152248fa587857cb3771f0b2aa87db0f","data":"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"}
 import { client } from './zones.config'
 
-const status = await client.zone.getDepositStatus({
+const status = await client.zone.waitForDepositProcessed({
   tempoBlockNumber: 123456n,
 })
 ```
@@ -125,8 +125,16 @@ Validate the public transaction details before broadcasting a prepared payload f
 
 ### Track the Deposit Block Number
 
-`zone.getDepositStatus` is keyed by the Mainnet block number of the deposit. Capture it from the
-deposit receipt so you can reliably poll for processing.
+`zone.waitForDepositProcessed` is keyed by the Mainnet block number of the deposit. Capture it from
+the deposit receipt so you can reliably wait for processing.
+
+### Use a Custom Portal for Hosted Zones
+
+If your zone's portal is not in viem's built-in registry, pass `portalAddress` to
+[`zone.deposit`](/tempo/actions/zone.deposit), [`zone.encryptedDeposit`](/tempo/actions/zone.encryptedDeposit),
+`zone.encryptedDeposit.prepare`, or `zone.encryptedDeposit.prepareRecipient`.
+This keeps hosted-zone integrations from needing to fork the Zone helpers while the registry catches
+up.
 
 ## See More
 

site/vocs.config.ts

@@ -3047,6 +3047,10 @@ export default defineConfig({
                   text: 'getZoneInfo',
                   link: '/tempo/actions/zone.getZoneInfo',
                 },
+                {
+                  text: 'prepareWithdrawal',
+                  link: '/tempo/actions/zone.prepareWithdrawal',
+                },
                 {
                   text: 'requestVerifiableWithdrawal',
                   link: '/tempo/actions/zone.requestVerifiableWithdrawal',
@@ -3059,6 +3063,10 @@ export default defineConfig({
                   text: 'signAuthorizationToken',
                   link: '/tempo/actions/zone.signAuthorizationToken',
                 },
+                {
+                  text: 'waitForDepositProcessed',
+                  link: '/tempo/actions/zone.waitForDepositProcessed',
+                },
               ],
             },
           ],

src/chains/index.ts

@@ -152,9 +152,9 @@ export { datahavenTestnet } from './definitions/datahavenTestnet.js'
 export { dbkchain } from './definitions/dbkchain.js'
 export { dchain } from './definitions/dchain.js'
 export { dchainTestnet } from './definitions/dchainTestnet.js'
-export { defiOracleMetaMainnet } from './definitions/defiOracleMetaMainnet.js'
 export { defichainEvm } from './definitions/defichainEvm.js'
 export { defichainEvmTestnet } from './definitions/defichainEvmTestnet.js'
+export { defiOracleMetaMainnet } from './definitions/defiOracleMetaMainnet.js'
 export { degen } from './definitions/degen.js'
 export { dfk } from './definitions/dfk.js'
 export { diode } from './definitions/diode.js'

src/clients/createClient.ts

@@ -350,8 +350,9 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
  * Binds an action function to a `client`, returning a parameter-only version
  * along with any helpers the action exposes. Helpers that need a client
  * (`.call`, `.calls`, `.callWithPeriod`, `.estimateGas`, `.prepare`,
- * `.simulate`) are bound to `client`; pure helpers (`.extractEvent`,
- * `.extractEvents`) are copied as-is. Used by decorators that attach
+ * `.prepareRecipient`, `.simulate`) are bound to `client`; pure helpers
+ * (`.extractEvent`, `.extractEvents`) are copied as-is. Used by decorators
+ * that attach
  * namespaced actions to a Client.
  * @internal
  */
@@ -366,6 +367,7 @@ export function bindActionDecorators(
     'callWithPeriod',
     'estimateGas',
     'prepare',
+    'prepareRecipient',
     'simulate',
   ] as const)
     if (Object.hasOwn(action, key)) {

src/tempo/Decorator.test.ts

@@ -56,6 +56,11 @@ describe('decorator', () => {
     expect(typeof client2.token.transfer.estimateGas).toBe('function')
     expect(typeof client2.token.transfer.simulate).toBe('function')
     expect(typeof client2.zone.encryptedDeposit.prepare).toBe('function')
+    expect(typeof client2.zone.encryptedDeposit.prepareRecipient).toBe(
+      'function',
+    )
+    expect(typeof client2.zone.prepareWithdrawal).toBe('function')
+    expect(typeof client2.zone.waitForDepositProcessed).toBe('function')
   })
 
   test('binds missing action entries', () => {