ox 0.0.1 → 0.1.0

package/_esm/Rlp.js

@@ -0,0 +1,267 @@
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as Hex from './Hex.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');
+}
+toBytes.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * 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');
+}
+toHex.parseError = (error) => 
+/* v8 ignore next */
+error;
+/////////////////////////////////////////////////////////////////////////////////
+// Internal
+/////////////////////////////////////////////////////////////////////////////////
+/** @internal */
+export function to(value, to) {
+    const to_ = to ?? (typeof value === 'string' ? 'Hex' : 'Bytes');
+    const bytes = (() => {
+        if (typeof value === 'string') {
+            if (value.length > 3 && value.length % 2 !== 0)
+                throw new Hex.InvalidLengthError(value);
+            return Bytes.fromHex(value);
+        }
+        return value;
+    })();
+    const cursor = Cursor.create(bytes, {
+        recursiveReadLimit: Number.POSITIVE_INFINITY,
+    });
+    const result = decodeRlpCursor(cursor, to_);
+    return result;
+}
+/** @internal */
+to.parseError = (error) => 
+/* v8 ignore next */
+error;
+/** @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;
+    const encodable = getEncodable(value);
+    const cursor = Cursor.create(new Uint8Array(encodable.length));
+    encodable.encode(cursor);
+    if (as === 'Hex')
+        return Hex.fromBytes(cursor.bytes);
+    return cursor.bytes;
+}
+from.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * 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 });
+}
+fromBytes.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * 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 });
+}
+fromHex.parseError = (error) => 
+/* v8 ignore next */
+error;
+/////////////////////////////////////////////////////////////////////////////////
+// Internal
+/////////////////////////////////////////////////////////////////////////////////
+function getEncodable(bytes) {
+    if (Array.isArray(bytes))
+        return getEncodableList(bytes.map((x) => getEncodable(x)));
+    return getEncodableBytes(bytes);
+}
+function getEncodableList(list) {
+    const bodyLength = list.reduce((acc, x) => acc + x.length, 0);
+    const sizeOfBodyLength = getSizeOfLength(bodyLength);
+    const length = (() => {
+        if (bodyLength <= 55)
+            return 1 + bodyLength;
+        return 1 + sizeOfBodyLength + bodyLength;
+    })();
+    return {
+        length,
+        encode(cursor) {
+            if (bodyLength <= 55) {
+                cursor.pushByte(0xc0 + bodyLength);
+            }
+            else {
+                cursor.pushByte(0xc0 + 55 + sizeOfBodyLength);
+                if (sizeOfBodyLength === 1)
+                    cursor.pushUint8(bodyLength);
+                else if (sizeOfBodyLength === 2)
+                    cursor.pushUint16(bodyLength);
+                else if (sizeOfBodyLength === 3)
+                    cursor.pushUint24(bodyLength);
+                else
+                    cursor.pushUint32(bodyLength);
+            }
+            for (const { encode } of list) {
+                encode(cursor);
+            }
+        },
+    };
+}
+function getEncodableBytes(bytesOrHex) {
+    const bytes = typeof bytesOrHex === 'string' ? Bytes.fromHex(bytesOrHex) : bytesOrHex;
+    const sizeOfBytesLength = getSizeOfLength(bytes.length);
+    const length = (() => {
+        if (bytes.length === 1 && bytes[0] < 0x80)
+            return 1;
+        if (bytes.length <= 55)
+            return 1 + bytes.length;
+        return 1 + sizeOfBytesLength + bytes.length;
+    })();
+    return {
+        length,
+        encode(cursor) {
+            if (bytes.length === 1 && bytes[0] < 0x80) {
+                cursor.pushBytes(bytes);
+            }
+            else if (bytes.length <= 55) {
+                cursor.pushByte(0x80 + bytes.length);
+                cursor.pushBytes(bytes);
+            }
+            else {
+                cursor.pushByte(0x80 + 55 + sizeOfBytesLength);
+                if (sizeOfBytesLength === 1)
+                    cursor.pushUint8(bytes.length);
+                else if (sizeOfBytesLength === 2)
+                    cursor.pushUint16(bytes.length);
+                else if (sizeOfBytesLength === 3)
+                    cursor.pushUint24(bytes.length);
+                else
+                    cursor.pushUint32(bytes.length);
+                cursor.pushBytes(bytes);
+            }
+        },
+    };
+}
+function getSizeOfLength(length) {
+    if (length < 2 ** 8)
+        return 1;
+    if (length < 2 ** 16)
+        return 2;
+    if (length < 2 ** 24)
+        return 3;
+    if (length < 2 ** 32)
+        return 4;
+    throw new Errors.BaseError('Length is too large.');
+}
+//# sourceMappingURL=Rlp.js.map

package/_esm/Rlp.js.map

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

package/_esm/RpcRequest.js

@@ -0,0 +1,131 @@
+/**
+ * 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 the {@link ox#RpcSchema.From} type.
+ *
+ * ```ts twoslash
+ * import { RpcSchema, RpcRequest } from 'ox'
+ *
+ * type 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 function createStore(options = {}) {
+    let id = options.id ?? 0;
+    return {
+        prepare(options) {
+            return from({
+                id: id++,
+                ...options,
+            });
+        },
+        get id() {
+            return id;
+        },
+    };
+}
+createStore.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * 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 function from(options) {
+    return {
+        ...options,
+        jsonrpc: '2.0',
+    };
+}
+from.parseError = (error) => 
+/* v8 ignore next */
+error;
+//# sourceMappingURL=RpcRequest.js.map

package/_esm/RpcRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcRequest.js","sourceRoot":"","sources":["../RpcRequest.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,UAAU,WAAW,CAEzB,UAA+B,EAAE;IACjC,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,CAAC,CAAA;IACxB,OAAO;QACL,OAAO,CAAC,OAAO;YACb,OAAO,IAAI,CAAC;gBACV,EAAE,EAAE,EAAE,EAAE;gBACR,GAAG,OAAO;aACF,CAAU,CAAA;QACtB,CAAC;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,CAAA;QACX,CAAC;KACF,CAAA;AACH,CAAC;AAcD,WAAW,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;AAC1C,oBAAoB;AACpB,KAA8B,CAAA;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,UAAU,IAAI,CAClB,OAAiC;IAEjC,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE,KAAK;KACN,CAAA;AACZ,CAAC;AAgBD,IAAI,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;AACnC,oBAAoB;AACpB,KAAuB,CAAA"}