ox 0.14.28 → 1.0.0-beta.0

package/dist/core/Rlp.js

@@ -0,0 +1,485 @@
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+import * as internal_bytes from './internal/bytes.js';
+import * as Cursor from './internal/cursor.js';
+/**
+ * Decodes a Recursive-Length Prefix (RLP) value into a {@link ox#Bytes.Bytes} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Rlp } from 'ox'
+ * Rlp.toBytes('0x8b68656c6c6f20776f726c64')
+ * // Uint8Array([139, 104, 101, 108, 108, 111,  32, 119, 111, 114, 108, 100])
+ * ```
+ *
+ * @param value - The value to decode.
+ * @returns The decoded {@link ox#Bytes.Bytes} value.
+ */
+export function toBytes(value) {
+    return to(value, 'Bytes');
+}
+/**
+ * Decodes a Recursive-Length Prefix (RLP) value into a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Rlp } from 'ox'
+ * Rlp.toHex('0x8b68656c6c6f20776f726c64')
+ * // 0x68656c6c6f20776f726c64
+ * ```
+ *
+ * @param value - The value to decode.
+ * @returns The decoded {@link ox#Hex.Hex} value.
+ */
+export function toHex(value) {
+    return to(value, 'Hex');
+}
+/////////////////////////////////////////////////////////////////////////////////
+// Internal
+/////////////////////////////////////////////////////////////////////////////////
+/** @internal */
+export function to(value, to) {
+    const to_ = to ?? (typeof value === 'string' ? 'Hex' : 'Bytes');
+    const bytes = typeof value === 'string' ? Bytes.fromHex(value) : value;
+    const cursor = Cursor.create(bytes, {
+        recursiveReadLimit: Number.POSITIVE_INFINITY,
+    });
+    const result = decodeRlpCursor(cursor, to_);
+    return result;
+}
+/** @internal */
+/** @internal */
+export function decodeRlpCursor(cursor, to = 'Hex') {
+    if (cursor.bytes.length === 0)
+        return (to === 'Hex' ? Hex.fromBytes(cursor.bytes) : cursor.bytes);
+    const prefix = cursor.readByte();
+    if (prefix < 0x80)
+        cursor.decrementPosition(1);
+    // bytes
+    if (prefix < 0xc0) {
+        const length = readLength(cursor, prefix, 0x80);
+        const bytes = cursor.readBytes(length);
+        return (to === 'Hex' ? Hex.fromBytes(bytes) : bytes);
+    }
+    // list
+    const length = readLength(cursor, prefix, 0xc0);
+    return readList(cursor, length, to);
+}
+/** @internal */
+export function readLength(cursor, prefix, offset) {
+    if (offset === 0x80 && prefix < 0x80)
+        return 1;
+    if (prefix <= offset + 55)
+        return prefix - offset;
+    if (prefix === offset + 55 + 1)
+        return cursor.readUint8();
+    if (prefix === offset + 55 + 2)
+        return cursor.readUint16();
+    if (prefix === offset + 55 + 3)
+        return cursor.readUint24();
+    if (prefix === offset + 55 + 4)
+        return cursor.readUint32();
+    throw new Errors.BaseError('Invalid RLP prefix');
+}
+/** @internal */
+export function readList(cursor, length, to) {
+    const position = cursor.position;
+    const value = [];
+    while (cursor.position - position < length)
+        value.push(decodeRlpCursor(cursor, to));
+    return value;
+}
+/**
+ * Encodes a {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value into a Recursive-Length Prefix (RLP) value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes, Rlp } from 'ox'
+ *
+ * Rlp.from('0x68656c6c6f20776f726c64', { as: 'Hex' })
+ * // @log: 0x8b68656c6c6f20776f726c64
+ *
+ * Rlp.from(
+ *   Bytes.from([
+ *     139, 104, 101, 108, 108, 111, 32, 119, 111, 114, 108,
+ *     100
+ *   ]),
+ *   { as: 'Bytes' }
+ * )
+ * // @log: Uint8Array([104, 101, 108, 108, 111,  32, 119, 111, 114, 108, 100])
+ * ```
+ *
+ * @param value - The {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value to encode.
+ * @param options - Options.
+ * @returns The RLP value.
+ */
+export function from(value, options) {
+    const { as } = options;
+    // Two-walk encode without the per-node `Encodable` closure tree:
+    // 1. `measure` walks the input once and caches each list's `bodyLength`
+    //    in a side array indexed by visit order. This makes the second walk
+    //    O(N) instead of O(N²) for nested inputs.
+    // 2. `writeEncoded` walks again, reads cached body lengths, and writes
+    //    bytes straight into the pre-sized buffer. Hex leaves are
+    //    nibble-decoded directly into the destination, skipping the per-leaf
+    //    `Bytes.fromHex` allocation.
+    const ctx = { lengths: [], cursor: 0 };
+    const totalLength = measure(value, ctx);
+    // Hex-output fast path: when the caller asked for hex AND every leaf is
+    // already hex, emit a hex string directly instead of allocating an
+    // intermediate `Uint8Array` and round-tripping through `Hex.fromBytes`.
+    // This is the dominant shape for transaction envelope serialize.
+    if (as === 'Hex' && isAllHex(value)) {
+        const parts = [];
+        writeEncodedHex(parts, value, {
+            lengths: ctx.lengths,
+            cursor: 0,
+        });
+        return `0x${parts.join('')}`;
+    }
+    const bytes = new Uint8Array(totalLength);
+    writeEncoded(bytes, 0, value, { lengths: ctx.lengths, cursor: 0 });
+    if (as === 'Hex')
+        return Hex.fromBytes(bytes);
+    return bytes;
+}
+/**
+ * Encodes a {@link ox#Bytes.Bytes} value into a Recursive-Length Prefix (RLP) value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes, Rlp } from 'ox'
+ *
+ * Rlp.fromBytes(
+ *   Bytes.from([
+ *     139, 104, 101, 108, 108, 111, 32, 119, 111, 114, 108,
+ *     100
+ *   ])
+ * )
+ * // @log: Uint8Array([104, 101, 108, 108, 111,  32, 119, 111, 114, 108, 100])
+ * ```
+ *
+ * @param bytes - The {@link ox#Bytes.Bytes} value to encode.
+ * @param options - Options.
+ * @returns The RLP value.
+ */
+export function fromBytes(bytes, options = {}) {
+    const { as = 'Bytes' } = options;
+    return from(bytes, { as });
+}
+/**
+ * Encodes a {@link ox#Hex.Hex} value into a Recursive-Length Prefix (RLP) value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Rlp } from 'ox'
+ *
+ * Rlp.fromHex('0x68656c6c6f20776f726c64')
+ * // @log: 0x8b68656c6c6f20776f726c64
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to encode.
+ * @param options - Options.
+ * @returns The RLP value.
+ */
+export function fromHex(hex, options = {}) {
+    const { as = 'Hex' } = options;
+    return from(hex, { as });
+}
+/////////////////////////////////////////////////////////////////////////////////
+// Internal
+/////////////////////////////////////////////////////////////////////////////////
+/**
+ * Returns the byte length needed to encode `length` itself (1-4 bytes per
+ * RLP), or throws when `length` exceeds the protocol cap.
+ *
+ * @internal
+ */
+function getSizeOfLength(length) {
+    if (length <= 0xff)
+        return 1;
+    if (length <= 0xff_ff)
+        return 2;
+    if (length <= 0xff_ff_ff)
+        return 3;
+    if (length <= 0xff_ff_ff_ff)
+        return 4;
+    throw new Errors.BaseError('Length is too large.');
+}
+/**
+ * Walks `value` once, caches each list's `bodyLength` into `ctx.lengths`,
+ * and returns the total encoded byte length. Allocates nothing per node
+ * beyond the shared `lengths` array entries.
+ *
+ * @internal
+ */
+function measure(value, ctx) {
+    if (Array.isArray(value)) {
+        // Reserve this list's slot before descending so children's slots come
+        // after ours; `writeEncoded` walks in the same order and reads slot N
+        // when it visits the Nth list.
+        const slot = ctx.lengths.length;
+        ctx.lengths.push(0);
+        let bodyLength = 0;
+        for (let i = 0; i < value.length; i++)
+            bodyLength += measure(value[i], ctx);
+        ctx.lengths[slot] = bodyLength;
+        if (bodyLength <= 55)
+            return 1 + bodyLength;
+        return 1 + getSizeOfLength(bodyLength) + bodyLength;
+    }
+    // Hex leaf: byte length = ceil((hex.length - 2) / 2). The `>> 1` of
+    // `length - 1` yields ceil for both odd- and even-nibble inputs.
+    if (typeof value === 'string') {
+        const byteLen = (value.length - 1) >> 1;
+        if (byteLen === 0)
+            return 1;
+        if (byteLen === 1) {
+            // Single-byte values < 0x80 encode as themselves (no prefix).
+            const odd = (value.length & 1) === 1;
+            const firstChar = value.charCodeAt(odd ? 2 : 3);
+            const high = odd
+                ? 0
+                : (internal_bytes.charCodeToBase16(value.charCodeAt(2)) ?? 0) << 4;
+            const low = internal_bytes.charCodeToBase16(firstChar) ?? 0;
+            const byte = high | low;
+            if (byte < 0x80)
+                return 1;
+            return 2;
+        }
+        if (byteLen <= 55)
+            return 1 + byteLen;
+        return 1 + getSizeOfLength(byteLen) + byteLen;
+    }
+    // Bytes leaf
+    const len = value.length;
+    if (len === 1 && value[0] < 0x80)
+        return 1;
+    if (len <= 55)
+        return 1 + len;
+    return 1 + getSizeOfLength(len) + len;
+}
+/**
+ * Writes `value`'s RLP encoding into `bytes` starting at `offset` and returns
+ * the next free offset. Reads list body lengths from `ctx.lengths` in the
+ * same DFS order that `measure` filled them. Hex leaves are nibble-decoded
+ * directly into the destination, skipping the per-leaf `Bytes.fromHex`
+ * allocation.
+ *
+ * @internal
+ */
+function writeEncoded(bytes, offset, value, ctx) {
+    if (Array.isArray(value)) {
+        const bodyLength = ctx.lengths[ctx.cursor++];
+        let cursor = offset;
+        if (bodyLength <= 55) {
+            bytes[cursor++] = 0xc0 + bodyLength;
+        }
+        else {
+            const sizeOfBodyLength = getSizeOfLength(bodyLength);
+            bytes[cursor++] = 0xc0 + 55 + sizeOfBodyLength;
+            cursor = writeBigEndian(bytes, cursor, bodyLength, sizeOfBodyLength);
+        }
+        for (let i = 0; i < value.length; i++)
+            cursor = writeEncoded(bytes, cursor, value[i], ctx);
+        return cursor;
+    }
+    if (typeof value === 'string')
+        return writeHexLeaf(bytes, offset, value);
+    return writeBytesLeaf(bytes, offset, value);
+}
+/**
+ * Hex-leaf fast path: writes the RLP encoding of a hex string directly into
+ * `bytes` by nibble-decoding the source hex chars into the destination
+ * buffer. Even-pads odd-nibble hex (e.g. `'0x1'`) on the fly.
+ *
+ * @internal
+ */
+function writeHexLeaf(bytes, offset, hex) {
+    const dataStart = 2;
+    let byteLen = (hex.length - 2) >> 1;
+    let highNibbleFromOddPad = false;
+    if ((hex.length & 1) === 1) {
+        // Odd-nibble: first emitted byte's high nibble is `0` (left-pad).
+        byteLen += 1;
+        highNibbleFromOddPad = true;
+    }
+    // Empty leaf -> single 0x80 prefix byte (zero-length string in RLP).
+    if (byteLen === 0) {
+        bytes[offset] = 0x80;
+        return offset + 1;
+    }
+    // Single-byte fast path: if the byte < 0x80, write it as-is (no prefix).
+    if (byteLen === 1) {
+        let byte;
+        if (highNibbleFromOddPad) {
+            byte = internal_bytes.charCodeToBase16(hex.charCodeAt(dataStart)) ?? 0;
+        }
+        else {
+            const high = internal_bytes.charCodeToBase16(hex.charCodeAt(dataStart)) ?? 0;
+            const low = internal_bytes.charCodeToBase16(hex.charCodeAt(dataStart + 1)) ?? 0;
+            byte = (high << 4) | low;
+        }
+        if (byte < 0x80) {
+            bytes[offset] = byte;
+            return offset + 1;
+        }
+        bytes[offset] = 0x80 + 1;
+        bytes[offset + 1] = byte;
+        return offset + 2;
+    }
+    let dest = offset;
+    if (byteLen <= 55) {
+        bytes[dest++] = 0x80 + byteLen;
+    }
+    else {
+        const sizeOfBytesLength = getSizeOfLength(byteLen);
+        bytes[dest++] = 0x80 + 55 + sizeOfBytesLength;
+        dest = writeBigEndian(bytes, dest, byteLen, sizeOfBytesLength);
+    }
+    // Decode hex nibbles directly into the destination buffer.
+    let src = dataStart;
+    if (highNibbleFromOddPad) {
+        const low = internal_bytes.charCodeToBase16(hex.charCodeAt(src++));
+        if (low === undefined)
+            throw invalidNibble(hex);
+        bytes[dest++] = low;
+    }
+    while (src < hex.length) {
+        const high = internal_bytes.charCodeToBase16(hex.charCodeAt(src++));
+        const low = internal_bytes.charCodeToBase16(hex.charCodeAt(src++));
+        if (high === undefined || low === undefined)
+            throw invalidNibble(hex);
+        bytes[dest++] = (high << 4) | low;
+    }
+    return dest;
+}
+function writeBytesLeaf(bytes, offset, leaf) {
+    const len = leaf.length;
+    if (len === 1 && leaf[0] < 0x80) {
+        bytes[offset] = leaf[0];
+        return offset + 1;
+    }
+    let dest = offset;
+    if (len <= 55) {
+        bytes[dest++] = 0x80 + len;
+    }
+    else {
+        const sizeOfBytesLength = getSizeOfLength(len);
+        bytes[dest++] = 0x80 + 55 + sizeOfBytesLength;
+        dest = writeBigEndian(bytes, dest, len, sizeOfBytesLength);
+    }
+    bytes.set(leaf, dest);
+    return dest + len;
+}
+/**
+ * Returns true if every leaf in the (possibly nested) input is a hex string.
+ * Used to gate the hex-output fast path in `from`.
+ *
+ * @internal
+ */
+function isAllHex(value) {
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++)
+            if (!isAllHex(value[i]))
+                return false;
+        return true;
+    }
+    return typeof value === 'string';
+}
+/**
+ * Hex-output fast path: writes the RLP encoding of `value` directly as hex
+ * substrings into `parts`. Avoids the intermediate `Uint8Array` allocation
+ * (and the trailing `Hex.fromBytes` round-trip) used by the bytes path.
+ *
+ * Length-prefix bytes are formatted via the cached `hexes[]` table so we
+ * never call `toString(16)` per node.
+ *
+ * @internal
+ */
+function writeEncodedHex(parts, value, ctx) {
+    if (Array.isArray(value)) {
+        const bodyLength = ctx.lengths[ctx.cursor++];
+        if (bodyLength <= 55) {
+            parts.push(hexes[0xc0 + bodyLength]);
+        }
+        else {
+            const sizeOfBodyLength = getSizeOfLength(bodyLength);
+            parts.push(hexes[0xc0 + 55 + sizeOfBodyLength]);
+            parts.push(bigEndianHex(bodyLength, sizeOfBodyLength));
+        }
+        for (let i = 0; i < value.length; i++)
+            writeEncodedHex(parts, value[i], ctx);
+        return;
+    }
+    // Hex leaf: even-pad odd-nibble inputs and skip the `0x` prefix.
+    const hex = value;
+    const odd = (hex.length & 1) === 1;
+    const body = odd ? `0${hex.slice(2)}` : hex.slice(2);
+    const byteLen = body.length >> 1;
+    if (byteLen === 0) {
+        parts.push(hexes[0x80]);
+        return;
+    }
+    if (byteLen === 1) {
+        const byte = parseInt(body, 16);
+        if (byte < 0x80) {
+            parts.push(body);
+        }
+        else {
+            parts.push(hexes[0x81]);
+            parts.push(body);
+        }
+        return;
+    }
+    if (byteLen <= 55) {
+        parts.push(hexes[0x80 + byteLen]);
+        parts.push(body);
+        return;
+    }
+    const sizeOfBytesLength = getSizeOfLength(byteLen);
+    parts.push(hexes[0x80 + 55 + sizeOfBytesLength]);
+    parts.push(bigEndianHex(byteLen, sizeOfBytesLength));
+    parts.push(body);
+}
+const hexes = /*#__PURE__*/ Array.from({ length: 256 }, (_v, i) => i.toString(16).padStart(2, '0'));
+/**
+ * Returns the big-endian hex encoding of `value` in `size` bytes.
+ *
+ * @internal
+ */
+function bigEndianHex(value, size) {
+    if (size === 1)
+        return hexes[value & 0xff];
+    if (size === 2)
+        return `${hexes[(value >>> 8) & 0xff]}${hexes[value & 0xff]}`;
+    if (size === 3)
+        return `${hexes[(value >>> 16) & 0xff]}${hexes[(value >>> 8) & 0xff]}${hexes[value & 0xff]}`;
+    return `${hexes[(value >>> 24) & 0xff]}${hexes[(value >>> 16) & 0xff]}${hexes[(value >>> 8) & 0xff]}${hexes[value & 0xff]}`;
+}
+function writeBigEndian(bytes, offset, value, size) {
+    if (size === 1) {
+        bytes[offset] = value & 0xff;
+    }
+    else if (size === 2) {
+        bytes[offset] = (value >>> 8) & 0xff;
+        bytes[offset + 1] = value & 0xff;
+    }
+    else if (size === 3) {
+        bytes[offset] = (value >>> 16) & 0xff;
+        bytes[offset + 1] = (value >>> 8) & 0xff;
+        bytes[offset + 2] = value & 0xff;
+    }
+    else {
+        bytes[offset] = (value >>> 24) & 0xff;
+        bytes[offset + 1] = (value >>> 16) & 0xff;
+        bytes[offset + 2] = (value >>> 8) & 0xff;
+        bytes[offset + 3] = value & 0xff;
+    }
+    return offset + size;
+}
+function invalidNibble(hex) {
+    return new Errors.BaseError(`Invalid hex string \`${hex}\`.`);
+}
+//# sourceMappingURL=Rlp.js.map

