ox 1.7.2 → 1.7.5

package/src/tempo/multisig.e2e.test.ts

@@ -1,866 +1,377 @@
 import { AbiFunction, Address, Hex, Secp256k1, Value } from 'ox'
-import { getTransactionCount } from 'viem/actions'
 import { describe, expect, test } from 'vp/test'
 import { chain, client, fundAddress } from '../../test/tempo/config.js'
-import { KeyAuthorization, MultisigConfig, SignatureEnvelope } from './index.js'
+import { factory } from '../../test/tempo/multisig.js'
+import {
+  KeyAuthorization,
+  MultisigConfig,
+  MultisigOperation,
+  SignatureEnvelope,
+} from './index.js'
 import * as Transaction from './Transaction.js'
 import * as TransactionReceipt from './TransactionReceipt.js'
+import * as TransactionRequest from './TransactionRequest.js'
 import * as TxEnvelopeTempo from './TxEnvelopeTempo.js'
 
-const chainId = chain.id
+const precompile = '0xaacc000000000000000000000000000000000000'
 const updateConfig = AbiFunction.from(
   'function updateConfig((bytes32 salt, uint64 version, uint8 threshold, (address owner, uint8 weight)[] owners) current, uint8 threshold, (address owner, uint8 weight)[] owners)',
 )
 
-describe('behavior: multisig (TIP-1061)', () => {
-  function createKey() {
+async function setup() {
+  const keys = Array.from({ length: 3 }, () => {
     const privateKey = Secp256k1.randomPrivateKey()
-    const address = Address.fromPublicKey(
-      Secp256k1.getPublicKey({ privateKey }),
-    )
-    return { address, privateKey } as const
-  }
-
-  function setup(parameters: {
-    count: number
-    threshold: number
-    weights?: readonly number[] | undefined
-  }) {
-    const { count, threshold, weights = Array(count).fill(1) } = parameters
-    const ownerKeys = Array.from({ length: count }, () => {
-      const privateKey = Secp256k1.randomPrivateKey()
-      const address = Address.fromPublicKey(
-        Secp256k1.getPublicKey({ privateKey }),
-      )
-      return { address, privateKey } as const
-    }).sort((a, b) => a.address.localeCompare(b.address))
-
-    const initialConfig = MultisigConfig.from({
-      salt: Hex.random(32),
-      threshold,
-      owners: ownerKeys.map((key, index) => ({
-        owner: key.address,
-        weight: weights[index]!,
-      })),
-    })
-    const account = MultisigConfig.getAddress(initialConfig)
-
-    return { account, initialConfig, ownerKeys } as const
-  }
-
-  function approve(parameters: {
-    address?: Address.Address | undefined
-    config: MultisigConfig.Config
-    payload: Hex.Hex
-    signers: readonly { privateKey: Hex.Hex }[]
-  }) {
-    const {
-      address = MultisigConfig.getAddress(parameters.config),
-      config,
-      payload,
-      signers,
-    } = parameters
-    const digest = MultisigConfig.getSignPayload({
-      account: address,
-      config,
-      payload,
-    })
-    const signatures = signers.map((signer) =>
-      SignatureEnvelope.from(
-        Secp256k1.sign({ payload: digest, privateKey: signer.privateKey }),
-      ),
-    )
-    // The node requires approvals ordered by recovered owner address.
-    return SignatureEnvelope.sortMultisigApprovals({
-      account: address,
-      config,
-      payload,
-      signatures,
-    })
-  }
-
-  async function send(serialized: Hex.Hex) {
-    return (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialized],
-      })
-      .then((transaction) => TransactionReceipt.fromRpc(transaction as any)))!
-  }
+    return {
+      privateKey,
+      address: Address.fromPublicKey(Secp256k1.getPublicKey({ privateKey })),
+    }
+  })
+  const config: MultisigConfig.Config = MultisigConfig.from({
+    salt: Hex.random(32),
+    threshold: 2,
+    owners: keys.map((key) => ({ owner: key.address, weight: 1 })),
+  })
+  const account = MultisigConfig.getAddress(config, { factory })
+  await fundAddress(client, { address: account })
+  return { account, config, keys }
+}
+
+function transaction(
+  nonce: bigint,
+  calls: TxEnvelopeTempo.TxEnvelopeTempo['calls'] = [
+    { to: '0x0000000000000000000000000000000000000000' },
+  ],
+) {
+  return TxEnvelopeTempo.from({
+    calls,
+    chainId: chain.id,
+    feeToken: '0x20c0000000000000000000000000000000000001',
+    nonce,
+    gas: 5_000_000n,
+    maxFeePerGas: Value.fromGwei('20'),
+    maxPriorityFeePerGas: Value.fromGwei('10'),
+  })
+}
 
