ox 0.14.12 → 0.14.14

package/tempo/e2e.test.ts

@@ -781,6 +781,87 @@ test('behavior: feePayerSignature (user → feePayer)', async () => {
   expect(from).toBe(senderAddress)
 })
 
+test('behavior: feePayerSignature (feePayer → user)', async () => {
+  const userPrivateKey = Secp256k1.randomPrivateKey()
+  const userAddress = Address.fromPublicKey(
+    Secp256k1.getPublicKey({ privateKey: userPrivateKey }),
+  )
+
+  const feePayerPrivateKey = Secp256k1.randomPrivateKey()
+  const feePayerAddress = Address.fromPublicKey(
+    Secp256k1.getPublicKey({ privateKey: feePayerPrivateKey }),
+  )
+
+  await Promise.all([
+    fundAddress(client, { address: userAddress }),
+    fundAddress(client, { address: feePayerAddress }),
+  ])
+
+  const nonce = await getTransactionCount(client, {
+    address: userAddress,
+    blockTag: 'pending',
+  })
+
+  //////////////////////////////////////////////////////////////////
+  // Fee payer flow
+
+  // 1. Build the transaction with `feePayerSignature: null` to indicate
+  //    fee sponsorship intent. The user does NOT commit to `feeToken`.
+  const transaction = TxEnvelopeTempo.from({
+    calls: [
+      {
+        to: '0x0000000000000000000000000000000000000000',
+      },
+    ],
+    chainId,
+    feePayerSignature: null,
+    feeToken: '0x20c0000000000000000000000000000000000001',
+    nonce: BigInt(nonce),
+    gas: 500_000n,
+    maxFeePerGas: Value.fromGwei('20'),
+    maxPriorityFeePerGas: Value.fromGwei('10'),
+  })
+
+  // 2. Fee payer signs first — commits to the sender address and fee token.
+  const feePayerSignature = Secp256k1.sign({
+    payload: TxEnvelopeTempo.getFeePayerSignPayload(transaction, {
+      sender: userAddress,
+    }),
+    privateKey: feePayerPrivateKey,
+  })
+
+  // 3. Attach fee payer signature to the transaction.
+  const transaction_feePayer = TxEnvelopeTempo.from(transaction, {
+    feePayerSignature,
+  })
+
+  //////////////////////////////////////////////////////////////////
+  // User flow
+
+  // 4. User signs second — `feePayerSignature` presence causes `feeToken`
+  //    to be skipped from the user's signing payload.
+  const userSignature = Secp256k1.sign({
+    payload: TxEnvelopeTempo.getSignPayload(transaction_feePayer),
+    privateKey: userPrivateKey,
+  })
+
+  // 5. Serialize with both signatures.
+  const serialized_signed = TxEnvelopeTempo.serialize(transaction_feePayer, {
+    signature: SignatureEnvelope.from(userSignature),
+  })
+
+  const receipt = (await client
+    .request({
+      method: 'eth_sendRawTransactionSync',
+      params: [serialized_signed],
+    })
+    .then((tx) => TransactionReceipt.fromRpc(tx as any)))!
+  expect(receipt).toBeDefined()
+  expect(receipt.status).toBe('success')
+  expect(receipt.from).toBe(userAddress)
+  expect(receipt.feePayer).toBe(feePayerAddress)
+})
+
 describe('behavior: keyAuthorization', () => {
   const privateKey = Secp256k1.randomPrivateKey()
   const address = Address.fromPublicKey(Secp256k1.getPublicKey({ privateKey }))
@@ -2070,7 +2151,7 @@ describe('behavior: keyAuthorization', () => {
         limits: [{ token, limit: Value.from('10000', 6) }],
         scopes: [
           {
-            contractAddress: token,
+            address: token,
             selector: AbiFunction.getSelector(transfer),
           },
         ],
@@ -2136,9 +2217,7 @@ describe('behavior: keyAuthorization', () => {
 
         expect(response.from).toBe(root.address)
         expect(response.keyAuthorization).toBeDefined()
-        expect(response.keyAuthorization?.scopes?.[0]?.contractAddress).toBe(
-          token,
-        )
+        expect(response.keyAuthorization?.scopes?.[0]?.address).toBe(token)
         expect(response.keyAuthorization?.scopes?.[0]?.selector).toBe(
           '0xa9059cbb',
         )
@@ -2172,7 +2251,7 @@ describe('behavior: keyAuthorization', () => {
         limits: [{ token, limit: Value.from('10000', 6) }],
         scopes: [
           {
-            contractAddress: token,
+            address: token,
             selector: AbiFunction.getSelector(transfer),
             recipients: [recipient],
           },
@@ -2274,7 +2353,7 @@ describe('behavior: keyAuthorization', () => {
         type: 'secp256k1',
         scopes: [
           {
-            contractAddress: token1,
+            address: token1,
             selector: AbiFunction.getSelector(transfer),
           },
         ],
@@ -2357,7 +2436,7 @@ describe('behavior: keyAuthorization', () => {
         type: 'secp256k1',
         scopes: [
           {
-            contractAddress: token,
+            address: token,
             selector: AbiFunction.getSelector(transfer),
           },
         ],
@@ -2439,7 +2518,7 @@ describe('behavior: keyAuthorization', () => {
         type: 'secp256k1',
         scopes: [
           {
-            contractAddress: token,
+            address: token,
             selector: AbiFunction.getSelector(transfer),
             recipients: [allowedRecipient],
           },

package/tempo/index.ts

@@ -129,6 +129,26 @@ export * as Period from './Period.js'
  */
 export * as PoolId from './PoolId.js'
 
+/**
+ * Union of all JSON-RPC Methods for the `tempo_` namespace.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Provider, RpcSchema } from 'ox'
+ * import { RpcSchema as TempoRpcSchema } from 'ox/tempo'
+ *
+ * const schema = RpcSchema.from<
+ *   | RpcSchema.Default
+ *   | TempoRpcSchema.Tempo
+ * >()
+ *
+ * const provider = Provider.from(window.ethereum!, { schema })
+ * ```
+ *
+ * @category Reference
+ */
+export * as RpcSchema from './RpcSchema.js'
+
 /**
  * Signature envelope utilities for secp256k1, P256, WebAuthn, and keychain signatures.
  *

package/version.ts

@@ -1,2 +1,2 @@
 /** @internal */
-export const version = '0.14.12'
+export const version = '0.14.14'