ox 1.7.4 → 1.8.0

package/dist/core/Frame.d.ts.map

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

package/dist/core/Frame.js

@@ -0,0 +1,306 @@
+import * as Address from './Address.js';
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+import * as Quantity from './internal/quantity.js';
+/** Frame execution modes. */
+export const modes = { default: 0, sender: 2, verify: 1 };
+/** Approval and atomic batching flags. */
+export const flags = {
+    approveExecution: 2,
+    approveExecutionAndPayment: 3,
+    approvePayment: 1,
+    atomicBatch: 4,
+    none: 0,
+};
+/**
+ * Asserts that a {@link ox#Frame.Frame} satisfies frame-local constraints.
+ *
+ * Sender-dependent approval, batch adjacency, expiry, and transaction-wide gas
+ * constraints require the enclosing transaction.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * Check a verification frame before including it in a transaction.
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * Frame.assert({
+ *   flags: 'approveExecutionAndPayment',
+ *   gas: 50_000n,
+ *   mode: 'verify'
+ * })
+ * ```
+ *
+ * @param frame - The frame to assert.
+ */
+export function assert(frame) {
+    const { data = '0x', flags: flagsValue = 0, gas = 0n, mode: modeValue = 0, stateGas = 0n, value = 0n, } = frame;
+    const mode = typeof modeValue === 'string' ? modes[modeValue] : modeValue;
+    if (!Number.isInteger(mode) || mode < 0 || mode > 2)
+        throw new InvalidError('mode must be a supported name or 0, 1, or 2.');
+    const flags_ = typeof flagsValue === 'string' ? flags[flagsValue] : flagsValue;
+    if (!Number.isInteger(flags_) || flags_ < 0 || flags_ > 7)
+        throw new InvalidError('flags must be a supported name or an integer from 0 to 7.');
+    if (flags_ & flags.atomicBatch) {
+        if (mode === modes.verify)
+            throw new InvalidError('VERIFY frames cannot belong to an atomic batch.');
+        if (flags_ & flags.approveExecutionAndPayment)
+            throw new InvalidError('Atomic batch frames cannot approve execution or payment.');
+    }
+    if (frame.target !== undefined)
+        Address.assert(frame.target, { strict: false });
+    for (const [field, limit] of [
+        ['gas', gas],
+        ['stateGas', stateGas],
+    ])
+        if (typeof limit !== 'bigint' || limit < 0n || limit >= 2n ** 64n)
+            throw new InvalidError(`${field} must be an unsigned 64-bit integer.`);
+    if (gas + stateGas >= 2n ** 64n)
+        throw new InvalidError('Combined frame gas must be less than 2^64.');
+    if (typeof value !== 'bigint' || value < 0n || value >= 2n ** 256n)
+        throw new InvalidError('value must be an unsigned 256-bit integer.');
+    if (mode !== modes.sender && value !== 0n)
+        throw new InvalidError('Only SENDER frames can transfer value.');
+    Hex.assert(data, { strict: true });
+    if (data.length % 2 !== 0)
+        throw new InvalidError('data must contain whole bytes.');
+}
+/**
+ * Coerces a frame object into a {@link ox#Frame.Frame}.
+ *
+ * Validates the frame and returns a copy, preserving literal types and the supplied
+ * numeric or named mode and flags. Omitted fields stay omitted;
+ * {@link ox#Frame.(toTuple:function)} supplies their defaults when encoding.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * Construct a verification frame that approves execution and payment.
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const frame = Frame.from({
+ *   flags: 'approveExecutionAndPayment',
+ *   gas: 50_000n,
+ *   mode: 'verify'
+ * })
+ * ```
+ *
+ * @param frame - The frame object to convert.
+ * @returns The validated frame.
+ */
+export function from(frame) {
+    assert(frame);
+    return { ...frame };
+}
+/**
+ * Converts an RPC frame to a frame.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const frame = Frame.fromRpc({
+ *   data: '0x',
+ *   executionGasLimit: '0xc350',
+ *   flags: 3,
+ *   mode: 1,
+ *   stateGasLimit: '0x0',
+ *   value: '0x0'
+ * })
+ * ```
+ *
+ * @param frame - The value to convert.
+ * @returns The converted value.
+ */
+export function fromRpc(frame) {
+    return from({
+        data: frame.data,
+        flags: frame.flags,
+        gas: Hex.toBigInt(frame.executionGasLimit),
+        mode: frame.mode,
+        stateGas: Hex.toBigInt(frame.stateGasLimit),
+        ...(frame.target == null ? {} : { target: frame.target }),
+        value: Hex.toBigInt(frame.value),
+    });
+}
+/**
+ * Converts a frame to its JSON-RPC representation.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const frame = Frame.from({ gas: 50_000n, mode: 'verify' })
+ * const rpc = Frame.toRpc(frame)
+ * ```
+ *
+ * @param frame - The value to convert.
+ * @returns The converted value.
+ */
+export function toRpc(frame) {
+    const { flags: flags_ = 0, mode = 0 } = frame;
+    return {
+        data: frame.data ?? '0x',
+        executionGasLimit: Quantity.fromNumberish(frame.gas ?? 0n),
+        flags: typeof flags_ === 'string' ? flags[flags_] : flags_,
+        mode: typeof mode === 'string' ? modes[mode] : mode,
+        stateGasLimit: Quantity.fromNumberish(frame.stateGas ?? 0n),
+        ...(frame.target === undefined ? {} : { target: frame.target }),
+        value: Quantity.fromNumberish(frame.value ?? 0n),
+    };
+}
+/**
+ * Converts a {@link ox#Frame.Tuple} to a {@link ox#Frame.Frame}.
+ *
+ * Returns numeric mode and flags. An empty target becomes an omitted `target`.
+ * Integer fields must use minimal whole-byte encodings, with empty bytes for zero.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * Decode a frame tuple with separate execution and state gas limits.
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const frame = Frame.fromTuple([
+ *   '0x01',
+ *   '0x03',
+ *   '0x',
+ *   ['0xc350', '0x'],
+ *   '0x',
+ *   '0x'
+ * ])
+ * // @log: {
+ * // @log:   data: '0x',
+ * // @log:   flags: 3,
+ * // @log:   gas: 50000n,
+ * // @log:   mode: 1,
+ * // @log:   stateGas: 0n,
+ * // @log:   value: 0n
+ * // @log: }
+ * ```
+ *
+ * @param tuple - The frame tuple to convert.
+ * @returns The decoded frame.
+ */
+export function fromTuple(tuple) {
+    if (!Array.isArray(tuple) ||
+        tuple.length !== 6 ||
+        !Array.isArray(tuple[3]) ||
+        tuple[3].length !== 2)
+        throw new InvalidError('Expected [mode, flags, target, [execution, state], value, data].');
+    const [mode, flags, target, [execution, state], value, data] = tuple;
+    Hex.assert(target, { strict: true });
+    Hex.assert(data, { strict: true });
+    const quantities = [mode, flags, execution, state, value];
+    for (const quantity of quantities) {
+        Hex.assert(quantity, { strict: true });
+        if (quantity.length % 2 !== 0 || quantity.startsWith('0x00'))
+            throw new InvalidError('Integers must use minimal whole-byte encodings, with empty bytes for zero.');
+    }
+    const frame = {
+        ...(target === '0x' ? {} : { target }),
+        data,
+        flags: flags === '0x' ? 0 : Hex.toNumber(flags),
+        gas: execution === '0x' ? 0n : Hex.toBigInt(execution),
+        mode: mode === '0x' ? 0 : Hex.toNumber(mode),
+        stateGas: state === '0x' ? 0n : Hex.toBigInt(state),
+        value: value === '0x' ? 0n : Hex.toBigInt(value),
+    };
+    assert(frame);
+    return frame;
+}
+/**
+ * Converts a {@link ox#Frame.Frame} to its RLP-ready {@link ox#Frame.Tuple}.
+ *
+ * Named mode and flags are encoded as integers. An omitted target and zero integer
+ * fields are encoded as empty bytes. Omitted mode and flags default to zero;
+ * omitted gas limits and value default to `0n`, and data defaults to `'0x'`.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * Encode a verification frame in the field order required by EIP-8141.
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const tuple = Frame.toTuple({
+ *   flags: 'approveExecutionAndPayment',
+ *   gas: 50_000n,
+ *   mode: 'verify'
+ * })
+ * // @log: ['0x01', '0x03', '0x', ['0xc350', '0x'], '0x', '0x']
+ * ```
+ *
+ * @param frame - The frame to convert.
+ * @returns The encoded frame tuple.
+ */
+export function toTuple(frame) {
+    assert(frame);
+    const mode = typeof frame.mode === 'string' ? modes[frame.mode] : (frame.mode ?? 0);
+    const flags_ = typeof frame.flags === 'string' ? flags[frame.flags] : (frame.flags ?? 0);
+    return [
+        mode ? Hex.fromBytes(Bytes.fromNumber(mode)) : '0x',
+        flags_ ? Hex.fromBytes(Bytes.fromNumber(flags_)) : '0x',
+        frame.target ?? '0x',
+        [
+            frame.gas ? Hex.fromBytes(Bytes.fromNumber(frame.gas)) : '0x',
+            frame.stateGas ? Hex.fromBytes(Bytes.fromNumber(frame.stateGas)) : '0x',
+        ],
+        frame.value ? Hex.fromBytes(Bytes.fromNumber(frame.value)) : '0x',
+        frame.data ?? '0x',
+    ];
+}
+/**
+ * Returns whether a {@link ox#Frame.Frame} satisfies frame-local constraints.
+ *
+ * Performs the same checks as {@link ox#Frame.(assert:function)}, returning `false`
+ * instead of throwing when the frame is invalid.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * Check whether a frame is structurally valid.
+ *
+ * ```ts twoslash
+ * import { Frame } from 'ox'
+ *
+ * const valid = Frame.validate({
+ *   flags: 'approveExecutionAndPayment',
+ *   gas: 50_000n,
+ *   mode: 'verify'
+ * })
+ * // @log: true
+ * ```
+ *
+ * @param frame - The frame to validate.
+ * @returns Whether the frame satisfies frame-local constraints.
+ */
+export function validate(frame) {
+    try {
+        assert(frame);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Thrown when an EIP-8141 frame is structurally invalid. */
+export class InvalidError extends Errors.BaseError {
+    name = 'Frame.InvalidError';
+    constructor(details) {
+        super('Invalid frame.', { details });
+    }
+}
+//# sourceMappingURL=Frame.js.map

package/dist/core/Frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Frame.js","sourceRoot":"","sources":["../../src/core/Frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAwDlD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAW,CAAA;AAKlE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,gBAAgB,EAAE,CAAC;IACnB,0BAA0B,EAAE,CAAC;IAC7B,cAAc,EAAE,CAAC;IACjB,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,CAAC;CACC,CAAA;AAeV;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,MAAM,EACJ,IAAI,GAAG,IAAI,EACX,KAAK,EAAE,UAAU,GAAG,CAAC,EACrB,GAAG,GAAG,EAAE,EACR,IAAI,EAAE,SAAS,GAAG,CAAC,EACnB,QAAQ,GAAG,EAAE,EACb,KAAK,GAAG,EAAE,GACX,GAAG,KAAK,CAAA;IACT,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACzE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC;QACjD,MAAM,IAAI,YAAY,CAAC,8CAA8C,CAAC,CAAA;IACxE,MAAM,MAAM,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;IAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC;QACvD,MAAM,IAAI,YAAY,CACpB,2DAA2D,CAC5D,CAAA;IACH,IAAI,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM;YACvB,MAAM,IAAI,YAAY,CAAC,iDAAiD,CAAC,CAAA;QAC3E,IAAI,MAAM,GAAG,KAAK,CAAC,0BAA0B;YAC3C,MAAM,IAAI,YAAY,CACpB,0DAA0D,CAC3D,CAAA;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IACjD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI;QAC3B,CAAC,KAAK,EAAE,GAAG,CAAC;QACZ,CAAC,UAAU,EAAE,QAAQ,CAAC;KACd;QACR,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,GAAG;YAC/D,MAAM,IAAI,YAAY,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAA;IAC1E,IAAI,GAAG,GAAG,QAAQ,IAAI,EAAE,IAAI,GAAG;QAC7B,MAAM,IAAI,YAAY,CAAC,4CAA4C,CAAC,CAAA;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,IAAI;QAChE,MAAM,IAAI,YAAY,CAAC,4CAA4C,CAAC,CAAA;IACtE,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,KAAK,EAAE;QACvC,MAAM,IAAI,YAAY,CAAC,wCAAwC,CAAC,CAAA;IAClE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC,gCAAgC,CAAC,CAAA;AAC5D,CAAC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,IAAI,CAA4B,KAAoB;IAClE,MAAM,CAAC,KAAK,CAAC,CAAA;IACb,OAAO,EAAE,GAAG,KAAK,EAAW,CAAA;AAC9B,CAAC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAU;IAChC,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QACzD,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;KACjC,CAAC,CAAA;AACJ,CAAC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,KAAK,CAAC,KAAkB;IACtC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,KAAK,CAAA;IAC7C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,iBAAiB,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;QAC1D,KAAK,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;QAC1D,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACnD,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;KACjD,CAAA;AACH,CAAC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAErB,MAAM,IAAI,YAAY,CACpB,kEAAkE,CACnE,CAAA;IACH,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAA;IACpE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IACzD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAC1D,MAAM,IAAI,YAAY,CACpB,4EAA4E,CAC7E,CAAA;IACL,CAAC;IACD,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QACtC,IAAI;QACJ,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC/C,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QACtD,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC5C,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnD,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;KACjD,CAAA;IACD,MAAM,CAAC,KAAK,CAAC,CAAA;IACb,OAAO,KAAK,CAAA;AACd,CAAC;AASD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAY;IAClC,MAAM,CAAC,KAAK,CAAC,CAAA;IACb,MAAM,IAAI,GACR,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;IACxE,MAAM,MAAM,GACV,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAC3E,OAAO;QACL,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACnD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACvD,KAAK,CAAC,MAAM,IAAI,IAAI;QACpB;YACE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7D,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;SACxE;QACD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACjE,KAAK,CAAC,IAAI,IAAI,IAAI;KACnB,CAAA;AACH,CAAC;AASD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAY;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAA;QACb,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAMD,6DAA6D;AAC7D,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,SAAS;IAC9B,IAAI,GAAG,oBAAoB,CAAA;IAE7C,YAAY,OAAe;QACzB,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IACtC,CAAC;CACF"}

package/dist/core/FrameReceipt.d.ts

@@ -0,0 +1,92 @@
+import type * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+import type * as Log from './Log.js';
+/** Receipt for one frame. Frame logs contain only address, data, and topics. */
+export type FrameReceipt<bigintType = bigint> = {
+    /** Execution gas used before transaction-level refunds. */
+    gasUsed: bigintType;
+    /** Logs emitted by this frame. */
+    logs: readonly Pick<Log.Log, 'address' | 'data' | 'topics'>[];
+    /** Final state gas after refills and rollbacks. */
+    stateGasUsed: bigintType;
+    /** Frame execution result. */
+    status: Status;
+};
+/** JSON-RPC receipt for one frame. */
+export type Rpc = {
+    /** Execution gas used. */
+    executionGasUsed: Hex.Hex;
+    /** Logs emitted by this frame. */
+    logs: readonly Pick<Log.Log, 'address' | 'data' | 'topics'>[];
+    /** Final state gas used. */
+    stateGasUsed: Hex.Hex;
+    /** Zero for failure, one for success, or two for a skipped frame. */
+    status: RpcStatus;
+};
+/** Frame execution status. */
+export type Status = 'reverted' | 'skipped' | 'success';
+/** Numeric JSON-RPC frame execution status. */
+export type RpcStatus = 0 | 1 | 2;
+/** RPC status to status mapping. */
+export declare const fromRpcStatus: {
+    readonly 0: "reverted";
+    readonly 1: "success";
+    readonly 2: "skipped";
+};
+/** Status to RPC status mapping. */
+export declare const toRpcStatus: {
+    readonly reverted: 0;
+    readonly skipped: 2;
+    readonly success: 1;
+};
+/**
+ * Converts an RPC frame receipt to a {@link ox#FrameReceipt.FrameReceipt}.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { FrameReceipt } from 'ox'
+ *
+ * const receipt = FrameReceipt.fromRpc({
+ *   executionGasUsed: '0x5208',
+ *   logs: [],
+ *   stateGasUsed: '0x0',
+ *   status: 1
+ * })
+ * ```
+ *
+ * @param receipt - The RPC frame receipt.
+ * @returns The frame receipt with bigint gas and a named status.
+ */
+export declare function fromRpc(receipt: Rpc): FrameReceipt;
+export declare namespace fromRpc {
+    type ErrorType = Hex.toBigInt.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Converts a {@link ox#FrameReceipt.FrameReceipt} to an RPC frame receipt.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { FrameReceipt } from 'ox'
+ *
+ * const receipt = FrameReceipt.fromRpc({
+ *   executionGasUsed: '0x5208',
+ *   logs: [],
+ *   stateGasUsed: '0x0',
+ *   status: 1
+ * })
+ * const rpc = FrameReceipt.toRpc(receipt)
+ * ```
+ *
+ * @param receipt - The frame receipt. Gas accepts hex, bigint, or number values.
+ * @returns The RPC frame receipt with hex gas and a numeric status.
+ */
+export declare function toRpc(receipt: toRpc.Input): Rpc;
+export declare namespace toRpc {
+    type Input = FrameReceipt<Hex.Hex | bigint | number>;
+    type ErrorType = Hex.fromNumber.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=FrameReceipt.d.ts.map

package/dist/core/FrameReceipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameReceipt.d.ts","sourceRoot":"","sources":["../../src/core/FrameReceipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAA;AAEpC,gFAAgF;AAChF,MAAM,MAAM,YAAY,CAAC,UAAU,GAAG,MAAM,IAAI;IAC9C,2DAA2D;IAC3D,OAAO,EAAE,UAAU,CAAA;IACnB,kCAAkC;IAClC,IAAI,EAAE,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAA;IAC7D,mDAAmD;IACnD,YAAY,EAAE,UAAU,CAAA;IACxB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,GAAG,GAAG;IAChB,0BAA0B;IAC1B,gBAAgB,EAAE,GAAG,CAAC,GAAG,CAAA;IACzB,kCAAkC;IAClC,IAAI,EAAE,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAA;IAC7D,4BAA4B;IAC5B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAA;IACrB,qEAAqE;IACrE,MAAM,EAAE,SAAS,CAAA;CAClB,CAAA;AAED,8BAA8B;AAC9B,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAEvD,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEjC,oCAAoC;AACpC,eAAO,MAAM,aAAa;;;;CAIhB,CAAA;AAEV,oCAAoC;AACpC,eAAO,MAAM,WAAW;;;;CAId,CAAA;AAEV;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,YAAY,CAOlD;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAO/C;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;IAEpD,KAAK,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACnE"}

package/dist/core/FrameReceipt.js

@@ -0,0 +1,72 @@
+import * as Hex from './Hex.js';
+import * as Quantity from './internal/quantity.js';
+/** RPC status to status mapping. */
+export const fromRpcStatus = {
+    0: 'reverted',
+    1: 'success',
+    2: 'skipped',
+};
+/** Status to RPC status mapping. */
+export const toRpcStatus = {
+    reverted: 0,
+    skipped: 2,
+    success: 1,
+};
+/**
+ * Converts an RPC frame receipt to a {@link ox#FrameReceipt.FrameReceipt}.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { FrameReceipt } from 'ox'
+ *
+ * const receipt = FrameReceipt.fromRpc({
+ *   executionGasUsed: '0x5208',
+ *   logs: [],
+ *   stateGasUsed: '0x0',
+ *   status: 1
+ * })
+ * ```
+ *
+ * @param receipt - The RPC frame receipt.
+ * @returns The frame receipt with bigint gas and a named status.
+ */
+export function fromRpc(receipt) {
+    return {
+        gasUsed: Hex.toBigInt(receipt.executionGasUsed),
+        logs: receipt.logs,
+        stateGasUsed: Hex.toBigInt(receipt.stateGasUsed),
+        status: fromRpcStatus[receipt.status],
+    };
+}
+/**
+ * Converts a {@link ox#FrameReceipt.FrameReceipt} to an RPC frame receipt.
+ *
+ * @example
+ * ### Basic Usage
+ *
+ * ```ts twoslash
+ * import { FrameReceipt } from 'ox'
+ *
+ * const receipt = FrameReceipt.fromRpc({
+ *   executionGasUsed: '0x5208',
+ *   logs: [],
+ *   stateGasUsed: '0x0',
+ *   status: 1
+ * })
+ * const rpc = FrameReceipt.toRpc(receipt)
+ * ```
+ *
+ * @param receipt - The frame receipt. Gas accepts hex, bigint, or number values.
+ * @returns The RPC frame receipt with hex gas and a numeric status.
+ */
+export function toRpc(receipt) {
+    return {
+        executionGasUsed: Quantity.fromNumberish(receipt.gasUsed),
+        logs: receipt.logs,
+        stateGasUsed: Quantity.fromNumberish(receipt.stateGasUsed),
+        status: toRpcStatus[receipt.status],
+    };
+}
+//# sourceMappingURL=FrameReceipt.js.map

package/dist/core/FrameReceipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameReceipt.js","sourceRoot":"","sources":["../../src/core/FrameReceipt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAiClD,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;CACJ,CAAA;AAEV,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;CACF,CAAA;AAEV;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CAAC,OAAY;IAClC,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAC/C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;QAChD,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;KACtC,CAAA;AACH,CAAC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,KAAK,CAAC,OAAoB;IACxC,OAAO;QACL,gBAAgB,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;QACzD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1D,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAA;AACH,CAAC"}