accounts 0.6.7 → 0.7.0

package/dist/server/internal/handlers/sponsorship.d.ts

@@ -0,0 +1,77 @@
+import type { Address, Client } from 'viem';
+import type { LocalAccount } from 'viem/accounts';
+import { Transaction } from 'viem/tempo';
+/** Returns sponsor metadata for `eth_fillTransaction` responses. */
+export declare function getSponsor(options: getSponsor.Options): getSponsor.ReturnType;
+export declare namespace getSponsor {
+    type Options = {
+        /** Account used for sponsorship. */
+        account: LocalAccount;
+        /** Optional display name. */
+        name?: string | undefined;
+        /** Optional display URL. */
+        url?: string | undefined;
+    };
+    type ReturnType = {
+        /** Sponsor address. */
+        address: Address;
+        /** Sponsor display name. */
+        name?: string | undefined;
+        /** Sponsor display URL. */
+        url?: string | undefined;
+    };
+}
+/** Returns whether the fee payer approves a filled transaction. */
+export declare function shouldSponsor(options: shouldSponsor.Options): Promise<boolean>;
+export declare namespace shouldSponsor {
+    type Options = {
+        /** Sender address from the original request. */
+        sender?: Address | undefined;
+        /** Filled transaction to validate. */
+        transaction: Record<string, unknown>;
+        /** Optional sponsorship approval callback. */
+        validate?: ((request: Transaction.TransactionRequest) => boolean | Promise<boolean>) | undefined;
+    };
+}
+/** Returns whether a raw Tempo transaction is explicitly requesting sponsorship. */
+export declare function requestsRawSponsorship(serialized: `0x${string}`): boolean;
+/** Returns `true` when a fill request already has the fields needed for sponsorship signing. */
+export declare function isPreparedTransaction(value: Record<string, unknown>): boolean;
+/** Signs a filled transaction as the fee payer. */
+export declare function sign(options: sign.Options): Promise<{
+    feePayerSignature: {
+        r: bigint;
+        s: bigint;
+        yParity: number;
+    };
+    from: `0x${string}` | undefined;
+}>;
+export declare namespace sign {
+    type Options = {
+        /** Account used as the fee payer. */
+        account: LocalAccount;
+        /** Filled transaction to sign. */
+        transaction: Record<string, unknown>;
+        /** Sender address from the original request. */
+        sender?: Address | undefined;
+    };
+}
+/** Handles `eth_signRawTransaction` and broadcast methods for sponsored Tempo transactions. */
+export declare function handleRawTransaction(options: handleRawTransaction.Options): Promise<string>;
+export declare namespace handleRawTransaction {
+    type Options = {
+        /** Account used as the fee payer. */
+        account: LocalAccount;
+        /** Client resolver keyed by transaction `chainId`. */
+        getClient: (chainId?: number | undefined) => Client;
+        /** Raw transaction method to handle. */
+        method: 'eth_signRawTransaction' | 'eth_sendRawTransaction' | 'eth_sendRawTransactionSync';
+        /** Incoming JSON-RPC request. */
+        request: {
+            params?: readonly unknown[] | undefined;
+        };
+        /** Optional sponsorship approval callback. */
+        validate?: ((request: Transaction.TransactionRequest) => boolean | Promise<boolean>) | undefined;
+    };
+}
+//# sourceMappingURL=sponsorship.d.ts.map

package/dist/server/internal/handlers/sponsorship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsorship.d.ts","sourceRoot":"","sources":["../../../../src/server/internal/handlers/sponsorship.ts"],"names":[],"mappings":"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"}

package/dist/server/internal/handlers/sponsorship.js