-  async function bootstrap(multisig: ReturnType<typeof setup>) {
-    await fundAddress(client, { address: multisig.account })
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const receipt = await send(
-      TxEnvelopeTempo.serialize(transaction, {
-        signature: SignatureEnvelope.from({
-          account: multisig.account,
-          config: multisig.initialConfig,
-          signatures: approve({
-            config: multisig.initialConfig,
-            payload: TxEnvelopeTempo.getSignPayload(transaction),
-            signers: multisig.ownerKeys,
-          }),
-        }),
-      }),
-    )
-    expect(receipt.status).toBe('success')
+function sign(account: Awaited<ReturnType<typeof setup>>, payload: Hex.Hex) {
+  const value = {
+    account: account.account,
+    config: account.config,
+    payload,
   }
-
-  function accessKeySignature(parameters: {
-    accessKey: { privateKey: Hex.Hex }
-    account: Address.Address
-    transaction: TxEnvelopeTempo.TxEnvelopeTempo
-  }) {
-    const { accessKey, account, transaction } = parameters
-    return SignatureEnvelope.from({
-      inner: SignatureEnvelope.from(
-        Secp256k1.sign({
-          payload: TxEnvelopeTempo.getSignPayload(transaction, {
-            from: account,
-          }),
-          privateKey: accessKey.privateKey,
-        }),
-      ),
-      type: 'keychain',
-      userAddress: account,
-    })
-  }
-
-  test('examples: bootstrap, initialized, and configuration rotation', async () => {
-    const { account, initialConfig, ownerKeys } = setup({
-      count: 3,
-      threshold: 2,
-    })
-    const replacement = createKey()
-    const rotatedConfig = MultisigConfig.from({
-      owners: [{ owner: replacement.address, weight: 1 }],
-      salt: initialConfig.salt,
-      threshold: 1,
-      version: 1,
-    })
-
-    await fundAddress(client, { address: account })
-
-    const bootstrap = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-
-    const bootstrap_signed = TxEnvelopeTempo.serialize(bootstrap, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: approve({
-          config: initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(bootstrap),
-          signers: [ownerKeys[0]!, ownerKeys[1]!],
-        }),
-      }),
-    })
-
-    const bootstrap_receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [bootstrap_signed],
+  const digest = MultisigConfig.getSignPayload(value)
+  return SignatureEnvelope.from({
+    account: account.account,
+    config: account.config,
+    signatures: SignatureEnvelope.sortMultisigApprovals({
+      ...value,
+      signatures: account.keys
+        .slice(0, 2)
+        .map((key) =>
+          SignatureEnvelope.from(
+            Secp256k1.sign({ payload: digest, privateKey: key.privateKey }),
+          ),
+        ),
+    }),
+  })
+}
+
+async function submit(
+  tx: TxEnvelopeTempo.TxEnvelopeTempo,
+  signature: SignatureEnvelope.SignatureEnvelope,
+) {
+  const result = await client.request({
+    method: 'eth_sendRawTransactionSync',
+    params: [TxEnvelopeTempo.serialize(tx, { signature })],
+  })
+  return TransactionReceipt.fromRpc(result as unknown as TransactionReceipt.Rpc)
+}
+
+describe('behavior: configurable accounts', () => {
+  test('registers, spends, and round-trips the RPC signature', async () => {
+    const account = await setup()
+    for (const nonce of [0n, 1n]) {
+      const tx = transaction(nonce)
+      const signature = sign(account, TxEnvelopeTempo.getSignPayload(tx))
+      const receipt = await submit(tx, signature)
+      expect(receipt.status).toMatchInlineSnapshot('"success"')
+      expect(receipt.from).toBe(account.account)
+      const rpc = await client.request({
+        method: 'eth_getTransactionByHash',
+        params: [receipt.transactionHash],
       })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(bootstrap_receipt).toBeDefined()
-    expect(bootstrap_receipt.status).toBe('success')
-    expect(bootstrap_receipt.from).toBe(account)
-
-    {
-      const response = await client
-        .request({
-          method: 'eth_getTransactionByHash',
-          params: [bootstrap_receipt.transactionHash],
-        })
-        .then((tx) => Transaction.fromRpc(tx as any))
-      if (!response) throw new Error()
-      expect(response.from).toBe(account)
-      expect(response.signature?.type).toBe('multisig')
-      expect(
-        (response.signature as SignatureEnvelope.Multisig | undefined)?.config,
-      ).toEqual(initialConfig)
+      const returned = Transaction.fromRpc(rpc as unknown as Transaction.Rpc)
+      expect(returned.signature).toEqual(signature)
     }
-
-    const updateNonce = await getTransactionCount(client, {
-      address: account,
-      blockTag: 'pending',
-    })
-    const update = TxEnvelopeTempo.from({
-      calls: [
-        {
-          to: '0xaacc000000000000000000000000000000000000',
-          data: AbiFunction.encodeData(updateConfig, [
-            initialConfig,
-            rotatedConfig.threshold,
-            rotatedConfig.owners,
-          ]),
-        },
-      ],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: BigInt(updateNonce),
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const updateSigned = TxEnvelopeTempo.serialize(update, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: approve({
-          config: initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(update),
-          signers: [ownerKeys[0]!, ownerKeys[1]!],
-        }),
-      }),
-    })
-    const updateReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [updateSigned],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(updateReceipt.status).toBe('success')
-
-    const nonce = await getTransactionCount(client, {
-      address: account,
-      blockTag: 'pending',
-    })
-
-    const spend = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: BigInt(nonce),
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-
-    const spend_signed = TxEnvelopeTempo.serialize(spend, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: rotatedConfig,
-        signatures: approve({
-          address: account,
-          config: rotatedConfig,
-          payload: TxEnvelopeTempo.getSignPayload(spend),
-          signers: [replacement],
-        }),
-      }),
-    })
-
-    const spend_receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [spend_signed],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(spend_receipt).toBeDefined()
-    expect(spend_receipt.status).toBe('success')
-    expect(spend_receipt.from).toBe(account)
   })
 
