ox 0.0.1 → 0.1.0

package/_esm/Block.js

@@ -0,0 +1,177 @@
+import * as Hex from './Hex.js';
+import * as Transaction from './Transaction.js';
+import * as Withdrawal from './Withdrawal.js';
+/**
+ * Converts a {@link ox#Block.Block} to an {@link ox#Block.Rpc}.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Block } from 'ox'
+ *
+ * const block = Block.toRpc({
+ *   // ...
+ *   hash: '0xebc3644804e4040c0a74c5a5bbbc6b46a71a5d4010fe0c92ebb2fdf4a43ea5dd',
+ *   number: 19868020n,
+ *   size: 520n
+ *   timestamp: 1662222222n,
+ *   // ...
+ * })
+ * // @log: {
+ * // @log:   // ...
+ * // @log:   hash: '0xebc3644804e4040c0a74c5a5bbbc6b46a71a5d4010fe0c92ebb2fdf4a43ea5dd',
+ * // @log:   number: '0xec6fc6',
+ * // @log:   size: '0x208',
+ * // @log:   timestamp: '0x63198f6f',
+ * // @log:   // ...
+ * // @log: }
+ * ```
+ *
+ * @param block - The Block to convert.
+ * @returns An RPC Block.
+ */
+export function toRpc(block, _options = {}) {
+    const transactions = block.transactions.map((transaction) => {
+        if (typeof transaction === 'string')
+            return transaction;
+        return Transaction.toRpc(transaction);
+    });
+    return {
+        baseFeePerGas: typeof block.baseFeePerGas === 'bigint'
+            ? Hex.fromNumber(block.baseFeePerGas)
+            : undefined,
+        blobGasUsed: typeof block.blobGasUsed === 'bigint'
+            ? Hex.fromNumber(block.blobGasUsed)
+            : undefined,
+        excessBlobGas: typeof block.excessBlobGas === 'bigint'
+            ? Hex.fromNumber(block.excessBlobGas)
+            : undefined,
+        extraData: block.extraData,
+        difficulty: typeof block.difficulty === 'bigint'
+            ? Hex.fromNumber(block.difficulty)
+            : undefined,
+        gasLimit: Hex.fromNumber(block.gasLimit),
+        gasUsed: Hex.fromNumber(block.gasUsed),
+        hash: block.hash,
+        logsBloom: block.logsBloom,
+        miner: block.miner,
+        mixHash: block.mixHash,
+        nonce: block.nonce,
+        number: (typeof block.number === 'bigint'
+            ? Hex.fromNumber(block.number)
+            : null),
+        parentBeaconBlockRoot: block.parentBeaconBlockRoot,
+        parentHash: block.parentHash,
+        receiptsRoot: block.receiptsRoot,
+        sealFields: block.sealFields,
+        sha3Uncles: block.sha3Uncles,
+        size: Hex.fromNumber(block.size),
+        stateRoot: block.stateRoot,
+        timestamp: Hex.fromNumber(block.timestamp),
+        totalDifficulty: typeof block.totalDifficulty === 'bigint'
+            ? Hex.fromNumber(block.totalDifficulty)
+            : undefined,
+        transactions,
+        transactionsRoot: block.transactionsRoot,
+        uncles: block.uncles,
+        withdrawals: block.withdrawals?.map(Withdrawal.toRpc),
+        withdrawalsRoot: block.withdrawalsRoot,
+    };
+}
+toRpc.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * Converts a {@link ox#Block.Rpc} to an {@link ox#Block.Block}.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Block } from 'ox'
+ *
+ * const block = Block.fromRpc({
+ *   // ...
+ *   hash: '0xebc3644804e4040c0a74c5a5bbbc6b46a71a5d4010fe0c92ebb2fdf4a43ea5dd',
+ *   number: '0xec6fc6',
+ *   size: '0x208',
+ *   timestamp: '0x63198f6f',
+ *   // ...
+ * })
+ * // @log: {
+ * // @log:   // ...
+ * // @log:   hash: '0xebc3644804e4040c0a74c5a5bbbc6b46a71a5d4010fe0c92ebb2fdf4a43ea5dd',
+ * // @log:   number: 19868020n,
+ * // @log:   size: 520n,
+ * // @log:   timestamp: 1662222222n,
+ * // @log:   // ...
+ * // @log: }
+ * ```
+ *
+ * @example
+ * ### End-to-end
+ *
+ * Below is an end-to-end example of using `Block.fromRpc` to fetch a block from the network and convert it to an {@link ox#Block.Block}.
+ *
+ * ```ts twoslash
+ * import 'ox/window'
+ * import { Block } from 'ox'
+ *
+ * const block = await window.ethereum!
+ *   .request({
+ *     method: 'eth_getBlockByNumber',
+ *     params: ['latest', false],
+ *   })
+ *   .then(Block.fromRpc) // [!code hl]
+ * // @log: {
+ * // @log:   // ...
+ * // @log:   hash: '0xebc3644804e4040c0a74c5a5bbbc6b46a71a5d4010fe0c92ebb2fdf4a43ea5dd',
+ * // @log:   number: 19868020n,
+ * // @log:   size: 520n,
+ * // @log:   timestamp: 1662222222n,
+ * // @log:   // ...
+ * // @log: }
+ * ```
+ *
+ * :::note
+ *
+ * For simplicity, the above example uses `window.ethereum.request`, but you can use any
+ * type of JSON-RPC interface.
+ *
+ * :::
+ *
+ * @param block - The RPC block to convert.
+ * @returns An instantiated {@link ox#Block.Block}.
+ */
+export function fromRpc(block, _options = {}) {
+    if (!block)
+        return null;
+    const transactions = block.transactions.map((transaction) => {
+        if (typeof transaction === 'string')
+            return transaction;
+        return Transaction.fromRpc(transaction);
+    });
+    return {
+        ...block,
+        baseFeePerGas: block.baseFeePerGas
+            ? BigInt(block.baseFeePerGas)
+            : undefined,
+        blobGasUsed: block.blobGasUsed ? BigInt(block.blobGasUsed) : undefined,
+        difficulty: block.difficulty ? BigInt(block.difficulty) : undefined,
+        excessBlobGas: block.excessBlobGas
+            ? BigInt(block.excessBlobGas)
+            : undefined,
+        gasLimit: BigInt(block.gasLimit ?? 0n),
+        gasUsed: BigInt(block.gasUsed ?? 0n),
+        number: block.number ? BigInt(block.number) : null,
+        size: BigInt(block.size ?? 0n),
+        stateRoot: block.stateRoot,
+        timestamp: BigInt(block.timestamp ?? 0n),
+        totalDifficulty: BigInt(block.totalDifficulty ?? 0n),
+        transactions,
+        withdrawals: block.withdrawals?.map(Withdrawal.fromRpc),
+    };
+}
+fromRpc.parseError = (error) => 
+/* v8 ignore next */
+error;
+//# sourceMappingURL=Block.js.map

package/_esm/Block.js.map

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

package/_esm/Bloom.js

@@ -0,0 +1,57 @@
+import * as Bytes from './Bytes.js';
+import * as Hash from './Hash.js';
+import * as Hex from './Hex.js';
+/**
+ * Checks if an input is matched in the bloom filter.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bloom } from 'ox'
+ *
+ * Bloom.contains(
+ *   '0x00000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002020000000000000000000000000000000000000000000008000000001000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
+ *   '0xef2d6d194084c2de36e0dabfce45d046b37d1106',
+ * )
+ * // @log: true
+ * ```
+ *
+ * @param bloom - Bloom filter value.
+ * @param input - Input to check.
+ * @returns Whether the input is matched in the bloom filter.
+ */
+export function contains(bloom, input) {
+    const filter = Bytes.fromHex(bloom);
+    const hash = Hash.keccak256(input, { as: 'Bytes' });
+    for (const i of [0, 2, 4]) {
+        const bit = (hash[i + 1] + (hash[i] << 8)) & 0x7ff;
+        if ((filter[256 - 1 - Math.floor(bit / 8)] & (1 << (bit % 8))) === 0)
+            return false;
+    }
+    return true;
+}
+contains.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * Checks if a string is a valid bloom filter value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bloom } from 'ox'
+ *
+ * Bloom.validate('0x')
+ * // @log: false
+ *
+ * Bloom.validate('0x00000000000000000000008000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000044000200000000000000000002000000000000000000000040000000000000000000000000000020000000000000000000800000000000800000000000800000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000808002000000000400000000000000000000000060000000000000000000000000000000000000000000000100000000000002000000')
+ * // @log: true
+ * ```
+ *
+ * @param value - Value to check.
+ * @returns Whether the value is a valid bloom filter.
+ */
+export function validate(value) {
+    return Hex.validate(value) && Hex.size(value) === 256;
+}
+/* v8 ignore next */
+validate.parseError = (error) => error;
+//# sourceMappingURL=Bloom.js.map

package/_esm/Bloom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bloom.js","sourceRoot":"","sources":["../Bloom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAc,EACd,KAA4B;IAE5B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAEnD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;QACpD,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACnE,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AASD,QAAQ,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;AACvC,oBAAoB;AACpB,KAA2B,CAAA;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAA;AACvD,CAAC;AASD,oBAAoB;AACpB,QAAQ,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAA2B,CAAA"}

package/_esm/Bls.js

@@ -0,0 +1,141 @@
+import { bls12_381 as bls } from '@noble/curves/bls12-381';
+import * as Bytes from './Bytes.js';
+import * as Hex from './Hex.js';
+/** Re-export of noble/curves BLS12-381 utilities. */
+export const noble = bls;
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function aggregate(points) {
+    const group = typeof points[0]?.x === 'bigint' ? bls.G1 : bls.G2;
+    const point = points.reduce((acc, point) => acc.add(new group.ProjectivePoint(point.x, point.y, point.z)), group.ProjectivePoint.ZERO);
+    return {
+        x: point.px,
+        y: point.py,
+        z: point.pz,
+    };
+}
+aggregate.parseError = (error) => 
+/* v8 ignore next */
+error;
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function getPublicKey(options) {
+    const { privateKey, size = 'short-key:long-sig' } = options;
+    const group = size === 'short-key:long-sig' ? bls.G1 : bls.G2;
+    const { px, py, pz } = group.ProjectivePoint.fromPrivateKey(Hex.from(privateKey).slice(2));
+    return { x: px, y: py, z: pz };
+}
+/**
+ * Generates a random BLS12-381 private key.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bls } from 'ox'
+ *
+ * const privateKey = Bls.randomPrivateKey()
+ * ```
+ *
+ * @param options - The options to generate the private key.
+ * @returns The generated private key.
+ */
+export function randomPrivateKey(options = {}) {
+    const { as = 'Hex' } = options;
+    const bytes = bls.utils.randomPrivateKey();
+    if (as === 'Hex')
+        return Hex.fromBytes(bytes);
+    return bytes;
+}
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function sign(options) {
+    const { payload, privateKey, suite, size = 'short-key:long-sig' } = options;
+    const payloadGroup = size === 'short-key:long-sig' ? bls.G2 : bls.G1;
+    const payloadPoint = payloadGroup.hashToCurve(Bytes.from(payload), suite ? { DST: Bytes.fromString(suite) } : undefined);
+    const privateKeyGroup = size === 'short-key:long-sig' ? bls.G1 : bls.G2;
+    const signature = payloadPoint.multiply(privateKeyGroup.normPrivateKeyToScalar(privateKey.slice(2)));
+    return {
+        x: signature.px,
+        y: signature.py,
+        z: signature.pz,
+    };
+}
+sign.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * Verifies a payload was signed by the provided public key(s).
+ *
+ * @example
+ *
+ * ```ts twoslash
+ * import { Bls, Hex } from 'ox'
+ *
+ * const payload = Hex.random(32)
+ * const privateKey = Bls.randomPrivateKey()
+ *
+ * const publicKey = Bls.getPublicKey({ privateKey })
+ * const signature = Bls.sign({ payload, privateKey })
+ *
+ * const verified = Bls.verify({ // [!code focus]
+ *   payload, // [!code focus]
+ *   publicKey, // [!code focus]
+ *   signature, // [!code focus]
+ * }) // [!code focus]
+ * ```
+ *
+ * @example
+ * ### Verify Aggregated Signatures
+ *
+ * We can also pass a public key and signature that was aggregated with {@link ox#Bls.(aggregate:function)} to `Bls.verify`.
+ *
+ * ```ts twoslash
+ * import { Bls, Hex } from 'ox'
+ *
+ * const payload = Hex.random(32)
+ * const privateKeys = Array.from({ length: 100 }, () => Bls.randomPrivateKey())
+ *
+ * const publicKeys = privateKeys.map((privateKey) =>
+ *   Bls.getPublicKey({ privateKey }),
+ * )
+ * const signatures = privateKeys.map((privateKey) =>
+ *   Bls.sign({ payload, privateKey }),
+ * )
+ *
+ * const publicKey = Bls.aggregate(publicKeys) // [!code focus]
+ * const signature = Bls.aggregate(signatures) // [!code focus]
+ *
+ * const valid = Bls.verify({ payload, publicKey, signature }) // [!code focus]
+ * ```
+ *
+ * @param options - Verification options.
+ * @returns Whether the payload was signed by the provided public key.
+ */
+export function verify(options) {
+    const { payload, suite } = options;
+    const publicKey = options.publicKey;
+    const signature = options.signature;
+    const isShortSig = typeof signature.x === 'bigint';
+    const group = isShortSig ? bls.G1 : bls.G2;
+    const payloadPoint = group.hashToCurve(Bytes.from(payload), suite ? { DST: Bytes.fromString(suite) } : undefined);
+    const shortSigPairing = () => bls.pairingBatch([
+        {
+            g1: payloadPoint,
+            g2: new bls.G2.ProjectivePoint(publicKey.x, publicKey.y, publicKey.z),
+        },
+        {
+            g1: new bls.G1.ProjectivePoint(signature.x, signature.y, signature.z),
+            g2: bls.G2.ProjectivePoint.BASE.negate(),
+        },
+    ]);
+    const longSigPairing = () => bls.pairingBatch([
+        {
+            g1: new bls.G1.ProjectivePoint(publicKey.x, publicKey.y, publicKey.z).negate(),
+            g2: payloadPoint,
+        },
+        {
+            g1: bls.G1.ProjectivePoint.BASE,
+            g2: new bls.G2.ProjectivePoint(signature.x, signature.y, signature.z),
+        },
+    ]);
+    return bls.fields.Fp12.eql(isShortSig ? shortSigPairing() : longSigPairing(), bls.fields.Fp12.ONE);
+}
+/* v8 ignore next */
+verify.parseError = (error) => error;
+//# sourceMappingURL=Bls.js.map

package/_esm/Bls.js.map

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

package/_esm/BlsPoint.js

@@ -0,0 +1,59 @@
+import { bls12_381 as bls } from '@noble/curves/bls12-381';
+import * as Hex from './Hex.js';
+/**
+ * Converts a BLS point to {@link ox#Bytes.Bytes}.
+ *
+ * @example
+ * ### Public Key to Bytes
+ * ```ts twoslash
+ * import { Bls, BlsPoint } from 'ox'
+ *
+ * const publicKey = Bls.getPublicKey({ privateKey: '0x...' })
+ * const publicKeyBytes = BlsPoint.toBytes(publicKey)
+ * // @log: Uint8Array [172, 175, 255, ...]
+ * ```
+ *
+ * @example
+ * ### Signature to Bytes
+ * ```ts twoslash
+ * import { Bls, BlsPoint } from 'ox'
+ *
+ * const signature = Bls.sign({ payload: '0x...', privateKey: '0x...' })
+ * const signatureBytes = BlsPoint.toBytes(signature)
+ * // @log: Uint8Array [172, 175, 255, ...]
+ * ```
+ *
+ * @param point - The BLS point to convert.
+ * @returns The bytes representation of the BLS point.
+ */
+export function toBytes(point) {
+    const group = typeof point.z === 'bigint' ? bls.G1 : bls.G2;
+    return new group.ProjectivePoint(point.x, point.y, point.z).toRawBytes();
+}
+/* v8 ignore next */
+toBytes.parseError = (error) => error;
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function toHex(point) {
+    return Hex.fromBytes(toBytes(point));
+}
+/* v8 ignore next */
+toHex.parseError = (error) => error;
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function fromBytes(bytes) {
+    const group = bytes.length === 48 ? bls.G1 : bls.G2;
+    const point = group.ProjectivePoint.fromHex(bytes);
+    return {
+        x: point.px,
+        y: point.py,
+        z: point.pz,
+    };
+}
+/* v8 ignore next */
+fromBytes.parseError = (error) => error;
+// eslint-disable-next-line jsdoc/require-jsdoc
+export function fromHex(hex, group) {
+    return fromBytes(Hex.toBytes(hex), group);
+}
+/* v8 ignore next */
+fromHex.parseError = (error) => error;
+//# sourceMappingURL=BlsPoint.js.map

package/_esm/BlsPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlsPoint.js","sourceRoot":"","sources":["../BlsPoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAI1D,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AA6B/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,OAAO,CACrB,KAAY;IAEZ,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;IAC3D,OAAO,IAAK,KAAa,CAAC,eAAe,CACvC,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,CACR,CAAC,UAAU,EAAE,CAAA;AAChB,CAAC;AAMD,oBAAoB;AACpB,OAAO,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAA0B,CAAA;AAiCnE,+CAA+C;AAC/C,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AACtC,CAAC;AAMD,oBAAoB;AACpB,KAAK,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAwB,CAAA;AA0C/D,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,KAAkB;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAClD,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,EAAE;QACX,CAAC,EAAE,KAAK,CAAC,EAAE;QACX,CAAC,EAAE,KAAK,CAAC,EAAE;KACZ,CAAA;AACH,CAAC;AAMD,oBAAoB;AACpB,SAAS,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAA4B,CAAA;AA6CvE,+CAA+C;AAC/C,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,KAAkB;IACtD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;AAC3C,CAAC;AAMD,oBAAoB;AACpB,OAAO,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAA0B,CAAA"}