ox 0.13.2 → 0.14.1

package/tempo/TxEnvelopeTempo.test.ts

@@ -257,6 +257,7 @@ describe('deserialize', () => {
     const keyAuthorization = KeyAuthorization.from({
       expiry: 1234567890,
       address: '0xbe95c3f554e9fc85ec51be69a3d807a0d55bcf2c',
+      chainId: 1n,
       type: 'secp256k1',
       limits: [
         {
@@ -691,6 +692,32 @@ describe('from', () => {
     }
   })
 
+  test('tempo address input for calls.to', () => {
+    const hexAddr = '0x70997970c51812dc3a010c7d01b50e0d17dc79c8'
+    const tempoAddr = 'tempo1qpcfj7tsc5vp9hp6qyx86qd4pcx30hreeqlrsqqr'
+
+    const envelope = TxEnvelopeTempo.from({
+      chainId: 1,
+      calls: [{ to: tempoAddr }],
+      nonce: 0n,
+      nonceKey: 0n,
+    })
+    expect(envelope.calls[0]!.to).toBe(Address.checksum(hexAddr))
+  })
+
+  test('tempo address input for from', () => {
+    const hexAddr = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
+    const tempoAddr = 'tempo1qreel4h9r2kc3ah5ee4t3qnj088llwfzvccugvl7'
+
+    const envelope = TxEnvelopeTempo.from({
+      chainId: 1,
+      calls: [{}],
+      nonce: 0n,
+      from: tempoAddr as any,
+    })
+    expect(envelope.from).toBe(Address.checksum(hexAddr))
+  })
+
   test('options: signature', () => {
     const envelope = TxEnvelopeTempo.from(
       {
@@ -894,6 +921,7 @@ describe('serialize', () => {
   test('keyAuthorization (secp256k1)', () => {
     const keyAuthorization = KeyAuthorization.from({
       address: '0xbe95c3f554e9fc85ec51be69a3d807a0d55bcf2c',
+      chainId: 1n,
       expiry: 1234567890,
       type: 'secp256k1',
       limits: [
@@ -918,7 +946,7 @@ describe('serialize', () => {
 
     const serialized = TxEnvelopeTempo.serialize(transaction)
     expect(serialized).toMatchInlineSnapshot(
-      `"0x76f8a201808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f87bf7808094be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b841635dc2033e60185bb36709c29c75d64ea51dfbd91c32ef4be198e4ceb169fb4d50c2667ac4c771072746acfdcf1f1483336dcca8bd2df47cd83175dbe60f05401b"`,
+      `"0x76f8a201808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f87bf7018094be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b841635dc2033e60185bb36709c29c75d64ea51dfbd91c32ef4be198e4ceb169fb4d50c2667ac4c771072746acfdcf1f1483336dcca8bd2df47cd83175dbe60f05401b"`,
     )
 
     const deserialized = TxEnvelopeTempo.deserialize(serialized)
@@ -928,6 +956,7 @@ describe('serialize', () => {
   test('keyAuthorization (p256)', () => {
     const keyAuthorization = KeyAuthorization.from({
       address: '0xbe95c3f554e9fc85ec51be69a3d807a0d55bcf2c',
+      chainId: 1n,
       expiry: 1234567890,
       type: 'p256',
       limits: [
@@ -959,7 +988,7 @@ describe('serialize', () => {
 
     const serialized = TxEnvelopeTempo.serialize(transaction)
     expect(serialized).toMatchInlineSnapshot(
-      `"0x76f8e301808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f8bcf7800194be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b88201ccbb3485d4726235f13cb15ef394fb7158179fb7b1925eccec0147671090c52e77c3c53373cc1e3b05e7c23f609deb17cea8fe097300c45411237e9fe4166b35ad8ac16e167d6992c3e120d7f17d2376bc1cbcf30c46ba6dd00ce07303e742f511edf6ce1c32de66846f56afa7be1cbd729bc35750b6d0cdcf3ec9d75461aba001"`,
+      `"0x76f8e301808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f8bcf7010194be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b88201ccbb3485d4726235f13cb15ef394fb7158179fb7b1925eccec0147671090c52e77c3c53373cc1e3b05e7c23f609deb17cea8fe097300c45411237e9fe4166b35ad8ac16e167d6992c3e120d7f17d2376bc1cbcf30c46ba6dd00ce07303e742f511edf6ce1c32de66846f56afa7be1cbd729bc35750b6d0cdcf3ec9d75461aba001"`,
     )
 
     const deserialized = TxEnvelopeTempo.deserialize(serialized)
@@ -979,6 +1008,7 @@ describe('serialize', () => {
 
     const keyAuthorization = KeyAuthorization.from({
       address: '0xbe95c3f554e9fc85ec51be69a3d807a0d55bcf2c',
+      chainId: 1n,
       expiry: 1234567890,
       type: 'webAuthn',
       limits: [
@@ -1010,7 +1040,7 @@ describe('serialize', () => {
 
     const serialized = TxEnvelopeTempo.serialize(transaction)
     expect(serialized).toMatchInlineSnapshot(
-      `"0x76f9016501808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f9013df7800294be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b901020249960de5880e8c687434170f6476605b8fe4aeb9a28632c7995cf3ba831d976305000000007b2274797065223a22776562617574686e2e676574222c226368616c6c656e6765223a223371322d3777222c226f726967696e223a22687474703a2f2f6c6f63616c686f7374222c2263726f73734f726967696e223a66616c73657dccbb3485d4726235f13cb15ef394fb7158179fb7b1925eccec0147671090c52e77c3c53373cc1e3b05e7c23f609deb17cea8fe097300c45411237e9fe4166b35ad8ac16e167d6992c3e120d7f17d2376bc1cbcf30c46ba6dd00ce07303e742f511edf6ce1c32de66846f56afa7be1cbd729bc35750b6d0cdcf3ec9d75461aba0"`,
+      `"0x76f9016501808080d8d79470997970c51812dc3a010c7d01b50e0d17dc79c88080c0808080808080c0f9013df7010294be95c3f554e9fc85ec51be69a3d807a0d55bcf2c84499602d2dad99420c000000000000000000000000000000000000183989680b901020249960de5880e8c687434170f6476605b8fe4aeb9a28632c7995cf3ba831d976305000000007b2274797065223a22776562617574686e2e676574222c226368616c6c656e6765223a223371322d3777222c226f726967696e223a22687474703a2f2f6c6f63616c686f7374222c2263726f73734f726967696e223a66616c73657dccbb3485d4726235f13cb15ef394fb7158179fb7b1925eccec0147671090c52e77c3c53373cc1e3b05e7c23f609deb17cea8fe097300c45411237e9fe4166b35ad8ac16e167d6992c3e120d7f17d2376bc1cbcf30c46ba6dd00ce07303e742f511edf6ce1c32de66846f56afa7be1cbd729bc35750b6d0cdcf3ec9d75461aba0"`,
     )
 
     // Verify roundtrip
@@ -1378,6 +1408,29 @@ describe('getSignPayload', () => {
       `"0xe1222a45806457acbe3a13940aae4c34f3180659fa16613b5a45dc183adae07c"`,
     )
   })
+
+  test('tempo address input for from', () => {
+    const hexAddr = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
+    const tempoAddr = 'tempo1qreel4h9r2kc3ah5ee4t3qnj088llwfzvccugvl7'
+
+    const transaction = TxEnvelopeTempo.from({
+      chainId: 1,
+      calls: [
+        {
+          to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+        },
+      ],
+      nonce: 0n,
+    })
+
+    const hashHex = TxEnvelopeTempo.getSignPayload(transaction, {
+      from: hexAddr,
+    })
+    const hashTempo = TxEnvelopeTempo.getSignPayload(transaction, {
+      from: tempoAddr,
+    })
+    expect(hashTempo).toBe(hashHex)
+  })
 })
 
 describe('getFeePayerSignPayload', () => {
@@ -1400,6 +1453,29 @@ describe('getFeePayerSignPayload', () => {
     )
   })
 
+  test('tempo address input for sender', () => {
+    const hexAddr = '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266'
+    const tempoAddr = 'tempo1qreel4h9r2kc3ah5ee4t3qnj088llwfzvccugvl7'
+
+    const transaction = TxEnvelopeTempo.from({
+      chainId: 1,
+      calls: [
+        {
+          to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+        },
+      ],
+      nonce: 0n,
+    })
+
+    const hashHex = TxEnvelopeTempo.getFeePayerSignPayload(transaction, {
+      sender: hexAddr,
+    })
+    const hashTempo = TxEnvelopeTempo.getFeePayerSignPayload(transaction, {
+      sender: tempoAddr,
+    })
+    expect(hashTempo).toBe(hashHex)
+  })
+
   test('with feeToken', () => {
     const transaction = TxEnvelopeTempo.from({
       chainId: 1,

package/tempo/TxEnvelopeTempo.ts

@@ -17,6 +17,7 @@ import * as TransactionEnvelope from '../core/TxEnvelope.js'
 import * as AuthorizationTempo from './AuthorizationTempo.js'
 import * as KeyAuthorization from './KeyAuthorization.js'
 import * as SignatureEnvelope from './SignatureEnvelope.js'
+import * as TempoAddress from './TempoAddress.js'
 import * as TokenId from './TokenId.js'
 
 /**
@@ -26,11 +27,11 @@ import * as TokenId from './TokenId.js'
  *
  * [Batch Calls](https://docs.tempo.xyz/protocol/transactions#batch-calls)
  */
-export type Call<bigintType = bigint> = {
+export type Call<bigintType = bigint, addressType = Address.Address> = {
   /** Call data. */
   data?: Hex.Hex | undefined
   /** The target address or contract creation. */
-  to?: Address.Address | undefined
+  to?: addressType | undefined
   /** Value to send (in wei). */
   value?: bigintType | undefined
 }
@@ -77,11 +78,11 @@ export type TxEnvelopeTempo<
       | AuthorizationTempo.ListSigned<bigintType, numberType>
       | undefined
     /** Array of calls to execute. */
-    calls: readonly Call<bigintType>[]
+    calls: readonly Call<bigintType, TempoAddress.Address>[]
     /** EIP-155 Chain ID. */
     chainId: numberType
     /** Sender of the transaction. */
-    from?: Address.Address | undefined
+    from?: TempoAddress.Address | undefined
     /** Gas provided for transaction execution */
     gas?: bigintType | undefined
     /** Fee payer signature. */
@@ -154,7 +155,7 @@ export type Type = typeof type
  * import { TxEnvelopeTempo } from 'ox/tempo'
  *
  * TxEnvelopeTempo.assert({
- *   calls: [{ to: '0x0000000000000000000000000000000000000000', value: 0n }],
+ *   calls: [{ to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme', value: 0n }],
  *   chainId: 1,
  *   maxFeePerGas: 1000000000n,
  * })
@@ -413,7 +414,7 @@ export declare namespace deserialize {
  *   chainId: 1, // [!code focus]
  *   calls: [{ // [!code focus]
  *     data: '0xdeadbeef', // [!code focus]
- *     to: '0x0000000000000000000000000000000000000000', // [!code focus]
+ *     to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme', // [!code focus]
  *   }], // [!code focus]
  *   maxFeePerGas: Value.fromGwei('10'), // [!code focus]
  *   maxPriorityFeePerGas: Value.fromGwei('1'), // [!code focus]
@@ -434,7 +435,7 @@ export declare namespace deserialize {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x0000000000000000000000000000000000000000',
+ *     to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme',
  *   }],
  *   maxFeePerGas: Value.fromGwei('10'),
  *   maxPriorityFeePerGas: Value.fromGwei('1'),
@@ -497,6 +498,19 @@ export function from<
     typeof envelope === 'string' ? deserialize(envelope) : envelope
   ) as TxEnvelopeTempo
 
+  // Resolve TempoAddress inputs to hex addresses.
+  if (envelope_.from)
+    envelope_.from = TempoAddress.resolve(
+      envelope_.from as TempoAddress.Address,
+    )
+  if (envelope_.calls)
+    envelope_.calls = (envelope_.calls as readonly Call[]).map((call) => ({
+      ...call,
+      ...(call.to
+        ? { to: TempoAddress.resolve(call.to as TempoAddress.Address) }
+        : {}),
+    })) as readonly Call[]
+
   assert(envelope_)
 
   return {
@@ -559,7 +573,7 @@ export declare namespace from {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x0000000000000000000000000000000000000000',
+ *     to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme',
  *   }],
  *   maxFeePerGas: Value.fromGwei('10'),
  * })
@@ -581,7 +595,7 @@ export declare namespace from {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x0000000000000000000000000000000000000000',
+ *     to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme',
  *   }],
  *   maxFeePerGas: Value.fromGwei('10'),
  * })
@@ -632,7 +646,7 @@ export function serialize(
 
   // Encode calls as RLP list of [to, value, data] tuples
   const callsTupleList = calls.map((call) => [
-    call.to ?? '0x',
+    call.to ? TempoAddress.resolve(call.to) : '0x',
     call.value ? Hex.fromNumber(call.value) : '0x',
     call.data ?? '0x',
   ])
@@ -766,7 +780,7 @@ export declare namespace serialize {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     to: 'tempo1qpcfj7tsc5vp9hp6qyx86qd4pcx30hreeqlrsqqr',
  *   }],
  *   nonce: 0n,
  *   maxFeePerGas: 1000000000n,
@@ -779,16 +793,69 @@ export declare namespace serialize {
  * const signature = Secp256k1.sign({ payload, privateKey: '0x...' })
  * ```
  *
+ * @example
+ * ### Access Keys
+ *
+ * When signing as an access key on behalf of a root account, pass the
+ * `from` option with the root account address. This computes
+ * `keccak256(0x04 || sigHash || from)` which binds the signature to the
+ * specific user account (V2 keychain format).
+ *
+ * ```ts twoslash
+ * // @noErrors
+ * import { Secp256k1 } from 'ox'
+ * import { TxEnvelopeTempo, SignatureEnvelope } from 'ox/tempo'
+ *
+ * const envelope = TxEnvelopeTempo.from({
+ *   chainId: 1,
+ *   calls: [{
+ *     data: '0xdeadbeef',
+ *     to: 'tempo1qpcfj7tsc5vp9hp6qyx86qd4pcx30hreeqlrsqqr',
+ *   }],
+ *   nonce: 0n,
+ *   maxFeePerGas: 1000000000n,
+ *   gas: 21000n,
+ * })
+ *
+ * const payload = TxEnvelopeTempo.getSignPayload(envelope, { from: '0x...' }) // [!code focus]
+ *
+ * const signature = Secp256k1.sign({ payload, privateKey: '0x...' })
+ *
+ * const signed = TxEnvelopeTempo.serialize(envelope, {
+ *   signature: SignatureEnvelope.from({
+ *     userAddress: from,
+ *     inner: SignatureEnvelope.from(signature),
+ *   }),
+ * })
+ * ```
+ *
  * @param envelope - The transaction envelope to get the sign payload for.
+ * @param options - Options.
  * @returns The sign payload.
  */
 export function getSignPayload(
   envelope: TxEnvelopeTempo,
+  options: getSignPayload.Options = {},
 ): getSignPayload.ReturnValue {
-  return hash(envelope, { presign: true })
+  const sigHash = hash(envelope, { presign: true })
+  if (options.from)
+    return Hash.keccak256(
+      Hex.concat('0x04', sigHash, TempoAddress.resolve(options.from)),
+    )
+  return sigHash
 }
 
 export declare namespace getSignPayload {
+  type Options = {
+    /**
+     * The root account address for access key signing.
+     *
+     * When provided, computes `keccak256(0x04 || sigHash || from)` instead of
+     * the raw `sigHash`, binding the access key signature to the specific user account.
+     */
+    from?: TempoAddress.Address | undefined
+  }
+
   type ReturnValue = Hex.Hex
 
   type ErrorType = hash.ErrorType | Errors.GlobalErrorType
@@ -807,7 +874,7 @@ export declare namespace getSignPayload {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     to: 'tempo1qpcfj7tsc5vp9hp6qyx86qd4pcx30hreeqlrsqqr',
  *   }],
  *   nonce: 0n,
  *   maxFeePerGas: 1000000000n,
@@ -881,7 +948,7 @@ export declare namespace hash {
  *   chainId: 1,
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     to: 'tempo1qpcfj7tsc5vp9hp6qyx86qd4pcx30hreeqlrsqqr',
  *   }],
  *   nonce: 0n,
  *   maxFeePerGas: 1000000000n,
@@ -889,7 +956,7 @@ export declare namespace hash {
  * })
  *
  * const payload = TxEnvelopeTempo.getFeePayerSignPayload(envelope, {
- *   sender: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
+ *   sender: 'tempo1qrvd56ljd9j2l8t7ak0q8ef5zhfh42tqg5kwwrau'
  * }) // [!code focus]
  * // @log: '0x...'
  *
@@ -904,7 +971,7 @@ export function getFeePayerSignPayload(
   envelope: TxEnvelopeTempo,
   options: getFeePayerSignPayload.Options,
 ): getFeePayerSignPayload.ReturnValue {
-  const { sender } = options
+  const sender = TempoAddress.resolve(options.sender)
   const serialized = serialize(
     { ...envelope, signature: undefined },
     {
@@ -920,7 +987,7 @@ export declare namespace getFeePayerSignPayload {
     /**
      * Sender address to cover the fee of.
      */
-    sender: Address.Address
+    sender: TempoAddress.Address
   }
 
   type ReturnValue = Hex.Hex
@@ -938,7 +1005,7 @@ export declare namespace getFeePayerSignPayload {
  * const valid = TxEnvelopeTempo.validate({
  *   calls: [{
  *     data: '0xdeadbeef',
- *     to: '0x0000000000000000000000000000000000000000',
+ *     to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme',
  *   }],
  *   chainId: 1,
  *   maxFeePerGas: 1000000000n,
@@ -990,7 +1057,7 @@ export class CallsEmptyError extends Errors.BaseError {
  * import { TxEnvelopeTempo } from 'ox/tempo'
  *
  * TxEnvelopeTempo.assert({
- *   calls: [{ to: '0x0000000000000000000000000000000000000000' }],
+ *   calls: [{ to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme' }],
  *   chainId: 1,
  *   validBefore: 100,
  *   validAfter: 200,

package/tempo/e2e.test.ts

@@ -806,6 +806,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chain.id),
       type: 'secp256k1',
     })
 
@@ -839,7 +840,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: access.privateKey,
     })
 
@@ -978,7 +981,9 @@ describe('behavior: keyAuthorization', () => {
       })
 
       const signature = Secp256k1.sign({
-        payload: TxEnvelopeTempo.getSignPayload(transaction),
+        payload: TxEnvelopeTempo.getSignPayload(transaction, {
+          from: root.address,
+        }),
         privateKey: access.privateKey,
       })
 
@@ -1012,6 +1017,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chainId),
       type: 'p256',
     })
 
@@ -1045,7 +1051,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = P256.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: access.privateKey,
     })
 
@@ -1190,7 +1198,9 @@ describe('behavior: keyAuthorization', () => {
       })
 
       const signature = P256.sign({
-        payload: TxEnvelopeTempo.getSignPayload(transaction),
+        payload: TxEnvelopeTempo.getSignPayload(transaction, {
+          from: root.address,
+        }),
         privateKey: access.privateKey,
       })
 
@@ -1227,6 +1237,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chainId),
       type: 'p256',
     })
 
@@ -1260,7 +1271,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = await WebCryptoP256.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: keyPair.privateKey,
     })
 
@@ -1366,7 +1379,9 @@ describe('behavior: keyAuthorization', () => {
       })
 
       const signature = await WebCryptoP256.sign({
-        payload: TxEnvelopeTempo.getSignPayload(transaction),
+        payload: TxEnvelopeTempo.getSignPayload(transaction, {
+          from: root.address,
+        }),
         privateKey: keyPair.privateKey,
       })
 
@@ -1404,6 +1419,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chainId),
       type: 'p256',
       expiry: Math.floor(Date.now() / 1000) + 60 * 60,
       limits: [
@@ -1444,7 +1460,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = P256.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: access.privateKey,
     })
 
@@ -1498,6 +1516,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chainId),
       type: 'secp256k1',
       limits: [
         {
@@ -1537,7 +1556,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: access.privateKey,
     })
 
@@ -1586,6 +1607,7 @@ describe('behavior: keyAuthorization', () => {
 
     const keyAuth = KeyAuthorization.from({
       address: access.address,
+      chainId: BigInt(chainId),
       type: 'secp256k1',
       expiry: Math.floor(Date.now() / 1000) + 60 * 60,
     })
@@ -1620,7 +1642,9 @@ describe('behavior: keyAuthorization', () => {
     })
 
     const signature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
+      payload: TxEnvelopeTempo.getSignPayload(transaction, {
+        from: root.address,
+      }),
       privateKey: access.privateKey,
     })
 

package/tempo/index.ts

@@ -17,7 +17,7 @@ export type {}
  * import { AuthorizationTempo } from 'ox/tempo'
  *
  * const authorization = AuthorizationTempo.from({
- *   address: '0xbe95c3f554e9fc85ec51be69a3d807a0d55bcf2c',
+ *   address: 'tempo1qzlftsl42n5lep0v2xlxng7cq7sd2k709sxlwnsu',
  *   chainId: 1,
  *   nonce: 40n,
  * })
@@ -55,10 +55,11 @@ export * as AuthorizationTempo from './AuthorizationTempo.js'
  *
  * const authorization = KeyAuthorization.from({
  *   address,
+ *   chainId: 4217n,
  *   expiry: 1234567890,
  *   type: 'p256',
  *   limits: [{
- *     token: '0x20c0000000000000000000000000000000000001',
+ *     token: 'tempo1qqsvqqqqqqqqqqqqqqqqqqqqqqqqqqqqqyr9xgnd',
  *     limit: Value.from('10', 6),
  *   }],
  * })
@@ -120,6 +121,7 @@ export * as PoolId from './PoolId.js'
  * @category Reference
  */
 export * as SignatureEnvelope from './SignatureEnvelope.js'
+
 /**
  * Tempo address encoding/decoding utilities for human-readable addresses.
  *
@@ -132,15 +134,16 @@ export * as SignatureEnvelope from './SignatureEnvelope.js'
  * import { TempoAddress } from 'ox/tempo'
  *
  * const encoded = TempoAddress.format('0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28')
- * // @log: 'tempo1wskntnrxxnq9x2f95wuyf0y7wk2l90fg8zd8djs'
+ * // @log: 'tempo1wskntnrxxnq9x2f95wuyf0y7wk2l90fg0hlz9j'
  *
  * const { address, zoneId } = TempoAddress.parse(encoded)
- * // @log: { address: '0x742d35CC6634c0532925a3B844bc9e7595F2Bd28' }
+ * // @log: { address: '0x742d35CC6634c0532925a3B844bc9e7595F2Bd28', zoneId: undefined }
  * ```
  *
  * @category Reference
  */
 export * as TempoAddress from './TempoAddress.js'
+
 /**
  * Tick-based pricing utilities for DEX price conversions.
  *
@@ -161,6 +164,7 @@ export * as TempoAddress from './TempoAddress.js'
  * @category Reference
  */
 export * as Tick from './Tick.js'
+
 /**
  * TIP-20 token ID utilities for converting between token IDs and addresses.
  *
@@ -176,12 +180,13 @@ export * as Tick from './Tick.js'
  *
  * const tokenId = TokenId.from(1n)
  * const address = TokenId.toAddress(1n)
- * // '0x20c0000000000000000000000000000000000001'
+ * // 'tempo1qqsvqqqqqqqqqqqqqqqqqqqqqqqqqqqqqyr9xgnd'
  * ```
  *
  * @category Reference
  */
 export * as TokenId from './TokenId.js'
+
 /**
  * Token role utilities for serializing role identifiers to keccak256 hashes.
  *
@@ -227,7 +232,7 @@ export * as TokenRole from './TokenRole.js'
  *       value: '0x9b6e64a8ec60000',
  *     },
  *   ],
- *   feeToken: '0x20c0000000000000000000000000000000000000',
+ *   feeToken: 'tempo1qqsvqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqv0ywuh',
  *   transactionIndex: '0x2',
  *   from: '0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6',
  *   value: '0x9b6e64a8ec60000',
@@ -266,7 +271,7 @@ export * as Transaction from './Transaction.js'
  * const receipt = TransactionReceipt.fromRpc({
  *   status: '0x1',
  *   feePayer: '0x...',
- *   feeToken: '0x20c0000000000000000000000000000000000001',
+ *   feeToken: 'tempo1qqsvqqqqqqqqqqqqqqqqqqqqqqqqqqqqqyr9xgnd',
  *   // ... other fields
  * } as any)
  * ```
@@ -287,8 +292,8 @@ export * as TransactionReceipt from './TransactionReceipt.js'
  * import { TransactionRequest } from 'ox/tempo'
  *
  * const request = TransactionRequest.toRpc({
- *   calls: [{ to: '0xcafebabecafebabecafebabecafebabecafebabe', data: '0xdeadbeef' }],
- *   feeToken: '0x20c0000000000000000000000000000000000000',
+ *   calls: [{ to: 'tempo1qr90aw47etlt40k2l6atajh7h2lv4l46hcx5uwlp', data: '0xdeadbeef' }],
+ *   feeToken: 'tempo1qqsvqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqv0ywuh',
  * })
  * ```
  *
@@ -310,7 +315,7 @@ export * as TransactionRequest from './TransactionRequest.js'
  *
  * const envelope = TxEnvelopeTempo.from({
  *   chainId: 1,
- *   calls: [{ to: '0x0000000000000000000000000000000000000000', data: '0xdeadbeef' }],
+ *   calls: [{ to: 'tempo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj97hme', data: '0xdeadbeef' }],
  *   maxFeePerGas: Value.fromGwei('10'),
  * })
  *

package/version.ts

@@ -1,2 +1,2 @@
 /** @internal */
-export const version = '0.13.2'
+export const version = '0.14.1'