-  test('example: nested ownership', async () => {
-    const child = setup({ count: 1, threshold: 1 })
-    await fundAddress(client, { address: child.account })
-
-    const childBootstrap = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const childBootstrapSigned = TxEnvelopeTempo.serialize(childBootstrap, {
-      signature: SignatureEnvelope.from({
-        account: child.account,
-        config: child.initialConfig,
-        signatures: approve({
-          config: child.initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(childBootstrap),
-          signers: child.ownerKeys,
-        }),
-      }),
-    })
-    const childReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [childBootstrapSigned],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(childReceipt.status).toBe('success')
-
-    const initialConfig = MultisigConfig.from({
-      salt: Hex.random(32),
-      threshold: 1,
-      owners: [{ owner: child.account, weight: 1 }],
-    })
-    const account = MultisigConfig.getAddress(initialConfig)
-    await fundAddress(client, { address: account })
-
-    const bootstrap = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const digest = MultisigConfig.getSignPayload({
-      account,
-      config: initialConfig,
-      payload: TxEnvelopeTempo.getSignPayload(bootstrap),
-    })
-    const nested = SignatureEnvelope.from({
-      account: child.account,
-      config: child.initialConfig,
-      signatures: approve({
-        config: child.initialConfig,
-        payload: digest,
-        signers: child.ownerKeys,
-      }),
-    })
-    const bootstrapSigned = TxEnvelopeTempo.serialize(bootstrap, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: [nested],
-      }),
-    })
-
-    const receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [bootstrapSigned],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(receipt.status).toBe('success')
-    expect(receipt.from).toBe(account)
-
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 1n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const parentDigest = MultisigConfig.getSignPayload({
-      account,
-      config: initialConfig,
-      payload: TxEnvelopeTempo.getSignPayload(transaction),
-    })
-    const childSignature = SignatureEnvelope.from({
-      account: child.account,
-      config: child.initialConfig,
-      signatures: approve({
-        config: child.initialConfig,
-        payload: parentDigest,
-        signers: child.ownerKeys,
-      }),
-    })
-    const serialized = TxEnvelopeTempo.serialize(transaction, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: [childSignature],
-      }),
-    })
-    const nestedReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialized],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(nestedReceipt.status).toBe('success')
-    expect(nestedReceipt.from).toBe(account)
+  test('selects operation approvals and submits the serialized transaction', async () => {
+    const account = await setup()
+    const tx = transaction(0n)
+    const serialized = TxEnvelopeTempo.serialize(tx)
+    const hash = MultisigOperation.getHash({
+      account: account.account,
+      config: account.config,
+      transaction: serialized,
+      type: 'transaction',
+    })
+    const selected = await MultisigOperation.selectApprovals({
+      account: account.account,
+      approvals: account.keys.map(({ privateKey }) =>
+        SignatureEnvelope.serialize(
+          SignatureEnvelope.from(Secp256k1.sign({ payload: hash, privateKey })),
+        ),
+      ),
+      config: account.config,
+      hash,
+    })
+    const operation = MultisigOperation.from({
+      account: account.account,
+      approvals: selected.approvals,
+      config: account.config,
+      createdAt: 1,
+      hash,
+      signatureCount: selected.signatureCount,
+      status: 'pending',
+      threshold: selected.threshold,
+      transaction: serialized,
+      type: 'transaction',
+      updatedAt: 1,
+      weight: selected.weight,
+    })
+    const signed = MultisigOperation.serializeTransaction(operation, {
+      approvals: selected.selectedApprovals,
+    })
+    const result = await client.request({
+      method: 'eth_sendRawTransactionSync',
+      params: [signed],
+    })
+    const receipt = TransactionReceipt.fromRpc(
+      result as unknown as TransactionReceipt.Rpc,
+    )
+    expect(receipt.status).toMatchInlineSnapshot('"success"')
+    expect(receipt.from).toBe(account.account)
   })
 