@@ -0,0 +1,96 @@
+import { RpcResponse, Signature } from 'ox';
+import { TxEnvelopeTempo } from 'ox/tempo';
+import { signTransaction } from 'viem/actions';
+import { Transaction } from 'viem/tempo';
+import * as Utils from './utils.js';
+/** Returns sponsor metadata for `eth_fillTransaction` responses. */
+export function getSponsor(options) {
+    const { account, name, url } = options;
+    return {
+        address: account.address,
+        ...(name ? { name } : {}),
+        ...(url ? { url } : {}),
+    };
+}
+/** Returns whether the fee payer approves a filled transaction. */
+export async function shouldSponsor(options) {
+    const { sender, transaction, validate } = options;
+    if (!validate)
+        return true;
+    return await validate({
+        ...transaction,
+        from: sender,
+    });
+}
+/** Returns whether a raw Tempo transaction is explicitly requesting sponsorship. */
+export function requestsRawSponsorship(serialized) {
+    if (!serialized.startsWith('0x76') && !serialized.startsWith('0x78'))
+        return false;
+    const transaction = Transaction.deserialize(serialized);
+    return 'feePayerSignature' in transaction && transaction.feePayerSignature === null;
+}
+/** Returns `true` when a fill request already has the fields needed for sponsorship signing. */
+export function isPreparedTransaction(value) {
+    return (typeof value.from === 'string' &&
+        typeof Utils.resolveChainId(value.chainId) === 'number' &&
+        typeof value.gas !== 'undefined' &&
+        typeof value.nonce !== 'undefined' &&
+        (typeof value.maxFeePerGas !== 'undefined' || typeof value.gasPrice !== 'undefined'));
+}
+/** Signs a filled transaction as the fee payer. */
+export async function sign(options) {
+    const { account, transaction, sender } = options;
+    const from = transaction.from ?? sender;
+    const { signature: _, ...withoutSenderSig } = transaction;
+    const prepared = { ...withoutSenderSig, from };
+    if (!prepared.from)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Transaction sender must be provided before fee payer signing.',
+        });
+    if (!account.sign)
+        throw new Error('Fee payer account cannot sign transactions.');
+    const feePayerSignature = Signature.from(await account.sign({
+        hash: TxEnvelopeTempo.getFeePayerSignPayload(TxEnvelopeTempo.from(prepared), {
+            sender: prepared.from,
+        }),
+    }));
+    return { ...prepared, feePayerSignature };
+}
+/** Handles `eth_signRawTransaction` and broadcast methods for sponsored Tempo transactions. */
+export async function handleRawTransaction(options) {
+    const { account, getClient, method, request, validate } = options;
+    const serialized = request.params?.[0];
+    if (!serialized?.startsWith('0x76') && !serialized?.startsWith('0x78'))
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Only Tempo (0x76/0x78) transactions are supported.',
+        });
+    const transaction = Transaction.deserialize(serialized);
+    if (!transaction.signature || !transaction.from)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Transaction must be signed by the sender before fee payer signing.',
+        });
+    if (validate && !(await validate(transaction)))
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Sponsorship rejected.',
+        });
+    const client = getClient(transaction.chainId);
+    const serializedTransaction = toSerializedTransaction(await signTransaction(client, {
+        ...transaction,
+        account,
+        feePayer: account,
+    }));
+    if (method === 'eth_signRawTransaction')
+        return serializedTransaction;
+    return await client.request({
+        method: method,
+        params: [serializedTransaction],
+    });
+}
+function toSerializedTransaction(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && 'raw' in value && typeof value.raw === 'string')
+        return value.raw;
+    throw new Error('Expected a serialized transaction result.');
+}
+//# sourceMappingURL=sponsorship.js.map

package/dist/server/internal/handlers/sponsorship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsorship.js","sourceRoot":"","sources":["../../../../src/server/internal/handlers/sponsorship.ts"],"names":[],"mappings":"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"}

package/dist/server/internal/handlers/utils.d.ts

@@ -4,7 +4,9 @@ import { type Client } from 'viem';
 import * as z from 'zod/mini';
 export declare function resolveChainId(value: unknown): number | undefined;
 export declare function formatFillTransactionRequest(client: Client, value: Record<string, unknown>): Record<string, unknown>;
