ox 1.7.1 → 1.7.4

package/src/tempo/Transaction.test.ts

@@ -1,6 +1,9 @@
 import { Transaction } from 'ox/tempo'
 import { describe, expect, test } from 'vp/test'
 
+const multisigRpcSignature =
+  '0xf897949dba7f426b711d4893c11611eacf7cc334e7146bf83ba000000000000000000000000000000000000000000000000000000000000000008001d7d6947e5f4552091a69125d5dfcb7b8c2659029395bdf01f843b841869437e01f64bebeb78a8a6b30bfd3a993819c8cad82c807515d9b9e9b36f98535dfaa5eebc597715d05f6ce4927747f14fa4cd2acc717fdcd3877146437f8f41b' as const
+
 describe('fromRpc', () => {
   test('default', () => {
     const transaction = Transaction.fromRpc({
@@ -512,3 +515,61 @@ describe('toRpc', () => {
     `)
   })
 })
+
+describe('roundtrip', () => {
+  test('behavior: multisig RPC signature', () => {
+    const rpc = {
+      accessList: [],
+      blockHash:
+        '0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b',
+      blockNumber: '0x12f296f',
+      calls: [],
+      chainId: '0x1',
+      feeToken: '0x20c0000000000000000000000000000000000000',
+      from: '0x9dba7f426b711d4893c11611eacf7cc334e7146b',
+      gas: '0x43f5d',
+      hash: '0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0',
+      maxFeePerGas: '0x2',
+      maxPriorityFeePerGas: '0x1',
+      nonce: '0x357',
+      signature: multisigRpcSignature,
+      transactionIndex: '0x2',
+      type: '0x76',
+    } as const satisfies Transaction.TempoRpc
+    const transaction = Transaction.fromRpc(rpc)
+
+    expect({
+      rpc: Transaction.toRpc(transaction).signature,
+      signature: transaction.signature,
+    }).toMatchInlineSnapshot(`
+      {
+        "rpc": "0xf897949dba7f426b711d4893c11611eacf7cc334e7146bf83ba000000000000000000000000000000000000000000000000000000000000000008001d7d6947e5f4552091a69125d5dfcb7b8c2659029395bdf01f843b841869437e01f64bebeb78a8a6b30bfd3a993819c8cad82c807515d9b9e9b36f98535dfaa5eebc597715d05f6ce4927747f14fa4cd2acc717fdcd3877146437f8f41b",
+        "signature": {
+          "account": "0x9dba7f426b711d4893c11611eacf7cc334e7146b",
+          "config": {
+            "owners": [
+              {
+                "owner": "0x7e5f4552091a69125d5dfcb7b8c2659029395bdf",
+                "weight": 1,
+              },
+            ],
+            "salt": "0x0000000000000000000000000000000000000000000000000000000000000000",
+            "threshold": 1,
+            "version": 0n,
+          },
+          "signatures": [
+            {
+              "signature": {
+                "r": "0x869437e01f64bebeb78a8a6b30bfd3a993819c8cad82c807515d9b9e9b36f985",
+                "s": "0x35dfaa5eebc597715d05f6ce4927747f14fa4cd2acc717fdcd3877146437f8f4",
+                "yParity": 0,
+              },
+              "type": "secp256k1",
+            },
+          ],
+          "type": "multisig",
+        },
+      }
+    `)
+  })
+})

package/src/tempo/TransactionRequest.test-d.ts

@@ -1,6 +1,7 @@
 import type * as ox_TransactionRequest from '../core/TransactionRequest.js'
 import * as Signature from '../core/Signature.js'
 import { describe, expectTypeOf, test } from 'vp/test'
+import * as MultisigSimulation from './MultisigSimulation.js'
 import * as SignatureEnvelope from './SignatureEnvelope.js'
 import * as TransactionRequest from './TransactionRequest.js'
 import * as TxEnvelopeTempo from './TxEnvelopeTempo.js'
@@ -47,6 +48,15 @@ describe('TransactionRequest type', () => {
       Signature.Rpc | null | undefined
     >()
   })
+
+  test('carries domain and RPC multisig simulations', () => {
+    expectTypeOf<
+      TransactionRequest.TransactionRequest['multisigSimulation']
+    >().toEqualTypeOf<MultisigSimulation.Spec | undefined>()
+    expectTypeOf<TransactionRequest.Rpc['multisigSimulation']>().toEqualTypeOf<
+      MultisigSimulation.Rpc | undefined
+    >()
+  })
 })
 
 describe('toEnvelope', () => {
@@ -77,6 +87,7 @@ describe('toEnvelope', () => {
       keyType: 'secp256k1',
       maxFeePerGas: 1n,
       maxPriorityFeePerGas: 1n,
+      multisigSimulation: undefined,
       nonce: 0n,
       nonceKey: 'random',
       signature: undefined,

package/src/tempo/TransactionRequest.test.ts

@@ -1,6 +1,77 @@
-import { TransactionRequest } from 'ox/tempo'
+import {
+  MultisigConfig,
+  type MultisigSimulation,
+  TransactionRequest,
+} from 'ox/tempo'
 import { describe, expect, test } from 'vp/test'
 
+const multisigSimulationRpc = {
+  account: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+  approvals: [
+    {
+      keyType: 'secp256k1',
+      owner: '0x1111111111111111111111111111111111111111',
+      type: 'primitive',
+    },
+    {
+      spec: {
+        account: '0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
+        approvals: [
+          {
+            keyData: '0x0578',
+            keyType: 'webAuthn',
+            owner: '0x2222222222222222222222222222222222222222',
+          },
+        ],
+        config:
+          '0xf83ba022222222222222222222222222222222222222222222222222222222222222220101d7d694222222222222222222222222222222222222222201',
+      },
+      type: 'multisig',
+    },
+  ],
+  config:
+    '0xf852a011111111111111111111111111111111111111111111111111111111111111118002eed694111111111111111111111111111111111111111101d694bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb01',
+} as const satisfies MultisigSimulation.Rpc
+
+const multisigSimulation = {
+  account: multisigSimulationRpc.account,
+  approvals: [
+    multisigSimulationRpc.approvals[0],
+    {
+      spec: {
+        account: multisigSimulationRpc.approvals[1].spec.account,
+        approvals: multisigSimulationRpc.approvals[1].spec.approvals,
+        config: MultisigConfig.from({
+          owners: [
+            {
+              owner: '0x2222222222222222222222222222222222222222',
+              weight: 1,
+            },
+          ],
+          salt: `0x${'22'.repeat(32)}`,
+          threshold: 1,
+          version: 1n,
+        }),
+      },
+      type: 'multisig',
+    },
+  ],
+  config: MultisigConfig.from({
+    owners: [
+      {
+        owner: '0x1111111111111111111111111111111111111111',
+        weight: 1,
+      },
+      {
+        owner: '0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
+        weight: 1,
+      },
+    ],
+    salt: `0x${'11'.repeat(32)}`,
+    threshold: 2,
+  }),
+} as const satisfies MultisigSimulation.Spec
+
 describe('fromRpc', () => {
   test('default', () => {
     const request = TransactionRequest.fromRpc({
@@ -69,7 +140,7 @@ describe('fromRpc', () => {
     expect(request.nonceKey).toBe(255n)
   })
 
-  test('behavior: gas-model hints and capabilities pass through', () => {
+  test('behavior: capabilities and key hints pass through', () => {
     const request = TransactionRequest.fromRpc({
       calls: [{ to: '0xcafebabecafebabecafebabecafebabecafebabe' }],
       capabilities: { balanceDiffs: true },
@@ -77,30 +148,86 @@ describe('fromRpc', () => {
       keyData: '0x0578',
       keyId: '0xcccccccccccccccccccccccccccccccccccccccc',
       keyType: 'webAuthn',
-      multisigInit: {
-        salt: '0x0000000000000000000000000000000000000000000000000000000000000000',
-        threshold: 2,
-        owners: [
-          {
-            owner: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
-            weight: 1,
-          },
+      type: '0x76',
+    })
+    expect(request).toMatchInlineSnapshot(`
+      {
+        "calls": [
           {
-            owner: '0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
-            weight: 1,
+            "data": undefined,
+            "to": "0xcafebabecafebabecafebabecafebabecafebabe",
           },
         ],
-      },
-      multisigSignatureCount: 2,
+        "capabilities": {
+          "balanceDiffs": true,
+        },
+        "feePayer": true,
+        "keyData": "0x0578",
+        "keyId": "0xcccccccccccccccccccccccccccccccccccccccc",
+        "keyType": "webAuthn",
+        "type": "tempo",
+      }
+    `)
+  })
+
+  test('behavior: multisig simulation', () => {
+    const request = TransactionRequest.fromRpc({
+      from: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+      multisigSimulation: multisigSimulationRpc,
       type: '0x76',
     })
-    expect(request.capabilities).toEqual({ balanceDiffs: true })
-    expect(request.feePayer).toBe(true)
-    expect(request.keyData).toBe('0x0578')
-    expect(request.keyId).toBe('0xcccccccccccccccccccccccccccccccccccccccc')
-    expect(request.keyType).toBe('webAuthn')
-    expect(request.multisigInit).toMatchObject({ threshold: 2 })
-    expect(request.multisigSignatureCount).toBe(2)
+
+    expect(request.multisigSimulation).toMatchInlineSnapshot(`
+      {
+        "account": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "approvals": [
+          {
+            "keyType": "secp256k1",
+            "owner": "0x1111111111111111111111111111111111111111",
+            "type": "primitive",
+          },
+          {
+            "spec": {
+              "account": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+              "approvals": [
+                {
+                  "keyData": "0x0578",
+                  "keyType": "webAuthn",
+                  "owner": "0x2222222222222222222222222222222222222222",
+                },
+              ],
+              "config": {
+                "owners": [
+                  {
+                    "owner": "0x2222222222222222222222222222222222222222",
+                    "weight": 1,
+                  },
+                ],
+                "salt": "0x2222222222222222222222222222222222222222222222222222222222222222",
+                "threshold": 1,
+                "version": 1n,
+              },
+            },
+            "type": "multisig",
+          },
+        ],
+        "config": {
+          "owners": [
+            {
+              "owner": "0x1111111111111111111111111111111111111111",
+              "weight": 1,
+            },
+            {
+              "owner": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+              "weight": 1,
+            },
+          ],
+          "salt": "0x1111111111111111111111111111111111111111111111111111111111111111",
+          "threshold": 2,
+          "version": 0n,
+        },
+      }
+    `)
   })
 
   test('behavior: empty', () => {
@@ -157,7 +284,7 @@ describe('toRpc', () => {
     `)
   })
 
-  test('behavior: gas-model hints and capabilities are carried', () => {
+  test('behavior: capabilities and key hints are carried', () => {
     const request = TransactionRequest.toRpc({
       calls: [{ to: '0xcafebabecafebabecafebabecafebabecafebabe' }],
       capabilities: { balanceDiffs: true },
@@ -165,30 +292,72 @@ describe('toRpc', () => {
       keyData: '0x0578',
       keyId: '0xcccccccccccccccccccccccccccccccccccccccc',
       keyType: 'webAuthn',
-      multisigInit: {
-        salt: '0x0000000000000000000000000000000000000000000000000000000000000000',
-        threshold: 2,
-        owners: [
+    })
+    expect(request).toMatchInlineSnapshot(`
+      {
+        "calls": [
           {
-            owner: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
-            weight: 1,
+            "data": "0x",
+            "to": "0xcafebabecafebabecafebabecafebabecafebabe",
+            "value": "0x",
           },
+        ],
+        "capabilities": {
+          "balanceDiffs": true,
+        },
+        "feePayer": false,
+        "keyData": "0x0578",
+        "keyId": "0xcccccccccccccccccccccccccccccccccccccccc",
+        "keyType": "webAuthn",
+        "type": "0x76",
+      }
+    `)
+  })
+
+  test('behavior: multisig simulation', () => {
+    const request = TransactionRequest.toRpc({
+      from: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+      multisigSimulation,
+    })
+
+    expect(request).toMatchInlineSnapshot(`
+      {
+        "calls": [
           {
-            owner: '0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
-            weight: 1,
+            "data": "0x",
+            "to": "0x0000000000000000000000000000000000000000",
+            "value": "0x",
           },
         ],
-      },
-      multisigSignatureCount: 2,
-    })
-    expect(request.capabilities).toEqual({ balanceDiffs: true })
-    expect(request.feePayer).toBe(false)
-    expect(request.keyData).toBe('0x0578')
-    expect(request.keyId).toBe('0xcccccccccccccccccccccccccccccccccccccccc')
-    expect(request.keyType).toBe('webAuthn')
-    expect(request.multisigInit).toMatchObject({ threshold: 2 })
-    expect(request.multisigSignatureCount).toBe(2)
-    expect(request.type).toBe('0x76')
+        "from": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "multisigSimulation": {
+          "account": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "approvals": [
+            {
+              "keyType": "secp256k1",
+              "owner": "0x1111111111111111111111111111111111111111",
+              "type": "primitive",
+            },
+            {
+              "spec": {
+                "account": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+                "approvals": [
+                  {
+                    "keyData": "0x0578",
+                    "keyType": "webAuthn",
+                    "owner": "0x2222222222222222222222222222222222222222",
+                  },
+                ],
+                "config": "0xf83ba022222222222222222222222222222222222222222222222222222222222222220101d7d694222222222222222222222222222222222222222201",
+              },
+              "type": "multisig",
+            },
+          ],
+          "config": "0xf852a011111111111111111111111111111111111111111111111111111111111111118002eed694111111111111111111111111111111111111111101d694bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb01",
+        },
+        "type": "0x76",
+      }
+    `)
   })
 
   test('behavior: key data longer than 4 bytes shims into a length hint', () => {
@@ -288,6 +457,7 @@ describe('roundtrip', () => {
       nonceKey: 255n,
       gas: 100000n,
       maxFeePerGas: 1000000000n,
+      multisigSimulation,
     }
 
     const rpc = TransactionRequest.toRpc(original)
@@ -308,6 +478,7 @@ describe('roundtrip', () => {
     expect(converted.nonceKey).toBe(original.nonceKey)
     expect(converted.gas).toBe(original.gas)
     expect(converted.maxFeePerGas).toBe(original.maxFeePerGas)
+    expect(converted.multisigSimulation).toEqual(original.multisigSimulation)
     expect(converted.type).toBe('tempo')
   })
 
@@ -325,6 +496,7 @@ describe('roundtrip', () => {
       validAfter: '0x32',
       nonceKey: '0xff',
       gas: '0x186a0',
+      multisigSimulation: multisigSimulationRpc,
       type: '0x76',
     }
 
@@ -337,6 +509,7 @@ describe('roundtrip', () => {
     expect(rpc.validAfter).toBe(original.validAfter)
     expect(rpc.nonceKey).toBe(original.nonceKey)
     expect(rpc.gas).toBe(original.gas)
+    expect(rpc.multisigSimulation).toEqual(original.multisigSimulation)
     expect(rpc.type).toBe('0x76')
   })
 })

package/src/tempo/TransactionRequest.ts

@@ -7,7 +7,7 @@ import * as Signature from '../core/Signature.js'
 import * as ox_TransactionRequest from '../core/TransactionRequest.js'
 import * as AuthorizationTempo from './AuthorizationTempo.js'
 import * as KeyAuthorization from './KeyAuthorization.js'
-import type * as MultisigConfig from './MultisigConfig.js'
+import * as MultisigSimulation from './MultisigSimulation.js'
 import * as SignatureEnvelope from './SignatureEnvelope.js'
 import * as Transaction from './Transaction.js'
 import * as TxEnvelopeTempo from './TxEnvelopeTempo.js'
@@ -15,13 +15,6 @@ import type { Call } from './TxEnvelopeTempo.js'
 
 type KeyType = 'secp256k1' | 'p256' | 'webAuthn'
 
-/**
- * Bootstrap multisig config hint for node-side gas modeling (TIP-1061).
- * The node prices multisig gas from it during simulation, and ignores it
- * for registered senders.
- */
-export type MultisigInit = Compute<MultisigConfig.Config & { salt: Hex.Hex }>
-
 /**
  * A Transaction Request that is generic to all transaction types.
  *
@@ -44,19 +37,18 @@ export type TransactionRequest<
       | undefined
     calls?: readonly Call<bigintType>[] | undefined
     capabilities?: Record<string, unknown> | undefined
+    feePayer?: boolean | undefined
     feePayerSignature?: Signature.Signature<true, numberType> | null | undefined
+    feeToken?: Address.Address | undefined
     keyAuthorization?: KeyAuthorization.KeyAuthorization<true> | undefined
     keyData?: Hex.Hex | undefined
     keyId?: Address.Address | undefined
     keyType?: KeyType | undefined
-    feePayer?: boolean | undefined
-    feeToken?: Address.Address | undefined
-    multisigInit?: MultisigInit | undefined
-    multisigSignatureCount?: number | undefined
+    multisigSimulation?: MultisigSimulation.Spec | undefined
     nonceKey?: 'random' | bigintType | undefined
     signature?: SignatureEnvelope.SignatureEnvelope<numberType> | undefined
-    validBefore?: numberType | undefined
     validAfter?: numberType | undefined
+    validBefore?: numberType | undefined
   }
 >
 
@@ -67,12 +59,14 @@ export type Rpc = Omit<
   | 'feePayerSignature'
   | 'feeToken'
   | 'keyAuthorization'
+  | 'multisigSimulation'
   | 'signature'
 > & {
   authorizationList?: AuthorizationTempo.ListRpc | undefined
   feePayerSignature?: Signature.Rpc | null | undefined
   feeToken?: Hex.Hex | undefined
   keyAuthorization?: KeyAuthorization.Rpc | undefined
+  multisigSimulation?: MultisigSimulation.Rpc | undefined
   nonceKey?: Hex.Hex | undefined
   signature?: SignatureEnvelope.SignatureEnvelopeRpc | undefined
 }
@@ -100,7 +94,7 @@ export type Rpc = Omit<
  * @returns A transaction request.
  */
 export function fromRpc(request: Rpc): TransactionRequest {
-  const { authorizationList: _, ...rest } = request
+  const { authorizationList: _, multisigSimulation: __, ...rest } = request
   const request_ = ox_TransactionRequest.fromRpc(
     rest as any,
   ) as TransactionRequest
@@ -135,6 +129,10 @@ export function fromRpc(request: Rpc): TransactionRequest {
     request_.keyAuthorization = KeyAuthorization.fromRpc(
       request.keyAuthorization,
     )
+  if (request.multisigSimulation)
+    request_.multisigSimulation = MultisigSimulation.fromRpc(
+      request.multisigSimulation,
+    )
   if (typeof request.validBefore !== 'undefined')
     request_.validBefore = Hex.toNumber(request.validBefore as Hex.Hex)
   if (typeof request.validAfter !== 'undefined')
@@ -150,6 +148,7 @@ export declare namespace fromRpc {
     | AuthorizationTempo.fromRpcList.ErrorType
     | Hex.toNumber.ErrorType
     | Hex.toBigInt.ErrorType
+    | MultisigSimulation.fromRpc.ErrorType
     | Errors.GlobalErrorType
 }
 
@@ -223,8 +222,7 @@ export function toRpc(request: toRpc.Input): Rpc {
     typeof request.keyData !== 'undefined' ||
     typeof request.keyId !== 'undefined' ||
     typeof request.keyType !== 'undefined' ||
-    typeof request.multisigInit !== 'undefined' ||
-    typeof request.multisigSignatureCount !== 'undefined' ||
+    typeof request.multisigSimulation !== 'undefined' ||
     typeof request.nonceKey !== 'undefined' ||
     typeof request.validBefore !== 'undefined' ||
     typeof request.validAfter !== 'undefined' ||
@@ -274,10 +272,10 @@ export function toRpc(request: toRpc.Input): Rpc {
   if (typeof request.keyId !== 'undefined') request_rpc.keyId = request.keyId
   if (typeof request.keyType !== 'undefined')
     request_rpc.keyType = request.keyType
-  if (typeof request.multisigInit !== 'undefined')
-    request_rpc.multisigInit = request.multisigInit
-  if (typeof request.multisigSignatureCount !== 'undefined')
-    request_rpc.multisigSignatureCount = request.multisigSignatureCount
+  if (typeof request.multisigSimulation !== 'undefined')
+    request_rpc.multisigSimulation = MultisigSimulation.toRpc(
+      request.multisigSimulation,
+    )
   if (typeof request.validBefore !== 'undefined')
     request_rpc.validBefore = Quantity.fromNumberish(request.validBefore)
   if (typeof request.validAfter !== 'undefined')
@@ -312,6 +310,7 @@ export declare namespace toRpc {
   export type ErrorType =
     | AuthorizationTempo.toRpcList.ErrorType
     | Hex.fromNumber.ErrorType
+    | MultisigSimulation.toRpc.ErrorType
     | Errors.GlobalErrorType
 }
 

package/src/tempo/TxEnvelopeTempo.test-d.ts

@@ -0,0 +1,7 @@
+import { expectTypeOf, test } from 'vp/test'
+import type * as TxEnvelopeTempo from './TxEnvelopeTempo.js'
+
+test('Serialized', () => {
+  expectTypeOf<'0x76'>().toExtend<TxEnvelopeTempo.Serialized>()
+  expectTypeOf<'0x78'>().toExtend<TxEnvelopeTempo.Serialized>()
+})

package/src/tempo/TxEnvelopeTempo.test.ts

@@ -138,6 +138,31 @@ describe('deserialize', () => {
     expect(deserialized).toEqual(transaction)
   })
 
+  test('fee payer', () => {
+    const serialized = TxEnvelopeTempo.serialize(transaction, {
+      format: 'feePayer',
+      sender: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+    })
+
+    expect(TxEnvelopeTempo.deserialize(serialized)).toMatchInlineSnapshot(`
+      {
+        "calls": [
+          {
+            "to": "0x70997970c51812dc3a010c7d01b50e0d17dc79c8",
+          },
+        ],
+        "chainId": 1,
+        "feePayerSignature": null,
+        "from": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
+        "maxFeePerGas": 2000000000n,
+        "maxPriorityFeePerGas": 2000000000n,
+        "nonce": 785n,
+        "nonceKey": 0n,
+        "type": "tempo",
+      }
+    `)
+  })
+
   test('minimal', () => {
     const transaction = TxEnvelopeTempo.from({
       chainId: 1,

package/src/tempo/TxEnvelopeTempo.ts

@@ -134,7 +134,8 @@ export type Rpc<signed extends boolean = boolean> = TxEnvelopeTempo<
 export const feePayerMagic = '0x78' as const
 export type FeePayerMagic = typeof feePayerMagic
 
-export type Serialized = `${SerializedType}${string}`
+/** Serialized standard or fee-payer Tempo transaction. */
+export type Serialized = `${SerializedType | FeePayerMagic}${string}`
 
 export type Signed = TxEnvelopeTempo<true>
 
@@ -232,7 +233,7 @@ export declare namespace assert {
 }
 
 /**
- * Deserializes a {@link ox#TxEnvelopeTempo.TxEnvelopeTempo} from its serialized form.
+ * Deserializes a standard or fee-payer {@link ox#TxEnvelopeTempo.TxEnvelopeTempo}.
  *
  * @example
  * ```ts twoslash
@@ -254,7 +255,8 @@ export declare namespace assert {
  * @returns Deserialized Transaction Envelope.
  */
 export function deserialize(serialized: Serialized): Compute<TxEnvelopeTempo> {
-  if (Hex.slice(serialized, 0, 1) !== serializedType)
+  const prefix = Hex.slice(serialized, 0, 1)
+  if (prefix !== serializedType && prefix !== feePayerMagic)
     throw new TransactionEnvelope.InvalidSerializedError({
       attributes: {},
       serialized,

package/src/tempo/index.ts

@@ -173,6 +173,24 @@ export * as KeyAuthorization from './KeyAuthorization.js'
  * @category Reference
  */
 export * as MultisigConfig from './MultisigConfig.js'
+/**
+ * Offchain multisig transaction and key authorization operation utilities.
+ *
+ * Derives operation hashes, selects owner approvals, serializes transactions,
+ * validates operation state, and converts JSON-RPC representations.
+ *
+ * @category Reference
+ */
+export * as MultisigOperation from './MultisigOperation.js'
+/**
+ * Native multisig RPC simulation utilities.
+ *
+ * Converts complete root and nested owner specs between their domain and Tempo
+ * JSON-RPC representations.
+ *
+ * @category Reference
+ */
+export * as MultisigSimulation from './MultisigSimulation.js'
 /**
  * Utilities for constructing period durations (in seconds) for recurring spending limits.
  *
@@ -251,7 +269,7 @@ export * as PoolId from './PoolId.js'
  */
 export * as ReceivePolicyReceipt from './ReceivePolicyReceipt.js'
 /**
- * Union of all JSON-RPC Methods for the `tempo_` namespace.
+ * JSON-RPC schemas for the `tempo_` and `multisig_` namespaces.
  *
  * @example
  * ```ts twoslash
@@ -260,7 +278,9 @@ export * as ReceivePolicyReceipt from './ReceivePolicyReceipt.js'
  * import { RpcSchemaTempo } from 'ox/tempo'
  *
  * const schema = RpcSchema.from<
- *   RpcSchema.Default | RpcSchemaTempo.Tempo
+ *   | RpcSchema.Default
+ *   | RpcSchemaTempo.Multisig
+ *   | RpcSchemaTempo.Tempo
  * >()
  *
  * const provider = Provider.from(window.ethereum!, { schema })