-  test('example: fee sponsorship (owners sign first)', async () => {
-    const multisig = setup({ count: 2, threshold: 2 })
-    const feePayer = createKey()
-    await Promise.all([
-      bootstrap(multisig),
-      fundAddress(client, { address: feePayer.address }),
-    ])
-
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feePayerSignature: null,
-      nonce: 1n,
+  test('simulates registration with the full config without persisting it', async () => {
+    const account = await setup()
+    const data = AbiFunction.encodeData(
+      AbiFunction.from(
+        'function getConfigCommitment(address account) view returns (bytes32)',
+      ),
+      [account.account],
+    )
+    const request = TransactionRequest.toRpc({
+      from: account.account,
+      to: precompile,
+      data,
       gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const signedByOwners = TxEnvelopeTempo.from(transaction, {
-      signature: SignatureEnvelope.from({
-        account: multisig.account,
-        config: multisig.initialConfig,
-        signatures: approve({
-          config: multisig.initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(transaction),
-          signers: multisig.ownerKeys,
-        }),
-      }),
-    })
-    const sponsored = TxEnvelopeTempo.from({
-      ...signedByOwners,
       feeToken: '0x20c0000000000000000000000000000000000001',
-    })
-    const feePayerSignature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getFeePayerSignPayload(sponsored, {
-        sender: multisig.account,
+      multisigSimulation: {
+        config: account.config,
+        approvals: account.config.owners
+          .slice(0, 2)
+          .map(({ owner }) => ({ owner, keyType: 'secp256k1' })),
+      },
+    })
+    const simulated = await client.request({
+      method: 'eth_call',
+      params: [request as never, 'latest'],
+    })
+    expect(simulated).not.toBe(MultisigConfig.zeroSalt)
+    const estimate = await client.request({
+      method: 'eth_estimateGas',
+      params: [request as never],
+    })
+    expect(Hex.toBigInt(estimate)).toBeGreaterThan(0n)
+    const persisted = await client.request({
+      method: 'eth_call',
+      params: [{ to: precompile, data }, 'latest'],
+    })
+    expect(persisted).toBe(MultisigConfig.zeroSalt)
+    const tx = transaction(0n)
+    await submit(tx, sign(account, TxEnvelopeTempo.getSignPayload(tx)))
+    expect(
+      await client.request({
+        method: 'eth_call',
+        params: [{ to: precompile, data }, 'latest'],
       }),
-      privateKey: feePayer.privateKey,
-    })
-    const receipt = await send(
-      TxEnvelopeTempo.serialize(sponsored, { feePayerSignature }),
-    )
-    expect(receipt.status).toBe('success')
-    expect(receipt.from).toBe(multisig.account)
-    expect(receipt.feePayer).toBe(feePayer.address)
+    ).toBe(simulated)
   })
 
-  test('example: fee sponsorship (fee payer signs first)', async () => {
-    const multisig = setup({ count: 2, threshold: 2 })
-    const feePayer = createKey()
-    await Promise.all([
-      bootstrap(multisig),
-      fundAddress(client, { address: feePayer.address }),
+  test('rotates config and rejects stale witnesses and signatures', async () => {
+    const account = await setup()
+    const replacement = account
+    const tx = transaction(0n, [
+      {
+        to: precompile,
+        data: AbiFunction.encodeData(updateConfig, [
+          { ...account.config, salt: account.config.salt!, version: 0n },
+          2,
+          replacement.config.owners,
+        ]),
+      },
     ])
-
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feePayerSignature: null,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 1n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const feePayerSignature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getFeePayerSignPayload(transaction, {
-        sender: multisig.account,
-      }),
-      privateKey: feePayer.privateKey,
-    })
-    const sponsored = TxEnvelopeTempo.from(transaction, { feePayerSignature })
-    const receipt = await send(
-      TxEnvelopeTempo.serialize(sponsored, {
-        signature: SignatureEnvelope.from({
-          account: multisig.account,
-          config: multisig.initialConfig,
-          signatures: approve({
-            config: multisig.initialConfig,
-            payload: TxEnvelopeTempo.getSignPayload(sponsored),
-            signers: multisig.ownerKeys,
-          }),
-        }),
-      }),
-    )
-    expect(receipt.status).toBe('success')
-    expect(receipt.from).toBe(multisig.account)
-    expect(receipt.feePayer).toBe(feePayer.address)
-  })
-
-  test('example: weighted quorum', async () => {
-    const { account, initialConfig, ownerKeys } = setup({
-      count: 3,
-      threshold: 3,
-      weights: [2, 1, 1],
-    })
-
-    await fundAddress(client, { address: account })
-
-    const transaction = (nonce: bigint) =>
-      TxEnvelopeTempo.from({
-        calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-        chainId,
-        feeToken: '0x20c0000000000000000000000000000000000001',
-        nonce,
-        gas: 5_000_000n,
-        maxFeePerGas: Value.fromGwei('20'),
-        maxPriorityFeePerGas: Value.fromGwei('10'),
-      })
-    const serialize = (
-      value: ReturnType<typeof transaction>,
-      signers: readonly { privateKey: Hex.Hex }[],
-    ) =>
-      TxEnvelopeTempo.serialize(value, {
-        signature: SignatureEnvelope.from({
-          account,
-          config: initialConfig,
-          signatures: approve({
-            config: initialConfig,
-            payload: TxEnvelopeTempo.getSignPayload(value),
-            signers,
-          }),
-        }),
-      })
-
-    const bootstrap = transaction(0n)
-    const bootstrapReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialize(bootstrap, [ownerKeys[0]!, ownerKeys[1]!])],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(bootstrapReceipt.status).toBe('success')
-
-    const valid = transaction(1n)
-    const validReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialize(valid, [ownerKeys[0]!, ownerKeys[2]!])],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(validReceipt.status).toBe('success')
-
-    const belowThreshold = transaction(2n)
+    expect(
+      (await submit(tx, sign(account, TxEnvelopeTempo.getSignPayload(tx))))
+        .status,
+    ).toMatchInlineSnapshot('"success"')
+    const spend = transaction(1n)
+    const old = sign(account, TxEnvelopeTempo.getSignPayload(spend))
+    await expect(submit(spend, old)).rejects.toThrow(/commitment mismatch/)
+    const rotated = {
+      ...replacement,
+      account: account.account,
+      config: { ...replacement.config, salt: account.config.salt, version: 1n },
+    }
     await expect(
-      client.request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialize(belowThreshold, [ownerKeys[1]!, ownerKeys[2]!])],
-      }),
+      submit(spend, { ...old, config: rotated.config }),
     ).rejects.toThrow()
+    expect(
+      (
+        await submit(
+          spend,
+          sign(rotated, TxEnvelopeTempo.getSignPayload(spend)),
+        )
+      ).status,
+    ).toMatchInlineSnapshot('"success"')
+  })
 