-export declare function normalizeFillTransactionRequest(value: Record<string, unknown>): Record<string, unknown>;
+export declare function normalizeFillTransactionRequest(tx: Record<string, unknown>): {
+    calls: any[];
+};
 export declare function normalizeTempoTransaction(value: Record<string, unknown> | undefined): core_Transaction.Transaction<false, bigint, number>;
 /** Returns a raw JSON-RPC error response object (not wrapped in a `Response`). */
 export declare function rpcErrorJson(request: RpcRequest.RpcRequest, error: unknown): {

package/dist/server/internal/handlers/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/server/internal/handlers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AACjD,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,MAAM,CAAA;AAC7C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,sBAK5C;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAI1F;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAW7E;AAOD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,uDAGnF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;EA2B1E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,YAEtE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,YAExE;AAED,eAAO,MAAM,WAAW,gHAA2D,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/server/internal/handlers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AACjD,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,MAAM,CAAA;AAC7C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,sBAK5C;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAI1F;AAED,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAgB1E;AAOD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,uDAGnF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;EA2B1E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,YAEtE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,YAExE;AAED,eAAO,MAAM,WAAW,gHAA2D,CAAA"}

package/dist/server/internal/handlers/utils.js

@@ -17,19 +17,22 @@ export function formatFillTransactionRequest(client, value) {
         return value;
     return format({ ...value }, 'fillTransaction');
 }
-export function normalizeFillTransactionRequest(value) {
-    if (typeof value.to !== 'undefined' || typeof value.data !== 'undefined')
-        return value;
-    if (!Array.isArray(value.calls) || value.calls.length !== 1)
-        return value;
-    const [call] = value.calls;
-    const { calls: _, ...rest } = value;
-    return {
-        ...rest,
-        ...(typeof call?.data !== 'undefined' ? { data: call.data } : {}),
-        ...(typeof call?.to !== 'undefined' ? { to: call.to } : {}),
-        ...(typeof call?.value !== 'undefined' ? { value: normalizeFillValue(call.value) } : {}),
+export function normalizeFillTransactionRequest(tx) {
+    const { to, data, value, ...rest } = tx;
+    if (Array.isArray(tx.calls) && tx.calls.length > 0)
+        return {
+            ...tx,
+            calls: tx.calls.map((call) => ({
+                ...call,
+                value: normalizeFillValue(call.value),
+            })),
+        };
+    const call = {
+        ...(typeof to !== 'undefined' ? { to } : {}),
+        ...(typeof data !== 'undefined' ? { data } : {}),
+        ...(typeof value !== 'undefined' ? { value: normalizeFillValue(value) } : {}),
     };
+    return { ...rest, calls: [call] };
 }
 function normalizeFillValue(value) {
     if (typeof value !== 'string' || !value.startsWith('0x'))

package/dist/server/internal/handlers/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/server/internal/handlers/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/server/internal/handlers/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "accounts",
   "description": "Tempo Accounts SDK",
   "type": "module",
-  "version": "0.6.7",
+  "version": "0.7.0",
   "dependencies": {
     "hono": "^4.12.12",
     "idb-keyval": "^6.2.2",

package/src/core/ExecutionError.test.ts

@@ -0,0 +1,205 @@
+import { describe, expect, test } from 'vp/test'
+
+import * as ExecutionError from './ExecutionError.js'
+
+// ABI-encoded revert data fixtures.
+const insufficientBalanceData =
+  '0x832f98b500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f5e10000000000000000000000000020c0000000000000000000000000000000000001' as const
+const unauthorizedData = '0x82b42900' as const
+const tokenAlreadyExistsData =
+  '0x15ef3a5700000000000000000000000020c0000000000000000000000000000000000001' as const
+
+describe('parse', () => {
+  test('decodes InsufficientBalance from revert data', () => {
+    const error = Object.assign(new Error('reverted'), {
+      data: insufficientBalanceData,
+    })
+    const result = ExecutionError.parse(error)
+    expect(result).toMatchInlineSnapshot(`
+    	{
+    	  "abiItem": {
+    	    "inputs": [
+    	      {
+    	        "name": "available",
+    	        "type": "uint256",
+    	      },
+    	      {
+    	        "name": "required",
+    	        "type": "uint256",
+    	      },
+    	      {
+    	        "name": "token",
+    	        "type": "address",
+    	      },
+    	    ],
+    	    "name": "InsufficientBalance",
+    	    "type": "error",
+    	  },
+    	  "args": [
+    	    0n,
+    	    100000000n,
+    	    "0x20C0000000000000000000000000000000000001",
+    	  ],
+    	  "data": "0x832f98b500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f5e10000000000000000000000000020c0000000000000000000000000000000000001",
+    	  "errorName": "InsufficientBalance",
+    	  "message": "Insufficient balance. Required: 100000000, available: 0.",
+    	}
+    `)
+  })
+
+  test('decodes Unauthorized (no args)', () => {
+    const error = Object.assign(new Error('reverted'), {
+      data: unauthorizedData,
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('Unauthorized')
+    expect(result.message).toBe('Unauthorized.')
+  })
+
+  test('decodes TokenAlreadyExists with templated message', () => {
+    const error = Object.assign(new Error('reverted'), {
+      data: tokenAlreadyExistsData,
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('TokenAlreadyExists')
+    expect(result.message).toBe('Token 0x20C0000000000000000000000000000000000001 already exists.')
+  })
+
+  test('extracts revert data from nested cause', () => {
+    const inner = Object.assign(new Error('inner'), {
+      data: unauthorizedData,
+    })
+    const error = Object.assign(new Error('outer'), { cause: inner })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('Unauthorized')
+  })
+
+  test('extracts revert data from nested error property', () => {
+    const inner = Object.assign(new Error('inner'), {
+      data: insufficientBalanceData,
+    })
+    const error = Object.assign(new Error('outer'), { error: inner })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('InsufficientBalance')
+  })
+
+  test('extracts revert data via walk method', () => {
+    const inner = { data: unauthorizedData }
+    const error = Object.assign(new Error('walkable'), {
+      walk: (fn: (e: unknown) => boolean) => (fn(inner) ? inner : null),
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('Unauthorized')
+  })
+
+  test('fallback: extracts error name from human-readable revert message', () => {
+    const error = new Error('execution reverted: Unauthorized(something)')
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('unknown')
+    expect(result.message).toBe('Unauthorized.')
+  })
+
+  test('fallback: uses details property', () => {
+    const error = Object.assign(new Error('ignored'), {
+      details: 'execution reverted: Unauthorized(x)',
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('unknown')
+    expect(result.message).toBe('Unauthorized.')
+  })
+
+  test('fallback: uses shortMessage property', () => {
+    const error = Object.assign(new Error('ignored'), {
+      shortMessage: 'execution reverted: Unauthorized(x)',
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.errorName).toBe('unknown')
+    expect(result.message).toBe('Unauthorized.')
+  })
+
+  test('unknown error: returns raw message', () => {
+    const error = new Error('something went wrong')
+    const result = ExecutionError.parse(error)
+    expect(result.message).toBe('something went wrong')
+    expect(result.errorName).toBe('unknown')
+  })
+
+  test('unknown error: strips "execution reverted:" prefix', () => {
+    const error = new Error('execution reverted: mystery failure')
+    const result = ExecutionError.parse(error)
+    expect(result.message).toBe('mystery failure')
+  })
+
+  test('undecodable revert data falls back to raw message', () => {
+    const error = Object.assign(new Error('bad revert'), {
+      data: '0xdeadbeef',
+    })
+    const result = ExecutionError.parse(error)
+    expect(result.message).toBe('bad revert')
+    expect(result.errorName).toBe('unknown')
+  })
+})
+
+describe('serialize', () => {
+  test('serializes InsufficientBalance', () => {
+    const parsed = ExecutionError.parse(
+      Object.assign(new Error(''), { data: insufficientBalanceData }),
+    )
+    const serialized = ExecutionError.serialize(parsed)
+    expect(serialized).toMatchInlineSnapshot(`
+      {
+        "abiItem": {
+          "inputs": [
+            {
+              "name": "available",
+              "type": "uint256",
+            },
+            {
+              "name": "required",
+              "type": "uint256",
+            },
+            {
+              "name": "token",
+              "type": "address",
+            },
+          ],
+          "name": "InsufficientBalance",
+          "type": "error",
+        },
+        "data": "0x832f98b500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f5e10000000000000000000000000020c0000000000000000000000000000000000001",
+        "errorName": "InsufficientBalance",
+        "message": "Insufficient balance. Required: 100000000, available: 0.",
+      }
+    `)
+  })
+
+  test('serializes unknown error', () => {
+    const parsed = ExecutionError.parse(new Error('boom'))
+    const serialized = ExecutionError.serialize(parsed)
+    expect(serialized).toMatchInlineSnapshot(`
+      {
+        "errorName": "unknown",
+        "message": "boom",
+      }
+    `)
+  })
+
+  test('serializes error with no args', () => {
+    const parsed = ExecutionError.parse(Object.assign(new Error(''), { data: unauthorizedData }))
+    const serialized = ExecutionError.serialize(parsed)
+    expect(serialized.errorName).toBe('Unauthorized')
+  })
+})
+
+describe('messages', () => {
+  test('all messages end with a period', () => {
+    for (const [name, msg] of Object.entries(ExecutionError.messages))
+      expect(msg, `${name} message should end with "."`).toMatch(/\.$/)
+  })
+
+  test('templated messages contain placeholders', () => {
+    expect(ExecutionError.messages.InsufficientBalance).toContain('{0}')
+    expect(ExecutionError.messages.InsufficientBalance).toContain('{1}')
+    expect(ExecutionError.messages.TokenAlreadyExists).toContain('{0}')
+  })
+})