package/dist/core/Rlp.js.map

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

package/dist/core/RpcRequest.d.ts

@@ -0,0 +1,152 @@
+import type { Errors } from '../index.js';
+import type * as RpcSchema_internal from './internal/rpcSchema.js';
+import type { Compute } from './internal/types.js';
+import type * as RpcSchema from './RpcSchema.js';
+/** A JSON-RPC request object as per the [JSON-RPC 2.0 specification](https://www.jsonrpc.org/specification#request_object). */
+export type RpcRequest<schema extends RpcSchema.Generic = RpcSchema.Generic> = Compute<schema extends any ? schema['Request'] & {
+    id: number;
+    jsonrpc: '2.0';
+    /** @deprecated internal */
+    _returnType: schema['ReturnType'];
+} : never>;
+/** JSON-RPC request store type. */
+export type Store<schema extends RpcSchema.Generic | undefined = undefined> = Compute<{
+    prepare: <methodName extends RpcSchema.MethodNameGeneric>(parameters: Compute<schema extends RpcSchema.Generic ? RpcSchema.ExtractRequest<schema, methodName> : RpcSchema_internal.ExtractRequestOpaque<RpcSchema.Default, methodName>>) => Compute<RpcRequest<RpcSchema.ExtractItem<schema extends RpcSchema.Generic ? schema : RpcSchema.Default, methodName>>>;
+    readonly id: number;
+}>;
+/**
+ * Creates a JSON-RPC request store to build requests with an incrementing `id`.
+ *
+ * Returns a type-safe `prepare` function to build a JSON-RPC request object as per the [JSON-RPC 2.0 specification](https://www.jsonrpc.org/specification#request_object).
+ *
+ * @example
+ * ```ts twoslash
+ * import { RpcRequest } from 'ox'
+ *
+ * const store = RpcRequest.createStore()
+ *
+ * const request_1 = store.prepare({
+ *   method: 'eth_blockNumber'
+ * })
+ * // @log: { id: 0, jsonrpc: '2.0', method: 'eth_blockNumber' }
+ *
+ * const request_2 = store.prepare({
+ *   method: 'eth_call',
+ *   params: [
+ *     {
+ *       to: '0x0000000000000000000000000000000000000000',
+ *       data: '0xdeadbeef'
+ *     }
+ *   ]
+ * })
+ * // @log: { id: 1, jsonrpc: '2.0', method: 'eth_call', params: [{ to: '0x0000000000000000000000000000000000000000', data: '0xdeadbeef' }] }
+ * ```
+ *
+ * @example
+ * ### Type-safe Custom Schemas
+ *
+ * It is possible to define your own type-safe schema by using {@link ox#RpcSchema.from}.
+ *
+ * ```ts twoslash
+ * import { RpcSchema, RpcRequest } from 'ox'
+ *
+ * const schema = RpcSchema.from<
+ *   | {
+ *       // [!code focus]
+ *       Request: {
+ *         // [!code focus]
+ *         method: 'eth_foobar' // [!code focus]
+ *         params: [number] // [!code focus]
+ *       } // [!code focus]
+ *       ReturnType: string // [!code focus]
+ *     }
+ *   | {
+ *       // [!code focus]
+ *       Request: {
+ *         // [!code focus]
+ *         method: 'eth_foobaz' // [!code focus]
+ *         params: [string] // [!code focus]
+ *       } // [!code focus]
+ *       ReturnType: string // [!code focus]
+ *     }
+ * >() // [!code focus]
+ *
+ * const store = RpcRequest.createStore({ schema }) // [!code focus]
+ *
+ * const request = store.prepare({
+ *   method: 'eth_foobar', // [!code focus]
+ *   // ^?
+ *   params: [42]
+ * })
+ * ```
+ *
+ * @param options - Request store options.
+ * @returns The request store
+ */
+export declare function createStore<schema extends RpcSchema.Generic | undefined = undefined>(options?: createStore.Options<schema>): createStore.ReturnType<schema>;
+export declare namespace createStore {
+    type Options<schema extends RpcSchema.Generic | undefined = undefined> = {
+        /** The initial request ID. */
+        id?: number;
+        /** RPC Schema to use for the request store. */
+        schema?: schema | RpcSchema.Generic | undefined;
+    };
+    type ReturnType<schema extends RpcSchema.Generic | undefined = undefined> = Store<schema>;
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * A type-safe interface to build a JSON-RPC request object as per the [JSON-RPC 2.0 specification](https://www.jsonrpc.org/specification#request_object).
+ *
+ * :::warning
+ *
+ * You will likely want to use {@link ox#RpcRequest.(createStore:function)} instead as it will also manage `id`s and uses this function internally.
+ *
+ * :::
+ *
+ * @example
+ * ```ts twoslash
+ * import { RpcRequest, RpcResponse } from 'ox'
+ *
+ * // 1. Build a request object.
+ * const request = RpcRequest.from({
+ *   // [!code focus]
+ *   id: 0, // [!code focus]
+ *   method: 'eth_estimateGas', // [!code focus]
+ *   params: [
+ *     // [!code focus]
+ *     {
+ *       // [!code focus]
+ *       from: '0xd2135CfB216b74109775236E36d4b433F1DF507B', // [!code focus]
+ *       to: '0x0D44f617435088c947F00B31160f64b074e412B4', // [!code focus]
+ *       value: '0x69420' // [!code focus]
+ *     } // [!code focus]
+ *   ] // [!code focus]
+ * }) // [!code focus]
+ *
+ * // 2. Send the JSON-RPC request via HTTP.
+ * const gas = await fetch('https://1.rpc.thirdweb.com', {
+ *   body: JSON.stringify(request),
+ *   headers: {
+ *     'Content-Type': 'application/json'
+ *   },
+ *   method: 'POST'
+ * })
+ *   .then((response) => response.json())
+ *   // 3. Parse the JSON-RPC response into a type-safe result.
+ *   .then((response) =>
+ *     RpcResponse.parse(response, { request })
+ *   )
+ * ```
+ *
+ * @param options - JSON-RPC request options.
+ * @returns The fully-formed JSON-RPC request object.
+ */
+export declare function from<methodName extends RpcSchema.MethodNameGeneric>(options: from.Options<methodName>): from.ReturnType<methodName>;
+export declare namespace from {
+    type Options<methodName extends RpcSchema.MethodNameGeneric> = Compute<RpcSchema_internal.ExtractRequestOpaque<RpcSchema.Default, methodName> & {
+        id: number;
+    }>;
+    type ReturnType<methodName extends RpcSchema.MethodNameGeneric> = Compute<RpcRequest<RpcSchema.ExtractItem<RpcSchema.Default, methodName>>>;
+    type ErrorType = Errors.GlobalErrorType;
+}
+//# sourceMappingURL=RpcRequest.d.ts.map

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

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