+  test('rejects insufficient approvals without registering the account', async () => {
+    const account = await setup()
+    const tx = transaction(0n)
+    const signature = sign(account, TxEnvelopeTempo.getSignPayload(tx))
     await expect(
-      client.request({
-        method: 'eth_sendRawTransactionSync',
-        params: [serialize(belowThreshold, ownerKeys)],
+      submit(tx, {
+        ...signature,
+        signatures: signature.signatures.slice(0, 1),
       }),
-    ).rejects.toThrow()
+    ).rejects.toThrow(/threshold|weight|quorum/)
+    expect((await submit(tx, signature)).status).toMatchInlineSnapshot(
+      '"success"',
+    )
   })
 
-  test('behavior: keychain access key (authorize, spend, reject config update)', async () => {
-    const { account, initialConfig, ownerKeys } = setup({
-      count: 2,
-      threshold: 2,
-    })
-
-    await fundAddress(client, { address: account })
-
-    const access = (() => {
-      const privateKey = Secp256k1.randomPrivateKey()
-      const address = Address.fromPublicKey(
-        Secp256k1.getPublicKey({ privateKey }),
-      )
-      return { address, privateKey } as const
-    })()
-
-    const bootstrap = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-
-    const bootstrap_signed = TxEnvelopeTempo.serialize(bootstrap, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: approve({
-          config: initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(bootstrap),
-          signers: ownerKeys,
-        }),
-      }),
+  test('authorizes a multisig delegate and preserves the grant after delegate rotation', async () => {
+    const parent = await setup()
+    const delegate = await setup()
+    const grant = KeyAuthorization.from({
+      address: delegate.account,
+      account: parent.account,
+      chainId: BigInt(chain.id),
+      type: 'multisig',
+    })
+    const signed = KeyAuthorization.from(grant, {
+      signature: sign(parent, KeyAuthorization.getSignPayload(grant)),
+    })
+    const tx = { ...transaction(0n), keyAuthorization: signed }
+    const signature = SignatureEnvelope.from({
+      userAddress: parent.account,
+      version: 'v2',
+      inner: sign(
+        delegate,
+        TxEnvelopeTempo.getSignPayload(tx, { from: parent.account }),
+      ),
     })
-
-    const bootstrap_receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [bootstrap_signed],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(bootstrap_receipt.status).toBe('success')
-
-    // Multisig accounts authorize access keys through AccountKeychain.
-    const authorizeKey = AbiFunction.from(
-      'function authorizeKey(address keyId, uint8 signatureType, (uint64 expiry, bool enforceLimits, (address token, uint256 amount, uint64 period)[] limits, bool allowAnyCalls, (address target, (bytes4 selector, address[] recipients)[] selectorRules)[] allowedCalls) config)',
+    expect((await submit(tx, signature)).status).toMatchInlineSnapshot(
+      '"success"',
     )
 
-    const authorize = TxEnvelopeTempo.from({
-      calls: [
-        {
-          to: '0xaaaaaaaa00000000000000000000000000000000',
-          data: AbiFunction.encodeData(authorizeKey, [
-            access.address,
-            0, // secp256k1
-            {
-              expiry: 18446744073709551615n, // u64 max (never expires)
-              enforceLimits: false,
-              limits: [],
-              allowAnyCalls: true,
-              allowedCalls: [],
-            },
-          ]),
-        },
-      ],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 1n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-
-    const authorize_signed = TxEnvelopeTempo.serialize(authorize, {
-      signature: SignatureEnvelope.from({
-        account,
-        config: initialConfig,
-        signatures: approve({
-          config: initialConfig,
-          payload: TxEnvelopeTempo.getSignPayload(authorize),
-          signers: ownerKeys,
-        }),
-      }),
-    })
-
-    const authorize_receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [authorize_signed],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(authorize_receipt.status).toBe('success')
-    expect(authorize_receipt.from).toBe(account)
-
-    const nonce = await getTransactionCount(client, {
-      address: account,
-      blockTag: 'pending',
-    })
-
-    const spend = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: BigInt(nonce),
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-
-    const spend_signature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getSignPayload(spend, { from: account }),
-      privateKey: access.privateKey,
-    })
-
-    const spend_signed = TxEnvelopeTempo.serialize(spend, {
-      signature: SignatureEnvelope.from({
-        userAddress: account,
-        inner: SignatureEnvelope.from(spend_signature),
-        type: 'keychain',
-      }),
-    })
-
-    const spend_receipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [spend_signed],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(spend_receipt.status).toBe('success')
-    expect(spend_receipt.from).toBe(account)
-
-    {
-      const response = await client
-        .request({
-          method: 'eth_getTransactionByHash',
-          params: [spend_receipt.transactionHash],
-        })
-        .then((tx) => Transaction.fromRpc(tx as any))
-      if (!response) throw new Error()
-      expect(response.from).toBe(account)
-      expect(response.signature?.type).toBe('keychain')
-      expect(
-        (response.signature as SignatureEnvelope.Keychain | undefined)
-          ?.userAddress,
-      ).toBe(account)
+    const replacement = await setup()
+    const rotation = transaction(0n, [
+      {
+        to: precompile,
+        data: AbiFunction.encodeData(updateConfig, [
+          { ...delegate.config, salt: delegate.config.salt!, version: 0n },
+          2,
+          replacement.config.owners,
+        ]),
+      },
+    ])
+    expect(
+      (
+        await submit(
+          rotation,
+          sign(delegate, TxEnvelopeTempo.getSignPayload(rotation)),
+        )
+      ).status,
+    ).toMatchInlineSnapshot('"success"')
+    const spend = transaction(1n)
+    const rotated = {
+      ...replacement,
+      account: delegate.account,
+      config: {
+        ...replacement.config,
+        salt: delegate.config.salt,
+        version: 1n,
+      },
     }
-
-    const updateNonce = await getTransactionCount(client, {
-      address: account,
-      blockTag: 'pending',
-    })
-    const update = TxEnvelopeTempo.from({
-      calls: [
-        {
-          to: '0xaacc000000000000000000000000000000000000',
-          data: AbiFunction.encodeData(updateConfig, [
-            initialConfig,
-            initialConfig.threshold,
-            initialConfig.owners,
-          ]),
-        },
-      ],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: BigInt(updateNonce),
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const updateSignature = Secp256k1.sign({
-      payload: TxEnvelopeTempo.getSignPayload(update, { from: account }),
-      privateKey: access.privateKey,
-    })
-    const updateSigned = TxEnvelopeTempo.serialize(update, {
-      signature: SignatureEnvelope.from({
-        userAddress: account,
-        inner: SignatureEnvelope.from(updateSignature),
-        type: 'keychain',
-      }),
-    })
-
-    const updateReceipt = (await client
-      .request({
-        method: 'eth_sendRawTransactionSync',
-        params: [updateSigned],
-      })
-      .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
-    expect(updateReceipt.status).toBe('reverted')
-  })
-
-  test('example: bootstrap and immediate access key use', async () => {
-    const multisig = setup({ count: 2, threshold: 2 })
-    const accessKey = createKey()
-    await fundAddress(client, { address: multisig.account })
-
-    const keyAuthorization = KeyAuthorization.from({
-      account: multisig.account,
-      address: accessKey.address,
-      chainId: BigInt(chainId),
-      isAdmin: false,
-      type: 'secp256k1',
+    const payload = TxEnvelopeTempo.getSignPayload(spend, {
+      from: parent.account,
     })
-    const keyAuthorizationSigned = KeyAuthorization.from(keyAuthorization, {
-      signature: SignatureEnvelope.from({
-        account: multisig.account,
-        config: multisig.initialConfig,
-        signatures: approve({
-          config: multisig.initialConfig,
-          payload: KeyAuthorization.getSignPayload(keyAuthorization),
-          signers: multisig.ownerKeys,
+    await expect(
+      submit(
+        spend,
+        SignatureEnvelope.from({
+          userAddress: parent.account,
+          version: 'v2',
+          inner: sign(delegate, payload),
         }),
-      }),
-    })
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      keyAuthorization: keyAuthorizationSigned,
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
+      ),
+    ).rejects.toThrow(/commitment mismatch/)
+    expect(
+      (
+        await submit(
+          spend,
+          SignatureEnvelope.from({
+            userAddress: parent.account,
+            version: 'v2',
+            inner: sign(rotated, payload),
+          }),
+        )
+      ).status,
+    ).toMatchInlineSnapshot('"success"')
+    const unauthorized = transaction(2n, [
+      {
+        to: precompile,
+        data: AbiFunction.encodeData(updateConfig, [
+          { ...parent.config, salt: parent.config.salt!, version: 0n },
+          1,
+          parent.config.owners,
+        ]),
+      },
+    ])
+    const unauthorizedSignature = SignatureEnvelope.from({
+      userAddress: parent.account,
+      version: 'v2',
+      inner: sign(
+        rotated,
+        TxEnvelopeTempo.getSignPayload(unauthorized, { from: parent.account }),
+      ),
     })
-    const receipt = await send(
-      TxEnvelopeTempo.serialize(transaction, {
-        signature: accessKeySignature({
-          accessKey,
-          account: multisig.account,
-          transaction,
-        }),
-      }),
-    )
-    expect(receipt.status).toBe('success')
-    expect(receipt.from).toBe(multisig.account)
+    expect(
+      (await submit(unauthorized, unauthorizedSignature)).status,
+    ).toMatchInlineSnapshot('"reverted"')
   })
 
-  test('example: bootstrap and subsequent access key use', async () => {
-    const multisig = setup({ count: 2, threshold: 2 })
-    const accessKey = createKey()
-    await fundAddress(client, { address: multisig.account })
-
-    const keyAuthorization = KeyAuthorization.from({
-      account: multisig.account,
-      address: accessKey.address,
-      chainId: BigInt(chainId),
-      isAdmin: false,
+  test('rejects a grant signed by an individual owner instead of the account quorum', async () => {
+    const account = await setup()
+    const key = account.keys[0]!
+    const grant = KeyAuthorization.from({
+      address: key.address,
+      account: account.account,
+      chainId: BigInt(chain.id),
       type: 'secp256k1',
     })
-    const keyAuthorizationSigned = KeyAuthorization.from(keyAuthorization, {
-      signature: SignatureEnvelope.from({
-        account: multisig.account,
-        config: multisig.initialConfig,
-        signatures: approve({
-          config: multisig.initialConfig,
-          payload: KeyAuthorization.getSignPayload(keyAuthorization),
-          signers: multisig.ownerKeys,
-        }),
-      }),
-    })
-    const bootstrapTransaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      keyAuthorization: keyAuthorizationSigned,
-      nonce: 0n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
-    })
-    const bootstrapReceipt = await send(
-      TxEnvelopeTempo.serialize(bootstrapTransaction, {
-        signature: SignatureEnvelope.from({
-          account: multisig.account,
-          config: multisig.initialConfig,
-          signatures: approve({
-            config: multisig.initialConfig,
-            payload: TxEnvelopeTempo.getSignPayload(bootstrapTransaction),
-            signers: multisig.ownerKeys,
-          }),
-        }),
+    const signed = KeyAuthorization.from(grant, {
+      signature: Secp256k1.sign({
+        payload: KeyAuthorization.getSignPayload(grant),
+        privateKey: key.privateKey,
       }),
-    )
-    expect(bootstrapReceipt.status).toBe('success')
-
-    const transaction = TxEnvelopeTempo.from({
-      calls: [{ to: '0x0000000000000000000000000000000000000000' }],
-      chainId,
-      feeToken: '0x20c0000000000000000000000000000000000001',
-      nonce: 1n,
-      gas: 5_000_000n,
-      maxFeePerGas: Value.fromGwei('20'),
-      maxPriorityFeePerGas: Value.fromGwei('10'),
     })
-    const receipt = await send(
-      TxEnvelopeTempo.serialize(transaction, {
-        signature: accessKeySignature({
-          accessKey,
-          account: multisig.account,
-          transaction,
-        }),
-      }),
-    )
-    expect(receipt.status).toBe('success')
-    expect(receipt.from).toBe(multisig.account)
+    const tx = { ...transaction(0n), keyAuthorization: signed }
+    await expect(
+      submit(tx, sign(account, TxEnvelopeTempo.getSignPayload(tx))),
+    ).rejects.toThrow()
   })
 })